# Amplify をウェブアプリケーションと統合する
{% hint style="warning" %}
このドキュメントは外部ソースを参照しています。 Nexthink はサードパーティのドキュメントの正確性や、このページに記載されている情報に矛盾を生じさせる可能性のある外部の更新または変更を制御することはできません。 エラーや矛盾を[Nexthink サポート](https://support.nexthink.com/)に報告してください。
{% endhint %}
ここでは、ウェブアプリケーションにAmplifyを統合する一般的なプロセスについて説明します。
{% hint style="info" %}
例として、ServiceNow Helpdeskのプロセスを示します。他のウェブアプリケーションとは異なります。 ただし、プロセスは似ており、ほとんどのウェブアプリケーションで動作します。
{% endhint %}
## **ウェブアプリケーションにAmplify拡張機能を統合する**
特定のデバイス用にウェブベースのアプリケーションにAmplify拡張機能を統合します。
このローカル設定は、[Nexthinkプラットフォーム](https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/deploying-nexthink-in-non-vdi-environment/configure-amplify/configuring-amplify-in-the-nexthink-web-interface)にウェブアプリケーション設定を追加するまで、他のAmplifyユーザーデバイスには適用されません。
ローカルでウェブアプリケーション設定を統合するには：
1. Google ChromeまたはMicrosoft EdgeにインストールしたAmplify拡張機能を開きます。
2. ブラウザの拡張機能バーでAmplify拡張機能を右クリックします。
3. ドロップダウンから**オプション**をクリックして**Nexthink Amplify設定**ページを開きます。
4. **ウェブアプリケーション設定**の下で**ローカル**タブを選択します。
5. **ウェブアプリケーションを追加**をクリックします。
{% hint style="info" %}
単一インスタンス設定の場合、Amplify拡張機能は**ローカル**および**中央**タブのみを表示します。
{% endhint %}
6. **ウェブアプリケーションURL**フィールドに入力し、Amplifyの希望する動作に応じて**ユーザーまたはデバイス識別子**と**文字列セレクタ**を使用します：
| ウェブアプリケーションすべてのページでAmplifyボタンを有効にする。 |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| デバイスまたはユーザーの識別フィールドを読み取らずに、ウェブアプリケーションのすべてのページでAmplifyボタンを有効にするには：
- ウェブアプリケーションURLフィールドにアプリケーションの基本URLを追加します。
- ユーザーまたはデバイス識別子の値のフィールドを空白のままにします。
|
| ウェブアプリケーションの特定のモジュールに対してページでAmplifyボタンを有効にする。 |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ウェブアプリケーションの特定のモジュールで、デバイスまたはユーザー識別フィールドを読み取らずにAmplifyボタンを有効にするには：
アプリケーションモジュールに特有のURLをウェブアプリケーションURLフィールドに追加します。
- 例えば、ウェブアプリケーションURLに
- ユーザーまたはデバイス識別子の値のフィールドを空白のままにします。
|
| ウェブアプリケーションの特定のフィールドから識別子を読み取るようにAmplifyを有効にする |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| UIデザインやフィールドの違いにより、特定のフィールド識別子を使用したAmplifyウェブアプリケーション設定がサポートされない可能性があります。
ウェブアプリケーションの特定のフィールドから識別子を読み取るようAmplifyを有効にするには：
- デバイス/ユーザー フィールドが入力されたウェブアプリケーションページのURLで新しいタブをブラウザで開きます。 ページの全URLをコピーします。
- Amplifyのウェブアプリケーションを追加でコピーしたURLをウェブアプリケーションURLフィールドに貼り付けます。
- Amplifyで識別子を選択しフィールドセレクタポップアップでウェブアプリケーションURLを開きます。
- ページ上の興味のあるフィールドを選択するためにハイライターを使用します。 選択されると、システムは要素をフィールドセレクタポップアップにロードします。 下図を参照してください。
|
{% hint style="info" %}
正規表現を使用して**文字列セレクタ**を構成する際にオプションで[置換パターン](#transforming-matched-values-using-substitution)を定義して一致したテキストをリフォーマットできます。 フィールドに一致する前に値を再編成またはクリーニングする必要がある場合に役立ちます。
{% endhint %}
| ウェブアプリケーションのポップアップによって正しいフィールド選択が妨害される場合：
- フィールドセレクタポップアップでセレクタを無効にするトグルをオンにし、興味のあるウェブページに移動します。
- 正しいページに来たら、セレクタを無効にするトグルをオフにして、正しいフィールドを選択します。
必要に応じて、フィールドセレクタポップアップで文字列セレクタを使用してデバイスやユーザー識別子フィールドから文字列の特定部分を選択します：
- 関連する正規表現を文字列セレクタのフィールドに入力します。
- フィールド値を入力ボタンをクリックして選択されたフィールド値を確認します。
- 保存をクリックして関連するデバイスまたはユーザー識別子を修正します。
\* Amplifyフィールドセレクタは部分的なテキスト一致に正規表現の使用をサポートしています。 これにより、選択されたフィールド値から文字列の特定部分を選択できます。 下図を参照してください。
正規表現に関する詳細についてはWikipediaのドキュメントを参照してください。
|
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
7. **ウェブアプリケーション設定を保存**
{% hint style="info" %}
Nexthinkは、グループポリシー、設定管理ソリューションまたはリモートアクションを使用して、すべてのターゲットデバイスに単一のNexthinkインスタンス設定を配信することを推奨します。
{% endhint %}
### 置換を使用して一致した値を変換する
この機能により、ユーザーやデバイスが異なる順序で表示されても一致させることができます。 たとえば、他のシステムで名前が `Smith John` として表示される場合、Nexthinkで `John, Smith` として表示されます。 **置換** を行うことで値を正しく揃えることができます。
置換は、**文字列セレクタ**を使用する際にテキストを一致させる際にオプションで使用できます。 Amplifyが使用する前に一致した値を変更できます。 たとえば、名前を並び替えたり余分なテキストを削除したりします。
以下の場合に置換を使用できます。
* 選択したフィールドに削除したい余分なテキストが含まれる
* 一致した値の一部を並び替えたい
* 一致した部分の特定のセグメントだけを保持したい
#### **これが動作する方法**
このためには、正規表現パターンでキャプチャグループを使用します。 その後、**置換**フィールドで以下のようにグループを参照します：
* `$1`は最初のグループ
* `$2`は二番目のグループ
* `$3`以降
Amplifyは、Nexthinkのレコードと値を一致させる前にこの置換を適用します。
**フィールド値を入力**をクリックして、変換結果をプレビューして保存します。
#### **例**
仮にフィールド値が以下である場合：
```
Smith John
```
Nexthinkでは以下が期待されます：
```
John, Smith
```
形式を次のように変換できます：
1. 空白で分けられた2つの単語セグメントをキャプチャする次の正規表現パターンを入力します：
```
^(\S+)\s+(\S+)$
```
このパターンは以下をキャプチャします：
* `$1` → Smith
* `$2` → John
2. **置換**フィールドに以下を入力します：
```
$2, $1
```
3. **フィールド値を入力**をクリックして結果が期待される形式と一致することを確認します。
確認後、**保存**をクリックして設定を適用します。
#### その他の例
以下の表は、サードパーティプラットフォームとNexthink間でユーザーデータ形式を正規化するために使用される正規表現の例を示しています。これにより、Amplifyは形式に関わらず該当するユーザーを識別できます。
| 元の値 | Nexthink の値 | 正規表現パターン | 置換 |
| -------------------- | ------------------ | ------------------- | ------ |
| 名 姓 | 姓 名 | `/^(\S+)\s+(\S+)$/` | $2 $1 |
| 姓 名 | 名, 姓 | `/^(\S+)\s+(\S+)$/` | $2, $1 |
| Firstname.Lastname | Lastname Firstname | `/^(\S+).(\S+)$/` | $2 $1 |
| username\@deviceName | deviceName | `/^(\S+)@(\S+)$/` | $2 |
| username\@deviceName | ユーザー名 | `/^(\S+)@(\S+)$/` | $1 |
## ウェブアプリケーションの設定を管理する
Amplifyは一連の設定に基づいてフィールドの値を読み取ります。
設定したウェブアプリケーションの選択シーケンスを変更するためには、関連する行にマウスを置いてアクションメニューを開き、順序を切り替えます：**上に移動**または**下に移動**。
また、アクションメニューからウェブアプリケーションの設定を**編集**または**削除**することもできます。
完了したら、設定を**保存**してください。
オプションで、ウェブアプリケーション設定を[エクスポートするために](https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/deploying-nexthink-in-non-vdi-environment/extension-deployment#installationandconfiguration-exportingtheconfigurationdetailsfromtheamplifyextensionexportingconfigu) as `.reg` registry file. **設定をダウンロード**してください。
## 特定のウェブアプリケーションにAmplifyを統合する
バージョンの互換性やユーザインターフェイス（UI）デザインのためにボックス外のセレクタ設定をサポートしないITSMソリューションについては、次のページを参照してください：
* [configuring-amplify-for-servicenow-agent-workspace](https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/deploying-nexthink-in-non-vdi-environment/configure-amplify/installation-and-configuration/integrating-amplify-with-web-applications/configuring-amplify-for-servicenow-agent-workspace "mention")
* [configuring-amplify-for-servicenow-operations-workspace](https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/deploying-nexthink-in-non-vdi-environment/configure-amplify/installation-and-configuration/integrating-amplify-with-web-applications/configuring-amplify-for-servicenow-operations-workspace "mention")