API User's Guide

Referring to object fields

In order to reference an Alloy Navigator object field via the API, you must specify the original field name, as in the database. Display labels are not supported.

Supported field names for retrieving objects

The following HTTP requests retrieve the object data:

For these requests, the supported parameter value is the physical name of a field. You can find physical field names in the Settings App, as described below. Alternatively, you can see the Database Reference Guide. This document describes the structure of Alloy Navigator database tables and fields. The Alloy Navigator Database Reference Guide is available at the Alloy Support Portal.

To check a physical field name in the Settings App:

  1. Open the Settings App and go to the General > Fields > Miscellaneous > All Fields > By Table Name.

  2. Select the view-table that corresponds to the object. The name of the table should be [Object]_List, e.g. Computer_List.

  3. Open the drop-down list of fields and double-click the required field. The Field Properties window appears.

  4. The physical name of the field is on the General tab under the Field Name. Copy and save the physical name for later use.

Supported field names for creating and updating objects

The following HTTP requests create and change objects with workflow actions:

For these requests, the supported parameter value depends on the type of the field. There are two types of fields on an action form - object and virtual.

  • For the Object fields, both physical name and the name from the action form are supported.
  • For the Virtual fields, only the name from the action form is supported.

You can check the field name on the action form in the Settings App as follows:

  1. Go to the Workflow and Business Logic > [Object Class] > Actions.
  2. Double-click the corresponding Create or Step Action. The Action window appears.
  3. On the Form tab, view the list of fields involved in the action. Double-click the field which name you want to check.
  4. The Form Field window appears.
  5. Under Name, view the field name.

    NOTE: Alternatively, you can view physical field names in the Database Reference Guide, which describes the structure of all database tables and fields. The guide is available at the Alloy Support Portal.