Layout Setting Field Reference

The Layout Setting record type is intended to store configurations of Catalog, Promotions, Delivery Summary and Order layouts for Salesforce and the CT Mobile app.


Object record type API name: LayoutSetting


Field API Name Type Description

Object

orders__Object__c

Text(255)

Specify the API name of the object for which the settings are configured.

If set, it will be prioritized over the orders__ParentObject__c field.

Parent Object

orders__ParentObject__c

Text(255)

Specify the API name of the parent object for which the settings are configured if the object has master-detail relationships with another object.

If the object does not have the master-detail relationship with the object specified in the orders__Object__c field, the setting will not be applied.

If set, the orders__RecordType__c and orders__SalesOrganizationId__c are specified for a parent object.

Record Type

orders__RecordType__c

Text(255)

A record type for which the layout is configured.

  • Pay attention that the CT Order object has no record types by default.

  • To use different layouts depending on the CT Order record type, create a separate record of this setting for each desired record type.

  • If not specified, the settings will be applied to all record types.

  • If orders__ParentObject__c is set, the record type should be specified for this object. If not set, the same layout will be applied for the objects specified in the orders__Object__c or orders__ParentObject__c fields.

Sales Organization

orders__SalesOrganizationId__c

Lookup(Sales Organization)

The business unit for which settings are configured.

  • If specified, the setting will be applied to a particular Sales Organization.

  • If blank, the setting can be applied to all sales organizations.

If orders__ParentObject__c is set, the Sales Organization should be specified for this object.

Fields to Display

orders__FeildsToDisplay__c

Long Text Area(1000)

Specify the list of fields that will be displayed on the layout (separated by a comma, without spaces).

Support display fields on the related Product object in the ParentId__r.Field format, only as read-only fields on the Catalog Line Item and Promotion Line Item layouts.

Required Attributes

orders__RerquiredAttributes__c

Text(255)

For the specified fields in the orders__FeildsToDisplay__c field, list correspondingly the attributes true/false (separated by the comma, without spaces) to define which fields should be mandatorily filled out. An empty value of the attribute is applied as false.

The specified fields must be of the following types:

Fields of any other type will remain read-only regardless of the applied settings.
  • Text

  • Number

  • Currency

  • Percent

  • Date

  • DateTime

  • Email

  • URL

  • Phone

  • PickList

  • MultiPickList

Read Only Attributes

orders__ReadOnlyAttributes__c

Text(255)

For the specified fields in the Fields to Display, list correspondingly the attributes true/false (separated by the coma, without spaces) to define which fields should be set as read-only.

An empty value of the attribute is applied as false.

In the CT Mobile app, fields with this attribute will not be displayed on the layout, for example, when creating a new order.

Some fields are filled automatically on the objects when a product is being added and have always a read-only status.

  • Order Line Item:

    • orders__ListPrice__c

    • orders__CatalogId__c

    • orders__CatalogLineItemId__c

    • orders__FreebieConditionId__c

    • orders__FreebieLevelId__c, orders__FreebieTypeId__c

    • orders__OrderId__c

    • orders__ParentId__c

    • orders__PriceBookId__c

    • orders__PriceBookLineItemId__c

    • orders__Product2Id__c

    • orders__ProductId__c

    • orders__ProductComponentId__c

    • orders__PromotionId__c

    • orders__PromotionLineItemId__c

  • OM Settings:

    • orders__QuantityField__c

Displayed Field Width

orders__DisplayedFieldWidth__c

Text(255)

Set fields width as a percentage of visible part of the screen in the following format:

'Product Name,Quantity,Field1,Field2,..,FieldN'

where Field1, Field2, FieldN are fields listed in the Fields To Display.

Use 0 for default width.

Applies only to the Order Line Item layout.

Order Currency

CurrencyIsoCode

Picklist

Available since CT Mobile version 2.9

Applies to CT Order related objects (Order Line Item, Delivery Line Item, Calculated Discount) and requires multiple currency activation. Is the standard Salesforce field to select currency while creating order in the CT Mobile app. Do not change the currency after saving the order.

For lookup fields, you can set up lookup filters to control data that should be displayed in Delivery Summary.

Required Layouts

It is necessary to create the Settings record with the Layout Setting record type for the following objects:

Additionally, customize a mini layout for the CT Order object to display desired fields when creating a new order in the CT Mobile app.

Search the Appropriate Layout

The Settings record with the Layout Settings record type will be applied when the criteria are met. The search is carried out in the following order:

Salesforce CT Mobile
  1. With the specified record type and sales organization.

  2. With the specified record type.

  3. With the specified sales organization.

  4. Without specified record type and sales organization.

  1. With the specified record type and sales organization.

  2. With the specified record type.

  3. Without specified record type and sales organization.

``