# カスタムフィールド管理
カスタムフィールドを使用すると、NQLデータモデルを拡張して追加のフィールドを加えることができます。 カスタムフィールドには3つの種類があります:
* **手動**カスタムフィールドは、外部システムからデータをインポートしてインベントリオブジェクトを豊かにし、レポート作成や分析に利用できます。 NexthinkのWebインターフェースでオブジェクトにタグを割り当てて、特定のキャンペーンユーザーをターゲットにしたり、変革管理のためにパイロットグループを作成できます。
* **計算**カスタムフィールドは、NQLクエリで定義された値を追跡し、頻繁に実行されるクエリにかかる時間を節約できます。 データモデルに計算を要素として追加することで、[チェックリスト](https://docs.nexthink.com/platform/ja/user-guide/administration/content-management/checklists-management)などさまざまな製品部分でその結果を使用しやすくなります。
* **ルールベースのカスタムフィールド** は、あらかじめ定義された基準に従ってオブジェクトを自動的に分類でき、これら基準は各々NQLクエリで表現されます。 関連性の高い軸に基づいてデータセットを分解し、調査で簡単に管理しアクセスできる頻繁に使用されるフィルターを設定できます。
カスタムフィールド名は`#`文字で始まり、NQLクエリ内で識別可能です。
{% hint style="info" %}
Nexthinkプラットフォームでは、各タイプに対するカスタムフィールドの数に制限があります:
最大100個の手動カスタムフィールド。
最大200個の計算カスタムフィールド。
最大200個のルールベースカスタムフィールド。
詳細については、[Nexthink Infinityの閾値と制限の概要](https://edocs.nexthink.com/ja/nexthink-infinity/infinity-specifications/nexthink-infinity-default-thresholds-overview)ドキュメントを参照してください。
{% endhint %}
***
### ライブラリからインストールされたカスタムフィールド
Nexthinkは、Nexthinkライブラリから手動でインストールできる一連の事前設定されたカスタムフィールドを提供しています。 Nexthinkインスタンス内のNexthinkライブラリモジュールに移動して、事前定義されたカスタムフィールドをインストール、管理、および更新します。
詳細については、[Nexthinkライブラリ](https://docs.nexthink.com/platform/ja/user-guide/nexthink-library) ドキュメントを参照してください。
### 新しいカスタムフィールド
最初からカスタムトレンドを作成することで、目的やユースケースに合わせてデータを表示できます。 このページの[新しいカスタムフィールドの作成](#customfieldsmanagement-creatinganewcustomfieldaddfield)セクションを参照してください。
***
## カスタムフィールドへのアクセス
* メインメニューから**管理**を選択します。
* **コンテンツ管理**セクションのナビゲーションパネルで**カスタムフィールド**をクリックします。
メニュー項目が表示されない場合は、役割に適切な[権限](#customfieldsmanagement-permissionspermissions)が付与されていることを確認してください。
***
## カスタムフィールドの管理
**カスタムフィールド管理**ページでは、すべてのカスタムフィールドがテーブル形式で一覧表示されます。
* 各カスタムフィールドにカーソルを合わせると、テーブル右側にアクションメニューが表示されます。 アクションメニューのオプションは以下の通りです:
* **編集**: カスタムフィールドを設定します。
* **タグを管理**: カスタムフィールドに[1つまたは複数のタグを追加](#customfieldsmanagement-creatinganewcustomfieldaddfield)します。
* **削除**: カスタムフィールドを削除します。
* **エクスポート**: カスタムフィールドをJSONファイル形式でエクスポートし、他のNexthinkクラウドインスタンスと共有します。
* **NQL IDをコピー**: NQLクエリを記述してカスタムフィールドから情報を取得するときにNQL IDを使用します。
* ページの右上隅には、さまざまなタスクを行うための3つのボタンがあります:
* **新しいカスタムフィールド**ボタンをクリックして、カスタムフィールドを追加および設定します。 詳細については、[新しいカスタムフィールドの作成](#customfieldsmanagement-creatinganewcustomfieldaddfield)セクションを参照してください。
* **インポート**ボタンをクリックして、カスタムフィールドをJSONファイル形式でインポートします。
* ページの右上隅にあるアクションメニューをクリックし、**値を更新**を選択します。 詳細については、[CSVファイルのインポートによるカスタムフィールドの更新](#customfieldsmanagement-updatingcustomfieldsbyimportingacsvfileimportcsv)セクションを参照してください。
### カスタムフィールドにタグを追加
カスタムフィールドの検索とインデックス化を容易にするために、タグを作成または再利用できます。 任意のカスタムフィールドのアクションメニューから:
* **タグを管理**を選択します。
* 新しいタグまたは既存のタグの名前を入力します。 コンテキストメニューには、一致するタグのリストが表示されます。 一致するものがない場合は、システムが新しいタグを作成します。
* オプションで、タグの追加または特定の色の追加を行います。
* タグを**保存**します。
ダッシュボードの最右側にある**タグ**メニューを使用して、名前を入力するか、現在カスタムフィールドに割り当てられているすべてのタグのリストからクリックしてタグを検索できます。
***
## 新しいフィールドの作成
**新しいカスタムフィールド**ボタンをクリックして、カスタムフィールドを追加および設定します。 これにより、**ドラフト**ページが開きます。
以下の表に従って、**一般**の下のフィールドに入力します。
| フィールド | 説明 |
| -------------- | -------------------------------------------------------------------------------------------------------------- |
| **名前** | 調査のページで表示される名前です。 |
| **NQL ID** | システムはクエリ内でカスタムフィールドを参照するためにNQL IDを使用します。 Nexthinkはカスタムフィールド名に基づいてNQL IDを提案します。 カスタムフィールドを保存した後、NQL IDは編集できません。 |
| **説明 (オプション)** | カスタムフィールドの意味を他のユーザーに理解してもらうために、オプションでテキストを入力します。 |
カスタムフィールドの**タイプ**を選択します。 3つのオプションがあります:
* [手動タイプ](#customfieldsmanagement-choosingmanualcustomfieldtypemanual)と**オブジェクト**
* **NQLクエリ**を使用した[計算タイプ](#customfieldsmanagement-choosingcomputedcustomfieldtypecomputed)
* [ルールベースのタイプ](#customfieldsmanagement-choosingrule-basedcustomfieldtyperuledbased)と**オブジェクト**および**ルール**
### 手動カスタムフィールドタイプを選択する
* **タイプ**で**手動**を選択します。
* **オブジェクト** ドロップダウンメニューから、カスタムフィールドを適用するオブジェクトを選択します: **デバイス**、**ユーザー**、**バイナリ**、または **パッケージ**。
[手動カスタムフィールドの値の設定](#customfieldsmanagement-settingvaluesformanualcustomfieldssetvalues)セクションを参照してください。
### 計算カスタムフィールドタイプを選択する
* **タイプ**で**計算**を選択します。
* 各行に `devices` の計算結果が表示される単一列のテーブルを返す **NQL クエリー** を作成します。
以下の例を参考にして、**CPU待ち行列の長さ (24h)** カスタムフィールドを確認してください。
上記の**計算タイプ**例のフィールド入力は次のとおりです:
| フィールド | 入力 (例) |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **名前** | CPU待ち行列の長さ (24h) |
| **NQL ID** | #cpu\_queue\_length\_1hr
上記の例では、ユーザーがカスタムフィールド名を24時間のタイムフレームに更新した場合でも、NQL ID は最初の1時間のタイムフレームを反映しています。
NQL ID はカスタムフィールドを保存後に編集できませんので注意してください。
|
| **説明 (オプション)** | 過去24時間の平均待ち行列の長さを表示します。待ち行列の長さが長いほど、CPU のパフォーマンスは低下します。 CPUの待ち行列の長さは、最適なパフォーマンスを得るために、利用可能な論理プロセッサの数の1.5倍未満であるべきです。 |
| **NQL クエリー** | クエリーコードを以下に示します。 |
{% code lineNumbers="true" %}
```
devices
| include device_performance.events past 24h
| compute c1 = (cpu_queue_length.avg() / number_of_logical_processors.avg())
| list c1
```
{% endcode %}
#### **計算カスタムフィールドのためのNQLクエリーを書くためのガイドライン**
* クエリーは `devices` コレクションを対象とする必要があります。
* クエリーには `include`句が正確に1つ必要です。
* システムでは、`include`句の後にのみ `where`句が許可されます。
* クエリーには `compute` 句が正確に1つ必要です。
* クエリーは `list` 句と単一の数字の計算済みフィールドで終わる。
* システムでは `sort`、`limit`、`summarize` または `with`句は許可されていません。
* クエリーが保存された後は異なるデータ型を返すように変更することはできません。
### ルールベースのカスタムフィールドタイプの選択
* **タイプ**で**ルールベース**を選択して、オブジェクトを事前定義された基準に従ってソートします。
* **オブジェクト** ドロップダウンメニューから、システムがカスタムフィールドを適用するオブジェクトを選択します: **デバイス**、**ユーザー**、**バイナリ**、または **パッケージ**。
ルールベースのカスタムフィールドの一般的な使用例には次のようなものがあります:
* ハードウェアの仕様に基づいてデバイスモデルをプレミアム、メインストリーム、または低価格として分類します。
* インストールされたメモリに基づいてデバイスを分類します。
* 名前やメールパターンに基づいてユーザーを内部または外部として分類します。
* 業務の継続性のための重要性でパッケージとバイナリを分類します。
* コンプライアンスのためのパッケージやバイナリのブロックリストを定義します。
{% hint style="info" %}
ルールベースのカスタムフィールドには最大20のルールを含めることができます。
{% endhint %}
{% hint style="info" %}
ルールベースのカスタムフィールドをドラッグアンドドロップして順序を変更できます。 システムは上から下へルールを評価します。
{% endhint %}
それぞれのルールは次の属性を持ちます:
| ルール属性 | 説明 |
| ----------- | ------------------------------------------------------------------------------ |
| **値** | ルールを満たすすべてのオブジェクトに付与されるラベル。 |
| **格付け** | ルールに付けられる評価: **Poor**, **Average** または **Good** 。 デフォルトでは、 **None** に設定されています。 |
| **NQLクエリー** | ルールの評価時に実行されるクエリ。 |
{% hint style="info" %}
ルールベースのカスタムフィールドの値を並べ替える際、アルファベット順や設定ページ上のルールの順序とは一致しません。 むしろ、最初に保存された順序に従います。
{% endhint %}
ルールベースのカスタムフィールドのNQLクエリーについて次の制約を考慮してください:
* クエリーは、カスタムフィールドが定義されたオブジェクトを対象とする必要があります。 たとえば、`devices` はデバイスのカスタムフィールドです。
* クエリーには少なくとも1つの `where`句が必要です。
* `with`、`include`、`summarize`、`compute`、および `list`句は許可されていません。
* `during past`、`from`、および `to` などの時間選択は許可されていません。
* クエリーはネイティブオブジェクトのプロパティのみを参照することができます。
#### インストールされたメモリプロファイルのルールベースの例
このセクションでは、インストールされたメモリに基づいてデバイスを分類するルールベースのカスタムフィールドの例を表示します。 これらはフィールド入力とルールです:
* **名前**: メモリプロファイル
* **NQL ID:** `#memory_profile`
* **説明:** インストールされたメモリに基づいてデバイスを分類します。
* **オブジェクト:** デバイス
\| **ルール1** |
* 値: Installed\_memory\_0\_to\_8\_GB
* 評価: Poor
* NQLクエリー: `devices | where hardware.memory <= 8GB`
\| | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | **ルール2** |
* 値: Installed\_memory\_8\_to\_16\_GB
* 評価: Average
* NQLクエリー: `devices | where hardware.memory <= 16GB`
\| | **ルール3** |
* 値: Installed\_memory\_16\_to\_32\_GB
* 評価: Good
* NQLクエリー: `devices | where hardware.memory <= 32GB`
\| | **ルール4** |
* 値: Installed\_memory\_over\_32\_GB
* 評価: Good
* NQLクエリー: `devices | where hardware.memory > 32GB`
|
上記のルールを考慮すると、システムは16GBのインストール済みメモリを持つデバイスに `Installed\_memory\_8\_to\_16\_GB` タグを付けます。これはNQLクエリーの条件を最初に満たしたルール2です。
**インベスティゲーション**ページから、ルールベースのカスタムフィールドを使用して[NQLクエリー](https://docs.nexthink.com/platform/ja/user-guide/investigations/creating-investigations/nql-editor)を実行することで、調査を実施できます。
次のクエリーは、デバイスのメモリプロファイルに応じて、デバイスごとの実行クラッシュ数を返します：
{% code lineNumbers="true" %}
```
execution.crashes during past 30d
| summarize crash_ratio = count()/device.count() by device.#memory_profile
```
{% endcode %}
結果をメモリで分解せずに、ルールで設定された格付け: **poor**、**average**、**good** で分解することもできます。
この場合、Nexthink は **Installed\_memory\_16\_to\_32\_GB** および **Installed\_memory\_over\_32\_GB** を持つデバイスを **good** と評価します。
{% code lineNumbers="true" %}
```
execution.crashes during past 30d
| summarize crash_ratio = count()/device.count() by device.#memory_profile.rating
```
{% endcode %}
***
## 手動カスタムフィールドの値を設定する
カスタムフィールドを作成した後、その値を次の方法で設定できます：
* インベスティゲーションページ上の[編集](#customfieldsmanagement-editingcustomfieldsontheinvestigationspageeditcf)オプション。
* 手動カスタムフィールドを編集する権限は、[View domain](https://github.com/nexthink/documentation.online-product-documentation/blob/develop/ja_docs/user-guide/administration/account-management/roles/view-domain.md#administration)への**限定アクセス**だけで十分です。
* カスタムフィールド管理ページのアクション メニューから[値の更新](#customfieldsmanagement-updatingcustomfieldsbyimportingacsvfileimportcsv)を行います。
* **Enrichment API**については、[Nexthink APIドキュメンテーション](https://developer.nexthink.com/)を参照してください。
* Nexthink[ワークフローの実行](https://docs.nexthink.com/platform/ja/workflows/creating-workflows#updating-custom-fields-in-workflows-for-downstream-use)内の**カスタムフィールドの更新** 思考ユニットを使用して、値を更新します。
次の要件は、値を設定するために選択したオプションに依存せずに適用されます：
* UTF-8文字はバック スラッシュ`\`と二重引用符`"`を除いてサポートされます。
* フィールドの値は1つにつき最大64文字まで許可されています。
### インベスティゲーションページ上のカスタムフィールドの編集
次の方法で、インベスティゲーションページでカスタムフィールドを編集できます：
* アクションメニュー。
* アクションバー。
* 結果をエクスポートするオプション (一括編集)。
#### **アクションメニューでのカスタムフィールドの編集**
**インベスティゲーション** ページから：
* NQL結果テーブルのカスタムフィールドに対するアクションメニューから**編集**を選択します。
* **カスタムフィールドを編集** モーダルで、**新しい値**フィールドに値を入力します。
* 変更を保存するには**完了**をクリックします。
#### **アクションバーでのカスタムフィールドの編集**
**インベスティゲーション** ページから：
1. ページ下部のアクションバーにある**編集**オプションを選択して、編集したいオブジェクトタイプ、例えば`devices`のNQLクエリ結果を確認します。
{% hint style="info" %}
**編集**オプションが表示されない場合は、[役割](https://github.com/nexthink/documentation.online-product-documentation/blob/develop/ja_docs/configuring_nexthink/configuring-your-platform/administration/account-management/roles/README.md)が正しい権限を持っていることを確認してください。
{% endhint %}
2. **カスタムフィールドを編集**モーダルにて。
* **カスタムフィールド**ドロップダウンメニューからカスタムフィールドを選択します。
* **新しい値**テキストフィールドに新しい値を入力します。
* 変更を保存するには、**完了**をクリックします。
{% hint style="info" %}
アクションバーでは、ページで完全に読み込まれて表示されていない大量の調査結果の一括編集はできません。
{% endhint %}
#### **結果をエクスポートしてカスタムフィールドを一括編集**
**インベスティゲーション**ページから：
* IDフィールドおよび編集するカスタムフィールドで調査を実施します。
* 結果をCSVファイルとして**エクスポート**します。
* スプレッドシートエディタを使用してカスタムフィールドの値を編集します。
* 編集したCSVファイルを[インポート](#customfieldsmanagement-updatingcustomfieldsbyimportingacsvfileimportcsv)します。
このページの[CSV ファイルの例](#example-of-a-csv-file-for-updating-custom-fields)は、ファイルの表形式の構成を説明しています。 さらに、以下の画像は調査ページから**結果をエクスポート**する方法を示しています。
### CSVファイルのインポートによるカスタムフィールドの更新
{% hint style="info" %}
Nexthinkの[ワークフローの実行](https://docs.nexthink.com/platform/ja/workflows/creating-workflows#updating-custom-fields-in-workflows-for-downstream-use)内の**カスタムフィールドの更新**思考ユニットを使用して、手動カスタムフィールドの値を更新することもできます。
{% endhint %}
[カスタムフィールド](#customfieldsmanagement-accessingcustomfieldsaccesscs)ページから：
* ページの右上隅にあるアクションメニューをクリックします。
* 複数のカスタムフィールドを一度にNexthinkのWebインターフェースにインポートするには、**値を更新**を選択します。
* **値を更新**ダイアログボックスで、有効なCSVファイルを選択して、次の条件を満たしていることを確認します：
* ファイルサイズは5MB未満です。
* ファイルエンコードはUTF-8です（UTF-8-BOMはサポートされません）。
* バックスラッシュ`\`はサポートされていません。
* カンマはフィールドの区切り文字です。
* フィールド区切り文字はオプションであり、引用符`"`のみが許可されている区切り文字の型です。
#### **カスタムフィールドを更新するためのCSVファイルの例**
* データをインポートするために、タブ形式の構造を持つCSVファイルを構成します。
* ```
device.name,device.#custom_field1,device.#custom_field2
device-1,A1,B
device-2,A1,B
device-3,A2,B
device-4,A2,
```
* 最初のカスタムフィールド用に、CSVファイルに記載されているすべてのデバイスに`A1`または`A2`の値が割り当てられます。
* 2つ目のカスタムフィールドには、最初の3つのデバイスに`B`が割り当てられます。
* `device-4`の`#custom_field2`の値は設定されていません。 事前に設定されている場合、このCSVファイルは`#custom_field2`の値を`NULL`に更新します。
* 次のフォーマットルールに従います：
* ヘッダーは明示的なオブジェクトタイプを伴うNQL ID形式です。例：`device.name`および`device.#custom_field1`。
* ファイルには少なくとも1つのID列があります。 これらのIDが受け入れられます：
* デバイス: `device.uid`, `device.name`
* ユーザー: `user.uid`, `user.sid`, `user.upn`
* バイナリ: `binary.uid`
* パッケージ: `package.uid`
{% hint style="info" %}
`user.upn: UPN`コレクションがコレクタレベルでクリアテキストとして有効になっている場合、ユーザー更新の前提条件です。 これは以下のライブラリーコンテンツで実現できます：
{% endhint %}
## 権限
カスタムフィールドの適切な権限を有効にするには：
* メインメニューから**管理**を選択します。
* ナビゲーションパネルから**役割**をクリックします。
* ページの右上隅にある**新しい役割**ボタンをクリックして、新しい役割を作成します。
* または、既存の役割を編集するには、上にマウスを持っていき、編集アイコンをクリックして役割設定を変更します。
* **権限**セクションで下にスクロールし、**管理**を有効にして**全てのカスタムフィールドを管理**をクリックします。 これにより、ユーザーがカスタムフィールドを作成、編集、削除し、手動カスタムフィールドの値を設定できるようになります。 この権限は**フルビュードメイン**を持つユーザーにのみ利用可能です。
* **全てのカスタムフィールドを管理**権限を持つユーザーには、自動的に**全ての評価を管理する**権限が与えられます（ルールベースのカスタムフィールドを設定するためのユーザー権利が付与されます）。
* それ以外の場合、**手動カスタムフィールドの編集**権限は**限定ビュー ドメイン**を持つユーザーに付与できます。
* この権限は**全てのカスタムフィールドを管理**権限を持つユーザーにも自動的に付与されます。
{% hint style="info" %}
権限オプションの詳細な説明については、[役割](https://github.com/nexthink/documentation.online-product-documentation/blob/develop/ja_docs/configuring_nexthink/configuring-your-platform/administration/account-management/roles/README.md)のドキュメントを参照してください。
{% endhint %}
---
# 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/administration/content-management/custom-fields-management.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.