Customizing-FAQ

Allgemeines

Was ist Python?

objektorientierte

aspektorientierte

funktionale

Warum Python?

Wo finde ich die Beschreibung der Python-Funktionen, die PLANTA bereitstellt?

Die Funktionen werden in der Python-API beschrieben.

Was ist ein DTP?

DTP bedeutet Data Table Pool. Die PLANTA-Software legt dort alle aus der Datenbank geladenen (z.B. per Modul-Suche, oder mit Python-Funktionen: search_record, get_children etc.) Datensätze ab. Die Datensätze werden dann dort zur Darstellung in einem oder mehreren Modulen vorgehalten.

Wie kann man den Systemtitel ändern?

Hinweis

• Alternativ kann auch zur Laufzeit der Systemtitel mit der folgenden Python-Funktion geändert werden:

 ui_set_system_title(title: string) 

Tipp

• Zur Auseinanderhaltung von verschiedenen Sessions können z.B. der aktuell angemeldete Benutzer und die PID im Systemtitel angezeigt werden.
  • Das Modul Pythonmakros öffnen und in der on_load-Methode des Benutzermenüs folgende Zeilen einfügen:
  • Die folgenden Zeilen müssen, wie auch die anderen Zeilen in der on_load-Methode, mit jeweils vier Leerzeichen eingerückt werden.

PID = str(os.getpid())
ppms.ui_set_system_title('Systemtitel' + ', PID: ' + PID + " - " + ppms.uvar_get("@1"))

Details

• Ab dem nächsten Start von PLANTA project wird die PID im Systemtitel angezeigt.
  • Die PID ist auch Bestandteil des Logfiles, sodass ein Logfile immer der entsprechenden Session zugeordnet werden kann.

Wie kann man den Editor ändern, der aufgerufen wird?

Wie richte ich die PLANTA-E-Mail-Funktion (um E-Mails direkt zu versenden) ein?

Technik

Wie wird die I-Nummer für einen I-Text generiert?

PLANTA generiert anhand des Eintrages in der schemaspezifischen Zählerstandtabelle eine neue I-Nummer für einen I-Text.

Abhängig von der Lizenz und des I-Nr. DIs, wird der Wert des Zählerstand 1 DIs ausgelesen und für einen neuen I-Text genommen.

• Beispiel für Q2B
  • Zählerstandtabelle: DT 396 Zählerstand Q2B
    Lizenzdataitem: DI 008150 Lizenz = Kundenlizenz
    DI-Dataitem: DI 008152 DI = 000985 (I-Nr. DI aus der DT434 I-Nr. Q2B)
    Zählerstanddataitem: DI 008164 Zählerstand 1

Hat sich etwas bei den I-Texten generell geändert?

I-Texte werden in PLANTA project nur noch in der schemaspezifischen I-Text-Tabelle abgelegt.

Die I-Nummern-Tabelle wird nicht mehr gepflegt und befüllt.

Customizing

Was kann ich tun, um die Performance zu verbessern?

• Sind die meisten Module langsam,
  • prüfen, ob die Umgebung den Hardware-Anforderungen entspricht
• Ist ein spezielles Modul langsam,
  • Filterkriterien überprüfen (Filtern von, Filtern bis, Regulärer Ausdruck)
    • Sind auch Filterkriterien auf reellen und nicht nur auf virtuellen Datenfeldern (Dataitems)
      • Grund: Filterkriterien auf reellen Dataitems werden in der Datenbank ausgewertet, die auf virtuellen im Hauptspeicher – d.h. wenn in einem Modul nur Filterkriterien auf virtuellen Dataitems gesetzt sind, werden erst alle Daten in den Hauptspeicher geladen, um dann dort auf die Filterkriterien einzuschränken.
        • Bei virtuellen Datenfeldern wird der Wert in Filtern von und Filtern bis rot und fett markiert.
      • Das gleiche gilt für reguläre Ausdrücke.
    • Die meisten Wertebereiche und Hol-Exits können in einen Python-Wertebereich mit der Funktion computeSqlValueRange() umgewandelt werden. Felder mit solchen Wertebereichen sind der Datenbank bekannt. Daher wirken Filterkriterien auf diesen Feldern nicht erst im Hauptspeicher, sondern auf der Datenbank.
  • Implizite Hol-Exits sollten aus Performancegründen nicht in Modulen mit großen Datenmengen verwendet werden.
