Vorausfüllen von Antworten

Zum Vorausfüllen von Antworten in Survey123 haben Sie mehrere Möglichkeiten.

Standardantworten

Während der Erstellung Ihres Survey können Sie in der Spalte default Ihres Arbeitsblattes Standardantworten für Survey-Fragen festlegen. Dadurch wird die Survey-Frage jedes Mal mit der gleichen Antwort vorab ausgefüllt, wenn Sie einen Survey beginnen oder wenn eine Frage relevant wird. Dies ist besonders hilfreich, wenn die Antwort auf Ihre Survey-Fragen in den meisten Fällen gleich ist. Sie können die Standardantwort weiterhin bearbeiten, falls erforderlich. Durch das Festlegen einer Standardantwort können Sie aber beim Beantworten Ihrer Surveys viel Zeit sparen. Standardantworten können Konstanten wie Zeichenfolgen und Zahlen enthalten.

Antworten auf Fragen des Typs "select_multiple" funktionieren anders als andere. Jede ausgewählte Antwort wird in der Reihenfolge der Auswahl (getrennt durch Kommas) aufgeführt. Um in einem Feld des Typs "select_multiple" mehrere Werte als Standard festzulegen, trennen Sie sie durch Kommas (Beispiel: item1,item2,item3).

Geopunkt-, Geotrace- und Geoshape-Fragen unterstützen Standardantworten. Weitere Informationen zum Festlegen einer Standardantwort finden Sie unter Geopunkte und Geotrace und Geoshape.

Berechnungen

Berechnungen ähneln Standardwerten, es gibt jedoch auch einige Unterschiede. Im Gegensatz zur Spalte default, die nur ausgewertet wird, wenn der Survey geöffnet oder die Frage relevant wird, werden Berechnungen jedes Mal ausgewertet, wenn Antworten im Survey, die Eingaben für die Berechnung sind, sich ändern oder relevant werden. Bereits vorhandene Antworten in Ihrem Formular können für Berechnungen verwendet werden. Der Ausdruck 100 - (${integer1} + ${integer2}), der in die Spalte "calculation" einer Frage eingegeben wird, fasst beispielsweise die Werte der Fragen "integer1" und "integer2" zusammen, subtrahiert diesen Wert von 100, und fügt ihn als Ihre Antwort ein. Der Benutzer kann diesen Wert überschreiben, aber die Berechnung kann als Ausgangspunkt für eine Frage gesehen werden, an dem sich der Benutzer orientieren kann.

Tipp:

Wenn das Ergebnis einer Berechnung manuell bearbeitet wird, können Sie die angezeigte Schaltfläche verwenden, um den bearbeiteten Wert zu löschen und die Berechnung erneut auszuführen.

Berechnungsmodus

Mit dem in der Spalte bind::esri:parameters eingegebenen Parameter calculationMode wird festgelegt, wann Berechnungen in Fragen berechnet werden, z. B. calculationMode=manual. Dabei werden vier Werte unterstützt:

  • auto: Berechnen, wenn die Frage leer ist oder zuvor nicht von dem Benutzer geändert wurde. Wenn kein Wert angegeben wird, wird das Standardverhalten für Berechnungen verwendet.
  • manual: Die Berechnung der Frage wird nur ausgeführt, wenn die Schaltfläche Berechnen neben der Frage gedrückt wird.
  • always: Eine Berechnung findet statt, wenn sich ein Wert, auf den im Berechnungsausdruck verweisen wird, geändert hat. Dies betrifft auch dynamische Funktionen wie now().
  • whenEmpty: Berechnen, bis ein nicht leerer Wert zurückgegeben wird. Wenn ein nicht leerer Wert zurückgegeben wird, verhält sich die Frage wie im Modus manual. Berechnungen, die dynamische Funktionen wie beispielsweise now() enthalten, werden nur neu berechnet, wenn die Schaltfläche Berechnen gedrückt wird. Der Modus whenEmpty ist hilfreich, wenn eine bereits mit einem nicht leeren Wert berechnete Frage beim erneuten Laden des Formulars, beispielsweise beim Öffnen über den Eingang, nicht aktualisiert werden soll.

Der Parameter calculationMode wird von den folgenden Fragetypen unterstützt:

  • text
  • decimal
  • integer
  • note
  • date
  • time
  • dateTime
  • select_one
  • select_multiple
  • geopoint
  • calculate
  • hidden

