Omniscripts Multi-Select Element (Managed Package)

For the managed package runtime, enable users to select from multiple items by adding the Multi-select element to your Omniscript. Display options vertically, horizontally, or as an image.

1. Drag a Multi-select element from the Build panel onto the canvas.
2. In the Properties panel, give the element a name in the Name field.
3. In Field Label, enter a label visible to the user.
4. (Optional) In Display Mode, select how to display the radio buttons. These options are available:

   • Horizontal: (Default) Display radio buttons next to each other.

   • Vertical: Display radio buttons stacked.

   • Image: Display each radio button as an image.

     Read-only Multi-Select element images render in grayscale. To restore color for these images, see Restore Color for Read-Only Multi-Select Element Images (Managed Package).

5. (Optional) If you select Image in Display Mode, the following are additional properties you can configure:

   • Width: Sets the image width.

   • Height: Sets the image height.

   • Image Count In Row: Sets how many images per row to display.

   • Enable Caption: Displays a caption below the image.

6. In Option Source, select where the list of options come from. Select from one of the following:

   • Manual: (Default) Manually enter value/label pairs. Available when Display Mode isn’t Image.

   • Custom: Enter the Apex class and method that returns the options. Use the format ClassName.method. See Populating Picklist Values From Apex (Managed Package).

   • SObject: Retrieves the picklist values from the Salesforce object and field. Use the format ObjectAPIName.FieldAPIName.

   • Image: When Image is selected as Display Mode, manually enter value/label pairs and upload images to display. If no image is uploaded, the label displays in the image box.

7. If you select Manual or Image as an Option Source, for each option follow these steps:

   1. Click + Add New Option.

   2. Enter the Value and visible Label.

   3. If your option is an image, select an image available from the Choose existing image dropdown. Or upload an image from your computer from the Or upload new image section.

   4. (Optional) Check Use as Default to select the option by default.

8. If you select Custom as an Option Source, in the Source, enter the name of a method to call on a class in the format class.method.
9. If you select SObject as an Option Source, in the Source, enter the name of a field on an object in the format SObject.field.
10. (Optional) To display options based on the selection of another value, configure Controlling Field Type by following these steps:

    1. To define the source of the controlling field:

       • To retrieve picklist options from an Apex class, select Custom.

       • To retrieve dependent picklist values from a Salesforce object, select SObject.

    2. In Controlling Field Source, enter an Apex class.

    3. In Controlling Field Element, enter an Omniscript element name.

11. (Optional) For additional properties, see Common Omniscript Element Properties Definitions (Managed Package).

• Restore Color for Read-Only Multi-Select Element Images (Managed Package)
  For the managed package runtime, read-only Multi-Select element images render in grayscale. To restore color for these images, create a .css file, save it as a static resource, then reference it in the Custom Lightning Stylesheet File Name property in Omniscript Setup.
• Multi-Select Properties (Managed Package)
  For the managed package runtime, Multi-Select properties are configurable from the Properties panel when you select a Multi-Select element. With the Multi-Select element, enable users to select one or more items from one or more options in your Omniscript.