Verfahrenskonfigurator

Aus DiPlanung

> Zurück zur Hauptseite DiPlan Cockpit Basis für Mandanten-Administratoren (M-A)

> Zurück zur Hauptseite DiPlanCockpit Pro für Mandanten-Administratoren (M-A)

Einleitung[Bearbeiten | Quelltext bearbeiten]

Beim Verfahrenskonfigurator handelt es sich um eine in das DiPlanCockpit integrierte grafische Lösung für die Erstellung und Anpassung von Verfahrenskonfigurationen (VK).

Verfahrenskonfigurationen (VK) sind XML-Dateien, die im DiPlanCockpit den strukturellen Aufbau eines Verfahrens und seiner Elemente definieren. Sie beinhalten unter anderem Informationen zur Zeitplanung, passenden Plan- und Verfahrensarten, der Gliederung der einzelnen Verfahrensschritte sowie den darin enthaltenen Terminen und Aufgaben im Verfahren. Damit handelt es sich bei VKs um sehr komplexe XML-Dateien, die aus mehreren Tausend Zeilen Code bestehen können.

Die Verwaltung der VKs liegt innerhalb des DiPlanCockpits im Bereich der fachlichen Leitstelle der Mandanten-Administration. Da es dort bisher nur eine Funktion zum Hoch- bzw. Herunterladen der VKs gab, konnten VKs nur lokal bzw. außerhalb des Cockpits gepflegt werden.

Der Verfahrenskonfigurator hat das Ziel, den Prozess der Erstellung und Anpassung von Verfahrenskonfigurationen (VK) nutzerfreundlicher zu gestalten und die bisher notwendige Verwendung externer Tools dafür abzulösen. In dem folgenden Kapitel wird zunächst die allgemeine technische Funktionsweise des Verfahrenskonfigurators skizziert. Anschließend wird in einem gesonderten Kapitel der Aufbau und der aktuelle Funktionsumfang des Verfahrenskonfonfigurators erläutert.

Technische Funktionsweise[Bearbeiten | Quelltext bearbeiten]

Damit der Verfahrenskonfigurator möglichst flexibel mit Anpassungen und übergreifenden Weiterentwicklungen im Aufbau der Verfahrenskonfiguration umgehen kann, verfolgt der Verfahrenskonfigurator einen generischen Lösungsansatz. Das bedeutet, dass die Darstellung von VKs und ihren Anpassungsmöglichkeiten im Verfahrenskonfigurator auf verallgemeinerbaren Regeln basiert. Diese Regeln werden – soweit möglich – aus der XSD-Schemadatei (diplanung.xsd) abgeleitet. Sie dient im DiPlanCockpit zur Validierung der VKs und definiert die hierarchische Struktur sowie Häufigkeit der möglichen Bestandteile einer VK. Der Verfahrenskonfigurator übersetzt die Logik der XSD-Schemadatei in die Logik der VK (XML-Datei) und erlaubt es Ihnen, einzelne Elemente wie aufeinander aufbauende Bausteine der VK entsprechend der vordefinierten Regeln hinzuzufügen und zu konfigurieren.

Hinweis: Bevor mit Hilfe des Verfahrenskonfigurators eine VK angepasst oder eine neue VK erstellt wird, ist es notwendig, dass relevante Codelisten vorher angepasst sind! Andernfalls kann es zu Fehlern im DiPlanCockpit kommen!

Erläuterung der Oberfläche und des Funktionsumfangs[Bearbeiten | Quelltext bearbeiten]

In diesem Abschnitt wird der Aufbau und die Funktionsweise der Oberfläche des Verfahrenskonfigurators erläutert. Der Verfahrenskonfigurator ist für die Mandanten-Administration im Bereich „Fachliche Leitstelle Administration“ unter dem Reiter „Verfahrenskonfiguration“ verfügbar.

Verfahrenskonfigurator öffnen[Bearbeiten | Quelltext bearbeiten]

Sie können mit Hilfe des Verfahrenskonfigurators entweder eine völlig neue VK erstellen (noch in Entwicklung!) oder eine der bestehenden VKs ändern. Je nachdem für welche der beiden Optionen Sie sich entscheiden, unterscheidet sich der Navigationsweg zum Verfahrenskonfigurator.

