Skip to main content
Version: 8.2

Common Freedom UI components for Mobile Creatio

Level: beginner

Button

Use the Button component to add buttons.

View the example of a configuration object that adds the button below.

Example of a configuration object that adds the button
{
"type": "crt.Button",
"clicked": {
/* Creatio lets you bind the sending of base or custom request to the button click event. */
"request": "crt.CreateRecordRequest"
},
"icon": "open-button-icon",
"caption": "Button",
"color": "primary",
"size": "medium",
"iconPosition": "left-icon",
"menuTitle": "Menu title" /*Added.*/,
"menuItems": [
{
"type": "crt.MenuItem",
"caption": "Menu item 1",
"clicked": {
/* Creatio lets you bind the sending of base or custom request to the button click event. */
"request": "crt.SetViewModelAttributeRequest",
"params": {
"attributeName": "CalendarViewMode",
"value": "day"
}
},
},
{...}
...
]
}

Common properties

type

Component type. crt.Button for the Button component.


clicked

The request fires when a user clicks the button. Creatio lets you bind the sending of a base request or custom request handlers implemented in remote module to the button click event.


icon

Icon to display next to the menu item caption.

Available values

actions-button-icon

add-button-icon

back-button-icon

bars-button-icon

calculator-button-icon

clip-button-icon

close-button-icon

delete-button-icon

disk-warn-button-icon

document-button-icon

document-new-button-icon

upload-button-icon

download-button-icon

edit-button-icon

email-button-icon

export-button-icon

export-data-button-icon

flag-button-icon

gear-button-icon

horn-button-icon

import-button-icon

import-data-button-icon

lock-button-icon

contact-lock-icon

message-warn-button-icon

more-button-icon

open-button-icon

pencil-button-icon

print-button-icon

process-button-icon

reload-button-icon

save-button-icon

settings-button-icon

social-button-icon

call-button-icon

folder-button-icon

person-button-icon

timeline-button-icon

facebook-button-icon

linkedin-button-icon

webforms-button-icon

webhooks-integration-button-icon

copy-icon

message-composer-checkmark

relationship-button-icon

date

date-time

box-icon

car-icon

contact-leads-icon

database-icon

employee-icon

filter-column-icon

filter-funnel-icon

money-icon

newspaper-icon

organizational-structure-icon

tag-icon

trolley-icon

work-icon

replace-squares-icon

sum-button-icon


caption

Localizable button caption.


Optional properties

color

Button style. By default, default.

Available values

primary

Primary. Blue button.

accent

Accent. Green button.

warn

Warning. Red button.

default

Auxiliary white button.


size

Button size. By default, large.

Available values

small

medium

large


iconPosition

Position of the icon relative to the button caption. By default, left-icon.

Available values

only-text

Do not display the icon. Display only the button caption.

left-icon

Display the icon to the left of the button caption.

right-icon

Display the icon to the right of the button caption.

only-icon

Display only the icon. Do not display the button caption.


menuTitle

Title of the menu picker.


menuItems[]

List of button menu items. Displayed at the bottom of the page after clicking the button. When the menuItems property is used the clicked button property is ignored. To add the button menu item, use the Menu item component.


Field

Use the Field component to modify the component data. Before you use the component, make sure that the viewModelConfig schema section includes the attribute bound to the Field component.

View the example that adds an attribute to the Freedom UI page schema below.

Example that adds an attribute to the Freedom UI page schema
{
"viewModelConfig": {
"attributes": {
"SomeAttribute": {
"modelConfig": {
"path": "PDS.Title"
},
"name": "SomeAttribute"
}
}
}
}

Mobile Creatio lets you modify the text, lookup, double, integer, date, boolean, phone, email, web, rich text, and color Field component types.

View the example of a configuration object that modifies data below.

Example of a configuration object that modifies data
{
"type": "crt.EditField",
"value": "$SomeAttribute",
"minLines": 2,
"maxLines": 5,
"hint": "Enter title",
"readOnly": false,
"label": {
"visible": true,
"value": "Title",
"position": "left"
}
}
type

Component type. crt.EditField for the Field component.


value

The name of attribute from the viewModelConfig schema section.


minLines

Minimum number of lines in the component. Available for the text, email, web Field component types.


maxLines

Maximum number of lines in the component. Available for the text, email, web Field component types.


hint

The hint that Mobile Creatio displays in the component when you omit the component value.


readOnly

The flag that sets the component to read-only. By default, false.

