Environment
TeamDynamix, iPaaS
Issue
Admins need to know how to create ticket tasks using iPaaS JSON
Resolution
We recommend testing your workflows in the Sandbox environment.
- From within a TeamDynamix workflow, create a new step with the type ‘TeamDynamix iPaaS'.
- Name the workflow step.
- The name can indicate what the step does.
- Choose Ticket: Create Task in the iPaaS Flow field.
- Choose Latest Published Version in the iPaaS Flow Version field.
- Add appropriate JSON in the Additional Arguments field.
- See example code snippets below for acceptable values for the Additional Arguments JSON field.
- Save the workflow step and connect it in the workflow.
Important: Do not connect this flow directly to another call of this flow. It will fail. There must be a different flow or step type between calls of this flow, or a timer.
Accepted value details for Ticket: Create Task
A feed entry will be added to the source ticket and the target ticket referencing the ticket ID and application created and created from.
* Ensure the values are valid for the specific application, whether they're entered as a parameter value or defaulted from the existing ticket value.
| Value name |
Acceptable value details |
|
appID
|
The target application id value.
If no value is passed, the current ticket appID will be set.
|
| formID |
The target form id value.
If no value is passed, the application default form will be set.
|
| *accountID |
The account id value.
If no value is passed, the current ticket accountID will be set.
|
locationID
Setting the standard Location attribute |
The location id value.
- Int32
- Pass custom attribute ID in “{{}}”
- Pass current ticket location as “{{Location}}”
|
locationroomID
Setting the standard Location Room attribute
|
The location room id value.
- Int32.
- Pass current ticket location room as “{{LocationRoom}}”
|
locandroomID
Only use when passing the custom attribute: Location and Room
|
Used to set the standard Location and Location Room attributes from a Location and Room custom attribute.
Be sure to NOT pass values for locationID and locationroomID
- Pass custom attribute ID in “{{}}”
|
| titleattrib |
The values will be set as the title of the ticket.
- Use []
- Pass custom attribute ID in “{{}}”
- Text string value in quotes
- Pass the current ticket title, location, or account enter “{{Location}}” or “{{Account}}” or “{{Title}}”
If no value is passed, the current ticket title will be set.
|
| descrattrib |
The values will be added to the description of the ticket. Text string values accept html.
- Use []
- Pass custom attribute ID in “{{}}”
- Text string value in quotes
- Pass the current ticket account or location enter “{{Location}}” or “{{Account}}”
If no value is passed, the current ticket description will be set.
|
| taskdescrattrib
|
Pass the current ticket description to the “descrattrib” value passed of the new ticket.
- Set to “Yes” to add the current ticket description.
- Set to “No” to not add the existing ticket description.
If no value is passed, it defaults to “No”.
|
| * respgroup |
The responsible group id value.
If no value is passed, the current ticket responsible group will be set if the source and target appIDs are the same. If they are not the same, the ticket will be Unassigned if there is no form default.
|
| * targetattrib |
The type id value.
*If creating a ticket in another application, the type id value needs to exist in the appID entered. Otherwise the flow will fail.
|
Examples
A Ticket Task will be created in a MiWorkspace Onboarding ticket using the ITS-MiWorkspace Onboarding form.
The source custom attribute values and string text:
Title = Provision Crashplan - No Hardware Needed
Responsible = ITS-SCComputeandCollabSupport
Description = Please onboard, Phuong Hoang, 05/15/2023, Service Support
{"titleattrib": ["Provision Crashplan - Unit"],
"respgroup": 169,
"taskdescrattrib": ["Please onboard","{{1917}}","{{12226}}","{{2161}}"]}
A Ticket Task will be created in a Change Exception ticket using the ITS-Change Exception Request form.
The source custom attribute values and string text:
Title = Create new Permanent Exception Maintenance Window
Responsible = ITS-MigrationsandScheduling
Description = Department Manager, Rhian Copeland, TeamDynamix,
{"title": "Create new Permanent Exception Maintenance Window",
"respgroup": 83,
"taskdescrattrib": ["Department Manager","{{4195}}","{{4196}}"]}
Additional Information
Video: Configure Workflow
Need additional information or assistance? Submit a request here ITS-TeamDynamix Support.