Neue VK erstellen[Bearbeiten | Quelltext bearbeiten]

Abbildung: Position des Buttons „Neue Verfahrenskonfiguration erstellen“ im Reiter „Verfahrenskonfiguration“ innerhalb des Bereichs „Fachliche Leitstelle Administration“ (mit orangenem Rahmen markiert).

Um eine neue VK zu erstellen, klicken Sie im geöffneten Reiter „Verfahrenskonfigurationen“ auf den Button „Neue Verfahrenskonfiguration erstellen“. Anschließend öffnet sich der Verfahrenskonfigurator mit einer neuen VK und es wird ein Hinweis zum aktuellen Entwicklungsstand des Verfahrenskonfigurators angezeigt. Lesen Sie den Hinweis aufmerksam durch und klicken Sie anschließend auf den Button „Schließen“, um fortzufahren. Die neue VK enthält zu Beginn nur das Element „Verfahrenssteuerung“.

Hinweis: Die Funktion zum Erstellen neuer VKs befindet sich aktuell noch in Entwicklung!

Bestehende VK ändern[Bearbeiten | Quelltext bearbeiten]

Abbildung: Position des „Ändern“-Buttons im 3-Punkte-Menü eines Eintrages der Übersichtsliste aller bestehenden Verfahrenskonfigurationen (mit orangenem Rahmen markiert).

Der Reiter „Verfahrenskonfigurationen“ zeigt im unteren Abschnitt standardmäßig eine Übersichtstabelle sämtlicher Verfahrenskonfigurationen im System an. Um eine bestehende VK zu öffnen, klicken Sie in der Übersichtstabelle auf das Drei-Punkte-Symbol des gewünschten Listeneintrages. Nachdem sich das Drei-Punkte-Menü geöffnet hat, klicken Sie auf den Menüpunkt „Ändern“ (Stift-Symbol).

Anschließend öffnet sich der Verfahrenskonfigurator mit der gewünschten VK und es wird ein Hinweis zum aktuellen Entwicklungsstand des Verfahrenskonfigurators angezeigt. Lesen Sie den Hinweis aufmerksam durch und klicken Sie anschließend auf den Button „Schließen“, um fortzufahren.

Verfahrensstruktur einsehen[Bearbeiten | Quelltext bearbeiten]

Abbildung: Position des Verfahrensstruktur-Bereichs im Verfahrenskonfigurator (mit orangenem Rahmen markiert).

In der Mitte des Verfahrenskonfigurators befindet sich der Bereich "Verfahrensstruktur". In diesem Bereich wird die geöffnete Verfahrenskonfiguration in einer Baumstruktur dargestellt. Die Elemente der VK werden darin mit ihrem Namen aufgeführt. Wenn ein Element bereits über Attributwerte verfügt, werden die Attributwerte hinter dem Elementnamen fettgedruckt dargestellt und durch einen senkrechten Strich voneinander getrennt.

Die Baumstruktur gibt die hierarchische Ordnung der in der VK enthaltenen Elemente wieder: So befindet sich das übergeordnete Element "Verfahrenssteuerung" an oberster Stelle, Elemente wie ActionItems werden (wenn vorhanden) auf den untersten Hierarchie-Ebenen unterhalb der Verfahrensschritte (VS) angezeigt. Das hierarchische Verhältnis zwischen den Elementen wird standardmäßig durch grau gestrichelte Äste vor den Elementnamen dargestellt.

Elemente auswählen und Auswahl aufheben[Bearbeiten | Quelltext bearbeiten]

Sie können einzelne Elemente in der Baumstruktur auswählen, um weitere Aktionen am jeweiligen Element durchzuführen. Klicken Sie dazu auf den Namen des gewünschten Elements. Das ausgewählte Element wird dann durch eine Blaufärbung des Elementnamens markiert. Falls das Element Kind-Elemente hat, werden deren Äste mit blauen durchgängigen Linien in der Baumstruktur hervorgehoben. Zusätzlich werden das ausgewählte Element und seine Kind-Elemente in der Verfahrensstruktur hellblau hinterlegt dargestellt.

