This chapter contains the following topics:
Section 2.1, "Published Business Service Reference Implementations"
Section 2.2, "Accessing Business Service Reference Implementations"
Section 2.5, "AddressBookStagingESBReference Implementation"
Section 2.6, "MediatorForWeblogicGetCustomerCreditInfo Reference Implementation"
Service provider reference implementations include published business service reference implementations, which are examples of JD Edwards EnterpriseOne web services that are exposed for consumption by external systems. These reference implementations contain published business services and business services. When invoked by external systems, these web services call business services, which are JD Edwards EnterpriseOne objects that perform a specific business process.
With JD Edwards EnterpriseOne Tools Release 9.1 Update 2, reference implementation JPR01MO1 - RI_AddressBookMediaObjectManager is available for testing your development environment for media object operations. The media object published business service reference implementation is a JD Edwards EnterpriseOne web service that is exposed for consumption by external systems. When invoked by external systems, this web service calls business services, which are JD Edwards EnterpriseOne objects that perform the actual media object operation.
See Published Business Service: JPR01MO1 - RI_AddressBookMediaObjectManager (Release 9.1 Update 2) for information about this reference implementation.
You can use published business service reference implementations as a model for creating your own business services. In addition, you can run them to test the business services development environment.
The tables in this section describe the components of each published business service reference implementation. The last column in each table describes the implementation pattern along with a cross reference to the section in the JD Edwards EnterpriseOne Tools Business Services Development Methodology Guide that provides further details about the implementation pattern.
This section describes the components of these published business service reference implementations:
JPR01000 - RI_AddressBookManager
JPR01001 - RI_AddressBookTransactionManager
JPR01002 - RI_AddressBookStagingManager
JPR01020 - RI_CustomerManager
JPRCUST0 - RI_CustomABManager
JPRCUST1 - RI_CustomAddressBookManager
JPRCUST2 - RI_CustomAddressBookStagingManager
JPR01MO1 - RI_AddressBookMediaObjectManager (Release 9.1 Update 2)
This table describes the components of JPR01000 - RI_AddressBookManager:
Note:
When you develop a business service, you need to test it as you develop it. For JPR01000 - RI_AddressBookManager, JD Edwards EnterpriseOne provides a test object that makes use of the functionality of the RI_AddressBookManager service. It is included in the reference implementation as an example of how a developer codes test objects. The JTR87010 test object is automatically delivered with JD Edwards EnterpriseOne and requires no additional configuration.| Business Service | Method | Description | Implementation Pattern and Reference to Business Services Development Methodology Guide |
|---|---|---|---|
| JR010010 - RI_AddressBookProcessor | addAddressBook | Adds an address book record with phone number information. | A business service calling a BSFN, utility, or another business service.
See: Calling Business Functions. Calling Other Business Services. |
| JR010010 - RI_AddressBookProcessor | addAddressBookAndParent | Adds an address book record with phone information and creates a parent record to demonstrate an explicit transaction. | An explicit transaction with a manual connection.
See Using an Explicit Transaction. |
| JR010030 - RI_PhonesProcessor | addPhones | Adds phones from a collection of phone information. | A business service that is not exposed publicly in a web service; it is used only by other business services.
See Calling Other Business Services. |
| JR010040 - RI_AddressBookQueryProcessor | getAddressBook | Queries the V0101XPI view and returns address book information based on data passed in. | Query of "Select" database operation and auto commit transaction.
See: Creating a Query Database Operation Business Service. Understanding Transaction Processing. |
This table describes the components of JPR01001 - RI_AddressBookTransactionManager:
| Business Service | Method | Description | Implementation Pattern and Reference to Business Services Development Methodology Guide |
| JR010011 - RI_AddressBookTransactionProcessor | addAddressBook | Adds an address book record with phone number information. | A business service calling a business function, utility, or another business service.
See: Calling Business Functions. Calling Other Business Services. |
| JR010011 - RI_AddressBookTransactionProcessor | addAddressBookandBusinessUnit | An explicit transaction business function and database operation.
See Using an Explicit Transaction. |
no value |
| JR010011 - RI_AddressBookTransactionProcessor | addAddressBookAndParent | Adds an address book record with phone information and creates a parent record to demonstrate an explicit transaction. | An explicit transaction business function.
See Using an Explicit Transaction. |
| JR010040 - RI_AddressBookQueryProcessor | getAddressBook | Queries the V0101XPI view and returns address book information based on data passed in. | Select database operation and auto commit transaction.
See: Creating a Query Database Operation Business Service. Understanding Transaction Processing. |
This table describes the components of JPR01002 - RI_AddressBookStagingManager:
| Business Service | Method | Description | Implementation Pattern and Reference to Business Services Development Methodology Guide |
| JR010050 - RI_AddressBookStagingProcessor | insertAddressBookStaging | Inserts records into the Address Book Z table F0101Z2 | Insert database operation.
See Creating an Insert Database Operation Business Service. |
| JR010050 - RI_AddressBookStagingProcessor | updateAddressBookStaging | Updates records in the Address Book Z table F0101Z2 | Update database operation.
See Creating an Update Database Operation Business Service. |
| JR010050 - RI_AddressBookStagingProcessor | deleteAddressBookStaging | Deletes record from the Address Book Z table F0101Z2 | Delete database operation.
See Creating a Delete Database Operation Business Service. |
This table describes the components of JPR01020 - RI_CustomerManager:
| Business Service | Method | Description | Implementation Pattern and Reference to Business Services Development Methodology Guide |
| JR010023 - RI_CustomerCreditQueryProcessor | getCustomerCreditInfo | Retrieves customer credit information based on input of customer number. | A query performed by a business function.
See Value Object Overview. |
| JR010020 - RI_EntityProcessor (Utility) | processEntity | A re-useable business service.
See Calling Other Business Services. |
no value |
This published business service exposes this method:
An example of a published business service calling another published business service or a customer's extension of a delivered RI_AddressBookManager published business service calling the addAddressBook method.
This published business service exposes this method:
An example of a published business service calling another published business service or a customer's extension of a delivered RI_AddressBookTransactionManager published business service calling the addAddressBookAndBusinessUnit method.
This published business service exposes this method:
An example of a published business service calling another published business service or a customer's extension of a delivered RI_AddressBookStagingManager published business service calling the insertAddressBookStaging method.
This table describes the components of JPR01MO1- RI_AddressBookMediaObjectManager:
| Business Service | Method | Description | Implementation Pattern and Reference to Business Services Development Methodology Guide |
|---|---|---|---|
| JR010MO1 | addAddressBookMO | Adds an address book record along with media objects. | A business service calling a media object operation.
See Creating an Insert Media Object Operation Business Service. |
| JR010MO1 | getAddressBookMO | Retrieves an address book record along with any media objects. | A business service calling a media object operation.
See Creating a Select Media Object Operation Business Service. |
| JR010MO1 | deleteAddressBookMO | Deletes media objects for an address book number. | A business service calling a media object operation.
See Creating a Delete Media Object Call Business Service. |
These prerequisites enable you to download, install, and use reference implementation JPR01MO1:
Download and install the ESU for published business service reference implementation JPR01MO1 and internal business service reference implementation JR010MO1 to the deployment server.
The ESUs that correspond to the following bug numbers must be installed for testing media object operations for reference implementations JPR01MO1 and JR010MO1:
EnterpriseOne Applications Release 9.0: Bug 14125712
EnterpriseOne Applications Release 9.1: Bug 14125693
On the EnterpriseOne development client machine, using OMW, first search for the JPR01MO1 object and then perform a Get operation in OMW to get the JPR01MO1 object locally to <E1_Install_Path>\DV900\java\source \oracle\e1\bssv\JPR010MO1 location.
On the EnterpriseOne development client machine, using OMW, search for the JR010MO1 object and then perform a Get operation in OMW to get the JR010MO1 object locally to <E1_Install_Path>\DV900\java\source\oracle\e1\bssv \JR010MO1 location.
If you want to test the reference implementation using a standalone business services server, you can build a JAX-WS business service package and deploy the package to your business services server.
See Also:
Creating, Deploying, and Testing Reference Implementation JPR01MO1
You can use reference implementation JPR01MO1 as a model to create a custom published business service that uses media object operations. After you create your custom published business service, you deploy it to the JDeveloper 11g Integrated WebLogic Server for testing. You can verify that your business service server is working properly by testing the JPR01MO1 reference implementation in the JDeveloper 11g Integrated WebLogic Server.
You can access business service reference implementations through Object Management Workbench (OMW) in the JD Edwards EnterpriseOne Windows client.
Install JDeveloper.
To access a business service reference implementation:
Access OMW.
In OMW, create a project.
Search for a reference implementation and then add it to your project.
Select the reference implementation and then click the Design button.
On the Business Function Design form, click the Design Tools tab.
Click Invoke JDeveloper.
See "Working with Business Services" in the JD Edwards EnterpriseOne Tools Object Management Workbench Guide for more information.
Oracle provides the following BPEL reference implementations to test that a JD Edwards EnterpriseOne business service running on the IBM WebSphere Application Server can be consumed by Oracle's BPEL PM:
BPELProcessForWebSphereAddABAndGetCustomerCredit
In addition, you can use the BPEL reference implementations as a template for creating a BPEL flow that calls a business service.
The BPEL reference implementations use these JD Edwards EnterpriseOne published business service reference implementations:
JPR01020: RI_CustomerManager
This reference implementation contains the getCustomreCredit method, which retrieves customer credit information based on input of customer number.
JPR01000: RI_AddressBookManager
This reference implementation contains the addAddressBook method, which adds an address book record with phone number information.
These reference implementations must be installed before you run a BPEL reference implementation. See Published Business Service Reference Implementations in this guide for more information.
The files that you need to install the BPEL reference implementation are in a Zip file located in this JD Edwards EnterpriseOne installation directory:
\\EnterpriseOneInstallDirectory\System\Classes\samples\BPEL
The Zip file includes a readme file that contains a list of prerequisites and provides instructions on how to install and run the reference implementation from the BPEL Admin Console.
Note:
You cannot run this reference implementation from Object Management Workbench in JD Edwards EnterpriseOne because it is not a JD Edwards EnterpriseOne object.Oracle provides the following BPEL reference implementations to test that a JD Edwards EnterpriseOne business service running on the Oracle WebLogic Server can be consumed by Oracle's BPEL PM:
BPELForWeblogicGetCustomerCreditInfo
In addition, you can use the BPEL reference implementations as a template for creating a BPEL flow that calls a business service.
The BPEL reference implementation use this JD Edwards EnterpriseOne published business service reference implementation:
JPR01020: RI_CustomerManager
This reference implementation contains the getCustomerCredit method, which retrieves customer credit information based on input of customer number.
This reference implementations must be installed before you run a BPEL reference implementation. See Published Business Service Reference Implementations in this guide for more information.
The files that you need to install the BPEL reference implementation are in a Zip file located in this JD Edwards EnterpriseOne installation directory:
\\EnterpriseOneInstallDirectory\System\Classes\samples\BPEL11g
The Zip file includes a readme file that contains a list of prerequisites and provides instructions on how to install and run the reference implementation from the BPEL Admin Console.
The AddressBookStagingESB reference implementation is an example of an ESB flow that calls a business service in JD Edwards EnterpriseOne. You can use this ESB reference implementation to test that a JD Edwards EnterpriseOne business service can be consumed by Oracle's ESB. In addition, you can use this reference implementation as a template for creating an ESB flow that consumes a JD Edwards EnterpriseOne business service.
This reference implementation uses the methods in the JPR01002 business service that:
Insert address book records.
Update address book records.
Delete address book records.
The files that you need to install and run this reference implementation are in a Zip file located in this JD Edwards EnterpriseOne installation directory:
\\EnterpriseOneInstallDirectory\System\Classes\samples\ESB
The Zip file includes a readme file that provides instructions on how to install and run the AddressBookStagingESB reference implementation.
Note:
You cannot run this reference implementation from Object Management Workbench in JD Edwards EnterpriseOne because it is not a JD Edwards EnterpriseOne object.The MediatorForWeblogicGetCustomerCreditInfo reference implementation is an example of a Mediator flow that calls a business service in JD Edwards EnterpriseOne. You can use this Mediator reference implementation to test that a JD Edwards EnterpriseOne business service can be consumed by Oracle's Mediator component. In addition, you can use this reference implementation as a template for creating a Mediator flow that consumes a JD Edwards EnterpriseOne business service.
The Mediator reference implementation uses this JD Edwards EnterpriseOne published business service reference implementation:
JPR01020: RI_CustomerManager
This reference implementation contains the getCustomerCredit method, which retrieves customer credit information based on input of customer number.
The files that you need to install and run this reference implementation are in a Zip file located in this JD Edwards EnterpriseOne installation directory:
\\EnterpriseOneInstallDirectory\System\Classes\samples\ESB11g
The Zip file includes a readme file that provides instructions on how to install and run the MediatorForWeblogicGetCustomerCreditInfo reference implementation.