> 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/de/automatisierung/runbooks/runbook-report-settings.md). # Runbook-Berichtseinstellungen ## Übersicht Mehrere RealmJoin-Runbooks enthalten automatisierte Berichtsfunktionen, um Berichte, Benachrichtigungen und Warnungen direkt an Administratoren zu übermitteln. Je nach Konfiguration können Berichte: * **per E-Mail versendet werden** — unter Verwendung der Microsoft Graph API im Namen einer konfigurierten Absenderadresse * **in ein Azure Storage Account hochgeladen** — und als zeitlich begrenzter SAS-Download-Link bereitgestellt Die Unterstützung beider Übermittlungskanäle ist künftig der angestrebte Standard für alle Reporting-Runbooks. Noch unterstützen möglicherweise nicht alle Reporting-Runbooks beide Kanäle, aber die Zahl der unterstützten Runbooks wächst kontinuierlich. Beide Kanäle können unabhängig voneinander oder in Kombination aktiviert werden. Alle gemeinsam genutzten Einstellungen werden einmalig im [RealmJoin Runbook Customization](https://portal.realmjoin.com/settings/runbooks-customizations) konfiguriert und werden automatisch auf alle Runbooks angewendet, die die jeweilige Funktion verwenden. Einstellungen, die je Runbook unterschiedlich sind (z. B. der Ziel-Containername), sind nicht Teil dieser zentralen Konfiguration und werden direkt im jeweiligen Runbook festgelegt. Die Funktionen, die diese Einstellungen verwenden — [`Send-RjRbReportEmail`](/de/dev-reference/report-functions/send-rjrbreportemail.md) und [`Publish-RjRbFilesToStorageContainer`](/de/dev-reference/report-functions/publish-rjrbfilestostoragecontainer.md) — werden vom **RealmJoin.RunbookHelper** PowerShell-Modul bereitgestellt. Siehe [Berichtsfunktionen](/de/dev-reference/report-functions.md) für eine ausführliche Verwendungsdokumentation. ## E-Mail-Zustellung ### Voraussetzungen Wir empfehlen die Verwendung eines dedizierten freigegebenen Postfachs, z. B. `realmjoin-report@contoso.com`. Dieses Postfach wird als Absenderadresse für alle Berichte verwendet. Sie können eine No-Reply-Adresse verwenden, da von den Empfängern nicht erwartet wird, auf automatisierte Berichte zu antworten. ### Konfiguration Wie in der [JSON-basierte Anpassung](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) Dokumentation ausführlich beschrieben, navigieren Sie zu [RealmJoin Runbook Customization](https://portal.realmjoin.com/settings/runbooks-customizations) im RealmJoin Portal (Settings > Runbook Customizations). Im `Settings` Block fügen Sie den `RJReport` Bereich hinzu oder ändern Sie ihn, um die `EmailSender` Eigenschaft mit Ihrer gewünschten Absender-E-Mail-Adresse aufzunehmen: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com" } } } ``` Ersetzen Sie dies `realmjoin-report@contoso.com` durch die tatsächliche Adresse Ihres freigegebenen Postfachs. ### Service-Desk-Kontaktinformationen (optional) Diese zentrale Konfiguration stellt nur die einheitlichen Service-Desk-Werte für alle Runbooks bereit. Ob die Kontaktinformationen tatsächlich in einer Benachrichtigungs-E-Mail enthalten sind, wird vom jeweiligen Runbook selbst bestimmt — nur Runbooks, die die entsprechenden Service-Desk-Parameter implementieren (z. B. `ServiceDeskDisplayName`, `ServiceDeskPortalUrl`) lesen diese Werte aus und stellen sie in ihren E-Mails dar. Um die Service-Desk-Kontaktinformationen für diese Runbooks bereitzustellen, fügen Sie die folgenden Eigenschaften zum `RJReport` Bereich hinzu: ```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" } } } ``` **Parameter:** * `ServiceDesk_DisplayName` — Anzeigename Ihres Service Desks (z. B. "IT Support", "Help Desk") * `ServiceDesk_EMail` — E-Mail-Adresse des Service Desks (als klickbarer `mailto:` Link angezeigt) * `ServiceDesk_Phone` — Telefonnummer des Service Desks im internationalen Format (als klickbarer `tel:` Link angezeigt) * `ServiceDesk_PortalUrl` — URL Ihres Service-Desk-Portals oder Ihrer Website (als klickbarer Link angezeigt) Alle Parameter sind optional. Wenn sie konfiguriert sind, werden sie in der Fußzeile der E-Mail als klickbare Links angezeigt. > **Hinweis:** Einige Runbooks akzeptieren zusätzlich einen Ticket-Link pro Ausführung (z. B. `ServiceDeskTicketUrl`), um auf das spezifische Ticket zu verweisen, das die Anfrage ausgelöst hat. Dies ist ein Runbook-Parameter und nicht Teil dieser zentralen Konfiguration. ### E-Mail-Branding (optional) Bericht-E-Mails können Tenant-spezifisches Branding enthalten: Die standardmäßigen RealmJoin-Kopf- und Fußzeilengrafiken können durch eigene Bilder ersetzt werden, das Fußzeilenbild kann auf ein benutzerdefiniertes Ziel verlinken — beispielsweise Ihr Intranet oder IT-Portal — und die Vorlagenfarben können an Ihr Corporate Design angepasst werden. Um das Branding zu konfigurieren, fügen Sie dem `Branding` Unterabschnitt zum `RJReport` Block hinzu (verschachtelt wie `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" } } } } ``` **Parameter:** | Einstellung | Erforderlich | Standard | Beschreibung | | ---------------- | ------------ | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | `HeaderImageUrl` | nein | RealmJoin-Kopfzeilengrafik | Öffentliche HTTPS-URL eines benutzerdefinierten Kopfzeilenbilds, das die standardmäßige RealmJoin-Kopfzeilengrafik ersetzt | | `FooterImageUrl` | nein | RealmJoin-Fußzeilengrafik | Öffentliche HTTPS-URL eines benutzerdefinierten Fußzeilenbilds, das die standardmäßige RealmJoin-Fußzeilengrafik ersetzt | | `FooterLink` | nein | `https://www.realmjoin.com` | URL, auf die das Fußzeilenbild verweist | | `AccentColor` | nein | `#f8842c` (RealmJoin-Orange) | Akzentfarbe der E-Mail-Vorlage: Tabellenkopfzeilen, Aktionsschaltflächen, Akzentrahmen der Informationsboxen | | `TextColor` | nein | `#011e33` (RealmJoin-Navy) | Primäre Textfarbe der E-Mail-Vorlage: Fließtext, Überschriften, Listeneinträge, Code | **Bildanforderungen:** * Das Bild muss über eine **öffentliche HTTPS-URL** erreichbar sein — zum Beispiel ein Azure Blob Storage-Container mit anonymem Lesezugriff, ein CDN oder die Unternehmenswebsite. Eine URL mit einem SAS Token funktioniert ebenfalls und hält den Container privat. * Unterstützte Formate: **PNG, JPEG oder GIF**. Das Format wird anhand der Dateisignatur erkannt, nicht anhand der Dateierweiterung. * Bilder werden mit **750 px Breite**. Empfohlene Abmessungen sind **750×200 px** (entsprechend den Standard-Bannern) oder **1500×400 px** für High-DPI-Anzeigen. * Maximal **200 KB** pro Bild; **100 KB oder weniger** wird empfohlen. Die Branding-Bilder teilen sich die Gesamt-E-Mail-Größenbeschränkung von ca. 4 MB mit den Berichtsanhängen (zum Vergleich: die standardmäßigen RealmJoin-Grafiken sind 52 KB und 15 KB). **Farbanforderungen:** * Werte müssen 6-stellige hexadezimale Farben sein, einschließlich des führenden `#` — zum Beispiel `#0052cc`. Kurzformen (`#05c`) und Farbnamen (`rot`) werden nicht unterstützt. * Sowohl E-Mails als auch ihre Anhänge werden im Hell-/Dunkelmodus dargestellt: Wählen Sie eine Textfarbe, die auf einer weißen Inhaltskarte lesbar bleibt, und eine Akzentfarbe mit ausreichendem Kontrast zu weißem Schaltflächentext. **und** Die Statusfarben (Grün/Rot/Bernstein für Erfolgs-, Fehler- und Warnzustände) sowie die neutralen Grautöne sind absichtlich nicht konfigurierbar — sie tragen eine Bedeutung, die sich nicht je Tenant ändern sollte. * Die Bilder werden bei jedem Lauf vom Runbook heruntergeladen und validiert. Wenn eine Einstellung leer bleibt, werden die standardmäßige RealmJoin-Grafik, Farbe und der Fußzeilenlink verwendet. Wenn ein Download fehlschlägt, ein Bild ungültig ist oder eine Farbe kein gültiger Hex-Wert ist, wird eine Warnung protokolliert und stattdessen die entsprechende Standardeinstellung verwendet — eine fehlerhafte Branding-Konfiguration verhindert niemals, dass eine Bericht-E-Mail gesendet wird. Alle Einstellungen sind optional und gelten für alle Runbooks, die Bericht-E-Mails versenden. Die Farbeinstellungen erfordern > **Hinweis:** RealmJoin.RunbookHelper 0.8.9 **oder höher im Automation-Konto. Mit älteren Modulversionen gelten die Bildeinstellungen weiterhin, und die Farben werden ignoriert.** Storage Account-Zustellung ## Reporting-Runbooks, die diesen Übermittlungskanal unterstützen, können ihre Ausgabe in einen Azure Blob Storage-Container hochladen. Nach einem erfolgreichen Upload gibt das Runbook einen zeitlich begrenzten SAS-Link zurück, über den die Datei direkt heruntergeladen werden kann. Dieser Kanal kann unabhängig von der E-Mail-Zustellung oder zusätzlich dazu verwendet werden. Ein vorhandenes Azure Storage Account ist erforderlich. Die verwaltete Identität des Automation-Kontos (oder der von den Runbooks verwendete Service Principal) benötigt mindestens ### Voraussetzungen Storage Blob Data Contributor **Berechtigungen für das Storage Account oder seine Ressourcengruppe.** Navigieren Sie zu ### Konfiguration und fügen Sie einen [RealmJoin Runbook Customization](https://portal.realmjoin.com/settings/runbooks-customizations) Block hinzu: `StorageAccount` Unterabschnitt zum `RJReport` "StorageAccount": { ```json { "Settings": { "RJReport": { "ResourceGroup": "rg-reports", "StorageAccountName": "stcontosoreports", "LinkExpiryDays": 6 ResourceGroup } } } } ``` **Parameter:** | Einstellung | Erforderlich | Standard | Beschreibung | | --------------------------------------------------------------- | ------------ | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ja` | — | Ressourcengruppe, die das Storage Account enthält | StorageAccountName | | `Name des Azure Storage Account` | — | Ressourcengruppe, die das Storage Account enthält | LinkExpiryDays | | `Anzahl der Tage, bis der generierte SAS-Download-Link abläuft` | nein | `6` | Einstellungen, die für ein einzelnes Runbook spezifisch sind — etwa der Ziel-Containername oder ein benutzerdefinierter Blob-Name — werden direkt in diesem Runbook konfiguriert und sind absichtlich nicht Teil dieser zentralen Konfiguration. Dasselbe gilt für das Präfixieren von Blob-Namen: Ob ein Zeitstempelpräfix ( | > **Hinweis:** yyyyMMdd-HHmmss`) vor den Blob-Namen gesetzt wird, um Überschreiben zu verhindern, wird durch den`AddBlobNamePrefix `Parameter von` (Standard [`Publish-RjRbFilesToStorageContainer`](/de/dev-reference/report-functions/publish-rjrbfilestostoragecontainer.md) $false `), gesteuert, den jedes Runbook explizit übergibt.`Kombiniertes Beispiel ## Das folgende Snippet zeigt eine vollständige Konfiguration mit allen aktivierten Funktionen: `RJReport` "ServiceDesk\_PortalUrl": "", ```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" }, "ResourceGroup": "rg-reports", "StorageAccountName": "stcontosoreports", "LinkExpiryDays": 6 ResourceGroup } } } } ``` --- # 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/de/automatisierung/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.