Integrate your local and remote ServiceNow instances to export, import, and manage records from your local instance.

Request apps on the Store

Visit the ServiceNow Store website to view all the available apps and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.

Integration Hub subscription

This spoke requires an Integration Hub subscription. For more information, see Legal schedules - IntegrationHub overview.

Spoke version

ServiceNow Remote Instance spoke v2.2.7 is the latest version.

Supported versions

This spoke was built for the Orlando version and later.

Spoke dependencies

If you’re having trouble installing the app, ensure that these dependent plugins are installed:
  • ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
  • ServiceNow IntegrationHub Action Template - Data Stream (com.glide.hub.action_type.datastream)
  • Complex Object (com.glide.cobject)
  • ServiceNow Flow Designer - Dynamic Outputs (com.glide.hub.dynamic_outputs)
  • ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
  • ServiceNow Flow Designer - Dynamic Inputs (com.glide.hub.dynamic_inputs)
Note: Some of these plugins are licensable features and require appropriate licenses, if used outside the spoke implementation.

Spoke requirements

Ensure that the spoke users have only the required minimum permissions to access data in ServiceNow tables. Do not assign elevated privilege roles to users of this spoke unless very much required. This practice ensures controlled access to data.
Note: The terms remote instance and local instance are used in these contexts:
  • Local instance: This is the ServiceNow instance from which the communication is initiated and established.
  • Remote instance: This is the ServiceNow instance with which the local instance communicates.

Spoke actions

The ServiceNow Remote Instance spoke provides actions to export, import, and manage records when events occurs in your local ServiceNow instance. Available actions include:

Category Action Description
Change request Management Export Change Request Record Exports a change request record to a remote instance from the local instance.
Import Change Request Record Imports a record from the Change Request table of the remote instance to the local instance.
Incident Management Export Incident Record Exports an Incident record to a remote instance from the local instance.
Import Incident Record Imports a record from Incident table of the remote instance to the local instance.
Problem Management Export Problem Record Exports a Problem record to a remote instance from the local instance.
Import Problem Record Imports a record from Problem table of the remote instance to the local instance.
Table Management Look Up Fields By Remote Table Retrieves all the fields from the given remote table.
Look Up Local Import Set Tables Retrieves information about the given local import set table.
Look Up Remote Import Set Tables Retrieves information about the given remote import table.
Look Up Remote Tables Retrieves information about the given remote table.
Attachment Management Copy Attachment From Remote Instance Copies the required attachment from the remote instance.
Note: You must select the required attachment using data pills only.
Copy Attachment To Remote Instance Copies the required attachment to the remote instance.
Note: You must select the required attachment using data pills only.
Look Up Local Attachments Names Retrieves name of the required attachment.
Case Management Export Case as Incident Exports a case record as an incident record to a remote instance from the local instance.
Export Case Record Exports a case record to the remote instance from the local instance.
Export Case Task Record Exports a Case Task record to the remote instance from the local instance.
Export Incident as Case Exports an incident record as a case record to the remote instance from the local instance.
Import Case as Incident Imports a record from the case table of the remote instance as an incident record to the local instance.
Import Case Record Imports a record from the Case table of the remote instance to the local instance.
Import Case Task Record Imports a record from the Task table of the remote instance to the local instance.
Import Incident as Case Imports a record from the Incident table of the remote instance as a case record to the local instance.
Record Management Create or Update Remote Record Creates a record or updates an existing record in the remote instance.
Create or Update Remote Record Using Import Set Creates a record in the remote import set.
Create Remote Record Creates record in remote instance.
Delete Remote Record Deletes record in remote instance.
Export Record Using Import Set Exports a record from the selected local table to a remote instance.
Get Remote Record Retrieves the required record information from the remote instance.
Import Record Using Import Set Imports a record from table in the remote instance to the local instance.
Look Up Remote Record Retrieves the required record from the remote Instance.
Look Up Remote Records Retrieves multiple records from the remote instance table.
Update Remote Record Updates the required record in the remote instance.
Note: The Company field is required to import or export records using the default transform maps. However, users can modify the transform maps as per their requirement. Also, use the import sets when working with integration involving data transfer.

Spoke transform maps

The ServiceNow Remote Instance spoke provides sample transform maps in active state and associated sample target tables to demonstrate using transform maps to save the remote ServiceNow instance data in your local ServiceNow tables. You can use these sample transform maps and target tables as reference to create transform maps as per your requirement.

For more information, see Transform maps.

Note:
  • By default, the sample transform maps uses sys_id as the coalesce field. You can customise the transform map script as per your requirement to change the coalesce field.
  • By default, the export and import actions use the spoke tables. You can change this to use different import sets.
  • The time zones may be different in your ServiceNow instances. Ensure that you customise flows accordingly.

Connection and credential alias requirements

Integration Hub uses aliases to manage connection and credential information. Using an alias eliminates the need to configure multiple credentials and connection information profiles when using multiple environments. If the connection or credential information changes, you don't need to update any actions that use the connection. For more information, see Connections and Credentials.

Two connection and credential aliases are required for this spoke; one for the local instance and other for the remote instance. For information about setting up the spoke, see Set up the ServiceNow Remote Instance spoke.