Enabling Application of Target Lists on an Applet

You can configure list applets and association list applets so that target lists can be applied to them.

In order for a list applet to be configurable, the business component on which the applet is based must contain a multi-value ID field for the list category (accounts, contacts, employees, positions, or prospects).

To configure list and association list applets so that target lists can be applied

1. Create a multi-value link between the applet’s business component and the List Mgmt Lists business component where:

   • Destination Business Component is List Mgmt Lists.

   • Destination Link is one of the following (as appropriate for the list category that is applied in the applet):

     • SLM Account/List Mgmt Lists

     • Contact/List Mgmt Lists

     • Employee/List Mgmt Lists

     • Position/List Mgmt Lists

     • Prospects/List Mgmt Lists

     For example, the SIS Account List Applet is based on the Account business component; it contains a List Mgmt Lists multi-value link, where Destination Link is SLM Account/List Mgmt Lists.

2. Create a multi-value field for the applet’s business component where:

   • Multivalue Link is the multi-value link created in Step 1.

   • Field is ID.

3. For the applet’s business component, create a TargetProp (or TargetProp 1, TargetProp 2, and so on) user property, and enter a value for the user property in the following form:

   “Entity Display Name", “Multi-Value Field Name", “List Category"

   where:

   • Entity Display Name is a name for the user property.

   • Multi-Value Field Name is the name of the field created in Step 2.

   • List Category is one of the display values defined for the SLM_LST_CATEGORY LOV: Accounts, Contacts, Employees, Positions, or Prospects.

   For example, “Accounts", “List Mgmt List Id", “Accounts"

4. Repeat Step 1 to Step 3 for each category of list that you want to apply to the applet.

5. (If you are configuring a list applet, then skip to Step 6.) If you are configuring an association list applet, then create an Apply List button for the applet by completing the following steps:

   1. Create the ButtonApplyList control for the applet.

      The values for the new control are described in the following table.

      Field	Value
      Name	ButtonApplyList
      Caption	Apply List
      HTML Type	MiniButton
      Method Invoked	ShowPopup

   2. Create two control user properties for the new ButtonApplyList control.

      The values for the two control user properties are described in the following table.

      Field	Value for 1st User Property	Value for 2nd User Property
      Name	Mode	Popup
      Value	Edit List	SIA Apply Target List Applet - Simple

   3. Edit the Applet Web Template for the association applet to add the new ButtonApplyList control to the applet’s layout.

6. (Optional) Add an Apply List item to the menu for the cogwheel icon in the applet by completing the following steps:

   1. Create an Applet Menu Method Item for the applet.

   2. If the applet’s business component contains:

      • Only one TargetProp user property, then set Command to Apply List Popup-Simple.

      • Multiple TargetProp user properties for the applet, then set the command property to Apply List Popup.

   3. Set Menu Text to Apply List.

Note: If you do not complete this step, then a target list can still be applied by using the Apply Target List button in the toolbar or by selecting File in the application-level menu, then Apply List.