5 Building the Data Model

This chapter contains the following topics:

5.1 Understanding the Data Model

The data model for EnterpriseOne ADF applications includes foundation classes that hold the data returned from AIS services. These classes are specific to the EnterpriseOne application forms accessed by an ADF application's data control. You use the AIS Client Class Generator to generate these classes in JDeveloper and typically add them to the Model project along with the data control class.

5.2 Configuring the AIS Client Class Generator

The AIS Client Class Generator is available as a JDeveloper extension. Before you configure it, you must install the extension. See Chapter 3, "Getting Started" in this guide for instructions on how to install the extension.

To configure the AIS Client Class Generator:

  1. In JDeveloper, access Preferences:

    On Microsoft Windows, select the Tools menu, Preferences.

    On Mac, select the JDeveloper menu, Preferences.

  2. Select AIS Client Class Generator.

  3. Press the Load Extension button, if visible, to display the AIS Client Class Generator form.

  4. On Preferences, complete the following fields to specify the AIS Server location and AIS Server information:

    • AIS Server URL. This is a fully qualified URL to the AIS Server. Make sure it ends with the port number of the AIS Server.

    • JAS Server URL. (Optional) Only enter a value if you want to override the value configured on the AIS Server.

    • Username. Enter a JD Edwards EnterpriseOne user name.

    • Password. Enter a JD Edwards EnterpriseOne user password.

    • Environment. (Optional) Enter a value only if you want to override the value configured on the AIS Server.

    • Role. (Optional) Enter a value only if you want to override the value configured on the AIS Server.

    • JSON Files Folder. The directory where JSON data files are saved, if you elect to retain the generated JSON.

    • Default Java Classes Folder. The directory where the generated form classes are stored, if an active project is not selected.

    • Java Package. Enter the name of the Java package assigned to the generated form classes. This will also determine the folder structure for the Java classes in the project src folder.

  5. Click OK.

5.3 Generating Data Classes Based on a Form

Use the AIS Client Class Generator to generate data classes for an EnterpriseOne form. In the AIS Client Class Generator, you supply the service request information.

Note:

The AIS Client Class Generator supports form interconnects only; it does not support form events.

To use the AIS Client Class Generator to generate data classes:

  1. In JDeveloper, select the Model project in your ADF application workspace.

    JDeveloper will save the classes generated by the AIS Client Class Generator in this location.

  2. Select AIS Client Class Generator from the Tools menu.

  3. On AIS Client Class Generator, complete the following fields to supply the service request information:

    • Username. This contains the default value entered in the preferences.

    • Password. This contains the default value entered in the preferences.

    • Environment. This contains the default value entered in the preferences.

    • Role. This contains the default value entered in the preferences.

    • Application Name. Enter the name of the EnterpriseOne application.

    • Form Name. Enter the name of the EnterpriseOne application form.

    • Version. (Optional) Enter the version name. If you leave it blank, the generator will use ZJDE0001 by default.

    • MaxPageSize. (Optional)

    • ReturnControlIDs. (Optional) Use this field to specify the exact fields on the form that you want generated. The return control IDs can specify hidden fields or a subset of fields.

    • FormInputs. (Optional)

    • FormServiceAction. Enter the action to be performed. Valid values include: Create, Read, Update, Delete.

    • FindOnEntry. (Optional)

    • DemoMode. (Optional, but recommended) This ensures at least one grid row is present, so grid classes are generated even if there is no data in the database.

    • Generate for Mobile Application. Ensure that this check box is not checked

  4. Select the Preview JSON Data and Keep JSON Files check boxes, if you want to preview and keep the generated JSON files.

  5. Click the Generate button to generate the JSON, and then verify that it has the fields and records you need.

  6. Click Continue to generate the Java files.

    If successful, a confirmation message appears that shows the locations of the JSON files and the form service classes.

  7. Highlight the Model project and then click the refresh button to display the new files.