Creating message listeners

Before creating a listener you must have Inbox tables available in the database where the documents must be received. The inbox tables are the same as for an application connection point. When you are creating a listener to replace an application connection point, you can use the existing tables.

To create a new listener:

  1. Create the Inbox tables when they are not available yet.
    For the procedure see the Infor ION Development Guide. Note that this will also create the Outbox tables, however the outbox tables are not used by the listener.
  2. In ION Desk select Connect > Message Listeners.
    A list of existing listeners is displayed.
  3. Click New.
    The Listen details page is displayed.
  4. Specify the general properties for the listener.
    Name

    Specify a unique name for the listener.

    The name can contain:

    • Characters ranging from a-z or A-Z
    • Characters ranging from 0-9
    • Underscor (_)

    Based on the name, a logical ID is created for the listener.

    Description
    Optionally, specify a description for the listener.
    Tenant
    Leave blank when using the default tenant. Otherwise select the checkbox and specify the tenant to which the listener belongs.
  5. On the Connection tab, specify the connection to the database that holds the Inbox where the documents must be delivered.
    Property Description
    Database: Select one of these configurations for the database address:
    • Basic - specify properties for the database. The properties to be specified depend on the selected Database Type. The URL to connect to the database will be built automatically.
    • Advanced - specify the URL to connect to the database. Use this if you need to use advanced settings that are not shown when selecting Basic.
    Hostname Specify the host name of the server that hosts the database. This field is only enabled if the Basic checkbox is selected.
    Port Number Specify the number of the port that must be used to connect to the database. This field is only enabled if the Basic checkbox is selected.
    Schema Name Specify the name of the database schema to be used. This field is only enabled if the Basic checkbox is selected and the Database Type is SQL Server, Oracle DB2 or DB2/400.
    SID Specify the name of the Oracle schema ID to be used. This field is only enabled if the Basic checkbox is selected and the Database Type is Oracle
    URL Specify the URL of the database that contains the Inbox and Outbox tables. The URL is dependent of the database driver. See the supported database drivers table in Infor application properties.

    If you selected the Basic configuration for the database address, the URL is read-only.

    User Name Specify the user name to connect to the database. Note: when using SQL Server with Windows authentication, specify a valid Windows domain username instead of a SQL Server user name.
    Password: Specify the password to connect to the database.
  6. On the Documents tab, select the verbs. After activation, any document having one of the selected verbs is delivered to the listener.
  7. Save the listener and click Back to return to the list.