Come aggiungere un componente COM a un'applicazione

Questo argomento descrive come usare la console di amministrazione di BizTalk Server o la riga di comando per aggiungere un componente COM a un'applicazione BizTalk:

Quando si aggiunge un componente COM a un'applicazione, tenere presente quanto segue:

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

• BizTalk Server non controlla le dipendenze per i componenti COM per verificare che siano presenti, pertanto è necessario verificare che siano presenti elementi da cui dipende il componente.

• Se si aggiunge un componente COM o COM+ non gestito a 64 bit e si tenta di installare l'applicazione che include il componente COM o COM+ in un computer a 32 bit, il componente non verrà installato. Verrà installato solo in un computer a 64 bit.

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

Uso della console di amministrazione di BizTalk Server

1. Fare clic su Start, su Programmi, su Microsoft BizTalk Server 20xx e quindi su Amministrazione di 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 un componente COM.

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, selezionare il componente COM e quindi fare clic su Apri.

5. Nell'elenco a discesa Tipo di file fare clic su System.BizTalk:Com.

6. In Opzioni, selezionare o deselezionare la casella di controllo Registra il file nella destinazione (regsvr32) per decidere se aggiungere il componente al Registro di sistema di Windows quando si installa l'applicazione.

7. In Destinazione digitare il percorso completo del percorso in cui deve essere copiato il componente COM 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. Questo percorso è obbligatorio se è stata selezionata la casella di controllo Registra il file nella destinazione (regsvr32) nel passaggio precedente.

   Esempio: %BTAD_InstallDir%\MyComponent.dll

8. 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:Com [/Overwrite] /Source:value [/Destination:value] [/Options:Regsvr32OnInstall] [/Server:value] [/Database:value]

   Esempio:

   BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:Com /Overwrite /Source:"C:\Source Components\COM.dll" /Destination:"C:\New Components\COM.dll" /Options:Regsvr32OnInstall /Server:MyDatabaseServer /Database:BizTalkMgmtDb

   Parametro	Valore
   /ApplicationName	Nome dell'applicazione BizTalk a cui aggiungere il componente COM. 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:Com (questo valore non fa distinzione tra maiuscole e minuscole).
   /Sovrascrivere	Opzione per aggiornare un componente COM esistente. Se non specificato e un componente COM esiste già nell'applicazione con lo stesso LUID del componente COM da aggiungere, l'operazione AddResource ha esito negativo. È possibile visualizzare gli identificatori LUID per gli artefatti in un'applicazione usando il comando ListApp.
   /Fonte	Percorso completo del componente COM del file .dll, incluso il nome del file. Se il percorso include spazi, è necessario racchiuderlo tra virgolette doppie (").
   /Destinazione	Percorso completo del percorso in cui il componente COM .dll file deve essere copiato quando l'applicazione viene installata dal file .msi. Se non specificato, il file non viene copiato nel file system locale durante l'installazione; pertanto, il componente non può essere aggiunto al Registro di sistema di Windows durante l'installazione. Se il percorso include spazi, è necessario racchiuderlo tra virgolette doppie ("). Se si specifica Regsvr32OnInstallOption, è necessario specificare anche Destination.
   /Opzioni	Regsvr32OnInstall. Specificare di aggiungere il componente COM al Registro di sistema di Windows quando l'applicazione viene installata dal file .msi. Se si specifica questa opzione, è necessario specificare anche Destinazione.
   /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: componente COM
Creazione e modifica di applicazioni BizTalk