Come importare un'applicazione BizTalk

In questo argomento viene illustrata la modalità di utilizzo della console di amministrazione BizTalk Server o della riga di comando per importare un'applicazione BizTalk in un gruppo BizTalk. Quando si importa un'applicazione BizTalk, gli elementi vengono registrati nel database di gestione BizTalk e i dati degli elementi vengono scritti nei database BizTalk appropriati. Per informazioni dettagliate, vedere Cosa accade quando gli artefatti vengono importati. L'importazione di un'applicazione non comporta la sua installazione. Per poter eseguire un'applicazione che contiene elementi basati su file, è necessario installarla.

Quando si utilizza la console di amministrazione BizTalk Server per importare un'applicazione, il percorso da cui viene avviata l'Importazione guidata MSI determina se è possibile o meno creare una nuova applicazione durante l'importazione degli elementi. Se si avvia l'Importazione guidata facendo clic con il pulsante destro del mouse sul gruppo BizTalk, è necessario specificare il nome dell'applicazione. Se nel gruppo BizTalk esiste già un'applicazione con il nome specificato dall'utente, gli elementi del file verranno importati in tale applicazione. In caso contrario, verrà creata una nuova applicazione con il nome specificato e gli elementi verranno importati in essa. Se si avvia l'Importazione guidata facendo clic con il pulsante destro del mouse su un'applicazione, non sarà possibile specificare un nome di applicazione e gli elementi verranno importati nell'applicazione corrente.

Quando si utilizza lo strumento della riga di comando BTSTask per importare un file con estensione msi, è facoltativo specificare il nome dell'applicazione. Se non si specifica un nome, gli elementi verranno importati nell'applicazione predefinita.

Dopo aver importato gli elementi, è possibile visualizzarli nella cartella appropriata sotto la cartella dell'applicazione nella console di amministrazione BizTalk Server. È anche possibile visualizzare un elenco di artefatti nell'applicazione usando BTSTask, come descritto in Comando ListApp.

Prerequisiti

Per importare un'applicazione BizTalk, è necessario accedere con un account membro del gruppo Amministratori BizTalk Server. Per installare un'applicazione BizTalk, è inoltre necessario disporre delle autorizzazioni di scrittura per il file system locale. Per informazioni più dettagliate sulle autorizzazioni, vedere Autorizzazioni necessarie per la distribuzione e la gestione di un'applicazione BizTalk.

Considerazioni sull'importazione delle applicazioni

Per l'importazione di un'applicazione valgono le considerazioni riportate di seguito:

• Importazione di applicazioni da versioni precedenti di BizTalk Server. Se si importano applicazioni da BizTalk Server 2006 R2 o BizTalk Server 2009 e le applicazioni contengono dati EDI/AS2, l'importazione dell'applicazione potrebbe non riuscire perché il modello di gestione dei partner commerciali è cambiato notevolmente in BizTalk Server. È invece necessario utilizzare lo Strumento migrazione entità per migrare i dati delle entità da versioni precedenti di BizTalk Server. Per altre informazioni sullo strumento, vedere Utilità di migrazione EDI.

• I binding esistenti vengono sempre sovrascritti dai binding importati. Quando in un'applicazione esistente si importa un file con estensione msi contenente binding, i binding esistenti vengono sovrascritti da quelli importati che hanno lo stesso nome. Questo accade anche se non è stata selezionata l'opzione per la sovrascrittura degli elementi esistenti durante l'importazione del file con estensione msi. Se si desidera che i binding contenuti nell'applicazione in cui si sta importando il file con estensione msi non vengano sovrascritti dai binding contenuti nell'applicazione che si sta esportando, evitare di selezionare il file di associazione come risorsa da esportare durante l'operazione di esportazione. Per altre informazioni, vedere Come esportare un'applicazione BizTalk.

  Durante il processo di importazione, i binding che sono già stati applicati vengono sovrascritti da quelli nuovi con lo stesso nome. In altre parole, ha effetto l'ultimo binding con un determinato nome che è stato applicato. Quando si importa un'applicazione, i binding vengono applicati nell'ordine seguente:

  1. Binding di applicazione generati da BizTalk Server che non sono stati aggiunti esplicitamente all'applicazione mediante un file di associazione, ma che sono stati selezionati esplicitamente dall'utente per l'esportazione nel file con estensione msi dell'applicazione.

  2. File di associazione che sono stati aggiunti esplicitamente e per cui non è stato specificato un ambiente di distribuzione di destinazione. I binding di questo gruppo vengono applicati senza un ordine specifico.

  3. I binding che sono stati aggiunti esplicitamente e ai quali è associato un ambiente di distribuzione di destinazione corrispondente all'ambiente di distribuzione selezionato per l'importazione dell'applicazione. I binding di questo gruppo vengono applicati senza un ordine specifico.

