Einstieg

  • Customizer → System-Customizer → Data Dictionary

Information

  • In diesem Modul können
    • neue Dataitems angelegt werden
    • bestehende Dataitems bearbeitet werden
    • Datentabellenkopfdaten bearbeitet werden
    • Relationen einer Datentabelle bearbeitet werden

Modulvarianten

Dataitems mit Strukturblendet die Unter-Dataitems unter den DIs ein.
DB-Optionenzeigt alle für die Datenbank relevanten Parameter der DIs.
DF-Einstellungenblendet die Standardparameter für die Datenfelder, in denen die DIs eingebunden werden, ein.
DI-Verwendungblendet die Verwendungshäufigkeit der DIs ein.
Exitsblendet die Exits unter dem DI ein, auf das sie sich beziehen.
Inkarnationenblendet bei Inkarnationen die dazugehörigen Unter-Dataitems ein.
SQL Wertebereichezeigt nur die DIs an, bei denen im Feld Wertebereich "computesql" vorkommt.
Virtuelle DIszeigt nur die DIs an, bei denen die Checkbox virtuell aktiviert ist.
Wertebereicheblendet das Feld Wertebereich ein.

Datentabelle

System-Customizing aktualisieren

Achtung

  • Werden an Datentabellen oder Dataitems System-Customizing-Änderungen vorgenommen (z.B. neue Dataitems angelegt, Dataitem-Parameter geändert) muss der Menüpunkt Tools → PLANTA-Dienst neu starten ausgeführt werden, um die Änderungen sichtbar zu machen.
    • Hinweis: Betätigt man den Menüpunkt, werden alle offenen Client-Verbindungen (Sessions) geschlossen. Neue Client-Verbindungen sind während des Neustarts nicht möglich. Ausnahmen sind Änderungen an I-Texten, z.B. Änderung der DI-Bezeichnung oder Anpassungen an Wertebereichen (auch der WB-Art).
    • Vor dem Neustarten des Dienstes muss das target-Verzeichnis gelöscht werden, damit es beim Neustart des Dienstes neu angelegt werden kann, um sicherzustellen, dass die darin enthaltenen POJO-Klassen, die für die Metadaten des Data Dictionary verantwortlich sind, neu generiert werden.

Schaltfläche 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

Relationen

Information

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

Vorgehensweise

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. 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.
    • Zuordnung individueller Wertebereiche zu Standard-DIs

 Achtung

  • Da sämtliche Änderungen an Standard-Dataitems bei einem Update überschrieben werden, sollten solche Änderungen dokumentiert (individuelles ICOU) und nach dem Update nachgezogen werden oder mit dem neuen PLANTA-Konfliktmanagement-Verfahren  behandelt werden.

Hinweis

  • Die von PLANTA deaktivierten Standard-DIs dürfen von Kundenbenutzern nicht wieder aktiviert werden, da solche DIs mit hoher Wahrscheinlichkeit in einem der nach der Deaktivierung folgenden Releases gelöscht werden. Versucht ein Kundenbenutzer ein solches DI dennoch zu aktivieren, wird er mit einer Meldung davor gewarnt.
  • Die deaktivierten Dataitems werden im Modul Data Dictionary ausgegraut dargestellt.

Individuelle Dataitems anlegen

Das Anlegen, Ändern und Löschen der Dataitems in den Datentabellen der Schemas Q1B und Q2B dürfen nur von PLANTA durchgeführt werden. Die einzige Ausnahme bildet die Datentabelle DT400, die auch kundenindividuelle DIs enthalten darf.

Hinweise

  • Werden individuelle Dataitems für Datentabellen der Systemdatenbanken Q1B oder Q2B 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 sowie den Spaltentyp (im Fenster 2) vergeben und speichern.
    • Dabei wird die Nummer des neuen DI automatisch generiert und einige Felder wie z.B. DB-Typ , DF-Typ und PPMS-Typ und je nach Spaltentyp (Datentyp) andere Parameter automatisch gefüllt. 
  • Bei reellen Dataitems (Dataitems mit Parameter Virtuell = ):
    • Im Feld DI-Python-ID eine Python-ID vergeben.
    • Im Feld SQL-ID eine SQL-ID vergeben (meistens setzt man der automatischen Nummer den Zusatz „DI“ voraus, z.B. DI100001)
      • Durch Betätigen der Schaltfläche Spaltennamen setzen (im Kopfbereich des Moduls) lassen sich SQL-ID automatisch für alle angelegten DIs auf einmal eintragen.
    • 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.
    • Die Checkbox Aktiviert aktivieren.
    • Wurden beim Setzen des Spaltentyp s keine DB-Länge und DF-Länge gefüllt, diese bitte füllen.
    • Speichern.
      • Dabei wird die Meldung ausgegeben: Durch Ihre Änderungen an der DT412 muss Ihre Datenbank angepasst werden. Bitte wählen Sie die passende Datei ./xx_*.sql (je nach Datenbank-System) und führen Sie den Inhalt in Ihrer Datenbank aus.
      • Achtung: Werden in der gleichen Session weitere DIs angelegt, kommt die Information für das Schema-Update nicht mehr, die Text-Datei wird aber um die weiteren DIs erweitert.
    • Die Text-Datei, die dabei vom Schema-Update erzeugt wurde, prüfen und auf der Datenbank ausführen. Hierzu siehe auch das nächste Kapitel Dataitem in der Datenbank anlegen.

