Come configurare la forma di orchestrazione delle chiamate

La forma Call Orchestration può essere utilizzata per chiamare in modo sincrono un'orchestrazione a cui viene fatto riferimento in un altro progetto. In questo modo è possibile riutilizzare i modelli comuni del flusso di lavoro di orchestrazione nei progetti BizTalk. Quando si richiama un'altra orchestrazione nidificata in modo sincrono con la forma Call Orchestration, l'orchestrazione contenitore 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 di ruolo o set di correlazioni. I riferimenti alle porte passate, i collegamenti di ruolo e i set di correlazione funzionano tutti come buste autodirizzate: forniscono le informazioni di orchestrazione annidate che può usare per inviare informazioni all'orchestrazione contenitrice.

Attenzione

Se si passano oggetti nonerializzabili, ad esempio XmlDocument o XmlNode come parametri a un'orchestrazione, l'operazione avrà esito negativo.

Per un esempio di come usare la forma di orchestrazione delle chiamate, vedere CallOrchestration (esempio di BizTalk Server).

Per configurare una forma di orchestrazione delle chiamate

1. Usando il menu a discesa Selezione orchestrazione, selezionare un'orchestrazione dall'elenco.

2. Usando il controllo griglia Parametri di orchestrazione, specificare gli argomenti da passare all'orchestrazione, come indicato nel menu a discesa Selezione orchestrazione chiamata. Questi argomenti vengono specificati nelle celle della colonna Variabile, una variabile per cella, digitando il nome di una variabile o facendo clic su una variabile da un elenco a discesa in una cella.

3. Per configurare la forma Call Orchestration in base al servizio e agli argomenti specificati nella finestra di dialogo, fare clic su OK. Per chiudere la finestra di dialogo Configurazione dell'orchestrazione delle chiamate senza apportare modifiche all'elemento Orchestrazione chiamata, fare clic su Annulla.

   Attenzione

   BizTalk Server non supporta orchestrazioni ricorsive. Se orchestrazione A chiama o avvia Orchestration B, Orchestration B non può chiamare o avviare direttamente Orchestration A, né può chiamare o avviare qualsiasi orchestrazione che chiama direttamente o indirettamente Orchestration A.

Orchestrazioni a cui si fa riferimento

Affinché l'orchestrazione a cui si fa riferimento sia chiamabile, 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.

Casella di riepilogo a discesa Selezione orchestrazione

Fare clic sulla freccia Giù nella casella di riepilogo a discesa per visualizzare i servizi disponibili e selezionarne uno. Questo elenco contiene tutti i servizi che possono essere chiamati dall'orchestrazione corrente, inclusi gli assembly a cui si fa riferimento.

Controllo della griglia dei parametri di orchestrazione

Specificare gli argomenti da passare a un'orchestrazione parametrica utilizzando il controllo griglia Parametri orchestrazione. La griglia ha quattro colonne: Variabili in Ambito, Nome Parametro, Tipo di Parametro e Direzione dei Parametri. È possibile apportare modifiche solo nella prima colonna; le altre colonne sono di sola lettura.

Quando si seleziona un'orchestrazione valida, i relativi parametri popolano il nome del parametro, il tipo e le colonne di direzione del controllo griglia. Selezionare quindi le variabili in ogni riga da passare come argomenti. È possibile selezionare queste variabili da un elenco a discesa presente in ogni cella della colonna Variabili nell'ambito. In questo elenco vengono visualizzate tutte le variabili disponibili del tipo specificato nella cella Tipo di parametro adiacente. Se è disponibile un solo oggetto di tale tipo, la cella Variables in Scope viene popolata automaticamente con tale oggetto. È anche possibile digitare una variabile nella cella Ambito per selezionare una variabile disponibile nell'elenco a discesa.

Annotazioni

Poiché una forma di Call Orchestration chiama un'orchestrazione, i "Parametri di orchestrazione" selezionati in questa finestra di dialogo fanno effettivamente riferimento alle variabili di orchestrazione.

Se un'orchestrazione che si sta chiamando non ha parametri definiti, il controllo griglia in questa finestra di dialogo non è disponibile.

Vedere anche

Come configurare la forma di orchestrazione di inizio