> 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/pt/automacao/runbooks/runbook-report-settings.md). # Definições de relatório de Runbook ## Visão geral Vários runbooks do RealmJoin incluem funcionalidades automatizadas de relatórios para entregar relatórios, notificações e alertas diretamente aos administradores. Dependendo da configuração, os relatórios podem ser: * **enviados por e-mail** — usando a API do Microsoft Graph em nome de um endereço de remetente configurado * **carregados para uma Storage Account do Azure** — e disponibilizados como um link de download SAS com tempo limitado Dar suporte a ambos os canais de entrega é o padrão pretendido para todos os runbooks de relatórios daqui em diante. Nem todos os runbooks de relatórios ainda podem oferecer suporte a ambos os canais, mas o conjunto de runbooks suportados está em constante crescimento. Ambos os canais podem ser ativados de forma independente ou em combinação. Todas as definições partilhadas são configuradas uma única vez no [Personalização de Runbook do RealmJoin](https://portal.realmjoin.com/settings/runbooks-customizations) e aplicam-se automaticamente a todos os runbooks que usam a respetiva funcionalidade. As definições que diferem por runbook (como o nome do contentor de destino) não fazem parte desta configuração central e são definidas diretamente no respetivo runbook. As funções que consomem essas definições — [`Send-RjRbReportEmail`](/pt/dev-reference/report-functions/send-rjrbreportemail.md) e [`Publish-RjRbFilesToStorageContainer`](/pt/dev-reference/report-functions/publish-rjrbfilestostoragecontainer.md) — são fornecidas pelo **RealmJoin.RunbookHelper** módulo PowerShell. Consulte [Funções de relatório](/pt/dev-reference/report-functions.md) para documentação detalhada de utilização. ## Entrega por e-mail ### Pré-requisitos Recomendamos o uso de uma caixa de correio partilhada dedicada, como `realmjoin-report@contoso.com`. Esta caixa de correio será usada como endereço do remetente para todos os relatórios. Pode usar um endereço sem resposta, uma vez que não se espera que os destinatários respondam a relatórios automatizados. ### Configuração Conforme descrito em detalhe na [Personalização baseada em JSON](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) documentação, navegue até [Personalização de Runbook do RealmJoin](https://portal.realmjoin.com/settings/runbooks-customizations) no Portal do RealmJoin (Definições > Personalizações de Runbook). No `Definições` bloco, adicione ou modifique a `RJReport` secção para incluir a `EmailSender` propriedade com o endereço de e-mail do remetente pretendido: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com" } } } ``` Substitua `realmjoin-report@contoso.com` pelo endereço real da sua caixa de correio partilhada. ### Informações de contacto do Service Desk (opcional) Para incluir informações de contacto do Service Desk em e-mails de notificação, adicione as seguintes propriedades à `RJReport` secção: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com", "ServiceDesk_DisplayName": "Service Desk de TI", "ServiceDesk_EMail": "servicedesk@domain.com", "ServiceDesk_Phone": "+49123456789" } } } ``` **Parâmetros:** * `ServiceDesk_DisplayName` — Nome de exibição do seu Service Desk (por exemplo, "Suporte de TI", "Central de ajuda") * `ServiceDesk_EMail` — Endereço de e-mail do Service Desk (mostrado como um `mailto:` link clicável) * `ServiceDesk_Phone` — Número de telefone do Service Desk em formato internacional (mostrado como um link clicável `tel:` link clicável) Todos os três parâmetros são opcionais. Se configurados, aparecerão no rodapé do e-mail como links clicáveis. ## Entrega para Storage Account Os runbooks de relatórios que suportam este canal de entrega podem carregar a sua saída para um contentor do Azure Blob Storage. Após um carregamento bem-sucedido, o runbook devolve um link SAS com tempo limitado que pode ser usado para descarregar o ficheiro diretamente. Este canal pode ser usado de forma independente ou em adição à entrega por e-mail. ### Pré-requisitos É necessária uma Storage Account do Azure existente. A identidade gerida da Automation Account (ou o Service Principal usado pelos runbooks) precisa de, pelo menos **Storage Blob Data Contributor** permissões na Storage Account ou no respetivo grupo de recursos. ### Configuração Navegue até [Personalização de Runbook do RealmJoin](https://portal.realmjoin.com/settings/runbooks-customizations) e adicione uma `StorageAccount` subsecção ao `RJReport` bloco: ```json { "Settings": { "RJReport": { "StorageAccount": { "ResourceGroup": "rg-reports", "StorageAccountName": "stcontosoreports", "LinkExpiryDays": 6, "AddBlobNamePrefix": true, "UseRandomPrefix": false } } } } ``` **Parâmetros:** | Definição | Obrigatório | Predefinição | Descrição | | -------------------- | ----------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `ResourceGroup` | sim | — | Grupo de recursos que contém a Storage Account | | `StorageAccountName` | sim | — | Nome da Storage Account do Azure | | `LinkExpiryDays` | não | `6` | Número de dias até o link de download SAS gerado expirar | | `AddBlobNamePrefix` | não | `verdadeiro` | Acrescenta um carimbo temporal (`yyyyMMdd-HHmmss`) ao nome do blob para evitar sobrescritas | | `UseRandomPrefix` | não | `falso` | Usa uma string aleatória alfanumérica de 6 caracteres como prefixo em vez de um carimbo temporal; aplica-se apenas quando `AddBlobNamePrefix` é `verdadeiro` | > **Nota:** As definições específicas de um runbook individual — como o nome do contentor de destino ou um nome de blob personalizado — são configuradas diretamente nesse runbook e, de forma intencional, não fazem parte desta configuração central. ## Exemplo combinado O seguinte excerto mostra uma configuração completa `RJReport` com todas as funcionalidades ativadas: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com", "ServiceDesk_DisplayName": "Service Desk de TI", "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/pt/automacao/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.