產生文件並以 Rational DOORS 作為資料來源

建立完報告範本,並在其中移入資料點之後,您就可以產生各種格式的報告。

開始之前

如果您從 Launcher 應用程式預覽資料,會使用預設基準線和視圖來擷取資料。

您可以從 Rational® DOORS® 資料來源中擷取「物件鏈結與內嵌 (OLE)」。 請參閱OLE 物件

使用附加程式來產生文件

如果您已安裝 Rational DOORS 附加程式,您可以直接從 Rational DOORS 使用者介面發佈。

關於這項作業

  • 當從 Rational Publishing Engine 附加程式,透過使用者介面或指令行來啟動本端文件產生作業時,您的電腦上會耗用一份授權。當遠端文件產生作業開始時,會移出授權。然後在文件產生作業完成之後,會移入授權。
  • 當從 Rational Publishing Engine 附加程式,透過使用者介面或指令行來啟動遠端文件產生作業時,伺服器上會耗用一份授權。當遠端文件產生作業開始時,會移出授權。然後在文件產生作業完成之後,會移入授權。
註: 當您使用 Rational Publishing Engine 附加程式來發佈文件時,您無法存取 Document Studio 或 Launcher 使用者介面。

程序

請從「資料庫」視圖或「模組」視圖」,按一下發佈
  • 當您從「資料庫」視圖按一下發佈時,就如同在 Rational Publishing Engine 中按一下文件規格 > 產生 > 配置和產生文件,系統會提示您輸入範本與文件規格配置。
  • 當您從「模組」視圖按一下發佈時,您可以選取一個新的文件規格,再將範本加到其中,或者您也可以選取其中已新增範本的現有文件規格。 之後,如果範本使用 Rational DOORS 資料來源,Rational Publishing Engine 會以開放模組中的資訊來配置您的資料來源,以產生文件。 如果文件規格中任何現有的配置資訊不符合開啟模組中的資訊,就會以開啟模組中的資訊來改寫現有的資訊。當選取至少一個範本和一個輸出格式時,完成就會啟用。
    重要: 如果要產生本端文件,Rational Publishing Engine 可以連接到執行中的 Rational DOORS 用戶端;不過,如果要產生遠端文件,就無法使用這個選項。 如果您是從「資料庫」或「模組」視圖中,利用遠端產生引擎來進行發佈,產生文件之前,您必須先在文件規格中輸入鑑別認證,如此一來,遠端 Rational Publishing Engine 服務才能夠建立新的 Rational DOORS 遠端控制用戶端實例來取出報告資料。

使用 Rational Publishing Engine 文件產生精靈來產生文件

您可以使用文件產生精靈來配置報告需求。

