> 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 runbooks ## Descripción general Varios runbooks de RealmJoin 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 remitente configurada * **cargados en un Storage Account de Azure** — y puestos a disposición mediante un enlace de descarga SAS con tiempo limitado Compatibilizar ambos canales de entrega es el estándar previsto para todos los runbooks de informes de ahora en adelante. Es posible que todavía no todos los runbooks de informes admitan ambos canales, pero el conjunto de runbooks compatibles crece continuamente. Ambos canales pueden habilitarse de forma independiente o en combinación. Todas las configuraciones compartidas se configuran una sola vez en [RealmJoin Runbook Customization](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 respectivo. 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 módulo **RealmJoin.RunbookHelper** de PowerShell. Consulte [Funciones de informe](/es/dev-reference/report-functions.md) para obtener 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 usará como dirección 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. ### Configuración Como se describe en detalle en la documentación de [Personalización basada en JSON](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) navegue a [RealmJoin Runbook Customization](https://portal.realmjoin.com/settings/runbooks-customizations) en el Portal de RealmJoin (Settings > Runbook Customizations). En el bloque `Settings` agregue o modifique la sección `RJReport` para incluir la propiedad `EmailSender` con la dirección de correo electrónico remitente deseada: ```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 de Service Desk para todos los runbooks. Si la información de contacto se incluye realmente en un correo de notificación lo determina el propio runbook correspondiente; solo los runbooks que implementan los parámetros de Service Desk correspondientes (por ejemplo, `ServiceDeskDisplayName`, `ServiceDeskPortalUrl`) leen estos valores y los muestran en sus correos electrónicos. Para proporcionar la información de contacto del Service Desk para estos runbooks, agregue las siguientes propiedades a la sección `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" } } } ``` **Parámetros:** * `ServiceDesk_DisplayName` — Nombre visible de su Service Desk (por ejemplo, "IT Support", "Help Desk") * `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 electrónico como enlaces clicables. > **Nota:** Algunos runbooks además aceptan un enlace por ejecución a un ticket (por ejemplo, `ServiceDeskTicketUrl`) para hacer referencia al ticket específico que desencadenó la solicitud. Este es un parámetro del runbook, no parte de esta configuración central. ## Entrega de 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 con tiempo limitado que puede utilizarse para descargar el archivo directamente. Este canal puede utilizarse de forma independiente o además de la entrega por correo electrónico. ### Requisitos previos Se requiere un Azure Storage Account existente. La identidad administrada de la cuenta de automatización (o el Service Principal usado por los runbooks) necesita al menos **Storage Blob Data Contributor** permisos en el Storage Account o en su grupo de recursos. ### Configuración Vaya a [RealmJoin Runbook Customization](https://portal.realmjoin.com/settings/runbooks-customizations) y agregue una sub-sección `StorageAccount` al bloque `RJReport` : ```json { "Settings": { "RJReport": { "StorageAccount": { "ResourceGroup": "rg-reports", "StorageAccountName": "stcontosoreports", "LinkExpiryDays": 6, "AddBlobNamePrefix": true, "UseRandomPrefix": false } } } } ``` **Parámetros:** | Configuración | Requerido | Predeterminado | Descripción | | -------------------- | --------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ResourceGroup` | sí | — | Grupo de recursos que contiene el Storage Account | | `StorageAccountName` | sí | — | Nombre del Azure Storage Account | | `LinkExpiryDays` | no | `6` | Número de días hasta que caduca el enlace de descarga SAS generado | | `AddBlobNamePrefix` | no | `true` | Antepone una marca de tiempo (`yyyyMMdd-HHmmss`) al nombre del blob para evitar sobrescrituras | | `UseRandomPrefix` | no | `false` | Usa una cadena aleatoria alfanumérica de 6 caracteres como prefijo en lugar de una marca de tiempo; solo se aplica cuando `AddBlobNamePrefix` es `true` | > **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, a propósito, no forman parte de esta configuración central. ## Ejemplo combinado El siguiente fragmento muestra una configuración `RJReport` completa con todas las características habilitadas: ```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", "StorageAccount": { "ResourceGroup": "rg-reports", "StorageAccountName": "stcontosoreports", "LinkExpiryDays": 6, "AddBlobNamePrefix": true, "UseRandomPrefix": false } } } } ``` --- # 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.