Prerequisites

Set up Emporix access so you can use the Import Tool to import data from external systems.

Before you use the Import Tool, prepare Emporix access: create a user group with the required access controls and grant that group access to the Import Tool perspective in the Management Dashboard.

Source systems also need their own permissions before you import data. For an example based on Celonis configuration, see Importing from Celonis.

Access controls

Create an access control, or update an existing one, that includes the scopes the Import Tool needs. For example, when you import data related to custom entities, include the following scopes:

Scope ID	Description
schema.schema_read	Read mixin schemas
schema.custominstance_read	Read custom instance of all types
schema.custominstance_manage	Manage custom instance of all types
importtool.import_trigger	Trigger Import Tool imports
importtool.import_manage	Manage Import Tool imports

1

Open Access Controls

In Management Dashboard, go to Administration -> Access Controls.

2

Create or edit an access control

Create a new access control, or open an existing one that you want to use for imports.

3

Assign scopes

On the Scopes tab, choose + Assign Scopes and add the scopes your import use case requires. Then choose Save.

Scopes assigned to the Import Users access control, including Import Tool and schema permissions

User group

Create a user group with the import access controls, or update an existing group by assigning the additional access controls for the Import Tool.

1

Open Users and Groups

In Management Dashboard, go to Administration -> Users and Groups and open the Groups tab.

2

Create or edit a group

Create a new group, or open an existing group that can run imports.

3

Assign access controls

In Access Controls Assignment, choose + Assign Access Controls and add the access control that contains the Import Tool scopes. Then choose Save.

4

Assign members

On the Members tab, add the users who can use the Import Tool.

The Import Users group with the Import Tool and schema access controls assigned

Import Tool perspective

Grant the relevant user group access to the Import Tool perspective so members can open the Import Tool in the Management Dashboard.

1

Open Perspectives

In Management Dashboard, go to Administration -> Perspectives.

2

Edit the Import Tool perspective

Open the Import Tool perspective.

3

Assign the user group

In Allowed Groups, add the user group that has the Import Tool access controls. Confirm that the perspective is Active, then choose Save.

The Import Tool perspective with the Import Users group added under Allowed Groups

• To learn more about access controls, see Access Controls.
• To learn more about managing users and groups, see Users and Groups.
• To learn more about perspectives, see Perspectives.