Über Skript-Ausdrücke #
Skript-Ausdrücke bieten eine Möglichkeit, dynamische Parameter zu Xtract Universal hinzuzufügen. Sie werden zur Laufzeit einer Extraktion aufgelöst. Die Ausgabe eines Skript-Ausdrucks ist ein String. Dieser String kann als Eingabe für weitere .NET-String-Operationen verwendet werden.
Skript-Ausdrücke können in den folgenden Szenarien verwendet werden:
- als Auswahlparameter in Table und DeltaQ Extraktionen.
- als Custom SQL-Anweisungen in Datenbank-Destinationen.
- als dynamische Ordnerpfade in den Destinationen Amazon S3, Azure Storage und Hadoop.
- als dynamische Dateinamen in Push-Destinationen.
Syntax von Skript-Ausdrücken #
Skript-Ausdrücke verwenden eine C#-Syntax. Sie werden mit einem Rautezeichen (#) eingeleitet und beendet. Die Formel beginnt mit und endet mit geschweiften Klammern ({}).
Beispiel:
#{ Extraction.TableName }#
Hinweis: Bei XU-spezifischen benutzerdefinierten Ausdrücken wird zwischen Groß- und Kleinschreibung unterschieden. Es muss die exakte Syntax wie auf dieser Seite dokumentiert verwendet werden.
IF-Anweisungen
Eine IF-Anweisung (ternärer Operator) hat die folgende Syntax: iif([bool condition], [string trueResult], [string falseResult])
Beispiele:
| Eingabe | Ausgabe | Beschreibung |
|---|---|---|
#{ iif(DateTime.Now.Month==7, "July","Unknown")}# |
Juli | Wenn wir uns im 7. Monat befinden, ist der Ausgang “Juli”, alles andere ist “Unbekannt”. |
#{Extraction.ExtractionName}##{ iif(string.IsNullOrEmpty(Extraction.Context), string.Empty, "/" + Extraction.Context)}# |
Extraction.Context liefert nur bei ODP-Extraktionen ein Ergebnis. Bei allen anderen Extraktionstypen ist das Ergebnis leer. Wenn der Extraktionsname ‘SAP_1’ und der Extraktionstyp ‘Tabelle’ ist, würde der resultierende Dateipfad SAP_1/[filename] lauten. Wenn der Extraktionsname ‘SAP_2’ und der Extraktionstyp ‘ODP’ ist und eine SAP DataSource (Extraktionskontext: SAPI) extrahiert wird, wäre der resultierende Dateipfad SAP_2/SAPI/[filename]. |
Skript-Ausdrücke auf Basis von .NET #
Die Skript-Ausdrücke von Xtract Universal unterstützen die folgenden .NET-Objekte, -Eigenschaften und -Methoden aus dem .NET-Systemnamensraum des aktuellen .NET-Frameworks:
Object, Boolean, Char, String, SByte, Byte, Int16, UInt16, Int32, UInt32, Int64, UInt64, Single, Double, Decimal, DateTime, TimeSpan, Guid, Math, Convert.
Hinweis: Das gebräuchlichste Anwendungsszenario ist die Verwendung der Methoden und Eigenschaften der .NET-Klassen DateTime und String. Weitere Informationen zu den unterstützten .NET-Klassen und deren Eigenschaften und Methoden einschließlich DateTime und String finden Sie in der Online-Dokumentation von Microsoft.
Unterstützte Schlüßelworte
Die folgenden Schlüsselworte werden unterstützt: true, false, null.