> 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/es/automatizacion/runbooks/runbook-report-settings.md). # Configuración de informes de runbook Configurar ajustes centralizados de entrega por correo electrónico y almacenamiento para runbooks de informes. ## Descripción general Varios RealmJoin Runbooks incluyen capacidades automatizadas de generación de informes para entregar informes, notificaciones y alertas directamente a los administradores. Según la configuración, los informes pueden ser: * **enviados por correo electrónico** — usando la API de Microsoft Graph en nombre de una dirección del remitente configurada * **cargados en una Azure Storage Account** — y puestos a disposición como un enlace de descarga SAS limitado en el tiempo Dar soporte a ambos canales de entrega es el estándar previsto para todos los runbooks de informes a partir de ahora. Es posible que todavía no todos los runbooks de informes admitan ambos canales, pero el conjunto de runbooks admitidos crece continuamente. Ambos canales pueden habilitarse de forma independiente o en combinación. Toda la configuración compartida se configura una sola vez en la [Personalización de RealmJoin Runbook](https://portal.realmjoin.com/settings/runbooks-customizations) y se aplican automáticamente a todos los runbooks que usan la característica correspondiente. Las configuraciones que difieren por runbook (como el nombre del contenedor de destino) no forman parte de esta configuración central y se establecen directamente en el runbook correspondiente. Las funciones que consumen estas configuraciones — [`Send-RjRbReportEmail`](/es/dev-reference/report-functions/send-rjrbreportemail.md) y [`Publish-RjRbFilesToStorageContainer`](/es/dev-reference/report-functions/publish-rjrbfilestostoragecontainer.md) — son proporcionadas por el **RealmJoin.RunbookHelper** módulo de PowerShell. Véase [Funciones de informes](/es/dev-reference/report-functions.md) para ver la documentación detallada de uso. ## Entrega por correo electrónico ### Requisitos previos Recomendamos usar un buzón compartido dedicado, como `realmjoin-report@contoso.com`. Este buzón se utilizará como dirección del remitente para todos los informes. Puede usar una dirección sin respuesta, ya que no se espera que los destinatarios respondan a los informes automatizados. > **Nota:** La dirección del remitente debe ser un usuario o un buzón compartido: un grupo de Microsoft 365 no puede enviar correo a través de la API de Microsoft Graph. Las direcciones de grupo como destinatarios de informes **destinatarios** funcionan técnicamente, pero no se recomiendan: que los miembros reciban realmente el correo depende de la configuración de seguimiento/suscripción del grupo, y los fallos de entrega solo son visibles como informes de no entrega en el buzón del remitente. ### Configuración Como se describe en detalle en la [personalización basada en JSON](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) documentación, navegue a [Personalización de RealmJoin Runbook](https://portal.realmjoin.com/settings/runbooks-customizations) en el Portal de RealmJoin (Settings > Runbook Customizations). En el `bloque de Configuración` bloque, agregue o modifique la `RJReport` sección para incluir la `EmailSender` propiedad con la dirección de correo electrónico del remitente que desee: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com" } } } ``` Reemplace `realmjoin-report@contoso.com` con la dirección real de su buzón compartido. ### Información de contacto del Service Desk (opcional) Esta configuración central solo proporciona los valores unificados del Service Desk para todos los runbooks. Que la información de contacto se incluya realmente en un correo de notificación lo determina el propio runbook correspondiente: solo los runbooks que implementan los parámetros del Service Desk correspondientes (p. ej. `ServiceDeskDisplayName`, `ServiceDeskPortalUrl`) leen estos valores y los muestran en sus correos. Para proporcionar la información de contacto del Service Desk para estos runbooks, agregue las siguientes propiedades a la `RJReport` sección: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com", "ServiceDesk_DisplayName": "Mesa de servicio de TI", "ServiceDesk_EMail": "servicedesk@domain.com", "ServiceDesk_Phone": "+49123456789", "ServiceDesk_PortalUrl": "https://servicedesk.domain.com" } } } ``` **Parámetros:** * `ServiceDesk_DisplayName` — Nombre visible de su Service Desk (p. ej., "Soporte de TI", "Mesa de ayuda") * `ServiceDesk_EMail` — Dirección de correo electrónico del Service Desk (se muestra como un `mailto:` enlace) * `ServiceDesk_Phone` — Número de teléfono del Service Desk en formato internacional (se muestra como un `tel:` enlace) * `ServiceDesk_PortalUrl` — URL del portal o sitio web de su Service Desk (se muestra como un enlace clicable) Todos los parámetros son opcionales. Si se configuran, aparecerán en el pie de página del correo como enlaces clicables. > **Nota:** Algunos runbooks además aceptan un enlace de ticket por ejecución (p. ej., `ServiceDeskTicketUrl`) para hacer referencia al ticket específico que activó la solicitud. Este es un parámetro del runbook, no parte de esta configuración central. ### Identidad visual del correo electrónico (opcional) Los correos de informe pueden llevar una identidad visual específica del Tenant: los gráficos predeterminados de encabezado y pie de página de RealmJoin pueden reemplazarse por sus propias imágenes, la imagen del pie de página puede enlazar a un destino personalizado — por ejemplo, su intranet o portal de TI — y los colores de la plantilla pueden ajustarse a su diseño corporativo. Para configurar la identidad visual, agregue una `Branding` subsección al `RJReport` bloque (anidada como `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" } } } } ``` **Parámetros:** | Configuración | Requerido | Predeterminado | Descripción | | ---------------- | --------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | `HeaderImageUrl` | no | gráfico de encabezado de RealmJoin | URL HTTPS pública de una imagen de encabezado personalizada que reemplaza el gráfico de encabezado predeterminado de RealmJoin | | `FooterImageUrl` | no | gráfico de pie de página de RealmJoin | URL HTTPS pública de una imagen de pie de página personalizada que reemplaza el gráfico de pie de página predeterminado de RealmJoin | | `FooterLink` | no | `https://www.realmjoin.com` | URL a la que enlaza la imagen del pie de página | | `AccentColor` | no | `#f8842c` (naranja de RealmJoin) | Color de acento de la plantilla de correo: filas de encabezado de tabla, botones de acción, bordes de acento de los cuadros de información | | `TextColor` | no | `#011e33` (azul marino de RealmJoin) | Color primario del texto de la plantilla de correo: texto del cuerpo, encabezados, elementos de lista, código | **Requisitos de la imagen:** * La imagen debe ser accesible mediante una **URL HTTPS pública** — por ejemplo, un contenedor de Azure Blob Storage con acceso de lectura anónimo, una CDN o el sitio web de la empresa. También funciona una URL que contenga un SAS Token y mantiene el contenedor privado. * Formatos admitidos: **PNG, JPEG o GIF**. El formato se detecta a partir de la firma del archivo, no de la extensión del archivo. * Las imágenes se renderizan a **750 px de ancho**. Las dimensiones recomendadas son **750×200 px** (coincidiendo con los banners predeterminados) o **1500×400 px** para pantallas de alta densidad de píxeles. * Máximo **200 KB** por imagen; **100 KB o menos** se recomienda. Las imágenes de identidad visual comparten el límite total de tamaño del correo de \~4 MB con los archivos adjuntos del informe (a modo de comparación, los gráficos predeterminados de RealmJoin son de 52 KB y 15 KB). **Requisitos de color:** * Los valores deben ser colores hexadecimales de 6 dígitos, incluido el `#` — por ejemplo `#0052cc`. Los formatos abreviados (`#05c`) y los nombres de color (`rojo`) no son compatibles. * Tanto los correos como sus adjuntos se leen en **y** modo claro/oscuro: elija un color de texto que siga siendo legible sobre una tarjeta de contenido blanca, y un color de acento con suficiente contraste frente al texto blanco de los botones. * Los colores de estado (verde/rojo/ámbar para los estados de éxito, error y advertencia) y los grises neutros no son configurables deliberadamente: transmiten un significado que no debe cambiar por Tenant. Las imágenes se descargan y validan por el runbook en cada ejecución. Si se deja una configuración vacía, se usan el gráfico, el color y el enlace del pie de página predeterminados de RealmJoin. Si una descarga falla, una imagen no es válida o un color no es un valor hexadecimal válido, se registra una advertencia y se usa el valor predeterminado correspondiente en su lugar: una configuración de identidad visual defectuosa nunca impide que se envíe un correo de informe. Todas las configuraciones son opcionales y surten efecto para todos los runbooks que envían correos de informe. > **Nota:** Las configuraciones de color requieren **RealmJoin.RunbookHelper 0.8.9** o una versión posterior en la Automation Account. Con versiones anteriores del módulo, las configuraciones de imagen siguen aplicándose y los colores se ignoran. ## Entrega a Storage Account Los runbooks de informes que admiten este canal de entrega pueden cargar su salida en un contenedor de Azure Blob Storage. Tras una carga correcta, el runbook devuelve un enlace SAS limitado en el tiempo que puede usarse para descargar el archivo directamente. Este canal puede usarse independientemente de la entrega por correo electrónico o además de ella. ### Requisitos previos Se requiere una Azure Storage Account existente. La identidad administrada de la Automation Account (o el Service Principal usado por los runbooks) necesita al menos **Storage Blob Data Contributor** permisos en la Azure Storage Account o en su grupo de recursos. ### Configuración Navegue a [Personalización de RealmJoin Runbook](https://portal.realmjoin.com/settings/runbooks-customizations) y agregue un `StorageAccount` subsección al `RJReport` bloque: ```json { "Settings": { "RJReport": { "StorageAccount": { "ResourceGroup": "rg-reports", "StorageAccountName": "stcontosoreports", "LinkExpiryDays": 6 } } } } ``` **Parámetros:** | Configuración | Requerido | Predeterminado | Descripción | | ------------------------------- | --------- | -------------- | ------------------------------------------------------------------ | | `Grupo de recursos` | sí | — | Grupo de recursos que contiene la Storage Account | | `Nombre de la StorageAccount` | sí | — | Nombre de la Azure Storage Account | | `Días de expiración del enlace` | no | `6` | Número de días hasta que expire el enlace de descarga SAS generado | > **Nota:** Las configuraciones específicas de un runbook individual — como el nombre del contenedor de destino o un nombre de blob personalizado — se configuran directamente en ese runbook y, de forma intencional, no forman parte de esta configuración central. Lo mismo aplica al prefijado del nombre del blob: si se antepone un prefijo de marca de tiempo (`yyyyMMdd-HHmmss`) al nombre del blob para evitar sobrescrituras está controlado por el `AddBlobNamePrefix` parámetro de [`Publish-RjRbFilesToStorageContainer`](/es/dev-reference/report-functions/publish-rjrbfilestostoragecontainer.md) (predeterminado `$false`), que cada runbook pasa explícitamente. ## Ejemplo combinado El siguiente fragmento muestra una `RJReport` configuración completa con todas las funciones habilitadas: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com", "ServiceDesk_DisplayName": "Mesa de servicio de TI", "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/es/automatizacion/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.