--- sourceDocument: Yokohama ビルドのワークフロー sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/build-workflows Release : - yokohama ft:locale : - ja-JP ft:publication_title : - Yokohama ビルドのワークフロー ft:clusterId : - crworkflow bundleId : - crworkflow workflow : - Creator --- # 変換関数 # 変換関数 {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年01月30日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：3分 スクリプトを記述する必要なく、データピル値を変換します。変換関数を使用して、テキストの再フォーマット、数値計算の実行、潜在的に危険な SQL ステートメントのサニタイズ、複合的なオブジェクトの生 XML へのシリアル化を行います。 使用可能な変換関数のカテゴリには、[日付と時刻](https://servicenow-prod.fluidtopics.net/PY7AfChoieELHNv3q7o9vQ "日付と時刻の変換関数を使用して、日付/時刻値のデータピルを再計算または再フォーマットします。")、[文字列](https://servicenow-prod.fluidtopics.net/A7mVT4fpPb7mnbYSezXEZg "文字列変換関数を使用して、文字列データピルを再フォーマットしたり、計算したりします。")、[ユーティリティ](https://servicenow-prod.fluidtopics.net/_G1YJHp1DujF0TtBaQ9RYQ "ユーティリティ変換関数を使用して、アレイから複合オブジェクトを返すか、特定のキーに関連付けられた値を返します。")、[単純な数式](https://servicenow-prod.fluidtopics.net/FW5gZeOoTrOxmvNYCbZMiw "単純な数式変換関数を使用して、数値データピルに対して基本的な数学計算を実行します。")、[シェル引数のサニタイズ](https://servicenow-prod.fluidtopics.net/ufTVi25uvI9j8wPamClpkA "シェル引数のサニタイズ変換関数を使用して、Bash シェルスクリプティングに使用する文字列データピル内の潜在的に危険なコマンド挿入をすべて削除します。")、[SQL のサニタイズ](https://servicenow-prod.fluidtopics.net/dN8iQa5ozsgH1Ff4sDZw1g "SQL のサニタイズ変換関数を使用して特殊文字をエスケープし、SQL ステートメントに使用される文字列データピルへの挿入を阻止します。")、[複合データ](https://servicenow-prod.fluidtopics.net/dbIzZ4MLathKpr304R2_KQ "複合データ変換関数を使用して、複合オブジェクトデータピルを XML 形式にシリアル化します。")が含まれます。変換関数の使用例を次に示します。 * CMDB にデータ連携する前に文字列から空白をトリミングします。 * 特定のタイムゾーンにローカライズする日付または時刻に日、時、分、および秒を追加します。 * 統合ハブ スポークの [JDBC ステップ](https://servicenow-prod.fluidtopics.net/WBL9z~~uyA6Wo64j08VfCQ "SQL コマンドをリレーショナルデータベースに送信するための再利用可能なアクションを作成します。")の一部として挿入されないように SQL 値をサニタイズします。 * サードパーティデータベース内で同じ値の優先度マップから適切な値を取得します。 * [REST ステップ](https://servicenow-prod.fluidtopics.net/un~5NcIHMtrqnwY~m7IPyA "送信 REST Web サービス要求を外部システムに送信します。")の \[要求本文\] フィールドの一部として複合オブジェクトを 生 XML に変換します。 {#transform-functions__ul_n23_4cl_t3b} 注: 現在、カスタム変換関数はサポートされていません。ワークフロースタジオ データを変換するカスタム関数の作成方法については、「[インラインスクリプト](https://servicenow-prod.fluidtopics.net/Fu662VTizPYDRhZUxXXjfQ "コーディング経験のあるユーザーが、アクションまたはフローの構成中に入力値を設定および変更するインラインスクリプトを記述できるようにします。インラインスクリプトを使用して、小さな形式変換、データ変換、または演算操作を必要とする入力値を変更します。")」を参照してください。 ## 変換関数の適用 {#transform-functions__section_rjd_mhl_t3b} フローを設計または作成するときに、データピルに変換関数を適用できます。変換関数を適用するには、データピルをポイントするかタブで移動して、表示される f(x) (![関数アイコン]()) アイコンを選択します。アイコンを選択すると、\[利用可能な変換 (Available Transforms)\] リストが表示されます。データピルに適用する変換関数を選択し、必須フィールドに情報を入力して、\[適用\] を選択します。選択した変換関数が \[適用された変換 (Applied Transforms)\] リストに表示されます。 ## 複数の変換関数の適用 {#transform-functions__section_f5v_dqn_kjb} 同じデータピルに複数の変換関数を適用できます。\[適用された変換 (Applied Transforms)\] リストに一覧表示されているとおりに、変換関数は上から下へ順番に適用されます。たとえば、\[文字列から日付 (String to Date)\] 変換関数を適用してから、\[時間を追加 (Add Time)\] 変換関数を適用することができます。 ## 適用された変換関数の表示 {#transform-functions__section_afb_fng_r3b} \[適用された変換 (Applied Transforms)\] リストを確認して、データピルに適用されている変換関数を特定できます。フローまたはアクションを設計または作成する場合は、データピルをポイントするかタブで移動して、f(x) (![選択されている関数アイコン]()) アイコンを選択します。[フロー実行の詳細](https://servicenow-prod.fluidtopics.net/Xq0j7CEMORUPcCjsiTyOAA "現在のステータス、実行されたアイテム、生成された値など、設計環境からアクションまたはフローに関するランタイム情報を直接表示します。埋め込まれた Now Platform エディターまたは新しいタブから関連レコードを開きます。")で適用された変換関数を表示することもできます。 注: 適用された変換機能の出力値はフィールド値であり、[表示値](https://www.servicenow.com/docs/access?context=c_DisplayValues&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US)ではありません。 データピルが特定のタイプの入力にドロップされると、入力に関連する変換関数カテゴリが自動的に提案されます。たとえば、SQL ステートメント内の特殊文字をエスケープし、シェルスクリプトにスクリプトが挿入されないようにし、API または操作要求を検証するための変換関数が提案されます。現在、システムでは次の入力に対して変換関数カテゴリが提案されます。 * JDBC ステップの SQL ステートメント入力にドロップされたデータピルには、「[SQL のサニタイズ変換関数カテゴリ](https://servicenow-prod.fluidtopics.net/dN8iQa5ozsgH1Ff4sDZw1g "SQL のサニタイズ変換関数を使用して特殊文字をエスケープし、SQL ステートメントに使用される文字列データピルへの挿入を阻止します。")」が自動で表示されます。 * SSH ステップのコマンド入力にドロップされたデータピルには、「[シェル引数のサニタイズ変換関数カテゴリ](https://servicenow-prod.fluidtopics.net/ufTVi25uvI9j8wPamClpkA "シェル引数のサニタイズ変換関数を使用して、Bash シェルスクリプティングに使用する文字列データピル内の潜在的に危険なコマンド挿入をすべて削除します。")」が自動で表示されます。 {#transform-functions__ul_wd4_13d_ljb} ## 一般的なガイドライン {#transform-functions__id_m33_yvb_ptb} 有効なタイプの入力のデータピルに変換関数を適用する : 変換関数を適用する前に、入力のデータピルのタイプを確認してください。無効なデータピルタイプに変換関数を適用すると、システムは変換をスキップします。変換関数によってシステムで解析できない結果が生成された場合にも、エラーが発生します。たとえば、文字列を日付に変換する際に、変換によって有効な日付が生成されない場合、システムはエラーをスローします。 同じデータピルを使用して、複数の入力に適用された変換関数を確認する : 変換関数は、実行時に特定の入力用に新しい値を作成し、元のデータピルは変更されません。したがって、複数のアクションまたはステップで同じデータピルを使用する場合は、変換関数を個々の入力に適用する必要があります。 フロー実行の詳細で最終的に変換された値を確認する{#transform-functions__final-transformed-value} : [フロー実行の詳細](https://servicenow-prod.fluidtopics.net/Xq0j7CEMORUPcCjsiTyOAA "現在のステータス、実行されたアイテム、生成された値など、設計環境からアクションまたはフローに関するランタイム情報を直接表示します。埋め込まれた Now Platform エディターまたは新しいタブから関連レコードを開きます。")には最終的に変換された値のみが表示され、適用された各変換の値は表示されません。 変換関数をテストして予期した結果が得られることを確認する : 変換関数がデータピルの予期したランタイム値を生成することを確認します。詳細については、「[フローのテスト](https://servicenow-prod.fluidtopics.net/kcmcfukcYpQcvcGo96YM0Q "フローを有効化して他のユーザーがアクセスできるようにする前に、テストを実行して、想定どおりに機能することを確認します。")」および「[アクションのテスト](https://servicenow-prod.fluidtopics.net/ml3DNlm7PNi~Eo68_M4AhA "他のユーザーに公開する前に、アクションをテストします。")」を参照してください。 * **[日付と時刻の変換関数](https://servicenow-prod.fluidtopics.net/PY7AfChoieELHNv3q7o9vQ)** 日付と時刻の変換関数を使用して、日付/時刻値のデータピルを再計算または再フォーマットします。 * **[文字列変換関数](https://servicenow-prod.fluidtopics.net/A7mVT4fpPb7mnbYSezXEZg)** 文字列変換関数を使用して、文字列データピルを再フォーマットしたり、計算したりします。 * **[ユーティリティ変換関数](https://servicenow-prod.fluidtopics.net/_G1YJHp1DujF0TtBaQ9RYQ)** ユーティリティ変換関数を使用して、アレイから複合オブジェクトを返すか、特定のキーに関連付けられた値を返します。 * **[単純な数式変換関数](https://servicenow-prod.fluidtopics.net/FW5gZeOoTrOxmvNYCbZMiw)** 単純な数式変換関数を使用して、数値データピルに対して基本的な数学計算を実行します。 * **[シェル引数のサニタイズ変換関数](https://servicenow-prod.fluidtopics.net/ufTVi25uvI9j8wPamClpkA)** シェル引数のサニタイズ変換関数を使用して、Bash シェルスクリプティングに使用する文字列データピル内の潜在的に危険なコマンド挿入をすべて削除します。 * **[SQL のサニタイズ変換関数](https://servicenow-prod.fluidtopics.net/dN8iQa5ozsgH1Ff4sDZw1g)** SQL のサニタイズ変換関数を使用して特殊文字をエスケープし、SQL ステートメントに使用される文字列データピルへの挿入を阻止します。 * **[複合データ変換関数](https://servicenow-prod.fluidtopics.net/dbIzZ4MLathKpr304R2_KQ)** 複合データ変換関数を使用して、複合オブジェクトデータピルを XML 形式にシリアル化します。