Salesforce Docs Portal

Configure an Edit Block (Managed Package)

For the managed package runtime, Edit Blocks enable a user to add and edit multiple entries in a single array. For example, you can use an Edit Block to list and edit an Account's list of Contacts. Edit Blocks are repeatable blocks by default. You can prefill repeatable blocks with data by using an array format.

Managed Package app icon This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see Omnistudio Help.

Displaying Elements in an Edit Block

Edit Block displays three elements in the Edit Block's default view and can display additional elements in the edit view. It's possible to hide elements from the edit view.

  • To display an element in the Edit Block's default view, check the checkbox next to the element in the structure panel. The element also appears when editing an entry.

    Example Default View:

    image

  • To display elements only when a user edits an entry, leave the checkbox next to the element in the structure panel unchecked.

    Example Edit View:

    image

  • To hide an element in the Edit Block, click Edit as JSON in the element and set Hide equal to true. For more information, see Hide Omniscript Elements (Managed Package).

  • To display an element only in the Edit Block's default view, check the checkbox next to the element in the structure panel. Then click Edit as JSON in the element and set Hide equal to true. The element displays in the entry's default view and is hidden when editing the entry.

Note
Note You can't nest Edit Blocks within other Edit Blocks, and you can add only one level of Block inside an Edit Block. Also, Edit Blocks don’t support the Custom LWC Element.

Setting Display Modes and Templates

Enable LWC Omniscripts and Angular Omniscripts to display different Edit Block user interfaces by using LWC Modes and Angular Templates.

LWC Modes

Select a Mode in the Edit Block's Edit Block Mode field to change the display and functionality of the Edit Block.

Mode

Configuration Notes

Lightning Example

Newport Example

Inline

n/a
image
image

Table

The maximum number of elements that you can display as columns is 6.

Currently, edit blocks configured in table mode in Omniscripts aren't compatible with screen readers. If you use a screen reader, we recommend that you use Flexcards instead of Omniscripts. In Flexcards, you can use data tables or Lightning datatables that are compatible with screen readers. See Show Data in a Table on a Flexcard and Lightning Web Component – Datatable.
image
image

Financial Statement (FS)

  • The total combined width of the elements must be less than or equal to 12.

  • Vlocity recommends displaying fewer than twelve elements.

  • Hidden elements don't affect the total display width.
image
image

Cards

n/a
image
image

LongCards

The width of LongCards must be set to 12.
image
image

Angular Templates

Add a template to the EditBlock's HTML Template Id field to modify the display and functionality of the Edit Block.

Template Name

Lightning Example

Newport Example

Responsive table - vlcEditBlock.html
image
image

Cards - vlcEditBlockCards.html
image
image

Financial Statement - vlcEditBlockFS.html
image
image

Inline - vlcEditBlockInline.html
image
image

Long cards - vlcEditBlockLongCards.html
image
image

Compatible Elements

The following elements are compatible with Edit Block:

  • Aggregate

  • Checkbox

  • Currency

  • Date

  • Date/Time

  • Disclosure

  • Email

  • File

  • Formula

  • Headline

  • HTTP Action

  • Image

  • Integration Procedure Action

  • Line Break

  • Lookup

  • Matrix Action

  • Multi-select

  • Number

  • Password

  • Radio

  • Radio Group

  • Range

  • Remote Action

  • Select

  • Signature

  • Telephone

  • Text

  • Text Area

  • Text Block

  • Type Ahead Block

  • Time

  • URL

What's Next

Add actions to an Edit Block or use sObject mapping to create, edit, and delete records. See Add, Edit, and Delete Records with Edit Block Actions (Managed Package).