URL-Parameter

Dashboards können durch die effektive Verwendung von URL-Parametern verbessert werden. Ein URL-Parameter ist eine Eigenschaft, die der Konfiguration des Dashboards von dessen Autor hinzugefügt wird, und zum Auslösen von Aktionen verwendet werden kann. Dadurch ermöglichen URL-Parameter die Darstellung des Dashboards in der vorgegebenen Weise. URL-Parameter sind außerdem in Fällen hilfreich, in denen ein Dashboard in eine andere Anwendung eingebettet wurde. In diesem Szenario kann die aktuelle Ansicht des Dashboards mit der Hosting-App geändert werden.

Hinweis:

Mit Ausnahme des integrierten Parameters für das Gebietsschema führt eine Änderung der Parameter eines Dashboards zur Laufzeit in den meisten modernen Browsern nicht dazu, dass es erneut geladen wird.

Ein URL-Parameter ist ein Name/Wert-Paar. In jedem Parameter werden der Name und der Wert durch ein Gleichzeichen (=) getrennt. Zur Laufzeit wird ein Parameter mithilfe eines Fragezeichens (?), gefolgt von dem Parameter, an das Ende der URL eines Dashboards angehängt.

Eine Dashboard-URL, die einen Parameter enthält, kann beispielsweise folgendermaßen lauten: <scheme>://<yourPortalUrl>/apps/opsdashboard/index.html#/<id>?param=value.

Bei mehreren Parametern wird jeweils ein kaufmännisches Und-Zeichen (&) zu deren Trennung hinzugefügt: <scheme>://<yourPortalUrl>/apps/opsdashboard/index.html#/<id>?param=value&param2=value2

Tipp:

Die Reihenfolge der Parameter ist nicht relevant. param=value&param2=value2 und param2=value2&param=value führen beispielsweise zum selben Ergebnis.

Parameternamen bestehen aus alphanumerischen ASCII-Zeichen. Bindestriche (-) und Unterstriche ( _ ) sind ebenfalls zulässig, und zwar an jeder Stelle, ausgenommen an der ersten. Ungültige Zeichen werden beim Entwurf mit einer Validierungswarnung blockiert. Es empfiehlt sich, lange Parameternamen zu vermeiden.

Tipp:

Einige Parameternamen sind für die interne Verwendung reserviert, z. B. mode und edit. Wenn Sie beim Erstellen eines neuen Parameters einen reservierten Namen verwenden, tritt die Validierungswarnung Bereits verwendet auf.

Vorsicht:

Für die Interaktion zwischen Dashboard-Elementen werden sowohl URL-Parameter als auch Auswahlen verwendet. Werden sie für dieselben Elemente verwendet, können Sie im Widerspruch zueinander stehen und unerwartete Fehler verursachen. Lassen Sie beim Entwerfen der Interaktionen des Dashboards Vorsicht walten.

URL-Codierung

Codieren Sie den Wert eines Parameters, wenn Sie ihn an ein Dashboard übergeben. Durch die Codierung wird sichergestellt, dass ungültige Zeichen durch "%" gefolgt von ihrem entsprechenden Dezimalwert ersetzt werden.

Die Übergabe des Wertes "Main Street" über einen URL-Parameter sieht wie folgt aus:

<scheme>://<yourPortalUrl>/apps/opsdashboard/index.html#/<id>?param=Main%20Street

Beachten Sie Folgendes, wenn Sie einen URL-Parameter als Liste mit kommagetrennten Werten übergeben:

• Jeder Wert sollte getrennt codiert werden.

  Richtig

  ?param=Main%20Street,Broadway%20Avenue

  Falsch. Codieren Sie nicht das Komma, das zum Trennen von Werten verwendet wird.

  ?param=Main%20Street%2CBroadway%20Avenue

• Zwischen Werten sollten keine Leerstellen vorhanden sein.

  Richtig

  ?param=Main%20Street,Broadway%20Avenue

  Falsch

  ?param=Main%20Street, Broadway%20Avenue

Typen von URL-Parametern

Es gibt fünf Typen von URL-Parametern: "Kategorie", "Numerisch", "Datum", "Feature" und "Geometrie". Weitere Informationen zu den Aktionstypen, die von verschiedenen Parametertypen ausgelöst werden können, finden Sie unter Konfigurieren von Aktionen für URL-Parameter

Kategorieparameter

Ein Kategorieparameter wird verwendet, um eine Filteraktion auf ein oder mehrere Elemente anzuwenden. Beim Entwurf legen Dashboard-Autoren den Namen des Parameters fest, d. h., ob Eingaben vom Typ "Zeichenfolge" oder "Zahl" sind und ob Filterabfragen die übergebenen Werte ein- oder ausschließen.

