Skip to content

App-Einstellungen

Die App-Einstellungen passen das Attributformular und die Benennung von Objekten an: welche Werte leere Eigenschaften neuer Objekte erhalten, wie ein Feld beschriftet ist, auf welchem Reiter es steht und unter welchem Namen ein Objekt im Featurebaum und in Auswahllisten erscheint. Dazu kommen allgemeine Einstellungen wie das Anwendungsschema neuer Pläne.

Geöffnet werden sie über den Button App-Einstellungen neben Plugin-Einstellungen im Panel, siehe Einstellungen. Gespeichert werden sie in der XMAS-App, nicht in QGIS: Sie gelten also auf jedem Rechner, auf dem sich derselbe Nutzer anmeldet.

Konfigurationsebenen

Einstellungen und Regeln gibt es auf drei Ebenen:

Ebene Bearbeitet von Wo
Eigene jedem Nutzer mit der Rolle editor oder admin, für sich selbst App-Einstellungen
Organisation den Nutzern mit der Rolle admin der Organisation App-Einstellungen
Server dem Betreiber der App in den App-Einstellungen nur lesbar

Die eigene Ebene geht der Organisation vor, diese dem Server. Nutzer ohne Organisation (externe Eingeladene) haben nur die eigene Ebene und die des Servers. Ebenen, die jemand nicht bearbeiten darf, zeigt die Seite ausgegraut und schreibgeschützt an, damit erkennbar ist, was von dort gilt; mit der Rolle viewer sind das alle.

Welche Regel gilt

Die Regeln einer Art werden in der Reihenfolge Eigene, Organisation, Server und innerhalb einer Ebene von oben nach unten geprüft; es gilt die erste passende. Eine höhere Ebene überdeckt so eine Regel einer niedrigeren, löscht sie aber nicht: Alles, wofür sie keine Regel hat, fällt auf die Ebenen darunter durch. Bei Vorlagen gilt das je Eigenschaft.

Ist eine Ebene ungültig, wird sie als Ganzes übergangen; die übrigen Ebenen gelten weiter.

Aufbau der Seite

  • Reiter im Kopf der Seite: Allgemein, Objektarten und Formular. Objektarten und Formular haben je Regelart einen Unterreiter: Anzeigename bzw. Vorlagen, Beschriftungen und Reiter. Wofür ein Reiter da ist, steht oben auf der Seite, eine Kurzfassung im Tooltip.
  • Ebenen: Jede Regelart hat links einen senkrechten Reiter je Ebene, in der Reihenfolge, in der sie geprüft werden. Die Zahl am Reiter nennt die Regeln der Ebene, die greifen können, die also keine frühere Regel verdeckt.
  • Regelliste: eine Zeile je Regel mit dem, was sie setzt, und darunter, wofür sie gilt (Familien · bei Vorlagen Versionen · Klassen · bei Formularregeln Attribute, Typen und Stereotypen).
  • Welche Regel greift? unter der Liste öffnet den Regeltester.
  • oben rechts öffnet Im- und Export.
  • Speichern und Zurücksetzen in der Fußleiste, siehe Speichern.

Allgemein

Jede Einstellung hat eine Auswahl je Ebene. Standard setzt den Standardwert und überdeckt damit die Ebenen darunter; eine geleerte Auswahl setzt nichts, dann gilt die nächste Ebene. Die Auswahl, die gilt, ist mit aktiv markiert. Setzt keine Ebene einen Wert, gilt der Standard.

Einstellung Wirkung Standard
Anwendungsschema neuer Pläne In diesem Anwendungsschema legt der Planmanager neue Pläne an; die Auswahl der Planarten richtet sich danach. Ein geöffneter Planmanager übernimmt eine gespeicherte Änderung ohne Neuladen. Pläne anderer Anwendungsschemas können weiterhin geladen werden. die neueste unterstützte XPlanung-Version; die mitgelieferte Server-Ebene setzt XPLAN 6.1
Schriftinhalt immer erzeugen Ob das Formular den schriftinhalt eines Präsentationsobjekts aus den gewählten Werten zusammensetzt, auch wenn die passende Stilregel keinen Text vorgibt. Gilt ebenso für die Layer-Aktion Darstellungsattribute aktualisieren. Ja

Regeln

Wofür eine Regel gilt

Eine Regel wählt über Listen aus:

