共用方式為

如何匯入 BizTalk 應用程式

  • 發行項

本主題描述如何使用 [BizTalk Server 管理] 主控台或命令列，以將 BizTalk 應用程式匯入 BizTalk 群組。 匯入 BizTalk 應用程式會在 BizTalk 管理資料庫中註冊成品，並將成品的資料寫入適當的 BizTalk 資料庫。 如需詳細資訊，請參閱匯 入成品時會發生什麼情況。 匯入應用程式並不會安裝該應用程式， 您必須先安裝包含檔案架構成品的應用程式，才可以執行該應用程式。

使用 [BizTalk Server 管理] 主控台匯入應用程式時，您啟動匯入 MSI 精靈的地方將決定您是否可以在匯入成品的同時建立新的應用程式。 如果是使用滑鼠右鍵按一下 BizTalk 群組來啟動精靈，就必須提供應用程式名稱。 如果 BizTalk 群組中具有您指定名稱的現有應用程式，就會將檔案中的成品匯入此應用程式；否則，會建立具有指定名稱的新應用程式，再將成品匯入其中。 如果是使用滑鼠右鍵按一下應用程式來啟動精靈，就無法指定應用程式名稱，而會將成品匯入目前的應用程式中。

使用 BTSTask 命令列工具匯入 .msi 檔案時，不一定需要提供應用程式名稱。 如果沒有提供應用程式名稱，就會將成品匯入預設應用程式中。

成品匯入後，您可以在 [BizTalk Server 管理] 主控台的應用程式資料夾下的適當資料夾中進行檢視。 您也可以使用 BTSTask 檢視應用程式中的成品清單，如 ListApp 命令中所述。

必要條件

若要匯入 BizTalk 應用程式，您必須使用「BizTalk Server 系統管理員」群組成員的帳戶登入。 若要安裝 BizTalk 應用程式，則也必須具有本機檔案系統的寫入權限。 如需許可權的詳細資訊，請參閱 部署和管理 BizTalk 應用程式所需的許可權。

匯入應用程式的考量

匯入應用程式時，適用下列考量：

  • 從舊版BizTalk Server匯入應用程式。 如果您要從 BizTalk Server 2006 R2 或 BizTalk Server 2009 匯入應用程式，且應用程式包含 EDI/AS2 合作物件資料，則應用程式匯入可能會失敗，因為交易夥伴管理模型在BizTalk Server中已大幅變更。 您必須改用「合作對象移轉工具」，從舊版 BizTalk Server 移轉合作對象資料。 如需工具的詳細資訊，請參閱 EDI 移轉公用程式。

  • 匯入的繫結永遠會覆寫現有的繫結。 在現有應用程式中匯入包含繫結的 .msi 檔案時，現有繫結會遭到具有相同名稱的匯入繫結所覆寫。 即使您沒有在匯入 .msi 檔案時選取覆寫現有成品選項也會如此。 如果不想用匯入的應用程式繫結來覆寫要匯入 .msi 檔案的應用程式的現有繫結，則應該在匯出作業期間選擇不要將繫結檔案做為匯出資源。 如需詳細資訊，請參閱 如何匯出 BizTalk 應用程式。

    由於繫結是在匯入過程中套用，新的繫結會覆寫先前已套用的同名繫結。 也就是說，同名的繫結當中最後套用的繫結將會生效。 當您匯入應用程式時，將依下列順序套用繫結：

    1. 並非透過繫結檔案明確加入至應用程式，而是使用者明確選定欲匯出至應用程式 .msi 檔案的應用程式繫結 (由 BizTalk Server 所產生)。

    2. 已明確加入，但未指定目標部署環境的繫結檔案。 套用此集合中的繫結時，並無特定順序。

    3. 已明確加入，且其相關聯目標部署環境與應用程式匯入所選定的部署環境相符的繫結。 套用此集合中的繫結時，並無特定順序。

  • 群組中必須有主控件。 BizTalk 群組中必須已經有主控件能夠相對於 .msi 檔案所含應用程式繫結中指定的主控件，否則匯入作業將失敗。 此外，主控件的信任層級也必須相符合。

  • 需要將參考新增至其他應用程式。 如果要匯入的應用程式與另一個應用程式中的成品相依，則必須新增參考至此應用程式。 群組中必須已經有應用程式和必要的成品。 匯入精靈有提供這個選項。 不過，如果您使用 BTSTask 的 ImportApp 命令，則必須在匯入之後新增應用程式的參考，如 如何將參考新增至另一個應用程式中所述。 如需背景資訊，請參閱 相依性和應用程式部署。 匯入精靈會比對群組中現有應用程式的參考，並讓您選擇要新增參考或變更現有的參考。 您應該另外確認參考的應用程式是否包含必要的成品。

  • 如果匯入作業逾時，請將應用程式分割到其他 .msi 檔案中。 匯入作業的持續時間一旦超過 3600 秒就會逾時。 如果您嘗試匯入某個 .msi 檔案而發生作業逾時，請重新匯出應用程式並分批選取所要匯出的部分成品，以將應用程式的內容分成多個 .msi 檔案。 如需詳細資訊，請參閱 如何匯出 BizTalk 應用程式。

