Funktionsbibliothek Neu ab S 39.5.4

Neu ab S 39.5.10

warning Hinweis
  • Sowohl globale als auch dynamische Variablen können in den Parametern verwendet werden.
    • stop 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.
    • warning 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.

warning 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.
    • warning 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.

warning 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.
    • warning 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.

warning 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.

warning 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.
    • warning 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. warning 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. warning 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

  • Funktioniert wie ein MtsModule, stempelt aber Daten
  • Die korrekte Funktionsweise des Moduls ist nur gegeben, wenn die Pool-Tabelle korrekt gecustomized wurde, siehe Schnittstellen-Customizing.

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

Ab DB 39.5.8

Parameter Funktion
da_name Siehe MtsModule
warning 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.
info 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
warning 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

warning 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

info 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

info 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
warning 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

warning 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

info 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
warning 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
warning 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
warning 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

application 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

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

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

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.
    • 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.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

warning Hinweis


index Siehe auch:

Ab DB 39.5.11

note Allgemeines

note Workflows (Tutorials)

note Funktionen

note Standard-Schnittstellen

note Module

note Datentabellen

Topic revision: r99 - 2019-08-19 - 14:43:54 - IrinaZieger








 
  • Suche in Topic-Namen

  • Suche in Topic-Inhalten