建置範例 API 應用程式

Rational® Publishing Engine 隨附了範例應用程式, 其可示範利用 API 於本端或遠端執行預先配置的文件規格。

關於這項作業

該應用程式位於 %RPE_HOME%/lib/api/example 中。 如果未提供 -home 選項的值,建置時期會使用您專案的起始資料夾。在部署應用程式時, 您必須在與 .jar 檔相同的資料夾中提供此起始資料夾, 應用程式才能找到起始資料夾。

程序

  1. 開啟 %RPE_HOME%/lib/api/example
  2. 解壓縮 com.ibm.rational.rpe.examples.zip 保存檔。
  3. 讓您的應用程式可存取 Rational Publishing Engine 程式庫中必要的 .dll.so 檔。
    重要: 範例保存檔之根目錄中所提供的 .dll.so 檔, 不一定適用於您的環境。
    • 32 位元應用程式:
      1. %RPE_HOME%/lib/rcl_telelogic.dll
      2. %RPE_HOME%/lib/librcl_telelogic.so
    • 64 位元應用程式:
      1. %RPE_HOME%/lib/64/rcl_telelogic.dll
      2. %RPE_HOME%/lib/64/librcl_telelogic.so

    如果要讓應用程式可存取這些檔案,您可以:

    • 新增檔案路徑至應用程式啟動 Script。這個選項可確保應用程式不管是在何處執行,都是自行包含的。
    • 新增檔案路徑至 PATH 系統變數。 如果您選擇這個選項,則必須在使用應用程式的每一部電腦上完成這個步驟。
  4. Rational Publishing Engine 安裝檔案的 lib 目錄中,複製外掛程式。
    • 如果要建置 32 位元應用程式,請複製 %RPE_HOME%/lib 目錄中的外掛程式。
    • 如果要建置 64 位元應用程式,請複製 %RPE_HOME%/lib/64 目錄中的外掛程式。
  5. 將外掛程式貼到已解壓縮之範例保存檔的 lib 目錄中。請勿複製 .dll.so 檔。 範例:project/lib
  6. 開啟 %RPE_HOME%/config 目錄。
  7. 複製 rpeconfig.xmlRPEElementsDefinitions.xml 檔。
  8. rpeconfig.xmlRPEElementsDefinitions.xml 檔貼到範例的 home/config 資料夾中。 此範例的設計是從 src 資料夾的根目錄使用 log4j.properties 檔, 而不能從 home/config 資料夾使用該檔案(即使有提供)。
  9. 選擇性的: 如果要從 Rational DOORS® 產生文件,請複製 %RPE_HOME%/source/DOORS%RPE_HOME%/source/DB Structure 資料夾
  10. 選擇性的: DOORSDB Structure 資料夾貼到專案的 home/source 資料夾中。
  11. 複製 %RPE_HOME%/utils/Word%RPE_HOME%/utils/HTML 資料夾。
  12. Word and HTML 資料夾貼到專案的 home/utils 中。
  13. 將類別路徑更新為專案中外掛程式的路徑。

意見