REST API - PUT Workflow Definition
This operation imports a workflow definition.
Request
Syntax
PUT <webservice>/workflow HTTP/1.1
Host: <host name>
Accept: {application/xml | application/json}
Authtoken: <authentication token>
Content-type: {application/xml | application/json}
<workflow_definition>
where <webservice> is the root path used to route the API requests to the Web Server.
For more information, see Available Web Services for REST API.
Request Headers
Name |
Description |
Host |
The host name of the Web Server or Web Console used in the API request. |
Accept |
The format of the response. Valid values are: application/xml or application/json. |
Authtoken |
The authentication token received after successfully logging on. For details on receiving an authentication token, see Authentication. |
Content-type |
The media type contained in the request body. |
Request Body
Use the workflow definition generated by the GET Workflow Definition API.
Response
Response Parameters
Parameter |
Description |
Element |
workflowId |
The system-generated ID assigned to the workflow. |
Workflow_SetWorkflowResponse |
workflowName |
The name of the workflow. |
Workflow_SetWorkflowResponse |
Examples
Sample Request
PUT <webservice>/workflow HTTP/1.1
Host: client.mydomain.com
Accept: application/xml
Authtoken: QSDK 38568012f4d1e8ee1841d283a47aa3ba78e124ea58354b5fc6
0f4dab8a63347d05cf5552484dafda3bfa4c5db84e580b1cb37bcf8e65b39f7f
8549a443e6f78a2c7be3f31b3d845e24776c835e498e8e883bb40c46bd15af4f
40ca94e823acedcdd4e9659e74b34a07a85c4586cd2ed914b6dce015874783ef7
68fda78183a4208930954a377f66eb56c8b92cexampl4s437a19317ca6ce7f323
3d5a01aca35dbad93468b833f2cf71010809006a937670adce711ca8be46638e8
Content-type: application/json
{
"outputs": "<outputs />",
"isHtmlDescription": false,
"inputs": "<inputs><Client class=\"java.lang.String\" _list_=\"false\"></Client></inputs>",
"interactive": false,
"description": "",
"apiMode": true,
"variables": "<variables />",
"revision": "$Revision: 1.1.2.6 $",
"uniqueGuid": "d4c7f7b3-682e-4b79-8e00-7924bb1e9c7e",
"name": "ClientDeconfigure",
"config": "<configuration />",
"workflowId": 0,
"schema": {
"outputs": {
"className": "",
"type": "",
"name": "outputs"
},
"variables": {
"className": "",
"type": "",
"name": "variables"
},
"inputs": {
"className": "",
"type": "",
"attribute": false,
"name": "inputs",
"children": [{
"hidden": false,
"defaultValue": "",
"displayName": "",
"className": "java.lang.String",
"type": "{http://www.w3.org/2001/XMLSchema}string",
"listType": false,
"required": true,
"minimumValue": "",
"inputType": "java.lang.String",
"attribute": false,
"documentation": "",
"controlHidden": false,
"readOnly": false,
"searchable": false,
"controlType": 0,
"name": "Client",
"maximumValue": ""
}]
},
"config": {
"className": "",
"type": "",
"name": "configuration"
}
},
"Start": {
"displayName": "Start",
"interactive": false,
"originalStyle": "",
"jobMode": false,
"description": "",
"waitSetting": false,
"continueOnFailure": false,
"commented": false,
"height": 36,
"created": 0,
"uniqueName": "Start_1",
"skipAttempt": false,
"name": "Start",
"width": 55,
"x": 45,
"y": 41,
"style": "image;image=/images/jgraphx/house.png",
"inputs": [
"<inputs />"
],
"transition": [{
"sourceX": 72,
"sourceY": 59,
"activity": "Execute_1",
"targetY": 448,
"targetX": 342,
"originalStyle": "",
"points": "",
"x": 0,
"y": 0,
"transitionIndex": 0,
"style": "defaultEdge",
"commented": false,
"status": 0,
"condition": {
"language": 1,
"script": "/*\nThe expression should return a boolean. Use the variable name \"activity\" to refer to the previous activity object. Example:\nactivity.exitCode==0;\n*/\n"
}
}]
},
"Activity": [{
"displayName": "Execute",
"interactive": false,
"originalStyle": "",
"jobMode": false,
"description": "",
"waitSetting": false,
"continueOnFailure": false,
"namespaceUri": "commvault.cte.workflow.activities.cmd.operation",
"commented": false,
"height": 34,
"created": 1459757072147,
"uniqueName": "Execute_1",
"skipAttempt": false,
"name": "Execute",
"width": 100,
"x": 286,
"y": 424,
"style": "label;image=Execute",
"inputs": [
"<inputs><inputXml class=\"java.lang.String\" _list_=\"false\"><TMMsg_ReleaseLicenseReq isClientLevelOperation=\"1\">
\r\n <clientEntity _type_=\"3\" clientName=\"xpath:{/workflow/inputs/Client}\" hostName=\"\"/>
\r\n <licenseTypes appType=\"0\" licenseName=\"\" licenseType=\"0\"/>
\r\n</TMMsg_ReleaseLicenseReq></inputXml><escapeXml class=\"java.lang.Boolean\" _list_=\"false\">true</escapeXml><commandArgs class=\"java.lang.String\" _list_=\"false\" /><sessionOptions class=\"workflow.types.cmd.SessionOptions\" _list_=\"false\"><useImpersonatedAccount class=\"java.lang.Boolean\" _list_=\"false\">true</useImpersonatedAccount><tokenFile class=\"java.lang.String\" _list_=\"false\" /><token class=\"java.lang.String\" _list_=\"false\" /></sessionOptions></inputs>"
]
}],
"formProperties": {
"css": "",
"javaScript": ""
}
}
Sample Response
<Workflow_SetWorkflowResponse>
< workflow workflowId = "138" workflowName = "ClientDeconfigure" />
</Workflow_SetWorkflowResponse>
Last modified: 5/25/2018 2:42:37 PM