> For the complete documentation index, see [llms.txt](https://docs.nexthink.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexthink.com/platform/ja/user-guide/adopt/guide-content-development-from-in-app-adopt-editor/developing-walkthrough-guides/defining-walkthrough-step.md).
# ウォークスルーステップの定義
Nexthink Applications でウォークスルータイプのガイドを作成し、Adopt Editor でそのガイドにアクセスした後:
{% stepper %}
{% step %}
### **新しいステップ**を作成する
ドロップダウンメニューから **Step** を選択するか、キーボードショートカット **Shift + A** を使用します。これによりエレメントピッカーが起動し、このステップに関連付けるページ上の要素を選択できます。詳細については、Adopt Editor の「Using Element Selector」を参照してください。
ページ上にカーソルを移動し、クリックするかキーボードショートカット **Shift + S** を使用して要素を選択します。これにより、選択した要素に割り当てられたステップが作成されます。
{% hint style="info" %}
**Shift + S** ショートカットは、カーソルで要素を選択できない場合に便利です。例えば、クリックすると表示されなくなるポップアップメニュー内の要素を選択する場合です。
{% endhint %}
{% endstep %}
{% step %}
### ステップの**プロパティ**を設定する
ステップの**プロパティ**を開き、**コンテンツ**、**外観**、**位置**、**表示**の各タブにアクセスします。これらのタブを使用して次の操作を行います:
* テキストと**コンテンツ**をウォークスルーステップに追加する
* ウォークスルーステップの**外観**を定義する
* ウォークスルーステップの**位置**オプションを定義する
* ウォークスルーステップの**トリガー**オプションを定義する
各タブの詳細については、このページに含まれる以下のセクションを参照してください。
{% endstep %}
{% endstepper %}
***
{% hint style="info" %}
エディターを簡素化するため、Content、Appearance、Position の各タブでは、一部の詳細設定がデフォルトで非表示になっています。これらの設定は引き続き存在しており、ご要望に応じて組織向けに再度有効化できます。Nexthink の担当者にお問い合わせください。非表示の設定の全一覧については、[詳細設定](/platform/ja/user-guide/adopt/guide-content-development-from-in-app-adopt-editor/developing-walkthrough-guides/defining-walkthrough-step/advanced-settings.md)を参照してください。
{% endhint %}
### ウォークスルーステップへのテキストとコンテンツの追加
Adopt Editor の左側パネルからステップの **Properties** にアクセスし、**Content** タブを開くと、ガイドを使用する従業員に表示するコンテンツを追加できます。
#### ステップコンテンツ
* **ツールチップコンテンツ**エディターを使用してテキストを書き、形式を整えます。
* 必要に応じて、URL またはアセットライブラリから画像を追加します。
* オプションとして関連ページ、画像、音声、ビデオへのリンクを追加します。
***
### ウォークスルーステップの見た目の定義
Adopt Editor の左側パネルからガイドステップの**プロパティ**にアクセスし、**外観**タブを開きます:
ボタンとアクション
事前定義された追加ボタンを有効または無効にして、ステップに表示されるボタンを決定できます。
* **次へ**と**前へ**ボタンを有効にして、ステップで直接ナビゲートできるようにします。
* 追加ボタンを有効にします。これらは**アクションボタン**の設定に使用できます。
* **閉じるクロスボタン**を有効にして、ユーザーがステップを完了せずに終了できるようにします。
ステップの見た目
* **閉じるラベル**を有効にし、閉じるボタンのテキストを指定します。最初に閉じるアクションボタンを有効にする必要があります ([操作とインジケーターを参照](#controls-and-indicators))。
ステップのインタラクション
* ドロップダウンを使用してこの動作を有効または無効にすることで、ステップの表示中にユーザーがページ要素を操作できないようにすることができます。このオプションは、ステップの周囲またはページ全体の要素に適用されます。
影
このオプションは、ステップ完了に必要な要素を除くページを暗くするか、ぼかしを入れることができます。
* 影の**種類**を選択します:
* オフ (影をオフにする)
* 透明
* ぼやけた背景。
枠線
* ステップにリンクされたUI要素に**単一**または**グラデーション**の枠線を追加します。枠線を削除するには**オフ**を選択します。
* **枠線**オプションを有効にすると、瞬時の視覚効果の代わりに漸進的な遷移**アニメーション**を適用できます。
コントロールとインジケーター
ステップを進めるためのアクションボタンを表示します。
* ユーザーがステップを閉じることができるように**閉じるアクションボタン**を表示します。
* ユーザーが完了したステップの数を表示する**ステップカウンター**を表示します。
* ウォークスルーの**全ステップ数**を示すカウンターを表示します。
* ステップを独自のiframe内に配置するステップカプセル化を有効にします。レンダリング中に全体のページ構造に干渉するのを防ぎます。
ステップオーバーレイ
ステップの全体的な表示方法とページ上でのレンダリング方法を定義します。
* 標準のステップ外観である**ツールチップ**は、割り当てられた要素に対して相対的に表示されるボックスです。
* **スマートページ**は、ビデオコンテンツや大きな画像に推奨される画面中央の大きなボックスです。
* **通知** はページの下部にある通知に似た幅広いボックスです。
* **非表示**にすると、ユーザーからステップが削除されます。これは、正しいページに誘導されるステップ間の遷移に推奨されます。詳細については、ウォークスルーの位置オプションの定義を参照してください。
* ページの左側を上下に占める**サイドバー** このオプションは`.pdf`ファイルや大量のコンテンツに推奨されます。
***
### ウォークスルーステップの位置オプションを定義する
Adopt Editor の左側パネルからステップの**プロパティ**にアクセスし、**位置**タブを開きます:
#### **ステップ位置**
選択されたステップ — 要素セレクターと不安定性 自動修正
アプリケーションのWebページ上でステップに関連する要素を**プレビュー**します。必要に応じて、要素を**再選択**するか、不安定なセレクターを**自動修正**します。
Adopt Editor は、ステップのセレクターの30％以上が不安定（動的に生成された識別子に依存している）で、少なくとも1つのセレクターがターゲット要素を正しく識別している場合に、**セレクターの自動修正**ボタンを有効にします。システムは機能しているセレクターを使用して、不安定なセレクターを再生成し、セレクターの不安定性を軽減します。
要素が削除されている場合、または複数の動作するセレクターが異なる要素を識別し、セレクターの**自動修正**を実行できない場合を除き、**自動修正**機能では要素を**再選択**したりステップを再記録する必要はありません。これらの場合は、手動で要素を**再選択**してください。
{% hint style="warning" %}
**自動修正**は単一のステップで動作し、ガイド全体のセレクターを修正するものではありません。
{% endhint %}
**不安定なセレクターを含むガイドの通知を受け取る**
デプロイされたガイド内の不安定なステップを能動的に識別するには、Nexthink Library から **Adopt Unstable Selectors** の事前定義モニターをインストールして使用します。モニターは、ステップに不安定なセレクターが含まれている場合にアラートを生成します。
ライブラリコンテンツのセットアップについては、[Nexthink Library](/platform/ja/user-guide/nexthink-library.md#nexthinklibrary-accessingnexthinklibrary) を参照してください。
モニターが不安定なセレクターを含むガイドについて通知した場合:
* Nexthink でガイドの公開を中止します。
* Adopt Editor でガイドを開き、システムによりフラグ付けされたステップを確認します（下のスクリーンショットを参照）。
* 影響を受けたステップの**位置**タブで、**セレクターの自動修正**オプションを確認します。
キーのページ
* **ナビゲーション**を使用して、ステップに到達したときにユーザーを特定のページに誘導できます。動的なアドレスを持つページをガイド目的でより安定させる**位置URLパターン**
* **キーページをターゲットにする**は、**一致を表示**を選択することやリストからキーページを選択することを許可します。また、**検索**バーを使用して、名前で結果をフィルタリングすることもできます。
* 事前定義されたキーページは、動的URLとまだ認識可能なNexthink Infinityのステップを関連付けることができます。例: `https://impl.workday.com/*/d/home.htmld`
* 一致するキーページがない場合は、キーページのドキュメントを参照してください。
* **キーページ選択を無視し**、**ナビゲーション**の下で静的URLを定義します。
要素の位置
必要に応じて、Nexthink Infinity Adoption 設定でデフォルト構成されている**要素セレクター**を有効または無効にし、このステップ専用にします。
* **Element XPath** セレクターの上書きは、特定のテキストブロックを対象としているため、別の言語にローカライズできます。
{% hint style="warning" %}
ifのあるアプリケーション内でAdopt Editorを使用する場合、**一致の表示**オプションは、対象要素が存在するiframeの一致するキーページを表示できません。
これらのケースでは、一致するキーページを表示するには、ターゲットの要素を**再選択**します。
{% endhint %}
* ステップが表示される際にURLアドレスに自動的に移動するようにするには、この設定を有効にします。この設定は、ウォークスルーの最初のステップでは有効にできません。
* 選択した要素の位置に基づき、ステップ描画の方向を決定する**方向**を選択します。
* **自動**がデフォルト設定です。要素がページの上部にある場合、ステップは下から描画され、それ以外の場合は上から描画されます。
* 描画する方向を指定するには **上**, **右**, **下** または **左** を選択します。
{% hint style="info" %}
システムがスペースの制約により希望する位置に表示できない場合、Adopt は時計回りの方向で最適な位置に配置します。
{% endhint %}
***
### ウォークスルーステップのトリガーオプションを定義する
Adopt Editor の左側パネルからステップの**プロパティ**にアクセスし、**トリガー**タブを開きます:
#### **ステップが開始される条件を定義する**
* ドロップダウンからトリガーを選択して、ステップを開始するタイミングを定義します:
* **スポット/アンスポット**トリガーは、ページに表示されている要素で機能し、**プレゼント/アンプレゼント**は、ページには表示されていないが存在する要素に関連します。たとえば、CSSで`hidden`に設定されています。
* **ビューポートでのスポット**は、要素が従業員の画面に表示されたときにステップを開始します。
* **選択値の入力および移動**は、検索バーに単語を入力するなど、ページ上の入力フィールドとのインタラクションのためにステップをトリガーします。
* **Element loses focus** は、フォーカスされているページ要素以外の場所をクリックすると、ステップをトリガーします。たとえば、検索バーでの入力を無効にするためにクリックします。
* **Completing previous step after** を有効にし、前のステップの完了後にこのステップを表示するまでの時間を秒単位で設定します。
* ステップの表示をトリガーとして受け取るためにカスタム外部コマンドを定義します。
* **Wait for other guide(s)** で他のガイドのリストを定義すると、それらのガイドが完了した場合にのみステップが表示されます。
* **+** を選択して、開始条件をさらに追加します。
{% hint style="info" %}
前のステップの設定の**トリガー**タブでカスタム外部コマンドを作成する必要があります。
{% endhint %}
#### **ステップが完了する時の条件を定義する**
* ドロップダウンからトリガーを選択して、ステップを完了するタイミングを定義します:
* **Mouse click** は、ユーザーが任意の場所をクリックするとステップをトリガーします。
* **Spot/Unspot** トリガーはページ上で見える要素に対して機能し、 **Present/Unpresent** は存在するがページに表示されない要素を指します。たとえば、CSSで`非表示`と設定されている場合があります。
* **ビューポートでのスポット** は、要素が従業員の画面に表示されているときに、そのステップをトリガーします。
* **選択値を入力して進める** と、ページ上の入力フィールドとの相互作用、例えば検索バーに単語を入力する、またはドロップダウンからオプションを選ぶ際にそのステップをトリガーします。
* 必要に応じて、入力値が一致する必要がある正規表現を使用して **With specific pattern** を定義します。例: `^((?!CEO).)*$`。
* **セレクター**で、**メインウィンドウで選択したトリガー要素**を**再選択**または**プレビュー**します。これは値が入力または選択される要素であり、ステップ自体に関連付けられた要素とは異なる場合があります。
* **要素 XPath**を有効にして、トリガー要素のセレクタータイプを上書きします。
* **要素がフォーカスを失ったとき**は、フォーカスされているページ要素の外側をクリックするとステップをトリガーします。たとえば、検索バーからタイピングを停止させるためにクリックして離れてください。
* ユーザーが**次へ**ボタンを押したとき。
* オプションで、**次へ**または**完了**ラベルを追加します。
* ユーザーが**前へ**ボタンを押したとき。
* オプションで、**前へ**ラベルを追加します。
* **ステップを直ちに終了する**を有効にすると、追加の操作なしでステップを完了します。
* **経過時間**を有効にし、ステップを自動的に完了するまでのタイマーを秒単位で設定します。
* ステップの完了をトリガーとして受け取るカスタム外部コマンドを定義します。
* ステップが完了したときにカスタム外部コマンドを送信するかどうかを定義し、そのコマンドを作成します。
* ステップが完了後に持続するかどうかを定義します。
* **URLアドレスの変更時** は、ガイドが別のページに移動した後もステップを持続します。
* **ページのリロード時** は、ユーザーがページを更新した後もステップを持続します。
* **履歴を遡るとき** は、ユーザーが以前のページに戻った後もステップを持続します。
* **どのオプションでも** 、上記の条件を満たしたときにステップを持続させます。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.nexthink.com/platform/ja/user-guide/adopt/guide-content-development-from-in-app-adopt-editor/developing-walkthrough-guides/defining-walkthrough-step.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
