Constructing the Projects

This section explains how to construct the Projects in the ASC X12 PM in order to run the sample scenario. This operation includes:

• Using installed Projects (in Project Explorer) for the sample scenario

• Setting up and configuring Project components

• Associating each Project with the appropriate Environment(s)

• Mapping and building the Project’s Deployment Profile

• Deploying the Deployment Profile, if necessary

Building a Deployment Profile creates the application .ear file for the Project. After creating this file, you must deploy it for all Deployment Profiles except the B2B Host.

You perform these operations using Enterprise Designer’s Project Explorer and its canvas windows. The remainder of this section describes the necessary procedures under the following sections:

• Constructing the B2B Host Project

• eXchange Deployment Project

• Constructing the 855_FromInt_850 Project

• Constructing the Remaining Projects’ Deployment Profiles

Constructing the B2B Host Project

This section explains how to set up, and configure the ASC X12 PM sample scenario’s B2B Host Project, X12Host. Constructing the B2B Host Project creates an eXchange service that acts as a channel manager and provides a connection to the eXchange database. You must build two Deployment Profiles, one for each company, Atlanta and Berlin. However, you do not deploy these Deployment Profiles.

To Build the B2B Host’s Deployment Profile for Atlanta

1. On Enterprise Designer’s Project Explorer tree, right-click X12Host under eXchange ⇒ B2BHosts and, on the context menu, choose New and click Deployment Profile.

2. In the resulting dialog box, name the new Deployment Profile dpHost_A, point it at envA, make sure it is using only the cmX12 Connectivity Map, and click OK.

   Deployment Editor opens. Its left pane shows the X12 B2B Host instance, the Oracle1 external application, and the LDAP1 external application. These are the components created in the Connectivity Map cmX12.

   The Deployment Editor right pane contains windows representing the Logical Host and external systems created in envA.

3. Click Automap to map the components.

   The components in the left pane automatically map to the appropriate windows on the right pane of Deployment Editor for dpHost_A. See the figure below.

   

4. Click Save.

5. Click Build to build the Deployment Profile.

   A dialog box appears, indicating the status of the build operation. A new service, X12 eXchange Service, is created and assigned to the current Deployment Profile and Environment.

   You may view this X12 eXchange Service on envA, in the Environment Explorer tree, as well as in the right pane of Deployment Editor for dpHost_A.

   ---

   Note –

   Do not deploy the B2B Host Project.

   ---

   If the build operation is not successful due to incomplete or incorrect configuration, repeat the steps in this procedure, carefully rechecking every action. When the build is successful, go to the next step.

   ---

   Note –

   Building Deployment Profiles for large Projects may take approximately 10 to 15 minutes or more.

   ---

6. When you are finished, click Save All and close all canvases.

To Build the B2B Host’s Deployment Profile for Berlin

1. On Enterprise Designer’s Project Explorer tree, right-click X12Host under eXchange ⇒ B2BHosts and, on the context menu, point at New and click Deployment Profile.

2. In the resulting dialog box, name the new Deployment Profile dpHost_B, point it at envB, make sure it is using cmX12, and click OK.

3. In Deployment Editor, click Automap to map the components.

4. Click Save.

5. Build the Deployment Profile for Berlin in the same way as you did for Atlanta, except make sure to use envB and cmX12.

   The X12 eXchange Service is created and assigned to the current Deployment Profile and Environment. Do not deploy the B2B Host Project. Once more, if there are any errors, troubleshoot until you are ready to go to the next step.

6. When you are finished, click Save All and close all canvases.

   Result: You have now finished constructing the B2B Host Project, including creating, mapping, and building Deployment Profiles for Atlanta and Berlin.

eXchange Deployment Project

This section explains how to set up, build, and deploy Atlanta and Berlin Deployment Profiles in the eXchange Deployment Project. This Project makes all of the core B2B services and processing available to the application .ear files built from the Deployment Profiles.

To complete this operation, you must set up a Connectivity Map for ASC X12 OTD validation and Deployment Profiles for both Atlanta and Berlin. You must map, build, and deploy both Deployment Profiles.

Creating the Validation Connectivity Map

To complete this operation, you must You must deploy OTD validation BPs via a Connectivity Map, to allow you to configure the Trading Partner Profiles to specify the custom validation handlers. You must then map, build, and deploy two Deployment Profiles, one each for Atlanta and Berlin.

To Create the OTD Validations Connectivity Map

1. Create a Connectivity Map using Project Explorer, under eXchange ⇒ Deployment, named, for example, cmX12OtdValidation (or a convenient name for your system, with fewer characters).

2. From Project Explorer, drag Sun SeeBeyond ⇒ eXchange ⇒ User Components ⇒ OTD Validations ⇒ X12 ⇒ v4010 ⇒ X12_4010_850_FullSynValhandler onto the Connectivity Map canvas.

3. From the same Project Explorer location, drag the X12_4010_855_FullSynValhandler component onto the Connectivity Map canvas.