Zur Laufzeit akzeptieren Kategorieparameter entweder einen einzelnen Wert oder mehrere durch ein Komma getrennte Werte. Auf das Komma sollte keine Leerstelle folgen.

Wird ein einzelner Wert übergeben, verwendet die im Hintergrund ausgeführte Abfrage den Vergleichsoperator "gleich" oder "ungleich", um die Zielelemente zu filtern. Werden mehrere Werte übergeben, werden die logischen Operatoren "IN" oder "NOT IN" verwendet.

Beispiele

Die folgende Tabelle enthält Hinweise dazu, ob der Kategorieparameter für eine Zeichenfolge oder eine Zahl konfiguriert wurde:

Parameter	Hinweis
?status=DAMAGED	Zeichenfolge
?status=DAMAGED,DESTROYED	Zeichenfolge mit mehreren Werten
?category=1	Zahl
?category=1,2	Zahl mit mehreren Werten

Beispiele für Sonderfälle

Datenkategorien werden nicht immer festgelegt, oder sind im Fall von Zeichenfolgen möglicherweise leer. Demzufolge unterstützen Parameter die folgenden vier Sonderfälle:

• ((null))
• ((notnull))
• ((empty))
• ((notempty))

Parameter	Hinweis
?status=((null))	Filter für Werte, die NULL sind
?status=((notnull)	Filter für Werte, die NICHT NULL sind
?status=((empty))	Filter für Werte, die leer sind
?status=((notempty))	Filter für Werte, die nicht leer sind
?status=DAMAGED,((null))	Filter für Werte, die übergeben wurden ODER NULL sind
?status=DAMAGED,DESTROYED,((null))	Filter für mehrere Werte, die übergeben wurden ODER NULL sind

Numerische Parameter

Numerische Parameter werden verwendet, um eine Filteraktion auf ein oder mehrere Zielelemente anzuwenden. Beim Entwurf legen Dashboard-Autoren den Namen des Parameters fest und ob die erwarteten Eingabewerte einzelne Werte oder zwei Werte sein sollen, die einen Bereich darstellen. Bei Verwendung eines einzelnen Wertes wird der Parameter für die Anwendung eines der folgenden Vergleichsparameter konfiguriert:

• gleich
• ungleich
• kleiner als
• kleiner als oder gleich
• größer als
• größer als oder gleich

Tipp:

Wenn Sie eine genauere Steuerung als die des Bereichswerttyps wünschen, erstellen Sie zwei einzelne numerische Parameter, und wenden Sie die Filterbedingung (Operator) an, die Ihren Anforderungen entspricht. Zur Laufzeit werden die einzelnen Parameter mit einem logischen UND-Operator kombiniert, wenn ein Filter auf die Zielelemente angewendet wird.

Zur Laufzeit werden numerische Parameter als einzelner Wert oder als zwei durch ein Komma getrennte Werte übergeben.

Beispiele

Die folgende Tabelle enthält Hinweise dazu, ob der numerische Parameter für einen einzelnen Wert oder einen Bereich konfiguriert wurde.

Parameter	Hinweis
?meas=10	Einzelner Wert
?meas=10,15	Bereich

Beispiele für Sonderfälle

Numerische Werte in Daten werden nicht immer festgelegt. Demzufolge unterstützen numerische Parameter zwei Sonderfälle: ((null)) und ((notnull)). Diese Beschriftungen für Sonderfälle können in Workflows für einzelne Werte und in Workflows für numerische Bereiche verwendet werden.

Parameter	Hinweis
?meas=((null))	Einzelner Datumswert oder numerischer Bereich. Filter für Werte, die NULL sind
?meas=((notnull))	Einzelner Datumswert oder numerischer Bereich. Filter für Werte, die NICHT NULL sind
?meas=10,((null))	Einzelwert. Filter für einen Wert ODER für Werte, die NULL sind
?meas=10,15,((null))	Numerischer Bereich. Filter für Zahlen in einem Bereich ODER für Werte, die NULL sind

Ein weiterer spezieller Fall liegt vor, wenn ein numerischer Parameter einen Bereich erwartet, zur Laufzeit jedoch nur ein einzelner Wert bereitgestellt wird.

Parameter	Hinweis
?meas=,10	Offen links. Werte, die kleiner oder gleich diesem Wert sind, werden gefiltert
?meas=10,	Offen rechts. Werte, die größer oder gleich diesem Wert sind, werden gefiltert
?meas=10	Offen rechts. Werte, die größer oder gleich diesem Wert sind, werden gefiltert
?meas=10,((null))	Offen rechts. Filterwerte, die größer oder gleich diesem Wert ODER NULL sind

Datumsparameter

Datum-Parameter werden verwendet, um eine Filteraktion auf mindestens ein Zielelement anzuwenden. Beim Entwurf legen Dashboard-Autoren den Namen des Parameters fest und ob die erwarteten Eingabewerte ISO 8601-Datumszeichenfolgen oder UNIX Epoch sein sollen.

Datum-Parameter können für die Verarbeitung eines einzelnen Wertes oder zweier Werte konfiguriert werden, die einen Datumsbereich darstellen. Bei Verwendung eines einzelnen Wertes wird der Parameter für die Anwendung eines der folgenden Vergleichsparameter konfiguriert:

• ist
• ist nicht
• ist vor
• ist oder ist vor
• ist nach
• ist oder ist nach

Tipp:

Wenn Sie eine genauere Steuerung als die des Bereichswerttyps wünschen, erstellen Sie zwei einzelne Datum-Parameter, und wenden Sie die Filterbedingung (Operator) an, die Ihren Anforderungen entspricht. Zur Laufzeit werden die einzelnen Datum-Parameter mit einem logischen UND-Operator kombiniert, wenn ein Filter auf die Zielelemente angewendet wird.

Zur Laufzeit werden Datum-Parameter als ein einzelner Wert oder als zwei durch ein Komma getrennte Werte übergeben. Wenn ein Datum-Parameter vom Typ "UNIX Epoch" ist, erwartet er einen ganzzahligen 32-Bit-Wert mit Vorzeichen. Handelt es sich um eine Zeichenfolge, müssen Datumsangaben als JJJJ-MM-TT oder JJJJMMTT formatiert werden. Datumsangaben werden gemäß dem gregorianischen Kalender eingegeben und bestehen aus Jahres-, Monats- und Tagesangaben.

• JJJJ – Vierstellige Jahresangabe (JJJJ)
• MM – Zweistellige Monatsangabe des Jahres (01 bis 12)
• DD – Zweistellige Tagesangabe (01 bis 31)

Tipp:

Die Liste der von Datum-Parametern unterstützten Datumsformate unterscheidet sich von der, die vom Reihendiagramm zum Analysieren von Datumsangaben unterstützt wird.

Eine Uhrzeit kann auch in eine Datumsangabe einbezogen werden. Uhrzeitangaben werden im 24-Stunden-Format eingegeben und bestehen aus Stunden-, Minuten- und Sekundenangaben. Sie können als hh:mm:ssoder hhmmss formatiert werden. Wenn die Datumsangabe keine Uhrzeit enthält, wird der vollständige Tag zwischen 00:00:00 und 23:59:59 impliziert.

• hh – Eine mit Nullen aufgefüllte Stundenangabe zwischen 00 und 24
• mm – Eine mit Nullen aufgefüllte Minutenangabe zwischen 00 und 59
• ss – Eine mit Nullen aufgefüllte Sekundenangabe zwischen 00 und 59

Falls die Uhrzeit angegeben ist, wird sie durch eine Leerstelle oder einen Großbuchstaben von der Datumsangabe getrennt T. Bei den folgenden Datumsangaben handelt es sich um gültige Datumsangaben, die als Zeichenfolgen übergeben werden:

Datum	Hinweis
31.10.2018	Nur Datum
20181031	Nur Datum (alternatives Format)
2018-10-31T23:14:42	Durch T getrennte Datums- und Uhrzeitangabe
20181031T231442	Durch T getrennte Datums- und Uhrzeitangabe (alternatives Format)
2018-10-31 23:14:42	Durch eine Leerstelle getrennte Datums- und Uhrzeitangabe
20181031 231442	Durch eine Leerstelle getrennte Datums- und Uhrzeitangabe (alternatives Format)

Tipp:

Es wird empfohlen, Datums- und Uhrzeitangaben durch einen Großbuchstaben zu trennen T. Wenn Sie eine Leerstelle verwenden, sollten Sie diese codieren.

Wenn Datumsangaben zur Laufzeit an ein Dashboard übergeben werden, wird vorausgesetzt, dass deren Uhrzeitkomponente in der lokalen Zeitzone angegeben wird. Das heißt, die Zeitzone des Computers oder des Geräts, auf dem der Browser ausgeführt wird. Zur besseren Steuerung kann Zeit auch in koordinierter Weltzeit (Coordinated Universal Time, UTC) oder als Versatz aus UTC angegeben werden. Um anzugeben, dass die Uhrzeit in UTC vorliegt, fügen Sie direkt nach der Zeitangabe ein Z ohne Leerstelle ein. Das Z ist der Zonenbezeichner für den UTC-Versatz von Null. Ein Versatz aus UTC wird der Zeitangabe im Format "±hh:mm", "±hhmm" oder "±hh" angehängt.

Datum	Hinweis
2018-10-31T23:14:42Z	UTC
2018-10-31T23:14:42+01:00	Eine Stunde vor UTC
2018-10-31T23:14:42+0100	Eine Stunde vor UTC
2018-10-31T23:14:42+01	Eine Stunde vor UTC
2018-10-31T23:14:42-05:00	Fünf Stunden hinter UTC
2018-10-31T23:14:42-0500	Fünf Stunden hinter UTC
2018-10-31T23:14:42-05	Fünf Stunden hinter UTC

Beim Erstellen von Filtern aus Datum-Parametern überprüfen Dashboards die Datenquelle des Zielelements auf Zeitzoneninformationen. Wenn sie gefunden werden, werden Abfragen in dieser Zeitzone gesendet. Wenn keine Zeitzoneninformationen gefunden werden, wird vorausgesetzt, dass es sich bei der Zieldatenquelle um eine UTC-Datenquelle handelt. In beiden Fällen muss das Dashboard möglicherweise Eingabezeiten konvertieren, sodass diese denen des Ziels entsprechen.

Tipp:

Wenn ein Dashboard einen Datum-Parameter in einem Format empfängt, das es nicht erkennt, wird er zur Laufzeit ignoriert.

Beispiele

Die folgende Tabelle enthält Hinweise dazu, ob der Datum-Parameter für ein einzelnes Datum oder einen Datumsbereich konfiguriert wurde. Hier finden Sie Beispiele für UNIX Epoch- und Datumszeichenfolgen.

Parameter	Hinweis
?created=1541027682	Einzelwert. UNIX Epoch
?created=2018-10-31	Einzelwert. Datumszeichenfolge. Vollständiger Tag impliziert
?created=2018-10-31T23:14:42	Einzelwert. Datumszeichenfolge mit Uhrzeit. Lokale Zeitzone impliziert
?created=2018-10-31T23:14:42Z	Einzelwert. Datumszeichenfolge mit Uhrzeit. UTC

Beispiele für Sonderfälle

Datumswerte werden nicht immer festgelegt. Demzufolge unterstützen Datum-Parameter zwei Sonderfälle: ((null)) und ((notnull)). Diese Beschriftungen für Sonderfälle können in Workflows für einzelne Werte und in Workflows für Datumsbereiche verwendet werden.

Parameter	Hinweis
?created=((null))	Einzelner Datumswert oder Datumsbereich. Filter für NULL-Datumsangaben
?created=((notnull))	Einzelner Datumswert oder Datumsbereich. Filter für Datumsangaben, die NICHT NULL sind
?created=2018-10-31,((null))	Einzelner Datumswert Filter für 31. Oktober ODER für Datumsangaben, die NULL sind
?created=2018-10-31,2018-11-05,((null))	Datumsbereich. Filter für Datumsangaben in einem Bereich ODER für Datumsangaben, die NULL sind

Ein weiterer Sonderfall liegt vor, wenn ein Datum-Parameter einen Bereich erwartet, zur Laufzeit jedoch nur ein einzelner Wert bereitgestellt wird.

Parameter	Hinweis
?created=,2018-10-31	Offen links. Datumsangaben, die auf das aktuelle Datum fallen oder davor liegen, werden gefiltert
?created=2018-10-31,	Offen rechts. Datumsangaben, die auf das aktuelle Datum fallen oder dahinter liegen, werden gefiltert
?created=2018-10-31,((null))	Offen rechts. Filter für Datumsangaben, die auf das aktuelle Datum fallen oder dahinter liegen ODER für Datumsangaben, die NULL sind

Feature-Parameter

Feature-Parameter werden verwendet, um mindestens eine Feature-ID an ein Dashboard zu übergeben. Sie können herangezogen werden, um die Elemente von Dashboards zu filtern oder um Positionsaktionen – Zoomen, Schwenken, Pop-up anzeigen, Feature verfolgen und Flash – auf die Karten des Dashboards anzuwenden.

Beim Entwurf legen Dashboard-Autoren den Namen des Parameters fest und wählen eine Datenquelle aus. Das eindeutige ID-Feld der Datenquelle muss identifiziert werden. Wenn die Auswahl eines Feldes, das nicht eindeutige Werte enthält, nicht erfolgreich ist, führt dies zur Laufzeit zu unerwartetem Verhalten.

Tipp:

Enthält die ausgewählte Datenquelle Polygone, kann Sie verwendet werden, um räumliche Filter auf Zielelemente anzuwenden.

Stellen Sie sicher, dass Sie zur Laufzeit eine URL-Codierung für Feature-IDs durchführen, wenn die Werte im Ziel-Layer Zeichenfolgen sind. Mehrere Feature-IDs können übergeben werden, indem sie durch Kommas getrennt werden, z. B. ?asset=1240,1241,1242. Fügen Sie keine Leerstelle nach dem Komma ein.

Tipp:

Wenn ein Feature-Parameter für die Durchführung der Aktion "Feature verfolgen" konfiguriert ist, wird nur eine ID erwartet. Werden mehrere Werte übergeben, wird nur eines der Features verfolgt. Das verfolgte Feature gibt nicht unbedingt die Reihenfolge der übergebenen IDs wieder.

Beispiele

Parameter	Hinweis
?id=11033	Einzelner Wert
?id=11033,23034,34035	Mehrere Werte

Geometrieparameter

Es gibt zwei Typen von Geometrieparametern: Punkt und Ausdehnung. Wenn der Typ "Punkt" lautet, werden Geometrieparameter verwendet, um auf einer oder mehreren Karten des Dashboards auf eine Position zu zoomen, auf sie zu schwenken oder sie aufblinken zu lassen. Lautet der Typ "Ausdehnung", können mithilfe von Geometrieparametern die Ausdehnungen der Karte eines Dashboards festgelegt oder die anderen Elemente gefiltert werden. Beim Entwurf werden Dashboard-Autoren aufgefordert, den Namen des Parameters anzugeben und den Geometrietyp auszuwählen, bevor Aktionen konfiguriert werden.

Zur Laufzeit werden alle Geometrietypen als kommagetrennte WGS84-Werte (World Geodetic System 1984) übergeben. Das Format für Punktparameter lautet x,y. Das Format für Ausdehnungsparameter lautet leftX,leftY,rightX,rightY. In allen Fällen ist nach dem Komma keine Leerstelle vorhanden.

Beispiele

Parameter	Hinweis
?pt=-75.6971931,45.4215296	Geometrieparameter erwartet einen Punkt
?ext=-80.6,40.6,-70.7,47.7	Geometrieparameter erwartet eine Ausdehnung

Ändern des Gebietsschemas

Dashboards verfügen über einen integrierten URL-Parameter zum Umschalten der beim Anzeigen von Inhalten verwendeten Sprache, dem so genannten Gebietsschema. Fügen Sie den ?locale=<language code>-Parameter an das Ende der Dashboard-URL an. Dieser integrierte Parameter kann zusammen mit jedem vom Autor konfigurierten URL-Parameter verwendet werden, indem mehrere URL-Parameter durch ein kaufmännisches Und-Zeichen (&) getrennt werden.

In der folgenden Tabelle sind die unterstützten Sprachcodes aufgeführt:

Sprachcode	Sprache
ar	Arabisch
bs	Bosnisch
ca	Katalanisch
cs	Tschechisch
da	Dänisch
de	Deutsch
el	Griechisch
en	Englisch
es	Spanisch
et	Estnisch
fi	Finnisch
fr	Französisch
he	Hebräisch
hi	Hindi
hr	Kroatisch
hu	Ungarisch
id	Indonesisch
it	Italienisch
ja	Japanisch
ko	Koreanisch
lt	Litauisch
lv	Lettisch
nb	Norwegisches Bokmål
nl	Niederländisch
pl	Polnisch
pt-br	Portugiesisch (Brasilien)
pt-pt	Portugiesisch (Portugal)
ro	Rumänisch
ru	Russisch
sl	Slowenisch
sr	Serbisch
sv	Schwedisch
th	Thailändisch
tr	Türkisch
uk	Ukrainisch
vi	Vietnamesisch
zh-ch	Chinesisch (vereinfacht)
zh-hk	Chinesisch (traditionell, Hongkong)
zh-tw	Chinesisch (Traditionell – Taiwan)

Die folgende URL ist ein Beispiel für die Angabe des Gebietsschemas Französisch:

https://<yourPortalUrl>/apps/opsdashboard/index.html#/4f539791b2f1418cb5403891f1a7be50?locale=fr