Available values

true

The component is editable.

false

The component is not editable.


label

The component title. If you omit a value, Mobile Creatio displays the DataSchemaAttribute.caption property value.

Parameters

visible

The flag that makes the component label visible. By default, true.

Available values

true

The component label is visible.

false

The component label is not visible.

value

The label value. By default, the title is the same as the title of the corresponding model field.

position

The label position. By default, top.

Available values

left

Display the label to the left of the component.

right

Display the label to the right of the component.

top

Display the label above the component.

bottom

Display the label below the component.


Read-only field

Use the Read-only field component to display the component data. Before you use the component, make sure that the viewModelConfig schema section includes the attribute bound to the Read-only field component.

View the example that adds an attribute to the Freedom UI page schema below.

Example that adds an attribute to the Freedom UI page schema
{
"viewModelConfig": {
"attributes": {
"SomeAttribute": {
"modelConfig": {
"path": "PDS.Title"
},
"name": "SomeAttribute"
}
}
}
}

Mobile Creatio lets you display the text, lookup, double, integer, date, boolean, phone, email, web, rich text, and color Read-only field component types.

View the example of a configuration object that displays data below.

Example of a configuration object that displays data
{
"type": "crt.ViewField",
"value": "$SomeAttribute",
"maxLines": 2,
"label": {
"visible": true,
"value": "Title",
"position": "left"
},
"launchConfig": {
"name": "ConfigurationOptionalName",
"type": "phone",
"bindingColumn": "CommunicationType",
"binding": {
...
},
}
}
type

Component type. crt.ViewField for the Read-only field component.


value

The name of attribute from the viewModelConfig schema section.


maxLines

Maximum number of lines in the component to display.


label

The component title. If you omit a value, Mobile Creatio displays the DataSchemaAttribute.caption property value.

Parameters

visible

The flag that makes the component label visible. By default, true.

Available values

true

The component label is visible.

false

The component label is not visible.

value

The label value. By default, the title is the same as the title of the corresponding model field.

position

The label position. By default, top.

Available values

left

Display the label to the left of the component.

right

Display the label to the right of the component.

top

Display the label above the component.

bottom

Display the label below the component.


launchConfig

Add link to the component. If you omit the type property, Creatio analyzes the values of the binding and bindingColumn properties. The bindingColumn property configures the content provider launched based on the value set in the binding property.

Parameters

name

Link name.

type

Link type.

Available values

phone

Mobile Creatio opens the dialer app.

email

Mobile Creatio opens the email client.

map

Mobile Creatio opens the map app.

uri

Mobile Creatio opens an arbitrary link.

bindingColumn

Name of the column that determines the type of opened link.

binding

Record ID that determines the type of opened link.


Dropdown field

Use the Dropdown field component to add the lookup type field that has extended customization features. For example, create a record directly from the lookup type field. Before you use the component, make sure that the viewModelConfig schema section includes the attribute bound to the Dropdown field component.

View the example that adds an attribute to the Freedom UI page schema below.

Example that adds an attribute to the Freedom UI page schema
{
"viewModelConfig": {
"attributes": {
"SomeAttribute": {
"modelConfig": {
"path": "PDS.Title"
},
"name": "SomeAttribute"
}
}
}
}

View the example of a configuration object that lets you add a new contact directly from the lookup type field below.

Example of a configuration object that lets you add a new contact directly from the lookup type field
{
"value": "$Contact",
"type": "crt.ComboBox",
"name": "Case_PrimaryTab_Body_primaryColumnSet_Contact",
"clicked": {
"request": "crt.OpenLookupPageRequest",
"params": {
"entitySchemaName": "Contact",
"features": {
"create": {
"enabled": true
}
},
"addButtonClicked": {
"request": "crt.CreateRecordRequest",
"params": {
"entityName": "Contact",
"defaultValues": [{
"attributeName": "Name",
"value": "$Number"
}]
}
}
}
}
}
type

Component type. crt.ComboBox for the lookup type of the Field component.


value

The name of attribute from the viewModelConfig schema section.


name

The name of the lookup type field whose functionality is extended.


clicked

The request fires when a user clicks the button. Creatio lets you bind the sending of a base request or custom request handlers implemented in remote module to the button click event.


Embedded list

Use the Embedded list component to add embedded list. Before you use the component, make sure that the Freedom UI page schema includes the data source. Learn more: Operations with data for Mobile Creatio.

View the example of a configuration object that adds embedded list below.