4. Drag one eXchangeService from eXchange ⇒ Deployment folder onto the canvas

5. Double-click bpX12_850_FullSynValhandler1 and link InboundeXchangeService to eXchangeService.

6. Double-click bpX12_855_FullSynValhandler1 and link InboundeXchangeService to eXchangeService.

   For the results, see the figure below.

   

7. Open and save all the default properties for the eWays on the Connectivity Map.

8. Click Save All then close the Connectivity Map.

Building and Deploying the Deployment Profiles

When you are finished, you must create Deployment Profiles for both Atlanta and Berlin. These Deployment Profiles are for the eXchange Deployment Project.

To Build and Deploy the eXchange Deployment Project’s Deployment Profile for Atlanta

1. On Enterprise Designer’s Project Explorer tree, right-click Deployment and, on the context menu, point at New and click Deployment Profile.

2. In the resulting dialog box, name the new Deployment Profile dpA, point it at envA, and click OK.

3. On Deployment Editor, click Automap to map the components.

4. Click Build to build the Deployment Profile for Atlanta.

5. Click Deploy to deploy the Deployment Profile.

   ---

   Note –

   After each of the operations, map, build, and deploy, you receive a status message. If you receive any errors, troubleshoot your previous procedures, as necessary. Deploying Deployment Profiles may take as long or longer than building them.

   ---

6. When you are finished, click Save All and close all canvases.

To Build and Deploy the eXchange Deployment Project’s Deployment Profiles for Berlin

1. On Enterprise Designer’s Project Explorer tree, right-click Deployment and, on the context menu, point at New and click Deployment Profile.

2. In the resulting dialog box, name the new Deployment Profile dpB, point it at envB, and click OK.

3. On Deployment Editor, click Automap to map the components.

4. Click Build to build the Deployment Profile for Berlin.

5. Click Deploy to deploy the Deployment Profile.

6. When you are finished, click Save All and close all canvases.

   Result: You have now finished constructing the eXchange Deployment Project, including creating, mapping, building, and deploying Deployment Profiles for Atlanta and Berlin.

Constructing the 855_FromInt_850 Project

This section describes how to set up, build, and deploy the Berlin Deployment Profile for the 855_FromInt_850 Project. This Project operates with envB and makes sure the X12 855 message is returned from Berlin to Atlanta.

Updating the bp855 Business Process

You must make sure the Berlin system is using the data file path listed under Editing the Sample Data .xml Files by checking the bp855 BP in 855_FromInt_850. To do this action, open eXchange ⇒ Samples ⇒ X12 ⇒ 855_FromInt_850 ⇒ BPs ⇒ bp855 in Project Explorer.

The BP structure appears in Business Process Editor, in Enterprise Designer’s right pane. See Figure 6–3.

Figure 6–3 Business Process Editor: bp855

Make sure that the path given in the indicated component, in the previous figure, reflects your Berlin data path, for example:

C:\temp\eXchange\Sample\X12\Data\Berlin

This is also the path location of the X12_dlg_850_In_Atlanta_850_In.xml and X12_4010_855_template.st files.

This setup has been created for the purpose of the sample scenario only. It is recommended that, when creating your own inbound BPs, you configure the BP to read this type of path information from the inbound eWay.

Building and Deploying the Deployment Profile

This section describes how to build and deploy the 855_FromInt_850 Project’s Deployment Profile for Berlin.

To Build and Deploy the 855_FromInt_850 Project’s Deployment Profile for Berlin

1. On Enterprise Designer’s Project Explorer tree, right-click Deployment and, on the context menu, point at New and click Deployment Profile.

2. In the resulting dialog box, name the new Deployment Profile dp855_B, point it at envB, make sure it is using all the checked Connectivity Maps, and click OK.

3. On Deployment Editor, click Automap to map the components.

4. Click Build to build the Deployment Profile for Berlin.

5. Click Deploy to deploy the Deployment Profile.

6. When you are finished, click Save All and close all canvases.

   Result: You have now finished setting up the 855_FromInt_850 Project, including creating, mapping, building, and deploying Deployment Profile for Berlin only (there is no Atlanta Deployment Profile for this Project).

Constructing the Remaining Projects’ Deployment Profiles

Construct the following Projects’s Deployment Profiles, as shown under eXchange in Project Explorer, in the same way you have done for the previous Projects in the sample scenario:

• ePM

• Tracker

• Sub_DLQ

• Sub_ProcErrors

• RecvFromInt

• RecvFromTP; use only the BatchLocalFile sub-Project.

• SendToInt

To construct the remaining Projects’ Deployment Profiles locate, name, and deploy Deployment Profiles for the Projects shown in the previous list, as depicted in Table 6–1.

Final Result: You have constructed, built, and deployed (if necessary) all the Projects’ Deployment Profiles for the sample scenario.

Summary of Sample Scenario Projects

Table 6–1 provides a summary list of the sample scenario’s Projects, their Deployment Profiles, and corresponding Environments. It is recommended that you construct the Projects and their Deployment Profiles in the order shown in the table.