Verschillende apps laten samenwerken met behulp van een Custom url Scheme

Binnen het Esri platform zijn er verschillende apps beschikbaar die allemaal hun eigen specifieke toepassing hebben. Soms is het echter fijn als je voor bepaalde werkzaamheden meerdere apps kunt combineren. Dit kan met behulp van een ‘Custom URL Scheme’. In dit artikel worden handvatten gegeven hoe je, in dit geval, survey123 kunt openen vanuit een andere app.

Apps die geopend kunnen worden met een Custom URL Scheme zijn bijvoorbeeld ArcGIS Workforce, Field Maps, Survey123 en Navigator. De URL kan echter ook gebruikt worden binnen andere apps om bovenstaande apps te openen. Een voorbeeld hiervan is je eigen web mapping application. Met behulp van een Custom URL Scheme kun je bepaalde apps automatisch laten openen en bestaat er de mogelijkheid om alvast parameters van een object mee te geven.

In onderstaand technisch artikel wordt de toepassing van een Custom URL Scheme besproken. Eerste wordt kort uitgelegd hoe een Custom URL Scheme eruit ziet en vervolgens hoe deze geintegreerd kan worden in een app.

Hoe ziet een Custom URL Scheme eruit?
Het eerste component van een URL definieert altijd de app die geopend moet worden. In dit voorbeeld gaat het om de app Survey123. Je gebruikt hier: arcgis-survey123://. Deze URL zal de app openen op de standaard login pagina. Wil je een specifieke survey openen, dan kun je parameters aan de URL toevoegen. Aan het begin komt altijd een vraagteken (?) te staan. Daarachter kun je met ‘itemID=’ en het ID van de survey een specifieke survey openen:

arcgis-survey123://?itemID=89bc8c7844e548e09baa3aad4695e78b

URL integreren in pop-up
Het is mogelijk om vanuit een web map vragen van de survey automatisch in te vullen. Dit kan met de volgende string:

arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:type=windmolen

Hier is ‘type’ de vraag die ingevuld moet worden in de survey en ‘windmolen’ de informatie die in dat veld opgenomen moet worden. De parameters worden gescheiden met een ‘&’ teken.

Het is ook mogelijk om aan de survey de eigenschappen van het object mee te geven, door in de pop-up te verwijzen naar de attribuutwaarde van het desbetreffende object. De URL ziet er dan als volgt uit:

survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:type=windmolen&field:naam={name}

Een andere handige parameter is center. Hiermee kunnen coördinaten meegegeven worden aan de URL, zodat Survey123 op die locatie een survey aanmaakt. Je kunt dit doen door ‘&center=’ te typen, gevolgd door de coördinaten in longitude en latitude (decimale graden, gescheiden door een komma). De URL komt er dan als volgt uit te zien:

Arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:type=windmolen&field:naam={name}&center= 52.143245,5.243456

Aanvullende informatie

Dit artikel heeft een aantal mogelijkheden laten zien hoe je apps met elkaar kan koppelen. Meer informatie over Custom URL Schemes kun je terugvinden in de help: Integrate with other apps of in dit blog-artikel: Understanding Survey123's Custom URL Scheme

-----------------------------------------------------------------

Integrate with other apps, https://doc.arcgis.com/en/survey123/reference/integratewithotherapps.htm

Understanding Survey123's custom URL Scheme, https://community.esri.com/t5/arcgis-survey123-blog/understanding-survey123-s-custom-url-scheme/ba-p/900291