Add a component

  1. In the B2Bi user interface, select Processing configuration > Manage components.
  2. The interface displays the Manage components page.
  3. Click Add a component to open the Add a component wizard.
  4. Complete the fields:
    • Name — Enter a name for the component object .
    • Type — From the drop-down list, select the type that corresponds to the object you are adding:
      • Custom delivery – Create Custom Delivery components to provide processing for Application Custom Deliveries.
      • Detector
      • Document
      • Enveloper
      • Map
      • Post detection
      • Post enveloping
      • Post transfer failed
      • Post transfer success
    • Resource filter – Enter a text string to filter the list of resources that are displayed in the Resource field drop-down list. You can use wildcards ( *, ? ).
    • Resource – From the list of available resources, select the resource that provides the functionality for this component. An additional set of tabs and fields are displayed that enable you to control how the component processes a message. These fields vary depending on the component type and may or may not be editable.
    • For a description of the set of default component resources delivered with B2Bi, see Component resources.
    • Copy input message if no output is created – This option is only displayed if the component is not a map and if the resource that is assigned to this component has no outputs. When this option is:
      • Not selectedB2Bi completes processing for the component and performs no additional processing on the message.
      • SelectedB2Bi copies the input message to the output of the component
      • Selecting this option enables B2Bi to continue processing the message (mapping, etc.,). This also enables you to select the desired output format when configuring the component
  5. Complete any additional fields that display after a resource is selected.
  6. On the Connection tab, select the appropriate connection, such as Web Services.
  7. Click Add.
  8. The new component object is added to the list of available components. You can now use the component object in one or more services.
  9. For more information, see Services.

Common resource configuration fields

The following fields are common to most resource types:

Input and output tabs

Filling in the input and output format fields is optional. These fields do not affect the runtime behavior of B2Bi. When you specify the output file format for various components used in a service, and then later configure an outbound agreement on a service output, the display of available agreements is filtered by the final component output format type. This can simplify agreement configuration by reducing the number of agreements displayed for selection.

  • Input format – From the drop-down list, select a format for the message that is input to the component resource.
  • Output format – From the drop-down list, select a format for the message that is output from the component resource.
  • Note: If the component does not produce an output, the output tab is not displayed.

Configuration tab

  • Debug – Optionally set the debug mode. y = debug. n=no debug (default)

Specialized resource configuration fields

Accept documents with errors

By default, the B2Bi integration engine rejects processing on documents that contain errors in the format of the data they contain. However, for the following types of resources, you have an option that enables you to accept and process inbound and produce outbound documents with data format errors:

  • inhouse
  • X12
  • XML

If you select the Accept input document with errors option on the resource Input tab, the B2Bi integration engine modifies the data (by padding, trimming, and so on) to enable document processing to proceed. An appropriate warning message is generated in Mapping Log.

If you select the Accept output document with errors option on the resource Output tab, the B2Bi integration engine performs the same data modification enabling the handling by the integration engine of messages produced (output) by the resource.

To activate this feature:

  1. In the "Add a component" page, select a map to handle an inbound EDIFACT, inhouse, X12 or XML document.
  2. Select the Input tab.
  3. Select the option: Accept input document with errors
  4. Select the Output tab (if the tab is displayed).
  5. Select the option: Accept output document with errors
  6. These options enable B2Bi to consume and produce documents with errors. If you do not select this option, only documents with no errors are processed.
  7. These fields are available when you create and when you modify the component.

Connection selection

Some component resources require a connection to a third-party application or database. If a drop-down field for a connection is displayed, select a connection from the list. Only configured connections are available to select. You must add one or more connections if none are available. For additional information, see Connections.

Add and configure specific B2Bi component resources

When you install B2Bi, the product is installed with a set of component resources that you can use when you add components.

You can view these component resources in the directory [Integrator install directory]\solutions\b2bx\component\.

View the following topics for information about implementing these specific resources:

Related Links