Skip to main content

Adding Business Hosts

This topic describes how to add business hosts to a production.

For information on performing these tasks in the legacy UI, see Modifying Business Hosts (Legacy UI).

Introduction

A business host is any business service, business process, or business operation within a production. These are also referred to generically as configuration items.

A configuration item is always associated with a specific production. It may resemble or duplicate items in other productions. Each production is an entirely closed universe that does not use configuration items from other productions.

Configuration Names

By default, the name of a configuration item is the name of its underlying host class. However, you can assign a different name, to describe the purpose of the item, for example.

For example, if you have a business service class that communicates with a specific type of server, and you use it to communicate with the same type of server in different enterprise locations, you must configure the business service with different settings to communicate with each enterprise location, even though the type of server is the same. Each different configuration of the business service must have a different name.

The following rules govern configuration names:

  • The name must consist of at least one character.

  • The name can contain letters, numbers, and any printable character except for the following:

    | ; , : [ < > \ / & "

  • Neither the first nor the last character can be any of the following: ! $ .

  • The first character cannot be _

  • The name (if is it one character long) cannot be *

Important:

You cannot change the name of an existing configuration item. If you require a name change, you can copy the item and delete the original item.

Adding a Business Host to a Production

To add a business host to a production:

  1. Identify (or create and compile) the appropriate business host class.

  2. Open the production on the Interoperability > Configure > Production page.

  3. From the Add item menu, select one of the following:

  4. Continue as described in the following sections.

This process does not generate any new classes. It updates the production class.

Adding a Business Service

To add a business service to a production:

  1. Add a business host, choosing the Inbound Host option.

  2. For Inbound Type option, choose one of the following:

    • General—Use this to create a business service other than the following types.

    • HL7—Use this to create a business service for working with HL7 messages.

    • X12—Use this to create a business service for working with X12 messages.

    • Business Metric—Use this to create a business service for working with business metrics.

  3. Then choose one of the following:

    • (General) Inbound Class—Choose an existing class.

    • (HL7) Input Type—Choose TCP, File, FTP, HTTP, or SOAP, depending on the form of input data.

    • (X12) Input Type—Choose TCP, File, FTP, or SOAP, depending on the form of input data.

  4. Name—Specify a name; see Configuration Names.

  5. (HL7 and X12) Specify values for settings as provided in these reference sections:

  6. (Business Metric) Metric Class—Select the business metric class to use.

  7. (Business Metric) Call Interval—Specify how often the business metric will recalculate the values of its properties. The Call Interval is in seconds, starting from a minimum of 0.1 seconds. The default is 5 seconds.

  8. Display Category—Specify a category name for use in sorting and organizing items within the production. Category names are case-sensitive, and space characters are allowed. To place an item in multiple categories, list them in the Display Category field separated by commas (with no spaces around these commas).

  9. Comment—Specify an optional text description.

  10. Enable Now—Optionally select this to immediately enable the item.

  11. Click Create.

Also see Settings in All Business Services.

Adding a Business Process

To add a business process to a production:

  1. Add a business host, choosing the Process Host option.

  2. For Process Type option, choose one of the following:

    • General—Use this to create a business process other than the following types.

    • HL7—Use this to create a business process for working with HL7 messages.

    • X12—Use this to create a business process for working with X12 messages.

    • Component—Use this to create a business process as a component.

  3. (General or Component) Process Class—Choose a base class from the list of valid business process classes. If the class you need does not appear on this list, create and compile the class and then return here to choose it.

  4. Name—Specify a name; see Configuration Names.

  5. (HL7 or X12) Specify the following details:

    • Auto-Create Rule—Select this check box to create a rule definition name based on the business process class name. When this option is selected, you can use the Rule or Package Name field to specify a package name that will be added to the name of the rule created for the new router. If you do not specify a New Rule Package value, the production’s package is used. In most cases, the Rule or Package Name field is ignored if the Routing Process Name field begins with a package name. However, if the package specified by the Routing Process Name field is the system package name Ens or Enslib, a rule that is auto-created will have a different package name added to the beginning of the rule name. This additional package is determined by the contents of the New Rule Package field. If the package of the production or routing process is used instead of a specified value, the generated rule class name ends with 'RoutingRule'.

  6. Display Category—Specify a category name for use in sorting and organizing items within the production. Category names are case-sensitive, and space characters are allowed. To place an item in multiple categories, list them in the Display Category field separated by commas (with no spaces around these commas).

  7. Comment—Specify an optional text description.

  8. Enable Now—Optionally select this to immediately enable the item.

  9. Click Create.

Also see Settings in All Business Processes.

Adding a Business Operation

To add a business operation to a production:

  1. Add a business host, choosing the Outbound Host option.

  2. For Outbound Type option, choose one of the following:

    • General—Use this to create a business operation other than the following types.

    • HL7—Use this to create a business operation for working with HL7 messages.

    • X12—Use this to create a business operation for working with X12 messages.

    • Workflow—Use this to create a business service for managing workflow.

  3. Then choose one of the following:

    • (General or Workflow) Outbound Class—Choose an existing class.

    • (HL7) Outbound Type—Choose TCP, File, FTP, HTTP, or SOAP, depending on the form of input data.

    • (X12) Outbound Type—Choose TCP, File, FTP, or SOAP, depending on the form of input data.

  4. Name—Specify a name; see Configuration Names.

  5. (HL7 and X12) Specify values for settings as provided in these reference sections:

  6. Display Category—Specify a category name for use in sorting and organizing items within the production. Category names are case-sensitive, and space characters are allowed. To place an item in multiple categories, list them in the Display Category field separated by commas (with no spaces around these commas).

  7. Comment—Specify an optional text description.

  8. Enable Now—Optionally select this to immediately enable the item.

  9. Click Create.

Also see Settings in All Business Operations.

See Also

Modifying Business HostsNext section
Previous sectionCreating a Production
FeedbackOpens in a new tab