Transformationsfunktionen

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 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 Transformationsfunktionskategorien gehören Datum und Uhrzeit, Zeichenfolge, Dienstprogramme, einfache Berechnung, Shell-Argumentebereinigen, SQL bereinigenund komplexe Daten. Beispiele für die Verwendung von Transformationsfunktionen:

    • Leerzeichen aus einer Zeichenfolge entfernen, bevor sie in CMDBintegriert wird.
    • 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 äquivalente Werte in einer Drittanbieterdatenbank aufweisen.
    • Transformieren eines komplexen Objekts in Roh-XML als Teil eines REST-Schritt - Anforderungstextfelds.
    Hinweis:
    Benutzerdefinierte Transformationsfunktionen werden derzeit nicht unterstützt. Informationen zum Erstellen benutzerdefinierter Funktionen zum Transformieren von Flow Designer -Daten finden Sie unter Inline-Skripts.

    Anwenden einer Transformationsfunktion

    Sie können eine Transformationsfunktion auf eine Datenpille anwenden, wenn Sie einen Flow entwerfen oder erstellen. Um eine Transformationsfunktion anzuwenden, zeigen Sie mit dem Mauszeiger oder der Tabulatortaste auf eine Datenpille, und wählen Sie das angezeigte f(x)-Symbol (Funktionssymbol) aus. Wenn Sie auf das Symbol klicken, 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 „Angewandte Transformationen“ angezeigt.

    Anwenden einer Transformationsfunktion auf eine Datenpille.

    Anwenden mehrerer Transformationsfunktionen

    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 „Angewandte Transformationen“ aufgeführt. Sie können beispielsweise eine Transformationsfunktion für Zeichenfolge auf Datum anwenden, gefolgt von der Transformationsfunktion für Zeit hinzufügen.

    Angewendete Transformationsfunktionen anzeigen

    Sie können herausfinden, welche Transformationsfunktionen auf eine Datenpille angewendet werden, indem Sie sich die Liste „Angewandte Transformationen“ ansehen. Wenn Sie einen Flow oder eine Aktion entwerfen oder erstellen, zeigen Sie auf die Datenpille, und wählen Sie das Symbol f(x) ( Funktionssymbol ausgewählt) aus. Sie können angewendete 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. Beispielsweise schlägt das System Transformationsfunktionen vor, um Sonderzeichen in SQL-Anweisungen mit Escape-Zeichen zu versehen, die Skripteinschleusung in Shell-Skripts zu verhindern und API- oder Vorgangsanforderungen zu validieren. Derzeit schlägt das System Transformationsfunktionskategorien für die folgenden Eingaben vor:

    Allgemeine Richtlinien

    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 liefern, die das System nicht analysieren kann. Wenn Sie beispielsweise eine Zeichenfolge in ein Datum umwandeln, 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 nicht die ursprüngliche Datenpille. Wenn Sie dieselbe Datenpille für mehrere Aktionen oder Schritte verwenden, müssen Transformationsfunktionen daher auf jede einzelne Eingabeangewendet werden.
    Zeigen Sie die endgültigen transformierten Werte in den Details der Flow-Ausführung an
    Nur der endgültige transformierte Wert wird in den Details der Flow-Ausführungangezeigt und nicht der Wert für jede angewendete Transformation.
    Testen Sie Transformationsfunktionen, um sicherzustellen, dass sie die erwarteten Ergebnisse liefern
    Stellen Sie sicher, dass Ihre Transformationsfunktionen die erwarteten Laufzeitwerte für die Datenpillen erzeugen. Weitere Informationen finden Sie unter Flowstesten und Aktionen testen.