1. Get started

  2.  Welcome
  3.  Get started
  4.  Run as a Windows service
  5.  Build your first app
  6.  Requirements
  7.  Accessibility support
  8.  Development overview
  9.  About release versions
  10.  What's new
  11.  Frequently asked questions
  12. Working with apps

  13.  Home page
  14.  Create or import an app
  15.  Edit and launch an app
  16.  Choose a theme
  17.  Select a map or scene
  18.  Add widgets
  19.  Widgets overview
  20.  Configure app attributes
  21.  Preview apps on smaller screens
  22.  Export as a template
  23.  Edit or preview template
  24.  Use URL parameters
  25.  Upgrade apps
  26. Configure 2D widgets

  27.  About widget
  28.  Add Data widget
  29.  Analysis widget
  30.  Attribute Table widget
  31.  Batch Attribute Editor widget
  32.  Basemap Gallery widget
  33.  Bookmark widget
  34.  Business Analyst widget
  35.  Chart widget
  36.  Controller widget
  37.  Coordinate widget
  38.  Coordinate Conversion widget
  39.  Cost Analysis widget
  40.  Data Aggregation widget
  41.  Directions widget
  42.  Distance and Direction widget
  43.  District Lookup widget
  44.  Draw widget
  45.  Edit widget
  46.  Emergency Response Guide widget
  47.  Extent Navigate widget
  48.  Filter widget
  49.  Full Screen widget
  50.  Geocoder widget
  51.  GeoLookup widget
  52.  Geoprocessing widget
  53.  Grid Overlay widget
  54.  Gridded Reference Graphic widget
  55.  Group Filter widget
  56.  Image Measurement widget
  57.  Home Button widget
  58.  Incident Analysis widget
  59.  Infographic widget
  60.  Info Summary widget
  61.  Layer List widget
  62.  Legend widget
  63.  Measurement widget
  64.  My Location widget
  65.  Near Me widget
  66.  Network Trace widget
  67.  Oblique Viewer widget
  68.  Overview Map widget
  69.  Parcel Drafter widget
  70.  Print widget
  71.  Public Notification widget
  72.  Query widget
  73.  Related Table Charts widget
  74.  Report Feature widget
  75.  Reviewer Dashboard widget
  76.  Scalebar widget
  77.  Screening widget
  78.  Search widget
  79.  Select widget
  80.  Share widget
  81.  Situation Awareness widget
  82.  Smart Editor widget
  83.  Splash widget
  84.  Stream widget
  85.  Suitability Modeler widget
  86.  Summary widget
  87.  Swipe widget
  88.  Threat Analysis widget
  89.  Time Slider widget
  90.  Visibility widget
  91.  Zoom Slider widget
  92. Configure 3D widgets

  93.  3DFx widget
  94.  About widget
  95.  Basemap Gallery widget
  96.  Compass widget
  97.  Coordinate widget
  98.  Daylight widget
  99.  Full Screen widget
  100.  Home Button widget
  101.  Layer List widget
  102.  Legend widget
  103.  Measurement widget
  104.  My Location widget
  105.  Navigate widget
  106.  Search widget
  107.  Share widget
  108.  Slides widget
  109.  Splash widget
  110.  Zoom Slider widget
  111. Widget development

  112.  Get started
  113.  Naming conventions
  114.  In-panel and off-panel widgets
  115.  Deploy your widget
  116.  Required files
  117.  Widget manifest
  118.  Extend BaseWidget
  119.  Required properties
  120.  Define the template
  121.  Configure the Demo widget
  122.  Add i18n support
  123.  Make widgets user-friendly
  124.  Build your first app
  125.  Communication to app container
  126.  Widget properties
  127.  Make widgets responsive
  128.  Communication between widgets
  129.  Dojo dijit
  130.  Make widgets configurable in builder
  131.  Make widgets backward compatible
  132.  Create a controller widget
  133.  Widget life cycle
  134.  Add help for your widget
  135.  Create a feature action in your widget
  136.  Provide and consume data sources in widgets
  137.  Best practices for unit testing
  138. Theme development

  139.  Theme elements
  140.  Create a theme
  141. 3D development

  142.  3D development guide
  143. Sample code

  144.  Create a custom in-panel widget
  145.  Create a ListView widget
  146.  Create a custom widget using the Report dijit
  147.  Create a new theme
  148.  Create a new style for a theme
  149.  Create a new default layout
  150.  Create a nondefault layout
  151.  Create a new panel
  152.  Create a new layout widget
  153.  Create a controller widget
  154.  Create a feature action in your widget
  155.  Send a layer to the Attribute Table widget
  156.  Open multiple widgets simultaneously
  157.  Use other libraries
  158.  Change the URL of ArcGIS API for JavaScript
  159. Deployment

  160.  Deploy your app
  161.  Use proxy
  162.  Web-tier authentication
  163.  Custom widget and theme deployment
  164.  Upgrade custom widgets and themes
  165. Framework reference

  166.  CSS framework
  167.  FeatureActionManager class
  168.  FilterManager class
  169.  LayerInfo class
  170.  LayerInfos class
  171.  LayerNode class
  172.  LayerStructure class
  173.  PanelManager class
  174.  SelectionManager class
  175.  Utils class
  176.  WidgetManager class
  177. dijit

  178.  FeaturelayerChooserFromMap class
  179.  FeaturelayerServiceBrowser class
  180.  FeatureSetChooserForSingleLayer class
  181.  Filter class
  182.  ImageChooser class
  183.  ItemSelector class
  184.  LayerChooserFromMap class
  185.  RendererChooser class
  186.  Report class
  187.  SnapShot class
  188.  SymbolChooser class
  189. JSON reference

  190.  App configuration
  191.  Map configuration
  192.  Widget configuration
  193.  Widget pool configuration
  194.  Widget on-screen configuration
  195.  Panel configuration
  196.  Group configuration
  197.  DataSource configuration
  198.  About
  199.  Analysis
  200.  Attribute Table
  201.  Basemap Gallery
  202.  Bookmark
  203.  Chart
  204.  Coordinate
  205.  Directions
  206.  Draw
  207.  Edit
  208.  Full Screen
  209.  Geocoder
  210.  Geoprocessing
  211.  Controller
  212.  Home Button
  213.  Image Measurement
  214.  Infographic
  215.  Layer List
  216.  Legend
  217.  Loading Page
  218.  Measurement
  219.  My Location
  220.  Near Me
  221.  Oblique Viewer
  222.  Overview Map
  223.  Print
  224.  Query
  225.  Report Feature
  226.  Reviewer Dashboard
  227.  Scalebar
  228.  Search
  229.  Share
  230.  Splash
  231.  Stream
  232.  Swipe
  233.  Time Slider
  234.  Zoom Slider
  235. What's new archive

  236.  What's new in version 2.23
  237.  What's new in version 2.22
  238.  What's new in version 2.21
  239.  What's new in version 2.20
  240.  What's new in version 2.19
  241.  What's new in version 2.18
  242.  What's new in version 2.17
  243.  What's new in version 2.16
  244.  What's new in version 2.15
  245.  What's new in version 2.14
  246.  What's new in version 2.13
  247.  What's new in version 2.12
  248.  What's new in version 2.11
  249.  What's new in version 2.10
  250.  What's new in version 2.9
  251.  What's new in version 2.8
  252.  What's new in version 2.7
  253.  What's new in version 2.6
  254.  What's new in version 2.5
  255.  What's new in version 2.4
  256.  What's new in version 2.3
  257.  What's new in version 2.2
  258.  What's new in version 2.1
  259.  What's new in version 2.0
  260.  What's new in version 1.3
  261.  What's new in version 1.2
  262.  What's new in version 1.1