重要

基於安全性考量，應用程式匯出期間將從應用程式繫結移除密碼。 但是，並不是從新增至應用程式的繫結檔案中移除密碼。 匯入應用程式後，您必須重新設定密碼，應用程式才能正常運作。 您可以編輯繫結檔案或使用管理主控台，以完成這項作業。 如需編輯系結檔案的詳細資訊，請參閱 自訂系結檔案。 如需設定配接器安全性的詳細資訊，請參閱 使用配接器。

注意

當匯入作業失敗時，除了自訂指令碼執行的動作外，BizTalk Server 會回復所有的匯入作業。

注意

如果您在一個使用其他應用程式中之屬性結構描述的應用程式內建立傳送埠的篩選，然後再將此應用程式匯入至新的 BizTalk 群組，那麼您在安裝及啟動應用程式時，將不會收到結構描述遺失的警告，並且篩選功能也無法運作。 在安裝沒有包含結構描述的應用程式之前，您可以先匯入包含結構描述的應用程式來修正問題。

使用BizTalk Server管理匯入 BizTalk 應用程式

  1. 依序按一下 [開始]、[所有程式]、[Microsoft BizTalk Server 20xx]，然後按一下[BizTalk Server系統管理]。

  2. 在主控台樹中，依序展開 [BizTalk Server系統管理]、[BizTalk] 群組，然後執行下列其中一項：

    • 若要將包含在 .msi 檔案中的應用程式和成品匯入 BizTalk 群組，請以滑鼠右鍵按一下 [ 應用程式]，指向 [ 匯入]，然後按一下 [MSI 檔案]。

    • 若要將 .msi 檔案中包含的成品匯入至現有的應用程式，請展開 [ 應用程式]，以滑鼠右鍵按一下應用程式，指向 [ 匯入]，然後按一下 [MSI 檔案]。

  3. 在 [歡迎使用匯入 MSI 精靈] 頁面上的 MSI 檔案中，輸入 .msi 檔案的路徑，然後按 [ 下一步]。 如有必要，您可以按一下 ... 按鈕來流覽 .msi 檔案。

  4. 在 [應用程式設定] 頁面上的 [ 應用程式名稱 ] 下拉式清單中，如果可用，請選取應用程式名稱。 當您將應用程式匯入 BizTalk 群組中，就會有此清單。

    注意

    清單中包含 BizTalk 群組中目前的所有應用程式名稱，以及匯出 .msi 檔案的應用程式名稱。 如果您選取後面的應用程式名稱，而 BizTalk 群組中還沒有該應用程式，則匯入精靈會建立新的應用程式。 如果您選取群組中已經有的應用程式，則匯入精靈會從 .msi 檔案將成品匯入到現有應用程式中。

  5. 在 [可用的應用程式] 中，選取要新增參考的應用程式，如果有的話，然後按 [ 下一步]。

  6. 如果您要將 .msi 檔案匯入現有的應用程式，並想要覆寫現有應用程式中的成品，請選取 [ 覆寫資源]。

    注意

    如果沒有選取此選項，而包含成品的 .msi 檔案已經在應用程式中，則匯入作業即失敗並會進行回復。 BizTalk 應用程式或群組中的某些類型成品必須是唯一的。 如果新增的成品已經在 BizTalk 群組中，卻不在目前應用程式中，即使您指定了覆寫選項，匯入作業將會失敗。 如需哪些成品必須是唯一的，以及它們必須是唯一方式的詳細資訊，請參閱 應用程式或群組中必須是唯一的成品。

  7. 在 [應用程式目標環境設定] 頁面上的 [ 目標預備環境 ] 下拉式清單中，選取此應用程式的目標環境，然後按 [ 下一步]。 此清單包含針對新增至此應用程式的任何繫結檔案所指定的所有環境。 如果您想要在應用程式中套用所有系結，但已指定目標環境以外的系結，請選取 < [預設值 > ]。 如果 .msi 檔案不包含您想要明確套用的系結檔案，您可以保留 < [預設 > ] 選取。

    注意

    當您將繫結檔案新增至應用程式時，可以指定繫結的目標環境。 如需背景資訊，請參閱 系結檔案和應用程式部署。 如需新增系結檔案的指示，請參閱 如何將系結檔案新增至應用程式。

  8. 在 [匯入摘要] 頁面上，確認摘要資訊正確無誤，然後按一下 [ 匯入]。

  9. 如果您想要在本機電腦上安裝應用程式，請在 [匯入成功] 頁面上，選取 [ 執行應用程式安裝精靈] 以在本機電腦上安裝應用程式 核取方塊。

    注意

    因為目前已在本機電腦上設定這個選項，所以只有在您要執行應用程式時才會需要進行安裝。 但是，如果應用程式包含檔案架構成品，您必須在將會執行應用程式的所有電腦上安裝應用程式，它才能開始運作，因為匯入應用程式只是將其新增至 BizTalk 管理資料庫中。

  10. 按一下 [完成] 。

