Anlage Patches

Maskenverwaltung

Erfassungsmaske

Patchbare Elementtypen

Diese Tabelle ermöglicht die Erfassung einer Liste der zu patchenden Objekte. Die Liste wird über einen Objekttyp und einen Namen beschrieben. Im Folgenden eine Definition der verschiedenen Typen sowie die Bedeutung ihrer Namen. Die Spalte Rang gibt die Reihenfolge der Elementtypen in der Patchdatei an (siehe Absatz unten). Elemente mit Rangnummer 100in der Tabelle werden stets am Ende des Patches positioniert (alphabetisch nach Elementcode sortiert).

Wichtige Hinweise

Vollständige Datenübertragung aus einer Tabelle

Mit dem Code TABkönnen Tabellendaten über ein erneutes Laden der Datenbank mitsamt ihrer Struktur und ihren Daten übertragen werden. Die Dictionary-Elemente dieser Tabelle werden hingegen nicht angelegt, weswegen die Tabelle nicht sichtbar ist. Dieser Code eignet sich also gut zum erneuten Laden einer bereits im zu patchenden Ordner angelegten Tabelle mit unveränderter Struktur. In allen anderen Fällen muss die Patch-Definition um zwei Zeilen ergänzt werden: die erste betrifft die Definition der Tabelle (ATB XXXXX), die zweite den Inhalte (TAB XXXXX). Sollten die beiden Zeilen in umgekehrter Reihenfolge eingegeben werden, werden sie von der Patch-Funktion umgeordnet. Bei Patch-Integration wird die Tabelle im Dictionary und ggf. in der Datenbank angelegt (falls sie dort bereits vorhanden ist, wird ihre Struktur ggf. aktualisiert). Danach wird die Datentabelle erneut geladen.

Teilweise Datenübertragung aus einer Tabelle

Der Inhalt einer Tabelle kann teilweise übertragen werden, wenn in der Spalte 'Typ' die Tabellenabkürzung und in der Spalte 'Name' eine logische Bedingung für die Ausgabe des Ursprungordners und für die Integration in den Zielordner formuliert wird. Wichtiger Hinweis: So ausgegebene Daten können mit den selben Schlüsseln vorhandene Daten verändern oder neue Daten anlegen. Aus Sicherheitsgründen werden aber bei der Patch-Integration niemals Daten gelöscht. So zum Beispiel in der folgenden Situation für die Ländertabelle (Abkürzung TCY):

Wird im Patch eine Zeile mit TCY und der Bedingung CRY="AL" erfasst, enthält der Patch nur die Zeile für Albanien. Bei der Integration der Patches in den Zielordner wird erneut AL geschrieben. Dieses AL steht für Deutschland und ersetzt Albanien.

Wird am Patch eine Zeile mit TCY und der Bedingung (CRY,"A") erfasst, enthält der Patch die vier Zeilen AD, AE, AF und AR. Bei der Integration werden dann die Datensätze AE (Vereinigte Arabische Emirate) und AR (Argentinien) angelegt, AL (Deutschland) durch AL (Albanien) ersetzt und A (Afghanistan) sowie AU (Australien) unverändert gelassen. Letztere wurden noch nicht ausgeliefert, befinden sich aber schon im Zielordner.

Dasselbe gilt für Patches mit einer Zeile mit TCY und der Bedingung (CRY,"AD", "AE", "AL"). Der einzige Unterschied wäre, dass AR (Argentinien) nicht übertragen würde.

Daten können nur wie folgt gelöscht werden:

• Der Inhalt einer Tabelle wird vollständig ersetzt (Patch vom Typ TAB).
• Es wird eine EXE-Verarbeitung ausgeliefert (siehe unten). Möchte man sicherstellen, dass in den Ländern mit A lediglich die Länder mit den Codes AD, AE und AL in der Liste bleiben, könnte man eine Verarbeitung mit den (z.B. unter dem Namen MAJPATCHnnn) im obigen Beispiel beschriebenen Zeilen ausliefern.

Ausführung einer Bearbeitung

Ein Sonderfall sollte erwähnt werden: der Code EXE, der es ermöglicht, den Namen einer auszuführenden Verarbeitung oder eines Skripts anzugeben. Trotz seiner Rangnummer wird diese Verarbeitung am Ende der Patch-Integration ausgeführt (sie kann bereits vorher existieren oder mit dem Patch ausgeliefert worden sein).

Die Verarbeitung muss ein PATCH-Unterprogramm mit einem dem Ordnercode entsprechenden Parameter integrieren. Dieses Unterprogramm wird dann ausgeführt. Im obigen Fall erhält man folgendes Programm:

