Data Dictionary MOD009101

Einstieg

• Customizer System-Customizer Data Dictionary

Ziele

• Datentabellenkopfdaten bearbeiten
• Relationen einer Datentabelle bearbeiten
• Bestehende Dataitems bearbeiten
• Neue Dataitems anlegen

Modulvarianten des Moduls

• Dataitems mit Struktur
  • blendet die Unter-Dataitems unter den DIs ein.
• DB-Optionen
  • zeigt alle für die Datenbank relevanten Parameter der DIs.
• DF-Einstellungen
  • blendet die Standardparameter für die Datenfelder, in denen die DIs eingebunden werden, ein.
• DI-Verwendung
  • blendet die Verwendungshäufigkeit der DIs ein.
• Exits
  • blendet die Exits unter dem DI ein, auf das sie sich beziehen.
• Inkarnationen
  • blendet bei Inkarnationen die dazugehörigen Unter-Dataitems ein.
• SQL Wertebereiche
  • zeigt nur die DIs an bei denen im Feld Wertebereich "computesql" vorkommt.
• Virtuelle DIs
  • zeigt nur die DIs an bei denen die Checkbox virtuell aktiviert ist.
• Wertebereiche
  • blendet das Feld Wertebereich ein

Datentabelle

Spaltennamen setzen

Information

• Das Betätigen der Schaltfläche Spaltennamen setzen löst folgende Aktionen aus:
  • Es wird geprüft, ob das Feld SQL-ID für alle reelen Dataitems gesetzt ist.
    • Falls nein, wird die SQL-ID für die entsprechenden Dataitems gesetzt. Der Eintrag setzt sich zusammen aus dem Text "DI" und der ID aus dem Feld DI
      • Bsp: Legt man das Dataitem 100001 an und betätigt die Schaltfläche Spaltennamen setzen wird in SQL-ID der folgende Wert eingetragen: DI100001

Reload Forking-Server

Information

• Durch Betätigen der Schaltfläche Reload Forking-Server wird der Forking-Server neugestartet.
• Unter Linux muss der Forking-Server neugestartet werden, wenn
  • neue Dataitems angelegt werden (virtuell und reell)
  • Dataitem-Parameter geändert werden.

Relationen

Information

• Datentabellen sind über Relationen miteinander verknüpft. Der logische Zusammenhang der PLANTA-Software-Daten hängt also von den Relationen ab.

Vorgehensweise

• Rechtsklick auf den Datentabellenkopf.
• Einfügen Relation auswählen.
  • Ein neuer Relationsdatensatz wird eingefügt.
• Die Relation und die Relationsparameter definieren.
• Speichern.

Details

• Durch Klick auf den Link im Datenfeld Index wird die entsprechende Datentabelle anstatt der gerade geöffneten angezeigt.
• Durch Klick auf den Link im Datenfeld Ident von DI wird das entsprechende Dataitem im Modul Data Dictionary markiert.

Dataitems

Standard-Dataitems

Allgemeine Regeln

• Standard-Dataitems dürfen in der Regel nicht geändert werden, da eine Änderung bei Updates überschrieben wird.
• Ausnahmen:
  • DF-Längen werden in der Regel für alphanumerische Dataitems geändert. Hier wird zwischen DI-Klassen unterschieden:
    • DI-Klasse = 0: Klassisches alphanumerisches Dataitem
      • Die DF-Länge darf maximal den Wert der DB-Länge erhalten, da diese DIs in der Datenbank physikalisch in der Größe der DB-Länge gespeichert werden.
      • Die DB-Länge darf nicht vergrößert werden.
    • DI-Klasse = 15: Internationaler Text (I-Text)
      • Diese Dataitems verhalten sich im System wie alphanumerische DIs, werden aber in der Datenbank als nummerische DIs von 4 Byte gespeichert. Die Werte dieser Dataitems können in den verfügbaren Sprachen gespeichert werden. Ihre DF-Länge kann ohne weiteres auf 80 erhöht werden, dazu muss nur die DB-Länge angepasst werden.
• Dataitem-Bezeichnungen, die vom Standard systemweit abweichen, können einfach überschrieben werden.
• Wertebereiche
  • Das Update löscht individuelle WBs, wenn sie Standard-DIs zugeordnet sind, auch wenn ein Standard-WB dabei ist.
  • Wird einem Standard-DI mit Standard-WB ein individueller WB zugeordnet, muss dies dokumentiert werden, damit dies nach einem Update nachgezogen werden kann.

Individuelle Dataitems anlegen

Hinweise

• Das Anlegen und Ändern der Dataitems in Datentabellen der Systemdatenbanken (Q1-Q3) ist nur durch PLANTA möglich.
• Werden individuelle Dataitems für Datentabellen der Systemdatenbanken benötigt, muss eine individuelle Datentabelle mit Relation zur entsprechenden Datentabelle der Systemdatenbanken angelegt werden.
• Das Anlegen und Ändern in den Datentabellen der Anwendungsdatenbanken (Q4-Q7) ist erlaubt.

