5 Working with Objects

This chapter contains the following topics:

5.1 Understanding Objects

JD Edwards EnterpriseOne OMW enables you to administer database objects in a tool that displays nodes, tables, business views, indexes, and programs hierarchically. Rather than have an administrator manage all of the objects and track what modifications went with which SAR/Project, you do it yourself. You can create and manage a variety of objects with JD Edwards EnterpriseOne OMW, including:

  • Applications

  • Business functions

  • Data structures

  • Tables

  • Business views

  • Data and menu items

  • User defined codes (UDCs)

  • Workflow processes

5.2 Creating Objects

Access JD Edwards EnterpriseOne OMW.

  1. From the JD Edwards EnterpriseOne OMW, click Add.

  2. In Add JD Edwards Object to the Project, click the object type that you want to create, and then click OK.

    The Add Object form appears. The contents of this form vary based on the type of object that you are creating.

  3. In Add Object, complete the fields as appropriate for the type of object you are creating, and then click OK.

    Depending on the object that you are creating, a design form, which provides the functions you need to design the object, might appear. For example, if you create an interactive application, the Interactive Application Design form appears. Click the Design Tools tab to access the buttons that launch Form Design Aid, Work with Vocabulary Overrides, Work with Interactive Versions, and so on.

    Note:

    The Object Librarian name for a business view can have a maximum of 9 characters and should be formatted as follows: VzzzzzzzA.

5.2.1 Alternative Method to Accessing Design Tool Functionality

After you create an object you can also access the appropriate design tool by clicking the object, and then clicking one of the following buttons located on the left-hand side of the screen:

  • Start Design

    Select an object and then click the Start Design button to automatically launch the design tool associated with the object.

  • Start BusBuild

    Select a business function object that you have designed, and then click Start BusBuild to launch the tool used to build the business function.

  • Start Browse ER

    Select an object and then click Start Browse ER to view the object's event rules.

  • Run HTML

    Select an application and then click Run HTML to execute the application in HTML format.

5.3 Searching for Objects

This section provides an overview of object searches and discusses how to search for objects.

5.3.1 Understanding Object Searches

Conducting an efficient search is preliminary to adding objects to a project. You can search for objects by category and type, or you can perform an advanced search and find objects based on other criteria.

Note:

Searches are case-sensitive. When you enter your search criteria, enter the commonly accepted spelling in standard capitals and lower case. If you receive no search results, try different capitalization or spelling.

5.3.2 Searching for Objects

Access JD Edwards EnterpriseOne OMW.

  1. In JD Edwards EnterpriseOne OMW, click the Search tab.

  2. Complete the following fields, and then click the button next to the Search field:

    • Category. You can search a variety of categories. For example, to find a report, select Object Librarian as the category because reports are Object Librarian objects. To find a project, select JD Edwards EnterpriseOne OMW Project. To find a user, select Owners.

    • Search Type. Valid choices for this field vary based on the category that you select. If you set the search type to Object Name|Version Name, you can use the | delimiter to specify a search suffix. For example, if the category is Object Librarian and the search type is object name, entering R0008P|XJDE* displays all XJDE versions of object R0008P (Date Patterns Report).

    • Search. Entries in this field must match the Search Type that you select.

  3. To search for objects based on criteria other than category, search type, and name, click Advanced Search.

  4. In Object Librarian Search and Select, enter the desired criteria in the Query by Example columns, and then click Find.

  5. Select one or more objects, and then click Select.

    The objects that you chose appear in the information window.

5.4 Adding Objects to Projects

This section provides an overview of object addition and discusses how to:

  • Add an object.

  • Add multiple objects.

5.4.1 Understanding Object Addition

An object must exist within one of your projects before you can work with it. You can add an existing object to a project, or you can create a new object for a project. When you create a new object, the system places it in the current project that you have selected. If you did not select a project before creating the object, the system places it in your default project. Adding an object to a project neither checks out the object nor downloads the specifications of the object to your local environment.

Note:

If you try to add an object to a project that already exists in that same project, the Release Search & Select form appears because the system enables you to modify the same object across multiple releases.

5.4.2 Adding an Object

