共用方式為

整合套件精靈

  • 發行項

整合套件精靈 （IP 精靈） 可讓您從現有的 整合元件建立新的整合套件。 整合元件 可以使用命令行活動精靈 （CLIActivityWizard） 或使用 Orchestrator SDK 來撰寫。 IP 精靈 （IPWizard） 會將元件、相依檔案和必要的元數據封裝到 .OIP 可透過 Orchestrator 部署管理員部署的檔案中。 您可以使用完整的品牌和自定義圖示來建立專業外觀整合套件，或只是封裝命令行活動，以便使用IP精靈更輕鬆地部署它們。

決定何時建立整合套件

請務必決定是否適合搭配工具組的 .NET 整合套件活動個別使用活動，或者最好是在整合套件 中建立和部署所有活動。

當您只有少數活動，或是在開發階段並在活動中建立許多變更時，您應該只使用元件搭配 Toolkit .NET Integration Pack 活動，在 Runbook 中執行這些活動。 封裝、註冊、部署、卸載和升級整合套件，在開發過程中會產生大量額外負荷。

如果您有一組要測試的活動，或是在開發週期中進一步進行，而且想要測試整個端對端安裝或升級程式，則建立整合套件是較佳的方法。 整合套件提供更方便使用者使用的體驗和完整的安裝體驗。 整合套件也允許將活動部署到整個組織或外部客戶的多個 Runbook 伺服器或 Runbook 設計工具。

建立新的整合套件

整合套件精靈可讓您從現有的 Orchestrator 相容元件和相依檔案建立整合套件。 如果您尚未建立 Orchestrator 相容的元件，請參閱 命令行活動精靈。

注意

Integration Toolkit 不再包含 Windows Installer XML （WiX） 工具組的二進位檔，IP 精靈會用來建立自定義整合套件。 使用IP精靈之前，請先安裝WiX工具組的最新版本 （v3.11）。