Neue Spalte(n) aus Datenbank in PLANTA anlegen

Information

  • Mit dieser Funktion können Spalten, die nur in der Datenbank, aber nicht als DIs in PLANTA-Datentabellen existieren, angelegt werden.

Vorgehensweise

  • Das Modul Data Dictionary aufrufen.
  • Die gewünschte Datentabelle aus der Listbox auswählen.
  • Die Schaltfläche Neue Spalte(n) als DI(s) anlegen betätigen.
  • Das Modul Dataitems anlegen wird geöffnet. In diesem werden alle Spalten der ausgewählten Datentabelle, die in der Datenbank, aber nicht in PLANTA vorhanden sind, angezeigt.
  • Für die Spalten, die als DIs angelegt werden sollen, die Checkbox Übernehmen aktivieren.
  • Die Schaltfläche Ausgewählte Dataitems übernehmen betätigen. Dabei werden die gewünschten Spalten in der PLANTA-Datentabelle angelegt.

Hinweis

  • Wenn es keine Spalten auf der Datenbank gibt, die nicht als DIs in PLANTA existieren, wird die Meldung Keine neuen Dataitems auf der Datenbank vorhanden angezeigt.

Dataitem in der Datenbank anlegen

Hinweis

  • Die neue Funktion Schema-Update ersetzt die Funktion Dataitem anlegen (in der Datenbank) aus dem Kontextmenü. Daher wurde dieser Kontextmenü-Befehl entfernt.

Aktionen auf Dataitems

Kontextmenü

Dataitem einfügen

Vorgehensweise zum Einfügen eines Dataitems siehe hier.

Automatische Nummer-Generierung für Dataitems festlegen

Information

  • Für bestimmte Dataitems einer Datentabelle kann festgelegt werden, ob beim Anlegen eines neuen Datensatzes mit diesem DI in der Anwendung eine automatische ID generiert werden soll.
  • Automatische IDs
    • Automatische IDs (automatische Nummern) werden nicht vom Benutzer manuell eingetragen, sondern vom System nach einer bestimmten Regel generiert.
    • Eine automatische ID wird erst erzeugt, wenn alle DIs des Fremdschlüssels des Datensatzes mit gültigen Werten und, falls vorhanden, alle Muss-Datenfelder gefüllt sind.
  • Manuelle IDs
    • werden vom Anwender selbst vergeben.

Vorgehensweise

Hinweis

  • Eine automatische Nummer muss Teil des Primärschlüssels sein.

Exit einfügen

Automatisches Anlegen von Hol-Exit-Dataitems

Exits

Ziel-Dataitems und die dazugehörigen Exits automatisch anlegen

Automatisches Anlegen von Inkarnationen und deren Unter-Dataitems

Inkarnationen

Inkarnation automatisch anlegen

Dataitem bearbeiten

Vorgehensweise

  • Klick mit der rechten Maustaste auf das Dataitem und Auswahl Dataitem bearbeiten aus dem Kontextmenü.
  • Das Modul Dataitems wird geöffnet, 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 Dataitems aufrufen.

Exit bearbeiten

Vorgehensweise

  • Klick mit der rechten Maustaste auf das Dataitem und Auswahl Exit bearbeiten aus dem Kontextmenü.
  • Das Modul Exits wird geöffnet, in dem einzelne Exitparameter bearbeitet werden können.

Format bearbeiten

Vorgehensweise

  • Klick mit der rechten Maustaste auf das Dataitem und Auswahl Format bearbeiten aus dem Kontextmenü.
  • Das Modul Formate wird geöffnet, in dem einzelne Formatparameter bearbeitet werden können.

Dataitems in Datenbereich übernehmen

Vorgehensweise

  • Im Feld DT die Nummer der gewünschten Datentabelle eintragen bzw. aus der Listbox auswählen.
  • Die Dataitems, die in den Datenbereich übernommen werden sollen, markieren.
  • Mit der rechten Maustaste auf eines der Dataitems klicken und den Kontextmenü-Befehl Dataitems in Datenbereich übernehmen auswählen.
    • Dabei werden nur die markierten Dataitems übertragen.
  • Das Modul Datenbereich auswählen wird automatisch geöffnet.
    • Ein neuer Datenbereich wird automatisch angelegt.
        • Sind noch Instanzen des Moduls Datenbereiche offen, werden die Datenbereiche ausgelesen und automatisch eingefügt.
          • Sollen die Dataitems einem anderen, bereits existierenden, Datenbereich hinzugefügt werden, kann über F4 ein neuer Datensatz in Fenster 1 angelegt werden.
          • Danach in das Feld DA die ID des gewünschten Datenbereichs eintragen.
        • Der Wert im Feld DDI wird automatisch auf das Ident von DI der entsprechenden Datentabelle gesetzt.
        • Die vorher ausgewählten Dataitems werden im Fenster 2 angezeigt.
        • Die Schaltfläche Dataitem in Bereich übernehmen betätigen.
          • Die Dataitems werden in den Datenbereich übernommen.
      • Speichern.

Achtung

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