Im oberen rechten Bildschirmbereich ist der Speichern-Button zu finden. Dieser startet den Download der Profilierungsdatei im .zip-Format. Der Button ist ausgegraut, wenn Validierungsfehler vorliegen. Ein Download ist erst möglichen, wenn die Validierungsfehler behoben wurden. Das Icon links neben dem Speichernbutton liefert weitere Informationen zum Validierungsergebnis.

Über das Icon links neben dem Speichern-Button, im oberen rechten Bildschrimbereich, lassen sich mögliche Profilierungsfehler einsehen. Bei einem grünen Haken liegen keine Validierungsfehler vor. Wird ein rotes !-Icon angezeigt so liegen Validierungsfehler vor und ein Speichern der Profilierung ist erst nach Behebung der Fehler wieder möglich. Per Klick auf das Icon lassen sich die Validierungsergebnisse anzeigen. Die aufgelisteten Fehler sind klickbar und ermöglichen eine Navigation dirket zu den betreffenden Feldern.

Neben dem Speichern-Button im oberen rechten Bildschirmbereich gibt es die vor- und zurück-Pfeile. Sie ermöglichen ein rückgängig machen der letzten Änderungen. Sie funktionieren auch Bereichsübergreifend. Das bedeutet, das ich eine Eingabe im Bereich Datentypen wiederrufen kann, obwohl ich gerade in den Bereich Nachrichtenstrukturen gesprungen bin.

In der hell blauen Navigationszeile wird der Navigationspfad der Anwendung angezeigt. Dieser ist klickbar und ermöglicht eine Navigation zu anderen Teilen der Anwendung.

Die Eingaben in viele Felder der Anwendung werden von der Anwendung validiert. Sollten Eingaben nicht mit dem erwarteten Wert übereinstimmen, so wird unterhalb des Feldes mit Roter Schrift ein Hinweis gegeben. Gleichzeitig wird der Speichernbuton ausgegraut und der Fehler wird über den Validierungsbutton einsehbar.

In der Anwendung werden i- und ?-Icons verwendet. Indem Sie mit der Maus über das Icon fahren erhalten Sie weitere Informationen zum Vorgang neben dem das Icon gesetzt ist.

Per Klick auf das Autokorrektur-Icon können fehlerhafte Einträge automatisch berichtigt werden.

Die Profilierung eines Standards kann aus methodischer Sicht vereinfacht als eine Einschränkung der Gestaltungsmöglichkeiten bei der Erzeugung von Nachrichten verstanden werden. Vorgaben zur Gestaltung von Nachrichten werden durch einen (XÖV-)Standard in Form von Beschreibungen prozessualer oder semantischer Aspekte (Spezifikationsdokument), expliziten Geschäftsregeln (Spezifikationsdokument und Schematron) und technischer Ausgestaltung (XML Schemata und Codelisten) gegeben.

Vereinfacht formuliert kann eine Profilierung die Freiheitsgrade bei der Nachrichtenerzeugung in allen genannten Bereichen einschränken. Einzige Bedingung dabei ist, dass alle zum jeweiligen Profil konformen Nachrichten gleichzeitig konform zu den Vorgaben des zugrundeliegenden Standards sind.

Um einen Standard mit Hilfe der XÖV-Suite zu profilieren muss zunächst ein Projekt geöffnet werden. Sie haben die Möglichkeit ein neues Profil zu erstellen oder ein bereits vorhandenes Profil in die Anwendung zu laden um es weiter zu bearbeiten.

Mit der Auswahl der Option "Neues Profil erstellen" auf der Startseite der Anwendung (suite.xoev.de/), haben Sie die Möglichkeit ein neues Profil anzulegen. Es öffnet sich eine Eingabemaske "Profilierungsprojekt anlegen".

Mit der Auswahl der Option "Profil laden" auf der Startseite der Anwendung (suite.xoev.de/), haben Sie die Möglichkeit ein bereits vorhandenes Profil von Ihrem Gerät in die Anwendung zu laden. Es öffnet sich ein Dialogfenster "Profilierungsprojekt öffnen".

Hier können Sie die Metadaten eines Projektes einsehen und bearbeiten. Eine Änderung des ausgewählten Standards nach der initialen Anlage des Profilierungsprojekts, ist in der XÖV-Suite nicht vorgesehen.

In diesem Bereich können nutzerspezifische Eigenschaften definiert werden, die im weiteren Verlauf der Anwendung Elementen zugeordnet werden können. Sie dienen als Ergänzug zu den bereits vorhandenen Attributen aus dem Standard. Nach dem befüllen der Eingabefelder, kann die Eigenschaft über das + Icon hinzugefügt werden. Über das Stift-Icon kann die Eigenschaft editiert werden. Durch betätigen des Mülleimer-Icons wird die Eigenschaft entfernt.

