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

リリースバージョン: Yokohama

更新日 2025年01月30日

所要時間：3分

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

始める前に

必要なロール：なし

フォーマットテキストコンポーネントを使用する際に、次の例外を回避するために覚えておくべき重要なヒント。

引数がありません

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

次に例を示します。

この問題に対して表示されるエラーメッセージは、「実行中にエラーが発生しました。アクティビティ [新しいアクティビティ] でコンポーネント [テキストの書式設定] を実行できませんでした。

インデックス (0 から始まる) は、0 以上引数リストのサイズより小さくなければなりません。

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

「こんにちは」

「世界」

正しい引数の配置

インデックス (0 から始まる) は、0 以上引数リストのサイズより小さくなければなりません。

ソリューション：

解決策は、引数の数が文字列形式のプレースホルダーの数と一致していることを確認することです。たとえば、次のようになります：

この場合、書式文字列にはプレースホルダーが含まれていないため、引数は必要ありません。「こんにちは、{0}! {1} へようこそ。では、「 World」 と 「ServiceNow」などの 2 つの引数を指定する必要があります。

文字列形式でのリテラル中括弧の使用

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

誤った使用例:

文字列の書式設定:


{
{0}
{1}
},

エラーメッセージ:実行中にエラーが発生しました。アクティビティ [新しいアクティビティ] でコンポーネント [テキストの書式設定] の実行に失敗しました。

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

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


{{
{0}
{1}
}},

覚えておくべきルール:

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

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

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

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


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