Open Interfaces to import production batches from external
systems
Oracle Process Manufacturing provides Open Interfaces to import production
batches from external systems, update production batches, and perform lifecycle
transitions and resource and material transactions on existing batches using
staging tables also called as Interface Tables. These interface tables are:





GME_BATCH_HEADER_INTERFACE
GME_BATCH_DTLS_INTERFACE
GME_BATCH_ACTIONS_INTERFACE
GME_RESOURCE_TXNS_INTERFACE
GME_INTF_ERRORS
Note: For a detailed description of these tables, navigate to Integrated SOA
Gateway > Integration Repository > Process Manufacturing > OPM Process
Execution.
Inserting Records Into the Batch Open Interfaces
In order to insert records (rows) from your source system into the Interface
Tables, you must write a PL/SQL program, a SQL script, or use a third party
program. You must model your data to be supported by the current OPM
Executions application.
For more information about migrating data from legacy systems, refer to Oracle
Process Manufacturing (OPM) Migration from 11i to Release 12.1 and Higher.
Once the data are populated in the interface tables, you can launch the following
concurrent programs to import the corresponding data:



Batch Import Open Interface: Imports the data from
GME_BATCH_HEADER_INTERFACE /
GME_BATCH_DTLS_INTERFACE tables to create or update
batch/batch detail objects
Batch Actions Import Manager: Imports batch/step lifecycle actions from
GME_BATCH_ACTIONS_INTERFACE table.
Resource Transactions Manager: Imports resource transactions from
GME_RESOURCE_TXNS_INTERFACE table.
Users are required to load the data into these staging interface tables with a
Pending status before launching different open interface concurrent programs to
import the batches and related information:
1. The data loaded to interface tables is in a Pending status.
2. The concurrent programs process the pending data.
3. The processed data is imported to the production tables after validation.
o All successfully imported rows are updated to a Successful status
or Successful with Warnings status.
o Rows either failing validation or import are marked with an Error
status.
Users can query, view, update and re-process the interface rows using the
following forms:
1.
2.
3.
4.
Batch Header Interface
Batch Details Interface
Batch Actions Interface
Resource Transactions Interface
Viewing Batch Header Interface Information
Use the Batch Header Interface window to view and manage errors that
occurred while importing a batch. This window displays the data from the
GME_BATCH_HEADER_INTERFACE table and related error messages from
the GME_INTF_ERRORS table. Launch the Batch Import Open Interface
concurrent program to either import production batches from an external system
or update existing production batches in bulk. You can perform the following
actions using the Batch Header Interface window:
Details of all E-Business Suite interfaces reside in the Integration Repository,
which can be accessed from the E-Business Suite Navigator using the following
navigation path:
Integrated SOA Gateway > Integration Repository > Process Manufacturing >
OPM Process Execution.




