ai-assist Benutzerhandbuch

Global

Der Reiter Global bündelt Parameter und Glossar. Beide Sichten wirken serviceübergreifend und beeinflussen Fragen, Regeln, Erklärungen und Tests.

Was Sie hier erledigen

Global-Maske in der Parameteransicht mit Aktionszeile, Suche, Export, Parameterliste, Verwendungen und Detailformular 1 2 3 4 5
Abb. G-01: Globale Parameter mit Listenexport, Detailpflege und Verwendungsprüfung.
MarkerElementBedeutung
1Parameter-SichtZeigt wiederverwendbare fachliche Werte.
2ParameterlisteFiltert, markiert und öffnet Parameter über ihre kanonische ID.
3DetailformularPflegt Datentyp, Beschreibung, Alias und Optionen.
4VerwendungenZeigt, wo ein Parameter in Voraussetzungen genutzt wird.
5ExportLädt markierte oder aktuell sichtbare Parameter als JSON, CSV oder Markdown.

Abb. G-01 zeigt die Parameteransicht vor der Erklärung der Global-Aufgaben. Links wählen Sie Parameter, rechts pflegen Sie Datentyp, Beschreibung, Aliase und Verwendungen.

Aufbau

Parameter und Glossar exportieren

  1. Wählen Sie Sammlung und Service oder lassen Sie Alle Services aktiv.
  2. Grenzen Sie die Liste bei Bedarf über die Suche ein.
  3. Markieren Sie gezielt Einträge, wenn nur diese exportiert werden sollen.
  4. Wählen Sie rechts neben der Suche JSON, CSV oder Markdown.

Wichtig: Markierte Einträge haben immer Vorrang. Ist nichts markiert, enthält die Datei alle aktuell sichtbaren Treffer. So können Sie entweder eine bewusste Auswahl oder das aktuelle Filterergebnis sichern.

Arbeitsablauf: Parameter bereinigen

1 Suchen Ähnliche IDs, Aliase und Beschreibungen vergleichen.
2 Bewerten Datentyp, Werte und echte Verwendung prüfen.
3 Zusammenführen Nur fachlich identische Parameter mergen und testen.
  1. Suchen Sie nach ähnlichen Parameterbezeichnungen.
  2. Prüfen Sie Datentyp, Beschreibung, kanonische Werte und Aliase.
  3. Markieren Sie die zusammengehörigen Parameter in der Liste und nutzen Sie Merge nur, wenn die fachliche Bedeutung wirklich identisch ist.
  4. Prüfen Sie danach die Verwendung in Fakten.
  5. Führen Sie einen Testdialog aus.

Referenz: Parameterfelder

FeldBedeutung
Bezeichnungfachliche ID des Parameters
DatentypText, Ja/Nein, Ganzzahl, Zahl, Datum oder Liste
Beschreibungfachliche Erklärung für Redaktion und Test
Kanonische Werteerlaubte Sollwerte für Auswertung
Aliasealternative Formulierungen, die zugeordnet werden können

Beispiel: Listenparameter

Für einen Parameter wohnsitz_region mit Datentyp Liste können die kanonischen Werte zeilenweise gepflegt werden:

salzburg
oberösterreich
tirol

Aliase werden je Kanon geschrieben, zum Beispiel salzburg = sbg, land salzburg. Dadurch kann der Chat unterschiedliche Bürger:innenformulierungen auf denselben fachlichen Wert abbilden.

Beispiel: Format der Parameter-ID

Die Bezeichnung wird automatisch in Kleinbuchstaben normalisiert; Punkte und Leerzeichen werden zu Unterstrichen. Gültig sind nur Kleinbuchstaben, Ziffern und Unterstriche, etwa brutto_einkommen oder anzahl_kinder.

Referenz: Glossar

Global-Maske in der Glossaransicht mit Aktionszeile, Suche, Export, Begriffsliste, Erklärung und Quellenangabe 1 2 3 4 5
Abb. G-02: Globales Glossar mit Listenexport und fachlichen Begriffen.
MarkerElementBedeutung
1Glossar-SichtWechselt von Parametern zu Begriffen.
2BegriffslisteSucht, markiert und wählt den zu pflegenden Glossareintrag.
3ErklärungBeschreibt den Begriff für Chat und Redaktion.
4Status und AktionenSteuert Aktivierung, Speichern, Entfernen und gesammelte Statusänderung.
5ExportLädt markierte oder aktuell sichtbare Glossarbegriffe als JSON, CSV oder Markdown.

Abb. G-02 steht vor der Glossar-Erklärung. Die Ansicht zeigt Listenexport, Begriffsliste, Erklärung, Servicebezug und Statusaktionen.

Nutzen Sie die Kopfcheckbox und das Status-Select nur nach enger Suche oder bewusst gewähltem Servicefilter. So vermeiden Sie, dass fachlich ungeprüfte Glossarbegriffe versehentlich in den Chat-Kontext gelangen.

Häufige Probleme

Parameter-Suchoverlay in der Voraussetzungen-Maske mit Suche, Trefferliste und Zuordnungsaktionen 1 2 3 4
Abb. X-02: Parameter-Suchoverlay zum Verknüpfen von Voraussetzungen.
MarkerElementBedeutung
1Overlay-TitelZeigt, dass die Parametersuche geöffnet ist.
2SuchfeldFindet Parameter über ID, Alias oder Beschreibung.
3TrefferlisteVergleicht mögliche Parameterkandidaten.
4ÜbernehmenOrdnet den ausgewählten Parameter der Voraussetzung zu.

Abb. X-02 zeigt, wo Parameter bei Voraussetzungen ausgewählt werden. Wenn ähnliche Parameter zu Problemen führen, prüfen Sie zuerst diese Such- und Zuordnungssituation.

Querverweise