getJob

Click to copy

Get a job by jobId

Get the details of a job by jobId.

If the job contains active versions, they are returned in an activeVersions array with the following information:

  • name: The name of the version.
  • url: The feature service URL.
  • layerItemId: The organization item ID of the source feature layer.
  • versionID: The GUID for the version in version management server.

If the job contains extended properties and extProps is set to true, they are returned in an extendedProperties array with the following information:

  • tableName: The name of the extended property table.
  • featureServiceProperties: Available when a job contains feature service extended properties.
  • properties: The array of the properties in the extended property table, includes propertyName and value.

If the job contains feature service extended properties and extProps is set to true, they are returned within extendedProperties as a featureServiceProperties object with the following information:

  • itemId: ItemId for the feature service in Portal or AGOL.
  • layerid: LayerId for the layer in the Feature service.
  • portalType: Specifies where the feature service is located. Current for feature services available on the same portal as Workflow Manager, ArcGISOnline for feature services available on AGOL and Other for public feature services available on a different portal.
  • featureServiceUniqueId: The field from the feature service as linked field stored in the extended property table.
  • portalUrl: Portal url for the feature service. This field is specified only for portalType.
  • secure: Specifies whether the feature service is secure or not.

If the job contains a hold or dependency, it is returned in the corresponding current step in the currentSteps array with the following information:

  • manualHold: If the step is on hold with a manual or scheduled hold
  • dependencies: If the step has dependencies on another job
  • holdScheduledRelease: Date and time stamp the scheduled hold is released

Jobs that have a current or past hold will return the following information in the holds array if holds is set to true:

  • jobId: JobId for the job containing a hold
  • stepId: StepId for the step on hold
  • holdId: HoldId for the hold
  • setBy: Username for the user who added the hold
  • setDate: Date and time stamp for when the hold was added
  • scheduledRelease: If the step has a current hold, date and time stamp for when the hold is scheduled to be released
  • releasedBy: If the step has a past hold, the username for the user who released the hold
  • releasedDate: If the step has a past hold, date and time stamp for when the hold was released

Jobs that contain a dependency will return the following infrormation in the holds array if holds is set to true:

  • dependentJobId: JobId for the job dependent on the current or past hold
  • dependentStepId: StepId for the step dependent on the current or past hold

If the job is a parent job, a unique ID for the job is returned:

  • parentJobRefId: Unique ID for the parent job

Query parameters

NameTypeRequired

extProps

boolean

holds

boolean

token

string

Path parameters

NameTypeRequired

jobId

string

orgId

string

itemId

string

Examples

Request

Use dark colors for code blocksCopy
1
2
3
4
# You can also use wget
curl -X GET /{orgId}/{itemId}/jobs/{jobId} \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

Response

200 Response

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
{
  "jobId": "string",
  "jobName": "string",
  "ownedBy": "string",
  "createdBy": "string",
  "notes": "string",
  "description": "string",
  "createdDate": "2019-08-24T14:15:22Z",
  "startDate": "2019-08-24T14:15:22Z",
  "startedDate": "2019-08-24T14:15:22Z",
  "dueDate": "2019-08-24T14:15:22Z",
  "endDate": "2019-08-24T14:15:22Z",
  "parentJob": "string",
  "percentComplete": 0,
  "priority": "string",
  "diagramId": "string",
  "diagramVersion": 0,
  "diagramName": "string",
  "currentSteps": [
    {
      "stepId": "string",
      "assignedTo": "string",
      "assignedType": "Unassigned",
      "stepName": "string",
      "canSkip": true,
      "manualHold": true,
      "holdScheduledRelease": "2019-08-24T14:15:22Z",
      "dependencies": true
    }
  ],
  "jobStatus": "string",
  "jobTemplateId": "string",
  "jobTemplateName": "string",
  "extendedProperties": [
    {
      "tableName": "string",
      "featureServiceProperties": {
        "itemId": "string",
        "itemType": "SurveyForm",
        "layerId": "string",
        "portalType": "Current",
        "portalUrl": "string",
        "featureServiceUniqueId": "string",
        "secure": true
      },
      "properties": [
        {
          "propertyName": "string",
          "value": {}
        }
      ]
    }
  ],
  "relatedProperties": [
    {
      "tableName": "string",
      "featureServiceProperties": {
        "itemId": "string",
        "itemType": "SurveyForm",
        "layerId": "string",
        "portalType": "Current",
        "portalUrl": "string",
        "featureServiceUniqueId": "string",
        "secure": true
      },
      "entries": [
        {
          "id": "string",
          "createdDate": "2019-08-24T14:15:22Z",
          "properties": [
            {
              "propertyName": "string",
              "value": {}
            }
          ]
        }
      ]
    }
  ],
  "holds": [
    {
      "jobId": "string",
      "stepId": "string",
      "holdId": "string",
      "setBy": "string",
      "setDate": "2019-08-24T14:15:22Z",
      "scheduledRelease": "2019-08-24T14:15:22Z",
      "releasedBy": "string",
      "releasedDate": "2019-08-24T14:15:22Z",
      "dependentJobId": "string",
      "dependentStepId": "string"
    }
  ],
  "activeVersions": [
    {
      "name": "string",
      "url": "string",
      "privateUrl": "string",
      "layerItemId": "string",
      "versionId": "string",
      "replicaName": "string",
      "replicaId": "string",
      "replicaLocation": "string",
      "proReplicaLocation": "string"
    }
  ],
  "hasLocation": 0,
  "parentJobRefId": "string",
  "closed": true,
  "archived": true
}
StatusMeaningDescriptionSchema

200

OK

success

Job

400

Bad Request

error

WorkflowExceptionDTO

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.