Vorgehensweise

• Das Modul Data Dictionary aufrufen.
• Die gewünschte Datentabelle aus der Listbox auswählen.
• Klick mit rechter Maustaste auf ein bestehendes DI und Auswahl Einfügen Dataitem.
• Den Namen im Feld Bezeichnung vergeben und speichern, dabei wird die Nummer des neuen DI automatisch generiert.
• Bei reellen Dataitems:
  • Im Feld DB-Pos. die Nummer vergeben, die aufsteigend zu der von dem voranstehenden DI ist. Bitte darauf achten, dass dieses Feld nicht leer bleibt.
  • Im Feld SQL-ID eine SQL-ID vergeben.
    • Durch den Button Spaltennamen setzen erfolgt dies automatisch.
  • Im Feld DI-Python-ID eine Python-ID vergeben.
  • Durch Klick auf den Button Dataitem anlegen wird das Dataitem in der Datenbank angelegt. Weitere Informationen
• Das Feld Spaltentyp füllen, dadurch werden je nach Typ automatisch weitere Felder gefüllt.
• Ggf. weitere Dataitemparameter definieren.
• Speichern.

Dataitem in der Datenbank anlegen

Kontextmenü

• Durch Klick mit der rechten Maustaste auf Dataitem anlegen lässt sich das entsprechende Dataitem in der Datenbank anlegen.
• Folgende Werte müssen hierfür eingegeben werden:
  • Bezeichnung
  • SQL-ID
  • DB-Pos.
  • Spaltentyp
    • dabei wird die SQL-ID automatisch gesetzt.
  • PPMS-Typ , DB-Typ , DF-Typ
    • diese Werte werden nach Auswahl eines Spaltentyp automatisch gesetzt.
  • DB-Länge , DF-Länge

Hinweis

• Bei unvollständiger Eingabe der relevanten Werte erscheint eine Meldung, die darauf hinweist den fehlenden Wert zu ergänzen.

Dataitems bearbeiten

Kontextmenü

• Durch Klick mit der rechten Maustaste auf das gewünschte Dataitem und Auswahl des entsprechenden Befehls aus dem Kontextmenü lassen sich für Dataitems folgende Aktionen durchführen:
  • Inkarnation/Hol-Exit definieren
  • das Modul Dataitems öffnen, in dem einzelne Dataitemparameter definiert und bearbeitet werden können.
    • Das Modul Dataitems lässt sich ebenfalls durch Klick auf den Link im Datenfeld DI des gewünschten DI aufrufen.
  • das Modul Exits öffnen, in dem einzelne Exitparameter bearbeitet werden können.
  • das Modul Formate öffnen, in dem einzelne Formatparameter bearbeitet werden können.
  • DIs in Datenbereiche übernehmen

Automatische Nummern einfügen

Information

• Automatische Identnummern werden verwendet, wenn die Identnummern nicht vom Benutzer manuell eingetragen, sondern vom System nach einer bestimmten Regel generiert werden sollen.

Vorgehensweise

• Klick mit der rechten Maustaste auf das Dataitem, das automatische Nummern bekommen soll, und Auswahl des Befehls Einfügen Automatische Nummern.
• Die Parameter für automatische Nummern festlegen und speichern.

Dataitems in Datenbereich übernehmen

Vorgehensweise

• Die Dataitems, die in den Datenbereich übernommen werden sollen, markieren.
• Klick mit der rechten Maustaste auf eines der Dataitems Dataitems in Datenbereich übernehmen.
• Das DDI wird automatisch auf das Ident von DI der entsprechende Datentabelle gesetzt.
• Speichern.

Achtung

• Es können Dataitems aus verschiedenen Datentabellen beliebig zusammengefügt werden. Wenn dies aufgrund der Relation keinen Sinn ergibt, kann es zu Fehlern in der Darstellung kommen.

Automatisches Anlegen von Hol-Exit Dataitems

Ziel

• Automatisches Anlegen von Hol-Exit Dataitems

Information

• Exits

Vorgehensweise

• Im Modul Data Dictionary Klick mit der rechten Maustaste auf das gewünschte Quell-Dataitem und Auswahl des Befehls Inkarnation/ Hol-Exit definieren
• Die Datenfelder wie folgt befüllen:
  • aus Tabelle: ID der Tabelle in der sich das zu holende Dataitem befindet
  • Dataitem: Bezeichnung des Dataitems, das geholt werden soll
• Klick auf Hol-Exit anlegen
• Es wird automatisch das Exit erstellt und das Dataitem, das dem Ziel-Dataitem entspricht.
• Speichern.

Automatisches Anlegen von Inkarnationen und deren Unter-Dataitems

Vorgehensweise