Updated Tutorial Available
This tutorial is for the Desktop Designer. To view the updated tutorial for the online project designer, please click here .

Session List Options

Learn how the your projects can be configured to display sessions in different formats such as a list, a map or a calendar.

What are Session List Options?

When a project is opened on a mobile device, the user will see a list of sessions that have been created for that project. The project can be configured to display these sessions in a different format by configuring the Session List Options tab in the project's properties. These options can be used to display the sessions on a map using GPS coordinates from each session or on a calendar using a datetime point and a duration.

Key Features

  • Can be configured to display a map of sessions, plotting each session using a GPS point's coordinates.
  • Can display a KML overlay on a map view to provide additional information on the map view.
  • Can be configured to display sessions on a day or week calendar, by using a datetime and duration.

Ios session list view options

Configuration and Settings

A project's session list options can be configured in the Mobile Data Anywhere Designer to customise the way that the session list can be displayed on the mobile device. Below is an example of the properties window for a project, opened in the Mobile Data Anywhere Designer. The session list can be configured on the Session List Options tab.

Project session list options tab

View Sessions on Map

Selecting a point with GPS coordinates

To configure a project to display sessions on a map view, the project must contain a point that can be used to plot the coordinates of each session. The point must contain a value in the correct format in order for the session to be plotted on the map view. The required format is:

latitude,longitude

The simplest and quickest way to configure the map view is to use a GPS point that is configured to use the format:

%lat%,%long%

Once the point has been added to the project, the point will need to be selected as the point with the GPS coordinates, on the Session List Options tab.

Offline Maps and KML Overlays

KML can be used to add custom geographic features to the maps that are displayed on the mobile app. To learn how to add KML to your projects, see the KML Mapping documentation .

View Sessions on a Calendar

To configure a project to display sessions on a calendar view each session will need to provide enough information to create a calendar event. These events require a start date and time as well as a duration for the event.

Start Date/Time

The project must contain a Date/Time point with a valid format. For example:

{year}-{month:2}-{day:2} {hour-24:2}:{minute:2}:{second:2}

When a session is created on the mobile device, this Date/Time point will be used to set the starting date and time for the session's calendar event.


Sample Projects

This sample simulates an auditing form which is used to collect information from sites that have been reported for discharging hazardous substances into the local environment. This project has been configured to allow sessions to be displayed using any of the view modes; list, map and calendar view.


Sample Projects
You can download the sample files for this tutorial or import the projects directly into your account.

Sample 1: Displaying Sessions on a Map

This sample demonstrates how to configure a project to display sessions on a map view. The project contains a GPS point, Incident Location , which has been configured to use the format %lat%,%long% . The project's Session List Options have been configured to use this point to plot each session on a map. A KMZ file has also been added to the project which will be used to display an overlay on the map view. The overlay contains several images which are used to display the words California and USA on the Northa American continent, as seen in the screenshot on the right.

Project session list options tab
Ios usa ca overlay

On the mobile device, the user can view sessions on a map by selecting View As and then selecting Map View, as seen in the image below. This will display each of the sessions as a map marker, using the gps coordinates saved in each sessions Incident Location point. If a session does not have a value for the gps point, then it will not be displayed on the map view and the session will need to be edited from the list view.

Similar to the session list view, the user can open, edit, send, duplicate and delete sessions by selecting the session’s map marker. This view will display a summary of the session and the standard actions that are provided for a session.

Ios map view animation

Sample 2: Displaying Sessions on a Calendar

This sample demonstrates how to configure a project to display sessions on a calendar view. The project contains a Date/Time point, Date , which has been configured to use the format {year}-{month:2}-{day:2} {hour-24:2}:{minute:2}:{second:2} . This point is used to determine the starting date and time for the calendar event, for each session that is created in this project. The project also contains an Edit point which is used to determine the duration of each session's calendar event.

On the mobile device, the user can view sessions on a calendar by selecting View As and then selecting Calendar View. The user can choose to display the sessions for a calendar week or day. If a session does not have values for Date or Time Taken then the session will not appear on the calendar view and will need to be edited from the session list view.

See below for an example of how sessions can be viewed on a calendar:

Ios calendar animation