Cómo configurar la forma Orquestación de llamada
La forma Orquestación de llamadas se puede usar para llamar de forma sincrónica a una orquestación a la que se hace referencia en otro proyecto. Esto permite volver a utilizar patrones de flujo de trabajo de orquestaciones comunes en los proyectos de BizTalk. Cuando se invoca otra orquestación anidada de forma sincrónica con la forma Orquestación de llamadas , la orquestación envolvente espera a que finalice la orquestación anidada antes de continuar.
Puede especificar parámetros que pasarán a la orquestación anidada. Los parámetros pueden ser mensajes, variables, referencias a puertos, vínculos de función o conjuntos de correlaciones. Las referencias de puerto pasadas, los vínculos de rol y los conjuntos de correlación funcionan como sobres autodirigidos: proporcionan la información de orquestación anidada que puede usar para devolver información a la orquestación envolvente.
Precaución
Si pasa objetos no serializables, como XmlDocument o XmlNode, como parámetros a una orquestación, se generará un error.
Para obtener un ejemplo de cómo usar la forma Orquestación de llamadas, vea CallOrchestration (BizTalk Server Sample).
Para configurar la forma Orquestación de llamada
Con el cuadro de lista desplegable Selección de orquestación , seleccione una orquestación de la lista.
Mediante el control de cuadrícula Parámetros de orquestación , especifique los argumentos que se van a pasar a la orquestación, tal y como se especifica en el cuadro de lista desplegable Selección de orquestación , al que se llama. Para especificar estos argumentos en las celdas de la columna Variable (una variable por celda) puede escribir el nombre de una variable o hacer clic en una variable de la lista desplegable de la celda.
Para configurar la forma Orquestación de llamadas según el servicio y los argumentos que especificó en el cuadro de diálogo, haga clic en Aceptar. Para cerrar el cuadro de diálogo Configuración de orquestación de llamadas sin realizar ningún cambio en la forma Orquestación de llamadas , haga clic en Cancelar.
Precaución
BizTalk Server no admite orquestaciones recursivas. Si Orquestación A llama a Orquestación B o la inicia, ésta no podrá llamar a Orquestación A o iniciarla directamente; tampoco podrá llamar a las orquestaciones que llamen directa o indirectamente a la Orquestación A, ni iniciarlas.
Orquestaciones a las que se hace referencia
Para que se pueda llamar a la orquestación a la que se hace referencia, asegúrese de que se han configurado las siguientes propiedades para la orquestación de llamada:
Establezca la propiedad Modificador de tipo en Public para la orquestación denominada. Para establecer la propiedad Modificador de tipo para una orquestación en Public, abra la orquestación en Microsoft Visual Studio, haga clic en la forma de inicio verde en la parte superior de la orquestación para mostrar el cuadro de diálogo Propiedades de orquestación y establezca la propiedad Modificador de tipo en Public.
Establezca la propiedad Activate de la forma de recepción inicial de la orquestación en False.
Cuadro de lista desplegable de selección de orquestación
Haga clic en la flecha hacia abajo que se encuentra en el cuadro de lista desplegable para ver los servicios disponibles y seleccionar uno. Esta lista contiene todos los servicios a los que se pueden llamar desde la orquestación actual, incluidos los ensamblados a los que se hace referencia.
Control de cuadrícula de Parámetros de orquestación
Los argumentos se especifican para pasar a una orquestación parametrizada mediante el control de cuadrícula Parámetros de orquestación . La cuadrícula tiene cuatro columnas: Variables en Ámbito, Nombre de parámetro, Tipo de parámetro y Dirección del parámetro. Sólo puede realizar cambios en la primera columna; el resto de columnas es de sólo lectura.
Al seleccionar una orquestación válida, sus parámetros rellenan el nombre del parámetro, el tipo y las columnas de dirección del control de cuadrícula. A continuación, seleccione las variables de cada fila para que pasen como argumentos. Estas variables se seleccionan de la lista desplegable que se encuentra en cada celda de la columna Variables en ámbito. Esta lista muestra todas las variables disponibles del tipo especificado en la celda Tipo de parámetro adyacente. Si sólo hay un objeto de ese tipo disponible, la celda Variables en ámbito se rellena de forma automática con el objeto. Asimismo, puede especificar que una celda Variables en ámbito seleccione una variable que esté disponible en la lista desplegable.
Nota
Dado que una forma de orquestación de llamadas llama a una orquestación, los "Parámetros de orquestación" que seleccione en este cuadro de diálogo hacen referencia realmente a las variables de orquestación.
Si una orquestación a la que está llamando no tiene parámetros definidos, el control de cuadrícula del cuadro de diálogo no estará disponible.