Configure VideoWall widget dataset
The widget dataset specifies the data source from which the widget retrieves information to display. In the case of the VideoWall widget, the dataset contains a dynamic list of cameras to be displayed on the video wall, along with their corresponding connection details. These details are stored in a tabular CSV format.
As with all datasets, the video wall dataset may require an input parameter that is to be provided at run-time. This may be a geographical region or an individual city ID, so that only the cameras relating to this region are displayed on the video wall.
If the dataset uses input parameters to dynamically update its content then you can specify the event(s) on which the information from the data source should be updated. For example, you can specify that the information should be updated when the user selects a different Region from the Region filter.
Note
For VideoWall widgets, although you normally specify a dataset containing details of the videos to display, you don't have to. You can instead supply these details in the Video option in Admin Panel.
If the widget configuration dialog box is not already open, do as follows:
If the widget is on a Grid layout dashboard, click the Menu icon
in the top right-hand corner of the widget and select Settings.If the widget is on a Fluid layout dashboard, on the floating toolbar for the widget, click the Settings icon:
.
In the widget configuration dialog box, click the Dataset tab.
Click New Dataset.
A new dataset is created for you to configure.
On the left-hand side of the tab, you can rename the dataset. Click the Actions icon
and then click the Edit icon. Enter the new name and click the Update icon.You can also translate this text by clicking on the Translate icon
and entering the translation of the desired language selected. Auto-suggestions are also available where the reused contents are auto-suggested.
In the Data Source box, select the data source from which you want to display information. The list is populated with the data sources that have already been set up and is automatically filtered on the data source type that is appropriate for the widget type. For the VideoWall widget, only CSV datasets will be displayed.
If you need to, you can edit the data source by clicking the Edit icon
next to the Data Source box.Note
For a VideoWall widget, the dataset must contain the following columns:
name - the camera name to be displayed at the bottom of the video.
rtsp - the Real-time Streaming Protocol (RTSP) URL for the corresponding video stream.
id - a unique identifier for the camera.
latitude - the GeoJSON latitude coordinate for the camera position.
longitude - the GeoJSON longitude coordinate for the camera position.
status - a textual description of the camera status.
If the Request Parameters drop-down panel appears on the right-hand side, you must supply parameters to the data source to enable the widget to display information. Click Request Parameters.
Enter the default values for the parameters. These are the values that will be passed to the data source when the widget loads data for the first time.
Click Submit.
The preview pane in the upper half of the dialog box is updated with information from the data source.
Click Data Refresh Settings. In the Custom Events box, select the event(s) on which the information from the data source should be updated. The default events are as follows:
MAP_ENTITY_CLICK The user clicks a marker on a map widget.
DASHBOARD.REGION_CHANGE_EVENT The user selects a different Region from the Region filter.
DASHBOARD.DATE_RANGE_CHANGE_EVENT The user selects a different time period from the Date filter.
TABLE.SELECT_ROW_EVENT The user selects a row in a datagrid widget.
DASHBOARD.LANG_CHANGE_EVENT The user selects a different language from the Language drop-down at the top of the main screen.
DASHBOARD.GENDER_CHANGE_EVENT The user selects a different gender from the Gender filter.
DASHBOARD.AGE_RANGE_CHANGE_EVENT The user selects a different age range from the Age Range filter.
DASHBOARD.GRANULARITY_CHANGE_EVENT The user selects a different granularity from the Granularity filter.
Note that to enable MAP_ENTITY_CLICK or TABLE.SELECT_ROW_EVENT to work, you must also set up a corresponding Action in the map or datagrid widget to trigger this event. See Configure map widget actions or Configure datagrid widget columns.
The Mappings boxes indicate the parameters that are passed when an event occurs. They are already populated with the names of the parameters whose values are needed by the data source.
To enable the dataset to be updated at a regular frequency, select the Time check box and enter the time after which the dataset should be updated.
To disable the initial loading of data, select the Disable initial load check box so that only the dataset data will be loaded. This will improve the performance. However, this should be enabled only when one widget data changes depending on another widget data selection ie; parent-child widgets.
To enter a custom text to show before the widget is fully configured, enter it in Custom widget message.
Additionally, click Security Settings. In the Select Domain drop-down, select any of the domain that was created in the Definitions->Domains section. The widget created for the domain selected will be accessible only for the role to which it is assigned. For example, a Parking Widget can be accessed by only the parking operator and the default operator.
Click Update.