1. Using Oracle Internet of Things Asset Monitoring Cloud Service
  2. Set Up Your Devices in Oracle Internet of Things Intelligent Applications Cloud
  3. Create Device Models in Oracle Internet of Things Intelligent Applications Cloud

Create Device Models in Oracle Internet of Things Intelligent Applications Cloud

The device model options for asset types are fetched from your Oracle Internet of Things Intelligent Applications Cloud instance.

The Oracle IoT Asset Monitoring Cloud Service application relies on your platform side Oracle Internet of Things Intelligent Applications Cloud for its device models. If you do not already have your device models set up in Oracle Internet of Things Intelligent Applications Cloud, you need to add the device models for your sensor devices.

Create a New Device Model

A device model is an interface that lets any device communicate with Oracle Internet of Things Intelligent Applications Cloud regardless of its manufacturer or operating system.

  1. Open the Oracle Internet of Things Intelligent Applications Cloud Management Console.

    You can access the Oracle Internet of Things Intelligent Applications Cloud Management Console from the following URL:

    https://hostname/ui

    Here, hostname is the host name of your Oracle Internet of Things Intelligent Applications Cloud instance.

  2. Click the Menu (Menu icon) icon.
  3. Select Devices and then select Model.
  4. Select one of these options:
    • If you have not previously created a device model, click Create Device Model.
    • If you have previously created a device model, click the Add (Add icon) icon.
  5. Complete these fields:
    1. Name: Enter a name for the device model.
    2. Description: Enter an optional description for the device model.
    3. URN: Enter a unique identifier for the device model. Use this format: urn:com:<mycompany>:<mydevice>:<what the device model does>.
  6. Select system attributes for the device model.
  7. (Optional) Add custom attributes for the device model:
    1. Expand the Custom Attributes option list.
    2. Click the Add (Add icon) icon.
    3. Enter a name for the custom attribute in the Name field.
    4. Enter an optional description for the custom attribute in the Description field.
    5. Select a data type in the Type list.
    6. Select Writable if you want to make the custom attribute writable.
    7. Click OK.
  8. (Optional) Define the actions that can be invoked on the device:
    1. Expand the Actions option list.
    2. Click the Add (Add icon) icon.
    3. Enter a name for the action in the Name field.
    4. Enter an optional description for the action in the Description field.
    5. Select the data type for the action in the Arguments list.
    6. Enter an optional alternate name for the action in the Alias field.
    7. Click OK.
  9. (Optional) Create alerts and custom message formats for the device model:
    1. Expand the Alerts and Custom Messages option list.
    2. Click the Add (Add icon) icon.
    3. Enter a name for the alert or custom message in the Name field.
    4. Enter an optional description for the alert or custom message in the Description field.
    5. Enter a unique identifier for the alert or custom message in URN field. Use this format:urn:<mycompany>:<department>:<mydevice>:<device model>:<message>.
    6. Select a data type in the Type list.
    7. Click OK.
    8. Select the alert message format and then click the Add (Add icon) icon in the Fields column.
    9. Enter a name for the message type in the Name field.
    10. Select a data type in the Type list.
    11. Select Optional to indicate the field value can be missing in the device model message format.
    12. Click OK.
  10. Click Save.

Import a Device Model

If you have previously exported a device model, you can import the .json file into Oracle Internet of Things Intelligent Applications Cloud.

  1. Open the Oracle Internet of Things Intelligent Applications Cloud Management Console.

    You can access the Oracle Internet of Things Intelligent Applications Cloud Management Console from the following URL:

    https://hostname/ui

    Here, hostname is the host name of your Oracle Internet of Things Intelligent Applications Cloud instance.

  2. Click the Menu (Menu icon) icon.
  3. Select Devices and then select Model.
  4. In the Device Models tab, click the Import (Import Icon) icon.
  5. Click Choose File and select the .json file to import.
  6. Click Import to import the device model.

Duplicate a Device Model