Auswahl Bedeutung
Familien Anwendungsschema-Familien xplan, xtrasse, xwp, jeweils mit allen Versionen, auch künftigen. Leer: alle Familien.
Versionen nur bei Vorlagen: Versionen je Familie, z.B. xplan 5.4. Eine Familie, für die keine Version gewählt ist, gilt in allen ihren Versionen. Leer: alle Versionen, auch künftige.
Klassen Objektarten und Datentypen, z.B. BP_Plan oder XP_Gemeinde; bei Vorlagen nur Objektarten. Leer: alle Klassen.
Attribute Feldnamen (nur Beschriftungen und Reiter)
Typen Typen, die ein Feld annehmen kann, z.B. CharacterString (nur Beschriftungen und Reiter)
Stereotypen Association, BasicType, Codelist, DataType, Enumeration, Geometry, Identifier, Measure, ObjectType, Temporal (nur Beschriftungen und Reiter)

Beschriftungs- und Reiterregeln brauchen mindestens eine Angabe unter Attribute, Typen oder Stereotypen; ein Feld passt, wenn eine davon zutrifft. Namen werden exakt verglichen. Die Auswahllisten bieten nur an, was die gewählten Familien und Klassen haben. Ein Name, den das Datenmodell nicht kennt, ist kein Fehler: Die Regel passt dann nur nie.

Regeln bearbeiten

  • Regel hinzufügen oben in der Liste einer bearbeitbaren Ebene legt eine neue Regel an. Vorlagen entstehen dagegen im Attributformular, siehe Vorlage anlegen.
  • Ein Klick auf eine Zeile öffnet die Regel. Übernehmen prüft sie und markiert, was fehlt oder falsch ist; Abbrechen verwirft die Änderung. Schreibgeschützte Regeln haben nur Schließen.
  • Die Reihenfolge ändert sich durch Ziehen am Griff oder über das Menü (Nach oben, Nach unten); dort steht auch Löschen.
  • Der Schalter einer Zeile schaltet die Regel ein und aus, siehe Inaktive Regeln.
  • Kopieren nach … in einer geöffneten Regel öffnet eine Kopie als neue Regel in einer bearbeitbaren Ebene, auch der eigenen. So lässt sich eine Regel der Organisation oder des Servers in der eigenen Ebene abwandeln und damit überdecken.

Eine Ebene fasst höchstens 100 Regeln, eine Vorlage höchstens 200 Eigenschaften. Änderungen gelten erst nach dem Speichern.

Inaktive Regeln

Eine ausgeschaltete Regel passt wie eine eingeschaltete, setzt aber nichts, und überdeckt damit die Regeln nach ihr; ihren Wert behält sie für das Wiedereinschalten. So lässt sich eine Regel einer niedrigeren Ebene unwirksam machen: in die eigene Ebene kopieren und dort ausschalten.

Regelart Wirkung einer inaktiven Regel
Anzeigename Das Objekt wird mit dem Ende seiner ID angezeigt.
Vorlagen Ihre Eigenschaften bleiben leer.
Beschriftungen Das Feld zeigt seinen Namen.
Reiter Das Feld bleibt unter Weitere Attribute.

Markierungen

  • Verdeckt von …: Eine frühere Regel greift immer zuerst, diese kommt nie zum Zug.
  • Ungültig: setzt die ganze Ebene außer Kraft: Die Regel passt nicht zum Datenmodell. Solange es sie gibt, wird die ganze Ebene übergangen.
  • Greift nicht: die Ebene ist ungültig: Die Regel selbst ist in Ordnung, aber eine andere Regel oder Einstellung der Ebene, ggf. auf einem anderen Reiter, ist ungültig.

Regeltester

Welche Regel greift? zeigt für eine gewählte Familie und Klasse, je nach Regelart auch ein Attribut oder eine Version, welche Regel gilt:

  • Beschriftungen und Reiter: die Regel, die das Attribut bestimmt, oder Keine Regel greift.
  • Anzeigename: alle passenden Regeln in der Reihenfolge, in der sie durchfallen, zuletzt das Ende der ID. Regeln, deren Eigenschaft die Klasse nicht hat, fehlen.
  • Vorlagen: je Eigenschaft die Regel, die sie setzt oder als inaktive Regel leer lässt (nicht vorbelegt), und die Regeln, deren Wert nicht zur Version passt (passt nicht).

