Berichtsvorlagen

Mit der Funktionalität für Berichte der Survey123-Website können Sie Ihre eigenen personalisierten Vorlagen und mehrere Berichte gleichzeitig erstellen.

In einem Bericht können die folgenden Elemente enthalten sein:

• ein Zusammenfassungsabschnitt
• ein einzelner Survey-Datensatz
• ein einzelner Survey-Datensatz und ein Zusammenfassungsabschnitt
• mehrere Survey-Datensätze
• mehrere Survey-Datensätze und ein Zusammenfassungsabschnitt

Hinweis:

Das Drucken von Berichten ist ein ArcGIS Online-Premium-Service, bei dem entsprechend Credits verbraucht werden. Weitere Informationen finden Sie unter Berichte drucken.

Für das Drucken von Berichten in ArcGIS Enterprise werden keine Credits verbraucht, es gelten jedoch Einschränkungen.

Eine Berichtsvorlage ist eine Microsoft Word-Datei (.docx), in der Platzhaltertext mit spezifischer Syntax bereitgestellt wird. Beim Drucken eines Berichts wird dieser Platzhaltertext durch den Inhalt der entsprechenden Felder aus der Survey-Antwort ersetzt. Dieser Platzhaltertext kann mit beliebiger Formatierung, Tabellen, Bildern oder anderen Anpassungen verwendet werden, um eine Vorlage zu erstellen, die Ihre spezifischen Anforderungen erfüllt.

Wenn Sie eine Vorlage erstellen möchten, klicken Sie auf der Registerkarte Daten in der Leiste oberhalb der Karte auf Bericht und anschließend auf Vorlagen verwalten. Daraufhin wird ein neues Fenster angezeigt, in dem Sie eine Beispielvorlage herunterladen, eine neue Vorlage hochladen oder den Namen und die Zusammenfassung einer vorhandenen Vorlage bearbeiten können. Klicken Sie auf Neue Vorlage, um eine neue Berichtsvorlage hochzuladen und einen Namen und eine Zusammenfassung für Ihre Vorlage anzugeben, wenn sie hochgeladen wurde. Sie können aber auch den Link Beispielvorlage herunterladen verwenden, um eine Beispielvorlage basierend auf Ihrem Survey herunterzuladen.

Hinweis:

Berichtsvorlagen können nur vom Besitzer des Survey und von Administratoren der Organisation hochgeladen werden.

Durch die Freigabe der Ergebnisse eines Survey für alle, für eine Organisation oder für eine Gruppe werden auch die mit dem Survey verknüpften Berichtsvorlagen freigegeben.

Ausdrücke

Die Antwort auf eine Frage kann in einer Berichtsvorlage durch Angabe ihres Namens in geschweiften Klammern, also { und }, , mit vorangestelltem Dollarzeichen angezeigt werden. Mit dem folgenden Ausdruck wird die Antwort auf die Textfrage Vorname angezeigt.

${firstname}

Sie können auch mit Ausdrücken definieren, welche Antworten im Bericht angezeigt werden und wie sie dargestellt werden. Ein Ausdruck kann der Name einer einzelnen Frage, eine Berechnung einer oder mehrerer Fragen oder der Name einer Frage mit Methoden und Parametern zum Einschränken oder Stylen der Antwort sein. Ein Ausdruck verwendet die folgende Schreibweise:

${questionname | method:parameter}

Ein Ausdruck kann mehrere Methoden und Parameter oder gar keine enthalten. Parameter können entweder Werte aus anderen Fragen oder ein fester Wert sein.

Mit dem folgenden Ausdruck wird die Berechnung einer Zahlenfrage namens floweringtrees geteilt durch eine Zahlenfrage namens totaltrees angezeigt. Bei der Verwendung mehrerer Fragen in einem Ausdruck brauchen lediglich deren Namen angegeben zu werden. Geschweifte Klammer sind in diesem Fall nicht erforderlich.

${floweringtrees / totaltrees}

Mit dem folgenden Ausdruck wird der X-Koordinatenwert aus der Positionsfrage angezeigt, wobei getValue die Methode und x der Parameter ist.

${location | getValue:"x"}

Zeichenfolgen können in einem Ausdruck anhand von Pluszeichen (+) verkettet werden. In diesem Ausdruck wird diese Art der Verkettung genutzt, um den Inhalt einer Frage namens "field_0" an einen Service zur Erstellung von QR-Codes zu übergeben, woraufhin ein QR-Code für die Antwort auf die Frage erstellt wird.

${$image | src:"https://barcode.tec-it.com/barcode.ashx?code=QRCode&data="+field_0}

Nicht alle Fragetypen unterstützen Ausdrücke und Methoden. In der folgenden Tabelle ist aufgeführt, welche Methoden und Parameter mit welchen Fragetypen verwendet werden können.

