Survey123 Connect wandelt die mit der XLSForm-Spezifikation erstellten Formulare in ein XForm für die Verwendung in Survey123 um und veröffentlicht sie in ArcGIS Online oder ArcGIS Enterprise. Während dieses Vorgangs können einige Fehler auftreten.
Tipp:
Das Werkzeug Survey analysieren überprüft das XLSForm des Survey auf häufige Probleme und gibt Empfehlungen für das Survey-Design.Fehler bei der Formularkonvertierung
Wenn Sie einen Survey in Survey123 Connect erstellen, verwenden Sie die XLSForm-Spezifikation, um das Formular mithilfe einer Tabelle aufzusetzen. Survey123 Connect wandelt die Tabelle in ein XForm um, sodass Sie eine Vorschau Ihres Surveys gemäß der Darstellung in Survey123 anzeigen können.
Die Konvertierung erfolgt, nachdem Sie folgende Schritte ausgeführt haben:
- Speichern Sie die Änderungen in Ihrem Arbeitsblatt.
- Klicken Sie in Survey123 Connect auf die Schaltfläche Aktualisieren.
Wenn ein Problem mit Ihrem Survey besteht, erhalten Sie eine Fehlermeldung vom Service für die Formularkonvertierung. Im folgenden Beispiel zeigt die Fehlermeldung an, dass ein Problem mit der Eingabe für die Frage "last name" besteht. In diesem Fall ist in der Eingabe ein Leerzeichen enthalten. Das Leerzeichen sollte entfernt oder durch einen Unterstrich oder Gedankenstrich ersetzt werden.
In der folgenden Tabelle sind einige häufige Formularfehler aufgeführt:
| Fehlerbeschreibung | Diagnose |
|---|---|
Fehler beim Konvertieren von XLSForm | Im Beispiel oben bezieht sich der Fehler auf die Frage last name. Der Fehler besteht in diesem Fall darin, dass in der Spalte name ein Leerzeichen vorhanden ist. Ein weiterer häufiger Fehler, der zu dieser Meldung führt, tritt durch die Verwendung von anderen als ASCII-Zeichen in der Spalte name des Arbeitsblatts survey oder choices auf. ASCII-Zeichen können in der Spalte label, aber nicht in der Spalte name verwendet werden. |
[row : 2] Listenname nicht im Arbeitsblatt "choices": [JobType] | Diese Fehlermeldung wird angezeigt, wenn eine Frage des Typs select_one oder select_multiple auf eine Liste verweist, die im Arbeitsblatt choices nicht vorhanden ist. In diesem Beispiel sollten die Klammern entfernt werden. |
Für diese Frage sollten zudem Auswahlmöglichkeiten zur Verfügung stehen. | Diese Fehlermeldung wird angezeigt, wenn für eine Frage, die vom Typ select_one oder select_multiple ist und über den zusätzlichen Parameter or_other als Teil des Typs verfügt, auch ein Auswahlfilter definiert ist. Auswahllisten, in denen der Wert Other eingegeben werden kann, können nicht als kaskadierende Auswahllisten verwendet werden. |
Netzwerkfehler
Wenn Sie Probleme beim Zugriff auf den Service für die Formularkonvertierung haben, erhalten Sie eine Fehlermeldung wie die folgende:
In der folgenden Tabelle sind einige häufige Netzwerkfehler aufgeführt:
| Fehlernummer | Fehlerbeschreibung | Diagnose |
|---|---|---|
-1 | C:/Users/Username/ArcGIS/My Survey Designs/Form 1/Form 1.xlsx kann nicht geöffnet werden | Excel hat Ihre Datei unter Umständen gesperrt. Stellen Sie sicher, dass der Survey nicht von einer anderen Anwendung oder einem anderen Benutzer geöffnet ist. |
3 | Host survey123.arcgis.com nicht gefunden | Es wird eine frühere Version von Survey123 Connect ausgeführt. Nehmen Sie ein Upgrade auf die neueste Version vor. |
6 | SSL-Handshake fehlgeschlagen | Der SSL-Handshake-Fehler kann verschiedene Ursachen haben, z. B.:
Sie können die auf einem Webserver verwendeten SSL-Zertifikate mit einem Online-Testprogramm wie SSL Labs testen. |
99 | Verbindungs-Timeout | Dieser Fehler tritt manchmal bei der Arbeit mit sehr großen Surveys auf. Versuchen Sie es erneut. |
202 | Fehler beim Download von https://survey123.esri.com/api/xls2xform – Server antwortet: verboten | Fehlermeldungen, in denen esri.com enthalten ist, verweisen auf den alten Server. Nehmen Sie ein Upgrade auf die neueste Version vor. |
203 | Fehler beim Download von https://survey123.esri.com/api/xls2xform – Server antwortet: nicht gefunden | Fehlermeldungen, in denen esri.com enthalten ist, verweisen auf den alten Server. Nehmen Sie ein Upgrade auf die neueste Version vor. |
401 | Fehler beim Download von https://survey123.arcgis.com/api/xls2xform – Server antwortet: interner Serverfehler | Dieser Fehler wird in der Regel von Ausdrücken in den Spalten "relevant" oder "calculation" ausgelöst. Verwenden Sie geschweifte Klammern, und fügen Sie ein $-Symbol am Anfang der Anweisung ein. |
403 | Fehler beim Download von https://survey123.esri.com/api/xls2xform – Server antwortet: Service vorübergehend nicht verfügbar | Melden Sie diesen Fehler umgehend an Esri. |
498 | Ungültiges Token | Das Token, das Survey123 Connect an ArcGIS weiterleiten wollte, wurde nicht akzeptiert. Die Ursache dieses Fehlers ist in den meisten Fällen eine Übermittlungs-URL, die das Token an einen öffentlichen Feature-Layer weitergeben möchte. |
499 | Fehler beim Übertragen von https://survey123.arcgis.com/api/xls2xform – Server antwortet: Proxy-Fehler | Die Survey123-API ist nicht verfügbar oder hat das Zeitlimit überschritten. Warten Sie kurz, und versuchen Sie es dann noch einmal. Wenn das Problem weiterhin besteht, erhalten Sie in der Survey123 Esri Community weitere Informationen. |
Das Fehlerdialogfeld bietet die Möglichkeit, den Fehler zu erfassen, sodass Sie ihn an Esri weiterleiten können. Fügen Sie der E-Mail alle weiteren Informationen hinzu, die zu der Lösung des Problems beitragen könnten.
Veröffentlichungsfehler
Diese Fehler treten in der Regel aufgrund von Problemen bei der Erstellung von Survey-Elementen in ArcGIS auf.
In der folgenden Tabelle sind häufige Veröffentlichungsfehler aufgeführt:
| Fehler | Diagnose |
|---|---|
Übermittlungs-URL ist nicht kompatibel (Feld nicht gefunden) | Das benannte Feld ist im Feature-Layer, der von der Übermittlungs-URL zugeordnet wurde, nicht vorhanden. Dadurch sind die Survey-Antworten nicht kompatibel mit dem Survey. Heben Sie die Zuweisung der Übermittlungs-URL entweder auf, um eine neue zu erstellen, oder stellen Sie sicher, dass die Übermittlungs-URL dem richtigen Feature-Layer zugewiesen wird. Dieser Fehler wird im Allgemeinen von dem zusätzlichen Feld verursacht, das erstellt wird, wenn Sie die Option or_other für eine Frage vom Typ "select_one" oder "select_multiple" verwenden. Weitere Informationen finden Sie unter Mehrfachauswahl. |
Übermittlungs-URL ist nicht kompatibel (Anfragefehler) | Überprüfen Sie, ob der Benutzer, als der Sie sich bei Survey123 Connect angemeldet haben, über Berechtigungen für den Zugriff auf den Feature-Layer verfügt. |
Kein untergeordnetes Schlüsselfeld in "SurveyName" für übergeordnetes Element "repeat_1" | Dieser Fehler tritt auf, wenn der Feature-Layer, an den Sie senden, von globalen übergeordneten ID-Schlüsseln abhängt, die im Survey nicht vorhanden sind. Setzen Sie im Fenster Veröffentlichungsoptionen die Option Globale übergeordnete ID-Schlüssel in Wiederholungsbeziehungen verwenden auf "true". |
CREATE TABLE ist fehlgeschlagen, da die Spalte "x" in der Tabelle "y" die maximale Anzahl von 1.024 Spalten überschreitet. | Der Survey, den Sie veröffentlichen möchten, überschreitet die maximal zulässige Zahl von Feldern in einem Feature-Layer in einer ArcGIS-Organisation (1.024). Reduzieren Sie die Anzahl der Felder auf weniger als 1.024, und veröffentlichen Sie den Survey erneut. Weitere Informationen zu diesen Einschränkungen finden Sie unter Problembehandlung in der Hilfe zu ArcGIS Online. |
Die benutzerdefinierte Übermittlungs-URL des Feature-Service ist nicht mit diesem Survey kompatibel (Der Feature-Service erfüllt nicht die Anforderungen für einen Survey mit Wiederholungen - supportsApplyEditsWithGlobalIds) | Die Eigenschaft supportsApplyEditsWithGlobalIds wurde auf "False" festgelegt, muss aber "True" sein. Am einfachsten lässt sich dies durch Aktivieren der Synchronisierung beim Veröffentlichen Ihres Feature-Layers erreichen. |
Die benutzerdefinierte Übermittlungs-URL des Feature-Service ist nicht mit diesem Survey kompatibel (Zielbeziehung für Tabelle nicht gefunden). | Eine Wiederholung im Survey ist entweder mit einer zugehörigen Tabelle im Feature-Layer falsch verknüpft, oder die Tabelle ist nicht vorhanden. Stellen Sie sicher, dass der Name der Wiederholung mit dem Namen der zugehörigen Zieltabelle übereinstimmt. |
Portalfehler
In ArcGIS Enterprise veröffentlichte Surveys unterliegen anderen Beschränkungen als Surveys, die in ArcGIS Online veröffentlicht werden. Zu diesen Beschränkungen zählen die folgenden:
- Sie können keine Surveys in ArcGIS Enterprise veröffentlichen, die bestimmte reservierte Schlüsselwörter als Feldnamen wie zum Beispiel end verwenden (Feldnamen, die diese Schlüsselwörter enthalten [zum Beispiel endSurvey], sind zulässig, sofern sie nicht tatsächlich als das Schlüsselwort fungieren). Reservierte Schlüsselwörter sind im Arbeitsblatt Reserved der Survey123-XLSForm-Vorlagen aufgeführt.
- Beim Veröffentlichen in ArcGIS Enterprise müssen alle Feldnamen in Kleinbuchstaben geschrieben sein.
- Die maximale Anzahl an Spalten, die ein in einem Portal veröffentlichter Feature-Layer enthalten kann, ist von Ihrer Enterprise-Geodatabase abhängig. Die Größenbeschränkungen sind der Dokumentation des Datenbankmanagementsystems zu entnehmen. Wenn die Anzahl der Fragen in Ihrem Survey das Spaltenlimit für Ihre Enterprise-Geodatabase überschreitet, besteht die Problemumgehung darin, eine Wiederholung einzufügen und repeat_count auf 1 zu setzen, um den Survey auf mehrere Tabellen zu erweitern.
- Der Name von Fragen im Survey-Arbeitsblatt darf höchstens 32 Zeichen enthalten.
- Sie können Survey123-Inhalt nur in ArcGIS Enterprise oder Portal for ArcGIS hochladen, wenn Sie ArcGIS Data Store verwenden.
- Wenn ArcGIS Enterprise in einer Offline-Umgebung bereitgestellt wird, funktionieren Survey-Vorlagen, Beispiele und Übermittlungs-URLs zu ArcGIS Online-Feature-Layern nicht.
- Übermittlungs-URLs können nicht direkt mit einem nicht verbundenen ArcGIS Server-Feature-Layer verwendet werden. Zur Umgehung des Problems können Sie den Service bei ArcGIS Online oder ArcGIS Enterprise registrieren.
- 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.
- esriFieldTypeDateOnly, esriFieldTypeTimeOnly, esriFieldTypeTimestampOffset und esriFieldBigInteger können nur in ArcGIS Online verwendet werden. Diese Feldtypen sind ab ArcGIS Enterprise 11.2 verfügbar.
Aktivieren der Diagnoseprotokollierung
Wenn Ihnen Fehlermeldungen angezeigt werden, die in diesem Thema nicht aufgeführt sind, oder Sie andere unerwartete Verhaltensweisen beobachten, ist es unter Umständen hilfreich, ein Protokoll mit Informationen aus Survey123 Connect aufzuzeichnen. Dieses können Sie für Fehlerbehebungszwecke an Dritte, zum Beispiel den Support von Esri, weitergeben.
Öffnen Sie zum Aktivieren der Protokollierung das Menü auf der Startseite der App, wählen Sie Einstellungen aus, und rufen Sie die Registerkarte Diagnose auf.
Wenn Sie Meldungen in einer Datei speichern möchten, klicken Sie auf die Umschaltfläche Protokollierung, um die Protokollierung zu aktivieren. In das Textfeld Protokoll-Ausgabespeicherort wird der standardmäßige Protokolldateispeicherort automatisch eingefügt. Sie können diesen Dateipfad bearbeiten. Um Meldungen online in einer syslog-kompatiblen Konsole zu erfassen, geben Sie im Textfeld Protokoll-Ausgabespeicherort die URL anstelle des Speicherortes der Protokolldatei ein.
Protokolldateien können freigegeben oder per E-Mail gesendet werden. Wenn Sie das Protokoll per E-Mail über die App senden, enthält der E-Mail-Text die Versionsnummer der App, den Namen des Betriebssystems und das Gebietsschema des Systems, und das Protokoll wird als Anlage angehängt.
Hinweis:
Zur Protokollierung in Echtzeit werden auf der Registerkarte Diagnose alle Instanzen einer AppStudio-Konsole angezeigt, die derzeit in Ihrem Netzwerk geöffnet sind. Auf der Registerkarte Diagnose wird ein Suchkreissymbol angezeigt, bis eine ausgeführte AppStudio-Konsole gefunden wird. Wenn Sie zunächst eine AppStudio-Konsole auswählen und auf die Umschaltfläche Protokollierung klicken, werden in dieser Konsole Protokollierungsinformationen angezeigt. Weitere Informationen finden Sie unter Konsolenausgabe erfassen in der ArcGIS AppStudio-Hilfe.