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

Cost Analysis widget

The Cost Analysis widget allows you to assign a cost factor for each feature you create. These costs are automatically tallied and provide an overall project or event cost. Additional cost factors can be applied, or the entire cost can be scaled based on factors not captured in the data. Costs can be assigned for the edit templates of each layer, and they can be different depending on the area in which the features are created.

Configure settings

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. Hover over the widget and click the Configure this widget button Configure this widget to open the configuration window.
    NoteNote:

    If you need to add the widget to the app first, click a widget placeholder on the Widget tab. In the Choose Widget window that opens, select the widget and click OK.

  2. Check the options to customize your widget. A description of each setting is listed below.
  3. Once you've configured your settings, click OK to close the dialog box and apply your changes.

There are five sections to consider when configuring the Cost Analysis widget: general settings, project settings, layer settings, costing info, and additional settings.

General settings

The general settings options are as follows:

  • Cost Unit—The standard of measure for displaying the length and area of features to be costed.
  • Cost Symbol—Displays the cost.
  • Round Cost—The rounded final cost of the project.
    NoteNote:

    Individual line items are not rounded, only the final result.

  • Type of Project Area—As you sketch in features, a boundary of all the features in your project is made. Use this setting to determine the type of area you want.
  • Allow users to export report of the project—Users can export a report of all the assets and any additional costs associated with the project. To make changes to the report format, click the edit button. In the Report Setting window, specify the report name, what information to include, and in what order.

Project settings

The project settings options are as follows:

  • Define geography for costing—This option allows you to set cost equations of feature templates based on geographies.
    • Costing Geometry Layer—If your project consists of different areas of interest, and those areas have different costs associated with them, specify them here. This layer must be a polygon.
    • Field to Label Geography—The descriptive field of the costing geometry to display.
  • Ability to Save and Load project settings—Configuring these tables and layers allows you to save or load the project.
    NoteNote:

    The settings on these tabs are optional. If you decide not to specify any of these parameters, you can still cost out features you sketch on the map. The widget still provides the final cost of all features sketched. It will not save the project, so if you restart the app, all your cost information is removed.

    • Project Assets Table—This table associates all drawn features to the project along with any costing geography so that a project can be reloaded at any time.
    • Project Multiplier Additional Cost Table—This table stores costs that are not associated with any feature, such as rebates, credits, sponsorships, and rentals.
    • Project Layer—This is a polygon feature layer that stores the details of the project along with the net and gross cost of the project.
    • Point Layer Centroid—This point feature layer is automatically generated based on the centroid of the project layer.

Layer settings

The Layer settings tab shows all the layers in the map. You can select the layers you want to edit and use for costing out a project. If there are layers that are not editable, the Editable check box will be unavailable. Optionally, you can configure the attribute settings to map project fields to corresponding layer fields.

Costing information

The options on the Costing Info tab are as follows:

  • Feature Template—The layers for which you enabled editing on the Layer settings tab are listed here as individual tables. There is a row for each feature template for its corresponding layer. This allows you to cost each feature template independently. You can have more than one of the same feature template as long as you have a different Geography or Scenario setting for each.
  • Cost Equation—This is where you define the cost for each feature template.

    You can have a fixed number, such as 100. Each time you sketch in a feature from this feature's template, 100 appears in the line item. This text field also supports mathematical expressions. Additionally, there are built-in variables you can access to build complex expressions. These built-in variables are {MEASURE} for the length or area of the feature, {TOTALMEASURE} for the length or area of all the same drawn features, and {TOTALCOUNT} for the count of all the same features. You can build an expression such as {MEASURE} * 100. If you draw a line, the widget will multiply the length of the line by 100 to calculate the cost of that feature.

  • Geography—If you specified a cost geography on the Project Settings tab, this drop-down list will show the distinct records.

    The Geography option allows you to define cost by geographic area. For example, you have a costing geography that consists of high fire threat regions and low fire threat regions, and you have a feature layer for electric poles. Your feature templates for an electric pole are based on material, and one of the values is wood. For the low fire threat region, you set the cost to x, where x is the base cost of the pole. In the high fire threat region, you set the value of the wood pole to 2x, because it has to be treated to resist fire. If you choose to break down your costing by geography, you need to ensure that for each feature template, you have a none case. This is in case your sketch falls into an area that is outside of any costing geography, but still needs a cost associated with it.

  • Scenario—Scenarios behave similarly to geography but without any spatial component. If you have different use cases where you need to have different costs, this is when scenarios are useful. You can manage scenarios by clicking the Manage Scenarios button.

    For example, if you have a tree trimming route, you can define different contractors as scenarios so that contractor 1 costs x amount to trim trees and contractor 2 costs y amount to trim trees. The contractors would be added as scenarios. You can have the same scenario in different costing geographies. In this example, contractor 1 can trim in both high and low fire threat regions.

  • Actions—Allows you to delete or copy rows.

