Hierarchische Suche (Productivity Kit) – VertiGIS Support

Bietet eine systematische Möglichkeit, auf Daten zuzugreifen, sodass Benutzer leichter durch große Datensätze navigieren und bestimmte Informationen effizient finden können.

Dieser Workflow verwendet ein konfigurierbares Schema, um ein dynamisches Formular zu generieren und einen hierarchischen Satz von Feldern in einem Layer abzufragen. Unterstützt werden Zeichenfolgen und Zahlen. Das Formular kann Dropdown-Listen und Autovervollständigungsfelder enthalten. Wenn ein Feld ein Domänenfeld ist, wird dies automatisch erkannt.

Voraussetzungen

VertiGIS Studio Productivity Kit mit aktiver Service Subskription
Activity Pack Deployment
Das Einbinden von Activity Packs wird in diesem Abschnitt beschrieben.

Inputs

```
schema: object array
```
Das Schema für das Formular. Die folgenden Eigenschaften sind enthalten:
1. ```
layer: string
```
  Der Name des zu durchsuchenden Layers. Zu den unterstützten Layertypen gehören Feature-Layer, Kartenbild-Layer sowie eigenständige Tabellen. Sie können den Layer mit einer der folgenden Kennungen angeben:
  
  layer-map-id: Ein eindeutiger Identifier für den Layer innerhalb der Karte. Dies ist der empfohlene Identifier, da er in allen Studio-Web-Apps, die dieselbe Karte verwenden, einheitlich ist (siehe unten angeführtes Beispiel).
  
  layer-extension-id: Ein eindeutiger Identifier für die Erweiterung des Layers innerhalb der App.
2. ```
sublayer: string | number (optional)
```
  Der abzufragende Sublayer. Der Sublayer kann mittels folgenden Identifiern angegeben werden:
  
  sublayer-id (string): Ein eindeutiger Identifier für den Sublayer innerhalb des Layers.
  
  subtype-code (number): Der Subtype Code für einen SubtypeSublayer. Wenn es sich bei dem Layer um einern SubtypeGroupLayer handelt, benutzen Sie diesen Identifier um den Sublayer zu spezifizieren (siehe unten angeführtes Beispiel).
```
title: string (optional)
```
Der Titel des anzuzeigenden Formelements. Wenn dieses Feld leer bleibt, wird das Titelelement überhaupt nicht generiert.
```
showFilter: boolean (optional)
```
Gibt an, ob die Schaltfläche „Filter erstellen“ angezeigt wird oder nicht. Der Standardwert ist „true“.
```
fields: object array
```
Ein Array mit Definitionen für jedes Feld. Die folgenden Eigenschaften sind enthalten:
1. ```
hierarchy: number
```
  Reihenfolge der hierarchicschen Suche. Muss bei 0 beginnen und muss für jedes Feld um eins erhöht werden. Der Workflow funktioniert nicht richtig, wenn die Hierarchie nicht richtig konfiguriert ist.
2. ```
id: string
```
  Feldname des Layers.
3. ```
title: string
```
  Label für das Feld im Workflow.
4. ```
autoComplete: boolean
```
  Gibt an, ob es sich um eine Autovervollständigung (true) oder ein Dropdown-Menü (false) handelt. Die Autovervollständigung verwendet die Sprachressource @defaultPromptText für die Eingabeaufforderung.
5. ```
minLength: number
```
  Die Anzahl der Zeichen für eine automatische Vervollständigung, um Vorschläge zu starten. Der Standardwert ist 3.
6. ```
type: string | integer (optional)
```
  Feldtyp des ArcGIS-Layers– Derzeit werden „string“ und „integer“ unterstützt. Es wird dringend empfohlen, den Typ korrekt einzustellen. Insbesondere wenn die Werte aus einer codierten Wertesammlung stammen und vom Typ Integer sind. Die Werte können in der SQL-Abfrage falsch ausgewertet werden, was zu einem Fehler führt und die Abfrage nicht verarbeiten kann. Beispiel: intValue = '5' statt intValue = 5.
7. ```
required: boolean 
```
  Gibt an, ob das Feld einen Wert enthalten muss, damit der Workflow abgeschlossen werden kann. Wenn ein Feld erforderlich ist, müssen auch alle oben genannten übergeordneten Elemente erforderlich sein. Wenn ein Feld nicht erforderlich ist, ignorieren alle untergeordneten Elemente diese Konfiguration und sind nicht erforderlich.

Verhalten

Das Formular wird für jedes Feld dynamisch ausgefüllt. Jedem Feld wird ein dynamisches "Change" Event
hinzugefügt.
Immer wenn sich eine Auswahl in einer Liste ändert, wird das nachfolgende Element aktiviert und
automatisch ausgefüllt.
Wenn die übergeordneten Elemente eines bereits ausgewählten Felds geändert werden, werden alle untergeordneten Elemente zurückgesetzt.
Nach dem Klick auf „Suchen“ wird die entsprechende Abfrage ausgelöst.

Konfigurationsbeispiel

Konfiguration mit Layer IDs:
Konfiguration mit Domain Values:

URI im JSON der Web-App finden

Um die URI eines Layers oder Sublayers im JSON-Format der VertiGIS Studio Web-App zu finden, sehen Sie sich das folgende Beispiel eines Layer-Extension- und Sublayer-Extension-Objekts an. Sie können das JSON-Format der Web-App über den VertiGIS Item Manager oder im Web-Designer-Editor mit Strg+Umschalt+E aufrufen.

Beispiel: Layer-Extension-Objekt

id: Eindeutiger Identifier für die Layer-Extension.
sublayerExtensions: Array von Referenzen auf Sublayer-Extension-Objekte.
layer: Enthält die Referenz zum Layer, einschließlich seiner eindeutigen ID und title.
- id: Dies ist die Layer-Map-ID, ein eindeutiger Identifier für den Layer innerhalb der Karte. Dies ist der empfohlene Identifier, da er in allen Studio Web-Apps, die dieselbe Karte verwenden, einheitlich ist.
- title: Name oder Titel des Layers.
layerType: Gibt den Layertyp an. Dies können beispielsweise ArcGISFeatureLayer, ArcGISMapServiceLayer, SubtypeGroupLayer usw. sein.

Beispiel: Sublayer-Extension-Objekt

id: Eindeutigr Identifier für die Sublayer-Erweiterung. Diese ID sollte nicht zur Referenzierung des Sublayers verwendet werden. Verwenden Sie stattdessen die im Sublayer-Objekt unten angegebene ID.
sublayer: Enthält den Verweis auf den Sublayer, einschließlich seiner eindeutigen ID und title.
- id: Dies ist der Sublayer-Code, ein eindeutiger Identifier für den Sublayer innerhalb des Layers. Dies ist der empfohlene Identifier, da er in allen Studio Web-Apps, die dieselbe Karte verwenden, einheitlich ist.
- title: Name oder Titel des Sublayers.
$sublayerType: Gibt den Typ des Sublayers an. Beispielsweise kann dies „ArcGISMapServiceSublayer“, „SubtypeSublayer“ usw. sein.

Verknüpfung mit