文字列変換関数

  • リリースバージョン: Xanadu
  • 更新日 2024年08月14日
  • 所要時間:5分
  • 文字列変換関数を使用して、文字列データピルを再フォーマットしたり、計算したりします。

    文字列変換関数には、文字列入力データピルが必要です。文字列変換関数を適用するときは、正しい入力データピルタイプを使用してください。文字列変換関数が不適切なデータタイプに適用されると、データは実行時に変換されず、代わりに入力値が返されます。フローランタイム値を確認する方法の詳細については、「フローをテストする」を参照してください。

    文字列を数値に変換

    文字列を数値に変換します。

    入力データピル 出力データピル
    文字列 数値:文字列から変換された数値。
    図 : 1.
    • 入力:「500」
    • 出力:500

    包含

    入力文字列に指定された文字シーケンスが含まれている場合は true を返します。

    入力データピル パラメーター 出力データピル
    文字列 検索する文字。 文字シーケンスが入力文字列に存在するかどうかを示すブール値
    図 : 2.
    • 入力:Cheese Pizza
    • パラメーター:Cheese
    • 出力:true

    含まれていない場合

    入力文字列に指定された文字シーケンスが含まれていない場合は true を返します。

    入力データピル パラメーター 出力データピル
    文字列 検索する文字。 文字シーケンスが入力文字列に存在しないかどうかを示すブール値
    図 : 3.
    • 入力:Cheese Pizza
    • パラメーター:Joey
    • 出力:true

    次の値で終わる

    入力文字列が指定された文字シーケンスで終了する場合は true を返します。

    入力データピル パラメーター 出力データピル
    文字列 検索する文字。 入力文字列が指定した文字シーケンスで終了するかどうかを示すブール値
    図 : 4.
    • 入力:Cheese Pizza
    • パラメーター:Pizza
    • 出力:true

    最初の文字 (First Character)

    入力文字列の最初の文字を返します。

    入力データピル 出力データピル
    文字列 文字列:入力文字列の最初の文字として変換された文字列
    図 : 5.
    • 入力:Madrid
    • 出力:M

    この例では、ユーザー [sys_user] レコードが作成されるとフローがトリガーされます。その後、フローは、ユーザー [sys_user] レコードの [市区町村 (City)] フィールドを、市区町村名の最初の文字として表されるコードで更新します。

    ユーザーの市区町村コードの更新。

    最後の文字 (Last Character)

    入力文字列の最後の文字を返します。

    入力データピル 出力データピル
    文字列 文字列:入力文字列の最後の文字として変換された文字列
    図 : 6.
    • 入力:Madrid
    • 出力:d

    置換文字列 (Replace String)

    指定された正規表現 (regex) と置換文字列に基づいて、入力文字列から置換された文字列を返します。JavaScript 正規表現形式を使用します。

    入力データピル パラメーター 出力データピル
    文字列
    • Regex:置換のために照合する正規表現
    • Replace String:置換文字列
    指定されたパラメーターで置換した後に生成された文字列
    図 : 7.
    • 入力: 「Example input string.」
    • パラメーター:
      • 正規表現: \"
      • 置換文字列: \\\"
    • 出力: \"Example input string.\"

    サイズ

    入力文字列内の合計文字数を返します。

    入力データピル 出力データピル
    文字列 整数
    図 : 8.
    • 入力:Example input string.
    • 出力:21

    スプリット

    入力文字列を分割するために指定したセパレーターに基づいて Array.String を返します。[セパレーター (Separator )] フィールドを空白のままにすると変換は無視され、入力文字列が返されます。[セパレーター (Separator )] として文字列以外のデータタイプを入力すると、指定された値が文字列に変換されます。

    入力データピル パラメーター 出力データピル
    文字列 Separator:入力文字列を分割する場所を指定する区切り文字を入力します。空白のままにすると入力文字列は実行時に変換されません。 Array.String:入力文字列からのサブ文字列のアレイ
    図 : 9.
    • 入力:Example, input, string.
    • セパレーター:,
    • 出力:["Example", "input", "string."]

    次の値で始まる

    入力文字列が指定された文字シーケンスで開始する場合は true を返します。

    入力データピル パラメーター 出力データピル
    文字列 検索する文字。 入力文字列が指定した文字シーケンスで開始するかどうかを示すブール値
    図 : 10.
    • 入力:Cheese Pizza
    • パラメーター:Chees
    • 出力:true

    サブ文字列

    指定された [開始インデックス (Start Index)][終了インデックス (End Index)] に基づくサブ文字列を入力文字列から返します。入力文字列インデックスは 0 から始まります。

    入力データピル パラメーター 出力データピル
    文字列
    • Start Index:返されるサブ文字列に含める最初の文字のインデックス
    • End Index:返されるサブ文字列に含める最後の文字のインデックス
    文字列:入力文字列のサブ文字列として変換された文字列
    図 : 11.
    • 入力:Example input string
    • 開始インデックス (Start Index):3
    • 終了インデックス (End Index):6
    • 出力:mple

    小文字にする (To Lower Case)

    入力文字列をすべて小文字に変換します。

    入力データピル 出力データピル
    文字列 すべて小文字の文字列
    図 : 12.
    • 入力:ExamPle inpuT stRing
    • 出力:example input string

    適切なケース (To Proper Case)

    入力文字列の単語の大文字と小文字を変更します。各単語の最初の文字を大文字にし、単語の残りの文字を小文字にします。単語は、スペース、ハイフン、バックスラッシュ、または前方スラッシュ文字で区切られた任意の文字列と見なされます。変換関数は、単語を常に左から右に評価して最初の文字を決定します。

    入力データピル 出力データピル
    文字列 大文字と小文字が適切な文字列
    図 : 13.
    • 入力:exAMPle-input string/TEXT
    • 出力:Example-Input String/Text

    To Upper Case (大文字にする)

    入力文字列をすべて大文字に変換します。

    入力データピル 出力データピル
    文字列 すべて大文字の文字列
    図 : 14.
    • 入力:ExamPle inpuT stRing
    • 出力:EXAMPLE INPUT STRING

    トリミング (Trim)

    入力文字列の最初と最後から空白を削除します。入力文字列内の空白は削除しません。

    入力データピル 出力データピル
    文字列 文字列:空白がトリミングされた変換文字列
    図 : 15.
    • 入力: SQL Server APAC 1
    • 出力:SQL Server APAC 1

    この例では、アクションによってサードパーティシステムへの REST 呼び出しが行われ、サーバーに関するデータを含む応答本文が取得されます。次に、トリミング変換関数は、サーバーの名前をサーバー [cmdb_ci_server] テーブルの新しいレコードに追加する前に不要な空白を削除します。

    CMDB に追加する前にサーバー名から空白を削除。