Methode	Parameter	Connect-Fragentyp	Web Designer-Fragentyp	Beschreibung
getValue	-	Alle Fragentypen	Alle Fragentypen	Ruft den Rohdatenwert aus dem Feature-Layer oder das Rohbild aus einer Anlage ab.
getValue	x, y, z, wkid	geopoint	Karte	Ruft die X-, Y- und Z-Koordinaten einzeln in einem angegebenen Raumbezug ab. Der WKID-Parameter ist optional und entspricht dem Raumbezug des Feature-Layers, wenn keine Angabe erfolgt.
getValue	length, area, unit, measurement type	geotrace, geoshape	Karte	Gibt die Länge einer Polylinie oder den Umfang bzw. die Fläche eines Polygons in der angegebenen Einheit zurück und gibt an, ob die Messungen planar oder geodätisch sind. Der Standardmesstyp ist geodätisch.
getValue	name, size	image, audio, file	Bild, Unterschrift, Audio, Datei	Gibt den Dateinamen oder die Größe einer Anlage zurück.
getValue	width, height, x, y, date, time, direction	image	Bild, Unterschrift	Breite und Höhe geben den ganzzahligen Wert der Bildbreite und -höhe in Pixeln zurück, und X, Y, Datum, Zeit und Richtung geben Werte zurück, die aus den EXIF-Daten des Bildes gelesen wurden, sofern vorhanden.
getValue	count	begin repeat, image, audio, file	Wiederholung, Bild, Unterschrift, Audio, Datei	Gibt die Gesamtzahl von Wiederholungen oder Anlagen zurück.
getValue	duration	audio, file	Audio, Datei	Gibt die Dauer von Audioaufzeichnungen in Sekunden zurück. Vorsicht: Bei Verwendung von Safari wird in Antworten, die in der Web-App erfasst wurden, die Dauer nicht zurückgegeben.
appearance	multiline	text	Mehrzeiliger Text	Wird verwendet, um die Zeilenumbrüche in der Zeichenfolge beizubehalten. Wenn kein Aussehen angegeben ist, wird als Antwort eine einzeilige Zeichenfolge zurückgegeben.
appearance	bullets	select_multiple	Mehrfachauswahl	Gibt die Antwort im Aufzählungsformat zurück.
checked	choice value	select_one, select_multiple	Mehrfachauswahl, Einzelauswahl, Einfachauswahltabelle, Dropdown, Likert-Skala, Bewertung	Gibt ein aktiviertes Kontrollkästchen zurück, wenn der Feldwert gleich "choiceValue" ist, andernfalls wird ein deaktiviertes Kontrollkästchen zurückgegeben.
selected	choice value	select_one, select_multiple	Mehrfachauswahl, Einzelauswahl, Einfachauswahltabelle, Dropdown, Likert-Skala, Bewertung	Wenn eine Domäne mit codierten Werten vorhanden ist, wird "true" zurückgegeben, sofern der Feldwert mit dem Auswahlwert übereinstimmt, andernfalls wird "false" zurückgegeben.
countSelected	-	select_one, select_multiple	Mehrfachauswahl, Einzelauswahl, Einfachauswahltabelle, Dropdown, Likert-Skala, Bewertung	Gibt die Anzahl der ausgewählten Auswahlmöglichkeiten zurück.
selectedAt	index	select_one, select_multiple	Mehrfachauswahl, Einzelauswahl, Einfachauswahltabelle, Dropdown, Likert-Skala, Bewertung	Gibt die Zeichenfolge an der Indexposition in der Auswahlliste zurück. Der Index beginnt bei Null.
locale	language code	date, dateTime, start, end, decimal	Datum, Datum und Zeit, Zahl	Gibt lokalisierte Datums-, Zeit- und Zahlenangaben zurück.
format	format string	date, dateTime, integer, decimal, start, end	Datum, Datum und Zeit	Gibt eine formatierte Datumszeichenfolge zurück.
utcOffset	offset value	date, dateTime, start, end	Datum, Datum und Zeit	Gibt einen Datums- oder Datums-Zeitwert zurück, der um den UTC-Versatzwert verschoben ist.
mapSettings	web map item ID, map scale	geopoint, geotrace, geoshape	Karte	Legt die Grundkarte und den Maßstab beim Drucken des Kartenbildes fest. Vorversion: Wurde durch map und mapScale ersetzt.
mapExtent	xmin, ymin, xmax, ymax, wkid	geopoint, geotrace, geoshape	Karte	Legt die feste Kartenausdehnung beim Drucken des Kartenbildes fest. Der Parameter "wkid" ist optional und wird auf den Wert 4326 (WGS 1984) festgelegt, wenn keine Angabe erfolgt.
map	web map item ID	geopoint, geotrace, geoshape	Karte	Legt die Grundkarte beim Drucken des Kartenbildes fest.
mapScale	Kartenmaßstab	geopoint, geotrace, geoshape	Karte	Legt den Maßstab beim Drucken des Kartenbildes fest.
rotate	degrees	geopoint, geotrace, geoshape, image	Karte, Bild	Gibt den Drehwinkel der Karte oder des Bildes an.
drawingInfo	currentLayer, Feature-Layer-URL	geopoint, geotrace, geoshape	Karte	Gibt die Darstellungsinformationen zum Drucken des Kartenbildes an, wie z. B. Symbol, Beschriftung und Transparenz.
src	image URL	-	-	Gibt die Quell-URL eines dynamischen Bildelements an.
size	width, height, max width, max height	image	Bild	Gibt die Größe des gedruckten Bildes an.
round	places	decimal, geopoint, geoshape, geotrace	Zahl	Rundet eine Dezimalzahl auf die angegebenen Dezimalstellen.
useGrouping	boolean	decimal	Zahl	Gibt bei "true" eine Zahl mit Gruppierungstrennzeichen zurück, die vom Gebietsschema bestimmt werden; bei "false" werden keine Trennzeichen verwendet.
toFixed	places	decimal, geopoint, geoshape, geotrace	Zahl	Gibt eine feste Anzahl von Ziffern nach dem Dezimaltrennzeichen an. Die Zahl wird bei Bedarf mit Nullen aufgefüllt, um der festgelegten Anzahl von Ziffern zu entsprechen.

Wählen Sie im Fenster Vorlagen verwalten die Option Kurzübersicht aus, um eine Seite zu öffnen, die Beispielsyntax für Ausdrücke enthält, mit denen die in einem Bericht angezeigte Antwort für die einzelnen Survey-Fragen geändert werden kann. Um die Syntax zu kopieren, klicken Sie auf die Schaltfläche In die Zwischenablage kopieren. Fügen Sie die Syntax anschließend in ein Vorlagendokument ein. Nachdem eine Vorlage hochgeladen wurde, können Sie die Optionen im Fenster Bericht verwenden, um Ihren Bericht zu erstellen. Weitere Informationen finden Sie unter Berichte drucken.