Inaktive Regeln sind mit (inaktiv) gekennzeichnet, Regeln ungültiger Ebenen bleiben außen vor. Zurücksetzen leert die Auswahl.

Anzeigename

Unter Objektarten → Anzeigename wird festgelegt, welche Eigenschaft ein Objekt benennt: im Featurebaum sowie im Attributformular in den Auswahllisten der Relationen (nach der Objektart) und in der Spalte Bezeichnung ihrer Tabelle.

Es gilt die erste passende Regel, deren Eigenschaft beim Objekt gesetzt ist; ist sie leer, wird die nächste Regel versucht. Greift keine, erscheint das Ende der ID – die vorderen Teile der IDs sind ein Zeitstempel und bei gemeinsam angelegten Objekten fast gleich. Die Namen werden natürlich sortiert (2 vor 10). Der Featurebaum lädt neu, sobald Änderungen an Objekten seines Plans gespeichert werden.

Die mitgelieferte Server-Ebene benennt in XPlanung die Bereiche (BP_Bereich … SO_Bereich) nach nummer, die Pläne nach name und die Text- und Begründungsabschnitte nach schluessel.

Vorlagen

Unter Formular → Vorlagen stehen die Werte, die das Formular in leere Eigenschaften neuer Objekte einträgt – solcher, die noch nicht gespeichert sind, also digitalisiert oder aus einem anderen Layer eingefügt. Ein gespeichertes Objekt bleibt beim Öffnen unverändert, auch wenn ihm eine Eigenschaft fehlt. Die Datenmodelle selbst belegen nichts vor: Ein neues Objekt enthält nur, was eine Vorlage oder der Nutzer einträgt. In der Mehrfachbearbeitung bleibt ein Attribut, in dem sich die Auswahl unterscheidet, dem Karussell überlassen.

Je Eigenschaft gilt die erste passende Vorlage, die sie enthält und deren Wert zur Version des Anwendungsschemas passt. Vorlagen ergänzen sich so: etwa die gemeinde aus einer Vorlage der Organisation und die planArt aus einer eigenen. Die Datenmodelle unterscheiden sich zwischen den Versionen – zweckbestimmung ist bis XPlanung 5.4 eine Liste von Codes, ab 6.0 eine Liste von Datentyp-Objekten. Ein Wert, der nicht zur Version passt, wird deshalb übergangen, und es greift die nächste Vorlage, z.B. eine für diese Version angelegte. Fehlen einem Wert nur Pflichtangaben, gilt er trotzdem; das Formular zeigt sie dann unausgefüllt.

Vorlage anlegen

  1. Im Attributformular die gewünschten Werte eintragen.
  2. Als Vorlage speichern neben dem Namen der Objektart im Kopf des Formulars klicken (nur mit der Rolle editor oder admin).
  3. Im Dialog sind alle belegten Eigenschaften angehakt; was nicht in die Vorlage soll, abwählen. id, Geometrie und Relationen bietet der Dialog nicht an, da sie Objekte dieses Plans benennen. Angezeigt, aber nicht wählbar sind Eigenschaften mit dem Hinweis
    • unvollständig: Einem Wert fehlen Pflichtangaben, z.B. einem halb ausgefüllten Datentyp-Objekt.
    • ungültig: Der Wert ist nicht gültig.
    • verweist auf Plandokument: Der Wert nennt ein Dokument dieses Plans.
  4. Unter den Eigenschaften steht, für welche Versionen die Vorlage gelten wird: Gilt für alle Versionen, wenn die gewählten Werte zu jeder Version der Familie passen (auch zu künftigen), sonst z.B. Gilt für xplan 5.4, 6.0.
  5. Speichern: Die Vorlage wird sofort als erste Vorlage der eigenen Ebene gespeichert und gilt für die Objektart des Formulars.

Eine Vorlage der Organisation entsteht, indem ein Nutzer mit der Rolle admin eine eigene Vorlage mit Kopieren nach … in die Ebene Organisation kopiert und speichert.

Vorlage bearbeiten

In den App-Einstellungen lassen sich bei einer Vorlage Familien, Versionen und Objektarten ändern; sie lässt sich ein- und ausschalten, verschieben, kopieren und löschen. Ihre Werte sind dort nur einsehbar: Geändert werden sie, indem im Formular eine neue Vorlage angelegt wird.

