Adding a BlackBerry PIM Action

Add the BlackBerry PIM action to a control to select a BlackBerry PIM application.

You can assign only one BlackBerry PIM action per control.
  1. Drag and drop the BlackBerry PIM action from the Palette onto a control or menu item that accepts an action. You can also add the BlackBerry PIM action using the Properties view for the selected control:
    1. Select the control to which you want to add the BlackBerry PIM action.
    2. In the Properties view for the control, select Actions from the left pane.
    3. In the Actions dialog, click New and select BlackBerry PIM. add_pim_action
  2. In the BlackBerry PIM Action dialog, select from these configuration options:
    Option Description
    BlackBerry PIM Application Select the BlackBerry 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 BlackBerry 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 BlackBerry 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 BlackBerry 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.
  3. Click OK.
  4. Select File > Save.
Parent topic: Device Application Designer