Destinos de Relatórios eletrónicos (ER)
Pode configurar um destino para cada configuração de formato de Relatórios eletrónicos (ER) e o respetivo componente de saída (uma pasta ou um ficheiro). Os utilizadores que tenham direitos de acesso adequados também podem modificar as definições do destino no tempo de execução. Este tópico explica a gestão de destinos de ER, os tipos de destinos que são suportados, e considerações de segurança.
As configurações de formato de ER geralmente contêm pelo menos um componente de saída: um ficheiro. Normalmente, as configurações contêm vários componentes de saída de ficheiros de diferentes tipos (por exemplo, XML, TXT, XLSX, DOCX ou PDF) que são agrupados numa única pasta ou em várias pastas. A gestão de destinos de ER permite-lhe pré-configurar o que ocorre quando cada componente é executado. Por predefinição, quando uma configuração é executada, aparece uma caixa de diálogo que permite guardar ou abrir o ficheiro. O mesmo comportamento também ocorre quando importa uma configuração de ER e não configura nenhum destino específico para a mesma. Depois de um destino ser criado para um componente de saída principal, esse destino substitui o comportamento predefinido, e a pasta ou o ficheiro é enviado de acordo com as definições do destino.
Disponibilidade e pré-requisitos gerais
A funcionalidade para destinos de ER não está disponível no Microsoft Dynamics AX 7.0 (fevereiro de 2016). Por isso, tem de instalar a versão 1611 do Microsoft Dynamics 365 for Operations (novembro de 2016) ou posterior para utilizar os seguintes tipos de destino:
Em alternativa, pode instalar um dos seguintes pré-requisitos. No entanto, tenha em atenção que estas alternativas proporcionam uma experiência de destinos de ER mais limitada.
- Versão de aplicação Microsoft Dynamics AX 7.0.1 (maio de 2016)
- Correção de aplicação de gestão de destinos de Relatórios eletrónicos
Há também um tipo de destino Imprimir. Para a utilizar, tem de instalar a versão 10.0.9 do Microsoft Dynamics 365 Finance (abril de 2020).
Descrição Geral
Pode configurar destinos apenas para configurações de ER que tenham sido importadas para a instância de Finanças atual, e para os formatos que estão disponíveis na página Configurações de relatórios eletrónicos. A funcionalidade para a gestão de destinos de ER está disponível em Administração da organização > Relatórios eletrónicos > Destino de relatórios eletrónicos.
Comportamento predefinido
O comportamento predefinido para uma configuração de formato de ER depende do tipo de execução que especifica quando um formato de ER se inicia.
Na caixa de diálogo Relatório Intrastat, no Separador Rápido Executar em segundo plano, se definir a opção Processamento em lote como Não, um formato de ER é executado imediatamente no modo interativo. Quando esta execução estiver concluída com êxito, um documento de saída gerado é disponibilizado para transferência.
Se definir a opção Processamento em lote como Sim, um formato de ER é executado no modo de lote. A tarefa de lote apropriada é criada, com base nos parâmetros que especifica no separador Executar em segundo plano da caixa de diálogo Parâmetros de ER.
Nota
A descrição da tarefa informa-o sobre a execução de um mapeamento de formato de ER. Contém também o nome do componente de ER que é executado.
Pode encontrar informações sobre esta tarefa em vários locais:
Aceda a Comum > Consultas > Tarefas de lote > As minhas tarefas de lote para verificar o estado da tarefa agendada.
Aceda a Administração da organização > Relatórios eletrónicos > Tarefas de relatórios eletrónicos para verificar o estado da tarefa agendada e os resultados da execução da tarefa concluída. Quando a execução da tarefa estiver concluída com êxito, selecione Mostrar ficheiros na página Tarefas de relatórios eletrónicos para obter um documento de saída gerado.
Nota
Este documento é armazenado como um anexo do registo da tarefa atual e é controlado pela estrutura Gestão de documentos. O tipo de documento que é utilizado para armazenar artefactos ER deste tipo é configurado nos parâmetros de ER.
Na página Tarefas de relatórios eletrónicos, selecione Mostrar ficheiros para visualizar a lista de quaisquer erros e avisos gerados durante a execução da tarefa.
Comportamento configurado pelo utilizador
Na página Destino de relatórios eletrónicos, pode substituir o comportamento predefinido para uma configuração. As configurações importadas não são mostradas nesta página até que selecione Novo e, em seguida, no campo Referência, selecione uma configuração para criar definições de destino.
Depois de criar uma referência, pode criar um destino de ficheiro para cada componente de saída Pasta ou Ficheiro do formato de ER referenciado.
Em seguida, na caixa de diálogo de Definições de destino, pode ativar e desativar destinos individuais para o destino do ficheiro. O botão Definições é utilizado para controlar todos os destinos para um destino de ficheiro selecionado. Na caixa de diálogo Definições de destino, pode controlar cada destino separadamente definindo a opção Ativado para o mesmo.
Nas versões de Finanças anteriores à versão 10.0.9, pode criar um destino de ficheiro para cada componente de saída do mesmo formato, como uma pasta ou um ficheiro selecionado no campo Nome do Ficheiro. No entanto, na versão 10.0.9 e posteriores, pode criar vários destinos de ficheiros para cada componente de saída do mesmo formato.
Por exemplo, pode utilizar esta capacidade para configurar destinos de ficheiro para um componente de ficheiro que é utilizado para gerar um documento de saída em formato Excel. Um destino (Arquivo) pode ser configurado para armazenar o ficheiro Excel original no ficheiro de tarefas de ER, e outro destino (E-mail) pode ser configurado para converter simultaneamente o ficheiro Excel em formato PDF e enviar o ficheiro PDF por e-mail.
Quando executa um formato de ER, todos os destinos que foram configurados para componentes do formato são sempre executados. Além disso, na versão 10.0.17 e posteriores de Finanças, a funcionalidade de destinos de ER foi melhorada e permite agora configurar diferentes conjuntos de destinos para um único formato de ER. Esta configuração marca cada conjunto como configurado para uma determinada ação do utilizador. A API ER foi alargada para que possa ser fornecida uma ação que é efetuada pelo utilizador ao executar um formato de ER. O código de ação fornecido é transmitido aos destinos de ER. Pode executar diferentes destinos de um formato de ER, dependendo do código de ação fornecido. Para mais informações, consulte Configurar destinos de ER dependentes da ação.
Tipos de destino
Os destinos seguintes são atualmente suportados para formatos de ER. Pode desativar ou ativar todos os tipos ao mesmo tempo. Deste modo, pode não fazer nada ou enviar o componente para todos os destinos configurados.
Aplicabilidade
Pode configurar destinos apenas para configurações de ER que tenham sido importadas e para os formatos que estão disponíveis na página Configurações de relatórios eletrónicos.
Nota
Os destinos configurados são específicos da empresa. Se pretender utilizar um formato de ER em diferentes empresas da atual instância de Finanças, tem de configurar destinos para esse formato de ER para cada uma dessas empresas.
Ao configurar destinos de ficheiros para um formato selecionado, configura-os para todo o formato.
Ao mesmo tempo, pode ter várias versões do formato que foram importadas para a atual instância de Finanças. Pode vê-las se selecionar a ligação Configuração que é disponibilizada quando seleciona o campo Referência.
Por predefinição, os destinos configurados só são aplicados quando executa uma versão do formato de ER que tem o estado Concluído ou Partilhado. No entanto, por vezes tem de utilizar destinos configurados quando a versão de rascunho de um formato de ER é executada. Por exemplo, modifica uma versão de rascunho do seu formato e pretende utilizar destinos configurados para testar como a saída gerada será entregue. Siga estes passos para aplicar destinos a um formato de ER quando é executada a versão de rascunho.
- Vá para Administração da organização > Relatórios eletrónicos > Configurações.
- Na página Configurações, no Painel de Ações, no separador Configurações, no grupo Definições avançadas, selecione Parâmetros de utilizador.
- Defina a opção Utilizar destinos para o estado de rascunho como Sim.
Para utilizar a versão de rascunho de um formato de ER, tem de marcar o formato de ER em conformidade.
- Vá para Administração da organização > Relatórios eletrónicos > Configurações.
- Na página Configurações, no Painel de Ações, no separador Configurações, no grupo Definições avançadas, selecione Parâmetros de utilizador.
- Defina a opção Executar definição como Sim.
Depois de concluir esta configuração, a opção Executar rascunho fica disponível para os formatos de ER que modifica. Defina esta opção como Sim para começar a utilizar a versão de rascunho do formato quando o formato é executado.
Processamento de falha no destino
Normalmente, um formato de ER é executado no âmbito de um processo de negócio específico. No entanto, a entrega de um documento de saída gerado durante a execução de um formato de ER tem por vezes de ser considerada parte desse processo de negócio. Neste caso, se a entrega de um documento de saída gerado a um destino configurado não for bem sucedida, a execução do processo de negócio tem de ser cancelada. Para configurar o destino de ER apropriado, selecione a opção Parar processamento em caso de falha.
Por exemplo, configura o processamento de pagamentos a fornecedores de modo que o formato de ER Transferência de Crédito ISO20022 seja executado para gerar o ficheiro de pagamento e documentos suplementares (por exemplo, a carta de apresentação e o relatório de controlo). Se um pagamento dever ser considerado como processado com êxito apenas se a carta de apresentação for entregue com êxito por e-mail, tem de selecionar a caixa de verificação Parar processamento em caso de falha para o componente CoveringLetter no destino de ficheiro apropriado, conforme mostrado na ilustração seguinte. Neste caso, o estado do pagamento selecionado para processamento será alterado de Nenhum para Enviado apenas quando a carta de apresentação gerada for aceite com êxito para entrega por um fornecedor de e-mail que esteja configurado na instância de Finanças.
Se desmarcar a caixa de verificação Parar processamento em caso de falha para o componente CoveringLetter no destino, um pagamento será considerado como processado com êxito mesmo que a carta de apresentação não seja entregue com êxito por e-mail. O estado do pagamento será alterado de Nenhum para Enviado mesmo que a carta de apresentação não possa ser enviada porque, por exemplo, o endereço de e-mail do destinatário ou do remetente está em falta ou incorreto.
Conversão de saída para PDF
Pode utilizar a opção de conversão para PDF para converter a saída em formato Microsoft Office (Excel ou Word) para formato PDF.
Disponibilizar conversão para PDF
Para disponibilizar a opção de conversão para PDF na instância de Finanças atual, abra a área de trabalho Gestão de funcionalidades e ative a funcionalidade Converter documentos de saída de Relatórios Eletrónicos em formatos Microsoft Office para PDF.
Aplicabilidade
Nas versões de Finanças anteriores à versão 10.0.18, a opção de conversão para PDF só pode ser ativada para componentes Ficheiro\Excel utilizados para gerar saídas em formato do Office (Excel ou Word). Quando esta opção é ativada, a saída que é gerada em formato do Office é automaticamente convertida para formato PDF. No entanto, na versão 10.0.18 e posteriores, também pode ativar esta opção para componentes do tipo Ficheiro\Comum.
Nota
Preste atenção à mensagem de aviso que recebe quando ativa a opção de conversão para PDF para um componente de ER do tipo Ficheiro\Comum. Esta mensagem informa-o de que não existe maneira de garantir, no momento da estrutura, que o componente de ficheiro selecionado irá expor o conteúdo em formato PDF ou o conteúdo convertível para PDF no tempo de execução. Por esse motivo, só deve ativar a opção se tiver a certeza de que o componente de ficheiro selecionado foi configurado para expor o conteúdo em formato PDF ou o conteúdo convertível para PDF no tempo de execução.
Se ativar a opção de conversão para PDF para um componente de formato, se esse componente expuser o conteúdo num formato diferente de PDF e se o conteúdo exposto não puder ser convertido para formato PDF, ocorrerá uma exceção no tempo de execução. A mensagem que recebe informa-o de que o conteúdo gerado não pode ser convertido para formato PDF.
Limitações
A opção de conversão para PDF está disponível apenas para implementações na cloud.
O documento PDF que é produzido é limitado a um comprimento máximo de 300 páginas.
Na versão 10.0.9 de Finanças, apenas a orientação horizontal da página é suportada no documento PDF que é produzido a partir da saída em Excel. Na versão 10.0.10 (maio 2020) e posteriores de Finanças, pode especificar a orientação da página do documento PDF que é produzido a partir da saída do Excel enquanto configura um destino de ER.
Apenas os tipos de letra comuns do sistema operativo Window são utilizados para converter saídas que não contêm tipos de letra incorporados.
Utilizar a opção de conversão para PDF
Para ativar a conversão para PDF para um destino de ficheiro, selecione a caixa de verificação Converter para PDF.
Selecione uma orientação da página para conversão para PDF
Se gerar uma configuração de ER no formato Excel e quiser convertê-la para formato PDF, pode especificar explicitamente a orientação da página do documento PDF. Quando selecionar a caixa de verificação Converter para PDF para ativar a conversão para PDF para um destino de ficheiro que produz um ficheiro de saída no formato Excel, o campo Orientação da página fica disponível no Separador Rápidos Definições de conversão para PDF. No campo Orientação da página, pode selecionar a orientação preferencial.
Para ter a opção de selecionar a orientação da página do PDF, instale a versão de Finanças 10.0.10 ou posterior. Nas versões de Finanças anteriores à versão 10.0.23, esta opção oferece as seguintes opções de orientação da página:
- Vertical
- Horizontal
A orientação da página selecionada é aplicada a todas as páginas de um documento de saída que é gerado em formato Excel e, em seguida, convertido para formato PDF.
No entanto, na versão 10.0.23 e posterior, a lista de opções de orientação da página foi alargada da seguinte forma:
- Vertical
- Horizontal
- Específica da folha de cálculo
Quando seleciona a opção Específica da folha de cálculo, todas as folhas de cálculo de um livro do Excel gerado são convertidas para PDF utilizando a orientação da página que foi configurada para esta folha de cálculo no modelo Excel utilizado. Por conseguinte, pode ter um documento PDF final contendo páginas com orientação vertical e horizontal.
Se uma configuração de ER em formato Word for convertida para formato PDF, a orientação da página do documento PDF é sempre retirada do documento Word.
Desdobramento de saída
Quando configura um destino para o componente Pasta do seu formato de ER, pode especificar como a saída desse componente é entregue no destino configurado.
Disponibilizar o desdobramento de saída
Para disponibilizar a opção de desdobramento de saída na instância de Finanças atual, abra a área de trabalho Gestão de funcionalidades e ative a funcionalidade Permitir a configuração de destinos de ER para enviar conteúdos de pastas como ficheiros separados.
Aplicabilidade
A opção de desdobramento de saída só pode ser configurada para os componentes de formato do tipo Pasta. Quando começa a configurar um componente Pasta, o Separador Rápido Geral fica disponível na página Destino de relatórios eletrónicos.
Utilizar a opção de desdobramento de saída
No Separador Rápido Geral, no campo Enviar pasta como, selecione um dos seguintes valores:
Arquivo Zip – Entrega um ficheiro gerado como ficheiro zip.
Ficheiros separados – Entrega todos os ficheiros de um ficheiro zip gerado como ficheiros individuais.
Nota
Quando seleciona Ficheiros separados, a saída gerada é recolhida na memória em estado comprimido. Assim, o limite de tamanho máximo do ficheiro é aplicado para a saída comprimida quando o tamanho real do ficheiro pode exceder este limite. Recomendamos que selecione este valor quando espera que o tamanho da saída gerada seja bastante grande.
Limitações
Se definir o campo Enviar pasta como para Ficheiros separados para um componente Pasta que contenha outros componentes Pasta aninhados, a definição não é aplicada de forma recursiva aos componentes Pasta aninhados.
Considerações de segurança
São utilizados dois tipos de privilégios e deveres para destinos de ER. Um tipo controla a capacidade geral de um utilizador de manter os destinos que são configurados para uma entidade legal (isto é, controla o acesso à página Destinos de relatórios eletrónicos). O outro tipo controla a capacidade de um utilizador de aplicação de substituir, em tempo de execução, as definições de destino que um programador de ER ou consultor funcional ER configurou.
| Função (nome AOT) | Nome da função | Dever (nome AOT) | Nome do direito |
|---|---|---|---|
| ERDeveloper | Programador de relatórios eletrónicos | ERFormatDestinationConfigure | Configurar destino do formato de relatórios eletrónicos |
| ERFunctionalConsultant | Consultor funcional de relatórios eletrónicos | ERFormatDestinationConfigure | Configurar destino do formato de relatórios eletrónicos |
| PaymAccountsPayablePaymentsClerk | Assistente de pagamentos de contas a pagar | ERFormatDestinationRuntimeConfigure | Configurar o destino do formato de relatórios eletrónicos durante a execução |
| PaymAccountsReceivablePaymentsClerk | Assistente de pagamentos de contas a receber | ERFormatDestinationRuntimeConfigure | Configurar o destino do formato de relatórios eletrónicos durante a execução |
Nota
São utilizados dois privilégios nos deveres anteriores. Estes privilégios têm os mesmos nomes que os deveres correspondentes: ERFormatDestinationConfigure e ERFormatDestinationRuntimeConfigure.
Perguntas frequentes
Importei configurações eletrónicas e vejo-as na página de configurações de relatórios eletrónicos. Mas por que não as vejo na página Destinos de relatórios eletrónicos?
Certifique-se de que seleciona Novo e, em seguida, seleciona uma configuração no campo Referência. A página Destinos de relatórios eletrónicos mostra apenas configurações para as quais foram configurados destinos.
Existe alguma maneira de definir que Conta de armazenamento do Microsoft Azure e Armazenamento de Blobs do Azure são utilizadas?
Não. É utilizado o Armazenamento de Blobs do Microsoft Azure predefinido que é definido e utilizado para o sistema de gestão de documentos.
Qual é o propósito do Destino de ficheiros nas definições de destino? O que faz esta configuração?
O destino Ficheiro é utilizado para controlar uma caixa de diálogo do seu browser quando executa um formato de ER em modo interativo. Se ativar este destino ou se não for definido nenhum destino para uma configuração, aparece no seu browser uma caixa de diálogo para abrir ou guardar após a criação de um ficheiro de saída.
Pode dar um exemplo da fórmula que se refere a uma conta de fornecedor à qual posso enviar e-mail?
A fórmula é específica da configuração de ER. Por exemplo, se utilizar a configuração de Transferência de Crédito ISO 20022, pode utilizar '$PaymentsForCoveringLetter'.Creditor.Identification.SourceID ou model.Payments.Creditor.Identification.SourceID para obter uma conta de fornecedor associada.
Uma das minhas configurações de formato contém vários ficheiros que estão agrupados numa pasta (por exemplo, a Pasta1 contém o Ficheiro1, o Ficheiro2 e o Ficheiro3). Como posso configurar destinos para que a Pasta1.zip não seja criada de todo, o Ficheiro1 seja enviado por e-mail, o Ficheiro2 seja enviado para o SharePoint e eu possa abrir o Ficheiro3 imediatamente após a configuração ser executada?
O seu formato deve estar primeiro disponível nas configurações de ER. Se este pré-requisito for cumprido, abra a página Destino de relatórios eletrónicos e crie uma nova referência à configuração. Em seguida, deve ter quatro destinos de ficheiro, um para cada componente de saída. Crie o primeiro destino de ficheiro, dê-lhe um nome como Pasta e selecione um nome de ficheiro que represente uma pasta na sua configuração. Em seguida, selecione Definições e certifique-se de que todos os destinos estão desativados. Para este destino de ficheiro, a pasta não será criada. Por predefinição, devido às dependências hierárquicas entre ficheiros e pastas principais, os ficheiros irão comportar-se da mesma forma. Por outras palavras, não serão enviados para lado nenhum. Para anular esse comportamento predefinido, tem de criar mais três destinos de ficheiros, um para cada ficheiro. Nas definições de destino de cada, deve ativar o destino para o que o ficheiro deve ser enviado.