Come distribuire un assembly BizTalk da Visual Studio

  • Articolo

In questo argomento vengono fornite istruzioni sull'uso di Visual Studio Esplora soluzioni o del prompt dei comandi di Visual Studio per distribuire gli assembly BizTalk da Visual Studio in un'applicazione BizTalk. Sebbene sia possibile distribuire un singolo assembly dal livello del progetto (ad esempio facendo clic con il pulsante destro del mouse sul progetto e scegliendo Distribuisci) o contemporaneamente tutti gli assembly della soluzione dal livello della soluzione (ad esempio facendo clic con il pulsante destro del mouse sulla soluzione e scegliendo Distribuisci), è consigliabile distribuire contemporaneamente tutti gli assembly dal livello della soluzione.

Nelle versioni precedenti di BizTalk Server se si desidera distribuire più assembly in una soluzione e uno degli assembly ha dipendenze in uno degli altri assembly, è necessario distribuire singolarmente gli assembly in ordine inverso rispetto alle dipendenze. Ad esempio, se Assembly1 ha dipendenze in Assembly2, è necessario distribuire prima Assembly2, quindi Assembly1.

Questa procedura è tuttora valida quando si distribuiscono assembly dal livello del progetto. Con BizTalk Server, tuttavia, quando si distribuiscono assembly dal livello di soluzione anziché dal livello di progetto, BizTalk Server si occupa automaticamente di tutti i passaggi di distribuzione, inclusa la distribuzione di assembly nell'ordine corretto. Per semplificare la distribuzione, pertanto, se un altro assembly ha una dipendenza nell'assembly che si desidera ridistribuire, è necessario ridistribuire gli assembly a livello di soluzione.

Quando si seleziona l'opzione che consente di distribuire un progetto o una soluzione da Visual Studio, l'assembly o gli assembly vengono automaticamente creati e distribuiti nell'applicazione BizTalk specificata nel gruppo BizTalk locale. Se l'applicazione specificata non esiste nel gruppo, verrà creata durante il processo di distribuzione. Gli assembly e gli elementi in essi contenuti vengono registrati e i relativi dati vengono archiviati nel database di gestione (configurazione) BizTalk per il gruppo BizTalk. Se, inoltre, si specifica questa opzione nelle proprietà di distribuzione per il progetto, gli assembly vengono aggiunti alla Global Assembly Cache.

Per "elemento" si indica qualsiasi elemento incluso in un'applicazione BizTalk, incluse le risorse utilizzate in Visual Studio, ad esempio assembly, orchestrazioni e altri elementi creati o aggiunti dopo la distribuzione dell'applicazione, quali porte di trasmissione e ricezione, certificati e script. Dopo la distribuzione dell'assembly, è possibile visualizzare e gestire gli elementi nel nodo Applicazioni della console di amministrazione BizTalk Server. Ogni applicazione viene archiviata nella relativa cartella e nelle sottocartelle vengono visualizzati gli elementi dell'applicazione. Per altre informazioni, vedere Uso della console di amministrazione BizTalk Server. Per altre informazioni sulla creazione e la gestione di applicazioni, vedere Distribuzione e gestione di applicazioni BizTalk.

Prima di distribuire un assembly, è necessario eseguire le operazioni seguenti:

Importante

Evitare di eseguire le attività descritte in questo argomento in un computer di produzione. Durante il processo di sviluppo spesso è necessario ridistribuire gli assembly di Visual Studio. Per poter effettuare la ridistribuzione, è possibile che in Visual Studio venga eseguito l'annullamento della distribuzione, l'annullamento del binding, l'interruzione e la rimozione di elementi esistenti nelle stesse applicazioni o in applicazioni diverse. Benché necessario e appropriato in un ambiente di sviluppo, ciò può provocare conseguenze impreviste e indesiderate in un ambiente di produzione. Inoltre, per evitare tentativi di distribuzione di un assembly di Visual Studio in un computer di produzione, è consigliabile evitare di installare Visual Studio nei computer di questo tipo.

Nota

Il criterio di protezione runtime di .NET Framework impedisce, per impostazione predefinita, la distribuzione di assembly da una condivisione di rete. Se si tenta di distribuire un assembly da una condivisione di rete e di difficoltà, vedere l'amministratore della sicurezza di .NET Framework o consultare "Gestione criteri di sicurezza" nella raccolta combinata di Visual Studio.

Prerequisiti

Per eseguire le procedure descritte in questo argomento, è necessario accedere con un account membro del gruppo Amministratori BizTalk Server. Se, nelle proprietà di distribuzione , è stata abilitata l'opzione per installare un assembly nella global assembly cache (GAC), sono necessarie anche autorizzazioni di lettura/scrittura nella gaC. L'account Administrators del computer locale dispone di tale autorizzazione. Per informazioni più dettagliate sulle autorizzazioni, vedere Autorizzazioni necessarie per la distribuzione e la gestione di un'applicazione BizTalk.

Per distribuire uno o più assembly BizTalk

Tramite Esplora soluzioni di Visual Studio

  • In Visual Studio Esplora soluzioni fare clic con il pulsante destro del mouse su un progetto o una soluzione BizTalk e quindi scegliere Distribuisci.

    L'assembly del progetto o gli assembly della soluzione vengono distribuiti nell'applicazione BizTalk specificata. Lo stato del processo di compilazione e sviluppo viene visualizzato nell'angolo inferiore sinistro della pagina.

Tramite il prompt dei comandi di Visual Studio

  1. Avviare il prompt dei comandi di Visual Studio.

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

    devenv /deploySolnConfigNameSolutionName [/project ProjName] [/projectconfigProjConfigName]

    Esempio:

    devenv /deploy Release "C:\Documents and Settings\utente\Documenti\Visual Studio\Projects\MySolution\MySolution.sln" /project "MyBizTalkApp\MyBizTalkApp.csproj" projectconfig Release

    Parametro Valore
    /schierare Distribuisce una soluzione dopo una compilazione o ricompilazione.
    SolnConfigName Nome della configurazione della soluzione da utilizzare per generare la soluzione indicata in SolutionName.
    Solutionname Percorso completo e nome del file della soluzione.
    /projectProjName Percorso e nome del file di progetto nella soluzione. È possibile immettere un percorso relativo del file di progetto dalla cartella SolutionName, il nome visualizzato del progetto o il percorso completo e il nome del file di progetto.
    /projectconfigProjConfigName Nome della configurazione della build di un progetto da utilizzare per la compilazione del progetto.

    La prima volta che si distribuisce un assembly contenente un'orchestrazione, è possibile che venga visualizzato un messaggio di avviso nel quale si segnala che l'orchestrazione non è contenuta nel file di binding. Questo problema si verifica in quanto non viene automaticamente eseguito il binding all'host delle orchestrazioni durante la distribuzione. È necessario eseguire questa operazione manualmente.

Vedere anche

Distribuzione di assembly BizTalk da Visual Studio in un'applicazione BizTalk