Die Dokumentation ab Version 39.5.17 von PLANTA project finden Sie in der neuen PLANTA Online-Hilfe.

Funktionsbibliothek Neu ab S 39.5.4

Neu ab S 39.5.10

Hinweis
  • Sowohl globale als auch dynamische Variablen können in den Parametern verwendet werden.
    • Das Benutzen von ungültigen Variablen führt zu einem undefinierten Verhalten.

Python-Modulunterklassen

Neu ab DB 39.5.11

PPMSCSVModule

  • Kann CSV-Dateien schreiben, die von PPMS 38 gelesen werden können.
    • Das Format dieser CSV-Dateien sieht wie folgt aus:
@BEGIN GLOBAL
SEPARATOR ;
ESCAPE @
@END GLOBAL
@BEGIN MODULE
MODULE @
@END MODULE
wert_1;wert_2
wert_1;wert_2 

Verwendung Möglich ?
Quellmodul Nein
Pool-Modul Nein
Zielmodul Ja

Parameter Funktion
filepath Der Pfad zur Datei, die exportiert werden soll. Dieser kann entweder relativ zum Serververzeichnis oder ein absoluter Pfad auf dem Server sein.
delimiter Der Trenner innerhalb der CSV-Datei.
escapechar Der Charakter, um den delimiter innerhalb eines Wertes zu escapen.
encoding Das codec, mit dem die Datei kodiert ist
overwrite Bestimmt, ob eine bereits vorhandene Datei beim Export überschrieben werden soll
quoting Bestimmt, ob die Werte in Anführungszeichen geschrieben/gelesen werden sollen. Mögliche Werte stehen in der Python-Doku

MtsModule

Ab DB 39.5.11

  • Sendet und schreibt Daten unter Verwendung der Mts-Schicht in PLANTA.
  • Sämtliche Daten, die von diesem Modul gesendet werden, sind vom Typ Strings und das Modul erwartet auch als Empfänger, dass sämtliche Werte Strings sind.
  • Datenfelder, die zwar im Mapping vorkommen, aber nicht im Datenbereich vorhanden sind, werden ohne Warnung ignoriert.
  • Datenfelder in Fenster 9 werden nicht befüllt.
  • Das Modul bestimmt anhand des DDI die Tabelle, in die importiert wird.
    • Diese Info wird benutzt, um die Primärschlüssel in diesem Datenbereich ausfindig zu machen und zuerst zu füllen.
    • Durch dieses Verhalten wird das Aktualisieren von bestehenden Datensätzen ermöglicht, wenn der komplette Primärschlüssel mitgeliefert wird
  • Stellt eine Feldlängenprüfung bereit.
    • Die Feldlängenprüfung wird nicht für Datumsfelder durchgeführt.

Verwendung Möglich ?
Quellmodul Ja
Pool-Modul Nein
Zielmodul Ja

Parameter Funktion
sorted Werte
  • 0 = Die Werte werden in einer zufälligen Reihenfolge exportiert.
  • 1 = Die Daten werden in der Reihenfolge exportiert, die im Quellmodul eingestellt ist. Voraussetzung hierfür ist, dass der Datenbereich, aus dem die Daten exportiert werden, keinen übergeordneten Datenbereich hat.
da_name Die Python-ID des Datenbereichs, in den im- oder exportiert werden soll.
Wird das MtsModule als Zielmodul eingesetzt, kann der Parameter leer gelassen werden. Dies hat zur Folge, dass alle Datenbereiche im Modul als Importziel benutzt werden.

Hinweis

  • MtsModule interpretiert die folgenden Eingaben als valide Werte für Checkboxen:
    • Deaktiviert: 'N', '@N', '0', '', 'FALSE'
    • Aktiviert: 'Y', '@Y', '1', 'J', 'TRUE', NEU 'X'

