Deep Linking links are links that send users directly to a page or resource of a third-party website or app, other than its home page.

In Service Manager, deep links can be created to third-party collaboration tools such as EV Reach, Teams or Slack.

• Dedicated icons for calling the deep links will appear next to some fields of forms.
• You can click the icon to run the third-party collaboration tool that was configured, e.g. chat, voice call or video call.
• You can create multiple deep links for a given field so that users can run different tools.

Examples

• Initiate a Teams conversation with the recipient directly from an Incident form
          

• Start a EV Reach remote control session for an item of equipment directly from an Incident form or Equipment form
• Interact with the EV Reach ticketing system directly from an Incident form
• Start a Teams call or a chat directly from the User field of a form

Notes

• Dedicated icons for calling the deep links will appear on hover over the relevant fields.
• Icons are available in all forms with visible fields that have been configured with deep links.

  example  Configuration of a Teams call for a User field ==> The dedicated icon will appear in all forms that display this field, e.g. Employee, Incident, Request, etc.

• You can configure a deep link locally in a form using edit mode. If you do this configuration locally, the dedicated icons will only appear in this form.  See the procedure

Screens description

Actions - Deep Linking

This screen is used to define the list of actions that can be performed by the third-party collaboration tools used in Service Manager.

Menu access: Administration > Deep Linking Tools > Actions - Deep Linking

Software - Deep Linking

This screen is used to define the list of collaboration tools used in Service Manager.

Menu access: Administration > Deep Linking Tools > Software - Deep Linking

Title: Name of the third-party collaboration tool.

Icon: Icon representing the third-party collaboration tool.

• This icon will automatically appear in the Collaboration Tools screen.
• Click Change to download an image from the library.

Settings - Deep Linking

This screen is used to create deep links by associating an action with a third-party collaboration tool.

Menu access: Administration > Deep Linking Tools > Settings - Deep Linking

Title: Description of the deep link that will appear on hover over the dedicated icon.

Icon: Dedicated icon that will appear on hover over the field.

Software: Name of the third-party collaboration tool for the deep link selected in the form.

Action: Name of the action that will be performed by the third-party collaboration tool when the deep link is selected in the form.

Automatic display of the Deep Linking icon: This indicates whether the deep link will be visible in all forms containing this field (box is checked) or if the deep link will be visible only in this form (box is not checked). If it is visible only in this form, you should configure the link locally using edit mode.  See the procedure.

URI: URL that will run when the deep link is selected in the form.

• The URL can include parameters in the following format, @@tag@@.

Default table: Service Manager table where the field belongs.

Default Field: Field where the dedicated icon for calling the deep link must be placed.

Tags: Parameter values passed in the URL.

Collaboration Tools

This screen displays a list of the third-party collaboration tools using deep links.

• The standard deep links integrated in Service Manager are preconfigured for each tool.

Menu access: Administration > Deep Linking Tools > Collaboration Tools

Software: Name of the third-party collaboration tool.

• The icon displayed is the one selected for the tool in the Software - Deep Linking screen.

Deep Linking: Action performed by the deep link.

• The links available are those defined in the Settings - Deep Linking screen in the Title field.

Procedures

How to create deep links

Step 1: Define the collaboration tools used in Service Manager

1. Select Administration > Deep Linking Tools > Software - Deep Linking in the menu.

2. Click + New.

3. Specify the information on the new third-party collaboration tool.

4. Click Save.
 

Step 2: Define the actions that can be performed by the collaboration tools

1. Select Administration > Deep Linking Tools > Actions - Deep Linking in the menu.

2. Click + New.

3. Enter the description of the new action.

4. Click Save.
 

Step 3: Create deep links between Service Manager and the collaboration tools 

1. Select Administration > Deep Linking Tools > Settings - Deep Linking in the menu.

2. Click + New.

3. Specify the information on the new link.

• Enter the description of the link.
• Click Change icon to select the dedicated icon for calling the deep link.
• Select the third-party collaboration tool in the Software field.
• Select the action to be performed in the Action field.

4. Indicate whether the link should be available in all forms using the Automatic display of the Deep Linking icon option.

• Check this box to make the link available in all forms.
• Leave this box unchecked to make the link available only in certain forms. If this is the case, see How to create a deep link locally in a form.

5. Specify the URL that will run when the deep link is selected in the form.

6. Indicate the name of the field where the dedicated icon for calling the deep link must be placed.

7. Click Save.
 

Step 4: Check that the deep links work correctly

1. Open a form that displays the field configured with a deep link.

2. Click the dedicated icon to run the third-party collaboration tool.

3. Check that the configuration is correct.
        

How to create a deep link locally in a form

Step 1: Configure a deep link locally

1. Select Administration > Deep Linking Tools > Settings - Deep Linking in the menu.

2. Select the deep link that will run locally.

3. Uncheck the Automatic display of the Deep Linking icon option.

4. Click Save.

Step 2: Configure the deep link for the form

1. Open the form where you want to define a deep link locally.

2. Click  in the top banner and select Edit Form.

The main form presentation of the form will appear.
        

3. Click  next to the field where the dedicated icon for calling the deep link must be placed.

The Properties Inspector will appear.

4. Click  +  in the Deep Linking section.

The Deep Linking Properties Inspector will appear.

5. Specify the information on the deep link.

FieldsDeepLinking

6. Click Apply Changes.

7. Close the Properties Inspector and then close the form editor.

You will return to the form interface.
 

Step 3: Check that the deep link works correctly

1. Hover over the field you just configured and click the dedicated icon to run the third-party collaboration tool.

2. Check that the configuration is correct.