Define display name and field information

When form elements are added to the form and saved, they become fields within the layer. These fields store information collected by mobile workers. For example, if you add a Text - Single line form element to the form, a string field is added to the layer.

When you add a form element to the form canvas, the Properties pane appears. Every form element requires a value for the Display name, Field name, and Field type properties. If the field is a string type, a Field length value is also required. Define the display name and field information by completing the following steps:

Format basic elements

After entering the required display name and field information, you can configure additional properties for basic form elements to help streamline data collection in the field. For more information, see the following:

• Format date elements
• Format text elements
• Format barcode and QR code elements
• Provide a description
• Provide hints
• Require form elements
• Set default values
• Disable editing
• Add calculated expressions
• Configure conditional visibility

Define display name and field information

When form elements are added to the form and saved, they become fields within the layer. These fields store information collected by mobile workers. For example, if you add a Combo box form element with a string type to the form, a string field is added to the layer.

When you add a form element to the form canvas, the Properties pane appears. Every form element requires a value for the Display name, Field name, and Field type properties. If the field is a string, a Field length value is also required. Define this information by completing the following steps:

Create a list of values

A list of values (also known as a coded value domain) defines the options mobile workers can choose from when filling out the form. Providing a list of values streamlines data collection in the field and ensures consistency in the data being entered. Each value in a list includes a label and a code:

• Label—The label is the value displayed when filling out the form in Field Maps and how you want the value to appear to mobile workers. It's also displayed when viewing the attribute table in Map Viewer and other apps.
• Code—The code is the value stored in the feature layer.

You can add values one-by-one or by uploading a .csv file. How you create a list depends on the type of choice element you're configuring.

Format choice elements

After you've defined the display name, field information, list of values, and default value, you can configure additional properties for choice form elements to help streamline data collection in the field. For more information, see the following:

• Provide descriptions
• Manage the list of values
• Require form elements
• Disable editing
• Add calculated expressions
• Configure conditional visibility

Add fields to the form

Fields within the layer appear in the Fields list next to the form canvas. You can add fields to the form in one or more of the following ways:

• Add fields one by one—To add a single field to the form, double-click it or drag it onto the form canvas.
• Add a selection of fields to the form—To add multiple fields to the form, press the Ctrl key and click the fields you want to include, and then drag them to the form canvas.
• Add all fields to the form—To include all fields in the form, click Add all in the Fields list.
• Convert the pop-up—If you configured the form as a pop-up in Map Viewer Classic, you can configure the form using the existing pop-up configuration. On the blank form canvas, click Convert pop-up. Editable fields from the pop-up are added to the canvas and placed in their original order. Fields that are not part of the pop-up configuration appear in the Fields list.

If fields are required, they appear in the Required section of the Fields list and must be added to the form. Fields appear in the Required section if they were configured to not allow null values when created in ArcGIS Online.

Add contingent field groups to the form

If contingent field groups were configured in ArcGIS Pro, they appear in the Field groups list next to the form canvas. If field groups share common fields, they are listed together. You can add field groups to the form in one or more of the following ways:

• Add field groups one by one—To add a single field group to the form, double-click it or drag it onto the form canvas.
• Add a selection of field groups to the form—To add multiple field groups to the form, press the Ctrl key and click the field groups you want to include, and then drag them to the form canvas.
• Add all field groups to the form—To include all field groups in the form, click Add all in the Field groups list.

When a field group is added to the form, its contingent fields are contained in a group element. Contingent fields should stay grouped together so mobile workers can fill them out sequentially in the Field Maps mobile app. If a field is removed from its field group, a warning appears.

If field groups are required, they appear in the Required section of the list and must be added to the form. Field groups are required if they were configured as restrictive in ArcGIS Pro.

To learn how contingent values work in the Field Maps mobile app, see Select contingent values. To learn how to create contingent field groups in ArcGIS Pro, see Create and manage contingent values.

Configure fields as form elements

Once fields have been added to the form canvas, they can be configured as form elements. Configure how fields appear in the form by completing the following steps:

Manage the list for a combo box or radio buttons

Manage the list of values for a combo box or radio buttons element by completing the following steps:

Manage the list for a switch

Manage a list of values for a switch element by completing the following steps:

Add calculated expressions

Calculated expressions automatically calculate and populate data in the form, saving time for mobile workers in the field. You can build calculated expressions in a variety of ways with Arcade, including using feature attributes, geometry, and account information for the signed-in user.

Calculated expressions are dynamic, meaning they automatically update the form as information changes. As a result, mobile workers can see the updated calculation before submitting the form. To create a calculated expression, complete the following steps:

The following are examples of calculated expressions:

• Provide date information—The following expression provides the current date for a date field:

  return Today();

  To learn more about date information you can access with Arcade, see Date Functions.
• Include account information for the signed-in user—The following expression returns the full name of the user signed in to Field Maps:

  var userInfo = GetUser(portal("https://<org>.maps.arcgis.com"),"")return (userinfo["fullName"])

  To learn more about account information you can access with Arcade, see GetUser (Data Functions).
• Extract information from intersecting layers—The following expression is applied to a ZIP Code field in the form. It checks whether the feature geometry is null and then extracts a ZIP Code value from an intersecting parcel layer:

  if (IsEmpty(Geometry($feature))){
      return;
  }
  else{
      var parcels_FS = Intersects($feature, FeatureSetByName($map,"Redlands parcels")); 
       if (Count(parcels_FS) == 1){ 
         return Text(First(parcels_FS).ZIP_CODE);
       }
  }

  To learn more about extracting information from intersecting layers with Arcade, see Intersects (Geometry Functions).

For a list of all the functions offered in Arcade, see the Arcade Function Index.

Add conditional visibility expressions

You can conditionally show or hide elements in the form based on values added to previous fields. For example, a building assessment form includes a field to indicate whether there is water damage. It also includes a group form element containing fields related to water damage. A conditional visibility expression can be applied to the water damage group so it only appears if water damage is indicated in the earlier field. To create a conditional visibility expression, complete the following steps:

Unable to configure the form for a table

If a table is related to a layer with GNSS fields, you cannot configure its form; however, you can configure the form for a copy of the table. To create a copy of a related table, complete the following steps: