Infor CloudSuite Industrial Configuration Guide For Infor Operating Service
Infor CloudSuite Industrial Configuration Guide For Infor Operating Service
Release 10.x
Copyright © 2020 Infor
Important Notices
The material contained in this publication (including any supplementary information) constitutes and
contains confidential and proprietary information of Infor.
By gaining access to the attached, you acknowledge and agree that the material (including any
modification, translation or adaptation of the material) and all copyright, trade secrets and all other
right, title and interest therein, are the sole property of Infor and that you shall not gain right, title or
interest in the material (including any modification, translation or adaptation of the material) by virtue
of your review thereof other than the non-exclusive right to use the material solely in connection with
and the furtherance of your license and use of software made available to your company from Infor
pursuant to a separate agreement, the terms of which separate agreement shall govern your use of
this material and all supplemental related materials ("Purpose").
In addition, by accessing the enclosed material, you acknowledge and agree that you are required to
maintain such material in strict confidence and that your use of such material is limited to the Purpose
described above. Although Infor has taken due care to ensure that the material included in this publication
is accurate and complete, Infor cannot warrant that the information contained in this publication is
complete, does not contain typographical or other errors, or will meet your specific requirements. As
such, Infor does not assume and hereby disclaims all liability, consequential or otherwise, for any loss
or damage to any person or entity which is caused by or relates to errors or omissions in this publication
(including any supplementary information), whether such errors or omissions result from negligence,
accident or any other cause.
Without limitation, U.S. export control laws and other applicable export and import laws govern your
use of this material and you will neither export or re-export, directly or indirectly, this material nor any
related materials or supplemental information in violation of such laws, or use such materials for any
purpose prohibited by such laws.
Trademark Acknowledgements
The word and design marks set forth herein are trademarks and/or registered trademarks of Infor and/or
related affiliates and subsidiaries. All rights reserved. All other company, product, trade or service
names referenced may be registered trademarks or trademarks of their respective owners.
Publication Information
Release: Infor Cloudsuite Business (Industrial) 10.x
Publication Date: August 6, 2020
Document code: csbi_10.x_csbixicg_op_csind_en-us
Contents
Contents
Chapter 3: Overview.........................................................................................................................12
Infor OS...........................................................................................................................................12
Infor Ming.le.................................................................................................................................12
Infor ION......................................................................................................................................13
Infor ION Grid...............................................................................................................................14
Infor Document Management.......................................................................................................14
Integration with other products in the CloudSuite............................................................................14
BOD integrations..........................................................................................................................15
Point to point integrations.............................................................................................................15
Concepts and definitions specific to this configuration....................................................................16
Tenant ID......................................................................................................................................16
Accounting entity..........................................................................................................................16
Location.......................................................................................................................................16
Logical ID.....................................................................................................................................16
Chapter 4: Configuring your browser.............................................................................................18
Allowing popups for browsers..........................................................................................................18
Avoiding multiple connections in a browser.....................................................................................18
Chapter 5: Configuring security......................................................................................................19
Setting up your application to use Single Sign On..........................................................................19
Chapter 7: Configuring your application and ION to send and receive BODs............................25
Configuring your application for ION...............................................................................................25
Verifying that the SQL Server no count option is not set.............................................................25
Setting master data to standardized values.................................................................................25
Setting up a default configuration for each site............................................................................26
Setting up BOD replication and logical IDs, tenants, accounting entities, and locations in the
ERP..............................................................................................................................................26
Setting up information that will flow to other products..................................................................29
Verifying BOD replication.............................................................................................................29
Connecting the ERP to ION............................................................................................................29
Understanding connection points and data flows........................................................................29
Using the Enterprise Connector in a hybrid environment............................................................30
Creating an ERP connection point...............................................................................................30
Defining BODs for the ERP connection point...............................................................................31
Using the Cloud Connector to connect to cloud applications..........................................................32
Configuring document flows............................................................................................................32
Setting up a document flow to Infor Ming.le to pass user and role information............................32
Configuring other data flows between applications......................................................................33
Publishing BODs.............................................................................................................................34
Starting products and services....................................................................................................34
Initial data load.............................................................................................................................34
BOD dependencies......................................................................................................................35
Turning off BOD replication to reduce traffic....................................................................................36
Verifying the ION configuration........................................................................................................37
Verifying that BODs are published...............................................................................................37
Verifying that ION receives data...................................................................................................38
Verifying the data flow between applications...............................................................................38
This guide provides configuration and implementation information for the integration of Infor CloudSuite
Industrial with Infor Operating Service (OS).
Use this guide in either of these cases:
• CloudSuite Industrial and Infor OS are both installed on-premises
• CloudSuite Industrial is installed on-premises and Infor OS is in the cloud.
Intended audience
This guide is intended for the system administrator or consultant who configures CloudSuite Industrial
for use with Infor OS.
Contacting Infor
If you have questions about Infor products, go to Infor Concierge at https://concierge.infor.com/ and
create a support incident.
The latest documentation is available from docs.infor.com or from the Infor Support Portal. To access
documentation on the Infor Support Portal, select Search > Browse Documentation. We recommend
that you check this portal periodically for updated documentation.
If you have comments about Infor documentation, contact [email protected].
Chapter 1: Requirements
Required products
Ensure that you have installed and configured these products:
• CloudSuite Industrial 10.x
See the Infor CloudSuite Industrial Installation Guide.
• Infor Operating Service, latest version
The installation of Infor OS includes these products: Infor Ming.le, Infor ION, Infor Document
Management, ION Grid, and ION API.
• If you are using Infor OS in the Cloud, with CloudSuite Industrial on-premises, the Infor Cloud
team provisions Infor OS and its components for you. Use the instructions in this guide to
configure Infor OS to communicate with your on-premises application through the Enterprise
Connector. See the Infor ION Desk User Guide - Cloud Edition for the Enterprise Connector
server prerequisites.
• If Infor OS is installed on-premises, the server where you install Infor OS must be able to
connect to the servers where you install CloudSuite Industrial and other BOD-enabled products.
ADFS is used for Single Sign On authentication with Infor OS. SAML Session Provider, the
default provider for ADFS, is installed with Infor OS and must be configured correctly for your
application.
See the Infor Operating Service Installation Guide.
Note: If you are upgrading from an earlier version of Infor OS, check the Infor OS release
notes for any pre-upgrade actions that must be performed.
Required information
Obtain this information before you begin the integration:
• Credentials to connect to the application interface, for example, database user, password, server
name, port or instance.
• Name of the CloudSuite Industrial instance or logical ID that is used to connect with ION; tenant
ID that is used to connect the application to Infor OS in ION; and enterprise organization structure,
that is, accounting entities.
SeeSetting up BOD replication and logical IDs, tenants, accounting entities, and locations in the
ERP on page 26 for information about how to set up the logical ID, tenant ID and accounting entities
for your application.
• CloudSuite Industrial sites that are used in the integration, and either the queue server name or
the bootstrap site that is used to communicate with the sites through replication inboxes and
outboxes.
• Names of physical locations where your CloudSuite Industrial databases exist, if your company
has multiple physical locations.
• A URL and an administrator account for Infor Ming.le and ION. Verify that you can access the URL
and log into Infor Ming.le.
• Location or source of files to be imported into ION and Infor Ming.le for content.
Follow this checklist to integrate this application with the components of Infor Operating Service:
Chapter 3: Overview
Before you complete the configuration tasks, you must understand how this application is used with
Infor OS. You should also be familiar with a list of related concepts and definitions.
Infor OS
Infor Operating Service is a technology platform that supports fully integrated, industry-specific solution
suites with mobile-first design, a consumer-inspired user experience, and science-driven analytics. It
leverages the convergence of information, analytics, cloud computing, mobility, and social business.
This platform includes these products:
• Infor Ming.le™
• Infor ION
• Infor ION Grid
• Infor Document Management
• Infor Data Lake
• Analytics
• Infor Localization Services™
Infor Ming.le
Infor Ming.le is a web-based application framework that provides a common user interface for Infor
applications, third-party applications, and in-house developed applications integrated through Infor
ION. It is a centralized platform for social collaboration, business process improvement, and contextual
analytics.
Infor Ming.le provides drillback capability so that users can navigate across the applications to track
transactions, the transfer of data, and report updates. Additionally, Infor Ming.le provides an infrastructure
for sharing content with context applications.
Infor Ming.le uses Homepages, configurable by users to organize information and activities at a high
level to focus on critical areas of concern.
Within Infor Ming.le, you can use ION API, a managed API layer across all applicable Infor and non-Infor
APIs, allowing existing APIs to be presented in a standardized, managed, and controllable way.
Infor Ming.le uses Infor Federation Services (IFS) for centralized authentication.
Infor Ming.le is available as a mobile app, supported by iOS, Android™, and Windows Mobile operating
systems.
Infor ION
Infor ION is a business process management platform that integrates applications, people, and business
processes. The ION platform converts data into the common language of standardized XML to enable
disparate business systems such as Infor products, third-party applications, and in-house developed
applications to share information.
ION simplifies the connectivity and data sharing across the connected applications. It enables users
to configure a routed infrastructure, set up workflows, and design and activate business event monitors
and manage tasks and alerts.
ION features
Infor ION has these features:
• You can establish connections between applications which can either be Infor applications or third
party applications through ION Desk.
• You can model document flows between applications to represent a business process. More
technical flows can also be defined, for example, mapping data from a third party application to a
standard business object document as required by an Infor application. You can also include filtering
or content-based routing.
From ION Desk you can deploy your models by activating them. ION Desk also provides
management screens to monitor the behavior of the ION service and to help in troubleshooting
when needed.
• You can monitor business events and create alerts when exceptions occur.
The start point of monitoring are the business object documents that are published by applications
when business events occur. Monitors are processes that run in the Event Management engine
and evaluate these documents by applying predefined business rules. When exceptions are
detected, these are reported as alerts to the business users. The distribution list of alerts is part
of the monitor definition.
• You can model and run business processes such as authorizations, work distribution, or task-driven
workflows across several components.
For authorizations, you can use an approval workflow to approve a purchase order or to sign off
a new item. Such workflows are triggered by the creation of a new item or the submission of a new
order.
In the area of work distribution, the workflow ensures that all tasks for a certain event are being
distributed and executed by different users. The advantage of using a workflow is that you can
model how these tasks are performed, for example sequential or in parallel.
• You can manage the alerts, tasks and notifications and distribute them to users. When users take
actions in Infor Ming.le, these actions are recorded and a reply is sent to the engine that generated
the user activity.
For more information about these features, see the Infor ION Desk User Guide.
To understand common ION concepts such as BOD nouns and verbs, document flows and workflows,
listeners and connection points, see the Infor ION Desk User Guide.
BOD integrations
An outbound operation typically begins when a user performs an action in CloudSuite Industrial that
requires a data exchange with another ION-enabled application. A Business Object Document (BOD)
XML message is generated by CloudSuite Industrial and placed in an area designated as the CloudSuite
Industrial message outbox. At scheduled intervals, ION connects to the outbox and retrieves the BODs
from it.
In ION Desk, you create application connection points. The connection point defines the information
needed to connect to the application database. It also holds a list of all the BOD documents that the
application can send or receive.
You define data flows between CloudSuite Industrial and other applications that represent the business
flows between the applications. A document flow is a type of data flow, used with BODs. For example,
you set up a document flow between CloudSuite Industrial and Infor Ming.le to pass BODs that contain
user and role information. Use the Modeler in ION Desk to define these document flows. Use the
Modeler in ION Desk to define these document flows.
ION routes BODs according to the document flows between BOD-enabled products. If a document
flow is defined from CloudSuite Industrial to another application for a particular BOD, then at specified
intervals, ION places the outbound BOD from CloudSuite Industrial in the other application’s designated
message inbox. Products are responsible for validating and incorporating the data in inbound BODs
according to their rules.
If a document flow is defined from CloudSuite Industrial to another application for a particular BOD,
then at specified intervals, ION places the outbound BOD from CloudSuite Industrial in the other
application’s designated message inbox. Products are responsible for validating and incorporating the
data in inbound BODs according to their rules.
If a flow is defined from another application to CloudSuite Industrial, ION retrieves BODs from the
sending application’s message outbox and delivers them to CloudSuite Industrial’s message inbox for
processing. CloudSuite Industrial retrieves, validates, and processes the BODs.
Tenant ID
The tenant is a container for accounting entities and locations and is required in each BOD. The value
of the tenant must be the same in all of the products that exchange BODs. Data is not shared or
accessible between tenants.
See the information about using tenants in the Infor ION Desk User Guide.
For an on-premises configuration, verify that all of the other products are using the default value of
infor for the tenant ID, and if so, use that as your tenant ID for CloudSuite Industrial.
Accounting entity
An accounting entity usually represents a legal or business entity that owns its general ledger. Every
transaction belongs to only one accounting entity. An accounting entity can also be defined as the
owner of certain master data among the enterprise. CloudSuite Industrial is the system of record for
accounting entities.
For CloudSuite Industrial, the site is used as the accounting entity.
Do not confuse this Infor definition of “accounting entity” with the CloudSuite Industrial definition of
“entity,” which is a type of site that is used only for financial consolidation.
Location
A location is the physical location that is associated with data or transactions. The location can be, for
example, a warehouse, a manufacturing location, a project location, or an office. Locations are published
in the Location BOD. A location is required for all transactional BODs and is usually the location from
which a transaction or record is generated. CloudSuite Industrial is the system of record for locations.
Logical ID
The logical ID is a unique identifier used in the communication of data between the applications in the
tenant’s environment. Each instance of an application, for example, a site, is assigned one logical ID.
In ION, the logical ID is used to properly route BODs. Infor Ming.le uses the logical ID to determine
which application to start when you click a drillback.
This logical ID is defined in the CloudSuite Industrial Sites/Entities form. You must provide the logical
ID when you define the ION connection point for on-premises applications.
In Infor Ming.le, each application is assigned a logical ID. Infor Ming.le supports only one logical ID per
application.
For more information, see the CloudSuite Industrial online help.
Single sign on allows users to use one set of credentials to log into all Infor applications.
CloudSuite Industrial is set up for Single Sign On in Infor Ming.le through the use of SAML authentication,
Microsoft AD FS and Integrated Windows Authentication. This requires an environment where a
Windows domain trust between the client systems and the AD FS host is configured.
See the Infor Operating Service Installation Guide for information about the client Single Sign On
experience and about the SAML session provider.
Note: Before you configure security for your CloudSuite, contact your Infor representative to discuss
your requirements and get a complete listing of certified identity providers. The representative might
engage the Infor Global Identity and Access Management (IAM) team to assist you in setting up SSO
for the CloudSuite.
Creating a relying party trust for Infor Ming.le and the ERP
This task uses a Power Shell script to create a relying party that associates Infor Ming.le with AD FS
for Single Sign On.
This Power Shell script is similar to the Power Shell scripts that you ran in the post-installation steps
of the Infor OS installation. See the Infor Operating Service Installation Guide.
1 In Infor OS Manager, open the Applications section.
2 Add an application and specify this information:
Application Name and Description
Specify a name of your choice that identifies the application.
Application Type
Select SYTELINE(SyteLine).
Signing Certificate
Leave this field as (none).
Create these security groups in Active Directory outside of Infor Ming.le. See the Microsoft documentation
about Active Directory for information about how to configure user accounts with security groups. Also
see the Infor CloudSuite Industrial Installation Guide for information about how to configure CloudSuite
Industrial for use with Active Directory.
Perform these steps to add CloudSuite Industrial as an application that can run in Infor Ming.le:
1 From the Infor Ming.le user menu, select Admin Settings.
2 Click Add Application.
3 Use this information to complete these fields:
Application Type
Specify Infor Non-Provisioned..
Application Name
Select your application name and version from the list. For all versions of CloudSuite Industrial
10.x, select Infor CloudSuite - 10.0.
Display Name
Specify CloudSuite Industrial.
Logical ID
The first part of the logical ID is set automatically based on the application name. Specify the rest
of the logical ID for the CloudSuite Industrial instance associated with this instance of Infor Ming.le,
for example, the site name. This ID must be lowercase and not contain special characters.
Application Icon
Click Choose Icon.
Each application has a default icon. You can only select the color which you want to apply to the
icon.
Use Https
Select this option if SSL is enabled for the CloudSuite Industrial user interface. If CloudSuite
Industrial is using SSL, ensure that you specify the SSL-related port number in the Port # field.
Host Name
Specify the name of the CloudSuite Industrial web/utility server. This host name is also used for
drillbacks to the application.
Also, if you use a fully-qualified name, for example, server.infor.com, in one instance, you must
use it for all instances.
Note: The host name entered in Infor Ming.le must exactly match both of these:
• The web server URL (http://servername/WSWebClient), which is defined when you install the
Application & Web role on the server during CloudSuite Industrial installation. The IIS
application name for the web client defaults to WSWebClient and cannot be overridden in
the ApplicationSettings.xml file.
Port #
Specify the port used by the CloudSuite Industrial web/utility server. Typically this is 80 for HTTP,
and 443 for HTTPS.
Context
If any context is defined in the Infor Registry, it is shown as the default context when you select
the Application Name.
Default Tenant
We recommend that you specify Infor.
4 Click Save.
5 Review the default values in these tabs:
• Deployment Information: The connection information you specified for this application is
displayed.
• Permissions: Two default roles are created, Infor-SystemAdministrator and MingleAdministrator.
Additional roles are automatically generated that match the default authorization groups in
CloudSuite Industrial.
Later in the configuration process, you will use the Permissions tab to configure user access
to CloudSuite Industrial through Infor Ming.le.
• Context/Utility Apps: The default context apps that are included with your application are
listed on this tab.
See Context and utility apps that work with the ERP on page 63.
You can add other context or utility apps here, including context apps that are unique to your
application.
By default, all the required applications are enabled and optional applications are disabled.
You can enable or disable context applications at any time.
• Custom Parameters: Default custom parameters, if any exist, are displayed. You cannot edit
the default name of the custom parameter.
• Logical ID Fallback: By default, no logical ID fallbacks are displayed.
Default values are generated when the application is created. Do not change the default values.
6 Click Save.
7 Verify that you can access the CloudSuite Industrial application from the App Menu.
8 Verify that you can log in to the CloudSuite Industrial app.
This section describes how to configure your application to communicate with ION. Integrations between
this application and other applications use ION to send and receive BODs. For details about a specific
integration, see the appropriate integration guide.
You can map existing non-standard units of measure, currencies and countries to ISO values through
these CloudSuite Industrial forms:
• Currency Codes
Note: ISO currency codes are required for some integrations. ISO currencies are not defined as
part of an initialized database and must be set manually.
• Countries
• Unit of Measure
Description
Specify an appropriate description, for example, Infor ION BOD connection.
External
Select this check box.
Transport
In this field on the General tab, specify ESB.
3 On the Intranets form, select the intranet used by your CloudSuite Industrial site and specify this
information:
Transport
Specify HTTP.
Queue Server
Optionally, specify the name of your MSMQ Server. You only need to specify a special queue
name here if your site names are not unique, or if the MSMQ is on a different machine than the
utility server. The queue server name can encompass both the name of the machine and the
prefixed names of the queues.
If this field is left blank, the default queue server names are used.
Tenant ID
To use the same tenant ID for all sites on this intranet, specify it here. You can also leave it blank
here and specify the tenant ID on the local site records, or leave that field blank to use the default
tenant ID value of infor. The tenant ID can be a maximum of 22 characters and must match the
tenant ID used in ION for other connecting products. For more information about how the tenant
ID is used with ION, see the Infor Operating Service Administration Guide.
4 On the CloudSuite Industrial utility server, specify configuration information on the Replication tab
of the Service Configuration Manager utility:
• In the Replicator/Inbound Bus Configurations field, specify all of the configurations that can
receive inbound or outbound messages from other sites on the intranet. The Replication
Document Outbox form at each site collects outbound BODs for that site. The Replication
Document Inbox form at each site collects inbound BODs for that site.
• In the Replication Queue Listener Servers field, set up a queue server name for every intranet
in your system.
Generally, the queue server name is set to localhost\private$ which uses the standards
private message queues named inbound and outbound on the utility server. However, if you
have specified a Queue Server Name on the Intranets form, that name is used to build a path.
For example, utilityserver3\private$\MyQueues results in the use of the queue names
MyQueues_inbound and MyQueues_outbound.
Note: If you are upgrading from a previous version and you already have replication set up through
a “bootstrap” site, it will still work as it did in the previous version. The Replicator/Inbound Bus
Configurations field contains one site set as the Master Site, and the ReplQListener Queue
Servers field has the Default field selected.
5 On the Sites/Entities form, create a logical "site" for ION:
Site
Specify a name to identify this site as your ION site, for example: InforBUS.
Type
Specify Site.
Intranet Name
Select the intranet you created in step 2.
From Site
On the Site User Map tab, specify the local site, for example, oh. The site name is used as the
accounting entity in BODs.
User Name
Specify the user ID used to send replication documents to the CloudSuite Industrial outbox for
ION to retrieve. This user must already be set up on the CloudSuite Industrial Users form at the
local site. We recommend that you specify the repl_user here, if it is defined. Otherwise, specify
a user with Full User editing permissions. Also, the Automation license module must be assigned
to the user that you specify here.
6 On the Sites/Entities form, configure the local site, for example, oh, to generate or receive business
object documents (BODs).
a Specify the Message Bus Logical ID for the site. This identifies the CloudSuite Industrial site
to ION.
Specify the logical ID as tenant.syteline.site where tenant is the tenant ID, syteline
is the application type, and site is the name of the local site, for example infor.syteline.oh.
The logical ID must be all lowercase.
Note: The logical ID entered here must match the application type and name defined in the
ION connection point for this CloudSuite Industrial site.
b Optionally, specify a Tenant ID for the local site. If no tenant ID is specified here or on the
Intranets form, the default tenant ID value is infor.
7 At each site that is sending or receiving BODs, open the Replication Rules form and create a
new rule. Specify this information:
Source Site
Specify the local site that you configured in Step 6.
Target Site
Specify the ION site that you created in Step 5.
Category
Specify ESB.
Interval Type
Specify any option except Transactional.
8 At each site that is sending or receiving BODs, open the Replication Management form and click
Regenerate Replication Triggers.
Note: If you have multiple sites in one database, you only need to perform this step at one site.
In an integration between two BOD-enabled applications, document flows are set up to define the
BODs that flow between the application connection points. A document flow is a type of data flow.
A connection point can be reused multiple times in one or more data flows. You can also create
connection points during the modeling of a data flow in the details section of the data flow elements.
The connection points that are created during the modeling of a flow are added to the shared list of
connection points, and they can be reused.
Some integrations with CloudSuite Industrial use a solution XML file to set up sample connection points
and data flows. This file can be imported to ION to provide the basis for connection points and data
flows.
See the section on ION Connect Modeling in the Infor ION Desk User Guide for additional information
about connection points and data flows.
Description
Optionally, specify a description for the site.
Location
If this is a hybrid environment, and you have installed the Enterprise Connector, specify the location
that you defined with the Enterprise Connector for the CloudSuite Industrial application.
See Using the Enterprise Connector in a hybrid environment on page 30.
In a cloud environment, this value could be the tenant ID. In an on-premises environment, this is
usually infor.
Logical ID Type
Specify syteline.
Database Driver
Specify SQL Server (Microsoft).
Connection points are not activated separately. When you activate a document flow, the associated
connection points are activated.
Note: If you later remove a BOD from a connection point, and that BOD is used in a document flow,
an error is reported in the document flow messages pane.
4 In the properties pane for each of the application boxes, click + and add the appropriate connection
points.
Note: You only need to add one CloudSuite Industrial site as a connection point. The sites are all
in one database, so basic user data is shared between all sites. However, if you want to ensure
that updates to roles (groups) are also shared between all sites, you must set up a master site and
shared user tables in CloudSuite Industrial. (See the Infor CloudSuite Industrial Multi-Site Planning
Guide – Cloud Edition.) If you don’t want to use a master site and shared user tables, then you
must include all of the CloudSuite Industrial site connection points in this document flow.
5 Select the document icon between MINGLE_1 and ERP_1 and ensure that it lists this document:
• Sync.SecurityUserMaster
6 Select the document icon between ERP_1 and MINGLE_2 and ensure that it lists these documents:
• Sync.SecurityRoleMaster
• Process.SecurityUserMaster
7 Save your changes.
8 Activate the document flow.
9 Open CloudSuite Industrial from the App menu.
10 In the Replication Document Manual Request Utility form, select the Sync SecurityRoleMaster
BOD. Select Initial Load and click Process. This publishes the security roles from CloudSuite
Industrial, which are sent to Infor Ming.le. The Infor-SystemAdministrator group fromCloudSuite
Industrial is synchronized with the Infor-SystemAdministrator role in Infor Ming.le.
For information about these BODs, see User and role BOD usage on page 73.
not an appropriate integration guide, you can follow these general steps. See the Infor ION Desk User
Guidefor more information
1 Define a new data flow that includes connection points for both CloudSuite Industrial and the other
application.
2 Define the documents or messages that flow between the applications, and the direction that they
flow.
3 Save the data flow.
4 Activate the data flow.
Publishing BODs
You publish BODs so that ION can retrieve them from your message outbox, viewed through the
Replication Document Outbox form. You can publish BODs for general use by any product that
subscribes to the BODs through Infor ION. After you perform an initial data load from your application,
you verify that data is flowing out of the application into ION. For details about a specific integration,
see the appropriate integration guide.
For a BOD-based integration between this application and another application, see the appropriate
integration guide for these instructions:
• Setting up the document flows
• Performing any additional configuration of the applications that is required for that integration
You can then use the steps in the integration guide to publish the BODs.
application, so that the base systems are synchronized. The BODs are placed in the Replication
Document Outbox, from which ION retrieves them and passes them to the other application.
BOD dependencies
Be aware that you must load these BODs in this order to prevent errors in the integration due to missing
data:
• AccountingEntity: This is the first BOD you should publish from each site.
• FinancialCalendar: This must be published before the ChartOfAccounts or any financial transaction
BODs.
• AccountingChart: This must be published before any financial transaction BODs.
• ChartOfAccounts: This must be published before any financial transaction BODs.
• Master data, including:
• CodeDefinition
• Location
• CustomerPartyMaster
• ItemMaster
• BillToPartyMaster
• ShipFromPartyMaster
• ShipToPartyMaster
• SupplierPartyMaster
• Any required historical transaction data, including:
• SalesOrder
• Shipment
• Invoice
2 If your system is integrated via BOD with some other products, leave the ESB rule in Step 1 enabled.
Use these steps to only replicate BODs for the integrations you are using:
a Go to the Infor Support Portal site and download the script from KB 1964331.
b Run the script on each CloudSuite Industrial application database. This script enables users
to turn off replication of specific BOD triggers.
c Open the Replication Categories form.
d Specify ESB as the Category and click the filter.
e To stop publishing a BOD, update its Trigger* record in the ESB replication category. Select
the appropriate Skip Method check box.
This example shows how to turn off the Sync.ItemMaster BOD:
Select Skip Method for any BOD triggers that you are not using, with these exceptions:
• See the appendixes of this guide for a list of the BODs required to integrate with Infor OS
components such as Infor Ming.le and Document Management. Leave the triggers for
those BODs enabled.
• See the appendixes of this guide for a list of the outbound BODs required to integrate with
any other products that you are using. Leave the triggers for those BODs enabled.
• Also leave these triggers enabled:
• FlushBusCacheForSiteSp
• FlushBusParmsForSiteSp
• SendEntireBodSp
• TriggerBODConfirmSp
• TriggerPulseNotificationSyncSp
3 If you later integrate CloudSuite Industrial with additional applications via BODs, you must turn on
the triggers for the required BODs when you integrate with the other applications.
See the appendixes of this guide, or the appropriate integration guide, for the list of outbound BODs
that are required for each integration.
Users, roles, and person IDs are initially defined in Infor Ming.le and shared with all of the other
applications that run through the Infor Ming.le portal. Roles and some user information can later be
modified in CloudSuite Industrial.
How Infor Ming.le users and roles work with ERP users and
groups
Note: In a Cloud usage-tracking environment, licenses are not assigned to specific users, either in
CloudSuite Industrial or through Infor Ming.le roles.
When you create or update a user in Infor Ming.le, the information associated with that user is used to
automatically set up some user information in CloudSuite Industrial. This association is handled through
Sync SecurityUserMaster BODs that are passed through ION.
CloudSuite Industrial groups and license modules are mapped to security roles in Infor Ming.le.
The list of available CloudSuite Industrial groups must be updated and maintained in CloudSuite
Industrial – not in Infor Ming.le - because the types of roles and the names of roles are dependent on
the requirements of CloudSuite Industrial. After the groups are set up in CloudSuite Industrial, they are
synchronized to Infor Ming.le through the Sync SecurityRoleMaster BOD, so that Infor Ming.le is aware
of all possible roles. The ability of security roles to perform specific operations and access specific data
is enforced by CloudSuite Industrial, not Infor Ming.le.
When you assign a user to a group or license module in either CloudSuite Industrial or Infor Ming.le,
that information is passed to the other application through a SecurityUserMaster BOD. Infor Ming.le is
the System of Record for this information.
CloudSuite Industrial licenses can be assigned to users either through the CloudSuite Industrial User
Modules form or through “CSI-LicenseModule-“ roles in Infor Ming.le.. However, these license
assignments are meaningless in a usage-tracking environment.
Note: All CloudSuite Industrial license modules are available as security roles in Infor Ming.le. However,
if you assign a license module security role to a user in Infor Ming.le, but your company is not licensed
for that module, or if the user count for that module is exceeded, then when CloudSuite Industrial
processes the inbound BOD, it will not assign the license module to the user. This can leave the two
applications out of sync.
Infor Ming.le provides a default Infor-SystemAdministrator role that allows for full access to all applications
that are linked to Infor Ming.le. CloudSuite Industrial has an Infor-SystemAdministrator group or role
that allows access to all CloudSuite Industrial screens. When a user who has the
Infor-SystemAdministrator role inInfor Ming.le is synchronized to CloudSuite Industrial, that user
automatically has access to all CloudSuite Industrial forms.
For more information about these BODs, see User and role BOD usage on page 73.
2 From the menu on the left side, select Security Administration > Settings > General Settings.
3 Click Manage Features.
4 Configure these general properties to ensure that new or changed user information is synchronized
with other applications:
Publish Security User Master BOD
Select this option to publish the SecurityUserMaster BOD when a user’s details are changed in
Infor Ming.le. This synchronizes the user details with other applications that subscribe to the BOD.
5 To set up system administrator access for your account between Infor Ming.le and CloudSuite
Industrial, add the Infor-SystemAdministrator role to your account:
a In Infor Ming.le, select User Management from the user menu.
b Select your system administrator account and click the Details icon.
c Click the Security Roles tab.
d Click + and add the Infor-SystemAdministrator role.
e Click Add.
6 On the Users page, follow these general steps to add users. See the Infor Ming.le online help for
more information.
Note: If your application already has legacy users set up, you can import the users into Infor Ming.le
from a .CSV formatted file. See the Infor Operating Service Administration Guide. To temporarily
disable user synchronization before the import, clear the Publish Security User Master BOD
option and select Do not enable for the Enable SCIM Parameter configuration option. Then
select Allow Import. The Import option is then enabled on the Manage > Users page.
a Click + to add a user.
b Clear the Send Invitation option so that you can send the invitation later, after you have
completed the user setup.
c Save your changes.
d Click the details icon to view details for the user.
Note: The IFS ION-Person ID will be used to synchronize personnel records with CloudSuite
Industrial. It is generated automatically and should not be changed.
e In the Security Roles tab, assign the user to one or more roles, and click Add & Close.
In order for users to access CloudSuite Industrial through Infor Ming.le, they must be assigned
at least one CloudSuite Industrial role.
You might not see all of the application-specific roles that you need. If you do not see the roles
you need, those roles can be added and assigned later from within CloudSuite Industrial.
f Save your changes.
The information is sent through BODs to CloudSuite Industrial after you save your changes.
8 If prompted, select a configuration, which is linked to one of your CloudSuite Industrial sites. If you
plan to use one site as a master site, select the configuration for the master site.
9 In CloudSuite Industrial, select Form > Open and open the Users form.
10 In the Users form, click the filter toolbar button to see all of the users who were defined in Infor
Ming.le.
11 Update the information for each user to specify additional required or optional fields that are not
shared with Infor Ming.le. See the CloudSuite Industrial online help for more information.
a After you add your users in Infor Ming.le, verify that the user information has been sent through
BODs to CloudSuite Industrial. This information should be shown in the CloudSuite Industrial
Users form:
• The user name (email address) that you set for each user in Infor Ming.le is shown in the
User Name field.
• The IFS ION-Person ID that was set for each user in Infor Ming.le is shown in the
Workstation Domain/ID field.
These values should not be changed.
b Assign the user’s form editing permission level, PO requisition limit, and multi-site group
authorization, as needed. See the online help.
c Set the user’s password for the CloudSuite Industrial web client or click once client.
(This is not the same password that is used to log into the Infor Ming.le portal. The Infor Ming.le
portal password uses the IFS ID tied to the Workstation ID, so no additional user login is
required to access the CloudSuite Industrial application in Infor Ming.le.)
When users access CloudSuite Industrial through the web client or the click once client rather
than through Infor Ming.le, they must know this password.
d Ensure that the email address that you set for each user in Infor Ming.le is shown in the Primary
Email Address on the Users form. This value should not be changed. We recommend setting
these additional fields for the user:
e In the Groups tab, click in the grid and select Actions > New to add a new row.
f Click in the Group Name field to view the list of groups. Add any groups to which this user
should belong. If you were able to assign the groups as security roles for the user in Infor
Ming.le, you will see them listed here. Otherwise, you can assign the additional groups here.
g Click User Modules and assign the appropriate license modules to the user. If you were able
to assign the license modules as security roles for the user in Infor Ming.le, you will see them
listed here. Otherwise, you can assign the additional license modules here.
By default, users who are originally created in Infor Ming.le and sent through BODs to CloudSuite
Industrial are assigned a Transactional license in CloudSuite Industrial. This is handled through
the Admin License Module Name setting in the Process Defaults form.
Note: Some modules such as Service and QCS are separately licensed and require additional
configuration, as described in the next section.
h Save your changes.
12 In Infor Ming.le User Management, select the user’s record, and then select Action > Resend
Invitation.
The user receives a notification with a link that provides user-specific access to Infor Ming.le and
to CloudSuite Industrial.
5 Select the check box at the top of the column, to select all admin roles.
Note: If you have "power users" who only need administrator access in some applications, select
the “administrator” roles only for specific applications for those users.
6 Click Add & Close.
7 Click + again and specify Mingle in the filter field. Add all displayed roles to the admin user.
8 Click + again and specify Homepage in the filter field. Add all displayed roles to this user.
9 Click the Save icon on the Security Roles tab to save the roles for this user.
About locations
Locations are set up through BODs that are sent by your application to Infor Ming.le.
After the locations exist in Infor Ming.le, you can assign users and groups to them. Infor Ming.le then
sends BODs to your application with the information to be synchronized.
The CloudSuite Industrial application is the system of record (SOR) for locations.
Service accounts
The Infor Ming.le Service Accounts page shows accounts that have been created to allow applications
a resource owner grant to contact the Infor Authorization Service to obtain a token for use in making
API requests.
You can configure workflows and ION messages for your application.
ION messages
This table shows the types of ION messages:
Type Description
Alert Alerts are generated by Event Management in Infor OS or by a
PulseAlert BOD. An alert is a business notification or exception indi-
cating that something out of the ordinary has happened in the flow of
application documents.
Task Tasks are generated by Workflow in Infor OS or by a PulseTask BOD.
A task is an activity that must be completed within a defined period
of time. When the task is generated by Workflow, it suspends the ex-
ecution of the workflow until the task is completed. When a task is
completed, the user's response is sent back to Workflow to resume
execution of the workflow.
Notification Notifications are generated by Workflow or by a PulseNotification
BOD. A notification is similar to a task, but it does not require immedi-
ate user action. A notification does not suspend the execution of the
workflow.
Alarm The ION Alarms mobile application for Android devices is available
to create monitors, called alarms.
In ION Desk, the business administrator can create alarm templates.
After the templates are activated, mobile users can use the templates
to create alarms in the ION Alarms mobile application. The alarm
creator can specify the distribution list for the resulting alert. See the
Infor ION Alarms Mobile Application User Guide.
The users receive the alert on their Infor Ming.le page, in the Infor
Ming.le mobile application, or by email.
A Process PulseAlert BOD is generated when a business event associated with one of these publications
occurs in CloudSuite Industrial:
CloudSuite Industrial users can subscribe to the appropriate publications. Then, when an alert occurs
and a BOD is generated, the email addresses for all subscribers are included in the BOD.
The email address that is used in the BOD is determined by the Email Type Description field on the
Users form. If an address is specified where the Email Type Description is set to PersonID, then the
email address that is associated with the PersonID type is used. If no PersonID type is found, then the
address in the Primary Email Address field is used, as shown in this example:
Ensure that the Process PulseAlert BOD is included in the list of BODs that can be sent from the
CloudSuite Industrial connection point.
a In ION Desk, select Connect > Connection Points.
b Select the Infor Ming.le connection point and add Process.PulseAlert in the Documents tab
(as Send from Application) if it does not exist.
Through an internal API, ION passes the alert to Infor Ming.le as a Sync.PulseAlert BOD. See the
Infor ION Desk User Guide.
3 Configure Infor Ming.le to display alerts for this application.
4 Set up Infor Ming.le users with the appropriate roles to access tasks and alerts. See information
about configuring user access for tasks and alerts in the Infor ION Desk User Guide.
In addition, the value in the Infor Ming.le IFS ION-Person ID field must match the
Workstation/Domain ID field for the same user in CloudSuite Industrial, and the User Name field
in Infor Ming.le must match either the PersonId email address or Primary email address for the
same user in CloudSuite Industrial. This is handled automatically if you set up users first in Infor
Ming.le/IFS and then use SecurityUserMaster BODs to populate the user records in CloudSuite
Industrial, as described in Configuring user access to the ERP through Infor Ming.le on page 40.
• Perform automated processing, like inserting orders, updating customers, etc. In AES, you can
select any IDO for any of these operations from drop-downs, and update, insert, delete, or query
without having to write code.
Use ION when you are orchestrating interactions between applications via BODs.
You can use the two systems together in a variety of ways as well-AES can send and respond to the
receipt of ION BODs.
Available drillbacks
An Infor Ming.le search result, alert, or share can include a link to the form with a reference to specific
CloudSuite Industrial data. This type of drillback is displayed in the Infor Ming.le user interface as a
link that opens CloudSuite Industrial to a specific form filtered for specific results.
This table shows the BODs associated with drillbacks, the views that are currently available for this
drillback, and the CloudSuite Industrial form that is launched:
Verifying a drillback
To verify that the drillbacks are working for shared links in Infor Ming.le:
1 From the App menu, open CloudSuite Industrial.
2 Open a form that has a drillback, for example, Customers.
Note: The user interface does not indicate whether a screen has a drillback. In order for a screen
to have a drillback, a drillback must be configured and a business context message must also be
sent. See Available drillbacks on page 58 and Understanding business context messages on page
61.
3 Display the information that you want to share, for example, the record for a particular customer.
6 In the Infor Ming.le feed, find the message that contains the drillback icon, and click the drillback
icon to verify that it is working.
On the right side of the Infor Ming.le page is a collapsible panel that hosts a series of Infor Ming.le
context and utility applications.
Context apps are lightweight applications that communicate with the application frame to present
contextual information to the user. These applications subscribe to information published by the
application frame and display relevant content only when it is available. The values and content of the
application depend on the current context (form or field) that is shown in the CloudSuite Industrial
application panel in Infor Ming.le.
Utility apps are lightweight applications that represent information unrelated to content in the application.
They do not communicate with the application frame and, if activated, show only when the application
is open.
{"type":"inforBusinessContext","data":{"screenId":"CSI_Customers","enti
ties":[{"entityType":"InforAccountingEntity","id1":"DALS"},{"entity
Type":"InforShipToPartyMaster","id1":"4851","id2":"0","accountingEnti
ty":"DALS","drillbackURL":"?LogicalId=lid://infor.syteline.dals&page=for
monly&form=Customers(FILTER(CustNum%3D%27%20%20%20%20%2013%27%20AND%20Cust
Seq%3D0)SETVARVALUES(InitialCommand%3DRefresh))","bodRefer
ence":{"noun":"BillToPartyMaster","documentId":"4851","accountingEnti
ty":"DALS","logicalId":"lid://infor.syteline.dals"}},{"entityType":"Infor
CustomerPartyMaster","id1":"4851","name":"Brand Central Dept Store","ac
countingEntity":"DALS"}]}}
The message informs context apps that the Customers form is currently displaying a record for the
Brand Central Dept Store, which has the customer ID 4851 and the Ship To address ID 0, in the
accounting entity DALS. The message contains one or more business entities, or collections of
information, associated with the current record. The entity information can include a relative URL that
can be used to drill back into the application and display the form and record. It also can include a BOD
reference that maps from the current entity in the user interface to a corresponding BOD noun.
Any context apps that are associated with CloudSuite Industrial receive all of the information in this
message. Each context app searches its data to determine whether it has contextual information to
display that is related to information in this message.
For example, you might display the Customers form with the customer ID 4851. The Related Information
context app uses the entity type, or context, and its parameters from the message to determine if there
are any documents related to that context in its database. If so, the documents are listed in the app
and can be opened. If you drag and drop files into the Related Information app pane while this form
and record are displayed in CloudSuite Industrial, the files are automatically linked in Infor Document
Management to each of the entity types (contexts) listed in the context message.
For information about how to use the other application-specific apps, see the Infor CloudSuite Industrial
User Guide for Infor Operating Service.
Some of the apps are initially disabled. When the apps are enabled for CloudSuite Industrial, their
content is displayed in small app panes to the right of your application.
3 In the Manage Context/Utility Apps tab, select the app that you want to enable.
4 in the Permissions tab for that app, either select Grant access to all users or click Add new
users and/or IFS security roles to specify certain users or roles in CloudSuite Industrial that can
access this context app.
5 In the Applications tab for that app, select your application and enable it for the app.
6 Save your changes.
In order to see the changes, you might need to sign out of the application and Infor Ming.le. Close your
browser and reopen it.
Homepages are a flexible and configurable way to present information and activities to users.
Administrators can build pages for various groups of users, roles, departments, or business functions.
You can select from the library of available Infor widgets or build your own.
The predefined Homepages and widgets for CloudSuite Industrial were imported automatically when
the application was added to Infor Ming.le.
In this section, you will verify that they are working for your users.
For general Homepages administration tasks, see the Infor Operating Service Administration Guide.
For information about using the homepages and widgets, see the Infor CloudSuite Industrial User
Guide for Infor Operating Service.
d Close the catalog to view your new Homepage. Verify that the widgets display as expected.
4 Add a CloudSuite Industrial widget to a custom homepage:
a From the ellipses (…) menu, select New Page.
b Specify a title, description and color for the page and click Create.
c Click Add Widget.
d Under Categories, select Application. You should see a lot of application-related widgets.
You can use the filter icon in the toolbar to find specific widgets.
e Select the CloudSuite Industrial widget and click + (Add Widget).
f Close the catalog and save the page to view your new widget.
g Initially the widget shows a default page. Click the ellipses (…) in the widget and select
Configure.
h Leave the Title and Application values as-is. Select a widget from the list and click Save.
You must be assigned the appropriate CloudSuite Industrial authorization group/role to display
the .home form that underlies this widget.
5 Add a critical numbers widget, and configure it. Ensure that you can view critical numbers that you
are authorized to view in this widget.
You must be authorized in CloudSuite Industrial to view the critical numbers.
6 Drill down to CloudSuite Industrial forms from the appropriate widgets.
This section describes the process to integrate Infor Document Management (Document Management)
and CloudSuite Industrial.
In the case of failure, a notification is sent to the email address that is assigned on the CloudSuite
Industrial Users form to the user who originated the report. The PDF file that could not be stored in
Document Management is included as an attachment in the email.
CloudSuite Industrial also supports a BOD-based integration with Infor Document Capture (using
Ephesoft). See the Infor CloudSuite Industrial Integration Guide for Infor Document Capture.
Document Management or the Related Information context app must also have the appropriate
roles assigned.
• If you have enabled TaskMan Options and set the value to debugrep on the Process Defaults
form, then you must define a txt extension for a document type in the Document Types form. This
setting should only be used for report debugging purposes, and must be removed as soon as
testing is done.
Application Instance
If you are defining more than one instance of Document Management, describe the difference.
URL
Specify the URL of the Document Management application, typically
https://hostname.infor.com:9543/ca.
If Infor OS is in the Cloud, you can find the URL in the Control Center home page of the Document
Management application.
Authorization Method
If you select OAuth1, the API call functions as a back-end service, facilitating the impersonation
of the user who is actually creating the documents. In this case, specify the consumer key as the
User Name and the secret key as the Password. We recommend that you use the OAuth1 method
so that multiple CloudSuite Industrial users can generate reports and send them to IDM.
For help obtaining the OAuth user name and password, contact Document Management support
by logging a support incident and selecting Infor Document Management as the product line.
If you select Basic, IFS user authentication is used. In this case, specify a domain name and
password.
CloudSuite Industrial users are matched to Document Management users through the Infor Ming.le
(IFS) GUID value, which is shown in the Workstation/Domain ID field of the Users form.
Is Active
Ensure that this field is selected for the instance of Document Management that you want to use.
See the online help for assistance with the fields on this form.
2 Click Verify. If a green check mark is displayed beside the button, the connection is working. If a
red X is displayed, the connection is not working.
Note: Any generated output format from a workflow background task must have a Document Type
record associated with that extension and appropriate groups assigned.
3 Save your changes.
Later, you could use the advanced features on this form, along with the Application Event System, to
customize the integration. See the online help for assistance with the advanced fields.
Property or Attribute
Verify that these attributes are in the list: Purchase Order and Vendor Number. Select
Purchase Order.
Operation
Select Like.
Search Value
Specify the PO number. Use the % wildcard character to allow for leading and trailing spaces.
This appendix provides detailed information about how the security BODs are used between CloudSuite
Industrial and Infor Ming.le.
Person IDs
Any CloudSuite Industrial users who plan to use Infor Ming.le or other Infor OS components must be
set up as users in Infor Ming.le, and the user’s Person ID must be synchronized between Infor Ming.le
and CloudSuite Industrial.
Workstation Domain/ID
Specify the user name in the format domain_name\user_name.
3 For the rest of the field values, see the online help.
4 After the Process.SecurityUserMaster BOD is received by Infor Ming.le, the user is created there.
Appendix B: Troubleshooting
This section describes actions that you can perform to solve Infor OS integration issues.
This table shows the events, which are user actions in CloudSuite Industrial that generate an outbound
BOD from CloudSuite Industrial:
This table shows the incoming BODs that CloudSuite Industrial can accept. It also indicates, when
possible, what area of CloudSuite Industrial shows the processed inbound data.
This section contains the list of BODs that are available for integrations with CloudSuite Industrial.
For information about upgrading from previous versions of Infor CloudSuite Industrial, see the Infor
CloudSuite Industrial Installation Guide.