Connection Variables

Connection Variables can be especially useful if you have multiple connection environments - e.g. Dev, Test, Prod - each containing different data.

Although having multiple environments may not apply to this integration, we will create Connection Variables to contain certain data values which will be substituted into the Poll Processor scripts.

Instead of scripting data values directly into the code of your Poll Processor scripts, it may be better practice to use Connection Variables in their place. Not only does it make those scripts cleaner, but it also means that changes in requirements can be more easily enacted by changing the values of the data in those variables, without having to change the code in the scripts.

We will create an additional two Connection Variables to identify the Child Pollers we shall be creating.

Icons

Before continuing we would like to draw your attention to some of the relevant icons that will be visible down the left hand navigation strip in Unifi Integration Designer.

The icons are:

a) 'Integration' icon: Opens the current integration's Details page.

b) 'Pollers' icon: Opens the current integration's Pollers page.

c) 'Poll Processors' icon: Opens the current integration's Poll Processors page.

d) 'Connections' icon: Opens the current integration's Connections page.

Variable: get_attachment_poller

This variable will contain the sys_id of the child Poller which we will create on the 'Get Attachment Poller' page of this Guide. Once you have created the Poller, copy the sys_id and paste it as the value in this variable.

To open Unifi Integration Designer, navigate to Unifi > Unifi Integration Designer, then navigate to < Your Integration > (created following the Outbound Incident Guide).

Click the 'Connections' icon, then navigate to and open < Your Connection >.

From the Connection, navigate to Connection > Variables & click New.

The 'get_attachment_poller' New Connection Variable fields to be configured are as follows:

#	Field	Description	Value
1	Key	A unique name that will be used to get the value.	'get_attachment_poller'
2	Value	The variable value to be used in the integration.	<Your Value>*
3	Description	Describe what this connection variable is for and how it should be used.	<Your Description>

*Value may vary. Use the sys_id of the Poller you will create from the Get Attachment Poller page.

Your 'get_attachment_poller' New Connection Variable modal should look like this:

4) Click Submit.

You will be redirected back to the Variables page of the Connection record.

Variable: select_attachments_poller

This variable will contain the sys_id of the child Poller which we will create on the 'Select Attachments Poller' page of this Guide. Once you have created the Poller, copy the sys_id and paste it as the value in this variable.

From the Connection, navigate to Connection > Variables & click New.

The 'select_attachments_poller' New Connection Variable fields to be configured are as follows:

#	Field	Description	Value
5	Key	A unique name that will be used to get the value.	'select_attachments_poller'
6	Value	The variable value to be used in the integration.	<Your Value>*
7	Description	Describe what this connection variable is for and how it should be used.	<Your Description>

*Value may vary. Use the sys_id of the Poller you will create from the Select Attachments Poller.

Your 'select_attachments_poller' New Connection Variable modal should look like this:

8) Click Submit.

The following Connection Variables should now be in place for your Connection:

Now let's move on and edit the Endpoint URLs.