ProcessInstanceNode

Represents a step in an instance of an approval process. Compare to ProcessNode, which describes the step in a process definition. Use this object to retrieve approval history.
Note

Note

Exceptions apply to approval history data retrieved with this object and available only via the SOAP API. For each approval process instance that was pending when Summer ’14 became available for your organization, some field values are never populated or are populated only after the approval process instance is next acted upon—such as when a user approves, rejects, or reassigns an approval request—after the Summer ’14 rollout.

ProcessInstanceNode fields are never populated for approval process instances that were completed before the Summer ’14 rollout. For approval process instances that were pending during the Summer ’14 rollout, all ProcessInstanceNode fields are populated only after the approval process instance is next acted upon after the Summer ’14 rollout.

Supported Calls

describeSObjects(), query(), retrieve()

Fields

Field Details
CompletedDate
Type
dateTime
Properties
Filter, Sort
Description
The completion date and time of this step in the approval process. The ElapsedTimeDay, ElapsedTimeHours, and ElapsedTimeMinutes field values are calculated using CompletedDate.
ElapsedTimeInDays
Type
double
Properties
Filter, Sort
Description
The total time in days since this step was started.
ElapsedTimeInHours
Type
double
Properties
Filter, Sort
Description
The total time in hours since this step was started.
ElapsedTimeInMinutes
Type
double
Properties
Filter, Sort
Description
The total time in minutes since this step was started.
LastActorId
Type
reference
Properties
Defaulted on create, Group, Filter, Sort
Description
The last actor that approved or rejected this step.
NodeStatus
Type
picklist
Properties
Filter, Group, Restricted picklist, Sort
Description
The status of this approval instance, for example Started, Pending, or Approved.
ProcessInstanceId
Type
reference
Properties
Filter, Group, Sort
Description
The approval process this step is part of.
ProcessNodeId
Type
reference
Properties
Filter, Group, Sort
Description
The identifier for this step.
ProcessNodeName
Type
string
Properties
Filter, Group, Sort
Description
The name of this step.