Example of a configuration object that adds embedded list
{
"type": "crt.Detail",
"items": "ItemAttribute",
"title": "Contact in opportunity",
"itemLayout": {
"type": "crt.ListItem",
"body": [
{
"value": "\$Contact"
}
]
},
"editColumns": [
{
"columnName": "Contact"
}
],
"tools": [
{
"type": "crt.Button",
"text": "Add",
"menuTitle": "Select",
"menuItems": [
{
"type": "crt.MenuItem",
"caption": "By filter",
"clicked": [
{
"request": "crt.CreateActivityParticipantDetailRequest",
"params": {
"attributeName": "ActivityParticipantDetailV2EmbeddedDetail",
"filtersConfig": {
"filterAttributes": [
{
"loadOnChange": true,
"name": "ParticipantFilterAttribute",
}
],
}
}
}
]
},
{
"type": "crt.MenuItem",
"caption": "All",
"clicked": [
{
"request": "crt.CreateActivityParticipantDetailRequest",
"params": {
"attributeName": "ActivityParticipantDetailV2EmbeddedDetail",
}
}
]
},
]
}
]
}
type

Component type. crt.Detail for the Embedded list component.


items

The attribute from the viewModelConfig schema section.


title

The component title.


itemLayout

Configuration object that configures parameters of component to display in the Embedded list component.

Parameters

type

The component type to display in the Embedded list component. In most cases, crt.ListItem.

body

Parameters of the crt.ListItem component type.


editColumns

List of editable columns.


tools

List of embedded common Freedom UI components. For example, buttons. Embedded components are displayed in the top right of the Embedded list component.


List

Use the List component to add lists. Mobile Creatio displays data received from a data source as a scrolling list on the full screen.

View the example of a configuration object that adds the list below.

Example of a configuration object that adds the list
{
"type": "crt.List",
"items": "$Items",
"itemLayout": {
"type": "crt.ListItem",
"title": "$PDS_Name"
}
}

type

Component type. crt.List for the List component.


items

The attribute from the viewModelConfig schema section.


itemLayout

Configuration object that configures parameters of a list item to display in the List component.

Parameters

type

The component type to display in the List component. In most cases, crt.ListItem.

title

The data source attribute from the viewModelConfig schema section.


List item preview

Use the List item preview component to preview a list item.

View the example of a configuration object that previews a list item below.

Example of a configuration object that previews a list item
{
"type": "crt.ListItem",
"title": "\$Name",
"subtitles": ["\$Account"],
"body": [
{
"value": "\$JobTitle"
},
{
"value": "\$MobilePhone"
}
],
"action": {
"type": "crt.Button",
"caption": "Open",
"clicked": {...}
},
"showEmptyValues": true,
"icon": "\$Photo"
}
type

Component type. crt.ListItem for the List item preview component.


title

The attribute from the viewModelConfig schema section. Mobile Creatio displays the title above the content.


subtitles

The attribute from the viewModelConfig schema section. Mobile Creatio displays the subtitle below the list item title on a single line.


body

The array of attributes from the viewModelConfig schema section that are attached to the component. Mobile Creatio displays single column for mobile phones and two for tablets.

Parameters

value

The attribute from the viewModelConfig schema section.


action

The Freedom UI component that is attached to the List Item preview component. The component executes an action. For example, button. Mobile Creatio displays the component to the right of the List Item preview component. The parameters of attached component depend on the component type.


showEmptyValues

A flag that enables displaying empty values of fields that are specified in the body property. By default, false.

Available values

true

Display empty values of fields.

false

Do not display empty values of fields.


icon

List item icon. Mobile Creatio displays the icon of image type field. The icon property includes the DataSchemaAttribute.caption property value. If the value of image type field is omitted, Mobile Creatio displays the first two letters of the image type field.


Data grid

Use the Data grid component to add and edit table data.

View the example of a configuration object that adds table data below.

Example of a configuration object that adds table data
{
"type": "crt.DataGrid",
"features": {
"editable": {
"enable": true
},
"rows": {
"toolbar": true
}
},
"rowTitle": "\$Account",
"columns": [
{
"code": "Name",
"width": 200,
"sticky": true,
"cellView": {
"type": "crt.ViewField",
"value": "\$Name",
"maxLines": 3,
"label": {
"visible": false
}
},
"readonly": true
},
{
"code": "CreatedOn"
},
{
"code": "DoNotUseEmail"
},
{
"code": "Age"
}
],
"sorting": [
{
"columnCode": "Name",
"direction": "asc"
}
],
verticalScroll: true
}
type

