Funktionsbibliothek Neu ab S 39.5.4

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

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 

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

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

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'

Hinweis

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

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

Hinweis

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

• 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

Hinweis

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

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.

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:
    • DI060503 Obligo (DT282)
    • DI060189 Obligo (DT281)
  • 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:
    • DI064672 Datum letzter Obligo-Import
    • DI064673 Uhrzeit letzter Obligo-Import

MtsLiabilityModule

• Funktion und Verwendung analog zu MtsModule mit dem Unterschied, dass für die folgenden Felder der Wert 0 für alle Projekte gespeichert wird, wenn Daten importiert werden:
  • DI041540 Obligo: Personal intern
  • DI041541 Obligo: Personal extern
  • DI041542 Obligo: Sachkosten
  • DI041543 Obligo: Investitionen
  • DI041544 Obligo: Sonstige

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

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

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.

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.

• Importiert Belastungsdatensätze und stempelt diese NEU in den Feldern Importiert am, Importiert durch,
• exportiert Belastungsdatensätze und stempelt diese in den Feldern SAP-Status und NEU in den Feldern Exportiert am, Exportiert durch.

• Funktioniert wie das MtsPoolModule, stempelt aber zusätzlich SAP-Status und NEU Exportiert am, Exportiert durch.
• Kann nur für Export-Schnittstellen benutzt werden.

BAPIModule

• Wenn Sie eine Schnittstelle mit BAPI-Anbindung customizen möchten, wenden Sie sich bitte an Ihren PLANTA-Consultant.

GermanHolidayImportModule

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

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.

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

ConversionFactorImport

• Parameter wie MtsModule

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.

ConstantBoolValue

• Gibt je nach Konfiguration den boolschen Wert True/False zurück
• Eingabewert: Wird nicht berücksichtigt
• Ausgabewert: Boolscher Wert (True/False)

VariableReader

• Liest den Wert aus einer beliebigen Variable und gibt ihn zurück
• Eingabewert: Nicht relevant
• Ausgabewert: Inhalt der Variable

Stripper

• Schneidet die angegeben Zeichen vor und hinter einem Wert ab

LeftStripper

• Schneidet die angegeben Zeichen am Anfang eines Wertes ab

RightStripper

• Schneidet die angegeben Zeichen am Ende eines Wertes ab

• 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

• Wurde ersetzt durch den Validator ConvertResourceIdToPersonId

Concatenator

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

Rounder

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

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

LeftPadder

• Erweitert den eingetragenen String links um die definierten Zeichen und setzt den gesamten String auf die festgelegte Länge

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

Beispiel

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

DataitemReplacer

• Ersetzt, falls der Eingabewert leer ist, diesen mit dem Wert eines anderen Dataitems
• Ausgabewert: Eingabewert (wenn nicht leer), sonst Wert des angegebenen Dataitems

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

GetValueFromUuid

• Gibt den Wert eines Dataitems für einen Datensatz mit der angegebenen UUID aus
• Eingabewert: PLANTA UUID
• Ausgabewert: Wert des Dataitems

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.

ConvertPSPtoUUID

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

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

ConvertDateToYear

• Konvertiert ein Datum in eine Jahreszahl.

ConvertProjectToAttribute

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

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

ConvertToJiraField

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

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

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

• Wurde ersetzt durch den Validator ComparesTo

ComparesTo

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

YearlyTrancheExists

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

AlreadyMapped

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

System-Prüfklassen

Hinweis

• Es können auch individuelle Prüfklassen erstellt werden. Hierzu siehe Individuelle System-Prüfklasse customizen.