> 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/fr/automatisation/runbooks/runbook-report-settings.md). # Paramètres de rapport de runbook ## Aperçu Plusieurs runbooks RealmJoin incluent des fonctionnalités de rapports automatisés pour fournir des rapports, des notifications et des alertes directement aux administrateurs. Selon la configuration, les rapports peuvent être : * **envoyés par e-mail** — à l’aide de l’API Microsoft Graph au nom d’une adresse d’expéditeur configurée * **téléversés vers un Azure Storage Account** — et rendus disponibles sous la forme d’un lien de téléchargement SAS temporaire La prise en charge des deux canaux de livraison est le standard souhaité pour tous les runbooks de reporting à l’avenir. Tous les runbooks de reporting ne prennent pas encore en charge les deux canaux, mais la liste des runbooks pris en charge ne cesse de s’allonger. Les deux canaux peuvent être activés indépendamment ou en combinaison. Tous les paramètres partagés sont configurés une seule fois dans le [Personnalisation des runbooks RealmJoin](https://portal.realmjoin.com/settings/runbooks-customizations) et s’appliquent automatiquement à tous les runbooks qui utilisent la fonctionnalité correspondante. Les paramètres qui diffèrent d’un runbook à l’autre (comme le nom du conteneur cible) ne font pas partie de cette configuration centrale et sont définis directement dans le runbook concerné. Les fonctions qui consomment ces paramètres — [`Send-RjRbReportEmail`](/fr/dev-reference/report-functions/send-rjrbreportemail.md) et [`Publish-RjRbFilesToStorageContainer`](/fr/dev-reference/report-functions/publish-rjrbfilestostoragecontainer.md) — sont fournies par le **RealmJoin.RunbookHelper** module PowerShell. Voir [Fonctions de rapport](/fr/dev-reference/report-functions.md) pour une documentation détaillée sur l’utilisation. ## Livraison par e-mail ### Prérequis Nous recommandons d’utiliser une boîte aux lettres partagée dédiée, comme `realmjoin-report@contoso.com`. Cette boîte aux lettres sera utilisée comme adresse d’expéditeur pour tous les rapports. Vous pouvez utiliser une adresse no-reply, car les destinataires ne sont pas censés répondre aux rapports automatisés. ### Configuration Comme décrit en détail dans la documentation [Personnalisation basée sur JSON](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) , accédez à [Personnalisation des runbooks RealmJoin](https://portal.realmjoin.com/settings/runbooks-customizations) dans le portail RealmJoin (Paramètres > Personnalisations des runbooks). Dans le `bloc « Settings »,` ajoutez ou modifiez la section `RJReport` pour inclure la propriété `EmailSender` avec l’adresse e-mail d’expéditeur souhaitée : ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com" } } } ``` Remplacez `realmjoin-report@contoso.com` par l’adresse réelle de votre boîte aux lettres partagée. ### Informations de contact du Service Desk (facultatif) Cette configuration centrale ne fournit que les valeurs unifiées du Service Desk pour tous les runbooks. Le fait que les informations de contact soient réellement incluses dans un e-mail de notification est déterminé par le runbook concerné lui-même — seuls les runbooks qui implémentent les paramètres Service Desk correspondants (par exemple `ServiceDeskDisplayName`, `ServiceDeskPortalUrl`) lisent ces valeurs et les affichent dans leurs e-mails. Pour fournir les informations de contact du Service Desk pour ces runbooks, ajoutez les propriétés suivantes à la `RJReport` section : ```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" } } } ``` **Paramètres :** * `ServiceDesk_DisplayName` — Nom affiché de votre Service Desk (par ex. « IT Support », « Help Desk ») * `ServiceDesk_EMail` — Adresse e-mail du Service Desk (affichée comme un `mailto:` lien cliquable) * `ServiceDesk_Phone` — Numéro de téléphone du Service Desk au format international (affiché comme un `tel:` lien cliquable) * `ServiceDesk_PortalUrl` — URL du portail ou du site Web de votre Service Desk (affichée comme un lien cliquable) Tous les paramètres sont facultatifs. S’ils sont configurés, ils apparaîtront dans le pied de page de l’e-mail sous forme de liens cliquables. > **Remarque :** Certains runbooks acceptent en plus un lien de ticket par exécution (par ex. `ServiceDeskTicketUrl`) pour référencer le ticket spécifique qui a déclenché la demande. Il s’agit d’un paramètre de runbook, qui ne fait pas partie de cette configuration centrale. ### Branding des e-mails (facultatif) Les e-mails de rapport peuvent porter une image de marque spécifique au Tenant : les graphiques d’en-tête et de pied de page RealmJoin par défaut peuvent être remplacés par vos propres images, l’image du pied de page peut renvoyer vers une cible personnalisée — par exemple votre intranet ou votre portail IT — et les couleurs du modèle peuvent être adaptées à votre charte graphique. Pour configurer le branding, ajoutez une `sous-section Branding` au `RJReport` bloc (imbriqué comme `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" } } } } ``` **Paramètres :** | Paramètre | Requis | Valeur par défaut | Description | | ---------------- | ------ | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | `HeaderImageUrl` | non | graphique d’en-tête RealmJoin | URL HTTPS publique d’une image d’en-tête personnalisée qui remplace le graphique d’en-tête RealmJoin par défaut | | `FooterImageUrl` | non | graphique de pied de page RealmJoin | URL HTTPS publique d’une image de pied de page personnalisée qui remplace le graphique de pied de page RealmJoin par défaut | | `FooterLink` | non | `https://www.realmjoin.com` | URL vers laquelle pointe l’image de pied de page | | `AccentColor` | non | `#f8842c` (orange RealmJoin) | Couleur d’accentuation du modèle d’e-mail : lignes d’en-tête du tableau, boutons d’action, bordures d’accentuation des encadrés d’information | | `TextColor` | non | `#011e33` (bleu marine RealmJoin) | Couleur de texte principale du modèle d’e-mail : texte du corps, titres, éléments de liste, code | **Exigences relatives aux images :** * L’image doit être accessible via une **URL HTTPS publique** — par exemple un conteneur Azure Blob Storage avec accès en lecture anonyme, un CDN ou le site Web de l’entreprise. Une URL contenant un SAS Token fonctionne également et conserve le conteneur privé. * Formats pris en charge : **PNG, JPEG ou GIF**. Le format est détecté à partir de la signature du fichier, et non de son extension. * Les images sont rendues à **750 px de largeur**. Les dimensions recommandées sont **750×200 px** (correspondant aux bannières par défaut) ou **1500×400 px** pour les écrans haute densité (HiDPI). * Maximum **200 Ko** par image ; **100 Ko ou moins** est recommandé. Les images de branding partagent la limite totale d’environ 4 Mo par e-mail avec les pièces jointes du rapport (à titre de comparaison, les graphiques RealmJoin par défaut font 52 Ko et 15 Ko). **Exigences relatives aux couleurs :** * Les valeurs doivent être des couleurs hexadécimales à 6 chiffres, avec le signe `#` — par exemple `#0052cc`. Les formes courtes (`#05c`) et les noms de couleurs (`red`) ne sont pas pris en charge. * Les e-mails et leurs pièces jointes sont affichés en mode clair/sombre : **et** choisissez une couleur de texte qui reste lisible sur une carte de contenu blanche, et une couleur d’accentuation offrant suffisamment de contraste avec le texte blanc des boutons. * Les couleurs d’état (vert/rouge/ambre pour les états de réussite, d’erreur et d’avertissement) et les gris neutres ne sont volontairement pas configurables — ils portent un sens qui ne devrait pas changer selon le Tenant. Les images sont téléchargées et validées par le runbook à chaque exécution. Si un paramètre est laissé vide, le graphique, la couleur et le lien de pied de page RealmJoin par défaut sont utilisés. Si un téléchargement échoue, qu’une image est invalide ou qu’une couleur n’est pas une valeur hexadécimale valide, un avertissement est consigné et la valeur par défaut correspondante est utilisée à la place — une configuration de branding défectueuse n’empêche jamais l’envoi d’un e-mail de rapport. Tous les paramètres sont facultatifs et prennent effet pour tous les runbooks qui envoient des e-mails de rapport. > **Remarque :** Les paramètres de couleur nécessitent **RealmJoin.RunbookHelper 0.8.9** ou une version ultérieure dans le Automation Account. Avec les versions antérieures du module, les paramètres d’image s’appliquent toujours et les couleurs sont ignorées. ## Livraison via Storage Account Les runbooks de reporting qui prennent en charge ce canal de livraison peuvent téléverser leur sortie vers un conteneur Azure Blob Storage. Après un téléversement réussi, le runbook renvoie un lien SAS à durée limitée qui peut être utilisé pour télécharger le fichier directement. Ce canal peut être utilisé indépendamment ou en complément de la distribution par e-mail. ### Prérequis Un Azure Storage Account existant est requis. L’identité managée du Automation Account (ou le Service Principal utilisé par les runbooks) a besoin d’au moins **Storage Blob Data Contributor** d’autorisations sur le Storage Account ou son groupe de ressources. ### Configuration Accédez à [Personnalisation des runbooks RealmJoin](https://portal.realmjoin.com/settings/runbooks-customizations) et ajoutez un `StorageAccount` au `RJReport` bloc : ```json { "Settings": { "RJReport": { "StorageAccount": { "ResourceGroup": "rg-reports", "StorageAccountName": "stcontosoreports", "LinkExpiryDays": 6 } } } } ``` **Paramètres :** | Paramètre | Requis | Valeur par défaut | Description | | -------------------- | ------ | ----------------- | ----------------------------------------------------------------------- | | `ResourceGroup` | oui | — | Groupe de ressources contenant le Storage Account | | `StorageAccountName` | oui | — | Nom du Storage Account Azure | | `LinkExpiryDays` | non | `6` | Nombre de jours avant l’expiration du lien de téléchargement SAS généré | > **Remarque :** Les paramètres spécifiques à un runbook individuel — comme le nom du conteneur cible ou un nom de blob personnalisé — sont configurés directement dans ce runbook et ne font intentionnellement pas partie de cette configuration centrale. Il en va de même pour le préfixage du nom de blob : le fait qu’un préfixe d’horodatage (`yyyyMMdd-HHmmss`) soit ajouté au nom du blob pour éviter les écrasements est contrôlé par le `paramètre AddBlobNamePrefix` de [`Publish-RjRbFilesToStorageContainer`](/fr/dev-reference/report-functions/publish-rjrbfilestostoragecontainer.md) (par défaut `$false`), que chaque runbook transmet explicitement. ## Exemple combiné L’extrait suivant montre une `RJReport` configuration complète avec toutes les fonctionnalités activées : ```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/fr/automatisation/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.