LogoLogo
AboutSupport
2.2
2.2
  • Unifi Documentation
  • Release
    • Release Notes
      • 2.1 Release Notes
      • 2.0 Release Notes
    • Hotfixes
    • Setup
  • Overview
    • Quick Tour
    • Supported Features
    • Application Module Overview
  • Integration Guides
    • Outbound Incident Guide
      • Getting Started
      • Process
      • Integration
      • Connection
      • Trigger
      • Create Scenario
        • CreateIncidentResponse Message
        • CreateIncidentResponse Fields
        • CreateIncident Message
        • CreateIncident Fields
        • Test CreateIncident
      • Update Scenario
        • Response Message
        • UpdateIncident Message
        • UpdateIncident Fields
        • Test UpdateIncident
      • Resolve Scenario
        • ResolveIncident Message
        • ResolveIncident Fields
        • Test ResolveIncident
      • Build - Integration Level
      • Conclusion
    • Bidirectional Asynchronous Incident Guide
      • Getting Started
      • Process
      • Web Service
      • Integration
      • Connection
      • Trigger
      • Create Scenario
        • Response Message
        • CreateIncidentReceipt Message
        • CreateIncidentReceipt Fields
        • CreateIncident Message
        • CreateIncident Fields
        • Test CreateIncident
      • Update Scenario
        • Receipt Message
        • UpdateIncident Message
        • UpdateIncident Fields
        • Test UpdateIncident
      • Resolve Scenario
        • ResolveIncident Message
        • ResolveIncident Fields
        • Test ResolveIncident
      • Build - Integration Level
      • Build the Other Half
        • Move the Integration
        • Reconfigure the Connections
      • Conclusion
    • Incident Update Poller Guide
      • Polling
        • Poll Processor
        • Poller
      • Inbound Message
        • UpdateIncidentInbound Message
        • UpdateIncidentInbound Fields
      • Message Identification
      • Bond Identification
        • Edit Incident Form
        • Edit CreateIncident Message
      • Test Update Poll
      • Conclusion
    • Incident Multiple Message Poller Guide
      • Polling
        • Poll Processor
        • Poller
      • Inbound Messages
        • ResolveIncidentInbound Message
        • ResolveIncidentInbound Fields
      • Testing
        • Test UpdateIncidentInbound
        • Test ResolveIncidentInbound
      • Conclusion
    • Incident Create Poller Guide
      • Polling
        • Connection Variables
        • Poll Processor
        • Poller
      • Messages
        • CreateIncidentInboundReceipt Message
        • CreateIncidentInboundReceipt Fields
        • CreateIncidentInbound Message
        • CreateIncidentInbound Fields
      • Build - Integration Level
      • Test Create Poll
      • Conclusion
    • Incident Parent and Child Poller Guide
      • Polling
        • Connection Variables
        • Child Poll Processor
        • Child Poller
        • Parent Poll Processor
        • Parent Poller
      • Inbound Messages
      • Testing
        • Test UpdateIncidentInbound
        • Test ResolveIncidentInbound
      • Conclusion
    • Incident Attachment Poller Guide
      • Polling
        • Connection Variables
        • Edit Endpoint URLs
        • Get Attachment Poll Processor
        • Get Attachment Poller
        • Select Attachments Poll Processor
        • Select Attachments Poller
        • Edit Child Poll Processor
        • Edit Child Update Poller
      • Messages
        • AddAttachmentInbound Message
      • Testing
        • Test Outbound Scenarios
        • Test CreateIncidentInbound
        • Test UpdateIncidentInbound
        • Test ResolveIncidentInbound
        • Test AddAttachmentInbound
      • Conclusion
  • Feature Guides
    • Packager Feature Guide
      • Instructions
    • Error Handling Tools Feature Guide
      • Retry
      • Replay
      • Ignore
      • Repair
      • Pause and Resume
  • Bonding
    • Bonds
    • Bonded Attachments
  • Transport
    • Transport Data Flow
    • Transactions
    • Stages
    • HTTP Requests
    • Response Actions
  • Configuration
    • Processes
    • Integrations
    • Connections
    • Messages
    • Message Scripts
    • Fields
    • Field Maps
    • Event Actions
  • Polling
    • Pollers
    • Poll Processors
    • Poll Requests
    • Large Response Payloads
  • Administration
    • Activity Logs
    • Data Stores
    • Properties
    • Scheduled Scripts
    • System Logs
    • Self-test
  • Scripting
    • Variables
    • Snippets
  • Attachments
    • Attachment Handling
    • Multipart Form Data
