Please enable JavaScript to view this site.

Prozess Designer

Navigation: PHP API > Parameter

Eingabe-Parameter (getInputParameter)

Scroll Zurück Oben Weiter Mehr

Mit dieser Funktion können Sie Eingabe-Parameter anhand des in der Konfiguration hinterlegten Namens auswerten. Die Auswertung erfolgt dabei automatisch anhand des Parameter-Typs (Fester Wert, Prozesstabelle oder Untertabelle) und kann verschiedene Rückgabewerte bzw. Datentypen liefern.

Parameter

Typ

Beschreibung

$parameterName

string

Der in der Konfiguration hinterlegte Name des Parameters.

Mögliche Rückgabewerte:

Parameter-Typ

Rückgabe-Typ

Beschreibung

Text

string

-

Anhang

\SplFileInfo

PHP-Objekt des Typs SplFileInfo, auch wenn die Datei nicht existiert. Wird auf eine nicht existierende Datei verwiesen, kann dies mit der Methode isReadable() überprüft werden. Ist kein Anhang vorhanden, wird null zurückgeliefert.

Ganzzahl

integer

-

Große Ganzzahl

string

Große Ganzzahlen sind in PHP ab einer bestimmten Größe nicht mehr als integer-Wert darstellbar und werden daher als string zurückgeliefert. Wird mit dem Wert gerechnet, muss vorher eigenständig eine explizite Typumwandlung durchgeführt werden (z.B. in float).

Dezimalzahl

float

-

Datum

\DateTime

PHP-Objekt des Typs DateTime. Ist kein Wert vergeben, wird null zurückgeliefert.

JobArchive ID

string

Die JobArchive ID wird wie eine Große Ganzzahl behandelt.

Untertabellen:

Zu beachten ist, dass, sofern die Regel mit einer Untertabelle verknüpft wurde, die Funktion einen einzelnen Wert für die aktuelle Zeile liefert, andernfalls ein Array von Werten für alle Untertabellenzeilen mit der rowId als Schlüssel.

Fehlerbehandlung:

Wird auf einen nicht definierten Parameter zugegriffen, wird eine Exception geworfen.

Beispiel:

echo $this->getInputParameter("Lieferant");

 

$invoiceFile = $this->getInputParameter("Rechnung");

if ($invoiceFile && $invoiceFile->isReadable()) {

 echo $invoiceFile->getBasename();

}

 

$invoiceDate = $this->getInputParameter("Rechnungsdatum");

if ($invoiceDate) {

 echo $invoiceDate->format("d.m.Y");

}

 

try {

 echo $this->getInputParameter("NichtVorhanden");

} catch (\Exception $e) {

 echo "Parameter nicht vorhanden.";

}