Add Request Worklog
Compatibility: Add Request Worklog is compatible with ManageEngine Cloud; on Linux and Windows environments
Limitation: Currently, worklog can only be created for ManageEngine SDP Cloud deployment.
Reference: Cloud API documentation and common error codes: https://www.manageengine.com/products/service-desk/sdpod-v3-api/SDPOD-V3-API.html
Known issue: The step does not provide support input through Environment Variables.
Description
ManagedEngine SDP: Add Request Worklog step adds a worklog to an existing request in ManageEngine ServiceDesk Plus.
Configurations
| No. | Field Name | Description |
|---|---|---|
| General Tab: | ||
| 1 | Step Name | Name of the step. This name has to be unique in a single workflow. |
| Connection: | ||
| 1 | Deployment Type | Specify the Deployment type of the ManageEngine SDP instance. Select one from the dropdown i.e. either CLOUD or ON_PREMISE. Note: Auth Token is displayed when Deployment Type is ON_PREMISE. Client ID, Client Secret and Refresh Token are displayed when Deployment Type is CLOUD. |
| 2 | Base URL | Base URL of ManageEngine ServiceDesk Plus (e.g. https://sdpondemand.manageengine.com for on cloud instance) The data type is string. This field is mandatory. |
| 3 | Accept Values as variable/ static | Leave checkbox unchecked to accept Auth Token value from a field in the previous steps of the stream using a drop down list. Else enable checkbox for Auth Token field to appear as Text box. |
| 4 | Auth Token | Specify the API Key generated in ManageEngine ServiceDesk Plus instance. This field is visible when selecting the Deployment Type as “ON_PREMISE”. If checkbox above is enabled Auth Token field appears as Text box and accepts static values or variables. Else if checkbox above is disabled Auth Token field appears as a drop down containing values from previous steps. The data type is secure string. This field is mandatory. |
| 5 | Accounts Server URL | Specify the Accounts Server URL specific Data Centre of ManageEngine SDP instance (https://www.manageengine.in/products/service-desk/sdpod-v3-api/getting-started/data-centers.html). Note: This field is visible when the Deployment Type is “CLOUD”. |
| 6 | Client ID | Specify the Client ID of the client created in the ManageEngine SDP developer console. The data type is string. Client ID, Client Secret and Refresh Token are displayed when Deployment Type is CLOUD. |
| Client Secret: | ||
| 7 | Checkbox: Accept Value as variable/static | Leave checkbox unchecked to accept Client Secret value from a field in the previous steps of the stream using a drop down list. Else enable checkbox for Client Secret field to appear as Text box. |
| 8 | Client Secret | Specify the Client Secret of the client created in the ManageEngine SDP developer console. This field is visible when selecting the Deployment Type as “CLOUD”. The data type is secure string. |
| Refresh Token: | ||
| 9 | Checkbox: Accept Value as variable/static | Leave checkbox unchecked to accept Refresh Token value from a field in the previous steps of the stream using a drop down list. Else enable checkbox for Refresh Token field to appear as Text box. |
| 10 | Refresh Token | Specify the Refresh Token generated from the access token. This field is visible when selecting the Deployment Type as “CLOUD”. The data type is secure string. |
Known Issues:
- Even though the provided connection details may be valid, the “access_denied” error occurs intermittently for the cloud deployment.
- HTTP-401 unauthorized error occurs intermittently due to a limitation from ManageEngine SDP cloud.
| No. | Field Name | Description |
|---|---|---|
| Input Tab | ||
| Input Fields: | ||
| 1 | Accept Fields as JSON | Enable checkbox to accept field names as JSON input. In the JSON text you can have dynamic fields to insert rather than static fields to be provided in the Table Fields. Leave this unchecked to provide Table Fields as input. |
| 2 | JSON | The referenced field should have JSON text in a valid format to add a Worklog. About JSON text: If ‘Accept Fields as JSON’ checkbox is enabled this field is activated. Choose a field containing the JSON text. JSON text should contain key-value pairs enclosed by double quotes (“) enclosure. Provide all the required or mandatory fields as well as other fields to be inserted as keys in the JSON. Note: The JSON could be from any input step such as Generate rows, Text File input, Excel Input Et al. JSON text can only be accepted from input fields from previous steps and not as files directly. JSON text can also be specified by a parameter already defined. The data type is string. This field is optional. Sample JSON key value pairs: [ { "displayName": "Service", "value": "HR Service Desk" }, { "displayName": "Title", "value": "Test_KA10" } ] Note: - The supported format to provide DateTime values is “MMM dd yyyy hh:mm a” (E.g. Apr 19 2021 10:00 am). - The supported format for date is “MMM dd yyyy” (e.g. Apr 19 2021). - JSON format for checkbox should be as “fieldName”: “[Option-1, Option-2]”. - For Multi-select fields provide comma separated values. - The supported format for date is “MMM dd yyyy” (e.g. Apr 19 2021). JSON format for checkbox should be as “fieldName”: “[Option-1, Option-2]”. - For Multi-select fields provide comma separated values. |
| 3 | Request ID | ID of the Request for which worklog has to be added (One can get this ID from URL when we go to that particular request from ManageEngine SDP UI). |
| 4 | Button: Get | Click to get IDs of all the records of the provided form name/module name. Note: - The button will only work when static values or environment variables are provided for Connection details. Get button will not work if the previous step fields are provided for Connection. - On clicking get button, maximum 1000 worklog IDs are populated. |
| Table Fields: | Table Fields are enabled if ‘Accept Fields as JSON’ checkbox is unchecked. | |
| 5 | Variable Field Name | This field accepts values from previous fields in the stream/ environment variables or variables. Note: - One of either Variable Field Name or Static Field Name must be provided. If both are provided, then Static Field Name is taken - The group type fields are not supported in this plugin step. |
| 6 | Static Field Name | On click of this cell, fields associated with the request worklog are populated. The data type is string. This field is optional |
| 7 | Field Value | Valid values for the field associated with the field name. The data type is string. This field is mandatory. Note: - The supported format to provide DateTime values is “MMM dd yyyy hh:mm a” (E.g. Apr 19 2021 10:00 am). - The supported format for date is “MMM dd yyyy” (e.g. Apr 19 2021). - Field format for checkbox should be - [Option-1, Option-2]. - For Multi-select fields provide comma separated values. |
| Output Field: | ||
| 1 | WorklogID | Output field to hold the ID of the Request Worklog created on successful plugin execution |