Add data to an app

When adding data to an app, you can select web maps, web scenes, and layers stored as content items in ArcGIS, including the following:

• Feature layers—A feature layer is a grouping of similar geographic features—for example, buildings, parcels, cities, roads, or earthquake epicenters. Features can be points, lines, or polygons (areas). Feature layers are most appropriate for visualizing data on top of basemaps.
• Scene layers with associated feature layers—A scene layer is a collection of 3D feature objects and z-values (elevation values).
  • Point scene layers—Scene layers that are designed for displaying large amounts of point data, up to millions of points.
  • 3D Object scene layers—Scene layers that are mainly used to display 3D features such as buildings, trees, and other elements of a city.
  • Building scene layers—3D renderings of buildings made from building information modeling (BIM) data. A building scene layer contains the following sublayers:
    • Full Model—All of the features of a building, grouped by work discipline. Work disciplines include architectural, electrical, infrastructure, mechanical, plumbing, and structural. Each discipline is a building group sub-layer that contains building component sub-layers of building features such as rooftops, walls, doors, air conditioning units, lighting fixtures, columns, foundations, and more.
    • Overview—A building component sub-layer that displays the exterior shell of a building.
• Feature, scene, and map services—Services make features, scenes, and maps available to others on a server.
• Feature collections (excluding map notes and route layers)—Subsets of feature layers with focused and limited functionality.
• Imagery layers—Collections of map cartography based on raster data. Raster data consists of a matrix of pixels (or cells) and is commonly used to store imagery and other information captured by remote sensing devices, such as satellites and unmanned aircraft systems.
  • Tiled imagery layers—Imagery layers generated from one or more image files. If a tiled imagery layer is created with multiple images, the images are mosaicked together into a single image.
  • Elevation layers—Collections of pre-rendered cached image tiles in the Limited Error Raster Compression (LERC) format. LERC is a compression format for single-band or elevation data. Elevation layers are suitable for showing terrain in scenes at global and landscape scales.
  • Dynamic imagery layers—Imagery layers made up of single image or collection of images. They are similar to tiled imagery layers. With dynamic imagery layers, you can use raster function templates to perform analysis on the fly.
• Oriented imagery layers—Collections of images taken from any angle—including oblique, bubble, street-side, and 360-degree images. Oriented imagery can be imagery from different optical cameras, including mobile cameras, unmanned aircraft systems, and terrestrial sensors.
• Subtype group layers—Composite feature layers that contain multiple sublayers called subtype layers. A subtype is a subset of features in a feature class that share the same attributes and behaviors. A subtype group layers is comprised of a sublayer for each subtype. A subtype group layer's sublayers come from a single feature source, meaning a single query to the feature source returns results for every single sublayer. An advantage of subtype group layers is faster performance. Loading data represented by a subtype group layer with 10 sublayers performs faster than loading the same data but represented by 10 individual feature layers.

You can browse and search for these data sources in your content, your groups, your organization, and content that’s shared publicly, including ArcGIS Living Atlas of the World. Layers from feature, image, scene, or map service URLs are also supported. In addition, when you add web maps and web scenes to an app, you can use their supported layers as a data source for widgets.

You can add data to an app in the following ways:

• Before adding any widgets, click the Add data button in the Data panel to add data that will be used in the app. All data types supported in Experience Builder are listed in the Add data window.
• If you don’t add data before adding widgets, you can add data when configuring a widget by clicking Add data at the bottom of the Select data pane. Only the data type supported by the widget is available to add. The data you add when configuring a widget also appears in the Data panel and is available to select when configuring other widgets.

Remove data

You can remove a data source using the Remove option on item cards in the Data panel. The data contained in the data source is also removed. When you remove data here, it is no longer available for widget configuration. If you remove data that’s already used by widgets, the app will no longer display information from that data, and all widgets connected to that data will be affected. You can delete the affected widgets when you delete the data, or you can reconfigure the widget settings by connecting other data later.

Data details and data views

The Data panel displays item cards with the item names for data that you add to the app. Labels with icons help you differentiate between data types. You can view additional details by clicking the link to open the item page for the original data source. You can change the name that appears on the item cards to something more relevant to the app (the source data is unchanged). Each card indicates the number of related widgets and layers in a map or scene. Clicking a data card opens a pane with more data details.

• For web maps, web scenes, services, and group layers, you can view the following details:
  • Layers tab—Layers that the data source contains are listed. The layers are divided into two groups: In use shows layers that are selected in widget settings, and Others shows layers not yet connected to a widget. You can hide an unused layer so it won’t appear in the select data list when you configure a widget. Click the layer card to open a details pane.
  • Widgets tab—Widgets that use the entire map, scene, service, or group layer directly are listed. Widgets that only use specified layers under the data aren’t listed here; they’re listed under the corresponding layer instead.
