Jump to: navigation, search

Identify Customer Block

Use this block to identify a customer in the database based on search criteria, which can be Profile Core customer profile data or customer extension data. If the customer is found, then Context Services can provide data that can be used to personalize offer or to resume/modify a service in process.

Note: Prior to using this block, set Context Services Preferences. For detailed information on how Universal Contact Server identifies customers, see the Context Services User's Guide. For an example of how to use this block, see the Getting and Using E-mail Addresses topic.

The Identify Customer block has the following properties. The behavior of some properties can vary depending on whether you are in offline or online mode.

Name Property

Find this property's details under Common Properties for Callflow Blocks or Common Properties for Workflow Blocks.

Block Notes Property

Find this property's details under Common Properties for Callflow Blocks or Common Properties for Workflow Blocks.

Extensions Property

Find this property's details under Common Properties Context Services.

Get Attributes Property

Use this property to control whether only matching Customer IDs are returned (No) or whether all profile attributes are returned (Yes).

  1. Click under Value to display the OpenDialogBoxButton.gif button.
  2. Click the OpenDialogBoxButton.gif button to open the Get Attribute dialog box.
  1. Opposite Type, click the down arrow and select one of the following:
  • Variable. Then click the Value down arrow and select the name of the variable.
  • Literal.  Then for Value, select Yes or No.

Exceptions Property

Find this property's details under Common Properties for Callflow Blocks or Common Properties for Workflow Blocks.

You can also define custom events.

Suppress Customer Not Found Exception Property

  • If set to true, no exception will be raised when no customer is found. The Customer Data array will be empty. See the Customer Data property below.
  • If set to false (default), the error.com.genesyslab.composer.customernotfound exception is raised when no matching customer is found.

Customer Attributes Property

Use this property to specify a list of attributes which will be used to search for the customer. To specify customer attributes:

  1. Click under Value to display the OpenDialogBoxButton.gif button.
  2. Click the OpenDialogBoxButton.gif button to open the Customer Attributes dialog box.
  3. Click Add in the dialog box to open the Customer Attribute dialog box.
  4. Opposite Extension, click the down arrow and select either Core (for customer profile core data) or a customer profile extension.
  • If you select Core, select a core attribute from the Attribute dropdown menu. For example, you might select Core and then CustomerSegment.
  • If you select an extension, select the extension attribute name from the Attribute dropdown menu.  

Note: In offline mode, for both core and extension data, there is an additional field ‘’Attribute Type” where you must choose between string, Boolean,  integer, long, double, date, datetime, or currency depending on the customer profile attribute definition.

  1. Click the down arrow opposite Type and select Literal or Variable.
  • If you select Literal, then for Value, enter the value of the attribute. For example, if you are looking for a customer having LastName=Rosen, you would key in Rosen.
  • If you select Variable, select the variable under Value.
  1. Click OK to close the Customer Attribute dialog box. The Customer Attributes dialog box reflects your entries. You can also use this dialog box to edit and remove entries.

Identification Key Property

Use this property to specify the name of the key to be used for lookups. If specified, speeds the lookup. The key can be contained in a variable.

  1. Click under Value to display the OpenDialogBoxButton.gif button.
  2. Click the OpenDialogBoxButton.gif button to open the Identification Key dialog box.
  3. Opposite Type, click the down arrow and select one of the following:
  • Context Services. Then click the Value down arrow and select the key. If Context Services attributes have been mapped to Configuration Server Business Attributes, you can select an Identification Key name for Value.
  • Variable. Select the name of the variable.
  • Literal. Enter the name of the key.

Customer Count Property

Click the down arrow under Value to select a variable whose value is the number of customer records returned by Universal Contact Server. This feature is for your convenience.  It also serves the purpose of retaining the original number of records returned in case the returned data is modified through other blocks.

Customer Data Property

Click the down arrow under Value to select a variable whose value will be the JSON array containing data returned.

If no matching customers are found, an empty array is returned and an exception will be thrown unless the Suppress Customer Not Found Exception property is set to true.

Variables Mapping Property

Variables Mapping Property Use this property to map the JSON data returned by this block to variables. See the Variables Mapping topic for details.

Condition Property

Find this property's details under Common Properties.

Logging Details Property

Find this property's details under Common Properties.

Log Level Property

Find this property's details under Common Properties.

Enable Status Property

Find this property's details under Common Properties.

This page was last edited on November 19, 2013, at 21:07.
Comments or questions about this documentation? Contact us for support!