Page Comparison

The WorkLink platform has a number of existing and planned interface points to interact with customer systems.

Learn about a number of ways to interact with the WorkLink platform and recommended orchestration techniques for common use casesfull integration with other systems in your organization.

In

...

This Article

• Definitions

• Use Case #1: System of Record Integration

• Use Case #2: Data Analytics

• Use Case #3: Call Integration (Coming Soon)

...

Further use case examples are described here:

Glossary

There are a number of systems, services and actors key terms relevant to interacting with the WorkLink platformthe use cases described in this document.

...

Use Case #1: System of Record Integration

Real-Time Integration with System-Of-Record

Problem

As an administrator, I want a work order to associate Scope AR Scenario Session data with work orders in my system-of-record updated with activity executed through 3D work instructions, so that i have a single source of truth for job completion.

Application

Get data from a work instruction session and attach it to a particular job ID in the customer’s system of record.

Functional Summary

Clicking a URL in the system of record user interface (in a work order or a training module) launches the WorkLink app and loads the relevant work instructions.

A Work Instruction Session is completed and session data is sent to the CMS

Through a webhook, the system-of-record is notified data is available for the specific record id. System of record queries the GraphQL API to retrieve the data (Sample):

...

Orchestration

1. Through the Resource Catalog interface in the CMS, IDs (for asset models) are mapped to sets of Work Instructions

2. The system of record is configured to generate a dynamic URL (or Deeplink) with the Asset Model ID and a System of Record ID.

3. The URLs are added to the relevant UI screens in the system or record

4. Customers configure a “webhook receiver” app to get webhook alerts

5. Customer system is configured to automatically query the GraphQL endpoint to receive the data based on Work/Job Order ID.webhook alerts for the

Use Case #1b: Multiple Sessions

Summary

As an administrator, I want aggregate data for Work Instruction Sessions so that I can merge it with data from my system of record to calculate KPI and ROI metrics.

Application

• For Learning Management Systems (LMS), get a report of everyone that has completed a particular work instruction scenario so that they get credit for the associated learning module in the LMS.

...

Orchestration

1. Customer system is configured to automatically query the GraphQL endpoint to receive the data fields necessary to perform any internal analysis.

2. Customers can transform JSON format into CSV to merge with System of Record data.

Use Case #2: Data Analytics

...

(e.g. Salesforce), in real-time, as my users interact with the Scope AR platform.

Solution

I will use a custom internal application, Deeplinks, Scenario Catalogs, Webhooks, and the Scope AR GraphQL API to retrieve Scenario Session data, as the data becomes available, and associate said data with work orders in my system-of-record.

Configuration

