esri / summary-viewer-template Goto Github PK

A configurable application template that summarizes the numeric attributes of features in operational layer that are within the visible map area.

JavaScript 83.20% CSS 7.36% PHP 4.50% HTML 4.94%

web-application javascript portal summarize summary-viewer web-development configurable-apps

summary-viewer-template's Introduction

ArcGIS Configurable Apps will be retired in 2025. The ArcGIS Configurable Apps source code repro is deprecated and will not receive further updates. In addition, this repository will be removed in October 2025, along with the October 2025 ArcGIS Online update.

Deprecated: summary-viewer

Summary Viewer is a configurable application template that summarizes the numeric attributes of features in operational layer that are within the visible map area.

View it live

Features

A configurable application template that summarizes the numeric attributes of features in a specific operational layer that are within the visible map area. The summaries can be configured to show the sum, average, minimum or maximum values.

Instructions

Download and unzip the .zip file or clone the repo.
Web-enable the directory
Access the .html page
See the readme page for more details.

Deploying

To deploy this application, download the template from Portal/ArcGIS Online and unzip it.
Copy the unzipped folder containing the web app template files, such as index.html, to your web server. You can rename the folder to change the URL through which users will access the application. By default the URL to the app will be http://<Your Web Server>/<app folder name>/index.html
Change the sharing host, found in defaults.js inside the config folder for the application, to the sharing URL for ArcGIS Online or Portal. For ArcGIS Online users, keep the default value of www.arcgis.com or specify the name of your organization.

ArcGIS Online Example: "sharinghost": location.protocol + "//" + “<your organization name>.maps.arcgis.com
Portal Example where arcgis is the name of the Web Adaptor: "sharinghost": location.protocol + "//" + "webadaptor.domain.com/arcgis"

If you are using Portal or a local install of the ArcGIS API for JavaScript, change all references to the ArcGIS API for JavaScript in index.html to refer to your local copy of the API. Search for the references containing "//js.arcgis.com/" and replace this portion of the reference with the url to your local install.

For example: "//webadaptor.domain.com/arcgis/jsapi/jsapi" where arcgis is the name of your Web Adaptor.

Copy a map or group ID from Portal/ArcGIS Online and replace the default web map ID in the application’s index.html page. You can now run the application on your web server or customize the application further.

Note: If your application edits features in a feature service, contains secure services or web maps that aren't shared publicly, or generate requests that exceed 200 characters, you may need to set up and use a proxy page. Common situations where you may exceed the URL length are using complex polygons as input to a task or specifying a spatial reference using well-known text (WKT). For details on installing and configuring a proxy page see Using the proxy. If you do not have an Internet connection, you will need to access and deploy the ArcGIS API for JavaScript documentation from developers.arcgis.com.

Requirements

Notepad or HTML editor
Some background with HTML, CSS and JavaScript
Experience with the ArcGIS API for JavaScript is helpful.

Resources

ArcGIS API for JavaScript Resource Center

Issues

Found a bug or want to request a new feature? Please let us know by submitting an issue.

Contributing

Anyone and everyone is welcome to contribute.

Licensing

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

A copy of the license is available in the repository's license.txt file.

summary-viewer-template's People

Contributors

Stargazers

Watchers

summary-viewer-template's Issues

Provide additional configurable text in configureApp.html

Currently, there are several text values in the app that are hard-coded and it would be nice to have options to set them in the ConfigureApp dialog:

"Hint" text for the Filter - currently set to "All" explicitly - It would be great if this could be set to the field name used for the filter or user-configurable value.
Label for the "COUNT" summary is hard-coded to "COUNT":

Filter Functionality

The Summary Viewer app on ArcGIS Online allows for an optional filter in the summary layer configuration. The filter does not appear to be available in this downloaded version of the application and it would sure be nice if it was.

apply layer visibility scale levels

Hi, like the template. I would like to suggest/request a small change: the ability to apply layer visibility scale levels to the summary data. Thanks NSWSES

Expand width of Field Selection

When selecting fields for summary attributes, the narrow width of the dialog makes it difficult to differentiate between fields, this could easily be increased to be wider which would improve the UX. Best case would be to increase it to the length of the longest field, as I understand it also looks strange if it is wider than all of the field names.

Current:

Better:

Cluster not working with Multipoint feature class

Hi Kelly,

I am trying to use a multipoint feature class with the viewer but have noticed that the cluster feature is not working.

I am working with the following webmap: b0170557ffe14758baa081c139f13528

and summing off of these layers:
{
"id": "sumFields",
"fields": [
"TOTAL_FUND",
"BP",
"BPTRANS",
"MOEX"
]
},

I have also tried filtering on PRJ_ID. Any suggestions?

Smitty

Map extent across 180th meridian

Sorry, this might not be the right place for this issue, since the error isn't in this github repo or the live version linked to here. But it is in the hosted ArcGIS Online version of the Summary Viewer as of early August 2015.

If the current extent of the map includes the 180th meridian, the extent used for the statistics wraps horizontally around the entire world.

Steps to reproduce:

Open the live example from the ArcGIS Online gallery of the Summary Viewer
Navigate to an extent that includes the 180th meridian but doesn't include any features (the string of atolls to the northwest of Hawaii is a good landmark)
Note the summary statistics aren't 0

I'm not sure the implications of changing the main.js > summarizeFeatures() function back to its state in this repo, but the new normExts in the summarizeFeatures function as seen in the hosted version of main.js seems to be what's causing problems.

If you add a graphic to the map in that function to symbolize the normalized extent used, you'll see it start at the 180th meridian and extend around the world.

// existing code in hosted version
if (normExts.length > 0) {
  ext = normExts[0];
  for (var j=1; j<normExts.length; j++) {
     ext = ext.union(normExts[j]);
  }
  // new code to symbolize one of the problematic extents
  if (normExts.length > 1 && !this.map.graphics.graphics.length) {
    var sym = new esri.symbol.SimpleFillSymbol();
    sym.outline.setColor('red');
    var gr = new Graphic(ext, sym);
    this.map.graphics.add(gr);
  }
}

Update Readme.MD

Update Readme.MD "Try it Live" to point to arcgis.com webmap, not DevExt webmap