Edit

Walkthrough 6: Configure the Debugger hosted control in agent applications

  • Article

Unified Service Desk provides a Debugger type of hosted control, which provides you key information about your Unified Service Desk configuration that helps you to successfully build an agent application and troubleshoot issues in your configuration. More information: Debug issues in Unified Service Desk

This walkthrough demonstrates how to configure a Debugger hosted control for your agent application.

Prerequisites

In This Walkthrough

Step 1: Create a Debugger type of hosted control

Step 2: Add toolbar button and action call to display the Debugger hosted control

Step 3: Add the controls to the configuration

Step 4: Test the application

Conclusion

Step 1: Create a Debugger type of hosted control

  1. Sign in to Unified Service Desk Administrator.

  2. Select Hosted Controls under Basic Settings.

  3. Select + New.

  4. On the New Hosted Control page, specify the following values:

    Field Value
    Name Contoso Debugger
    Sort Order 3
    Display Name Contoso Debugger
    USD Component Type Debugger
    Display Group MainPanel

  5. Select Save.

Step 2: Add toolbar button and action call to display the Debugger hosted control

Add a toolbar button to Contoso Main Toolbar (created in Walkthrough 3: Display Unified Interface apps records in your agent application), and then add an action call for the button to display the Contoso Debugger hosted control that you created in step 1.

  1. Sign in to Unified Service Desk Administrator.

  2. Select Toolbars under Basic Settings.

  3. Select Contoso Main Toolbar.

  4. In the Buttons area, select + New Toolbar Button to add a toolbar button.

  5. On the New Toolbar Button page, specify the following values.

    Field Value
    Name Contoso Debugger Button
    Button Text DEBUGGER
    Order 3
    Note: The Order field defines the position of buttons in the toolbar. Buttons are arranged from left to right or top to bottom in an ascending order.

  6. Select Save.

  7. In the Actions area, select Add Existing Action Call to create an action call for the button. The Lookup Records pane is displayed.

  8. Select the search icon and then select + New Action Call.

  9. On the New Action Call page, specify the following values.

    Field Value
    Name Contoso Action Call: Show Debugger
    Order 1
    Hosted Control Contoso Global Manager
    Action CallDoAction
    Data action=default
    application=Contoso Debugger

  10. Select Save.

  11. Select the back button in the browser to go back to the Contoso Debugger Button page.

  12. Select Add Existing Action Call. The Lookup Records pane is displayed.

  13. Type the name of the action call in the search box. Select the record from the list, and then select Add.

  14. Select Save.

Step 3: Add the controls to the configuration

Add the action call and hosted control that you created in this walkthrough to Contoso Configuration to display these controls to the user who is assigned to the configuration. Contoso Configuration was created in Walkthrough 1: Build a simple agent application for Unified Interface Apps.

Add the following to Contoso Configuration.

Control name Control type
Contoso Action Call: Show Debugger Action Call
Contoso Debugger Hosted Control

To add a control to the configuration:

  1. Sign in to Unified Service Desk Administrator.

  2. Select Configuration under Advanced Settings.

  3. Select Contoso Configuration to open the definition.

  4. Select the Hosted Controls, Events and Action Calls tab.

  5. Select the ellipsis (...) in the Action Calls section, and then select Add Existing Action Call. The Lookup Records pane is displayed.

  6. Type the name of the action call mentioned in the above table in the search box. The action calls are displayed in the search results. Select the record from the list, and then select Add.

  7. Select the ellipsis (...) in the Hosted Controls section, and then select Add Existing Hosted Control. The Lookup Records pane is displayed.

  8. Type the name of the hosted control mentioned in the above table in the search box. The hosted controls are displayed in the search results. Select the record from the list, and then select Add.

  9. Select Save.

Step 4: Test the application

Start the Unified Service Desk client application, and sign in to the Dynamics 365 instance where you configured Unified Service Desk using the same user credentials that you assigned to the Contoso Configuration in Walkthrough 1: Build a simple agent application for Unified Interface Apps. For information about connecting to Dataverse instance using the Unified Service Desk client application, see Connect to a model-driven app instance using the Unified Service Desk client.

Your agent application will now have a DEBUGGER button in the toolbar area. Selecting this button displays the Debugger control.

Debugger in your agent application.

Conclusion

In this walkthrough, you saw how to configure the Debugger hosted control in your agent application. You also learned how to filter access to Unified Service Desk controls using configuration.

See also

Support for Unified Interface Apps in Unified Service Desk

Unified Interface Page (Hosted Control)

Unified Service Desk and Unified Interface Configuration Walkthroughs

Walkthrough 1: Build a simple agent application for Unified Interface Apps

Walkthrough 2: Display an external webpage in your agent application

Walkthrough 3: Display Unified Interface apps records in your agent application

Walkthrough 4: Display a Unified Interface apps record in a session in your agent application

Walkthrough 5: Display enhanced session information by displaying session name and overview data

Walkthrough 7: Configure agent scripting in your agent application