6 Add and Manage Vehicles

In Oracle IoT Fleet Monitoring Cloud Service , a vehicle is any conveyance such as a car or truck that is used to transport goods to customers. Fleet vehicles are groups of cars or trucks that are owned or leased by a business, government agency, or other organization. To monitor the location or operational parameters of a vehicle with Oracle IoT Fleet Monitoring Cloud Service, a data logger must be connected to the OBD-II port of the vehicle and configured to communicate with Oracle IoT Fleet Monitoring Cloud Service.

Vehicles are a critical component of your business operations. Using Oracle IoT Fleet Monitoring Cloud Service to manage these expensive assets effectively can help your business realize these benefits:

• Vehicle security. You know where every vehicle is located at all times.

• Cost efficiency. Assign vehicles to a route that avoids unnecessary stops and idling.

• Driver safety. You know where your drivers are and how long they have been working.

• Vehicle utilization. You can make sure every vehicle is operating and not sitting idle in a parking lot.

Note:

If you are using multiple organizations, the vehicles and vehicle types created within an organization are not available to other organizations.

Create a Vehicle Type

Create vehicle types to group vehicles with similar attributes. Grouping vehicles with similar attributes can simplify performance management.

1. Click Menu (), and then click Design Center.
2. Select Vehicle Types from the Design Center sub-menu.
3. Click Create Vehicle Type ().
4. Enter a name for the vehicle type.
5. (Optional) Complete these fields:
   • Description : Enter a a description for the vehicle type.
   • Make: Enter the make of the vehicle.
   • Model: Enter model information for the vehicle.
   • Year: Enter the year of manufacture for the vehicles. Multiple selections are allowed
   • Category: Select either Truck or Car as the vehicle category. If you do not specify a value for the Category field, then Truck is used as the default transport mode to fetch the route from map provider. If no route is found for Truck category, then the map provider tries to fetch a route for Car category.

     Note that Oracle Maps supports vehicle categories Truck and Auto. So any category value other than Truck is considered as Auto.

6. (Optional) To add an image to the vehicle type, click Upload Image, browse to the location of the image, and then double-click it.
7. (Optional) To add custom attributes to the vehicle type, click () next to Attributes and then complete these fields:
   • Name: Enter a name for the attribute.
   • Required: (Optional) Select this option to make an attribute required for the vehicle type.
   • Type: (Optional) Select one of these attribute types: Text, Number, Date, True/False, Image, and URI.
   • Allowed Values: (Optional) Select or enter the allowed values for the attribute.
   • Default: (Optional) Enter the default value for the attribute.
   • Instructions: (Optional) Enter instructions for the attribute.
