Criando Arquivos de Configuração para Exportar Artefatos de Teste do Excel

Ao exportar um artefato de teste do Microsoft Excel, você deve ter um arquivo de configuração para definir como mapear o arquivo XML para um artefato de gerenciamento de qualidade.

Sobre Esta Tarefa

Os arquivos de configuração contêm instruções que associam informações de artefatos do Quality Management a locais dos dados. Cada instrução em um arquivo de configuração tem dois lados que estão vinculados com um sinal de igual. O lado esquerdo da instrução consiste de palavras-chave. O lado direito do sinal de igual de uma entrada de configuração pode consistir em três possibilidades.
  1. Uma definição de coluna ou de célula, por exemplo, D ou D4
  2. Uma sequência literal, por exemplo, "execution"
  3. Uma referência a outro artefato (autorreferência), por exemplo, testscript.description
Para definir uma linha ou célula, simplesmente coloque o identificador da coluna ou da célula:
testscript.dc:title=G
Para definir uma sequência literal, simplesmente coloque-a entre aspas:
testscript.steps.type="execution"
Para definir uma autorreferência, simplesmente coloque as informações do lado esquerdo do sinal de igual de uma linha definida anteriormente:
testscript.dc:title=G
testcase.dc:title=testscript.dc:title
Nota: As autorreferências são usadas para criar artefatos que utilizarão dados que já estão sendo usados por outro artefato e que criarão um link para esse artefato. As autorreferências não podem ser usadas com a palavra-chave XLSLink.

Palavras-chave e casos especiais

Há várias palavras-chave que vão no lado esquerdo do sinal de igual. Todas elas começam com "XLS" e substituem um campo após o artefato. Elas são definidas como:
  • XLSStartRow define qual linha os dados do artefato iniciam em seguida.
  • XLSDelimeter define o elemento que denota o próximo artefato (atualmente apenas \n é suportado).
  • XLSLink especifica que o artefato está vinculado a todos os artefatos do tipo especificado na planilha.
  • XLSLinkReverse instrui o utilitário de exportação a inserir o XML do link no artefato, em vez daquele que cria o link. Use esta palavra-chave apenas com os links de auto-referência. Utilize essa palavra-chave ao criar um artefato com base em outro (por exemplo, requirement.dc:title=testcase.dc:title), mas você precisa que o link seja criado no artefato original (aquele à direita do sinal de igual). Especificar requirement.XLSLinkReverse=true insere o link no artefato principal, em vez de inseri-lo naquele que especifica o link de auto-referência.
  • XLSArtifactID especifica o ID externo do artefato. Se o ID externo do artefato não for especificado, um ID externo será designado usando este formato:
    Excel file name_Excel worksheet name[_artifact_count].xml
    em que artifact_count é o número de artefatos em uma única planilha, se a planilha contiver dois ou mais artefatos. Se a planilha contiver um artefato, esse argumento não será necessário.
    Importante: Se a planilha contiver um artefato com o mesmo ID externo do outro artefato, o artefato será atualizado a partir do conteúdo da planilha. Por exemplo, se você exportar a mesma planilha do Excel com a mesma configuração várias vezes, o ID externo será atualizado todas as vezes.
    CUIDADO:
    Se você estiver usando artifact.XLSArtifactID="urn:com.ibm.rqm:testplan:2" quando o valor for especificado como uma sequência (não uma célula), certifique-se de que não haja uma folha em branco e que artifact.XLSWorksheetID não seja usado para especificar a planilha para ler o XLSArtifactID.
    Para criar novos artefatos ao exportar os mesmos arquivos do Excel para o mesmo repositório, conclua uma destas etapas:
    • Use a palavra-chave XLSArtifactID para especificar um ID externo exclusivo para cada operação de exportação.
    • Altere o nome do arquivo Excel ou o nome da planilha Excel sempre que você exportar.
    • Use a opção Exportar para Arquivo ao iniciar o processo de exportação e altere o nome dos arquivos XML e depois importe os arquivos XML para o Quality Management: Efetue login no Quality Management e clique em um destes comandos:
      • Planejamento > Importar Planos de Teste
      • Construção > Importar Casos de Teste
      • Construção > Importar Scripts de Teste
      Dica: É possível usar o método anterior apenas para importar planos de teste, casos de teste e scripts de teste.
  • XLSWorksheetID especifica o nome da planilha para processar. Você deve usar a sequência literal para essa palavra-chave.
    Nota: A partir da versão 4.0, a sintaxe para testsuite vinculada com testcases foi anterada de
    testsuite.testcases=testcase
    para
    testsuite.XLSLink=testcase
  • Eis alguns exemplos:
    • testscript.XLSStartRow=7
    • testscript.title=B
    • testscript.steps.type="execution"
    • testscript.steps.description=B
    • testscript.steps.title=B
    • testscript.steps.name=B
    • testscript.steps.expectedResult=F
    • testscript.XLSDelimeter=\n
    • testcase.dc:title=C1
    • testcase.dc:description=C2
    • testcase.XLSLink=testscript
    • testcase.XLSArtifactID=D1
    • testcase.XLSWorksheetID="test_case_1"

    As etapas de script, categorias, seções, exportações de imagem, procuras dinâmicas por uma palavra ou frase e o acesso às propriedades da planilha são casos especiais. Uma etapa de script requer diversos campos para cada etapa. Como um script pode ter muitas etapas, todas as linhas são considerados uma única etapa até que uma linha em branco seja encontrada, que inicia a próxima etapa.

    Seções são casos especiais. Para simplificar seus usos e manter suas definições fora da interferência da notação de período, elas são usadas de outra forma. Para atualizar uma seção, use este formato:
    testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=C
    Este exemplo de entrada de configuração preenche a seção de critérios de aceitação integrada no aplicativo Quality Management.

Procedimento


Feedback