Paso 1: Publicar las operaciones de componentes empresariales de Siebel como un servicio WCF
Tiempo de finalización: 10 minutos
Objetivo: Puede usar el Asistente para desarrollo de servicios de adaptador de WCF para generar un servicio WCF que se pueda hospedar en un entorno de hospedaje, como Internet Information Services (IIS) o servicio de activación de procesos de Windows (WAS). En este tema se muestra cómo usar el asistente para generar un archivo de servicio WCF.
Requisitos previos
Antes de ejecutar el asistente, instale lo siguiente:
SDK del adaptador de línea de negocio (LOB) de Microsoft Windows Communication Foundation (WCF) con la opción Completar o la opción Personalizada (y elegir Herramientas dentro de esta opción). Esto instala la plantilla de Visual Studio para el Asistente para desarrollo del servicio adaptador de WCF.
Adaptadores de Microsoft BizTalk para aplicaciones Siebel eBusiness
El cliente de Siebel necesario.
Para obtener más información sobre estos requisitos previos, consulte la guía de instalación del paquete de adaptadores de BizTalk. La guía de instalación se instala normalmente en la <unidad> de instalación:\Archivos de programa\Microsoft BizTalk Adapter Pack\Documents.
Publicar los componentes empresariales de Siebel como un servicio WCF
Inicie Visual Studio y, a continuación, cree un proyecto.
En el cuadro de diálogo Nuevo proyecto , en el panel Tipos de proyecto, seleccione Visual C#. En el panel Plantillas , seleccione Servicio de adaptador de WCF.
Como alternativa, en el panel Tipos de proyecto , expanda Visual C# y, a continuación, seleccione Web. En el panel Plantillas , seleccione Servicio de adaptador de WCF.
Nota
Si instaló Visual Studio con el componente Desarrollo web, la plantilla Servicio de adaptador de WCF también está disponible en la opción Nuevo sitio web .
Especifique un nombre y una ubicación para la solución y, a continuación, haga clic en Aceptar. Se inicia el Asistente para desarrollo del servicio adaptador de WCF.
En la página de bienvenida, haga clic en Siguiente.
En la página Elegir operaciones, especifique un cadena de conexión para conectarse al sistema Siebel. Para ello:
En la lista Seleccionar un enlace , haga clic en siebelBinding y, a continuación, haga clic en Configurar.
En el cuadro de diálogo Configurar adaptador , haga clic en la pestaña Seguridad .
En la lista Tipo de credencial de cliente, seleccione Nombre de usuario y especifique el nombre de usuario y la contraseña para conectarse al sistema Siebel.
Haga clic en la pestaña Propiedades de URI y, a continuación, especifique valores para los parámetros de conexión. Para obtener más información sobre el URI de conexión para el adaptador de Siebel, vea Crear el URI de conexión del sistema de Siebel.
Nota
Si los parámetros de conexión contienen caracteres reservados (como caracteres especiales XML), debe especificarlos tal y como están en la pestaña Propiedades del URI , es decir, sin usar caracteres de escape. Sin embargo, si especifica el URI directamente en el campo Configurar un URI y los parámetros de conexión contienen caracteres reservados, debe especificar los parámetros de conexión mediante caracteres de escape adecuados.
Haga clic en la pestaña Propiedades de enlace y, a continuación, especifique valores para las propiedades de enlace, si las hay, necesarias para las operaciones de destino.
Para obtener más información sobre las propiedades de enlace, vea Leer sobre el adaptador de BizTalk para propiedades de enlace de Siebel.
Haga clic en Aceptar y, a continuación, haga clic en Conectar. Una vez establecida la conexión, el estado de la conexión se muestra como Conectado.
En la página Elegir operaciones, en la lista Seleccionar tipo de contrato, haga clic en Cliente (operaciones salientes).
En el cuadro Seleccionar una categoría , expanda el nodo Siebel Business Objects para ver la lista de objetos empresariales en el repositorio de Siebel. Para este ejemplo, haga lo siguiente:
Expanda el objeto de negocio Account y, a continuación, haga clic en el componente De negocio Cuenta .
En el cuadro Categorías y operaciones disponibles , seleccione la operación Consulta y, a continuación, haga clic en Agregar. La operación seleccionada aparece en el cuadro Categorías y operaciones agregadas .
En la página Elegir operaciones, haga clic en Siguiente.
En la página Configurar comportamientos de servicio y punto de conexión, especifique los valores para configurar el comportamiento del servicio y del punto de conexión.
En el cuadro Configuración del comportamiento del servicio , especifique los valores para lo siguiente:
Para la propiedad Especificar el valor EnableMetadataExchange Establézcalo en True para crear un punto de conexión de intercambio de metadatos. Al establecer esto en True, los metadatos del servicio estarán disponibles mediante protocolos estandarizados, como WS-Metadata Exchange (MEX) y solicitudes HTTP/GET.
El valor predeterminado es false.IncludeExceptionDetailsinFault Establézcalo en True para incluir información de excepciones administradas en detalle de los errores soap devueltos al cliente con fines de depuración. El valor predeterminado es false. Nombre Nombre de la configuración del comportamiento del servicio. UseServiceCertificate Especifica si desea usar el modo de seguridad de nivel de mensaje de WCF. El valor predeterminado es true.
Para este tutorial, debe establecerlo en False.FindValue Cadena que especifica el valor que se va a buscar en el almacén de certificados X.509.
Nota: Especifique un valor para esta propiedad solo si UseServiceCertificate está establecido en True.StoreLocation Valor que especifica la ubicación del almacén de certificados que el servicio puede usar para validar el certificado del cliente.
Nota: Especifique un valor para esta propiedad solo si UseServiceCertificate está establecido en True.StoreName Nombre del almacén de certificados X.509 que se va a abrir.
Nota: Especifique un valor para esta propiedad solo si UseServiceCertificate está establecido en True.X509FindType El tipo de búsqueda de X.509 que se va a ejecutar.
Nota: Especifique un valor para esta propiedad solo si UseServiceCertificate está establecido en True.Nota
Para obtener más información sobre los certificados y las propiedades asociadas, vea Propiedades X509ClientCertificateCredentialsElement.
En el cuadro Configuración de comportamiento del punto de conexión , especifique los valores para lo siguiente:
Para la propiedad Especificar el valor Tipo de autenticación : establézcalo en ClientCredentialUserNamePassword para permitir que los clientes especifiquen el nombre de usuario y la contraseña mientras consumen el servicio WCF.
: establézcalo en HTTPUserNamePassword para permitir que los clientes especifiquen el nombre de usuario y la contraseña como parte del encabezado HTTP.
- Establézcalo en Automático para permitir primero que los clientes especifiquen las credenciales a través de la interfaz ClientCredential . Si se produce un error, los clientes pueden pasar credenciales como parte del encabezado HTTP.
El valor predeterminado es Automático. Para que Microsoft Office SharePoint Server consuma el servicio WCF, debe establecerlo como HTTPUserNamePassword.Nombre Especifique un nombre para la configuración del comportamiento del punto de conexión. UsernameHeader Nombre del encabezado de nombre de usuario. En este ejemplo, especifique MyUserHeader. Para obtener más información sobre los encabezados HTTP, vea "Compatibilidad con encabezados HTTP y SOAP personalizados" en https://go.microsoft.com/fwlink/?LinkId=106692.
Nota: Debe especificar un valor para esta propiedad si el tipo de autenticación está establecido en HTTPUserNamePassword. Si tipo de autenticación se establece en Automático, esta propiedad es opcional.PasswordHeader Nombre del encabezado de contraseña. En este ejemplo, especifique MyPassHeader. Para obtener más información sobre los encabezados HTTP, vea "Compatibilidad con encabezados HTTP y SOAP personalizados" en https://go.microsoft.com/fwlink/?LinkId=106692.
Nota: Debe especificar un valor para esta propiedad si el tipo de autenticación está establecido en HTTPUserNamePassword. Si tipo de autenticación se establece en Automático, esta propiedad es opcional.En la ilustración siguiente se muestra la página Configurar comportamientos de servicio y punto de conexión con los valores especificados.
de conexión
En la página Configurar comportamientos de servicio y punto de conexión, haga clic en Siguiente.
En la página Configurar enlace de punto de conexión de servicio y dirección, el cuadro Seleccionar un contrato para configurar enumera los contratos de los componentes empresariales de Siebel para los que seleccionó las operaciones en la página Elegir operaciones. En el cuadro Operaciones del contrato seleccionado se muestran las operaciones seleccionadas para cada artefacto en la página Elegir operaciones.
En el cuadro Configure the address and binding for the contract (Configurar la dirección y el enlace del contrato ), especifique los valores para lo siguiente:
Para la propiedad Especificar el valor Configuración de enlace El asistente solo admite el enlace HTTP básico. Por lo tanto, el campo de configuración de enlace se rellena automáticamente en System.ServiceModel.Configuration.BasicHttpBindingElement.
Haga clic en el botón de puntos suspensivos (...) para cambiar las propiedades del enlace HTTP. Para usar un canal de comunicación seguro, siempre debe establecer la propiedad Mode en Transport. El asistente establece el valor predeterminado de la propiedad Mode como Transport.
Para obtener más información sobre los demás enlaces expuestos, vea BasicHttpBindingElement (clase).Nombre del punto de conexión Especifique un nombre de punto de conexión para el contrato. Los demás campos de esta página se rellenan automáticamente en función de los valores especificados en las páginas anteriores.
Haga clic en Aplicar. Realice este paso para todos los contratos mostrados en el cuadro Seleccionar un contrato para configurar .
Nota
Si no especifica ningún valor en esta página, se aceptan los valores predeterminados para todos los contratos.
En la ilustración siguiente se muestra la página Configurar enlace de punto de conexión de servicio y dirección con los valores especificados.
Configurar el enlace de punto de conexión de
En la página Configurar enlace de punto de conexión de servicio y dirección, haga clic en Siguiente. En la página Resumen se muestra una estructura de árbol de los contratos de los componentes empresariales de Siebel seleccionados y, en ese caso, las operaciones seleccionadas para cada componente empresarial.
Revise el resumen y, a continuación, haga clic en Finalizar.
El asistente crea un servicio WCF y agrega los siguientes archivos al proyecto de Visual Studio:
Archivo .svc. Este es el archivo de servicio WCF. El asistente genera un archivo para cada contrato.
Web.config archivo.
Código de servicio (archivo .cs).
Publique el servicio WCF.
Asegúrese de que SSL está habilitado para Internet Information Services (IIS). Consulte Cómo configurar SSL.
Haga clic con el botón derecho en el proyecto en Explorador de soluciones y, a continuación, haga clic en Publicar.
En el cuadro de diálogo Publicar web , especifique una dirección URL para el servicio WCF. Por ejemplo:
https://<computer_name>/Siebel_Account/
En el cuadro Copiar , haga clic en Todos los archivos de proyecto.
Haga clic en Publicar.
Compruebe que el servicio WCF se ha publicado correctamente.
Inicie microsoft Management Console de IIS. Haga clic en Inicio, seleccione Herramientas administrativas y, a continuación, haga clic en Internet Information Services.
Vaya al nodo donde publicó el servicio. Para el servicio Siebel_Account, vaya a Internet Information Services><Nombre>> de equipoSitios>web>predeterminados Siebel_Account.
En el panel derecho, haga clic con el botón derecho en el archivo BusinessObjects_Account_Account_Operation.svc y, a continuación, haga clic en Examinar.
La página web se muestra con la dirección URL para recuperar el WSDL. Es posible que desee probar la recuperación de metadatos mediante el comando svcutil. Por ejemplo, el comando para recuperar los metadatos del servicio Siebel_Account es:
svcutil.exe https://localhost/Siebel_Account/BusinessObjects_Account_Account_Operation.svc?wsdl
Pasos siguientes
Ahora tiene un servicio WCF para el componente de negocio de Siebel. Use el Editor de definiciones de Business Data Catalog para crear un archivo de definición de aplicación para las operaciones del componente de negocio de Siebel. Consulte Step 2: Create an Application Definition File for Siebel Business Component Operations (Paso 2: Crear un archivo de definición de aplicación para operaciones de componentes empresariales de Siebel ) para obtener instrucciones. El archivo de definición de aplicación identifica dónde se almacenan los datos loB y el formato en el que se almacena.
Consulte también
Tutorial 1: Presentación de datos de un sistema de Siebel en un sitio de SharePoint