Kony Fabric console User Guide: Integration > Configure the Integration Service > IBM MQ Adapter

IBM MQ Adapter

IBM MQ server 9.0.0 version is a messaging middleware that simplifies and accelerates the integration of diverse applications and business data across multiple platforms. It uses message queues to facilitate the exchanges of information and offers a single messaging solution for cloud, mobile, Internet of Things (IoT) and on-premises environments. Kony uses the IBM MQ service to secure the message delivery and reduce the risk of data loss.

Configure IBM MQ End-point Adapter

To configure your IBM MQ Service in the Integration Service Definition tab, follow these steps:

  1. In the Service Name text box, enter a unique name for your service.
  2. From the Service Type list, select IBM MQ.
    By default, XML is selected. If you select IBM MQ, the Connection Parameters section is displayed.
  3. Provide the following details to create an IBM MQ Service:
    FieldsDescription
    Connection Parameters

    If the entered details are correct, the system displays the message: Valid Database connection details.

    Use Existing Identity ProviderSelect IBM MQ identity from the list.
  4. In the Description field, enter the description.
  5. Click SAVE to save your service definition.

Create Operations for IBM MQ Service

  1. Click SAVE & ADD OPERATION in your service definition page to save your service definition and display the NewOperation tab for adding operations.
                        OR
    Click Add Operation to add a new operation or from the tree in the left pane, click Add > Add New Operation.

  2. Select an operation from the drop-down list and click ADD OPERATION.
  3. Click the configured operation and provide the following details to create an operation.
    FieldDescription
    NameThe operation name appears in the Name field. You can modify the name, if required.
    Mapped ToThe operation name to which the configured operation is mapped.
    Operation Security Level

    It specifies how a client must authenticate to invoke this operation.

    Note: The field is set to Authenticated App User, by default.

  4. Click the Advanced tab to configure the preprocessor and postprocessor forJava and JavaScript. For more details, refer to Preprocessor and Postprocessor. You can also configure Server Events from here. For more details, refer Server Events.

    Note: All options in the Advanced section are optional.

Configure Request Operation for IBM MQ

Integration services accept only form-url-encoded inputs for all input parameters provided in service input parameters (request input).

You can perform the following actions in the Request Input tab,

  1. Click Add Parameter  to add an entry (if the entries for input and the output tabs does not exist).
  2. To make duplicate entries, select the check box for the entry, click Copy and Paste.
  3. To delete an entry, select the check box for an entry and click Delete .
  4. Click Show button and enter the message template in the right pane. The message template is used to send a message to IBM MQ server.

  5. Add the template parameters as request parameters in the Request Input tab.

    Note: Enter Queue and Transacted in the request parameters.

    - Queue parameter is used to change queue in the queue manager at run time.
    - Transacted parameter accepts Trueor False to set JMS message to be in the transacted session scope or not.

  6. Provide the following details in the request input parameters tab:
    FieldDescription
    NameEnter a unique identifier for the request input parameter. Change the identifier, if required.
    Value

    Three different options are available in Kony Fabric under VALUE during configuration of any operation. When you start editing this field, dependent identity services are auto populated. These options primarily determine the source of the value of the header.

    Note: The field is set to Request, by default.

    TEST VALUEEnter a value. A test value is used for testing the service.
    DEFAULT VALUEEnter the value, if required. The default value will be used if the test value is empty.
    DATA TYPE
    Record IDEnter the record ID.
    Collection IDEnter the collection ID.
  7. Enter the description for the Request Input.
  8. You can test a MQ service operation from Kony Fabric. You can refer to Test a Service Operation for the steps to test a service.

Configure Response Operation for IBM MQ

Click the Response Output tab, and the values in the required fields such as name, scope, path, data type, collection ID, record ID, and description are automatically populated.

The following JMS service output parameters are auto-populated, by default.

You can delete the default parameters and add the custom parameters and XML path or JSON path to receive the response from IBM MQ server.

Click SAVE OPERATION to save the operation. The system updates the operation definition.

If you click Cancel, the Edit Operation tab closes without saving any information.

Note: You can view the service in the Data Panel feature of Kony Visualizer. By using the Data Panel, you can link back-end data services to your application UI elements seamlessly with low-code to no code. For more information on Data Panel, click here.

 

Copyright © 2020 Kony, Inc. All rights reserved.