Compartir a través de

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

El adaptador de Siebel expone las operaciones que se pueden invocar en un componente empresarial. Las operaciones de los componentes empresariales se pueden clasificar como:

Cómo realizar operaciones en un componente empresarial

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 BizTalk con el adaptador de Siebel.

Para completar una operación en un componente empresarial, estas tareas son:

  1. Cree un proyecto de BizTalk y genere el esquema para la operación que desea invocar en el componente empresarial.

  2. Cree mensajes en el proyecto de BizTalk para enviar y recibir mensajes desde el sistema Siebel.

  3. Cree una orquestación para invocar una operación en el sistema Siebel.

  4. Compile e implemente el proyecto de BizTalk.

  5. Configure la aplicación de BizTalk mediante la creación de puertos de envío y recepción físicos.

  6. 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, SiebelAccount, 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 demostrar cómo invocar operaciones en un componente de negocio, se genera un esquema para la operación Insertar en el componente de negocio Cuenta. Consulte Recuperació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 dos mensajes: uno para enviar una solicitud al sistema Siebel y al otro para recibir una respuesta.

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

  1. 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.

  2. En la vista Orquestación, haga clic con el botón derecho en Mensajes y, a continuación, haga clic en Nuevo mensaje.

  3. Haga clic con el botón derecho en el mensaje recién creado y seleccione Ventana Propiedades.

  4. En el panel Propiedades de Message_1, haga lo siguiente:

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

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

    Usa esto Para
    Identificador Escriba Respuesta.
    Tipo de mensaje En la lista desplegable, expanda Esquemas y seleccione SiebelAccount.SiebelBindingSchema.InsertResponse.

Configuración de la orquestación

Debe crear una orquestación de BizTalk utilizando BizTalk Server para realizar una operación en un componente empresarial de Siebel. En esta orquestación, se deja un mensaje de solicitud en una ubicación de recepción definida. El adaptador de Siebel consume este mensaje y lo pasa al sistema Siebel. La respuesta del sistema Siebel se guarda en otra ubicación. Una orquestación típica para realizar operaciones en componentes empresariales de Siebel contendrá:

  • Enviar y recibir formas para enviar mensajes a Siebel y recibir respuestas.

  • Puerto de recepción unidireccional para recibir mensajes de solicitud que se van a enviar a Siebel.

  • Puerto de envío bidireccional para enviar mensajes de solicitud a Siebel y recibir respuestas.

  • Un puerto de envío unidireccional para enviar las respuestas de Siebel a una carpeta.

    Una orquestación de ejemplo para la operación Insertar en un componente empresarial Cuenta es similar a la siguiente:

    Orquestación para insertar datos en Siebel BC

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
ReceiveXML Recibir - Establecer nombre en ReceiveXML
- 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 - Establecer identificador en FileIn
- Configura Tipo como FileInType
- Establecer el patrón de comunicación en unidireccional
- Establecer la dirección de comunicación para recibir
LOBPort - Establecer identificador en LOBPort
- Establecer el tipo en LOBPortType
- Establecer el patrón de comunicación en Request-Response
- Establecer la dirección de comunicación en enviar y recibir
GuardarRespuesta - Establecer identificador en SaveResponse
- Establecer Tipo en SaveResponseType
- 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
ReceiveXML - Establecer mensaje en solicitud
- Establecer la operación en FileIn.Insert.Request
SendToLOB - Establecer mensaje en solicitud
- Fije operación en LOBPort.Insert.Request
RecibirRespuesta - Establecer mensaje en respuesta
- Establecer Operación en LOBPort.Insert.Response
SendResponse - Establecer mensaje en respuesta
- Establecer operación en SaveResponse.Insert.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. Cómo crear una aplicación enumera los pasos.

La configuración de una aplicación implica:

  • Selección de un host para la aplicación.

  • Asigne los puertos que creó en la orquestación a los 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.

    • 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.

    • Configure un puerto de envío físico 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.

      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 BizTalk para realizar una operación de inserción en el componente empresarial Cuenta en Siebel. 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.

  • El puerto de envío WCF-Custom o WCF-Siebel para enviar mensajes al sistema Siebel se está ejecutando.

  • La orquestación de BizTalk para la operación se está ejecutando.

Ejecución de la operación

Después de ejecutar la aplicación, debe colocar el mensaje de solicitud en la ubicación de recepción del FILE. El esquema del mensaje de solicitud debe ajustarse al esquema de la operación de inserción (en el componente de negocio Cuenta) que generó anteriormente. Por ejemplo, el mensaje de solicitud para insertar un registro en el componente de negocio Cuenta es:

<Insert xmlns="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Operation">  
  <ArrayOfAccountInsertRecord>  
    <AccountInsertRecord xmlns="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects">  
      <Currency_x0020_Code>usd</Currency_x0020_Code>  
      <Current_x0020_Volume>9</Current_x0020_Volume>  
      <Customer_x0020_Account_x0020_Group>Sold-To Party</Customer_x0020_Account_x0020_Group>  
      <Location>Location_1</Location>  
      <Main_x0020_Phone_x0020_Number>4256543212</Main_x0020_Phone_x0020_Number>  
      <Name>Name_Surname</Name>  
      <Party_x0020_Name>test_party</Party_x0020_Name>  
      <Primary_x0020_Address_x0020_Id>1212 street</Primary_x0020_Address_x0020_Id>  
    </AccountInsertRecord>  
  </ArrayOfAccountInsertRecord>  
</Insert>

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

La orquestación consume el mensaje de solicitud y lo pasa 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 sistema Siebel para el mensaje de solicitud anterior es:

<?xml version="1.0" encoding="utf-8"?>  
<InsertResponse xmlns="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Operation">  
  <InsertResult>  
    <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">1-8ANYV</string>  
  </InsertResult>  
</InsertResponse>

Posibles excepciones

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

Procedimientos recomendados

Después de implementar y configurar el proyecto de BizTalk, puede exportar los valores de configuración a un archivo XML denominado archivo de enlace. 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 vinculaciones de adaptadores en el adaptador de Siebel.

Véase también

Desarrollo de aplicaciones de BizTalk mediante el adaptador de Siebel