Test drive technical configuration

  • Article

The test drive option in the Microsoft commercial marketplace lets you configure a hands-on, self-guided tour of your product's key features. With a test drive, new customers can try your offer before committing to purchase it. For more information, see What is Test Drive?

If you no longer want to provide a test drive for your offer, return to the Offer setup page and clear the Enable test drive check box. Not all offer types have a test drive available.

Tip

To see the customer's view of test drive in the commercial marketplace, see What is Azure Marketplace? and What is Microsoft AppSource?.

Azure Resource Manager test drive

There is only one test drive option for virtual machine or Azure app offers, and it requires fairly detailed setup. Read the sections about Deployment subscription details and Test drive listings first, then continue on to the article Azure Resource Manager test drive configuration.

Hosted test drive

Microsoft can remove the complexity of setting up a test drive by hosting and maintaining the service provisioning and deprovisioning. The configuration for this type of test drive is the same regardless of whether the test drive is targeting a Dynamics 365 apps on Dataverse and Power Apps or Dynamics 365 Operations Apps audience.

  • Max concurrent test drives (required) – Set the maximum number of customers that can use your test drive at one time. Each concurrent user consumes a Dynamics 365 license while the test drive is active, so ensure you have enough licenses available to support the maximum limit set. The recommended value is 3-5.

  • Test drive duration (required) – Enter the number of hours the test drive is to stay active for each customer. After this period, the session will end and no longer consumes one of your licenses. We recommend a value of 2-24 hours depending on the complexity of your offer. This duration can only be set in whole hours (for example, "2 hours" is valid; "1.5 hours" isn't valid). The user can request a new session if they run out of time and want to access the test drive again.

  • Instance URL (required) – The URL where the customer begins their test drive. Typically the URL of your Dynamics 365 instance running your app with sample data installed (for example, https://testdrive.crm.dynamics.com).

  • Instance Web API URL (required) – Retrieve the Web API URL for your Dynamics 365 instance by logging into your Microsoft 365 account and navigating to Settings > Customization > Developer Resources > Instance Web API (Service Root URL), copy the URL found here (for example, https://testdrive.crm.dynamics.com/api/data/v9.0).

  • Role name (required) – Provide the security role name you defined in your custom Dynamics 365 test drive, which is assigned to the user during their test drive (for example, test-drive-role).

For help on how to set up your Dynamics 365 environment for test drive and grant AppSource permission to provision and deprovision test drive users in your tenant, see Set up an Azure Marketplace subscription for hosted test drives.

For step by step instructions on listing and configuring your Hosted Test Drive, see Detailed configuration for hosted test drive.

Logic app test drive

This type of test drive isn't hosted by Microsoft. Use it to connect with a Dynamics 365 offer or other custom resource, which encompasses various complex solution architectures. For more information about setting up Logic App test drives, visit Operations and Customer Engagement on GitHub.

  • Region (required, single-selection dropdown list) – Currently there are 26 Azure-supported regions where your test drive can be made available. The resources for your Logic app are deployed in the region you select. If your Logic App has any custom resources stored in a specific region, make sure that region is selected here. The best way is to fully deploy your Logic App locally on your Azure subscription in the portal and verify that it functions correctly before making this selection.

  • Max concurrent test drives (required) – Set the maximum number of customers that can use your test drive at one time. These test drives are already deployed, enabling customers to instantly access them without waiting for a deployment.

  • Test drive duration (required) – Enter the length of time that the Test Drive is to stay active, in # of hours. The test drive terminates automatically after this time period ends.

  • Azure resource group name (required) – Enter the Azure resource group) name where your Logic App test drive is saved.

  • Azure logic app name (required) – Enter the name of the Logic app that assigns the test drive to the user. This Logic app must be saved in the Azure resources group above.

  • Deprovision logic app name (required) – Enter the name of the Logic app that de-provisions the test drive once the customer is finished. This Logic app must be saved in the Azure resources group above.

Power BI test drive

Products that want to demonstrate an interactive Power BI visual can use an embedded link to share a custom-built dashboard as their test drive, no further technical configuration required. All you need to do is to upload your embedded Power BI URL.

For more information on setting up Power BI apps, see What are Power BI apps?

Deployment subscription details

To allow Microsoft to deploy the test drive on your behalf, create and provide a separate, unique Azure Subscription (not required for Power BI test drives).

  • Azure subscription ID (required for Azure Resource Manager and Logic apps) – Enter the subscription ID to grant access to your Azure account services for resource usage reporting and billing. We recommend that you consider creating a separate Azure subscription to use for test drives if you don't have one already. You can find your Azure subscription ID by logging in to the Azure portal and navigating to the Subscriptions tab of the left-side menu. Selecting the tab displays your subscription ID (for example, "a83645ac-1234-5ab6-6789-1h234g764ghty").

  • Microsoft Entra tenant ID (required) – Enter your Microsoft Entra tenant ID). To find this ID, sign in to the Azure portal, select the Active Directory tab in the left-menu, select Properties, then look for the Directory ID number listed (for example, 50c464d3-4930-494c-963c-1e951d15360e). You can also look up your organization's tenant ID using your domain name address at https://www.whatismytenantid.com.

  • Microsoft Entra tenant name (required for Dynamic 365) – Enter your Microsoft Entra ID name. To find this name, sign in to the Azure portal, in the upper right corner your tenant name is listed under your account name.

  • Microsoft Entra app ID (required) – Enter your Microsoft Entra ID application ID). To find this ID, sign in to the Azure portal, select the Active Directory tab in the left-menu, select App registrations, then look for the Application ID number listed (such as 50c464d3-4930-494c-963c-1e951d15360e).

  • Microsoft Entra app client secret (required) – Enter your Microsoft Entra application client secret). To find this value, sign in to the Azure portal. Select the Microsoft Entra ID tab in the left menu, select App registrations, and select your test drive app. Next, select Certificates and secrets, select New client secret, enter a description, select Never under Expires, and choose Add. Make sure to copy down the value. Don't navigate away from the page before you copy the value.

Test drive listings

The Test Drive listings option found under the Test drive tab in Partner Center displays the languages (and markets) where your test drive is available, currently English (United States) is the only location available. Additionally, this page displays the status of the language-specific listing and the date/time that it was added. You must define the test drive details (description, user manual, videos, etc.) for each language/market.

  • Description (required): Describe your test drive, what will be demonstrated, objectives for the user to experiment with, features to explore, and any relevant information to help the user determine whether to acquire your offer. Up to 3,000 characters of text can be entered in this field.

  • Access information (required for Azure Resource Manager and Logic test drives): Explain what a customer needs to know in order to access and use this test drive. Walk through a scenario for using your offer and exactly what the customer should know to access features throughout the test drive. Up to 10,000 characters of text can be entered in this field.

  • User Manual (required): An in-depth walk-through of your test drive experience. The User Manual should cover exactly what you want the customer to gain from experiencing the test drive and serve as a reference for any questions that they might have. The file must be in PDF format and be named (255 characters max) after uploading.

  • Videos: Add videos (optional): Videos hosted elsewhere can be referenced here with a link and thumbnail image (533 x 324 pixels) so a customer can view a walk-through of information to help them better understand the test drive, including how to successfully use the features of your offer and understand scenarios that highlight their benefits.

    • Name (required)
    • URL (YouTube or Vimeo only; required)
    • Thumbnail (533 x 324 pixels) – Image must be in PNG format.

If you're currently creating your test drive in Partner Center, select Save draft before continuing.

For step by step instructions on listing and configuring your Hosted Test Drive, see the article Detailed configuration for hosted test drive.

Next steps