• For single layers (including those without sublayers), the following setting options and details are available:
  • Data settings—Set filters, sort fields, and record limitations for the data. The filter settings here affect all its data views.
  • Refresh settings—If the Auto refresh option is turned off, the data is refreshed only when you refresh the app or the builder. Turn on Auto refresh to refresh the data and get the latest features based on a specified time interval. You can set a custom time interval, or if the data comes from a web map, you can use the layer’s settings.
  • Allow export—Provide options for users to export data at run time from connected widgets for which data actions are enabled.

    Note:

    For hosted feature layers, the app verifies that the user's role and item settings allow exporting the data.

  • Related—If the feature layer has any related data, the relationships are listed here along with the type of relationship.
  • Data views tab—Create data views of supported feature layers and scene layers by adding filters, sort fields, and records limitations to control what appears in connected widgets. These settings only take effect within the view and don’t affect other data views or the source data.

    Note:

    Each layer also has built-in views that you can select when configuring data sources for the widget. The default view contains all the features. The selected features view contains features selected at run time. The automatically populated view is used for dynamic content settings with List widgets.

    • View for empty selection—Check this box and click its Settings button to configure a view that displays when there are no features selected in a Selected features view. (Features in this configured view are not selected automatically.)
  • Fields tab—Fields that are used by widgets are listed.
  • Widgets tab—Widgets that use the layer in their settings are listed.

Output data

In addition to the data that you manually add to the app, the following widgets can process the original data and generate a new output dataset with the displayed results.

When these source widgets are configured in the app, their output data is listed in the Select data pane when configuring other widgets. The output is created as a new data source, so filters and selections on the output data don’t affect the original data source.

The schema of the output data is defined by its source widget:

• Chart—A statistic with attributes of the category field (if configured) and calculation results of number fields (it doesn't contain geometry)
• Query—A subset of records that meet the query criteria, with the fields as configured in its Results settings
• Search—The address for the search result from the corresponding locator source

The actual records in the output data are generated dynamically by the source widget at run time.

Data source views

Once the data is selected in the widget settings, you can choose one or more views from the drop-down list, based on the number of data sources the widget supports. A data source has the following view options:

• Default—A built-in view containing all the features in the data.
• Selected features—A built-in view containing features selected by the user at run time. The selected state of a feature is synchronized through all views. This view can be used to display an interaction result. For example, if it's configured for a List widget, the list only displays the selected records, and items in the list change dynamically as the selection changes. If there is no selection, the list displays a No data message until records are selected. You can also create a view for empty selection in the Data panel.
• Auto-populated—A built-in view that's available in dynamic content settings if a widget is added to a List widget and is connected to the same data view. This view only contains one feature that the list generates for each item in it.
• Data view—A subset of features that you can create with different filters, sort fields, and records limitations. You can preprocess a data source with multiple data views to control the data that appears in a widget without affecting other data views or the source data.

  Note:

  Output data doesn’t support adding custom data views.

  Note:

  The Page size setting on the Records tab is used for query performance and efficiency. It doesn't affect the total number of result features in widgets that support pagination. If the page size is smaller than the result, multiple requests are sent until all results are loaded.

The Default view is selected by default. You can also edit an existing view or create another view for the widget. Views created from a widget configuration panel are also available to select in other widget settings.

Attribute

Get the attribute value of a feature in the specified data view using one of the following views:

• The views you set in the widget’s data source setting.
• The Selected features view of the original data layer. This view allows you to display the interaction results such as displaying the selected feature’s attributes.
• The automatically populated view if the widget is in a List widget (such as text, image, or button) and has the same data view as the List widget. This view contains only one feature that the list item represents.

If the view contains multiple features, the attribute value of the first feature is returned (based on the sort settings in the data view).

Statistics

Get the statistics results of the feature set defined by the specified data view.

Results can be the maximum, minimum, average, sum, standard deviation, discrete percentile, or continuous percentile value of a numeric field; the maximum or minimum value of a date field; the feature count of the feature set (using the unique ID field); or, if the service supports distinct count, the number of unique values for a field.

Use the statistics editor to provide custom labels for statistics. To set a label, replace the placeholder text, which acts as the default label and changes based on the operator and field you specify.

For discrete percentile and continuous percentile, you must set a percentile value and choose to display values in either ascending (ASC) or descending (DESC) order. A percentile value is a value n on a scale of 0-100. Ascending order means a value in the n^th percentile of a dataset is greater than n% of values in the dataset. Descending order means a value in the n^th percentile of a dataset is less than n% of values in the dataset.

Expression

Use the expression editor to input text (format: “text”); numbers; field variables (format: {field}); and functions including AVERAGE({field}), COUNT({field}), SUM({field}), MAX({field}), MIN({field}), STANDARD_DEVIATION({field}), PERCENTILE_DISCRETE({field},percentile value, order), and PERCENTILE_CONTINUOUS({field},percentile value, order). Each part is concatenated with a plus sign. The expression returns the result of string concatenation and number calculation. For example, if you input 1+1, it returns 2 (number), but if you input 1 + “1”, it returns “11” (string).

As you type, suggestions appear that you can click to insert. Also, you can insert a field variable or a function by clicking the field names or function names listed under the input box.

Data on the Fields tab allows you to set the data view that the field variable represents. If a field variable is added as an independent part in the expression, the attribute value for that field is returned from the first feature in the specified data view.

If a numeric field variable or date field variable is used in a function—for example, AVERAGE({field})—the function returns the statistic result of the data view for that field. For date fields, the expression builder only supports COUNT, MAX, and MIN functions.

You can format numbers in the expression by clicking the Number formatting button and turning on Number formatting. You can choose the number of decimal places to show, include a thousands separator, and add a unit from the data.