1. For each physical device (aka the “Asset”) that work orders might pertain to in the system-of-record (.e.g. “Generator Model #1234”):

   1. The administrator creates at least one Scenario for the Asset using the Scope AR Create application.

   2. The administrator creates a Scenario Catalog for the Asset using the Scope AR CMS web interface.

2. The administrator configures the system-of-record to present a dynamically generated link whenever system-of-record users view work orders (aka the “Deeplink”). The link passes both the asset identifier and work order identifier as parameters:

   Code Block
   worklink://resource?action=fetch_catalog&asset=INSERT_ASSET_ID_HERE&work_order_id=INSERT_WORK_ORDER_ID_HERE

   See Using Deeplinks for more details on this.

3. The administrator creates a custom internal application designed to receive Scope AR Webhooks.

4. A company administrator then creates a webhook that will trigger this application when the pertinent information in the Scope AR system is added or updated.

See Using WebHooks for more details on how to do this.

Integration Workflow with Middleware App

To integrate your system of record that is triggering the execution of work instructions and then recording the results of that execution the data workflow would be as follows.

...

The steps of this flow entail:

1. The user visits a Deeplink dynamically generated by the system-of-record (see “configuration” above).

2. The WorkLink app launches and loads the Scenario Catalog identified by the Deeplink’s asset query param.

3. The user selects a Scenario and begins a Scenario Session (causing all additional query parameters passed by the Deeplink to be stored as key-value pairs in a JSON hash on the ScenarioSession.externalData attribute, including and notably work_order_id).

4. The customer’s custom application receives Webhook event notifications from the Scope AR platform that there is new data that the application is interested in.

5. The customer’s custom application queries the Scope AR GraphQL API to retrieve the ScenarioSession data identified by the Webhook payload resource_id (see Scenario Session Data Sample Queries ).

6. The customer’s custom application inspects the data retrieved for the value of ScenarioSession.externalData.work_order_id

7. The customer’s custom application then associates the retrieved Scenario Session data with the work order in the customer’s system-of-record (using system-of-record APIs, or similar) using available APIs from the system-of-record.

Integration Workflow with Built-in Integrations

Alternatively, you can use the built-in integration features of the WorkLink CMS. This eliminates the need for a custom middleware app and the WorkLink Integration scripts do that for you. See below for how that changes the data flow.

The steps of this flow entail:

1. The user visits a Deeplink dynamically generated by the system-of-record (see “configuration” above).

2. The WorkLink app launches and loads the Scenario or Catalog identified by the Deeplink’s asset query param.

3. The user selects a Scenario and begins a Scenario Session (causing all additional query parameters passed by the Deeplink to be stored as key-value pairs in a JSON hash on the ScenarioSession.externalData attribute, including and notably work_order_id).

4. The WorkLink integration receives Webhook event notifications from the Scope AR platform that there is new data that the application is interested in.

5. The WorkLink integration queries the Scope AR GraphQL API to retrieve the ScenarioSession data identified by the Webhook payload resource_id (see Scenario Session Data Sample Queries ).

6. The WorkLink integration inspects the data retrieved for the value of ScenarioSession.externalData.work_order_id

7. The WorkLink integration then associates the retrieved Scenario Session data with the work order in the customer’s system-of-record (using system-of-record APIs, or similar) using available APIs from the system-of-record.

Scheduled Data Import/Analytics

Problem

As an analyst, I want to merge import data from the Worklink system the Scope AR platform on a regular basis so I can visualize the data with my internal BI tools to visualize the data.

Application

• Advanced visualization of WorkLink data, merged with customer system of record data.

• Pull WorkLink system data to integrate with Security Information and Event Management systems. (Coming soon)

...

Orchestration

1. Customer system is configured to automatically query the GraphQL endpoint to receive the data fields necessary to perform any internal analysis.

2. Customers can transform JSON format into CSV to merge with System of Record data.

...

Solution

I will use a custom internal application and the Scope AR GraphL API to retrieve Scenario Session data and store in a Data Store that my BI tools can read.

Procedure

...

Customer creates a custom application that:

• Queries the Scope AR GraphL API on a regular basis.

• Translates the JSON response into a Schema most compatible with customer’s needs.

• Stores the translated data to customer’s Data Stores.

Call Integration

As a field service technician, I want an easy way to launch a call from our service desk application so that it’s associated with the active job id.

As an analyst, I want to measure time-to-resolution metrics for jobs that had AR Remote Assistance calls to measure ROI.

Application

• Simplified calling

• Closed loop service desk SLA metrics.

...

Orchestration

1. Users are assigned call IDs that can be integrated with a system of record (like a service desk tool’s contact list)

...

1. . This can then be used to initiate a call to that user and external data can be added for case id or any other record id.

2. The deeplink then launches application and calls a specific contact that is specified within the deeplink.

3. The call is connected and the external data included in the deeplink is stored within the session data.

4. The call’s session data is sent to the CMS to be stored with the external data included.

5. A webhook is triggered when the call session data is stored in the CMS.

6. The system of record (or some middleware application) is triggered by the webhook which then queries the CMS API for the full details of the call session.

7. The call session is then stored in the system of record, using the external data from the deeplink as the cross-reference info to connect the call session data to other records in that system.