alfresco-ng2-components/docs/process-services/services/process.service.md

---
Title: Process Service
Added: v2.0.0
Status: Active
Last reviewed: 2019-03-20
---

# [Process Service](../../../lib/process-services/src/lib/process-list/services/process.service.ts "Defined in process.service.ts")

Manages process instances, process variables, and process audit Log.

## Class members

### Methods

-   **cancelProcess**(processInstanceId: `string`): `Observable<void>`<br/>
    Cancels a process instance.
    -   _processInstanceId:_ `string`  - ID of process to cancel
    -   **Returns** `Observable<void>` - Null response notifying when the operation is complete
-   **createOrUpdateProcessInstanceVariables**(processInstanceId: `string`, variables: `RestVariable`[]`): `Observable<RestVariable[]>`<br/>
    Creates or updates variables for a process instance.
    -   _processInstanceId:_ `string`  - ID of the target process
    -   _variables:_ `RestVariable[]`  - Variables to update
    -   **Returns** `Observable<ProcessInstanceVariable[]>` - Array of instance variable info
-   **deleteProcessInstanceVariable**(processInstanceId: `string`, variableName: `string`): `Observable<void>`<br/>
    Deletes a variable for a process instance.
    -   _processInstanceId:_ `string`  - ID of the target process
    -   _variableName:_ `string`  - Name of the variable to delete
    -   **Returns** `Observable<void>` - Null response notifying when the operation is complete
-   **fetchProcessAuditJsonById**(processId: `string`): `Observable<any>`<br/>
    Fetches the Process Audit information in a JSON format.
    -   _processId:_ `string`  - ID of the target process
    -   **Returns** `Observable<any>` - JSON data
-   **fetchProcessAuditPdfById**(processId: `string`): [`Observable`](http://reactivex.io/documentation/observable.html)`<`[`Blob`](https://developer.mozilla.org/en-US/docs/Web/API/Blob)`>`<br/>
    Fetches the Process Audit information as a PDF.
    -   _processId:_ `string`  - ID of the target process
    -   **Returns** `Observable<Blob>` - Binary PDF data
-   **getProcess**(processInstanceId: `string`): `Observable<ProcessInstance>`<br/>
    Gets Process Instance metadata.
    -   _processInstanceId:_ `string`  - ID of the target process
    -   **Returns** [`Observable`](http://reactivex.io/documentation/observable.html)`<`[`ProcessInstance`](../../../lib/process-services/src/lib/process-list/models/process-instance.model.ts)`>` - Metadata for the instance
-   **getProcessDefinitions**(appId?: `number`): [`Observable`](http://reactivex.io/documentation/observable.html)`<`[`ProcessDefinitionRepresentation`](https://github.com/Alfresco/alfresco-js-api/blob/develop/src/api/activiti-rest-api/docs/ProcessDefinitionRepresentation.md)`[]>`<br/>
    Gets process definitions associated with an app.
    -   _appId:_ `number`  - (Optional) ID of a target app
    -   **Returns** [`Observable`](http://reactivex.io/documentation/observable.html)`<`[`ProcessDefinitionRepresentation`](https://github.com/Alfresco/alfresco-js-api/blob/develop/src/api/activiti-rest-api/docs/ProcessDefinitionRepresentation.md)`[]>` - Array of process definitions
-   **getProcessInstanceVariables**(processInstanceId: `string`): `ObservableRestVariable[]>`<br/>
    Gets the variables for a process instance.
    -   _processInstanceId:_ `string`  - ID of the target process
    -   **Returns** `ObservableRestVariable[]>` - Array of instance variable info
-   **getProcessInstances**(requestNode: [`ProcessFilterParamRepresentationModel`](../../../lib/process-services/src/lib/process-list/models/filter-process.model.ts), processDefinitionKey?: `string`): [`Observable`](http://reactivex.io/documentation/observable.html)`<`[`ProcessListModel`](../../../lib/process-services/src/lib/process-list/models/process-list.model.ts)`>`<br/>
    Gets process instances for a filter and optionally a process definition.
    -   _requestNode:_ [`ProcessFilterParamRepresentationModel`](../../../lib/process-services/src/lib/process-list/models/filter-process.model.ts)  - Filter for instances
    -   _processDefinitionKey:_ `string`  - (Optional) Limits returned instances to a process definition
    -   **Returns** [`Observable`](http://reactivex.io/documentation/observable.html)`<`[`ProcessListModel`](../../../lib/process-services/src/lib/process-list/models/process-list.model.ts)`>` - List of process instances
-   **getProcessTasks**(processInstanceId: `string`, state?: `string`): `Observable<TaskRepresentation[]>`<br/>
    Gets task instances for a process instance.
    -   _processInstanceId:_ `string`  - ID of the process instance
    -   _state:_ `string`  - (Optional) Task state filter (can be "active" or "completed")
    -   **Returns** `Observable<TaskRepresentation[]>` - Array of task instance details
-   **getProcesses**(requestNode: `ProcessFilterParamRepresentationModel, processDefinitionKey?: `string`): `Observable<ProcessListModel>`<br/>
    Gets processes for a filter and optionally a process definition.
    -   _requestNode:_ [`ProcessFilterParamRepresentationModel`](../../../lib/process-services/src/lib/process-list/models/filter-process.model.ts)  - Filter for instances
    -   _processDefinitionKey:_ `string`  - (Optional) Limits returned instances to a process definition
    -   **Returns** [`Observable`](http://reactivex.io/documentation/observable.html)`<`[`ProcessListModel`](../../../lib/process-services/src/lib/process-list/models/process-list.model.ts)`>` - List of processes
-   **getStartFormDefinition**(processId: `string`): [`Observable`](http://reactivex.io/documentation/observable.html)`<any>`<br/>
    Gets the start form definition for a given process.
    -   _processId:_ `string`  - Process definition ID
    -   **Returns** [`Observable`](http://reactivex.io/documentation/observable.html)`<any>` - Form definition
-   **getStartFormInstance**(processId: `string`): [`Observable`](http://reactivex.io/documentation/observable.html)`<any>`<br/>
    Gets the start form instance for a given process.
    -   _processId:_ `string`  - Process definition ID
    -   **Returns** [`Observable`](http://reactivex.io/documentation/observable.html)`<any>` - Form definition
-   **startProcess**(processDefinitionId: `string`, name: `string`, outcome?: `string`, startFormValues?: `FormValues`, variables?: `RestVariable[]`): `Observable<ProcessInstance>`<br/>
    Starts a process based on a process definition, name, form values or variables.
    -   _processDefinitionId:_ `string`  - Process definition ID
    -   _name:_ `string`  - Process name
    -   _outcome:_ `string`  - (Optional) Process outcome
    -   _startFormValues:_ [`FormValues`](../../../lib/core/src/lib/form/components/widgets/core/form-values.ts)  - (Optional) Values for the start form
    -   _variables:_ `RestVariable[]`  - (Optional) Array of process instance variables
    -   **Returns** `Observable<ProcessInstance>` - Details of the process instance just started
-   **toJson**(res: `any`): `any`<br/>
    Creates a JSON representation of form data.
    -   _res:_ `any`  - Object representing form data
    -   **Returns** `any` - JSON data

## Details

Parameter and return value classes are defined in the Alfresco JS API. See the
[Activiti REST API](https://github.com/Alfresco/alfresco-js-api/tree/master/src/alfresco-activiti-rest-api)
pages for further information.

### Importing

```ts
import { ProcessService, ProcessInstance, ProcessInstanceVariable, 
         ProcessDefinitionRepresentation, ProcessFilterParamRepresentationModel, TaskDetailsModel } from '@alfresco/adf-process-services';

export class SomePageComponent implements OnInit {

  constructor(private processService: ProcessService) {
  }
```

### Example of starting a process

When starting a process, you can choose to pass in form field values or process variables
but not both in the same call.

In this example, values are supplied to the start form that has been defined for the process:

```ts
const processDefinitionId = 'InvoiceApprovalProcess:2:21';
const name = 'Sample Invoice Process';
const outcome = null;
const startFormValues = {
  approver: 'admin@app.activiti.com',
  companyemail: 'someone@acme.com',
  invoicetobeapproved: null
};
this.processService.startProcess(processDefinitionId, name, outcome, startFormValues)
  .subscribe( (processInstance: ProcessInstance) => {
  console.log('ProcessInstance: ', processInstance);
}, error => {
  console.log('Error: ', error);
});
```

A [`ProcessInstance`](../../../lib/process-services/src/lib/process-list/models/process-instance.model.ts) object is returned for a successfully started process. This implements the
[ProcessInstanceRepresentation interface](https://github.com/Alfresco/alfresco-js-api/blob/master/src/alfresco-activiti-rest-api/docs/ProcessInstanceRepresentation.md).

You can start the process with process variables instead of form field values using
code like the following:

```ts
const processDefinitionId = 'InvoiceApprovalProcess:2:21';
const name = 'Sample Invoice Process (Var)';
const variables: ProcessInstanceVariable[] = [
  {name: 'approver', value: 'admin@app.activiti.com'},
  {name: 'companyemail', value: 'someone@acme.com'},
  {name: 'invoicetobeapproved', value: null},
  {name: 'sampleVar', value: 'hello'}
];
this.processService.startProcess(processDefinitionId, name, null, null, variables)
  .subscribe( (processInstance: ProcessInstance) => {
  console.log('ProcessInstance: ', processInstance);
}, error => {
  console.log('Error: ', error);
});
```

You can also start a process that has no start form and no process variables:

```ts
const processDefinitionId = 'SimpleProcess:1:2';
const name = 'Sample Process';
this.processService.startProcess(processDefinitionId, name)
  .subscribe( (processInstance: ProcessInstance) => {
  console.log('ProcessInstance: ', processInstance);
}, error => {
  console.log('Error: ', error);
});
```