--- sourceDocument: Xanadu-Build-Workflows sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/build-workflows Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu-Build-Workflows ft:clusterId : - crworkflow bundleId : - crworkflow workflow : - Creator --- # Transformationsfunktionen # Transformationsfunktionen {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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](https://servicenow-prod.fluidtopics.net/fuQW6Q3ub14aUncM8pXPWQ "Verwenden Sie Datums- und Uhrzeittransformationsfunktionen, um Datenpillen für Datums-/Uhrzeitwerte neu zu berechnen oder neu zu formatieren."), [Zeichenfolge](https://servicenow-prod.fluidtopics.net/Qtn9f2I373ENu42s9bp71Q "Verwenden Sie Zeichenfolgentransformationsfunktionen, um Zeichenfolgendatenpillen neu zu formatieren oder Berechnungen durchzuführen."), [Dienstprogramme](https://servicenow-prod.fluidtopics.net/Tn6CM3lFEyIUuZBsi0iqOw "Verwenden Sie die Transformationsfunktionen von Dienstprogrammen, um ein komplexes Objekt aus einem Array oder einen Wert zurückzugeben, der einem bestimmten Schlüssel zugeordnet ist."), [einfache Berechnung](https://servicenow-prod.fluidtopics.net/tzWJhUGpjj1B~pdVZo_4zA "Verwenden Sie einfache mathematische Transformationsfunktionen, um grundlegende mathematische Berechnungen für Zahlen-Datenpillen durchzuführen."), [Shell-Argumente](https://servicenow-prod.fluidtopics.net/aOgswhyAA2olTmiWPNqqAw "Verwenden Sie die Transformationsfunktionen zum Bereinigen von Shell-Argumenten, um potenziell unsichere Befehlseinfügungen in Zeichenfolgendatenpillen zu entfernen, die für Bash-Shell-Skripting verwendet werden sollen.")bereinigen, [SQL bereinigen](https://servicenow-prod.fluidtopics.net/f4tMFTAWzDmCsFvKeJjp2g "Verwenden Sie SQL-Transformationsfunktionen bereinigen, um Sonderzeichen mit Escape-Zeichen zu versehen und die Einschleusung in Zeichenfolgendatenpillen zu verhindern, die für SQL-Anweisungen verwendet werden sollen.")und [komplexe Daten](https://servicenow-prod.fluidtopics.net/DwDB6yYSkXXqypghwWJerw "Verwenden Sie komplexe Datentransformationsfunktionen, um komplexe Objektdatenpillen in ein XML-Format zu serialisieren."). 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](https://servicenow-prod.fluidtopics.net/OzpgthqnQIewc_Oj__NYtg "Erstellen Sie eine wiederverwendbare Aktion, um SQL-Befehle an eine relationale Datenbank zu senden.") 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](https://servicenow-prod.fluidtopics.net/qBIp7gBa9DnOzz82FeLPmQ "Senden Sie eine ausgehende REST-Webdienstanforderung an ein externes System.") -Felds „ Anforderungstext". {#transform-functions__ul_n23_4cl_t3b} Hinweis: Anwenderdefinierte Transformationsfunktionen werden derzeit nicht unterstützt. Informationen zum Erstellen anwenderdefinierter Funktionen zum Transformieren von Workflow-Studio -Daten finden Sie unter [Inline-Skripts](https://servicenow-prod.fluidtopics.net/4HL3XimXMCUfCd4_ON8Bug "Ermöglichen Sie Anwendern mit Codierungserfahrung das Schreiben von Inline-Skripts, die Eingabewerte während der Konfiguration einer Aktion oder eines Flows festlegen und ändern. Verwenden Sie Inline-Skripts, um Eingabewerte zu ändern, die Kleinformatkonvertierungen, Datentransformationen oder mathematische Berechnungen erfordern."). ## Eine Transformationsfunktion wird angewendet {#transform-functions__section_rjd_mhl_t3b} 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. ## Mehrere Transformationsfunktionen anwenden {#transform-functions__section_f5v_dqn_kjb} 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 {#transform-functions__section_afb_fng_r3b} 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ührungsdetails](https://servicenow-prod.fluidtopics.net/EFcN4myXdQdmFz4tQRHiRQ "Zeigen Sie Laufzeitinformationen zu einer Aktion oder einem Flow direkt aus der Designumgebung an, z. B. den aktuellen Status, ausgeführte Elemente und erzeugte Werte. Öffnen Sie zugehörige Datensätze von eingebetteten Now Platform-Editoren aus oder in einer neuen Registerkarte.")anzeigen. Hinweis: Die Ausgabewerte für angewendete Transformationsfunktionen sind Feldwerte, keine [Anzeigewerte](https://www.servicenow.com/docs/access?context=c_DisplayValues&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). 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: * Für Datenpillen, die in der SQL-Anweisungseingabe des JDBC-Schritts abgelegt werden, wird automatisch [die Kategorie SQL-Transformationsfunktion bereinigen](https://servicenow-prod.fluidtopics.net/f4tMFTAWzDmCsFvKeJjp2g "Verwenden Sie SQL-Transformationsfunktionen bereinigen, um Sonderzeichen mit Escape-Zeichen zu versehen und die Einschleusung in Zeichenfolgendatenpillen zu verhindern, die für SQL-Anweisungen verwendet werden sollen.") angezeigt. * Für Datenpillen, die in der Befehlseingabe des SSH-Schritts abgelegt werden, wird automatisch [die Kategorie der Transformationsfunktion für Shell-Argumente bereinigen](https://servicenow-prod.fluidtopics.net/aOgswhyAA2olTmiWPNqqAw "Verwenden Sie die Transformationsfunktionen zum Bereinigen von Shell-Argumenten, um potenziell unsichere Befehlseinfügungen in Zeichenfolgendatenpillen zu entfernen, die für Bash-Shell-Skripting verwendet werden sollen.") angezeigt. {#transform-functions__ul_wd4_13d_ljb} ## Allgemeine Leitlinien {#transform-functions__id_m33_yvb_ptb} 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{#transform-functions__final-transformed-value} : In den [Flow-Ausführungsdetails](https://servicenow-prod.fluidtopics.net/EFcN4myXdQdmFz4tQRHiRQ "Zeigen Sie Laufzeitinformationen zu einer Aktion oder einem Flow direkt aus der Designumgebung an, z. B. den aktuellen Status, ausgeführte Elemente und erzeugte Werte. Öffnen Sie zugehörige Datensätze von eingebetteten Now Platform-Editoren aus oder in einer neuen Registerkarte.")wird 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 Flow](https://servicenow-prod.fluidtopics.net/qmlOq7vvK6cXTUIFfxbBFw "Bevor Sie einen Ablauf aktivieren, damit andere Benutzer darauf zugreifen können, testen Sie, ob er so funktioniert, wie Sie es erwarten.")[testen und Aktion testen](https://servicenow-prod.fluidtopics.net/IwFgwpLrQRWMsGiMe8ymdg "Testen Sie eine Aktion, bevor Sie sie für andere Anwender veröffentlichen."). * **[Datums-/Uhrzeit-Transformationsfunktionen](https://servicenow-prod.fluidtopics.net/fuQW6Q3ub14aUncM8pXPWQ)** Verwenden Sie Datums- und Uhrzeittransformationsfunktionen, um Datenpillen für Datums-/Uhrzeitwerte neu zu berechnen oder neu zu formatieren. * **[Zeichenfolgentransformationsfunktionen](https://servicenow-prod.fluidtopics.net/Qtn9f2I373ENu42s9bp71Q)** Verwenden Sie Zeichenfolgentransformationsfunktionen, um Zeichenfolgendatenpillen neu zu formatieren oder Berechnungen durchzuführen. * **[Mit Dienstprogrammen werden Funktionen transformiert](https://servicenow-prod.fluidtopics.net/Tn6CM3lFEyIUuZBsi0iqOw)** Verwenden Sie die Transformationsfunktionen von Dienstprogrammen, um ein komplexes Objekt aus einem Array oder einen Wert zurückzugeben, der einem bestimmten Schlüssel zugeordnet ist. * **[Einfache mathematische Transformationsfunktionen](https://servicenow-prod.fluidtopics.net/tzWJhUGpjj1B~pdVZo_4zA)** Verwenden Sie einfache mathematische Transformationsfunktionen, um grundlegende mathematische Berechnungen für Zahlen-Datenpillen durchzuführen. * **[Transformationsfunktionen für Shell-Argumente bereinigen](https://servicenow-prod.fluidtopics.net/aOgswhyAA2olTmiWPNqqAw)** Verwenden Sie die Transformationsfunktionen zum Bereinigen von Shell-Argumenten, um potenziell unsichere Befehlseinfügungen in Zeichenfolgendatenpillen zu entfernen, die für Bash-Shell-Skripting verwendet werden sollen. * **[SQL-Transformationsfunktionen bereinigen](https://servicenow-prod.fluidtopics.net/f4tMFTAWzDmCsFvKeJjp2g)** Verwenden Sie SQL-Transformationsfunktionen bereinigen, um Sonderzeichen mit Escape-Zeichen zu versehen und die Einschleusung in Zeichenfolgendatenpillen zu verhindern, die für SQL-Anweisungen verwendet werden sollen. * **[Komplexe Datentransformationsfunktionen](https://servicenow-prod.fluidtopics.net/DwDB6yYSkXXqypghwWJerw)** Verwenden Sie komplexe Datentransformationsfunktionen, um komplexe Objektdatenpillen in ein XML-Format zu serialisieren.