Component type. crt.DataGrid for the Data grid component.


features

Additional component features.

Parameters

editable

Manages the editing of data.

Parameters

enable

The flag that determines whether to edit component data. By default, false.

Available values

true

The component data is editable.

false

The component data is not editable.

rows

Additional features of component rows.

Parameters

toolbar

The flag that determines whether to display available actions. By default, false.

Available values

true

Available actions are displayed.

false

Available actions are not displayed.


rowTitle

Pre-configured and non-editable column name. When you set the rowTitle property, Mobile Creatio ignores the sticky property value.


columns

Array of columns to load.

Parameters

id

Unique column identifier. If you omit a value, Mobile Creatio uses the code property value as an identifier.

code

Column name.

caption

Column caption. If you omit a value, Mobile Creatio receives the caption property value from data source.

dataValueType

Column data type.

width

Column width. If you omit a value, Mobile Creatio uses out-of-the-box column width (120px).

hidden

The flag that determines whether to hide a column. By default, false.

Available values

true

A column is hidden.

false

A column is shown.

sticky

The flag that determines whether to freeze a column. By default, false.

Available values

true

A column is frozen.

false

A column is not frozen.

readOnly

The flag that sets the column to read-only. By default, false.

Available values

true

The column is editable.

false

The column is not editable.

cellView

Parameters that determine conditions to view and edit column. List of parameters depends on column type.


sorting

Sort component data.

Parameters

columnCode

Column name.

direction

The sorting order.

Available values

asc

Ascending.

desc

Descending.

none

The sorting order is not defined.


verticalScroll

The flag that determines whether to scroll component data. By default, false.

Available values

true

Scrolling is enabled.

false

Scrolling is disabled.


Folder management menu

Use the Folder management menu component to open the page folder tree.

View the example of a configuration object that opens the page folder tree below.

Example of a configuration object that opens the page folder tree
{
"type": "crt.FolderTreeActions",
"caption": "Folders",
"name": "MyFolderTree",
"sourceSchemaName": "ContactFolder",
"folderTreeVisibleChanged": {
"request": "crt.OpenModalFolderTreeRequest",
"params": {
"folderTreeConfig": {
"caption": "Select folder",
"sourceSchemaName": "ContactFolder",
"rootSchemaName": "Contact"
}
}
}
}
type

Component type. crt.FolderTreeActions for the Folder management menu component.


caption

Component caption.


name

Component name.


sourceSchemaName

Entity schema that stores a list of folders.


activeFolderName

Out-of-the-box selected folder. Required.


folderTreeVisibleChanged

The crt.OpenModalFolderTreeRequest base request that opens a list of folders.


Attachment

Use the Attachment component to work with files. The component lets you display, add, and delete files. Before you use the component, make sure that the Freedom UI page schema includes the data source. Learn more: Operations with data for Mobile Creatio.

View the example of a configuration object that works with files below.

Example of a configuration object that works with files
{
"type": "crt.Attachments",
"items": "AttachmentItems"
}
type

Component type. crt.Attachments for the Attachment component.


items

The attribute from the viewModelConfig schema section.


Feed

Use the Feed component to add a feed. You can enable internal and external users to post and read comments that support rich text and user mention via "@." Authors can edit or delete their posts or attachments. Before you use the component, make sure that the Freedom UI page schema includes the data source. Learn more: Operations with data for Mobile Creatio.

View the example of a configuration object that adds a feed below.

Example of a configuration object that adds a feed
{
"type": "crt.Messaging",
"items": "ContactFeed"
}
type

Component type. crt.Messaging for the Feed component.


items

The attribute from the viewModelConfig schema section.


Filter

Use the Filter component to filter data.

View the example of a configuration object that filters data below.

Example of a configuration object that filters data
{
"type": "crt.RelatedDetailItem",
"moduleName": "Activity",
"relationOptions": {
"detailColumn": "Opportunity",
"masterColumn": "Id",
"parentRecordId": "$Id"
},
"filterAttributes": [
{
"name": "ActivityDetail_Filter"
}
],
"caption": "Attachments",
"parentModuleName": "Opportunity"
}
type

Component type. crt.RelatedDetailItem for the Filter component.


moduleName

The name of module that was customized in the manifest.


relationOptions

Configuration object to create a related filter based on the parent model.