Jede Eigenschaft ist eine aufklappbare Zeile. Ihre Hinweise zeigen, wie weit sie greift, und ändern sich mit der Auswahl:

  • eine durchgestrichene Version, z.B. xplan 6.0: In dieser Version passt der Wert zu keiner gewählten Objektart und bewirkt nichts.
  • ohne SO_Gebiet bzw. ohne 2 Klassen: Diese Objektarten übergehen den Wert. Sind Objektarten gewählt, sind das die, denen die Eigenschaft fehlt oder deren Typ der Wert nicht entspricht; ohne gewählte Objektarten nur die letzteren.
  • für BRA_BreitbandtrasseAbschnitt bzw. für 4 Klassen: Bei einer Vorlage ohne gewählte Objektarten die Objektarten, die den Wert übernehmen – das können wenige sein, auch aus einer unerwarteten Familie.

Aufgeklappt zeigt die Zeile den Wert, diese Hinweise im Klartext und unter Gilt für diese Klassen die übernehmenden Objektarten je Version.

Beschriftungen

Unter Formular → Beschriftungen wird festgelegt, was das Formular statt eines Feldnamens anzeigt, z.B. Name des Plans für name von BP_Plan. Es gilt die erste passende Regel.

Reiter

Unter Formular → Reiter werden die Felder des Formulars auf Reiter verteilt. Ein Feld kommt auf den Reiter der ersten passenden Regel; die Reiter erscheinen in der Reihenfolge der Regeln. Regeln gleichen Namens, auch aus verschiedenen Ebenen, füllen einen gemeinsamen Reiter. Felder ohne Reiter stehen unter Weitere Attribute.

Die mitgelieferte Server-Ebene legt für XPlanung diese Reiter an:

Reiter Stereotypen
Basisattribute BasicType, Codelist, DataType, Enumeration, Identifier, Measure
Datums-/Zeitangaben Temporal
Referenzen Association

Im- und Export

Im- und Export oben rechts öffnet einen Dialog:

  • Exportieren lädt eine Ebene (Eigene, Organisation, Server) oder alle zusammen (Zusammengeführt) als JSON-Datei herunter, z.B. anpassungen_eigene.json. Exportiert wird der gespeicherte Stand; nicht gespeicherte Änderungen fehlen, worauf die Seite hinweist. Der zusammengeführte Export enthält die Regeln aller Ebenen in der Reihenfolge, in der sie geprüft werden, und je Einstellung den Wert, der gilt. Als einzige Ebene importiert, wirkt er wie alle Ebenen zusammen: eine Momentaufnahme.
  • Importieren (nur mit einer bearbeitbaren Ebene): unter In Konfigurationsebene die Ziel-Ebene wählen und eine JSON-Datei von höchstens 1 MB hochladen. Die Datei wird streng geprüft; eine fehlerhafte ändert nichts. Sie ersetzt die Ebene im Editor, auch nicht Gespeichertes, und gespeichert wird erst mit Speichern. Vorlagen verlieren dabei, was keine Vorlage enthalten darf (IDs, Geometrien, Referenzen, Plandokumente und unvollständige Werte); eine Meldung nennt es.

Speichern

Speichern ist nur aktiv, solange es ungespeicherte Änderungen gibt, Zurücksetzen außerdem, wenn die Seite einen anderswo gespeicherten Stand nicht übernommen hat. Speichern speichert jede geänderte Ebene für sich; Zurücksetzen verwirft die Änderungen und lädt die Ebenen neu.

Hat jemand anderes eine Ebene seit dem Laden gespeichert, wird das Speichern dieser Ebene abgelehnt, statt seine Änderungen zu überschreiben: Die Meldung „inzwischen an anderer Stelle geändert“ verweist auf Zurücksetzen, das den aktuellen Stand lädt. Die eigenen Änderungen bleiben bis dahin sichtbar, um sie danach erneut einzugeben. Ohne ungespeicherte Änderungen übernimmt eine geöffnete Seite eine anderswo gespeicherte Ebene von selbst, etwa eine eben im Formular gespeicherte Vorlage.

Ein geöffnetes Attributformular arbeitet mit dem Stand, mit dem es aufgebaut wurde; gespeicherte Änderungen gelten ab dem nächsten Aufbau des Formulars.