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

XML Adapter

An XML Adapter communicates with an external data source using an XML endpoint over the HTTP protocol.

Configure XML End-point Adapter

To configure a XML service in Integration service definition tab, follow these steps:

  1. In the Name field, provide a unique name for your service.
  2. From the Service Type list, select XML.

    Note: XML is selected, by default.

  3. Provide the following details to create a XML service.
    FieldsDescription
    VersionSpecify the version number for the service.
    Base URLType the URL.
    Web Service Authentication
    Identity Service for Backend Token

    Select the Identity service associated with your app if this service needs backend token like access_token from that Identity service to access the backend server.

  4. Note: All options in the Advanced section are optional.

  5. Enter the Description for the service.
  6. Click SAVE to save your service definition.

Create Operations for XML

The Operations List tab appears only after the service definition is saved.

Note: Click Operations List tab > Configure Operation. The Configured Operations list appears.

To create an operation, follow these steps:

  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.
  1. Type the following fields to create a new operation:
    FieldDescription
    Name

    Type a new name for the operation in the Operation Name box.

    Important: While configuring an integration service with basic auth mode, ensure that some reserved IDs are not used as input (or) header IDs. Key words such as userID and password are reserved by middleware when a user selects basic auth mode.

    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.

    Target URL

    You can select which HTTP method to invoke on the back-end service from integration server.

    The Target URL field is pre-populated with the URL. You can add the suffix, if required.

    http://baseurl.com/suffix

    For Example, to the base URL, you can add suffix such as /latest  or /sports to get latest news or sports news:

    • http://feeds.foxnews.com/foxnews/latest
    • http://feeds.foxnews.com/foxnews/sports
    Target HTTP MethodYou can select which HTTP method to invoke on the back-end service from integration server. Select the required method for the operation from the Target HTTP Method field.
  2. Note: All options in the Advanced section for operations are optional.

  3. Enter the Description for the operation.

Configure Request Operation for XML

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 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. Under the Body tab, perform the following actions:
    1. To forward the body of the client's request to backend as it is, select the Enable pass-through input body check box. For more details on API Proxy service, refer to How to Enable Pass-through Proxy for Operations.

    2. To configure parameters in the clients body, do the following:
      FieldDescription
      NameEnter the name for the request input parameter.
      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.
      ScopeSelect request or session. This field is set to Request, by default.
      DATA TYPEThe default data type for the selected column is loaded under the DATA TYPE field.
      EncodeSelect the checkbox to enable an input parameter to be encoded. For example, the name New York Times would be encoded as New%20York%20Times  when the encoding is set to True. The encoding must also adhere the HTML URL encoding standards.
      DescriptionEnter the description for the Request Input parameter.
  5. Click the Header tab to provide the following custom headers for an operation.

    You must provide the custom HTTP headers based on the operation. For example, post or get.

    Perform the following actions to provide the custom header

    1. To forward headers of the client's request to backend as it is, select the Enable pass-through input header check box. For more details on API Proxy service, refer to How to Enable Pass-through Proxy for Operations.
    2. To configure parameters in the client's header, do the following:
      FieldDescription
      NameProvide custom HTTP headers required by the external source.
      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.

      Note: If the header value is scoped as a Request (or) Session and the same header is accessed under the Expression header value, then the expression must be represented as $request.header (or) $session.header.

      Example: If a header 1 value is a request and header 2 value is an expression, then the value of the expression must be $Request.header1.

      TEST VALUEEnter a value. A test value is used for testing the service.
      DEFAULT VALUEChange the syntax, if required. The default value will be used if the test value is empty.
      DescriptionEnter the description for the header parameter.
  6. You can add pre and post processing logic to services to modify the request inputs. When you test, the services details of various stages are displayed in the service execution for better debugging. You can refer to Test a Service Operation for the steps to test a service.

Configure Response Operation for XML

Click Response Output tab to configure the fields of the table for displaying the data.

Note: If you define parameters inside a record as the session, the session scope will not get reflected for the parameters.

  1. To forward the response from the backend to the client as is, select the Enable pass-through output body check box. For more details on API Proxy service, refer to How to Enable Pass-through Proxy for Operations.
  2. You can configure XPath expressions for extracting the required elements from the back-end response of the service call. So that the extracted output can be sent to the client app. You can create an XPath automaticallyor manually.

    Note: Auto generation of XPath support is available from Kony Fabric V8 SP3 onwards.

    The following table details XPath generation:

    To create XPath automatically (SP4)To create XPath manually
    1. After you click Save and Fetch Response, the Tree view with the back-end response appears by default in the Test > Backend Response pane.
    2. Click or hover your mouse cursor over the node for which you want to create XPath.

      The Create response button appears next to that node.

    3. Click the Create response button.

      A new row is created automatically along with the XPath for the selected node in the Response Output tab.

      Note: The Response Output tab appears if you have clicked the Create response button from Request Input tab.

    1. Click Add Parameter to add new row.
    2. Click the Tree button in the Backend Response tab.

      This displays the backend response in a tree structure format.

    3. Click the node for which you want to create XPath.

      The XPath for that node is displayed at the bottom of the Tree structure.

       

    4. Enter that XPath in the row that you have created.
      
  3. To configure parameters in the response, enter the values for required fields such as name, path, scope, data type, collection ID, record ID, format and format value.

    Important: If the back-end for an XML service provides the date in a specific format and you want send the date in a different format to a device, you can configure the data format and FormatValue ( syntax : inputDateFormat~outputDateFormat) in the response tab.

    For example, if a back-end sends the date as Thu, 07 Sep 2017 07:03:00 GMT and you want convert it to 2017-09-07T07:03:00.000+0000, then set the format value as EEE, dd MMM yyyy HH:mm:ss z~yyyy-MM-dd'T'HH:mm:ss.SSSZ.



    For more details on the syntax of the date formats, referhttps://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html

    Note:  When you enable Pass-through proxy flags, you will notice that you cannot configure request input, headers, and response out parameters for this operation.

  4. To validate the operation details, click Save and Test. For more details, refer to Test a Service Operation.

  5. Click Save Operation to save the changes.

    To use an existing integration service, refer to How to Use an Existing Integration Service.

    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.