Format Text コンポーネントの使用

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:3分
  • RPA デスクトップデザインスタジオ の Format Text コンポーネントで変数プレースホルダー、行変数とタブ変数を使用して、テキストをフォーマットします。変数プレースホルダー、行変数とタブ変数を更新するだけで、テキストとその位置を簡単に更新できます。

    始める前に

    必要なロール:なし

    このタスクについて

    次の例外を回避するために、Format Text コンポーネントを使用する際に覚えておくべき重要なヒントです。

    引数がありません

    この問題は、書式指定文字列に、指定された引数の数よりも多くのプレースホルダーが含まれている場合に発生します。

    例えば
    • フォーマット文字列:{0} {1}
    • 指定された引数:「こんにちは」
    この問題に対して表示されるエラーメッセージは、「実行中にエラーが発生しました。コンポーネント「Format Text」をアクティビティ「New Activity」で実行できませんでした。

    インデックス (0 ベース) は、0 以上で、引数リストのサイズより小さくする必要があります。

    解決策は、引数の数がフォーマット文字列のプレースホルダーの数と一致するようにすることです。

    「こんにちは」

    「世界」

    正しい引数の配置

    インデックス (0 ベース) は、0 以上で、引数リストのサイズより小さくする必要があります。

    ソリューション:

    解決策は、引数の数が書式指定文字列のプレースホルダーの数と一致するようにすることです。たとえば、次のようになります。

    • フォーマット文字列: 「Hello」
    • 論拠: 「世界」

    この場合、フォーマット文字列にはプレースホルダーが含まれていないため、引数は必要ありません。"Hello, {0}! Welcome to {1}.」、「 World」「ServiceNow」など、2 つの引数を指定する必要があります。

    フォーマット文字列でのリテラル中括弧の使用

    問題: 中括弧 {} は文字列の書式設定において特別な意味を持ち、リテラル文字として使用する場合はエスケープする必要があります。

    誤った使用例:

    文字列の書式設定:
    
    {
    {0}
    {1}
    },

    エラーメッセージ: 実行中にエラーが発生しました。コンポーネント「Format Text」がアクティビティ「New Activity」で実行できませんでした。

    入力文字列の形式が正しくありませんでした
    解決策は、二重中括弧を使用してリテラル中括弧を表すことです。
    
    {{
    {0}
    {1}
    }},
    覚えておくべきルール:
    • {{ はリテラル { を表します。
    • }} はリテラル } を表します

    Format Text コンポーネントのプロパティが設定可能です。これらのプロパティの詳細については、「General コンポーネントのプロパティ」を参照してください。

    手順

    1. [ツールボックス] ペインで、 全般 > テキストの書式設定.
    2. Format Text コンポーネントを [デザイン面 (Design surface)] にドラッグします。
    3. テキストプレースホルダー変数を設定するには、次の手順を実行します。
      1. 変数を追加アイコン (変数を追加アイコン) をクリックします。
        追加される変数ごとに、データ入力ポートが追加されます。
      2. 変数値を設定するには、「ポートのプロパティを設定する」を参照してください。
      3. オプション: さらに変数および値を追加するには、手順を繰り返します。
    4. コンポーネント設定アイコン (コンポーネント設定アイコン) をクリックします。
    5. テキストフォーマットエディターでテキストを挿入します。
    6. テキストを挿入します。
    7. オプション: テキスト内の適切な位置に、行区切りの \n またはタブ区切りの \t の各変数を挿入します。
    8. テキスト変数プレースホルダーを、テキスト本文中の適切な位置に挿入します。
      ヒント:
      テキストを更新するには、プレースホルダー値を更新します。
    9. 下表に従って、Format Text コンポーネントのデータポートとコントロールポートを、他のコンポーネントの対応するポートに接続します。
      ポートタイプ 接続の目的 必須?
      データ入力 (Variable) 前に実行されたコンポーネントから変数値を取得します。 はい
      データ出力 (Formatted Output) 書式設定済みテキストを返し、次のコンポーネントに渡します。 はい。

      出力を表示するには、[戻る] フィールドを右クリックし、[データをプレビュー] をクリックします。

      コントロール入力 前に実行されたコンポーネントからコントロールを渡します。 はい
      コントロール出力 次のコンポーネントにコントロールを渡します。 いいえ。ポートの接続はオプションです。
    10. オプション: コンポーネントをテストするには、[デザイン] タブで [実行] をクリックします。