Map

The map control allows users to mark locations on a map. For example, construction sites, discovery locations of certain items, or a customer’s address can be marked.
Within the map, users can search for a location using the search field on the upper right side of the map, as well as determine their current position via GPS.

info

Since this control requires a map service, it may not be displayed in an on-premise environment.
Details on integration can be found here.

Configuration

The following options are available within the configuration:

• Title:
  Enter the display name of the control element here. This is displayed to the users so that they know which control it is.
• Internal name:
  The internal name allows you to reference a control in placeholders or rules using a name other than the title. This field does not have to be filled in, but is helpful if you have several controls with the same title in a form.

• Mandatory field:
  If you activate this option, people must fill in this field before the form can be transferred to the next process step via a button. In this way, you can force a form to have all the necessary information before it is sent.
  Caching is possible at any time, even if mandatory fields are not filled in.

• Read-only:
  If you mark a field as read-only, the field cannot be filled in by persons. This is particularly useful in combination with a default value in order to display certain values but not be able to change them. For example, you can display which person is currently logged in and accordingly record which person has sent a form.

• Height:
  Here you can specify how tall the map should be displayed in the form.
• Map:
  If more than one map is available in the system (e.g., a Germany map and a France map), you can select the map here.
  Note: Since a world map is available in the cloud, you cannot switch between maps here, and therefore this option is not available.
• Default View / markers:
  This option opens a map. You can then focus the area that should be displayed by default. This could, for example, be a specific city or forest area.
  You can also set specific default markers here by clicking on the map.
• Dynamic markers:
  With this button you can insert markers whose addresses are dynamically resolved via placeholders. For each dynamic marker, you can configure the following values:
  • Location:
    This value defines the address where the marker is displayed. This can be latitude/longitude or an address.
  • Marking Text:
    This value defines the text displayed on the marker.
  • Color:
    Define the color of the marker here.

• Help text:
  If you enter a value here, a help icon () is displayed next to the control. People can click on this to display the help text. This allows you to give people help on an individual control.

Placeholders

This control provides the following placeholders:

• Markers:
  This placeholder allows you to loop through all set markers.
• Number of Markers:
  This placeholder returns the number of markers. For example, you can use a condition to check if a marker exists.
• Marker Latitude:
  This placeholder references the latitude of a marker.
• Marker Longitude:
  This placeholder references the longitude of a marker.
• Marker Text:
  This placeholder provides the text of the marker.