Zum Inhalt springen

Textvalidierungsfunktionen in Jitterbit Studio

Diese Funktionen bieten für ein Validierungsskript die gleiche Validierung, die für ein Textdokument-Dateiformat definiert werden kann.

Validate

Deklaration

bool Validate(string op, string arg[, boolean ignoreCase])

Syntax

Validate(<op>, <arg>[, <ignoreCase>])

Erforderliche Parameter

  • op: Der Vergleichsoperator, der für die Validierung verwendet werden soll
  • arg: Der Wert, der mit dem Vergleichsoperator in der Validierung verwendet werden soll

Optionale Parameter

  • ignoreCase: Ob die Groß- und Kleinschreibung bei der Durchführung der Validierung ignoriert werden soll; standardmäßig false

Beschreibung

Diese Funktion ist dafür vorgesehen, von einem Skript aufgerufen zu werden, das für die Textvalidierung verwendet wird. Sie bietet für dieses Validierungsskript die gleiche Validierung, die für ein Textdokument-Dateiformat definiert werden kann. Typischerweise wird diese Funktion in einem Skript aufgerufen, das zur Validierung eines Quell-Textdokument-Dateiformats verwendet wird. Beachten Sie, dass die Validierung nur für Quellen und nicht für Ziele funktioniert.

Die Validate-Funktion geht davon aus, dass das aufrufende Skript diese drei Eingabeargumente bereitstellt, da es sie verwendet, um den Wert zu erhalten, den es validieren möchte:

  • _1: Der Eingabewert, als Zeichenfolge
  • _2: Eine Zeichenfolge mit dem Datentyp des Eingabewerts (das "Typ"-Feld, wie es im Dateiformat verwendet wird)
  • _3: Eine Formatzeichenfolge des Eingabewerts (das "Format"-Feld, wie es im Dateiformat verwendet wird)

Siehe die Funktion ArgumentList für weitere Informationen darüber, wie Werte mit der _n-Syntax übergeben werden.

Vergleichsoperatoren und Werte

Je nach Art der an das aufgerufene Skript übergebenen Daten können unterschiedliche Vergleichsoperatoren und Werte verwendet werden. In allen Fällen kann ein regulärer Ausdruck verwendet werden, der der Boost-Regulärer-Ausdruck-Bibliothek Syntax folgt. Es handelt sich um eine Variation der Perl-Regulärer-Ausdruck Syntax.

Datentyp Vergleichsoperatoren Vergleichswerte
Zeichenkette =
!=
Enthält
Enthält Nicht
Eines Von
Nicht Eines Von
Regex
Zeichenfolgenwerte
Zahl
(Ganzzahl, Lang, Float, Double)
<
<=
>
>=
=
!=
Zwischen
Nicht Zwischen
Regex
Ganzzahl-, Lang-, Float- oder Double-Werte
Datum <
<=
>
>=
=
!=
Zwischen
Nicht Zwischen
Regex
Daten (oder Zeichenfolgen, die ein Datum darstellen) unter Verwendung der Datumvergleichswerte
Boolean =
!=
Regex
true, false, 1, 0

Datumvergleichswerte

Für Daten können diese Vergleichswerte zusätzlich zu den Daten selbst verwendet werden. Beachten Sie, dass einige Variationen einen ganzzahligen Parameter verwenden, um eine Menge anzugeben.

