Messaging configuration
The Messaging configuration in the Configuration Editor is used to configure messaging for Infor Public Sector. This includes enabling or disabling messaging, configuring messaging processes in the Batch Manager, and indicating which import and export mapping files are to be used for specific types of messages.
The Messaging configuration has a root node with four children: , , , and .
The root node can have these attributes:
| Attribute | Description |
|---|---|
| Accounting Entity ID | Accounting entity ID of this application. The accounting entity attribute contains the ID of an accounting entity within the tenant that is the source of the document being produced. Accounting entity information is communicated using the AccountingEntity noun. The maximum length of an accounting entity's ID is 22 characters. |
| Default Mapper Type | Default mapper for all mappings. Can be overridden for individual mappings. The mapper is responsible for mapping message data to or from a business object. |
| Enable Mapping Configuration Validation | Enables mapping configuration validation. This is disabled by default for performance reasons. Enabling this will cause each message to go through validation for its mapping process. |
| Location ID | Location ID of this application. |
| Logical ID | Logical ID of this application. This must be unique among all applications registered with ION Connect and must match what was entered in the ION Connect configuration. Required. |
| Messaging Enabled | Set to True to enable messaging for this instance of Infor Public Sector, or False to disable messaging. This supersedes all other mapping configurations, and will disable all mappings if False. Required. |
| Queuing Enabled | True to enable the queuing of components or False to disable it. If enabled, this helps to improve runtime performance by not processing components as soon as they are received. Instead, they will be queued for processing at a later time as determined by the polling process. |
| Revision ID | Revision ID of this application. |
| Tenant ID | The tenant ID identifies the message as belonging to a specific tenant. A tenant is a hosting or software as a service (SaaS) concept where the data of one tenant is kept separate from the data of all other tenants. Required. |
| Variation ID | Variation ID of this application. |
Inbound Processing
The node stores default settings for the inbound messaging process. This node has a child node that defines one or more handlers for inbound messages.
The node can have these attributes:
| Attribute | Description |
|---|---|
| Batch Size | Maximum number of messages that will be processed in one batch per business object type. |
| Default Processing Manager Type | Moniker of the default manager to use for inbound message processing. Required. |
| Mapping Root | Root directory for the inbound mapping files. Can be relative. |
| Poller Type | Moniker of the poller to use for inbound polling. Required. |
| Polling Frequency | Frequency in seconds at which the poller checks for pending messages. |
Outbound Processing
The node stores default settings for the outbound messaging process. This node has a child node that defines one or more handlers for outbound messages.
The node can have these attributes:
| Attribute | Description |
|---|---|
| Batch Size | Maximum number of messages that will be processed in each outbound batch. |
| Default Processing Manager Type | Moniker of the default manager to use for outbound message processing. Required. |
| Mapping Root | Root directory for the outbound mapping files. Can be relative. |
| Poller Type | Moniker of the poller to use for outbound polling (if supported). |
| Polling Frequency | Frequency in seconds at which the poller is invoked to process outbound messages. If set to 0 then polling is disabled. |
Handlers
The node is a child of both the node and the node. It has one or more nodes as children. A handler is a piece of code that determines how a message is to be processed.
Each node can have these attributes:
| Attribute | Description |
|---|---|
| Description | Description of the message handler. |
| Handler Type Moniker | Moniker of the message handler. |
| Priority | Order in which the handler will be evaluated. More specific handlers should have higher priorities than more general handlers. |
Listeners
The node has one or more nodes as children. A listener is a piece of code that responds to a specified event in the messaging process. For example, the messaging service includes a default listener that sends an acknowledgment when a message is imported.
Each node can have these attributes:
| Attribute | Description |
|---|---|
| Description | Description of the listener. |
| Listener Type Moniker | Moniker of the listener. |
Mappings
The node has no attributes of its own. This node server as the parent for a collection of nodes, each of which contains a mapping for a specific Infor Public Sector business object. Each node can have up to three children: , , and .
Each node can have these attributes:
| Attribute | Description |
|---|---|
| Business Object Moniker | Moniker of the business object for which the mapping is defined. Required. |
| Description | An optional description providing detailed information on the mapping. |
| Mapper Type | Overrides the default mapper for this mapping. Defines the moniker of the object which implements IMapper. |
| Noun | Noun used to represent the business object. Required. |
| Verb | Verb used for this mapping, indicating the action to be performed. Required. |
Inbound node
If a mapping is to be used for inbound messaging, the node will have one node as a child.
The node can have these attributes:
| Attribute | Description |
|---|---|
| Automatic Polling Enabled | Used to enable or disable inbound processing for this mapping. |
| Mapping File | Relative path to the mapping file for this mapping. The path is relative to the mapping root defined in the node. |
| Processing Manager Type | Moniker of the IProcessingManager to use for inbound message processing. |
| Processor Extension Type | Moniker for the IProcessorExtension implementation to use for this inbound mapping. |
Outbound
If a mapping is to be used for outbound messaging, the node will have one node as a child.
The node can have these attributes:
| Attribute | Description |
|---|---|
| Automatic Messaging Enabled | Used to enable or disable outbound processing for this mapping. |
| Automatic Polling Enabled | Used to enable or disable outbound processing for this mapping from the outbound queue. You can disable automatic polling if you want to process all queued messages simultaneously each day. If polling is enabled, the Batch Manager will process the messages in the queue at the specified polling interval. If disabled, you can set up a separate Formula task to process the messages in the queue. For example, you may want to process all queued messages simultaneously each night, rather than processing them at intervals throughout the day. |
| Default Priority | Default priority to assign when sending messages of this type. Valid values are between 0 and 9. |
| Mapping File | Relative path to the mapping file (BOD) for this mapping. The path is relative to the mapping root defined in the node. |
| Processing Manager Type | Moniker of the IProcessingManager to use for outbound message processing. |
| Processor Extension Type | Moniker for the IProcessorExtension implementation to use for this outbound mapping. |
| Queuing Enabled | Used to enable or disable component queuing for an individual mapping. Overrides the Queuing Enabled attribute of the root node. |
| To Logical ID | ION Connect logical ID to which messages should be routed. [Null] means ION will decide. |
Formatters
Each node can have an optional node as a child. The node defines data and field formatters for the mapping. A formatter is a piece of code that manipulates imported or exported data, either before or after it is mapped. Field formatters apply to specific fields in the message, and data formatters apply to the message as a whole.
The node can have these attributes:
| Attribute | Description |
|---|---|
| Clear Default Formatters | Set to True to clear the default formatters for the parent mapping. |
| Data Formatter Type | Defines the data formatter moniker for this mapping |
| Field Formatter Type | Defines the field formatter moniker for this mapping |