--- schema_version: "1" id: 7e2cc4560aab638ba965f347ee176e01af8814dc11e2a10c7af9fbdfa7425474 title: ProcessInstanceStep collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_processinstancestep.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_processinstancestep.htm source_site: developer.salesforce.com content_type: documentation content_hash: 0ed2fd29d89610bc25afb429dbfab34860c33c15507e540a62c791ecd17c562e description: Represents one work item in an approval process (ProcessInstance). --- # ProcessInstanceStep Represents one work item in an approval process (ProcessInstance). ![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png) #### Note Exceptions apply to approval history data retrieved with this object and are available only via 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 rollout. Other fields 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. ProcessInstanceStep 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 ProcessInstanceStep 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 | | --- | --- | | ActorId | Type reference Properties Filter, Group, Sort Description ID of the user who’s assigned to this approval step. This is a polymorphic relationship field. Relationship Name Actor Relationship Type Lookup Refers To Group, User | | Comments | Type string Properties Filter, Nillable, Sort Description Limit: 4,000 bytes. The contents of this field can be publicly viewed. | | ElapsedTimeInDays | Type double Properties Filter, Nillable, Sort Description The total time in days since this step was started. | | ElapsedTimeInHours | Type double Properties Filter, Nillable, Sort Description The total time in hours since this step was started. | | ElapsedTimeInMinutes | Type double Properties Filter, Nillable, Sort Description The total time in minutes since this step was started. | | OriginalActorId | Type reference Properties Filter, Group, Sort Description ID of the user who was originally assigned to this approval step. This is a polymorphic relationship field. Relationship Name OriginalActor Relationship Type Lookup Refers To Group, User | | ProcessInstanceId | Type reference Properties Filter, Group, Sort Description ID of the ProcessInstance that this approval step belongs to. This is a relationship field. Relationship Name ProcessInstance Relationship Type Lookup Refers To ProcessInstance | | StepNodeId | Type reference Properties Filter, Group, Nillable, Sort Description ID of the node currently assigned to this approval step. | | StepStatus | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description The status of this approval step. - Approved - Fault - Held - NoResponse - Pending - Reassigned - Rejected - Removed - Started If the approval step requires unanimous approval and one approver rejects the request, the value of this field for the other approvers changes to NoResponse. Likewise, if approval is based on the first response and an approver responds, the value of this field for the other approvers changes to NoResponse. | ## Usage Query or retrieve a new step in an approval process (ProcessInstance). ## Associated Objects This object has the following associated objects. Unless noted, they’re available in the same API version as this object. [ProcessInstanceStepChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_change_event.htm "A ChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.") (API Version 58.0) Change events are available for the object. #### See Also - [ProcessInstance](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_processinstance.htm "Represents an instance of a single, end-to-end approval process. Use this and the node, step, and workitem process instance objects to create approval history reports.") - [ProcessInstanceHistory](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_processinstancehistory.htm "This read-only object shows all steps and pending approval requests associated with an approval process (ProcessInstance).") - [ProcessInstanceWorkitem](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_processinstanceworkitem.htm "Represents a user’s pending approval request.")