---
sourceDocument: Yokohama データと自動化
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/integrate-applications

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama データと自動化

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

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

# Format Text コンポーネントの使用 {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年01月30日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：3分

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

## 始める前に

必要なロール：なし

## このタスクについて

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

引数がありません

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

    次に例を示します。

    * フォーマット文字列:{0} {1}
    * 指定された引数:「こんにちは」
    {#use-general-format-text__ul_ddm_sjd_wfc}この問題に対して表示されるエラーメッセージは、「実行中にエラーが発生しました。アクティビティ \[新しいアクティビティ\] でコンポーネント \[テキストの書式設定\] を実行できませんでした。

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

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

    「こんにちは」

    「世界」

正しい引数の配置

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

    **ソリューション：**

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

    * 文字列の形式:「 `こんにちは」`
    * 引数: `"World"`

    {#use-general-format-text__ul_ebg_jmg_xfc}

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

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

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

    誤った使用例:
    文字列の書式設定:


        {
        {0}
        {1}
        },

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

入力文字列の形式が正しくありませんでした
:   解決策は、二重括弧を使用してリテラル中括弧を表すことです。


        {{
        {0}
        {1}
        }},

    覚えておくべきルール:

    * `{{` はリテラル `{` を表します
    * `}}` はリテラル `}` を表します
    {#use-general-format-text__ul_djb_bsg_xfc}

Format Text コンポーネントのプロパティが設定可能です。これらのプロパティの詳細については、「[General コンポーネントのプロパティ](https://servicenow-prod.fluidtopics.net/Tgl6oxo9BXQx2rn3PsWAXg "RPA デスクトップデザインスタジオ の General コンポーネントのプロパティについて説明します。")」を参照してください。

## 手順

1. \[ツールボックス\] ペインで、次に移動します 全般テキストの書式設定.
2. Format Text コンポーネントを \[デザイン面 (Design surface)\] にドラッグします。
3. テキストプレースホルダー変数を設定するには、次の手順を実行します。
   1. 変数を追加アイコン (![変数を追加アイコン]()) をクリックします。  
      追加される変数ごとに、データ入力ポートが追加されます。
   2. 変数値を設定するには、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。
   3. **オプション:** さらに変数および値を追加するには、手順を繰り返します。
   {#use-general-format-text__substeps_ayf_jyd_tsb}
4. コンポーネント設定アイコン (![コンポーネント設定アイコン]()) をクリックします。
5. テキストフォーマットエディターでテキストを挿入します。
6. テキストを挿入します。
7. **オプション:** テキスト内の適切な位置に、行区切りの \\n またはタブ区切りの \\t の各変数を挿入します。
8. テキスト変数プレースホルダーを、テキスト本文中の適切な位置に挿入します。  
   ヒント:  
   テキストを更新するには、プレースホルダー値を更新します。
9. 下表に従って、Format Text コンポーネントのデータポートとコントロールポートを、他のコンポーネントの対応するポートに接続します。  
   {#use-general-format-text__table_jnw_jn1_krb__entry__3}

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

   {#use-general-format-text__table_jnw_jn1_krb}
10. **オプション:** コンポーネントをテストするには、\[デザイン\] タブで \[実行\] をクリックします。