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

Grid Point

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

What is the Grid point?

The Grid point can be used to display sequential data in a table with customisable rows and columns. Each row of data in the grid can be created, edited and reordered from within the Grid point. This point uses the Template point to design a page of points that are used for each row's entry page.

Key Features

  • Allows storing a sequence of data within a session.
  • Rows can easily be reordered on the mobile device.
  • Can be configured to be a read-only table of data instead of providing full create/edit/delete functionality.
  • Multiple style options available to customise the look and feel to suit a variety of needs.

Configuration and Settings

Preparations

Before a Grid point can be added to a project there are several steps that need to be applied to a project.

Preparing a template page

The first step is to add a new page to your project that will contain the points that will appear in each row entry in the Grid point.

Important: This page will only be used as a template and will not appear within the project, except when creating or editing an activity of the Grid point. Ensure that all points that are not related to a Grid activity are added to a different page to the template page.

Preparing a content page

Once the template page has been created, create another page in the project which will contain the Grid point and any other points that are not contained within the Grid activities.

Template point

Add a Template point to the content page. Edit the properties to select the template page that was created in the first step along with configuring how many times to insert the template into the project. This number determines how many rows can be added to the Grid point.

Configuring a Grid point

Add a Grid point to the content page and see below for the configuration options:

Grid point properties

Template

Select template point

Select the template point that was created in the preparation steps.

Column Headings

This section is used to specify which of the points from the Template page are displayed in the Grid point. Select the points you would like to use from the Available Points list on the left and click that right arrow to add them to the Column Headings list. The column headings can then be reordered using the Move Up and Move Down buttons. To remove a column heading, simply select the heading from the Column Headings list and click the left arrow.

Options

Use point captions instead of point names for column headings.

By default, each of the points used in the column headings will appear using their point ID name. This option can be enabled to use the points' captions instead.

Read only

When enabled, it will disable the ability to create, edit and delete row entries from the Grid.

Disable deleting entries

When enabled, it will disable the ability to delete row entries from the Grid.

Disable reordering entries

Disables the ability to reorder row entries from the Grid view.

Hide vertical grid lines

Hides the vertical lines separating each column in the Grid.

Show next/previous navigation buttons on entry page

Displays a Next and Previous button on the entry page for each activity. These buttons can be used to navigate between the row entries from within an entry.

Show create entry button on entry page

Displays a New Activity button on each activity entry page. This button can be used to create a new row from with an existing row's entry page.


Sample Projects

This sample demonstrates how a Grid point can be used to to create rows of data and display them on a grid view.


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