Hinweis:

Der Parameter calculationMode wird von der Survey123-Web-App nicht unterstützt.

Geräte- und Benutzereigenschaften

Mit der Funktion pulldata("@property") sind Sie in der Lage, Informationen zu den Geräten, mit denen Survey-Antworten übermittelt werden, sowie zu den angemeldeten Benutzern, die die Antworten übermitteln, zu extrahieren. Diese Funktion ist sinnvoll, um technische Details und Informationen zum Kontext, in dem Ihr Survey beantwortet wurde, aufzuzeichnen.

Die Funktion gibt eine Geräte- oder Benutzereigenschaft im Format pulldata("@property", '<property name>') zurück. Im folgenden Beispiel wird der UTC-Versatz des Geräts abgerufen. Dadurch kann die Zeitzone erfasst werden, in der die Teilnahme am Survey erfolgt ist:

pulldata("@property", 'utcOffset')

Mit der Funktion pulldata("@property") kann ermittelt werden, in welcher Weise der Benutzer derzeit mit der Survey-Antwort interagiert. Dabei können Sie folgende Angaben machen:

pulldata("@property", 'mode')

Bei der Eigenschaft mode können drei mögliche Werte zurückgegeben werden: new, wenn der Benutzer eine neue Survey-Antwort eingibt (umfasst auch Antworten, die aus einem vorhandenen Survey kopiert werden), edit, wenn der Benutzer eine vorhandene Antwort bearbeitet, und view, wenn der Benutzer eine vorhandene Antwort im schreibgeschützten Modus anzeigt. Im folgenden Beispiel wird ermittelt, ob der Benutzer eine vorhandene Frage bearbeitet. Befindet sich die Funktion in der Spalte readonly, kann der Benutzer die ausgewählte Frage nicht bearbeiten:

pulldata("@property", 'mode') = 'edit'

Mithilfe der Funktion pulldata("@property") kann auch bestimmt werden, wo ein Survey geöffnet wurde. Mit dem folgenden Beispiel wird bestimmt, ob der Survey aus dem Eingang geöffnet wurde:

pulldata("@property", 'status') = 'inbox'

Vorsicht:

Es empfiehlt sich nicht, die Ergebnisse der Eigenschaften mode und status in einer Frage des Typs "hidden" oder "calculate" zu speichern. Zudem sollten Sie die Fragen, in denen diese Eigenschaften verwendet werden, nicht in der Spalte relevant aktivieren oder deaktivieren. Dies kann dazu führen, dass der Inhalt der Felder gelöscht wird oder die Werte nicht wie erwartet aktualisiert werden.

Die Funktion pulldata("@property") unterstützt die folgenden Eigenschaften:

EigenschaftBeschreibung

pulldata("@property", 'portalUrl')

Die URL des Portals, an das der Survey übermittelt wird.

pulldata("@property", 'token')

Das an den Feature-Layer übergebene Token.

pulldata("@property", 'portalInfo')

Alle Portalinformationen in Form eines JSON-Objekts.

pulldata("@property", 'online')

Ein boolescher Wert. Dieser Wert ist wahr, wenn am Gerät Netzwerkaktivität festzustellen ist, und ist andernfalls falsch.

pulldata("@property", 'utcOffset')

Zeitversatz in Stunden gegenüber der UTC-Zeit für die lokale Zeitzone.

pulldata("@property", 'language')

Im aktuellen Survey verwendete Sprache.

pulldata("@property", 'locale')¹

Das im aktuellen Survey verwendete Gebietsschema-Objekt.

pulldata("@property", 'localeInfo')¹

Das im aktuellen Survey verwendete AppStudio-Objekt LocaleInfo, das den Sprachencode in verschiedenen Notationen enthält.

pulldata("@property", 'timeZone')

Zeitzonencode.

pulldata("@property", 'username')

Benutzername des aktuell angemeldeten Benutzers für das ArcGIS-Organisationskonto.

pulldata("@property", 'email')

E-Mail-Adresse des aktuell angemeldeten Benutzers für das ArcGIS-Organisationskonto.

pulldata("@property", 'userFullName')

Vor- und Nachname des aktuell angemeldeten Benutzers.

pulldata("@property", 'userFirstName')²

Vorname des aktuell angemeldeten Benutzers.

pulldata("@property", 'userLastName')²

Nachname des aktuell angemeldeten Benutzers.

