Receiving messages

The data components, which refers to tables, charts, crosstabs and geographic maps, in a library component can receive messages, including the built-in messages 0001 - Filter, 0002 - Sort, 0003 - Parameter, 0004 - Parameters and user defined messages that are sent out by itself or another library component. You can then specify actions such as filtering, sorting, re-running library component with predefined parameter values and changing object properties on the data component to respond the received messages.

To make a data component receive messages and respond corresponding web actions:

1. Select the data component in a library component, right-click and select Receive Message from the shortcut menu to display the Receive Message dialog. See the dialog.

   

2. Click to add a message line.
3. Select the message you want the data component to receive from the Message ID column.
   • 0001 - Filter
     When the data component receive this message, it will filter itself based on the filter condition defined in the message.
   • 0002 - Sort
     When the data component receive this message, it will sort itself based on the sort condition defined in the message.
   • 0003 - Parameter
     When the data component receive this message, the library component which contains the data component will be re-run with the parameter value defined in the message.
   • 0004 - Parameters
     When the data component receive this message, the library component which contains the data component will be re-run with all the parameter values defined in the message.
   • User Defined
     Specifies to receive a user defined message.
4. When a user defined message is selected, input the ID of the message in the Message ID column, and the name of the message in the Message Name column.
5. If a built-in message is selected, the action the message will respond cannot be changed, but you can edit how the action will be performed as you want.

   If a user define message is selected, you can specify the action the data component will respond when it receives the message and define how the action will be performed.

6. Repeat the above steps to add more messages to receive and define the actions to respond the messages. To delete a message, select it and click
7. For message of the same ID and name, you can make the data component receive it more than once, and in which order the actions defined in the message will be excuted is determined by the order of the messages in the list. To adjust the order, select the message and click or , then for message with the same ID and name, the higher a message is placed in the list, the eariler the action defined in it will be excuted.
8. Upon finish, click OK to close the dialog.

The following topics show how to make a data component receive a message in detail:

• Receiving a built-in message
• Receiving a user defined message