|
| WriteOutputStringList | \[string\[]] | stringと同じ |
## 自己支援シナリオで従業員と対話する
従業員が問題を自分で解決するのを助けるために、リモートアクションをキャンペーンと組み合わせます。 リモートアクションと組み合わせることで、従業員に問題の検出を通知し、その解決に導くことができます。
デバイスを使用している従業員のデスクトップにキャンペーンを表示するには：
* キャンペーンには**リモートアクション**トリガーがあり、公開されている必要があります。
* リモートアクションのスクリプトは次のいずれかで実行できます：
* 特別な権限を必要としない場合は、従業員のコンテキストで。
* 管理者権限を必要とする場合は、ローカルシステムアカウントのコンテキストで。
### キャンペーンのUIDを取得する
リモートアクションからキャンペーンを実行する方法には、キャンペーンのUIDを引数として渡す必要があります。
リモートアクションにキャンペーン識別子を渡すには、リモートアクションのスクリプト内で必要なキャンペーンごとにパラメータを宣言します。 リモートアクションを編集する際に、実際の値としてUIDをパラメータに使用します。
キャンペーンのUIDを取得し、リモートアクションにパラメータとして渡すには：
1. キャンペーンとリモートアクションを編集する権限を持つユーザーとしてFinderにログインします。
2. 左側のメニューの**キャンペーン**セクションで、リモートアクションから起動したいキャンペーンの名前を右クリックします。
3. **エクスポート > キャンペーンUidをクリップボードへ**を選択して、キャンペーンのUIDをコピーします。
4. 左側のメニューの**リモートアクション**セクションで、キャンペーンを実行するリモートアクションの名前をダブルクリックして編集します。 リモートアクションには、キャンペーンのUIDを格納するためのパラメータを宣言するスクリプトが含まれている必要があります。
5. スクリプトの下にある**パラメータ**セクションで、キャンペーンのUIDを保持するパラメータを選択します。
6. **Ctrl+V**を押してキャンペーンの実際のUIDを貼り付け、対応するパラメータに割り当てます。
### リモートアクションのスクリプトからキャンペーンを実行する
キャンペーンと対話するために、リモートアクションスクリプトは、Collectorと共に従業員デバイスにインストールされる.NETアセンブリ(`nxtcampaignaction.dll`)を読み込む必要があります。 アセンブリには、キャンペーンの実行を制御し、従業員からの応答を取得するためのメソッドを提供する**Nxt.CampaignAction**クラスが含まれています。
アセンブリを読み込むには、スクリプトの冒頭に以下の行を追加します：
`Add-Type -Path $env:NEXTHINK\RemoteActions\nxtcampaignaction.dll`
キャンペーンを制御するための**Nxt.CampaignAction**メソッドは次の通りです：
`NxTrayResp RunCampaign(string campaignUid)`
`campaignUid`で識別されるキャンペーンを実行し、従業員がキャンペーンの回答を終了するまで待ちます。 `campaignUid`引数にはUIDが含まれます。 応答を`NxTrayResp`型のオブジェクトで返します。
`NxTrayResp RunCampaign(string campaignUid, int timeout)`
`campaignUid`で識別されるキャンペーンを実行し、従業員がキャンペーンの回答を終了するか、指定された`timeout` (秒単位) 期間が経過するまで待ちます。 応答を`NxTrayResp`型のオブジェクトで返します。
`RunStandAloneCampaign(string campaignUid)`
`campaignUid`で識別されるキャンペーンを実行します。
`string GetResponseStatus(NxTrayResp response)`
`NxTrayResp`型の応答オブジェクトが与えられた場合、そのキャンペーンのステータスを反映する文字列を返します。 ステータスの可能な値：
* **fully**: 従業員がキャンペーンの質問に完全に回答しました。
* **declined**: 従業員がキャンペーンへの参加を拒否しました。
* **延期**: その従業員はキャンペーンへの参加に同意しました。
* **タイムアウト**: システムが従業員が回答を終える前にキャンペーンをタイムアウトしました。
* **接続失敗**: Collector コンポーネント間の通信に技術的なエラーがあったため、キャンペーン通知を制御する Collector コンポーネントへの接続がスクリプトでできませんでした。
* **通知失敗**: スクリプトがキャンペーンを成功裏に表示できなかった原因は以下の一つまたは複数です：
* キャンペーンが存在しないか、公開されていないため、プラットフォームからキャンペーン定義を取得できませんでした。
* 別のキャンペーンが既に従業員に表示されています。
* Collector のフォーカス保護または「邪魔しない」ルールのため、緊急でないキャンペーンを表示することができません。 詳細については、[キャンペーンの受信レートを制限する](/platform/ja/user-guide/campaigns/managing-campaigns/creating-campaigns/limiting-the-reception-rate-of-campaigns.md) ドキュメントをご参照ください。
`string[] GetResponseAnswer(NxTrayResp response, string questionLabel)`
`NxTrayResp` 型の応答オブジェクトとキャンペーン内の質問を識別するラベルを受け取ると、メソッドは従業員からの応答を返します。
* 単一回答の質問の場合、返される文字列配列は1つの要素だけを持ちます。
* 複数回答の質問の場合、返される文字列配列は、従業員が選択した回答の数だけ要素を持ちます。 任意の自由記述テキストは無視されます。
* 例えば、ステータスが「完全」ではない場合など、従業員がキャンペーンに完全に回答していない場合、返される文字列配列は空です。 任意の自由記述テキストは無視されます。
{% hint style="info" %}
セキュリティ上の理由から、自己援助シナリオのリモートアクションは、複数の回答や意見尺度質問の任意の自由記述答案を無視します。 したがって、自己援助シナリオでのみ使用されるキャンペーンには、任意の自由記述答案を含めることは無意味です。
{% endhint %}
### コード例
この例では、*yes* のような可能な回答がある単一回答キャンペーンを作成したと仮定します：
```
Add-Type -Path "$env:NEXTHINK\RemoteActions\nxtcampaignaction.dll"
$CampaignUid = ""
$maxWaitTimeinSeconds = 60
$result = [Nxt.CampaignAction]::RunCampaign($CampaignUid, $maxWaitTimeinSeconds)
$status = [Nxt.CampaignAction]::GetResponseStatus($result)
if ($status -eq "fully") {
$questionName = "question1"
$choiceName =[Nxt.CampaignAction]::GetResponseAnswer($result, $questionName)
if ($choiceName -eq "yes") {
# user has confirmed - let's do some actions:
Start-Process notepad.exe
}
}
```
## エラーハンドリング
Nexthink は、スクリプトを実行した PowerShell プロセスの戻り値に基づいて、リモートアクションの実行が成功したかどうかを検出します：
* 終了コードの値が0であることは、実行が成功したことを示します。
* 非ゼロの値はエラーを示します。
しかし、PowerShell の未処理例外は、適切な終了コードを返すことなくスクリプトを終了させる可能性があります。 予期しないエラーを処理するために、Nexthink は以下のコードスニペットで全てのスクリプトの本文を始めることを推奨します：
```
trap {
$host.ui.WriteErrorLine($_.ToString())
exit 1
}
```
あらゆる形式のパラメータ宣言の後に続く、必要なDLL依存関係のインクルージョンの下にこのデフォルトのエラーハンドラーを配置します。
## パフォーマンス測定
スクリプトのパフォーマンスとリソース消費を測定するために、[コレクター構成ツール](https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/deploying-nexthink-in-non-vdi-environment/installing-collector/windows-collector-references/collector-configuration-tool-for-windows.md)を使ってCollectorのログをデバッグモードでオンにします。
`nxtcfg.exe /s logmode=2`
出力は、[nxtcod.log ファイル](broken://pages/fVII4tnl1ROWw5bdzBfQ#componentsofcollector-additionalfiles)に保存されます。
{% hint style="info" %}
この記事で説明されている操作は、Nexthink エンジニアまたは Nexthink 認定パートナーによってのみ実行されるべきです。
必要に応じて、Nexthink 認定パートナーにお問い合わせください。
{% endhint %}
### パフォーマンス測定
スクリプトのパフォーマンスとリソース消費を測定するために、[コレクター構成ツール](https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/deploying-nexthink-in-non-vdi-environment/installing-collector/windows-collector-references/collector-configuration-tool-for-windows.md)を使ってCollectorのログをデバッグモードでオンにします。
`nxtcfg.exe /s logmode=2`
出力は、[nxtcod.log ファイル](broken://pages/fVII4tnl1ROWw5bdzBfQ#componentsofcollector-additionalfiles)に保存されます。
{% hint style="info" %}
この記事で説明されている操作は、Nexthink エンジニアまたは Nexthink 認定パートナーによってのみ実行されるべきです。
必要に応じて、Nexthink 認定パートナーにお問い合わせください。
{% endhint %}
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.nexthink.com/platform/ja/user-guide/remote-actions/remote-actions-in-finder-classic/writing-scripts-for-remote-actions-on-windows-for-finder-classic.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.