# 採用設定の設定
{% hint style="warning" %}
**採用設定**は、[管理者](https://docs.nexthink.com/platform/ja/user-guide/administration/account-management/roles#roles-administration) ロールを持つユーザーのみがアクセスできます。
ガイドを公開するためのステップをまとめた手順については、[ガイドの展開: エンドツーエンド](/platform/ja/user-guide/adopt/getting-started-with-adopt/deploying-a-guide-end-to-end-procedure.md)を参照してください。
{% endhint %}
**採用設定**では、Web アプリケーション内のすべてのガイドのデフォルト動作を設定できます。 これには、Adopt Editorでのコンテンツ開発を形作る要素セレクタとガイドコンポーネントのセットアップが含まれます。 さらに、**コンテキスト ヘルプ**を表示するためのデフォルトオプションを選択することもできます。
**採用設定**には次のサブタブが含まれます。
* [設定 ](#configuring-adoption-settings-for-the-selected-application)サブタブ
* [ローカライズ](#configuring-the-localization-settings-for-the-selected-application) サブタブ
* [テーマ](#customizing-the-adopt-theme-for-the-selected-application)サブタブ
* [コンテキストヘルプ](#configuring-context-help-settings-for-the-selected-application) サブタブ
## 選択されたアプリケーションの採用設定を構成する
Nexthink **Applications** > **アプリケーションを管理**から、ガイドがあるWebアプリケーションを選択します。 **採用設定**タブ > **設定**サブタブを開くには次の操作を行います。
1. ガイドのコンポーネント動作の[ガイド デフォルト ](#setting-guide-defaults)を有効または無効にします。
2. アドプトエディタがウェブアプリケーションから直接ページ要素をキャプチャする方法を、[要素セレクタのための事前定義されたセット](#configuring-selectors)に基づいて決定します。
3. **設定を保存**。
### ガイドデフォルトの設定
ガイドのコンポーネントのデフォルト動作を構成します:
* **キーのページ選択を無視**: 指定された要素がアプリケーションページビューに存在するたびに、ガイドステップやコンポーネントが表示されるようになります。
* これはシステムが主要ページを無視し、要素セレクタのみに基づいてガイドステップを表示することを意味します。
* **記録されたクエリパラメータを無視する**: ステップが特定のURLにナビゲートし、たとえば`http://google.com/?query`というクエリが含まれている場合、この設定を有効にしてクエリ、つまり`/?`以降のすべてを無視し、基本URLのみを使用します。
* ユーザーがスクロールするときに位置を再計算する機能を有効にします。これは、メインページ以外にもスクロールバーを持つ複数のコンテナがある場合に便利です。 通常、Adoptはステップに関連付けられた要素に到達するためにメインページをスクロールします。 このオプションを有効にして、`element ID`を指定することで、そのコンテナへのスクロールに制限を課すことができます。
* **要素が覆われていない場合にステップを表示する**：モーダルダイアログなど、追加の層に覆われていない場合にのみガイドステップを表示させます。 選択を解除すると、追加の層があってもステップが表示されます。
* **完了後にステップを維持する**：ユーザーが完了した後もガイドステップをそのままにします。
* **任意の**: ステップへのユーザーの操作に関係なく設定が機能します。
* **再読み込み時**：ページの再読み込み時に設定が機能します。
* **ナビゲート時：** ユーザーがURLを変更したときに設定が機能します。
* **バックフォワードでの動作:** 設定はユーザーが前のページに戻るときに機能します。
{% hint style="info" %}
特定のガイドオーバーレイ（ステップ、アクション、ツールチップなど）の[ポジション プロパティ タブ](broken://pages/9jcfummECIGZn2G3QU9g)を設定する際に、**ガイドデフォルト**をカスタマイズすることができます。 ガイドの種類に関係なく、ウェブアプリケーション上でAdopt Editorから直接。
{% endhint %}
{% hint style="warning" %}
**記録されたクエリパラメータの無視**、**ユーザースクロール時の位置再計算の有効化**、および**スクロールコンテナの位置**機能は、Nexthink Adoptが改良されるとともに廃止される予定です。
{% endhint %}
### セレクターフレームワークの定義
[要素セレクタ](#define-element-selectors)と[セレクタのオーバーライド](#defining-element-selector-overrides)を決定して、Adopt EditorがWebアプリケーションからページ要素を直接キャプチャする方法に関するデフォルトの指示を指定します。 これらの指示は、Adoptが内部レンダリング構造を解釈するために使用する**セレクタ**システムを定義します。
Nexthinkは、次の方法で要素の選択を微調整するのに役立ちます:
* 要素を見つける可能性を高めるための複数のセレクタータイプを特定します。
* 動的に生成された識別子を検出し、信頼性のあるガイドオーバーレイ表示のために動的コンポーネントから削除します。
{% hint style="info" %}
\[位置プロパティ]タブ(手順、アクション、ツールチップなど)の特定ガイドオーバーレイを設定する際、**セレクター**設定をカスタマイズできます。 ガイドの種類に関係なく、ウェブアプリケーション上でAdopt Editorから直接。
{% endhint %}
#### 要素セレクタの定義
{% hint style="info" %}
実際の要素セレクターの例については、次を参照してください:
* [ユースケース: Workday用のエレメントセレクター](/platform/ja/user-guide/adopt/guide-creation-and-management-from-nexthink-applications/configuring-adoption-settings/use-case-element-selectors-for-workday.md)
* [ユースケース: Microsoft Dynamics用のエレメントセレクター](/platform/ja/user-guide/adopt/guide-creation-and-management-from-nexthink-applications/configuring-adoption-settings/use-case-element-selectors-for-msdynamics.md)
* [use-case-element-selectors-for-salesforce-lightning.md](/platform/ja/user-guide/adopt/guide-creation-and-management-from-nexthink-applications/configuring-adoption-settings/use-case-element-selectors-for-salesforce-lightning.md)
* [use-case-element-selectors-for-sap-concur.md](/platform/ja/user-guide/adopt/guide-creation-and-management-from-nexthink-applications/configuring-adoption-settings/use-case-element-selectors-for-sap-concur.md)
{% endhint %}
\[Adoptエディターで要素をキャプチャするとき]（../../guide-content-development-from-in-app-adopt-editor/using-element-selector-in-adopt-editor.md）に不安定を避けるために、次の**要素セレクター**フィールドに入力してください。 要素セレクターはケースバイケースであり、一部のWebサイトは他よりも複雑なデザインを持っています。
設定を保存した後に**要素セレクタ**フィールドを更新すると、その後行われた要素選択にのみ影響し、Adopt Editorですでに構成されている既存のガイドコンポーネント内の要素セレクタには影響しません。
{% hint style="warning" %}
**要素セレクター**フィールドの更新には、Webページからの[属性の識別と抽出](#extracting-element-selectors-from-web-pages)に慣れている必要があります。例えば、要素IDなどです。
{% endhint %}
無視された要素IDフィールド
要素IDはページ要素を指し示す最も一般的な手段です。 ただし、要素の可視性はユーザーやページの状態に依存するため、これは常に適用されるわけではありません。
この設定により、ステップを記録する際に常に存在するとは限らない要素を無視することができます。 複数の要素をカンマで区切って含めることができます。
ID置換またはクラス名置換フィールド
**ID置換**または**クラス名置換**フィールドを使用して、IDまたはクラス名セレクターから数字などの動的要素を削除し、関心のある静的セグメントのみを保持するようシステムに指示します。
{% hint style="info" %}
ID 替換の実際の使用例については、[ユースケース: Microsoft Dynamics用のエレメントセレクター](/platform/ja/user-guide/adopt/guide-creation-and-management-from-nexthink-applications/configuring-adoption-settings/use-case-element-selectors-for-msdynamics.md#element-id-replacement-example) ドキュメントを参照してください。
{% endhint %}
無視された要素のクラス名フィールド
複数の HTML 要素がクラス名を使用でき、これらはページ状態の異なる表現をもたらす視覚スタイルでよく用いられます。
この設定により、これらの異なる状態の結果を無視することができ、ガイドステップに干渉する可能性があります。 複数の要素をカンマで区切って含めることができます。
含まれる要素のカスタム属性名フィールド
動的クラス名を扱う場合、動的な要素を取り除くとページ状態の表現に問題を引き起こす可能性があります。 この設定では、ガイドステップで要素が記録される際に`div`内に存在するカスタム属性を使用することができます。 カンマで区切って複数の要素を含めることができます。
* [Shadow DOM](#identifying-if-a-web-page-element-uses-shadow-dom)を使用した **SAP SuccessFactors** のウェブアプリケーションページ要素の例:
`data-ui5-stable`
#### セレクタ検証ルール
Adoptのセレクタシステムは、構成されたすべての要素、パターン、および置換が有効であり、Webアプリケーション全体で一貫して機能することを保証するための一連の検証ルールに従っています。
* **オプションフィールド:** すべてのセレクターフィールドはオプションです。 構成に必要ない場合は、任意のフィールドを空白のままにすることができます。
* **正規表現パターンフィールド:** 以下のフィールドには有効な正規表現が含まれている必要があり、特定のフォーマットルールに従う必要があります:
* *無視された要素ID*
* *無視された要素クラス名*
* *クラス名置換 → パターン*
* *要素ID置換 → パターン*
これらのパターンは次の要件を満たす必要があります:
* 有効な正規表現であること。
* 数字で始めないこと。
* 二重引用符を `\"` としてエスケープすること。
* エスケープされたバックスラッシュを含まないこと。
* **カスタム属性フィールド:** フィールド *含まれる要素のカスタム属性名* には、有効な HTML 属性名を含める必要があります。 例えば: `data-user` または `aria-label`。
* **置換フィールド:** フィールド *クラス名置換 → 置換子* および *要素ID置換 → 置換子* には、有効な CSS セレクターを含める必要があります（例えば `#element-id` または `.element-class`）。
#### 要素セレクターのオーバーライドの有効化/無効化
{% hint style="warning" %}
**要素セレクターのオーバーライド**の更新は、新しい要素選択にのみ影響します。すでにAdopt Editorで構成されているガイドコンポーネントの要素セレクターオーバーライドには更新を適用しません。
{% endhint %}
これらのオプションは、特定アプリケーションに対してデフォルトで有効にするセレクターを定義することを可能にします。
* **要素 XPath**: 言語特有の要素テキスト値に基づくセレクタ。\
例えば: `(/html/body//span[contains(translate(.,'AÁÄBCČDĎEÉFGHIÍJKLĽĹMNŇOÓÔPQRŘŔSŠTŤUÚVWXYÝZŽ ','aáäbcčdďeéfghiíjklľĺmnňoóôpqrřŕsštťuúvwxyýzž'),concat('new',''))][not(ancestor-or-self::yes-elf-holder)])[3]`
* **要素 CSS 相対パス**: タグ名、クラス名、ID、`nth-child` からなる相対 CSS セレクタ。\
例えば: `div#target.element:nth-child(0)`
* 各レベルは`>`結合子で区切られています。
* 利用可能であれば、IDを持つ最も近い親から開始します。
* **限定されたXPath要素**: 相対CSSパスに相当しますが、XPath形式で表現されています。 通常は自動生成され、評価が遅い。\
例えば: `input[@id='...'][contains(@class,'textbox')]`
* **要素のCSS相対パス限定**: CSS相対パスと同様ですが、`nth-child()`擬似クラスを除外します。 要素が兄弟の中でユニークな場合、位置を指定する必要がない場合に使用します。\
例えば: `input#RequestID_input.alignmentLeft.field.textbox`
* **要素 CSS 表現パス**: 複数のクラス名に依存し、ターゲット要素を相対セレクタで定義するセレクタ。\
例えば: `.class1 .class2 > div#target.element:nth-child(0)`
* **要素 CSS クラスのみパス**: クラス名のみを使用して作成されたセレクタ—ID やタグは使用しません。\
例えば: `.applicationShell-2 .active-form.dialog-container`
* **要素のCSSタグのみのパス**: タグ名と`nth-child()`擬似クラスのみを使用したセレクタ、それらを`>`で結合します。 クラスまたは ID が存在しない場合に便利です。\
例えば: `html > body > div:nth-child(3) > div:nth-child(1) > input:nth-child(4)`
アダプトエディターでガイドオーバーレイの位置を設定する際、前述のものに加えて以下の**要素セレクターのオーバーライド**を有効または無効にすることができます:
* **Element JSPath**: 合成されたパスとShadow DOMのトラバースに基づくセレクタ。\
例: `body > ui5-static-area > ui5-static-area-item-sf-header,...`
#### Webページから要素セレクターを抽出する
[要素セレクターの定義](#defining-element-selectors)時にWebページから属性を抽出するのが初めての場合、次の手順に従ってください:
Webページから属性を特定して抽出する
**設定**タブで[要素セレクタを定義する](#defining-element-selectors)には、まずウェブページから属性を直接特定して抽出する必要があります。
あなたのブラウザから:
1. MS EdgeとChromeブラウザ内で開発者ツールを起動します (F12)。
* 他の手段として、右クリックして**インスペクト**します。
2. ツールバー内の 
アイコンをクリックしてください。
3. マウスカーソルを使用して必要な要素を選択します。
4. 右側の**Elements**パネルから選択した要素に関連するデータが見えるでしょう。
5. どの属性が安定したデータを含んでいるか評価します。 比較として5〜6の要素をサンプルしてください。
または、[Nexthink ブラウザー拡張機能](https://docs.nexthink.com/platform/ja/applications/configuring-applications/configuring-web-applications/transactions.md#transactions-usingthenexthinkbrowserextensionbrowser)を使用して、Web アプリケーションページから **CSS セレクター** を抽出します。この拡張機能は現在、Firefox をサポートしていません。
以下の画像では、`data-automation-id` 属性が要素セレクタの候補です。
{% hint style="warning" %}
Webページ上のドロップダウンやメニューなど、[Shadow DOM](#identifying-if-a-web-page-element-uses-shadow-dom)でカプセル化された動的に複雑な要素の場合、単なる属性抽出では一致する精度が十分でないことがあります。
{% endhint %}
{% hint style="info" %}
実際の要素セレクタの例については、次を参照してください:
* [ユースケース: Workday用のエレメントセレクター](/platform/ja/user-guide/adopt/guide-creation-and-management-from-nexthink-applications/configuring-adoption-settings/use-case-element-selectors-for-workday.md)
* [ユースケース: Microsoft Dynamics用のエレメントセレクター](/platform/ja/user-guide/adopt/guide-creation-and-management-from-nexthink-applications/configuring-adoption-settings/use-case-element-selectors-for-msdynamics.md)
* [ユースケース: SAPアプリケーション用のシャドウDOMセレクター](/platform/ja/user-guide/adopt/guide-creation-and-management-from-nexthink-applications/configuring-adoption-settings/use-case-shadow-dom-selectors-configuration-for-sap-application.md)
{% endhint %}
### アプリケーションテンプレートからセレクターを使用する
アプリケーションテンプレートを選択すると、必要なセレクター設定が自動的に入力され、ガイドコンテンツ作成前の手動での事前設定が不要となります。
アプリケーションテンプレートの実装に関する情報は、[ウェブアプリケーションの設定](/platform/ja/user-guide/applications/configuring-applications/configuring-web-applications.md#configuringwebapplications-understandingurlpatterns-1)を参照してください。
セレクター設定:
* エディター内の要素ピッカーにのみ影響する
* 既存のガイドや手順を変更しない
* 最終利用者には反映されません
{% hint style="warning" %}
テンプレートが適用される前にアプリケーションにセレクター設定がある場合、テンプレートの適用によりそれらは上書きされます。 新しいセレクターを後から追加することはできますが、テンプレートによって提供されるものを削除することはできません。
テンプレートの選択は不可逆的なプロセスです。
{% endhint %}
#### テンプレートをカスタムセレクター置換で上書きする
組織の必要性に応じて、サポートされている企業向けアプリケーションのカスタマイズ版を展開することが可能です。 これらの環境では、DOM構造が標準的なベンダー実装と異なる場合があります。 たとえば：
* クラス名がリネームされたりプレフィックスが付与されることがあります。
* 要素IDがデフォルトの構造と異なる場合があります。
* 特定のコンポーネントは追加のコンテナでラップされる場合があります。
セレクタシステムは、これらのバリエーションに対応するために制御されたオーバーライドをサポートしています。 オーバーライドできるもの:
* クラス名
* 要素 ID
これにより、テンプレートベースのセレクタが、基礎となるテンプレート構成を変更することなく、顧客固有の実装に正しくマッピングされます。
#### サポートされているテンプレート
セレクタテンプレートは次のアプリケーションで利用可能です:
* ワークデイ
* Microsoft Dynamics
* Salesforce Lightning
* SAP Concur
フィールドに永続的なセレクタ入力を持つ
一部のフィールドは、変更された場合、常に顧客入力を保持します:
* `classOnly.pattern`
* `classOnly.replacer`
* `idOnly.pattern`
* `idOnly.replacer`
* 属性ブロックリストと許可リストの値
以下のフィールドは、選択したモードに依存します:
* `excludedLocations`
* `disabledLocationPaths`
* 関連するチェックボックス
テンプレートを選択すると、更新が自動的に適用されます。 テンプレートの更新は、カスタム値を変更しません。
### ユーザー履歴をリセット
Nexthink Adoptは、ユーザーの操作、具体的にはガイドビューや完了をデータベースに保存します。 管理者は、このデータを特定のユーザー単位で、またはアプリケーション全体に対して削除することができます。 削除するユーザーを指定するには、そのNQL IDを入力してください。
保存されたユーザー操作は、[ガイド条件](/platform/ja/user-guide/adopt/guide-creation-and-management-from-nexthink-applications/creating-guides.md#defining-conditions-for-guide-autostart)チェックをサポートします。 公開済みのガイドをテストした後、自分のインタラクション履歴をリセットして、クリーンな状態からの動作を確認できます。
{% hint style="warning" %}
**アドプション履歴**のリセットは取り消しできません。
{% endhint %}
***
## 選択したアプリケーション用のローカライズ設定を構成する
**ローカリゼーション** は、従業員のブラウザ設定に基づいてAIによる自動翻訳を使用してガイドの内容をローカライズします。
採用コンテンツをローカライズするには二つの方法があります: AIによる方法と手動で翻訳を提供する方法です。
* AIローカリゼーションはガイド名とその手順内のすべてのコンテンツに影響を及ぼします。
* 手動翻訳はガイドの手順内のすべてのコンテンツに影響を及ぼしますが、ガイド名を異なる言語に適合させるために変更することはできません。
ローカリゼーションを有効化するには、Nexthinkの **Applications** > **Manage applications** からガイドを含むWebアプリケーションを選択します。 **Adoption settings**タブ > **Localization**サブタブを開きます:
* 最大5つの言語を選択できます。 ユーザーの言語が選択されたオプションの中にない場合、システムはデフォルトで英語を使用します。
{% hint style="warning" %}
**ローカリゼーション**タブで言語セットを選択した後、特定のガイドを作成または設定する際は、[コンテンツ翻訳を有効化](/platform/ja/user-guide/adopt/guide-creation-and-management-from-nexthink-applications/creating-guides.md#localizing-content-with-ai)してください。この翻訳はガイドレベルで有効化されます。
{% endhint %}
***
## 選択したアプリケーション用のAdoptテーマのカスタマイズ
テーマを設定するには、アプリケーション管理に移動し、必要なアプリケーションを選択してから、導入設定とテーマタブを選択してください。
Adoptがデフォルトの配色として使用する**テーマ**を選択し、コンテキストヘルプや手順、アクション、ツールチップなどのガイドコンテンツを表示します。
選択したアプリケーションのテーマをカスタマイズするには:
1. **Navi**、**Light**、または **Dark** からテーマを選択してください。
2. LightまたはDarkでは、HEXカラーコードを使用してカスタムの**アクセント**カラーを選ぶことができます。 例えば: `#1046a8`.
3. 変更をアプリケーションとガイドコンテンツに適用するため、**保存**してください。
{% hint style="info" %}
**Navi** テーマは追加オプションとして提供され、カスタマイズすることはできません。
{% endhint %}
#### コンテキストヘルプアイコン
Adoptが従業員に表示するコンテキストヘルプアイコンを選択します。 Adoptが提供するアイコンを使用するには、**デフォルト**を選択し、変更を適用するために**保存**をクリックしてください。
選択したアプリケーションに対してカスタムの**アイコン**を設定するには:
1. PNG または SVG 画像ファイルタイプを[アセットライブラリ](/platform/ja/user-guide/adopt/guide-creation-and-management-from-nexthink-applications/managing-adoption-assets-with-the-asset-library.md)にアップロードします。
2. **画像を選択**し、利用可能なアセットから画像を見つけてください。
3. **導入設定** > **テーマ**タブで、アイコンの背景色をHEXコードで選択してください。 例: `#1046a8`
4. 選択したアイコンと色のプレビューを確認します。
5. 変更をアプリケーションに適用するには、**保存**をクリックしてください。
Nexthinkは、アイコンの以下のプロパティを推奨します:
* PNG または SVG 画像ファイルタイプ
* 最小サイズ: 36 x 36 ピクセル
* 正方形のアスペクト比
**Navi** テーマとアイコンは追加オプションとして提供されていますが、カスタマイズすることはできません。
{% hint style="info" %}
HEXカラー規則は16進数（基数16）桁を使用して色を指定します。 これらの数字は 00 から FF までの赤、緑、青の強度を示すようにペア（RR、GG、BB）でグループ化されています。
{% endhint %}
***
## 選択したアプリケーション用のコンテキストヘルプ設定を構成します
{% hint style="info" %}
ウェブアプリケーション内のクエスチョンマークアイコンからアクセスできるコンテキストヘルプは、従業員が自己支援のためにコンテキスト特有のガイドやドキュメントを検索することができます。
{% endhint %}
ターゲットアプリケーションサイトでデフォルトで**コンテキストヘルプ**ポップアップがどのように表示され動作するかを設定します。
Nexthink **アプリケーション** > **アプリケーションを管理**から、ガイドを含むウェブアプリケーションを選択します。 **Adoption settings**タブ > **コンテキストヘルプ**サブタブを開きます:
1. オプションとして、[表示中のウォークスルーを抑制する](#suppress-visible-tours)。
2. 任意で、[構成をカスタマイズ](#composition)してください。
3. **設定を保存**.
### **表示中のウォークスルーを抑制する**
従業員がコンテキストヘルプポップアップから新しいガイドを開始するときに、**表示中のウォークスルーを抑制する**ことができます。 この設定により、2つのガイドが同時に表示されることを防ぎます。
### コンポジション
* オプションで、[ガイド ジャーニー](/platform/ja/user-guide/adopt/guide-creation-and-management-from-nexthink-applications/creating-and-managing-guide-journeys.md)、ウォークスルー、およびメディア型ガイドを分類するためにコンテキスト ヘルプ ポップアップに表示されるヘッダーを変更します。 必要に応じて、デフォルトのヘッダーを保持します。
* ユーザーに表示されるそれらのセクション内のガイドジャーニーの視覚順序を並べ替えます。
***
関連トピック
* [Nexthink「アプリケーション」からのガイドの作成と管理](/platform/ja/user-guide/adopt/guide-creation-and-management-from-nexthink-applications.md)
* [コンテキストヘルプ](/platform/ja/user-guide/adopt/guide-creation-and-management-from-nexthink-applications/configuring-adoption-settings/adopt-conditions.md)
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.nexthink.com/platform/ja/user-guide/adopt/guide-creation-and-management-from-nexthink-applications/configuring-adoption-settings.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.