Destinos de Relatório eletrônico (ER)
Você pode configurar uma meta para cada configuração de formato de relatório eletrônico (ER)e seu componente de saída (uma pasta ou um arquivo). Os usuários que têm direitos de acesso apropriados também podem modificar configurações de destino em tempo de execução. Este artigo explica gerenciamento de destino do ER, os tipos de destinos que têm suporte e considerações de segurança.
As configurações de formato de ER geralmente contêm pelo menos um componente de saída: um arquivo. Normalmente, as configurações contêm vários componentes de saída de arquivos de diferentes tipos (por exemplo, XML, TXT, XLSX, DOCX ou PDF) que são agrupados em uma única pasta ou em várias pastas. Gerenciamento de destino do ER permite pré-configurar o que ocorre quando cada componente é executado. Por padrão, quando uma configuração é executada, aparece uma caixa de diálogo que permite salvar ou abrir o arquivo. O mesmo comportamento também ocorre quando você importa uma configuração ER e não configura destinos específicos para ele. Após a criação de um destino para um componente de saída principal, esse destino substitui o comportamento padrão e a pasta ou o arquivo é enviado de acordo com as configurações do destino.
Disponibilidade e pré-requisitos gerais
A funcionalidade de destinos de ER não está disponível no Microsoft Dynamics AX 7.0 (fevereiro de 2016). Por isso você deve instalar o Microsoft Dynamics 365 for Operations versão 1611 (novembro a 2016) ou posterior para usar os seguintes tipos de destino:
Se preferir,, você pode instalar um dos seguintes pré-requisitos. Entretanto, essas alternativas proporcionam uma experiência de destino de ER mais limitada.
- Versão 7.0.1 do aplicativo Microsoft Dynamics AX (maio de 2016)
- Hotfix do aplicativo de gerenciamento de destino de relatório eletrônico
Também existe um tipo de destino Impressão. Para usá-lo, você precisa instalar o Microsoft Dynamics 365 Finance versão 10.0.9 (abril de 2020).
Visão geral
Você pode configurar destinos somente para as configurações ER importadas para a instância atual do Finance e para os formatos disponíveis na página Configurações de Relatórios eletrônicos. A funcionalidade de gerenciamento de destino de ER está disponível em Administração da organização>Relatório eletrônico>Destino de relatório eletrônico.
Comportamento padrão
O comportamento padrão de uma configuração de formato ER depende do tipo de execução que você especifica quando um formato ER é iniciado.
Na caixa de diálogo Relatório Intrastat, na Guia Rápida Executar o plano de fundo, se você definir a opção de Processamento em lotes como Não, um formato ER será executado imediatamente no modo interativo. Quando essa execução é concluída com êxito, um documento de saída gerado é disponibilizado para download.
Se você definir a opção de Processamento em lotes como Sim, um formato ER será executado no modo de Lotes. O trabalho em lotes apropriado é criado com base nos parâmetros especificados na guia Executar no plano de fundo da caixa de diálogo Parâmetros de ER.
Observação
A descrição do trabalho informa você sobre a execução de um mapeamento de formato ER. Também contém o nome do componente ER que é executado.
Você pode encontrar informações sobre esse trabalho em vários locais:
Acesse Comum>Consultas>Trabalhos em lotes>Meus trabalhos em lotes para verificar o status da tarefa agendada.
Acesse Administração da organização>Relatório eletrônico>Trabalhos de relatórios eletrônicos para verificar o status do trabalho agendado e os resultados da execução do trabalho concluído. Quando a execução do trabalho for concluída com êxito, selecione Mostrar arquivos na página Trabalhos de relatório eletrônicos para obter um documento de saída gerado.
Observação
Este documento está armazenado como um anexo do registro de trabalho atual e é controlado pela estrutura Gerenciamento de documentos. O tipo de documento usado para armazenar artefatos ER deste tipo é configurado nos parâmetros ER.
Na página Trabalhos de relatório eletrônicos, selecione Mostrar arquivos para exibir a lista de erros e avisos que foram gerados durante a execução do trabalho.
Comportamento configurado pelo usuário
Na página Destino de relatório eletrônico, é possível substituir o comportamento padrão de uma configuração. As configurações importadas não são mostradas nessa página até você selecionar Novo e, no campo Referência, selecionar uma configuração para criar configurações de destino.
Depois de criar uma referência, você pode criar um destino de arquivo para cada componente de saída Pasta ou Arquivo do formato de ER referenciado.
Em seguida, na caixa de diálogo Configurações de destino, você pode habilitar e desabilitar destinos individuais para o destino do arquivo. O botão Configurações é usado para controlar todos os destinos de um destino de arquivo selecionado. Na caixa de diálogo Configurações de destino, você pode controlar cada destino separadamente, definindo a opção Ativado para ele.
Em versões do Finance antes da versão 10.0.9, você pode criar um destino de arquivo para cada componente de saída do mesmo formato, como uma pasta ou um arquivo selecionado no campo Nome do arquivo. No entanto, na versão 10.0.9 e posterior, você pode criar vários destinos de arquivo para cada componente de saída do mesmo formato.
Por exemplo, você pode usar esse recurso para configurar destinos de arquivo para um componente de arquivo usado para gerar um documento de saída no formato Excel. Um destino (Arquivo) pode ser configurado para armazenar o arquivo do Excel original no arquivo de trabalhos de ER, e outro destino (Email) pode ser configurado para simultaneamente converter o arquivo do Excel em formato PDF e enviar o arquivo PDF por email.
Quando você executa um formato de ER, todos os destinos que foram configurados para componentes do formato são sempre executados. Além disso, no Finance versão 10.0.17 e posterior, a funcionalidade de destinos de ER foi aperfeiçoada e agora permite que você configure conjuntos diferentes de destinos para um único formato de ER. Essa configuração marca cada conjunto como configurado para uma ação de usuário específica. A API de ER foi estendida para que seja possível fornecer uma ação que o usuário realiza executando um formato de ER. O código de ação fornecido é passado para destinos de ER. Você pode executar diferentes destinos de um formato de ER, dependendo do código de ação fornecido. Para obter mais informações, consulte Configurar destinos de ER dependentes da ação.
Tipos de destino
No momento, os destinos a seguir são aceitos para os formatos de ER. Você pode desativar ou ativar todos os tipos ao mesmo tempo. Dessa forma, você pode não fazer nada ou enviar o componente para todos os destinos configurados.
Aplicabilidade
Você pode configurar destinos somente para configurações ER que foram importadas e para os formatos que estão disponíveis na página Configurações de relatório eletrônicas.
Observação
Os destinos configurados são específicos da empresa. Se você planeja usar um formato de ER em diferentes empresas da instância atual do Finance, deve configurar destinos para esse formato de ER para cada uma dessas empresas.
Quando você configura destinos de arquivo para um formato selecionado, eles são configurados para todo o formato.
Ao mesmo tempo, você pode ter várias versões do formato que foram importadas para a instância atual do Finance. É possível vê-las selecionando o link Configuração que é exibido quando você seleciona o campo Referência.
Por padrão, os destinos configurados são aplicados somente quando você executa uma versão do formato de ER que tem o status Concluído ou Compartilhado. No entanto, às vezes você deve usar destinos configurados quando a versão de rascunho de um formato de ER é executada. Por exemplo, você modifica uma versão de rascunho do seu formato e quer usar destinos configurados para testar como a saída gerada será entregue. Siga estas etapas para aplicar os destinos de um formato de ER quando a versão de rascunho for executada.
- Acesse Administração da organização>Relatório eletrônico>Configurações.
- Na página Configurações, no Painel Ação, na guia Configurações, no grupo Configurações avançadas, selecione Parâmetros de usuário.
- Defina a opção Usar destinos para status de rascunho como Sim.
Para usar a versão de rascunho de um formato de ER, você deve marcar o formato de ER adequadamente.
- Acesse Administração da organização>Relatório eletrônico>Configurações.
- Na página Configurações, no Painel Ação, na guia Configurações, no grupo Configurações avançadas, selecione Parâmetros de usuário.
- Defina a opção Executar configuração como Sim.
Depois de concluir essa configuração, a opção Executar rascunho fica disponível para os formatos de ER que você modificar. Defina esta opção como Sim para começar a usar a versão de rascunho do formato quando o formato for executado.
Tratamento de falha no destino
Normalmente, um formato de ER é executado no escopo de um processo de negócios específico. No entanto, às vezes, a entrega de um documento de saída gerado durante a execução de um formato de ER deve ser considerada como parte desse processo de negócios. Nesse caso, se a entrega de um documento de saída gerado em um destino configurado não for bem-sucedida, a execução do processo de negócios deverá ser cancelada. Para configurar o destino de ER apropriado, selecione a opção Interromper processamento em caso de falha.
Por exemplo, você configura o processamento de pagamentos de fornecedor para que o formato de ER Transferência de Crédito ISO20022 seja executado para gerar o arquivo de pagamento e os documentos complementares (por exemplo, a carta de apresentação e o relatório de controle). Se um pagamento tiver de ser considerado como tendo o processamento bem-sucedido somente se a carta de apresentação for entregue com êxito por email, você deverá marcar a caixa de seleção Interromper processamento em caso de falha para o componente CoveringLetter no destino de arquivo apropriado, conforme mostrado na ilustração a seguir. Nesse caso, o status do pagamento selecionado para processamento mudará de Nenhum para Enviado somente quando a carta de apresentação gerada for aceita com êxito para entrega por um provedor de email configurado na instância do Finance.
Se você desmarcar a caixa de seleção Interromper processamento em caso de falha para o componente CoveringLetter no destino, um pagamento será considerado como tendo o processamento bem-sucedido mesmo que a carta de apresentação não seja entregue com êxito por email. O status do pagamento mudará de Nenhum para Enviado mesmo que a carta de apresentação não possa ser enviada porque, por exemplo, o endereço de email do destinatário ou remetente está ausente ou incorreto.
Conversão de saída em PDF
Você pode usar a opção de conversão em PDF para converter a saída em formato do Microsoft Office (Excel/Word) para PDF.
Disponibilizar conversão em PDF
Para disponibilizar a opção de conversão em PDF na instância atual do Finance, abra o espaço de trabalho Gerenciamento de recursos e ative o recurso Converter documentos de saída do Relatório Eletrônico de formatos do Microsoft Office em PDF.
Aplicabilidade
Nas versões do Finance antes da versão 10.0.18, a opção de conversão do PDF pode ser ativada apenas para componentes Excel\Arquivo usados para gerar saída no formato do Office (Excel ou Word). Quando esta opção está ativada, a saída gerada no formato do Office é convertida automaticamente para o formato PDF. No entanto, na versão 10.0.18 e posterior, também é possível ativar essa opção para componentes do tipo Arquivo\Comum.
Observação
Preste atenção à mensagem de aviso recebida ao ativar a opção de conversão em PDF para um componente ER do tipo Arquivo\Comum. Esta mensagem informa que não há como garantir, em tempo de design, que o componente de arquivo selecionado exporá o conteúdo no formato PDF ou o conteúdo convertido por PDF no runtime. Portanto, você deve ativar a opção somente se tiver certeza de que o componente de arquivo selecionado foi configurado para expor o conteúdo no formato PDF ou o conteúdo convertido em PDF no runtime.
Se você ativar a opção de conversão de PDF para um componente do formato, se esse componente expuser conteúdo em um formato diferente de PDF, e se o conteúdo exposto não puder ser convertido em formato PDF, ocorrerá uma exceção no runtime. A mensagem recebida informa que o conteúdo gerado não pode ser convertido para o formato PDF.
Limitações
A partir do Finance versão 10.0.9, a opção de conversão em PDF só está disponível para implantações em nuvem. A partir do Finance versão 10.0.27, a opção de conversão em PDF está disponível para implantações locais com conectividade da Internet habilitada.
O documento PDF produzido pode ter um número máximo de 300 páginas.
A partir do Finance versão 10.0.9, apenas a orientação de página paisagem tem suporte no documento PDF produzido de uma saída do Excel. A partir do Finance versão 10.0.10, você pode especificar a orientação de página do documento PDF produzido a partir de uma saída do Excel enquanto você configura um destino de ER.
Somente as fontes de sistema comuns do sistema operacional Windows são usadas para converter uma saída que não contém fontes incorporadas.
Recursos
Antes da versão 10.0.29 do Finance, a conversão em PDF pode ser feita somente fora da instância atual do Finance. Um arquivo gerado foi enviado do Finance para o serviço de conversão e esse serviço retornou o documento convertido. No entanto, na versão 10.0.29 e posterior, além do recurso converter documentos de saída de relatórios eletrônicos de formatos do Microsoft Office para PDF, você pode habilitar a opção Utilizar recursos de aplicativo para executar a conversão de documentos CBD do formato Word para PDF. Esse recurso permite a conversão de documentos gerados do Word para o formato PDF localmente, usando os recursos de servidor de aplicativos na atual instância do Finance.
Estas são as vantagens da conversão local em PDF quando a opção Utilizar recursos de aplicativos para executar a conversão de documentos CBD do formato Word para PDF está habilitada:
- O documento PDF produzido não tem limite quanto ao número máximo de páginas.
- O documento do Word convertido pode conter um grande número de controles de conteúdo.
- A conectividade com a Internet não é necessária em implantações locais.
Usar a opção de conversão em PDF
Para ativar a conversão em PDF para um destino de arquivo, marque a caixa de seleção Converter em PDF.
Selecione uma orientação de página para conversão em PDF
Se você gerar uma configuração ER no formato Excel e quiser convertê-la em formato PDF, poderá especificar explicitamente a orientação de página do documento PDF. Quando você marca a caixa de seleção Converter para PDF para ativar a conversão em PDF para um arquivo de destino que produz um arquivo de saída no formato Excel, o campo Orientação da página fica disponível na página Configurações de conversão para PDF. No campo Orientação da página, você pode selecionar a orientação de sua preferência.
Para ter a opção de selecionar a orientação da página PDF, instale o Finance versão 10.0.10 ou posterior. Nas versões do Finance antes da versão 10.0.23, essa opção oferece as seguintes opções de orientação de página:
- Retrato
- Paisagem
A orientação de página selecionada é aplicada a todas as páginas de um documento de saída gerado no formato Excel e, em seguida, convertidas para o formato PDF.
No entanto, na versão 10.0.23 e posterior, a lista de opções de orientação de página foi estendida da seguinte maneira:
- Retrato
- Paisagem
- Específico da planilha
Quando você seleciona a opção Específico para a planilha, todas as planilhas de uma pasta de trabalho do Excel gerada são convertidas para PDF usando a orientação de página configurada para essa planilha no modelo usado no Excel. Portanto, você pode ter um documento PDF final contendo página com orientação retrato e paisagem.
Se uma configuração ER no formato Word for convertida para o formato PDF, a orientação de página do documento PDF será sempre baseada do documento do Word.
Desdobramento de saída
Ao configurar um destino para o componente Pasta do seu formato de ER, você pode especificar como a saída desse componente será entregue ao destino configurado.
Disponibilizar desdobramento de saída
Para tornar a opção de desdobramento de saída disponível na atual instância do Finance, abra o espaço de trabalho Gerenciamento de recursos e ative o recurso Permitir a configuração de destinos de ER para enviar conteúdo de pastas como arquivos separados.
Aplicabilidade
A opção de desdobramento de saída pode ser configurada somente para os componentes de formato do tipo Pasta. Quando você começa a configurar um componente Pasta, a Guia Rápida Geral fica disponível na página Destino do relatório eletrônico.
Usar a opção de desdobramento de saída
Na Guia Rápida Geral, no campo Enviar pasta como, selecione um dos seguintes valores:
Arquivo ZIP – entrega um arquivo gerado como um arquivo zip.
Arquivos separados – entrega cada arquivo de um arquivo zip gerado como um arquivo individual.
Observação
Quando você seleciona Arquivos separados, a saída gerada é coletada na memória em um estado zipado. Portanto, o limite de tamanho de arquivo máximo é aplicado à saída compactada quando o tamanho real do arquivo pode exceder esse limite. É recomendável selecionar este valor quando se espera que o tamanho da saída gerada seja muito grande.
Limitações
Se você definir o campo Enviar pasta como para Separar arquivos para um componente de Pasta que contém outros componentes de Pasta aninhada, a configuração não será aplicada recursivamente aos componentes de Pasta aninhados.
Alterar propriedades de layout de página de um modelo
Você pode configurar um destino de ER para um componente de formato de ER que foi criado para usar um modelo em um formato do Microsoft Office (Excel ou Word) para geração de relatórios. Se você não for o proprietário deste formato e precisar alterar as propriedades de layout de página do modelo do formato, em versões do Finance, antes da versão 10.0.29, será necessário criar um formato derivado e modificar as propriedades do modelo. Em seguida, você terá que manter a configuração de formato derivado. No entanto, na versão 10.0.29 e posterior, você pode alterar as propriedades de layout de página do modelo no runtime para evitar criar e manter a configuração de formato derivado. Para isso, configure as propriedades desejadas como parte das configurações do destino de ER configurado. Quando você executa um formato de ER e um destino de ER configurado para usar determinadas propriedades de layout de página, os valores das propriedades de layout de página do destino executado são aplicados ao modelo que você está usando, substituindo as propriedades do modelo original. É possível configurar destinos diferentes para o mesmo componente do formato, configurando diferentes propriedades de layout de página para o modelo em uso.
As seguintes propriedades podem ser configuradas em um destino de ER para um componente de formato projetado para usar um modelo no formato Excel ou Word:
- Orientação da página
- Retrato
- Paisagem
- Tamanho do papel
- A3
- A4
- A5
- B4
- B5
- Executivo
- Ofício
- Carta
- Instrução
- Tabloide
- Margens da página
- Superior
- Cabeçalho
- Inferior
- Rodapé
- Esquerda
- Direita
- Superior
Observação
A orientação de página do modelo que está configurada dessa maneira deve ser alinhada à orientação de página para conversão em PDF, se a conversão em PDF estiver configurada.
Você deve selecionar a unidade de duração para definir margens de página:
- Polegadas
- Centímetros
- Milímetros
Dica
Quando um valor de margem é indicado em centímetros e especificado com vários decimais, ele é arredondado no runtime para o valor mais próximo com um ponto decimal.
Quando um valor de margem é indicado em milímetros e especificado com vários decimais, ele é arredondado no runtime para Excel para o valor inteiro, sem ponto decimal.
Quando um valor de margem é indicado em milímetros e especificado com vários decimais, ele é arredondado no runtime para Word para o valor inteiro com um ponto decimal.
Considerações de segurança
Dois tipos de direitos e privilégios são usados para destinos de ER. Um tipo controla a capacidade geral do usuário de manter os destinos que estão configurados para uma entidade legal (isto é, controla o acesso à página Destinos de Relatório eletrônico). O outro tipo controla a capacidade de um usuário do aplicativo de substituir, em tempo de execução, as configurações de destino feitas por um desenvolvedor de ER ou consultor funcional ER.
| Função (nome da AOT) | Nome da função | Direito (nome da AOT) | Nome da obrigação |
|---|---|---|---|
| ERDeveloper | Desenvolvedor de relatório eletrônico | ERFormatDestinationConfigure | Configurar destino de formato de relatório eletrônico |
| ERFunctionalConsultant | Consultor funcional de relatório eletrônico | ERFormatDestinationConfigure | Configurar destino de formato de relatório eletrônico |
| PaymAccountsPayablePaymentsClerk | Auxiliar de pagamentos de contas a pagar | ERFormatDestinationRuntimeConfigure | Configurar destino de formato de relatório eletrônico durante o tempo de execução |
| PaymAccountsReceivablePaymentsClerk | Auxiliar de pagamentos de contas a receber | ERFormatDestinationRuntimeConfigure | Configurar destino de formato de relatório eletrônico durante o tempo de execução |
Observação
Dois privilégios são usados em tarefas anteriores. Esses privilégios têm os mesmos nomes que as tarefas correspondentes: ERFormatDestinationConfigure e ERFormatDestinationRuntimeConfigure.
Perguntas frequentes
Importei configurações eletrônicas e vejo na página de configurações de relatório eletrônico. Mas por que eu não os vejo na página de destinos de relatórios eletrônicos?
Selecione Novo e, depois, escolha uma configuração no campo Referência. A página Destinos de Relatório eletrônico mostra apenas as configurações definidas para os destinos.
Existe alguma forma de definir qual conta de armazenamento do Microsoft Azure e qual armazenamento de Blob do Azure são usados?
Nº É utilizado o armazenamento de Blob padrão do Microsoft Azure que é definido e usado para o sistema de gerenciamento de documentos.
Qual é a finalidade do destino do arquivo nas configurações de destino? O que faz essa configuração?
O destino do Arquivo é usado para controlar uma caixa de diálogo do navegador da Web quando você executa um formato de ER no modo interativo. Se você habilitar esse destino, ou se nenhum destino for definido para uma configuração, será exibida no seu navegador uma caixa de diálogo para abrir ou salvar após a criação de um arquivo de saída.
Pode dar um exemplo de fórmula que se refere a uma conta de fornecedor que eu possa enviar e-mail para?
A fórmula é específica da configuração ER. Por exemplo, se você usa a configuração de transferência de crédito ISO 20022, você pode usar '$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 arquivos agrupados em uma pasta (por exemplo, Pasta1 contém Arquivo1, Arquivo2 e Arquivo3). Como posso configurar destinos de forma que a Pasta1.zip não seja criada, o Arquivo1 seja enviado por email, o Arquivo2 seja enviado ao SharePoint e eu possa abrir o Arquivo3 logo depois que a configuração for executada?
O formato deve estar disponível primeiro nas configurações ER. Se esse pré-requisito for atendido, abra a página Destino de relatório eletrônico e crie uma nova referência para a configuração. Em seguida, você deve ter quatro destinos de arquivo, um para cada componente de saída. Crie o destino do arquivo primeiro, dê a ele um nome como Pasta e selecione um nome de arquivo que representa uma pasta na sua configuração. Depois, selecione Configurações e certifique-se de que todos os destinos estão desabilitados. Para este destino do arquivo, a pasta não será criada. Por padrão, por causa das dependências hierárquicas entre os arquivos e pastas pai, os arquivos irão se comportar da mesma maneira. Em outras palavras, eles não serão enviados em qualquer lugar. Para substituir esse comportamento padrão, você deve criar três destinos mais de arquivo, um para cada arquivo. Nas configurações de destino de cada um, você deve habilitar o destino em que o arquivo deve ser enviado para.