Parameters

detailColumn

The child object.

masterColumn

The parent object column that is linked to the child object.

detailColumn

The object column that is linked to the parent object.


filterAttributes

Additional filters.

Parameters

name

The attribute that implements the filter from the viewModelConfig schema section.


caption

Link name.


parentModuleName

Name of the Classic UI form page.


Quick filter group

Use the Quick filter group component to display multiple filters. The component container includes all active filters and lets you scroll data horizontally.

Before you use the component, make sure that the viewModelConfig schema section includes the attribute bound to the Quick filter group component.

View the example that adds an attribute to the Freedom UI page schema below.

Example that adds an attribute to the Freedom UI page schema
{
"viewModelConfig": {
"attributes": {
"Items": {
"modelConfig": {
"path": "PDS",
"filterAttributes": [
{
"loadOnChange": true,
"name": "QuickFilterGroup_Filters"
}
]
}
}
}
}
}

View the example of a configuration object that displays multiple filters below.

Example of a configuration object that displays multiple filters
{
"name": "QuickFilterGroup",
"type": "crt.QuickFilterGroup",
"_filterOptions": {
"from": "QuickFilterGroup_Value",
"expose": [
{
"attribute": "QuickFilterGroup_Filters",
"converters": [
{
"args": [
{
"target": {
"viewAttributeName": "Items"
}
}
],
"converter": "crt.QuickFilterGroupAttributeConverter"
}
]
}
]
}
}

Properties

type

Component type. crt.QuickFilterGroup for the Quick filter group component.


items

Array of predefined quick filters to display on the page.


_filterOptions

Filter parameters.

Parameters

from

The attribute from the viewModelConfig schema section that is used to calculate filter value. When you change bound attribute, the filter value changes.

attribute

The attribute from the viewModelConfig schema section that stores a filter value.

viewAttributeName

The attribute from the viewModelConfig schema section that stores a data collection to filter.

items

Filter details that are generated by the preprocessor based on the columns in the initial data collection. You can add details of custom filters.

View the example of a custom filter for Account column below.

Example of a custom filter for Account column
"_filterOptions": {
"from": "QuickFilterGroup_Value",
"expose": [
{
"attribute": "QuickFilterGroup_Filters",
"converters": [
{
"args": [
{
"target": {
"viewAttributeName": "Items",
"items": {
"QuickFilterGroup_Item_Primary_Account": {
"quickFilterType": "lookup",
"target": {
"viewAttributeName": "Items",
"filterColumn": "Account.PrimaryAccount"
}
}
}
}
}
],
"converter": "crt.QuickFilterGroupAttributeConverter"
}
]
}
]
}

Component requests

The Quick filter group component lets you bind the following base requests depending on your business goals.

crt.UpdateQuickFilterGroupRequest

Opens a picker to set filters.

View the example that adds a custom filter to the configuration object of Quick filter group component below.

Example that adds a custom filter to the configuration object of Quick filter group component
{
"name": "QuickFilterGroup",
"type": "crt.QuickFilterGroup",
"_filterOptions": {
"from": "QuickFilterGroup_Value",
"expose": [
{
"attribute": "QuickFilterGroup_Filters",
"converters": [
{
"converter": "crt.QuickFilterGroupAttributeConverter",
"args": [
{
"target": {
"viewAttributeName": "Items",
"items": {
"QuickFilterGroup_Item_Type": {
"quickFilterType": "lookup",
"target": {
"viewAttributeName": "Items",
"filterColumn": "Type"
}
},
}
},
}
]
}
]
}
],
"from": "QuickFilterGroup_Value"
}
}

View the example of a configuration object that adds a button below. The request fires when a user clicks the button.

Example of a configuration object that adds a button
{
"name": "FilterGroupButton",
"type": "crt.Button",
"clicked": {
"request": "crt.UpdateQuickFilterGroupRequest",
"params": {
"value": "\$QuickFilterGroup_Value",
"actions": [
{
"caption" : "Type",
"filterViewConfig" : {
"name" : "QuickFilterGroup_Item_Type",
"type" : "crt.QuickFilter",
"config" : {
"caption" : "Type",
"icon" : "filter-column-icon",
"iconPosition" : "left-icon",
"entitySchemaName" : "ContactType",
"defaultValue": [
{
"value": "60733efc-f36b-1410-a883-16d83cab0980",
"displayValue": "Employee",
"checkedState": true
}
]
},
"filterType" : "lookup"
}
}
]
}
}
}

