Lab - Extend an EDT

  • 15 minutes

Read this first - before you start the lab!

Important

For this lab, you CANNOT sign in with your own credentials. Use the following steps to sign in to your lab environment with the correct credentials.

  1. Ensure that you are signed in to Microsoft Learn.

  2. Select Launch VM mode or Sign in to launch VM mode in this unit.

  3. In the Resources tab on the lab side bar, select the T icon next to Password in the MININT box, to have the administrator password for the Virtual Machine entered for you.

    Screenshot of the administrator password.

  4. Select Enter.

  5. Microsoft Edge will open. Wait for it to navigate to the Sign in page for finance and operations.

  6. On the Microsoft Sign in page in finance and operations, place your mouse cursor into the Username field.

  7. On the Resources tab of the lab side bar, below the Azure portal heading, select the T icon next to Username, then press Enter.

    Screenshot of the Username field and the Sign in dialog box that appears.

  8. Your mouse cursor will now be in the Password page.

  9. On the Resources tab of the lab side bar, below the Azure portal heading, select the T icon next to select Password, then press Enter.

    Screenshot of the Password field the Enter password dialog box that appears.

  10. Don't stay signed in or store the password on the virtual machine.

  11. Select Accept in the Permissions requested page.

    Screenshot of the Permissions requested page.

  12. To see the lab instructions, select the Instructions tab on the lab side bar.

You can now begin your work on this lab.

Scenario

The finance and operations apps developer has been asked by the Fleet Management company to change a number-entry field on the Customer page. The Agency location code field only accepts 12 digits, and the company needs to be able to enter 14 digits. Because the company doesn't need a new field, the developer will create an extension of the AgencyLocationCode EDT in Visual Studio.

Create a new project

  1. Close the Microsoft Edge window and finance and operations.
  2. Select Run as administrator to open Visual Studio.
  3. Select Continue without code at the bottom of the page to open Visual studio.
  4. To ensure the correct applications suite is referenced, select Extensions in the toolbar, and then select Dynamics 365.
  5. Select Model Management > Update model parameters
  6. Select the FleetManagement model from the Model name drop-down list.
  7. Select Next, then ensure ApplicationSuite is selected in the Select referenced packages drop-down list. Leave any other selections as is.
  8. Select Next three times.
  9. Open the File menu and select New > Project.
  10. Search for Finance Operations if it is not already showing in the latest projects list, and then select Next.
  11. In the Configure your new project dialog box enter FleetManagementExtensionProject in the Project name field.
  12. Select Create.
  13. Select Dynamics 365 in the Extensions menu at the top of the page.
  14. Select Options.
  15. Under the Dynamics 365 node on the left pane, select Projects.
  16. Ensure the check boxes for Organize projects by element type and Synchronize database on build for newly created project are selected. If others are selected, just leave them as is.
  17. Select OK.

Extend the AgencyLocationCode EDT

  1. Select View in the ribbon to open the Application Explorer. In the search bar, in the Application Explorer window, expand the AOT node and then expand the Data Types node.

  2. In the Data types node, expand the Extended Data Types node.

  3. Select the AgencyLocationCode EDT.

  4. Right-click the AgencyLocationCode EDT and select Create extension. An element named AgencyLocationCode.FleetManagement will be added to your FleetManagementExtensionProject in Solution Explorer. For demonstration purposes, you will keep the default name.

    Note

    We recommend that you rename the extension to avoid conflict with any extensions that are rolled out during application updates. For example, you should rename AgencyLocationCode.Extension to AgencyLocationCode.abcExtension.

  5. Double-click the AgencyLocationCode.FleetManagement element in the Solution Explorer window to open it in the element designer window.

  6. With the AgencyLocationCode.FleetManagement main node selected, go to the Properties window and change the String size property to 14.

  7. Perform a build by right-clicking the project FleetManagementExtensionProject in the Solution Explorer window and then selecting Build.

Close the lab environment

  1. Select Done in the Instructions pane in the lab side bar.
  2. In the Lab is complete window, select Continue, and then select Leave to return to the next unit in the module.