Rastrear resultados de relatórios gerados e compará-los com valores de linha de base

Pode rastrear os resultados dos formatos de Relatório eletrónicos (ER) que geram documentos eletrónicos de saída. Quando a geração de rastreio está ativada (utilizando o parâmetro de utilizador de ER Executar em modo de depuração), é gerado um novo registo de rastreio no registo de execução do formato de ER sempre que é executado um relatório de ER. Os seguintes detalhes são armazenados em cada rastreio gerado:

• Todos os avisos que foram gerados pelas regras de validação
• Todos os erros que foram gerados pelas regras de validação
• Todos os ficheiros gerados que são armazenados como anexos do registo de rastreio

Pode armazenar ficheiros de aplicação de linha de base individuais para qualquer formato de ER. Os ficheiros são considerados ficheiros de linha de base quando descrevem os resultados esperados dos relatórios que são executados. Se um ficheiro de linha de base estiver disponível para um formato de ER que é executado enquanto a geração de rastreio está ativada, o rastreio armazena, além dos detalhes mencionados anteriormente, o resultado da comparação do documento eletrónico gerado com o ficheiro de linha de base. Num clique, também pode obter o documento eletrónico gerado e o ficheiro de linha de base num único ficheiro zip. Em seguida, pode fazer uma comparação detalhada utilizando uma ferramenta externa como WinDiff.

Pode avaliar o rastreio para analisar se os documentos eletrónicos gerados incluem o conteúdo esperado. Pode fazer esta avaliação num ambiente de testes de aceitação de utilizador (UAT) quando a base do código for alterada (por exemplo, quando migrou para uma nova instância da aplicação, instalou pacotes de correções ou implementou modificações de código). Desta forma, pode certificar-se de que a avaliação não afeta a execução de relatórios de ER que são utilizados. Para muitos relatórios de ER, a avaliação pode ser feita em modo automático.

Para saber mais sobre esta funcionalidade, reproduza os guias de tarefas ER Gerar relatórios e comparar resultados (Parte 1) e ER Gerar relatórios e comparar resultados (Parte 2), que fazem parte do processo de negócio 7.5.4.3 Testar serviços/soluções de TI (10679) e que podem ser transferidos a partir do Centro de Transferências da Microsoft. Estes guias de tarefas explicam o processo de configuração da arquitetura de ER para utilizar ficheiros de linha de base para avaliar documentos eletrónicos gerados.

Exemplo: Rastrear resultados de relatórios gerados e compará-los com valores de linha de base

Este procedimento explica como configurar a arquitetura de ER para recolher informações sobre execuções de formato de ER e avaliar os resultados dessas execuções. Como parte dessa avaliação, os documentos gerados são comparados com os seus ficheiros de linha de base. Neste exemplo, vai criar as configurações de ER necessárias para a empresa de exemplo, Litware, Inc. Este procedimento destina-se a utilizadores a quem tenha sido atribuída a função Administrador de sistema ou Programador de Relatórios eletrónicos. Estes passos podem ser concluídos utilizando qualquer conjunto de dados.

Para concluir os passos descritos neste exemplo, tem de concluir primeiro os passos indicados em Criar fornecedores de configuração e marcá-los como ativos.

1. Vá para Administração da organização > Áreas de trabalho > Relatórios eletrónicos.
2. Na página Configurações de localização, na secção Fornecedores de configuração, verifique se o fornecedor de configuração para a empresa de exemplo Litware, Inc. está listado e marcado como Ativo. Caso não veja este fornecedor de configuração, siga os passos indicados em Criar fornecedores de configuração e marcá-los como ativos.

Configurar parâmetros de gestão de documentos

1. Vá para Administração da organização > Gestão de documentos > Tipos de documentos e crie um novo tipo de documento para armazenar ficheiros de linha de base.
2. No campo Classe , introduza Anexar ficheiro.
3. No campo Grupo , introduza Ficheiro.

Nota

Um novo tipo de documento com o mesmo nome tem de ser configurado para cada conjunto de dados em que pretende utilizar a funcionalidade de linha de base de ER.