params

Request parameters.

Parameters

value

The name of attribute from the viewModelConfig schema section that stores a list of filters and filter values.

updated

The crt.QuickFilterGroupRequest base request that processes a selected filter.

actions

Array of filters to display. Array includes both predefined custom filters and filters that are generated by the preprocessor based on the columns in the initial data collection.

Parameters

caption

Title of the quick filter.

filterViewConfig

Parameters of quick filter.


crt.QuickFilterGroupRequest

Stores specified filters to the attribute from the viewModelConfig schema section and adds filters to the component container.

View the example of a configuration object that adds a button below. The request fires when a user clicks the button.

Example of a configuration object that adds a predefined custom filter
{
"name": "FilterGroupButton",
"type": "crt.Button",
"clicked": {
"request": "crt.UpdateQuickFilterGroupRequest",
"params": {
"value": "$QuickFilterGroup_Value",
"updated": {
"request": "crt.QuickFilterGroupRequest",
"params": {
"target": "QuickFilterGroup"
}
}
}
}
}

params

Request parameters.

Parameters

value

The name of attribute from the viewModelConfig schema section that stores a list of filters and filter values.

target

The component container that displays specified filters.


Quick filter

Use the Quick filter component to filter data by custom conditions, date/time, or lookup values. Before you use the component, make sure that the viewModelConfig schema section includes the attribute bound to the Quick filter component.

View the example that adds an attribute to the Freedom UI page schema below.

Example that adds an attribute to the Freedom UI page schema
{
"viewModelConfig": {
"attributes": {
"My_QuickFilter_Value": {
"value": null
},
"My_Converter_Arg": {
"value": {
"quickFilterType": "lookup",
"target": {
"viewAttributeName": "Items",
"filterColumn": "Category"
}
}
},
"My_Filter": {
"from": "My_QuickFilter_Value",
"converter": "crt.QuickFilterAttributeConverter : \$My_Converter_Arg"
},
"Items": {
"modelConfig": {
"path": "PDS",
"filterAttributes": [
{
"loadOnChange": true,
"name": "My_Filter"
}
]
}
}
}
}
}

View the example of a configuration object that filters the lookup values below.

Example of a configuration object that filters the lookup values
{
"name": "My_QuickFilter",
"type": "crt.QuickFilter",
"filterType": "lookup",
"config": {
"caption": "Select category",
"icon": "person-button-icon",
"iconPosition": "left-icon",
"entitySchemaName": "AccountCategory"
}
}

Once you select a filter value, Mobile Creatio stores it to the attribute whose name is QuickFilterCaption_Value. For this example, My_QuickFilter_Value.

View the example of a configuration object that filters data by custom condition below.

Example of a configuration object that filters data by custom condition
{
"name": "QuickFilter_Custom",
"type": "crt.QuickFilter",
"config": {
"caption": "Show drafts",
"defaultValue": true,
"approachState": true
},
"filterType": "custom"
}
type

Component type. crt.QuickFilter for the Quick filter component.


filterType

Type of quick filter.

Available values

lookup

Filter that filters the lookup values.

date-range

Filter that filters the date/time values.

custom

Filter that filters data by custom conditions.


config

Parameters of quick filter.

Parameters

caption*

Title of the quick filter. Mobile Creatio displays title if no value is selected.

icon*

Icon of the quick filter. The property is supported by the date-range and lookup quick filter types. You can select any icon that is supported by the icon property of Button component.

iconPosition*

Position of the icon relative to the quick filter caption. By default, left-icon. The property is supported by the date-range and lookup quick filter types.

Available values

only-text

Do not display the icon. Display only the quick filter caption.

left-icon

Display the icon to the left of the quick filter caption.

right-icon

Display the icon to the right of the quick filter caption.

only-icon

Display only the icon. Do not display the quick filter caption.

defaultValue

Out-of-the-box value of quick filter.

Parameters of the of date-range quick filter type

start*

Column that stores out-of-the-box start date of quick filter.

end*

Column that stores out-of-the-box end date of quick filter.

macros*

Macro that determines out-of-the-box time interval of quick filter. For example, macros: "[#currentWeek#]".

Parameters of the of custom quick filter type

true

Out of the box, quick filter is enabled. Default value.

false

Out of the box, quick filter is disabled.

entitySchemaName*

Entity schema whose data is displayed in the quick filter of the lookup type.

recordsFilter

Filter to filter lookup values.

