Come configurare la forma Trasforma
Trasforma, forma
Le trasformazioni vengono usate solo quando si costruiscono messaggi, quindi la forma Trasforma viene sempre visualizzata all'interno di una forma Costrutto messaggio . È possibile eliminare la forma Costrutto messaggio nell'area di progettazione e quindi rilasciare la forma Trasforma all'interno di esso oppure è sufficiente eliminare la forma Trasforma nell'area di progettazione e l'orchestrazione Designer creerà la forma Costrutto messaggio per l'utente.
Nota
Qualsiasi messaggio di origine o destinazione in una trasformazione deve essere basato su uno schema.
Procedura
Per configurare una forma Trasforma
Nella finestra Proprietà fare clic sul pulsante Puntini di sospensione (...) per la proprietà Messaggi di input, Messaggi di output o Nome mappa .
Utilizzare la finestra di dialogo Trasforma configurazione per configurare la forma Trasforma .
Nota
Una forma Transform può esistere solo all'interno di una forma Costrutto messaggio . Se si trascina una forma Assegnazione messaggi in qualsiasi altro punto dell'area di progettazione, verrà creata una nuova forma Costrutto messaggio .
Considerazioni importanti sulle prestazioni
BizTalk Server ottimizza la possibilità di eseguire trasformazioni su messaggi di grandi dimensioni trasmettendo il documento in memoria, applicando la trasformazione anziché caricando l'intero documento in memoria contemporaneamente. Questa ottimizzazione consente il mapping o la trasformazione di documenti aventi dimensioni notevolmente maggiori rispetto a quando accade nelle versioni precedenti di BizTalk Server. Tuttavia, se un'orchestrazione accetta più input e/o output per le forme Trasforma, questa ottimizzazione non viene applicata.
In questo caso, infatti, la trasmissione come flusso del documento non viene eseguita e l'utilizzo di memoria aumenta in modo significativo. Una soluzione al problema può essere l'applicazione della trasformazione o delle trasformazioni in una pipeline di ricezione in modo che l'orchestrazione non accetti mai input od output multipli per una forma Trasforma.
Sezione delle opzioni Nuova Mappa e Mappa esistente
In questa sezione è possibile fare clic sul pulsante Nuova mappa o mappa esistente per selezionare una mappa da assegnare alla forma Trasforma .
Usare il campo Nome sotto il pulsante di opzione selezionato per specificare una mappa. Se è stata selezionata Nuova mappa, è possibile digitare una designazione per la mappa da assegnare. Quando si usa l'opzione Nuova mappa , è necessario specificare il nome completo della mappa nella casella di testo. La casella di testo visualizza un esempio di tale nome per impostazione predefinita, perché è precompilato con un nome identificatore univoco in base allo spazio dei nomi del progetto e Trasforma nome forma: <Spazio dei nomi> progetto.<Trasformare il nome> della forma_Map (ad esempio, MyProject.Transform3_Map).
Se è stata selezionata Mappa esistente, fare clic sulla freccia Giù nel campo Nome per selezionare il file mappa da usare. Nella casella di riepilogo visualizzata vengono elencate in ordine alfabetico tutte le mappe disponibili nel progetto. In questo elenco, se si fa clic sul testo <Seleziona dall'assembly> a cui si fa riferimento, viene visualizzata la finestra di dialogo Seleziona tipo artefatto . Per altre informazioni sulle selezioni disponibili, vedere Come usare la finestra di dialogo Seleziona tipo di artefatto.
Sezione dei controlli griglia Messaggi origine e Messaggi destinazione
Usare questa parte della finestra di dialogo Configurazione trasformazione per configurare la mappa selezionata nella sezione File mappa nuovo/esistente? Se è stata selezionata Nuova mappa in questa sezione, si crea tale mappa configurandola in questa sezione.
Se si seleziona Mappa esistente, è possibile usare questa sezione per eseguire una delle due operazioni seguenti:
Scelta di una mappa da riutilizzare nella trasformazione corrente senza apportare modifiche.
Scelta di una mappa esistente al fine di modificarla (riconfigurarla) e quindi utilizzare questa nuova configurazione della mappa nella trasformazione corrente.
Specificare i messaggi di origine e di destinazione usando i controlli griglia Messaggi di origine e Messaggi di destinazione . Questi controlli griglia possono essere utilizzati per modificare il file di mappa in vari modi. Se si elimina un messaggio (una riga in uno dei due controlli griglia), si aggiunge un messaggio o si seleziona un messaggio di un altro tipo, la struttura della mappa viene modificata. In questo caso, tutte le altre trasformazioni che utilizzano tale mappa devono essere adattate alla nuova struttura. Se si apportano modifiche di altro tipo, quali ad esempio la rimozione e la successiva sostituzione di un messaggio con un altro messaggio dello stesso tipo, la struttura della mappa non viene modificata.
I controlli della griglia Messaggi di origine e Messaggi di destinazione sono identici nell'aspetto e nel comportamento. Ogni controllo griglia include due colonne: Messaggio e Tipo. Per compilare i controlli griglia è possibile selezionare i messaggi nella colonna Messaggio. Si aggiungono dati solo nella colonna Message, perché la colonna Type è di sola lettura. Le celle nella colonna Messaggio hanno elenchi a discesa popolati con istanze di messaggio che si trovano nell'ambito dell'orchestrazione corrente.
È possibile selezionare una riga in un controllo griglia facendo clic sul pulsante freccia destra (>) sul lato sinistro del controllo griglia. Dopo aver selezionato una riga è possibile eliminarla premendo il tasto CANC. Se si elimina una riga (ovvero un messaggio), la struttura del file di mappa a cui tale riga apparteneva viene modificata. È possibile modificare soltanto i file di mappa locali rispetto al progetto.
Opzione "Quando si sceglie OK, avvia BizTalk Mapper"
Facendo clic su OK, avviare BizTalk Mapper apre automaticamente BizTalk Mapper quando si fa clic su OK per chiudere la finestra di dialogo Trasforma configurazione e salvare le modifiche. Tuttavia, se alcune informazioni obbligatorie risultano mancanti, non è consentito salvare le modifiche. In questo caso, completare il riempimento dei campi nella finestra di dialogo e quindi fare clic su OK.
Vedere anche
Informazioni sulle mappe
Costruzione di messaggi
Come utilizzare espressioni per trasformare messaggi in modo dinamico