Configurar parâmetros de ER para começar a utilizar a funcionalidade de linha de base

1. Na área de trabalho Relatórios eletrónicos, na secção Ligações relacionadas, selecione Parâmetros de relatórios eletrónicos.

   

2. No separador Anexos, no campo Linha de base, introduza ou selecione o tipo de documento que acabou de criar.

   

3. Selecione Guardar e feche a página Parâmetros de relatórios eletrónicos.

Adicionar uma nova configuração de modelo de ER

1. Na área de trabalho Relatórios eletrónicos, na secção Configurações, selecione o mosaico Configurações de relatórios.
2. No Painel de Ações, selecione Criar configuração.
3. Na caixa de diálogo pendente, no campo Nome, introduza Modelo para saber mais sobre linhas de base de ER.
4. Selecione Criar configuração para confirmar a criação de uma nova entrada do modelo de dados de ER.

Estruturar um modelo de dados

1. Na página Configurações, no Painel de Ações, selecione Estruturador.
2. Selecione Novo.
3. Na caixa de diálogo pendente, no campo Nome, introduza Raiz.
4. Selecione Adicionar.
5. Selecione Referência raiz.
6. Selecione OK e, em seguida, selecione Guardar.
7. Feche a página Estruturador de modelo.
8. Selecione Alterar estado.
9. Selecione Concluir e, em seguida, selecione OK.

Adicionar uma nova configuração de formato de ER

1. Na página Configurações, no Painel de Ações, selecione Criar configuração.
2. Na caixa de diálogo pendente, no grupo de campo Novo, introduza Formato baseado no modelo de dados Modelo para saber mais sobre linhas de base de ER.
3. No campo Nome, introduza o Formato para saber mais sobre linhas de base de ER.
4. Selecione Criar configuração para confirmar a criação de uma nova entrada de formato de ER.

Estruturar um formato

Para este exemplo, irá criar um simples formato de ER para gerar documentos XML.

1. Na página Configurações, no Painel de Ações, selecione Estruturador.

2. Selecione Adicionar raiz.

3. Na caixa de diálogo pendente, siga estes passos:

   1. Na árvore, selecione Comum\Ficheiro.
   2. No campo Nome, introduza Resultado.
   3. Selecione OK.

4. Selecione Adicionar.

5. Na caixa de diálogo pendente, siga estes passos:

   1. Na árvore, selecione XML\Elemento.
   2. No campo Nome, introduza Documento.
   3. Selecione OK.

6. Na árvore, selecione Saída\Documento.

7. Selecione Adicionar.

8. Na caixa de diálogo pendente, siga estes passos:

   1. Na árvore, selecione XML\Atributo.
   2. No campo Nome, introduza ID.
   3. Selecione OK.

   

9. No separador Mapeamento, selecione Eliminar.

10. Selecione Adicionar raiz.

11. Na caixa de diálogo pendente, na árvore, selecione Geral\Parâmetro de entrada de utilizador e, em seguida, siga estes passos:

    1. No campo Nome, introduza ID.
    2. No campo Etiqueta, introduza Introduzir ID.
    3. Selecione OK.

12. Na árvore, selecione Saída\Documento\Id.

13. Selecione Vincular e, em seguida, selecione Guardar.

Com base na estrutura ciada, o formato configurado gerará um ficheiro XML. Este XML contém o elemento Raiz que tem o atributo ID que é definido para o valor que o utilizador introduz na caixa de diálogo de runtime de ER.

Gerar um novo ficheiro de linha de base para um formato de ER estruturado

1. Na página Configurações, no Separador Rápido Versões, selecione Executar.

2. No campo Introduzir ID, introduza 1.

3. Selecione OK.

   

4. Guarde uma cópia local do ficheiro out.Admin.xml que é gerado, para que possa usá-lo mais tarde como linha de base para este formato de ER.

   

Configurar parâmetros de ER para utilizar a funcionalidade de linha de base

1. Na página Configurações, no Painel de Ações, no separador Configurações, selecione Parâmetros de utilizador.
2. Defina a opção Executar no modo de depuração para Sim.
3. Selecione OK.