cacheConfig

Manages caching of lookup values.

approachState

The flag that specifies whether the quick filter of the custom type is reversible. For example, quick filter is changed to "Show open cases" when section list displays only closed cases. By default, false.

Available values

true

The quick filter is not reversible.

false

The quick filter is reversible.


Sort

Use the Sort component to sort list data.

View the example of a configuration object that sorts list data below.

Example of a configuration object that sorts list data
{
"type": "crt.Sort",
"value": "\$ItemsSorting",
"sortItems": [
{
"attributeName": "Name",
"caption": "Name"
}
],
"valueChange": {
"request": "crt.SortChangeRequest"
}
}
type

Component type. crt.Sort for the Sort component.


value

The attribute from the viewModelConfig schema section.


sortItems

Array of parameters to sort.

Parameters

attributeName

The attribute from the viewModelConfig schema section.

caption

Column caption.


valueChange

The crt.SortChangeRequest base request that opens a list of available sorting options.


Link

Use the Link component to add clickable URLs. Additionally, you can display a label above the URL text.

View the example of a configuration object that adds the clickable URL below.

Example of a configuration object that adds the clickable URL
{
"type": "crt.Link",
"caption": "\$MyActivityCaptionAttribute",
"label": "Label",
"clicked": {
"request": "crt.UpdateRecordRequest",
"params": {
"entityName": "Activity",
"recordId": "\$MyActivityIdAttribute",
}
}
}
type

Component type. crt.Link for the Link component.


caption

Link name.


label

Link title.


clicked

The request fires when a user clicks the link.


Contact compact profile

The component is available if you have the Customer 360 app installed.

Use the Contact compact profile component to display main data of a contact:

  • photo
  • full name
  • birth date
  • age
  • local time
  • country

The component behavior is pre-configured and non-editable.

View the example of a configuration object that displays main contact data below.

Example of a configuration object that displays main contact data
{
"type": "crt.ContactCompactProfile"
}
type

Component type. crt.ContactCompactProfile for the Contact compact profile component.


Account compact profile

The component is available if you have the Customer 360 app installed.

Use the Account compact profile component to display main data of an account:

  • logo
  • name
  • local time
  • country

The component behavior is pre-configured and non-editable.

View the example of a configuration object that displays main account data below.

Example of a configuration object that displays main account data
{
"type": "crt.AccountCompactProfile"
}
type

Component type. crt.AccountCompactProfile for the Account compact profile component.


Timeline

Use the Timeline component to enable users to view the history of communication regarding the record as well as records linked to it in chronological order. You can specify the sorting column for most objects in the timeline except for "Feed" and "File" that are always sorted by creation date. Users can like and comment feed records in the timeline. The component also includes the message composer functionality.

Use the Timeline component to display the linked records of the following objects:

  • Attachments
  • Activities
  • Emails
  • Calls
  • Feed messages

The timeline displays the primary display value and creation date of linked records. You can customize the columns to display in the timeline addon of the relevant object using no-code tools. Learn more: Customize an object column to display in the Timeline component.

View the example of a configuration object that implements the timeline below.

Example of a configuration object that implements the timeline
{
"type": "crt.Timeline",
"masterSchemaId": "$Id",
"items": [
{
"type": "crt.TimelineTile",
"linkedColumn": "Contact",
"sortedByColumn": "CreatedOn",
"data": {
"schemaName": "Activity",
"schemaType": "Email",
"columns": [
{
"columnName": "Status"
}
],
"filter": {
"columnName":"Type",
"columnValue":"e2831dec-cfc0-df11-b00f-001d60e938c6"
}
}
}
]
}
type

Component type. crt.Timeline for the Timeline component.


masterSchemaId

Parent object column to create a filter in the timeline tile.


items

The array of timeline tiles.

Parameters

type

Tile type. By default, crt.TimelineTile.

linkedColumn

The tile object column that is linked to the parent object.

sortedByColumn

The tile object column to sort timeline data.

data

Configuration object of timeline data.

Parameters

schemaName

Name of the tile schema.

schemaType

The tile type.

Available values

Email

Call

Feed

SysFile

columns

The list of tile columns to load.

filter

Additional filter.


Menu item

Use the Menu item component to add additional actions to a button menu item.

View the example of a configuration object that implements the button menu item below.

