The Reftab element

Description

Declares a reference data table instance on the Mobilengine Cloud.

Usage

<Reftab Name="name"
  Notify="change-notification" Push="change-push">
  columns-element
</Reftab>

Parameters

Parameter	Description
name (required)	The string type name of the reference table, which must be unique across the workflow management solution.
change-notification	A boolean value that specifies whether changes to the reference table will trigger a notification on affected mobile clients after the changes have been synchronized. Its default value is `false`.
change-push	A boolean value that specifies whether changes to the reference table will trigger a push notification to affected mobile clients, causing the changes to be synchronized to them. Its default value is `false`.
columns-element (required)	A single `Columns` element.

Remarks

Reference table names have certain limitations: they can contain ASCII characters (basic Latin letters, digits, the dollar sign, and underscore), but no “/”, “\”, or “.”, and cannot end with a space or have more than 64 characters.

All reference tables need to be declared on the server before they can be used in a Mobilengine workflow solution. You can declare reference tables as needed by uploading their schema (with the file extension .refem) to the Mobilengine Cloud via the MEBT. The Reftab element is the root element for a reference table schema.

Sample

draftboard.refem

<Reftab Name="draftboard" xmlns="http://schemas.mobilengine.com/reftab/v1" Push="true" Notify="true">
  <Columns>
    <Column Name="id" Type="Integer" PrimaryKey="true" NotNull="true"></Column>
    <Column Name="playername" Type="Text" AgentName="true" NotNull="true"></Column>
    <Column Name="birthdate" Type="Date" DateFormat="dd-mm-yyyy"></Column>
    <Column Name="pointaverage" Type="Float"></Column>
  </Columns>
</Reftab>

Developer Documentation

Reference Table Schema Guide