Microsoft Excel 테스트 아티팩트를 내보낼 때마다
XML 파일을 품질 관리 아티팩트로 맵핑하는 방법을 정의하기 위해
구성 파일이 있어야 합니다.
이 태스크 정보
구성 파일에는 품질 관리 아티팩트 정보를 데이터 위치와
연관시키는 명령문이 포함되어 있습니다. 구성 파일의 개별 명령문에는
등호로 연결된 두 개의 측면이 있습니다.
명령문의 왼쪽은 키워드로 구성되어 있습니다. 구성의 등호 오른쪽은 다음과 같이 세 가지로 구성될 수 있습니다.
- 열 또는 셀 정의(예: D 또는 D4)
- 리터럴 문자열(예: "execution")
- 다른 아티팩트에 대한 참조(자체 참조)(예:testcript.description)
행 또는 셀을 정의하려면 열 ID 또는 셀 ID를 입력하십시오.
testscript.dc:title=G
리터럴 문자열을 정의하려면 따옴표 안에 리터럴 문자열을 포함하십시오.
testscript.steps.type="execution"
자체 참조를 정의하려면 이전에 정의한 행에서
등호 왼쪽의 정보를 지정하십시오.
testscript.dc:title=G
testcase.dc:title=testscript.dc:title
참고: 자체 참조는 다른 아티팩트에서 이미 사용 중인 데이터를 사용할
아티팩트를 작성하는 데 사용하며 해당 아티팩트로 링크를 작성합니다.
자체 참조는 XLSLink 키워드와 함께 사용할 수 없습니다.
키워드 및 특수한 경우
일부 키워드는
등호 왼쪽에 사용됩니다.
모두 "XLS"와 함께 시작하고 아티팩트 뒤의 필드 위치를 차지합니다. 다음과 같이 정의됩니다.
- XLSStartRow는 아티팩트 데이터가 시작되는 직전
행을 정의합니다.
- XLSDelimeter는 다음 아티팩트를 표시하는 요소를 정의합니다(현재 \n만 지원됨).
- XLSLink는 아티팩트를 워크시트 내에 지정된 유형의
모든 아티팩트에 링크하도록 지정합니다.
- XLSLinkReverse는 내보내기 유틸리티가
링크 XML을 링크를 작성하는 대상이 아닌 아티팩트로 보내도록 지정합니다.
이 키워드를 자체 참조 링크에만 사용하십시오. 다른 아티팩트(예: requirement.dc:title=testcase.dc:title)를
기반으로 하는 아티팩트를 작성하지만 링크를 원래 아티팩트(등호 오른쪽에 있음)에 작성해야 하는 경우 이 키워드를 사용하십시오.
requirement.XLSLinkReverse=true를 지정하면 링크가
자체 참조 링크를 지정하는 아티팩트가 아닌 기본 아티팩트에
배치됩니다.
- XLSArtifactID는 아티팩트의 외부 ID를 지정합니다.
아티팩트의 외부 ID 가 지정되지 않은 경우, 기본 외부 ID가 이 형식을 사용하여
지정됩니다.
Excel file name_Excel worksheet name[_artifact_count].xml
여기서 artifact_count는
스프레드시트에 두 개 이상의 아티팩트가 포함된 경우 단일 스프레드시트의
아티팩트 개수를 의미합니다. 스프레드시트에 1개의 아티팩트가 포함되어 있는 경우
이 인수는 필요하지 않습니다. 중요사항: 스프레드시트에
다른 아티팩트와 동일한
외부 ID가 있는
아티팩트가 있는 경우 해당 아티팩트가 스프레드시트 컨텐츠로부터 업데이트됩니다.
예를 들어, 동일한 구성으로 여러 번
동일한 Excel 스프레드시트를 내보내는 경우,
외부 ID가 매번 업데이트됩니다.
경고:
값이 셀이 아닌 문자열로 지정된 경우
artifact.XLSArtifactID="urn:com.ibm.rqm:testplan:2"를 사용할 때
XLSArtifactID를 읽도록 워크시트를 지정하는 데
artifact.XLSWorksheetID를 사용하지 않아야 하고 빈 시트가 없어야 합니다.
동일한
Excel 파일을 동일한 저장소로 내보내는 경우 새 아티팩트를 작성하려면
다음 단계 중 하나를 완료하십시오.
- XLSWorksheetID는 처리할 워크시트의 이름을 지정합니다. 이 키워드에는 리터럴 문자열을 사용해야 합니다.
참고: 버전 4.0부터는
testcases와 링크된
testsuite의 구문이
testsuite.testcases=testcase
에서
testsuite.XLSLink=testcase
- 다음은 일부 예입니다.
- 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"
스크립트 단계, 카테고리, 섹션, 이미지 내보내기,
단어 또는 구문의 동적 검색, 스프레드시트 특성 액세스는
특수한 경우입니다. 스크립트 단계에는 각 단계를 위한
여러 필드가 필요합니다. 스크립트에는 여러 단계가 있을 수 있으므로
빈 행이 발생하여 다음 단계가 시작될 때까지 모든 행은 단일 단계로 취급됩니다.
섹션은 특수한 경우입니다. 섹션의 사용을 단순화하고
해당 정의가 대신 사용하는 마침표 표기법의 사용을 방해하지 않도록 하려면
다음을 수행하십시오. 섹션을 업데이트하려면 다음 형식을 사용하십시오.
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=C
이 예제 구성 항목은 품질 관리 애플리케이션에 빌드되어 있는 승인 기준 섹션을 채웁니다.
- 사전 정의된 섹션의 이름 또는 표시 이름을 판별하려면
다음을 수행하십시오.
- 품질 관리에 있는 자원의 사전 정의된 섹션을 업데이트하십시오.
- https://jazz.net/wiki/bin/view/Main/RqmApi#ReadResource자원을 abbreviate=false가 있는 XML로 읽으십시오.
- 섹션 이름을 사용하여 XML 문서에서 요소를 찾으십시오.
예: com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria.
- 섹션 표시 이름이 포함된 요소에서 extensionDisplayName 속성을
찾으십시오. 예: RQM-KEY-TC-ACCEPT-CRITERIA-TITLE.
- 사용자 정의 섹션을 정의하려면 첫 번째 매개변수를 유효한 이름으로 대체하고
두 번째 매개변수를 표시 이름으로 대체하십시오.
testcase.Section("myns:mysection","my custom section")=C
- 카테고리를 정의하려면 다음 형식 category term=category_name.value=category_value를 사용하십시오.
testcase.category term="Function".value=H
- 하나의 아티팩트에 사용자 정의 속성을 추가하려면 다음을 수행하십시오. 하나의
테스트 케이스에 두 개의 customAttributes인 testcaseCustomAttribute1과
testcaseCustomAttribute2가 있는 경우, customAttributes testcaseCustomAttribute1
및 testcaseCustomAttribute2는 품질 관리 Excel 임포터를 실행하기 전에 품질 관리에
작성되어야 합니다.
.cfg 파일을 다음과 같이 구성할 수
있습니다.
testcase.customAttributes.type="SMALL_STRING" //사용자 정의
속성 유형(데이터 유형)을 설정합니다.
testcase.customAttributes.identifier=A //Excel의
A열에 ID를 입력합니다. ID는 작성 당시의 속성
이름입니다. 예를 들어, 이름이 "name1"인 customerAttribute를
작성하고 나중에 "name2"로 변경하는 경우 ID는
품질 관리 서버에서 "name1"으로 남습니다.
사용자 정의 속성 ID를 Custom_attribute_number_로 설정하고
첫 번째 속성은 Custom_attribute_0_이고 두 번째 속성이
Custom_attribute_1_인 경우, Excel 셀에 해당 ID를 입력할 때
이 ID는 올바릅니다.
testcase.customAttributes.name=B //속성 이름을 B열에 입력합니다.
testcase.customAttributes.value=C //속성 값을
C열에 입력합니다. 결과는 다음과 같습니다.
<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>
custom attributes.xls이 있는 새로운 샘플 TestCases 001과
custom attributes.cfg가 있는 TestCases 001이 추가되었습니다.
- 작업 중인 스프레드시트의 특성에 액세스하려면 다음 행을 사용하십시오.
세 가지 다른 특성 “Name,” “Full Name,” 및 “Location”도 사용할 수 있습니다.
특성이 설정되지 않았거나 Excel이 특성을 지원하지 않는 경우,
특성(“property name”)이 빈 문자열 “”을 리턴합니다.
관련 샘플 .xls 및 .cfg 파일은
문서 특성을 사용하는 Requirements001이라고 합니다.
- Excel에서 이미지를 내보내려면 스프레드시트에서 이미지의 이러한 측면을
이해해야 합니다.
Excel에서 이미지의 위치는 이미지의 왼쪽 상단이 포함되어 있는
셀에서 표시됩니다. 이미지에 여러 개의 셀을 사용해도 이미지를 내보낼 때
이미지 왼쪽 상단이 포함되어 있는 셀을 지정해야 합니다.
셀에는 이미지를 무제한으로 포함할 수 있습니다. 모든 이미지의 왼쪽 상단이 포함된 셀을
지정하면 모든 이미지를 내보냅니다.
Excel에서는 이미지를 2가지 방법으로 내보낼 수 있습니다.
첫 번째 방법은 이미지 함수를 사용하는 것입니다. 이미지는
구성 파일 항목에서 등호 다음에 들어가는 함수로 설정됩니다.
이미지는 셀 또는 행별로 지정할 수 있습니다. 이미지 함수는
이미지를 지정된 서식있는 텍스트 필드에 삽입합니다.
속성이 서식있는 텍스트 필드를 사용하지 않는 경우, 이미지 함수를
무시합니다. 다음 이미지 함수 예제를 참조하십시오.
- testscript.steps.expectedResult=image(G)
- testscript.steps.description=image(C4)
두 번째 방법은 첨부 속성을 사용하는 것입니다.
- testcase.attachment=C4
- testcase.attachment=C
첨부 속성은 이미지를 서식있는 텍스트 필드에 삽입하지 않고
아티팩트에 첨부로 추가합니다.
관련 샘플
.xls 및 .cfg 파일은
각각 이미지가 있는 스크립트에서 작성된 테스트 케이스 및 첨부가 있는 스크립트에서 작성된 테스트 케이스라고 합니다.