Come aggiungere un assembly BizTalk a un'applicazione

In questo argomento viene descritto come usare la console di amministrazione di BizTalk Server o la riga di comando per aggiungere un assembly BizTalk a un'applicazione.

Quando si aggiunge l'assembly BizTalk a un'applicazione, tenere presente quanto segue:

• Se si vuole aggiungere un assembly e sovrascrivere un assembly con lo stesso identificatore univoco locale (LUID) già esistente nell'applicazione, specificare l'opzione Sovrascrivi. Se non specificato e un assembly con lo stesso LUID dell'assembly da aggiungere esiste già nell'applicazione, l'operazione avrà esito negativo. LUID includono il nome del file di assembly, la versione, la cultura e il token di chiave pubblica. È possibile visualizzare gli identificatori LUID per gli artefatti in un'applicazione usando il comando ListApp.

• Se l'assembly che si aggiunge ha una dipendenza da un altro artefatto non incluso nell'applicazione, l'operazione di aggiunta avrà esito negativo.

• Quando si aggiunge un assembly BizTalk, è possibile specificare una o più delle opzioni seguenti per l'installazione dell'assembly nella Global Assembly Cache (GAC):

  • Aggiungere alla Global Assembly Cache al momento dell'aggiunta di una risorsa (gacutil). Quando si seleziona questa opzione, l'assembly viene installato nella GAC nel computer locale quando l'assembly viene aggiunto a un'applicazione, a seguito dell'utilizzo delle procedure descritte in questo argomento.

  • Aggiungere alla Global Assembly Cache nell'importazione di file MSI (gacutil). Quando si seleziona questa opzione, se l'applicazione viene esportata in un file .msi e il file .msi viene importato in un gruppo BizTalk, l'assembly viene installato nella GAC nel computer locale come parte del processo di importazione.

  • Aggiungere alla Global Assembly Cache nell'installazione del file MSI (gacutil). Quando si seleziona questa opzione, se l'applicazione viene esportata in un file .msi e l'applicazione viene installata in un computer dal file .msi, l'assembly viene installato nella GAC nel computer locale come parte del processo di installazione.

Prerequisiti

Per eseguire le procedure descritte in questo argomento, è necessario essere connessi con un account membro del gruppo BizTalk Server Administrators. Per informazioni più dettagliate sulle autorizzazioni, vedere Autorizzazioni necessarie per la distribuzione e la gestione di un'applicazione BizTalk.

Per aggiungere un assembly BizTalk a un'applicazione

Uso della console di amministrazione di BizTalk Server

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

2. Nell'albero della console, espandi l'Amministrazione BizTalk Server e il gruppo BizTalk contenente l'applicazione a cui si desidera aggiungere l'assembly BizTalk.

3. Apri Applicazioni e seleziona l'applicazione a cui si desidera aggiungere un assembly BizTalk.

4. Fare clic con il pulsante destro del mouse su Risorse, scegliere Aggiungi e quindi fare clic su Assembly BizTalk.

5. Fare clic su Aggiungi, selezionare il file di assembly BizTalk e quindi fare clic su Apri.

6. In Destinazione digitare il percorso completo del percorso in cui copiare il file di assembly quando l'applicazione viene installata dal file .msi, incluso il nome del file. Se non specificato, il file di assembly non viene copiato nel file system locale durante l'installazione.

7. In Opzioni specificare le opzioni per l'installazione dell'assembly BizTalk nella GAC e quindi fare clic su OK.

Uso della riga di comando

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

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

   BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:BizTalkAssembly [/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport] [/Server:value] [/Database:value]

   Esempio:

   BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:BizTalkAssembly /Overwrite /Source:"C:\BizTalk Assemblies\MyOrchestration.dll" /Destination:"C:\New BizTalk Assemblies\ MyOrchestration.dll " /Server:MyDatabaseServer /Database:BizTalkMgmtDb

   Parametro	Valore
   /ApplicationName	Nome dell'applicazione BizTalk a cui aggiungere l'assembly BizTalk. Se il nome dell'applicazione non viene specificato, viene usata l'applicazione BizTalk predefinita. Se il nome include spazi, è necessario racchiuderlo tra virgolette doppie (").
   /Tipo	System.BizTalk:BizTalkAssembly
   /Sovrascrivere	Opzione per aggiornare un assembly esistente. Se non specificato, e nell'applicazione esiste già un assembly con lo stesso LUID dell'assembly da aggiungere, l'operazione AddResource ha esito negativo. È possibile visualizzare gli identificatori LUID per gli artefatti in un'applicazione usando il comando ListApp. Se un'altra applicazione dipende dall'assembly da sovrascrivere, l'operazione AddResource ha esito negativo, anche quando questo parametro viene specificato.
   /Fonte	Percorso completo del file di assembly, incluso il nome del file. Se il percorso include spazi, è necessario racchiuderlo tra virgolette doppie (").
   /Destinazione	Percorso completo del percorso in cui deve essere copiato il file di assembly quando l'applicazione viene installata dal file .msi. Se non specificato, il file di assembly non viene copiato nel file system locale durante l'installazione. Se il percorso include spazi, è necessario racchiuderlo tra virgolette doppie (").
   /Opzioni	- GacOnAdd: specificare per installare l'assembly nella Global Assembly Cache (GAC) nel computer locale durante l'operazione AddResource. - GacOnInstall: bisogna specificare di installare l'assembly nella Global Assembly Cache quando l'applicazione viene installata dal file .msi. - GacOnImport: specificare di installare l'assembly nella GAC quando il file dell'applicazione .msi viene importato. È necessario separare più opzioni con una virgola.
   /Server	Nome dell'istanza di SQL Server che ospita il database di gestione BizTalk nel formato NomeServer\NomeIstanza,Porta. Il nome dell'istanza è obbligatorio solo quando il nome dell'istanza è diverso dal nome del server. La porta è necessaria solo quando SQL Server usa un numero di porta diverso da quello predefinito (1433). Esempi: Server=MyServer Server=MyServer\MySQLServer,1533 Se non specificato, viene usato il nome dell'istanza di SQL Server in esecuzione nel computer locale.
   /Banca dati	Nome del database di gestione BizTalk. Se non specificato, viene usato il database di gestione BizTalk in esecuzione nell'istanza locale di SQL Server.

Vedere anche

Gestione degli assembly BizTalk
Comando AddResource: Assembly di BizTalk