Come aggiornare una mappa usando il versionamento affiancato

Alcuni artefatti BizTalk, ad esempio le mappe, vengono scelti da un nome forte completamente qualificato (FQSN), nel qual caso le associazioni includono la versione usata. In questo modo, due o più mappe possono coesistere affiancate nella console di amministrazione di BizTalk Server. Di conseguenza, è possibile selezionare una delle mappe per il mapping in ingresso nelle proprietà della posizione di ricezione o nel mapping in uscita nelle proprietà della porta di trasmissione.

Prerequisiti

Per eseguire le procedure descritte in questo argomento, è necessario essere connessi con un account membro del gruppo BizTalk Server Administrators.

Per aggiungere una seconda mappa affiancata a una mappa esistente

1. Aprire Visual Studio e quindi aprire il progetto contenente la mappa.

2. Apri la mappa nell'assemblaggio e effettua una modifica al codice relativa alla mappa.

   Annotazioni

   Quando si richiama una mappa da un'orchestrazione e il riferimento alla mappa è codificato staticamente, potrebbe essere necessario apportare modifiche al codice dell'orchestrazione stessa.

3. Modificare il numero di versione dell'assembly:

   1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto BizTalk e quindi scegliere Proprietà.

   2. In Progettazione progetti fare clic sulla scheda Applicazione .

   3. Nel riquadro destro, clicca su Informazioni sull'assembly.

   4. Nella finestra di dialogo Informazioni dell'assembly, specificare i valori per il campo Versione assembly per modificare il numero di versione dell'assembly. È consigliabile modificare solo il numero di versione principale o secondario. Il numero di versione principale è la prima cifra nella sequenza (n.0.0.0); il numero di versione secondaria è la seconda cifra nella sequenza (0.n.0.0).

   5. Fai clic su OK per chiudere la finestra di dialogo Informazioni sull'assembly.

4. Compilare l'assembly.

5. Distribuire l'assemblaggio al gruppo (e a tutti i computer).

Modifica di una mappa in modo da riflettere i numeri di versione aggiornati

Gli assembly .NET possono essere richiamati dall'interno di una mappa usando il functoid Scripting. Ciò offre una grande flessibilità e consente allo sviluppatore di risolvere molti problemi di mapping personalizzati diversi. Impone inoltre un vincolo univoco sulla mappa, che deve fare riferimento internamente non solo al nome del tipo di assembly, ma anche al numero di versione completo dell'assembly richiamato. Di conseguenza, se il numero di versione dell'assembly chiamato dalla mappa cambia, tutti i collegamenti che fanno riferimento all'assembly verranno interrotti.

Per evitare questo problema, è consigliabile che se gli assembly devono essere chiamati da una mappa, si crei un assembly specifico che contenga solo la funzionalità della mappa e che il numero di versione di questo assembly sia fisso. In questo modo, altre funzioni helper possono aggiornare la versione dell'assembly senza interrompere le mappe.

Se un assembly a cui viene fatto riferimento da una mappa viene modificato dopo lo sviluppo della mappa, è consigliabile aggiornare il file di mappa all'esterno dell'editor mappa per riflettere i numeri di versione aggiornati.

Per modificare un file di mapping in modo da riflettere i numeri di versione aggiornati

1. Usando il menu Start , aprire Blocco note.

2. In Blocco note, nel menu File, fare clic su Apri. Nella finestra di dialogo Apri selezionare il file di mappa da modificare e quindi fare clic su Apri.

3. Nel menu Modifica selezionare Trova. Nella finestra di dialogo Trova immettere Assembly=, quindi fare clic su Trova successivo.

4. Se è presente un riferimento di script a un assembly esterno, il Blocco note dovrebbe trovare un elemento XML simile al seguente:

   <Script Language="ExternalAssembly" Assembly="Contoso.Scripts, Version=2.0.0.0, Culture=neutral, PublicKeyToken=  
   <token>  
   " Class="Contoso.Scripts" Function="CalculateValue" AssemblyPath="Contoso.Scripts.dll"/>  
   

5. Aggiornare il numero di versione. Se sono presenti più istanze, usare Sostituisci dal menu Modifica .

6. Salva il file.

   Annotazioni

   È ora possibile aprire la mappa usando l'editor mappa.