15 Customize Your Application

Add a corporate logo or modify the application name to personalize your application. Use the Settings page in Oracle IoT Intelligent Applications Cloud Service to manage your application storage and capacity.

The data usage and capacity settings are shared between all the applications that you are using under Oracle IoT Intelligent Applications Cloud Service.

Show or Hide the Application Name

Show or hide the application name when business requirements change.

1. In the Operations Center, click Menu (), and then click Settings.

   Note:

   If you wish to change the appearance for an individual organization only, navigate to Menu > Settings > IoT Organizations > Organization Name.
2. Click Appearance on the Settings page.
3. Select one of these options:.
   1. Select Show Application Name to display the application name on all application pages.
   2. Clear Show Application Name to remove the application name from all application pages.
4. Click Save.

Add or Update an Application Logo

Add or update corporate logos when business requirements change or a new corporate logo is issued.

1. In the Operations Center, click Menu (), and then click Settings.

   Note:

   If you wish to change the appearance for an individual organization only, navigate to Menu > Settings > IoT Organizations > Organization Name.
2. Click Appearance on the Settings page.
3. Under Title Bar Logo, select Custom.
   Under Image, click the Drag and Drop area to select an image file to upload. Alternatively, you can also drag and drop the image file to the Drag and Drop area in your browser window.
4. Click Save.

Remove an Application Logo

Remove a logo when an application logo is no longer required.

1. In the Operations Center, click Menu (), and then click Settings.

   Note:

   If you wish to change the appearance for an individual organization only, navigate to Menu > Settings > IoT Organizations > Organization Name.
2. Click Appearance on the Settings page.
3. Under Title Bar Logo, select None.
4. Click Save.

Set Default Units of Measure

Set the default units of measurement for your application. You can select between the US Imperial and Metric unit systems.

1. In the Operations Center, click Menu (), and then click Settings.

   Note:

   If you wish to change the measurement units for an individual organization only, navigate to Menu > Settings > IoT Organizations > Organization Name. For example, you may want to set different measurement units for your US and Europe organizations.
2. Click Units and Measurement.
3. Click Edit to change the unit system.
4. Under Unit System, select between US Imperial and Metric.
   The US Imperial setting uses the following units for Distance, Speed, Temperature, and Volume respectively: Miles, Miles per Hour, Fahrenheit, and Gallons.
   The Metric setting uses the following units for Distance, Speed, Temperature, and Volume respectively: Kilometers, Kilometers per Hour, Celsius, and Liter.
5. Click Save.

Change the Map Provider

You can change the map provider to replace Oracle maps with the maps provided by a third-party map provider. Currently, only maps provided by HERE Technologies are supported. When you change the map provider, the maps in the Oracle IoT Connected Worker Mobile Application are also updated.

Note:

To change the map provider, you must be an administrator. To review the Oracle maps terms of use, see Oracle Maps Cloud Service Enterprise Hosting and Delivery Policies.

1. In the Operations Center, click Menu () and choose Settings .

   Note:

   If you wish to change the map provider for an individual organization only, navigate to Menu > Settings > IoT Organizations > Organization Name.
2. Click Map Provider.
3. Select one of these options in the Map Provider list:
   • Oracle Maps: (Default) Select this option to use the maps provided by Oracle.
   • HERE Maps: Select this option to use the maps provided by HERE Technologies.
4. Enter your HERE Technologies application ID in the Application ID field.
5. Enter your HERE Technologies application code in the Application Code field.
6. Click Save.

Monitor Data Storage and Manage Capacity Usage

As an administrator, you can monitor the data storage for your Oracle IoT Intelligent Applications Cloud Service. Use the Data Storage page to review storage data in the system, to set up or adjust the time window for data retention, and to run data deletion jobs.

Note:

If you are using more than one application in Oracle IoT Intelligent Applications Cloud Service, then the data storage settings are shared between these applications. Also, any operations that you perform under data management, such as tweaking data life spans or creating deletion jobs, affects data in all these applications.

So, for example, if you are using the Oracle IoT Asset Monitoring Cloud Service and Oracle IoT Production Monitoring Cloud Service applications, the data usage includes usage across both these applications. Also, if you were to delete metric data older than, say, 30 days, then metric data that is older than 30 days is deleted in both your applications.

When you log in to your IoT application as an administrator, a notification appears with details on the storage capacity used. Notifications may also appear periodically for every 10% of capacity that is used up. High-priority notifications are sent after you have used up more than half of the storage capacity. You can use the Data Storage page to manage your storage capacity.

The Storage Management option under application Settings lets you monitor and manage the data storage for your application. The Data Storage page has the following sections:

• Summary: Shows you the total data storage capacity available for your account, and the currently used up capacity. Depending on your current usage, the status is indicated using one of the following colors:
  • Green: Indicates that more than 50% of the available capacity remains.
  • Orange: Indicates that between 25% and 50% of the available capacity remains. A recommendation on ways to manage your data is also included.
  • Red: Indicates that less than 25% of the available capacity remains, and you must take steps to manage your storage data.
  
  
  
  
  
• Data Management: Lets you manage data, change settings, and create data deletion jobs. The data capacity usage percentages are shown category-wise:
  • Device Data: Comprises application messages, connector messages, integration-related messages, log messages, and other related messages.

    Device data is stored for 30 days, by default.

  • Training Data: Comprises incoming sensor data, visualization and training data.

    By default, training data is stored indefinitely in the system until manually deleted.

  • Custom Metric Data: Comprises data specific to custom metrics or KPIs. Custom metrics are metrics that you create in the application for your production environment and scenarios.

    By default, custom metric data is stored indefinitely in the system until manually deleted.

  • System Metric Data: Comprises data specific to system metrics or KPIs. System metrics are the built-in metrics that are calculated automatically in your application.

    System metric data is stored for 90 days, by default.

  You can select the data life span for each category. The data life span is the time period for which data is retained.

  You can choose to create data deletion jobs to delete selective data. A data deletion job lets you select the data type and time span for which you wish to delete data.

Perform Data Management Tasks

Use the Data Management section to manage data storage settings for your application. You can select the data life span for the various data types. You can also create data deletion jobs to delete selective data.

1. Click Menu () and then click Settings .
2. Click Storage Management.
   The Data Storage page appears.
3. To change the data life span, click Edit under Data Life Span.
   The Data Life Span section appears under the Data Management section.
   1. Select the data life span for Device Data, Training Data, Custom Metric Data, and System Metric Data.
      
      

      

      
      
   2. Click Save to save your settings.
4. (Optional) To run a data deletion job, click Create Data Deletion Job.
   1. Select one or more data types for which you wish to delete data.
      The available choices are:

      • Device Data
      • Metric Data
      • Training Data
   2. Under Delete Data, choose the time period for which you wish to delete the data.
      For example, you may want to delete training data that is Older than 30 days.

      You can also choose a custom Time Range for which to delete data. For example, you may wish to delete data for a particular day or hour.

   3. Click Delete to create the delete job.
      You can monitor the job progress, and the number of records that were deleted, under the Data Deletion Jobs section. When the data delete job completes, its status changes from In Progress to Completed.
      You can also choose to delete a data deletion job. If the job is still running when you delete it, then the job is terminated and deleted. If the job has already failed or completed, then deleting the job simply removes it from the list of failed or completed jobs.