Create a batch from a recipe.
Update a batch.
Reroute a batch.
Reschedule a batch.
To view batch header information:
1. Navigate to the Find Batch Header Interface Rows window.
2. Enter any of the following criteria to search batch information:
Field Name
Description
Organization Enter the organization code of the batch that you want to
import.
Batch No
Enter the batch number range of an existing batch that
you want to import or update in the respective fields.
Creation
Date
Enter the creation date range for the batch that you want
to import in the respective fields.
Creator
Name of the user who created the batch.
Load Type
Select the type of action that you want to perform on a
specific row during the import process:
o
o
o
o
o
Create Batch From Recipe
Create Batch and Release
Update Batch
Reschedule Batch
Reroute Batch
Group ID
Enter the group identifier used to group rows for
processing.
Request ID
Do not update this column value. The Import process
populates the identifier of the concurrent request that
processes this row.
Process
Status
Select the appropriate check box:
o
o
o
Pending: Batches which are pending import.
Error: Batches that encountered errors while
processing. This check box is selected by default.
Successful with Warnings: Batches that were
imported successfully with warning.
3. Click Find.
The details of the batch appear.
Updating Batch Header Information
Use the Batch Header Interface Rows page to view and modify header
information for the batch. When a concurrent request completes with an error,
the interface table GME_INTF_ERRORS is used to record the errors. You can
view the details of the errors on the Batch Header Interface Rows page. You can
then correct the errors, change the process status to Pending, and launch the
concurrent program (Actions > Resubmint) to resubmit the batch for reprocessing.
To update batch header information:
1. Navigate to the Find Batch Header Interface Rows window.
2. Query the batch. Refer to the Viewing Batch Header Interface
Information section for more details.
Main
This tab displays batch information such as Batch Number, Organization,
Process Status, Creation mode of the batch, and so on.
Detail
This tab displays details of the batch such as Group ID, Load Type, Org ID,
Batch ID, planned completion date, Actual Start and Completion Date, and so
on.
Attributes
This tab displays the additional information entered by the user about the batch
using descriptive flexfields (Attribute 1 to Attribute 40) and Attribute Category.
For details regarding various columns in these tabs and the values that a user
can modify, navigate to Integrated SOA Gateway > Integration Repository >
Process Manufacturing > OPM Process Execution.
The Batch Header Interface Rows page also displays the details of the errors
that occurred during batch interface processing. You can view the following
details:
Field Name
Description
Column Name Column name of the interface table where the error occurred.
Message Text Text describing the error.
Message Type Severity of the error. Values are Warning and Error.
Creation Date Date when the error occurred.
Actions Menu
You can perform the following actions from the Actions menu on the Batch
Header Interface Rows page:
Action
Description
Select All
Select all the records in the results table.
Clear All
Deselect all the selected records.
Resubmit
Re-process the pending rows of the groups in the results table.
For each group that has at least one pending row in the result
table, a separate batch import request will be launched.
Delete Rows Delete selected records in the results table. The dependent batch
selected
detail rows will be deleted from the batch detail interface table
after confirmation.
Bulk Status
Change
Change the selected rows to Pending Status.
Note: For rows with the Successful with Warnings status, the
status is not changed.
Viewing Batch Details Interface Information
Use the Batch Details Interface window to view and update various details of a
batch. This window displays the data from the
GME_BATCH_DTLS_INTERFACE table and related error messages from the
GME_INTF_ERRORS table. The GME_BATCH_DTLS_INTERFACE table is
used to import and update additional material, steps, activities, resource
transactions, step material details, and process parameters for a batch. You can
launch the Batch Import Open Interface concurrent program to either import
production batches from an external system or update existing production
batches in bulk.
Several combinations can be set to view Object and Load Types. The Object
Type is used to identify the type of object that must be updated for a batch, and
the Load Type identifies the operation that must be performed. For example,
selecting Material for the Object Type, and Create from Recipe for the Load
Type forms an instruction to add material to an existing batch.
Details of all E-Business Suite interfaces reside in the Integration Repository,
which can be accessed from the E-Business Suite Navigator using the following
navigation path:
Integrated SOA Gateway > Integration Repository > Process Manufacturing >
OPM Process Execution.
Use the Batch Details Interface window to perform the following actions:






Material Actions
o Insert, update or delete material.
Step Actions
o Insert, update, delete, or reschedule a step.
Activity Actions
o Insert, update or delete an activity.
Resource Actions
o Insert, update or delete a resource.
Process Parameter Actions
o Insert, update or delete a process parameter.
Step Item Association Actions
o Insert, update or delete a step item association.
To view batch detail information:
1. Navigate to the Find Batch Details Interface Rows window.
2. Enter any of the following criteria to search batch information:
Field Name
Description
Organization Enter the organization code that owns the batch that you
want to import.
Object Type Select the type of object that you want to add to a batch:
o
o
o
o
o
o
Load Type
Material
Step
Activity
Resource
Step Item Association
Process Parameter
Select the type of action that you want to perform on a
specific row during the import process:
o
o
o
o
Create
Update
Reschedule
Reroute
Batch No
Enter batch number range for an existing batch that you
want to update in the respective fields.
Creation
Date
Enter or select the date range that you want to view.
Creator
Name of the user who created the batch.
Group ID
Enter the group identifier used to group rows for
processing.
Request ID
Do not enter any value in this field. The Import process
populates the identifier of the concurrent request that
processes this row.
Process
Status
Select the appropriate check box:
o
o
Pending: Batches which are pending import.
Error: Batches that encountered errors while
processing.
Note: This check box is selected by default.
3. Click Find.
The details of the batch appear.
Updating Batch Details Information
Use the Batch Details Interface Rows page to view and modify details for the
batch. When a concurrent request completes with an error, the
GME_INTF_ERRORS interface table is used to record the errors. You can view
the details of the errors on the Batch Details Interface Rows page. You can then
correct the errors, update batch details, change the Process State to Pending,
save the records, and launch the concurrent program (Actions > Resubmit) to
resubmit the batch for re-processing.
To update batch details:
1. Navigate to the Find Batch Details Interface Rows window.
2. Query the batch. Refer to the Viewing Batch Details Interface
Information section for more details.
Material
This tab displays batch material information such as Batch Number,
Organization, Item, Actual Quantity, and so on.
Step
This tab displays batch step information such as Step Number, Step ID, Actual
Start and Complete Date, and so on.
Activity
This tab displays batch activity information such as Activity, Batchstep
Activity, Actual Start and Complete Date, and so on.
Resource
This tab displays batch resource information such as Batch Number,
Organization, Resource, Batchstep Resource, Actual Start and Complete Date,
and so on.
Parameter
This tab displays batch parameter information related to various parameters
such as Parameter ID, Process Parameter ID, Actual and Target Value, and so
on.
Attributes
This tab displays the additional batch information entered by the user using the
descriptive flexfields (Attribute 1 to Attribute 30) and Attribute Category.
For details regarding various columns in these tabs and the values that a user
can modify, navigate to Integrated SOA Gateway > Integration Repository >
Process Manufacturing > OPM Process Execution.
The Batch Details Interface Rows page also displays the details of the errors
that occurred during batch interface processing. You can view the following
details:
Field Name
Description
Column Name Column name of the interface table where the error occurred.
Message Text Text describing the error.
Message Type Severity of the error. The values are Warning and Error.
Creation Date Date when the error occurred.
Actions Menu
A user can perform the following actions from the Actions menu on the Batch
Details Interface Rows page:
Action
Description
Select All
Select all the records that appear in the results table.
Clear All
Deselect all the records selected in the results table.
Resubmit
Re-process the pending rows of the groups that appear in the
results table. For each group that has at least one pending row in
the result form, a separate batch import request will be
launched.
Delete Rows Delete multiple records in the results table. The dependent batch
selected
detail rows will be deleted from the batch detail interface table
after confirmation.
Bulk Status
Change
Change selected rows to Pending Status.
Note: For rows with the Successful with Warnings status, the
status is not changed.
Viewing Batch Action Interface Information
Use the Batch Action Interface window to import and process batch actions.
This window displays the data from the
GME_BATCH_ACTIONS_INTERFACE table and related error messages from
the GME_INTF_ERRORS table. The Batches Actions Import Manager
concurrent program enables you to process multiple batch actions for batches in
bulk. The program permits the division of processing work into multiple work
orders and executes these work orders in parallel. The Batch Release actions are
processed first, followed by Complete actions and Close action. The ordering is
based on the Object Type and Action combination. Step dependencies are
considered while executing the step-level actions.
Details of all E-Business Suite interfaces reside in the Integration Repository,
which can be accessed from the E-Business Suite Navigator using the following
navigation path:
Integrated SOA Gateway > Integration Repository > Process Manufacturing >
OPM Process Execution.
The Batch Actions Interface window enables you to perform the following
actions:

Batch
o
o
o
Release a batch.
Complete a batch.
Close a batch.
o
o
o
o
o

