> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-customization.md).

# Runbook のカスタマイズ

RealmJoin の汎用 Runbook を環境のニーズに合わせて調整します。

## 概要

RealmJoin の runbook 実装は、runbook の作成者や環境の管理者にカスタマイズ機能を提供し、次のことができるようにします：

* 顧客/Tenant 固有のパラメーターとテンプレートを保持する
* ユーザー選択やドロップダウン選択などの UI 要素を提供する
* パラメーターの人間が読める説明を表示する
* 不要な UI 要素を非表示にする

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FmVmZrDFgG1ShkZlo1Fbe%2Fimage.png?alt=media&amp;token=39876732-3578-41d2-acf1-8571bb941e68" alt=""><figcaption></figcaption></figure>

カスタマイズは runbook 自体に含めることも、顧客の RealmJoin Portal インスタンスに保存することもできます。既定では、on で提供される runbook に妥当な既定値を提供しようとします [GitHub](https://github.com/realmjoin/realmjoin-runbooks).

一部の runbook には、ユーザーのオンボーディングにおける Office の所在地の指定のような、顧客固有のテンプレートを構成する方法の例が含まれます。

### 書式設定

カスタマイズは（優先度の高い順に）定義できます

* JSON のブロック [RealmJoin Portal の設定](https://portal.realmjoin.com/settings/runbooks-customizations)、既定の runbook の動作を上書きします
* runbook のヘッダー内の JSON ブロック

さらに（最も優先度が低く）

* runbook ヘッダー内の各パラメーターごとに
* runbook の param ブロック内の各パラメーターごとに（RJRb Helper Module を使用）

一部の機能（テンプレートなど）は JSON 形式でのみ利用できます。一部の機能（ユーザー ピッカーの作成など）は、param ブロックでデータ型を指定した場合にのみ利用できます。最良の結果を得るには、複数の種類のカスタマイズを組み合わせることができます。

## Runbook の Param ブロック

RealmJoin Portal は、runbook の PowerShell param ブロックを解析して、どの入力フィールドを表示するかを判断します。可能な場合は、変数に指定された .NET 型に従って入力の妥当性も検証します。

現在認識されるデータ型は次のとおりです：

* `[bool]`, `[boolean]` - 二値トグルを表示します
* `[string]` - 任意の英数字入力を入力できるテキストボックスを表示します
* `[int]` - 数値入力のみを許可するテキストボックスを表示します
* `[DateTime]`, `[DateTimeOffset]` - 日付/時刻ピッカーを表示します

パラメーターには標準の PowerShell 修飾子を適用できます。RealmJoin Portal は、特に次を指定すると理解します `[Parameter(Mandatory = $true)]` 必須パラメーターであることを示し、これらのパラメーターが入力されるように強制します。

可能な場合は、RealmJoin Portal は UI に既定値も読み込んで表示します。

注意してください。runbook の既定値はカスタマイズによって上書きされる場合があります。さらに、パラメーターはカスタマイズによって完全に非表示にすることもできます。

### パラメーターのカスタマイズ

パラメーターをカスタマイズできるようにするには、runbook に RealmJoin の Runbook Helper PS Module を含めてください：

`#Requires -Modules @{ModuleName = "RealmJoin.RunbookHelper"; ModuleVersion = "0.6.0" }`

その後、 `[ValidateScript( { Use-RJInterface ... } )]` という文をパラメーター定義に含めることができます。たとえば次の例では、Entra ID ユーザーを選択でき、そのオブジェクト ID が文字列として runbook に渡されるユーザー ピッカーが作成されます。

```powershell
param(
    [ValidateScript( { Use-RJInterface -DisplayName "このユーザーにデバイスを割り当てる（任意）" -Type Graph -Entity User } )]
    [string] $AssignedUserId = ""
)
```

これを一つずつ見ていきましょう。 `[ValidateScript...]` は、param ブロックで定義された次のパラメーターに対する修飾子です。この場合、変数 `$AssignedUserId`.

`Use-RJInterface` は、私たちの [RealmJoin Runbook Helper](https://github.com/realmjoin/RealmJoin.RunbookHelper) PowerShell Module の一部です。これにより、次を使用して、想定する入力の種類を指定できます `-Type` と `-Entity`。これは、変数の型で完全には定義されていない場合に使います。

`-DisplayName` これにより、このパラメーターに対する人間にわかりやすいプロンプト / 説明を RealmJoin Portal に渡せます。

#### Graph リソース

上の例では、情報源は MS Graph であり、次のように説明されています `-Type Graph`。MS Graph では、 `-Entity` を使用して、どの種類のリソースを想定しているかを指定します。利用可能なエンティティは `User`, `グループ`, `デバイス`です。これにより、指定した Entra ID 内のユーザー、グループ、またはデバイス用のピッカーが作成されます。

ピッカーにはクイック検索が含まれており、必要なリソースを簡単に絞り込めます。

![ピッカーの例](https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-0c393c4ea73a77b34da2c678b0712a6556ed3bc2%2Frunbook-customization-img2.png?alt=media)

現在、ピッカーを使った複数選択はできません。

既定では、MS Graph のピッカーはオブジェクトの ID を返します。たとえば user principal name を返したい場合は、変数名の末尾に "name" を付けるようにしてください。つまり、ユーザーの ID を取得したいなら、パラメーター名を `$userid`とします。UPN が欲しい場合は、次のように名前を付けます `$username`.

#### Graph フィルタリング

MS Graph ベースのピッカーを使用している場合は、次も指定できます `-Filter` を使って [ODATA-Filter](https://docs.microsoft.com/en-us/graph/query-parameters?context=graph%2Fapi%2F1.0\&view=graph-rest-1.0#filter-parameter) を適用し、ピッカーで提供されるオブジェクトを制限できます。

次の例では、Entra ID で "LIC\_" で始まるグループのみを一覧表示します。

```powershell
param(
    [Parameter(Mandatory = $true)]
    [ValidateScript( { Use-RJInterface -Type Graph -Entity Group -Filter "startswith(DisplayName, 'LIC_')" -DisplayName "ライセンス グループ" } )]
    [String] $GroupID_License
)
```

フィルターを準備し、 [中央データストア](#graph-filters)を使って複数のスクリプト間で再利用できます。この場合は、次を使って名前でフィルターを参照するだけです `-Filter "ref:LicenseGroup"`。ここで `ref:` は、保存されたフィルターを探すことを示します。

```powershell
param(
    [Parameter(Mandatory = $true)]
    [ValidateScript( { Use-RJInterface -Type Graph -Entity Group -Filter "ref:LicenseGroup" } )]
    [String] $GroupID_License
)
```

この特定の例では `ref:LicenseGroup` は、追加設定なしで既定で利用できます。

![ODATA フィルター](https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-4913ddfbc3324fc7a3522de2bc6887e8d2745e35%2Frunbook-customization-img3.png?alt=media)

## Runbook ヘッダー

Portal は runbook の [コメントベースのヘルプ](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_comment_based_help?view=powershell-5.1) セクションを、存在する場合は解析できます。

例を示します：

```powershell
<#
  .SYNOPSIS
  グループ メンバーシップを通じて、ユーザーにライセンスを（割り当て/解除）します。

  .DESCRIPTION
  グループ メンバーシップを通じて、ユーザーにライセンスを（割り当て/解除）します。より詳細な説明...

  .PARAMETER DefaultGroups
  割り当てるグループのカンマ区切りリスト。例: "DL Sales,LIC Internal Product"

  .NOTES
  権限:
  MS Graph (API):
  - User.Read.All
  - GroupMember.ReadWrite.All 
  - Group.ReadWrite.All

  .INPUTS
  RunbookCustomization: {
        "Parameters": {
            "UserName": {
                "Hide": true
            },
            "Remove": {
                "DisplayName": "ライセンスを割り当てるまたは削除する",
                "SelectSimple": {
                    "ユーザーにライセンスを割り当てる": false,
                    "ユーザーからライセンスを削除する": true
                }
            }
        }
    }
#>
```

`.SYNOPSIS` - runbook の機能について、非常に簡潔に説明してください。これは利用可能な runbook の一覧に表示されます。

`.DESCRIPTION` - runbook の機能について説明してください。少し詳しく書いても構いません。これは runbook の実行 / パラメーター ダイアログ内に表示されます。

`.PARAMETER` - パラメーター名を後ろに続ける必要があります。対象のパラメーターに期待される入力について、詳しい説明を与えることができます。

`.INPUTS` - JSON ベースの Runbook Customization のブロックを含めることができます。

`.NOTES` - 解析 / レンダリングされません。runbook に存在する権限と要件を書き留めるためにこのスペースを使ってください。

`.EXAMPLE` - 解析 / レンダリングされません。Tenant 内の RealmJoin Datastore で使用する JSON ベースのカスタマイズ例を含めることができます。これらは、たとえば異なるワークフローやユーザー クラス向けのテンプレートを作成する方法の例にできます。

## JSON Based Customizing

### 中央データストア

各 Azure Tenant は、「Runbook Customizations」データストアをホストでき、場所は次です <https://portal.realmjoin.com/settings/runbooks-customizations> .

形式はコメント付き JSON で、末尾のカンマも許可されます。現在、関連するセクションは 3 つあります、 `Settings`, `テンプレート`, `Runbooks`.

```json
{
    "Settings": {
    },
    "Templates": {
    },
    "Runbooks": {
    }
}
```

### Runbooks セクション

`Runbooks` runbook を開始するときに Portal により解析されます。現在の Azure Automation Runbook と同じ名前のセクションが存在する場合、その内容がユーザーに表示されるフロントエンドのカスタマイズに使用されます。

次の単純なデモ runbook があるとします。名前は `rjgit-device_demo-runbook-customizing`.

```powershell
<#
  .SYNOPSIS
  runbook カスタマイズをデモする

  .DESCRIPTION
  runbook カスタマイズをデモする、ドロップダウン/選択など
#>

#Requires -Modules @{ModuleName = "RealmJoin.RunbookHelper"; ModuleVersion = "0.6.0" }

param(
    [string] $DeviceId,
    [bool] $ExtraWorkflow = $true,
    [int] $ExtraWorkflowTime = 15
)

"## '$DeviceID' に対して処理を実行中"

# 非常に任意性の高い複雑なワークフロー
if ($ExtraWorkflow) {
    "## 瞑想を実行中..."
    Start-Sleep -Seconds $ExtraWorkflowTime
}
```

カスタマイズされていない場合、フロントエンドでは次のように表示されます：

![デモ - 変更前](https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-931b958f4b949268736f6ff3f174913cf56adcf7%2Frunbook-customization-img4.png?alt=media)

考え：

* この runbook は portal でデバイスのコンテキストから開始されるため、 `$DeviceId` はユーザーにとって冗長な情報です。私はすでに、どのデバイスを作業対象にしているかを知っています。
* 「Extra Workflow」を有効/無効にするとどうなりますか？「Extra Workflow」を無効にした場合、「Extra Workflow Time」について考える必要はありますか？

それを改善しましょう。中央データストアにある次の JSON の例が、runbook の UI を変更します。

```json
{
    "Runbooks": {
        "rjgit-device_demo-runbook-customizing": {
            "ParameterList": [
                {
                    "Name": "DeviceId",
                    "Hide": true
                }, 
                {
                    "Name": "ExtraWorkflow",
                    "Hide": true
                },
                {
                    "Name": "ExtraWorkflowTime",
                    "DisplayName": "どれくらい瞑想しますか？",
                },
                {
                    "DisplayName": "追加ワークフローを実行",
                    "DisplayBefore": "ExtraWorkflowTime",
                    "Select": {
                        "Options": [
                            {
                                "Display": "瞑想を実行（任意）",
                                "Customization": {
                                    "Default": {
                                        "ExtraWorkflow": true
                                    }
                                }
                            },
                            {
                                "Display": "デバイスのマインドフルネスをスキップ",
                                "Customization": {
                                    "Default": {
                                        "ExtraWorkflow": false
                                    },
                                    "Hide": [
                                        "ExtraWorkflowTime"
                                    ]
                                }
                            }
                        ],
                        
                    },
                    "Default": "デバイスのマインドフルネスをスキップ"
                }
            ]
        }
    }
}
```

あなたの [runbook ヘッダー](#runbook-header).

#### ParameterList

各パラメーターには、ParameterList 内に独自のセクションがあります `ParameterList`. [修飾子](#modifiers) は、そのパラメーターの動作を変更できます。

結果は次のようになります：

![デモ - 非表示後](https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-4ae4e681371ad29f076063c5f1925a0cb8113872%2Frunbook-customization-img5.png?alt=media)

追加ワークフローを選ぶと、さらに多くのパラメーターが表示されます（非表示が解除されます）：

![デモ - 非表示解除後](https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-7960cf8309d8bbdf12ab1539c073714211715411%2Frunbook-customization-img6.png?alt=media)

これは、カスタマイズ適用前と比べて表示がすっきりします。同時に、「Extra Workflow」の代替案に関するより多くの情報がユーザーに提供されます。また、ユーザーは「Extra Workflow Time」が関連するときだけ気にすればよくなります。

そのフィールドの表示/非表示の変更は、次のものを使って行われました `カスタマイズ` のブロックを、次のいずれかの `選択` オプション内に配置します。現在、有効にできるそのような `カスタマイズ` ブロックは同時に 1 つだけです。

ご覧のとおり、パラメーター `$DeviceId` は完全に非表示です。これは次を設定することで実現されます `"Hide": true` このパラメーターについて。

パラメーターには `DisplayName`人間にわかりやすい `DisplayName` を置き換えるための `$ExtraWorkflowTime` を UI で表示します。ほかの [修飾子](#modifiers) 詳細は

「名前なし」のパラメーター（次を欠くもの）を挿入できます `名前` ステートメント）を、「Execute Extra Workflow」セクションのように、値を直接返さずに UI 要素を提供したい場合に使えます。これは通常、次と組み合わせてのみ使用されます `次を選択`.

#### 次を選択

ここでは次を使用しました `次を選択`、一覧を表示するために `オプション` をドロップダウンに。各オプションは `表示` テキストを表示したり、次をトリガーしたりできます `カスタマイズ`。たとえば次の設定です `Hide` または `既定値` 他のパラメーターの値。今回の例では、これを使って次を（非）表示にしました `$ExtraWorkflowTime` および上書きしました `$ExtraWorkflow`の値。

`$ExtraWorkflowTime` したがって、それは関連があるときだけ表示され、二値スイッチは `$ExtraWorkflow` ユーザーの視点では意味のある選択肢に置き換えられます。

次の場合 `次を選択` （名前付きパラメーターの場合）、各オプションには `"ParameterValue": "..."` を runbook に渡す必要があります。次を配置できます `"ShowValue: false"` の中に `次を選択` ブロックを入れると、ドロップダウンだけを表示し、結果のパラメーター値のフィールドは表示しません。

名前付きパラメーターの例：

```json
{
    "Name": "ExtraWorkflow",
    "DefaultValue": true,
    "DisplayName": "追加ワークフローを実行",
    "DisplayBefore": "ExtraWorkflowTime",
    "Select": {
        "Options": [
            {
                "Display": "瞑想を実行（任意）",
                "ParameterValue": true
            },
            {
                "Display": "デバイスのマインドフルネスをスキップ",
                "ParameterValue": false,
                "Customization": {
                    "Hide": [
                        "ExtraWorkflowTime"
                    ]
                }
            }
        ],
        "ShowValue": false
    }
}
```

次の `既定値` / `DefaultValue` というパラメーター内のステートメントは、ドロップダウンの初期状態も指定します。名前なしのパラメーターの場合は、目的のオプションの `DisplayName` 値を使用し、それ以外の場合は、"true"、"false"、または任意の文字列などの既定の戻り値を指定します。

#### パラメーター

名前付きパラメーターしかない場合は、少し短い `パラメーター` 形式を次の代わりに使用できます `ParameterList`.

例として SelectSimple を参照してください

#### SelectSimple

カスタマイズの完全な機能が不要で、 `次を選択` ドロップダウンで候補値の一覧だけを提供したい（追加のカスタマイズを適用しない）場合は、次を使用できます `SelectSimple`.

`SelectSimple` は、名前付きパラメーターでのみ使用できます。

例:

```json
{
    "Runbooks": {
        "rjgit-device_demo-runbook-customizing": {
            "Parameters": {
                "DeviceId": {
                    "Hide": true
                }, 
                "ExtraWorkflow": {
                    "Name": "ExtraWorkflow",
                    "DisplayName": "追加ワークフローを実行",
                    "Default": false,
                    "SelectSimple": {
                        "瞑想を実行（任意）": true,
                        "デバイスのマインドフルネスをスキップ": false
                    }
                },
                "ExtraWorkflowTime": {
                    "DisplayName": "どれくらい瞑想しますか？"
                }
            }
        }
    }
}
```

前の例と比べた最大の違い（短くなったこと以外）は、 `$ExtraWorkflowTime` 常に表示されることです。

#### 修飾子

各パラメーターには、次の修飾子を 1 つ以上指定できます：

* `"DisplayName": "text"` - UI でそのパラメーター名として "text" を表示する
* `"Hide": true / false` - このパラメーターを非表示にする
* `"Mandatory": true / false` - このパラメーターの入力を必須にする
* `"ReadOnly": true / false` - このパラメーターが既定値から変更されないように保護する
* `"DefaultValue": "..."` - このパラメーターの既定値を設定する。（代わりに `既定値` DefaultValue を使うこともできます。）
* `"GraphFilter": "startswith(DisplayName, 'LIC_')"` - 参照 [Graph フィルタリング](#graph-filtering)
* `"AllowEdit": true / false` - このパラメーターを手動編集から保護する。（テンプレートと組み合わせて使用します）

### Settings

`Settings` Azure Storage Account 名のような構成データを中央の場所に保存しつつ、runbook とは分離したままにできます。

runbook の param ブロック内の個々の値には、次を使ってアクセスできます `Use-RJInterface`.

runbook の次の param ブロックの例を見てみましょう：

```powershell
param(
    [ValidateScript( { Use-RJInterface -Type Setting -Attribute "RJReport.StorageAccount.ResourceGroup" } )]
    [string] $ResourceGroupName,
    [ValidateScript( { Use-RJInterface -Type Setting -Attribute "RJReport.StorageAccount.StorageAccountName" } )]
    [string] $StorageAccountName,
    [ValidateScript( { Use-RJInterface -Type Setting -Attribute "RJReport.StorageAccount.LinkExpiryDays" } )]
    [int] $LinkExpiryDays = 6
)
```

Portal は、存在する場合、中央データストアの値で各パラメーターを事前入力しようとします。これは、パラメーターが UI で非表示になっていても機能します。

この runbook のデータストアに入る可能性のある JSON は次のとおりです：

```json
{
    "Settings": {
        "RJReport": {
            "StorageAccount": {
                "ResourceGroup": "rj-runbooks-01",
                "StorageAccountName": "rjrbexports01"
            }
        }
    }
}
```

不足している `LinkExpiryDays` 要素は単に UI に事前入力されないだけなので、パラメーターは既定値のままになります `6`.

の runbook ブロック `Runbooks` セクションには独自の `Settings`を含めることができます。各値について、Portal はまずそこを参照し、その後でグローバルな `Settings`を参照するため、個々の runbook は異なる値を使用できます。 [個々のランブックに別の Storage Account を使用する](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-report-settings.md#use-a-different-storage-account-for-individual-runbooks) を例として参照してください。

### テンプレート

`テンプレート` JSON 参照を使ってデータを取り込みます。たとえば、Office の所在地の長い一覧などです。次の `次を選択` ステートメントを使用する場合です。

これにより、カスタマイズを中立的・再利用可能・実データから分離した状態に保てます。

新しいユーザーのオンボーディングの例を見てみましょう。部門や Office の所在地について複数の選択肢があり、Office の所在地を割り当てると特定の住所、国、州なども必須になる場合があります。

次の runbook カスタマイズの例では、 `$ref` の中に `Runbooks` セクションを使って、次のものから部分木を参照/インポートします `テンプレート` セクション。次の `$id`/`$values` キーワードに注意してください。また、 `$id`/`$values` は、次を使って参照する前に定義しておく必要があります `$ref`。そのため、 `テンプレート` は、次より前に定義されています `Runbooks` この例では。

この例では、Portal に次を持つ部分木を取得するよう指示しています `$id` という名前の `LocationOptions` を含め、その `$values`を含めます。これにより、次を置き換えます `$ref` ステートメント。したがって、Portal は次をレンダリングします `次を選択` 。次の `Runbooks` セクションで説明されているように、実際のオプションを次から含めます `テンプレート`.

テンプレートには、参照先の場所でサポートされている任意のステートメントを含めることができます。この例では、次を使用します `カスタマイズ` 他のパラメーターを変更するためのステートメントを、たとえば次のように使います `StreetAddress`.

つまり、次の中に runbook 固有のカスタマイズを持たせることができます `Runbooks` 複数の環境で再利用可能にしつつ、実データは分離しておけます。

```json
{
    "Templates": {
        "Options": [
            {
                "$id": "LocationOptions",
                "$values": [
                    {
                        "Display": "DE-OF",
                        "Customization": {
                            "Default": {
                                "StreetAddress": "Kaiserstraße 39",
                                "PostalCode": "63065",
                                "City": "Offenbach",
                                "Country": "ドイツ"
                            }
                        }
                    },
                    {
                        "Display": "DE-DEG",
                        "Customization": {
                            "Default": {
                                "StreetAddress": "Lateinschulgassse 24-26",
                                "PostalCode": "94469",
                                "City": "Deggendorf",
                                "Country": "ドイツ"
                            }
                        }
                    },
                    {
                        "Display": "DE-HH",
                        "Customization": {
                            "Default": {
                                "StreetAddress": "Hans-Henny-Jahnn-Weg 53",
                                "PostalCode": "22085",
                                "City": "Hamburg",
                                "Country": "ドイツ"
                            }
                        }
                    },
                    {
                        "Display": "FI-HS",
                        "Customization": {
                            "Default": {
                                "StreetAddress": "Somewhere 42",
                                "PostalCode": "12345",
                                "City": "Helsinki",
                                "Country": "フィンランド"
                            }
                        }
                    }
                ]
            },
            {
                "$id": "CompanyOptions",
                "$values": [
                    {
                        "Id": "gkg",
                        "Display": "glueckkanja",
                        "Value": "glueckkanja AG"
                    },
                    {
                        "Id": "pp",
                        "Display": "PRIMEPULSE",
                        "Value": "PRIMEPULSE SE"
                    }
                ]
            }
        ]
    },
    "Runbooks": {
        "rjgit-org_general_add-user": {
            "ParameterList": [
                {
                    "DisplayName": "Office の所在地",
                    "DisplayAfter": "CompanyName",
                    "Select": {
                        "Options": {
                            "$ref": "LocationOptions"
                        }
                    }
                },
                {
                    "Name": "CompanyName",
                    "Select": {
                        "Options": {
                            "$ref": "CompanyOptions"
                        },
                        "AllowEdit": false
                    }
                }
            ],
            "ReadOnly": [
                "StreetAddress",
                "PostalCode",
                "City",
                "Country"
            ]
        }
    }
}
```

これにより、次の UI が作成されます：

![デモ - ref-location](https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-93295541748dcc12dbc72208851138efd0808d51%2Frunbook-customization-img7.png?alt=media)

![デモ - ref-address](https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-11e2812670e56cf10bb03fe7588059d232a8addf%2Frunbook-customization-img8.png?alt=media)

### Graph フィルター

次を準備できます [ODATA Graph フィルター](https://docs.microsoft.com/en-us/graph/query-parameters?context=graph%2Fapi%2F1.0\&view=graph-rest-1.0#filter-parameter) を複数の runbook で使用できます。これらを次の名前のセクションに保存します `GraphFilters`.

次の例では、ある特定のプレフィックスでフィルターします `DisplayName` グループのもので、グループ ピッカーでライセンス関連のグループのみを表示します。

```json
"GraphFilters": {
    "LicenseGroup": "startswith(DisplayName, 'LIC_')" // RJ コードにも既定として含まれています
  }
```

参照 [グラフ フィルタリング](#graph-filtering) ランブックからこれを使用する方法について。


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-customization.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
