Transformationsfunktionen

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 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 RohXML zu serialisieren.

    Verfügbare Transformationsfunktionskategorien umfassen Datum und Uhrzeit , Zeichenfolge , Dienstprogramme , Einfache Mathematik , Bereinigen Sie Shell-Argumente , Bereinigen Sie SQL , Und Komplexe Daten . Einige Beispiele für die Verwendung von Transformationsfunktionen sind:

    • Schneiden von Leerzeichen aus einer Zeichenfolge ab, bevor sie in integriert werden CMDB.
    • Hinzufügen von Tagen, Stunden, Minuten und Sekunden zu einem Datum oder einer Uhrzeit zur Lokalisierung für eine bestimmte Zeitzone.
    • SQL-Werte werden bereinigt, um die Injektion als Teil von zu verhindern JDBC-Schritt Für einen IntegrationHub Spoke.
    • Abrufen eines entsprechenden Werts aus einer Zuordnung von Prioritäten mit entsprechenden Werten in einer Drittpartei-Datenbank.
    • Umwandlung eines komplexen Objekts in Rohdaten-XML als Teil von REST-Schritt Anforderungstext Feld.
    Hinweis:
    Anwenderdefinierte Transformationsfunktionen werden derzeit nicht unterstützt. Informationen zum Erstellen anwenderdefinierter Funktionen zum Transformieren Workflow-Studio Daten, siehe Inline-Skripts .

    Transformationsfunktion wird angewendet

    Sie können eine Transformationsfunktion auf eine Datenpille anwenden, wenn Sie einen Flow entwerfen oder erstellen. Um eine Transformationsfunktion anzuwenden, zeigen Sie auf eine Datenpille, und wählen Sie aus f(x) ( Funktionssymbol) Symbol, das angezeigt wird. Wenn Sie das Symbol auswählen, wird die Liste der verfügbaren Transformationen angezeigt. Wählen Sie die Transformationsfunktion aus, die Sie auf Ihre Datenpille anwenden möchten, geben Sie Informationen in alle erforderlichen Felder ein, und wählen Sie aus Anwenden . Ihre ausgewählte Transformationsfunktion wird in der Liste „angewendete Transformationen“ angezeigt.

    Eine Transformationsfunktion wird auf eine Datenpille angewendet.

    Mehrere Transformationsfunktionen werden angewendet

    Sie können mehrere Transformationsfunktionen auf dieselbe Datenpille anwenden. Das System wendet Transformationsfunktionen sequenziell von oben nach unten an, wie in der Liste der angewendeten Transformationen aufgeführt. Sie können beispielsweise eine Transformationsfunktion „Zeichenfolge auf Datum“ gefolgt von der Transformationsfunktion „Zeit hinzufügen“ anwenden.

    Angewendete Transformationsfunktionen anzeigen

    Sie können herausfinden, welche Transformationsfunktionen auf eine Datenpille angewendet werden, indem Sie sich die Liste der angewendeten Transformationen ansehen. Wenn Sie einen Flow oder eine Aktion entwerfen oder erstellen, zeigen Sie auf oder Registerkarte in der Datenpille, und wählen Sie aus f(x) ( Funktionssymbol ausgewählt)-Symbol. Sie können auch angewendete Transformationsfunktionen in anzeigen Flow-Ausführungsdetails .
    Hinweis:
    Die Ausgabewerte für angewendete Transformationsfunktionen sind Feldwerte, nicht Anzeigewerte .
    Wenn eine Datenpille in bestimmte 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 zu vermeiden, Skripteinschleusungen 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 Arten von Datenpillen für die Eingabe an
    Überprüfen Sie 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, löst das System einen Fehler aus, wenn die Transformation kein gültiges Datum erzeugt.
    Bestätigen Sie die angewendeten Transformationsfunktionen für mehrere Eingaben mit derselben Datenpille
    Eine Transformationsfunktion erstellt zur Laufzeit einen neuen Wert für eine bestimmte Eingabe und ändert die ursprüngliche Datenpille nicht. Wenn Sie dieselbe Datenpille für mehrere Aktionen oder Schritte verwenden, Transformationsfunktionen müssen daher auf jeden einzelnen Inpu angewendet werden t.
    Zeigen Sie die endgültigen transformierten Werte in den Flow-Ausführungsdetails an
    Nur der endgültige transformierte Wert wird in angezeigt Flow-Ausführungsdetails , 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 Testen Sie einen Flow Und Testen Sie eine Aktion .