Access JD Edwards EnterpriseOne OMW.

  1. In JD Edwards EnterpriseOne OMW, click the project to which the object will be added.

  2. Find the object to add to the destination project by performing a search using the Search tab in the information window.

  3. When the search completes, on the search form, select the object to be added to the destination project.

  4. Verify that the destination project is highlighted in the project window. If it is not highlighted, click it.

  5. With the object to be added highlighted, click the Add Object or User to Project button in the center column.

5.4.3 Adding Multiple Objects

Access JD Edwards EnterpriseOne OMW.

  1. In JD Edwards EnterpriseOne OMW, click the project to which the objects will be added.

  2. Find the objects to add to the destination project by performing a search using the Search tab in the information window.

  3. Verify that the destination project is highlighted in the project window. If it is not highlighted, click it.

  4. From the Row menu, select Advanced, and then select Add All Objects.

    The system adds all of the objects that fit the search criteria to the project that you selected in step 1.

5.5 Moving Objects

You can move objects from one project to another by dragging and dropping them. Both projects and the object must be visible in your project window. This task can be used to move users from one project to another or to move a project to another project.

This section discusses how to:

  • Move an object.

  • Move multiple objects.

5.5.1 Moving an Object

Access JD Edwards EnterpriseOne OMW.

  1. In JD Edwards EnterpriseOne OMW, in the project window, click and hold the mouse button on the object that you want to move.

  2. Drag the object over the target project and release the mouse button.

    The system removes the object from the source project and adds it to the target project.

5.5.2 Moving Multiple Objects

Access JD Edwards EnterpriseOne OMW.

  1. In JD Edwards EnterpriseOne OMW, in the project window, click the project that contains the objects that you want to move.

  2. From the Row menu, select Advanced, and then select Move Objects.

  3. In Move Multiple Objects Search & Select, in the To Project field, enter the project to which you want to move the selected objects.

  4. In the detail area, click the objects that you want to move.

  5. Click Select.

    The system moves the objects from the source project to the target project. This process might take several minutes, depending on the number of objects that you selected.

5.6 Removing Objects from Projects

This action removes the reference to the object from the project; it does not delete the object. This task also can be used to remove users from a project.

Access JD Edwards EnterpriseOne OMW.

  1. In JD Edwards EnterpriseOne OMW, select an object in the project window.

  2. Click the Remove Object or User from Project button in the center column.

    Alternatively, you can select the object, click the Row exit, and then click Remove Object.

5.7 Deleting Objects

This section provides an overview of object deletion and discusses how to delete objects.

5.7.1 Understanding Object Deletion

You can delete any object from the server that is configured for the project's current status. You can also mark an object for deletion from its transfer locations upon project advancement or from its current save location (the location where the system saves the object when you click the Save button in the center column of JD Edwards EnterpriseOne OMW).

You can also use this task to remove the specifications for Object Librarian object from your workstation.

When you select Delete Object from Server, the system deletes the object from locations that are defined in the transfer activity rules when you click OK. If you select Mark Object to be Deleted from Transfer Locations, the system deletes the object from any other configured locations when the project advances.

For an Object Librarian object, you can delete the local and save specifications. If the Object Librarian object is checked in, you can delete the checked-in version of this object by choosing Delete Object from Server. If you select Mark Object to be Deleted from Transfer Locations, the Object Librarian object is deleted from its transfer locations, which are defined in the transfer activity rules when the Project Status is advanced.

5.7.2 Deleting Objects

Access JD Edwards EnterpriseOne OMW.

  1. In JD Edwards EnterpriseOne OMW, select an object in the project window.

  2. Click Delete.

    A Delete form appears. Your available options vary depending on the object type and whether the object has been checked in.

  3. Select one or more of the following options, and then click OK:

    • Delete Object from Server

      Click View Locations for a list of locations from which the object is deleted when you select this option. This action occurs as soon as you click OK.

    • Delete Object Locally

      This action occurs as soon as you click OK.

    • Delete Object from the SAVE location

      This action occurs as soon as you click OK.

    • Mark Object To Be Deleted From Transfer Locations

      Objects marked for deletion from transfer locations appear in bold letters in the project window. They are deleted from the transfer locations when the project status is advanced.

    • Remove Object from ALL locations

      This option selects all of the above options.

5.8 Downloading Object Specifications

This section provides an overview of specification downloads and discusses how to use the advanced get feature.

