In der Survey123-Web-App werden Parameter in demselben Format wie in der mobilen App akzeptiert. Ein Unterschied besteht darin, dass die Element-ID für den Survey kein URL-Parameter ist, wie ihn die anderen Links zum Öffnen von Surveys verwenden, sondern Teil des URL-Pfades ist. Wenn Sie dieser URL Parameter hinzufügen, müssen Sie ein Fragezeichen verwenden, um die Element-ID des Survey im Pfad vom ersten Parameter zu trennen, und danach kaufmännische Und-Zeichen als Trennzeichen zwischen nachfolgenden Parametern verwenden. Die folgende Beispiel-URL übergibt den Nachnamen (surname) und die Koordinaten als Parameter an einen Survey in der Survey123-Web-App:
https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19?field:surname=Klauser¢er=37.8199,-122.4783Die Survey123-Web-App unterstützt zudem eine Reihe von Parametern, die von der mobilenSurvey123-App nicht unterstützt werden. Diese beziehen sich auf die Darstellung eines Survey im Browser: Mit den URL-Parametern und Beispielen in der folgenden Tabelle kann das Öffnen der Web-App angepasst werden.
Hinweis:
Wenn ein Parameterwert Leerzeichen, Pluszeichen (+) oder andere Sonderzeichen enthält, sollten diese Zeichen mit Prozentcodierung versehen werden. Weitere Informationen finden Sie unter URL-Codierung.
URL-Parameter zum Starten der Web-App
| Parameter | Beschreibung | Typ |
|---|---|---|
signIn | Bei öffentlichen Surveys wird die Schaltfläche "Anmelden" angezeigt oder das Anmelden obligatorisch gemacht. Standardmäßig stellt die Web-App keine Möglichkeit zur Anmeldung für öffentliche Surveys bereit. Öffentliche Surveys können jedoch Funktionen enthalten, die nur funktionieren, wenn die Benutzer angemeldet sind. Ein Beispiel ist die Verwendung einer Berechnung zum Extrahieren der E-Mail-Adresse eines angemeldeten Benutzers. Gültige Werte sind show zum Anzeigen der Schaltfläche "Anmelden" in der Navigationsleiste oben in der Web-App und require. Bei Verwendung dieses Wertes werden die Benutzer für die obligatorische Anmeldung zur Anmeldeseite umgeleitet. Beispiel: | Zeichenfolge |
isOrgSignIn | Verwendet die organisationsspezifische Anmeldeseite. Survey123 verwendet standardmäßig die organisationsspezifische Anmeldeseite. Bei Freigabe von Surveys für mehr als eine Organisation kann jedoch die ArcGIS Online-Annmeldeseite vorzuziehen sein. Legen Sie für diesen Parameter false fest, um die ArcGIS Online-Anmeldeseite zu verwenden. Beispiel: | Boolesch |
center | Zentriert die Karte auf einen bekannten Breitengrad, Längengrad und optional eine Höhe. Beispiel: | Zeichenfolge |
field:fieldname | Füllt Survey-Fragen mit Feldwerten. Beispiel: | Zeichenfolge |
portalUrl | Gibt die URL zu dem Portal an, in dem das Survey-Element gehostet wird. Beispiel: | Zeichenfolge |
| open | Gibt die App an, die zum Öffnen des Survey verwendet wurde. Gültige Werte sind web zum Öffnen des Survey in der Web-App (Standardeinstellung), native zum Öffnen des Survey in der mobilen App, sofern diese installiert ist, und menu zum Öffnen einer Webseite, auf der festgelegt ist, mit welcher App der Survey geöffnet wird. Beispiel: | Zeichenfolge |
| hide |
Blendet Elemente des Survey in der Web-App aus. Der Parameter kann mehrere Werte akzeptieren, die jeweils durch Kommata voneinander getrennt werden müssen. Gültige Werte sind navbar (die Leiste oben auf dem Survey, einschließlich der Optionen zum Anmelden, Abmelden und Ändern der Sprache), header, description, footer, submit, theme und leaveDialog (die Warnmeldung, die angezeigt wird, wenn die Seite verlassen oder geschlossen wird). Sie können auch den Parameter field:fieldName statt fieldName verwenden, um eine bestimmte Frage, Gruppe, Seite oder Wiederholung durch Angabe des Namens auszublenden. Fragen innerhalb von Wiederholungen können nicht einzeln ausgeblendet werden. Beispiel: | Zeichenfolge |
| locale | Ändert die Sprache des Survey. Funktioniert nur, wenn der Survey mehrere Sprachen umfasst. Beispiel: | Zeichenfolge |
| mode | Legt den Modus der Web-App fest. Gültige Werte sind edit (legt für den Survey fest, dass keine neuen Einträge erstellt, sondern vorhandene Einträge bearbeitet werden), view (öffnet einen vorhandenen Eintrag im schreibgeschützten Modus) und copy (erstellt einen Survey, der mit dem Inhalt des angegebenen Eintrags gefüllt ist). Wenn Sie diesen Parameter verwenden, muss auch der Parameter globalId angegeben werden. Beispiel: | Zeichenfolge |
| globalId | Gibt den Survey-Datensatz an, der in das Formular geladen wird. Gültige Werte sind die Global-IDs für vorhandene Survey-Datensätze. Für den Namen dieses Parameters muss die Groß- und Kleinschreibung beachtet werden. Beispiel: | Zeichenfolge |
recalculate | Kann nur mit mode=edit verwendet werden. Erzwingt die Neuberechnung bestimmter Fragen beim Laden des Survey, ohne dass die Schaltfläche Neu berechnen verwendet wird. Beispiel: | Zeichenfolge |
| version | Legt die Version der zu verwendenden Web-App fest. Der einzige gültige Wert ist latest. Damit wird die neueste Version der Web-App verwendet, auch wenn der Survey auf eine bestimmte Version beschränkt ist. Beispiel: | Zeichenfolge |
| token | Übergibt einen gültigen Token für einen Survey. Damit können Teilnehmer ohne Anmeldung einen Survey beantworten, für den ein ArcGIS-Konto erforderlich ist. Beispiel: | Zeichenfolge |
autoReload | Lädt den Survey nach der Übermittlung erneut. Geben Sie die Verzögerung (in Sekunden) an, bevor der Survey neu geladen wird. Dies wurde zuvor autoRefresh genannt. Der Parameter autoRefresh wird aus Gründen der Abwärtskompatibilität unterstützt. Beispiel: | Integer |
| encodeUrlParams | Verschleiert die URL-Parameter. Die resultierende URL enthält dann stattdessen den Parameter code mit allen codierten Parametern. Die einbezogenen Parameter außerhalb dieses code-Parameters werden ignoriert. Beispiel: | Boolesch |
width | Legt die Breite des Survey in Pixel oder als Bruchteil der Bildschirmbreite fest. Bei einem Wert über 1 wird die Breite in Pixel festgelegt. Wenn der Pixelwert kleiner ist als die Breite des Bildschirms, wird die Bildschirmbreite verwendet. Bei einem Wert zwischen 0 und 1 wird die Breite des Formulars als Bruchteil der Bildschirmbreite festgelegt. Dies wirkt sich auch auf andere Steuerelemente im Survey wie etwa auf Textfelder aus und kann zur Verbesserung der Anzeige eines festgelegten oder dynamischen Gitternetzes in der Web-App beitragen. Beispiele: | Zeichenfolge |
Hinweis:
Der Parameter field:fieldname unterstützt Geopunkt-, Geotrace- und Geoshape-Fragen in der Web-App. Für Geopunkt-Fragen geben Sie Breitengrad, Längengrad und Höhe (optional), getrennt durch Leerzeichen, an. Für Geotrace- und Geoshape-Fragen geben Sie für jeden Stützpunkt den Breitengrad und den Längengrad, getrennt durch ein Leerzeichen, an. Die einzelnen Koordinatenpaare müssen durch ein Semikolon voneinander getrennt werden. Dieses Beispiel könnte für eine Geoshape-Frage verwendet werden:
field:geoshape=-37.842156723211474 144.95942945338243;-37.83554486071995 144.9726235713864;-37.85681405373047 144.98240735651922;-37.85954045531896 144.97715349053766