Skip to main content

Request handlers in Creatio Mobile

Level: advanced

Request handlers are items of the HandlerChain mechanism that let you describe business logic as an action request and a chain of handlers. The custom logic of request handlers in Creatio Mobile is implemented exclusively via a remote module. Learn more: Custom request handler.

Request handlers include actions that open pages, work with data on pages, etc.

The table below lists the page and record handlers.

Name

Description

crt.CreateRecordRequest

Open a new record.

crt.UpdateRecordRequest

Open an existing record.

crt.OpenPageRequest

Open a specific page.

crt.SaveRecordRequest

Save data.

crt.CancelRecordChangesRequest

Cancel a record update.

crt.ClosePageRequest

Close a page.

crt.DeleteRecordRequest

Delete a record.

crt.LoadDataRequest

Reload data on the page.

crt.UploadFileRequest

Upload a file.

crt.SetAttributeFromBarcodeRequest

Open a barcode scanner.

crt.SetAttributeFromNfcRequest

Open an NFC reader.

crt.AddCommunicationOptionsRequest

Add a communication option to a record.

crt.UpdateQuickFilterGroupRequest

Set up filters.

crt.RunBusinessProcessRequest

Run a business process. Available in Creatio Mobile 8.3.4 and later.

Parameters

Name

Type

Required

Description

processName

string

Yes

Code of the business process schema.

processRunType

string

Yes

Type of business process to run.

Available values

Value

Description

ForTheSelectedPage

Run the business process for the selected app page.

RegardlessOfThePage

Run the business process without connection to a dedicated app page.

ForTheSelectedRecords

Run the business process for the selected list records.

saveAtProcessStart

boolean

No

Save the current record before the business process is run. By default, "true."

Available values

Value

Description

true

Save the current record before the business process is run.

false

Do not save the current record before the business process is run.

showNotification

boolean

No

Display the notification when the business process is run. By default, "true."

Available values

Value

Description

true

Creatio displays the notification when the business process is run.

false

Creatio does not display the notification when the business process is run.

sorting

object

No

Sorting of selected records before they are passed to the business process. Usually, a variable like $ItemsSorting.

recordIdProcessParameterName

string

Required, only if processRunType is set to ForTheSelectedPage, or if processRunType is set to ForTheSelectedRecords and parameterMappings is not defined

Name of the process parameter that receives the record ID.

dataSourceName

string

Optional, only if processRunType is set to ForTheSelectedRecords

The data source name. By default, "PDS."

parameterMappings

object

Optional, only if processRunType is set to ForTheSelectedRecords

Key-value collection where key is the business process parameter and the value is the data source field.

filters

string

Optional, only if processRunType is set to ForTheSelectedRecords

Filter selected list records. Set the parameter to $Items.

selectionStateAttributeName

string

Optional, only if processRunType is set to ForTheSelectedRecords

Track changes of the selected variable in data source. By default, DataTable_SelectionState.