5.8.1 Understanding Specification Downloads

To download checked-in object specifications from the server that is defined for the current status, select the object and click the Get button in the center column. Use this function when someone else has been working on the object and you want to see the changes, or when you have made changes to the object but want to abandon them in favor of another version of the object.

The Get button enables you to get the specifications for objects that reside in your path code only. However, you can download the specifications of an object that resides in other areas of the system. For example, you might want to get the specifications for an object as it existed in a previous software release. Use the advanced get feature to specify the location of the object that you want to download.

Note:

If you want to review the object and not save any changes, use the Get button to copy the latest specifications to your local workstation instead of checking out the object and then erasing the checkout.

5.8.2 Saving and Restoring Objects and Projects

Access JD Edwards EnterpriseOne OMW.

  1. In JD Edwards EnterpriseOne OMW, select the object or project that you want to save.

  2. Click the Save button in the center column.

    The jdeomw dialog box displays. OMW provides two methods with which to save an object. The first method is to save the object to a zip file. If you save the object to a zip file, OMW saves the object or project as a local copy in a format compatible with Zip, Jar and JDEdwards Change Assistant technologies.The second method is to save the object to a shared database location. The shared location is configured by your OMW administrator, and is the most common method with which you will save objects or projects.

  3. Click Yes to save the object to a zip file, or click No to save the object to a pathcode save location.

  4. If you clicked Yes, continue to step 5. If you clicked No, OMW saves the object to pathcode save location.

  5. On the Select Folder form, select the folder to which you want to save the object, and then click Open.

To restore an object or project, access JD Edwards EnterpriseOne OMW.

  1. In JD Edwards EnterpriseOne OMW, select the object or project that you want to restore.

  2. Click the Restore button in the center column.

    The jdeomw dialog box displays and provides options for you to choose from where you want to restore the object. You can choose to restore the object from a zip file, or to restore the object from the Save location specified by the OMW administrator.

  3. Click Yes to restore the object from a zip file, or click No to restore the object from a pathcode save location.

  4. If you clicked Yes, continue to step 6. If you clicked No, OMW restores the object from the pathcode save location.

  5. On the Select Folder form, select the PAR file from which you want to restore the object or project, and then click Open.

    OMW restores the object or project.

5.8.3 Using the Advanced Get Feature

Advanced Get on Projects enables you to get projects from any pathcode. To perform an Advanced Get on Projects, every object in the project must reside in the pathcode from which you have selected the project. This functionality is only applicable to Object Librarian objects, for example, applications, UBEs, DSTR. It is not functional with UDCs, DDs, menus, and so forth.

Access JD Edwards EnterpriseOne OMW.

  1. In JD Edwards EnterpriseOne OMW, select an object in the project window.

  2. From the Row menu, select Advanced, and then select Advanced Get.

    You are prompted to decide whether you want to overwrite local specifications.

  3. Click one of the following options:

    • Yes

      If you select Yes, go to step 5.

    • No

      If you select No, continue with step 4.

  4. In Path Code Search & Select, enter the path code, and then click Find.

  5. Select the location of the object that you want to get, and then click Select.

5.8.4 Performing Quick Gets on Objects

Quick Gets enable you to perform Gets on objects returned to the OMW Project Search and Select by Object form, and the Object Librarian Search and Select form. From these forms, you can select one or many objects to Get.

Note:

When you Get an object you copy the object and its specifications to your work area without checking out the object.

Access OMW.

  1. On the Search tab of the main OMW interface, in the Category field, select Object Librarian.

    Note:

    Object Librarian is the only category for which Quick Gets is enabled.
  2. Click Advanced Search.

  3. On the Object Librarian Search and Select form, click Find.

  4. Select the objects you want to Get, click the Row menu, and then click Quick Gets.

    The Overwrite Specifications Confirmation form displays with the following options:

    Default – This option copies an object and its specifications from the configured checkout location to your work area without checking the object out.

    Advanced - Advanced Get on Projects enables you to get projects from any pathcode. To perform an Advanced Get on Projects, every object in the project must reside in the pathcode from which you have selected the project. This functionality is only applicable to Object Librarian objects, for example, applications, UBEs, DSTR. It is not functional with UDCs, DDs, menus, and so forth.

    If you choose this option, you will get the Pathcode & Select form. Enter criteria for which you want to search, and then click Select. OMW returns you to the OMW main screen.

