# Integration

## New Integration

In the **Unifi Integration Designer** window, after clicking either on the '**+**' **tile** or '**New Integration**', you are given a 'New Integration' modal to complete.

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

|  #  | Field          | Description                                                                                                 | Value        |
| :-: | -------------- | ----------------------------------------------------------------------------------------------------------- | ------------ |
|  1  | Name           | The name of the integration.                                                                                | \<Your Name> |
|  \* | Service type   | The type of web service this integration is using *(Choices: SOAP/REST)*.                                   | 'REST'       |
|  \* | Message format | Automatically pre-process incoming messages for simpler message scripting. *(Choices: XML, JSON, Advanced)* | 'JSON'       |

{% hint style="info" %}
\*Service type/Message format:  these values are defaulted.
{% endhint %}

*Your 'New Integration' modal should look like this:*

![](https://2404534899-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQBk35gIi557UHt7QlJ%2F-MeOtKgqmt0n6zKJNRDU%2F-MeP493RKfysKtYZ7Okm%2FOBIG%20-%20Integration%201.png?alt=media\&token=886555c7-5063-44ed-b181-d4b81aeebce2)

{% hint style="info" %}
We have chosen to name this integration 'Push-Pull Incident' as it will also later form the basis for the Poller Guides (where we pull data from your Personal Developer Instance, ‘PDI’).
{% endhint %}

2\) Click **Create**.

You will be redirected to the Details page of the newly created Integration.

## Icons

{% hint style="info" %}
Before continuing we would like to draw your attention to some of the relevant icons that are now visible down the left hand navigation strip.
{% endhint %}

![](https://2404534899-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQBk35gIi557UHt7QlJ%2F-MeOtKgqmt0n6zKJNRDU%2F-MeP73qRZcIYPp7kgZ1f%2FOBIG%20-%20Integration%202.png?alt=media\&token=bf8d68f4-1d4e-45aa-a889-fe529042fc5f)

*The icons are:*

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

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

c) ***'Fields' icon*****:** Opens the current integration's Fields page.

d) ***'Field Maps' icon*****:** Opens the current integration's Field Maps page.

e) ***'Documentation' icon*****:** Opens the automatically generated documentation for the current integration. *(Another awesome feature in **Unifi**.)*

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

## Details

*The Details page of your Integration form should look like this:*

![](https://2404534899-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQBk35gIi557UHt7QlJ%2F-MeOtKgqmt0n6zKJNRDU%2F-MePY29NPHyp5qFU90Eh%2FOBIG%20-%20Integration%203.png?alt=media\&token=c5703fda-ff24-48b8-b743-f445db45a612)

3\) Navigate to **Settings > Feedback**.

## Feedback Settings Fields

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

|  #  | Field              | Description                                                                                                                                                                                     | Value   |
| :-: | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
|  4  | Enable UI messages | Allow information and error messages to be shown to the user as UI Notifications. Only applies to certain notifications.                                                                        | \<true> |
|  5  | Note bond history  | Use the 'Note bond history' to process bond history updates.  *(Set to true for the history to be promoted to the work notes fields of the record we're integrating - for the analyst to view)* | \<true> |

*The Feedback Settings fields should look like this:*

![](https://2404534899-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQBk35gIi557UHt7QlJ%2F-MeOtKgqmt0n6zKJNRDU%2F-MePZTL0lrHSasewN7ga%2FOBIG%20-%20Integration%204.png?alt=media\&token=1982b26c-13ac-44f1-bf5b-015d08d2a334)

{% hint style="info" %}
The remaining 'Integration' values are to be left as-is:

* Message Identification

All of the remaining 'Settings' values are to be left as-is:

* Attachments Settings
* Bond Settings

All of the 'Error handling' values are to be left as-is:

* General
* Timeouts
* Retry&#x20;
  {% endhint %}

6\) Click **Save**.

7\) Click the **'Connections' icon** to move on and configure the **Connection**.