Adding a PIM Action

Add the PIM action to a control to integrate the control with a Windows Mobile or BlackBerry PIM application.

1. Drag and drop the BlackBerry or Windows Mobile PIM action from the Palette onto a control or menu item that accepts an action. You can also add the PIM action using the Properties view for the selected control:
   1. Select the control to which you want to add the BlackBerry or Windows Mobile PIM action.
   2. In the Properties view for the control, select Actions from the left pane.
   3. In the Actions dialog, click the down arrow next to New and select BlackBerry PIM or Windows Mobile PIM.
2. In the PIM Action dialog, select from these configuration options:

   Option	Description
   BlackBerry/Windows Mobile PIM Application	Select the PIM application with which the action will interact.
   Read from Application	By default, this option is selected, and indicates that the action should retrieve information from the PIM application. When selected, the PIM application is launched and a custom menu called "Import to <client name>" is added to all the PIM applications. This menu appears on the context menu of each PIM application on the device. When the PIM action is called, the specified PIM application is launched. The user selects a specific contact, calendar, memo, or task and clicks the "Import to <client name>" menu item, which activates the PIM action on the Device Application Designer, where it loops through the list of PIM controls on the current screen. PIM controls that have valid and compatible PIM fields and attributes are populated with the corresponding value from the PIM application in which the menu was clicked.
   Write to Application	Select this option for the action to save information to the PIM application. Values are taken from the PIM controls, table, or list detail layout. The logical types are then checked to see which PIM fields and attributes are valid. The information is then saved into the corresponding PIM application.
   Data Source	When writing information to the PIM application, this option indicates where the client should get information from. For example, if you select Display, the client searches the entire screen display for controls that have logical datatypes mapped. If you select Table, the client searches only in the table. You can select Data Source only if Write to Application is also selected.
   Launch PIM Application	This option is available only if Write to Application is selected. If selected, the corresponding application is launched after writing the PIM action. Note: BlackBerry only.

3. Click OK.
4. Select File > Save.