• Ist das Laden eines Panels langsam, oder stockt das Laden der Reiter bei bestimmten Untermodulen,
  • die Python-Makros der Untermodule überprüfen
• Ist eine bestimmte gecustomizte Funktion langsam,
  • überprüfen, ob das Makro dieser Funktion das Nachladen von noch nicht vollständig geladenen Untermodulen im aktuellen Panel auslöst.

Wie kann ein Hol-Exit mit den neuen Python-Wertebereichen ersetzt werden?

• Auf DI A ist ein Hol-Exit mit den folgenden Eigenschaften gecustomized:
  • Quell-DI = DI B
  • Hol-DI = DI C
  • DT Hol-DI = DT X
• Schlüssel-DI der DT X = DI D
• DI-Python-ID von DI A = python_name

• Auf dem DI A
  • das Exit entfernen
  • WB-Art auf PY umstellen
  • den folgenden Wertebereich in das Feld Wertebereich einfügen

def computeSqlValueRange(dt_name):
    val = "Select diC from dtX where diD={0}.diB".format(dt_name)
    return str(val)

Hinweis

• Mit diesem Customizing ändert sich das DI nicht sofort, wenn sich etwas am Quell-DI ändert, sondern erst nach erneutem Filtern.
• Damit sich das DI sofort ändert, muss zusätzlich die folgende Vorgehensweise durchgeführt werden.

Vorgehensweise

• Auf DI B
  • WB-Art auf PY umstellen
  • den folgenden Wertebereich in das Feld Wertebereich einfügen

def processInput(di, oldvalue):
    val = ppms.db_select("Select diC from dtX where diB='{0}'".format(di.get_value()))
    
    # check if resource exists
    if val: return_value=val[0][0]
    else: return_value=""
    
    # set new value on resource_name (sql value range)
    di.get_dtp_record().get_di("python_name").set_value(return_value)
        
    return di.get_value()
processInput.deps = ("DIA",)

Beim Customizen eines Python-Wertebereichs kommt eine Fehlermeldung. Was bedeutet sie?

Beispiele für Fehlermeldungen

• IE: "deps" attribute of computeOutput() function in WB code of DI100001 must be a tuple. The function won't be available.
  • Bedeutung: In der Dependency muss ein Tupel angegeben werden. D.h. soll die Funktion nur eine Dependency haben, gibt man das wie folgt an: deps = ('DI012345',). Weitere Informationen zu Dependencies
• IE: processInput() function must take exactly 2 arguments (DataItem reference and old DI value), but in WB code of DI 100001 it takes 1 argument(s) and thus won't be available.
  • Bedeutung: Die Funktion processInput() erfordert zwei Übergabe-Werte ( di, oldvalue). Weitere Informationen zu den Python-Wertebereichs-Funktionen

Hinweis

• Weitere Informationen zu Fehlermeldungen in Python-Wertebereichen

Wie kann ich die Funktion Terminplan kopieren erweitern?

Beispiel: Es sollen zusätzlich die Offene Punkte-Notizen kopiert werden.

• Einen Datenbereich aus der DT805 Offene Punkte-Notizen anlegen.
  • Tipp: den entsprechenden Datenbereich aus dem Terminplan (im Standard: 0099AN) kopieren.
• Eine DA-Python-ID vergeben (z.B. open_item_notices_area).
• Den Datenbereich in das Modul Terminplan kopieren (0099J9) einbinden.
• In der Python Modulunterklasse schedule_copy.py den neuen Bereich in die default_props aufnehmen.
  • Schlüssel: DA-Python-ID des Datenbereichs
  • Werte: eine Liste der DF-Python-IDs der Felder, die kopiert werden sollen, z.B.:

'open_item_notices_area': ["note","finished"]

• • Vorsicht: Nach der folgenden Zeile das Komma nicht vergessen:

'ress_area': ["..."],

Was sind implizite Hol-Exits?

Details

• Um Daten aus übergeordneten Datentabellen anzuzeigen, muss kein Exit gecustomized werden, es kann einfach das Dataitem selbst in den Datenbereich mit aufgenommen werden.

Wie kann ich ein eigenes Produktlogo (Firmenlogo) hinterlegen?

• Um pro Modul ein individuelles Produktlogo zu hinterlegen:
  • Im Modul OLEs ein neues OLE-Objekt für das Produktlogo anlegen.
  • Für das gewünschte Modul im Modul Weitere Modulparameter im Feld Produktlogo die Identnummer des neu angelegten OLE-Objekts eintragen.
• Um das Logo in der Kopfzeile (Druckkopf) in den Standarddruckbereichen auszutauschen:
  • Den Datenbereich mit Positionierung = 3 ( Druckbereich: Kopfzeile) des Moduls, das im Skin des angemeldeteten Benutzers im Datenfeld Modul für Druckber. hinterlegt ist aufrufen.
  • Dort die Identnummer des OLE-Objekts mit der des neu angelegten OLE-Objekts ersetzen.
• Das Logo in individuellen Druckbereichen muss ggf. genauso ausgetauscht werden.

Beim Starten meines Moduls kommt eine leere Dialogmeldung. Warum?

Wie wird die Höhe und Breite von Listboxen eingestellt?

• Die Höhe (bzw. Breite) von Listboxen muss nicht manuell eingestellt werden, sondern sie wird anhand der Anzahl der Werte (bzw. Breite der Felder) berechnet.
  • Es gibt eine minimale und eine maximale Höhe, bzw. Breite.

Wie sind die Währungsformate standardmäßig gecustomizt?

Warum wird keine automatische Nummer erzeugt?

• Ein Strichdatensatz ist nur dann ein gültiger Wert, wenn im Modul PLANTA Datentabelle in der dazugehörigen Datentabelle das DI004269 Strich-DS anlegen aktiviert ist.

Warum kann man ein neu angelegtes DI nicht verwenden/Warum wirken Änderungen am DI nicht?

Hinweise

• Bei Änderungen an folgenden Datentabellen muss der Forking-Server neu gestartet werden:
  • DT412 Dataitem
  • DT415 Datentabelle
  • DT416 Relation
  • DT420 DB-Schema
  • DT439 Automatische Nummer
  • DT440 Dataitem-Struktur
• Ausnahme ist eine Änderung an
  • I-Texten, z.B. der DI-Bezeichnung oder
  • Wertebereichen (auch der WB-Art)

Warum kann aus einer Listbox kein Wert ausgewählt werden?

Tipp

• Über den Parameter LB: Teilstringsuche kann festgelegt werden, welche Datenfelder der Listbox bei einer Teilstringeingabe durchsucht werden.

Warum werden Felder in einem neuen Fenster nicht angezeigt?

• Soll ein Feld im Fenster 2 (bzw. Fenster 3) angezeigt werden, muss zusätzlich im Modul Weitere Modulparameter ein Wert im Datenfeld Breite F2 (bzw. Breite F3) eingetragen werden.
• Beim Anlegen eines neuen Moduls im Modul Module wird über einen Standardwert in Breite F1 eine Breite für das Fenster 1 festgelegt, daher muss hier nicht explizit eine vergeben werden.

Hinweis

• Wenn das Feld Breite Fx (Breite F1, Breite F2, Breite F3) gefüllt ist, aber im Modul kein Datenfeld Fenster = x hat, wird Fenster x trotzdem (leer) angezeigt.

Wie kann ich ein Datenfeld ohne Überschrift anzeigen lassen?

• Wenn der Datenbereich ein horizontales Layout (Parameter Layout = 0) oder ein vertikales Layout (Layout= 1) hat,
  • im Modul Datenbereiche für das Datenfeld, dessen Überschrift nicht angezeigt werden soll, in den Parameter DF-Überschrift ein geschütztes Leerzeichen (Alt+ 0160) eintragen.
