Reiter Aufgaben: Übersicht der ActionItems
> Zurück zur Hauptseite DiPlanCockpit Pro für Mandanten-Administratoren (M-A)
Der Reiter Aufgaben enthält die innerhalb einer Verfahrens zu erledigenden Aufgaben, unterteilt nach Verfahrensschritten, Verfahrensteilschritten und Unterverfahrensteilschritten. Aufgaben bestehen aus Unteraufgaben und diese wiederum aus ActionItems, die in der Verfahrenskonfiguration enthalten sind.
Auf dieser Seite ist beschrieben, wie die ActionItems im Frontend dargestellt und in der Verfahrenskonfiguration in XML konfiguriert werden.
Allgemeine Informationen zu ActionItems[Bearbeiten | Quelltext bearbeiten]
Ein ActionItem beschreibt eine Aktion die durchgeführt werden soll.
Alle ActionItems haben folgende übergreifenden Datenfelder:
| Name | Zweck |
|---|---|
| label | Bezeichnung des ActionItem, erscheint als Überschrift |
Einzelne ActionItems unterstützen das Auslesen und Zurückschreiben von Werten in den Stammdaten sowie in den generischen Eigenschaften der sonstigen Termine. Hierzu können an den ActionItems folgende Angaben gemacht werden:
| Name | Zweck |
|---|---|
| source | Zu verwenden, wenn der Wert aus dem Stammdaten kommt. Angabe in Platzhalter-Syntax. |
| source.updateModel | Angabe, ob der Wert in den Stammdaten bei Änderung zurückgeschrieben werden soll. Angabe "ja", wenn es erfolgen soll. |
| sonstigerTermin.code | Zu verwenden, wenn der Wert aus einer generischen Eigenschaft eines sonstigen Termins kommt. Hier muss dann der Wert den sonstigen Termin aus der Codeliste "Code.SonstigerTermin" angegeben werden. |
| sonstigerTermin.eigenschaft | Angabe der generischen Eigenschaft, wo der Wert definiert ist. |
Welche ActionItems dieses Verhalten unterstützen ist der Datei "diplanung.xsd" zu entnehmen. ActionItems, die es unterstützen, enthalten die Angabe "ActionItemReadWriteModel" oder "diplanung:ReadWriteModelSource". Aktuell sind das die folgenden ActionItems: Checkbox, String, Integer, Float, InputLink, Textarea und Link.
Beschreibung der ActionItems[Bearbeiten | Quelltext bearbeiten]
| ActionItem | Beschreibung | Grafische Darstellung (FE Ansicht) | Attribute XML | Codebeispiel XML |
|---|---|---|---|---|
| UploadFile | Ermöglicht es Dateien in das Cockpit hochzuladen. Die Dateien werden in der Dokumentenbibliothek angezeigt. | allowedExtensions: Angabe der hochladbaren Dateiendungen in einer Komma/Semikolon separierten Liste. Leerer String / nicht angegeben --> alle Dateiendungen möglich.
allowedUnterlagentypen: Angabe der erlaubten CodeUnterlagenTypen, die in der Anwendung auswählbar und damit hochladbar sind. logicalFileID: Angabe einer logischen FileID, die die hochgeladenen Dateien bekommen. Dient in anderen ActionItems der Referenzierung der Dateien. vormerkung: Angabe eines Codes der Codeliste Vormerkung. Die Vormerkung wird automatisch mit dem Hochladen an der Datei gesetzt. |
<actionItemUploadFile>
<label>Aktion File Upload</label> <allowedUnterlagentypen>9900</allowedUnterlagentypen> <allowedUnterlagentypen>0700</allowedUnterlagentypen> <vormerkung>0300</vormerkung> </actionItemUploadFile> | |
| BeteiligungUploadFile | Gleiche Funktionalität wie UploadFile. Es wird zusätzlich an der hochgeladenen Datei automatisch die Vormerkung "Beteiligungsverfahren" vergeben. | siehe uploadFile | siehe uploadFile | <actionItemBeteiligungUploadFile>
<label>Dokumente für Beteiligungsverfahren hochladen</label> <allowedUnterlagentypen>1180</allowedUnterlagentypen> </actionItemBeteiligungUploadFile> |
| VisualizeFile | Stellt den Link zu einer über den Parameter logicalFileID verknüpften Datei dar. | logicalFileID: Logische FileID die auf eine Datei referenziert. Die ID hat kein fest vorgegebenes Format. | <actionItemVisualizeFile>
<label>In Digitalen Wissensassistenten wechseln</label> <logicalFileID>12345abc678</logicalFileID></actionItemVisualizeFile> | |
| BeteiligungVisualizeLink | Prägt mithilfe des Systemparameters BETEILIGUNG_URL, der BeteiligungsID und dem aus dem Element "type" ermittelten Zusatz eine URL ins Beteiligungsverfahren aus ("<BETEILIGUNG_URL> /verfahren/ <BETEILIGUNGS_ID>/type"). | type: mögliche Angaben: #verfahren -> "/uebersicht" , #beteiligung -> "/public/detail",
#verteiler -> "/einstellungen/benutzer", #einladung -> "/einstellungen/benutzer" |
<actionItemBeteiligungVisualizeLink>
<label>Verfahren in Bauleitplanung online konfigurieren</label> <type>#verteiler</type> </actionItemBeteiligungVisualizeLink> | |
| ChooseFile | Setzt an Dateien einen Unterlagentyp und eine logische FileID und bereitet sie so beispielsweise für die Ausleitung in einen fachlichen Ordner vor. | allowedExtensions: Angabe auswählbarer Dateiendungen in einer Komma/Semikolon separierten Liste.
logicalFileID: Angabe einer logischen FileID, die die hochgeladenen Dateien bekommen. Dient in anderen ActionItems der Referenzierung der Dateien. |
<actionItemChooseFile>
<label>Aktion choose File</label> <allowedExtensions>.pdf, .png</allowedExtensions> <logicalFileID>12345abc678</logicalFileID> </actionItemChooseFile> | |
| BeteiligungChooseFile | Dient der Auswahl von Dateien für ein Beteiligungsverfahren. | siehe chooseFile | allowedExtensions: Angabe auswählbarer Dateiendungen in einer Komma/Semikolon separierten Liste. | <actionItemBeteiligungChooseFile>
<label>Dokumente auswählen für BOP</label> <allowedExtensions>.pdf, .png</allowedExtensions> </actionItemBeteiligungChooseFile> |
| ChangeDate | Setzt das Datum (Tag oder Zeitraum) und den Status (geplant/stattgefunden) eines VTS-Termins (Sitzung oder Sonstiger Termin). | datumsstatus: Mögliche Werte: "geplant" oder "stattgefunden"
sitzung.code: Im Fall einer Sitzung muss ihr Code aus der Codeliste "Code.Sizungstermine" angegeben werden. sitzung.datumsart: Soll das Datum des Sitzungstermin geändert werden, so muss "sitzungsdatum" angegeben werden. Soll das Versanddatum des Sitzungstermin geändert werden, entsprechend das "versanddatum". Wenn es den Wert "versanddatum" hat und der Termin eine Sitzung ist, dann wird er nicht als zeitplanungsrelevant markiert und der Zeitpunkt ist der des Versanddatums. Andernfalls werden die Planungsrelevanz und der Zeitraum aus dem Termin übernommen und die Nachfolgetermine werden ggf. neu berechnet. sonstigerTermin.code: Im Fall eines sonstigen Termins muss hier der Wert aus der Codeliste "Code.SonstigerTermin" angegeben werden. |
Sonstiger Termin
<actionItemChangeDate> <label>Aktion ChangeDatum Stattgefunden</label> <datumsstatus>stattgefunden</datumsstatus> <sonstigerTermin code="0050"/> </actionItemChangeDate>
Sitzung <actionItemChangeDate> <label>Aktion Date Change</label> <datumsstatus>stattgefunden</datumsstatus> <sitzung code="9200" datumsart="sitzungsdatum"/> </actionItemChangeDate> | |
| AddDate | Dient der Angabe eines Datums (Tag oder Zeitraum). Dies ist kein VTS-Termin und wird ausschließlich am ActionItem gespeichert. D.h. es fließt nicht in die Zeitplanung oder Prognoseberechnung ein. | siehe ChangeDate | keine | <actionItemAddDate>
<label>Aktion Date Add</label> </actionItemAddDate> |
| Dient der Erstellung einer MSG-Datei, die heruntergeladen werden kann. In den Feldern "Subject" und "Body" können Platzhalter verwendet werden. | body: Inhalt der Mail
subject: Betreff der Mail receiverAddresses: Liste der Empfänger-Emailadressen, getrennt mit Semikolon. copyAddresses: Liste der CC-Emailadressen, getrennt mit Semikolon. |
<actionItemMail>
<label>E-Mail versenden</label> <receiverAddresses>beispiel@mail.com</receiverAddresses> </actionItemMail> | ||
| GenerateDocument | Dient der Erstellung von Dokumenten, basierend auf im Cockpit enthaltenen Mustervorlagen. Die erstellten Dokumente werden in der Dokumentenbibliothek dargestellt. | musterdokument: Code des Musterdokuments für das ein Dokument generiert werden soll.
Damit das Dokument generiert werden kann, muss eine gültige Vorlagenzuordnung für den musterdokument Code existieren. Wenn es sich um ein übergeordnetes Dokument handelt, muss der Verfahrensschritt und Verfahrensteilschritt mit „Alle“ angegeben sein. unterlagentyp: Angabe des Wertes aus der Codeliste "Code.VerfahrensunterlagenTyp" uebergeordnetesDokument: Angabe ob das Dokument in den Ordner "Übergeordnete Verfahrensdokumente" abgelegt werden soll. Wenn nicht wird das Dokument automatisch in dem Verfahrensschrittordner zugeordnet. |
<actionItemGenerateDocument>
<label>Niederschrift des Nachgesprächs erstellen</label> <musterdokument>0482</musterdokument> <unterlagentyp>1132</unterlagentyp> <uebergeordnetesDokument>nein</uebergeordnetesDokument> </actionItemGenerateDocument> | |
| Link | Stellt im Cockpit einen Link (URL) dar. Der Link kann aus den Stammdaten, generischen Eigenschaften der sonstigen Termine oder am ActionItem selbst definiert werden. | name: Name des Links, wenn der Link nur am ActionItem definiert werden soll.
url: URL des Links, wenn der Link nur am ActionItem definiert werden soll. |
<actionItemLink>
<label>Webseite aufrufen</label> <name>Beispielseite</name> <url>https://beispielseite.de</url> </actionItemLink> | |
| InputLink | Ermöglicht die Eingabe eines Links (URL). Der Link kann in den Stammdaten, generischen Eigenschaften eines sonstigen Termins sowie am ActionItem gespeichert werden. Für die Speicherung an den Stammdaten muss "updateModel" true sein. | updateModel: Steuert Speicherung der Eingabe in den Stammdaten. | <actionItemInputLink>
<label>URL zur Interseite eintragen</label> <source updateModel="ja">verfahrensbeschreibung.internetseite</source> </actionItemInputLink> | |
| Checkbox | Dient der Anzeige und Eingabe eines Booleans. Der Wert kann in den Stammdaten, generischen Eigenschaften eines sonstigen Termins und am ActionItem gespeichert werden. | checked: Angabe ob die Checkbox defaultmäßig selektiert ist. | <actionItemCheckbox>
<label>Bereitstellung der Planinformationen prüfen</label> <checked>nein</checked> </actionItemCheckbox> | |
| Dropdown | Dient der Speicherung eines Wertes aus einer Werteliste. Es kann an Sitzungen das Sitzungsergebnis setzen sowie an sonstigen Terminen den Wert einer generischen Eigenschaft des Typs Codeliste. Es kann am ActionItem eine eigene Werteliste definiert oder eine vorhandene Codeliste verwendet werden. | sitzung.code: Um ein Sitzungsergebnis zu setzen, muss hier der Wert der Sitzung aus der Codeliste "Code.Sitzungen" angegeben sein.
sitzung.ergebnistyp: Typ des Sitzungsergebnisses. "Code.PolitischesSitzungsergebnis", "Code.VerwaltungstechnischesSitzungsergebnis" oder "Code.RechtspruefungSitzungsergebnis" sonstigerTermin.code: Um den Wert einer generischen Eigenschaft eines sonstigen Termins zu setzen, muss hier der Wert des sonstigen Termins aus der Codeliste "Code.SonstigerTermin" angegeben sein. sonstigerTermin.eigenschaft: Name der generischen Eigenschaft des sonstigen Termins bei dem der Wert gesetzt werden soll. sonstigerTermin.codelistName: Name der Codeliste der generischen Eigenschaft. optionLabels: Angabe aller Werte für eine eigene Werteliste am ActionItem. codelistName: Angabe des Namens der Codeliste, die verwendet werden soll. valueDefault: Angabe eines Wertes, der vorausgewählt sein soll. |
Dokumentation eines Sitzungsergebnisses:
<actionItemDropdown> <label>Sitzungsergebnis dokumentieren</label> <sitzung code="ak1"> <ergebnistyp>Code.verwaltungstechnischesSitzungsergebnis</ergebnistyp> </sitzung> </actionItemDropdown>
Angabe einer Codeliste: <actionItemDropdown> <label>Zeitpunkt der Rechtsprüfung</label> <codelistName>Code.RechtspruefungZeitpunkt</codelistName> </actionItemDropdown> | |
| String | Dient der Anzeige und Eingabe eines Strings. Der Wert kann in den Stammdaten, generischen Eigenschaften eines sonstigen Termins sowie am ActionItem gespeichert werden. | keine | <actionItemString>
<label>Abstimmungsbedarf benennen</label> </actionItemString> | |
| Textarea | Dient der Anzeige und Eingabe eines längeren Strings. Der Wert kann in den Stammdaten, generischen Eigenschaften eines sonstigen Termins sowie am ActionItem gespeichert werden. Um das Kommentar-Feld einer Sitzung zu setzen, muss "sitzung" angegeben sein | sitzung: Wert der Codeliste "Code.Sitzungen", wenn an einer Sitzung ein Kommentar gesetzt werden soll. | <actionItemTextarea>
<label>Beschlusskommentar dokumentieren</label> <sitzung>ak1</sitzung> </actionItemTextarea> | |
| Integer | Dient der Anzeige und Eingabe einer Ganzzahl. Der Wert kann in den Stammdaten, generischen Eigenschaften eines sonstigen Termins sowie am ActionItem gespeichert werden. | sonstigerTermin: Hier können der Wert der Codeliste "Code.SonstigeTermin" und die Eigenschaft eingetragen werden. | <actionItemInteger>
<label>Amtlicher Anzeiger Nr.</label> <sonstigerTermin code="InfoAufstellungsbeschluss" eigenschaft="amtlicherAnzeigerNummer"/> </actionItemInteger> | |
| Float | Siehe Integer, mit Fließkommazahl statt Ganzzahl. | Siehe Integer, mit Fließkommazahl statt Ganzzahl. | siehe Integer | wie Integer, mit "actionItemFloat" |
| ShowFlaggedFiles | Dient der Erstellung eines fachlichen Ordners. Ausgewählte Dateien werden mit einer Vormerkung versehen und in den fachlichen Ordner hinzugefügt. Der fachliche Ordner wird in der Dokumentenbibliothek als separater Ordner abgelegt. Word-Dateien werden automatisch nach PDF- konvertiert. Ist das Element "unterlagenTyp" mit Wert "1170" (Stellungnahme) gesetzt, werden automatisch Stellungnahmen, die die entsprechende Vormerkung besitzen, in den fachlichen Ordner ausgleitet. | vormerkung: Wert der Codeliste "Code.Vormerkungen", den die ausgeleiteten Dateien gesetzt bekommen und der den fachlichen Ordner benennt.
unterlagenTyp: Wert der Codeliste "Code.Verfahrensunterlagentyp". Wert "1170", wenn Stellungnahmen mit der identischen Vormerkung ausgeleitet werden sollen |
<actionItemShowFlaggedFiles>
<label>Umweltordner bearbeiten und abstimmen</label> <vormerkung>0300</vormerkung> </actionItemShowFlaggedFiles> | |
| BeteiligungEinrichten | Dient dem Anlegen eines Beteiligungsverfahrens in DiPlan Beteiligung. Es wird eine entsprechende XBeteiligung-Nachricht erstellt und an DiPlan Beteiligung via XTA2/FitConnect/RabbitMq übermittelt.
Zum übermitteln von Dokumenten sind chooseFileBeteiligung und uploadFileBeteiligung ebenfalls in die VK einzubinden. Angabe von bspw. Geltungsbereich über Textarea und Beteiligungszeitraum per ChangeDate. |
nachrichtenTyp: "0401" für XBeteiligungsnachricht "Planung2BeteiligungBeteiligungNeu0401" (kommunale Bauleitplanung)
codeVerfahrensschritt: CodeVerfahrensschritt aus XBeteiligung oeffentlichkeit.zeitraum: Bei Öffentlichkeitsbeteiligung der Wert des sonstigen Termins aus der Codeliste "Code.SonstigerTermin" für den Beteiligungszeitraum oeffentlichkeit.bekanntmachung: Bei Öffentlichkeitsbeteiligung der Wert des sonstigen Termins aus der Codeliste "Code.SonstigerTermin" für das Bekanntmachungsdatum oeffentlichkeit.veroeffentlichungszeitraum: Bei Öffentlichkeitsbeteiligung der Wert des sonstigen Termins aus der Codeliste "Code.SonstigerTermin" für den Veröffentlichungszeitraum oeffentlichkeit.ArtFormal: Art der formalen Beteiligung. Code.Verfahrensschritt aus XBeteiligung toeb.zeitraum: Bei TöB-beteiligung Wert des sonstigen Termins aus der Codeliste "Code.SonstigerTermin" für den Beteiligungszeitraum toeb.bekanntmachung: Bei TöB-Beteiligung Wert des sonstigen Termins aus der Codeliste "Code.SonstigerTermin" für das Bekanntmachungsdatum toeb.veroeffentlichungszeitraum: Bei TöB-Beteiligung Wert des sonstigen Termins aus der Codeliste "Code.SonstigerTermin" für den Veröffentlichungszeitraum toeb.ArtFormal: Art der formalen Beteiligung. Codeverfahrensschritt aus XBeteiligung |
Beispiel einer Konfiguration in Kombination mit weiteren ActionItems: <actionItemTextarea>
<label>Planungsanlass</label> <source updateModel="nein">verfahrensbeschreibung.beschreibungPlanungsanlass</source> </actionItemTextarea> <actionItemTextarea> <label>Geltungsbereich</label> <source updateModel="nein">verfahrensbeschreibung.beschreibungGeltungsbereich</source> </actionItemTextarea> <actionItemChangeDate> <label>Beteiligungszeitraum: </label> <datumsstatus>geplant</datumsstatus> <sonstigerTermin code="InfoFoeb.zeitraum"/> </actionItemChangeDate> <actionItemBeteiligungChooseFile> <label>Dokumente auswählen für Beteiligung</label> </actionItemBeteiligungChooseFile> <actionItemBeteiligungUploadFile> <label>Dokumente hochladen für BOP</label> <allowedUnterlagentypen>0200</allowedUnterlagentypen> <allowedUnterlagentypen>0600</allowedUnterlagentypen> <allowedUnterlagentypen>0700</allowedUnterlagentypen> <allowedUnterlagentypen>1112</allowedUnterlagentypen> <allowedUnterlagentypen>1501</allowedUnterlagentypen> </actionItemBeteiligungUploadFile> <actionItemBeteiligungEinrichten> <label>Beteiligungsverfahren einrichten</label> <nachrichtentyp>0401</nachrichtentyp> <codeVerfahrensschritt>2000</codeVerfahrensschritt> </actionItemBeteiligungEinrichten> | |
| BeteiligungAktualisieren | Dient der Aktualisierung eines Beteiligungsverfahrens. Es wird eine entsprechende XBeteiligung-Nachricht erstellt und an DiPlan Beteiligung via XTA2/FitConnect/RabbitMq übermittelt. Kombination mit weiteren ActionItems wie bei BeteiligungEinrichten. | siehe BeteiligungEinrichten | <actionItemBeteiligungAktualisieren>
<label>Beteiligung aktualisieren</label> </actionItemBeteiligungAktualisieren> (Kombination mit weiteren ActionItems wie für BeteiligungEinrichten) | |
| BeteiligungLöschen | Dient der Löschung eines Beteiligungsverfahrens in DiPlan Beteiligung. Es wird eine entsprechende XBeteiligung-Nachricht erstellt und an DiPlan Beteiligung via XTA2/FitConnect/RabbitMq übermittelt. | keine | <actionItemBeteiligungLoeschen>
<label>Beteiligungsverfahren löschen</label> </actionItemBeteiligungLoeschen> | |
| LinkPlanwerke | Verlinkt zum Reiter Planwerke. Dort kann ein Planwerk hochgeladen, validiert und veröffentlicht werden. | keine | <actionItemLinkPlanwerke>
<label>XPlanGML veröffentlichen</label> </actionItemLinkPlanwerke> | |
| ShowPlanrecht | Zeigt einen Button an, um den Kartenclient der Stammdatenseite zu öffnen. | keine | <actionItemShowPlanrecht>
<label>Planrecht anzeigen</label> </actionItemShowPlanrecht> |
