Condividi tramite


Come aggiungere un componente COM a un'applicazione

In questo argomento viene illustrata la modalità di utilizzo della Console di amministrazione BizTalk Server o della riga di comando per aggiungere un componente COM a un’applicazione BizTalk.

Quando si aggiunge un componente COM a un’applicazione, tenere presente le considerazioni seguenti:

  • Se si desidera sovrascrivere un componente COM già esistente nell'applicazione, specificare l’opzione per la sovrascrittura. Questa opzione è necessaria solo quando entrambi gli elementi hanno lo stesso identificatore univoco locale (LUID). Se si omette e nell'applicazione esiste già un componente COM con lo stesso identificatore univoco locale del componente COM da aggiungere, l’operazione di aggiunta non verrà completata. È possibile visualizzare gli IDENTIFICATORi di entità utente per gli artefatti in un'applicazione usando il comando ListApp.

  • In BizTalk Server non vengono controllate le dipendenze dei componenti COM per verificare se sono presenti o meno, pertanto è necessario controllare che siano presenti tutti gli 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 contenente il componente COM o COM+ in un computer a 32 bit, il componente non verrà installato. Verrà installato solo nei computer a 64 bit.

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

Uso della console di amministrazione BizTalk Server

  1. Fare clic su Start, su Programmi, su Microsoft BizTalk Server 20xx e quindi su amministrazione BizTalk Server.

  2. Nell'albero della console espandere BizTalk Server Amministrazione, 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) in base al fatto che il componente venga aggiunto al Registro di sistema di Windows quando l'applicazione è installata.

  7. In Destinazione digitare il percorso completo del percorso in cui copiare il componente COM 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. 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 che segue:

    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 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:Com (questo valore non fa distinzione tra maiuscole e minuscole).
    /Sovrascrivere Opzione per aggiornare un componente COM esistente. Se si omette e nell'applicazione esiste già un componente COM con lo stesso identificatore univoco locale del componente COM da aggiungere, l'operazione AddResource non verrà completata. È possibile visualizzare gli IDENTIFICATORi di entità utente per gli artefatti in un'applicazione usando il comando ListApp.
    /Fonte Percorso completo del file DLL del componente COM, 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 DLL del componente COM durante l'installazione dell'applicazione dal file con estensione msi. Se omesso, il file non verrà copiato nel file system locale durante l'installazione e il componente non verrà 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. Consente di aggiungere il componente COM al Registro di sistema di Windows quando l'applicazione viene installata dal file con estensione msi. Se si specifica questa opzione, è necessario specificare anche Destination.
    /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: componente COM
Creazione e modifica di applicazioni BizTalk