• Ist der Datenbereich eine Maske (Layout = 2), so kann man die Überschrift ausblenden
  • indem man im Modul den Menüpunkt Customizing-Modus aktiviert, die Überschrift anklickt und auf ENTF drückt, oder
  • indem man die X/Y-Positionen der Überschrift in der Modulvariante Layout im Modul Datenbereiche entfernt.

Warum kann ich, obwohl der Customizing-Modus aktiviert ist, keine Felder anklicken?

• Der Datenbereich, in dem die Felder sind,
  • wurde noch nicht durch Reinklicken aktiviert (der Datenbereich wird noch grün angezeigt) oder
  • ist keine Maske (Layout = 0 oder 1). Der Datenbereich wird grau angezeigt.
    • Tipp: Durch Rechte Maustaste in einem Bereich und Auswahl des entsprechenden Eintrags kann das Layout geändert werden.
• Weitere Informationen zum Customizing-Modus (Maskeneditor)

Kann ich im Customizing-Modus mehrere Felder auf einmal aktivieren?

• Es gibt zwei Möglichkeiten, mehrere Elemente zu markieren:
  • Die gewünschten Elemente einzeln nacheinander über STRG+Linke Maustaste markieren.
  • Mehrere Elemente in einem Bereich mittels "Gummiband" markieren.
    • Durch Gedrückthalten der SHIFT-Taste, der linken Maustaste und Bewegen der Maus über den entsprechenden Bereich wird ein sogenanntes "Gummiband" eingeblendet.
    • Durch Loslassen der linken Maustaste werden alle Elemente, die vollständig im Bereich des "Gummibandes" liegen, markiert.
    • Um weitere Elemente mittels "Gummiband"-Funktion zu den schon markierten Elementen hinzuzufügen, die Prozedur mit zusätzlich gedrückter STRG-Taste wiederholen.
• Weitere Informationen zum Customizing-Modus (Maskeneditor)

Abbilden von Funktionen aus Releases <=3.8 in PLANTA project

Tipps und Tricks zum Customizing

Customizen in zwei Sessions

Begründung: Ist der Parameter aktiviert, werden die Daten aus den entsprechenden Datentabellen beim ersten Laden in den DTP Cache geladen und bei jedem weiteren Zugriff werden die Daten nicht aus der Datenbank, sondern aus dem DTP Cache verwendet.

Strg+F3 zum Öffnen des aktuellen Datenbereichs/F9 zum Öffnen des Moduls

• mit F9 das Customizing des aktuellen Moduls im Modul Module aufrufen
• mit Strg+F3 den Datenbereich, in dem sich der Fokus befindet, im Modul Datenbereiche aufrufen.

Automatisches Anlegen von Inkarnationen

Round Wertebereiche aus Performancegründen in Compute SQL Wertebereiche umwandeln

Beispiel alt

(ROUND(DI001510,2) != 0.00) ||
(ROUND(DI002669,2) != 0.00) ||
(ROUND(DI002671,2) != 0.00)

Beispiel neu

def computeSqlValueRange(dt_name):
    val = """case  
                when nvl(DI001510,0)+nvl(DI002669,0)+nvl(DI002671,0) > 0 then 1
                when nvl(DI001510,0)+nvl(DI002669,0)+nvl(DI002671,0) = 0 then 0
            end"""
    return str(val)

Python: Wie füge ich Elemente zu einer Liste hinzu

• Variante 1

value_list = [["R1"],["R2"],["R3"]]
list = []
i = 0
for rec in value_list:
    list.append(value_list[i][0])
    i = i + 1

• Variante 1 (Strukturiert)

value_list = [["R1"],["R2"],["R3"]]
list = []
for rec in value_list:
    list.append(value_list[0])

• Variante 1 (Einzeiler)

value_list = [["R1"],["R2"],["R3"]]
list = []
 [list.append(rec[0]) for rec in value_list]