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

リリースバージョン: Australia

更新日 2026年03月12日

所要時間：3分

RPA デスクトップデザインスタジオの Format Text コンポーネントで変数プレースホルダー、行変数とタブ変数を使用して、テキストをフォーマットします。変数プレースホルダー、行変数とタブ変数を更新するだけで、テキストとその位置を簡単に更新できます。

始める前に

必要なロール：なし

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

引数がありません

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

例えば

この問題に対して表示されるエラーメッセージは、「実行中にエラーが発生しました。コンポーネント「Format Text」をアクティビティ「New Activity」で実行できませんでした。

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

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

「こんにちは」

「世界」

正しい引数の配置

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

ソリューション：

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

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

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

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

誤った使用例:

文字列の書式設定:


{
{0}
{1}
},

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

入力文字列の形式が正しくありませんでした

解決策は、二重中括弧を使用してリテラル中括弧を表すことです。


{{
{0}
{1}
}},

覚えておくべきルール:

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

[ツールボックス] ペインで、全般 > テキストの書式設定.
Format Text コンポーネントを [デザイン面 (Design surface)] にドラッグします。
テキストプレースホルダー変数を設定するには、次の手順を実行します。
1. 変数を追加アイコン () をクリックします。
  追加される変数ごとに、データ入力ポートが追加されます。
2. 変数値を設定するには、「ポートのプロパティを設定する」を参照してください。
3. オプション: さらに変数および値を追加するには、手順を繰り返します。
コンポーネント設定アイコン () をクリックします。
テキストフォーマットエディターでテキストを挿入します。
テキストを挿入します。
オプション: テキスト内の適切な位置に、行区切りの \n またはタブ区切りの \t の各変数を挿入します。
テキスト変数プレースホルダーを、テキスト本文中の適切な位置に挿入します。

ヒント:
テキストを更新するには、プレースホルダー値を更新します。

下表に従って、Format Text コンポーネントのデータポートとコントロールポートを、他のコンポーネントの対応するポートに接続します。


ポートタイプ	接続の目的	必須？
データ入力 (Variable)	前に実行されたコンポーネントから変数値を取得します。	はい
データ出力 (Formatted Output)	書式設定済みテキストを返し、次のコンポーネントに渡します。	はい。出力を表示するには、[戻る] フィールドを右クリックし、[データをプレビュー] をクリックします。
コントロール入力	前に実行されたコンポーネントからコントロールを渡します。	はい
コントロール出力	次のコンポーネントにコントロールを渡します。	いいえ。ポートの接続はオプションです。