pulldata("@property", 'deviceId')³

Von Survey123 generierte UUID zur Beschreibung des Geräts, mit dem der Survey ausgefüllt wurde. Diese ist nicht mit der IMEI (International Mobile Equipment Identity) zu verwechseln, da Survey123 auf Geräten ausgeführt wird, die möglicherweise keine IMEI haben.

pulldata("@property", 'deviceModel')³

Modellname des Geräts des Benutzers.

pulldata("@property", 'OS')³

Betriebssystem des Geräts des Benutzers.

pulldata("@property", 'appVersion')

Versionsnummer der mobilen App oder Build-Nummer der Web-App

pulldata("@property", 'surveyName')

Name des Survey.

pulldata("@property", 'userAgent')

Benutzer-Agent-Zeichenfolge für das Gerät des Benutzers.

pulldata("@property", 'mode')

Gibt new zurück, wenn der Benutzer eine Survey-Antwort erstellt, edit, wenn der Benutzer eine vorhandene Antwort bearbeitet, oder view, wenn der Benutzer eine Antwort im schreibgeschützten Modus anzeigt.

pulldata("@property", 'status')

Gibt draft, submitted, sent oder inbox zurück, wenn der Survey aus Entwürfe, Ausgang, Gesendet bzw. Eingang geöffnet wurde. Wenn die Antwort neu ist, wird eine leere Zeichenfolge zurückgegeben.

¹ Nur zur Verwendung mit der Funktion pulldata("@javascript").

² Diese Parameter sind abhängig vom Inhalt der Konfiguration des Identity-Providers; es kann sein, dass sie in Organisationen, die eine andere als die integrierte Authentifizierung verwenden, nicht verfügbar sind.

³ Nur die mobile Survey123-App.

Favoritenantworten

Nach der Eingabe von Antworten in die mobile Survey123-App können Sie diese für die Verwendung in nachfolgenden Surveys speichern, indem Sie Favoritenantworten festlegen. Über das Menü oben links können Sie den aktuellen Status Ihres Survey als Favoritenantwort festlegen.

Sobald Sie diese festgelegt haben, können Sie sie in neue Surveys einfügen, indem Sie das Menü öffnen und auf Antworten aus Favorit einfügen klicken.

Wenn Sie Ihre Favoritenantworten ändern müssen, geben Sie sie in Ihren aktuellen Survey ein, und klicken Sie auf Als Favoritenantwort festlegen. Wenn Sie sich wiederholende Informationen in ein Feld eingeben, können Sie nachfolgende Surveys anhand Ihrer aktuellen Antworten vorab ausfüllen. Der Survey, den Sie zum Festlegen Ihrer Favoritenantworten verwenden, wird durch einen Stern gekennzeichnet.

Hinweis:

Wenn der Ordner Gesendet deaktiviert wurde, kann ein gesendeter Survey nicht für Favoritenantworten verwendet werden. In diesem Fall funktioniert die Option Antworten aus Favorit einfügen, wenn Sie Ihren Survey mit Favoritenantworten als Entwurf speichern.

CSV-Daten

Durch das Ausfüllen von Fragen mit Informationen, die Sie auf Ihrem Gerät gespeichert haben, können Sie den Zeitaufwand für das Fertigstellen Ihres Survey erheblich reduzieren. Bei den Informationen kann es sich um Daten aus einem vorherigen Survey handeln, oder sie stellen eventuell mehrere Antworten basierend auf der Eingabe einer einzelnen Antwort des Benutzers bereit.

Das Vorausfüllen von Antworten ist in Inspektions-Surveys sinnvoll. Durch die Eingabe einer Asset-ID-Nummer (durch manuelle Eingabe oder Scannen eines Barcodes) können Informationen zu diesem Asset aus der .csv-Datei abgerufen und zur Beantwortung anderer Fragen, wie Position, letztes Prüfdatum und Zustand zum Zeitpunkt der letzten Prüfung, verwendet werden.

Weitere Informationen dazu, wie Sie Antworten auf diese Weise ausfüllen, finden Sie unter Abrufen eines Wertes aus einer CSV-Datei.

Hinweis:

Wenn in Ihrer .csv-Datei eine Spaltenüberschrift fehlt oder am Ende der Zeilen ein nachgestelltes Komma vorhanden ist, wird die .csv-Datei nicht in den Survey importiert.