Integrating Amplify with web applications
This documentation references external sources. Nexthink does not have control over the accuracy of third-party documentation, nor any external updates or changes that might create inconsistencies with the information presented on this page. Please report any errors or inconsistencies to Nexthink Support.
This page describes the generic process of integrating Amplify with web applications.
The example demonstrates the process in ServiceNow Helpdesk, which differs from that in other web applications. However, the process is similar and will work for most web applications.
Integrating the Amplify extension with web applications
Integrate the Amplify extension with web-based applications for a specific device.
This local configuration does not apply to other Amplify user devices until you add the web application configurations to the Nexthink platform.
To integrate web application configuration locally:
Open the browser where you installed the Amplify extension (Google Chrome or Microsoft Edge).
Right-click on the Amplify extension in the browser extension bar.
From the drop-down, click Options to open the Nexthink Amplify configuration page.
Select the Local tab under Web application configuration.
Click Add web application.
The Amplify extension only displays the Local and Central tabs in case of a single instance configuration.
Fill in the Web application URL field, and use the User or device identifier and String selector according to the desired behavior for Amplify:
To enable the Amplify button on all pages of the web application, without reading the webpage for device or user identification fields:
Add the base URL of the application in the Web application URL field.
Leave the User or device identifier value field blank.
To enable the Amplify button on pages specific to a module of the web application, without reading the webpage for device or user identification fields:
Add the URL specific to the application module in the Web application URL field.
For example, place the Amplify button on all pages of the ServiceNow incidents module by entering the web application URL:
https://your-service-now.com/nav_to.do?uri=%2Fincident.do
Leave the User or device identifier value field blank.
Some web applications may no support the Amplify web application configuration using specific field identifiers due to differences in UI designs/fields.
To enable Amplify to read identifiers from specific fields of the web application:
Open a new tab on your browser with the web application page URL with the populated device/user field. Copy the entire page URL.
Add web application in Amplify and paste the copied URL in the Web application URL field.
Select identifier in Amplify to open the web application URL using the Field selector pop-up.
Use the highlighter to choose the field of interest on the page. Once selected, the system loads the element into the Field selector pop-up. See the image below.
When configuring a String selector using a regular expression, you can optionally define a substitution pattern to reformat the matched text. This is useful when a field contains values that need to be reordered or cleaned before matching with Nexthink records.
If pop-ups from the web application prevent you from selecting the correct fields:
Switch on the Disable selector toggle in the Field selector pop-up and navigate to the webpage of interest.
Once on the correct page, switch off the Disable selector toggle and pick the correct field.
If needed, select a specific part of the string from the device or user identifier field using the String selector* on the Field selector pop-up:
Enter the relevant regular expression in the String selector field.
Click the Fill field value button to verify the selected field value.
Click Save to modify the relevant device or user identifier.
*Amplify Field selector supports the use of regular expressions for partial text matching. This enables the selection of specific parts of the string from the Selected field value. See the image below.
Refer to the Regular expression documentation from Wikipedia for more information.
Save the web application configuration.
Nexthink recommends pushing the single Nexthink instance configuration on all target devices using group policy, configuration management solution or remote actions.
Transforming matched values using substitution
With this feature, you can match users or devices even when values appear in a different order. For example, if a name is shown as Smith John in a third-party system but appears as John, Smith in Nexthink, substitution allows you to realign the values for a successful match.
Substitution is an option you can use when matching text with a String selector. It lets you change the matched value before Amplify uses it. For example, reordering names or removing extraneous text.
You can use substitution when:
The selected field contains extra text you want to remove
You want to reorder parts of the matched value
You only want to keep specific captured segments of the match
How it works
To do this, use capturing groups in your regex pattern. Then, in the Substitution field, refer to those groups using:
$1for the first group$2for the second group$3, and so on
Amplify will apply the substitution before trying to match the value against Nexthink records.
Click Fill field value to preview how the transformation will look before saving.
Example
Suppose the field value is:
But Nexthink expects:
You can transform the format by doing the following:
Enter the following regex pattern, which captures two word segments separated by whitespace:
This pattern captures:
$1→ Smith$2→ John
In the Substitution field, enter:
Click Fill field value to verify that the result matches the expected format.
Once confirmed, click Save to apply the configuration.
Managing web application configurations
Amplify reads the values of the fields in a sequence of configurations.
To change the selection sequence of the configured web applications, hover over the relevant row and open the action menu to switch the order: Move up or Move down.
You can also Edit or Delete the web application configuration from the action menu.
Once done, Save your configurations.
Optionally, Download configuration to export the web application configuration as a .reg registry file.
Integrating Amplify with specific web applications
For ITSM solutions that do not support the out-of-the-box selector configuration due to version incompatibility or user interface design, refer to the following pages:
Last updated
Was this helpful?