Sobald Sie ein Element ausgewählt haben, öffnet sich am rechten Bildschirmrand der Konfigurationsbereich des Elements (siehe Abschnitt "Elemente konfigurieren"). Wenn Sie die Auswahl des Elements aufheben wollen, können Sie dafür auf den Namen des ausgewählten Elements klicken. Alternativ haben Sie die Möglichkeit, auf das Schließen-Symbol (X) oben rechts im Konfigurationsbereich (neben dem Titel "Konfiguration") zu klicken. Der Konfigurationsbereich wird dann geschlossen und die Auswahl des Elements aufgehoben.

Elemente aus- und einklappen[Bearbeiten | Quelltext bearbeiten]

Wenn Sie eine VK öffnen, wird die VK zunächst zusammengeklappt dargestellt. Wenn ein Element Kind-Elemente beinhaltet, wird vor dem übergeordneten Element ein Chevron-Symbol angezeigt. Klicken Sie auf das Chevron-Symbol, um das übergeordnete Element auszuklappen und seine enthaltenen Kind-Elemente einzusehen. Klicken Sie erneut auf das Chevron-Symbol, um das übergeordnete Element wieder zusammenzuklappen.

Elementeübersicht einsehen[Bearbeiten | Quelltext bearbeiten]

Abbildung: Position der Elementeübersicht im Verfahrenskonfigurator (mit orangenem Rahmen markiert).

Im Verfahrenskonfigurator finden Sie am linken Bildschirmrand die Spalte "Elementeübersicht". In dieser Spalte können Sie sich einen Überblick über mögliche Elementtypen der VK verschaffen. Die Elementtypen sind mit ihrer minimalen sowie maximalen Häufigkeit in einer VK angegeben. Abhängig davon, zu welchem Elementtyp ein Element gehört, das Sie im Verfahrensstruktur-Bereich ausgewählt haben, werden die Elementtypen in der Elementübersicht hervorgehoben, die Sie dem ausgewählten Element als Kind-Elemente hinzufügen können. Alle übrigen Elemente werden ausgegraut dargestellt. Klicken Sie auf das doppelte Chevron-Symbol (<<) rechts neben dem Titel "Elementeübersicht", um die "Elementeübersicht"-Spalte ein- oder auszuklappen.

Element zur Verfahrensstruktur hinzufügen[Bearbeiten | Quelltext bearbeiten]

Abbildung: Hinzufügen-Button mit Dropdown-Menü für die Auswahl des gewünschten Elementtypen des neuen Kind-Elementes (mit orangenem Rahmen markiert).

Wenn Sie einem Element ein Kind-Element hinzufügen möchten, klicken Sie im Bereich „Verfahrensstruktur“ auf das gewünschte übergeordnete Element in der Baumstruktur, um dieses auszuwählen. Klicken Sie anschließend am Element auf den Hinzufügen-Button (Plus-Symbol). Unterhalb des Plus-Symbols öffnet sich dann eine Auswahlliste mit allen hinzufügbaren Elementtypen. Klicken Sie auf den Listeneintrag des gewünschten Elementtyps, um ein entsprechendes Kind-Element hinzuzufügen. Das neue Kind-Element wird daraufhin automatisch an die letzte Position aller hinzugefügten Kind-Elemente des gewählten Elementtyps gesetzt. Auf diese Weise stellt der Verfahrenskonfigurator die korrekte Abfolge der Elementtypen gemäß der XSD-Schemadatei (diplanung.xsd) in der VK sicher.

Sollte ein Elementtyp in der Auswalliste ausgegraut sein, bedeutet dies, dass kein weiteres Element dieses Typs hinzugefügt werden darf. Das ist der Fall, wenn

  • die maximale Anzahl der Kind-Elemente diesen Typs unter dem übergeordneten Element erreicht ist
  • oder ein bereits vorhandenes Kind-Element eines anderen Typs dies ausschließt. (Beispiel: Im Rahmen der Zeitplanung kann dem Element "Prognosestarttermin" nur entweder ein Kind-Element "codeSitzung" oder "codeSonstigerTermin" hinzugefügt sein.) Löschen Sie in dem Fall das andere Element und versuchen Sie erneut, das gewünschte Element hinzuzufügen. Im Abschnitt "Element aus Verfahrensstruktur entfernen" erfahren Sie mehr über das Löschen von Elementen.

