> 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 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 de remitente configurada * **cargados en un Azure Storage Account** — y ponerse a disposición como un enlace de descarga SAS con tiempo limitado Dar soporte a ambos canales de entrega es el estándar previsto para todos los runbooks de informes de aquí en adelante. Es posible que aún 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. Todos los ajustes compartidos se configuran una sola vez en el [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. Los ajustes que difieren según el 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 estos ajustes — [`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. 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 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. ### 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 (Ajustes > Personalizaciones de runbook). En el `Ajustes` 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 { "Ajustes": { "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) Para incluir la información de contacto del Service Desk en los correos electrónicos de notificación, agregue las siguientes propiedades a la `RJReport` sección: ```json { "Ajustes": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com", "ServiceDesk_DisplayName": "IT Service Desk", "ServiceDesk_EMail": "servicedesk@domain.com", "ServiceDesk_Phone": "+49123456789" } } } ``` **Parámetros:** * `ServiceDesk_DisplayName` — Nombre visible de su Service Desk (p. ej., "IT Support", "Help Desk") * `ServiceDesk_EMail` — Dirección de correo electrónico del Service Desk (se muestra como un enlace `mailto:` en el que se puede hacer clic) * `ServiceDesk_Phone` — Número de teléfono del Service Desk en formato internacional (se muestra como un enlace `tel:` en el que se puede hacer clic) Los tres parámetros son opcionales. Si se configuran, aparecerán en el pie del correo electrónico como enlaces en los que se puede hacer clic. ## 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. Después de una carga correcta, el runbook devuelve un enlace SAS con tiempo limitado que puede usarse 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 Automation Account (o el Service Principal utilizado por los runbooks) necesita al menos **Storage Blob Data Contributor** permisos en el 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 una `StorageAccount` subsección al `RJReport` bloque: ```json { "Ajustes": { "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 expire el enlace de descarga SAS generado | | `AddBlobNamePrefix` | no | `verdadero` | Antepone una marca de tiempo (`yyyyMMdd-HHmmss`) al nombre del blob para evitar sobrescrituras | | `UseRandomPrefix` | no | `falso` | Usa una cadena aleatoria alfanumérica de 6 caracteres como prefijo en lugar de una marca de tiempo; solo se aplica cuando `AddBlobNamePrefix` es `verdadero` | > **Nota:** Los ajustes específicos de un runbook individual — como el nombre del contenedor de destino o un nombre personalizado de blob — se configuran directamente en ese runbook y, de forma intencionada, no forman parte de esta configuración central. ## Ejemplo combinado El siguiente fragmento muestra una `RJReport` configuración completa con todas las características habilitadas: ```json { "Ajustes": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com", "ServiceDesk_DisplayName": "IT Service Desk", "ServiceDesk_EMail": "servicedesk@domain.com", "ServiceDesk_Phone": "+49123456789", "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: ``` GET https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-report-settings.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.