Versions Compared

Old Version 7

changes.mady.by.user Stonebranch

Saved on

compared with

New Version Current

changes.mady.by.user Stonebranch

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...


Description

URI

http://host_name/uc/resources/workflow/edges

HTTP Method

POST

Description

Adds a dependency to a workflow, with the dependency represented by a workflowEdge. (See Example Request, below.)

URI Parameters

See Add a Dependency to a Workflow: URI Parameters, below.

Example URI

http://localhost:8080/uc/resources/workflow/edges?workflowname=workflow1

Consumes Content-Type

application/xml, application/json

Produces Content-Type

n/a

Example Request

See Add a Dependency to a Workflow: Example Request, below.

Add a Dependency to a Workflow Properties

See Add a Dependency to a Workflow: Properties, below.

Example Response

  • Status 200 /OK
    Successfully added a dependency between <sourceId> and <targetId>.
  • Status 400 /Bad Request
    Workflow <workflowName> doesn`t exist.

...

XML

JSON


Expand
titleXML
<workflowEdge>
      <condition>Success</condition>
      <points>
            <point x="280" y="300" />
      </points>
      <sourceId>2</sourceId>
      <straightEdge>false</straightEdge>
      <targetId>3</targetId>
</workflowEdge>



Expand
titleJSON
{
  "condition": {
    "value": "Success"
  },
  "points": [ {
     "x": "280",
     "y": "300"
  } ],
  "sourceId": {
    "value": "2"
  },
  "straightEdge": false,
  "targetId": {
    "value": "3"
  }
}


Anchor
Add a Dependency to a Workflow Request Properties
Add a Dependency to a Workflow Request Properties
Add a Dependency to a Workflow: Request Properties

Property

UI Field Name

Description

Specifications

Required

Anchor
condition - ADW
condition - ADW
condition

n/a

Dependency condition between the source and target tasks of this dependency (connector).

Valid values:

  • Success
  • Failure
  • Success/Failure
  • Exit Code; Format: Numeric. Use commas to list a series of exit codes; use hyphens to specify a range. Example: 1,5, 22-30
  • Step Condition; Format: step:procedure:program:condition codes. Example: *:*:*:JCLERR
  • Variable


Default is Success.
 
For example: 

Panel

 <condition>Success</condition>
   <condition>Failure</condition>
   <condition>Success/Failure</condition>
   <condition>1,5,22-30</condition>
   <condition>*:*:*:JCLERR</condition>
   <condition>S1:PROC1:PGM1:U016</condition>
   <condition type="Exit Code">1,5,22-30</condition>
   <condition type="Step Condition">*:*:*:JCLERR</condition>
   <condition type="Step Condition">*:*:*:S0C4</condition>
   <condition type="Step Condition">S1:PROC1:PGM1:U016</condition>
   <variableCondition>
           <firstValue>${_varToLowerCase('variableName')}</firstValue>
           <operator>=</operator>
           <secondValue>${var2}</secondValue>
   </variableCondition>


 
Step Condition is valid for z/OS tasks only.
 
Success/Failure and Failure are not valid for Workflow, Timer, and Manual tasks.
 

Note
titleNote

The type attribute (type=) is optional for Exit Code and Step Condition. Based on the format of the condition, in most cases it is easily determined if the condition is Exit Code and Step Condition. If the condition cannot be determined, the type attribute can be checked.


N

Anchor
points - ADW
points - ADW
points

n/a

If straightEdge is false; x and y coordinates of the Edge angles.

For example:
 

Panel
<points>
	<point x="280" y="300" />
</points>


N

Anchor
sourceId - ADW
sourceId - ADW
sourceId

n/a

Vertex ID of the source task.


Y

Anchor
straightEdge - ADW
straightEdge - ADW
straightEdge

n/a

Specification for whether the edge is straight or bent.

Boolean; Valid values: true/false. Default is true.

N

Anchor
targetId - ADW
targetId - ADW
targetId

n/a

Vertex ID of the target task.


Y

...


Description

URI

http://host_name/uc/resources/workflow/vertices

HTTP Method

POST

Description

Adds a task to a workflow, with the task represented by a workflowVertex. (See Example Request, below.)

URI Parameters

See Add a Task to a Workflow: URI Parameters, below.

Example URI

http://localhost:8080/uc/resources/workflow/vertices?workflowname=workflow1

Consumes Content-Type

application/xml, application/json

Produces Content-Type

application/xml, application/json

Example Request

See Add a Task to a Workflow: Example Request, below.

Example Response

See Add a Task to a Workflow: Example Response (Status 200), below.

Add a Task to a Workflow Properties

See Add a Task to a Workflow: Request/Response Properties, below.

Example Response

  • Status 200 /OK
    Successfully added vertex with vertexId <vertextId>.
  • Status 400 /Bad Request
    Workflow <workflowName> doesn`t exist.

...

XML

JSON


Expand
titleXML
<workflowVertex>
      <alias>S30</alias>
      <task>Sleep 30</task>
      <vertexX>360</vertexX>
      <vertexY>60</vertexY>
