> 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-report-settings.md). # Runbook レポート設定 ## 概要 複数の RealmJoin runbooks には、レポート、通知、アラートを管理者に直接配信する自動レポート機能が含まれています。構成に応じて、レポートは次のいずれかになります: * **メールで送信される** — 構成済みの送信者アドレスを代理して Microsoft Graph API を使用して * **Azure Storage Account にアップロードされる** — そして、期限付きの SAS ダウンロード リンクとして利用可能になる 今後のすべてのレポート用 runbook では、両方の配信チャネルをサポートすることが意図された標準です。まだ両方のチャネルをサポートしていないレポート用 runbook もありますが、対応する runbook の数は継続的に増えています。両方のチャネルは個別にも、組み合わせても有効化できます。 共有設定はすべて、次の場所で一度だけ構成されます [RealmJoin Runbook カスタマイズ](https://portal.realmjoin.com/settings/runbooks-customizations) その後、各機能を使用するすべての runbook に自動的に適用されます。runbook ごとに異なる設定（ターゲット コンテナー名など）は、この中央構成には含まれず、各 runbook 内で直接設定されます。 これらの設定を使用する関数は — [`Send-RjRbReportEmail`](/ja/dev-reference/report-functions/send-rjrbreportemail.md) および [`Publish-RjRbFilesToStorageContainer`](/ja/dev-reference/report-functions/publish-rjrbfilestostoragecontainer.md) — は次のものによって提供されます: **RealmJoin.RunbookHelper** PowerShell モジュールです。詳細な使用方法のドキュメントについては、 [レポート関数](/ja/dev-reference/report-functions.md) を参照してください。 ## メール配信 ### 前提条件 たとえば、専用の共有メールボックスの使用を推奨します: `realmjoin-report@contoso.com`。このメールボックスは、すべてのレポートの送信者アドレスとして使用されます。受信者が自動レポートに返信することは想定されていないため、no-reply アドレスを使用できます。 ### 構成 の詳細で説明されているように、 [JSON ベースのカスタマイズ](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) ドキュメントを参照し、次へ移動します: [RealmJoin Runbook カスタマイズ](https://portal.realmjoin.com/settings/runbooks-customizations) RealmJoin Portal（Settings > Runbook Customizations）内の 〜の `設定` ブロックで、次の項目を追加または変更します: `RJReport` セクションに次を含めます: `EmailSender` プロパティに、希望する送信者メールアドレスを指定します: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com" } } } ``` 置き換えてください `realmjoin-report@contoso.com` 実際の共有メールボックスのアドレスに ### Service Desk の連絡先情報（任意） この中央構成では、すべての runbook に対する統一された Service Desk の値のみが提供されます。連絡先情報を実際に通知メールに含めるかどうかは、各 runbook 自身によって決まります — 対応する Service Desk パラメーター（例: `ServiceDeskDisplayName`, `ServiceDeskPortalUrl`）を実装している runbook のみがこれらの値を読み取り、メールに表示します。 これらの runbook に Service Desk の連絡先情報を提供するには、次のプロパティを `RJReport` セクションに追加します: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com", "ServiceDesk_DisplayName": "IT Service Desk", "ServiceDesk_EMail": "servicedesk@domain.com", "ServiceDesk_Phone": "+49123456789", "ServiceDesk_PortalUrl": "https://servicedesk.domain.com" } } } ``` **パラメーター:** * `ServiceDesk_DisplayName` — Service Desk の表示名（例: "IT Support"、"Help Desk"） * `ServiceDesk_EMail` — Service Desk のメールアドレス（クリック可能な `mailto:` リンクとして表示されます） * `ServiceDesk_Phone` — 国際形式の Service Desk 電話番号（クリック可能な `tel:` リンクとして表示されます） * `ServiceDesk_PortalUrl` — Service Desk ポータルまたは Web サイトの URL（クリック可能なリンクとして表示されます） すべてのパラメーターは任意です。構成されている場合、メール フッターにクリック可能なリンクとして表示されます。 > **注:** 一部の runbook では、実行ごとのチケット リンク（例: `ServiceDeskTicketUrl`）を追加で受け付け、要求のきっかけとなった特定のチケットを参照できます。これは runbook パラメーターであり、この中央構成の一部ではありません。 ### メールのブランド設定（任意） レポートメールには Tenant 固有のブランド設定を適用できます。既定の RealmJoin のヘッダーおよびフッター画像は独自の画像に置き換えられ、フッター画像のリンク先は社内イントラネットや IT ポータルなどの任意のターゲットに変更でき、テンプレートの色も企業デザインに合わせて調整できます。 ブランド設定を構成するには、次のものを追加します: `Branding` のサブセクションを `RJReport` ブロックに追加します（次のようにネストされています: `StorageAccount`): ```json { "Settings": { "RJReport": { "Branding": { "HeaderImageUrl": "https://cdn.contoso.com/branding/email-header.png", "FooterImageUrl": "https://cdn.contoso.com/branding/email-footer.png", "FooterLink": "https://intranet.contoso.com", "AccentColor": "#0052cc", "TextColor": "#1a1a2e" } } } } ``` **パラメーター:** | 設定 | 必須 | 既定 | 説明 | | ---------------- | --- | --------------------------- | --------------------------------------------------- | | `HeaderImageUrl` | いいえ | RealmJoin のヘッダー画像 | 既定の RealmJoin のヘッダー画像を置き換えるカスタム ヘッダー画像の公開 HTTPS URL | | `FooterImageUrl` | いいえ | RealmJoin のフッター画像 | 既定の RealmJoin のフッター画像を置き換えるカスタム フッター画像の公開 HTTPS URL | | `FooterLink` | いいえ | `https://www.realmjoin.com` | フッター画像がリンクする URL | | `AccentColor` | いいえ | `#f8842c` （RealmJoin オレンジ） | メール テンプレートのアクセント色: 表ヘッダー行、アクション ボタン、情報ボックスのアクセント枠線 | | `TextColor` | いいえ | `#011e33` （RealmJoin ネイビー） | メール テンプレートの本文の文字色: 本文テキスト、見出し、リスト項目、コード | **画像要件:** * 画像は次を介して到達可能である必要があります: **公開 HTTPS URL** — たとえば、匿名読み取りアクセスが有効な Azure Blob Storage コンテナー、CDN、または会社の Web サイトです。SAS トークンを含む URL でも機能し、コンテナーをプライベートに保てます。 * 対応形式: **PNG、JPEG、GIF**。形式はファイル拡張子ではなく、ファイル シグネチャから検出されます。 * 画像は次の幅でレンダリングされます: **750 px 幅**。推奨サイズは **750×200 px** （既定のバナーと一致）または **1500×400 px** 高 DPI ディスプレイ向けです。 * 最大 **200 KB** 画像 1 枚あたり； **100 KB 以下** を推奨します。ブランド設定画像は、レポートの添付ファイルと合わせて、メール全体サイズの約 4 MB 制限を共有します（参考までに、既定の RealmJoin 画像は 52 KB と 15 KB です）。 **色の要件:** * 値は、先頭の `#` を含む 6 桁の 16 進カラーである必要があります — たとえば `#0052cc`。短縮形（`#05c`）および色名（`赤`）はサポートされていません。 * メール本文と添付ファイルの両方は、ライト/ダーク モードで読み取られます。白いコンテンツ カード上でも判読できる文字色を選び、白いボタン文字に対して十分なコントラストがあるアクセント色を選択してください。 **および** ステータス色（成功、エラー、警告状態を示す緑/赤/琥珀色）と中立のグレーは、あえて構成できないようになっています。これらは Tenant ごとに変わるべきでない意味を持つためです。 * 画像は各実行時に runbook によってダウンロードされ、検証されます。設定が空のままの場合は、既定の RealmJoin 画像、色、フッター リンクが使用されます。ダウンロードに失敗した場合、画像が無効な場合、または色が有効な 16 進値でない場合は、警告が記録され、代わりに対応する既定値が使用されます — 壊れたブランド設定によりレポート メールの送信が妨げられることはありません。 すべての設定は任意で、レポート メールを送信するすべての runbook に適用されます。 色設定には次が必要です: > **注:** RealmJoin.RunbookHelper 0.8.9 **以上の Automation Account が必要です。古いモジュール バージョンでは画像設定は引き続き適用され、色は無視されます。** またはそれ以降を Automation Account に用意してください。古いモジュール バージョンでは画像設定は引き続き適用され、色は無視されます。 ## Storage Account 配信 この配信チャネルをサポートするレポート用 runbook は、出力を Azure Blob Storage コンテナーにアップロードできます。アップロード成功後、runbook はファイルを直接ダウンロードするために使用できる期限付きの SAS リンクを返します。このチャネルは、メール配信とは独立して、または追加で使用できます。 ### 前提条件 既存の Azure Storage Account が必要です。Automation Account のマネージド ID（または runbook で使用される Service Principal）には少なくとも **Storage Blob Data Contributor** の Storage Account またはそのリソース グループに対する権限が必要です。 ### 構成 次へ移動し、 [RealmJoin Runbook カスタマイズ](https://portal.realmjoin.com/settings/runbooks-customizations) を追加します: `StorageAccount` のサブセクションを `RJReport` ブロック: ```json { "Settings": { "RJReport": { "StorageAccount": { "ResourceGroup": "rg-reports", "StorageAccountName": "stcontosoreports", "LinkExpiryDays": 6 } } } } ``` **パラメーター:** | 設定 | 必須 | 既定 | 説明 | | -------------------- | --- | --- | ---------------------------------- | | `ResourceGroup` | はい | — | Storage Account を含むリソース グループ | | `StorageAccountName` | はい | — | Azure Storage Account の名前 | | `LinkExpiryDays` | いいえ | `6` | 生成された SAS ダウンロード リンクの有効期限が切れるまでの日数 | > **注:** 個別の runbook に固有の設定 — ターゲット コンテナー名やカスタム blob 名など — は、その runbook で直接構成され、この中央構成には意図的に含まれていません。blob 名のプレフィックス付与にも同様に当てはまります。タイムスタンプ プレフィックス（`yyyyMMdd-HHmmss`）を blob 名の先頭に付けて上書きを防ぐかどうかは、 `AddBlobNamePrefix` のパラメーターによって制御されます。 [`Publish-RjRbFilesToStorageContainer`](/ja/dev-reference/report-functions/publish-rjrbfilestostoragecontainer.md) （既定値 `$false`）で、各 runbook が明示的に渡します。 ## 組み合わせ例 次のスニペットは、完全な `RJReport` すべての機能を有効にした構成を示しています: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com", "ServiceDesk_DisplayName": "IT Service Desk", "ServiceDesk_EMail": "servicedesk@domain.com", "ServiceDesk_Phone": "+49123456789", "ServiceDesk_PortalUrl": "https://servicedesk.domain.com", "Branding": { "HeaderImageUrl": "https://cdn.contoso.com/branding/email-header.png", "FooterImageUrl": "https://cdn.contoso.com/branding/email-footer.png", "FooterLink": "https://intranet.contoso.com", "AccentColor": "#0052cc", "TextColor": "#1a1a2e" }, "StorageAccount": { "ResourceGroup": "rg-reports", "StorageAccountName": "stcontosoreports", "LinkExpiryDays": 6 } } } } ``` --- # 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.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-report-settings.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.