Configuring Back Office Extension Integration
You must complete these tasks to configure the Back Office Extension integration.
The system administrator and users with the appropriate role can access these features. See What are Roles and Secured Actions?
To configure:
-
Run the conversion utility provided for the selected version of
Infor CRM SLX.
Note: These options are not mandatory, are optional but have significant ramifications and must be enabled based on implementation-specific recommendations from the integrator or the Infor CRM SLX support team.
- Master Data Consolidation
- Isolate integrated content by logical ID
- Sign in as the administrator.
- Select Integrations from Administration or Integrations on the navigation bar. The Integrations list view is displayed.
- Select Back Office Extension in the Integrations list view. See Using the Integrations list view.
-
View this information:
Field Description/Action Integration Back Office Extension The name of the integration.
Version The version of the integration. Sync Method ION Indicates the process in which information is synchronized between the integrated application and Infor CRM SLX.
Authentication Type Basic The method for authenticating data.
Note: The integration can fail, if the authentication type is changed.Link Type System The type of link used to synchronize data with the integrated application and Infor CRM SLX.
Note: The data is managed through a single link.Enabled Use this option to enable or disable synchronization process for the integration. Note: When enabled, this option synchronizes data with the integrated application and Infor CRM SLX. This makes all the subsequent synchronization options available. -
Verify that the Enabled check box is
selected.
Note: You must clear the Enabled check box, to turn off synchronization.
- Click Save.
-
Click the Reset Inbox Status option
(if required) to reset the status of BODs that are yet to be processed due to a
disruption in the synchronization process.
Note: The Reset Inbox Status option is used for troubleshooting purpose. It is not recommended to reset the Inbox unless directed otherwise. Resetting the inbox status inappropriately can result in reprocessing of BODs.
-
Click the Options tab
to specify the required data.
- Select the Tenant row, click the Value column. Specify the implementation specific Infor LTR Tenant ID provided by your integrator or Infor CRM SLX support team.
- Select the Logical ID row, click the Value column. Specify the Infor CRM SLX Logical ID defined in the Infor LTR based ION Desk Connection Point editor.
- Infor CRM SLX recommends leaving the remaining items as the default
values, but the items can be edited:
- Contact Account Management Enabled
- This custom setting instructs the inbound processor to cascade changes to the account's account manager to the account's related contacts when the value is set to True.
- Success Message Expiration (in minutes)
- The number of minutes after which success messages are purged from the log. The default setting is 4320. A value of -1 means that success messages are not purged from the log.
- Error Message Expiration (in minutes)
- The number of minutes after which error messages are purged from the log. The default setting is -1 which means that error messages are not purged from the log.
- Local CRM Pricing Quote
- Indicate if local CRM pricing is allowed for quotes. By default, this value is set to False.
- Local CRM Pricing Opportunity
- Indicate if the local CRM pricing is allowed for opportunities. The By default, this value is set to True.
- Local CRM Pricing Sales Order
- Indicate if local CRM pricing is allowed for sales orders. By default, this value is set to False.
- Log Success Messages
- Indicate if the log can include successful transactions. To exclude successful transactions from the log, click the Value column and type False. Setting this option to False reduces the items that are displayed for each record on the Sync History tab.
- Inbound Process List Size
- The number of BODs to be processed by a single job service thread. The default value is 10.
- Inbox Message Fetch Size
- The maximum number of BODs processed at any given time. The default value is 1000.
- Out of Sequence Message Expiration (in hours)
- The length of time for which missing relationship information is stored in a log file. When BODs arrive out of sequence and have missing dependent data, the system stores the missing relationships in a log. The default value is 24 hours.
- Acknowledge Message Timeout (in minutes)
- The maximum delay for Infor CRM SLX back office to respond to the Process BOD request with the Acknowledge response. The default value is 10.
- Associate Roles to Unsynced Account
- The option to restrict the generation of new Ship to or Bill to records until after the associated account is successfully promoted. By default, this value is set to False. When set to True, Ship to or Bill to records can be created for an account, that has not yet been promoted.
- Inbound Poling Interval (in seconds)
- The time duration (in seconds) between inbound sync jobs. The duration is defined as the time period between the completion of one inbound sync job and the start of the next inbound sync job. The default value is 15.
- Outbound Poling Interval (in seconds)
- The time duration (in seconds) between outbound sync jobs. The duration is defined as the time period between the completion of one outbound sync job and the start of the next outbound sync job. The default value is 15.
- Default Quote Duration (in days)
- The default time duration (in days) between the start date and expiration date when creating a quote, if the expiration date is not specified.
- Numeric Culture
- The Culture setting used by the Job Server when parsing numeric content saved in BODs. Although this field is editable, you must not modify the default setting (en-US) unless instructed to do so by Infor CRM SLX Support Personnel.
- Prepend Code to Description for Picklist
- This option is used by host applications for publishing the SyncCodeDefinition BODs at the Accounting Entity level. By default the value is set to False. If the integrated host ERP application publishes unique integrated picklist items at the Accounting Entity level, set this value to True.
- Normalize Base Currency Values
- The value can be set to True to enable inbound BOD handling to use the CRM based exchange rates. This normalizes the base currency values published by the host system in a currency other than the Infor CRM SLX base currency.
- Block Quote For Promoted Records
- The value can be set to True to prevent the promotion of updated quote content for host applications. For example, CSD does not support the promotion of updated CRM quote content.
- Block Quote For Non-Promoted Records
- The value can be set to True to prevent the promotion of new quotes for host applications. For example, CSD does not support the promotion of CRM quote content.
- Block Sales Order For Promoted Records
- The value can be set to True to prevent the promotion of modified sales order content for host applications. For example, CSD does not support the promotion of updated Infor CRM SLX Sales Orders.
- Block Sales Order For Non-Promoted Records
- The value can be set to True to prevent the promotion of new sales orders for host applications. For example, CSD does not support the promotion of CRM sales order content.
- Read Only Quote On Promotion
- The value can be set to True to prevent the modification of quotes for host applications. For example, CSD does not support the promotion of updated CRM Quote content.
- Read Only Sales Order On Promotion
- The value can be set to True prevents the modification of promoted sales order content for host applications. For example, CSD does not support the promotion of updated CRM Sales Order content.
- Publish All Addresses
- This value can be set to True to integrate primary and alternate addresses with the host ERP application. This custom setting enables the outbound processor to publish multiple addresses. By default, the value is set to False.
- Freight Reason Code
- This is the implementation-specific distributed charge freight reason code. (For CSD it corresponds to the CSD-based CRM Freight Addon reason code. For CSI a value of Freight is required.
- Display snapshot shipping summary
- The value can be set to True to view Shipping information in the Sales Order snapshot. By default, the value is set to False. (Supported by both CSD, and CSI.)
- Include ERP Freight Rates
- The value can be set to False to disable the CSD Freight Rate Shopping functionality for Infor CRM SLX based Sales Orders. By default the value is set to True.
- Maximum IOBOX Update Batch Size
- The limit on the number of Inbox records can be updated in a single SQL update statement when changing the status of the pending BOD records. By default the value is set to 1000.
- Sync max percentage of threads to consume in decimal format
- The portion (as a decimal) of 10 worker threads that can be used for inbound BOD processing. By default the value is set to 0.8.
- Sync max thread load governor in KBytes
- The maximum BOD content size (in kilobytes) that each inbound worker thread can process. By default the value is set to 40960 (40 MB in KB).
- Sync reload low water factor in decimal format
-
The value indicates if the inbound processor can add more prioritized BODs to the in-process queue and sets the maximum fraction (as a decimal) of the “Inbox Message Fetch Size” that can remain in the queue before reloading with the next batch of prioritized BODs. By default the value is set to 0.2.
- Sync delay between worker threads in seconds
- The setting defines the delay time (in seconds) between the start of each inbound processing thread. By default the value is set to 5 seconds.
- Include CRM Products
- The value is set to True to include non-integrated (CRM) products in the Quote and Sales Order Product lookup. By default the value is set to False. If the integrated host ERP application can process CRM products as write-in products, set this value to True.
- Master Data Consolidation
- The Master Data Consolidation feature is an optional capability that combines
data published across multiple Accounting Entities that
reference a common ERP Customer ID or Contact ID. This
consolidation results in unified Accounts and Contacts that
reference transactions from all active Accounting Entities,
providing a comprehensive, consolidated view.
Modifying the option setting manually is not recommended as that is not compressing or adjusting any pre existing data content. To properly enable the optional Master Data Consolidation feature, the Conversion Utility must be used to ensure that all necessary data transformations and consolidations occur correctly.
- Integrated Primary Contact indicator
- The Primary contact indicator is not displayed on the Contact details page, when the value is set to True. Instead, the new primary contact flag displayed on the Contact, Account Associations or Account, Contact Associations tab. Changes to the integrated primary contact must be made on the Account, Contacts Associations tab grid.
- Type of Order Location
- The Quote and Sales Order location lookup filter criteria for the selection of
the transaction's integrated location value. Type
Office,
Warehouse or
Site to indicate the type of
location required by the host ERP system. To hide the Quote
and Sales Order location lookup controls, the field value
must be blank. The type of Order location by ERP:
- SX: Warehouse
- LN: Office, Site or Warehouse
- M3: Warehouse
- CSI: Warehouse
- Visual: Site
- Price Overrides enabled
- The value is set to True to allow authorized users to
override the unit price on quotes or sales orders. These
host ERP systems support integrated Infor CRM SLX Sales
Order price overrides:
- Infor Syteline
- Infor CloudSuite Industrial
- Infor Distribution SX.e
- Infor LN
- Infor M3
Note: Infor CRM SLX supports price overrides for quote-based unit pricing. However, promoting quotes containing Infor CRM SLX-based price overrides is not supported. - Price Adjustments enabled
- The value is set to True to allow authorized users to
apply price adjustments to unit pricing on quotes or sales
orders. These host ERP systems support integrated Infor CRM
SLX Sales Order containing price adjustments:
- Infor Syteline
- Infor CloudSuite Industrial
- Infor LN
Note: Infor CRM SLX supports price adjustments for Quote-based unit pricing. However, promoting Quotes containing CRM SLX-based price adjustments is not supported. - CRM Price Override Reason Code
- The implementation-specific line-level Distributed
Charge Reason Code, published for the combined ERP and Infor
CRM SLX-based price adjustment percentage. Possible
scenarios:
- SyteLine or CSI integrations: The Data Value field must be blank.
- LN integrations: Set the Data Value to the implementation-specific line-level Distributed Charge Reason Code, published for the summary CRM-based SalesOrderLine/DistributedCharge Bod element.
Note: For assistance defining this unique Distributed Charge Reason Code, check with the LN administrator or integrator. - ERP Price Override Reason Code
- The implementation-specific line-level Distributed
Charge Reason Code, published for the combined ERP and Infor
CRM SLX-based price adjustment percentage. Possible
scenarios:
- SyteLine or CSI integrations: Set the Data Value to Discount.
- LN integrations: Set the Data Value to the implementation-specific line-level Distributed Charge Reason Code, published for the summary ERP-based SalesOrderLine/DistributedCharge Bod element.
Note: For assistance defining this unique Distributed Charge Reason Code, check with the LN administrator or integrator. - Filter products by transaction
- The option to specify the Quote and Sales Order
Product filtered lookup criteria, based on the transaction’s
location settings. Select one of these options based on the
requirements of the integrated host ERP system:
- Logical ID
- Accounting Entity
- Warehouse
- Site
- Filter products by fixed Logical Id
- The option to specify the Quote and Sales Order filtered Product lookup criteria, based on a specified Logical ID. Enter The Back Office Logical ID that publishes the host ERP system's products to be used for all Quotes and Sales Orders. This value is considered only if, the Filter products by transaction custom setting is not specified.
- Click Save.
-
Click the Outbound Message
Settings tab to define the parent-child relationships that can
auto-promote parent records based on modifications to one or more of the
dependent child records. See Outbound Message Settings tab.
- Infor CRM SLX recommends leaving the remaining Outbound Message Settings
with the out of the box settings unless otherwise instructed by CRM SLX
support.
- Contact
- The contact reference defined by the integrated back office application.
- Account
- The customer reference defined by the integrated back office application.
- ERPBill To
- The Bill To reference defined by the integrated back office application.
- ERPPay From
- The Pay From reference defined by the integrated back office application.
- Address
- The address reference defined by the integrated back office application.
- ERPTrading Account
- The account reference defined by the integrated back office application.
- ERPBillTo Contact
- The contact reference defined by the integrated back office application. A many-to-many relationship exists between Bill To and Contact.
- ERPBillTo Account
- The account reference defined by the integrated back office application. A many-to-many relationship exists between Bill To and Account.
- ERPContact Account
- The contact relationship defined by the integrated back office application.
- Sales Order
- The sales order reference defined by the integrated back office application.
- Quote
- The quote reference defined by the integrated back office application.
- ERPShipTo Account
- The customer reference defined by the integrated back office application. A many-to-many relationship exists between Ship To and Account.
- ERPShipToContact
- The customer reference defined by the integrated back office application. A many-to-many relationship exists between Ship To and Contact.
- ERPBillTo ShipTo
- The customer reference defined by the integrated back office application. A many-to-many relationship exists between Bill To and Ship To.
- ERPPayFrom BillTo
- The billing address defined by the integrated back office application. A many-to-many relationship exists between Pay From and Bill To.
- ERPPayFrom Contact
- The contact relationship defined by the integrated back office application. A many-to-many relationship exists between Pay From and Contact.
- Quote Item
- The quote item defined by the integrated back office application.
- Quote Address
- The quote address defined by the integrated back office application.
- SalesOrder Item
- The sales order item defined by the integrated back office application.
- Click Save.
- Infor CRM SLX recommends leaving the remaining Outbound Message Settings
with the out of the box settings unless otherwise instructed by CRM SLX
support.
-
Click the Back
Offices tab to select the required back office, See Back Office tab. Use the Back Office detail
view to:
- Configure the back office information fields. See Using the Back Office detail view.
- Add a new accounting entity using the Accounting Entities tab. See Adding an accounting entity (back office extension).
Note: If the required back office does not exist, the standard Bod Pack for the integrated host ERP system must be installed. -
Use the BOD Mapping detail view to:
- Modify an existing BOD mapping. See Using the BOD mappings detail view.
- Add a BOD field mapping. See Defining a BOD field mapping.
- Edit a BOD field mapping. See BOD Mappings tab.
Note:- If the required BOD mapping does not exist, you must add a new BOD mapping first. See Adding a BOD mapping (back office extension).
- This step is optional.
-
Add the users to the Integration role to give individual users
access these administrative integration
views:
- Back Office
- BOD Mappings
- Field Mappings
- ERP Persons
-
Add the users to the BackOffice role to give individual users access to these
non-administrative integration
views:
- Invoices
- Receivables
- Shipments
- Bill To
- Ship To
- Pay From
- ERP Persons (View)