search

xiao8579 / QuickCapture-Testing

Repo for feedback and issues during QuickCapture testing events.
0 stars 0 forks source link

[Exercise] Share your project with App Links #2

Open xiao8579 opened 4 years ago

xiao8579 commented 4 years ago

Description

ArcGIS QuickCapture can be integrated with other apps using either App Links or a custom URL scheme. Both AppLinks and custom URLs support the same parameters, so the expected behaviors will be the same.

App links Custom URLs
Allows launching of/from all Esri apps (as long as they support app links) Allows launching of/from all Esri apps. But for iOS, only if the apps have respectively whitelisted each other
Only supported on iOS and Android Supported on iOS, Android and Windows

Test Areas

Steps:

  1. Download QuickCapture mobile app following instructions on the WIKI page.
  2. Construct app link with below test cases.
  3. Open the app links on your mobile devices, verify that the link can successfully:
    • Direct to the download page if you haven't download the app yet.
    • Download the open the specified QuickCapture project on your phone, and the test cases work as expected.

Notes: If you are WFH and connect to your own network at home, you will need to use Esri VPN in order to sign in the Enterprise portals.

Test cases

  1. Test the link You can create a link/URL to open the QuickCapture mobile app that can be embedded into your own native or web app. Type https://quickcapture.arcgis.app/ into your browser for testing.

  2. Sign in to a specified portal To launch and download a project from a specific portal, include the portalUrl parameter. For example, https://quickcapture.arcgis.app/?portalUrl=www.arcgis.com

  3. Download and launch a specified project To include your project in the URL you're constructing, add ?itemId= and your project item ID to the app link. Your URL should look similar to the following: https://quickcapture.arcgis.app/?itemId=dcdb68465fbc4c38a6aba7f5165cdfd4

  4. Include a predetermined user input value To do this, the app link must include a reference to the user input variable. For example, to populate a user input variable whose ID is 001, type &userInput:001= and the value you want to enter; the ampersand (&) acts as a parameter separator. The following example URL would launch QuickCapture and populate the user input value with the content of the workArea field https://quickcapture.arcgis.app/?itemId=dcdb68465fbc4c38a6aba7f5165cdfd4&userInput:001={workArea}

Feedback

Please provide your feedback to us:

  1. Add your comments under this issue about your impression and use experience of this functionality.
    • Can you successfully construct the app links and download the project accordingly?
    • Are the parameters work as expected during your test?
  2. Log separate issues in this repo to report bugs or request enhancements during your test.
xiao8579 commented 4 years ago

Demo screenshots: Animation

esoekianto commented 4 years ago

I tested this and made sure that the URL parameters are case-insensitive, which means users are free to make "mistakes" regarding case sensitivity. Nice!

mzugelder commented 4 years ago

Working as expected so far. I launched a QC Survey from a URL embedded in a WAB App and it successfully launched the QC app and prompted me for a login. After login it downloaded the survey no problem.

mzugelder commented 4 years ago

Working as expected so far. I launched a QC Survey from a URL embedded in a WAB App and it successfully launched the QC app and prompted me for a login. After login it downloaded the survey no problem.

Also, tried this with both a new 'QuickCapture Project' item and the older 'Mobile Application'. Works with both.

jerjer007 commented 4 years ago

Before adding a 'link' button, I made a new group. But I was not able to 'customize' the group, such as adding a name, until I added a button to the group.