程序

  1. 在 Document Studio 或 Launcher 應用程式中,按一下文件規格 > 產生 > 配置和產生文件,來開啟文件產生精靈。
  2. 在「範本」區段中,範本已列在文件規格顯示畫面中。如果要新增範本,請執行下列動作:
    1. 選取要新增之範本的位置:
      • 從中央程式庫:如果要選取儲存在「中央管理」元件中的範本
      • 從本端或遠端檔案:如果要選取本端或遠端範本,您可以輸入範本的 URL,或是按一下瀏覽,來選取範本。
    2. 選取一或多個要新增的範本。
      • 如果您選取從中央程式庫,並且從「中央管理」元件選擇範本,請按一下新增選定項目,將範本新增至文件規格。
      • 如果您選取從本端或遠端檔案,並輸入個別範本的 URL,請按一下新增 URL,將範本新增至文件規格。
      • 如果您選取從本端或遠端檔案,並透過瀏覽來新增範本,當您按一下開啟時,會將範本新增至文件規格。
    3. 選擇性的: 重複上述動作,來新增其他位置中的其他範本。
    4. 選擇性的: 選取一個範本,並按一下上移下移,來重新排序文件規格中的範本。
    5. 下一步
  3. 在「資料來源」區段中,配置每一個資料來源。
    註:
    • 如果資料來源已有預設值,或者已輸入預設 URI 值,在輸出中,就會依照配置來顯示資料來源,且除非選取了另一值,否則會使用預設值。
    • 如果您跳過「資料來源」區段,然後按上一步,對資料來源進行其他變更,當開啟區段時,一律會顯示清單中的第一個資料來源。
    1. 資料庫:輸入要連接的資料庫名稱。依預設,會使用 -data 36677@localhost 如果沒有指定 -data,會自動附加。如果沒有指定任何值,Rational Publishing Engine 會從登錄擷取預設值(如果可能的話)。
    2. doors.exe 路徑:輸入 doors.exe 的完整路徑。 如果路徑無效或無法存取,如果可能的話,精靈會為您更正路徑。 範例:C:\Program Files\IBM\Rational\DOORS\version\bin\doors.exe
    3. 模組 URI視圖基準線:您可以輸入這些值,或按一下探索,利用精靈從值清單中選取。 如果您選擇使用探索精靈,請按下一步,並完成下列其中一個步驟:
      • 下一步,選取模組 URI視圖基準線的值。如果您按下一步,在「從 DOORS 資料庫選取視圖」視窗中,您可以從模組、視圖和基準線清單中選取。然後按一下完成
      • 輸入模組 URI。在輸入模組 URI 之後,會啟用完成,您可以按一下它,使用視圖和基準線的預設值。如果要使用非預設的視圖和基準線,請輸入要改用的視圖基準線值,並按一下完成
        註: 如果您手動編輯模組 URI 值,並輸入不正確的值,可能就無法產生輸出。當您提供不正確的視圖基準線值時,會從現行模組版本的預設視圖來產生輸出。會產生輸出,但資料不見得正確。
    4. 使用者名稱:輸入 Rational DOORS 帳戶名稱。
    5. 密碼:輸入 Rational DOORS 帳戶密碼。
    6. 選擇是否使用在文件產生期間使用執行中的 DOORS 實例選項:
      • 當您從這項文件規格產生文件時,如果預期 Rational DOORS 會從您指定給 doors.exe 路徑欄位的位置執行,請選取在文件產生期間使用執行中的 DOORS 實例選項。
      • 當您從這項文件規格產生文件時,如果預期 Rational DOORS 不會從您指定給 doors.exe 路徑欄位的位置執行,請清除在文件產生期間使用執行中的 DOORS 實例選項,以便啟動新的實例。
        註: 若有使用「遠端服務」應用程式,「遠端服務」應用程式一律會重新編寫 doors_homenew_instance 內容。在上傳文件規格之後,Rational Publishing Engine 會重新編寫內容,以符合伺服器配置。

    在精靈中,當 Rational Publishing Engine 取代了不正確值時,也會在「內容」視圖中更新該資料來源的值,以及更新執行時期旗標值中的值。

  4. 在「變數」區段中,配置每一個變數。
    註:
    • 如果變數已有預設值,在輸出中,就會依照配置來顯示變數,且除非選取了另一值,否則會使用預設值。
    • 如果您跳過「變數」區段,然後按上一步,對變數進行其他變更,當開啟區段時,一律會顯示清單中的第一個變數。
    1. 從下拉功能表中,選取下列其中一個選項:
      • 手動配置:如果因為這個變數沒有其他配置資訊存在於配置層或「中央管理」元件中,而要為變數輸入任何值
      • 從配置層:如果要從您在範本中針對變數所輸入的配置 meta 資料選取一值
      • 使用中央程式庫中的變數值:如果要選取儲存在「中央管理」元件中的變數
    2. 輸入或選取配置值。
    3. 下一步
  5. 在「輸出」區段中,選取要產生的輸出類型:
    • Microsoft Word
    • PDF
    • HTML
    • XSL-FO
    • 舊式 PDF
    1. 選擇性的: 針對儲存位置,按一下瀏覽,針對每一種輸出類型,選取用來儲存檔案的路徑。 如果沒有指定輸出的儲存位置,會將檔案產生於暫時位置中。
    2. 選擇性的: 針對樣式表,按一下瀏覽,針對每一種輸出類型,選取產生輸出期間要使用的樣式表。
    3. 選擇性的: 僅適用於 Microsoft Word 輸出:針對巨集,輸入樣式表內所包含的巨集名稱。
    4. 選擇性的: 如果要輸入其他的 meta 資料,或配置精靈中未包含的其他文件內容,請按一下編輯 meta 資料內容
    5. 下一步
  6. 在摘要視窗中,驗證範本和輸出資訊是正確的。
  7. 選取當您按一下完成時,要採取的動作。
    • 執行文件產生作業:產生您指定的輸出類型。
    • 執行文件產生作業並關閉 RPE:產生您指定的輸出類型,並在您結束「結果」精靈之後,關閉 Rational Publishing Engine 應用程式。
    • 關閉這個精靈並開啟 RPE 用戶端:在 Launcher 應用程式中開啟文件規格和您所輸入的詳細資料。

意見