注意

如果安裝失敗 (例如您沒有本機檔案系統的寫入權限而失敗)，就會回復安裝作業，而非匯入作業。

使用命令列匯入 BizTalk 應用程式

  1. 開啟命令提示字元，如下所示：按一下 [ 開始]，按一下 [ 執行]，輸入 cmd ，然後按一下 [ 確定]。

  2. 輸入下列命令，並以適當的值替代，如下表所述：

    BTSTask ImportApp /Package：value [/Environment：value] [/ApplicationName：value] [/Overwrite] [/Server：value] [/Database：value]

    範例：

    BTSTask ImportApp /Package：「C：\MSI Files\MyApplication.msi」 /Environment：Test /ApplicationName：MyApplication /Overwrite

    參數 值
    /包 .msi 檔案的完整路徑。 如果路徑包含空格，您必須將它括在引號 (") 中。
    /環境 所套用之繫結檔案的目標部署環境，例如 Test。 此值係針對已加入應用程式中的繫結檔案指定其目標部署環境。
    /ApplicationName 要從 .msi 檔案匯入成品的 BizTalk 應用程式的名稱。 如果沒有指定，將會使用匯入 .msi 檔案時指定的應用程式名稱。 如果指定的應用程式不存在，則會建立該應用程式。 包含空格的應用程式名稱必須以雙引號 (") 圍住。
    /覆蓋 此選項指定以 .msi 檔案中，本機唯一識別碼 (LUID) 相同的成品覆寫應用程式中的成品。 若未指定此選項，且應用程式中有一或多個成品與 .msi 檔案中的成品具有相同的 LUID，匯入就會失敗。 您可以使用 ListApp 命令來檢視應用程式中成品的 LUID。
    /伺服器 裝載 BizTalk 管理資料庫之 SQL Server 執行個體的名稱，其格式為：伺服器名稱\執行個體名稱,連接埠。

    只有在執行個體名稱和伺服器名稱不同時，才需要執行個體名稱。 只有在 SQL Server 使用預設值 (1433) 以外的連接埠編號時，才需要連接埠。

    範例：

    Server=MyServer

    Server=MyServer\MySQLServer,1533

    如果不提供，將會使用在本機電腦上執行的 SQL Server 執行個體的名稱。
    /資料庫 BizTalk 管理資料庫的名稱。 如果沒有指定，將會使用在 SQL Server 本機執行個體中執行的 BizTalk 管理資料庫。

另請參閱

匯入 BizTalk 應用程式、繫結和原則
ImportApp 命令