Ejecutar operaciones en componentes empresariales con campos MVG mediante BizTalk Server y el adaptador de Siebel

2025-06-05

En esta sección se proporcionan instrucciones sobre cómo realizar operaciones en un componente empresarial que contiene campos de varios valores. Para demostrar una operación de un extremo a otro en estos componentes empresariales, debe realizar lo siguiente:

Una operación de INSERT en un componente de negocio principal
Una operación INSERT en un componente empresarial secundario
Una operación ASSOCIATE en los enlaces multivalor entre el componente de negocio padre e hijo
Operación Query_[MVG_Child_Business_Comp] en un registro del componente de negocio principal

Para obtener más información sobre cómo el adaptador de Siebel admite operaciones en componentes empresariales, consulte Operaciones en componentes empresariales. Para obtener más información sobre la estructura de mensajes SOAP para realizar estas operaciones, vea Esquemas de mensajes para operaciones de componentes empresariales.

¿Cómo realizar operaciones en un componente empresarial con campos de varios valores?

La realización de una operación en un sistema Siebel mediante el adaptador de Siebel con BizTalk Server implica tareas de procedimientos descritas en Bloques de creación para crear aplicaciones de Siebel. Para realizar una operación en un componente empresarial, estas tareas son:

Cree un proyecto de BizTalk y genere esquema para todas las operaciones que desea invocar en el componente empresarial. Como se ha descrito anteriormente, para realizar operaciones en un componente de negocio con campos de múltiples valores, debe generar el esquema para la operación de inserción en los componentes de negocio padre e hijo, la operación de asociación en los enlaces de múltiples valores entre los componentes de negocio padre e hijo, y una operación de consulta en el componente de negocio padre.
Cree mensajes en el proyecto de BizTalk para enviar y recibir mensajes desde el sistema Siebel.
Cree una orquestación para invocar las distintas operaciones en el sistema Siebel.
Compile e implemente el proyecto de BizTalk.
Configure la aplicación de BizTalk mediante la creación de puertos de envío y recepción físicos.
Inicie la aplicación de BizTalk.

En este tema se proporcionan instrucciones para realizar estas tareas.

Ejemplo basado en este tema

También se proporciona un ejemplo, MVLDemo, basado en este tema, con el paquete de adaptadores de BizTalk. Para obtener más información, consulte Ejemplos para el adaptador de Siebel.

Generar esquema

En este tema, para mostrar cómo asociar el componente de negocio primario, Cuenta a un componente empresarial secundario, Contacto, generaremos el esquema para lo siguiente:

Operación de INSERCIÓN en el componente empresarial Cuenta. Consulte Ejecutar operaciones en componentes empresariales mediante BizTalk Server y el adaptador de Siebel.
Operación INSERT en el componente empresarial Contact.
Operación ASSOCIATE en el componente de negocio Cuenta .
La operación QUERY_CONTACT en el componente de negocio Cuenta.

Consulte Obtención de metadatos para operaciones de Siebel en Visual Studio para obtener más información sobre cómo generar esquema.

Definición de mensajes y tipos de mensajes

El esquema que generó anteriormente describe los "tipos" necesarios para los mensajes de la orquestación. Normalmente, un mensaje es una variable, el tipo para el que se define mediante el esquema correspondiente. Debe vincular el esquema que generó en el primer paso a los mensajes de la vista Orquestación del proyecto de BizTalk.

Para este tema, debe crear cuatro conjuntos de mensajes de solicitud y respuesta, uno para cada operación que invocará en el sistema Siebel. Cada conjunto debe tener un mensaje de solicitud y un mensaje de respuesta. Por ejemplo, el procedimiento siguiente proporciona instrucciones para crear mensajes de solicitud y de respuesta para la operación "Asociar". Debe realizar pasos similares para crear mensajes para otras operaciones.

Realice los pasos siguientes para crear mensajes y vincularlos al esquema:

Creación de mensajes y vínculo al esquema

Abra la vista de orquestación del proyecto de BizTalk, si aún no está abierto. Haga clic en Ver, seleccione Otras ventanas y haga clic en Vista de orquestación.
En la vista Orquestación, haga clic con el botón derecho en Mensajes y, a continuación, haga clic en Nuevo mensaje.
Haga clic con el botón derecho en el mensaje recién creado y seleccione Ventana Propiedades.