Element in Verfahrensstruktur verschieben[Bearbeiten | Quelltext bearbeiten]

Hinweis: Die Funktion zum Verschieben von Elementen in der Verfahrensstruktur befindet sich noch in Entwicklung!

Element aus Verfahrensstruktur entfernen[Bearbeiten | Quelltext bearbeiten]

Abbildung: Position des Löschen-Buttons an einem entfernbaren Kind-Element (mit orangenem Rahmen markiert).

Wenn Sie ein Element aus der VK entfernen wollen, klicken Sie im Bereich „Verfahrensstruktur“ auf das gewünschte Element in der Baumstruktur, um dieses auszuwählen. Klicken Sie anschließend am Element auf den Entfernen-Button (Minus-Symbol).

Falls das gewählte Element mindestens ein Kind-Element enthält, wird vor dem Löschen ein Warnhinweis angezeigt. Klicken Sie unterhalb des Hinweistexts auf den rechten Button "Löschen", um das Element mit allen seinen Kind-Elementen zu löschen. Klicken Sie auf den "Abbrechen"-Button, um den Löschvorgang abzubrechen.

Abbildung: Warnhinweis vor dem Löschen von Elementen mit Kind-Elementen: "Achtung. Mit dem Löschen des ausgewählten Elementes werden auch alle ihm hinzugefügten Elemente gelöscht. Möchten Sie mit dem Löschen fortfahren?"

Wenn ein Element gelöscht wird, wird das Element mit all seinen enthaltenen Kind-Elementen durch eine Rotfärbung seines Titels und der betroffenen Äste in der Baumstruktur markiert. Die zu löschenden Elemente werden zusätzlich mit einer zweimal aufleuchtenden Farbhinterlegung hervorhoben. Anschließend wird das Element (mit seinen Kind-Elementen) aus der Baumstruktur entfernt.

Abbildung: Hervorhebung der zu löschenden Elemente durch rote Struktur-Äste, den roten Titel des Hauptelements und eine zweimal aufleuchtende rote Farbhinterlegung.
Hinweis: Das Element "Verfahrenssteuerung" kann grundsätzlich nicht gelöscht werden, da es sich hierbei um das zentrale übergeordnete Element der VK handelt.

Elemente konfigurieren[Bearbeiten | Quelltext bearbeiten]

Abbildung: Position des Konfigurationsbereiches für das ausgewählte Element am linken Bildschirmrand (mit orangenem Rahmen markiert).

Nachdem Sie im Verfahrensstruktur-Bereich ein Element ausgewählt haben (siehe Abschnitt "Elemente auswählen und Auswahl aufheben"), öffnet sich am rechten Bildschirmrand der Konfigurationsbereich des Elements. Wenn das ausgewählte Element Attribute oder andere konfigurierbare Parameter enthält, werden diese dort untereinander aufgeführt. Jedes Attribut wird mit seinem Namen und einem Datenfeld für die Angabe eines Wertes angezeigt. Es können folgende Datenfeldtypen vorkommen:

Freitextfeld[Bearbeiten | Quelltext bearbeiten]

Klicken Sie im geöffneten Konfigurationsbereich unter dem Namens des anzupassenden Parameters in das Eingabefeld, um einen gewünschten Wert angeben zu können.

Dropdown[Bearbeiten | Quelltext bearbeiten]

Abbildung: Geöffnetes Dropdown-Menü für die Angabe eines Parameterwertes im Konfigurationsbereich des ausgewählten Elements. Hier: Angabe des Codewertes für ein Planart-Element (mit orangenem Rahmen markiert).

Klicken Sie im geöffneten Konfigurationsbereich unter dem Namens des anzupassenden Parameters in das Feld, um das Dropdown-Menü zu öffnen. Falls für den Parameter bereits ein Wert angegeben worden ist, wird dieser in dem Feld angezeigt. Falls noch kein Wert angegeben worden ist, steht im Feld der Beschreibungstext "Wert wählen". Unterhalb des Feldes werden ein Suchfeld und die Liste der wählbaren Werte angezeigt.