</workflowVertex>



Expand
titleJSON
{
  "alias": "S30",
  "task": {
  "value": "Sleep 30"
  }, 
  "vertexX": "360",
  "vertexY": "60"
}



Anchor
Add a Task to a Workflow Example Response
Add a Task to a Workflow Example Response
Add a Task to a Workflow: Example Response (Status 200)

XML

JSON


Expand
titleXML
<workflowVertex>
      <alias>S30</alias>
      <task>Sleep 30</task>
      <vertexId>9</vertexId>
      <vertexX>360</vertexX>
      <vertexY>60</vertexY>
</workflowVertex>



Expand
titleJSON
{
  "alias": "S30",
  "task": {
  "value": "Sleep 30"
  }, 
  "vertexId": "9,
  "vertexX": "360",
  "vertexY": "60"
}


Anchor
Add a Task to a Workflow Request Response Properties
Add a Task to a Workflow Request Response Properties
Add a Task to a Workflow: Request/Response Properties

...


Description

URI

http://host_name/uc/resources/workflow/edges

HTTP Method

GET

Description

Returns the list of dependencies for all tasks in a workflow, with each dependency represented by a workflowEdge (see Example Response, below).

URI Parameters

See List Dependencies in a Workflow: URI Parameters, below.

Example URI

http://localhost:8080/uc/resources/workflow/edges?workflowname=workflow1

Authentication

HTTP Basic

Consumes Content-Type

n/a

Produces Content-Type

application/xml, application/json

Example Response

See List Dependencies in a Workflow: Example Response, below.

Response Properties

See List Dependencies in a Workflow: Properties, below.

Anchor
List Dependencies in a Workflow URI Parameters
List Dependencies in a Workflow URI Parameters
List Dependencies in a Workflow: URI Parameters

...

XML

JSON


Expand
titleXML
<workflowEdges>
        <workflowEdge>
                 <condition>Success</condition>
                 <sourceId taskName="Sleep 30" taskAlias="test">2</sourceId>
                 <straightEdge>true</straightEdge>
                 <targetId taskName="Sleep 60">3</targetId>
        </workflowEdge>
        <workflowEdge>
                 <condition>Success</condition>
                 <sourceId taskName="Sleep 60">3</sourceId>
                 <straightEdge>true</straightEdge>
                 <targetId taskName="Sleep 60">6</targetId>
        </workflowEdge>
</workflowEdges>



Expand
titleJSON
[
  {
  "condition": {
    "value": "Success"
  },
  "sourceId": {
    "taskAlias": "test",
    "taskName": "Sleep 30",
    "value": "2"
  },
  "straightEdge": true,
  "targetId": {
    "taskName": "Sleep 60",
    "value": "3"
  }
},
  {
  "condition": {
    "value": "Success"
  },
  "sourceId": {
    "taskName": "Sleep 60",
    "value": "3"
  },
  "straightEdge": true,
  "targetId": {
    "taskName": "Sleep 60",
    "value": "6"
  }
} 
]


...


Description

URI

http://host_name/uc/resources/workflow/vertices

HTTP Method

GET

Description

Returns the list of tasks in a workflow, with each task represented by a workflowVertex (see Example Response, below).

URI Parameters

See List Tasks in a Workflow: URI Parameters, below.

Example URI

Authentication

HTTP Basic

Consumes Content-Type

n/a

Produces Content-Type

application/xml, application/json

Example Response

See List Tasks in a Workflow: Example Response, below.

Response Properties

See List Tasks in a Workflow: Properties, below.

Anchor
List Tasks in a Workflow URI Parameters
List Tasks in a Workflow URI Parameters
List Tasks in a Workflow: URI Parameters

...

XML

JSON


Expand
titleXML
<workflowVertices>
	<workflowVertex>
		<alias>Task 1</alias>
		<task sysId="1010f538c0a801c900e0fe0af94d9be5">task1</task>
		<vertexId>5</vertexId>
		<vertexX>253</vertexX>
		<vertexY>296</vertexY>
	</workflowVertex>
	<workflowVertex>
		<alias>Task 2</alias>
		<task sysId="f81d30ccc0a801c9008ea20e4f5f61d6">task2</task>
		<vertexId>6</vertexId>
		<vertexX>252.5</vertexX>
		<vertexY>429</vertexY>
	</workflowVertex>
</workflowVertices>



Expand
titleJSON
[
  {
  "alias": "Task 1",
  "task": {
    "sysId": "1010f538c0a801c900e0fe0af94d9be5",
    "value": "task1"
  },
  "vertexId": "5",
  "vertexX": "253",
  "vertexY": "296"
  },
  {
  "alias": "Task 2",
  "task": {
    "sysId": "f81d30ccc0a801c9008ea20e4f5f61d6",
    "value": "task2"
  },
  "vertexId": "6",
  "vertexX": "252.5",
  "vertexY": "429"
  }
]


