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.
- Uma definição de coluna ou de célula, por exemplo, D ou D4
- Uma sequência literal, por exemplo, "execution"
- 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:
- 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.
- Para determinar o nome ou nome de exibição das seções predefinidas:
- Atualize a seção predefinida de um recurso no Quality Management.
- Leiao recurso como XML com abbreviate=false.
- Localize o elemento no documento XML com o nome da seção, por exemplo, com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria.
- Localize o atributo extensionDisplayName no elemento que contém o nome de exibição da seção, por exemplo RQM-KEY-TC-ACCEPT-CRITERIA-TITLE.
- Para definir uma seção customizada, substitua o primeiro parâmetro por um nome válido e o segundo parâmetro por um nome de exibição:
testcase.Section("myns:mysection","my custom section")=C
- Para definir uma categoria, use o formato category term=nome_da_categoria.value=valor_da_categoria:
testcase.category term="Function".value=H
- Para incluir um atributo customizado em um artefato: se você tiver
dois customAttributes, testcaseCustomAttribute1 e testcaseCustomAttribute1, em um
caso de teste, os customAttributes testcaseCustomAttribute1 e testcaseCustomAttribute2 deverão ser
criados no Quality Management antes de executar o Importador de Excel do
Quality Management.
Podemos configurar o arquivo .cfg conforme
a seguir:
testcase.customAttributes.type="SMALL_STRING" //configure
o tipo de atributo customizado (o tipo de dados).
testcase.customAttributes.identifier=A //coloque um
identificador na coluna A no Excel. O identificador é o nome
do atributo ao criá-lo. Por exemplo, quando você cria
o customerAttribute com o nome "name1" e o altera para "name2"
posteriormente, o identificador permanece como "name1" no servidor Quality Management.
Se você configurar o identificador de atributo customizado como Custom_attribute_number_,
e o primeiro atributo for Custom_attribute_0_ e o segundo for
Custom_attribute_1_ , esse identificador estará correto quando você
colocá-lo na célula d Excel.
testcase.customAttributes.name=B //coloque o nome do atributo na coluna B
testcase.customAttributes.value=C //coloque o valor de atributo
na coluna C, o resultado será:
<customAttributes>
<customAttribute type="SMALL_STRING">
<identifier>Custom_attribute_0_</identifier>
<name>testcaseCustomAttribute1</name>
<value>111111111111111111111111111</value>
</customAttribute>
<customAttribute type="SMALL_STRING">
<identifier>Custom_attribute_1_</identifier>
<name>testcaseCustomAttribute2</name>
<value>3333333333333333333333333</value>
</customAttribute>
</customAttributes>
Uma nova amostra TestCases 001 com
attributes.xls customizado e TestCases 001 com attributes.cfg customizado
foram incluídos.
- Para acessar as propriedades da planilha na qual você está trabalhando,
usando as seguintes linhas:
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 Excel 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 Requirements001 usando propriedades do documento.
- Para exportar imagens do Excel, entenda estes aspectos das imagens nas planilhas:
O local das imagens no Excel é representado pela célula que contém o canto superior esquerdo da imagem. Mesmo que uma imagem obtenha diversas células, você deverá especificar a célula que contém o canto superior esquerdo da imagem para exportá-la. As células podem conter um número ilimitado de imagens. Se você especificar a célula que contém o canto superior esquerdo de todas as imagens, todas as imagens serão exportadas.
No Excel, você pode exportar imagens de duas maneiras. O primeiro método é utilizar a função de imagem. A imagem é configurada como uma função para inserção após o sinal de igual em uma entrada do arquivo de configuração. Imagens podem ser especificados pela célula ou pela linha. A função da imagem insere uma imagem no campo rich text ao qual ela está designada. Se o atributo não utilizar um campo rich text, a função da imagem será ignorada. Consulte estes exemplos de função da imagem:
- testscript.steps.expectedResult=image(G)
- testscript.steps.description=image(C4)
O segundo método é usar o atributo de anexo:
- testcase.attachment=C4
- testcase.attachment=C
O atributo de anexo inclui imagens como anexos para o artefato em vez de inserir a imagem nos campos rich text.
Os arquivos .xls e .cfg da amostra relacionada
são chamados, respectivamente, Casos de Teste feitos de scripts com
imagens e Casos de Teste feitos de scripts com anexos.