3 Create and Manage Organizations

Organizations are digital twin versions of your business. These are digital placeholders for the various heterogeneous entities that you have in your business, the locations where these entities operate from, and the associated users of these entities.

Your Oracle IoT Connected Worker Cloud Service instance includes a default organization. Your projects, locations, rules and other entities are created in the default organization. You can create additional organizations if you need multiple business domains.

Your application can contain one or more organizations. For example, businesses often divide organizational operations based on geography.

You may also want to have multiple organizations if you manage several clients, and you need to separate these clients into sub-tenants, so that each sub-tenant has its own set of projects and locations.

Create a New Organization

Organizations are digital placeholders for the various heterogeneous entities that you have in your business, the locations where these entities operate from, and the associated users of these entities.

This operation is meant for application administrators only. Log in using the administrator account to create organizations in your application.

1. In your IoT application, click Menu (), and then click Settings.
2. Click IoT Organizations, and then click Manage Organizations.
3. Click Create Organization in the Manage Organizations page.
   The Create Organization dialog appears.
4. Specify a Name for your organization.
   For example, North America Operations.
5. Specify an optional Description.
6. Click Create.
   The new organization is created along with its required artifacts. The operation status appears on the IoT Organizations page until the organization is ready for use.

Change Your Current Organization

If you are part of more than one organization, then you can change your current organization in the application.

1. In your IoT application, click Menu (), and then click Settings.
2. Click IoT Organizations, and then click Manage Organizations.
3. Click Switch Organization in the Manage Organizations page.
4. Under Switch To, select the organization name that you wish to change to, and click Switch.
   The current organization is changed in the Design Center and Operations Center.

Assign Users to an Organization

Edit the organization to add or update the list of authorized users for the organization.

If you need to assign users to an organization other than your current organization, then make sure that you switch to the organization before performing the following steps. See Change Your Current Organization for more information on switching organization contexts.

1. In your IoT application, click Menu (), and then click Settings.
2. Click IoT Organizations, and then click your organization name.
3. Click User Access Control on your organization page.
4. Under Users, select the users that you wish to include in the organization, and click the right-arrow icon ().
   The selected user moves to the list of authorized users.
   Tip: You can hold down the Ctrl key to select multiple users at a time.
5. Click Save to save the changes to the organization.

Delete an Organization

Only administrators can delete organizations. Log in using the administrator account to delete an organization in Oracle IoT Connected Worker Cloud Service.

Note:

Deleting an organization also deletes its projects, locations, and other entities.

1. In your IoT application, click Menu (), and then click Settings.
2. Click IoT Organizations, and then click Manage Organizations.
3. Click Delete Organization in the Manage Organizations page.
   The Delete Organization dialog appears.
4. Select the organization name that you wish to delete, and click Delete.

   Note:

   You cannot delete the organization that you are currently in. You must switch to another organization before you can delete the organization.

Export and Import Organizations and Settings

Export entities and settings from your application instance to import them into another instance. For example, you may wish to copy your entities and settings from a test instance to a production instance.

When you export an organization, the application adds all the organization entities, such as projects, workers, locations, hazards, and rules to the export file, together with the organization configuration settings. In addition, the application also exports your global configuration settings and global entities, such as certifications and wearable types.

Note:

For sensitive user data to be successfully imported into the target system, the target system must have the same user name with privileges equal or greater than the exported user. If the importing system doesn't have the same user with equal or greater privileges, the import of dependent entities for that user is skipped.

The application log dialog provides detailed information on the export and import. If the user browser uses a language other than English, and if the language is in the list of supported languages for Oracle IoT Intelligent Applications Cloud Service, then the log messages are shown in the user's language.

Export an Organization

Exporting an organization creates an iot export file that contains all the organizational entities, such as projects, workers, locations, hazards, and rules. The export file also contains your global configuration settings and entities, such as certifications and wearable types.

1. In your IoT application, click Menu (), and then click Settings.
2. Click IoT Organizations, and then click Manage Organizations.
3. Click Export Organization in the Manage Organizations page.
   The Export Organization dialog appears.
4. Select the Organization that you wish to export, and click Export.
   A .iot archive of the organization is generated.
5. Save the generated .iot archive file to your hard disk or a storage location.
   You will use this file when importing the organization into another instance of your IoT application.

Import an Organization

Import a previously exported iot file into your target instance to create the organizational artifacts exported from the source instance. The exported configurations are also imported.

1. In your IoT application, click Menu (), and then click Settings.
2. Click IoT Organizations, and then click Manage Organizations.
3. Click Import Organization in the Manage Organizations page.
   The Import Organization dialog appears.
4. Under Upload File, click the Drag and Drop area to select a previously exported .iot archive file. Alternatively, you can also drag and drop the archive file to the Drag and Drop area in your browser window.
5. Click Done.

The organization is imported along with its containing artifacts. The organization appears in the list of existing organizations.