Aggiungere un file di associazione a un'applicazione

Informazioni generali

Usare la console di amministrazione di 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 di applicazioni o assembly, come descritto in Associazione di file e distribuzione di applicazioni.

È possibile esportare le associazioni in un file .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 descritte 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 di BizTalk Server, nella cartella Risorse dell'applicazione. A differenza dell'importazione di un file di vincoli, l'aggiunta di un file di vincoli non applica immediatamente i suoi vincoli. Al contrario, le associazioni vengono applicate quando l'applicazione viene importata in un altro gruppo BizTalk.

Importante

Per motivi di sicurezza, quando si esportano associazioni, BizTalk Server rimuove le password per le associazioni dal file. Dopo aver importato le associazioni, è necessario riconfigurare le password per le porte di trasmissione e le posizioni di ricezione prima che funzionino. Configuri le password nella finestra di dialogo Proprietà trasporto della console di amministrazione di BizTalk Server per la porta di trasmissione o il percorso di ricezione. Vedere Creare una porta di trasmissione o creare un percorso di ricezione.

Annotazioni

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 rappresenta l'ambiente, ad esempio Test o Production. È possibile usare qualsiasi stringa per questo valore. Quindi, quando si importa l'applicazione, è possibile selezionare il file di associazione da applicare specificando il valore specificato per l'ambiente di destinazione. Quando si esegue questa operazione, i collegamenti vengono applicati dal file di collegamento. Tutte le associazioni esistenti nell'applicazione con lo stesso nome delle associazioni nel file vengono sovrascritte automaticamente.

Quando si importa un'applicazione, le associazioni vengono applicate nell'ordine seguente. Quando le associazioni vengono applicate durante il processo di importazione, quelle già applicate vengono sovrascritte da nuove associazioni con lo stesso nome. In altre parole, l'ultima associazione di un nome specifico da applicare diventa effettiva.

1. Associazioni di applicazioni generate da BizTalk Server che non sono state aggiunte in modo esplicito all'applicazione tramite un file di associazione, ma selezionate in modo esplicito dall'utente per l'esportazione nel file .msi dell'applicazione.

2. I file di associazione aggiunti in modo esplicito e non hanno un ambiente di distribuzione di destinazione specificato. I legami in questo set vengono applicati senza alcun ordine specifico.

3. Associazioni aggiunte in modo esplicito e con un ambiente di distribuzione di destinazione associato che corrisponde all'ambiente di distribuzione selezionato per l'importazione dell'applicazione. Le associazioni in questo set vengono applicate senza un ordine specifico.

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

Prerequisiti

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

Aggiungere un file di associazione tramite Amministrazione BizTalk

1. Aprire Amministrazione di BizTalk Server nel menu Start.

2. Espandere Amministrazione BizTalk Server, 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 file, selezionare la casella di controllo Sovrascrivi tutto . Se esiste un altro file con lo stesso nome e non si seleziona questa casella di controllo, l'operazione di aggiunta avrà esito negativo.

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 si lascia vuoto questo campo, le associazioni in questo file verranno sempre applicate all'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 seguente:

   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 il nome dell'applicazione non viene specificato, viene usata l'applicazione BizTalk predefinita. Se il nome include spazi, è necessario racchiuderlo tra virgolette doppie (").
   /Tipo	System.BizTalk:BizTalkBinding (questo valore non fa distinzione tra maiuscole e minuscole).
   /Sovrascrivere	Opzione per aggiornare un file di associazione esistente. Se non specificato, e il file di associazione esiste già nell'applicazione con lo stesso nome file del file da aggiungere, l'operazione AddResource ha 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 usare qualsiasi stringa, ad esempio Production. Esempio: /Property:TargetEnvironment="Production" Se non specificato, viene applicato automaticamente un valore default<>. Il valore è sensibile alle maiuscole. 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. 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: Binding BizTalk
Creazione e modifica di applicazioni BizTalk