The Settings table consists of four columns that are all primary keys:

• CustomerId
• UnitId
• TerritoryId
• RouteId
• DriverId

Each entry in the Settings table must have exactly one of these four columns populated, to indicate the record to be retrieved or updated.

When you write templates that access this table, follow these requirements:

1. Specify the Symbolic Name for the table version to use:

   Copy

   TableId = Settings-1.0

2. Specify an Intent that this table supports:

   • Retrieve
   • Update

3. Input templates: In your [Output] section, be sure to map an input value to every table column that is flagged as being a primary key or required.

4. Retrieve templates: This table requires the use of a fetcher. The following fetchers are available and are listed from most efficient to least:
   1. CustomerId (Equals/In)
      Copy

      [Filter]
      CustomerId(ExternalIdName) = Equals("DEF123")

      Copy

      [Filter]
      CustomerId(ExternalIdName) = In(["ABC123","DEF123"])

   2. UnitId (Equals/In)
      Copy

      [Filter]
      UnitId(ExternalIdName) = Equals(Id1)

      Copy

      [Filter]
      UnitId(ExternalIdName) = In([Id1,Id2,Id3])

   3. TerritoryId(Equals/In)
      Copy

      [Filter]
      TerritoryId(ExternalIdName) = Equals("ABC123")

      Copy

      [Filter]
      TerritoryId(ExternalIdName) = In(["ABC123","DEF123"])

   4. RouteId (Equals/In)
      Copy

      [Filter]
      RouteId(ExternalIdName) = Equals("RST456")

      Copy

      [Filter]
      RouteId(ExternalIdName) = In([RouteId1,RouteId2,RouteId3])

   5. DriverId (Equals/In)
      Copy

      [Filter]
      DriverId(ExternalIdName) = Equals(Id1)

      Copy

      [Filter]
      DriverId(ExternalIdName) = In([Id1,Id2,Id3])

This table supports the following options, which can be set in the [TableOptions] section.

• Retrieve
• Update

This list includes each column's name, which you use in expressions to retrieve or create data, and data type, which defines how the data is retrieved and set.

Note
If a column of data type Id is a primary key OR if it refers to other tables (Id <OtherTable>), then you can map it to an external key or, in some cases, a Telogis key.

Additional columns: