TABLE OF CONTENT


The Map Screen Type is one of our data perusal screens. This screen type is data-driven and enables you to visualize data with a GPS component on a map.


To add a details screen, navigate to Apps -> Screens. Click on the ADD NEW+ button.


  1. Select your Screen Type
  2. Name your Map Screen
  3. Select a suitable icon
  4. Select your data source
  5. Click on the CREATE+ button


Title Bar

  1. Data source: A selection of connected data sources within your app to which to relate your configuration.
  2. Screen Title: This will be populated with the name of your screen.
  3. Map Type: Standard, satellite and hybrid are the options, with hybrid being a combination of the previous two.
  4. Show User Location on Map (Check Box): If users’ GPS coordinates are available, checking this box this will create a pin on the map for them.


  1. Action Buttons: Define buttons to appear on the title bar.
    • Select which button you'd like to configure: LEFT, RIGHT1 or RIGHT2
    • Select an icon
    • Add the button text
    • Select the button colors
    • Select the user interaction (optional)
      NOTE that many interactions receive a value that is either static or dynamic based on a column in the data source. For the latter, use the syntax {{this[column]}}. On the Title Bar, parameter-based action will only succeed after first clicking a point on the map that has relevant data in the associated column.
      • Create Email To: This will send an email with the default email program to the user specified in the parameter field below the dropdown. 
      • Create SMS To: This will send a text message to the number specified in the parameter field below the dropdown.
      • Dial Phone Number: This will call the number specified in the parameter field below the dropdown.
      • Force Sync: This will Force Sync the device.
      • Open Doc: This will open a published doc from your organization. Choose a target doc from the dropdown to serve as the action target.
      • Open Entry: This will open a form entry by its entry ID. (This can be useful if mapping the Saved Drafts app data source.)
      • Open Screen: This will open a screen based on the choice from the dropdown. Parameters may be passed into the target screen:
        • For Form targets, you can preset target fields with "dataname:value," pipe-separated -- e.g., field1:{{this[1]}}|field4:hello.
        • For Listing & Map targets, you can pass in a formula for filtering the target rows. Use {{target[column]}} for target columns -- e.g., {{target[3]}} >= {{this[2]}}.

        • For Detail and Task Details targets, pass the identifier of the target data row or Task. For data rows, the identifier must match the first column's value -- e.g., {{this[2]}}.
      • Open Task: This is not relevant for a mapping screen.
      • Open URL in App: This will open a URL within the app.
      • Open Link in Web Browser: This will open a URL within a web browser.
      • Print Form Entry: This is not relevant for a mapping screen. 
      • Refresh Screen: This is not relevant for a mapping screen.
      • Show Address on Map: This will show the address of the target specified in the parameter field. On a mapping screen, this will center the user on the exact pin and exclude all others from view.
      • Show Coordinates on Map: This will show the coordinates of the target specified in the parameter field. On a mapping screen, this will center the user on the exact pin and exclude all others from view.

      • Button Visibility: Enter a formula here that will be used to toggle visibility for the button in question. Consider using formulas that reference user metadata or that run aggregate functions on data source data (see below).

        USERMETA('Type')='Admin'
        This will only show the button if the user type is Admin.

        DSSUM('FORTUNE1000', 14)>100
        This will only show the button if the sum of the specified data source's column 14 is greater than 100.


Go to the top.


Search Field

Basic Properties

  1. Data source: A selection of connected data sources within your app to which to relate your configuration of the detail line.
  2. Show Search Box (Check Box): If the check box is selected, the search box in the screen being interfaced will be displayed.
  3. Allow User to Filter by Column (Check Box): If the check box is selected, screen users will be allowed to create and apply filter rules for search results.
  4. Users Filters Override Default (Check Box) (Only visible if Allow User to Filter by Column Check Box is selected): If the check box is selected, user filters are applied to search results despite default settings.
  5. Left Text: Static text and dynamic values related to the data source can be entered here. Color, font and text size can also be adjusted.
  6. Left Icon: The icon image displayed for this detailed line. Having no icon selected for display is also an option.
  7. Right Text/Button: Same as left text and left icon combined but on the right-hand side of the field. Color, font and text size can also be adjusted.

Validation Behavior

  1. Search Pattern: By default, searching will filter rows based on the user's search text matching anywhere within the displayable row values. This option allows you to specify a replacement regular expression for row matching. Use {{this}} to refer to the user search text in your regular expression. E.g., '^{{this}}' will show rows that start with the search text.
  2. Default Filter: Allows you to specify the default filter formula for this screen. Any incoming filters will override any default filter specified -- e.g., {{this[0]}} = ORGMETA('projectId').


Go to the top.


Map Item

Basic Properties

  1. Pin Coordinates: This chooses the data source column with the geo coordinates that each pin will show. NOTE that the coordinates must be in the format of latitude, a space and then longitude -- e.g., 47.6144639 -122.1929722.
  2. User Interaction: See the details for each interaction below. NOTE that many interactions receive a value that is either static or dynamic based on a column in the data source. For the latter, use the syntax {{this[column]}}.
    • Create Email To: This will send an email with the default email program to the user specified in the parameter field below the dropdown. 
    • Create SMS To: This will send a text message to the number specified in the parameter field below the dropdown.
    • Dial Phone Number: This will call the number specified in the parameter field below the dropdown.
    • Force Sync: This will Force Sync the device.
    • Open Doc: This will open a published doc from your organization. Choose a target doc from the dropdown to serve as the action target.
    • Open Entry: This will open a form entry by its entry ID. (This can be useful if mapping the Saved Drafts app data source.)
    • Open Screen: This will open a screen based on the choice from the dropdown. Parameters may be passed into the target screen:
      • For Form targets, you can preset target fields with "dataname:value," pipe-separated -- e.g., field1:{{this[1]}}|field4:hello.
      • For Listing & Map targets, you can pass in a formula for filtering the target rows. Use {{target[column]}} for target columns -- e.g., {{target[3]}} >= {{this[2]}}.

      • For Detail and Task Details targets, pass the identifier of the target data row or Task. For data rows, the identifier must match the first column's value -- e.g., {{this[2]}}.
    • Open Task: This is not relevant for a mapping screen.
    • Open URL in App: This will open a URL within the app.
    • Open Link in Web Browser: This will open a URL within a web browser.
    • Print Form Entry: This is not relevant for a mapping screen. 
    • Refresh Screen: This is not relevant for a mapping screen.
    • Show Address on Map: This will show the address of the target specified in the parameter field. On a mapping screen, this will center the user on the exact pin and exclude all others from view.
    • Show Coordinates on Map: This will show the coordinates of the target specified in the parameter field. On a mapping screen, this will center the user on the exact pin and exclude all others from view.

Layout Styling

  1. Default Pin Color: This will be the pin color for every pin that does not have conditional formatting set up in its associated data source column. See below for more on this.
  2. Conditional Pin Color: Choose a data source column from this drop-down that has conditional formatting in place to display colors for pins based on said column's conditional display rules. These are set up within the data source by clicking the Cog icon in the column header and defining a rule within the Conditional Display Rules section (see below). Pins with values matching these rules will display in the defined color.

    /var/folders/yf/4dbjhxmx3xx657c5cbgdx0kc0000gn/T/com.microsoft.Word/WebArchiveCopyPasteTempFiles/KtIz_peupjZ7qLWjD_iT1e-oJzFQP7lE0g.png?1608683219
  3. Cluster Icon Style: This determines the styling of the cluster icon that displays for a high concentration of pins. NOTE that cluster icons display on the Android and iOS apps but not on the Windows app.
  4. Disable Conditional Styles: Checking this box will override any styling in the mapping screen design with styling defined in the data source.

h2

Go to the top.