コンテンツへスキップ
For the complete documentation index, see llms.txt. This page is also available as Markdown.

ガイドの高度なユースケース

このページでは、Guides 内の Edge ケースに対応するための追加のヒントとガイダンスを提供します。ここでは、高度な概念、構成オプション、および組織のニーズに応じて役立つかもしれないその他の情報を取り扱います。

Nexthinkブラウザ拡張機能での複数テナントの設定

Nexthinkブラウザ拡張機能を複数のNexthinkテナントと統合できます。これにより、Guides Editor を使用して、異なる Nexthink 環境に関連付けられたガイドコンテンツを作成できます。

この機能は、例えば同じ Web アプリケーション向けのガイドを作成し、それらを異なる Nexthink 環境にリンクさせ、干渉や重複を避けたい場合に役立ちます。

このページでは、Nexthink ブラウザー拡張機能から複数のテナントを構成し切り替える手順と、テナント固有のガイドコンテンツを Guides Editor で開く方法について説明します。

Nexthinkブラウザ拡張機能用に新しいテナントを設定するには:

  1. ブラウザの Google Chrome または Microsoft Edge を開き、ブラウザツールバーの拡張機能アイコンを選択し、Nexthink を探します。

  2. ピンアイコンをクリックして、ブラウザツールバーに拡張機能を追加します。

  3. ピンされている拡張機能(Nexthinkアイコン)を右クリックし、Tenants Configurationを選択します。これにより、拡張機能の設定ページが開き、デフォルトのテナントが表示されます。

  4. Add tenantをクリックし、NameとURLフィールドにAdd tenantポップアップから記入します。

    • NexthinkインスタンスのURLを追加します。例:https://nexthink.tet.nexthink.saas

    • URLの末尾にはスラッシュ(/)—通称トレイリングスラッシュ—を含めることはできません。

  5. 新しいテナントのアクションメニューを開き、Authenticateを選択します。これにより、新しいウィンドウで認証ページが開きます。認証が完了すると、このテナントを選択し、関連するガイドを Guides Editor で開くことができます。

インスタンス固有のガイドを Guides Editor で開くためのテナント切り替え

Nexthinkテナントへの認証

Guides Editor で特定の Nexthink Infinity 環境に関連付けられたガイドにアクセスするには、まずその Nexthink 環境に認証する必要があります。

  • Nexthinkブラウザ拡張機能のTenants Configurationページにアクセスし、アクションメニューからAuthenticateを選択します。

  • または、デフォルトのNexthinkテナントに認証するには、ブラウザツールバーのNexthinkアイコンを右クリックし、Sign in as adminを選択します。

Guides Editor でのテナント切り替え

  1. 認証が完了したら、ブラウザツールバーから Nexthink アイコンをクリックします。

  2. ドロップダウンメニューから目的のテナントを選び、ターゲットのウェブアプリケーションを選択します。

  3. 目的のガイドをクリックして、Web アプリケーションの URL で Guides Editor を直接開きます。

Selecting tenants from Guides Editor

デフォルトテナントの選択

マルチテナントアーキテクチャにおいて、特定の環境に関連付けられたガイドをウェブアプリケーションでの表示として確認するには(例: テスト目的など)、そのテナントをデフォルトに設定する必要があります。

これをするには:

  1. Nexthinkブラウザ拡張機能のテナント設定ページに移動します。

  2. 希望するテナントのアクションメニューを開きます。

  3. デフォルトに設定を選択します。

通常のケースでは、組織は単一のNexthinkインスタンスの下で運営されています。ただし、組織が開発環境を使用している場合、複数のテナントが必要になることがあります。その目的は、別々の環境で採用ガイドをテストするためです。

Guides の NQL 機能

特定の採用ガイドイベントは、データ収集、ガイドの関与測定、または分析の目的で調査を通じてクエリを実行できます。

Guides 固有の NQL テーブル

Guides 固有のテーブルの詳細については、NQL データモデルを参照してください。

Guides では主に次の NQL テーブルが使用されます。

  • application.guide: このテーブルはガイドオブジェクトを表します。エンドユーザーに提供されるさまざまなタイプのガイダンス(例:ウォークスルー、ツールチップ、メディア文書)を含みます。

  • application.guide_step: このテーブルは、ウォークスルータイプのガイドの個別ステップオブジェクトを表します。

  • web.context_help_executions: このテーブルは、Webアプリケーションのコンテキストヘルプ要素との従業員のやりとりを追跡します(例:質問マークアイコンをクリックする、ガイドを検索する)。

  • web.guide_executions: このテーブルはガイドの実行イベントを記録します。このイベントは、ターゲットのWebアプリケーションを使用している各従業員のために複数回発生することがあります。

  • web.guide_step_executions: このテーブルは、ガイド内の個々のステップとの従業員のやりとりを捕捉します。