Additionally, you can access Quick Gets using the following method:

  1. From the Row menu, select Select by Object.

    The OMW Project Search and Select by Object form displays.

  2. Enter criteria for which you want to search, and then click Select. OMW returns you to the OMW main screen, and then click Find.

  3. Choose the objects you want to get, and then click the Row menu, and then click Quick Gets.

  4. From the Row menu, select Quick Gets.

    The Overwrite Specifications Confirmation form displays with the following options:

    Default – This option copies an object and its specifications to your work area without checking the object out.

    Advanced - Advanced Get on Projects enables you to get projects from any pathcode. To perform an Advanced Get on Projects, every object in the project must reside in the pathcode from which you have selected the project. This functionality is only applicable to Object Librarian objects, for example, applications, UBEs, DSTR. It is not functional with UDCs, DDs, menus, and so forth.

    If you choose this option, you will get the Pathcode & Select form. Enter criteria for which you want to search, and then click Select. OMW returns you to the OMW main screen.

5.9 Checking Objects In and Out

This section provides an overview of object check in and check out and discusses how to:

  • Check out objects.

  • Check in objects.

  • Erase checkouts.

5.9.1 Understanding Object Check In and Check Out

You can check out an Object Librarian object that resides in your projects provided that the token for the object is either available or held by the project in which the object currently resides. Only one user at a time can check out an object. Checkout fails if the object is already checked out or if the token is unavailable. If the token is unavailable, you can join the token queue for the desired object. If you join the token queue, you will be notified when the token is available and your project will receive the token.

Check in an object when you want to upload its specifications to the server and make it publicly available. When you check in an object, the system records the project in which the object resides and ensures that only changes made under the current project are transferred when the project is advanced to a status that triggers a transfer. If you move an object from one project to another using the drag-and-drop method, the system tracks the change and records the new project for the object. However, consider the following scenario:

  1. You add an object to a project and check it out.

  2. You change the object and check it in.

  3. You use the right-facing arrow in the center column to remove the object from the project.

  4. You later add the object to a different project.

In this scenario, the system cannot track the object because it passes out of a project completely. Therefore, when you advance the second project, if the system needs to transfer the object as part of the advance, the transfer will fail because the object's last known check in project location and its current project location do not match.

When you drag-and-drop an object, the system updates its tables in such a way that the transfer can occur. This is not the case when you remove an object from a project and then add it to a different project later.

If an object is checked out, you can erase the checkout. When you erase a checkout, local changes are not uploaded to the server. Erasing the checkout for an object does not release its token, but it does enable other developers who are assigned to the same project to check out the object.

5.9.2 Checking Out Objects

Access JD Edwards EnterpriseOne OMW.

  1. In JD Edwards EnterpriseOne OMW, select an object in the project window.

  2. Click the Checkout button in the center column.

    JD Edwards EnterpriseOne OMW indicates that an object is checked out by superimposing a check mark over the object's button. Additionally, data about the object that appears in the information window is updated to reflect its checked out status.

    Note:

    If the object is unavailable, the system asks if you want to be added to the token queue for the object. If you select to join the queue, the system alerts you when the token is released and assigns the token to your project. To determine which project holds the token for an object, select the object in the project window and click the News/Status tab in the information window. The information in the News/Status window only refreshes if the window is selected. If the Search window is selected, the information in the News/Status window is not updated when you select different objects. Additionally, if you have joined a token queue, your position in the queue appears here.

5.9.3 Checking In Objects

Access JD Edwards EnterpriseOne OMW.

  1. In JD Edwards EnterpriseOne OMW, select a checked-out object in the project window.

  2. Click the check in button in the center column.

    JD Edwards EnterpriseOne OMW indicates that an object is checked in by removing the check mark that was superimposed over the object's button when it was checked out.

5.9.4 Checking in Object Specifications without Checking in the Object

You can check in an object's specifications without losing your ability to modify the object. This enables you to check in a partially completed object without having to check the object back out to continue development on it.

Access JD Edwards EnterpriseOne OMW.

  1. Select an object.

  2. From the View menu, choose Checkin/Checkout.

5.9.5 Erasing Checkouts

