12 Working with Vocabulary Overrides

This chapter contains the following topics:

12.1 Understanding Vocabulary Overrides

Vocabulary Overrides (P9220) is an application that you can use to change the text that appears on forms and reports. You can specify both form columns and row headings, provide customization for multiple languages and industries, and retain your overrides with the next software update.

Because the Vocabulary Overrides application (P9220) affects the user interface throughout JD Edwards EnterpriseOne, it is important that you secure this application from most users. When you work with vocabulary overrides for an interactive or batch application, the Vocabulary Overrides application simulates an application checkout from the central objects repository, just as if you checked out the application by using JD Edwards EnterpriseOne OMW. This checkout is done so that, while you are working on the application in the Vocabulary Overrides application, no one can check out the application.

Note:

When the OMW line is written for the Vocabulary Overrides application, the system does not bring down specifications to the requesting workstation. Instead, the requesting workstation accesses the relational database tables directly.

After you make vocabulary override changes, use an update package to push these changes to the users.

12.2 Creating Vocabulary Overrides

You can create vocabulary overrides to customize the interactive and batch applications. After you make vocabulary override changes, use an update package to push these changes to the users. For example, you could create vocabulary overrides for the Verify OCM report. After you make vocabulary override changes, you should use an update package to push these changes to the users.

Note:

When you create a vocabulary override for a report, the override occurs at the version level. When you run the version, the vocabulary override appears on the report instead of the data dictionary description. The vocabulary override does not affect the base report specifications or any other version of the report.

12.2.1 Forms Used to Work with Vocabulary Overrides

Form Name FormID Navigation Usage
Work With Vocabulary Overrides W9220H Application Development (GH902), Object Management, Vocabulary Overrides (P9220) Locate an interactive or batch application to which you want to apply vocabulary overrides. Review existing vocabulary overrides.
Object Management Workbench W98220A In Solution Explorer, enter OMW in the Fast Pathfield. Locate an interactive or batch application to which you want to apply vocabulary overrides.
SAR Requirement W559220A On the Work With Vocabulary Overrides form, select an application and click Select. This form only appears if the system administrator set up the processing option for vocabulary overrides to require a software action request (SAR) number for overrides.
Interactive Vocabulary Overrides W9220A On the Work With Vocabulary Overrides form, select the Interactive option and click Find. Select an application, and click Select. Create and reset interactive vocabulary overrides.
Batch Vocabulary Overrides W9220B On the Work With Vocabulary Overrides form, select the Batch option and click Find. Select a batch version and click Select. Create and reset batch vocabulary overrides.
Overridden Data Item Search W9220E On the Work With Vocabulary Overrides form, from the Form menu, select Data Item Search. Review data items that contain vocabulary overrides.

12.2.2 Accessing Vocabulary Overrides from JD Edwards EnterpriseOne Solution Explorer

Access the Work With Vocabulary Overrides form.

  1. Select the Interactive or Batch option and click Find.

    Use the query by example fields to refine the search.

  2. Select an application and click Select.

    If the application that you selected is checked out or is in the save location, the system displays the following error message: This object is currently in use by a project in JD Edwards EnterpriseOne OMW (either through check out or in the save location) and is, therefore, unavailable.

    You must create vocabulary overrides for this application at another time or contact the users of the application to check in, erase their checkout, or delete the object from the save location.

  3. If the SAR Requirement form appears, enter a SAR number in the SAR Number field.

    This form appears if the system administrator set up the processing option for vocabulary overrides to require a SAR number for overrides.

  4. Click OK.

    The Interactive Vocabulary Overrides form or the Batch Vocabulary Overrides form appears. All of the interactive forms or batch versions associated with the application that you chose appear in the detail area. You can expand any row that has a plus (+) sign on the left side.

    The Vocabulary Overrides application essentially checks out this application in JD Edwards EnterpriseOne OMW so that while you are working on the application in Vocabulary Overrides, no one else can check out the application. After you finish creating overrides, Vocabulary Overrides erases the checkout in JD Edwards EnterpriseOne OMW.

12.2.3 Accessing Vocabulary Overrides from JD Edwards EnterpriseOne OMW

Access the Object Management Workbench program (P98220).

  1. On Object Management Workbench, add the object to an OMW project.

  2. Select the interactive or batch application, and then click the Design button.

    The Interactive Application Design form or the Batch Application Design form appears.

  3. On the Design Tools tab, click Vocabulary Overrides.

    The system displays the following warning: Warning! You are now accessing Vocabulary Overrides. This application will override currently checked in objects. You must have authority to make changes.

  4. If you have authorization to make vocabulary override changes, click OK.

  5. If the SAR Requirement form appears, enter a SAR number in the SAR Number field.

    This form only appears if the system administrator sets the processing option that requires a SAR number for vocabulary overrides.

  6. On the Work with Vocabulary Overrides form, click Select.

    The Interactive Vocabulary Overrides form or the Batch Vocabulary Overrides form appears. All of the interactive forms or batch versions associated with the application appear in the detail area. You can expand any row that has a plus (+) sign on the left side.

    The Vocabulary Overrides application essentially checks out this application in OMW so that while you are working on the application in Vocabulary Overrides, no one else can check out the application. After you finish creating overrides, Vocabulary Overrides erases the checkout in OMW.