En el panel Propiedades de Message_1, haga lo siguiente:

Usa esto	Para
Identificador	Escriba AccountAssociate_Request.
Tipo de mensaje	En la lista desplegable, expanda Esquemas y seleccione MVLDemo.SiebelBindingSchema.Associate, donde MVLDemo es el nombre del proyecto de BizTalk. SiebelBindingSchema es el esquema generado para invocar la operación Associate en el componente de negocio Account .

Repita el paso anterior para crear un nuevo mensaje. En el panel Propiedades del nuevo mensaje, haga lo siguiente:

Usa esto Para

Identificador Escriba AccountAssociate_Response.

Tipo de mensaje En la lista desplegable, expanda Esquemas y seleccione MVLDemo.SiebelBindingSchema.AssociateResponse.

Usa esto	Para
Identificador	Escriba AccountAssociate_Response.
Tipo de mensaje	En la lista desplegable, expanda Esquemas y seleccione MVLDemo.SiebelBindingSchema.AssociateResponse.

Configuración de las orquestaciones

Ahora debe configurar orquestaciones para usar BizTalk Server y realizar operaciones en los componentes empresariales de Cuenta y Contacto.

Configure una orquestación para realizar una operación INSERT en el componente de negocio Cuenta . Consulte Ejecutar operaciones en componentes empresariales mediante BizTalk Server y el adaptador de Siebel.
Configure una orquestación que realice una operación INSERT en el componente de negocio Contacto. Esto es similar a la operación INSERT en el componente de negocio Cuenta .
Configure una orquestación para realizar una operación de asociación en el componente de negocio Cuenta.
Configurar una orquestación para llevar a cabo una operación QUERY_CONTACT en el componente de negocio Cuenta.

En este tema se muestra cómo configurar una orquestación para la operación ASSOCIATE en el componente de negocio Cuenta . También debe realizar tareas similares para configurar las orquestaciones restantes.

La orquestación de la operación ASSOCIATE en el componente de negocio Cuenta tiene el siguiente aspecto:

En la sección siguiente se proporciona información sobre cómo configurar esta orquestación quitando formas de mensaje, puertos, vinculando mensajes a esquemas, etc. También debe realizar tareas similares para configurar las otras orquestaciones.

Agregar formas de mensaje

Asegúrese de especificar las siguientes propiedades para cada una de las formas de mensaje. Los nombres enumerados en la columna Shape son los nombres de las formas de mensaje tal como se muestran en la orquestación anterior.

Forma	Tipo de forma	Propiedades
AccountAssociateXML	Recibir	- Establecer nombre en AccountAssociateXML - Establecer Activar en True
SendToLOB	Enviar	- Establecer Nombre en SendToLOB
RecibirRespuesta	Recibir	- Establecer Name en ReceiveResponse - Establecer Activar en False
SendResponse	Enviar	- Establecer nombre en SendResponse

Agregar puertos

Asegúrese de especificar las siguientes propiedades para cada uno de los puertos lógicos. Los nombres enumerados en la columna Puerto son los nombres de los puertos tal como se muestran en la orquestación.

Puerto	Propiedades
FileIn_AccountAssociate	- Establecer el identificador en FileIn_AccountAssociate - Establecer Type en FileInAccountAssociateType - Establecer el patrón de comunicación en unidireccional - Establecer la dirección de comunicación para recibir
LOBPort_AsociadoDeCuenta	- Establecer identificador en LOBPort_AccountAssociate - Establece Tipo en LOBPortAccountAssociateType - Establecer el patrón de comunicación en Request-Response - Establecer la dirección de comunicación en enviar y recibir
GuardarRespuesta_AsociarCuenta	- Establecer identificador en SaveResponse_AccountAssociate - Configurar Tipo en SaveResponseAccountAssociateType - Establecer el patrón de comunicación en unidireccional - Establecer la dirección de comunicación en Enviar

Especificar mensajes para formas de acción y conectarse a puertos

En la tabla siguiente se especifican las propiedades y sus valores que se van a establecer para especificar mensajes para las formas de acción y vincularlos a los puertos. Los nombres enumerados en la columna Shape son los nombres de las formas de mensaje tal como se muestran en la orquestación anterior.

