Add ability to download data from Online portal item

[kerryrobinson]

To make it easier for users to get the demo data, especially on mobile platforms, let's add an option to download data (instead of sideloading it). It could work similar to the download options we already have in our samples app. This should work both for the demo data we provide in ArcGIS Online (the Monterey data) and for any custom data that has been created (in other parts of the world, for instance).

This issue is specific to the ability to download the default Monterey demo data for the app

Requirements:

• New tool (download icon) to "Download Data" - Could be in DSA Settings
  • If user opens the app and other is currently no data in the DSA folder, user should be directed too the DSA Packages tool so they can download the data.
• Options for where to find the data:
  • "DSA Demo Data" - this is a well-known Portal item that contains a zip file. The user doesn't need to know the exact portal item URL, it just goes straight there and downloads (like how it works in the Samples app)
  • "Custom Data" (this is part of the follow-on issue Add ability to download and manage custom DSA packages #402)
• Data is unzipped into the DSA data folder, according to the platform it's deployed on
• If data already exists, ask the user if they want to wipe it first, otherwise cancel/abort!

Questions:

• how to handle overwriting? how to know there is existing data there?
  • can possibly give the user the option to wipe the existing data and replace.
• should we allow the user to manage two sets of data?
  • ultimately this would be great, but for now let's just focus on downloading the data. we should create an issue to capture how it could work managing more than one dataset, etc.
• How to handle if the data isn't in the correct folders, etc?
  • Just unzip anyway. The app will open and let the user know that it can't find.

Definition of Done:

• Design discussed and agreed
• Create new issue for the ability to specify a URL/path to custom data to download (but the user can manually copy the data into the folder structure) Add ability to download and manage custom DSA packages #402
• Implementation done
• Doc updated (covered in Update app download page description with new Android data location and process #370)
• Tested and verified

[kerryrobinson]

Let's also see if this tool could accommodate pointing to a user-specified zip file of data (description/requirements updated above)

[kerryrobinson]

Discussed:

• "DSA Package" zip file
  • everything must be according to the prescribed folder structure
  • all packages will be put into a subfolder of DSA, with a descriptive name ("SanDiego")
  • must include a config file but do a find and replace using the root directory to change to the new root directory (so easy to deploy on multiple platforms with different root directory)
  • specify the name for the folder by specifying a name in the browse/download panel (if the user use the 'download default demo data' tool, put in the default folder)
• Allow the DSA user to switch between DSA packages
  • store the name of the folder in a json file at the root DSA folder so it knows which one to start up.
  • expose the DSA Package switcher in the DSA Packages panel

[kerryrobinson]

Feedback from Lucas:

• If user opens app with no data, can we notify the user that they have no data and should use the tool to download it? Bare minimum is to notify, maybe can also include the tool to download the package (as well as Cancel).
• Put configurations panel as another option when you hit the gear button (parallel to Settings and About)
• Need an icon that shows download instead of upload.
• Need to describe to user what they need to change with regards to the data 'schema'