Evenementgestuurde integraties met Data Interoperability

bharold

<\/HEAD>

Webhooks.  Als je niet codeert, zou je kunnen denken dat webhook-integraties eng zijn of op zijn minst extra middleware nodig hebben naast ArcGIS.  Fout op beide punten.  Alle burgerintegrators die een FME<\/STRONG> werkbank kunnen samenstellen met de Data Interoperability<\/STRONG> extensie, en de extensie hebben voor zowel Pro 2.6<\/STRONG> als Enterprise 10.8.1<\/STRONG>, kunnen webhook-gestuurde integraties automatiseren tussen Survey123<\/STRONG> enquêtes en alles wat Data Interoperability kan bereiken.<\/P><\/P>Ik zal het scenario schetsen voor het geval je dit automatiseringspatroon nog niet hebt bekeken.  Survey123 is een formuliergestuurde data capture-app die een feature service beheert waarbij elke enquête een punt-, lijn- of gebiedsfeature is met attributen die jij ontwerpt.  De formulieren hebben rijke functionaliteit en ondersteunen web- en mobiele apparaten.  Er zijn onbeperkte mogelijkheden voor downstream verwerking van enquêtefeatures.  Wat deze blog zal behandelen is deze datastroom:<\/P><\/P>Een Survey123 enquête-indiening belichaamt een transactie voor zijn feature service (toevoegen, bijwerken)<\/LI>Een webhook gedefinieerd voor het transactie-type wordt geactiveerd bij elke indiening<\/LI>De webhook URL is een execute-aanroep voor een Spatial ETL webtool (geoprocessing service)<\/LI>De webtool voert een integratie uit met behulp van de enquête-indiening feature(s)<\/LI><\/UL><\/P>Het samenstellen hiervan draait helemaal om configuratie, dus laten we beginnen.  Ik ga de meest voorkomende platformcombinatie beschrijven - Survey123 wordt gehost in ArcGIS Online en jouw integratieserver is een ArcGIS Enterprise portal - maar als je Survey123 op je enterprise-infrastructuur hebt, werkt dat ook.<\/P><\/P>Aangezien je een webtool gaat maken die een feature service leest en schrijft, moet je een webverbinding naar je server delen zoals beschreven in deze blog<\/A>, dus je eerste stap is ervoor te zorgen dat het service-eigenaaraccount (standaard 'arcgis' genoemd) op je server Workbench kan starten zoals beschreven en een webverbinding kan gebruiken naar waar Survey123 feature services zich bevinden.  Ga niet verder dan dit punt totdat je succesvol een webtool hebt gedeeld die de webverbinding gebruikt, zoals de testtool beschreven in de blog.<\/P>

<\/P>

Ik ga nu vooruitlopen om uit te leggen hoe je kunt voorkomen wat als een stille mislukking van je webhook kan lijken.  Survey123 (d.w.z.

https:\/\/survey123.arcgis.com<\/A>) zal jouw server aanroepen met een POST-verzoek, dus het moet vertrouwd zijn.  Hieronder zie je een schermafbeelding van mijn browser terwijl ik een enquête indien, met het debuggerpaneel open (Firefox).  Ik heb het POST-verzoek gemarkeerd dat naar mijn server is gestuurd - het werkte.  Als jouw server een verzoek van Survey123 weigert, zie je foutmeldingen over CORS - cross origin resource sharing.<\/P>

<\/P>

<\/P>

<\/P>

Bekijk dit onderwerp over hoe je Survey123 toegang tot jouw server kunt geven -

Cross Origin Resource Sharing.<\/A><\/P>

Zo ziet het eruit in de portalinstellingen:<\/P>

<\/P>

<\/P>

<\/P>

Voor mij was deze instelling niet genoeg, ik moest ook HTTP response header-instellingen wijzigen in IIS.  Open op jouw server IIS bij de HTTP Response Header-controle, dubbelklik om te openen en Voeg toe<\/STRONG> wat je hieronder ziet.<\/P><\/P><\/P><\/P><\/P><\/P>Nu de server is ingesteld, laten we beginnen met het configureren van de datastroom.  Als je scherp kijkt zie je dat mijn testenquête over een kaviaarsandwich gaat.  Als je de coördinaten onderzoekt, is het heel goed mogelijk dat je er daadwerkelijk één kunt kopen!  Mijn echte punt is echter dat Survey123 veel JSON verzendt, en het kan erg complex zijn voor een grote enquête.  Als je naar andere integratieplatforms kijkt, zul je merken dat hoewel ze proberen eruit te zien als no-code benaderingen, je misschien gedwongen wordt JSON halverwege te parseren om de gegevens te krijgen die je wilt.  Echter schrijft Survey123 altijd naar een feature service, die Data Interoperability natuurlijk native begrijpt, dus we hebben het voordeel dat we de rondvliegende JSON kunnen vergeten en direct naar de feature service gaan.  Fantastisch!<\/P><\/P>Eerst maak je echter jouw enquête aan.  Hier is die van mij:<\/P><\/P><\/P><\/P>Wanneer een enquête wordt ingediend, wordt er een feature geschreven naar zijn feature service en dan pas<\/<EM>, wordt elke geconfigureerde webhook geactiveerd - je kunt de applyEdits<\/<STRONG>> POST zien in mijn browser debug-weergave hierboven, vóór de webhook POST.  Om de integratie-geoprocessingservice nieuwe records te laten vinden, bevat mijn enquête een verborgen, verplicht vraag 'Integrated' met standaardwaarde 'N', die mijn integratie wijzigt naar 'Y'.  Ik heb mijn enquête gemaakt in de webdesigner, die geen verborgen vragen ondersteunt, daarna heb ik hem bewerkt in Survey123 Connect om de vraag toe te voegen, zo ziet het eruit wanneer bewerkt:<\/<p>

het enige wat nog resteert is het configureren van de webhook in mijn enquête.<\/P>

<\/P>

<\/P>

<\/P>

Nu, wanneer een sandwich-enquête binnenkomt, wordt mijn webhook-integratie geactiveerd en Integrated = 'Y'.<\/P>

<\/P>

<\/P>

<\/P>

Echte no-code integratie, mogelijk gemaakt door ArcGIS Data Interoperability<\/STRONG>.  Als je me bij lokale sandwichwinkels ziet, ben ik aan het werk - eerlijk.<\/P><\/BODY><\/HTML>