Test Instance for Workflow Customization: To Deploy a Test Instance

The following activity will walk you through the process of preparing and deploying an MYOB Acumatica instance that you can use to perform the steps in other chapters of this guide.

Story

Suppose that you need to perform customization tasks for the Smart Fix company, as described in Company Story and Customization Description, and complete the activities described in other chapters of this guide. You need to deploy an instance of MYOB Acumatica with the PhoneRepairShop customization project published.

Process Overview

In this activity, you will install tools that will help you to perform customization tasks and then deploy the instance of MYOB Acumatica with the dataset from the T220 Data Entry and Setup Forms course.

Step 1: Preparing the Environment

To prepare the environment, do the following:

  1. Make sure that the environment that you are going to use conforms to the System Requirements for MYOB Acumatica 2024.1.
  2. Make sure that the Web Server (IIS) features that are listed in Configuring Web Server (IIS) Features are turned on.
  3. Install the Acuminator extension for Visual Studio.
  4. Clone or download the customization project and the source code of the extension library from the Help-and-Training-Examples repository in MYOB GitHub to a folder on your computer.
  5. Install MYOB Acumatica. On the Main Software Configuration page of the , select the Install Acumatica ERP and Install Debugger Tools check boxes.
    Tip: If you have already installed MYOB Acumatica without debugger tools, you should remove MYOB Acumatica and install it again with the Install Debugger Tools check box selected. The reinstallation of MYOB Acumatica does not affect existing MYOB Acumatica instances. For details, see To Install the MYOB Acumatica Tools.

Step 2: Deploying the Instance

To perform customization for the Smart Fix company as described in Company Story and Customization Description, you need deploy an instance of MYOB Acumatica and publish the customization project prepared for the T270 Workflow API training course (in this case, the project that has been developed in the T220 Data Entry and Setup Forms training course), on the instance.

You deploy an MYOB Acumatica instance and configure it as follows:
  1. Open the MYOB Acumatica ERP Configuration Wizard, and do the following:
    1. Click Deploy a New Acumatica ERP Instance for T-Series Developer Courses.
    2. On the Instance Configuration page, do the following:
      1. In the Training Course box, select T270 Workflow API.
      2. In the Local Path to the Instance box, select a folder that is outside of the C:\Program Files (x86), C:\Program Files, and C:\Users folders. (We recommend that you store the website folder outside of these folders to avoid an issue with permission to work in these folders when you customize the website.)
    3. On the Database Configuration page, make sure the name of the database is SmartFix_T270.

    The system creates a new MYOB Acumatica instance, adds a new tenant, loads the data to it, and publishes the customization project that is needed for activities of this guide.

  2. Make sure that a Visual Studio solution is available in the App_Data\Projects\PhoneRepairShop folder of the MYOB Acumatica instance folder.

    This is the solution of the extension library that you will modify in the activities of this guide.

  3. Sign in to the new tenant by using the following credentials:
    • Username: admin
    • Password: setup

    Change the password when the system prompts you to do so.

  4. In the top right corner of the MYOB Acumatica screen, click the username, and then click My Profile. The User Profile (SM203010) form opens. On the General Info tab, select YOGIFON in the Default Branch box; then click Save on the form toolbar.

    In subsequent sign-ins to this account, you will be signed in to this branch.

  5. Optional: Add the Customization Projects (SM204505) and Generic Inquiry (SM208000) forms to your favorites. For details about how to add a form to your favorites, see Favorites: General Information.