TransformerRuleList – Scoped, Global

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 18 Minuten Lesedauer

    • Mit der TransformerRuleList -API können Sie eine Liste von Regeln für die Umwandlung verschiedener Arten von JSON- und XML-Daten in eine Name-Wert-Paar-Ausgabe erstellen.

    Die TransformerRuleList -API funktioniert zusammen mit den APIs Transformer und TransformerDefinition. Zusammen wandeln diese APIs XML-Knoten oder eine beliebige Entität in einem strukturierten JSON-Dokument in eine Ausgabe von Name-Wert-Paaren um. Unterstützte JSON-Entitäten, einschließlich Objekte und Elemente innerhalb eines Arrays, z. B. Zeichenfolgen, Zahlen und andere Arrays.

    • Mit der TransformerRuleList -API können Sie Transformationsregellisten erstellen, die definieren, welche Daten im Quelldokument in die Ausgabe aufgenommen werden sollen und wie die Quelldaten transformiert werden.

    • Die TransformerDefinition -API verknüpft eine Transformationsregelliste mit einem JSON/XML-Datensatzpfad, um wiederverwendbare Transformationsdefinitionsobjekte zu definieren. Sie können ein Transformationsdefinitionsobjekt verwenden, um ein oder mehrere Quelldokumente umzuwandeln.

    • Die Transformer -API führt die tatsächliche Datentransformation für eine Datenentität nach der anderen durch und verwendet dabei die angegebene Transformationsregelliste, um die gewünschten Ausgabedaten zu erstellen.

    Wenn Sie das TransformRuleList -Objekt instanziieren, müssen Sie definieren, ob es ein JSON- oder XML-Quelldokument mit den Methoden .fromJSON() oder .fromXML() beschreibt. Beispiel:

    var trl = sn_tfrm.TransformerRuleList().fromJSON(); oder var trl = sn_tfrm.TransformerRuleList().fromXML();

    Verwenden Sie dann die addRule()- Methode, um eine Transformationsregel für jedes Element im Quelldokument zu definieren, das Sie als Name-Wert-Paar in die Ausgabe aufnehmen möchten.

    Verwenden Sie Adaptermethoden wie setName() oder thenAdd(), um zu definieren, wie Datenelemente bei der Transformation bearbeitet werden sollen. Adaptermethoden funktionieren zusammen mit der addRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern. Sie können eine oder mehrere Adaptermethoden auf jede Datentransformation anwenden. Mit Adaptermethoden können Sie beispielsweise Folgendes tun:
    • Verketten Sie den Text.
    • Führen Sie mathematische Funktionen aus, z. B. Addieren, Subtrahieren, Dividieren und Multiplizieren.
    • Runden Sie die Werte auf oder ab (aufrunden, Obergrenze/Boden).
    • Legen Sie fest, ob beim Vergleich eines Quelldatenelements mit einem angegebenen Wert der Mindest- oder Höchstwert verwendet werden soll.
    • Wenden Sie einen Währungscode an.
    • Konvertieren Sie zwischen verschiedenen Maßeinheiten.
    • Datenelemente formatieren.
    • Wenden Sie Muster an.
    • Ersetzen Sie die angegebenen Datenelemente durch einen angegebenen Wert.
    • Zeichenfolgen teilen und neu anordnen.

    Sie können die TransformerRuleList -Klasse sowohl in bereichsbezogenen als auch in globalen Serverskripts verwenden. Wenn Sie diese Klasse in einer bereichsbezogenen Anwendung verwenden, verwenden Sie den Namespace-Identifier sn_tfrm. Bevor diese API in einer Instanz verfügbar ist, müssen Sie außerdem das Transformation Service-Plugin (com.glide.transform) aktivieren.

    TransformerRuleList – addRule(String rule, String path)

    Erstellt einen Eintrag in der zugehörigen Liste der Transformationsregeln, der ein Feld definiert, das in der Ausgabe erstellt werden soll.

    Sie können Regeln für jedes Element in einem Quelldokument erstellen. Beispiel: .addRule('ticker', '$.quote.symbol') erstellt das Feld „ticker“ in der Ausgabe und kopiert den Wert in „quote.symbol“ der Quelle.

    Sobald Sie eine Regel mit addRule()definiert haben, verwenden Sie Adaptermethoden wie thenAdd(), thenReplace()und thenFloor(), um die Ausgabedaten der Regel zu bearbeiten. Sie können beliebig viele Adaptermethoden für eine einzelne Regel definieren. Alle Adaptermethoden direkt nach einem addRule() -Aufruf gelten bis zum nächsten addRule() -Aufruf für diese Regel. Adaptermethoden sind kumulativ, wobei das Ergebnis aller Adaptermethoden der endgültige Wert ist, der im Ausgabefeld gespeichert wird.

    Im folgenden Code-Fragment gelten beispielsweise thenMultiply() und thenRoundDown() für addRule('change_percentage', '$.quote.changePercent'); addRule('close_price', '$.quote.close') startet eine neue Regel. Wenn der Wert in $.quote.changePercent.011 ist, dann ist der endgültige Ausgabewert „1“ ( .011 * 100 abgerundet auf die Einerposition).

    
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close')

    Die addRule()- Methode unterstützt auch den Parameter summary. .addRule('summary'). Diese Implementierung erstellt das Namensfeld „summary:“ in der Ausgabe, korreliert es jedoch mit keinem Feld in der Quelle. Anschließend können Sie die Adaptermethoden „thenConcat() “ und „thenConcatSymbol()“ verwenden, um den Inhalt des Zusammenfassungsfelds zu ändern.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Regel Zeichenfolge Name des Elements in der Zielausgabe.
    path Zeichenfolge Optional. JSONPath oder XPath zum Datenelement im Quelldokument.

    Für die Adaptermethoden „thenConcat() “ und „thenConcatSymbol()“ müssen Sie diesen Parameter nicht definieren, wenn keine anderen Adaptermethoden für die Regel definiert sind. Alle anderen Adaptermethoden erfordern diesen Parameter.
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('summary') 
  .thenConcat('Shares of ') 
  .thenConcatSymbol('ticker') 
  .thenConcat(' closed at ') 
  .thenConcatSymbol('close_price');

    TransformerRuleList – setName(String name)

    Definiert einen Namen für das zugeordnete TransformerRuleList-Objekt zu Protokollierungszwecken.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name zur Identifizierung des zugeordneten TransformerRuleList-Objekts.

    Obwohl die API die Eindeutigkeit dieses Namens nicht erzwingt, ist es hilfreich, wenn sie innerhalb einer Instanz eindeutig sind.
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('summary') 
  .thenConcat('Shares of ') 
  .thenConcatSymbol('ticker') 
  .thenConcat(' closed at ') 
  .thenConcatSymbol('close_price');

    TransformerRuleList – thenAdaptCurrency(String WährungsCode, Boolean AusgabeNumericCurrencyValue)

    Fügt der aktuellen Regel einen Adapter hinzu, der den angegebenen Währungscode an das Ausgabefeld bindet, das im zugehörigen addRule()- Aufruf definiert ist.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 5. Parameter
    Name Typ Beschreibung
    currencyCode Zeichenfolge Währungscode, der an das Zieldatenelement gebunden werden soll, z. B. USD, EUR und GBP.
    AusgabeNumericCurrencyValue Boolean Optional. Kennzeichnung, die angibt, ob der Währungscode angezeigt werden soll.

    Gültige Werte:

    • true: Ländercode nicht anzeigen; Nur numerischer Wert
    • false: Ländercode anzeigen

    Standardwert: false
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('summary') 
  .thenConcat('Shares of ') 
  .thenConcatSymbol('ticker') 
  .thenConcat(' closed at ') 
  .thenConcatSymbol('close_price');

    TransformerRuleList – thenAdaptDuration(String inputDuration, StringoutputDuration)

    Fügt der aktuellen Regel einen Adapter hinzu, der das Quellfeld von einer Maßeinheit in eine andere konvertiert, z. B. von Minuten in Sekunden oder Wochen in Tage.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 7. Parameter
    Name Typ Beschreibung
    inputDuration Zeichenfolge Aktuelle Maßeinheit des Quellfelds.

    Gültige Werte:

    • nanOSEKUNDE
    • MIKROSKUNDE
    • MILLISKUNDE
    • ZWEITER
    • MINUTE
    • STUNDE
    • TAG
    • WOCHE
    AusgabeDuration Zeichenfolge Maßeinheit, in die das Quellfeld in der Ausgabe konvertiert werden soll.

    Gültige Werte:

    • nanOSEKUNDE
    • MIKROSKUNDE
    • MILLISKUNDE
    • ZWEITER
    • MINUTE
    • STUNDE
    • TAG
    • WOCHE
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('daily', '$.quote.weekly') 
  .thenAdaptDuration('WEEK', 'DAY');

    TransformerRuleList – thenAdd(Number operand)

    Fügt der aktuellen Regel einen Adapter hinzu, der dem Quellfeld den übergebenen Wert hinzufügt.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Operand Nummer Wert, der dem Quellfeld hinzugefügt werden soll.
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList.fromJSON()
  .setName('Stock Report 05182019 JSON')
  .addSymbol('ticker', '$.symbol') 
  .addSymbol('change_percentage', '$.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addSymbol('trade_price', '$.current_price')
  .thenAdaptCurrency('USD', false) 
  .addMultiply('$.trade_quantity')
  .thenAdd('4.5');

    TransformerRuleList – thenApplyMap(Object map)

    Fügt der aktuellen Regel einen Adapter hinzu, der das zugeordnete Quellfeld nach einer Liste von Zeichenfolgen durchsucht und diese in der Ausgabe durch die angegebenen Ersetzungswerte ersetzt.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 11. Parameter
    Name Typ Beschreibung
    Zuordnen Objekt Name/Wert-Paare.
    • name: Text, der im Quelldatenelement gesucht werden soll
    • Wert: Text, durch den er in der Ausgabe ersetzt werden soll
    Tabelle : 12. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt.

    In diesem Beispiel durchsucht der Aufruf von thenApplyMap() den Quelltext im Feld company_info nach Inc. und St. und ersetzt sie durch Incorporated und Street im Feld company_info in der Ausgabe.

    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('company_info', '$.quote.company_info') 
  .thenApplyMap({'Inc.': 'Incorporated', 'St.': 'Street'});

    TransformerRuleList – thenApplyPattern(String matchPattern, StringoutputPattern

    Fügt der aktuellen Regel einen Adapter hinzu, der ein angegebenes Muster für reguläre Ausdrücke mit dem Inhalt im Quellfeld übereinstimmt und diesen Inhalt dann durch ein zweites Muster für reguläre Ausdrücke ersetzt/neu formatiert und diesen Wert in der Ausgabe speichert.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 13. Parameter
    Name Typ Beschreibung
    matchPattern Zeichenfolge Muster des regulären Ausdrucks, das verwendet wird, um den zu ersetzenden/neu zu formatierenden Text zu finden.
    Ausgabemuster Zeichenfolge Muster des regulären Ausdrucks, das zum Aktualisieren des gefundenen Texts verwendet werden soll.
    Tabelle : 14. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt.

    In diesem Beispiel kann jeder Unternehmensname, der mit „Inc.“ endet, verwendet werden. wird in „Incorporated“ umgewandelt, z. B. „Company Inc.“ in „Company Incorporated“.

    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('company', '$.quote.company') 
  .thenApplyPattern('(.+)(\\w{3}\\.)', '$1Incorporated');

    TransformerRuleList – thenCeiling(Number operand)

    Fügt der aktuellen Regel eine Aktion hinzu, um das Quellfeld an der durch den übergebenen Wert angegebenen Dezimalposition aufzurunden.

    Im Gegensatz zur geraden Rundung, bei der die Zahl basierend auf dem Wert der Ziffer an der angegebenen Dezimalposition gerundet wird (0–4 abgerundet, 5–9 abgerundet), wird bei der Obergrenze immer aufgerundet. Zum Beispiel ist der Obergrenzenwert für 2,156 und 2,152 immer 2,16 für die übergebene Dezimalposition von 2; während die Werte für gerades Runden 2,16 bzw. 2,15 wären. Bei negativen Zahlen wird die Zahl durch den Obergrenzenvorgang positiver, da der Obergrenzenwert von -2,156 -2,15 ist. während die gleiche aufgerundete Zahl den Wert negativer macht, -2,16.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Operand Nummer Dezimalstelle rechts von der Dezimalstelle, an der die Zahl aufgerundet werden soll (Obergrenze anwenden).

    Wenn dieser Wert beispielsweise 2 ist und das Quelldatenelement 6.421 ist, lautet der resultierende Wert 6.43.
    Tabelle : 16. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Mortgage Rates 05022019 JSON')
  .addRule('interest_rate', '$.quote.interest_rate') 
  .thenCeiling('2') // Always round the interest rate up to the hundredths place 
  .addRule('monthly_payment', '$.quote.total_loan_amount') 
  .thenDivideBy('180');

    TransformerRuleList – thenConcat(String value)

    Fügt der aktuellen Regel einen Adapter hinzu, der die übergebene Zeichenfolge mit dem Ausgabefeld verkettet.

    Im Gegensatz zu anderen Adaptermethoden muss diese Methode nicht auf ein Quellfeld angewendet werden. Sie können diese Methode verwenden, um vollständig neue Datenzeichenfolgen in der Ausgabe zu erstellen.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 17. Parameter
    Name Typ Beschreibung
    Wert Zeichenfolge Text, der bis zum Ende des aktuellen Datenelements verkettet werden soll.
    Tabelle : 18. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('summary') 
  .thenConcat('Shares of ') 
  .thenConcatSymbol('ticker') 
  .thenConcat(' closed at ') 
  .thenConcatSymbol('close_price');

    TransformerRuleList – thenConcatSymbol(String symbol)

    Fügt der aktuellen Regel einen Adapter hinzu, der den Wert eines zuvor in der Regelliste definierten Felds mit dem aktuellen Ausgabefeld verkettet.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 19. Parameter
    Name Typ Beschreibung
    -Symbol Zeichenfolge Name des Regellistenelements, das an das Ausgabefeld angehängt werden soll.
    Tabelle : 20. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('summary') 
  .thenConcat('Shares of ') 
  .thenConcatSymbol('ticker') 
  .thenConcat(' closed at ') 
  .thenConcatSymbol('close_price');

    TransformerRuleList – thenDivideBy(Number operand)

    Fügt der aktuellen Regel einen Adapter hinzu, der das Quellfeld durch den übergebenen Wert teilt.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 21. Parameter
    Name Typ Beschreibung
    Operand Nummer Wert, durch den das Quellfeld geteilt werden soll.
    Tabelle : 22. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('dividend_per_share', '$.quote.total_dividend') 
  .thenDivideBy('$.quote.total_shares');

    TransformerRuleList – thenDivideInto(Number operand)

    Fügt der aktuellen Regel einen Adapter hinzu, der den übergebenen Wert durch das Quellfeld teilt.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 23. Parameter
    Name Typ Beschreibung
    Operand Nummer Wert, in den das Quellfeld aufgeteilt werden soll.
    Tabelle : 24. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('dividend_per_share', '$.quote.total_shares') 
  .thenDivideInto('$.quote.total_dividends');

    TransformerRuleList – thenFloor(Number operand)

    Fügt der aktuellen Regel einen Adapter hinzu, der das Quellfeld an der durch den übergebenen Wert angegebenen Dezimalposition abrundet und in der Ausgabe speichert.

    Im Gegensatz zur direkten Rundung, bei der die Zahl basierend auf dem Wert der Ziffer an der angegebenen Dezimalposition gerundet wird (0-4 abrunden, 5-9 aufrunden), wird beim Mindestwert immer abgerundet. Zum Beispiel ist der Mindestwert für 2,156 und 2,152 immer 2,15 für die übergebene Dezimalposition von 2; während die Werte für gerades Runden 2,16 bzw. 2,15 wären. Bei negativen Zahlen macht der Stockwerkvorgang die Zahl negativer, da der Stockwerkswert -2,156 -2,16 ist; während die gleiche Zahl nach unten den Wert positiver macht, -2,15.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 25. Parameter
    Name Typ Beschreibung
    Operand Nummer Dezimalstelle rechts von der Dezimalstelle, an der die Zahl abgerundet werden soll (Grundriss anwenden).

    Wenn dieser Wert beispielsweise 2 ist und das Quelldatenelement 6.427 ist, lautet der resultierende Wert 6.42.
    Tabelle : 26. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Mortgage Rates 05022019 JSON')
  .addRule('interest_rate', '$.quote.interest_rate') 
  .thenFloor('2') // Always round the interest rate down to the hundreths place 
  .addRule('monthly_payment', '$.quote.total_loan_amount') 
  .thenDivideBy('180');

    TransformerRuleList – thenFormat(String matchPattern, StringoutputPattern)

    Fügt der aktuellen Regel einen Adapter hinzu, der den Inhalt im Quellfeld, das dem angegebenen Abgleichsmuster entspricht, mit dem angegebenen Ausgabemuster neu formatiert.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 27. Parameter
    Name Typ Beschreibung
    matchPattern Zeichenfolge Muster, das mit dem Quellfeld abgeglichen werden soll.

    Gültige Werte:

    • @: beliebiges Zeichen
    • #: Dezimalstelle
    • \: wörtliches Escape-Zeichen (\@ für das @-Symbol)
    Ausgabemuster Zeichenfolge Muster, durch das der Inhalt in der Ausgabe ersetzt werden soll.

    Gültige Werte:

    • @: beliebiges Zeichen
    • #: Dezimalstelle
    • \: wörtliches Escape-Zeichen (\@ für das @-Symbol)
    Tabelle : 28. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt.

    In diesem Beispiel wird das Angebotsdatum von JJJJ/MM/TT in JJJJ MM-TT neu formatiert.

    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('date', '$.quote.date') 
  .thenFormat('####/##/##', '#### ##-##');

    TransformerRuleList – thenMax(Number operand)

    Fügt der aktuellen Regel einen Adapter hinzu, der den übergebenen Wert mit dem Quellfeld vergleicht und den größeren der beiden Werte in das Ausgabefeld kopiert.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 29. Parameter
    Name Typ Beschreibung
    Operand Nummer Wert, der mit dem Quellfeld verglichen werden soll.
    Tabelle : 30. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Mortgage Rates 05022019 JSON')
  .addRule('lowest_interest_rate', '$.quote.interest_rate') 
  .thenMax('3.5') // Interest rate cannot be less than 3.5%
  .addRule('dividend_per_share', '$.quote.total_shares') 
  .thenDivideInto('$.quote.total_dividends');

    TransformerRuleList – thenMin(Number operand)

    Fügt der aktuellen Regel einen Adapter hinzu, der den übergebenen Wert mit dem Quellfeld vergleicht und den niedrigeren der beiden Werte in das Ausgabefeld kopiert.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 31. Parameter
    Name Typ Beschreibung
    Operand Nummer Wert, der mit dem Quellfeld verglichen werden soll.
    Tabelle : 32. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addSymbol('broker_fee_percentage', '$.quote.broker_fee') 
  .thenMin('10') // Maximum of 10% broker fee
  .addSymbol('dividend_per_share', '$.quote.total_shares') 
  .thenDivideInto('$.quote.total_dividends');

    TransformerRuleList – thenMultiply(Number operand)

    Fügt der aktuellen Regel einen Adapter hinzu, der das Quellfeld mit dem übergebenen Wert multipliziert.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 33. Parameter
    Name Typ Beschreibung
    Operand Nummer Wert, mit dem das Quellfeld multipliziert werden soll.
    Tabelle : 34. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('summary') 
  .thenConcat('Shares of ') 
  .thenConcatSymbol('ticker') 
  .thenConcat(' closed at ') 
  .thenConcatSymbol('close_price');

    TransformerRuleList – thenReplace(String matchString, String replaceString)

    Fügt der aktuellen Regel einen Adapter hinzu, der den gesamten Text im Quellfeld findet, der einer angegebenen Zeichenfolge entspricht, und ihn durch eine aktualisierte Zeichenfolge ersetzt.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 35. Parameter
    Name Typ Beschreibung
    matchString Zeichenfolge Zeichenfolge, die mit dem Quellfeld abgeglichen werden soll, um den zu ersetzenden Text zu identifizieren.
    replaceString Zeichenfolge Zeichenfolge, durch die der übereinstimmende Text ersetzt werden soll.
    Tabelle : 36. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt.

    In diesem Beispiel kann jeder Unternehmensname, der mit „Inc.“ endet, verwendet werden. wird in „Incorporated“ umgewandelt, z. B. „Company Inc.“ in „Company Incorporated“.

    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('company', '$.quote.company') 
  .thenReplace('Inc.', 'Incorporated');

    TransformerRuleList – thenRoundDown(Number operand)

    Fügt der aktuellen Regel einen Adapter hinzu, der das Quellfeld an der durch den übergebenen Wert angegebenen Dezimalposition abrundet.

    Bei negativen Zahlen macht die thenRoundDown()- Methode die Zahl positiver. der Abrundungswert von -2,156 ist -2,15. Die Methode thenFloor() macht die gleiche Zahl negativer, -2,16.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 37. Parameter
    Name Typ Beschreibung
    Operand Nummer Dezimalstelle rechts von der Dezimalstelle, an der die Zahl abgerundet werden soll.

    Wenn dieser Wert beispielsweise 2 ist und das Quelldatenelement 6.427 ist, lautet der resultierende Wert 6.42.
    Tabelle : 38. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList90
  .fromJSON()
  .setName('Mortgage Rates 05022019 JSON')
  .addRule('interest_rate', '$.quote.interest_rate') 
  .thenRoundDown('2') // Always round the interest rate down to the hundredths place 
  .addRule('monthly_payment', '$.quote.total_loan_amount') 
  .thenDivideBy('180');

    TransformerRuleList – thenRound Up(Number operand)

    Fügt der aktuellen Regel einen Adapter hinzu, der das Quelldatenelement an der durch den übergebenen Wert angegebenen Dezimalposition aufrundet.

    Bei negativen Zahlen macht die Methode thenRoundUp() die Zahl negativer. der Aufrundungswert von -2,156 ist -2,16. Die Methode thenCeiling() macht die gleiche Zahl positiver, -2,15.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 39. Parameter
    Name Typ Beschreibung
    Operand Nummer Dezimalstelle rechts von der Dezimalstelle, an der die Zahl aufgerundet werden soll.

    Wenn dieser Wert beispielsweise 2 ist und das Quelldatenelement 6.422 ist, lautet der resultierende Wert 6.43.
    Tabelle : 40. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Mortgage Rates 05022019 JSON')
  .addRule('interest_rate', '$.quote.interest_rate') 
  .thenRoundUp('2') // Always round the interest rate up to the hundredths place 
  .addRule('monthly_payment', '$.quote.total_loan_amount') 
  .thenDivideBy('180');

    TransformerRuleList – thenSplit(String splitPattern, String replaceString)

    Fügt der aktuellen Regel einen Adapter hinzu, der Zeichenfolgen im Quellfeld aufteilt, neu organisiert und ersetzt und im Ausgabefeld speichert.

    Der Parameter splitPattern gibt an, wie die Quelltextzeichenfolge in Segmente unterteilt wird. Dieser Parameter kann ein typisches Worttrennzeichen sein, z. B. ein Leerzeichen (' '), ein Komma (',') oder ein Semikolon (';'), aber auch eine beliebige Zeichenfolge, z. B. 'name'. Beispiel: Wenn der Quelltext „Smith John Michael“ lautet und splitPattern ein Leerzeichen ist, sind die verfügbaren Segmente „Smith“, „John“ und „Michael“. Um auf ein Segment zu verweisen, verwenden Sie $#, wobei # die Nummer der Reihenfolge des Segments in der Quelltextzeichenfolge ist. Wenn der Methodenaufruf beispielsweise thenSplit(' ', '$2 $3 $1')lautet, lautet die Ausgabe „John Michael Smith“. Darüber hinaus können Sie Konstanten innerhalb des Ausgabemusters hinzufügen, z. B. thenSplit(' ', 'First name: $2 Middle name: $3 Last name: $1').

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 41. Parameter
    Name Typ Beschreibung
    splitPattern Zeichenfolge Zeichenfolge, die angibt, wie der Text in Segmente aufgeteilt wird.
    replaceString Zeichenfolge Zeichenfolge, die die Ausgabezeichenfolge definiert, einschließlich Segmentreferenzen und Konstanten. Nicht alle Segmente müssen referenziert werden.

    Referenzieren Sie die von splitPattern definierten Segmente mit $#, wobei # die Nummer der Reihenfolge des Segments im Quelldatenelement ist. Referenzieren Sie das gesamte Quelldatenelement mit $0.
    Tabelle : 42. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt.

    In diesem Beispiel lautet der Name des CEO Nachname, Vorname in den Quelldaten und wird in der Ausgabe in Vorname Nachname umgewandelt.

    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('CEO', '$.quote.CEO') 
  .thenSplit(',', '$2 $1');

    TransformerRuleList – thenSubtract(Number operand)

    Fügt der aktuellen Regel einen Adapter hinzu, der den übergebenen Wert aus dem Quellfeld subtrahiert und im Ausgabefeld speichert.

    Hinweis:
    Dies ist eine Adaptermethode und kann nicht allein verwendet werden. Adaptermethoden funktionieren in Verbindung mit deraddRule()- Methode. Sie definieren Anpassungen, die auf das durch die addRule()- Methode definierte Ausgabefeld angewendet werden sollen, z. B. Formatierung, Rundung und Anwendung von Mustern.
    Tabelle : 43. Parameter
    Name Typ Beschreibung
    Operand Nummer Wert, der vom Quelldatenelement subtrahiert werden soll.
    Tabelle : 44. Ergebnisse
    Typ Beschreibung
    Objekt Aktuelles TransformerRuleList-Objekt. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock 05182019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('trade_price', '$.quote.current_price') 
  .addMultiply('$.quote.trade_quantity')
  .thenSubtract('$.quote.discount_dollars');