Übersicht (Perspektive Kommunikation, Nachrichten...)
Fachlich/inhaltliche Beschreibung
Die Perspektive Kommunikation, Nachrichten… umfasst die ASYS-Repositoryobjekte der Nachrichten, Kommunikationspartner und Kommunikationsjobs des ASYS-Kommunikationsservers. Die genannten Objektklassen sind global für alle Repository-Standorte gültig und nutzbar.
Die in dieser Perspektive konfigurierbaren Repository-Objekte sind:
- Nachrichten: Die Nachrichten sind die Nachrichtentypen, mit denen Datensätze zwischen ASYS-Repository-Standorten manuell oder automatisch ausgetauscht werden können. Jeder Nachrichtentyp stellt dabei einen Ausschnitt des ASYS-Datenmodells dar, wobei dieser Ausschnitt sich über eine oder mehrere miteinander verknüpfte Tabellen des Datenmodells erstreckt (Kommunikationsbaum). Die Nachrichtentypen sind in einem Baum entsprechend dem Navigationsbaum der Anwenderoberfläche angeordnet. Jeder Nachrichtentyp ist einer Hauptdatenkategorie/Maske zugeordnet. Einer Hauptdatenkategorie/Maske können mehrere Nachrichtentypen zugeordnet sein. Hauptdatenkategorien/Masken ohne Nachrichtentyp sind nicht im Baum aufgeführt.
Zu jedem Nachrichtentyp können zwei Tochterobjekte gehören:- Regelmenge: Für den Empfang einer Nachricht eines bestimmten Nachrichtentyps kann diesem jeweils eine Nachrichtenregelmenge zugeordnet sein. Eine Nachrichtenregelmenge ist auf die gleiche Weise aufgebaut, wie ein Prüfplan für die Oberfläche. Das Ergebnis wird - wie das Ergebnis des Oberflächenprüfplans - in einer Fehlerprotokolltabelle des jeweiligen Datensatzes in der Datenbank gespeichert.
Wichtig: Mit ASYS7 ist der Prüfmechanismus geändert worden: Beim Nachrichteneingang wird zunächst der Nachrichtenprüfplan und anschließend der fachliche Prüfplan ausgeführt. Aus diesem Grunde sind im Nachrichtenprüfplan nur noch Prüfungen enthalten, die beim Nachrichteneingang zusätzlich ausgeführt werden sollen - z.B. die Prüfung auf Einhaltung des erlaubten Wertebereiches für Datumsangaben. Die Prüfungen, die in bislang in beiden Prüfplänen enthalten waren, sind nun nur noch im Oberflächenprüfplan enthalten. - Empfängerermittlung: Für einen automatischen Abgleich aller Datensätze in ASYS, die in mehr als nur einer Datenbank (entspricht in der Regel einem Bundesland) auf einem einheitlichen Stand gehalten werden sollen, können die betreffenden Datensätze mit Empfängerermittlungsskriptmengen versehen werden. In diesen Skriptmengen - sie bestehen, vergleichbar zu Regelmengen, aus Skriptgruppen und diese wiederum aus Skripten - lassen sich ein oder mehrere Empfänger aus der Liste der Kommunikationsparter als Empfänger einer Nachricht des jeweiligen Typs ermitteln. Mit den Skripten ist es möglich, die Datensätze in Abhängigkeit ihres Inhalts (z.B. behördlichen Nummern von Beteiligten oder behördliche Nummern von Vorgängen) nur den jeweils betroffenen Empfängern (meist die ASYS-Knotenstellen der Bundesländer) zuzusenden. Für einen Datensatz wird nur dann geprüft ob bzw. welche Empfänger ihn erhalten sollen, wenn er seit der letzten Versendung verändert wurde.
- Kommunikationspartner: Kommunikationspartner sind Repository-Standorte. Einstellungen zur Kommunikation, die pro Sender/Empfänger vorgenommen werden müssen, sind dieser Objektart zugeordnet.
Kommunikationspartner gibt es in zwei Hauptvarianten, als 'normale' ASYS-Kommunikationspartner und als WebService-Kommunikationspartner. Da sich diese beiden Varianten in wichtigen Konfigurationsparametern unterscheiden, werden sie zwar gemeinsam im Objektbaum verwaltet, aber mit unterschiedlichen Objektklassenicons angezeigt. - Kommunikationsjobs: Die automatisierte Kommunikation wird vom ASYS-Kommunikationsserver (AsysComServer) erledigt. Ausführliche Informationen zu den Kommunikationsjobs finden sich in der Spezifikation (s. 5. Jobs und Auslösen von Jobs ff. und 6. Empfang - Protokollierung und Ablauf der Jobs ff.) In der Standardkonfiguration findet dieser Service in mehreren separaten Schritten statt:
- Abholung VPS BMU: Abholung der BMU-XML-Dokumente aus dem Knotenstellenpostfach der ZKS-Abfall via OSCI-Protokoll. Die abgeholten Nachrichten werden in der Datenbank abgelegt. Protokollierung in den Protokollen 'Nachrichtenabholung' und 'Empfangene Nachricht'. Die Nachrichten werden noch nicht importiert. Dies geschieht erst bei der Ausführung des Jobs 'Empfang BMU'.
- Abholung VPS ASYS intern: Abholung der ASYS-internen Nachrichten aus dem Knotenstellenpostfach der ZKS-Abfall via OSCI-Protokoll. Die abgeholten Nachrichten werden in der Datenbank abgelegt. Protokollierung in den Protokollen 'Nachrichtenabholung' und 'Empfangene Nachricht'. Die Nachrichten werden noch nicht importiert. Dies geschieht erst bei der Ausführung des Jobs 'Empfang ASYS intern'.
- Abholung Verzeichnisse: Abholung von Nachrichten aus Verzeichnissen. Es werden alle Empfangsordner aller Kommunikationspartner überprüft, bei denen ein Empfangsordner angegeben ist. Dieser Jobtyp dient in erster Linie der Abholung von Nachrichten mit den Nachrichtenformaten 'Extern-XML' und 'Text-CSV'. Es werden allerdings auch die aus einem Registerauszug extrahierten und damit zum Import bereitgestellte Nachrichten im Empfangsordner des Kommunikationspartners mit dem Nachrichtenformat 'BMU-XML' abgelegt. Die abgeholten Nachrichten werden in der Datenbank abgelegt. Protokollierung in den Protokollen 'Nachrichtenabholung' und 'Empfangene Nachricht'. Die Nachrichten werden noch nicht importiert. Dies geschieht erst bei der Ausführung eines der Jobs 'Empfang …' (in Abhängigkeit vom Nachrichtenformat).
- Empfang BMU: Verarbeitung/Import aller Nachrichten mit dem Nachrichtenformat 'BMU-XML', die erfolgreich abgeholt aber noch nicht verarbeitet wurden. Protokollierung in den Protokollen 'Empfangene Nachricht', 'Empfangener Datensatz' und 'Prüfergebnis'.
- Empfang ASYS intern: Verarbeitung/Import aller Nachrichten mit dem Nachrichtenformat 'ASYS-intern', die keine 'ASYS-interne Quittung' sind und erfolgreich abgeholt aber noch nicht verarbeitet wurden. Protokollierung in den Protokollen 'Empfangene Nachricht', 'Empfangener Datensatz' und 'Prüfergebnis'.
- Empfang Sonstige: Verarbeitung/Import aller Nachrichten mit den Nachrichtenformaten 'Extern-XML' oder 'Text-CSV', die erfolgreich abgeholt aber noch nicht verarbeitet wurden. Protokollierung in den Protokollen 'Empfangene Nachricht', 'Empfangener Datensatz' und 'Prüfergebnis'.
- Empfang ASYS-QT: Verarbeitung/Import aller Nachrichten mit dem Nachrichtenformat 'ASYS-intern', die eine 'ASYS-interne Quittung' sind und erfolgreich abgeholt aber noch nicht verarbeitet wurden. Protokollierung im Protokoll 'Empfangene Nachricht' und 'Versandter Datensatz'.
- Quittierung BMU: BMU-Quittungserstellung und -versand für alle erfolgreich verarbeiteten Nachrichten mit dem Nachrichtenformat 'BMU-XML', für die eine Quittung erstellt werden soll. Protokollierung in den Protokollen 'Empfangene Nachricht', 'Versandte Nachricht' und 'Versandter Datensatz'.
- Quittierung ASYS intern: ASYS-interne-Quittungserstellung für alle erfolgreich verarbeiteten Nachrichten mit dem Nachrichtenformat 'ASYS-intern', für die eine Quittung erstellt werden soll. Die Quittungen werden im '…Outgoing-Ordner' abgelegt (und beim nächsten OSCI-Versand versandt). Protokollierung im Protokoll 'Empfangene Nachricht'.
- PreVersand: Ermittlung aller zu versendenden Datensätze und Ermittlung der Empfänger anhand der Empfängerermittlungsskripte. Generierung von Nachrichten im ASYS-internen XML-Format für alle Datensatz-Empfänger-Pärchen.
- OSCI-Versand: Versand aller generierten Nachrichten via OSCI-Protokoll an das jeweilige Empfängerpostfach der Kommunikationspartner in der VPS der ZKS-Abfall. Der OSCI-Versand verschickt alle ASYS internen Nachrichten aus dem '…Outgoing-Ordner' an die VPS. Hierbei werden die OSCI-Quittungen geordnet abgelegt und es erfolgt eine Protokollierung in den Versandtabellen.
- Batchausführung: Es findet ausschließlich die Ausführung der Pre- und Post-Batchjobs statt. Dieser Jobtyp kann z.B. verwendet werden, um vor oder nach anderen Jobs Nachrichtendateien mittels Konsolenkommandos auf Betriebssystemebene zu kopieren, zu verschieben oder zu archivieren. Dieser Jobtyp kann nicht in der Serverüberwachung des Kommunikationsservers manuell gestartet werden.
- AsysServer: Der ASYS-Kommunikationsserver (AsysComServer), der ASYS-WebServer (AsysWebServer) und der ASYS-Funktionsserver (AsysJobServer) arbeiten als eigenständige Serverprozesse. Damit diese Programme überwacht und beeinflusst werden können, müssen ihre IP-Adressen bzw. DNS-Namen hinterlegt werden.
- Freie Empfängerermittlungsskriptmengen: So wie sich Regelmengen als 'freie Regelmengen' ohne Zuordnung zu einer Maske im Repository für eine spätere Verwendung vorhalten lassen, können auch Skriptmengen der Empfängerermittlung ohne Zuordnung zu einer Nachricht als 'freie Empfängerermittlungsskriptmenge' verwaltet werden. Im Unterschied zu den 'freien Regelmengen' können 'freie Skriptmengen' auch bearbeitet werden.
Bedienung
Der Objektbaum
Der Objektbaum auf der linken Seite enthält kein Wurzelelement, sondern auf oberster Ebene fünf kursive Einträge, welche den Baum in Objektklassen gliedern:
- Nachrichtentypen mit
- keiner oder einer Regelmenge eines Nachrichtenprüfplans
- keiner oder einer Skriptmenge einer Empfängerermittlung
Unterhalb dieser Gliederungsüberschriften finden sich die Objekte der jeweiligen Klasse. Jedes Objekt trägt im Baum das Icon seiner Klasse:
Filterung des Objektbaums
Der Objektbaum bietet die übliche Filterung der Baumobjekte nach Namensbestandteilen (s. allgemeine Hilfe zum Objektbaum).
Über den Filterbutton () kann der Maskenbaum nach Eigenschaften gefiltert werden. Es öffnet sich ein Dialog zur Auswahl von Maskeneigenschaften:
Der Baum lässt sich einschränken auf Nachrichten mit
- einer Regelmenge (= Nachrichtenprüfplan) ODER
- einer Skriptmenge zur Empfängerermittlung
Werden diese Eigenschaften für den Filter kombiniert, so werden alle Nachrichten angezeigt, die zumindest eines der beiden Filterkriterien erfüllen (ODER-Bedingung).
Ein Objekt zur Bearbeitung auswählen
Ein Objekt wird im Baum durch Doppelklick zur Bearbeitung ausgewählt. Im Bearbeitungsbereich öffnet sich ein Tab-Reiter mit den Konfigurationsdaten des Objektes. Der Tab-Reiter trägt den Namen des Objektes. War bereits ein Tab-Reiter im Bearbeitungsbereich mit dem Objekt geöffnet, wird dieser Tab-Reiter im Bearbeitungsbereich nach vorne geholt.
Ein Objekt neu anlegen
Ein Objekt neu anzulegen kann auf zwei unterschiedlichen Wegen erfolgen:
- Über den Neu-Button in der Tool-Leiste des Objektbaums oder
- Über einen Rechtsklick im Objektbaum.
In beiden Fällen öffnet sich ein Menü mit den Einträgen:
Nachrichtentypen können nicht neu angelegt werden, sie werden durch die Entwickler vorgegeben.
Je nach Objektklasse öffnet sich ein anderer Dialog, um zumindest die Pflichtfeldinhalte für ein neues Objekt entgegenzunehmen. Nachdem dieser Dialog mit dem Ok-Button verlassen wurde, öffnet sich im Bearbeitungsbereich ein Tab-Reiter für die weitere Konfiguration des neuen Objektes.
Neuer Prüfplan
Diese Option steht nur zur Verfügung, wenn im Baum ein Nachrichtentyp markiert ist, für den es noch keinen Prüfplan gibt.
Es gelten die Erläuterungen für die Regelmengen bei den Masken. Sie werden daher nachfolgend zwischen den horizontalen Linien erneut angezeigt:
Einziger Unterschied:
- Der Name des Nachrichtentyps wird als letzter Teil des Regelmengennamens vorgeschlagen (nicht der Maskenname).
Neuer Prüfplan
Für einen neuen Prüfplan ist ein neuer Prüfplanname einzutragen. Der Name des Prüfplans muss einmalig im Repository sein. Als Standard wird ein Name vorgeschlagen, bestehend aus dem Standortkürzel des aktuellen Repositorys (hier: IKA), dem Wort 'Prüfplan' und dem Namen der Maske (des Aufgabenbereichs).
Der Dialog enthält zwei Buttons:
Der Auswahldialog kann in üblicher Weise nach Namensbestandteilen des Prüfplannamens gefiltert werden.
Neue Empfängerermittlung
Diese Option steht nur zur Verfügung, wenn im Baum ein Nachrichtentyp markiert ist, für den es noch keine Empfängerermittlungsskriptmenge gibt.
Für eine neue Skriptmenge ist ein Skriptmengenname einzutragen. Der Abfragename muss einmalig im Repository sein. Wird ein bereits vergebener Name erneut eingegeben, erfolgt eine entsprechende Fehlermeldung.
Mit dem Button Freie Empfängerermittlungsskriptmenge übernehmen () wird ein Auswahldialog der freien Empfängerermittlungsskriptmengen geöffnet.
Auf der linken Seite befindet sich die Liste aller freien Empfängerermittlungsskriptmengen, auf der rechten Seite werden die Skriptgruppen und Skripte der aktuell links markieren Skriptmenge angezeigt. Die Auswahl der Skriptmenge erfolgt über den Button Übernehmen. Der Name der Skriptmenge wird zunächst in den Dialog 'Neue Empfängerermittlung' übernommen, kann dort aber noch angepasst werden.
Neuer Kommunikationspartner
Für einen neuen Kommunikationsparter ist eine Standortname auszuwählen. Kommunikationspartner können nur Repository-Standorte werden, daher enthält der Dialog eine Liste aller Repository-Standorte, die noch nicht als Kommunikationspartner im Objektbaum eingetragen sind.
Mit dem Ankreuzfeld Web-Service wird festgelegt, ob es sich um einem normalen Kommunikationsparter handelt (= nicht angekreuzt; Default) oder um einen Kommunikationspartner, der via WebService auf ASYS-Bestandteile zugreift (= angekreuzt).
Neuer Kommunikationsjob
Für einen neuen Kommunikationsjob sind eine Name und ein Job-Typ einzutragen. Der Name muss einmalig im Repository sein. Wird ein bereits vergebener Name erneut eingegeben, erfolgt eine entsprechende Fehlermeldung. Der Job-Typ wird aus einer Liste vorgegebener Typen (s.o.) ausgewählt, die nicht verändert werden kann.
Ein Objekt kopieren
Um ein Objekt zu kopieren, muss es im Objektbaum markiert sein (es muss nicht notwendigerweise auch im Bearbeitungsbereich geöffnet sein!).
Grundsätzlich wird für kopierbare Objekte eine möglichst vollständige Kopie unter neuem Objektnamen angelegt. Meist wird ein Objektname auf der Basis der Vorlage ergänzt um den Namensbestandteil 'Kopie' als neuer Objektname vorgeschlagen.
Im Objektbaum kopiert werden können die Objekte:
Ein Objekt löschen
Um ein Objekt zu löschen, muss es im Objektbaum markiert sein (es muss nicht notwendigerweise auch im Bearbeitungsbereich geöffnet sein!).
Aus dem Objektbaum gelöscht werden können die Objekte:
Die Auswahllisten
In dieser Perspektive stehen drei Auswahllisten zur Verfügung:
Weitere Informationen zu dieser Maske | ||||||||||||||||
keine | ||||||||||||||||
landesspezifische Zusatzinformationen: | SH | HH | NI | HB | NW | HE | RP | BW | BY | SL | BE | MV | ST | BB | TH | SN |