Create list Attributes

This article explains list Attributes and how to create them in Lightico settings.

What is a list Attribute

While a basic Attribute can hold only one value at a time, a list Attribute can hold multiple values simultaneously.

For example, a basic number Attribute called account_number can hold only one account number per session. However, you may need to obtain a list of account numbers. In that case you could bind the account_number Attribute to a list Attribute called, for example, bank_accounts enabling you to hold multiple account numbers.

A list of complex Attributes

You can also create a list of complex Attributes where each item on the list includes multiple data points.

For example, for the bank_accounts list Attribute you can associate a complex Attribute called bank_account_information which contains not only the account number, but also the type of account, date of opening the account, and current balance.

Now each item in the list holds four Attribute values.

Where can you use list Attributes

List Attributes are used in a collaboration session in the following ways:

• Form - Add list Attribute fields to a Form to obtain lists of customer information.

• Dynamic Document - Include the information obtained with the Form in a Dynamic Document where it appear in a dynamic table that expands to fit the number of items in the list.

• Event - All values are available for retrieval in the Workflow completed event in the customerData parameter.

  

How to create a list Attribute

Note

Currently, list Attributes are created in the Form builder or HTML builder and cannot be created from the Attributes mapping page.

To create a list Attribute:

1. On the Form builder page, click the add (+) icon and select Attribute.

   

   The Select Attribute window opens.

2. Click Create Attribute and select List.

   

   The Create Attribute window opens.

3. Type a name and label for the Attribute.

   

4. Click in the Select Attribute field.

   

5. Select an Attribute to be repeated in the list.

   

6. Click Save.
   The list Attribute is saved and can be used in all supported areas of the Lightico platform.

Customer experience

The customer Form requires the customer to enter the number of mandatory instances of the Attribute (in the illustration below the minimum is 3). They can then click Add item to add instances up until the defined maximum limit. The customer can also remove an optional instance by clicking the X.

A list Attribute associated with a complex Attribute appears on the form as a list of instances of the group of Attributes. Each instance shows all Attributes in the group. Clicking Add item adds another instance of the whole group.