1. Routing Hub Configuration User Guide
  2. Service Consumers

2 Service Consumers

This topic describes the systematic instructions to configure the service consumers.

Service Consumer is an Oracle banking product which invokes Oracle Banking Routing Hub API for integration. Oracle Banking Routing Hub analysis, evaluate destination product processor and transform data into format as required by the destination product processor for service a request type
Specify User ID and Password, and login to Home screen.
  1. On Home screen, clickCore Maintenance. Under Core Maintenance, click Routing Hub.
  2. Under Routing Hub, click Service Consumers.
    The Service Consumers screen displays.

    Figure 2-1 Service Consumers


    Description of Figure 2-1 follows
    Description of "Figure 2-1 Service Consumers"

Add Service Consumer

In addition to importing Service Consumers, users can create Service Consumers manually using Add option..

  1. Click Add.
    The Add Service Consumer screen displays.

    Figure 2-2 Add Service Consumer


    Description of Figure 2-2 follows
    Description of "Figure 2-2 Add Service Consumer"

  2. Specify the fields on Add Service Consumer screen.

    Note:

    The fields marked as Required are mandatory.

    For more information on fields, refer to the field description table.

    Table 2-1 Add Service Consumer - Field Description

    Field Description
    Name Specify the unique service consumer name.

    Note:

    • Enter 0 to maximum of 255 characters.
    • No numeric value at beginning and no space allowed.
    Audit Type Select the Audit type from the dropdownlist.
    The available options are:
    • All Requests - All requests are logged in the OBRH and can be viewed later for debugging.
    • Service level configuration - Option has been provided at consumer services for enabling audit of requests for specific Consumer Services. Audit type should be configured as “Service level configuration” and audit option at “Consumer Services” should be selected for Consumer Services which need to be audited. Monitoring dashboard does not provide the data for requests which are not being audited.
    • None - Disables the audit completely. Audit logs cannot be reviewed later and monitoring dashboard does not provide the data
    Add To add, refer to step 5.

    Select the group from the drop-down list.

    The available options are:
    • Group
    • Variable
    Group Select the group from the drop-down list.
    Action Displays the action.

    The user can edit or delete the header.
    Name Displays the name of the header.
    Value Displays the value of the header.

Environment Variables

The user must define the group of variables which can be accessed throughout the specific consumer’s configuration. The syntax for accessing environment variables is below: $env.Environment_Group_Name.Environment_Variable_Name

For example, $env.COMMON.BRANCH_CODE

  1. To add Environment Variables, follow the below steps.
    1. Click Add on the Add Service Consumers screen, and select Group from drop-down list to add the group.
      The Add Environment Group screen displays.

      Figure 2-3 Add Environment Group


      Description of Figure 2-3 follows
      Description of "Figure 2-3 Add Environment Group"

    2. Specify the fields on Add Environment Group screen and click OK.

      Note:

      The fields marked as Required are mandatory.

      For more information on fields, refer to the field description table.

      Table 2-2 Add Environment Group - Field Description

      Field Description
      Name Specify the name of the environment group.

      Note:

      • Enter 0 to maximum of 255 characters.
      • No numeric value at beginning and no space allowed.
    3. Click Add on Add Service Consumer screen and select Variable from drop-down list to add the variable.
      The Add Environment Variable screen displays.

      Figure 2-4 Add Environment Variable


      Description of Figure 2-4 follows
      Description of "Figure 2-4 Add Environment Variable"

    4. Specify the fields on Add Environment Variable screen and click OK.

      Note:

      The fields marked as Required are mandatory.

      For more information on fields, refer to the field description table.

      Table 2-3 Add Environment Variable - Field Description

      Field Description
      Name Specify the name of the environment variable.

      Note:

      • Enter 0 to maximum of 255 characters.
      • No numeric value at beginning and no space allowed.
      Value Specify the value of the environment variable.

      The value can either be hardcoded or Velocity mapping.
  2. Click Save to save the details.
    The Confirmation screen displays.

    Figure 2-5 Confirmation - Add Service Consumers


    Description of Figure 2-5 follows
    Description of "Figure 2-5 Confirmation - Add Service Consumers"

  3. Click Confirm to save the record.

Import Service Consumer