建立新的整合套件

  1. 啟動整合套件精靈。 選取 [ 啟動 > Orchestrator 整合套件精靈]。 歡迎頁面隨即顯示。

  2. 如果您有想要更新的現有整合套件，請選取 [ 匯入整合套件]。 如需詳細資訊，請參閱 更新現有的整合套件。 若要建立新的整合套件，請選取 [ 下一步]。

    重要

    如果您想要升級現有的IP，您必須選取 [ 匯入整合套件]。 如果您選取 [下一步]，您建立的IP將會為所有活動提供新的唯一產品識別碼和新的唯一標識符，即使您重複使用先前的元件並使用相同的產品和檔名也一樣。

  3. 在 [ 產品詳細數據] 頁面上，輸入或修改所需的資訊，以自定義整合套件的相關信息。 下表描述欄位及其描述：

    欄位名稱 描述
    產品名稱 部署管理員中顯示的IP名稱
    類別名稱 在 Runbook Designer 的 [活動] 窗格中顯示為 IP 類別標題的文字
    公司 您公司的名稱。 這項資訊會顯示在 [發行者] 底下的 [新增/移除程式] 中
    EULA 檔案 擴展名為 RTF 格式的 .EULA 文字檔。 EULA 會在使用部署管理員進行註冊期間向用戶顯示，而且在註冊之前需要接受。
    資源檔 元件，其中包含用來提供類別和活動圖示的圖示和其他資源。 根據預設，會使用標準工具組資源檔（Microsoft.SystemCenter.Orchestrator.Integration.Toolkit.Wizard.Images.dll）
    版本 整合套件的版本號碼，將會顯示在部署管理員中，並用來判斷IP是否為升級。
    啟用升級 如果您匯入現有的整合套件，預設會選取此複選框，讓此整合套件升級現有的已安裝版本。 如果您清除此複選框，將會為IP建立新的產品和活動標識碼（不會升級現有的版本）。 如果您想要啟用多個IP版本的並存安裝，請清除此複選框。
    描述 整合套件的詳細描述
    類別圖示 默認類別圖示隨即顯示。 如果您想要選擇其他圖示，請選取 [修改] 按鈕並選取新的圖示，然後選取 [ 確定]。

  4. 當您完成輸入產品資訊時，請選取 [ 下一步]。 [活動] 頁面隨即顯示。 [活動] 頁面是您將參考元件或元件，其中包含您使用 [命令行活動精靈] 或使用 Orchestrator SDK 建立的活動。

  5. 若要將新的活動新增至IP，請選取[ 新增]。

  6. 若要開啟並新增元件檔，請選取連結庫右邊的省略號 （...） 按鈕。 流覽至所需的元件檔案、選取它，然後選取 [ 開啟]。 檔名和路徑會顯示在 [連結庫] 欄位中。

  7. 若要從元件中選取活動，請選取 [類別 ] 下拉式箭號，然後從清單中選取適當的活動名稱。 活動中定義的名稱和描述會顯示在 [顯示名稱 ] 和 [描述 ] 字段中。

  8. 如有需要，請修改活動的顯示名稱和描述。

  9. 活動的預設活動圖示隨即顯示。 如果需要不同的圖示，請選取 [修改]，從瀏覽器選取另一個圖示，然後選取 [ 確定]。

  10. 選取 [ 確定 ] 以儲存活動定義。 活動名稱和描述現在會出現在 [活動] 清單中。

  11. 視需要繼續將活動新增至清單。 當您完成新增活動時，請選取 [ 下一步]。 [相依性] 和 [包含的檔案] 頁面隨即顯示。

  12. 在此頁面上，您可以定義您想要使用整合套件封裝的額外檔案清單。 這些檔案可能是活動、腳本、檔或其他您想要部署至 Runbook 伺服器和 Runbook 設計工具以及活動的其他檔案所需的額外元件。 選取 [ 新增]，選取您需要的檔案，然後選取 [ 確定 ] 將檔案新增至清單。

  13. 當您完成將檔案新增至清單時，請選取 [ 下一步]。 [Orchestrator 整合套件檔案] 頁面隨即顯示。

  14. 在提供的文字框中，輸入要建立之整合套件的路徑和檔名。 如果您輸入已經存在的檔名，則會覆寫它。 請確定您有足夠的存取權可寫入指定的路徑，否則進程將會失敗。 如果未指定路徑，則會在 [文件] 資料夾中建立 OIP 檔案。C:\users\<your username>\Documents 選取 [下一步 ] 開始建置IP。

    重要

    檔名中的字元對於安裝在操作系統上的語言必須有效。

    重要

    指定整合套件的名稱，以確保它不符合另一個 Integration Pack 的名稱。 Orchestrator 無法安裝兩個具有相同名稱的整合套件。

  15. 成功建置IP時，精靈的最後一頁會顯示新OIP檔案的路徑和檔名。 選取 [完成] 以結束精靈。 如果發生錯誤，您可以選取 [上一頁 ]，然後重試建置程式。

    如需部署整合套件的資訊，請參閱如何新增整合套件一文。

更新現有的整合套件

Orchestrator 整合套件精靈可讓您匯入現有的整合套件，以便進行變更，並將其重新封裝為新版本。 確定您核取 [ 啟用升級] 複選框，否則將會建立新的IP，而不是取代或升級先前安裝的版本。

實用的IP升級秘訣

更新基礎元件

當您建立整合套件時，有關IP的元數據會儲存在封裝中，以便精靈在後續升級期間讀取。 當您更新某些專案，例如活動或這些活動的基礎元件時，您需要重建IP。 不過，如果您修改活動設定並選取新的元件檔案，則會重設 [活動資訊] 頁面上的欄位，要求您再次輸入資訊。

您可以保留IP組態設定，同時只修改元件。 將您的新元件儲存到與上一個元件相同的路徑和檔名（如 [活動資訊] 對話框的 [連結庫] 字段中所示）。

QIK 整合套件移轉

如果您使用 Opalis QIK 精靈建立整合套件，則必須將它轉換成與 Orchestrator 相容，才能由 Orchestrator 匯入和使用。