Example of a configuration object that implements the button menu item
{
"type": "crt.MenuItem",
"caption": "Menu item",
"clicked": {
"request": "crt.SetViewModelAttributeRequest",
"params": {
"attributeName": "CalendarViewMode",
"value": "day"
}
},
}
type

Component type. crt.MenuItem for the Menu item component.


caption

Localizable caption of button menu item.


clicked

The request fires when a user clicks the button menu item. Creatio lets you bind the sending of a base request or custom request handlers implemented in remote module to the button click event.


Calendar

Use the Calendar component to display calendar events.

View the example of a configuration object that embeds external content into a page below.

Example of a configuration object that embeds external content into a page
{
"type": "crt.Calendar",
"templateValuesMapping": {
"startColumn": "StartDate",
"endColumn": "DueDate",
"titleColumn": "Title",
"notesColumn": "Notes",
"colorizationColumn": "Status.Color"
},
"colorizationType": "byField",
"items": "ItemsAttribute",
"dateRange": "CalendarSelectedDate",
"viewMode": "CalendarViewMode",
"focusDate": "CalendarPickerFocusDate",
"createItem": {
"request": "crt.CreateCalendarRecordRequest",
"params": {
"entityName": "Activity",
"defaultValues": [
{
"attributeName": "ShowInScheduler",
"value": "true"
}
]
}
}
}

type

Component type. crt.Calendar for the Calendar component.


templateValuesMapping

Data source columns to bind.

Parameters

startColumn*

Column that stores start date of calendar events.

endColumn*

Column that stores end date of calendar events.

titleColumn*

Column that stores title of calendar events.

notesColumn

Column that stores additional details of calendar events.

colorizationColumn

Column that stores custom color of calendar events.


colorizationType

The data source attribute that stores calendar colorization modes from the viewModelConfig schema section. Requires the colorizationColumn property.

Set up calendar colorization
  1. Add a column that stores a custom color to data source. Instructions: Implement the data source (steps 1-3).

    View the configuration object example that implements the data source of the Activity object below.

    Configuration object example that implements the data source
    "modelConfig": {
    "primaryDataSourceName": "PDS",
    "dataSources": {
    "PDS": {
    "config": {
    "entitySchemaName": "Activity",
    "attributes": {
    "Status.Color": {"path": "Status.Color"}
    }
    }
    }
    }
    }
  2. Register a custom column in the mobile app manifest.

    1. Open the mobile app manifest.
    2. Go to the SyncOptions schema section → ModelDataImportConfig.
    3. Add a configuration object of a custom column.
    4. Save the changes.

    View the configuration object example that registers a custom column of the ActivityStatus object below.

    Configuration object example that registers a custom column
    /* Synchronization settings.*/
    "SyncOptions": {
    ...,

    /* An array of models that loads data during synchronization. */
    "ModelDataImportConfig": [

    /* "ActivityStatus" model configuration. */
    {
    "Name": "ActivityStatus",
    ...,
    /* An array of the model columns for which data is imported. */
    "SyncColumns": [
    "Color"
    ]
    },
    ...,
    ]
    }

items

The data source attribute from the viewModelConfig schema section.


dateRange

The data source attribute that stores time interval from the viewModelConfig schema section.


viewMode

The data source attribute that stores calendar display modes from the viewModelConfig schema section. For example, day, 3 days, week.


focusDate

The data source attribute that stores date from the viewModelConfig schema section. For example, current date.


createItem

Configuration object that configures parameters of calendar event to create in the Calendar component. For example, tasks.


Calendar date picker

Use the Calendar date picker component to select month date.

View the example of a configuration object that implements the calendar date picker below.

Example of a configuration object that implements the calendar date picker
{
"type": "crt.CalendarDatePicker",
"showHeader": true,
"value": "SomeAttribute"
}
type

Component type. crt.CalendarDatePicker for the Calendar date picker component.


showHeader

The flag that determines whether to display the month name when you select a date. By default, false.

Available values

true

The month name is displayed.

false

The month name is not displayed.


value

The name of attribute from the viewModelConfig schema section that is changed when you select of change the date.


IFrame

Use the IFrame component to embed external content into a page.

View the example of a configuration object that embeds external content into a page below.

Example of a configuration object that embeds external content into a page
{
"type": "crt.IFrame",
"name": "Link name",
"urlContent": "https://creatio.com/",
}
type

Component type. crt.IFrame for the IFrame component.


name

The name of the URL to receive the external content.


urlContent

The URL to receive the external content.


See also

Operations with data for Mobile Creatio

Customize the Timeline component