Condividi tramite

Come aggiungere un assembly BizTalk a un'applicazione

  • Articolo

In questo argomento viene illustrata la modalità di utilizzo della console di amministrazione BizTalk Server o della riga di comando per aggiungere un assembly BizTalk a un'applicazione.

Quando si aggiunge un assembly BizTalk a un'applicazione, tenere presente le considerazioni seguenti:

  • Se si desidera aggiungere e sovrascrivere un assembly con lo stesso identificatore univoco locale (LUID) già esistente nell'applicazione, specificare l'opzione per la sovrascrittura. 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 avrà esito positivo. L'identificatore univoco locale include il nome file dell'assembly, la versione, la lingua e il token di chiave pubblica. È possibile visualizzare gli IDENTIFICATORi di entità utente per gli artefatti in un'applicazione usando il comando ListApp.

  • L'operazione di aggiunta avrà esito negativo se l'assembly da aggiungere presenta una dipendenza da un altro elemento non incluso nell'applicazione.

  • Quando si aggiunge un assembly BizTalk, è possibile specificare una o più opzioni tra quelle indicate di seguito 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.

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

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 BizTalk a un'applicazione

Uso della console di amministrazione BizTalk Server

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

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

  3. Espandere Applicazioni e 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 di .msi, incluso il nome del file. Se omesso, il file assembly non verrà 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 che segue:

    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 non si specifica il nome dell'applicazione, viene utilizzata l'applicazione BizTalk predefinita. Se il nome include spazi, è necessario racchiuderlo tra virgolette doppie (").
    /Digitare System.BizTalk:BizTalkAssembly
    /Sovrascrivere Opzione per aggiornare un assembly esistente. Se si omette, e nell'applicazione esiste già un assembly con lo stesso LUID dell'assembly da aggiungere, l'operazione AddResource avrà esito negativo. È possibile visualizzare gli IDENTIFICATORi di entità utente per gli artefatti in un'applicazione usando il comando ListApp. Se un'altra applicazione dipende dall'assembly che viene sovrascritto, l'operazione AddResource ha esito negativo, anche se si specifica questo parametro.
    /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 (").
    /Opzioni - GacOnAdd: specificare per installare l'assembly nella Global Assembly Cache (GAC) nel computer locale durante l'operazione AddResource.
    - GacOnInstall: specificare per installare l'assembly nella GAC quando l'applicazione viene installata dal file .msi.
    - GacOnImport: specificare per installare l'assembly nella GAC quando l'applicazione .msi file 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.

    È 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 degli assembly BizTalk
Comando AddResource: assembly BizTalk