Creating data dictionary menus

To create a data dictionary menu

1. In Developer Studio, select File > New > dataDictionaryMenuType, where dataDictionaryMenuType is one of these values:
   • Field Data Dictionary Menu—The menu pulls labels and values from field objects in the data dictionary.
   • Form Data Dictionary Menu—The menu pulls labels and values from form objects in the data dictionary.
   • License Data Dictionary Menu—The menu pulls labels and values for licenses as per the licensing pricing models that are configured using the license key.
2. Select the server on which to create the menu, and click Finish.
   A new data dictionary menu appears as shown in the following figures.
   
   New field data dictionary menu
   
   
   New form data dictionary menu
   
   
   New license data dictionary menu
   
3. In the Refresh list, select the appropriate refresh mode.
   See Setting-a-refresh-mode-for-menus.
4. In the Server Name list, select the server from which the objects will be selected.
   You must have administrator permissions to the specified server.
   You can also enter a field ID, such as $fieldID$, so that the value in that field is used as the server name at runtime.
5. In the Label Format list, select a format for menu items:
   • Name—The name of the object in the database.
   • Label—The label displayed for the object in the client.
   • ID—The ID of the object.
6. In the Value Format list, select a format for displaying values in the field to which the menu is attached.
   You can specify the value name, label, or ID in various formats, such as plain (Name), or enclosed in single quotation marks (Name) or dollar signs ($Name$). You can specify pairs of values separated by semicolons, for example, ID;Label or ;Name;Label.

7. Select the object type to pull data from.

   Data Dictionary Menu	Options
   For field data dictionary menu	Click the ellipsis button next to the Form Name field, and use the Form Selector dialog box to select the form that contains the fields to pull data from. To shorten the list of available forms: In the Name field, enter the initial letters of the form name. In the Application field, select the appropriate application. To find a form in the Available Forms list, perform one of these actions: Scroll through the list. In the Locate field, enter the first characters of the form name. In the Field Type area, select one or more field types. The menu will be constructed from fields that match the selected types.
   For form data dictionary menu	In the Form Type list, select the type of form to pull data from. The menu will be constructed from fields that match the selected types. To display hidden forms matching the form type, select the Show Hidden Forms check box.
   For license data dictionary menu	In the License Type list, select the types of license. AR User—This includes the AR User Fixed and AR User Floating licenses. Application User—This includes user licenses for BMC applications (for example, BMC:Change Management User Fixed) and user licenses for custom applications. Bundled User—This includes new bundled licenses as per the licensing pricing models that are configured using the license key. Component/Application—This includes licenses that allow you to enable a specific component functionality (for example, the AR Distributed server, which enables DSO functionality) and also includes an application license for BMC applications and custom applications (for example, setting BMC:Change Management license limit to 1 allows you to use the Change Management application).

8. (Optional) Modify the menu's change history.
   See Updating-the-change-history-of-fields-forms-or-objects.
9. (Optional) Add Help text to the menu.
   See Creating-help-for-applications.
10. Select File > Save.
11. In the Save Menu As dialog box, enter a name for the menu, and click OK.
    Menu names must be unique on each AR System server.
    Names can have as many as 80 characters, including spaces. Names can include double-byte characters, but avoid using numbers at the beginning of the name.
12. Attach the menu to any character field in any form.
    See Creating-common-data-fields and Menu Name.