I’d like to replicate the "Survey123 field app" to load a predetermined survey on startup.
Similar to how the Quick Report template works.
e.g. On startup I want it to look like a standalone application for collecting water quality data or collecting tree data, etc….
Any help is greatly appreciated
Thanks,
Gee
Hello Gee,
The easiest way to achieve this without creating custom Survey123 app, is to use custom URL Scheme as explained in this blog, Understanding Survey123's custom URL Scheme
Something like,
arcgis-survey123://?itemID=89bc8c78xxxxxx
Hope this helps,
Erwin.
Hi Erwin Soekianto,
Thanks for this suggestion.
But, I'd like to create a standalone application with our own branding, that would load a predetermined survey on start-up.
I am aware this may not be a quick exercise. But, I'd like to know if this is possible and how to go about it. Sathya Prasad Marika Vertzonis
Thanks,
Gee
Yes you can customize Survey123 using the template supplied in AppStudio as little or as much as you like. Id suggest that you use the template to re-brand the app, and then using the URL scheme that Ewin suggests, to launch your re-branded app with the survey you want. You can go further if you like, but that's really up to you and how much time and skill you have to put to the customization task. Re-branding should be minimal effort
Thanks all.
Gee
where does one put this URL scheme in? I have changed in the app settings, is it in the parameters? Are there any documentation or help files that explain where to input the custom URL and how?
I am talking about appstudio. I have downloaded the survey123 template...then what? Where does one customize the app in QTcreator? where can one find the URL scheme and change it? Where can someone like me, who is not a programmer find a simple documentation on how to either:
open a survey from an appstudio app
or
open a specific survey123 from the appstudio app template?
The documentation is seriously lacking for a commercial package that ESRI sells for over 1000USD.
Hi Erwin,
I am not sure if this is the same as Gee but I am also looking to create a Survey123 app that will launch a single predetermined Survey. Consider the Map Tour template where you can enter a Map ID to skip the map gallery and have it launch a predetermined web map on launch.
Is it possible to configure the Survey123 template code to skip the Survey portal\gallery and launch a predetermined (public) survey on launch? That way, I could create and distribute a specific application for a specific survey.
Hello Matthew,
This is the same question as above.
Something like,
arcgis-survey123://?itemID=89bc8c78xxxxxx
Let me know if this helps,
Erwin
I am currently viewing the SurveysGalleryPage.qml and searched for 'itemID' and 'checkOpenParameters' and nothing came up....
It should be simple enough to enter an itemID and have the app load an existing survey? I thought that was what the URL schema did, but it does not work either...
Hi Gee and Matthew,
We are currently working on some new beta features in Survey123 that would allow further workflow extensibility options where the initial loading of the app, galley page etc could be customised, enabling you to launch directly into a single survey for example, and many other workflow related Survey123 tasks. Keep an eye out in the Early Adopter Community for when we make this beta feature available to be tested. No timing as of yet, but we are working on it. In the meantime the best option is to modify the source code and build you own custom app as Erwin explains above.
I have updated the internal issues with your comments and requests.
Phil.
are there any updates on this? We want to launch a series of public crowd sourcing apps - survey123 apps that open a public survey directly. Seems simple enough but ESRI technical support was not able to help and we are doing an official app launch next week...it is a shame to have a long work around (download survey123, search for survey, download), which are several steps which prevent people from easily accessing the app, and it's also not branded.
Anyone know a developer who could create these kind of customized survey123 apps for us would be greatly appreciated as it seems there is no ready ESRI software solution available...
Aurelie,
When Survey123 is installed, it's really easy to open a specific survey directly, using a link... users do not need to search for the survey, you can present it to them.
the applink pattern is: arcgis-survey123://?itemID=<Survey_ID>
This blog article shows how to launch a specific survey from Explorer for ArcGIS... not exactly what you are asking, but some information you may find useful. Using App links to Launch Survey123 from Explorer for ArcGIS
I believe you could do this in two links.
Link to install Survey123
Applink to Open the Survey.
Mark
thank you Mark,
I agree it should be "really easy" to open a survey in survey123 but unfortunately it isn't.
Imagine the possibilities if people could make apps that are surveys!
I purchased a developer Builder account from ESRI to the tune of 1250$ to be able to customize and brand survey123 with appstudio, which I did, but it's useless - it is not possible to open a survey without a login first. The workflow you outlined can only use esri's survy123 and is what we have been doing, but we wanted branding and invested in developer.
The goal of my public app is to make it as easy, simple and straightforward as possible for people to access and fill out the survey. With this workflow they won"t do it and it's just clunky.
Or they have to install collector, find my map, then click open a survey123? that's even worse.
Esri technical support spun me in circles for weeks and now told me I need to hire an app developer. Which means my investment into the developer account was a loss - I could have used that money to just pay someone design an app from scratch.
****************
Aurélie Shapiro
Remote Sensing Specialist
WWF Germany
www.wwf.de/remote-sensing
Aurélie,
If you prefer to go for the 2nd option from my suggestions above, which is customizing the source code of Survey123 field app. This is the simplest code change I could think of, this is done on template/SurveyGalleryPage.qml
Component.onCompleted: {app.openParameters = JSON.parse('{"itemID":"814e2804146341c89c237d166de19b0b"}');}
So I instead of opening the Survey123 using custom URL scheme explained above (1st option from my suggestions), we are going to add a block of code setting that `openParameters` as if we have a parameter, which is the itemID of the survey that you want to open.
I have tested this, now the Survey123 field app will open a predetermined survey that you set in that block of code. But please take this solution with a grain of salt, as this is just a quick hack to prove that it is easy to do.
Also please note that this will open a survey that is public as you are required to login for surveys that are private or shared with an organization.
I hope this helps,
Erwin.
thank you erwin!
I did change the custom URL scheme in my app but it didn't have any effect on how it opens. I believe that is only if you want your app to open in another app like collector...which is too complicated - I just want one single app. Or maybe I am wrong - doyou have a screenshot of what it should look like (there are in fact 2 entries for custom URL in appstudio settings). Tech support could not provide this or confirm if my settings were wrong.
This block of code might be exactly what I am looking for and what I have asked in this forum...i will check it - thank you!!
-aurélie
****************
Aurélie Shapiro
Remote Sensing Specialist
WWF Germany
www.wwf.de/remote-sensing
Aurélie,
If you prefer to go for the 2nd option from my suggestions above, which is customizing the source code of Survey123 field app. This is the simplest code change I could think of, this is done on template/SurveyGalleryPage.qml
So I instead of opening the Survey123 using custom URL scheme explained above (1st option from my suggestions), we are going to add a block of code setting that `openParameters` as if we have a parameter, which is the itemID of the survey that you want to open.
I have tested this, now the Survey123 field app will open a predetermined survey that you set in that block of code. But please take this solution with a grain of salt, as this is just a quick hack to prove that it is easy to do.
Also please note that this will open a survey that is public as you are required to login for surveys that are private or shared with an organization.
I hope this helps,
Erwin.