Test Instance for Customization: To Deploy an Instance for Creating Actions

This activity will walk you through the preparation and deployment of an MYOB Acumatica instance that you can use to perform the activities in this guide that are related to the development of actions.

Story

Suppose that you need to perform customization tasks and complete the activities described in the chapters of this guide that are related to the development of actions. You need to deploy an instance of MYOB Acumatica with the PhoneRepairShop customization project published and configure the instance.

Process Overview

In this activity, you will prepare the environment and install tools that will help you to perform customization tasks. You will then deploy the instance of MYOB Acumatica with the PhoneRepairShop customization project published and the dataset from the T220 Data Entry and Setup Forms course. Finally, in MYOB Acumatica, you will configure the instance that you have deployed.

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 tasks, you need to deploy an instance of MYOB Acumatica for the T230 Actions 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 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.)
      2. In the Training Course box, select T230 Actions.
    3. On the Database Configuration page, make sure that the name of the database is SmartFix_T230.

    The system creates a new MYOB Acumatica instance, adds a new tenant, loads the dataset 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.

Step 3: Updating the RSSVRepairItem Table

In later activities of this guide, you will implement an action that is run asynchronously. This action validates the prices of the repair items in the table on the Repair Items tab of the Services and Prices (RS203000) form. As a preparation step for these activities, you need to add a new field called IsPriceValidated to the existing RSSVRepairItem table in the database of your instance and then update the PhoneRepairShop project.

To add the new field, do the following:
  1. In SQL Server Management Studio, execute the T230_AddColumn_RSSVRepairItem.sql script.
    Tip:
    The script is provided in the Customization\T230\SourceFiles\DBScripts folder, which you have downloaded from Acumatica GitHub.
  2. To update the customization project, do the following:
    1. In the Customization Project Editor, open the PhoneRepairShop project.
    2. In the navigation pane, click Database Scripts.
    3. On the More menu of the Database Scripts page, which opens, click Reload from Database.