Cancel a batch.
Terminate a batch.
Reopen a batch.
Revert a batch to WIP.
Unrelease a batch.
Step
o
o
o
o
o
o
Release a step.
Complete a step.
Close a step.
Unrelease a step.
Revert a step.
Reopen a step.
To view batch action information:
1. Navigate to the Find Batch Actions window.
2. Enter any of the following criteria to search batch information:
Field Name
Description
Organization Enter the organization code that owns the batch.
Object Type
Select the type of object for the batch. Values are Batch
and Step.
Batch No
Enter the batch number range of an existing batch in the
respective fields.
Batch Step
No
Enter the batch step number range for an existing batch
in the respective fields.
Note: This field is enabled if the value for Object Type is
selected as Step.
Creation
Date
Enter or select the creation date range for the batch.
Creator
Name of the user who created the batch.
Action
Select the type of batch action or batch step action that
you want to perform:
o
o
o
o
o
Release
Complete
Close
Re Open
Revert to WIP
o
o
o
Process
Status
Un Release
Terminate Batch
Cancel Batch
Select the appropriate check box:
o
o
o
Pending: Batches which are pending import.
Error: Batches or steps that encountered errors
while processing. This check box is selected by
default.
Batches that were imported successfully with
warnings.
3. Click Find.
The details of the batch appear.
Updating Batch Action Information
Use the Batch Actions page to view and modify actions for the batch. When a
concurrent request completes with an error, the GME_INTF_ERRORS interface
table is used to record the errors. You can view the details of the errors on the
Batch Actions page. You can then correct the errors, change the Process State to
Pending, and launch the concurrent program (Actions > Resubmit) to resubmit
the batch for re-processing.
To update batch action details:
1. Navigate to the Find Batch Action Interface window.
2. Query the batch. Refer to the Viewing Batch Action Interface
Information section for more details.
Batch Actions
This page displays batch information such as Batch Number, Organization,
Action, Object Type, Process, and various actions that you can perform on the
batch, and so on.
For details regarding the various columns in these tabs and the values that a user
can modify, navigate to Integrated SOA Gateway > Integration Repository >
Process Manufacturing > OPM Process Execution.
The Batch Actions page also displays the details of the errors that occurred
during batch interface processing. You can view the following details:
Field Name
Description
Column Name Column name of the interface table where the error occurred.
Message Text Text describing the error.
Message Type Severity of the error. Values are Warning and Error.
Creation Date Date when the error occurred.
Actions Menu
You can perform the following actions from the Actions menu on the Batch
Actions page:
Action
Description
Select All
Select all the records that appear in the results table.
Clear All
Deselect all the selected records.
Resubmit
Re-process the pending rows of the groups that appear in the
results table. For each group that has at least one pending row in
the results table, a separate batch import request will be
launched.
Delete Rows Delete selected records in the results table. The dependent batch
selected
detail rows will be deleted from the batch detail interface table
after confirmation.
Bulk Status
Change
Change selected rows to Pending Status.
Note: For rows with the Successful with Warnings status, the
status is not changed.
Viewing Batch Resource Transaction Interface Information
The Batch Resource Transaction Interface window enables you to perform bulk
resource transactions and post resource usage data on batches that have been
created in the Oracle Process Manufacturing application. This window displays
the data from the GME_RESOURCE_TXNS_INTERFACE table and related
error messages from the GME_INTF_ERRORS table. After populating the data
in the GME_RESOURCE_TXNS_INTERFACE table, you can launch the
concurrent program, Resource Transactions Manager, to process the resource
transactions. You must populate the data to identify the batch, resources used,
and the resource usage information to successfully import the resource
transactions.
Details of all E-Business Suite interfaces reside in the Integration Repository,
which can be accessed from the E-Business Suite Navigator using the following
navigation path:
Integrated SOA Gateway > Integration Repository > Process Manufacturing >
OPM Process Execution.
To view resource transaction information:
1. Navigate to the Find Resource Transactions window.
2. Enter any of the following criteria to search batch information.
Field Name
Description
Organization Enter the organization code that owns the batch.
Batch No
Enter the batch number range of an existing batch in the
respective fields.
Batch Step
No
Enter the batch step number range for an existing batch
in the respective fields.
Creation Date Enter the creation date for the batch.
Creator
Name of the user who created the batch.
Activity
Enter the batch activity associated with the resource.
Resources
Enter the resource used for this transaction.
Process
Status
Select the appropriate check box:
o
o
Pending: Batches which are pending import.
Error: Batches that encountered errors while
processing.
Note: This check box is selected by default.
3. Click Find.
The details of the batch appear.
Updating Batch Resource Transaction Information
The Batch Resource Transactions page enables you to view and modify
resource transactions for the batch. When a concurrent request completes with
an error, the GME_INTF_ERRORS interface table is used to record the errors.
You can view the details of these errors on the Batch Resource Transactions
page. You can then correct the errors, change the Process State to Pending, and
launch the concurrent program (Actions > Resubmit) to resubmit the batch for
re-processing.
To update batch details:
1. Navigate to the Find Resource Transactions window.
2. Query the batch. Refer to the Viewing Batch Resource Transaction
Interface Information section for more details.
Main
This page displays batch information such as Batch Number, Organization,
Resource Instance Number, Instance ID, Resource Usage, and so on.
Attributes
This tab displays the additional batch information entered by the user using the
descriptive flexfields (Attribute 1 to Attribute 30) and Attribute Category.
For details regarding the various columns in these tabs and the values that a user
can modify, navigate to Integrated SOA Gateway > Integration Repository >
Process Manufacturing > OPM Process Execution.
The Batch Resource Transactions page also displays the details of the errors that
occurred during batch interface processing. You can view the following details:
Field Name
Description
Column Name Column name of the interface table where the error occurred.
Message Text Text describing the error.
Message Type Severity of the error. Values are Warning and Error.
Creation Date Date when the error occurred.
Actions Menu
You can perform the following actions from the Actions menu on the Batch
Resource Transactions page:
Action
Description
Select All
Select all the records.
Clear All
Deselect all the records.
Resubmit
Re-process the pending rows of the groups. For each group that
has at least one pending row in the results table, a separate
batch import request will be launched.
Delete Rows Delete selected records in the results table. The dependent
selected
batch detail rows will be deleted from the batch detail interface
table after confirmation.
Bulk Status
Change
Change selected rows to Pending Status.
Note: For rows with the Successful with Warnings status, the
status is not changed.