Bosch IoT Insights

Calendar widget

Using the Calendar widget, you can create bookings for devices. You can also create bookings for appointments that do not have to be linked to devices. The calendar can be displayed by month, week, or day.

Use Cases:

  • Repairs

  • Maintenance

  • Scheduled tests

  • Flexible tests

The calendar widget offers three display modes:

  • Calendar mode

  • Timeline mode

  • Table mode

Example

images/confluence/download/attachments/1698701064/widget_calendar_example_2021_04_22.png

Proceed as follows

  1. Select the Calendar widget in the widget list.
    → The widget configuration page is displayed.

    images/confluence/download/attachments/1698701064/widget_calendar_configuration_2021_04_22.png
  2. Configure the settings as described below.

  3. Click the Add button.
    → The widget is added to the dashboard.

Dashboard Settings

Open the Dashboard Settings pane to set how the widget is displayed in the dashboard.

  1. In the Size drop-down list, decide how much space the widget should take in the form of columns.

  2. In the Visibility drop-down list, decide whether the widget should be shown or hidden in the dashboard.

  3. In the Title field, enter a title for the widget.

Data Sources

Open the Data Sources pane to configure the display of devices.

  1. When connected to the Filter Panel widget:

    • In the Pagination Limit field, enter the number of devices to be displayed.

    • In the Sort field, enter a parameter to sort the displayed devices.

    • In the Filter field, enter a custom Things Filter to filter your devices.

  2. When disconnected from the Filter Panel widget:

    • In the Select Device Types drop-down list, select a device type.

    • In the Advanced Settings, you can specify more values as indicated in the Data Sources - Multiple Devices section.

Calendar Configuration

Open the Calendar Configuration pane to set how the widget is displayed by default.

  1. In the Default Display Mode drop-down list, select one of the following display modes to be set as default:

    • Calendar Mode: Displays the calendar as usual.

    • Timeline Mode: Displays the resources and their bookings in the calendar.

    • Table Mode: Displays the bookings in a table.

  2. Activate the Connect to filter widget checkbox to connect the Calendar widget with the Filter Panel widget.

    This checkbox is only available if the Filter Panel widget has been configured on the dashboard.

  3. Activate the Custom device details links checkbox to define a custom link that leads to the device details.
    → The device details page is configured as default.

    1. To change the link of the Default device details page, define a default URL with query parameters that will be displayed for all devices.

    2. To add a custom URL for a specific device type, click the Add Custom Device Type URL drop-down list and select a device type.

      1. In the Custom device details page field, define the custom URL with query parameters.

        You could also add a link to a view that shows the details of the device.

      2. Repeat the steps if you want to add a custom link for another device type.

  4. Activate the Extended device details checkbox to display device properties in the calendar booking.

    1. In the Type drop-down list, select a device type.

    2. In the Add properties drop-down list, select the device property.

      Add a maximum of five device properties per device type to ensure a good user experience when displaying the calendar booking.

      → The device type and the corresponding device properties are added grouped by device type.

      To change the order of the device properties, click the move icon and drag and drop the device property to the desired location.

      To delete a device property, click the delete icon in the line of the desired device property.

  5. If you have configured device types to be mandatory for calender bookings, you can set a custom filter for these devices.

    1. Open the Custom filter for Mandatory Devices pane to configure the filter.
      → The device types set to mandatory are displayed.

    2. Add a filter using query parameters to the field, such as like(features/general/properties/name,"*${filterParams.test}*").

  6. Open the Advanced Settings drop-down menu to define a default filter for the devices that shall be displayed for booking.

    1. In the Default Device Filter field, enter a default device filter, such as eq(attributes/type,”car”).
      → The filter is displayed in the Booking dialog.

    2. Activate the Hide device filter in the booking dialog checkbox to hide the Advanced Settings section in the Booking dialog.

      Use this checkbox if the filter should neither be accessed nor edited.