This tutorial is for the new, online project designer. The tutorial for the Desktop Designer is available here .

Sub Project Point

Learn how the sub project point can be used and see it in action with the sample projects.

What is the Sub Project point?

The sub project point can be added to an existing project which will allow you to select another project to be linked as a sub project. This creates a relationship between the two projects where the existing project is the parent of the sub project. When creating a session in the parent project, the user can create new sessions for the sub project that will belong to the parent session. When a parent session is sent, duplicated or deleted this action will also apply to the parent’s child sessions and any child sessions of those sessions and so forth. This useful point enables you to build a form where a parent session can contain many sub sessions and can be configured to copy data from the parent session into new sub sessions. The sub projects can be chained together with more sub projects to create a structure of your own design, with as many levels of sub projects as desired.

Key Features

  • Allows you to link multiple projects together so that sessions can be created in a sub project that are associated with a session in the parent project.
  • Supports adding multiple sub project points to a project to create many sub project relationships to the parent project.
  • Supports adding sub project points to child projects to create a hierarchy of sub projects.
  • Settings in the designer allow you to configure the language used to describe the relationship between the parent and sub projects to the users on the mobile device.
  • Can be configured to automatically copy data from a parent session into any newly created child session.

Common designs using the sub project point

Below is a diagram which demonstrates just some of the ways in which you can create a hierarchy of projects, using multiple sub project points. The diagram on the left shows the structure used in the sample projects that are used later in this tutorial to create the relationships between Buildings, Rooms and Assets.

The diagram on the right demonstrates a more advanced structure where a parent project, Sale, has multiple sub projects which also contain sub projects of their own.

Diagram heirarchies

Configuration and Settings

The sub project point can be configured in the Mobile Data Anywhere Designer to customise the labels and buttons that are displayed in the mobile application as well as to configure points to be shared with new child sessions. See below for details on each of this point's properties.

Sub project web properties

Sub Project Settings

Sub Project

This setting allows you to select a project from your web portal, to be used as a sub project.

Copy values into sub sessions

This allows you to select points from the parent project to be copied into new sub sessions. The sub project will need to have points with the same point ID names in order to store the values received from the parent project.

There are also some automatically populated values that can be accessed by adding a point to the sub project with the associated Point ID Name. These points can be added quickly to a project using the new Tools menu located in the Toolbox .


Sub project web tools
Tool Point ID Name Description
Parent Project Name __parent_project__ Stores the project filename of the parent project.
Parent Project UID __parent_uid__ Stores the parent project’s unique identifier (UID).
Parent Session GUID __parent_guid__ Stores the parent session’s unique identifier (GUID).

Label Options

These settings are used to customise the text that will appear on the parent session when displaying a status of how many sessions exist as well as the buttons used to create and view sub sessions.

When no sub sessions

This will be displayed when no sub sessions have been created.

When one sub session

This will be displayed when only one sub sessions exists.

When multiple sub sessions

This will be displayed when more than one sub sessions exist.

Button to create sub session

This will be displayed on the button that is used to create new sub sessions.

Button to view list of sub sessions

This will be displayed on the button that is used to view a list of the sub sessions.


Sample Projects

This sample simulates an asset auditing form which is used to collect information for assets that are assigned to rooms in a particular building. This sample contains three projects; Buildings, Rooms and Assets. The projects are linked together using sub project points so that a building can contain many rooms and each room can contain many assets.


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

Click each of the links below to install the sample projects into your Mobile Data Anywhere account:

Import the Buildings project
Import the Rooms project
Import the Assets project

These sample projects are setup using the structure outlined below where Buildings has a sub project called Rooms which in turn has a sub project called Assets.

Diagram heirarchies basic

The Buildings Project

This project is considered to be the parent project because it is the highest project in the hierarchy. This project contains a sub project point called Rooms which is used to link to a child project rooms.ppc. In the mobile application, this will enable the user to create many Room sessions that belong to a Building session. When a Building session is sent, deleted or duplicated this action will also be taken on all child sessions in the Room sub project, cascading down to any further sub projects as well.

The sub project point has been configured to copy the value of the Address point into child sessions. When a new Room session is created, the value of the Building’s Address point will be copied into the Room’s Address point. For more details see here.


Did You Know?
You can add a Logic Point to the sub project to wait for the Address point to have a value before showing or hiding a point.

The sub project point has been configured to customise the labels and buttons so that the text that is displayed on the mobile device is related to Rooms. See below for an example of the sub project point’s properties:

Buildings sub project point web

The Rooms Project

This project is referred to as the child project because it is the second project in the hierarchy. Any sessions created within this project will belong to a Building session, which is referred to as the parent session. Many sessions can be created that belong to the same parent session. In the context of the simulated building asset audit, this allows the user to collect data for many rooms in a particular building.

The Rooms project also contains a sub project point called Assets which is used to link to a child project assets.ppc. In the mobile application, this will enable the user to create many Asset sessions that belong to a Room session. This extends the existing parent-child relationship between Buildings and Rooms to create the parent-child-grandchild relationship seen in the diagram below:

Diagram heirarchies linear

The sub project point has been configured to copy the value of the Address point into child sessions. When a new Asset session is created, the value of the Room’s Address point will be copied into the Asset’s Address point. For more details see here.


Did You Know?
Values can be copied from a parent project to a child project and then those same values can be copied into a grandchild project. This sample demonstrates this with the Address point being copied from Buildings to Rooms to Assets.

The sub project point has been configured to customise the labels and buttons so that the text that is displayed on the mobile device is related to Assets. See below for an example of the sub project point’s properties:

Assets sub project point web

The Assets Project

This project is referred to as the grandchild project because it is the third project in the hierarchy. Each session that is created within this project will have a parent Room session. In the context of the simulated building asset audit, this allows the user to collect data for many assets that are located in a room, in a particular building.