Beruflich Dokumente
Kultur Dokumente
Disclaimer 1
Executive Overview 2
Introduction 2
Integration Methods 4
Business Events 5
Spreadsheet Integration 5
Reporting Tools 5
Integration Examples 11
Conclusion 21
Additional Resources 22
This paper is designed to guide you through adoption choices for manufacturing execution in the cloud, with
considerations of how to integrate with your existing shop floor execution systems with Oracle Cloud. With the right
integration approach, you can successfully deploy Oracle Manufacturing Cloud and achieve the benefits of modern
business processes.
Introduction
As part of your Oracle Cloud implementation for manufacturing execution, you must evaluate how these solutions will work
with your existing internal systems and the different integration options available to you. The approach you take will
depend on your business requirements, processes, capabilities of your existing systems, and configurations. Oracle Cloud
provides flexible options for inbound and outbound integration which you can leverage during your implementation.
The first part of this paper discusses how you can leverage the outbound integration capabilities to export different types
of manufacturing master data, work orders, and inventory information to your internal systems.
The second part of the paper discusses how you can leverage the inbound integration capabilities to import scheduled
work orders, operation, resource, and material transactions to the Oracle Manufacturing Cloud from your internal systems.
The rest of this paper provides considerations for each type of internal system, describes the available integration
technologies, and provides references to additional sources of information. With a successful coexistence strategy, you
can gain the advantages from the Oracle Manufacturing Cloud and start realizing business benefits as quickly as possible.
In this paper we will discuss the following integration scenarios involving Oracle Manufacturing Cloud:
» Integration with Production Scheduling Systems
» Integration with Manufacturing Execution Systems
» Integration with Third Party Mobile Applications
Some complexities are unavoidable when implementing systematic integration. For example, apart from the process
integration, you must also consider error handling, error recovery, and adaptability to changing or extended data models.
The right strategy can mitigate unnecessary investments in building integration and simplify your overall strategy.
Oracle Help Center is an online resource for discovering Oracle Cloud Applications metadata. You can use Oracle Help
Center to find information on the integration assets that are available for specific objects and processes across Cloud,
including those related to Oracle Supply Chain Management Cloud. This website will always contain the most recent
information on what is available. As time passes, you should consult Oracle Help Center for the most currently available
assets (and any new updates) prior to beginning an integration project. Oracle expects that new assets will become
available over time.
Examples of the types of assets that you can discover within Oracle Help Center include:
» Web services (SOAP and REST services)
Integration Methods
Oracle Cloud applications are built with Oracle’s Application Development Framework (ADF) and provide many methods of
integration with other applications, such as, ADF Services (commonly referred to as Web Services), File-Based Data Import
(FBDI), and Reporting Tools.
The following diagram illustrates various options of the Oracle Cloud to extend applications and interface with them:
Figure 2. Extensibility and Integration Options for Oracle SCM Cloud Applications
These options are available at different levels in the technology stack. Applications Extensibility Framework offers Page
Composer, Apps Composer and Flex Framework that help to build basic User Interface (UI) extensions to UI and data
model. You can use configurability in cloud applications to define the detailed behavior of the applications through options,
rules, and workflows. You can extend or integrate the application functionality using the REST and SOAP services. In case
of high volume use cases, you can use FBDI. Finally, some of the cloud applications offer pre-built B2B messages using
OAGIS standards.
REST (Representational State Transfer) describes a set of architectural principles by which data can be transmitted over a
standardized interface, such as HTTP. REST does not contain an additional messaging layer and focuses on design rules
for creating stateless services. A client can access the resource using the unique URI and a representation of the resource
is returned. With each new resource representation, the client is said to transfer state. While accessing REST resources
with HTTP protocol, the URL of the resource serves as the resource identifier and GET, PUT, DELETE, POST and HEAD
are the standard HTTP operations to be performed on that resource.
Business Events
The Oracle Workflow Business Event System is an application service that leverages Oracle Advanced Queuing (AQ)
infrastructure to communicate business events between systems. The Business Event System consists of the Event
Manager and workflow process event activities.
The Event Manager contains a registry of business events, systems, named communication agents within those systems,
and subscriptions indicating that an event is significant to a particular system. Events can be raised locally or received from
an external system or the local system through AQ.
Spreadsheet Integration
Spreadsheet integration through ADFdi enables the use of familiar spreadsheet tools such as Excel. ADF Desktop
Integration (ADFdi) is part of the ADF framework and enables desktop integration with MS Excel spreadsheets to manage
large volume data uploads to Cloud Applications. The integration provided with ADFdi includes interactivity that enables web
picker to search for valid values, perform validation during data entry, display error messages, and immediately submit
transactions directly from Microsoft Excel.
File-Based Data Import (FBDI) is another option for getting information into Cloud applications. For applications deployed in
the public cloud, in the absence of a delivered web service, the currently available option is file-based integration to transfer
files to a location that the source system can consume. The process of using FBDI is quite simple. Download an excel
template that identifies all of the fields, populate the spreadsheet with data from the external system, save the file as a .csv
file type, upload the file, and run processes to transfer the data to the interface tables and import to various applications. All
of the data is validated during import to insure its integrity. External data can be extracted and formatted into a source file for
transfer and import to Oracle Cloud applications.
Reporting Tools
Reporting tools can be used to extract data from Cloud applications for further analysis and import data to external
OTBI is a dynamic reporting layer built against the Oracle Fusion transactional tables. OTBI is designed to enable you to
build custom reports and perform dynamic analysis. OTBI reports in the Manufacturing Cloud offers predefined subject
areas that you can use to extract data for import to your external systems. OTBI provides the ability to build custom queries
on transactional data. The output of this data can be downloaded to Excel. You can configure an Oracle Business
Transaction Intelligence (OTBI) report.
BI Publisher (Business Intelligence Publisher) allows you to customize an existing out of the box data model or report, and
to create your own custom BIP data models and reports. You can also build your own data model using the development
tools and extract the data from the cloud applications and import the data to your system. So, if you want to reuse the data
models in the application, we recommend you to use OTBI. If you want to build your own data model or customize the pre-
built model, we recommend you to use BIP.
You can choose the following to export data from Manufacturing Cloud:
» Oracle Business Intelligence Cloud Service
» BIP Enterprise
» REST APIs
TABLE 1. DATA BASE TABLES FOR EXPORTING MASTER DATA FROM THE MANUFACTURING CLOUD
Inventory Transaction Types INV_TRANSACTION_TYPES This table has definition of the inventory transaction
types.
Work Areas WIS_WORK_AREAS_B This table has definition of the work areas.
Work Centers WIS_WORK_CENTERS_B This table has definition of the work centers.
Resource assignment to Work WIS_WC_RESOURCES This table has details of assignment of resources to work center.
Center
Shifts of a Resource assigned WIS_WC_RESOURCE_SHIFTS This table has details of shifts of the resources assigned to a work
to a Work Center center.
Work Definition Header WIS_WORK_DEFINITIONS This table has the work definition header details.
Work Definition Versions WIS_WD_VERSIONS_V This view has the work definition version details.
Work Definition Operations WIS_WD_OPERATIONS_V This view has the work definition operation details.
Work Definition Operation WIS_WD_OPERATION_MATERIALS_V This view has the work definition operation material details.
Materials
Work Definition Operation WIS_WD_OPERATION_RESOURCES_V This view has the details of work definition operation
Resources resources.
Current Shifts WIE_CURRENT_SHIFTS_V This view has the details of the shifts.
For process integration, you must synchronize transaction documents between Oracle Manufacturing Cloud and your internal
systems. You must decide the master system that owns the document and evaluate the options to export the transaction
data to the target system. If Oracle Manufacturing Cloud is the master system, you must export data using Oracle BIP. Table
2 helps you export the transaction documents.
TABLE 2. DATA BASE TABLES FOR EXPORTING PRODUCTION TRANSACTIONS FROM THE MANUFACTURING CLOUD
Work Order Operations WIE_WO_OPERATIONS_V This view contains the details of the work order operations.
Work Order Operation WIE_WO_OPERATION_MATERIALS_V This view contains the details of the work order operation
Materials materials.
Work Order Operation WIE_WO_OPERATION_RESOURCES_V This view contains the details of the work order operation
Resources resources.
Work Order Serials INV_SERIAL_NUMBERS This table contains the details of the work order serials.
Dispatch List WIE_WO_DISPATCH_LISTS_V This view contains the details of the dispatch list.
TABLE 3. REST APIS FOR EXPORTING MASTER DATA, WORK ORDER AND DISPATCH LIST FROM THE MANUFACTURING CLOUD
Work Area /fscmRestApi/resources/<version>/workAreas Using GET of this REST API, you can export work
areas.
Work Center /fscmRestApi/resources/<version>/workCenters Using GET of this REST API, you can export work
centers.
Work Order Statuses /fscmRestApi/resources/<version>/workOrderStatuses Using GET of this REST API, you can export work
order statuses.
Production /fscmRestApi/resources/<version>/productionResources Using GET of this REST API, you can export
Resources production resources.
Work Definitions /fscmRestApi/resources/<version>/workDefinitions Using GET of this REST API, you can export work
definitions.
Standard Operations /fscmRestApi/resources/<version>/standardOperations Using GET of this REST API, you can export
standard operations.
Work Orders /fscmRestApi/resources/<version>/workOrders Using GET of this REST API, you can export work
orders.
Work Orders Metrics /fscmRestApi/resources/<version>/workOrdersMetrics Using GET of this REST API, you can export
metrics related to work orders.
Work Order Operations for /fscmRestApi/resources/<version>/dispatchListWorkOrde Using GET of this REST API, you can export work order
Dispatch Lists rOperations operations dispatch list.
Operation Starts and Stops /fscmRestApi/resources/<version>/operationStartStops Using GET of this REST API, you can export start and
stop times of a work order operation.
» Develop an adapter in Oracle Integration Cloud Services (ICS) that can populate the interface tables
» Use File-Based Data Import
» Use SOAP web services
» Use REST APIs
You can use Oracle Integration Cloud Services (ICS) to import data from your internal system to the Manufacturing Cloud.
Oracle ICS provides infrastructure to develop an adapter that can automate the inbound integration process. This adapter in
ICS will insert records to appropriate Manufacturing Cloud tables. Table 4 summarizes the interface tables in the
Manufacturing Cloud.
Work Order Header WIE_WORK_ORDERS_INT This is the interface table for the work order header. It would contain details about the
work definition on which the work order is created, the work order type the assembly
quantities etc.
Work Order Details WIE_WORK_ORDER_DETAILS_INT This is the child interface table that carries the operations, operation resource and
operation material of the work order.
Material Transaction WIE_MATERIAL_TRANSACTIONS_INT This table will be the interface from Manufacturing for all the material transactions
Resource Transaction WIE_RESOURCE_TRANSACTIONS_INT This is the interface table for the charging of resources to record the actual usage of
the labor, equipment and tooling type of resources.
Operation Transaction WIE_OPERATION_TRANSACTIONS_INT This is the interface table for the work order operation level transactions.
Transaction Lots WIE_TRANSACTION_LOTS_INT This table stores the lot number information that is being interfaced to manufacturing. A
record in this table is either the child of the material transactions interface or the
operation transactions interface.
Transaction Serials WIE_TRANSACTION_SERIALS_INT This table stores the serial number information for the transaction interfaced as part of
a transactional interface to manufacturing.
The Manufacturing Cloud also provides xlsm templates for work orders, operation, material and resource transactions to
import data. You can find these templates at:
http://docs.oracle.com/cloud/<version>/scmcs_gs/OEFSC/FBDIOverview.htm#FBDIOverview
Entity Location
You can use SOAP web service to create material and operation transactions using REST APIs. However, Oracle
recommends REST APIs over SOAP web services. Table 6 summarizes the REST APIs:
Operation Transaction /wieMaterialTransactions/WorkOrderOperationTransaction You can use this SOAP web service to create an operation transaction
Service?WSDL
Material Transaction /wieMaterialTransactions/WorkOrderMaterialTransactionS You can use this SOAP web service to create a material transaction
ervice?WSDL
You can use REST APIs to create work order, material, resource and operation transactions using REST APIs. Table 7
summarizes the REST APIs:
Work Orders /fscmRestApi/resources/<version>/workOrders You can use this REST API to create and update work orders.
Operation Transaction /fscmRestApi/resources/<version>/operationTransactions You can use this REST API to create an operation transaction
Material Transaction /fscmRestApi/resources/<version>/materialTransactions You can use this REST API to create a material transaction
Operation Starts and /fscmRestApi/resources/<version>/operationStartStops You can use this REST API to create and update operation start and stop
Stops times of an operation
Integration Examples
Let us discuss three scenarios of integrating Oracle Manufacturing Cloud with external systems. The first scenario will
explain integration of Manufacturing Cloud with an external work order scheduling system using BI Publisher and FBDI. The
second scenario will explain integration of Manufacturing Cloud with an external MES using BI Publisher and FBDI. The third
scenario will detail the integration of an app running on a mobile device with Manufacturing Cloud.
Production scheduling systems typically employ constraint-based scheduling algorithms to schedule the work orders. These
algorithms attempt to find a feasible schedule by optimizing a performance metric (often called as an objective function) given
a set of manufacturing activities that have precedence constraints, and those that require a set of resources having finite
capacity.
For example, the feasible solution may result in splitting of a work order into two or more work orders where each work order
is worked on different start and end dates. Each work order may use different work definitions.
In this approach, the Oracle Planning Central System creates the work order and the work orders are exported to external
Production Scheduling Systems for scheduling. Oracle Planning Central system sends the work order header data containing
the work definition. Oracle Manufacturing Cloud then explodes the work definition to create detailed operations, operation
items, and schedules the work order.
Oracle Manufacturing takes availability of resources of a work center into consideration while scheduling the work orders.
However, Oracle Manufacturing Cloud assumes that the resources have infinite capacity, and schedules the work orders
without considering the load profile of the resources. If you need constraint-based scheduling, you must integrate Oracle
Manufacturing Cloud with your Production Scheduling System. From the Production Scheduling System, you will import
scheduled work orders to Oracle Manufacturing Cloud.
The following master data objects in the Manufacturing Cloud may need to be exported to the Production Scheduling
System:
» Item
» Production Calendar
» Shifts
» Resource
» Work Centers
» Assignment of Resources to Work Center
» Work Definition
The following transaction objects in the Manufacturing Cloud may need to be exported to the Production Scheduling System:
» Work Orders
» Inventory On Hand
Figure 3. Integration between Oracle Manufacturing Cloud and External Scheduling System
You must export the master data whenever there is an update in the Manufacturing Cloud. Depending upon your
Production Scheduling Systems, you can decide to do a full extract of the master data or only an extract of the updates.
You may also have to refresh periodically the Production Calendars and availability of the resources for each work center.
Work Orders except those, which are in Completed, and Closed status must be exported to your Production Scheduling
System. Apart from the Work Orders, you may also have to export ‘Inventory-on-Hand’ and ‘Projected Inventory’ to know
the availability of the components.
To prevent rescheduling of the work order in the Manufacturing Cloud, you must set the scheduling method as
‘No_Scheduling’. Oracle Manufacturing does not re-schedule the work orders if the scheduling method is ‘No_Scheduling’
and the operation start and end dates in the interface tables are not changed.
The following master data objects in the Manufacturing Cloud may need to be exported to MES:
» Item
» Production Calendar
» Shifts
» Resource
» Work Centers
» Assignment of Resources to Work Center
» Work Center Resource Calendar
» Work Definition
The following transaction objects in the Manufacturing Cloud may need to be exported to MES:
» Work Orders
» Inventory On Hand
» Projected Inventory
Figure 4. Integration between Oracle Manufacturing Cloud to 3rd party Manufacturing Execution System
You must use Oracle BI Publisher to export the master and transactional data from Oracle Manufacturing Cloud. You can
create a data model by creating a data set for each of the entities you want to export. From the saved data model, you can
ENTITY LOCATION
Similarly, you can find the details of SOAP based web services here:
ENTITY LOCATION
You can use a third party mobile application to issue components to a work order operation. You can use a REST API to get
details of a work order by scanning a serial of an assembly and post a material transaction for the components that are
issued to a particular work order operation.
For example, assume you create a solution that allows your customers to use a mobile client to connect to your partner
application. Assume this application allows your customer, a discrete manufacturer, to scan a serial of an assembly and get
the list of components required to manufacture the assembly. The issue of components is recorded in the application and
then posted as material transaction in Manufacturing Cloud.
The following diagram illustrates the request and response between the client application and Oracle Manufacturing Cloud:
Explanation of Callouts
1. You use the following command to send a REST API request from the client to the server. This command gets work order
details for an assembly serial PRE5712:
curl -u username:password
"server:port/fscmRestApi/resources/<version>/dispatchListWorkOrderOperations?finder=findBySerialNumber;SerialNumber=PRE5
712,OrganizationCode=M1,DispatchState=READY"
Data Value
API fscmRestApi
Resource dispatchListWorkOrderOperations
Finder findBySerialNumber
Finder Bind Variable SerialNumber, OrganizationCode, DispatchState
Method GET
Attribute Description
ItemNumber Uniquely identifies the Assembly Number. For example, MI-1234
ItemDescription Text description of the Assembly. For example, 5.5in mobile
WorkOrderNumber Number that identifies the work order. For example, M1-1208.
OperationSequenceNumber Number that identifies the work order operation. For example, 20.
WorkCenterCode Code that uniquely identifies the work center. For example, YLX_WC_02
DispatchState Dispatch state of the assembly. For example, READY.
{
"items" : [ {
"OrganizationId" : 207,
"OrganizationCode" : "M1",
"OrganizationName" : "Seattle Manufacturing",
"WorkAreaId" : 300100091177813,
"WorkAreaCode" : "YLX_WA_02",
"WorkAreaName" : "YLX_WA_02",
"WorkCenterId" : 300100091177814,
"WorkCenterCode" : "YLX_WC_02",
"WorkCenterName" : "YLX_WC_02",
"WorkCenterDescription" : "YLX_WC_02",
"WorkOrderId" : 300100093180128,
"WorkOrderNumber" : "M1-1208",
"WorkOrderDescription" : “WO for prototype”,
"InventoryItemId" : 300100039626650,
"ItemNumber" : "MI-1234",
"ItemDescription" : "5.5in mobile",
"OperationId" : 300100093180130,
"OperationSequenceNumber" : 20,
"OperationName" : "OP20",
"OperationDescription" : “Assemble”,
"DispatchState" : "READY",
"Quantity" : 10,
"UnitOfMeasure" : "Each",
"PlannedStartDate" : "2016-10-27T04:38:00-07:00",
"PlannedCompletionDate" : "2016-10-27T04:38:00-07:00",
"WorkOrderPriority" : null,
"PurchaseOrderId" : null,
"PurchaseOrder" : null,
"PurchaseOrderLineId" : null,
"PurchaseOrderLine" : null,
"CustomerId" : null,
"CustomerName" : null,
}]
}
Explanation of Callouts
1. The client application will construct a URL for a REST request to manufacturing Cloud using the below attributes in the
previous response payload to get the details of the components:
Attribute Description
WorkOrderId Unique key that is generated when a work order is created. For example,
300100093180128
WorkOrderOperationId Unique key that is generated when a work order operation is created. For
example, 300100093180130
You use the following command to send a REST API request from the client to the server. This command gets component
details for a work order M1-1208:
curl -u username:password
"server:port/fscmRestApi/resources/<version>/
workOrders/300100093180128/child/WorkOrderMaterial?q=WorkOrderOperationId=300100093180130 "
Data Value
API fscmRestApi
Resource workOrders, WorkOrderMaterial
Q parameter WorkOrderOperationId
Attribute Description
ItemNumber Uniquely identifies the component Number. For example, CO-1234
ItemDescription Text description of the Assembly. For example, Touch Screen
SupplyTypeDescription Description of the Supply Type of the component. For example,
Push
SupplySubinventory Subinventory to use for issuing the component. For example,
Stores.
SupplyLocatorId Uniquely identifies the locator to use for issue of the component.
For example, 01-01-01
QuantityPERProduct Required component quantity per serial of the Assembly
UnitOfMeasure Unit of Measure of the component
The following diagram illustrates the flow that posts material transaction:
Explanation of Callouts
1. The client application will capture the component quantity issued to the serial.
2. You use the following command to send a REST API request from the client to the server. This command posts one
material transaction in plant M1, for work order M1-1208, Operation Sequence 20 and component CO-1234:
Conclusion
This paper provides recommendations based on technologies available at the time of publication. Please consult
https://docs.oracle.com/en/ for the latest available web services, import and export processes, and other integration assets.
External Data Integration Services for Reference Describes how to load data from external sources into Oracle Fusion Applications. My
Oracle Cloud Oracle Support: Doc ID 1474204.1
Oracle Help Center Web Site Use the Oracle Help Center for technical information about integrating with other applications,
including services, operations, composites, events, and integration tables.
This includes diagrams, schematics, and links to other technical documentation.
https://docs.oracle.com/en/
Tables and Views of Oracle Supply Chain Web Site Use the Oracle Help Center for technical information about data base details of Oracle
Management Cloud Manufacturing Cloud. This includes diagrams, schematics, and links to other technical
documentation.
https://docs.oracle.com/cloud/farel9/scmcs_gs/OEDSC/toc.htm
File-Based Data Import for Oracle Supply Web Site Use the Oracle Help Center for technical information about file-based data import for Oracle
Chain Management Cloud Supply Chain Management Cloud.
https://docs.oracle.com/en/cloud/saas/supply-chain-management/r13-
update18a/oefsc/toc.htm
SOAP Web Services for Oracle Supply Web Site Use the Oracle Help Center for technical information about SOAP web services for Oracle
Chain Management Cloud Supply Chain Management Cloud.
https://docs.oracle.com/cloud/<version>/scmcs_gs/OESSC/toc.htm
REST Web Services for Oracle Supply Web Site Use the Oracle Help Center for technical information about REST web services for Oracle
Chain Management Cloud Supply Chain Management Cloud.
https://docs.oracle.com/cloud/<version>/scmcs_gs/FASRP/Overview_of_REST_API.html
Oracle Integration Cloud Service Web Site Contains all the documents related to Oracle Integration Cloud Service (ICS).
https://docs.oracle.com/cloud/<version>/intcs_gs/
Oracle Business Intelligence Publisher Web Site Contains all the documents related to Oracle BI Publisher (BIP).
http://docs.oracle.com/middleware/12212/bip/index.html
CONNECT W ITH US
blogs.oracle.com/oracle
Copyright © 2018, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only, and the
contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other
facebook.com/oracle warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or
fitness for a particular purpose. We specifically disclaim any liability with respect to this document, and no contractual obligations are
formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by any means,
twitter.com/oracle electronic or mechanical, for any purpose, without our prior written permission.
oracle.com Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and
are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are
trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. 0718