Verwenden von Survey123 mit vorhandenen Feature-Layern

Wenn Sie Surveys in ArcGIS Survey123 Connect erstellen, wird standardmäßig ein Feature-Layer unter Verwendung des Schemas aus dem Survey erstellt. Alternativ können Sie einen neuen Survey mit einem vorhandenen Feature-Layer verknüpfen.

Einen Feature-Layer vorbereiten

Damit ein Feature-Layer in Survey123 verwendet werden kann, muss es sich um ein Element in ArcGIS Enterprise oder ArcGIS Online handeln. Dazu gehören gehostete Feature-Layer und auf Verbundservern und nicht verbundenen Servern veröffentlichte Feature-Layer.

Hinweis:

Für die Arbeit mit nicht verbundenen Feature-Services sind weitere Konfigurationen erforderlich. Sie müssen in Ihrer ArcGIS-Organisation manuell ein Feature-Layer-Element erstellen, das den Service darstellt. Einzelheiten dazu finden Sie im Knowledge-Base-Artikel zur Herstellung einer Verbindung mit nicht verbundenen ArcGIS Server-Services.

Der Besitzer und die Benutzer des Survey müssen Zugriff auf den Feature-Layer haben, und dieser muss editierbar sein. Beachten Sie außerdem Folgendes:

  • Wenn Benutzer neue Surveys erfassen, ist die Funktion Create erforderlich.
  • Wenn Benutzer vorhandene Surveys bearbeiten, ist die Funktion Update für den Layer erforderlich.
  • Wenn Benutzer Bilder, Audio oder Dateien erfassen, muss hasAttachments auf true festgelegt sein.

Beim Aktivieren von Anlagen für einen Feature-Layer werden die Spalten KEYWORD und EXIFINFO dem Schema standardmäßig nicht hinzugefügt. Diese Spalten sind erforderlich, damit Anlagen mit dem richtigen Datensatz verknüpft werden können. Nach dem Aktivieren von Anlagen sollten Sie das Geoverarbeitungswerkzeug "Anlagen aktualisieren" ausführen.

Hinweis:
Es wird empfohlen, die Spalten KEYWORD und EXIFINFO vor dem Erfassen von Datensätzen mit Survey123 hinzuzufügen, damit alle Anlagen, die übermittelt werden, Schlüsselwörter enthalten. Wenn die Spalten KEYWORD und EXIFINFO nicht vorhanden sind, bevor Anlagen übermittelt werden, dann kann das Python-Notebook zum Aktualisieren von Anlagenschlüsselwörtern zum Aktualisieren der Anlagen verwendet werden.

Wiederholungen können nicht auf zugehörige Layer oder Tabellen verweisen, es sei denn, der untergeordnete Layer oder die untergeordnete Tabelle verwenden ein GUID-Feld für die Beziehung.

Wenn Sie einen Survey bearbeiten möchten, müssen Sie sicherstellen, dass der Feature-Layer NULL-Werte zulässt oder der Survey erforderliche Felder verwendet. Survey123 verwendet NULL-Werte bei der Bearbeitung, wenn eine Antwort gelöscht und nicht ersetzt wird. Demzufolge werden Surveys aus einem Feature-Layer, der keine NULL-Werte zulässt, von Survey123 nicht übermittelt.

Für den Feature-Layer müssen die folgenden zusätzlichen Funktionen auf "true" festgelegt werden:

  • supportsAttachmentsByUploadId: Diese Funktion wird automatisch aktiviert, wenn für den Feature-Layer Anlagen aktiviert sind. Sie ermöglicht, dass die App alle mit einem Survey verknüpften Anlagen hochlädt, bevor der Survey gesendet wird. Wenn bei einer der Anlagen ein Fehler auftritt, wird das gesamte Senden des Survey rückgängig gemacht, um Datenverlust zu verhindern.
  • supportsApplyEditsWithGlobalIds: Der Feature-Layer muss Änderungen mit Global-IDs unterstützen. Dies ermöglicht das Erstellen und Verwalten der Global-IDs in erstellten Features durch die App (statt eine neue Global-ID für erstellte Features durch den Server zu erstellen).

Damit ein Feature-Layer Änderungen mit Global-IDs unterstützt, müssen folgende Anforderungen erfüllt sein:

  • Die Layer im Feature-Layer müssen eine Global-ID-Spalte mit einem eindeutigen Index aufweisen. Am einfachsten lässt sich dies durch Aktivieren der Synchronisierung beim Veröffentlichen des Feature-Layers erreichen.
  • Bei Verwendung einer Mehrbenutzer-Geodatabase können Layer die Verzweigungsversionierung nutzen, nicht aber die traditionelle Versionierung. Bei Verwendung einer nach Verzweigung versionierten Geodatabase nutzt Survey123 die Default-Version als Zielversion. Weitere Informationen finden Sie unter Versionierungstypen.
  • Ein Feature-Layer oder eine Tabelle muss Global-IDs enthalten, bevor Anlagen zugelassen werden.
  • Wenn der Feature-Layer M-aktivierte Layer enthält, muss die Bearbeitung ohne M-Werte aktiviert werden.

