Ao exportar um artefato de teste do Microsoft Word,
você deve ter um arquivo de configuração para definir como mapear o arquivo XML para um artefato de gerenciamento de qualidade.
Procedimento
Nota: O lado direito do sinal de igual de uma entrada de configuração deve conter uma sequência literal, uma tabela ou uma definição de estrutura de tópicos.
Uma tabela é denotada por uma entrada Table(. Uma lista é denotada
por uma entrada List(. Ambas as entradas devem terminar com um parêntese
direito ()).
Para criar um mapeamento:
- Crie uma definição de estrutura de tópicos: A definição de conteúdo para uma lista de
estrutura de tópicos pode consistir no nível de indentação ou em um curinga único
que é denotado por um asterisco (*). Um nível de recuo é um número inteiro, enquanto o caractere curinga deve ser colocado entre aspas duplas. Qualquer um deles pode ser definido adicionalmente com um número de parágrafo
específico após uma vírgula.
O exemplo a seguir instrui o utilitário de exportação a localizar uma estrutura de tópicos cujo título corresponde ao padrão "1.*."
e obtém apenas o primeiro parágrafo de uma estrutura de tópicos que será o título do caso de teste:
testcase.dc:title=List("1.*.",1)
Se você omitir a vírgula e o número, o conteúdo inteiro do nível da estrutura de tópicos será colocado no campo de título.
Se você usar um número inteiro sem aspas duplas, o utilitário de exportação usará o conteúdo no
número especificado de indentações:
testcase.dc:title=List(1,1)
- Crie uma definição de tabela : Uma tabela é definida pelo
número no qual ela existe ou pelo conteúdo da primeira célula.
Uma tabela que você define por um número é estática, de modo que cada artefato que utiliza essa tabela sempre que se refere a essa tabela exata. Uma tabela nomeada é dinâmica, o que significa que se você tiver mais de uma tabela no documento
que corresponda ao texto, mais de um artefato será criado. Depois que uma
tabela é definida, ela deve ser seguida por um ponto e uma referência de célula ou coluna, da mesma maneira que uma célula ou coluna do Excel é definida.
O exemplo define uma tabela estática e uma célula estática:
testscript.dc:title=Table(1).B3
Uma tabela dinâmica corresponde ao início do texto na primeira célula da tabela. A função de correspondência faz distinção entre maiúsculas e minúsculas, mas ignora os espaços. Este exemplo obtém informações das colunas B de todas as tabelas com as primeiras células que começam com "Step":
testscript.steps.title=Table("Step").B
- Crie links com autorreferência: Para definir uma autoereferência,
especifique as informações do lado esquerdo do sinal de igual a partir de uma linha definida anteriormente:
testscript.dc:title= Table(1).G
testcase.dc:title=testscript.dc:title
Dica: Use autorreferências para criar artefatos que utilizam dados que já estão
sendo usados por outro artefato e para criar um link para esse artefato.
- Use palavras-chave: A palavra-chave XLSLink especifica
que o artefato se vincula a todos os artefatos do tipo especificado no
documento. Neste exemplo, todos os scripts de teste no documento são vinculados a todos os casos de teste:
testcase.XLSLink=testscript
Use as palavras-chave
DOCStart e
DOCStop para especificar em qual definição da lista iniciar e parar. Essas palavras-chave são utilizadas apenas para os tipos de lista e devem conter uma sequência literal. No exemplo a seguir, a entrada de configuração começará a processar a lista quando o quinto item for localizado e interromperá o processamento quando o décimo segundo item da lista for localizado. Essas correspondências são exatas, o item da lista "12.1" não termina o processo.
testscript.DOCStart="5."
testscript.DOCStop="12."
- Modifique dados: Qualquer definição de destino pode ser encapada em um modificador Pre().
Os exemplos a seguir encapam os dados resultantes nas tags <div>
e <pre>, preservando as informações de formatação:
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=Pre(Table(1).C)
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=Pre("this is my text")
Seções
são um caso especial para simplificar seu uso e impedir que suas definições
interfiram com a notação de ponto que é usada nos outros casos.
Para atualizar uma seção, use este formato:
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=Table(1).C
A entrada anterior preenche a seção de critérios de aceitação que é criada no aplicativo Quality Management.
Consulte o procedimento para especificar o nome ou nome de exibição das seções predefinidas neste tópico:
Criando Arquivos de Configuração para Exportar Artefatos de Teste do Excel. Para definir uma seção customizada, substitua o primeiro parâmetro por um nome válido e substitua o segundo parâmetro por um nome de exibição:
testcase.Section("myns:mysection","my custom section")=Table(1).C
Categorias são definidas com a notação
category term=category_name.value=category_value.
O nome da categoria é colocado entre aspas duplas:
testcase.category term="Function".value=Table(1).H
Utilize o símbolo e comercial (
&) para incluir dois ou mais bits de dados no mesmo campo. Os dados podem ser uma combinação de itens. Este exemplo mostra os dados incluídos:
testcase.description=”my description:” & Table(1).H & testscript.description
- Acesso às propriedades do documento do arquivo a ser exportado:
Siga estes exemplos para acessar as propriedades do documento Word do arquivo:
- requirement.dc:title=property(“Title”)
- requirement.dc:creator=property(“Author”)
- requirement.jzalm:owner=property(“Company”)
Você pode localizar as propriedades disponíveis integradas no Microsoft Office em http://msdn.microsoft.com/en-us/library/microsoft.office.core.documentproperty.aspx.
Três outras propriedades também estão disponíveis: "Nome," " Nome Completo" e "Local."
Se a propriedade não tiver sido configurada ou se o Word não suportar a propriedade,
a propriedade (“nome da propriedade”) retornará a sequência vazia: “”.
Os arquivos .xls e .cfg da amostra relacionada são chamados de “Script de Teste em Tabelas Usando Propriedades do Documento.”
Exemplo
Para a versão 4.0: o design e artefato na lista é alterado para
esperar ser separado por
\n, e não por ter
\n dentro de um
artefato como mostrado neste exemplo:
1. title
1.1 testcase1 title
1.1.1 testscript1 reference to the testcase1
1.1.1.1 testscript1 step1 title
1.1.1.1.1 testscript1 step1 description
1.1.1.1.2 testscript1 step1 expectresuit
1.1.1.2 testscript1 step2 title
1.1.1.2.1 testscript1 step2 description
1.1.1.2.2 testscript1 step2 expectresuit
1.1.1.3 testscript1 step3 title
1.1.1.3.1 testscript1 step3 description
1.1.1.3.2 testscript1 step3 expectresuit
1.1.1.4 testscript1 step4 title
1.1.1.4.1 testscript1 step4 description
1.1.1.4.2 testscript1 step4 expectresuit
1.2 testcase2 title
1.2.1 testscript2 reference to the testcase2
1.2.1.1 testscript2 step1 title
1.2.1.1.1 testscript2 step1 description
1.2.1.1.2 testscript2 step1 expectresuit
1.2.1.2 testscript2 step2 title
1.2.1.2.1 testscript2 step2 description
1.2.1.2.2 testscript2 step2 expectresuit
1.2.1.3 testscript2 step3 title
1.2.1.3.1 testscript2 step3 description
1.2.1.3.2 testscript2 step3 expectresuit
1.2.1.4 testscript2 step4 title
1.2.1.4.1 testscript2 step4 description
1.2.1.4.2 testscript2 step4 expectresuit
A linha em branco entre os dois títulos de caso de teste
denota a separação dos casos de teste.