• L'host deve esistere nel gruppo. Affinché l'operazione abbia esito positivo, nel gruppo BizTalk deve esistere un host corrispondente all'host specificato nei binding dell'applicazione contenuti nel file con estensione msi. Inoltre, i livelli di attendibilità degli host devono corrispondere.

• Può essere necessario aggiungere un riferimento a un'altra applicazione. Se l'applicazione da importare dipende da un elemento incluso in un'altra applicazione, è necessario aggiungere un riferimento a tale applicazione. L'applicazione e l'elemento devono esistere già nel gruppo. Questa opzione è disponibile nell'Importazione guidata. Se si usa il comando ImportApp di BTSTask, è tuttavia necessario aggiungere il riferimento all'applicazione dopo l'importazione, come descritto in Come aggiungere un riferimento a un'altra applicazione. Per informazioni in background, vedere Dipendenze e distribuzione di applicazioni. Durante l'importazione vengono fatti corrispondere i riferimenti alle applicazioni esistenti nel gruppo e viene offerta l'opportunità di aggiungere un nuovo riferimento o di modificarne uno esistente. Spetta all'utente, tuttavia, verificare che l'applicazione a cui viene fatto riferimento contenga l'elemento necessario.

• Se si verifica il timeout durante l'operazione di importazione, suddividere l'applicazione in più file con estensione msi. Se un'operazione di importazione dura più di 3600 secondi, si verifica il timeout. Se si tenta di importare un file con estensione msi e si verifica il timeout, suddividere il contenuto dell'applicazione in più file con estensione msi esportando di nuovo l'applicazione e selezionando un sottoinsieme di elementi da esportare. Per altre informazioni, vedere Come esportare un'applicazione BizTalk.

Importante

Per motivi di sicurezza, durante l'esportazione dell'applicazione le password vengono rimosse dai binding dell'applicazione. Tuttavia, non vengono rimosse da eventuali file di associazione aggiunti all'applicazione. Dopo aver importato l'applicazione, sarà necessario riconfigurare le password per garantire il funzionamento dell'applicazione. A tale scopo, modificare il file di associazione o utilizzare la Console di amministrazione. Per altre informazioni sulla modifica di un file di associazione, vedere Personalizzazione dei file di associazione. Per altre informazioni sulla configurazione della sicurezza per le schede, vedere Uso di adapter.

Nota

Se un'importazione non riesce, viene eseguito il rollback di tutte le operazioni di importazione, ma non delle azioni eventualmente eseguite da script personalizzati.

Nota

Se si crea un filtro per una porta di trasmissione in un'applicazione che utilizza uno schema di proprietà in un'altra applicazione e si importa la prima applicazione in un nuovo gruppo BizTalk, non verrà inviato alcun messaggio di avviso che informa che lo schema risulta mancante e il filtro non funzionerà dopo l'installazione e l'avvio dell'applicazione. È possibile correggere il problema importando l'applicazione che contiene lo schema prima di installare l'applicazione che non lo contiene.

Importare un'app BizTalk usando BizTalk Server Amministrazione

1. Fare clic su Start, fare clic su Tutti i programmi, fare clic su Microsoft BizTalk Server 20xx e quindi fare clic su BizTalk Server Amministrazione.

2. Nell'albero della console espandere BizTalk Server Amministrazione, espandere il gruppo BizTalk ed eseguire una delle operazioni seguenti:

   • Per importare l'applicazione e gli artefatti contenuti nel file .msi nel gruppo BizTalk, fare clic con il pulsante destro del mouse su Applicazioni, scegliere Importa e quindi fare clic su File MSI.

   • Per importare gli artefatti contenuti nel file .msi in un'applicazione esistente, espandere Applicazioni, fare clic con il pulsante destro del mouse sull'applicazione, scegliere Importa e quindi fare clic su File MSI.

3. Nella pagina Importa guidata MSI digitare il percorso del file .msi e quindi fare clic su Avanti. Se necessario, è possibile cercare il file .msi facendo clic sul pulsante ... .

4. Nell'elenco a discesa Nome applicazione della pagina Impostazioni applicazione selezionare il nome dell'applicazione, se disponibile. L'elenco è disponibile se si importa l'applicazione nel gruppo BizTalk.

   Nota

   L'elenco contiene i nomi di tutte le applicazioni presenti nel gruppo BizTalk nonché l'applicazione da cui è stato esportato il file con estensione msi. Se si seleziona il nome dell'applicazione e l'applicazione non esiste già nel gruppo BizTalk, verrà creata automaticamente una nuova applicazione. Se si seleziona un'applicazione che esiste già, gli elementi inclusi nel file con estensione msi vengono importati automaticamente nell'applicazione esistente.

5. In Applicazioni disponibili per aggiungere riferimenti a selezionare le applicazioni a cui aggiungere riferimenti, se presenti e quindi fare clic su Avanti.