Vergleichswert Beschreibung
GESTERN Beginnt um 12:00:00 am Tag zuvor und dauert 24 Stunden.
HEUTE Beginnt um 12:00:00 des aktuellen Tages und dauert 24 Stunden.
MORGEN Beginnt um 12:00:00 nach dem aktuellen Tag und dauert 24 Stunden.
LETZTE_WOCHE Beginnt um 12:00:00 am ersten Tag der Woche vor dem letzten ersten Tag der Woche und dauert sieben volle Tage. Der erste Tag der Woche wird durch die aktuelle Region bestimmt.
DIESE_WOCHE Beginnt um 12:00:00 am letzten ersten Tag der Woche vor dem aktuellen Tag und dauert sieben volle Tage. Der erste Tag der Woche wird durch Ihre Region bestimmt.
NÄCHSTE_WOCHE Beginnt um 12:00:00 am letzten ersten Tag der Woche nach dem aktuellen Tag und dauert sieben volle Tage. Der erste Tag der Woche wird durch Ihre Region bestimmt.
LETZTER_MONAT Beginnt um 12:00:00 am ersten Tag des Monats vor dem aktuellen Tag und dauert alle Tage dieses Monats.
DIESER_MONAT Beginnt um 12:00:00 am ersten Tag des Monats, in dem sich der aktuelle Tag befindet, und dauert alle Tage dieses Monats.
NÄCHSTER_MONAT Beginnt um 12:00:00 am ersten Tag des Monats nach dem Monat, in dem sich der aktuelle Tag befindet, und dauert alle Tage dieses Monats.
LETZTE_90_TAGE Beginnt um 12:00:00 des aktuellen Tages und dauert die letzten 90 Tage.
NÄCHSTE_90_TAGE Beginnt um 12:00:00 des aktuellen Tages und dauert die nächsten 90 Tage.
LETZTE_N_TAGE:n Für die angegebene Zahl n beginnt es um 12:00:00 des aktuellen Tages und dauert die letzten n Tage.
NÄCHSTE_N_TAGE:n Für die angegebene Zahl n beginnt es um 12:00:00 des aktuellen Tages und dauert die nächsten n Tage.
DIESES_QUARTAL Beginnt um 12:00:00 des aktuellen Quartals und dauert bis zum Ende des aktuellen Quartals.
LETZTES_QUARTAL Beginnt um 12:00:00 des vorherigen Quartals und dauert bis zum Ende dieses Quartals.
NÄCHSTES_QUARTAL Beginnt um 12:00:00 des nächsten Quartals und dauert bis zum Ende dieses Quartals.
NÄCHSTE_N_QUARTALE:n Beginnt um 12:00:00 des nächsten Quartals und dauert bis zum Ende des nten Quartals.
LETZTE_N_QUARTALE:n Beginnt um 12:00:00 des vorherigen Quartals und dauert bis zum Ende des vorherigen nten Quartals.
DIESES_JAHR Beginnt um 12:00:00 am 1. Januar des aktuellen Jahres und dauert bis zum Ende des 31. Dezember des aktuellen Jahres.
LETZTES_JAHR Beginnt um 12:00:00 am 1. Januar des vorherigen Jahres und dauert bis zum Ende des 31. Dezember dieses Jahres.
NÄCHSTES_JAHR Beginnt um 12:00:00 am 1. Januar des folgenden Jahres und dauert bis zum Ende des 31. Dezember dieses Jahres.
NÄCHSTE_N_JAHRE:n Beginnt um 12:00:00 am 1. Januar des folgenden Jahres und dauert bis zum Ende des 31. Dezember des nten Jahres.
LETZTE_N_JAHRE:n Beginnt um 12:00:00 am 1. Januar des vorherigen Jahres und dauert bis zum Ende des 31. Dezember des vorherigen nten Jahres.

Beispiele

Sie können diese Funktion in einem Skript oder Mapping verwenden. Zuerst erstellen Sie ein Skript ("ValWrap"), das die Validate-Funktion umschließt, sodass die erforderlichen lokalen Variablen befüllt werden:

<trans>
// This code could be a script called
// "ValWrap". It would be called from
// another script or mapping.

// Argument List:
// _1 (input_string_value), _2 (data_type),
// _3 (format) _4 (comparison operator),
// _5 (comparison value), _6 (ignore case)

Validate(_4, _5, _6);
</trans>

Dann rufen Sie das Wrapper-Skript von einem anderen Skript (oder einem Mapping) auf, um die Validate-Funktion zu verwenden:

// This code calls a wrapper script to access
// the Validate function.
// Wrapper Argument List:
// _1 (input_string_value), _2 (data_type),
// _3 (format), _4 (comparison operator),
// _5 (comparison value), _6 (ignore case)

// Validation of a Date
a1 = Date(CVTDate("02192018", "mmddyyyy", "yyyy-mm-dd HH:MM:SS"));
a2 = "Date";
a3 = ""; // Format not required if a Date passed
a4 = "=";
a5 = "THIS_QUARTER";
a6 = "true";
resultA = RunScript("<TAG>script:ValWrap</TAG>",
    a1, a2, a3, a4, a5, a6);

// Validation of a String Date
b1 = "02192018";
b2 = "Date";
b3 = "mmddyyyy";
b4 = "=";
b5 = "THIS_QUARTER";
b6 = "true";
resultB = RunScript("<TAG>script:ValWrap</TAG>",
    b1, b2, b3, b4, b5, b6);

// Validation of an Integer
c1 = 100;
c2 = "Integer";
c3 = "";
c4 = ">";
c5 = 1000;
c6 = "true";
resultC = RunScript("<TAG>script:ValWrap</TAG>",
    c1, c2, c3, c4, c5, c6);