Anchor
List Tasks in a Workflow Response Properties
List Tasks in a Workflow Response Properties
List Tasks in a Workflow: Response Properties

...


Description

URI

http://host_name/uc/resources/workflow/edges

HTTP Method

PUT

Description

Modifies a dependency in a workflow, with the dependency represented by a workflowEdge.

URI Parameters

See Modify a Dependency in a Workflow: URI Parameters.

Example URI

http://localhost:8080/uc/resources/workflow/edges?workflowname=workflow1

Consumes Content-Type

application/xml, application/json

Produces Content-Type

n/a

Example Request

See Modify a Dependency in a Workflow: Example Request, below.

Modify a Dependency in a Workflow Properties

See Add a Dependency to a Workflow: Properties.

Example Response

  • Status 200 /OK
    Successfully updated dependency between <sourceId> and <targetId>.
  • Status 400 /Bad Request
    Workflow <workflowName> doesn`t exist.

...

XML

JSON


Expand
titleXML
<workflowEdge>
      <condition>Success</condition>
      <points>
            <point x="280" y="300" />
      </points>
      <sourceId>2</sourceId>
      <straightEdge>false</straightEdge>
      <targetId>3</targetId>
</workflowEdge>



Expand
titleJSON
{
  "condition": {
     "value": "Success"
  },
  "points": [ {
     "x": "280",
     "y": "300"
  } ],
  "sourceId": {
    "value": "2"
  },
  "straightEdge": false,
  "targetId": {
    "value": "3"
  }
}


Anchor
Modify a Task in a Workflow
Modify a Task in a Workflow
Modify a Task in a Workflow


Description

URI

http://host_name/uc/resources/workflow/vertices

HTTP Method

PUT

Description

Modifies a task in a workflow, with the task represented by a workflowVertex.

URI Parameters

See Modify a Task in a Workflow: URI Parameters, below.

Example URI

http://localhost:8080/uc/resources/workflow/vertices?workflowname=workflow1

Consumes Content-Type

application/xml, application/json

Produces Content-Type

n/a

Example Request

See Modify a Task in a Workflow: Example Request, below.

Modify a Task in a Workflow Properties

See Add a Task to a Workflow: Properties.

Anchor
Modify a Task in a Workflow URI Parameters
Modify a Task in a Workflow URI Parameters
Modify a Task in a Workflow: URI Parameters

...

XML

JSON


Expand
titleXML
<workflowVertex>
      <alias>S30</alias>
      <task>Sleep 30</task>
      <vertexX>360</vertexX>
      <vertexY>60</vertexY>
</workflowVertex>



Expand
titleJSON
{
  "alias": "S30",
  "task": {
    "value": "sleep 30"
  },
  "vertexX": "360",
  "vertexY": "60"
}


Anchor
Modify a Task in a Workflow Properties
Modify a Task in a Workflow Properties
Modify a Task in a Workflow: Properties

...


Description

URI

http://host_name/uc/resources/workflow/edges

HTTP Method

DELETE

Description

Removes a dependency from a workflow, with the dependency represented by sourceid and targetid (see Example Response, below).

URI Parameters

See Remove a Dependency from a Workflow: URI Parameters, below.

Example URI

http://localhost:8080/uc/resources/workflow/edges?workflowname=workflow1&sourceid=2&targetid=4

Authentication

HTTP Basic

Example Response

  • Status 200 /OK
    Successfully updated vertex with vertex id <vertexId>.
  • Status 400 /Bad Request
    Workflow <workflowName> doesn`t exist.

...


Description

URI

http://host_name/uc/resources/workflow/vertices

HTTP Method

DELETE

Description

Removes one or more tasks from a workflow, with each removed task represented by a workflowVertex (see Example Response, below).

URI Parameters

See Remove Task(s) from a Workflow: URI Parameters, below.

Example URI

Consumes Content-Type

n/a

Produces Content-Type

application/xml, application/json

Authentication

HTTP Basic

Example Response

See Remove Task(s) from a Workflow: Example Response, below.

Remove Task(s) from a Workflow Properties

See Remove Task(s) from a Workflow: Properties, below.

Anchor
Remove Task(s) from a Workflow URI Parameters
Remove Task(s) from a Workflow URI Parameters
Remove Task(s) from a Workflow: URI Parameters

...

XML

JSON


Expand
titleXML
<workflowVertices>
	<workflowVertex>
		<alias>Task 1</alias>
		<task sysId="1010f538c0a801c900e0fe0af94d9be5">task1</task>
		<vertexId>5</vertexId>
		<vertexX>253</vertexX>
		<vertexY>296</vertexY>
	 </workflowVertex>
</workflowVertices>



Expand
titleJSON
[ {
  "alias": "task 1",
  "task": {
    "sysId": "1010f538c0a801c900e0fe0af94d9be5",
    "value": "task1"
  "vertexId": "5",
  "vertexX": "253",
  "vertexY": "296"
} ]



Note
titleNote

If there are no matching tasks to remove, an empty list is returned.

...