esri / crowdsource-manager

An ArcGIS Online group application template authored by organization and made available to operations staff to review incoming problems or observations; and assign problems or observations to appropriate staff.

crowdsource-manager

Crowdsource Manager, a companion group template to Crowdsource Reporter, allows users within an organization to review problems or observations submitted through the Reporter application.

Features

• Presents editable layers from one or more maps that have been shared with the ArcGIS Online/Portal group configured in the application.
• Users authenticate with their ArcGIS credentials to review problem details, update status, and assign responsibility for issues submitted to these layers through the Reporter app.
• The application is optimized for display on desktops and tablet devices using all browsers supported by ArcGIS Online.

Requirements

Experience

• Authoring maps
• Configuring ArcGIS Online/Portal web app templates

Software

• ArcGIS Online subscription or ArcGIS Portal

Browser Compatibility

• The application is optimized for display on desktops and tablet devices using all browsers supported by ArcGIS Online.

Instructions

General Help

• New to Github? Get started here.
• Want more info on this app? Check out the documentation.

Deploying

1. To deploy this application, download the template from Portal/ArcGIS Online and unzip it.
2. 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
3. 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"

4. 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/3.35" 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.

5. Copy a group ID from Portal/ArcGIS Online and replace the default group ID in the application’s default.js file. You can now run the application on your web server or configure 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.

Resources

Learn more about Esri's ArcGIS for Local Government maps and apps.

Show me a list of other Local Government GitHub repositories.

This application uses the 3.25 version of Esri's ArcGIS API for JavaScript; see the site for concepts, samples, and a reference for using the API to create mapping web sites.

Esri's ArcGIS Online Help site describes how to create web maps and web map applications in the ArcGIS Online ecosystem.

Issues

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

Contributing

Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing.

Licensing

Copyright 2014 Esri

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.

crowdsource-manager's Issues

Not using existing tokens

When I'm accessing this app from inside my AGOL org, I don't expect to be prompted to sign in again. The app should use the existing token and not prompt for credentials unnecessarily.

Android Tablet - Scrolling horizontally causes the header to lag behind the Observation List

Tested on Samsung Android Tablet (Galaxy 3) - device from test bank

Repro Steps
-Go to List View (happens in Split view too)
-Scroll Right in the Observation section
-Header is scolling slower than the list of records
(Header cannot catch up with the records during the scroll)

This does not happen on in the Desktop Browsers.

Selection options should reflect current state of app

the following options are available even when no features are selected:
Show Selected
Clear Selection:
Zoom To Selected

Please grey these out and disable them when no features are selected.

Cannot click links in map descriptions

This is the same issue that exists on the user interface.
Map descriptions may contain links. In AGOL, left-clicking those links opens them in a new tab. In this app, left-clicking does nothing, one must right-click and choose 'open in new tab' to access the link content.

Display user's name rather than username

The app currently displays my username (eg amuise_lg) in the top right corner. Please display the actual name (Allison Muise) associated with that account, instead.

Sign out doesn't work

after clicking 'sign out' the app should return the user to the sign in screen.
Currently, the app just reloads, and I'm still signed in.

Only public content displayed in app

Only maps that are shared publicly are displayed in the application, even if the authenticated user has access to the content. This should not be a restriction to viewing the content. If I am an authenticated user, and the map meets the other requirements (share with configured group, etc) the map should appear in the application, even if the map is not shared with anyone else.

use map search hint

When configuring search in the web map, there is the option to specify a search hint. This search hint should be displayed in the search text box

List layers in TOC order

Currently layers are listed alphabetically.

Change multi-select action

Instead of adding to the current selection when any area of a record in the table is selected, provide a check box on the left side of each row in the table. Features are selected by clicking the check box, and unselected by clearing the check box (or the 'clear all' menu option)

Clicking a feature in the map should:

• highlight the row in the table
• scroll the table to show the record
• not add the row to the selection

Check boxes should be styled like these:
HTML:

<p>
    <input type="checkbox" id="test1" />
    <label for="test1">Red</label>
</p>
<p>
    <input type="checkbox" id="test2" checked="checked" />
    <label for="test2">Yellow</label>
</p>

CSS:

/* Base for label styling */
[type="checkbox"]:not(:checked),
[type="checkbox"]:checked {
  position: absolute;
  left: -9999px;
}

[type="checkbox"]:not(:checked) + label,
[type="checkbox"]:checked + label {
  position: relative;
  padding-left: 25px;
  cursor: pointer;
}

/* checkbox aspect */
[type="checkbox"]:not(:checked) + label:before,
[type="checkbox"]:checked + label:before {
  content: '';
  position: absolute;
  left:0; top: 2px;
  width: 17px; height: 17px;
  border: 1px solid #777;
  background: #f8f8f8;
}