The user can create a service consumer by importing the JSON file and manually selecting the service providers or select all providers that needs to be imported. The user can also import zip file in order to import all the configuration JSON files together.

  1. Click Import.
    The Import Service Consumer screen displays.

    Figure 2-6 Import Service Consumer


    Description of Figure 2-6 follows
    Description of "Figure 2-6 Import Service Consumer"

  2. Specify the fields on Import Service Consumer screen.

    Note:

    The fields marked as Required are mandatory.

    For more information on fields, refer to the field description table.

    Table 2-4 Import Service Consumer - Field Description

    Field Description
    File Select the file using Select.

    Note:

    Allows only to select one file and accepts JSON and ZIP file.
    Extract Extracts the consumer name and service provider list from JSON file only and displays it in the respective elements.
    Name Specify the name of the service provider.

    Note:

    • Name cannot be blank and required only for JSON file.
    • Enter 0 to maximum of 255 characters.
    • No numeric value at beginning and no space allowed.
    Overwrite extended templates Select the respective radio button to overwrite the extended templates.
    The available options are:
    • Yes - This option overwrites the extended templates.
    • No - This option retains the existing extended templates.
    Overwrite environment variables Select the respective radio button to indicate whether environment variables (JSON file) should overwrite existing environment variables or not
    The available options are:
    • Yes - This option overwrites the environment variables.
    • No - This option retains the existing environment variables.
    Service Providers Displays the service provider details.
    Name Displays the list of service providers names that are present in JSON file only.
  3. Click Import to import the selected service consumer file.
    The Confirmation screen displays.

    Figure 2-7 Confirmation - Import Service Consumer


    Description of Figure 2-7 follows
    Description of "Figure 2-7 Confirmation - Import Service Consumer"

  4. Click Confirm to import the file.

    Note:

    Below data needs to be changed after importing provider configuration file:
    • Implementation Host and Port
    • Implementation Authentication Password

View Service Consumer

The user can view consumer details and can also switch to edit form by clicking on edit icon.

The user can also export and import only for the environment variables.

  1. On the Service Consumer tile, click Three dots, and select View from the dropdown list.
    The View Service Consumer screen displays.

    Figure 2-8 View Service Consumer


    Description of Figure 2-8 follows
    Description of "Figure 2-8 View Service Consumer"

  2. Click Edit icon to edit the Service Consumer.

Edit Service Consumer

The user can modify the consumer details.

  1. On the Service Consumer tile, click Operation Menu (3 dot icon), and select Edit from the dropdown list.
    The Edit Service Consumer screen displays.

    Figure 2-9 Edit Service Consumer


    Description of Figure 2-9 follows
    Description of "Figure 2-9 Edit Service Consumer"

  2. Click Save to save the modified consumer details.
    The Confirmation screen displays.

    Figure 2-10 Confirmation - Edit Service Consumer


    Description of Figure 2-10 follows
    Description of "Figure 2-10 Confirmation - Edit Service Consumer"

  3. Click Confirm.

Delete Service Consumer

The user can delete the Service Consumer.

  1. On the Service Consumer tile, click Operation Menu (3 dot icon), and select Delete from the dropdown list.
    The Confirmation screen displays.

    Figure 2-11 Confirmation - Delete


    Description of Figure 2-11 follows
    Description of "Figure 2-11 Confirmation - Delete"

  2. Click Confirm to delete the service consumer.

JSON Export

User can export the consumer configuration as JSON file. The option for Export is provided to move the configurations from one environment to another.

  1. On Service Consumer tile, click Operation Menu (3 dot icon).
  2. On Export option, select JSON from the list.
    The Export Service Consumer screen displays.

    Figure 2-12 Export Service Consumer


    Description of Figure 2-12 follows
    Description of "Figure 2-12 Export Service Consumer"

    Note:

    • The user has an option to select the service providers from the list which needs to be exported or can click on select all for all service providers.
    • The JSON Export feature exports below data:
      • Selected service consumer
      • All consumer services
      • Selected service providers with services
      • All implementations of selected service providers with services (without Host, Port and Authentication Password)
      • All transformations
      • All routes
  3. Select the required service providers and click Export.
    The Confirmation screen displays.

    Figure 2-13 Confirmation - JSON Export


    Description of Figure 2-13 follows
    Description of "Figure 2-13 Confirmation - JSON Export"

  4. Click Confirm to export the service consumer in JSON file.

SQL Export

The user can export the consumer configuration as SQL file.

  1. On Service Consumer tile, click Operation Menu (3 dot icon).
  2. On Export option, select SQL from the list.
    The Confirmation screen displays.

    Figure 2-14 Confirmation


    Description of Figure 2-14 follows
    Description of "Figure 2-14 Confirmation"

    Note:

    The SQL Export feature exports entire configuration without Host, Port, and Authentication Password details.
  3. Click Confirm to export the consumer configuration as SQL file.

Configuration

  1. On Service Consumer tile, click Operation Menu (3 dot icon), and click Configuration.
    The Configuration screen displays.

    Note:

    Refer to Configuration topic for the screen and field description.

Request Audit

  1. On Service Consumer tile, click Operation Menu (3 dot icon), and click Request Audit.
    The Request Audit screen displays.

    Note:

    Refer to Request Audit topic for the screen and field description.