In den folgenden Abschnitten werden für die einzelnen Fragetypen häufige Verwendungsszenarien von Ausdrücken beschrieben und entsprechende Beispiele bereitgestellt.

Text

Bei Fragen mit mehrzeiligem Text, die durch Hinzufügen einer Frage des Typs Mehrzeiliger Text im Survey123 Web Designer oder unter Verwendung des Aussehens "multiline" für eine Textfrage in Survey123 Connect erstellt wurden, werden Zeilenumbrüche standardmäßig ignoriert. Die Antwort wird als ein einziger Textblock angezeigt. Um die Antwort auf die Frage mit Zeilenumbrüchen anzuzeigen, kann ein Ausdruck wie folgt verwendet werden:

${multilinetext1 | appearance:"multiline"}

Platzieren Sie diesen Ausdruck in einer eigenen Zeile. Andernfalls treten Fehler auf.

Zahlen

Grundlegende mathematische Operatoren können für numerische Fragen zum Addieren, Subtrahieren, Multiplizieren und Dividieren oder zum Ermitteln des Restwerts für die Antworten auf diese Fragen verwendet werden. Nachfolgend finden Sie einige Beispiele:

${number1 - 15}

${number1 * 6}

${number1 / number2}

${number1 % number2}

Tipp:

Wenn der Ausdruck einen komplexen mathematischen Ausdruck enthält, empfiehlt sich die Verwendung von Klammern, um sicherzustellen, dass beim Generieren des Berichts das gewünschte Ergebnis erzielt wird.

Bei Fragen vom Typ "decimal" kann mit dem Ausdruck round eine maximale Anzahl an Dezimalstellen festgelegt werden, auf die der Wert gerundet wird. Im folgenden Beispiel wird die Zahl 3,141592 auf die vier Dezimalstellen 3,1416 gerundet:

${decimal1 | round:4}

Mit dem Ausdruck toFixed kann eine maximale Anzahl an Dezimalstellen festgelegt werden, auf die der Wert gerundet wird. Im folgenden Beispiel wird die Anzahl von Dezimalstellen der Zahl 3,14 in 3,140 geändert:

${decimal1 | toFixed:3}

Mit dem Formatausdruck können Sie unter Verwendung von Platzhaltern festlegen, wie die Antwort auf eine Zahlenfrage angezeigt werden soll: Die im Folgenden aufgeführten Platzhalterzeichen werden unterstützt.

Zeichen	Beschreibung
.	Dezimaltrennzeichen.
,	Bei Angabe in einem Format werden Gruppentrennzeichen eingefügt. Die Gruppengröße ist die Anzahl der Ziffern zwischen dem ersten Gruppentrennzeichen und dem Dezimaltrennzeichen oder stattdessen dem Ende des Ausdrucks. Wenn hier nichts angegeben ist, werden keine Gruppentrennzeichen verwendet.
0	Erforderliche Ziffern. Wenn die Antwort weniger als die erforderliche Anzahl Ziffern enthält, wird mit Nullen aufgefüllt.
#	Optionale Ziffern. Wenn die Antwort mehr als die angegebene Anzahl Ziffern enthält, wird die Zahl gerundet.

Tipp:

Dezimal- und Tausender-Trennzeichen werden in der Ausgabe des Ergebnisses entsprechend dem gewählten Gebietsschema angezeigt.

Im folgenden Beispiel wird die Antwort mit maximal drei Dezimalstellen mit Tausender-Trennzeichen und bei Bedarf gerundet zurückgegeben.

${decimal1 | format:"#,##0.###"}

Bilder und andere Anlagen

Für Bildfragen können Größen festgelegt werden, um sicherzustellen, dass die Bilder der Berichte eine konsistente Größe aufweisen. Diese Ausdrücke haben das folgende Format:

${image1 | size:width:height:max_width:max_height}

Anhand der Breiten- und Höhenwerte wird die Größe Ihres Bildes, in Pixel gemessen, festgelegt. Obwohl diese Werte für den Ausdruck erforderlich sind, wird durch die Angabe des Wertes 0 keine Einschränkung für diese Abmessung des Bildes festgelegt. Anhand des folgenden Ausdrucks wird für das Bild eine Breite von 300 Pixel unter Beibehaltung des Seitenverhältnisses erzwungen.

${image1 | size:300:0}

Die maximalen Höhen- und Breitenwerte schränken die maximale Größe eines Bildes ein und sind optionale Werte. Im folgenden Beispiel wird für das Bild eine Breite von 300 Pixel erzwungen, und die Bildhöhe wird auf maximal 200 Pixel beschränkt.

${image1 | size:300:0:0:200}

Sie können die Methode rotate verwenden, um eine Rotation des Bildes im Uhrzeigersinn zu definieren. Zulässig sind Werte zwischen 0 und 360.

${image1 | size:300:0:0:200 | rotate:90}

Wenn ein Survey Bildfragen enthält, können in der Antwort auch Bilddetails extrahiert und angezeigt werden. Dies dient wie folgt zur Anzeige des Dateinamens und der Größe des Bildes:

${image1 | getValue:"name"}

${image1 | getValue:"size"}

${image1 | getValue:"width"}

${image1 | getValue:"height"}

Mit derselben Methode lassen sich EXIF-Daten des Bildes darstellen. Diese zeigen folgendermaßen, wo und wann ein Foto aufgenommen wurde:

${image1 | getValue:"x"}

${image1 | getValue:"y"}

${image1 | getValue:"date"}

${image1 | getValue:"time"}

${image1 | getValue:"direction"}

