建立配置檔以便匯出 Excel 測試構件

當您匯出 Microsoft Excel 測試構件時,您必須有一個配置檔,來定義如何將 XML 檔對映至「品質管理」構件。

關於這項作業

配置檔包含一些陳述式,用來將「品質管理」構件資訊關聯於資料位置。配置檔中每一個陳述式的兩端用等號鏈結。陳述式左端由關鍵字組成。配置的等號右側可由三個可能的項目組成。
  1. 直欄或資料格定義,例如 D 或 D4
  2. 文字字串,例如 "execution"
  3. 另一個構件的參照(自我參照),例如 testscript.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 是如果單一試算表含有兩個或多個構件時,該試算表中的構件數目。如果試算表只含有一個構件,就不需要這個引數。
    重要: 如果試算表中有構件的外部 ID 與另一個構件相同,就會從試算表內容來更新構件。 比方說,如果您多次匯出具有相同配置的相同 Excel 試算表,則每次都會更新外部 ID。
    注意:
    如果您使用 artifact.XLSArtifactID="urn:com.ibm.rqm:testplan:2",並將值指定為字串(而不是資料格),請確定沒有空白表單,且沒有使用 artifact.XLSWorksheetID 指定工作表來讀取 XLSArtifactID。
    如果要在您將相同的 Excel 檔案匯出至相同的儲存庫時,建立新的構件,請完成下列其中一個步驟:
    • 使用 XLSArtifactID 關鍵字,為每一項匯出作業各指定一個唯一的外部 ID。
    • 每當匯出時,就變更 Excel 檔名或 Excel 工作表名稱。
    • 在您啟動匯出程序時,使用匯出至檔案選項,變更 XML 檔名稱,然後將 XML 檔匯入至「品質管理」:請登入「品質管理」,然後按下列其中一個指令:
      • 規劃 > 匯入測試計劃
      • 建構 > 匯入測試案例
      • 建構 > 匯入測試 Script
      提示: 前述方法只能用來匯入測試計劃、測試案例和測試 Script。
  • XLSWorksheetID 指定要處理的工作表名稱。對於這個關鍵字,您必須使用文字字串。
    註: 從 4.0 版開始,testsuite 與 testcases 鏈結的語法已從
    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"

    Script 步驟、種類、區段、影像匯出、動態搜尋某個單字或詞組,以及試算表內容存取都是特殊情況。Script 步驟要求每一個步驟要有數個欄位。由於 Script 可以有許多步驟,因此會將所有字行視為單一步驟,直到發現空白行之後,才開始下一個步驟。

    區段為特殊情況。這是為了簡化它們的使用,並且避免其定義干擾別處所用的句點表示法。如果要更新區段,請使用下列格式:
    testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=C
    這個範例配置項目會移入建置到「品質管理」應用程式中的驗收準則區段。

程序


意見