これらのテーブルは、ガイドやガイド内のステップ、コンテキストヘルプの実行に関するユーザーのやりとりを追跡します。これらのデータを活用することで、従業員の行動や Nexthink Guides 内でのガイドエンゲージメントを理解できます。

これらのメトリクスは次の利点を提供します:

  • ガイドの関与をクエリする: ガイドのターゲティング、関与度、実行時間、その他のユーザーのやりとりのメトリクスを追跡するために新しいフィールドを使用します。

  • ガイド関連のデータの詳細度を高める: データの詳細度を調整することで、エンドユーザーが特定のステップまたは要素と関わる正確なタイミングに関する詳細な洞察を得ることができます。

application NQL 名前空間の Guides 関連構成オブジェクト

guideテーブルのフィールド

以下の例ではapplication NQLネームスペースのguide テーブルからnql_id フィールドオブジェクトを使用しています。

フィールド名
説明

nql_id

ガイドの一意の識別子。

name

ガイドの一意の識別子。

type

ガイドのタイプ(例:ウォークスルー、ツールチップ、メディア)。

status

ガイドのステータス(例:公開済み、下書き)。

guide_stepテーブルのフィールド

以下の例では、application NQLネームスペースのguide_step テーブルからrank フィールドオブジェクトを使用しています。

ガイドステップ テーブルのフィールド
説明

nql_id

ガイドステップの一意の識別子。

name

ガイドステップの名前。

type

ステップのタイプ(例:ウォークスルーステップ、アクション、決定)。

rank

ガイド内のステップの位置や順番。

guide_nql_id

このステップを含むガイド識別子への関係。

web NQL 名前空間の Guides 関連イベント

context_help_executionsテーブルのフィールド

以下の例では、web NQLネームスペースのcontext_help_executions テーブルからbrowser_language フィールドイベントを使用しています。

context_help_executionsテーブルのフィールド
説明

execution_id

コンテキストヘルプ実行の一意の識別子。

status

コンテキストヘルプ実行のステータス: 開く、閉じる。

url

やりとりが発生したURL。

duration

コンテキストヘルプが開いたままでいた時間の長さ。

browser_language

コンテキストヘルプ実行でユーザーのブラウザの言語。

number_of_executions

NQLで集計メトリクスを計算するのに使用(各イベントで常に1)。

guide_executions テーブルのフィールド

以下の例では、web NQLネームスペースのguide_executions テーブルからstatus フィールドイベントを使用しています。

guide_executions テーブルのフィールド
説明

execution_id

ガイド実行の一意の識別子。

status

ガイド実行のステータス。

  • ターゲット: ガイドがユーザーにターゲットされました(ユーザーへガイドが提供されました)。

  • 開始: ガイド実行が開始され、ユーザーがやりとりしました。

  • 完了: ガイド実行がユーザーによって完了しました。

  • 閉じる: ユーザーがガイドを完了、またはそのステップを完了せずに閉じました。

number_of_executions

NQLで集計メトリクスを計算するのに使用。各イベントの値は常に1です。

duration

ガイドが最終ユーザーに表示された時間。

browser_language

ガイド実行でユーザーのブラウザの言語。

targeting_count

特定のユーザー/キーページ/日ごとのガイドターゲットの回数。

url

ガイドがトリガーされたURL。

time

ガイド実行が発生したタイムスタンプ。

guide_step_executions テーブルのフィールド

以下の例では、web NQLネームスペースのguide_step_executions テーブルからnumber_of_executions フィールドイベントを使用しています。

guide_step_executions テーブルのフィールド
説明

execution_id

ガイドステップ実行の一意識別子。

status

ガイドステップのステータス。

  • 完了: ステップが完了されました(ユーザーがそのステップとやりとりを終了しました)。

  • 閉じる: ステップが閉じられた、通常はユーザーがそれを完了前に閉じるまたは放棄する場合。

url

ガイドステップが実行されたURL。

duration

ガイドステップがエンドユーザーに表示されていた時間。

number_of_executions

