Configuring your application for IMS and the Data Lake

To configure your application to send data using ION Messaging Service (IMS) messages:

  1. On the Intranets form, specify this information:
    Intranet
    Specify a descriptive name, for example IMS-DataLake.
    Description
    Indicate that this intranet is used for IMS and Data Lake messaging.
    External
    Select this check box.
    Transport
    Select ESB.
    ION Transfer Type
    Select ION Messaging.
    Data Catalog URL
    Specify the URL for direct connection to the Data Lake Catalog or other data repository, when sending table schema information directly to the Data Lake.

    For example: https://<server>/<tenant>/IONSERVICES/datacatalog

    where:

    • <server> is the name of the server on which the data repository resides.
    • <tenant> is the Tenant ID of your application.

    You must also have this information available:

    • The Logical ID (LID), for example lid://infor.mg.site
    • The OAUTH consumer and secret keys

    For an on-premises or single tenant environment, contact your Infor support representative to get the Data Lake URL and the IMS URL.

    URL
    Specify the URL to use IMS connections to ION.

    For example, https://<server>/<tenant>/IONSERVICES/api/ion/messaging/service

    For IMS messaging and Data Lake connections, this is the destination to which information is to be sent.

    Tenant ID
    Specify the tenant ID.

    This ID is used in all BODs and messages to identify the sender of the document. This ID is used primarily for transactions on hosted software or Software as a Service (SaaS).

    In a cloud environment, the tenant ID is automatically provided, and you cannot change it.

  2. On the Sites form, perform these steps:
    1. Specify this information:
      Site
      Specify a concise name of eight letters or less, for example: DATALAKE or IMS-DL

      This name is used internally by the system.

      Site Name
      Specify a more descriptive name for the site.
      Description
      Specify a description for the site, for example: IMS-Data Lake virtual site
    2. On the System Info tab, specify this information:
      Language
      From the drop-down list, select the language to be used on the site.
      System Type
      Leave this field blank.
      Time Zone
      From the drop-down list, select UTC.
      Intranet Name
      From the drop-down list, select the intranet that you defined in Step 1.
      Tenant ID
      Provide the Tenant ID for your application, as specified on the Sites form.
  3. On the Replication Categories form, create a Data Lake category that holds the tables that tobe replicated to the Data Lake.
    1. Specify this information:
      Category
      Specify DataLake.
      Replication Transfer Type
      Select Data Lake.
    2. In the Table or Function grid, specify the tables to include in the category.
    3. Click Save.
    4. Set the Interval Type to Immediate.
  4. On the Replication Management form, click Regenerate Replication Triggers.
    Whenever a table listed in the replication category is updated, the replication functions send a message that contains the table update to the IMS URL that was defined for the IMS or Data Lake intranet.
  5. On the Replication Rules form, specify this information:
    Source Site
    Select the site from which the data is to be sent.
    Target Site
    Select the site or the destination to which the data is to be sent.
    Category
    Select DataLake.
    Description
    Optionally, provide an internally used description such as Data Lake.
    Interval Type
    Select Immediate.
    Disable Replication
    Clear this check box.
    Update All Columns
    Clear this check box.