Duplicate a device model to quickly copy the settings of an existing device model to a new device model.

  1. Open the Oracle Internet of Things Intelligent Applications Cloud Management Console.

    You can access the Oracle Internet of Things Intelligent Applications Cloud Management Console from the following URL:

    https://hostname/ui

    Here, hostname is the host name of your Oracle Internet of Things Intelligent Applications Cloud instance.

  2. Click the Menu (Menu icon) icon.
  3. Select Devices and then select Model.
  4. Click the Duplicate (Duplicate icon) icon.
  5. Complete these fields:
    1. Name: Enter a new name for the device model.
    2. Description: Enter an optional description for the device model.
    3. URN: Enter a new unique identifier for the device model. Use this format: .
  6. Select system attributes for the device model.
  7. (Optional) Add or edit the custom attributes for the device model.
  8. (Optional) Add or edit the actions that can be invoked on the device
  9. (Optional) Add or edit the alerts and custom message formats for the device model:
  10. Click Save.

Edit a Device Model

Edit a device model to edit, add, duplicate, or remove device model settings including the device model name, description, and attributes.

  1. Open the Oracle Internet of Things Intelligent Applications Cloud Management Console.

    You can access the Oracle Internet of Things Intelligent Applications Cloud Management Console from the following URL:

    https://hostname/ui

    Here, hostname is the host name of your Oracle Internet of Things Intelligent Applications Cloud instance.

  2. Click the Menu (Menu icon) icon.
  3. Select Devices and then select Model.
  4. Click the Edit (Edit icon) icon.
  5. Edit the device model settings.
  6. Click Save.

View the Devices Associated with a Device Model

View the devices associated with the device model to determine how many devices are using the device model.

  1. Open the Oracle Internet of Things Intelligent Applications Cloud Management Console.

    You can access the Oracle Internet of Things Intelligent Applications Cloud Management Console from the following URL:

    https://hostname/ui

    Here, hostname is the host name of your Oracle Internet of Things Intelligent Applications Cloud instance.

  2. Click the Menu (Menu icon) icon.
  3. Select Devices and then select Model.
  4. Click the Device (Device icon) icon.

Print Device Model Settings

Print the device model settings to view a hard copy of the device model settings.

  1. Open the Oracle Internet of Things Intelligent Applications Cloud Management Console.

    You can access the Oracle Internet of Things Intelligent Applications Cloud Management Console from the following URL:

    https://hostname/ui

    Here, hostname is the host name of your Oracle Internet of Things Intelligent Applications Cloud instance.

  2. Click the Menu (Menu icon) icon.
  3. Select Devices and then select Model.
  4. Click the Print (Print icon) icon.
  5. Select a printer.
  6. Click OK.

Export Device Model Settings

Export the device model settings to use the device model settings in another application or to save a copy of the device model settings as a backup in case of a system failure.

  1. Open the Oracle Internet of Things Intelligent Applications Cloud Management Console.

    You can access the Oracle Internet of Things Intelligent Applications Cloud Management Console from the following URL:

    https://hostname/ui

    Here, hostname is the host name of your Oracle Internet of Things Intelligent Applications Cloud instance.

  2. Click the Menu (Menu icon) icon.
  3. Select Devices and then select Model.
  4. Click the Export (Export icon) icon.
  5. Click Save File.
  6. Click OK.
  7. Browse to a location to save the file.
  8. Click Save.

Delete a Device Model

Delete a device model when it is no longer required.

  1. Open the Oracle Internet of Things Intelligent Applications Cloud Management Console.

    You can access the Oracle Internet of Things Intelligent Applications Cloud Management Console from the following URL:

    https://hostname/ui

    Here, hostname is the host name of your Oracle Internet of Things Intelligent Applications Cloud instance.

  2. Click the Menu (Menu icon) icon.
  3. Select Devices and then select Model.
  4. Click the Delete (Delete icon) icon.

    A warning appears if the device model is in use. If you delete the device model, the related message flows, explorations, integrations, and device message links are affected as well.

  5. Click Continue.