Über den Navigationsbereich auf der linken Bildschirmseite können Sie Datentypen auswählen. Das Suchfeld im oberen Bereich erleichtert die Ergebnissuche. Der Bearbeitungsbereich auf der rechten Seite präsentiert den Standarddatentyp und die Einschränkung des ausgewählten Datentyps.

Über die Verlinkung auf den Standarddatentypen im Bearbeitungsbereich, auf der rechten Seite, lässt sich die Definition des Standards im read-only-Modus anzeigen.

Unter dem Punkt "Einschränkungen" lassen sich neue Datentypprofile des ausgewählten Standardtypen anzeigen und anlegen. Durch die Vergabe eines Namens, einer Beschreibung, und dem Klick auf das Disketten-Icon, wird eine neue Einschränkung eines Datentyps angelegt.

Einschränkungen eines Datentyps können über das Stift-Icon bearbeitet und über das Mülleimer-Icon gelöscht werden. Bei Klick auf das Stift-Icon öffnet sich der Bearbeitungsbereich der Einschränkung. Hier, im Wurzelknoten der Navigation, können der Name, die Beschreibung, sowie der Umsetzungshinweis der Einschränkung eingesehen und editiert werden. Vorhandene Informationen aus dem Standard werden auf der rechten Seite abgebildet. Über die abgebildete Tabelle lässt sich die Einschränkung einer Nachricht zuweisen. Die Tabelle verfügt über eine eigene Such- und Filterfunktion, welche das finden von Einträgen erleichtern soll. In den aufgelisteten Einträgen der Tabelle sind sowohl der Elementname als auch der Sytaxpfad klickbar. Sie dienen als Sprungmarke in den entsprechenden Bereich der Anwendung.

Über die Baumnavigation im linken Bildschirmbereich lässt sich durch die Elemente des Datentypprofils navigieren. Die Suche im oberen Bereich erleichtert das Finden von Elementen. Im unteren Bereich der Navigation lassen sich Filter für den Navigationsbaum definieren. Der Toggle "Profilierte Elemente anzeigen" filtert den Navigationsbaum nach Elementen, die profiliert wurden. Alle nicht profilierten Elemente werden ausgeblendet. Per Klick auf die Elemente im Baum, öffnet sich der Bearbeitungsbereich im rechten Bildschirmbereich.

Neben dem Elementnamen ganz oben, wird der Datentyp in blau angezeigt. Per Klick kann hier direkt in den Datentypen gesprungen werden. Wurde eine Profilierung eines Standarddatentyps vorgenommen, so kann dieser hier entsprechend über das Stift-Icon neben dem Datentypen ausgewählt werden. Es öffnet sich ein entsprechnder Dropdown zur Auswahl.

Im Bearbeitungsbereich, auf der rechten Bildschirmseite der Anwendung, lassen sich die Attribute der Datentypprofile entsprechend befüllen. Die Angaben aus dem Standard sind am rechten Bildschirmrand dargestellt.

Folgende Informationen können über die Eingabefelder "Beschreibung" und "Umsetzungshinweis" abgebildet werden:

Im Bereich Datentypen befindet sich unterhalb des Speichern-Buttons Ein Zurücksetzen-Icon. Ist ein Datentypprofil ausgewählt und wurden Profilierungen vorgenommen, so können alle vorgenommenen Änderungen am Element durch Klick auf diesen Button gleichzeitig zurückgesetzt werden.

Die im Bereich "Projekt" der Anwendung definierten eigenen Eigenschaften können hier eingebunden werden. Sie dienen als Ergänzug zu den bereits vorhandenen Attributen aus dem Standard. Nach dem befüllen der Eingabefelder, kann die Eigenschaft über das + Icon hinzugefügt werden. Über das Stift-Icon kann die Eigenschaft editiert werden. Durch betätigen des Mülleimer-Icons wird die Eigenschaft entfernt.

Datentypprofile vom Typ CodeType lassen sich ähnlich wie andere Datentypen in der Anwendung profilieren. Sie sind durch ein graues Icon in der Navigation gekennzeichnet. Zusätzlich bieten sie weitere Profilierungsmöglichkeiten.

Folgende Informationen können über die Eingaben zu den Metadaten einer Codeliste angegeben werden:

Rekursive Datentypprofile sind durch ein Unendlich-Icon in der Baumnavigation gekennzeichnet.

