Come aggiungere un assembly .NET a un'applicazione

In questo argomento viene descritto come utilizzare la console di amministrazione 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 le considerazioni seguenti:

  • Se si desidera sovrascrivere un assembly già esistente nell'applicazione, specificare l'opzione per la sovrascrittura. Questa opzione è necessaria solo quando entrambi gli assembly hanno lo stesso identificatore univoco locale (LUID). Se si omette e nell'applicazione esiste già un assembly con lo stesso identificatore univoco locale dell'assembly da aggiungere, l'operazione di aggiunta non riuscirà. È possibile visualizzare gli ID 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 installare l'assembly nella Global Assembly Cache:

    • Aggiungi alla cache di assembly globale all'aggiunta della risorsa (gacutil). Quando si seleziona questa opzione, l'assembly viene installato nella cache di assembly globale del computer locale quando viene aggiunto all'applicazione, a seguito dell'utilizzo della procedura descritta in questo argomento.

    • Aggiungi alla cache di assembly globale all'importazione del file MSI (gacutil). Quando si seleziona questa opzione, se l'applicazione viene esportata in un file con estensione msi e questo viene importato in un gruppo BizTalk, l'assembly verrà installato nella cache di assembly globale del computer locale durante il processo di importazione. Selezionare questa opzione quando l'applicazione contiene un criterio nonché un assembly da cui dipende il criterio. Questa operazione è necessaria poiché, quando si importa un'applicazione contenente un criterio, gli assembly da cui dipende il criterio devono essere presenti nella cache di assembly globale.

    • Aggiungi alla cache di assembly globale all'installazione del file MSI (gacutil). Quando si seleziona questa opzione, se l'applicazione viene esportata in un file con estensione msi e installata in un computer da questo file, l'assembly viene installato nella cache i assembly globale del computer locale durante il processo di installazione.

    • Rendi visibile ai componenti COM (regasm). Quando si seleziona questa opzione, se l'applicazione viene esportata in un file con estensione msi e installata in un computer da questo file, viene aggiunto un assembly COM gestito nel Registro di sistema di Windows durante il processo di installazione. Se si specifica questa opzione, è necessario specificare anche l'indirizzo del file nella destinazione.

    • Registra componenti elaborati (regsvcs). Quando si seleziona questa opzione, se l'applicazione viene esportata in un file con estensione msi e installata in un computer da questo file, viene aggiunto un assembly COM+ nel Registro di sistema di Windows durante il processo di installazione. Se si specifica questa opzione, è necessario specificare anche l'indirizzo del file nella destinazione.

Prerequisiti

Per eseguire le procedure descritte in questo argomento, è necessario accedere con un account membro del gruppo Amministratori BizTalk Server. 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 BizTalk Server

  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, espandere Applicazioni e quindi espandere l'applicazione in 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 deve essere copiato il file quando l'applicazione viene installata dal file .msi, incluso il nome del file. Se il percorso viene omesso, il file non verrà copiato nel file system locale durante l'installazione. Per copiare il file nella cartella di installazione dell'applicazione, è possibile utilizzare la variabile di ambiente %BTAD_InstallDir% nel percorso, che recupera il valore della cartella di installazione 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 su cui dipende l'assembly.

  9. Se un elemento su cui dipende questo assembly non è presente in questa applicazione e si vuole 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 cmd, quindi fare clic su OK.

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

    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 non si specifica il nome dell'applicazione, viene utilizzata l'applicazione predefinita BizTalk per il gruppo. Se il nome include spazi, è necessario racchiuderlo tra virgolette doppie (").
    /Digitare System.BizTalk:Assembly (questo valore non è distinzione tra maiuscole e minuscole).
    /Sovrascrivere Opzione per aggiornare un assembly esistente. Se si omette, 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 lingua e il token di chiave pubblica. È possibile visualizzare gli ID LUID per gli artefatti in un'applicazione usando il comando ListApp.
    /Fonte Percorso completo del file assembly, incluso il nome del file. Se il percorso include spazi, è necessario racchiuderlo tra virgolette doppie (").
    /Destinazione Percorso completo della destinazione in cui verrà copiato il file assembly durante l'installazione dell'applicazione dal file con estensione msi. Se omesso, il file assembly non verrà copiato nel file system locale durante l'installazione. Se il percorso include 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. che recupera 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 di .msi.
    - GacOnImport: installare l'assembly nella gaC quando l'applicazione .msi file 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 Destination.
    - 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 Destination.

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

    È 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

Gestione di assembly .NET, certificati e altre risorse
Comando AddResource: assembly .NET
Creazione e modifica di applicazioni BizTalk