轉換IP之前，必須完成下列步驟：

  • 如果您使用 QIK CLI 精靈建立 IP 中的活動，您必須遵循 QIK CLI 活動移轉中所述的步驟，使其與 Orchestrator 相容。 如果您沒有包含活動的元件個別複本，您必須先將IP安裝到Opalis 6.3 伺服器，然後找出下列目錄中的元件： C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Quick Integration Kit 3。

  • 如果您的IP中的活動是使用Opalis API 在 C# 中自定義開發的，您必須遵循移轉 QIK API 自定義活動中所述的步驟，使其與 Orchestrator 相容。

    注意

    Integration Toolkit 或 Orchestrator 不再支援使用適用於 Java 的 Opalis API 的 Java 型活動。

  • 如果您的IP包含相依或其他內含檔案，則必須使用這些檔案，才能重新封裝到新的IP。 如果您沒有這些檔案的個別複本，您必須先將IP安裝到Opalis 6.3 伺服器，然後找出下列目錄中的檔案： C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Bin。

  • 如果您的IP包含用於活動和類別圖示的自訂資源檔，該檔案必須可供新的IP使用。 如果您沒有此檔案的個別複本，您必須先將IP安裝到Opalis 6.3 伺服器，然後找出下列目錄中的檔案： C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions。

  • 如果您的 IP 針對類別或活動圖示使用 QIK 所提供的標準圖示，而且您想要繼續使用這些圖示，而不是使用 Orchestrator 中提供的新圖示，則必須取得 Opalis.QIK.Wizard.Images.dll 檔案，並以自定義資源檔的形式使用它。 如果您沒有此檔案的個別複本，您必須先將IP安裝到Opalis 6.3 伺服器，然後找出下列目錄中的檔案： C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions。

注意

針對最簡單的轉換程式，您應該將這些檔案放在IP最初封裝之前，於IP精靈之前所位於的位置。 IP 精靈會依原始路徑參考這些檔案。 選取所有檔案的新路徑是可行的，但選取包含活動之元件的新路徑，會導致要重設活動的一些詳細數據，而要求您再次輸入資訊。 藉由使用檔案的原始路徑，就只會重複使用現有的資訊，而不需要重新輸入它。

轉換 Opalis 相容的整合套件

  1. 啟動整合套件精靈

  2. 選取 [匯入 整合套件]。

  3. 選取現有的 OIP 檔案，然後選取 [ 開啟]。

  4. 您會看到警告訊息，指出IP與Orchestrator不相容。 選取 [確定]。

  5. 視需要修改產品詳細數據，以反映任何變更。 IP 的版本號碼會自動遞增，並核取 [升級] 複選框。 選取 [下一步]。

  6. 在 [活動] 頁面上，流覽每個活動，並確定資訊已正確完成。 如果活動的元件尚未移轉，或與建立IP時的位置不同，則 [類別 ] 欄位會是空的。 若要避免重新輸入任何資訊，您應該先取代元件，再啟動精靈。

  7. 當您完成編輯活動時，請選取 [ 下一步]。

  8. 請確定相依檔案仍位於與顯示的相同位置，或移除相依檔案並新增相依檔案。 選取 [下一步]。

  9. 輸入新IP檔案的路徑和檔名。 請勿使用與上一個IP相同的名稱，以確保您保留上一個IP的複本。 選取 [下一步 ] 以建置IP。

    您現在有一個與 Orchestrator 相容的 IP，而且可以使用 Orchestrator 部署管理員來註冊和部署。

整合套件 – 已知問題

檔名長度限制

在整合套件中包含元件時，安裝程式會自動將其新增至登錄。 由於登錄機碼名稱長度的限制，元件的組合路徑和檔名不能超過 234 個字元。 指定放置IP內元件的預設路徑，內含元件檔的檔名長度上限不能超過80個字元。 如果安裝中包含檔名超過80個字元的元件，安裝將會失敗。

Orchestrator 資源

除了 System Center Orchestrator 所提供的此在線參考之外，有許多資源可以提供建置 Runbook、使用 Integration Toolkit 和最佳做法的其他資訊。

另請參閱