Rekursive Elemente lassen sich zusätzlich in ihrer Rekursionstiefe einschränken. Durch die Eingabe einer Zahl, kann die Rekursionstiefe festgelegt werden. Darüber hinaus ist es möglich eine Beschreibung der Rekursionstiefe anzugeben.

Simple Datentypprofile haben keine aufklappbare Navigation auf der linken Bildschirmseite. Die Profilierungsmöglichkeiten sind deutlich eingeschränkter als bei komplexen Datentypen oder Datentypen vom Typ Codeliste.

Alle Datentypen, die weder simple, noch Codelisten, noch rekursive Datentypen sind, werden auch als komplexe Datentypen bezeichnet. Dies gilt für die überwiegende Mehrheit der Datentypen.

Über die Navigation auf der linken Bildschirmseite lässt sich durch die Nachrichtenelemente navigieren. Die Suche im oberen Bereich erleichtert das Finden von Elementen. Im unteren Bereich der Navigation lassen sich Filter für den Navigationsbaum definieren. Der Toggle "Profilierte Elemente anzeigen" Filtert den Navigationsbaum nach Elementen, die profiliert wurden. Alle nicht profilierten Elemente werden ausgeblendet. Per Klick auf die Elemente im Baum, öffnet sich der Bearbeitungsbereich im rechten Bildschirmbereich.

Neben dem Elementnamen ganz oben, wird der Datentyp in blau angezeigt. Per Klick kann hier direkt in den Datentypen gesprungen werden. Ist für ein Nachrichtenelement ein Datentypprofil angelegt, so ist dies über das Stift-Icon über der Beschreibung zu erkennen. Bei Klick auf das Stift-Icon öffnet sich ein Dropdown und vorhandene Datentypprofilierungen können zugewiesen werden.

Dies wird in der Navigation durch ein ausgrauen des Teilbaums und ein kleines Schloss-Icon visualisiert. Die Kindknoten sind jedoch in der Leseansicht einsehbar.

Im Bereich Nachrichtenstrukturen befindet sich unterhalb des Speichern-Buttons ein Zurücksetzen-Icon. Ist ein Nachrichtenelement ausgewählt und wurden Profilierungen vorgenommen, so können alle vorgenommenen Änderungen am Element durch Klick auf dieses Icon gleichzeitig zurückgesetzt werden.

Im Bearbeitungsbereich, auf der rechten Bildschirmseite der Anwendung, lassen sich die Attribute der Nachrichtenelemente entsprechend befüllen. Die Angaben aus dem Standard sind am rechten Bildschirmrand dargestellt. Über die Kardinalität kann angegeben werden ob das Nachrichtenelement Teil der Profilierung sein soll und/oder wie oft es eingebunden werden soll. Je nach Angabe aus dem Standard kann hier entsprechend profiliert werden

Folgende Informationen können über die Eingabefelder "Beschreibung" und "Umsetzungshinweis" abgebildet werden:

Nachrichtenelemente vom Typ CodeType lassen sich ähnlich wie andere Elemente in der Anwendung profilieren. Sie sind durch ein graues quadratisches Icon in der Navigation gekennzeichnet. Zusätzlich bieten sie weitere Profilierungsmöglichkeiten.

Folgende Informationen können über die Eingaben zu den Metadaten einer Codeliste angegeben werden:

Rekursive Nachrichtenelemente sind durch ein Unendlich-Icon in der Baumnavigation gekennzeichnet.

Rekursive Elemente lassen sich zusätzlich in ihrer Rekursionstiefe einschränken. Durch die Eingabe einer Zahl, kann die Rekursionstiefe festgelegt werden. Darüber hinaus ist es möglich eine Beschreibung der Rekursionstiefe anzugeben.

Simple Datentypprofile lassen sich in den Basisattributen ähnlich wie Codelisten oder komplexe Datentypprofile in Nachrichtenelemente einbinden und auch profilieren.

Diese Nachrichtenelemente sind in der Navigation durch ein graues Verzweigungs-Icon gekennzeichnet. Die Profilierung erfolgt adequat zur Profilierung komplexer Datentypen

Alle Nachrichtenelemente, die weder simple, noch Codelisten, noch rekursive Nachrichtenelemente sind, werden auch als komplexe Nachrichtenelemente bezeichnet.

Die im Bereich "Projekt" der Anwendung definierten eigenen Eigenschaften können hier eingebunden werden. Sie dienen als Ergänzung zu den bereits vorhandenen Attributen aus dem Standard. Nach dem befüllen der Eingabefelder, kann die Eigenschaft über das + Icon hinzugefügt werden. Über das Stift-Icon kann die Eigenschaft editiert werden. Durch betätigen des Mülleimer-Icons wird die Eigenschaft entfernt.

