search

xiao8579 / QuickCapture-Testing

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

[Exercise] Link buttons - Launch Survey123 field app #29

Open xiao8579 opened 4 years ago

xiao8579 commented 4 years ago

Description

We introduced a new type of button in QuickCapture - link button. The new link button in QuickCapture allows users to construct a URL for the button, press the button will directly launch an URL. Except for fast data collection, QuickCapture can be used as a 'Launchpad' that redirect users to another app and continue their work.

More importantly, you can use the link button for App Integration stories. For example, to integrate QuickCapture with other field apps like Collector or Survey123, users can predefine what value (captured by QuickCapture when the button is pressed) to pass in the app link parameters for the target field app. image

Test

In the designer, you can configure the button to specifically open ArcGIS Survey123 field app, you can additionally browse and select a survey form and predefine the values for survey questions. The designer constructs the Survey123 link automatically.

To configure a button that launches the ArcGIS Survey123 field app, complete the following steps:

  1. Click the button and go to the Link tab.

  2. Click Survey123 field app.

  3. Select a survey to link to the button. This defines the itemID parameter in the Survey123 link.

  4. Click Add to add a survey question and match a fixed value, device variable, or project user input to the question. This defines the value of the specified field:fieldname parameter in the Survey123 link. Repeat this step to add all required survey questions. To remove a survey question that has been configured, click the delete button. This removes the specified field:fieldname parameter in the Survey123 link.

  5. Optionally, enable Return to QuickCapture to redirect the user to QuickCapture when a survey is submitted. This adds a callback:submit parameter in the Survey123 link.

  6. Make sure you download the lastest Survey123 field app from app stores.

  7. Download the QuickCapture project to your mobile app.

  8. Save and download the project to your device. Verify that the buttons are working as expected and the values in the custom URL are successfully passed to the Survey123 field app.

Please add your answers as comments

  1. How would you score this new functionality, range from 0 - 10?
  2. How can we improve current implementation, did you encounter any pain-points while using it?
glenshep commented 4 years ago

Successfully integrated and launched a Survey123 survey from QuickCapture Passed text, numeric, date attributes (Device Variables) to survey questions

How would you score this new functionality, range from 0 - 10?

10/10

How can we improve current implementation, did you encounter any pain-points while using it?

'Direction of Travel' passed through on some occasions but not others didn't encounter any other issues

J8L commented 4 years ago

How would you score this new functionality, range from 0 - 10? 11

How can we improve current implementation, did you encounter any pain-points while using it? I didn't have any issues and it worked well. Passed values and device variables. Callback worked on submission.

I had a Project User Input list in the Quickcapture project that matched choices in a select_one question in Survey123. When I assigned that survey question the Project User Input, this value was passed also. Very happy!

S123_Link