8. Click Create to create the custom attribute.
9. Select sensor attributes for the vehicle type:
   1. Select predefined sensor attributes from the list that are supported by your device, click Select Device Model, select a device model, and then click Select.
      The selected sensor attributes are mapped to their corresponding device model attributes. If required, edit a mapping by clicking Edit ( and click Update.
   2. To add other sensor attributes supported by your device, click () provide a name for the attribute, select the device model, and then click Create.
      You can select if the sensor attribute is a Required attribute for all vehicles of the vehicle type.
10. Click Save.
    If there are unconfigured sensor attributes, a dialog appears confirming if you want to remove the unselected sensor attributes from the sensor attributes list. Click OK to remove the unselected sensor attributes.

Edit a Vehicle Type

Edit a vehicle type to edit, add, duplicate, or remove vehicle type settings including the vehicle type name, description, image, attributes, device model reference, and sensor attributes.

1. Click Menu (), and then click Design Center.
2. Select Vehicle Types from the Design Center sub-menu.
3. In the left pane, select a vehicle type on the Vehicle Types dashboard.
4. Click Edit () against Description.
5. If the Edit Vehicle Type Warning dialog appears, click Yes.
6. (Optional) To view dependency information, click a dependency in the Dependencies area.
7. (Optional) Edit the Name, Description , Make, Model, Year. or Category fields.
8. (Optional) Click Upload Image to add a new image for the vehicle type, or click Delete to delete the existing image.
9. (Optional) Select one of these options in the Attributes area:
   • Click Add () to add a new attribute.
   • Click Edit () to edit an existing attribute.
   • Click Duplicate () to quickly copy the settings of an existing attribute to a new attribute.
   • Click Delete () to delete an attribute.
10. (Optional) Select one of these options in the Sensor Attributes area:
    • Click Add () to add a new sensor attribute.
    • Click Edit () to edit an existing sensor attribute.
    • Click Delete () to delete a sensor attribute.
    • Select the sensor attribute and then click Select Device Model to change the device model associated with the sensor attribute.
11. Click Save.
12. (Optional) Click Back to return to the Vehicle Types dashboard.

View Vehicle Type Dependencies

View vehicle type dependencies to view the trips, vehicles, rules, and shipments currently associated with the vehicle type. These dependencies can help you determine if the vehicle type is used frequently. If it is not in use or used frequently, consider deleting it.

1. Click Menu (), and then click Design Center.
2. Select Vehicle Types from the Design Center sub-menu.
3. In the left pane, select a vehicle type on the Vehicle Types dashboard.
4. Click Edit ().
5. If the Edit Vehicle Type Warning dialog appears, click Yes.
6. To view dependency information, click a dependency icon in the Dependencies area.
7. Click Back to return to the Vehicle Types dashboard.

Duplicate a Vehicle Type

Duplicate a vehicle type to quickly copy the settings of an existing vehicle type to a new vehicle type.

1. Click Menu (), and then click Design Center.
2. Select Vehicle Types from the Design Center sub-menu.
3. In the left pane, select a vehicle type on the Vehicle Types dashboard.
4. Click Duplicate ().
5. Enter a name for the vehicle type in the Name field and then modify the other vehicle type settings including the image, attributes, device model, and sensor attributes.
6. Click Save.
7. (Optional) Click Back to return to the Vehicle Types dashboard.

Delete a Vehicle Type

Delete a vehicle type when it is no longer required. Delete all associated KPIs, and dependencies before deleting a vehicle type.

1. Click Menu (), and then click Design Center.
2. Select Vehicle Types from the Design Center sub-menu.
3. In the left pane, select a vehicle type on the Vehicle Types dashboard.
4. Click Delete ().
5. If the vehicle type does not have has dependencies, click Delete.
6. If the vehicle type has dependencies, the Existing Dependencies dialog appears. These dependencies must be removed before the vehicle type can be deleted.
   Click a dependency icon to view details of the dependency. Click Close to close the dialog.

Create a Vehicle

Create a vehicle when a new vehicle is added to your fleet.

1. Click Menu (), and then click Design Center.
2. Select Vehicles from the Design Center sub-menu.
3. Click Create New Vehicle ().
4. Complete these fields in the Details area:
   • Name: Enter a name for the vehicle.
   • Description : (Optional) Enter a a description for the vehicle.
   • VIN: Enter the vehicle identification number (VIN) for the vehicle.
   • Registration Number: Enter the vehicle registration number.
   • Type: Select the vehicle type. To create a vehicle type, see Create a Vehicle Type.
   • Make: Non-selectable field auto-populated when the a vehicle type is selected.
   • Model: Non-selectable field auto-populated when the a vehicle type is selected.
   • Vehicle Year: Select the year of manufacture for the vehicle.
5. Select or enter the custom attributes for the vehicle in the Custom Attributes area.
6. (Optional) Select the sensor attributes for the vehicle in the Sensor Attributes area and then select one of these options:
   • Click Link Device next to Sensor Attributes to use the same sensor device for all of the selected sensor attributes.
   • Click Link Device for each sensor attribute to use a specific sensor device for each sensor attribute.
   A sensor attribute is the data that is returned by the data logger that is connected to the OBD-II port of the vehicle.
7. Click Save.
8. (Optional) Click Back to return to the Vehicles dashboard.

Edit Vehicle Details and Device Sensor Attributes

Edit vehicle details and device attributes when vehicle information changes or you want to request new vehicle sensor data or replace a device assigned to a vehicle.

1. Click Menu (), and then click Design Center.
2. Select Vehicles from the Design Center sub-menu.
3. Select a vehicle and then click Edit ().
4. Edit these fields in the Details area:
   • Name: Enter a name for the vehicle.
   • Description : (Optional) Enter a a description for the vehicle.
   • VIN: Enter the vehicle identification number (VIN) for the vehicle.
   • Type: The vehicle type associated with the vehicle.
   • Registration Number: Enter the vehicle registration number.
   • Vehicle Year: Select the year of manufacture for the vehicle.
5. (Optional) Select or edit custom attribute values in the Custom Attributes area.
6. (Optional) Select new or existing sensor attributes in the Sensor Attributes area.

   If you have selected new sensor attributes, click Link Device against each new attribute to associate the sensor attribute with a device and device attribute.

   If you wish to replace existing sensor attribute associations, click Replace Device against each sensor attribute that you wish to associate with a replacement device.

7. Click Save.
8. (Optional) Click Back to return to the Vehicles dashboard.

View Vehicle Dependencies

View vehicle dependencies, such as vehicle trips and other dependencies, currently associated with the vehicle.

1. Click Menu (), and then click Design Center.
2. Select Vehicles from the Design Center sub-menu.
3. Select a vehicle and then click Edit ().
4. To view dependency information, click a dependency in the Dependencies area.
5. Click Back to return to the Vehicles dashboard.

Delete a Vehicle

Delete a vehicle when it is no longer required. Remove all dependencies before deleting a vehicle.

1. Click Menu (), and then click Design Center.
2. Select Vehicles from the Design Center sub-menu.
3. Select a vehicle in the Vehicles list.
4. Click Delete ().
5. If the vehicle type does not have has dependencies, click Delete in the confirmation dialog.
6. If the vehicle has dependencies, the Existing Dependencies dialog appears. These dependencies must be removed before the vehicle can be deleted. Select one of these options:
   • Click a dependency icon to view details of the dependency.
   • Click Close to close the dialog.

View Your Vehicles in the Operations Center

The operations center vehicle information dashboard displays information about vehicles in motion, unassigned vehicles, idle vehicles, and stopped vehicles. The dashboard includes vehicle availability and utilization information. You can also see any open incidents against the vehicles.

1. Click Menu and then click Operation Center.
2. Click Vehicles in the operation center toolbar.
   The list of vehicles appears along with the following vehicle details:

   • Vehicle Name.
   • Vehicle Model.
   • Registration Number.
   • Vehicle Type.
   • Assigned Driver.
   • Vehicle Status, such as In Motion or Idling.
   • Vehicle Availability Status shows if the vehicle is currently available.
   • Vehicle Utilization Status shows if the vehicle is currently utilized.
   • Open Incidents shows the count of open incidents for the vehicle and links to the incidents page.
   You can sort the vehicle list by clicking on the column headings. You can also filter the list to see the vehicles that fit your criteria.

View Vehicle Information and its Operational Status

Use the vehicle information page to view static vehicle details such as its make, model, year, vehicle category, VIN, and so on. You can also view the registration and related details associated with the vehicle. On the other hand, use the Dashboard page to quickly determine the operational status of a vehicle, including its current location, its speed, engine temperature, and fuel level.

Note:

The Vehicle Dashboard page will be deprecated in a future release. As an alternative, use the following pages:

• Vehicle Information page: Use this page to view static vehicle details such as its make, model, year, and so on. See the procedure described later in this topic for more information.
• Digital Twin page: Use this page to obtain a detailed view of the sensor data being sent from the vehicle to Fleet Monitoring. See View Vehicle Digital Twin Data for more information.
• Custom dashboard: Create a custom dashboard to track key metrics data for your vehicle. Manage and Monitor Custom Dashboards for Vehicle Types, Drivers, and Trips for more information.

1. Click Menu and then click Operation Center.
2. Click Vehicles in the operation center toolbar.
3. From the list of vehicles, identify the name of the vehicle that you want to view. Scroll to the last column of the records, hover your mouse, and then click the Information () icon.
   
   

   

   
   
   The vehicle dashboard page that displays the operational status of the vehicle is displayed.
4. To view the vehicle information page, from the left navigation bar, click Info (), which is the second icon on the navigation bar.
   
   

   

   
   

   You can use the toolbar to access various other vehicle details, such as the vehicle location on the map, vehicle incidents and alerts, trips associated with the vehicle, shipments associated with the vehicle, and sensors associated with the vehicle.

5. Use the breadcrumb navigation at the top to navigate to another vehicle or page in the operation center.

View Vehicle Incidents

Use the vehicle incidents dashboard to view incidents reported for a specific vehicle.

1. Click Menu and then click Operation Center.
2. Click Vehicles in the operation center toolbar.
3. Select a vehicle in the Vehicles list.
4. Click the View () icon.
5. Click Incidents in the toolbar to the left of the vehicle details.
6. To filter the incidents list, click a pie chart segment or use a search filter:
   1. Click Search ().
   2. Select Status, Priority, Type, Creation Date, Description, or Creation Date.
   3. Select additional search parameters.
   4. (Optional) Click Add () or Remove () to add or remove search filters.

View Vehicle Alerts

Use the vehicle alerts dashboard to view alerts reported for a specific vehicle. Alerts are issued when the requirements set for an alert condition are met or exceeded. For example, an alert is issued when the vehicle engine temperature exceeds a specific limit.

1. Click Menu and then click Operation Center.
2. Click Vehicles in the operation center toolbar.
3. Select a vehicle in the Vehicles list.
4. Click the View () icon.
5. Click Alerts in the toolbar to the left of the vehicle details.
6. To filter the alerts list, click a pie chart segment or use a search filter:
   1. Click Search ().
   2. Select Alert Type, Rule Type, Severity, Creation Time, Description, or Driver Name.
   3. Select additional search parameters.
   4. (Optional) Click Add () or Remove () to add or remove search filters.

View Vehicle Trip Information

Use the vehicle trips dashboard to view the trips completed or in progress for a specific vehicle.

1. Click Menu and then click Operation Center.
2. Click Vehicles in the operation center toolbar.
3. Select a vehicle in the Vehicles list.
4. Click the View () icon.
5. Click Trips in the toolbar to the left of the vehicle details.
6. To filter the trips list, click a pie chart segment or use a search filter:
   1. Click Search ().
   2. Select Status, Start Time, ETA, Source, Destination, Stops or Trip Length.
   3. Select additional search parameters.
   4. (Optional) Click Add () or Remove () to add or remove search filters.

View Vehicle Digital Twin Data

View the vehicle’s digital twin data to obtain a detailed view of the sensor data being sent from the vehicle to Oracle IoT Fleet Monitoring Cloud Service.

1. Click Menu and then click Operation Center.
2. Click Vehicles in the operation center toolbar.
3. Select a vehicle in the Vehicles list.
4. Click the Information () icon.
5. Click Digital Twin in the toolbar to the left of the vehicle details.
   The digital twin view of the vehicle displays the list of sensor attributes and their values.

   
   
   

6. (Optional) To view the attributes in an order, click the Sort icon and select one of the following options:
   • Sort by Attribute Name (A-Z)
   • Sort by Attribute Name (Z-A)
   • Sort by Last Updated
7. (Optional) To search and display specific attributes, click the Filter icon to open the Filters dialog box.
   1. From the Filter drop down, select either Attribute Name or Attribute Value and then select a suitable operator such as contains, matches, does not contain, is, or is not.
   2. Enter a value in the Value text box and press enter.
   3. (Optional)Click Add to create additional filter conditions.
   4. Click Apply.
      The filtered results are displayed.
8. For a graphical view of an attribute over a time period, click the attribute value. On the graphical view select one of the following options from the Date Time Window drop down.
   • Live
   • 1 hour ago
   • 24 hours ago
   • 7 days ago
   • 14 days ago
   To disable or enable live refresh of attribute data from the sensor devices, on the top right corner of the window, click the Digital Twin Menu ... icon and select Disable Live Refresh or Enable Live Refresh.
   Review the data and click Close .