Come aggiungere un assembly .NET 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 .NET che non è un assembly BizTalk a un'applicazione BizTalk. Quando si aggiunge un assembly .NET a un'applicazione, tenere presente quanto segue:

• Se si desidera sovrascrivere un assembly già esistente nell'applicazione, specificare l'opzione Sovrascrittura. L'opzione di sovrascrittura è necessaria solo quando entrambi gli assembly hanno lo stesso LUID. Se non specificato, e un assembly esiste già nell'applicazione con lo stesso LUID dell'assembly aggiunto, l'operazione di aggiunta avrà esito negativo. È possibile visualizzare gli identificatori LUID per gli artefatti in un'applicazione usando il comando ListApp.

• Quando si aggiunge un assembly .NET, è 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. Selezionare questa opzione quando l'applicazione include un criterio e un assembly da cui dipende il criterio. È necessario eseguire questa operazione perché, quando si importa un'applicazione contenente un criterio, tutti gli assembly da cui dipende il criterio devono essere presenti nella GAC.

  • 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.

  • Rendere visibili i componenti COM (regasm). 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, un assembly COM gestito viene aggiunto al Registro di sistema di Windows nel computer locale come parte del processo di installazione. Se si specifica questa opzione, è necessario specificare anche un percorso per il file in Destinazione.

  • Registrare i componenti serviti (regsvcs). 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, un assembly COM+ gestito viene aggiunto al Registro di sistema di Windows nel computer locale come parte del processo di installazione. Se si specifica questa opzione, è necessario specificare anche un percorso per il file in Destinazione.

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 .NET 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 espandere Amministrazione BizTalk Server, espandere il gruppo BizTalk, espandere Applicazioni e quindi espandere l'applicazione a cui si vuole aggiungere l'assembly .NET.

3. Fare clic con il pulsante destro del mouse sulla cartella Risorse , scegliere Aggiungi e quindi fare clic su Risorse.

4. Fare clic su Aggiungi, fare clic sull'assembly e quindi su Apri.

5. Nell'elenco a discesa Tipo di file selezionare System.BizTalk:Assembly.

6. In Opzioni selezionare le opzioni di distribuzione per questo assembly.

7. In Destinazione digitare il percorso completo del percorso in cui copiare il file quando l'applicazione viene installata dal file .msi, incluso il nome del file. Se questo percorso non viene specificato, il file non viene copiato nel file system locale durante l'installazione. Per copiare il file nella cartella di installazione dell'applicazione, è possibile usare la variabile di ambiente %BTAD_InstallDir% nel percorso, che accetta il valore della cartella di installazione dell'applicazione quando l'applicazione viene installata. In questo modo, non è necessario conoscere il percorso della cartella di installazione dell'applicazione quando si specifica il percorso di destinazione.

   Esempio: %BTADInstall_Dir%\Assemblies\Orchestrations.dll

8. Fare clic sulla scheda Dipendenze e visualizzare gli artefatti da cui dipende questo assembly.

9. Se un elemento da cui dipende questo assembly non è presente in questa applicazione e si desidera aggiungerlo, fare clic su Aggiungi all'applicazione, passare all'artefatto e quindi fare clic su Apri.

10. Al termine, 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:Assembly [/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport|RegasmOnInstall|RegsvcsOnInstall] [/Server:value] [/Database:value]

   Esempio:

   BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:Assembly /Overwrite /Source:"C:\Source Assemblies\MyAssembly.dll" /Destination:"%BTAD_InstallDir%\New Assemblies\MyAssembly.dll" /Options:GacOnAdd,RegasmOnInstall /Server:MyDatabaseServer /Database:BizTalkMgmtDb

   Parametro	Valore
   /ApplicationName	Nome dell'applicazione BizTalk a cui aggiungere l'assembly. Se il nome dell'applicazione non viene specificato, viene usata l'applicazione BizTalk predefinita per il gruppo. Se il nome include spazi, è necessario racchiuderlo tra virgolette doppie (").
   /Tipo	System.BizTalk:Assembly (questo valore non fa distinzione tra maiuscole e minuscole).
   /Sovrascrivere	Opzione per aggiornare un assembly esistente. Se non specificato e nell'applicazione esiste già un assembly con lo stesso nome completo dell'assembly da aggiungere, l'operazione AddResource ha esito negativo. Il nome completo include 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.
   /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 contiene spazi, è necessario racchiuderlo tra virgolette doppie ("). Se si specifica l'opzione RegasmOnInstall o RegsvcsOnInstall, è necessario specificare anche Destination. Nota: È possibile usare la variabile di ambiente %BTAD_InstallDir% nel percorso. Accetta il valore della cartella di installazione dell'applicazione quando l'applicazione viene installata. In questo modo, non è necessario conoscere il percorso della cartella di installazione dell'applicazione quando si specifica il percorso di destinazione. Esempio: %BTAD_InstallDir%\Assemblies\Orchestrations.dll
   /Opzioni	- GacOnAdd: installare l'assembly nella Global Assembly Cache (GAC) nel computer locale durante l'operazione AddResource. - GacOnInstall: Installare l'assembly nella GAC quando l'applicazione viene installata dal file .msi. - GacOnImport: installare l'assembly nella Global Assembly Cache (GAC) quando il file dell'applicazione .msi viene importato. - RegasmOnInstall: aggiungere un assembly COM gestito al Registro di sistema di Windows quando l'applicazione viene installata dal file .msi. Se si specifica questa opzione, è necessario specificare anche Destinazione. - RegsvcsOnInstall:Aggiungere un assembly COM+ gestito al Registro di sistema di Windows quando l'applicazione viene installata dal file .msi. Se si specifica questa opzione, è necessario specificare anche Destinazione. È 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 di assembly, certificati e altre risorse .NET
Comando AddResource: .NET Assembly
Creazione e modifica di applicazioni BizTalk