Ab S 39.5.7

  • Sendet und schreibt Daten unter Verwendung der Mts-Schicht in PLANTA.
  • Sämtliche Daten, die von diesem Modul gesendet werden, sind vom Typ Strings und das Modul erwartet auch als Empfänger, dass sämtliche Werte Strings sind.
  • Datenfelder, die zwar im Mapping vorkommen, aber nicht im Datenbereich vorhanden sind, werden ohne Warnung ignoriert.
  • Datenfelder in Fenster 9 werden nicht befüllt.
  • Das Modul bestimmt anhand des DDI die Tabelle, in die importiert wird.
    • Diese Info wird benutzt, um die Primärschlüssel in diesem Datenbereich ausfindig zu machen und zuerst zu füllen.
    • Durch dieses Verhalten wird das Aktualisieren von bestehenden Datensätzen ermöglicht, wenn der komplette Primärschlüssel mitgeliefert wird
  • Stellt eine Feldlängenprüfung bereit.
    • Die Feldlängenprüfung wird nicht für Datumsfelder durchgeführt.
  • Verwendung Möglich ?
    Quellmodul Ja
    Pool-Modul Nein
    Zielmodul Ja

    Parameter Funktion
    sorted NEU Werte
    • 0 = Die Werte werden in einer zufälligen Reihenfolge exportiert.
    • 1 = Die Daten werden in der Reihenfolge exportiert, die im Quellmodul eingestellt ist. Voraussetzung hierfür ist, dass der Datenbereich, aus dem die Daten exportiert werden, keinen übergeordneten Datenbereich hat.
    da_name Die Python-ID des Datenbereichs, in den im- oder exportiert werden soll.
    Wird das MtsModule als Zielmodul eingesetzt, kann der Parameter leer gelassen werden. Dies hat zur Folge, dass alle Datenbereiche im Modul als Importziel benutzt werden.

    Hinweis

    • MtsModule interpretiert die folgenden Eingaben als valide Werte für Checkboxen:
      • Deaktiviert: 'N', '@N', '0', '', 'FALSE'
      • Aktiviert: 'Y', '@Y', '1', 'J', 'TRUE'

    Ab S 39.5.5

    • Sendet und schreibt Daten unter Verwendung der Mts-Schicht in PLANTA.
    • Sämtliche Daten, die von diesem Modul gesendet werden, sind vom Typ Strings und das Modul erwartet auch als Empfänger, dass sämtliche Werte Strings sind.
    • Datenfelder die zwar im Mapping vorkommen, aber nicht im Datenbereich vorhanden sind, werden ohne Warnung ignoriert
    • Datenfelder in Fenster 9 werden nicht befüllt
    • Das Modul bestimmt anhand des DDI die Tabelle in die importiert wird.
      • Diese Info wird benutzt, um die Primärschlüssel in diesem Datenbereich ausfindig zu machen und zuerst zu füllen
      • Durch dieses Verhalten wird das aktualisieren von bestehenden Datensätzen ermöglicht, wenn der komplette Primärschlüssel mitgeliefert wird
    • NEU Stellt eine Feldlängenprüfung bereit.
      • Die Feldlängenprüfung wird nicht für Datumsfelder durchgeführt.

    Verwendung Möglich ?
    Quellmodul Ja
    Pool-Modul Nein
    Zielmodul Ja

    Parameter Funktion
    da_name Die Python-ID des Datenbereichs, in den im- oder exportiert werden soll.
    Wird das MtsModule als Zielmodul eingesetzt, kann der Parameter leer gelassen werden. Dies hat zur Folge, dass alle Datenbereiche im Modul als Importziel benutzt werden.

    Hinweis

    • MtsModule interpretiert die folgenden Eingaben als valide Werte für Checkboxen:
      • Deaktiviert: 'N', '@N', '0', '', 'FALSE'
      • Aktiviert: 'Y', '@Y', '1', 'J', 'TRUE'

    Bis S 39.5.4

    • Sendet und schreibt Daten unter Verwendung der Mts-Schicht in PLANTA
    • Sämtliche Daten, die von diesem Modul gesendet werden, sind vom Typ Strings und das Modul erwartet auch als Empfänger, dass sämtliche Werte Strings sind.
    • Datenfelder, die zwar im Mapping vorkommen, aber nicht im Datenbereich vorhanden sind, werden ohne Warnung ignoriert
    • Datenfelder in Fenster 9 werden nicht befüllt
    • Das Modul bestimmt anhand des DDI die Tabelle in die importiert wird.
      • Diese Info wird benutzt, um die Primärschlüssel in diesem Datenbereich ausfindig zu machen und zuerst zu füllen
      • Durch dieses Verhalten wird das aktualisieren von bestehenden Datensätzen ermöglicht, wenn der komplette Primärschlüssel mitgeliefert wird

    Verwendung Möglich ?
    Quellmodul Ja
    Pool-Modul Nein
    Zielmodul Ja

    Parameter Funktion
    da_name Die Python-ID des Datenbereichs, in den im- oder exportiert werden soll.
    Wird das MtsModule als Zielmodul eingesetzt, kann der Parameter leer gelassen werden. Dies hat zur Folge, dass alle Datenbereiche im Modul als Importziel benutzt werden.

    Hinweis

    • MtsModule interpretiert die folgenden Eingaben als valide Werte für Checkboxen:
      • Deaktiviert: 'N', '@N', '0', '', 'FALSE'
      • Aktiviert: 'Y', '@Y', '1', 'J', 'TRUE'

    Neu ab DB 39.5.7

    MtsProjectModule

    • Sendet und schreibt Daten unter Verwendung der Mts-Schicht in PLANTA.
    • Sämtliche Daten, die von diesem Modul gesendet werden, sind vom Typ Strings und das Modul erwartet auch als Empfänger, dass sämtliche Werte Strings sind.
    • Datenfelder, die zwar im Mapping vorkommen, aber nicht im Datenbereich vorhanden sind, werden ohne Warnung ignoriert.
    • Datenfelder in Fenster 9 werden nicht befüllt.
    • Das Modul bestimmt anhand des DDI die Tabelle, in die importiert wird.
      • Diese Info wird benutzt, um die Primärschlüssel in diesem Datenbereich ausfindig zu machen und zuerst zu füllen.
      • Durch dieses Verhalten wird das Aktualisieren von bestehenden Datensätzen ermöglicht, wenn der komplette Primärschlüssel mitgeliefert wird
    • Stellt eine Feldlängenprüfung bereit.
      • Die Feldlängenprüfung wird nicht für Datumsfelder durchgeführt.

    Verwendung Möglich ?
    Quellmodul Ja
    Pool-Modul Nein
    Zielmodul Ja

    Parameter Funktion
    sorted Werte
    • 0 = Die Werte werden in einer zufälligen Reihenfolge exportiert.
    • 1 = Die Daten werden in der Reihenfolge exportiert, die im Quellmodul eingestellt ist. Voraussetzung hierfür ist, dass der Datenbereich, aus dem die Daten exportiert werden, keinen übergeordneten Datenbereich hat.
    da_name Die Python-ID des Datenbereichs, in den im- oder exportiert werden soll.
    Wird das MtsModule als Zielmodul eingesetzt, kann der Parameter leer gelassen werden. Dies hat zur Folge, dass alle Datenbereiche im Modul als Importziel benutzt werden.
    auto_task_id Die Python-ID für ein automatisches Anlegen eines Vorgangs (z.B. um Kosten darauf zu importieren). Wird der Parameter nicht gefüllt, wird kein Vorgang angelegt. Der Parameter steht nur zur Verfügung, wenn das Modul als Zielmodul beim Import benutzt wird.
    auto_task_name Die Bezeichnung für den automatisch angelegten Vorgang. Der Parameter steht nur zur Verfügung, wenn das Modul als Zielmodul beim Import benutzt wird.

    Ab DB 39.5.11

    MtsLiabilityModule

    • Funktion und Verwendung analog zu MtsModule mit den folgenden Unterschieden:
      • Beim Datenimport werden alle Obligo-Werte geleert, d.h., die folgenden DIs werden global auf 0 gesetzt:
      • Die Schnittstelle kennzeichnet die Pool-Datensätze, die sie importiert, mit einem Obligo-Flag.
      • Beim Import werden alle Pool-Datensätze, die als Obligo geflagged sind und noch nicht übertragen wurden, gelöscht. Bereits übertragene Werte werden zur Archivierung im Pool stehen gelassen.
      • Wurden alle Jahresscheiben für ein Projekt korrekt importiert, werden die folgenden DIs gestempelt:

    Ab S 39.5.15

    MtsLiabilityModule

    MtsPoolModule

    Verwendung Möglich ?
    Quellmodul Nein
    Pool-Modul Ja
    Zielmodul Nein

    Ab DB 39.5.8

    Parameter Funktion
    da_name Siehe MtsModule
    Hinweis:
    • wird ersetzt durch sending_da und receiving_da.
    • Daten von bereits existierenden Schnittstellen-Konfigurationen werden bei einem Update automatisch migriert.
    • Auch individuelle Klassen, die von MtsPoolModule erben, werden dabei auf den neuen Stand gehoben.
    sending_da NEU Datenbereich, von dem die Daten im Schritt Pool Ziel geladen werden
    receiving_da NEU Datenbereich, in den die Daten beim Schritt Quelle Pool gespeichert werden
    l_var Die Nummer, die im Pool-Modul mit der aktuellen Schnittstellen-Konfiguration gefüllt werden soll.
    Dadurch kann die Pool-Tabelle auf die Datensätze der aktuellen Transaktion eingeschränkt werden.
    Information
    • Die Konstellation erlaubt flexibleres Customizing. So kann nun in einen "technischen" Datenbereich importiert werden, der die rohen Felder beinhaltet und dann von einem aufgearbeiteten Datenbereich exportiert werden, der die Daten mithilfe von Funktionen wie Gruppierung oder Verdichtung aufarbeitet.

    Bis DB 39.5.8

    Parameter Funktion
    da_name Siehe MtsModule
    l_var Die Nummer, die im Pool-Modul mit der aktuellen Schnittstellen-Konfiguration gefüllt werden soll.
    Dadurch kann die Pool-Tabelle auf die Datensätze der aktuellen Transaktion eingeschränkt werden.

    CSVModule

    • Kann CSV-Dateien lesen und schreiben
      • Es kann nur Dateien importieren, die vom Applikationsserver aus mit dem Benutzer, unter dem der PLANTA-Dienst läuft, zugänglich sind.
    • Als Datenbereich kann hier ein einfacher Dummy-Datenbereich mit einem Feld genommen werden.
    • Wird das Modul als Quellmodul verwendet und der Parameter readheader ist 1, entsprechen die Quell-Mappings den Spaltennamen in der Datei.
      • Ist der Parameter 0, wird stattdessen die Position zur Spaltenbestimmung genutzt.
    • Ist das Modul als Zielmodul eingerichtet und der Parameter writeheader ist 1, entsprechen die Ziel-Mappings den Spaltennamen in der Datei.
      • Ist der Parameter 0, wird stattdessen die Position zur Spaltenbestimmung genutzt.

    Verwendung Möglich ?
    Quellmodul Ja
    Pool-Modul Nein
    Zielmodul Ja

    Ab S 39.5.5

    Parameter Funktion
    archive_dir NEU Der Pfad zu einem Verzeichnis, in das nach einem erfolgreichen Import die Datei verschoben werden soll. Dieser kann entweder relativ zum Serververzeichnis oder ein absoluter Pfad auf dem Server sein. Ist der Parameter leer wird das Serververzeichnis genommen. Existiert das Verzeichnis nicht, wird es angelegt
    filepath Der Pfad zur Datei, die im- oder exportiert werden soll. Dieser kann entweder relativ zum Serververzeichnis oder ein absoluter Pfad auf dem Server sein.
    NEU Wildcards wie * können im Namen benutzt werden. Werden mehrere Dateien gefunden, wird ein Fehler ausgegeben.
    delimiter Der Trenner innerhalb der CSV-Datei
    Soll ein Tab als Trennzeichen verwendet werden, muss /t eingetragen werden.
    escapechar Der Charakter, um den delimiter innerhalb eines Wertes zu escapen.
    encoding Das codec, mit dem die Datei kodiert ist
    writeheader Bestimmt, ob beim Export eine Titelzeile geschrieben werden soll
    readheader Bestimmt, ob beim Import die erste Zeile oder die Quell-Mappings die Spaltennamen in der CSV-Datei darstellen
    overwrite Bestimmt, ob eine bereits vorhandene Datei beim Export überschrieben werden soll
    quoting Bestimmt, ob die Werte in Anführungszeichen geschrieben/gelesen werden sollen. Mögliche Werte stehen in der Python-Doku

    Hinweise NEU

    • Nachdem eine Datei erfolgreich importiert wurde, wird die UUID der Schnittstellen-Konfiguration in den Dateinamen geschrieben und die Datei in das über archive_dir konfigurierte Verzeichnis verschoben.
    • Wird ein CSV-Export durchgeführt, können im filepath Parameter auch Platzhalter verwendet werden, um einen Zeitstempel zu formatieren. Die möglichen Platzhalter stehen in der Python-Doku

    Bis S 39.5.4

    Parameter Funktion
    filepath Der Pfad zur Datei, die im- oder exportiert werden soll. Dieser kann entweder relativ zum Serververzeichnis oder ein absoluter Pfad auf dem Server sein
    delimiter Der Trenner innerhalb der CSV-Datei
    escapechar Der Charakter, um den delimiter innerhalb eines Wertes zu escapen.
    encoding Das codec, mit dem die Datei kodiert ist
    writeheader Bestimmt, ob beim Export eine Titelzeile geschrieben werden soll
    readheader Bestimmt, ob beim Import die erste Zeile oder die Quell-Mappings die Spaltennamen in der CSV-Datei darstellen
    overwrite Bestimmt, ob eine bereits vorhandene Datei beim Export überschrieben werden soll
    quoting Bestimmt, ob die Werte in Anführungszeichen geschrieben/gelesen werden sollen. Mögliche Werte stehen in der Python-Doku

    Die geläufigsten encoding-Werte:

    encoding Verwendet von
    latin-1 Standard Encoding von Microsoft Excel auf deutschsprachigen Rechnern
    windows-1252 Standard Encoding von Microsoft Excel auf englischsprachigen Rechnern
    utf-8 UTF-8 enkodierte Datei ohne BOM
    utf-8-sig UTF-8 enkodierte Datei mit BOM

    Neu ab S 39.5.10

    MultiCSVModule

    Informationen

    • Diese Modulunterklasse gleicht der Modulunterklasse CSVModule.
    • Der einzige Unterschied besteht beim Parameter filepath.
      • Werden mehrere Dateien gefunden, wird bei Verwendung von MultiCSVModule kein Fehler ausgegeben, sondern die Dateien werden nacheinander in Reihenfolge ihres Dateinamens im- bzw. exportiert.

    Neu ab S 39.5.14/C 39.5.14

    ClientCSVModule

    Informationen

    • Diese Modulunterklasse gleicht der Modulunterklasse CSVModule.
      • Im Unterschied zu dieser gibt es hier die Parameter filepath und archive_dir nicht.
    • Im Gegensatz zu CSVModule kann ClientCSVModule Dateien importieren/exportieren, die für den Benutzer, der den PLANTA-Client aufruft, zugänglich sind.

    MtsLoadModule

    Ab DB 39.5.7

    Bis DB 39.5.7

  • Importiert sowie exportiert Belastungsdatensätze und stempelt diese im Feld SAP-Status.
  • Verwendung Möglich ?
    Quellmodul Ja
    Pool-Modul Nein
    Zielmodul Ja

    Parameter Funktion
    da_name Siehe MtsModule

    MtsExportPoolLoadModule

    Ab DB 39.5.7

    Bis DB 39.5.7

  • Funktioniert wie das MtsPoolModule, stempelt aber zusätzlich im Feld SAP-Status.
  • Kann nur für Export-Schnittstellen benutzt werden.
  • Verwendung Möglich ?
    Quellmodul Nein
    Pool-Modul Ja
    Zielmodul Nein

    Ab S 39.5.8

    Parameter Funktion
    da_name Siehe MtsPoolModule
    Hinweis: wird ersetzt durch sending_da und receiving_da.
    sending_da NEU Siehe MtsPoolModule
    receiving_da NEU Siehe MtsPoolModule
    l_var Siehe MtsPoolModule
    sorted NEU Siehe MtsModule

    Bis S 39.5.8

    Parameter Funktion
    da_name Siehe MtsPoolModule
    l_var Siehe MtsPoolModule

    Neu ab S 39.5.4

    BAPIModule

    Hinweis
    • Wenn Sie eine Schnittstelle mit BAPI-Anbindung customizen möchten, wenden Sie sich bitte an Ihren PLANTA-Consultant.
    SAP-Verbindungsparameter
    client
    user
    passwd
    lang
    trace
    ashost
    sysnr
    mshost
    msserv
    sysid
    group

    Neu ab DB 39.5.7

    GermanHolidayImportModule

    • Importiert deutsche Feiertage von einem Web-Service in PLANTA-Kalender. Hierzu siehe Kalender

    Parameter Funktion
    calendar die ID des Kalendars, in den importiert werden soll
    start_year das Jahr, ab dem die Feiertage importiert werden sollen
    end_year das Jahr, bis dem die Feiertage importiert werden sollen
    state das Bundesland, für das die Feiertage geladen werden sollen. Erlaubte Werte: HB, NI, NW, HH, SN, MV, BW, SL, SH, ST, BE, RP, BB, BY, HE, TH

    Neu ab DB 39.5.8

    AbsenceImportModule

    • Importiert Abwesenheiten in die Periodentabelle
    • Da die Periodentabelle einen Datensatz pro Tag beinhaltet, werden die importierten Daten für jeden Tag, der zwischen start_date und end_date liegt (einschließlich dem Start- und Ende-Datum), dupliziert.
    • Die Spalte absence_type erwartet einen numerischen Wert, der der folgenden Tabelle entnommen werden kann.
    • Die Werte können mit Hilfe einer Mapping-Funktion, wie z.B. ConstantValue oder Replacer, eingefügt werden.

    Abwesenheitsgrund Wert
    Abwesenheit 46
    1/2 Tag Abwesenheit 45
    Sonderurlaub 48
    Urlaub 44
    1/2 Tag Urlaub 43
    Mutterschutz/Elternzeit 47
    Aus- und Weiterbildung 113
    Krankheit 399

    Parameter Funktion
    da_name Siehe MtsModule
    date_format Das Format der Datumswerte, die in den Spalten start_date und end_date stehen. Für mögliche Werte siehe Python-Doku

    Neu ab DB 39.5.11

    ConversionFactorImport

    Eine Unterklasse von MtsModule, die in der Lage ist, Daten in der Umrechnungsfaktortabelle upzudaten.

    BAPIProjectGetInfo

    • Kann nur als Quell-Modul verwendet werden
    • Parameter wie BAPIModule und zusätzlich project_definition, wo die SAP-Projekt-ID eingetragen werden muss, um für dieses Projekt die PSP-Struktur zu importieren.

    BAPIBUS2054GetData

    • Kann nur als Quell-Modul verwendet werden
    • Parameter wie BAPIModule und zusätzlich project_definition, wo die SAP-Projekt-ID eingetragen werden muss, um für dieses Projekt die PSP-Struktur zu importieren.

    Mapping-Funktionen

    Information
    • Die folgenden Mapping-Funktionen können je nach Typ verwendet werden.

    Enricher

    Neu ab DB 39.5.11

    ConstantBoolValue

    • Gibt je nach Konfiguration den boolschen Wert True/False zurück
    • Eingabewert: Wird nicht berücksichtigt
    • Ausgabewert: Boolscher Wert (True/False)
    Parameter Funktion
    true Definiert, ob true oder false zurückgegeben werden soll. Mögliche Werte: 0 (false) und 1 (true)

    VariableReader

    • Liest den Wert aus einer beliebigen Variable und gibt ihn zurück
    • Eingabewert: Nicht relevant
    • Ausgabewert: Inhalt der Variable
    Parameter Funktion
    variable Die Variable, die ausgelesen werden soll, z.B. @1 oder @G123. Unterstützt alle Variablentypen.

    Slicer

    • Ermöglicht es, die Slice-Funktion aus Python auf einen Wert anzuwenden.
    • Dies kann benutzt werden, um Teile des Textes abzuschneiden oder den Text umzudrehen.
    • Eingabewert: Text
    • Ausgabewert: Text

    Parameter Funktion
    start Index, an dem begonnen wird
    step Die Schrittweite, an der abgeschnitten werden soll
    end Index, an dem gestoppt wird

    Replacer

    • Ersetzt einen Wert durch einen anderen
    • Eingabewert: Text
    • Ausgabewert: Text

    Parameter Funktion
    old_value Teilstring der ersetzt werden soll
    new_value Wert durch den der Teilstring ersetzt werden soll

    ConstantValue

    • Gibt einen konstanten Wert zurück
    • Eingabewert: Wird nicht berücksichtigt
    • Ausgabewert: Text

    Parameter Funktion
    value Durch Angabe eines Zeichens wird dieses gestrippt. Wird nichts angegeben: alle Arten von Leerzeichen/Tabs

    Neu ab S 39.5.7

    Stripper

    • Schneidet die angegeben Zeichen vor und hinter einem Wert ab

    Parameter Funktion
    chars Das Zeichen, das abgeschnitten werden soll
    Wird hier kein Zeichen angegeben, werden alle Arten von Leerzeichen/Tabs abgeschnitten.

    Neu ab DB 39.5.8

    LeftStripper

    • Schneidet die angegeben Zeichen am Anfang eines Wertes ab

    Parameter Funktion
    chars Das Zeichen, das abgeschnitten werden soll
    Wird hier kein Zeichen angegeben, werden alle Arten von Leerzeichen/Tabs abgeschnitten.

    RightStripper

    • Schneidet die angegeben Zeichen am Ende eines Wertes ab

    Parameter Funktion
    chars Das Zeichen, das abgeschnitten werden soll
    Wird hier kein Zeichen angegeben, werden alle Arten von Leerzeichen/Tabs abgeschnitten.

    GetResAssignmentAttribute

    Ab S 39.5.8

    • Gibt den Wert eines DIs aus der DT466 zurück und schreibt einen Hinweis in die Log-Datei, wenn es in der DT466 nicht gefunden werden konnte.
    • Eingabewert: Wird nicht berücksichtigt
    • Ausgabewert: Text

    Bis S 39.5.8

  • Gibt den Wert eines DIs aus der DT466 zurück.
  • Eingabewert: Wird nicht berücksichtigt
  • Ausgabewert: Text
  • Parameter Funktion
    project Die technische Projekt-ID des Projekts
    task Die technische Vorgangs-ID des Vorgangs
    res_id Die Ressourcen-ID
    python_id Die DI-Python-ID des DIs, das zurückgegeben werden soll

    GetPersonId

    Ab S 39.5.7

    Bis S 39.5.7

  • Gibt den Wert von Person zurück für das Kürzel was als Wert übergeben wird.
  • Eingabewert: Ein gültiges Kürzel
  • Ausgabewert: Der Wert des Feldes Person
  • Neu ab S 39.5.8

    Concatenator

    • Fügt den konfigurierten String zum Eingabewert hinzu
    • Eingabewert: Text
    • Ausgabewert: Text

    Parameter Funktion
    text Der Text, der zum Eingabewert hinzugefügt werden soll
    left Bestimmt, ob der Text links vom String hinzugefügt werden soll; mögliche Werte sind 0 und 1
    right Bestimmt, ob der Text rechts vom String hinzugefügt werden soll; mögliche Werte sind 0 und 1

    Rounder

    • Rundet den Eingabewert auf die definierte Anzahl Stellen
    • Eingabewert: Zahl
    • Ausgabewert: Text

    Parameter Funktion
    digits Eine Zahl größer/gleich 0; Bestimmt die Anzahl Stellen auf die der Eingabewerte gerundet werden soll. Wenn der Parameter in keine Zahl umgewandelt werden kann, wird der Default-Wert 2 verwendet.

    GetResourceAttribute

    • Gibt den Wert eines DIs aus der DT467 zurück und schreibt einen Hinweis in die Log-Datei, wenn es in der DT467 nicht gefunden werden konnte.
    • Eingabewert: Wird nicht berücksichtigt.
    • Ausgabewert: Text
    Parameter Funktion
    resource Die Ressourcen-ID
    python_id Die DI-Python-ID des DIs, das zurückgegeben werden soll

    Neu ab DB 39.5.7

    LeftPadder

    • Erweitert den eingetragenen String links um die definierten Zeichen und setzt den gesamten String auf die festgelegte Länge
    Parameter Funktion
    fillchar Zeichen, mit denen der String erweitert wird
    width die gesamte Länge des Strings mit Erweiterung

    Beispiel
    • Eingabestring: "foo"
      • fillchar: \s
      • width: 5
    • Ausgabestring: " foo"

    RightPadder

    • Erweitert den eingetragenen String rechts um die definierten Zeichen und setzt den gesamten String auf die festgelegte Länge
    Parameter Funktion
    fillchar Zeichen, mit denen der String erweitert wird
    width die gesamte Länge des Strings mit Erweiterung

    Beispiel
    • Eingabestring "foo"
      • fillchar: x
      • width: 5
    • Ausgabestring: "fooxx"

    Neu ab DB 39.5.15

    DataitemReplacer

    • Ersetzt, falls der Eingabewert leer ist, diesen mit dem Wert eines anderen Dataitems
    • Ausgabewert: Eingabewert (wenn nicht leer), sonst Wert des angegebenen Dataitems
    Parameter Funktion
    uuid UUID des Datensatzes, aus dem das Dataitem ausgelesen werden soll
    datatable SQL-ID der Datentabelle, aus der das Dataitem ausgelesen werden soll
    dataitem SQL-ID des Dataitems, das ausgelesen werden soll

    GetPlantaIdFromExternalId

    • Gibt die PLANTA UUID für die angegebene ID aus einem Fremdsystem an, sofern verknüpft
    • Eingabewert: ID aus einem Fremdsystem
    • Ausgabewert: PLANTA UUID
    Parameter Funktion
    system Kenner des Fremdsystems (z.B. 728 für PLANTA pulse)
    type Art des Objekts mit dieser ID (z.b. 'workload' für Belastungen aus PLANTA pulse)

    GetValueFromUuid

    • Gibt den Wert eines Dataitems für einen Datensatz mit der angegebenen UUID aus
    • Eingabewert: PLANTA UUID
    • Ausgabewert: Wert des Dataitems
    Parameter Funktion
    datatable SQL-ID der Datentabelle, aus der das Dataitem ausgelesen werden soll
    dataitem SQL-ID des Dataitems, das ausgelesen werden soll

    Konverter

    ToUppercase

    • Ändert einen Wert in GROSSBUCHSTABEN
    • Eingabewert: Text
    • Ausgabewert: Text

    ToString

    • Ändert einen Wert in einen Textwert
    • Eingabewert: Beliebig
    • Ausgabewert: Text

    ToInt

    • Ändert einen Wert in eine Ganzzahl
    • Eingabewert: Beliebig
    • Ausgabewert: Ganzzahl

    Parameter Funktion
    round Konfiguriert, ob der Wert vorher gerundet werden soll

    ToFloat

    • Ändert einen Wert in eine Fließkommazahl
    • Eingabewert: Beliebig
    • Ausgabewert: Fließkommazahl

    StringToPLANTADate

    • Konvertiert einen Text in das PLANTA-Datumsformat
    • Eingabewert: Text
    • Ausgabewert: Ganzzahl

    Parameter Funktion
    format Das Format, in dem das Datum vorliegt. Für mögliche Werte siehe Python-Doku

    PLANTADateToString

    • Konvertiert das PLANTA-Datumsformat in einen Text
    • Eingabewert: Ganzzahl
    • Ausgabewert: Text

    Parameter Funktion
    format Das Format, das für das Datum benutzt werden soll. Für mögliche Werte siehe Python-Doku

    Neu ab S 39.5.7

    ConvertFunctionalProjectIDToTechnical

    • Hat keine Parameter und nimmt eine fachliche Projekt-ID als Wert und gibt die technische Projekt-ID oder None zurück.

    ConvertResourceIdToPersonId

    • Gibt den Wert von Person zurück für das Kürzel was als Wert übergeben wird.
    • Eingabewert: Ein gültiges Kürzel
    • Ausgabewert: Der Wert des Feldes Person

    ConvertTrailingSignToLeadingSign

    • Hat keine Parameter und konvertiert eine Zahl, wie z.B. 10- in -10

    ConvertFunctionalProjectIDToTechnical

    • Hat keine Parameter und nimmt eine fachliche Projekt-ID als Wert und gibt eine technische Projekt-ID oder None zurück.

    UnicodeNormalizer

    • Wandelt Sonderzeichen, die von PLANTA project nicht dargestellt werden, über die kompatible Dekomposition (NFKD) in Zeichen um, die von PLANTA project dargestellt werden können.

    Parameter Funktion
    encoding Die Kodierung, in die der Eingabetext konvertiert werden soll. Standardmäßig wird dieser Parameter mit der Kodierung des Servers vorbelegt und muss nicht geändert werden.

    Neu ab DB 39.5.9

    ConvertPSPtoUUID

    • Nimmt den Parameter "project" und wandelt die übergebene PSP-ID in die UUID um.

    Neu ab DB 39.5.11

    ConvertValidFromToConversionFactorItemId

    • Schaut, ob es für die entsprechende Umrechnungsfaktor-ID mit dem übergebenen Datumswert einen Datensatz gibt, dessen Gültig ab mit dem Datum übereinstimmt. Wenn ja, wird die Position zurückgegeben (DI000343).

    Parameter Funktion
    conversion_factor_id Umrechnungsfaktor-ID, gespeichert in DI000341
    format Datumsformat für den eingehenden Wert (wie z. B. PLANTADateToString)

    Neu ab DB 39.5.11

    ConvertDateToYear

    • Konvertiert ein Datum in eine Jahreszahl.

    Parameter Funktion
    format Definiert das Datumsformat, welches übergeben wird.

    Neu ab DB 39.5.11

    ConvertProjectToAttribute

    • Holt sich den Wert aus dem konfigurierten DI für das angegebene Projekt
    • Eingabewert: Technische Projekt-ID
    • Ausgabewert: Text

    Parameter Funktion
    python_id Die Python-ID des DIs aus DT461 Projekt

    ConvertPlantaUserToPulseUser

    • Gibt für einen PLANTA project-Benutzer den PLANTA pulse-Benutzer zurück
    • Eingabewert: Benutzerkürzel aus DT511 (DI010323)
    • Ausgabewert: PLANTA pulse-ID des Benutzers oder None

    ConvertPlantaIdToPulseId

    • Wandelt eine PLANTA project-UUID in eine PLANTA pulse-ID um
    • Eingabewert: Eine UUID
    • Ausgabewert: die PLANTA pulse-ID des Objekts oder None

    ConvertResourceAssignmentUuidToPulseBoardId

    • Wandelt die UUID einer Ressourcenzuordnung in die Board-ID des Vorgangs um.
    • Eingabewert: UUID einer Ressourcenzuordnung (DI060939)
    • Ausgabewert: Board-ID des Vorgangs

    Neu ab DB 39.5.15

    ConvertToJiraField

    • Konvertiert den Wert zu einem von Jira verarbeitbaren json-Wert

    Parameter Funktion Standardwert
    format Format des json-Werts (muss den Platzhalter '{input}' enthalten) {'id': '{input}'}

    ConvertSecondsToHours

    • Konvertiert Sekunden zu Stunden und gibt diese als Float zurück

    ConvertJiraIdToPlantaId

    • Konvertiert eine Jira ID zu einer PLANTA project UUID
    • Eingabewert: ID eines Jira Objekts

    Parameter Funktion
    type Art des externen Objekts (wie auch in der DT597FremdsystemObjektMapping Tabelle gespeichert)

    ConvertUuidToAttribute

    • Gibt den Wert des angegebenen Dataitems von einem Datensatz mit der angegebenen PLANTA project UUID aus der angegebenen Tabelle zurück
    • Eingabewert: UUID eines PLANTA project Objekts

    Parameter Funktion
    table SQL-ID einer PLANTA project Tabelle
    dataitem SQL-ID eines Dataitems aus der angegebenen Tabelle

    Validatoren

    • Alle Validatoren haben zwei Parameter:
      • child_when_invalid: Hier kann der Name eines der Kinder des Validators angegeben werden. Wenn der Validator fehl schlägt, wird nur dieses Kind ausgeführt. Ist der Validator erfolgreich wird der child_when_invalid Strang ignoriert.
      • mark_record_as_invalid: Steht dieser Parameter auf 1, wird der Datensatz, bei Fehlschlag des Validators, als ungültig markiert und nicht übertragen. Steht der Parameter auf 0, wird lediglich diese Spalte beim Übertrag ignoriert.

    IsTrue

    • Prüft, ob der Wert logisch wahr ist

    ExistsAsPK

    • Prüft, ob der übergebene Wert ein Primärschlüssel in der konfigurierten Tabelle ist

    Parameter Funktion
    table_num Die Tabellennummer in PLANTA, die geprüft werden soll

    IsInList

    • Prüft, ob der übergebene Wert in der konfigurierten Liste von Werten ist

    Parameter Funktion
    values Eine Liste von Werten, die mit dem konfigurierten Trenner getrennt sein müssen
    separator Der Trenner, um die Liste in values in einzelne Werte zu trennen

    Equals

    Ab S 39.5.7

    Bis S 39.5.7

  • Prüft, ob der übergeben Wert mit dem konfigurierten übereinstimmt
  • Parameter Funktion
    value Der Wert, mit dem verglichen werden soll

    Contains

    • Prüft, ob der konfigurierte Wert im Übergebenen vorhanden ist

    Parameter Funktion
    value Der Wert, der vorhanden sein soll

    TaskExists

    • Prüft, ob der übergeben Wert eine gültige Vorgangs-ID im konfigurierten Projekt ist

    Parameter Funktion
    project Die technische Projekt-ID des Projekts, in dem geprüft werden soll

    ResIsAssignedToTask

    • Prüft, ob der übergebene Wert eine gültige Ressourcenzuordnung im konfigurierten Projekt und Vorgang ist
    • Zusätzlich kann dieser Validator eine Ressourcenzuordnung anlegen, wenn keine besteht.

    Parameter Funktion
    project Die technische Projekt-ID des Projekts, in dem geprüft werden soll
    task Die technische Vorgangs-ID des Vorgangs, in dem geprüft werden soll
    create_if_not_exists Falls die Ressourcenzuordnung nicht existiert und dieser Parameter auf 1 steht, wird die Ressourcenzuordnung angelegt

    Neu ab S 39.5.7

    ComparesTo

    • Vergleicht Werte. Der Validator schlägt fehl, wenn der Vergleich fehlschlägt
    • Eingabewert = beliebig

    Parameter Funktion
    value Gibt an, gegen was verglichen wird
    operator Gibt an, wie verglichen wird : ==, !=, <, >, <=, >=
    type Angabe des Typs, mögliche Werte: TEXT, INTEGER und FLOAT. Der Validator wandelt die Werte des Parameters value und den Eingabewert vor dem Vergleich in diesen Typen um.

    Neu ab DB 39.5.11

    YearlyTrancheExists

    • Prüft, ob das übergebene Jahr als Jahresscheibe im Budget des Projekts vorhanden ist.

    Parameter Funktion
    project Gibt die technische Projekt-ID des Projekts an, für das geschaut werden soll.
    cost_type_group Gibt die Kostengruppenart an, auf die geprüft wird.
    create_if_not_exists Gibt an, ob die Jahresscheibe angelegt werden soll, wenn sie nicht vorhanden ist. Gültige Werte: 1 oder 0

    Neu ab DB 39.5.15

    AlreadyMapped

    • Prüft, ob die übergebene ID aus einem Fremdsystem bereits einem PLANTA project-Objekt zugeordnet ist

    Parameter Funktion
    external_system Gibt die ID des Fremdsystems an
    external_type Gibt die Art des Objekts aus dem Fremdsystem an

    Neu ab DB 39.5.7

    System-Prüfklassen

    Parameter Funktion
    HostnameConditional Vergleicht den Parameterwert mit dem Hostnamen des Applikations-Servers
    PortConditional Vergleicht den Parameterwert mit dem in globals.conf des PLANTA-Servers eingetragenen Port
    WorkDirConditional Vergleicht den Parameterwert mit dem Arbeitsverzeichnis der PLANTA-Servers
    IPAddressConditional Vergleicht den Parameterwert mit der IP-Adresse des Applikations-Servers

    Hinweis


    Siehe auch: Hier finden Sie einen Überblick über alle PLANTA link-Inhalte

             PLANTA project









     
    • Suche in Topic-Namen

    • Suche in Topic-Inhalten
    This site is powered by the TWiki collaboration platform Powered by Perl