12.2.4 Creating Vocabulary Overrides

Access the Interactive Vocabulary Overrides form.

  1. To work with a language other than the domestic language, on Interactive Vocabulary Overrides, complete the Language field, and then click Find.

  2. Enter a language code.

    Leave this field blank if you are creating vocabulary overrides in the domestic language.

  3. Double-click the + button next to one of the forms listed in the detail area.

    The form expands, displaying the types of text that are available on that form, such as find/browse text, control text, grid column text, exit text, and text variables.

  4. Double-click the + button for one of the types of text.

    The type of text expands, displaying all of the text that you can override.

  5. To create a vocabulary override, change the text in the Description column for a particular item.

    Click OK when you finish creating overrides.

    Note:

    Some descriptions for data items contain carriage returns and new-line characters. To create a vocabulary override for these descriptions (indicated with an icon to the left of the row), select the data item row and, from the Row menu, select Extended Text Revision.
  6. On the Extended Text Revision form, change the text in the field and click OK.

The Vocabulary Overrides application essentially checks out this application in OMW so that while you are working on the application in Vocabulary Overrides, no one can check the application out. After you finish creating overrides, Vocabulary Overrides erases the checkout in OMW.

To actually see the description change applied to the application, you must first retrieve the specifications for the application to the local client machine and run it. Do this by clicking either the Check Out or Get button in OMW.

12.2.5 Creating Batch Vocabulary Overrides

Access the Batch Vocabulary Overrides form.

  1. To work with a language other than the domestic language, on Batch Vocabulary Overrides, complete the Language field, and then click Find.

  2. Enter a language code.

    Leave this field blank if you are creating vocabulary overrides in the base (domestic) language.

  3. Double-click the + button next to one of the versions listed in the detail area.

    The version expands, displaying the types of text that are available on that version, such as page header and group sections.

  4. Double-click the + button next to one of the types of text.

    The type of text expands, displaying all of the text that you can override.

  5. To create a vocabulary override, change the text in the Description column for a particular item.

  6. Click OK when you finish creating overrides.

The Vocabulary Overrides application essentially checks out this application in OMW so that while you work on the application in Vocabulary Overrides, no one can check the application out. After you finish creating overrides, Vocabulary Overrides erases the checkout in OMW.

12.2.6 Reviewing Vocabulary Overrides

Access the Work With Vocabulary Overrides form.

You can use vocabulary overrides to review every location where someone has overridden a data item. You can view the override locations from a form or from a report.

  1. On the Work With Vocabulary Overrides form, from the Form menu, select Data Item Search.

  2. On the Overridden Data Item Search form, enter a data item to search for and then click OK.

  3. Click one of these options to select a scope for the application search:

    • Interactive Application

    • Batch

    • Both

  4. Select one of these options for the output results:

    • Interactive

      If you view the search results by using the interactive application, the Data Item Locator form appears when this search is complete. This form displays a list of all of the applications in which the data item appears.

    • Printed Report

      If you view the search results by using the printed report, an Adobe Acrobat Portable Document Format (.pdf) file is created, which you can view or print.

  5. From the Form menu, select Run Report.

12.2.7 Resetting a Vocabulary Override

Access the Interactive Vocabulary Overrides form or the Batch Vocabulary Overrides form, depending on the type of application in which you want to reset a vocabulary override.

You can reset vocabulary overrides to the original data dictionary definition. If you need to reset multiple vocabulary overrides to the default data dictionary definition, JD Edwards EnterpriseOne provides an automated process that resets overrides at the interactive form level, the batch version level, and the interactive and batch application level. When you reset vocabulary overrides at the form level, you reset all vocabulary overrides on a specific form—for example, the Work with Addresses form (W01012B) in the Address Book application. When you reset vocabulary overrides at the application level, you reset all vocabulary overrides on all forms or versions in an entire interactive or batch application—for example, the Address Book application (P0101) or the Print Mailing Labels report (R01401).

  1. Double-click the + button in the row header for one of the forms or versions in the detail area, and then double-click the + button in the row header for a type of text on the form or a type of section in the version.

    The detail area expands to display the data items associated with the type of text or section.

  2. Select the data item that you want to reset, and then, from the Row menu, select Reset Description.

    Note:

    The Reset Description menu option is inactive if a vocabulary override does not exist for the data item.
  3. Click OK to return to the Work With Vocabulary Overrides form.

    If you click Cancel to return to the Work With Vocabulary Overrides form after you reset a vocabulary override, you do not cancel the action. The data item remains at the default data dictionary definition.

12.2.8 Resetting All Vocabulary Overrides on a Form (Interactive and Batch)

Access the Work With Vocabulary Overrides form.

  1. Click one of these options and then click Find:

    • Interactive

    • Batch

  2. Select an application and click Select.

    Depending on the type of application, either the Interactive Vocabulary Overrides form or the Batch Vocabulary Overrides form appears. The detail area displays forms for interactive applications and versions for batch applications.

  3. From the Form menu, select Reset by Application for interactive applications or Reset by Batch for batch applications.

    The software clears all vocabulary overrides from the entire application and resets the data items to the base definitions. If no base definition exists for a data item, the software resets the data item to the default data dictionary definition.

    Important:

    When you select either the Reset by Application or the Reset by Batch menu option, the decision is final; the software does not provide a confirmation box or a proof mode.