Mit einer Bildfrage mit dem Aussehen "draw" oder "annotate" können Benutzer auf eine leere Zeichenfläche eine Skizze zeichnen oder ein Bild oder einen Snapshot einer Karte mit einer Annotation versehen. Die mobile ArcGIS Survey123-App enthält eine Standardpalette mit acht Zeichenwerkzeugen wie etwa den Werkzeugen für Pfeile, generische Markersymbole und Textbeschriftungen. Weitere Informationen zur Standardpalette finden Sie unter Zeichenmodus.
Zusätzlich zu den Standardzeichenwerkzeugen können Sie benutzerdefinierte Paletten zum Konfigurieren von Zeichen- und Annotationswerkzeugen erstellen. So kann beispielsweise ein Versorgungsunternehmen bestimmte Symbole und Linien-Styles für die Elektro- und Gasversorgung verwenden.
Hinweis:
Benutzerdefinierte Paletten werden in der ArcGIS Survey123-Web-App nicht unterstützt.
Gehen Sie zum Erstellen einer benutzerdefinierten Palette wie folgt vor:
- Konfigurieren Sie die Python-Umgebung in ArcGIS Survey123 Connect, sodass Sie die Werkzeuge Neue XLSPalette-Vorlage und XLSPalette konvertieren ausführen können.
- Bereiten Sie eine benutzerdefinierte Palette mithilfe der XLSPalette-Spezifikation vor.
- Stellen Sie sicher, dass die XLSPalette-Vorlage und alle zugehörigen Dateien im Ordner "media" des Survey enthalten sind.
- Konvertieren Sie die XLSPalette-Vorlage in eine .palette-Datei, indem Sie das Werkzeug XLSPalette konvertieren auf der Registerkarte Medien in Survey123 Connect ausführen.
- Legen Sie im XLSForm für den Survey in der Spalte body::esri:style für eine Bildfrage mit dem Aussehen "draw" oder "annotate" die Verwendung einer benutzerdefinierten Palette anstelle der Standardpalette fest, indem Sie palette=<Palettenname> angeben.
Eine benutzerdefinierte Palette wird zunächst in einer XLSPalette-Vorlage konfiguriert. Anschließend wird die XLSPalette-Vorlage in eine .palette-Datei konvertiert, sodass sie zu einem Survey hinzugefügt werden kann. XLSPalette-Vorlagen werden mithilfe eines Werkzeugs auf der Registerkarte Medien in Survey123 Connect konvertiert.
Vorbereiten einer benutzerdefinierten Palette
Benutzerdefinierte Paletten werden in XLSPalette-Dateien konfiguriert. Hierbei handelt es sich um .xlsx-Dateien mit Arbeitsblättern, die in .palette-Dateien konvertiert werden, die im Survey verwendet werden können.
Für die ersten Schritte mit dem Entwerfen einer benutzerdefinierten Palette benötigen Sie eine XLSPalette-Vorlage. Survey123 Connect umfasst das Werkzeug Neue XLSPalette-Vorlage zur Erstellung einer leeren Vorlage. Zum Ausführen des Werkzeugs müssen Sie eine Python-Umgebung in Survey123 Connect konfigurieren. Weitere Informationen finden Sie unter Konfigurieren von Python.
Öffnen Sie den Survey in Survey123 Connect. Zum Erstellen einer XLSPalette-Vorlage klicken Sie auf Werkzeuge und dann auf Neue XLSPalette-Vorlage. Im Ordner "media" wird eine Vorlagendatei namens myXLSPalette1.xlsx erstellt. Alternativ können Sie eine Kopie der Survey123-XLSPalette-Vorlage aus ArcGIS Online herunterladen.
Jedes Arbeitsblatt in der XLSPalette-Vorlage entspricht einem Toolset, also einer Gruppe von Werkzeugen in der benutzerdefinierten Palette. Die Annotationswerkzeuge im Toolset werden durch die Zeilen in den einzelnen Toolset-Arbeitsblättern definiert. Im folgenden Beispiel ist eine XLSPalette-Konfiguration für drei Annotationswerkzeuge für die Inspektion einer Gaspipeline dargestellt, die zwei Linienwerkzeuge und ein Marker-Werkzeug umfasst:
| type | label | tool | symbol | textSymbol |
|---|---|---|---|---|
line | Gas Line (New) | line | color=Blue&size=5&style=dash | color=MediumBlue&size=14&anchor=bottom&italic |
line | Gas Line (Existing) | line | color=Yellow&size=5&outline.color=Black&outline.size=1 | color=#FFFFE0&size=14&anchor=bottom |
marker | Meter (New) | meter.svg |
Weitere Informationen zur Syntax und zu den Parametern, die beim Entwerfen einer benutzerdefinierten Palette verwendet werden können, finden Sie unter XLSPalette-Spezifikation. Eine Beschreibung der vollständigen Syntax finden Sie auch im Arbeitsblatt Reference in der XLSPalette-Vorlage.
Vergewissern Sie sich, dass sich die XLSPalette-Vorlage sowie alle in der Palette verwendeten Bilddateien wie etwa die Dateien für SVG-Markersymbole oder Toolset-Symbole im Ordner "media" des Survey befinden. Anschließend wird die XLSPalette-Vorlage in eine .palette-Datei konvertiert, sodass sie zum Survey hinzugefügt werden kann.
Palette konvertieren
Zum Ausführen des Werkzeugs XLSPalette konvertieren müssen Sie eine Python-Umgebung in Survey123 Connect konfigurieren. Weitere Informationen finden Sie unter Konfigurieren von Python.
Öffnen Sie den Survey in Survey123 Connect, und navigieren Sie zur Registerkarte Medien. Auf der Registerkarte Medien wird der Inhalt des Ordners "media" des Survey aufgeführt. Neben den .xlsx-Dateien wird die Schaltfläche "Konvertieren" angezeigt. Klicken Sie zum Ausführen des Werkzeugs XLSPalette konvertieren auf die Schaltfläche "Konvertieren", um die XLSPalette-Vorlage in eine .palette-Datei zu konvertieren, die im Survey verwendet werden kann.
Nach dem Konvertieren wird die .palette-Datei im Ordner "media" gespeichert und auf der Registerkarte Medien angezeigt.
Tipp:
Der Name der .palette-Datei entspricht dem Namen der .xlsx-Quelldatei. Achten Sie darauf, dass der Dateiname keine Leerzeichen enthält, da dieser Name als XLSForm-Parameter verwendet wird.
Hinzufügen einer Palette zum Survey
Nachdem Sie eine benutzerdefinierte Palette erstellt und konvertiert haben, können Sie sie dem XLSForm hinzufügen. Sie können dem Survey beliebig viele benutzerdefinierte Paletten hinzufügen. Pro Frage mit dem Aussehen "draw" bzw. "annotate" kann jedoch immer nur eine Palette verwendet werden.
Geben Sie für eine Bildfrage mit dem Aussehen "draw" oder "annotate" in der Spalte body::esri:style palette=<Palettenname> ein, wobei <Palettenname> dem Namen der Palettendatei ohne die Erweiterung .palette entspricht. Beispiel: palette=Electrical
Von nun an wird für die Bildfrage anstelle der Standardpalette die benutzerdefinierte Palette verwendet.
Wenn Sie eine benutzerdefinierte Palette aktualisieren möchten, nehmen Sie die erforderlichen Änderungen an der .xlsx-Datei vor, und führen Sie anschließend noch einmal das Werkzeug XLSPalette konvertieren auf der Registerkarte Medien aus. Dadurch wird die .palette-Datei im Ordner "media" ersetzt, und die Änderungen werden nach der Aktualisierung der Formularvorschau in Survey123 Connect angezeigt. Veröffentlichen Sie den Survey erneut, sodass die Änderungen in der mobilen Survey123-App zu sehen sind.
XLSPalette-Spezifikation
Die XLSPalette-Spezifikation ist speziell für die Erstellung von Zeichen- und Annotationswerkzeugen in Survey123 vorgesehen. Benutzerdefinierte Paletten werden in einer .xlsx-Datei mithilfe der XLSPalette-Syntax konfiguriert. Die XLSPalette-Vorlage enthält Folgendes:
- Mindestens ein Toolset-Arbeitsblatt mit den Spalten type, tool, symbol und textSymbol. Ein Toolset entspricht einer Gruppe von Werkzeugen in einer Palette. Eine Palette kann so viele Toolsets wie nötig enthalten. Der Name der einzelnen Toolset-Arbeitsblätter wird in der mobilen Survey123-App als der Name der jeweiligen Toolset-Registerkarte in einer benutzerdefinierten Palette angezeigt.
- Ein Arbeitsblatt mit der Bezeichnung Reference, das einen Leitfaden für die Syntax und die Parameter zum Entwerfen einer Palette enthält.
- Ein Arbeitsblatt mit der Bezeichnung Version, das Informationen zur letzten Aktualisierung der XLSPalette-Vorlage enthält.
- Ein Arbeitsblatt mit der Bezeichnung Lists, das Lookup-Tabellen für die Datenvalidierung in den Toolset-Arbeitsblättern enthält. Der Inhalt dieses Arbeitsblattes darf nicht geändert werden.
Toolset-Arbeitsblätter können nach Bedarf hinzugefügt oder entfernt werden. Wenn Sie ein neues Toolset-Arbeitsblatt hinzufügen möchten, erstellen Sie eine Kopie von einem vorhandenen Toolset-Arbeitsblatt, um sicherzustellen, dass die Formatierung und die Datenvalidierung beibehalten wird. Toolset-Arbeitsblätter, die außer der Kopfzeile keine weitere Zeile enthalten, werden beim Konvertieren der XLSPalette-Datei in eine .palette-Datei ignoriert.
Berücksichtigen Sie bei Verwendung von Werkzeugeigenschaften folgende Aspekte:
- Die meisten Symboleigenschaften werden als name=value-Paare angegeben und mit einem kaufmännischen Und-Zeichen getrennt.
- Farben können mit den HTML-Standardfarbnamen oder mit Hexadezimal-Farbcodes angegeben werden. Die Opazität kann mit achtstelligen Hexadezimal-Farbcodes festgelegt werden.
- Die Einheiten für Breite und Größe werden in Pixel angegeben.
- Liniensymbole unterstützen benutzerdefinierte Strichmuster.
- Wenn ein Werkzeug vom Typ "text" verwendet wird, ist ein Eintrag in der Spalte textSymbol erforderlich. Für alle anderen Typen kann optional ein textSymbol-Wert angegeben werden.
Typen und Werkzeuge
Eine Palette kann eine beliebige Kombination von Werkzeugtypen enthalten. Als Typ unterstützt werden Linien, Flächen, Marker und Text ("line", "area", "marker" und "text"). Sie müssen in den einzelnen Toolset-Arbeitsblättern in der Spalte type angegeben werden.
Von den als Typ unterstützten Linien, Flächen und Texten ("line", "area" und "text") werden verschiedene Werkzeuge unterstützt, die den Darstellungs-Style für den jeweiligen Typ bestimmen. Das Werkzeug kann in den einzelnen Toolset-Arbeitsblättern in der Spalte tool angegeben werden. Für die als Typ unterstützten Marker und Texte ("marker" und "text") muss kein Werkzeug angegeben werden.
Die vollständige Liste der unterstützten Werkzeuge finden Sie im Arbeitsblatt Reference in der XLSPalette-Vorlage.
Symbolisierung
Jedes Werkzeug unterstützt verschiedene Symboleigenschaften, die in den einzelnen Toolset-Arbeitsblättern in der Spalte symbol angegeben werden können.
Für Linien kann ein benutzerdefiniertes Strichmuster mit mindestens einem Paar aus durchgezogener Linie und Leerzeichen im Format [n,n...] angegeben werden, wobei n die relative Segmentlänge ist, zum Beispiel [4,3,2,3].
Bei Markersymbolen kann der erste Wert der Name eines einfachen Markersymbols von Esri oder der Name einer Bilddatei mit Dateierweiterung sein. Unterstützt werden die Bildformate SVG, PNG und JPG. Als einfache Markersymbole werden "Kreis", "Kreuz", "Raute", "Quadrat", "Dreieck" und "x" verwendet.
Die vollständige Liste der unterstützten Symbole und Eigenschaften finden Sie im Arbeitsblatt Reference in der XLSPalette-Vorlage.
Text
An jedes Werkzeug kann eine Textbeschriftung angefügt werden. Eine Beschriftung kann mithilfe eines als Typ unterstützten Textes ("text") auch einzeln angegeben werden. Die Formatierung für einen als Text unterstützten Typ ("text") wird in den einzelnen Toolset-Arbeitsblättern in der Spalte textSymbol angegeben.
Für die Eigenschaft alignment können mehrere durch Kommas voneinander getrennte Ausrichtungswerte angegeben werden, zum Beispiel "alignment=left,middle".
Die Eigenschaft anchor wird nur auf die als Typ unterstützten Linien, Flächen und Marker ("line", "area" und "marker") angewendet und gibt an, wo die Textbeschriftung relativ zum Grafikelement positioniert wird.
Die vollständige Liste der unterstützten Styles und Eigenschaften finden Sie im Arbeitsblatt Reference in der XLSPalette-Vorlage.
Toolset-Symbol
Toolset-Symbole werden in der Palette mit den Toolset-Namen angezeigt. Wenn für alle Werkzeuge in einem Toolset dasselbe Werkzeug verwendet wird, wird das Symbol automatisch entsprechend diesem Werkzeug festgelegt. Wenn Sie für ein Toolset ein Symbol angeben möchten, fügen Sie an den Namen des Arbeitsblattes "&icon=" und danach entweder den Namen eines Symbols aus der Bibliothek für Esrii Calcite-UI-Symbole oder den Namen einer im Ordner "media" gespeicherten Bilddatei an. Unterstützt werden die Bildformate SVG, PNG und JPG.
Tipp:
Optimale Ergebnisse erzielen Sie, wenn Sie für Toolset-Symbole eine Einzelfarbe vor einem transparenten Hintergrund verwenden. Toolset-Symbole werden in der Palette in Graustufen gerendert.
Die Namen von Arbeitsblättern sind auf 31 Zeichen begrenzt und dürfen Leerzeichen enthalten, zum Beispiel "New Works&icon=electric.svg".