Access JD Edwards EnterpriseOne OMW.

  1. In JD Edwards EnterpriseOne OMW, select a checked-out object in the project window.

  2. Click the Erase Checkout button in the center column.

    JD Edwards EnterpriseOne OMW indicates that an object is no longer checked out by removing the check mark that was superimposed over the object's button when it was checked out.

5.10 Changing Objects

This section provides an overview of object changes and discusses how to change objects.

5.10.1 Understanding Object Changes

When you create an objects, JD Edwards EnterpriseOne OMW enables you to define the properties of the object. JD Edwards EnterpriseOne OMW also provides access to design tools and system actions for the object. Similarly, after the object is created, you can use JD Edwards EnterpriseOne OMW to modify the object and its specifications.

Your system administrator can also specify a separate save location that is different from your local environment and from the location of the object on the server. You save objects to this location when you select the object and click the Save button in the center column. Retrieve an object from its save location by selecting the object and clicking the Restore button in the center column. Note that the save location for the object must be different from its system location.

You must check out the object before you modify it to be able to check the object back in and upload the changes.

As users modify objects, the changes exist only in their local environments until they either save the object to its save location or check in the object to its system location.

5.10.2 Changing Objects

Access JD Edwards EnterpriseOne OMW.

  1. In JD Edwards EnterpriseOne OMW, select an object in the project window.

  2. Click the Design button in the center column.

    An appropriate design form for the object appears. The current properties of the object appear on the form.

  3. Make the necessary changes to the object, and then click OK.

5.11 Maintaining Objects in Multiple Software Release

This section provides an overview of objects in multiple software releases, lists a prerequisite, and discusses how to:

  • Add same-named objects to a project.

  • Change the release level of an object on your project.

  • Update an object to match another object.

  • Update different objects in different releases.

5.11.1 Understanding Objects in Multiple Software Releases

Same-named objects in different software releases can be modified in JD Edwards EnterpriseOne OMW in the same project. After adding the objects to the project, you can maintain them independently or you can update one to match the other. When working on objects from separate releases, JD Edwards EnterpriseOne OMW handles save and check in file paths for you, based on the Object Management Configuration. You perform the necessary modifications and use the JD Edwards EnterpriseOne OMW functions as you would normally.

Important:

Changing and maintaining objects in multiple releases can cause problems due to JD Edwards EnterpriseOne object interdependencies. Changing an object in one version and then updating the object in another version to match might cause dependent objects to malfunction.

5.11.2 Prerequisite

Determine the paths of the objects that you want to modify.

5.11.3 Adding Same-Named Objects to a Project

Access JD Edwards EnterpriseOne OMW.

  1. In JD Edwards EnterpriseOne OMW, add the first object to the project.

    Note:

    The object is added to the project at the current release level of your JD Edwards EnterpriseOne.
  2. Add the same object to the project again.

  3. In the Release Search and Select form, click Find.

    All available releases for which the object can be added to the project appear.

  4. Click the release you want, and then click Select.

    The object is added to the project for the selected release level.

5.11.4 Changing the Release Level of an Object on Your Project

Access JD Edwards EnterpriseOne OMW

  1. In JD Edwards EnterpriseOne OMW, select Advanced from the Row menu, and then select Change Release.

  2. In the Release Search and Select form, click Find.

    All available releases for which the object can be added to the project appear.

  3. Click the release that you want, and then click Select.

    The object is added to the project for the selected release level.

5.11.5 Updating an Object to Match Another Object

Access JD Edwards EnterpriseOne OMW.

  1. Check out the object A from release A.

  2. Modify the object.

  3. Check in the modified object A.

  4. Check out the object B from release B.

  5. Select object B, select Advanced from the Row menu, and then select Advanced Get.

  6. Click Yes to override local specifications.

  7. In Path Code Search & Select, find and select the path code in which the release A version of the object was checked in, and then click Select.

    In your project, the release B version of the object is modified to match the release A version of the object.

  8. Check in object B.

5.11.6 Updating Different Objects in Different Releases

Access JD Edwards EnterpriseOne OMW,

  1. Check out the object from release A.

  2. Modify the object.

  3. Check in the modified object.

  4. Check out the object from release B.

  5. Modify the object.

  6. Check in the modified object.