Creating and Configuring BPADs

Business protocol attribute definitions (BPADs) consist of business attribute definitions (BADs) and enveloping attribute definitions (EADs). BPADs are used by business protocols, such as X12, HIPAA, and EDIFACT. If you do not use business protocols, your B2B Host does not need to define any BPADs.

Generally, BADs specify business protocol parameters at the group level (that is, the inner envelope), and EADs specify business protocol parameters at the interchange level (that is, the outer envelope).

Figure 4–8 provides examples of a BAD for X12 (named “X12”) and a BAD for EDIFACT (named “EDIFACT-UNG”). The attributes in the BAD specify the label, type, and so forth of parameters that are displayed in ePM.

Figure 4–8 Default Business Attribute Definitions (BADs) for X12 and EDIFACT

Figure 4–9 provides examples of an EAD for X12 (named “Envelope”) and an EAD for EDIFACT (named “EDIFACT-UNB”). The attributes in the EAD specify the label, type, and so forth for parameters that are displayed in ePM.

Figure 4–9 Default Enveloping Attribute Definitions (EADs) for X12 and EDIFACT

You can also create custom BPADs, either from scratch or by modifying/extending the versions shipped with X12 or HIPAA protocol managers.

To create a BPAD

1. In Enterprise Designer with the Project Explorer tab active, in the project tree, right-click the project or subproject where the BPAD will reside.

2. On the context menu, point to New, and click B2B Business Protocol Attributes Definition.

3. In the properties, enter a name (good practice is to enter a short name beginning with “bpad”, such as bpadCustom1) and click OK.

   The project tree displays the new component.

   This new component is useful only by virtue of its configuration — you need to add name/value pairs for the parameters you want it to define.

To configure a BPAD

1. In Enterprise Designer, with the Project Explorer tab active, right-click the BPAD you want to modify.

   ---

   Note –

   If the component is locked, you must check it out before you can modify it.

   ---

2. To the far right of the value for Envelope Attribute Definitions, click the ellipsis [...] button to display the Envelope Attribute Definitions dialog box.

   See Figure 4–10.

   Figure 4–10 Accessing a BPAD’s Envelope Attribute Definitions (EAD)

   
   

   You use this dialog box to create and set the envelope attribute definitions (EAD) of the current BPAD.

3. Click the Add button as many times as needed (a four-row EAD is illustrated in Figure 4–11) and then, for each row created:

   • Change Name to a meaningful node name for the OTD you will generate.

     • Change Display to the text you want to display as a prompt or label for the parameter in ePM.

     • For Type, select the data type for this attribute:

       • String (the default) allows the ePM user to enter any character data

       • Password accepts any ePM input, and masks the input

       • Integer accepts positive or negative whole numbers only

       • Number extends this to also accept decimal numbers (floating-point numbers)

       • Boolean requires the ePM user to make a yes-or-no choice

       • List of Values presents the ePM user with a drop-down list restricted to the items you have set up

       • DateTime prompts the ePM user to supply a date and/or time value, based on the formatting you provide

     • For Required, select or clear the box according to whether you want the parameter to be a required or optional entry. (In the ePM GUI, parameters that have been designated as required are flagged with a red asterisk.)

     • For Direction, choose ToPartner, FromPartner, or Both according to whether you want the parameter to appear with the ToPartner parameters, FromPartner parameters, or both.

     • For Default, you can optionally enter a default value to appear in ePM before the user enters data or makes a selection. This is the value that is used if it is not overridden by the ePM user.

     • For List of Values, which is available only for an attribute whose data type is “List of Values”, double-click the ellipsis [...] button to the far right and use the List of Values dialog box to add entries to the drop-down list that is seen by the end user:

       • Add appends a new item to the end of the list

       • Edit modifies the currently selected item

       • Up and Down move it higher or lower in the list

     • Format String allows you to use special characters as shorthand for certain often-used information; for example, %f is the working filename, %M is the current month, %d the current day, and so forth. For more information, see the eWay Batch Adapter User’s Guide. The chapter on understanding OTDs has a section on using special characters.

   Figure 4–11 Custom Envelope Attribute Definitions (EAD)

   
   

4. When you have finished adding and modifying envelope attributes, click OK.

5. Repeat the corresponding steps for the business attributes definition (BAD).

6. Click OK to close the properties dialog.

   The BPAD can now be used to generate an OTD.

   After you have completed these steps, the BPAD appears as a choice in the drop-down list of BPADs when you configure the delivery protocols of your B2B Host.

   After you have completed these steps, activation of the B2B Host causes the BPAD parameters (that is, the ones you defined for the EAD and the BAD) to appear in ePM.