NQLでの集計メトリクス(例:カウント)計算に使用。各イベントの値は常に1です。

engaged

ユーザーがガイドステップと関わったかどうかを識別(true/false)。

browser_language

ガイドステップ実行時のユーザーのブラウザの言語。

time

ガイドステップ実行が発生したタイムスタンプ。

Guides Editor のユースケース

以下のユースケースは Guides Editor に適用されます。それらを適用してガイドを持続可能に構成および管理します。

非表示ステップ

非表示ステップは、ユーザーにオーバーレイを表示せずにアクションを実行したり、ユーザー操作を待ったりするために使用されます。これらのステップは、ガイド内の背景ロジックを処理します。例えば特定のページに移動したり、ページの読み込みを待ったり、要素までスクロールしたり、要素の周りに枠を表示したり、ユーザー操作が発生するまで一時停止したりします。

非表示ステップを追加するには:

  1. 新しいステップを追加し、適切にラベルを付けてコンテンツを追加しないようにします。

  2. ステップの設定を開きます。外観で、ステップオーバーレイを非表示に設定します。これにより、ユーザーは空のオーバーレイを表示しません。シャドウをオフに設定して、短い視覚的なちらつきを防ぎます。

  3. ステップを必要に応じて設定します。以下のユースケースは非表示ステップを利用しており、その有用性に洞察を提供します。

  1. 設定を保存します。

特定の要素を強調するためにリップル効果を使用する

ユーザーが特定の要素を見つけるのに頼らず、ページ上で直接ガイドを必要とするポイントを視覚的に強調するためにリップル効果を利用します。

  1. ページ上の特定の要素から開始するガイドを Guides Editor で作成または開きます。

  2. ターゲット要素の近くに配置されるか、結びついているステップを追加します。

  3. ステップの設定を開きます。トリガー内で、「ステップが開始される条件」に基づいてステップの開始トリガーを設定します(例: 要素をクリックまたはホバー)。

    • また、「ステップが完了する条件」をトリガーとして使用することもできます。

  4. 選択ドロップダウンの近くにある設定ボタンをクリックします。外観の下でリップル効果を選択します。

  1. 設定を保存します。

  2. ガイドをプレビューすると、ターゲット要素が点滅するリップル効果を表示するようになります。

ボタンのホバーでステップをトリガーする

特定の要素、ボタンなどの上にユーザーがホバーするときにステップをトリガーすることで、ステップ条件を検証します。このアプローチにより、必須フィールドまたは条件が満たされる前にユーザーが続行しないことを確認し、各アクションが適切なタイミングで実行されることを保証します。

  1. ガイドを Guides Editor で開きます。

  2. ホバーアクションを検出するために新しいステップを追加します。

    • これを非表示ステップにすることができます。その場合、ステップが完了したときのトリガーをすぐにステップを完了に設定する必要があります。

  3. セレクターツールを使用して、ターゲットとなる要素をキャプチャします。

  4. ステップの設定を開きます。トリガーで、マウスオーバーをステップが開始されるときに設定します。

  1. 外観で、ステップオーバーレイを非表示に設定します。シャドウをオフに設定します。

  1. ホバーイベントが検出されると、ステップは自動的に完了し、ガイドは次の見えるステップに進みます。

  2. 保存してテストし、ステップがユーザーが要素にホバーするまで正しく待機し、その後期待通りに進むことを確認します。

ユーザーの操作なしで経過時間後にステップを自動的に完了する

ステップの自動化を使用してガイドを簡素化し、不要なクリックを減らします。これをタイマーとアクションによって達成でき、ガイドが自立的に進み、エンドユーザーの手動操作を減らします。

  1. ガイドを Guides Editor で開きます。

  2. 対象要素とやりとりするステップを選択します。

  3. ステップ設定を開きます。トリガー内のステップが完了したときに、数秒後にステップが自動的に終了するようタイマーを設定します(例、3秒)。

    • 冗長性のために、ユーザーがガイドを手動で進めることができるように、アクションタイプをクリックに設定したままにしておきます。

  1. 設定を保存します。

  2. ガイドを公開してテストし、ステップが自動的に完了し、クリックが正しい順序で実行されることを確認します。

フィールド検証の単一値を許可する

