---
sourceDocument: オーストラリアの対話型インターフェース
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/conversational-interfaces

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリアの対話型インターフェース

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# トピックブロックユーティリティ

# トピックブロックユーティリティ {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

仮想エージェント会話でトピックブロックを使用して、呼び出し元トピックで特定のステップを実行する特定の機能またはサブフローを実行します。

## トピックブロックユーティリティのプロパティ {#va-topic-blocks__section_xwb_mgn_pdb}

詳細については、「[呼び出し元トピックまたはトピックブロックへの再利用可能なトピックブロックの追加](https://servicenow-prod.fluidtopics.net/ckeViHyRyK0yUwZG_GcVdA "再利用可能なトピックブロックを呼び出し元 (親) トピックまたはトピックブロックに追加して、呼び出し元トピックで特定の機能またはタスクを実行します。トピックブロックで使用される入力パラメーターを指定し、呼び出し元トピックで使用される出力パラメーターを指定します。")」を参照してください。  
{#va-topic-blocks__table_nff_y1b_3db__entry__2}

| プロパティ | 説明 |
|-|-|
| ノード名 | トピックブロックノードの名前。名前は、選択したトピックブロックに基づいて自動的に割り当てられます。たとえば、ACME コンテキスト検索トピックブロックを選択した場合、\[ 名前 \] は「Acme コンテキスト検索」になります。 \[動的トピックブロックを使用 (Use dynamic Topic Block)\] をアクティブにして、任意の名前を入力します。 |
| 動的トピックブロックを使用 | 動的トピックブロックオプションを有効にするには、この切り替えを設定します。 |
| トピックブロック | 公開されたトピックブロックのリスト。呼び出し元トピックに追加するトピックブロックを選択します。 \[動的トピックブロックを使用 (Use dynamic Topic Block)\] をアクティブにした状態で、代わりに条件ビルダーを使用して条件またはスクリプトを入力します。 |
| 入力マッピング | 選択したトピックブロックへの入力として使用される変数。この例では、入力マッピング変数には、カタログアイテム ID、コンテキスト検索の実行、カタログアイテムの確認、終了ステータスカードの表示が含まれます。 このエリアの内容は、選択したトピックブロックに応じて変わります。オプションには、文字列入力、参照レコード、スクリプトなどが含まれます。 \[ 動的トピックブロックを使用 \] をアクティブにすると、\[入力を管理して定義\] アイコン \[ ![入力を管理して定義\] アイコンを選択する]()ことで、すべての入力マッピングを手動で追加できます。入力は、 [再利用可能なトピックブロック](https://servicenow-prod.fluidtopics.net/h5VKTFgjkoAT3h6uIK3mmA "仮想エージェント会話でタスクと会話要素の特定のサブフローを実行する再利用可能なコンポーネントを構築します。")の開始セグメントにある \[入力パラメーター\] ダイアログボックスと同様に処理されます。 |
| 出力マッピング | 選択したトピックブロックによって出力される変数。次の画像は、有効になっている変数の例を示しています。 このエリアの内容は、選択したトピックブロックに応じて変わります。 \[ 動的トピックブロックを使用\] をアクティブにすると、\[出力を管理して定義\] アイコン ![出力を管理して定義アイコンを選択する]()ことで、代わりにすべての入力マッピングを手動で追加できます。入力は、再利用可能なトピックブロックの開始セグメントにある \[入力パラメーター\] ダイアログボックスと同様に処理されます。 |
| 詳細 ||
| このノードを非表示 ||
| 次の場合、このノードを条件付きで使用します： | 会話でこのノードを表示するための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は true と評価される必要があります。 |
[ ]

{#va-topic-blocks__table_nff_y1b_3db}

## トピックブロックユーティリティの例 {#va-topic-blocks__section_jxd_nh5_tdb}

次のトピックブロックユーティリティのプロパティには、利用可能なトピックブロックへの参照、トピックブロックへの入力マッピング変数、およびトピックブロックが渡す出力変数が含まれます。

次のトピックブロックユーティリティのプロパティでは、\[ 動的トピックブロックを使用 \] 切り替えスイッチがオンになっています。

<br />

## 動的トピックブロックの使用 {#va-topic-blocks__section_p1r_ytb_jbc}

トピックブロックの動的設定を切り替えると、任意の数の条件に基づいて、呼び出すトピックブロックをプログラムで選択できます。トピックブロック定義に対する明示的な 1 対 1 の一致なしに、動的な入力セットを渡すことができます。

たとえば、2 つのトピックブロックがあるとします。ユーザー名を取得し、成功または失敗のメッセージを返すことでパスワードを設定します。もう 1 つはパスワードをリセットしますが、成功または失敗のメッセージと一時パスワードを返す前に、要求とともに 2 要素認証 (2FA) トークンを送信する必要があります。

パスワードリセット手順を処理する 2 つの個別のトピックブロック発動を作成するか、動的設定をアクティブにして次のように定義した 1 つのトピックブロックを作成することができます。  
* リセットタイプが `includesTwoFactor = true` かどうかを確認するスクリプトを追加します。ステートメントが true と評価された場合は `TwoFactorReset`、それ以外の場合は `NormalPasswordReset` を返します。
* `password` と `twoFactorToken` の 2 つの入力マッピングを定義します。どちらも、それぞれの値を含む渡されたオブジェクトと等しく設定されます。
* `successful` と `tempPass` の 2 つの出力マッピングを定義します。後者は、トピックブロックの戻り値に存在する場合にのみ設定されます。
* 成功または失敗を出力する 2 つの出力ノードと、 `tempPass` 値が true かどうかを確認する出力を定義します。
{#va-topic-blocks__ul_z5h_w5b_jbc}

## 動的なトピックブロック式の例 {#va-topic-blocks__section_b5f_zs1_jbc}

    (function execute() {
        /* Return the name of the topic block to run. For example:
            switch (vaVars.car_make) {
                case 'Ford':
                    return 'Ford troubleshooting';
                case 'Toyota':
                    return 'Toyota troubleshooting';
                default:
                    return 'General car troubleshooting';
            }
        */
    })()

動的トピックブロック式のスクリプトは、入力に基づいて値を返します。この例では、「 <kbd class="ph userinput">Ford</kbd> 」または <kbd class="ph userinput">「Toyota</kbd>」と入力すると、仮想エージェントは適切なトラブルシューティングトピックを呼び出します。他の値を入力すると、仮想エージェントは代わりに一般的なトラブルシューティングトピックを返します。