Ensemble X12 Development Guide
Configuring the Production
[Back] [Next]
   
Server:docs2
Instance:LATEST
User:UnknownUser
 
-
Go to:
Search:    

This chapter describes the process of creating and configuring an X12 Production. It contains the following sections:

Be sure to perform all tasks in the same namespace that contains your production. When you create rule sets and transformations do not use reserved package names; see Reserved Package Names in Developing Ensemble Productions.
Also see Overriding the Validation Logic in Ensemble Virtual Documents.
Creating a new X12 Production
You can add X12 components to an already existing production. However, if you want to create a new Ensemble production explicitly for handling X12, follow the steps below.
  1. In the Management Portal, switch to the appropriate namespace.
    To do so, click Switch in the title bar, click the namespace, and click OK.
  2. Click Ensemble.
  3. Click Configure.
  4. Click Production and then click Go.
    Ensemble then displays the last production you accessed, within the [Ensemble] > [Production Configuration] page.
  5. Click the Actions tab on the Production Settings menu.
  6. Click New to invoke the Production Wizard.
  7. Choose the Generic production type and click OK.
Ensemble creates a blank production from which you can add components such as business services, business processes, and business operations. See the sections below for more details.
Note:
As you build your production, it frequently happens that while configuring one component you must enter the name of another component that you have not yet created. A clear naming convention is essential to avoid confusion. For suggestions, see Naming Conventions in Ensemble Best Practices. For rules, see Configuration Names,” in Configuring Ensemble Productions.
Adding an X12 Business Service
Add one X12 business service for each application or source from which the production will receive X12 documents.
To add an X12 business service to a production:
  1. Access the Business Service Wizard as usual; see Configuring Ensemble Productions.
  2. Click the X12 Input tab.
  3. Click one of the following from the Input type list:
  4. For X12 Service Name, type the name of this business service.
  5. For X12 Service Target, select one of the following:
  6. Click OK.
Adding an X12 Business Process
To add an X12 business process to a production:
  1. Access the Business Process Wizard as usual; see Configuring Ensemble Productions.
  2. Click the X12 Router tab; the router class defaults to EnsLib.MsgRouter.VDocRoutingEngine.
  3. For Routing Rule Name, do one of the following:
  4. For X12 business process Name, type the name of this business process.
  5. Click OK.
  6. Ensure that your X12 business service is connected to the new X12 Business Process. To connect the process:
  7. Configure additional settings of the business process, as needed. For details, see Settings for X12 Business Processes.
Adding an X12 Routing Rule
For general information on defining business rules, see Developing Business Rules.
When you create an X12 routing rule:
In all other respects, the structure and syntax for both types of rule set are the same.
Adding an X12 Data Transformation
Your routing rule may need one or more data transformations.
For general information on defining DTL data transformations, see Developing DTL Transformations.
When you create a DTL data transformation for X12 documents:
Use the X12 Document Viewer Page to test your transformations, as described in the chapter Available Tools.”
To integrate the DTL data transformation in the production, enter its full package and class name in the Transform field of a routing rule.
Note:
Be sure your data transformation reflects your Batch Handling settings.
Adding an X12 Business Operation
To send X12 messages from a production to a file or application, you must add an X12 business operation. Add an X12 business operation for each output destination.
You might also want to add business operations to handle bad messages (for background, see Business Processes for Virtual Documents in Ensemble Virtual Documents).
To add an X12 business operation to a production:
  1. Access the Business Operation Wizard as usual; see Configuring Ensemble Productions.
  2. Click the X12 Output tab.
  3. Click one of the following from the Output type list:
  4. For X12 Operation Name, type the name of this business operation.
  5. Click OK.
  6. Ensure that the business operation is connected to the relevant business services or business process
  7. Configure additional settings of the business operation, as needed. For details, see Settings for X12 Business Operations.
If you want the production to send data that is not an X12 message, see Defining Business Operations in Developing Ensemble Productions. Also see Connectivity Options in Introducing Ensemble.