Weitere Informationen zur Unterstützung der Bearbeitung in einem Feature-Layer finden Sie unter supportsApplyEditsWithGlobalIds im Abschnitt Layer (Feature Service) der Dokumentation zu ArcGIS REST API.

Hinweis:

Survey123 unterstützt beim Arbeiten mit vorhandenen Feature-Layer und zugehörigen Tabellen nur Eins-zu-Viele-Beziehungen von GUIDs. Eins-zu-Eins-Beziehungen werden nicht unterstützt.

Erstellen eines Survey aus einem Feature-Layer

In Survey123 Connect können Sie einen Survey aus einem vorhandenen Feature-Layer erstellen. Der Feature-Layer muss für die Verwendung mit Survey123 vorbereitet werden. Melden Sie sich bei Ihrer ArcGIS-Organisation an, und klicken Sie auf Neuer Survey. Wählen Sie die Kategorie Feature-Service aus. Navigieren Sie zu einem Feature-Layer, wählen Sie ihn aus, und klicken Sie auf Survey erstellen. Es wird ein XLSForm aus dem Feature-Layer erstellt. Sie können den Survey anschließend sofort veröffentlichen oder weiter anpassen. Sie können zum Beispiel den Fragen beschreibende Beschriftungen hinzufügen oder Fragen in Gruppen anordnen.

Wenn der ausgewählte Feature-Layer mehr als einen Layer umfasst, wird der Survey basierend auf dem ersten Layer generiert. Um den Survey auf einem anderen Layer des Feature-Layers zu basieren, müssen Sie den Survey manuell erstellen. Aktualisieren Sie die Eigenschaften form_id und submission_url auf der Registerkarte settings der Tabelle entsprechend. Weitere Informationen finden Sie unter Verwenden von Feature-Layern als Vorlage für Surveys.

Wenn der ausgewählte Feature-Layer Anlagen enthält, wird im Survey eine einzelne Bildfrage mit dem Namen <Layer_Name>_image erstellt. Dieser Name stimmt mit keinem Schlüsselwort in der Tabelle der Anlagen überein und muss aktualisiert werden. Wenn die vorhandenen Anlagen mehr als eine Frage repräsentieren, müssen Sie im Survey zu jedem der Schlüsselwörter in der Tabelle der Anlagen entsprechende Bildfragen hinzufügen.

Hinweis:

Wenn der Survey, den Sie erstellen, Audio- oder Dateifragen erfordert, müssen Sie diese manuell zum Survey hinzufügen. Öffnen Sie nach dem Generieren des Survey das Arbeitsblatt und fügen Sie die Fragen hinzu. Weitere Informationen finden Sie unter Medienfragen. Im Feature-Layer müssen auch Anlagen aktiviert sein.

Verwenden von Feature-Layern als Vorlage für Surveys

Sie haben die Möglichkeit, neue Surveys anhand von vorhandenen Feature-Layern manuell zu erstellen. Dazu müssen Sie jedoch die Eigenschaften form_id und submission_url auf der Registerkarte Einstellungen der Tabelle aktualisieren, um eine Verknüpfung zwischen dem Survey und dem Element des Feature-Layers im Portal oder in ArcGIS Online zu definieren.

Mit der Eigenschaft form_id wird explizit der Name des Layers im Feature-Layer angegeben, der vom Survey verwendet wird. Weitere Informationen finden Sie im Knowledge-Base-Artikel zum Thema Verwenden von Feature-Services als Vorlage für Surveys.

Bei der Eigenschaft submission_url handelt es sich um die URL des Feature-Layer-Elements.

Übermittlungs-URL im Survey123-Formular
Tipp:

Geben Sie die URL des Feature-Layer-Elements wie oben dargestellt an. Ein häufiger Fehler ist die Verwendung der URL des Feature-Layers. Diese wird allerdings nicht unterstützt.

Für die Erstellung dieser URL müssen Sie die Element-ID mit dem Stammverzeichnis des Portalinhalts verbinden. Das Beispiel in der Abbildung oben zeigt einen Link zu einem ArcGIS Online-Element; der Link zu demselben Element in einem Portal sieht wie folgt aus:

https://<host>:<port>/arcgis/sharing/rest/content/items/21a6c530b31a4523bdff7gg94c9c5d9a

Wenn Sie einen Survey benötigen, für den einige, aber nicht alle Felder eines vorhandenen Feature-Layers erforderlich sind, ist es ratsam, wie oben beschrieben einen Survey anhand des Feature-Layers zu erstellen und die für die Veröffentlichung des Survey nicht notwendigen Fragen zu löschen. Auf diese Weise werden die Eigenschaften form_id und submission_url automatisch erstellt.

Ändern des Schemas

Wurde ein Survey aus einem vorhandenen Feature-Layer erstellt, können neue Fragen und Auswahllistenwerte erst dann dem Survey hinzugefügt werden, wenn dem Feature-Layer das entsprechende Feld oder die entsprechende Domäne hinzugefügt wurde. Wurde ein Survey aus einer Feature-Layer-Sicht erstellt, können neue Fragen und Auswahllistenwerte erst dann dem Survey hinzugefügt werden, wenn dem zugrunde liegenden Feature-Layer das entsprechende Feld oder die entsprechende Domäne hinzugefügt wurde und das Feld an die Feature-Layer-Sicht weitergegeben wurde.