# 設定ガイド: バッテリー交換スケジューリング

## **はじめに** <a href="#configurationguide-batteryreplacementscheduling-introduction" id="configurationguide-batteryreplacementscheduling-introduction"></a>

このワークフローを開始する前に、すべての関連コンテンツが適切にインストールおよび設定されていることを確認してください。 このページでは、含まれるコンテンツおよびその設定方法についてのガイダンスを提供します。

これは単なるガイドであり、提案される設定を示しています。 特定の環境に応じて、自由にコンテンツをカスタマイズおよび編集することができます。

## 前提条件 <a href="#configurationguide-batteryreplacementscheduling-pre-requisites" id="configurationguide-batteryreplacementscheduling-pre-requisites"></a>

このライブラリパックには、以下の[拡張製品](https://nexthink.gitbook.io/opd/overview/products)のコンテンツが含まれています。

* [Employee Engagement - Campaigns](https://nexthink.gitbook.io/opd/user-guide/campaigns)
* [Remote Actions](https://nexthink.gitbook.io/opd/user-guide/remote-actions)
* [Flow - Workflows](https://nexthink.gitbook.io/opd/user-guide/workflows)

## コンテンツリストと依存関係 <a href="#configurationguide-batteryreplacementscheduling-contentanddependency" id="configurationguide-batteryreplacementscheduling-contentanddependency"></a>

| 種類                                                                          | 名前              | 説明                                                                                                                       |
| --------------------------------------------------------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------ |
| [Workflows](https://nexthink.gitbook.io/opd/user-guide/workflows)           | バッテリー交換スケジューリング | エンドツーエンドのバッテリー交換プロセスを自動化します。                                                                                             |
| [Campaigns](https://nexthink.gitbook.io/opd/user-guide/campaigns)           | バッテリー交換アドバイザリー  | このキャンペーンは、ユーザーに対してバッテリーの交換時期が到来したことを知らせ、交換を行うためにITSMチケットの登録を依頼します。                                                       |
| [Remote Actions](https://nexthink.gitbook.io/opd/user-guide/remote-actions) | バッテリーステータス取得    | ノートパソコンにインストールされているバッテリーの健康状態を、残り容量の観点から返します。 また、Windowsデバイスでは現在アクティブな電源プランも取得します。 交換するバッテリーを識別し、デバイスの電源設定を最適化するのに役立ちます。 |
|                                                                             | 保証情報取得          | Dell、HP、Lenovoデバイスの保証情報をREST API経由で取得します。 取得された保証データは、DellとLenovoデバイスのラップトップバッテリーに関連することもあります。                           |

## 設定 <a href="#configurationguide-batteryreplacementscheduling-configuration" id="configurationguide-batteryreplacementscheduling-configuration"></a>

### ステップ 1) ライブラリパックコンテンツをインストール <a href="#configurationguide-batteryreplacementscheduling-step1-installlibrarypackcontent" id="configurationguide-batteryreplacementscheduling-step1-installlibrarypackcontent"></a>

Nexthink Libraryにアクセスし、必要なすべてのコンテンツをインストールします。

### ステップ 2) ITSM APIコネクタの資格情報を設定 <a href="#configurationguide-batteryreplacementscheduling-step2-configureitsmapiconnectorcredentials" id="configurationguide-batteryreplacementscheduling-step2-configureitsmapiconnectorcredentials"></a>

APIコールを有効にするには、コネクタの資格情報の設定が不可欠です。 詳細情報は[こちら](https://nexthink.gitbook.io/opd/integrations/outbound-connectors/connector-credentials)をご覧ください。 各Service/API Thinkletには、資格情報を入力するためのドロップダウンフィールドがあります。 ワークフローをライブラリからインストールまたはコピーする際、このフィールドは空白になります。これは各環境のローカル設定であり、ライブラリに含まれていないためです。

<div data-full-width="true"><figure><img src="/files/4MGR3EhVJ5PMtRBYlxpA" alt="Connector credential.png" width="760"><figcaption></figcaption></figure></div>

<div data-full-width="true"><figure><img src="/files/E698EtTSJiwNyuLyLStn" alt="image-20240119-144723.png" width="760"><figcaption></figcaption></figure></div>

### ステップ 3) グローバルパラメーターを設定します <a href="#configurationguide-batteryreplacementscheduling-step3-configureglobalparameters" id="configurationguide-batteryreplacementscheduling-step3-configureglobalparameters"></a>

このワークフローには1つのグローバルパラメーターがあります。

* itsm\_sys\_id - ワークフローを実行する前に作成された単一のグローバルITSMチケットへの参照。

ワークフローを実行する前に、バッテリー交換のためのチケットをITSMに記録する必要があります。 その後、チケット参照（ServiceNowのsys\_id）をグローバルパラメーターとしてワークフローに追加することができます。 ワークフローが進行し、チケットを記録する必要がある場合、このグローバルチケットにデバイス名やバッテリーと保証の状態などの重要な詳細をコメントとして追加します。

### ステップ 4) リモートアクションを設定します <a href="#configurationguide-batteryreplacementscheduling-step4-configureremoteaction-s" id="configurationguide-batteryreplacementscheduling-step4-configureremoteaction-s"></a>

<table><thead><tr><th width="190">名前</th><th>トリガー</th><th>スケジュール クエリ</th><th>編集するパラメーター</th></tr></thead><tbody><tr><td>バッテリーステータスを取得</td><td>API トリガーはワークフローからトリガーできるように有効にする必要があります。</td><td><pre><code>devices
| where device.hardware.manufacturer in ["Dell", "HP", "Lenovo", "Apple"]
| where hardware.type == laptop
| list name, hardware.manufacturer
</code></pre></td><td>温度出力（摂氏／華氏）</td></tr><tr><td>保証ステータスを取得</td><td>ワークフローからトリガーできるように、API トリガーを有効にする必要があります</td><td><pre><code>devices
| where device.hardware.manufacturer in ["Dell", "HP", "Lenovo"]
| where hardware.type == laptop
| list name, hardware.manufacturer
</code></pre></td><td>REST API を使用して Dell および／または Lenovo デバイスの保証情報を取得するには、入力フィールドの一部を設定する必要があります。 詳細については、以下の表を参照してください。</td></tr></tbody></table>

#### **保証ステータス取得 - 入力パラメータ**

<table><thead><tr><th width="338">名前</th><th width="133">デフォルト値</th><th>説明</th></tr></thead><tbody><tr><td>最大遅延秒数</td><td>30</td><td>ベンダーのserverに過負荷をかけないように、同時に発生するAPIリクエスト数を制限するための最大遅延秒数</td></tr><tr><td>DellClientID</td><td>なし</td><td>DellクライアントID</td></tr><tr><td>DellClientSecret</td><td>なし</td><td>Dellクライアントシークレットトークン</td></tr><tr><td>DellDeviceWarrantyItemNumbers</td><td>[なし]</td><td>Dellのデバイス保証アイテム番号のリストから情報を取得します。 要素はカンマで区切る必要があります</td></tr><tr><td>DellBatteryWarrantyItemNumbers</td><td>[なし]</td><td>Dellのバッテリー保証アイテム番号のリストから情報を取得します。 要素はコンマで区切ってください</td></tr><tr><td>LenovoClientToken</td><td>なし</td><td>Lenovoクライアントトークン</td></tr><tr><td>LenovoDeviceWarrantyProductCodes</td><td>[なし]</td><td>Lenovoのデバイス保証プロダクトコードのリストから情報を取得します。 要素はカンマで区切る必要があります</td></tr><tr><td>LenovoBatteryWarrantyProductCodes</td><td>[なし]</td><td>Lenovoのバッテリー保証プロダクトコードのリストから情報を取得します。 要素はコンマで区切ってください</td></tr><tr><td>HPClientId</td><td>なし</td><td>HPクライアントID</td></tr><tr><td>HPClientSecret</td><td>[なし]</td><td>HPクライアントシークレットトークン</td></tr></tbody></table>

**詳細情報**

API応答で見つかった保証アイテム番号は、Dellの請求書に記載されているSKU番号として知られています。 購入した各モデルのデバイス保証に関連するサポートアイテムのSKUを選択してください。 バッテリーについても同様に行い、保証期間が短いことが多いです。 これらのSKU値は、DeviceWarrantyItemNumbers入力パラメータで使用する必要があります。

### ステップ 5) キャンペーンを設定 <a href="#configurationguide-batteryreplacementscheduling-step5-configurecampaign" id="configurationguide-batteryreplacementscheduling-step5-configurecampaign"></a>

このワークフローには、1つのEngage[キャンペーン](https://nexthink.gitbook.io/opd/user-guide/campaigns)「バッテリー交換アドバイザリー」が含まれています。 このキャンペーンの目的は、従業員に対してバッテリーが交換の必要があると識別されたことを知らせ、交換を注文するかどうかを確認することです。 これにより、従業員の特定の業務習慣により、バッテリーの不良による影響を受けない可能性があるため、プロセスに重要なステップが追加されます。

<div data-full-width="true"><figure><img src="/files/CKdAPJQRlJwCIMk9SvQq" alt="image-20231228-103646.png"><figcaption></figcaption></figure></div>

使用前に、このキャンペーンを企業のコミュニケーションガイドラインに合わせて修正する必要があります。 [キャンペーン管理](https://nexthink.gitbook.io/opd/user-guide/campaigns/managing-campaigns) 管理ページに移動して、キャンペーンを確認および編集します。

各インストールされたキャンペーンに対して、以下を確認してください:

* 送信者の名前と画像をカスタマイズする。
* 質問を確認および調整する。
* 使用準備が整ったらキャンペーンを公開する。

### ステップ 6) バッテリー交換基準を設定 <a href="#configurationguide-batteryreplacementscheduling-step6-configurebatteryreplacementcriteria" id="configurationguide-batteryreplacementscheduling-step6-configurebatteryreplacementcriteria"></a>

ワークフローは、Battery Health dashboardと同じロジックを使用して、交換が必要なバッテリーのあるデバイスを特定します。 必要に応じて、このロジックはワークフロー内で調整できます。 デフォルトでは、以下の条件を満たすデバイスがバッテリー交換の候補とされています:

* Windows
  * バッテリー健康度 < 60%
  * バッテリーサイクル回数 > 300
* macOS
  * バッテリー状態: サービス推奨

### ステップ 7) ワークフローをスケジュール <a href="#configurationguide-batteryreplacementscheduling-step7-scheduletheworkflow" id="configurationguide-batteryreplacementscheduling-step7-scheduletheworkflow"></a>

バッテリー交換スケジューリングワークフローはすべてのノートパソコンデバイスでトリガーできますが、DellおよびLenovoのWindowsデバイス、およびMacBookでの使用を念頭に設計されています。 ワークフローは、Battery Health dashboardと同じロジックを使用して、交換が必要なバッテリーのあるデバイスを特定します。 DellおよびLenovoデバイスの場合、デバイスやバッテリーがメーカーの保証に含まれているかどうかを確認します。 その後、ワークフローはユーザーと交渉し、バッテリーが交換の必要があることを通知し、グローバルITSMチケットの更新を承諾するためにバッテリーのパフォーマンスについてフィードバックを求めます。

**ワークフローのトリガー設定**

このワークフローは、主にスケジュールされたトリガーを使用して定期的に実行されるように設計されています。 ただし、必要に応じて単一または複数のデバイスでアドホックに手動でトリガーすることも可能です。[インベスティゲーション](https://nexthink.gitbook.io/opd/user-guide/investigations) を使用して、下の例は、ワークフローと完全に互換性のあるノートパソコンデバイスの定期チェックのために自動スケジュールがどのように構成されるかを示しています。

**NQL:**

<pre><code><strong>Code
</strong>1 devices
2 | where device.hardware.manufacturer in ["Dell", "HP", "Lenovo", "Apple"] 
3 | where hardware.type == laptop
4 | list name, hardware.manufacturer
</code></pre>

## **使用ガイド** <a href="#configurationguide-batteryreplacementscheduling-usageguide" id="configurationguide-batteryreplacementscheduling-usageguide"></a>

コンテンツは設定され、使用する準備が整いました。 使用概要および推奨事項については、使用ガイドを参照できます。

[使用ガイド: バッテリー交換スケジューリング](/platform/ja/library-packs/hardware-management/workflow_-battery-replacement-scheduling/usage-guide_-battery-replacement-scheduling.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/library-packs/hardware-management/workflow_-battery-replacement-scheduling/configuration-guide_-battery-replacement-scheduling.md?ask=<question>
```

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.