在此課程中,您將學習如何修改 XML 資料配置檔。 XML 資料配置檔包含用於 ETL 的資料來源與結構相關資訊,XML ODBC 驅動程式會在執行時期使用此配置檔。 在此課程中,您將在 XML 資料配置檔中新增屬性及資源。
對於此課程,您將使用 clearquest.xdc 檔案作為起始點,並修改此檔案以符合課程目標。
您將新增元件實體,並讓它成為問題記錄的內容。
在此課程中,您將:
- 修改資源群組的連線資訊,以符合環境中部署的資料服務伺服器
- 修改問題資料表,以新增屬性及值對映
- 新增元件的資源及資料表
- 將多個專案新增到資源種類
配置資源群組的伺服器連線- 啟動 XML Data Configuration。
- 按一下。 此檔案通常位於 [rational_insight_installation_directory]/dataconfig/configs/configurations 目錄中。
- 展開 XML Data Configuration 節點以列出資源群組。 按兩下 CQEnterprise。
CQEnterprise 通常位於 中。
- 在資源群組編輯器中,變更「資料服務 URL」,以符合環境中部署的資料服務伺服器的 URL,然後變更鑑別類型以及使用者名稱與密碼,以符合資料服務伺服器中的鑑別設定。
概念: 資源群組應定義一組 XML 文件的基本 URL。 資源群組的建議範圍依產品而定:
- Rational® ClearQuest®:使用者資料庫的 URL
- Rational RequisitePro®:RequisitePro 專案的 URL
- Rational ClearCase®:ClearCase VOB 的 URL
- Microsoft® Project:專案檔的 URL
- Rational QualityManager:RQM REST 服務的根 URL
- Rational TestManager:TestManager 專案的 URL
- 儲存配置。
您現在已修改了 clearquest.xdc 檔案的連線資訊,以符合環境中部署的資料服務伺服器。
將直欄新增至資料表- 展開 節點以列出資料表。
概念: ENTDefect 節點代表 XML 文件(資源),
其中含有結合母項資源群組定義的 URL 與指派給資源的相對路徑後所傳回的所有問題記錄。
- 按兩下 ENTDefect 資料表。
- 按一下直欄標籤,選取優先順序直欄的列,然後按一下編輯器右上角的值對映鏈結。
概念: 透過值對映,您可在擷取處理程序中將來源實例值轉換為新的值。 若要將多個來源的資料共用定義標準化,這是一個非常方便的方法。 例如,若您的公司使用「高」、「中」及「低」來定義優先順序,而公司內的部分群組使用 P1、P2 及 P3 來定義優先順序,則您可以定義值對映來標準化此定義。
- 在值對映視窗中,指定下列值:
儲存資料表。
- 若要開啟關聯的資料表範本,請在直欄標籤中,按一下右上角的修改鏈結。
選取優先順序列定義,在 XML 綱目區段中選取業務優先順序直欄,然後按一下更新 XPath。
概念: XML Data Configuration 將使用現有的直欄對映,自動驗證從資料服務返回的綱目。 任何無效的對映都會在畫面上強調顯示。 在此狀況下,自訂的綱目與現行「優先順序」直欄具有相同的資訊,但在不同的屬性中。 在此步驟中,您將無效的現成可用 /Priority XPath 重新對映到有效的 /BusinessPriority XPath。
- 在「直欄對映」區段中,展開 XML 綱目區段下的問題根節點,列出問題下的屬性。
在接下來的若干步驟中,您將從 XML 來源建立新的表格直欄對映。 左邊的樹狀結構代表與資料表關聯的可擷取節點內包含的子節點。
- 按一下狀態,再按一下建立。
確保表格直欄的名稱為 Status,「SQL 類型」為 Varchar。 儲存表格範本。
- 在「對映直欄」區段中,展開 XML 綱目區段下的問題根節點,
列出問題下的屬性。
選取節點。
- 按一下 dbid,再按一下建立。
確保表格直欄的名稱為 Component_dbid,「SQL 類型」為 Integer。 儲存表格範本。
概念: 在此指導教學的自訂「企業」綱目中,您需要為 ETL 處理程序提供足夠的資訊,才能建立從「問題」記錄到「元件」記錄的關係。 您將透過公開「元件 dbid」屬性(ClearQuest 記錄的唯一索引鍵)來執行此作業。
- 回到 ENTDefect 資料表編輯器。 提示更新時,按一下確定。
- 選取 Status 與 Component_dbid 這兩個新的直欄,然後按一下載入。
概念: 資料表定義可包含關聯資料表範本中的直欄對映子集。
使用「載入/卸載」功能,可控制直欄對 ODBC 用戶端的可見性。
- 儲存資料表。
您現已透過新增屬性及值對映修改了問題資料表。
接下來,將定義新的資料表,以公開來自 XML 來源的元件資料。 首要步驟是定義新的資源來代表包含元件資訊的 XML 文件。
建立資料表- 在 CQEnterprise 資源群組上按一下滑鼠右鍵,選取,然後選取使用資料服務尋找。
概念: 如果不知道資源的 URL,則可使用使用資料服務尋找來定義資源。
- 將名稱指定為 ENTComponent,然後按下一步。
- 展開節點,在元素屬性區段中,選取 href 勾選框,然後按下一步。
您現在正在使用精靈來擷取從資源群組層次返回的 XML 文件綱目。 「個人查詢」與「公用查詢」資料夾包含 ClearQuest 使用者資料庫中定義的相關查詢。 「記錄查詢」資料夾包含動態產生的 ClearQuest 資料服務查詢,這些查詢將返回特定類型的所有記錄。 使用精靈頁面,您可將關注的範圍縮小至所有可能的記錄,而無需查看實際資料。
- 選取以 /Record+Queries/Component 結尾的 URL。
畫面上會顯示透過前一精靈頁面所選節點的所有實例。 按一下完成。
- 在新建立的資源上按一下滑鼠右鍵,並選取,然後將名稱指定為 ENTComponent。 按下一步。
- 將可擷取的節點指定為 /Query/results/Component。
按下一步。
- 選取建立新範本。 鍵入資料表的名稱及說明,然後按下一步。
在下一步中,您將在 XML 樹狀結構中選取要作為表格直欄的那些節點。
- 選取下列節點:
- dbid(SQL 類型為 Integer)
- 元件(SQL 類型為 VARCHAR)
按一下完成。
您現在已定義了 CQEnterprise 資源群組中的必要資料表。 此時,它僅用於單個 ClearQuest 資料庫。 但您可擷取單個資源種類下多個資源群組的資料。 為此,您需要為該資源種類下的每個 ClearQuest 資料庫建立資源群組。
在接下來的若干步驟中,您將在 ClearQuest Enterprise 資源種類下建立新的資源群組。
為此,將使用 CQEnterprise 資源群組作為起始點。
建立其他專案的資源群組- 拖曳 CQEnterprise 資源群組,並將其放入 ClearQuest Enterprise 資源種類中。
- 按一下複製。
- 選取重複的資源群組並進行修改,變更其 URL 以符合另一個專案的 ClearQuest 使用者資料庫的資料服務 URL。
在此指導教學的第一部分中,您已學習如何執此作業。
概念: 在 ETL 中,可依種類組織資源群組,從而以批次模式載入具有相同配置的多個資源群組。
- 選取鏈結至現有資源群組,選取 CQEnterprise,然後按一下確定並儲存變更。
概念: 您可以將資源群組鏈結至現有資源群組。 您建立的新資源群組具有自己的名稱與連線資訊,但會共用在現有資源群組 CQEnterprise 中定義的所有資源及資料對映表格。 這表示只維護資源與資料對映表格的一個副本。
如果您變更 CQEnterprise,所有鏈結的資源群組即會自動使用已更新的資源與資料對映表格。