ユーザーが入力フィールドに対して操作を行うとフィールド検証が起動され、必要なパターンと一致しない場合にはすぐにガイダンスが表示されます。

  1. ガイドを Guides Editor で開きます。

  2. フィールド入力のためのステップを作成します。

  3. ステップ設定を開きます。「トリガー」の下で「ステップが開始されるとき」を「マウスクリック」に設定し、「ステップが完了するのは」を「値を入力/選択し、次に進む」に設定します。

  4. 「値を入力/選択し、次に進む」を、必要に応じた正規表現パターンで設定します。設定した値と一致しない限り、そのステップは完了できません。無効なユーザー入力はエラーメッセージを引き起こします。

    • このユースケースでは、単語の組み合わせに対して追加の構文は必要ありませんが、複数の単語を組み合わせるためには (EXAMPLE1|EXAMPLE2) を使用し、サブストリングには .*EXAMPLE.* を使用します。

  5. 設定を保存し、ガイドをテストします。

不正な値入力時の警告メッセージのトリガー

ユーザーが不正な値を入力した場合のみ、検証メッセージをトリガーします。この方法を使用して、個別の検証ロジックを持つ複数のフィールドを監視します。

  1. ガイドを Guides Editor で開きます。

  2. 検証を目的とした隠しステップを作成します。

  3. ステップ設定を開きます。「表示」の下で「ステップオーバーレイ」を「非表示」に設定します。「トリガー」の下で、「値を入力/選択し、次に進むの完了」を設定します。

  4. ^(?!EXAMPLE$).* のような特定の逆論理パターンを設定します。フィールド入力がパターンに埋め込まれたフレーズ以外の任意のものと一致した場合にステップがトリガーされます。

  5. 設定を保存します。

  6. ステップを作成し、その内容を「指定された入力以外は許可されない」とメッセージに編集します。

  7. オプションで、このメッセージの後に判断ロジックを作成し、エラーメッセージステップがユーザー入力ステップに戻るように設定し、正しい入力が提供されるまでループさせます。

  8. 設定を保存し、ガイドをテストします。

特定の入力に基づくステップの自動完了

ユーザーが特定の値またはオプションを選択したときに、ステップを自動的に完了させます(例えば、ドロップダウンで特定のステータスを選択する場合)。これにより、ユーザーが正しい値を選択した後に「次へ」をクリックする必要がなくなります。

  1. ガイドを Guides Editor で開きます。

  2. ユーザーが特定の値またはオプションを選択したときに完了すべきステップを選択します。

  3. ステップ設定を開きます。選択された値に基づく検証/完成ルールを追加します(例: ステータスが 新規 の場合)。

  4. 次のようにルールを設定します:

    • ユーザーが正しい値を選択した場合、ステップは完了とマークされ、ガイドは次のステップに自動的に移動します。

    • ユーザーが別の値を選択した場合、ステップはアクティブのままであり、ユーザーは手動で「次へ」をクリックするか(または選択を修正する)必要があります。

  5. 正しい値と間違った値を選択することで、動作を確認するために保存してテストします。

言語依存のセレクタ

インターフェイスの異なる言語でガイドの信頼性を確保するために、ローカライズされたテキストに影響されないセレクタを選びます。 XPathセレクタは言語固有のテキスト値を含んでおり、UIが翻訳されるとこれが変更されステップが失敗する可能性があります。 CSSセレクタは一般的により安定しており、言語非依存です。一般的なルールとして、XPathを使用するステップが多言語対応であることを確認し、全体の安定性を向上させます。

  1. Adopt Editorでガイドを開きます。

  2. 言語関連の不安定性を引き起こしているステップを選択します。

  3. ステッププロパティを開きます。位置で、セレクタフィールドを確認します:

    • セレクタがXPathを使用しており、(例:ボタンラベルなど)テキストを参照している場合、それはその言語でしか機能しません。

  4. 複数の言語をサポートするために、次のオプションのいずれかを使用します:

    • オプション1: 各言語バージョンの要素を再選択し、各ロケールが自分のXPathを持つようにします。

      • 言語はツールバーまたはステップ設定で切り替えることができます。

      • ローカライズされていない場合、特定の言語のXPathは空になります。

    • オプション2: テキストではなく構造またはクラスベースの属性をターゲットにしたCSSセレクタ(XPathセレクタの代わり)を使用します。

  5. 可能な限り、広範で安定したセレクタを使用します。最善の方法は、ページの読み込みに応じて変更される動的なIDや要素を避けることです。

  6. サポートされている各言語でガイドをテストし、すべての要素が正しく検出され、ステップが期待通りにトリガーされることを確認します。


関連トピック

最終更新

役に立ちましたか?