Additional settings

If there is a need to understand statistical information in your project, use the Additional settings tab to configure those calculations.

  • Statistics—Allows you to define statistics that persist to all new projects. You can also build new statistics while using the widget; these statistics are not saved and are lost when the application is reloaded.
  • Additional Project Cost—Allows you to define additional project costs that persist to all new projects.

Use the Cost Analysis widget

Complete the following steps to configure the Cost Analysis widget:

Steps:
  1. Click the Cost Analysis widget button Cost Analysis button.

    Cost Analysis window options

    The Cost Analysis window appears with options to create a project, load an existing project, or update project equations in existing projects.

  2. Click Create Project. Fill in Project Name and Project Description and click Create.

    Cost Analysis window with project loaded

  3. When your new project loads in the widget pane, explore the following elements:
    • Project Name shows the name of the current project you are working on.
    • Feature Creation Mode offers options to create assets or replicate the location of existing assets using the template of your choice from the Select a template to create new assets section.
    • Asset Items shows the list of assets added on the map, the cost for each item, and the total and gross costs of the design works.
    • Asset Statistics allows you to define statistics for your design. Click Add New Statistics to add values based on a field from a layer in your map.
    • Project Summary allows you to view and edit project attributes.
    • Back returns to the previous pane. Refresh refreshes the assets from a project layer.
      NoteNote:

      If you reload the app without clicking Refresh, the features are still present in the underlying feature layer. You will need to use another widget, such as the Edit widget, to remove the remaining features. If project layers weren't defined in the widget configuration to allow saving and loading projects, clicking Refresh or reloading the app clears all your sketches.

  4. Say you're a planner at a wastewater utility who wants to know the estimated cost to extend sewer service to a new community located at Cortez Ct, Naperville, Illinois, 60563. Use the feature template picker and choose the 12" Proposed Main and then sketch in the new main on the map. The result shows that the cost to install the mainline sewer pipe is more than $200,000 at $100 per foot with an 8% tax fee, which can be set in the Asset Item Details pane.

    Choose Proposed Main

  5. Since you're extending a new service to the area, you need to increase the capacity servicing this new extension. Select the 16" Proposed Main template and click the Feature Mode button Feature Mode. Select the mainline just northeast of the new extension.

    Mainline on the northeast selected

  6. Copy over all the selected features or uncheck the features you don't want to copy. Click Create Features to create individual features or click Create 1 Multi-Geometry Feature to create a single multipart feature. The results are copied to the 16" Proposed Main layer in the current cost project.

    The newly copied feature is now included in your costing project, and the total cost of the project has increased to $500,000.

  7. This design qualifies for a discount. To determine how much money this will save the project, click the Asset Items arrow.

    Asset Items arrow

    A detailed view of the cost items appears, allowing you to edit the cost equation.

  8. Expand Proposed Main.
  9. Click the Summation button next to the 12" main.

    Expanded Proposed Main with the Summation button emphasized

    A window appears where you can override the cost equation that was initially set up for this layer.

  10. Change the value from {MEASURE} * 100 to {MEASURE} * 90 to reflect the $10 discount, and click OK.

    New cost equation

    You now see the new cost of the mainline pipe and the new cost of the entire design.

    Total cost for proposed main

    The total cost decreased by approximately $25,000. You're finished with this estimation and can now share the results with the project manager to discuss the next steps.