Powered by GitBook
On this page
  • Create an Inbound User (external instance)
  • Edit the Connection (external instance)
  • Create a Test Connection (internal instance)
  • Outbound Connectivity
  • Connection Details
  • View Connections

Was this helpful?

Export as PDF
  1. Integration Guides
  2. Bidirectional Asynchronous Incident Guide
  3. Build the Other Half

Reconfigure the Connections

The next step in building the other half of the Integration is to reconfigure the connections.

PreviousMove the IntegrationNextConclusion

Last updated 2 years ago

Was this helpful?

Now that both halves of the Integration are in place, we need to reconfigure each of the Connections to point to the other instance. Before doing that though, we need to create a new Inbound User for the external instance.

Create an Inbound User (external instance)

To configure our Integration user:

In native ServiceNow, navigate to User Administration > Users. Click New.

The fields to be configured for the User record are as follows:

#

Field

Description

Value

1

User ID

The id of the user (to be used by the external system for authentication).

<your.integration.user>

2

First name

The integration user's first name.

<Your First Name>

3

Last name

The integration user's last name.

<Your Last Name>

4

Password

The user's password (to be used in basic authentication).

<Your Password>

5

Roles

The role required for access to the integrated records.

<roles needed, e.g. itil>

This Inbound user will become the Outbound user in the other instance. We will need to update the other instance accordingly.

Edit the Connection (external instance)

We are going to edit the existing 'Development' Connection so that it will become our 'Test' Connection and use the Inbound user just created.

We will need to have our other instance point to this external one also (not only to itself). Therefore, we will create a new 'Test' Connection in the other instance to do that. (See the .)

In Unifi Integration Designer, navigate to the 'Connections' icon.

6) Click to open the previously created Development Connection to edit it.

Edit the values in the Connection as follows:

#

Field

Description

Value

7

Environment

The environment this connection applies to.

'Test'

8

Inbound user

The user profile used by the external system for authentication.

<Your Inbound user*>

*Inbound user created above.

Your Connection form should look like this

We have not updated the Endpoint URL nor the Outbound User because they already contain the correct values (i.e. the internal instance's Endpoint & Inbound user).

9) Save the Connection.

Create a Test Connection (internal instance)

Back in the internal instance, navigate to the 'Connections' icon. Click New.

We could have edited our existing 'Development' Connection to point to the external instance (instead of itself). We have chosen instead to create a new 'Test' Connection to do that. That way we have two Connections, a 'Development' Connection which points to itself and a 'Test' connection which points to the external instance.

The fields to be configured for the New Connection modal are as follows:

#

Field

Description

Value

10

Environment

The environment this connection applies to.

'Test'

11

Endpoint URL

The external system's access URL.

<External system Endpoint URL>

12

Active

Use this connection for the integration when true.

<true>

Outbound Connectivity

The format of the Endpoint URL is as follows:

https://<your_instance>.service-now.com/<your_resource_path>

For this Test environment Connection, we have edited the Development Connection, changing the <your_instance> element of the Endpoint URL to point to the external system instance (leaving the <your_resource_path> element unchanged). For our Outbound User we have used the external system's Inbound User (as created above).

Your New Connection modal should look like this:

13) Submit and view to further configure the Connection.

Clicking ‘Submit’ will redirect you to the list view of the record you’re creating. Clicking ‘Submit and view' will redirect you to the newly created record.

Connection Details

The fields to be configured for the Details form are as follows:

#

Field

Description

Value

14

Authentication

The authentication method to use for this connection.

'Basic'

15

User*

The username used in basic authentication.

<external.system.user>

16

Password*

The password used in basic authentication.

<External system user password>

17

Inbound user

The user profile used by the external system for authentication. An active connection must be found for the user to gain access.

<lookup: Your Inbound User>

(External) User/Password: As created above & set in the external instance.*

Your Details form should look like this:

18) Save the Connection.

View Connections

There will now be both a Development and a Test Connection for your Integration. Only the Test Connection should be Active.

These can be viewed by clicking the 'Connections' icon.

We have completed building the other half of the Integration. We are now ready to go back and repeat the Testing for each of the scenarios we've built.

See the following pages:

Test CreateIncident
Test UpdateIncident
Test ResolveIncident
next section