The Parature Operation defines how to interact with your Service Desk data. The Operation represents a specific action (e.g. Get, List, Create, Update, or Delete) to be performed against a specific Parature record type or object (e.g. Account, Customer, Ticket, etc.). Not all actions are available for every object. You will need to create a separate Operation Component for each action/object combination required for your integration. The Operation browses your object definitions in real time to get any custom fields you may have defined.
Important: A given Operation Component is tied to a specific Department. If you have multiple Departments in your Service Desk, you will need to create a separate "version" of each Operation for each Department. For example, if your integration scenario needs to create new Account records in three Departments, you will need to create three separate "Create Account" Operation Components, specifying a different deptID for each.
The Operation supports two types of actions:
- Get - Used to retrieve data from Parature.
- Send - Used to send data to Parature.
GET Action - Options Tab
Use the Import button to launch the Import Wizard which will help you configure the Operation. The wizard will automatically generate the Response XML Profile.
| Field |
Description |
| Response Profile |
Auto-generated XML Profile for the response message. |
Filters
To add a filter to the Operation:
- Click the Add (
) button to create a new filter.
- Select the filter and then configure the settings to the right.
You will provide static or dynamic values for the filter(s) when you use the Operation in a Connector Shape, Decision, Map Function, or other Component.
If multiple filters are created, only records that match all the conditions will be returned. For example, records must match filter 1 AND filter 2 AND filter 3 AND so on.
To remove a filter, select it and click the Delete ( 
) button.
| Field |
Description |
| Filter Name |
User-defined name for the filter. |
| Field |
The actual Parature field to filter by. Click the Browse (  ) button to choose from the list of available fields for the current record type. |
| Operator |
Choose a comparison operator from the list. Available operators will vary by the type of field selected but include:
- EqualTo
- Greater Than or Equal To
- Less Than or Equal To
|
SEND Action - Options Tab
Use the Import button to launch the Import Wizard which will help you configure the Operation. The wizard will automatically generate the Request XML Profile.
| Field |
Description |
| Request Profile |
Auto-generated XML Profile for the request message. |
Include History?
(Retrieve action only) |
If checked, the record's history is returned including all changes made to the record. |
Purge?
(Delete action only) |
If checked, the record will be completely deleted and cannot be recovered. Otherwise, the record will be moved to trash bin. Note: Not all record types can be "trashed" and therefore must be purged. |
Import Wizard
Step 1 - Parature Connection and Department
Choose the Connection and enter the Department ID and click Next. You can get the Department ID for a given department by logging into the Service Desk within that department and going to Setup -> Customization -> Customize Portal -> Portal Link. The URL/link to the department's portal contains the deptID value.
Step 2 - Parature Object and Action
Choose the Parature data object and action and click Next. Not all actions are available for every object.
Step 3 - Review
Review and click Finish. The Request or Response Profile is auto-generated.
Archiving Tab
Click here for more information on Archiving.
This page
Other pages
Account