Subprog PATCH(NOMDOS)
Value Char NOMDOS
Local File =NOMDOS+".TABCOUNTRY" [TCU]
Trbegin [TCU]
Delete [TCU] Where pat(CRY,"A*")=1 & find(CRY,"AD","AE","AL")=0
Commit
End

Wie man oben sehen kann, müssen die Tabellen in diesem Unterprogramm unter Berücksichtigung ihrer Deklaration in einem Ordner deklariert werden, auch wenn es sich bei diesem nicht unbedingt um den aktuellen Ordner handeln muss (dies wird durch die Syntax Local File = NOMDOS + ".NOMTABLE" sichergestellt).

Auszuführende generische Bearbeitungen

Werden Patches auf Vorlagenelementen der Benutzerschnittstelle realisiert (Vorlagemasken zur Anlage von Transaktionsfenstern), ist eine erneute Freigabe der betroffenen Masken erforderlich.

Diese erneute Freigabe kann während der Wartung bei Ausführung der entsprechenden Verarbeitung ausgeführt werden. Im Folgenden werden die aufzurufenden Standardverarbeitungen nach Typ des gepatchten Elements beschrieben:

Dieser Funktionalitätstyp kann auch spezifisch realisiert werden (hierfür ist lediglich, wie oben beschrieben, das Unterprogramm PATCH hinzuzufügen).

Dokumentationspatch

Die Datenstruktur der Dokumentation ist relativ speziell. Standardmäßig werden bei Anlage und erneuter Freigabe von Ordnern folgende Regeln angewendet:

• Die Dokumentationstexte und -dateien (Tabellen ADOCBLB und ADOCCLB) werden im Supervisor-Ordner ausgefüllt und nicht in die abhängigen Ordner übertragen (es können jedoch lokale Hilfetexte in einem Ordner angelegt und lokal gespeichert werden).
• Die Dokumentationsstruktur (Dokumentationslinks, also quasi Dictionary-Elemente, sowie Absatzstruktur) wird in jedem Ordner gespeichert und im Falle einer erneuten Freigabe in die Ordner der niedrigeren Ebenen kopiert (unter Beibehaltung des vertikalen oder spezifischen Aktivitätscodes, der in einem abgeleiteten Ordner hätte definiert worden sein können).

Für Patch-Integrationen vom Typ Doc (Typ ADO), gilt Folgendes:

• Die Dokumentationsstruktur ist in alle bei Anwendung des Patches aufgelisteten Ordner integrierbar. Dies gilt unabhängig vom Patchtyp (in Abhängigkeit der bei Integration vorgegebenen Ordnerliste).
• Die Texte und Dateien werden nur bei Patchtyp Supervisor in den Supervisor-Ordner integriert (dies trifft auf die Standard-Dokumentationspatches zu). Bei anderen Patchtypen können Texte und Dateien in alle Ordner integriert werden.
• Ein Patch vom Typ ADF (Links) ist auch dann in alle Ordner integrierbar, wenn es sich um einen Patch vom Typ Supervisor handelt.

Benennung der Patchdateien

Bei der Patch-Integration wird bei Patchdateien mit numerischer Sequenz im Dateinamen geprüft, ob die Integration der Dateien sequenziell erfolgte. Die Patchdateien sollten in der Form X_yyyy_zzz.dat benannt werden, wobei gilt:

• X ist ein Zeichen (ungleich P, da P für die Standardpatches verwendet), das den Patchtyp beschreibt.
• yyyy ist eine sequenzielle Nummer (beginnend mit 0001).
• zzz steht für die zu integrierende Version.

Entspricht der Dateiname diesem Muster, werden bei Integration von Pachdateien in ein Verzeichnis folgende Prüfungen durchgeführt:

• Alle integrierten Dateien müssen Patches zur selben Version sein.
• Es darf keine Sequenznummer übersprungen werden, wenn Patches mit dem gleichen Zeichen und der gleichen Versionsnummer bereits integriert wurden. Beispiel: Wurde Patch Z_0005_150.dat bereits integriert und soll nun Z_0007_150.dat integriert werden, wird bei der Integration eine Fehlermeldung ausgegeben.

Reihenfolge der Elemente in einer Patchdatei

Bei Anlage einer Patchdatei müssen die darin enthaltenen Patchelemente so gewählt werden, dass der Ordner kohärent bleibt. Wird beispielsweise per Patch eine neue Funktion angelegt, muss der Patch auch alle zugehörigen Elemente wie Fenster, Maske, Tabelle und / oder Verarbeitungen enthalten.