6. Se si importa il file di .msi in un'applicazione esistente e si desidera sovrascrivere gli artefatti nell'applicazione esistente, selezionare Sovrascrivere le risorse.

   Nota

   Se non si seleziona questa opzione e il file con estensione msi contiene un elemento che esiste già nell'applicazione, l'operazione di importazione avrà esito negativo e verrà eseguito il rollback. Alcuni tipi di elementi in un'applicazione o un gruppo BizTalk devono essere univoci. Se si aggiunge un elemento che esiste già nel gruppo BizTalk, ma non nell'applicazione corrente, l'operazione di importazione avrà esito negativo, anche se si specifica l'opzione per la sovrascrittura. Per altre informazioni su quali artefatti devono essere univoci e in quali modi devono essere univoci, vedere Artefatti che devono essere univoci in un'applicazione o in un gruppo.

7. Nell'elenco a discesa Ambiente di destinazione applicazione selezionare l'ambiente di destinazione per questa applicazione e fare clic su Avanti. L'elenco contiene tutti gli ambienti che sono stati specificati per gli eventuali file di associazione aggiunti all'applicazione. Selezionare <Impostazione predefinita> se si desidera applicare tutte le associazioni nell'applicazione, ad eccezione di quelle con un ambiente di destinazione specificato. Se il file .msi non contiene un file di associazione che si vuole applicare in modo esplicito, è possibile lasciare <selezionata impostazione predefinita> .

   Nota

   L'ambiente di destinazione per i binding viene specificato quando si aggiunge un file di associazione a un'applicazione. Per informazioni in background, vedere Associazione di file e distribuzione di applicazioni. Per istruzioni sull'aggiunta di file di associazione, vedere Come aggiungere un file di associazione a un'applicazione.

8. Nella pagina Importa riepilogo verificare che le informazioni di riepilogo siano corrette e quindi fare clic su Importa.

9. Nella pagina Importa riuscito, se si vuole installare l'applicazione nel computer locale, selezionare la casella di controllo Esegui installazione guidata applicazione per installare l'applicazione nel computer locale .

   Nota

   È necessario installare l'applicazione solo se è necessario eseguirla così come è configurata nel computer locale. Se l'applicazione include elementi basati su file, tuttavia, affinché funzioni è necessario installarla su tutti i computer in cui verrà eseguita, poiché con l'importazione l'applicazione viene solo aggiunta al database di gestione BizTalk.

10. Fare clic su Fine.

Nota

Se l'installazione non riesce, ad esempio perché non si dispone delle autorizzazioni di scrittura nel file system locale, viene eseguito il rollback dell'installazione, ma non dell'operazione di importazione.

Importare un'app BizTalk usando la riga di comando

1. Aprire un prompt dei comandi come indicato di seguito: fare clic su Start, fare clic su Esegui, digitare cmd, quindi fare clic su OK.

2. Digitare il comando seguente, sostituendo i valori appropriati, come descritto nella tabella che segue:

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

   Esempio:

   BTSTask ImportApp /Package:"C:\MSI Files\MyApplication.msi" /Environment:Test /ApplicationName:MyApplication /Overwrite

   Parametro	Valore
   /Pacchetto	Percorso completo del file con estensione msi. Se il percorso include spazi, è necessario racchiuderlo tra virgolette doppie (").
   /Ambiente	L'ambiente di distribuzione di destinazione del file di binding da applicare, ad esempio Test. È il valore che è stato specificato per l'ambiente di distribuzione di destinazione quando il file di binding è stato aggiunto all'applicazione.
   /Applicationname	Nome dell'applicazione BizTalk in cui vengono importati gli elementi del file con estensione msi. Se non si specifica il nome dell'applicazione, viene utilizzato il nome specificato per l'esportazione del file con estensione msi. Se l'applicazione specificata non esiste, verrà creata. I nomi di applicazione che contengono spazi devono essere racchiusi tra virgolette doppie (").
   /Sovrascrivere	Consente di sovrascrivere gli elementi dell'applicazione con gli elementi del file con estensione msi che presentano lo stesso identificatore univoco locale. Se questo parametro viene omesso e se vi sono uno o più elementi dell'applicazione che presentano lo stesso identificatore univoco locale di elementi del file con estensione msi, l'importazione ha esito negativo. È possibile visualizzare gli ID DEGLI elementi in un'applicazione usando il comando ListApp.
   /Server	Nome dell'istanza di SQL Server che ospita il database di gestione BizTalk, nel formato NomeServer\NomeIstanza,Porta. È necessario specificare il nome dell'istanza solo se è diverso dal nome del server. È necessario specificare la porta solo se SQL Server utilizza un numero di porta diverso da quello predefinito (1433). Esempi: Server=MyServer Server=MyServer\MySQLServer,1533 Se non si specifica il nome dell'istanza, viene utilizzato il nome dell'istanza di SQL Server in esecuzione nel computer locale.
   /Database	Nome del database di gestione BizTalk. Se omesso, verrà utilizzato il nome del database di gestione BizTalk in esecuzione nell'istanza locale di SQL Server.

Vedere anche

Importazione di criteri, binding e applicazioni BizTalk
Comando ImportApp