This chapter includes these topics:
This chapter provides detailed information about the business interfaces that are available for the Business Unit business object.
This table lists all of the available interface components:
| Interface Type | Available Interfaces |
|---|---|
| Business Services | The BusinessUnitManager (JP000006) manages the process of these business unit-related web service operations: |
| Real-Time Events | This list includes the real-time events for the Business Unit business object: |
| Batch Import Programs | This list includes the batch import programs for the Business Unit business object: |
| Batch Export Programs | This list includes the batch export programs for the Business Unit business object:
|
| Additional Components | There are several programs that work together to enable users to manually input, or upload from a spreadsheet, business unit data. The data can be reviewed and modified, and then transferred to a the live EnterpriseOne tables. You can then purge the records in the temporary table.
For additional information about these programs, see Importing and Exporting Business Unit and Company Records (Release 9.1 Update). |
|
Note: You can find additional technical information about each type of business interface component. For additional descriptions of the information available, and instructions for finding this information, see Chapter 5, "Accessing Additional Information for Business Interface Components." |
The BusinessUnitManager web service (JP000006) manages the processing of the business unit-related web service operations. This table includes a description of the business unit web service operations:
| Operation | Description |
|---|---|
| processBusinessUnit (J0000120) | Use this operation to process the Business Unit information in the JD Edwards Enterprise One system. This operation enables you to add, change, and delete Business Unit records. |
| getBusinessunit (J0000130) | Use this operation to retrieve Business Unit information from the EnterpriseOne database. The operation uses the user-defined search criteria to retrieve the records. |
To access Javadoc for the BusinessUnitManager web service and its related operations, review these Javadoc packages:
JP000006 (BusinessUnitManager)
J0000120 (processBusinessUnit)
J0000130 (getBusinessunit)
The ProcessBusinessUnitProcessor (J0000120) is a web service operation that calls the processBusinessUnit method, based on the action of the user. This method enables consumers to add, change, or delete Business Unit records in the Enterprise One database. When the processBusinessUnit method is called, the operation calls the BSFNs - ProcessBusinessUnit_Wrapper (B0001440) to add, change, or delete Business records, and calls the ProcessBusinessUnit_Translation (B0001440) to add, change, or delete Business Unit Alternate Description Translations records.
If the operation is successful, the system updates the Business Unit information in the JD Edwards EnterpriseOne system. If the operation encounters errors, processing stops and the errors are returned to the consumer.
Before you use this operation, you can set business service properties to specify how the system processes contact data. This table includes information about the business service properties that the processBusinessUnit operation uses:
| Group | Key | Description | Default Value |
|---|---|---|---|
| J0000120 | J0000120_BU_VERSION | Use this business service property to specify the version of the P0006 Entry program that will be used while processing the data. | ZJDE0001 |
See JD Edwards EnterpriseOne Tools Business Services Development Methodology Guide.
This table includes information that can help determine whether the processBusinessUnit operation is functioning correctly:
| Question | Answer |
|---|---|
| How can I tell if the operation completes successfully? | If the operation completes successfully, the system returns a confirmation message to the consumer. The message includes all of the fields that are listed in the response interface for this operation.
However, some of those fields can contain blank or zero values, depending on the data that exists in the Enterprise One system. At a minimum, the system returns non-zero values for these fields
|
| If I encounter errors while processing a transaction, do I need to reverse the transaction? | This operation uses standard transaction processing. If the system encounters errors while processing contact information, no data in the JD Edwards EnterpriseOne system is updated. No manual updates are required. |
| Does this operation use record reservation? | This operation reserves records in the JD Edwards EnterpriseOne system during the change of Business Unit. |
The getBusinessunit (J0000130) web service operation is a database query operation that enables consumers to retrieve and review Business Unit records from the JD Edwards EnterpriseOne database. The operation returns one or more records to the consumers from the Business Unit (F0006) table and Business Unit Business Unit Alternate Description (F0006D) table that meet the specified search criteria.
Before you use this operation, you can set business service properties to specify how the system processes contact data. This table includes information about the business service properties that the getBusinessUnit operation uses:
| Group | Key | Description | Default Value |
|---|---|---|---|
| J0000130 | J0000130_MAX_ROWS_F0006 | Use this business service property to specify the maximum number of BU records the operation can return for a query.
The default value is set to 100; however, this might limit the returned data when searching for records. If you find that limiting the number of results returned to 100 does not enable you to find the records you are searching for, it is acceptable to increase this value to a number that fits your business needs. |
100 |
See JD Edwards EnterpriseOne Tools Business Services Development Methodology Guide.
This table includes information that can help determine whether the getBusinessUnit operation is functioning correctly:
| Question | Answer |
|---|---|
| How can I tell if the operation completes successfully? | If the operation completes successfully, zero to many records are returned, based on the selection criteria.
The records that are returned to the consumer include all of the fields that are listed in the response interface for this operation. However, some of those fields can contain blank or zero values, depending on the data that exists in the JD Edwards Enterprise One system. At a minimum, the system returns non-zero values for these fields:
|
| If I encounter errors while processing a transaction, do I need to reverse the transaction? | This is a database query operation that does not perform transactions. If you encounter errors during processing, review your search criteria and business service property settings and try your query again. If the operation does not return any records, verify that records matching your query exist in the JD Edwards EnterpriseOne database. |
| Does this operation use record reservation? | No. The operation does not reserve records within the JD Edwards EnterpriseOne system during processing. |
This section describes the available real-time events associated with the Business Unit business object, which include:
RTBUOUT, which is a container event for these single events:
RTBUOUT2, which is a container event for these single events:
RTBUOUT3, which is a container event for these single events:
RTBUOUT is a container event generated by the JD Edwards EnterpriseOne system to provide business unit information.
| Event Type | Event Description | Event Category | Event Aggregate | Product Code |
|---|---|---|---|---|
| RTBUOUT | Business Unit Master | RTE | Container
Container event for:
|
H00 |
Please see the appropriate real-time events that are contained by this event for information about the event fields associated with this event.
Conceptual Approach
A business unit record added, modified, or deleted in the JD Edwards EnterpriseOne system creates, modifies, or deletes a record in the Business Unit table (F0006). If a business unit is added or modified, the information is sent to another third-party system for add or update. If a business unit is deleted, the pertinent information is sent to the third-party, which take the appropriate action.
Objects that Can Initiate the Event
These objects can initiate the RTBUOUT event, and the single events contained within the event:
P0006 - Business Units
P41001 - Branch/Plant Constants
PDG1117A
R10480 - Journalize Consolidation Balances
R10862 - Refresh Consolidation
B0000105 - F0006D Update Business Unit Translation
B0000107 - F0006D Edit Business Unit Translation
B0000203 - F0006 Update Business Unit Category Codes from Address Book
B0900156 - Delete F0006 Business Unit and F0006D Translations
B1000012 - Business Unit Existence Check
B1000040 - Build Parent/Child Business Unit Cache
RTBUOUTA is a single event within the RTBUOUT container event that provides business unit information. RTBUOUTA is generated only when RTBUOUT is generated.
| Event Type | Event Description | Event Category | Event Aggregate | Product Code | Data Structure | Event Relationship |
|---|---|---|---|---|---|---|
| RTBUOUTA | Business Unit Details | RTE | Single | H00 | D0000600B: Business Unit Real Time Notification Outbound Data | Included in container event RTBUOUT |
RTBUOUTB is a single event within the RTBUOUT container event that provides business unit information. RTBUOUTB is generated only when RTBUOUT is generated.
| Event Type | Event Description | Event Category | Event Aggregate | Product Code | Data Structure | Event Relationship |
|---|---|---|---|---|---|---|
| RTBUOUTB | Business Unit - Branch Plant | RTE | Single | H00 | D4101700B: Business Unit Real Time Notification Outbound Data | Included in container event RTBUOUT |
RTBUOUT2 is a container event generated by the JD Edwards EnterpriseOne system to provide business unit information.
| Event Type | Event Description | Event Category | Event Aggregate | Product Code |
|---|---|---|---|---|
| RTBUOUT2 | Business Unit Master Version 2 | RTE | Container
Container event for:
|
H00 |
Please see the appropriate real-time events that are contained by this event for information about the event fields associated with this event.
Conceptual Approach
A business unit record added, modified, or deleted in the JD Edwards EnterpriseOne system creates, modifies, or deletes a record in the Business Unit table (F0006). If a business unit is added or modified, the information is sent to another third-party system for add or update. If a business unit is deleted, the pertinent information is sent to the third-party, which take the appropriate action.
Objects that Can Initiate the Event
These objects can initiate the RTBUOUT2 event, and the single events contained within the event:
P0006 - Business Units
P41001 - Branch/Plant Constants
PDG1117A
R10480 - Journalize Consolidation Balances
R10862 - Refresh Consolidation
B0000105 - F0006D Update Business Unit Translation
B0000107 - F0006D Edit Business Unit Translation
B0000203 - F0006 Update Business Unit Category Codes from Address Book
B0900156 - Delete F0006 Business Unit and F0006D Translations
B1000012 - Business Unit Existence Check
B1000040 - Build Parent/Child Business Unit Cache
B0000600 - Business Unit Real Time Event Notification
B4101700 - Business Unit Real Time Event Notify 2
RTBUOUTA2 is a single event within the RTBUOUT2 container event that provides business unit information. RTBUOUTA2 is generated only when RTBUOUT2 is generated.
| Event Type | Event Description | Event Category | Event Aggregate | Product Code | Data Structure | Event Relationship |
|---|---|---|---|---|---|---|
| RTBUOUTA2 | Bus Unit Details Version 2 | RTE | Single | H00 | D0000610B: Business Unit Real Time Notification Outbound Data | Included in container event RTBUOUT |
RTBUOUTB2 is a single event within the RTBUOUT2 container event that provides business unit information. RTBUOUTB is generated only when RTBUOUT2 is generated.
| Event Type | Event Description | Event Category | Event Aggregate | Product Code | Data Structure | Event Relationship |
|---|---|---|---|---|---|---|
| RTBUOUTB2 | Bus Unit-Branch Plant Version2 | RTE | Single | H00 | D4101770B: Business Unit Real Time Notification Outbound Data | Included in container event RTBUOUT |
RTBUOUT3 is a container event generated by the JD Edwards EnterpriseOne system to provide business unit information.
| Event Type | Event Description | Event Category | Event Aggregate | Product Code |
|---|---|---|---|---|
| RTBUOUT3 | RTBUOUT3 | RTE | Container
Container event for:
|
H00 |
Conceptual Approach
A business unit record added, modified, or deleted in the JD Edwards EnterpriseOne system creates, modifies, or deletes a record in the Business Unit table (F0006). If a business unit is added or modified, the information is sent to another third-party system for add or update. If a business unit is deleted, the pertinent information is sent to the third-party, which take the appropriate action.
Objects that Can Initiate the Event
These objects can initiate the RTBUOUT3 event, and the single events contained within the event:
P0006 - Business Units
P41001 - Branch/Plant Constants
PDG1117A
R10480 - Journalize Consolidation Balances
R10862 - Refresh Consolidation
B0000105 - F0006D Update Business Unit Translation
B0000107 - F0006D Edit Business Unit Translation
B0000203 - F0006 Update Business Unit Category Codes from Address Book
B0900156 - Delete F0006 Business Unit and F0006D Translations
B1000012 - Business Unit Existence Check
B1000040 - Build Parent/Child Business Unit Cache
B0000600 - Business Unit Real Time Event Notification
B4101700 - Business Unit Real Time Event Notify 2
RTBUOUTA3 is a single event within the RTBUOUT3 container event that provides business unit information. RTBUOUTA3 is generated only when RTBUOUT3 is generated.
| Event Type | Event Description | Event Category | Event Aggregate | Product Code | Data Structure | Event Relationship |
|---|---|---|---|---|---|---|
| RTBUOUTA3 | RTBUOUTA3 | RTE | Single | H00 | D0000620B - Business Unit Real Time Notification Outbound Data | Included in container event RTBUOUT3 |
RTBUOUTB3 is a single event within the RTBUOUT3 container event that provides business unit information. RTBUOUTB3 is generated only when RTBUOUT3 is generated.
| Event Type | Event Description | Event Category | Event Aggregate | Product Code | Data Structure | Event Relationship |
|---|---|---|---|---|---|---|
| RTBUOUTB3 | RTBUOUTB3 | RTE | Single | H00 | D4101780B - Business Unit Real Time Notification Outbound Data | Included in container event RTBUOUT3 |
You use batch import programs to import data from an external software system into the JD Edwards EnterpriseOne system, where it can then be processed by EnterpriseOne programs.
This table lists and describes the available batch import programs that are associated with the Business Unit business object:
You use batch export programs to retrieve and format data from the JD Edwards EnterpriseOne database so that it can be used by an external software system.
This table lists and describes the available batch export programs that are associated with the Business Unit business object:
| Program and Program Type | Description | Available Documentation |
|---|---|---|
| Outbound Cost Center Extraction (R0006Z1E)
This is an outbound interoperability program. |
This program writes business unit information that is retrieved from the Business Unit Master table (F0006) into the Cost Center Unedited Transaction Table (F0006Z1) as outbound transaction records. This information is then intended to be used by systems outside of Enterprise One. | See this topic: |