Um Fehler bei der Integration zu vermeiden, werden die Patchelemente von der Patch-Anlagefunktion in eine bestimmte Reihenfolge gebracht. So wird beispielsweise beim Versuch, ein Fenster vor den zugehörigen Masken zu integrieren, bei der Freigabe die Fehlermeldung Maske nicht vorhanden ausgegeben. So müssen vor den Masken und Tabellen immer zunächst die Datentypen integriert werden, vor den Fenstern die Masken etc.

Die bei der Patchgenerierung zu beachtende Reihenfolge ist dabei der nachstehenden Tabelle zu entnehmen. Diese Reihenfolge wird auch von der Funktion Automatischer Patch vorgeschlagen.

Jedoch können dennoch immer wieder Probleme auftreten - eine völlig konfliktfreie Reihenfolgendefinition ist nicht möglich. Beispielsweise kann ein Datentyp eine Aktion referenzieren, diese Aktion kann ein Fenster referenzieren, das wiederum eine Maske referenzieren kann, der genau diesen Datentyp referenzieren kann. Um solche (seltenen) Konflikte aufzulösen, kann es erforderlich sein, die Patchdatei in zwei Dateien aufzuteilen. Die erste lieferte dabei alle Elemente mit einem die Aktion nicht referenzierenden Datentyp, die zweite den Datentyp der Aktion.

Nicht gepatchte Dictionary-Elemente

Wenn Sie einen Patch mit Dictionary-Elementen installieren, werden bestimmte Felder als parametrisierbare Dictionary-Elemente betrachtet. Sie bleiben auch über den Schutz durch ihren Aktivitätscode hinaus unverändert. Dies gilt z.B. für das Standardempfängerkonto in einem Report.

Diese geschützten Felder sind im Technischen Anhang aufgeführt.

Sonderformat der AAA-Elemente

Ein Patch vom Typ AAA entspricht einer Position aus einer Parametrisierungsvorlage. Für den Elementcode benutzt diese Position ein spezielles Format. Hierbei handelt es sich um eines der beiden folgenden Formate:

MODELE~CODE_LEG~CODE_TRS~='FORMULE_SELECTION'

MODELE~CODE_LEG~CODE_TRS~CLE~SOUS_CLE~SOUS_SOUS_CLE...

In diesen Zeilen:

• entspricht MODELE dem Datenmodell, das zur Beschreibung der auszugebenden Tabellen verwendet wird
• entspricht CODE_LEG dem möglicherweise leeren Rechtsordnungscode (es können zwei aufeinander folgende ~ vorhanden sein)
• entspricht CODE_TRS dem möglicherweise leeren Transaktionscode
• entspricht FORMULE_SELECTION einer Filterbedingung. Da die Formel 'in einfachen Anführungszeichen' eingeschlossen wird, müssen Zeichenketten in "doppelten Anführungszeichen" eingeschlossen werden.
• entspricht CLE~SOUS_CLE~SOUS_SOUS_CLE dem Sonderfall, wenn lediglich ein Schlüsselwert zur Haupttabelle des Modells gewählt werden soll (die Anzahl von Unterschlüsseln ist nicht fest). Dieser Typ ist nur dann möglich, wenn ein Modell (Code AAA) aus der Patchanlage aufgerufen wird, und wenn außerdem das Fenster zur Modellauswahl geöffnet und dort der Schlüssel per Direktsuche erfasst wird.

Reports

Standardmäßig sind der Funktion folgende Reports zugeordnet :

 PRTSCR : Druck Maske

Dies kann durch geeignete Parameter geändert werden.

Batchaufgabe

Diese Funktion kann im Batch gestartet werden,. Zu diesem Zweck ZPATCHC ist die Standardaufgabe vorgesehen.

Spezifische Aktionen

Fehlermeldungen

Während der Erfassung können außer den generischen Meldungen folgende Fehlermeldungen auftreten: :

…. : Verzeichnis existiert nicht

Der Zugriffspfad auf die Patchdatei existiert nicht

Objekttyp nicht korrekt

Der Objekttyp entspricht weder einem vordefinierten Objekttyp, noch der Abkürzung einer vorhandenen Tabelle.

XXXX Kein Dictionary vorhanden.

Es wurde versucht, Daten aus einem nicht vorhandenen Dictionary auszugeben.

Wert nicht korrekt

Die Ausgabebedingung für die Ausgabe von Tabellendaten ist syntaktisch nicht korrekt.

Verwendete Tabellen

Siehe Dokumentation Umsetzung