當您匯出 Microsoft Word 測試構件時,您必須有一個配置檔,來定義如何將 XML 檔對映至「品質管理」構件。
程序
註: 配置項目等號的右端必須包含一個文字字串、表格或大綱定義。表格是用 Table( 項目表示。
清單是用 List( 項目表示。這兩個項目的結尾都必須是右括弧 ())。
如果要建立對映,請執行下列動作:
- 建立大綱定義:大綱清單的內容定義可以包含縮排層次,或是包含用星號 (*) 表示的單一萬用字元。縮排層次是一個整數,而萬用字元則必須放在雙引號內。
兩者都可以在逗點之後用特定的段落編號來進一步定義。
下列範例是指示匯出公用程式尋找其標題符合 "1.*." 型樣的大綱,並且只取該大綱中的第一段來作為測試案例標題:
testcase.dc:title=List("1.*.",1)
如果您省略逗點和數字,則會將大綱層次的整個內容放在標題欄位中。
如果所用的整數沒有括上雙引號,匯出公用程式會使用位於指定縮排編號的內容:
testcase.dc:title=List(1,1)
- 建立表格定義:表格是用它所在的數字來定義,或是用第一個資料格的內容來定義。
您用數字來定義的表格是靜態的,因此,使用該表格的每一個構件一律會參照該確切的表格。具名表格是動態的,這表示如果文件中有多個表格符合文字,就會建立多個構件。
在定義表格之後,其後必須接著一個句點和一個資料格或直欄的參照,就像定義 Excel 資料格或直欄一樣。
範例是定義一個靜態表格和一個靜態資料格:
testscript.dc:title=Table(1).B3
動態表格會比對第一個表格資料格中的文字開頭。比對功能有區分大小寫,但是會忽略空格。這個範例會從其第一個資料格的開頭是“Step”的所有表格中,取得直欄 B 的資訊:
testscript.steps.title=Table("Step").B
- 建立自我參照鏈結:如果要定義自我參照,請指定先前定義之字行的等號左端中的資訊:
testscript.dc:title= Table(1).G
testcase.dc:title=testscript.dc:title
提示: 使用自我參照所建立的構件,會使用另一個構件已在使用的資料,並且會建立指向該構件的鏈結。
- 使用關鍵字:XLSLink 關鍵字指定構件鏈結至文件中指定類型的所有構件。在本例中,文件中的所有測試 Script 會鏈結至所有測試案例:
testcase.XLSLink=testscript
請使用
DOCStart 和
DOCStop 關鍵字來指定要從哪一項清單定義開始及停止。這些關鍵字僅用於清單類型,並且必須包含一個字串文字。在下列範例中,當找到第 5 個項目時,配置項目就開始處理清單,並在找到第 12 個清單項目時停止處理。這些相符項是精確的;清單項目 "12.1" 並不會結束程序。
testscript.DOCStart="5."
testscript.DOCStop="12."
- 修改資料:任何目標定義都可以包裝在 Pre() 修飾元內。
下列範例將產生的資料包裝在 <div> 和 <pre> 標籤內,以保留格式設定資訊:
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")
區段為特殊情況,這是為了簡化它們的使用,並且避免其定義干擾別處所用的句點表示法。
如果要更新區段,請使用下列格式:
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=Table(1).C
前面的項目會移入驗收準則區段,該區段會建置到「品質管理」應用程式中。請參閱下列主題中,有關指定預先定義區段的名稱或顯示名稱的程序:
建立配置檔以便匯出 Excel 測試構件。如果要定義自訂區段,請用有效的名稱取代第一個參數,以及用顯示名稱取代第二個參數:
testcase.Section("myns:mysection","my custom section")=Table(1).C
種類是用
category term=category_name.value=category_value 表示法來定義。
種類名稱放在雙引號內:
testcase.category term="Function".value=Table(1).H
請使用
& 符號,來將二或多位元的資料新增至相同的欄位。資料可以是多個項目的混合。這個範例顯示所新增的資料:
testcase.description=”my description:” & Table(1).H & testscript.description
- 存取要匯出之檔案的文件內容:請遵循下列範例來存取 Word 檔文件內容:
- requirement.dc:title=property(“Title”)
- requirement.dc:creator=property(“Author”)
- requirement.jzalm:owner=property(“Company”)
您可以在下列網址找到 Microsoft Office 內建的可用內容:http://msdn.microsoft.com/en-us/library/microsoft.office.core.documentproperty.aspx。
另有其他三個內容可以使用:“Name”、“Full Name”和“Location”。如果未設定內容,或者 Word 不支援該內容,則內容 ("property name") 會傳回空字串:""。
相關的 .xls 和 .cfg 範例檔稱為“Testscript in Tables using Document Properties”。
範例
以 4.0 版而言:清單中的設計和構件已變更為預期以
\n 隔開,而不是在一個構件內使用
\n,如下列範例所示:
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
兩個測試案例標題之間的空白行表示測試案例區隔。