UpdateIncident Fields
We will utilise the Field & Field Map records to configure the Message Scripts for the UpdateIncident Message.
Field: incident.short_description
The 'incident.short_desccription' (Integration level) Field record should already be in place (i.e. with Active set to false). Creating the Message level counterpart is now easier than ever.
From the UpdateIncident page, navigate to Message > Fields.
![](https://docs.sharelogic.com/~gitbook/image?url=https%3A%2F%2F2763208740-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZR0dkdEH0Mm7amiIzsdG%252Fuploads%252F8ICQo2O9Qu2cmZ1lumEu%252Fobig-updateincident-fields-1.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=297ec2ff&sv=1)
Find the incident.short_description (Integration level) Field & set Active to true.
The 'Build Integration' button becomes visible in the banner and the empty circle icon next to the Field name turns green & contains a green 'check' (to indicate that Message level configuration exists for this Field).
By simply setting the Active flag to true on the Integration level Field record listed on the Message, Unifi has automatically created the Message level counterpart. The Integration level record still exists (and can be seen when you click on the 'Fields' icon to navigate to the Fields page), but is no longer visible in the list view on the Message because the Message level record has been created.)
Hints & Tips: Unifi automatically creates Integration level Fields when we first create the Message level equivalent records; those Integration level Fields are visible on the Fields list of the Messages we subsequently create. Therefore, if a Field is required for multiple Messages, create it once for the first Message and then simply set active to true for its Integration level counterpart from the Fields list of each of the relevant Messages that Field is required on.
We will now configure Field records for two other Incident record field elements.
Fields & Field Maps
The table below lists the Incident fields above and the relevant Field Maps required to configure each Field record.
Incident Field | Field Map |
---|---|
comments | 'PI - String'* |
work_notes | 'PI - String'* |
We have chosen String type here because we are integrating with the table API. This will return the contents of those fields as a string value. If we were integrating Unifi to Unifi we may use a Journal field type which would return an array of comments objects with "text", "created_on", "created_by" & "published" elements.
*Field map: Values may vary (dependent on your configuration of the copies). Choose the copy Field Maps you created earlier.
Field: incident.comments
Because the incident.comments Field record is the same 'type' (IS - String) & the majority of the settings are the same as the previously configured Field, it will be quicker to copy the incident.short_description Field & make a few minor changes.
![](https://docs.sharelogic.com/~gitbook/image?url=https%3A%2F%2F2763208740-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZR0dkdEH0Mm7amiIzsdG%252Fuploads%252FZHJ7MKSPZr8LfWot7Fh9%252Fobig-updateincident-fields-2.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=1265ce99&sv=1)
Click the ellipsis next to the incident.short_description Field record & click Copy.
The fields to edit for the Copy Field modal are as follows:
Field | Description | Value |
---|---|---|
Element | The field on the source/target table this Field record is mapped to. | Additional comments |
Property* | The property in the payload the data will be written to. | Automatically populated |
Description | Describe what this field is for and any specific details that might help you in future. | 'The incident's comments' |
*This field is automatically populated.
Your Copy Field modal should look like this:
![](https://docs.sharelogic.com/~gitbook/image?url=https%3A%2F%2F2763208740-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZR0dkdEH0Mm7amiIzsdG%252Fuploads%252F3sm7fzwInAg63KwNuLFi%252Fobig-updateincident-fields-3.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=d863d33d&sv=1)
Click Copy.
You will be redirected to the Details page of the newly created incident.comments Field record.
Field: incident.work_notes
It will again be quicker to copy the previously configured incident.comments Field & make a few minor changes.
To quickly navigate back to the UpdateIncident Message, click the 'Preview' icon next to the Message field on the Details page of newly created incident.comments Field record.
![](https://docs.sharelogic.com/~gitbook/image?url=https%3A%2F%2F2763208740-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZR0dkdEH0Mm7amiIzsdG%252Fuploads%252Fz3lbvd7f2k3QvnnplHgI%252Fv2-fields-updateincident-4.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=4d3572a7&sv=1)
Navigate to Message > Fields.
![](https://docs.sharelogic.com/~gitbook/image?url=https%3A%2F%2F2763208740-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZR0dkdEH0Mm7amiIzsdG%252Fuploads%252F2IsyOS0Y8ftwrRu9pVIG%252Fobig-updateincident-fields-4.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=d4c2da1c&sv=1)
Click the ellipsis next to the incident.comments Field record & click Copy.
The fields to edit for the Copy Field modal are as follows:
Field | Description | Value |
---|---|---|
Element | The field on the source/target table this Field record is mapped to. | 'Work notes' |
Property* | The property in the payload the data will be written to. | Automatically populated |
Description | Describe what this field is for and any specific details that might help you in future. | 'The incident's work notes' |
*This field is automatically populated.
Your Copy Field modal should look like this:
![](https://docs.sharelogic.com/~gitbook/image?url=https%3A%2F%2F2763208740-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZR0dkdEH0Mm7amiIzsdG%252Fuploads%252FDUfIdUqh2At0DgwiPH62%252Fobig-updateincident-fields-5.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=f976632e&sv=1)
Click Copy.
You will be redirected to the Details page of newly created incident.work_notes Field record.
Build
Now that we’ve configured the Field records for the UpdateIncident message, we are ready to build our message scripts.
Navigate to the UpdateIncident Message, then navigate to Message > Fields.
The following Field records should now be in place for your UpdateIncident messsage:
![](https://docs.sharelogic.com/~gitbook/image?url=https%3A%2F%2F2763208740-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZR0dkdEH0Mm7amiIzsdG%252Fuploads%252Fab3ThucCgnZdQh4dPGJo%252Fobig-updateincident-fields-6.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=5ab853e8&sv=1)
Click on Build Message.
You will see the 'Message build successful' Info Message.
![](https://docs.sharelogic.com/~gitbook/image?url=https%3A%2F%2F2763208740-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZR0dkdEH0Mm7amiIzsdG%252Fuploads%252FkWRZidpB79I78MTNNRgD%252Fv2-fields-updateincident-8%2520%281%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=d4432b84&sv=1)
Navigate to Advanced > Script Editor to view the auto-generated code.
Your Script Editor fields should look like this:
![](https://docs.sharelogic.com/~gitbook/image?url=https%3A%2F%2F2763208740-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZR0dkdEH0Mm7amiIzsdG%252Fuploads%252FDynP1kagSuLMOZ4a3ATB%252Fobig-updateincident-fields-7.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=cc4f1e8e&sv=1)
Message Scripts
The newly auto-generated code will appear between a Begin & End Comment immediately prior to any code that may already be there (pre-existing code will be retained).
We will now examine our new, auto-generated Message Scripts.
Source to Stage:
Stage to Request:
We are now ready to Test the UpdateIncident Message.
Last updated