Aggiungere un file di associazione a un'applicazione

  • Articolo

Panoramica

Usare la console di amministrazione BizTalk Server o la riga di comando per aggiungere un file di associazione a un'applicazione BizTalk. È possibile eseguire questa operazione per semplificare la distribuzione dell'applicazione o dell'assembly, come descritto in File di associazione e distribuzione di applicazioni.

È possibile esportare associazioni in un file di .xml da un'applicazione BizTalk per un assembly, un'applicazione o un gruppo, come descritto in Esportazione di associazioni e quindi usare una delle procedure in questo argomento per aggiungere il file di associazione a un'applicazione.

Quando si esegue questa operazione, il file di associazione viene aggiunto al database di gestione BizTalk e viene visualizzato nella Console di amministrazione BizTalk Server. Diversamente da quanto avviene nel caso dell'importazione, l'aggiunta di un file di associazione non comporta l'applicazione immediata dei binding esistenti. I binding vengono applicati quando l'applicazione viene importata in un altro gruppo BizTalk.

Importante

Per ragioni di sicurezza, quando si esportano binding, le password per i binding vengono rimosse dal file. Dopo avere importato i binding, sarà necessario riconfigurare le password per le porte di trasmissione e gli indirizzi di ricezione per consentirne il funzionamento. Per configurare le password per la porta di trasmissione o l'indirizzo di ricezione, utilizzare la finestra di dialogo Proprietà del trasporto della Console di amministrazione BizTalk Server. Vedere Creare una porta di trasmissione o creare un percorso di ricezione.

Nota

Quando si usa un file di associazione, è necessario verificare che gli artefatti siano stati associati all'host corretto e che il livello di attendibilità sia appropriato.

Quando si aggiunge un file di associazione a un'applicazione, è possibile specificare un valore per l'ambiente di distribuzione di destinazione con una stringa che rappresenti l'ambiente, ad esempio Test o Produzione. È possibile utilizzare qualsiasi stringa per questo valore. Quando si importa un'applicazione, è possibile selezionare quale file di associazione applicare fornendo il valore specificato per l'ambiente di destinazione. Quando si esegue questa operazione, i binding vengono applicati dal file di associazione. Qualsiasi binding esistente nell'applicazione che ha lo stesso nome dei binding nel file viene sovrascritto automaticamente.

Quando si importa un'applicazione, i binding vengono applicati nel seguente ordine. Durante il processo di importazione, i binding che sono già stati applicati vengono sovrascritti da quelli nuovi con lo stesso nome. In altre parole, ha effetto l'ultimo binding con un determinato nome che è stato applicato.

  1. Binding di applicazione generati da BizTalk Server che non sono stati aggiunti esplicitamente all'applicazione mediante un file di associazione, ma che sono stati selezionati esplicitamente dall'utente per l'esportazione nel file con estensione msi dell'applicazione.

  2. File di associazione che sono stati aggiunti esplicitamente e per cui non è stato specificato un ambiente di distribuzione di destinazione. I binding di questo gruppo vengono applicati senza un ordine specifico.

  3. I binding che sono stati aggiunti esplicitamente e ai quali è associato un ambiente di distribuzione di destinazione corrispondente all'ambiente di distribuzione selezionato per l'importazione dell'applicazione. I binding di questo gruppo vengono applicati senza un ordine specifico.

    Per altre informazioni sull'importazione di applicazioni e l'applicazione di associazioni, vedere Importare un'applicazione BizTalk.

Prerequisiti

Accedere con un account membro del gruppo Administrators di BizTalk Server. Le autorizzazioni necessarie per la distribuzione e la gestione di un'applicazione BizTalk forniscono altri dettagli.

Aggiungere un file di associazione con Amministrazione BizTalk

  1. Aprire BizTalk Server Amministrazione (nel menu Start).

  2. Espandere BizTalk Server Amministrazione, espandere il gruppo BizTalk, espandere Applicazioni e fare clic con il pulsante destro del mouse sull'applicazione a cui si vuole aggiungere un file di associazione.

  3. Scegliere Aggiungi e quindi fare clic su Risorse.

  4. Fare clic su Aggiungi, selezionare il file da aggiungere e quindi fare clic su Apri.

  5. Per sovrascrivere un file di associazione esistente in questa applicazione con lo stesso nome di file, selezionare la casella di controllo Sovrascrivi tutto . Se esiste un altro file con lo stesso nome e questa casella di controllo non viene selezionata, l'operazione di aggiunta non avrà esito positivo.

  6. Nell'elenco a discesa Tipo di file selezionare System.BizTalk:BizTalkBinding.

  7. In Ambiente di destinazione digitare una stringa per rappresentare l'ambiente di distribuzione di destinazione in cui si desidera applicare le associazioni in questo file, ad esempio Test e fare clic su OK.

    Importante

    Se questo campo viene lasciato vuoto, i binding del file verranno sempre applicati al momento dell'importazione dell'applicazione.

    Il file di associazione viene aggiunto e viene visualizzato nella cartella Risorse dell'applicazione.

Aggiungere un file di associazione usando la riga di comando

  1. Aprire un prompt dei comandi (menu >Start immettere cmd> selezionare Prompt dei comandi).

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

    BTSTask AddResource [/ApplicationName:"value"] /Type:System.BizTalk:BizTalkBinding [/Overwrite] /Source:value/Property:TargetEnvironment="value" [/Server:value] [/Database:value]

    Esempio:

    BTSTask AddResource /ApplicationName:"My Application" /Type:System.BizTalk:BizTalkBinding /Source:"C:\Binding Files\MyBinding.xml" /Property:TargetEnvironment="Production" /Server:MyDatabaseServer /Database:BizTalkMgmtDb

    Parametro Valore
    /Applicationname Nome dell'applicazione BizTalk a cui aggiungere il file di associazione. 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:BizTalkBinding (Questo valore non è distinzione tra maiuscole e minuscole).
    /Sovrascrivere Opzione per aggiornare un file di associazione esistente. Se omesso, e nell'applicazione esiste il file di associazione con lo stesso nome del file da aggiungere, l'operazione AddResource avrà esito negativo.
    /Fonte Percorso completo del file di associazione, incluso il nome del file. Se il percorso include spazi, è necessario racchiuderlo tra virgolette doppie (").
    /Property:TargetEnvironment= Stringa che specifica l'ambiente di distribuzione di destinazione. È possibile utilizzare qualsiasi stringa, ad esempio Produzione. Esempio: /Property:TargetEnvironment="Production"

    Se non specificato, viene applicato automaticamente un valore di <Default> . Per il valore viene fatta distinzione tra maiuscole e minuscole. Se il valore include spazi, è necessario racchiuderlo tra virgolette doppie ("). La lunghezza massima del valore dell'ambiente è di 128 caratteri.
    /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: associazione BizTalk
Creazione e modifica di applicazioni BizTalk