Mit Hilfe des Suchfeldes haben die Möglichkeit, die Auswahlliste auf Einträge mit einer bestimmten Zeichenfolge zu beschränken. Klicken Sie hierzu in das Suchfeld und geben Sie einen Suchbegriff mit mindestens einem Zeichen ein. Falls zum Suchbegriff kein passender Eintrag gefunden werden kann, wird unterhalb des Suchfeldes folgender Hinweis angezeigt: "Es wurden keine Elemente gefunden."

Abbildung: Dropdown-Menü mit einem Suchbegriff, für den kein passender Eintrag in der Auswahlliste gefunden werden konnte.

Um einen Wert aus der Auswahlliste auszuwählen, bewegen Sie den Mauszeiger über dem gewünschten Eintrag, bis dieser hellblau hinterlegt ist, und klicken sie zur Bestätigung. Falls die Menge der Eintrage über den Anzeigebereich der Auswahlliste hinaus geht, ist es gegebenenfalls notwendig, das Sie in der Auswahlliste nach unten oder oben scrollen.

Hinweis: Die Wertelisten bestimmter Dropdowns speisen sich aus Codelisten. Stellen Sie vor der Nutzung des Verfahrenskonfigurators bitte sicher, dass die Codelisten aktuell sind!

Bestehende VK speichern[Bearbeiten | Quelltext bearbeiten]

Abbildung: Position des Speichern-Buttons unterhalb der Reiter-Navigation, im rechten oberen Bereich des Verfahrenskonfigurators (mit orangenem Rahmen markiert).

Wenn Sie eine VK im Verfahrenskonfigurator geöffnet haben, können Sie die VK mit ihrem aktuellen Bearbeitungsstand im DiPlanCockpit speichern. Klicken Sie dazu am rechten Bildschirmrand, unterhalb der Reiter-Navigation auf den "Speichern"-Button. Der "Speichern"-Button ist an seiner blauen Farbe und dem Diskettensymbol zu erkennen. Nach dem Klick auf den Speichern-Button ändert sich seine Beschriftung zu einer Meldung, ob der Speichervorgang erfolgreich war (Meldung: "Speichern erfolgreich!) oder nicht (Meldung: "Fehler aufgetreten.").

Abbildung: Speichern-Button mit Erfolgsnachricht "Speichern erfolgreich!".
Abbildung: Speichern-Button mit Meldung "Fehler aufgetreten".



Hinweis: Wenn beim Speichern ein Fehler auftritt, kann die Ursache ein fehlendes benötigtes Element oder eine fehlende Wertangabe in der Verfahrenskonfiguration sein. Kontrollieren Sie in dem Fall Ihren Arbeitsstand auf möglicherweise fehlende Mindestangaben und Elemente und ergänzen Sie diese gegebenenfalls.

Arbeitsstand herunterladen[Bearbeiten | Quelltext bearbeiten]

Abbildung: Position des "Arbeitsstand herunterladen"-Buttons im Titelbereich unterhalb der Reiter-Navigation, im rechten oberen Bereich des Verfahrenskonfigurators (mit orangenem Rahmen markiert).

Für den Fall, dass der Arbeitsstand der geöffneten Verfahrenskonfiguration nicht direkt im DiPlanCockpit gespeichert werden kann (beispielsweise aufgrund eines Validationsfehlers), haben Sie die Möglichkeit, Ihren aktuellen Arbeitsstand der geöffneten Verfahrenskonfiguration herunterzuladen und lokal zu speichern.

Klicken Sie hierzu im Titelbereich des Verfahrenskonfigurators (unterhalb der Reiter-Navigation) auf den Button "Arbeitsstand herunterladen". Wählen Sie anschließend einen beliebigen Speicherort für die XML-Datei im sich öffnenden Download-Fenster Ihres Browsers und bestätigen Sie den Vorgang.

Sie können die heruntergeladene Verfahrenskonfiguration manuell weiterbearbeiten und zu einem späteren Zeitpunkt im Bereich „Fachliche Leitstelle Administration“ unter dem Reiter „Verfahrenskonfiguration“ in das DiPlanCockpit hochladen.