Business Analyst widget

The Business Analyst widget allows you to view more information about any point or polygon feature on the map, by running reports and infographics for it. The point or polygon feature may be part of a web map layer you opened. The widget also allows you to add a new location by placing a pin on the map and applying rings, drive times, or walk times around it.

LicenseLicense:

If you include this widget in your app, confirm that your end users have the required privileges described in the Use this widget section.

Configure the Business Analyst widget

This widget can be set to open automatically when an app starts. Hover over the widget and click the Do not open this widget when the app starts button Do not open this widget when the app starts to change the setting to Open this widget automatically when the app starts. (For widgets that you need to add to the app first, you can turn on this option after configuring the widget.)

Steps:
  1. Sign in to ArcGIS Online.
  2. Click Content at the top of the page.
  3. Click Create and select Web AppBuilder in the list of options.
  4. In the Create a wep app window, select 2D and specify a title, tags, and summary for your new app.
  5. Click OK.

    Your new app opens in configuration mode.

    By default, to access the Business Analyst widget, users must have an organizational account with GeoEnrichment and Network Analysis privileges and available credits. You can configure the app to allow members of an organization who lack these privileges to access the widget through your subscription (and using your organization's credits). Currently, public accounts cannot access the Business Analyst widget.

    NoteNote:

    To use the Business Analyst widget in ArcGIS Enterprise, both the GeoEnrichment service and Directions and Routing service must be configured on the portal.

  6. To allow app users to access the app and widget through your subscription, complete the following steps:
    1. Click the Attribute tab in the top navigation.
    2. Click Subscriber content access and click + Add new URL.
    3. For Title, provide any name. For URL, type the following URL exactly as shown (it's case sensitive): https://geoenrich.arcgis.com/arcgis/rest/services/World/GeoenrichmentServer
    4. Optionally, set Request Limit and Interval to control the usage, and click OK.

      Attribute tab with Subscriber content access window and URL settings

  7. Click the Widget tab.

    Widget tab

    Several widgets are added to your app by default. You can remove these and add any widget into your app using the placeholders.

  8. Click the Widget 1 placeholder.

    First widget placeholder

  9. In the Choose Widget window, select Business Analyst and click OK.

    Business Analyst widget selected in the Choose Widget window

  10. In the Configure Business Analyst window, optionally edit the name field of the widget as it appears in your app. You can also replace the default icon by clicking Change widget icon.
  11. On the Home tab, optionally modify what appears on the widget's home screen.
    • Customize the content and appearance of the text.
      CautionCaution:

      If you configured the app prior to version 2.16 and used custom XSS for this content, you may need to modify it to ensure that it appears as expected now because XSS filters have since been implemented for improved security.

    • Select which options to include, such as the search box and drawing tools.
  12. On the Infographics tab, modify the following settings:
    • Disable—Check this box to exclude infographics from the widget.
    • Export options—Select from the following export options for infographics: Print, Image, PDF, and Dynamic HTML.
    • Select country or region—Choose an applicable country or region for the infographics.
    • Infographics—Expand the following lists and use the check boxes to deselect any infographic that you don't want available in the widget:
      • Esri infographics—Infographics that are available by default.
      • My Infographics—Infographic templates that you created in ArcGIS Business Analyst.
      • Shared Infographics—Infographic templates that are shared with you by members in your organization.
    • Make default—Set the default infographic by pointing to one in the list and clicking Make default. (To remove the default infographic, point to it and click Remove default or set a different infographic as the default.)

      Partial infographics list showing the Make default setting

    NoteNote:

    If you're using ArcGIS Enterprise and including infographics, confirm that the required application files are installed and infographic starter templates are published to the portal so end users can run infographics from the widget

  13. On the Reports tab, modify the following settings:
    • Disable—Check this box to exclude reports from the widget.
    • Select country or region—Choose an applicable country or region for the reports.
    • Reports—Expand the following lists and use the check boxes to deselect any report that you don't want available in the widget:
      • Esri Reports—Reports that are available by default.
      • My Reports—Reports that you created in ArcGIS Business Analyst.
      • Shared Reports—Reports that are shared with you by members in your organization.
    • Make default—Set the default report by pointing to one in the list and clicking Make default. (To remove the default report, point to it and click Remove default or set a different report as the default.)
  14. On the Rings tab, set the default radius values for applying rings around a point and specify the default units (miles or kilometers). Or you can check the Disable box to exclude rings from the widget.
  15. On the Drive time tab, set the default drive time values for applying a drive time around a point and specify the default units (minutes, miles, or kilometers). Or you can check the Disable box to exclude drive times from the widget.
  16. On the Walk time tab, set the default walk time values for applying a walk time around a point and specify the default units (minutes, miles, or kilometers). Or you can check the Disable box to exclude walk times from the widget.
  17. Click OK to save and close the widget configuration window.

    The Business Analyst widget is added to your web app and the icon appears under the Widget window.

    NoteNote:

    An ArcGIS Business Analyst Web App license is not needed to run reports and infographics from the Business Analyst widget, including any custom reports and infographics shared with you. (The license is needed to create, modify, and share custom reports and infographic templates using ArcGIS Business Analyst Web App.)

  18. Click Save to save the web app with the current configuration.

Use the Business Analyst widget

NoteNote:

To access this widget, you need an organizational account. By default, to run the widget, you must also have available credits and be assigned a role that includes GeoEnrichment and Network Analysis privileges. If you don't have the required credits and privileges, it's still possible to use the widget if the app was configured to allow access through the app owner's subscription.

Steps:
  1. Click the widget icon to open the Business Analyst widget.

    If a polygon feature is already selected on the map when the widget opened, the screen to choose infographics and reports opens immediately.

    TipTip:

    If you want to add a new location instead, click Back.

  2. If a point feature is selected, you must first apply rings, drive times, or walk times around it.
  3. Specify desired values of up to three rings, drive times, or walk times.

    Viewing reports using the Business Analyst widget

    You also have the following options in the pop-up menu for the selected feature:

    • Zoom to—Zooms the map extent to the feature.
    • Pan to—Pans the map to center it on the feature.
    • Add a marker—Show a visual marker on the feature.
    • View in Attribute Table—Open the attribute table for the feature.
    NoteNote:

    When a symbol represents a cluster of multiple points on the map, click the arrows to cycle through the points.

  4. Click Apply.

    You'll see infographics and reports tabs.

  5. Click Run Report to run infographics and reports within the area.

    In this example, the Detailed Age Profile report is selected.

    NoteNote:

    Running reports and infographics uses credits.

    TipTip:

    If the widget includes infographics that you can't run, ask your administrator to confirm that the required application files have been installed and that the infographic starter templates have been published to the portal.

    Run Report example

  6. If no feature is selected on the map when the widget opens, you can select a feature on the map and then run infographics and reports for it. Depending on which options are enabled for the widget in the app, you may also be able to search for locations and draw on the map to get related information using the following options:

    Default home screen for widget including search box and all three drawing tools

    • Enter a place name or address in the Find address or place field to search for a location.
    • Click the add point button Add point button to add a point by clicking on the map.
    • Click one of the polygon buttons to draw an area on the map.

    For points, you can apply desired values of up to three rings, drive times, or walk times around it. You can run infographics and reports for the selected or added location or area.

    NoteNote:

    Running reports and infographics uses credits.