Forma	Propiedades
AccountAssociateXML	- Establecer Mensaje en AccountAssociate_Request - Establecer operación en FileIn_AccountAssociate.Associate.Request
SendToLOB	- Establecer Mensaje en AccountAssociate_Request - Establezca la Operación en LOBPort_AccountAssociate.Associate.Request
RecibirRespuesta	- Establecer Mensaje en AccountAssociate_Response - Establecer Operación en LOBPort_AccountAssociate.Associate.Response
SendResponse	- Establecer mensaje en respuesta - Establecer Operación en SaveResponse_AccountAssociate.Associate.Request

Una vez que haya especificado estas propiedades, las formas de mensaje y los puertos están conectados y se completa la orquestación.

Ahora debe compilar la solución de BizTalk e implementarla en un servidor de BizTalk Server. Para obtener más información, vea Cómo compilar orquestaciones e implementar ensamblados de BizTalk desde Visual Studio en una aplicación de BizTalk.

Configuración de la aplicación de BizTalk

Después de implementar el proyecto de BizTalk, la orquestación que creó anteriormente aparece en el panel Orquestaciones de la consola de administración de BizTalk Server. Debe usar la consola de administración de BizTalk Server para configurar la aplicación. Para obtener más información sobre cómo configurar una aplicación, consulte How to Create an Application (Cómo crear una aplicación).

La configuración de una aplicación implica:

Selección de un host para la aplicación.
Asignación de los puertos que creó en la orquestación a puertos físicos en la consola de administración de BizTalk Server. Para esta orquestación, debes:
- Defina una ubicación en el disco duro y un puerto de archivo correspondiente donde dejará un mensaje de solicitud. La orquestación de BizTalk consumirá el mensaje de solicitud y lo enviará al sistema Siebel. Puede tener el mismo puerto para las cuatro orquestaciones.
- Defina una ubicación en el disco duro y un puerto de archivo correspondiente donde la orquestación de BizTalk depositará el mensaje que contiene la respuesta del sistema Siebel. Puede tener el mismo puerto para las cuatro orquestaciones.
- Defina puertos de envío físicos WCF-Custom o WCF-Siebel para enviar mensajes al sistema Siebel. También debe especificar la acción en el puerto de envío. Para obtener información sobre cómo crear puertos, consulte Configuración manual de un enlace de puerto físico al adaptador de Siebel. Es necesario tener puertos distintos para las cuatro orquestaciones.
  
  Nota:
  
  La generación del esquema mediante el complemento del proyecto de BizTalk para consumir servicio de adaptador también crea un archivo de enlace que contiene información sobre los puertos y las acciones que se van a establecer para esos puertos. Puede importar este archivo de enlace desde la Consola de administración de BizTalk para crear puertos de envío (para llamadas salientes). Para obtener más información, consulte Configuración de un enlace de puerto físico mediante un archivo de enlace de puertos en Siebel.

Iniciar la aplicación

Debe iniciar la aplicación de BizTalk para asociar un componente de negocio principal al componente de negocio secundario. Para obtener instrucciones sobre cómo iniciar una aplicación de BizTalk, vea Iniciar una aplicación de BizTalk o Iniciar una orquestación.

En esta fase, asegúrese de:

El puerto de recepción FILE para recibir mensajes de solicitud para la orquestación está en funcionamiento.
El puerto de envío "FILE" para recibir los mensajes de respuesta de la orquestación está en funcionamiento.
Los cuatro puertos de envío, etiquetados como WCF-Custom o WCF-Siebel, cada uno para enviar mensajes al sistema Siebel, están en funcionamiento.
Las cuatro orquestaciones de BizTalk para las distintas operaciones se están ejecutando

Ejecución de la operación

Debe descartar los mensajes de solicitud en el puerto de recepción FILE. El esquema de los mensajes de solicitud debe ajustarse al esquema que generó anteriormente en el tema. Consulte Esquemas de mensajes para operaciones de componentes empresariales para obtener más información sobre el esquema del mensaje de solicitud para distintas operaciones. Debe quitar los mensajes de solicitud en el orden siguiente:

Envía un mensaje de solicitud para insertar un registro en el componente empresarial Cuenta. El mensaje de solicitud será similar al que se ha generado para insertar un registro en el componente de negocio de Cuenta en el tema Ejecutar operaciones en componentes empresariales mediante BizTalk Server y el adaptador de Siebel. La orquestación consume el mensaje y lo envía al sistema Siebel. La respuesta del sistema Siebel se guarda en la otra ubicación FILE definida como parte de la orquestación.
Deje un mensaje de solicitud para insertar un registro en el componente de negocio Contacto. El mensaje de solicitud será similar al que se ha elaborado para insertar un registro en el componente de negocio de Cuentas en el tema Ejecutar operaciones en componentes empresariales mediante BizTalk Server y el adaptador de Siebel. La orquestación consume el mensaje y lo envía al sistema Siebel. La respuesta del sistema Siebel se guarda en la otra ubicación FILE definida como parte de la orquestación.
Quite un mensaje de solicitud para realizar una operación ASSOCIATE en el componente de negocio Cuenta . Esto asociará los componentes de negocio principal y secundario según la expresión de búsqueda y el nombre del campo multivalor que especifique en el XML de entrada. Observe lo siguiente:
- La expresión de búsqueda primaria de la operación ASSOCIATE debe coincidir con un registro único en la tabla primaria.
- La expresión de búsqueda secundaria de la operación ASSOCIATE debe coincidir con un registro único en la tabla secundaria.
  
  Por ejemplo, el mensaje de solicitud para realizar una operación Associate en el componente de negocio Account es:
```
<Associate xmlns="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Operation">  
  <ViewMode>3</ViewMode>  
  <ParentSearchExpr>[Name] LIKE "SampleName1"</ns0:ParentSearchExpr>   
  <ParentMVGField>Bill To First Name</ns0:ParentMVGField>   
  <ChildSearchExpr>[First Name] LIKE "SampleName2"</ns0:ChildSearchExpr>   
</Associate>  
```
La orquestación consume el mensaje y lo envía al sistema Siebel. La respuesta del sistema Siebel se guarda en la otra ubicación FILE definida como parte de la orquestación. Por ejemplo, la respuesta del mensaje de solicitud anterior es:
```
<?xml version="1.0" encoding="utf-8"?>  
<AssociateResponse xmlns="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Operation">  
  <AssociateResult>  
    <ChildID xmlns="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects">1-8AO09</ChildID>  
    <ParentID xmlns="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects">1-8ANZ5</ParentID>  
  </AssociateResult>  
</AssociateResponse>  
```
Deje caer un mensaje de petición para hacer una operación QUERY_CONTACT en el componente de negocio Cuenta. Por ejemplo, el mensaje de solicitud de una operación de QUERY_CONTACT es:
```
<Query_Contact xmlns ="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Operation">  
  <ViewMode>3</ViewMode>   
  <ParentSearchExpr>[Name] LIKE "SampleName1"</ParentSearchExpr>   
  <ParentMVGField>Bill To First Name</ParentMVGField>   
  <ContactQueryInputRecord>  
    <SearchExpr xmlns:ns1="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects">[Id] LIKE '*'</SearchExpr>   
  </ContactQueryInputRecord>  
</Query_Contact>  
```
La orquestación consume el mensaje y lo envía al sistema Siebel. La respuesta del sistema Siebel se guarda en la otra ubicación FILE definida como parte de la orquestación.

Consulte Esquemas de mensajes para operaciones de componentes empresariales para obtener más información sobre el esquema del mensaje de solicitud.

Posibles excepciones

Para obtener información sobre las excepciones que puede encontrar al realizar una operación en el componente empresarial con campos con varios valores mediante BizTalk Server, vea Excepciones y control de errores.

Procedimientos recomendados

Después de implementar y configurar el proyecto de BizTalk, puede exportar opciones de configuración a un archivo XML denominado archivo de enlaces. Una vez que genere un archivo de enlaces, puede importar los valores de configuración del archivo para que no sea necesario crear los puertos de envío, los puertos de recepción, etc. para la misma orquestación. Para obtener más información sobre la vinculación de archivos, consulte Reutilización de vínculos de adaptador.

Véase también

Desarrollo de aplicaciones de BizTalk