Previous Next JavaScript must be enabled to correctly display this content

## 2 Service Consumers

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

This option enables set up of Service Consumer. Service Consumer is an Oracle banking product which invokes Oracle Banking Routing Hub API for integration. Oracle Banking Routing Hub analyses, evaluate destination product processor and transform data into format as required by the destination product processor for service a request type.

Service Consumer comprises of the source and destination integration details.

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 Service Consumers"

Add Service Consumer

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

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

   Figure 2-2 Add Service Consumer

   Description of "Figure 2-2 Add Service Consumer"
4. Specify the fields on Add Service Consumer screen.

   Note:

   The fields, which are marked with an asterisk, 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 dropdown list. 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

5. 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 Add Environment Group"
   2. Specify the fields on Add Environment Group screen and click OK.

      Note:

      The fields, which are marked with an asterisk, 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 Add Environment Variable"
   4. Specify the fields on Add Environment Variable screen and click OK.

      Note:

      The fields which are marked with asterisk are mandatory.
      For more information on fields, refer to the field description table below.

      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.

6. Click Save to save the details.
   The Confirmation screen displays.

   Figure 2-5 Confirmation - Add Service Consumers

   Description of "Figure 2-5 Confirmation - Add Service Consumers"
7. 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.

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

   Figure 2-6 Import Service Consumer

   Description of "Figure 2-6 Import Service Consumer"
9. Specify the fields on Import Service Consumer screen.

   Note:

   The fields, which are marked with an asterisk, 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.
   Service Providers | Displays the service provider details.
   Name | Displays the list of service providers names that are present in JSON file only.

10. 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 Confirmation - Import Service Consumer"
11. 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.

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

    Figure 2-8 View Service Consumer

    Description of "Figure 2-8 View Service Consumer"
13. Click Edit button to edit the Service Consumer.

Edit Service Consumer

The user can modify the consumer details.

14. 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 Edit Service Consumer"
15. Click Save to save the modified consumer details.
    The Confirmation screen displays.

    Figure 2-10 Confirmation - Edit Service Consumer

    Description of "Figure 2-10 Confirmation - Edit Service Consumer"
16. Click Confirm.

Delete Service Consumer

The user can delete the Service Consumer.

17. 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 Confirmation - Delete"
18. 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.

19. On Service Consumer tile, click Operation Menu (3 dot icon).
20. 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 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
21. Select the required service providers and click Export.
    The Confirmation screen displays.

    Figure 2-13 Confirmation - JSON Export

    Description of "Figure 2-13 Confirmation - JSON Export"
22. Click Confirm to export the service consumer in JSON file.

SQL Export

The user can export the consumer configuration as SQL file.

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

    Figure 2-14 Confirmation

    Description of "Figure 2-14 Confirmation"

    Note:

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

Configuration

26. 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

27. 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.