Transformationsfunktionen

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 3 Minuten Lesedauer

    • Transformieren Sie Datenpillenwerte, ohne ein Skript schreiben zu müssen. Verwenden Sie Transformationsfunktionen, um Text neu zu formatieren, mathematische Berechnungen durchzuführen, potenziell unsichere SQL-Anweisungen zu bereinigen und komplexe Objekte in Roh-XML zu serialisieren.

    Zu den verfügbaren Kategorien für Transformationsfunktionen gehören Datum und Uhrzeit, Zeichenfolge, Dienstprogramme, einfache Berechnung, Shell-Argumentebereinigen, SQL bereinigenund komplexe Daten. Einige Beispiele für die Verwendung von Transformationsfunktionen sind:

    • Leerzeichen aus einer Zeichenfolge entfernen, bevor sie in CMDBintegriert werden.
    • Hinzufügen von Tagen, Stunden, Minuten und Sekunden zu einem Datum oder einer Uhrzeit, um sie für eine bestimmte Zeitzone zu lokalisieren.
    • SQL-Werte werden bereinigt, um die Einschleusung als Teil eines JDBC-Schritts für eine IntegrationHub -Spoke zu verhindern.
    • Abrufen eines geeigneten Werts aus einer Zuordnung von Prioritäten, die entsprechende Werte in einer Drittanbieterdatenbank haben.
    • Transformiert ein komplexes Objekt in Roh-XML als Teil eines REST-Schritt -Felds „ Anforderungstext“.
    Hinweis:
    Anwenderdefinierte Transformationsfunktionen werden derzeit nicht unterstützt. Informationen zum Erstellen anwenderdefinierter Funktionen zum Transformieren von Workflow-Studio -Daten finden Sie unter Inline-Skripts.

    Eine Transformationsfunktion wird angewendet

    Sie können eine Transformationsfunktion auf eine Datenpille anwenden, wenn Sie einen Flow entwerfen oder erstellen. Zum Anwenden einer Transformationsfunktion zeigen Sie mit dem Mauszeiger auf eine Datenpille, und wählen Sie das angezeigte Symbol f(x) ( Funktionssymbol). Wenn Sie das Symbol wählen, wird die Liste Verfügbare Transformationen angezeigt. Wählen Sie die Transformationsfunktion aus, die Sie auf Ihre Datenpille anwenden möchten, geben Sie Informationen in die erforderlichen Felder ein, und wählen Sie Anwendenaus. Die ausgewählte Transformationsfunktion wird in der Liste Angewendete Transformationen angezeigt.

    Transformationsfunktion auf eine Datenpille anwenden.

    Mehrere Transformationsfunktionen anwenden

    Sie können mehrere Transformationsfunktionen auf dieselbe Datenpille anwenden. Das System wendet die Transformationsfunktionen der Reihe nach von oben nach unten an, wie in der Liste Angewendete Transformationen aufgeführt. Sie können beispielsweise eine Transformationsfunktion für Zeichenfolge in Datum gefolgt von der Transformationsfunktion für Add Time anwenden.

    Angewendete Transformationsfunktionen werden angezeigt

    Welche Transformationsfunktionen auf eine Datenpille angewendet werden, erfahren Sie in der Liste „Angewendete Transformationen“. Wenn Sie einen Flow oder eine Aktion entwerfen oder erstellen, zeigen Sie auf die Datenpille, oder tippen Sie darauf, und wählen Sie das Symbol f(x) ( Funktionssymbol ausgewählt). Sie können die angewendeten Transformationsfunktionen auch in den Flow-Ausführungsdetailsanzeigen.
    Hinweis:
    Die Ausgabewerte für angewendete Transformationsfunktionen sind Feldwerte, keine Anzeigewerte.
    Wenn eine Datenpille in bestimmten Eingabetypen abgelegt wird, schlägt das System automatisch eine Transformationsfunktionskategorie vor, die sich auf die Eingabe bezieht. Das System schlägt beispielsweise Transformationsfunktionen vor, um Sonderzeichen in SQL-Anweisungen mit Escape-Zeichen zu versehen, die Skriptinjektion in Shell-Skripts zu verhindern und API- oder Vorgangsanforderungen zu validieren. Derzeit schlägt das System Transformationsfunktionskategorien für diese Eingaben vor:

    Allgemeine Leitlinien

    Wenden Sie Transformationsfunktionen auf gültige Typen von Datenpillen für die Eingabe an
    Überprüfen Sie unbedingt den Typ der Datenpille für die Eingabe, bevor Sie eine Transformationsfunktion anwenden. Das Anwenden einer Transformationsfunktion auf einen ungültigen Datenpillentyp führt dazu, dass das System die Transformation überspringt. Ein Fehler tritt auch auf, wenn Transformationsfunktionen Ergebnisse erzeugen, die vom System nicht analysiert werden können. Beispiel: Wenn eine Zeichenfolge in ein Datum umgewandelt wird, gibt das System einen Fehler aus, wenn die Umwandlung kein gültiges Datum ergibt.
    Angewendete Transformationsfunktionen für mehrere Eingaben mit derselben Datenpillebestätigen
    Eine Transformationsfunktion erstellt zur Laufzeit einen neuen Wert für eine bestimmte Eingabe und ändert die ursprüngliche Datenpille nicht. Wenn Sie dieselbe Datenpille über mehrere Aktionen oder Schritte hinweg verwenden, müssen die Transformationsfunktionendaher auf jede einzelne Eingabe angewendet werden.
    Zeigen Sie die endgültigen transformierten Werte in den Flow-Ausführungsdetails an
    In den Flow-Ausführungsdetailswird nur der endgültig transformierte Wert angezeigt, nicht der Wert für jede angewendete Transformation.
    Testen Sie die Transformationsfunktionen, um sicherzustellen, dass sie die erwarteten Ergebnisse liefern
    Stellen Sie sicher, dass Ihre Transformationsfunktionen die erwarteten Laufzeitwerte für die Datenpillen liefern. Weitere Informationen finden Sie unter Flowtesten und Aktion testen.