Im linken Bildschirmbereich wird die Struktur der Dokumentation angezeigt. Über das Suchfeld kann diese durchsucht werden. Per drag&drop lässt sich die Reihenfolge der Sortierung anpassen. In der Navigation der Dokumentation sind manche Punkte als "(generiert)" gekennzeichnet. Das sind Kapitel die auf Basis der Profilierung, während der Arbeit in der Anwendung automatisch generiert werden. Sie sind nicht editierbar.

Die Profilierungsdokumentation ist auf Basis von asciidoctor geschrieben. Einen Einstieg in dieses Dokumentationsformat ist hier zu finden: Asciidoctor

Im rechten Bildschirmbereich kann die Bearbeitung der Dokumentation vorgenommen werden. Über die Schaltflächen Bearbeitung und Preview kann zwischen dem Bearbeitungsmodus und der Vorschau des fertigen Dokuments gewechselt werden. Eingaben im Bearbeitungsmodus werden beim Umschalten in den Previewmodus direkt übernommen und visualisiert. Inhalte, die von der Dokumentation des Standards abweichen, werden gelb hervorgehoben.

Im Bearbeitungsbereich, unter dem Speichern-Button befindet sich ein Downloadsymbol. Per Klick lässt sich darüber die Dokumentation als PDF generieren und herunterladen.

Mit diesem Schalter wählen Sie aus, ob die Vorschau der gesamten Dokumentation angezeigt wird, oder nur die Vorschau des jeweils ausgewählten Abschnitts.

Um eine vorhandene Beispielnachricht mit Hilfe der XÖV-Suite zu verwenden, kann über den Button oben Links "Nachricht öffnen" ein Upload-Dialog geöffnet werden. Es erscheint ein Fenster. In dieses Fenster kann per drag&drop eine entsprechende Beispielnachricht gezogen werden. Alternativ kann per klick in den grauen Kasten der Dateiexplorer des eigenen PCs aufgerufen werden. Nachdem eine Datei erfolgreich ausgewählt werden konnte, kann über die blaue Schalfläche rechts unten im Dialog, "Hochladen", die ausgewählte Nachricht in die Anwendung geladen werden.

Auf Basis der Profilierung in der XÖV-Suite kann eine Beispielnachricht erzeugt werden. Über den Button oben Links "Nachricht generieren" wird ein Dialogfenster zur "Konfiguration der Nachrichtenerzeugung" geöffnet. In dieser Ansicht kann konfiguriert werden, welche Nachrichten Teil der Beispielnachricht sein sollen. Die Suchfunktion erleichtert die Auswahl aus der Liste an möglichen Einträgen. Über den Toggle "Nur eingeschränkte Nachrichten anzeigen" kann das Ergebnis der Auflistung auf die in der XÖV-Suite profilierten Einträge reduziert werden.

In der Nachrichtenübersicht werden alle hochgeladenen oder generierten Nachrichten abgebildet.

Auf der rechten Bildschirmseite finden Sie in der tabellarischen Auflistung der Nachrichtenübersicht, die Spalte "Validierungsbericht". Hier haben Sie die Möglichkeit per Klick auf das Icon den Validierungsreport der jeweiligen Nachrichten zu öffnen. Sollten die Nachricht Validierungsfehler oder -warnungen enthalten, so werden diese hier angezeigt. Neben dem Icon für den Validierungsreport gibt es noch das Dreipunktmenü mit weiterführenden Optionen.

Auf der rechten Bildschirmseite finden Sie in der tabellarischen Auflistung der Nachrichtenübersicht, die Spalte "Validierungsbericht". Per Klick auf das Icon mit den drei Punkten (Dreipunktmenü) haben Sie weitere Optionen:

Sobald eine Beispielnachricht in der Nachrichtenübersicht geöffnet ist, kann sie per Klick auf den blau hinterlegten "Dateinamen", in der tabellarischen Auflistung, geöffnet werden. Ist die Beispielnachricht geöffnet, erscheint Sie als Tab in der Leiste über der tabellarischen Auflistung.

Per Klick auf das Tab einer Beispielnachricht gelangen Sie in die Einzelansicht einer Beispielnachricht. Hier können Sie auf der linken Bildschirmseite die Nachrichtenstruktur der Nachricht einsehen. Auf der rechten Seite können Sie die Angaben aus der Profilierung einsehen und entsprechend kopieren.

Eine Bearbeitung der Beispielnachricht ist an dieser Stelle nicht möglich.