Prerequisites
- TOPdesk 3.0.x environment
Description
This task will create a new change in TOPdesk.
System variables
For this task a system configuration can be made. At ‘Automation’ -> ‘Systems’ -> ‘Create System’ select TOPdesk. Specify a valid TOPdesk URI, TOPdesk username and a TOPdesk password. For this task it is also possible to specify these values in the task editor, this will overwrite the system settings.
Variables
Name |
Description |
Type |
Example |
Comment |
TOPdesk System |
The system variables which contain URI, Username and Password |
List |
TOPdesk |
Configure these settings before running the task at ‘Automation’->’Systems’. |
TOPdesk URL |
The TOPdesk URL |
List |
topdesk.enyoi.org |
Specify the TOPdesk URL. If specified the URL from the system settings is ignored |
Username |
Specify a username to make the call |
String |
j.doe |
Specify the TOPdesk username. If specified the username from the system settings is ignored |
Password |
Specify a password for the username |
String |
Password123! |
Specify the TOPdesk password for the username specified. If specified the password from the system settings is ignored |
Requester Email |
Specify the requester email |
String |
j.doe@enyoi.org |
Mandatory parameter to specify the requester |
Request |
Specify the name of the request |
String |
New laptop |
Optional parameter for the request |
Action |
Specify the action |
String |
Order new laptop |
Optional parameter to specify the action of the change |
Brief Description |
Specify the brief description |
String |
Laptop for employee John Doe |
Mandatory parameter to specify the brief description |
Template |
Specify the template |
String |
Custom template |
Optional parameter to specify the template. Filled in parameters overwrite the values from the template. |
Category |
Specify the category |
String |
Salary |
Optional parameter to specify the category. Please make sure this is an existing category |
Sub Category |
Specify the sub category |
String |
Payments |
Optional parameter to specify the sub category. Only evaluated when category is specified and corresponds with this sub category |
Change Type |
Specify the change type |
String |
‘simple’ or ‘extensive’ |
Mandatory parameter to specify the change type. Default is simple |
External Number |
Specify the external number |
String |
C12345 |
Optional parameter to add an external number |
Impact |
Specify the impact |
String |
Person |
Optional parameter for the impact. Only existing values can be set. Please keep in mind that ‘Impact’, ‘Benefit’ and ‘Priority’ are linked fields and their values can affect another |
Benefit |
Specify the benefit |
String |
Cost reduction |
Optional parameter to specify the benefit. Only existing values can be set. Please keep in mind that ‘Impact’, ‘Benefit’ and ‘Priority’ are linked fields and their values can affect another |
Priority |
Specify the priority |
String |
P1 |
Optional parameter to specify the priority. Only existing values can be se.t Please keep in mind that ‘Impact’, ‘Benefit’ and ‘Priority’ are linked fields and their values can affect another |
Operator |
Specify if it is an operator |
Switch |
‘On’ or ‘Off’ |
If set to ‘On’ the incident will be created as an operator. If set to ‘Off’ the incident will be created as a person. Please note that valid credentials are needed for both options |
Status |
The status on which the change will be closed |
String |
Denied |
If specified, the change will be closed after it has been created. |