Come configurare la forma Orchestrazione chiamata
La forma Di orchestrazione chiamata può essere usata per chiamare in modo sincrono un'orchestrazione a cui si fa riferimento in un altro progetto. In questo modo è possibile riutilizzare i modelli comuni di flusso di lavoro dell'orchestrazione in vari progetti BizTalk. Quando si richiama un'altra orchestrazione annidata in modo sincrono con la forma di orchestrazione chiamata , l'orchestrazione racchiusa attende il completamento dell'orchestrazione annidata prima di continuare.
È possibile specificare i parametri che verranno passati all'orchestrazione annidata. I parametri possono essere messaggi, variabili, riferimenti alle porte, collegamenti ruolo o set correlazioni. Riferimenti alle porte passate, collegamenti al ruolo e set di correlazioni vengono eseguiti come buste auto-indirizzate: forniscono le informazioni di orchestrazione annidate che possono usare per inviare informazioni all'orchestrazione racchiusa.
Attenzione
Se si passano oggetti non serializzabili quali XmlDocument o XmlNode come parametri di un'orchestrazione, tale orchestrazione avrà esito negativo.
Per un esempio di come usare la forma di orchestrazione chiamata, vedere CallOrchestration (BizTalk Server Sample).
Per configurare una forma Orchestrazione chiamata
Usando la casella di riepilogo a discesa Selezione orchestrazione selezionare un'orchestrazione dall'elenco.
Usando il controllo griglia Parametri orchestrazione , specificare gli argomenti da passare all'orchestrazione, come specificato nella casella di riepilogo a discesa Orchestration Selection , denominata. È possibile specificare tali argomenti nelle celle della colonna Variabile, una variabile per cella, digitando il nome della variabile o selezionandone una nell'elenco a discesa di una cella.
Per configurare la forma Di orchestrazione chiamate in base al servizio e agli argomenti specificati nella finestra di dialogo, fare clic su OK. Per chiudere la finestra di dialogo Configurazione orchestrazione chiamata senza apportare modifiche alla forma di orchestrazione chiamata , fare clic su Annulla.
Attenzione
BizTalk Server non supporta orchestrazioni ricorsive. Se l'orchestrazione A chiama o avviare l'orchestrazione B, l'orchestrazione B non può chiamare o avviare direttamente l'orchestrazione A né può chiamare o avviare alcuna orchestrazione che chiami direttamente o indirettamente l'orchestrazione A.
Orchestrazioni di riferimento
Affinché l'orchestrazione di riferimento possa essere chiamata, verificare che le proprietà seguenti siano state configurate per l'orchestrazione chiamata:
Impostare la proprietà Type Modifier su Public per l'orchestrazione chiamata. Per impostare la proprietà Type Modifier per un'orchestrazione su Public, aprire l'orchestrazione in Microsoft Visual Studio, fare clic sulla forma iniziale verde nella parte superiore dell'orchestrazione per visualizzare la finestra di dialogo Proprietà orchestrazione e impostare la proprietà Type Modifier su Public.
Impostare la proprietà Activate della forma di ricezione iniziale nell'orchestrazione su False.
Elenco a discesa Orchestration Selection
Fare clic sulla freccia GIÙ nell'elenco a discesa per visualizzare i servizi disponibili e selezionarne uno. Nell'elenco sono contenuti tutti i servizi che possono essere chiamati dall'orchestrazione corrente, inclusi gli assembly di riferimento.
Controllo griglia Parametri di orchestrazione
Specificare gli argomenti da passare a un'orchestrazione con parametri usando il controllo griglia Parametri orchestrazione . La griglia include quattro colonne: variabili nell'ambito, nel nome del parametro, nel tipo di parametro e nella direzione del parametro. È possibile apportare modifiche solo alla prima colonna, poiché le altre solo di sola lettura.
Quando si seleziona un'orchestrazione valida, i relativi parametri compilano le colonne relative al nome, al tipo e alla direzione del parametro del controllo griglia. Successivamente si selezionano le variabili in ogni riga da passare come argomenti. Tali variabili possono essere selezionate da un elenco a discesa presente in ogni cella della colonna Variabili nell’ambito. Nell’elenco vengono visualizzate tutte le variabili disponibili del tipo specificato nella cella Tipo parametro adiacente. Se è disponibile solo un oggetto di tale tipo, la cella Variabili nell'ambito viene compilata automaticamente con tale oggetto. È inoltre possibile digitare direttamente in una cella Variabili nell'ambito per selezionare una variabile disponibile nell'elenco a discesa.
Nota
Poiché una forma di orchestrazione chiama un'orchestrazione , nella finestra di dialogo selezionata "Parametri di orchestrazione" in questa finestra di dialogo si fa effettivamente riferimento alle variabili di orchestrazione.
Se un'orchestrazione chiamata non dispone di parametri definiti, il controllo griglia in questa finestra di dialogo non è disponibile.