Task: Create TOPdesk change
Prerequisites
TOPdesk 3.0.x environment
Description
This task will create a new change in TOPdesk.
System variables (Create TOPdesk change)
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 | 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. |