Adicionar uma nova linha de base para um formato de ER estruturado

1. Vá para Administração da organização > Relatórios eletrónicos > Configurações.

2. No Painel de Ações, selecione Linhas de base.

   

3. No Painel de Ações, selecione Novo.

4. Selecione o formato de ER Formato para saber mais sobre linhas de base de ER que estruturou anteriormente.

5. Selecione Guardar.

A linha de base é adicionada ao formato Formato para saber mais sobre linhas de base de ER.

Configurar uma regra de linha de base para a linha de base adicionada

1. Na página Linhas de base do formato de relatórios eletrónicos, no Painel de Ações, selecione o botão Anexos (o símbolo do clipe de papel).

2. No Painel de Ações, selecione Novo > Ficheiro. Nos parâmetros de ER, o tipo de documento Ficheiro deveria ter sido previamente selecionado como o tipo de documento utilizado para armazenar ficheiros de linha de base.

3. Selecione Procurar e depois o ficheiro out. Admin.xml que foi gerado quando executou o formato de ER configurado anteriormente.

   

4. Feche a página Anexos.

5. No Separador Rápido Linhas de base, selecione Novo.

6. No campo Nome, introduza Linha de base 1.

7. No campo Nome do componente de ficheiro, introduza ou selecione Saída. Este valor indica que a linha de base configurada será comparada com um ficheiro que é gerado utilizando o elemento de formato Saída.

8. No campo Máscara de nome de ficheiro, introduza *.xml.

   Nota

   Pode definir a máscara de nome de ficheiro. Quando a máscara de nome de ficheiro for definida, o registo de linha de base será utilizado para avaliar a saída gerada apenas quando o nome do ficheiro de saída gerado satisfizer essa máscara.

9. Se a linha de base configurada só deve ser utilizada quando o formato de ER Formato para saber mais sobre linhas de base de ER for executado por utilizadores com sessão iniciada em empresas específicas, selecione essas empresas no campo Empresas.

10. No campo Linhas de base, introduza ou selecione o anexo out.Admin.

11. Selecione Guardar.

Executar o formato de ER estruturado e rever o registo para analisar os resultados

1. Vá para Administração da organização > Relatórios eletrónicos > Configurações.

2. Na árvore, expanda Modelo para saber mais sobre linhas de base de ER e selecione Modelo para saber mais sobre linhas de base de ER\Formato para saber mais sobre linhas de base de ER.

3. No Separador Rápido Versões, selecione Executar.

4. No campo Introduzir ID, introduza 1.

5. Selecione OK.

6. Aceda a Administração da Organização > Relatórios eletrónicos > Registos de depuração de configuração.

   

   Nota

   O registo de execução contém informações sobre os resultados da comparação do ficheiro gerado com a linha de base configurada. Neste exemplo, o registo indica que o ficheiro gerado e a linha de base são iguais.

7. Selecione Eliminar tudo.

Executar o formato de ER estruturado e rever o registo para analisar os resultados

1. Vá para Administração da organização > Relatórios eletrónicos > Configurações.

2. Na árvore, expanda Modelo para saber mais sobre linhas de base de ER e selecione Modelo para saber mais sobre linhas de base de ER\Formato para saber mais sobre linhas de base de ER.

3. No Separador Rápido Versões, selecione Executar.

4. No campo Introduzir ID, introduza 2.

5. Selecione OK.

6. Aceda a Administração da Organização > Relatórios eletrónicos > Registos de depuração de configuração.

   

   Nota

   O registo de execução contém informações sobre os resultados da comparação do ficheiro gerado com a linha de base configurada. Neste exemplo, o registo indica que o ficheiro gerado e a linha de base são diferentes.

7. Selecione Comparar.

Nota

O ficheiro gerado e o ficheiro de linha de base são disponibilizados como ficheiro zip. Pode utilizar ferramentas de comparação externas como WinDiff para comparar os ficheiros e rever as diferenças.

Recursos adicionais

• Configurar a arquitetura de Relatórios eletrónicos (ER)