Integrating Amplify with web applications
Last updated
Last updated
This page describes the generic process of integrating Amplify with web applications.
The example showcases the process in the ServiceNow Helpdesk, which will differ from other web applications. However, the process is similar and will work for most 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:
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.
Adding the locally configured integrations of web applications (from the Amplify extension) into the Nexthink web interface allows all the devices with the Amplify browser extension to pull the configured integration from the Nexthink platform.
First, from the Amplify extension, you must complete the steps described before on this page:
Ensure you have Manage Amplify permissions.
Configure web application integration locally on your device.
Copy the web application configuration fields: Web application URL, User or device identifier and String selector.
Then, from the Nexthink web interface:
Select Administration > Amplify from the main menu.
Add web application from the Amplify administration page.
Paste the respective web application configuration fields from the Amplify extension (see step 3 above).
If you need to integrate with multiple web applications, add all web application configurations into the Nexthink platform.
Amplify reads the values of the fields in a sequence of configurations.
To change the selection sequence of the configured web applications, from the Nexthink web interface:
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 you have added the Nexthink instances, you can configure multiple Nexthink instances locally.
From the Amplify extension:
Click New web application and follow the steps described in the Integrating with web applications from the Amplify extension section on this page.
Optionally, Download configuration to export the web application configuration as a .reg registry file.
You cannot set up multi-instance configurations from the Nexthink web interface using the Amplify module. The extension does not pull the central configuration from Nexthink for those multi-instance configurations. Refer to Deploying Amplify for more information.
Instead of accessing the Amplify extension through your browser, you can set it up as a standalone application.
Access the Amplify window directly with the following URL: chrome-extension://bmpbcphgifhfkfjioddeenggdpffbgek/extension-popup.html
Find the Customize and control Google Chrome menu in the upper right-hand corner.
Select Cast, save and share.
Select Create shortcut.
Rename the shortcut if needed.
Press Create.
Access the Amplify window directly with the following URL: extension://bmpbcphgifhfkfjioddeenggdpffbgek/extension-popup.html
Find the Settings and more menu in the upper right-hand corner.
Select Apps.
Select Install this site as an app.
Rename the application if needed.
Press Install.
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:
| Enable the Amplify button on all pages of the web application |
|---|
| Enable the Amplify button on pages specific to a module of the web application |
|---|
| Enable Amplify to read identifiers from specific fields of the web application |
|---|
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.
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.
