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.

About Organizations

An organization contains digital versions of all the IoT-enabled assets that are part of your business operations. An organization is also associated with its authorized set of users. Predefined roles determine the privileges of each application user.

Your Oracle IoT Production Monitoring Cloud Service instance includes a default organization. All your factories, machines, operators, products 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. The following image shows a business divided into regions. Each region, Asia-Pacific, Europe, and North America has its own set of assets and users.


Image shows three organizations, as described in the section.

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 assets and users.

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. Click Menu (Menu icon), and then click Design Center.
  2. Select Organization from the Design Center sub-menu.
  3. Click Switch/Manage Organizations.
  4. Click Create New in the Switch/Manage Organizations page.
    The Create Organization dialog appears.
  5. Specify a Name for your organization.
    For example, North America Operations.
  6. Specify an optional Description.
  7. Click Create.
    A confirmation banner appears, and the new organization is added to the list of existing organization.

Change Your Current Organization

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

  1. Click Menu (Menu icon), and then click Design Center.
  2. Select Organization from the Design Center sub-menu.
  3. Click Switch/Manage Organizations.
  4. Select the organization name that you wish to switch 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. Click Menu (Menu icon), and then click Design Center.
  2. Select Organization from the Design Center sub-menu.
  3. Click Edit (Edit icon) under Users.
  4. Under Users, select the users that you wish to include in the organization, and click the right-arrow icon (Right Arrow icon).
  5. Click Save to save the changes to the organization.

Export and Import Organizations

You can export an organization together with its constituent entities and settings. You can then import the organization into another Oracle IoT Production Monitoring Cloud Service instance.

When you export an organization, all constituents of the organization are exported. The factories, products, operators, machines, machine types, and the artifacts associated with the machine types, such as metrics, rules, anomalies, predictions, and trends are also exported. Any integration settings are also exported. Importing the organization into another instance creates the organization, together with its constituent entities, in the importing instance.

Note:

Import of organizations exported from previous releases is not supported. If you try to import a previously exported organization from an earlier release into the current release of Oracle IoT Production Monitoring Cloud Service, the import may fail.

Note that any devices connected to machines in the original instance are not included in the export. If you have machine types with mandatory sensor attributes, you would need to create new device links for the machines in the imported organization.

Export an Organization

Export an organization to create an iot export file containing the organization along with all its constituent entities and settings.

  1. Click Menu (Menu icon), and then click Design Center.
  2. Select Organization from the Design Center sub-menu.
  3. Click Switch/Manage Organizations.
  4. Select the organization name 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 another storage location.
    You will use this file when importing the organization into another instance of Oracle IoT Production Monitoring Cloud Service.

Import an Organization

Import an organization into an Oracle IoT Production Monitoring Cloud Service instance to create the organizational artifacts previously exported from another instance.

  1. Click Menu (Menu icon), and then click Design Center.
  2. Select Organization from the Design Center sub-menu.
  3. Click Switch/Manage Organizations.
  4. Click Import.
    The Import Organization dialog appears.
  5. Click Choose File and select a previously exported .iot archive file.
  6. Click Import.
The organization is imported along with its containing artifacts. The organization appears in the list of existing organizations.