Um das ursprüngliche Bild in seiner vollen Größe und der ursprünglichen Qualität anzuzeigen, verwenden Sie den Ausdruck ohne eine Methode oder den Ausdruck getValue ohne einen Wert:

${image1} oder ${image1 | getValue:""}

Um das ursprüngliche Bild in seiner ursprünglichen Qualität und einer festgelegten Größe anzuzeigen, verwenden Sie die beiden Ausdrücke getValue und size zusammen.

${image1 | getValue:"" | size:300:0}

Hinweis:

Wenn Sie die Größe eines Bildes in Verbindung mit einem beliebigen anderen Ausdrucksparameter festlegen, muss size an letzter Stelle im Ausdruck stehen.

Da Datums- und Zeitangaben als Zeichenfolgen in EXIF-Daten gespeichert werden, können diese Werte nicht mit dem Ausdruck format für Datums- und Zeitfragen in einem Bericht formatiert werden. Wenn die Formatierung dieser Werte wichtig ist, dann sollten Sie mit der Funktion pulldata("@exif") die EXIF-Extraktion im Rahmen Ihres Survey durchführen. Weitere Informationen finden Sie unter Bilder.

Die vorstehenden getValue-Ausdrücke können auch verwendet werden, um Daten aus gültigen Eigenschaften in Anlagen jedes Typs zu extrahieren, beispielsweise die Ergebnisse von Bild-, Audio- und Dateifragen. Folgende Eigenschaften können aus allen Anlagen extrahiert werden:

${file1 | getValue:"name"}

${file1 | getValue:"size"}

${file1 | getValue:"globalId"}

${file1 | getValue:"id"}

${file1 | getValue:"contentType"}

${file1 | getValue:"keywords"}

Wenn alle Feature-Anlagen Bilder sind, verwenden Sie die folgenden Platzhalter jeweils auf einer eigenen Zeile:

${#$attachment}
${$file}
${/}

Um mehrere Bilder zurückzugeben, die in einer Antwort auf dieselbe Frage übermittelt wurden, verwenden Sie statt $attachment den Namen der Bildfrage:

${#image1}
${$file}
${/}

Dies ist eine nützliche Methode zum Anzeigen von Bildern in ArcGIS Enterprise-Versionen vor Version 10.8.1 oder zum Anzeigen von Bildern, die außerhalb von Survey123 einem Feature hinzugefügt wurden. Im folgenden Beispiel werden die Dateinamen aller Anlagen, die einem Feature hinzugefügt wurden, angezeigt:

${#$attachment}
${$file|getValue:"name"}
${/}

Um ein Bild aus einer Online-Quelle anzuzeigen, geben Sie die URL der Quelle mit dem Ausdruck src an. Dabei muss statt des Namens einer Frage das Schlüsselwort $image als Referenz verwendet werden:

${$image |
src:"https://upload.wikimedia.org/wikipedia/commons/1/13/Esri_Headquarters%2C_Building_Q.jpg"
| size:400:0}

Kartenfragen

Alle Fragen die eine Karte verwenden, wie zum Beispiel der Typen "geopoint", "geotrace" und "geoshape", verwenden gemeinsame Methoden und Parameter, mit deren Hilfe Sie ihre Darstellung in Berichten festlegen können.

Für eine Karte in einem Bericht wird standardmäßig die Webkarte verwendet, die für die Frage festgelegt wurde. Wenn der Kartenmaßstab auf 0 festgelegt ist oder der Parameter nicht angegeben wird, wird der Kartenmaßstab wie folgt durch die Features in der Karte bestimmt:

• Wenn die Karte nur ein Punkt-Feature enthält, entspricht der Kartenmaßstab dem Maßstab, der für die Frage festgelegt wurde.
• Wenn die Karte nur ein Linien- oder Polygon-Feature enthält, wird der Kartenmaßstab durch die Ausdehnung des Features bestimmt.
• Wenn die Karte mehrere Features enthält, wird der Maßstab durch die Ausdehnung aller Features bestimmt.

In Kartenfragen ist es auch möglich, die Element-ID und den Kartenmaßstab einer Webkarte als optionale Parameter festzulegen. Im folgenden Beispiel wird ein Kartenmaßstab von 1:100.000 verwendet:

${location | map:"7e2b9be8a9c94e45b7f87857d8d168d6" | mapScale:100000}

Für alle Kartenfragen können Sie die Methode rotate verwenden, um die Drehung im Uhrzeigersinn genau nach Norden in Bezug auf die Sicht zu definieren. Zulässig sind Werte zwischen 0 und 360.

${location | map:"7e2b9be8a9c94e45b7f87857d8d168d6" | mapScale:100000 | rotate:90}

Wenn Sie die Webkarten-Element-ID als leere Zeichenfolge angeben, wird die Standardgrundkarte für die Frage verwendet. Wenn Sie den Maßstab auf 0 festlegen oder diesen Parameter nicht angeben, wird in der Karte die für die Frage festgelegte Standardausdehnung verwendet.

Mit der Methode mapExtent kann die Ausdehnung einer Karte in einem Bericht explizit festgelegt werden. Im folgenden Beispiel wird eine feste Kartenausdehnung für Tokio, Japan, angezeigt:

${location | mapExtent:139.7:35.6:139.9:35.8:4326}

Kartenfragen unterstützen auch den für Bildfragen verfügbaren Größenausdruck. Damit können Sie die Auflösung der im Bericht angezeigten Karte wie im folgenden Beispiel gezeigt steuern:

${location | size:400:400}

Sie können die Ausdrücke map, mapScale und size zusammen verwenden, um eine Webkarten-ID und einen Kartenmaßstab sowie eine Kartenbildauflösung bereitzustellen, wie im folgenden Beispiel gezeigt:

${location | map:"7e2b9be8a9c94e45b7f87857d8d168d6" | mapScale:100000 | size:400:400}

Hinweis:

Wenn Sie die Größe einer Karte in Verbindung mit einem beliebigen anderen Ausdrucksmethode festlegen, muss size an letzter Stelle im Ausdruck stehen.

Standardmäßig wird eine Kartenfrage ungeachtet der im Feature-Layer festgelegten Symbolisierung mit einem Standardkartenmarkersymbol angezeigt. Sie können die Methode drawingInfo verwenden, um die Darstellungsinformationen, wie z. B. Symbol, Beschriftung und Transparenz, die in einem bestimmten Feature-Layer gespeichert sind, zu extrahieren. Diese Informationen können Sie im aktuellen Layer oder in einem bestimmten Feature-Layer über eine URL angeben.

${location | drawingInfo:"currentLayer"}

${location | drawingInfo:"https://.../FeatureServer/0"}

Wenn Ihr Survey keine Kartenfrage enthält oder Sie Berichte für Feature-Layer ohne verknüpften Survey erstellen, kann die Geometrie eines Datensatzes dennoch mit dem Platzhalter ${$shape} zurückgegeben werden.

In einem Zusammenfassungsabschnitt werden mit einem Ausdruck für eine Kartenfrage mehrere Geometrien in der Eingabe für die Frage angezeigt. Wenn in einen einzelnen Bericht weitere Antworten eingebunden werden sollen, geben Sie einen where-Ausdruck mit dem !important-Tag an. Weitere Informationen finden Sie unter Zusätzliche Syntax. Mit dem folgenden Ausdruck werden alle Geometrien im Layer angezeigt, bei denen der Wert des Statusfeldes auf "broken" festgelegt ist:

${location | where:"status='broken' !important" | map:"<itemID>" | size:400:300}

Hinweis:

Im obigen Beispiel wird der Kartenmaßstab nicht angegeben. Wenn Sie den Maßstab auf 0 festlegen oder diesen Parameter nicht angeben und die Karte mehrere Datensätze enthält, wird in der Karte die kombinierte Ausdehnung für alle Datensätze verwendet.

Sie können festlegen, dass der where-Ausdruck immer "true" ist, um sicherzustellen, dass alle Geometrien im Layer angezeigt werden:

${location | where:"1=1 !important"}

Damit können auch alle Punkte in einer Wiederholung angezeigt werden:

${repeat1.repeatLocation | where:"inspectionId=123 !important" | size:400:300}

Mit dem Platzhalter ${$shape} können auch mehrere Kartengeometrien zurückgegeben werden.

${$shape | where:"1=1 !important" | drawingInfo:"currentLayer" | size:400:300}

Geopunkte

Für Geopunkt-Fragen können Sie Ausdrücke zum Anzeigen der Breiten- und Längengradwerte aus der Frage wie folgt verwenden:

${location | getValue:"x"}

${location | getValue:"y"}

Sie können nicht beide Werte mit einem Ausdruck anzeigen. Falls beide Werte erforderlich sind, müssen Sie beide Ausdrücke verwenden.

Tipp:

Den Höhenwert können Sie ebenfalls über einen ähnlichen Ausdruck anzeigen. Dies gilt jedoch nur, wenn der zugrunde liegende Feature-Layer Z-Werte unterstützt:

${location | getValue:"z"}

Standardmäßig werden Breitengrad-, Längengrad- und Höhenwerte als der ursprüngliche Wert, der im Survey angegeben wurde, ohne Kürzung zurückgegeben. Da diese häufig viel länger als in einem Bericht benötigt sein können, sollten Sie den Ausdruck round oder den Ausdruck toFixed verwenden, um den Wert auf eine bestimmte Dezimalstelle zu runden.

${location | getValue:"x" | round:3}

${location | getValue:"x" | toFixed:3}

Standardmäßig werden diese Werte im selben Raumbezug ausgegeben, der auch vom Feature-Layer des Survey verwendet wird. Sie können einen anderen Raumbezug als zusätzlichen Parameter festlegen, indem Sie die entsprechende WKID angeben:

${location | getValue:"x":4326}

Geotrace und Geoshape

Bei Fragen des Typs "Geotrace" und "Geoshape" können Sie den Ausdruck getValue verwenden, um die Länge der Zeile oder den Umfang des Polygons anzuzeigen:

${polyline1 | getValue:"length":"meters":"planar"}

Bei Fragen des Typs "Geoshape" können Sie auch den Ausdruck getValue verwenden, um die Fläche des Polygons anzuzeigen:

${polygon1 | getValue:"area":"hectares":"geodesic"}

Die Einheiten und Berechnungsmethode sind optionale Parameter. Für die Länge werden die folgenden Einheiten akzeptiert:

• feet
• kilometers
• meters
• miles
• nautical-miles
• yards

Für die Fläche werden die folgenden Einheiten akzeptiert:

• acres
• hectares
• square-miles
• square-kilometers
• square-meters
• square-feet
• square-yards

Alternativ können Sie eine beliebige, von ArcGIS REST API unterstützte esriSRUnitType-Konstante oder esriSRUnit2Type-Konstante verwenden. Verwenden Sie den numerischen Code für die Konstante ohne Anführungszeichen in Ihrem Ausdruck:

${polyline1 | getValue:"length":109002:"geodesic"}

Wenn keine Einheiten angegeben sind, lautet die Standardeinstellung für die Länge kilometers und für die Fläche square-kilometers.

Als Methode kann geodesic oder planar angegeben werden. Wenn keine Methode angegeben ist, wird standardmäßig geodesic verwendet.

Datum, Zeit und Datum/Zeit

Um sicherzustellen, dass Ihre Datums- und Datums-/Zeit-Fragen entsprechend der Formatierung Ihrer Region angezeigt werden, können Sie einen Ausdruck zum Formatieren der Frage entsprechend einem angegebenen Gebietsschema verwenden. Der Parameter locale muss am Anfang eines Ausdrucks stehen, und der Gebietsschemacode muss in Kleinbuchstaben angegeben werden.

${datetime | locale:"pt-br"}

Hinweis:

Informationen über die Gebietsschemacodes einer bestimmten Sprache finden Sie in der Liste von ISO 639-1-Codes in Wikipedia. Denken Sie jedoch daran, dass nicht alle in dieser Liste aufgeführten Sprachen von Survey123 unterstützt werden.

Alle Datums- und Datums-Zeitwerte in einem Feature-Layer werden in koordinierter Weltzeit (Coordinated Universal Time, UTC) gespeichert. Alle Datums- und Datums-Zeitwerte, die in einem Bericht zurückgegeben werden, werden standardmäßig in der gleichen Zeitzone wie der Webbrowser, der die Berichterstellung angefordert hat, angezeigt. Sie können die Methode utcOffset verwenden, um die Anzeige dieser Werte in einem Bericht entsprechend einer bestimmten Zeitzone zu formatieren. Mit dem folgenden Ausdruck wird die Antwort auf eine Datums-Zeit-Frage mit einem Zeitversatz von einer Stunde gegenüber UTC angezeigt:

${datetime | utcOffset:"+01:00"}

Die Methode utcOffset unterstützt die Formate +01:00, +0100 und +01 und gibt dasselbe Ergebnis zurück. Sie können diese Methode auch verwenden, um die Anzeige der Zeit der Übermittlung der Antwort zu formatieren. Beachten Sie, dass utcOffset für Zeitfragen nicht verwendet werden kann.

Für Datums- und Datums-Zeit-Fragen können Sie einen Ausdruck zum Formatieren des Datums mit den Platzhaltern DD, MM und YYYY für Tag, Monat und Jahr verwenden. Der folgende Ausdruck zeigt nur den Tag und den Monat an, das Jahr wird ausgelassen:

${date | format:"DD/MM"}

Außerdem können Sie die Zeit in Datums-Zeit-Fragen formatieren, indem HH, mm und SS als Platzhalter für Stunden, Minuten bzw. Sekunden verwendet werden. Der folgende Ausdruck zeigt den Tag, den Monat, die Stunden und die Minuten an:

${datetime | format:"DD/MM HH:mm"}

Hinweis:

Die Methode format muss am Ende des Ausdrucks stehen.

In der folgenden Tabelle sind die gängigen Platzhalter für Datum und Uhrzeit aufgeführt:

Platzhalter	Beschreibung
YY	Die letzten beiden Ziffern der Jahreszahl. Beispiel: 2023 wird als 23 dargestellt.
YYYY	Vier Ziffern der Jahreszahl. Beispiel: 2023 wird als 2023 dargestellt.
M	Monatsnummer zwischen 1 und 12. Beispiel: Der Januar wird als 1 dargestellt.
MM	Zweistellige Monatsnummer. Beispiel: Der Januar wird als 01 dargestellt.
MMM	Monat in drei Buchstaben. Beispiel: Januar wird als Jan dargestellt.
MMMM	Der Monat wird ausgeschrieben. Beispiel: Januar wird als Januar dargestellt.
D	Tagesnummer zwischen 1 und 31. Beispiel: Der erste Tag des Monats wird als 1 dargestellt.
DD	Zweistellige Tagesnummer. Beispiel: Der erste Tag des Monats wird als 01 dargestellt.
Do	Tageszahl, die Ordnungssuffixe enthält. Beispiel: Der erste Tag des Monats wird als 1. dargestellt.
H	Stundennummer im 24-Stunden-Format. Beispiel: 11 Uhr abends wird als 23 dargestellt.
HH	Stundennummer im 24-Stunden-Format mit zwei Ziffern. Beispiel: 2 Uhr nachts wird als 02 dargestellt.
h	Stundennummer im 12-Stunden-Format. Beispiel: 11 Uhr abends wird als 11 dargestellt.
hh	Stundennummer im 12-Stunden-Format mit zwei Ziffern. Beispiel: 2 Uhr nachts wird als 02 dargestellt.
m	Minutennummer zwischen 0 und 59. Beispiel: 8 Minuten werden als 8 dargestellt.
mm	Zweistellige Minutennummer. Beispiel: 8 Minuten werden als 08 dargestellt.
Z	Zeitzonenversatz in Stunden mit Trennzeichen. Beispiele: -07:00, +13:00
ZZ	Zeitzonenversatz in Stunden ohne Trennzeichen. Beispiele: -0700, +1300
x	Unix-Zeitstempel im Millisekundenbereich. Beispiele: 21 Uhr am 4. Mai 2023 GMT wird als 1683234000000 dargestellt.
X	Unix-Zeitstempel. Beispiele: 21 Uhr am 4. Mai 2023 GMT wird als 1683234000 dargestellt.
a	Kleinschreibung der Zeitangabe am Morgen/Vormittag oder Nachmittag. Beispiel: a.m. wird als am und p.m. als pm dargestellt.
A	Großschreibung der Zeitangabe am Morgen/Vormittag oder Nachmittag. Beispiel: a.m. wird als AM und p.m. als PM dargestellt.

Mehrfachauswahl

Wenn in einem Platzhalter auf eine Frage mit Einfachauswahl verwiesen wird, z. B. ${select_one}, wird die Auswahlbeschriftung zurückgegeben. Wenn eine Einzelauswahlfrage in einem Ausdruck verwendet wird oder wenn die Frage eine externe Auswahl verwendet, wird von einer Einzelauswahlfrage der Wert eines Auswahlelements zurückgegeben. Das folgende Beispiel verwendet einen Auswahlwert statt einer Beschriftung für eine Bedingungsanweisung.

${if select_one=="choice1Value"}The user selected the first choice.${/}

Um zu veranlassen, dass statt der Beschriftung der Wert einer Auswahl angezeigt wird, verwenden Sie den Ausdruck getValue:

${select_one | getValue:""}

Für die Auswahl einer oder mehrerer Fragen können Sie einen Ausdruck verwenden, um ein Kontrollkästchen neben einem Auswahlelement zu platzieren, das je nach Antwort auf die Frage gefüllt wird. Der folgende Ausdruck wird angezeigt, wenn die Option yes für eine Frage ausgewählt wurde:

${select_one | checked:"yes"} Yes

Bei Fragen mit Mehrfachauswahl werden Ausdrücke zur Ausgabe der Gesamtanzahl der ausgewählten Optionen sowie einer spezifischen ausgewählten Option unterstützt:

${select_multiple | countSelected}

${choiceQuestion1 | selectedAt:2}

Hinweis:

Mit dem Ausdruck selectedAt werden die ausgewählten Optionen beginnend mit Null gezählt. Für die dritte ausgewählte Option wird also ${choiceQuestion1 | selectedAt:2} zurückgegeben.

Für Fragen mit Mehrfachauswahl ist ebenfalls ein unterstützter Ausdruck verfügbar, um alle ausgewählten Auswahlelemente als Aufzählung zurückzugeben. Der Ausdruck sieht folgendermaßen aus:

${select_multiple | appearance:"bullets"}

Hinweis:

Wenn die Beschriftung des Auswahlelements doppelte Anführungszeichen enthält, muss diesen ein umgekehrter Schrägstrich vorangestellt werden. Andernfalls wird der Bericht nicht gedruckt. Bei einfachen Anführungszeichen ist kein umgekehrter Schrägstrich erforderlich. Beispiel:

${select_one | checked:"Service provided by \"Greg's Plumbing\""} Service provided by "Greg's Plumbing"

Wiederholungen

Um auf Fragen in einer Wiederholung zuzugreifen, fügen Sie Ihrer Vorlage einen Wiederholungsbereich hinzu. Bei einer Wiederholung mit dem Namen "defects" kennzeichnet der Platzhalter ${#defects} den Beginn des Wiederholungsbereichs, während der Platzhalter ${/} das Ende kennzeichnet. Platzhalter, die auf Fragen innerhalb der Wiederholung verweisen, müssen sich zwischen den Platzhaltern für Beginn und Ende des Wiederholungsbereichs befinden.

Hinweis:

Um den Inhalt einer Wiederholung in einer Tabelle zu drucken, stellen Sie sicher, dass sowohl das Anfangs- als auch das End-Tag innerhalb bzw. außerhalb der Tabelle platziert ist. Es kann kein Bericht generiert werden, wenn sich eines dieser Tags innerhalb einer Tabelle und das andere außerhalb der Tabelle befindet. In den meisten Fällen sollte sich das Anfangs-Tag in der ersten Zelle und das End-Tag in der letzten Zelle befinden, wenn ein Anfangs- und ein End-Tag in einer Tabelle platziert werden.

Um auf Fragen in einer geschachtelten Wiederholung zuzugreifen, setzen Sie ihre Tags zwischen die Tags für jeden Wiederholungs-Layer über dem betreffenden Wiederholungsbereich. Beispiel:

${#repeat1}
${#repeat2}
${#repeat3}
${field1InRepeat3}, ${repeat2.field1}, ${repeat1.field1}, ${mainLayer.field1} 
${/}
${/}
${/}

Ausdrücke für Berichte können beim Referenzieren von Layer-Namen unter Verwendung der ${layername}-Syntax keine Sonderzeichen, z. B. Bindestriche, lesen. Verwenden Sie beim Referenzieren eines Layers, dessen Name ein Sonderzeichen enthält, anstelle des Sonderzeichens einen Unterstrich. Alternativ können Sie den Layer mit dem Schlüsselwort $layers und dem Layer-Namen oder der Layer-ID referenzieren, beispielsweise ${$layers["my layer name"]} oder ${$layers[0]}. Dies kann bei doppelten Layer-Namen sinnvoll sein.

Wenn auf ein Feld in der Wiederholung verwiesen werden soll und dieses Feld über denselben Namen wie die übergeordnete Wiederholung verfügt, verwenden Sie die vollständige Pfadsyntax einschließlich Feld- und Wiederholungsname. Beispiel: ${sharedName.sharedName}.

Um den Index eines Wiederholungsdatensatzes anzuzeigen, verwenden Sie den Ausdruck getValue mit dem reservierten Schlüsselwort $feature. Mit diesem Beispiel wird 1 für den ersten Datensatz in einer Wiederholung, 2 für den zweiten Datensatz usw. generiert:

${#defects}
${$feature | getValue: "position"}
${/}

Abfragen in Berichten

Mit Aggregatfunktionen können Sie Abfragen der Werte in Ihren gedruckten Antworten generieren. Am besten sind diese Abfragen in einem Zusammenfassungsabschnitt geeignet, der ungeachtet der Anzahl der gedruckten Antworten nur einmal in einem Bericht vorhanden ist. Weitere Informationen finden Sie unter Abfragen in Berichten.

Wenn in Ihrem Bericht nicht jede Wiederholung zu einer bestimmten Antwort, sondern nur eine bestimmte Anzahl von Wiederholungen ausgegeben werden soll, verwenden Sie die Methode resultRecordCount, um die gewünschte Anzahl der zu druckenden Wiederholungen festzulegen:

${#defects | resultRecordCount:20}...${/}

Mit der Methode orderByFields können Sie festlegen, in welcher Reihenfolge die Wiederholungen gedruckt werden sollen. Dazu müssen Sie einen Feldnamen mit dem Zusatz ASC oder DESC deklarieren. Dadurch werden die Wiederholungen entsprechend der Eingabe in diesem Feld in aufsteigender bzw. absteigender Reihenfolge gedruckt:

${#defects | orderByFields:"state_name ASC, pop2000 DESC"}...${/}

Bedingte Berichtselemente

Mit IF-Anweisungen können Sie Elemente eines Berichts in Abhängigkeit von einer Bedingung ein- oder ausblenden. Die IF-Anweisung können Sie verwenden, indem Sie einen Ausdruck in den Startplatzhalter ${if expression} einfügen, wobei ${/} das Ende des bedingten Segments kennzeichnet. Nachfolgend einige Beispiel für if-Anweisungen, mit denen Sie Teile eines Berichts ein- oder ausblenden können:

• Bei Verwendung von ${if photo1} wird der Abschnitt nur angezeigt, wenn die Frage "photo1" beantwortet wurde.
• Bei Verwendung von ${if integer1>0} wird der Abschnitt nur angezeigt, wenn die Antwort auf die Frage "integer1" eine positive Zahl aufweist.
• Bei Verwendung von ${if ((geopoint1 | getValue:"y")>0)} wird der Abschnitt nur angezeigt, wenn der Geopunkt in der nördlichen Hemisphäre liegt.
• Bei Verwendung von ${if multiple_choice1 | selected:"A"} wird der Abschnitt nur dann angezeigt, wenn in der Mehrfachauswahlfrage "A" ausgewählt wurde.
• Bei Verwendung von ${if (repeat1 | getValue:"count")>=3} wird der Abschnitt nur dann angezeigt, wenn "repeat1" drei oder mehr Datensätze enthält.

Im folgenden Beispiel wird der Text in der zweiten Zeile nur dann im Bericht angezeigt, wenn high für die Priorität in der Einfachauswahlfrage ausgewählt wurde:

${if priority | selected:"high"}
High priority issues must be addressed within seven days.
${/}

Um zu überprüfen, ob eine Antwort einen Wert für eine Frage enthält, verwenden Sie eine IF-Anweisung, die den Feldnamen direkt referenziert und keine weiteren Operatoren enthält, z. B. ${if photo1}. Durch dieses Format wird sichergestellt, dass leere Zeichenfolgen, NULL-Werte und undefinierte Werte als leere Werte gelten. Dieses Format gilt für Feldtypen vom Typ Zeichenfolge, Zahl, Datum und Anlage. Wird dieses Format bei Wiederholungen verwendet, wird der Abschnitt angezeigt, sofern es mindestens ein Vorkommen in der Wiederholung gibt.

Führen Sie für die Verwendung von Bedingungsanweisungen mit Datums- und Zeitfragen Berechnungen mit der UNIX-Zeit (seit dem 1. Januar 1970 verstrichene Zeit in Millisekunden) durch. ${if (date1|getValue:"") < 1602735375000} zeigt z. B. den Abschnitt nur an, wenn der im Datumsfeld angegebene Zeitpunkt vor dem 14. Oktober 2020 liegt. Beachten Sie, dass die Berichtssyntax keine Entsprechung für die today() oder now()-XLSForm-Funktionen aufweist. Aus diesem Grund ist es nicht möglich, eine Bedingungsanweisung für Zeiten relativ zum Zeitpunkt des Druckens des Berichts zu verfassen.

IF-Anweisungen unterstützen die folgenden logischen Operatoren:

Operator	Beschreibung
||	"True", wenn eine der beiden Anweisungen "true" zurückgibt
&&	"True", wenn beide Anweisungen "true" zurückgeben
!	"True", wenn die Anweisung nicht "true" zurückgibt
==	"True", wenn beide Werte gleich sind
!=	"True", wenn beide Werte ungleich sind
>	Es wird ausgewertet, ob der erste Wert größer ist als der zweite Wert.
>=	Es wird ausgewertet, ob der erste Wert größer als oder gleich dem zweiten Wert ist.
<	Es wird ausgewertet, ob der erste Wert kleiner ist als der zweite Wert.
<=	Es wird ausgewertet, ob der erste Wert kleiner als oder gleich dem zweiten Wert ist.

Einschränkungen

Bei der Verwendung von Vorlagen für Berichte bestehen die folgenden Einschränkungen:

• Filter, die in der Survey123-Website auf Wiederholungen angewendet werden, werden in Berichten nicht angewendet. In einem Bericht können Wiederholungen nur mit Ausdrücken gefiltert werden.
• Ihre Karte wird im Bericht nicht angezeigt, wenn von der Karte eine ältere Webkartenversion als 2.0 (veröffentlicht im Juli 2014) verwendet wird.
• Ihre Karte wird im Bericht nicht angezeigt, wenn Ihr ArcGIS Enterprise-Portal nicht über ein gültiges SSL-Zertifikat verfügt.
• Das Drucken mit Berichtsvorlagen funktioniert nicht mit ArcGIS Enterprise-Bereitstellungen, die nicht öffentlich zugänglich sind. Der Versuch führt zu einem getaddrinfo ENOTFOUND-Fehler.
• Das Drucken mit Berichtsvorlagen funktioniert nicht bei ArcGIS Enterprise-Bereitstellungen, die die integrierte Windows-Authentifizierung (IWA) verwenden.
• Eine Berichtsanforderung kann maximal 2.000 Datensätze enthalten.
• Wenn die Survey123-Website in einer eigenen Infrastruktur installiert ist, kann die API für Berichte nicht verwendet werden. Berichte können nur bei Verwendung von https://survey123.arcgis.com/ generiert werden.