/* checked mark aspect */
[type="checkbox"]:not(:checked) + label:after,
[type="checkbox"]:checked + label:after {
  content: '✔';
  position: absolute;
  top: 0; left: 4px;
  font-size: 14px;
  color: #09ad7e;
  transition: all .2s;
}

/* checked mark aspect changes */
[type="checkbox"]:not(:checked) + label:after {
  opacity: 0;
  transform: scale(0);
}

[type="checkbox"]:checked + label:after {
  opacity: 1;
  transform: scale(1);
}

/* hover style just for information */
label:hover:before {
  border: 1px solid #4778d9!important;
}





/* Useless styles, just for demo design */

body {
  font-family: "Open sans", "Segoe UI", "Segoe WP", Helvetica, Arial, sans-serif;
  color: #777;
}

h1, h2 {
  margin-bottom: 5px;
  font-weight: normal;
  text-align: center;
}

h2 {
  margin: 5px 0 2em;
  color: #aaa;
}

form {
  width: 80px;
  margin: 0 auto;
}

.txtcenter {
  margin-top: 4em;
  font-size: .9em;
  text-align: center;
  color: #aaa;
}
.copy {

 margin-top: 2em; 
}

.copy a {
 text-decoration: none;
 color: #4778d9;
}```

Refresh button resets the current view of the application to Split View

Refresh button resets the current view of the application to Split View. User would probably expect that current view would persist after a refresh

Repro steps
-In Manager
-Set the application to Map View (or List View)
-Tap refresh
-Application will go back to split view

Display all 'display' and 'edit' enabled fields

( @CTLocalGovTeam I know we've discussed this one in meetings. Writing it down so it's documented)

All fields that have either/bot editing/display enabled should display in the app. Only editable fields should be editable.

This is different than the Reporter app.

Can't open details of features with editing templates

Repro steps:

Set up web map with a layer that uses AGOL editing templates.

1. Add an AGOL-hosted feature layer to a web map (don't use an existing map, or a layer that is used in other web maps as the changes in the following steps will affect ALL maps in which the layer appears)

2. Modify the layer symbology to use Unique Values and save the symbology

3. In the AGOL map viewer, click Edit.

4. At the bottom of the screen click the 'manage' button next to 'undo'

5. Set up editing templates and assign default values to the templates

6. share the map with a group, and share the group as a console app.

7. clicking any feature in the map will cause browser errors.

If no application title configured, app title displays 'Please Sign in'

If no app title is configured, no app title should display.
This message doesn't make any sense because I am signed in.
Messages should not be displayed as part of the app UI like this.

Update message when report cannot be displayed

When the report button (above the zoom controls on the map) is clicked, but no feature is selected, change the error message to:

"Please select a single feature to view the item details"

Update map/layer list UI to match Reporter

This work has been discussed previously and is included in the current sprint plan. I'm adding it here as well for tracking purposes.

Clicking rapidly between layers causes browser errors

Tested on multiple maps. Doesn't appear to be map, layer, or data specific.

Changing the display layers rapidly causes the browser to throw a series of errors such as:

Change View Options menu icon

I will provide a new graphic for this menu

Cannot configure app colour theme

The configuration panel provides an option for changing the colour of the app, but modifying this parameter only changes the background colour of the icons used in the application. This should control the overall app colour.

remove geographic filtering

remove geographic filtering from the table view. All features should be displayed regardless of what is in the current extent.

Update the table and map on a timed interval, or when a map/layer is loaded only.

Accessing the Manager application in a browser that is too small appears jumbled

On a really small browser OR on a smartphone the application icons are jumbled and the application is not usable.

Provide a message to users OR prevent them from having this experience

display comments in details view

Display comments for a feature (using comment popup formatting) under the thumbnails in the item details view.

accessing details view

open the details view for the currently highlighted feature. Clicking (not selecting via check box - #43 ) another record in the table should switch the details content to that of the just-clicked record.

change browser tab text

While app loads, tab displays 'Constituent Engagement'. Until the app name can be retrieved, don't display anything.

Add 'Help'

Add an entry for 'Help' to the username menu. Clicking this should open a window inside the app that displays configurable text content.

The purpose of this will be to give our users who configure this application a place inside the app to provide contact information, nav help, etc for their users.

Default app name

The default name of the application, as displayed in the AGOL configuration experience, doesn't match the name of the group, the default name in the configuration, or the name that is displayed outside the configuration experience.

The app name displayed in the configuration experience should match the app name displayed in the application. In both cases the group name should be used by default, unless a different name is provided in the configuration.

long map names are cut off

If a map name is too long to fit in the display, display an ellipses at the end and display the full name as a tooltip

Thumbnails not displaying

Web map thumbnails - default or configured - are not displaying. I'm not sure if this is the cause of the formatting issues I'm seeing. If not, please let me know and I'll create a seperate issue for the list appearing like this:

Change Selection Options menu graphic

I will provide a new graphic for this menu

tool tips?

tool tips seem to be missing from the UI. Please include tootips for all buttons and wherever else they may be needed for screenreaders

Summary shows up by default, even when configured off

When the map summary is turned off by default in the configuration panel, Summary is still displayed in the map details.

Once summary has been enabled and disabled in the configuration panel once, it behaves as expected.

Default configuration parameterse should be honored.

Table isn't honoring filters defined on map layers

Only Parking Sign Violations should be shown in the table when I'm looking at the parking sign violation layer because this web map layer has a filter restricting features to only features with this VIOLATION type.

The map is correctly displaying the 5 parking violation features.

Cannot change group using config panel

1. Share a group using the app
2. In the config panel choose another group
3. Click Save and Done
4. Open the application. The content displayed is from the initial group used, not the group that was selected in the config panel.

Allow app to be public

Currently the app prompts for credentials even if it, and the content displayed in it, are public.

Only prompt for credentials if the application or the content in it require credentials in order to display.

use group thumbnail for app icon

If the group has a thumbnail, this thumbnail should be displayed as the app icon in the top left corner of the app.

If an image is provided during the configuration of the app it should override the group thumbnail.

If the group does not have a thumbnail and no image is provided during configuration, use the current graphic as a fall-back.

Default map thumbnail

default map thumbnail, used for maps that do not have a thumbnail defined, should match the default map thumbnail used by ArcGIS Online

Signing In with an Esri Named User Acct will display the First and Last Name in reporter but just the username in manager

On Reporter -Signing In with an Esri Named User Account will display the First and Last Name of the user (For Example: Lindsay Thomas)
On Manager - Signing In with an Esri Named User Account will display the username (For Example: lind5149_lg)

Shouldn't they be the same?

Configurable option for color of active feature

Add a configuration panel item for choosing the color of the table row and selection graphic for the active feature.

Selected features will always be cyan.

Cannot update attributes

Attributes that are configured to be editable in the map popup should be editable through the application. Editing attribute values created empty browser prompts, and no edits are saved. If the field uses a domain, the browser throws the following error, then spins indefinitely: 'Cannot read property 'split' of undefined'

Map doesn't resize when browser is resized

When resizing browser from small to full screen, the map area doesn't resize to fill the new space.

Time selection works one click at a time

Choosing a time involve opening the widget, clicking an arrow to increment either the hour or minute one number (then the widget closes), reopening the widget and repeating the process until you get to the correct time.

Please use the same experience as the AGOL map viewer.

Update preview functionality

v1 of the app displays a static preview page when

• template is directly accessed without publishing an app from the template
• user chooses preview from "publish, preview, download" options while sharing a group

v2 of the app does not require preview page because the app will now display public content within the group. Sign in is not mandatory to access the app like in v1. Also, if user chooses to "Preview" while sharing a group, then groupid is passed as a url parameter that gets honored by the app and users will be able to see a dynamic preview of the app instead of a static html page preview.

These are our initial thoughts to begin the discussion. Need to update this after considering all possibilities of hosted, portal, public, private, mixed group environments.

Disable report button when reports not available

Reports are not available when no features are selected and when multiple features are selected. Disable the Report button in these circumstances.

Date formating

Date in long format are missing a space:

Before beginning work on this please let me know the level of effort required to include this fix in the next deliverable. As discussed this morning - this is not a showstopper and should not be fixed if it jeopardizes other dev work.

Maintain sorting after editing

Is there a way to maintain the sort order after committing edits? If I've edited the sort field, the record can stay where it is until I re-sort, but being bounced to the top of the list and needing to re-sort after every edit is a frustrating workflow.

Sign in/out arrow is too large

The downward-pointing arrow beside the username is too large, given that it is merely an indicator that clicking the username will show a menu. Please make this arrow smaller than the username font - approximately the height of short lowercase letter.

table header out of alignment with columns

I am seeing this in all browsers, although it is not consistent behavior.

If this is being caused by the vertical lines between the headers, let's remove them. If they are not the source, please fix without removing the lines.

layers turned off in map are showing in the app

Layers that are turned off in the map should not display in the application.

Change graphic marking selected feature in map

Please use a plain cyan square around the selected feature, rather than the current cyan square with crosshairs.

Cannot edit values on Android tablets

This was initially reported by CyberTech on a Tab 4 (Android 4.4.2).

I can repro on our Tab S (4.4.2) and Tab 2 (4.1.2).

Any text editing operation that causes the keyboard to open causes a refresh.