6 Working with Batch Version Specifications

This chapter contains the following topics:

Section 6.1, "Understanding Batch Version Specifications"
Section 6.2, "Checking Out and Checking In Batch Versions from the Microsoft Windows Client"
Section 6.3, "Copying Batch Version Specifications to an Enterprise Server"

6.1 Understanding Batch Version Specifications

Oracle JD Edwards EnterpriseOne batch versions read their specifications from the associated report template. Typically, any modifications that you make to a report template are read by all of the associated batch versions. The exception to this is a batch version in which you have overridden specifications.

Unlike other JD Edwards EnterpriseOne objects, you can submit the specifications of new and modified batch versions to the server without creating a package. However, the associated batch application must already be checked in.

6.2 Checking Out and Checking In Batch Versions from the Microsoft Windows Client

This section provides overviews of checking in and checking out batch versions and erasing the check out record for batch versions, and lists the forms used to check out, check in, and erase the check out of batch versions.

6.2.1 Understanding Checking Out and Checking In Batch Versions

You must check out batch versions before you can:

Modify batch versions using JD Edwards EnterpriseOne Report Design Aid (RDA).
Set data selection from the Row menu of the JD Edwards EnterpriseOne Batch Versions (P98305) application.
Set data sequencing from the Row menu of the Oracle's JD Edwards EnterpriseOne Batch Versions application.

When you check out a report object, or any JD Edwards EnterpriseOne object, the system copies the object specifications from the central objects location to the workstation. The set of central objects that the system accesses is defined in JD Edwards EnterpriseOne Object Management Configuration (P98230) application. Only batch versions that reside in that set of central objects are visible. A batch version cannot be checked out by more than one user at a time.

If you check out a batch version and do not make any changes to it, erase the check-out record so that other users can check it out. You need to check out a batch version if you want to make modifications that override the master report template specifications. You do not need to check out a batch version to make these changes at runtime:

Data selection
Data sequencing
Location
Processing option values

These runtime changes are not saved with the batch version. However, if you make changes to data selection or data sequencing from the Work With Batch Versions - Available Versions form, you must first check out the batch version. You then check the batch version in to save the changes and make them available to the enterprise. You can check in and check out batch versions either from JD Edwards Object Management Workbench (P98220) or from the Row menu on the Advanced Operations form in JD Edwards EnterpriseOne Batch Versions.

Before you check in batch versions, make sure that you want the changes that you made to be permanent. When you check in batch versions, the system copies the specifications to the central objects location. The new specifications override the previous specifications for the version. The report specifications on the workstation remain intact.

Note:

Checking in, checking out, or erasing the checkout of a version only applies when working with batch versions from the Microsoft Windows client. Changes to data selection or data sequencing for batch versions accessed from the web client are updated to central objects automatically, which makes them available to the enterprise without the need to check them out or in. Therefore, make sure that you want your changes to be permanent before making data selection or data sequencing modifications to batch versions accessed from the web client.

6.2.2 Understanding Erasing the Check Out Record for Batch Versions

Batch versions, as with all JD Edwards EnterpriseOne objects, can be checked out by only one person at a time. Erasing the check-out record allows another user to check out the version and leaves the specifications on the server unchanged. After you have erased the check out of a batch version, you cannot check in the version. However, the report specifications on the workstation remain intact.

When you erase the check out of a batch version, the system updates the checked out status field in the Versions List (F983051) table from Y to N. The system also updates the location field in the Versions List table. This value is changed from the location of the workstation that checked out the version to the machine name of the central object's server.

You can erase the check out of batch versions using JD Edwards EnterpriseOne Object Management Workbench or JD Edwards EnterpriseOne Batch Versions.

6.2.3 Forms Used for Checking Out, Checking In, and Erasing the Check Out of Batch Versions

Form Name	FormID	Navigation	Usage
Work With Batch Versions - Available Versions	W98305A	EnterpriseOne Life Cycle Tools, Report Management (GH9111), Batch Versions	Enter the name of a batch application and select from available batch versions.
Advanced Operations	W98305J	Select a batch version and Select Advanced from the Row menu of the Work With Batch Versions - Available Versions form.	Check in, check out, and erase the check out of batch versions.

6.3 Copying Batch Version Specifications to an Enterprise Server

This section provides an overview of copying batch version specifications to an enterprise server and lists the forms used to copy batch version specifications.

6.3.1 Understanding Copying Batch Version Specifications to an Enterprise Server

You can copy batch version specifications to an enterprise server without building a package for deployment. You can do this any time the associated report template specifications already reside on the enterprise server. You should use this process when you override the specifications in batch versions.

It is imperative that you copy batch version specifications to an enterprise server when you modify a batch version that is called by another batch version. After you modify the batch version, use this option to copy the version specifications to the same location as the batch version that calls it. This procedure ensures that the batch version calls the updated specifications, rather than obsolete specifications.

6.3.2 Forms Used to Copy Batch Version Specifications

Form Name	FormID	Navigation	Usage
Work With Batch Versions - Available Versions	W98305A or W98305WA	EnterpriseOne Life Cycle Tools, Report Management (GH9111), Batch Versions	Enter the name of a batch application and select from available batch versions.
Version Prompting	W98305D or W98305WD	Select a batch version and click Select on the Work With Batch Versions - Available Versions form.	Access advanced options.
Advanced Version Prompting	W98305I or W98305WI	Click Advanced on the Form menu of the Version Prompting form.	Select the Submit Version Specifications Only option and override the location, if required.
Version Prompting	W98305D or W98305WD	Click OK on the Advanced Version Prompting form.	Submit batch versions specifications to an enterprise server.