Applications Administration Guide > Global Target List Management > About Configuring Target Lists >

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 an 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 = List Mgmt Lists
   • Destination Link is one of the following (as appropriate for the list category that will be 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 multi-value link called List Mgmt Lists, where Destination Link = SLM Account/List Mgmt Lists.

2. Create a multi-value field for the applet's business component where:
   • Multivalue Link = The multi-value link created in Step 1
   • Field = Id
3. For the applet's business component, create a user property called TargetProp (or TargetProp 1, TargetProp 2, and so on), and enter a value for the user property in the form:

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

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

   The following table describes each term.

   Term in User Property Value	Description
   Entity Display Name	This must be one of the Language-Independent Code values defined for the SLM_FIELD_DISPLAY LOV.
   Multi-Value Field Name	The name of the field created in Step 2.
   List Category	This must be one of the display values defined for the SLM_LST_CATEGORY LOV: Account, Contact, Employee, Position, or Prospect.

4. Repeat Step 1 to Step 3 for each category of list that you want to be able to apply to the applet.
5. If you are configuring an association list applet, create an Apply List button for the applet: (If you are configuring a list applet, skip to Step 6.)
   1. Create the ButtonApplyList control for the applet.

      The following table describes the values for the new control.

      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 following table describes the values for the two control user properties.

      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 applet's menu button.
   1. Create an Applet Menu Method Item for the applet.
   2. If the applet's business component contains
      • Only one TargetProp user property, set Command to Apply List Popup—Simple.
      • Multiple TargetProp user properties for the applet, set the command property to Apply List Popup.
   3. Set Menu Text to Apply List.

      NOTE:  If you do not carry out this step, target list can still be applied using the Apply Target List button in the toolbar or using the application-level menu Edit > Apply List.