Creación del URI de conexión del sistema de Siebel
El URI de conexión del adaptador de Microsoft BizTalk para aplicaciones de siebel eBusiness contiene propiedades que el adaptador usa para establecer una conexión con el sistema Siebel.
En este tema se proporciona información sobre el URI de conexión de Siebel y también se proporcionan vínculos a otros temas que explican cómo especificar un URI de conexión en diferentes escenarios de programación.
URI de conexión para el adaptador de Siebel
Un URI de dirección de punto de conexión WCF típico se representa de la siguiente manera:
scheme://userinfoparams@hostinfoparams?query_string
El URI de dirección del punto de conexión contiene los siguientes componentes:
scheme es el nombre del esquema.
userinfoparams es una colección de valores de nombre de los parámetros necesarios para la autenticación de usuario por el punto de conexión.
hostinfoparams es información necesaria para establecer la conexión con el host; por ejemplo, una ruta de acceso.
query_string es una colección opcional name-value de parámetros delimitados por un signo de interrogación (?).
El URI de conexión de Siebel sigue este formato general y se implementa de la siguiente manera:
siebel://Username=[USER_NAME];Password=[PASSWORD]@[SERVER]:[PORT]?SiebelObjectManager=[SIEBEL_OBJECT_MANAGER_NAME]&SiebelEnterpriseServer=[SERVER_NAME]&Language=[LANGUAGE]&Transport=[TRANSPORT]&Encryption=[ENCRYPTION]&Compression=[COMPRESSION]&SiebelServer=[SIEBEL_SERVER_NAME]&SiebelRepository=[SIEBEL_REPOSITORY_NAME]
En las secciones siguientes se describen las propiedades implementadas para cada componente del URI de conexión de Siebel.
Esquema para el URI de conexión de Siebel
El esquema del URI de conexión de Siebel es "siebel".
Información del usuario en el URI de conexión de Siebel
De forma predeterminada, el adaptador de Siebel produce una excepción cuando se especifican las credenciales del sistema de Siebel en el URI de conexión. Esto se debe a que estas credenciales se representan como texto sin formato, lo que supone un riesgo de seguridad inherente. Puede establecer la propiedad de enlace AcceptCredentialsInUri para controlar si el URI de conexión puede contener credenciales. Si la propiedad AcceptCredentialsInUri es false, el adaptador de Siebel produce una excepción si el URI de conexión contiene credenciales; si la propiedad es true, no se produce ninguna excepción.
Importante
Debido a los riesgos de seguridad inherentes que supone pasar credenciales en cadenas como texto sin formato, es mejor no especificar credenciales del sistema Siebel en el URI de conexión.
Hay varias maneras de proporcionar credenciales del sistema de Siebel sin especificarlas en el URI de conexión.
En el código, puede establecer la propiedad ClientCredentials en el objeto adecuado.
Cuando use el complemento Agregar referencia de servicio de adaptador o el complemento Consumir servicio adaptador, puede escribir las credenciales seleccionando la pestaña Seguridad del cuadro de diálogo Configurar adaptador .
Al especificar un puerto de envío o un enlace de ubicación de recepción en una solución de BizTalk Server, puede escribir las credenciales seleccionando la pestaña Seguridad del cuadro de diálogo adecuado.
La información de usuario (userinfoparams) del URI de conexión de Siebel se representa como una colección de parámetros de nombre-valor necesarios para la autenticación de usuario. En la siguiente tabla se describen estos parámetros.
| Propiedad | Descripción |
|---|---|
| Nombre de usuario | El nombre de usuario en el sistema Siebel; este valor distingue mayúsculas de minúsculas. Debe establecer la propiedad de enlace AcceptCredentialsInUri en true para especificar el nombre de usuario y la contraseña en el URI de conexión. Nota: El adaptador de Siebel conserva el caso del valor especificado para el nombre de usuario cuando abre una conexión en el sistema Siebel. |
| Contraseña | La contraseña del usuario en el sistema Siebel; este valor distingue mayúsculas de minúsculas. Debe establecer la propiedad de enlace AcceptCredentialsInUri en true para especificar el nombre de usuario y la contraseña en el URI de conexión. Nota: El adaptador de Siebel conserva el caso del valor que escribe para la contraseña cuando abre una conexión en el sistema Siebel. |
Información del host en el URI de conexión de Siebel
La información del host de Siebel (hostinfoparams) especifica la dirección del sistema Siebel con el siguiente formato: [SERVER]:[PORT]. Según la versión del servidor de Siebel, la información del host de Siebel toma valores diferentes:
Para Siebel versión 7.5 y anteriores, el parámetro de información del host toma el nombre del equipo en el que está instalado el servidor de puerta de enlace de Siebel y el número de puerto de puerta de enlace de Siebel.
Para Siebel versión 7.7 y posteriores, el parámetro de información del host toma el nombre del equipo en el que está instalado el servidor de Siebel y el número de puerto del agente de conexión de Siebel.
Importante
Cuando se usa el complemento Agregar referencia de servicio de adaptador de Visual Studio o el Complemento de proyecto de BizTalk del servicio consumir adaptador para conectarse a un sistema Siebel, se debe proporcionar la información del host para la propiedad de conexión "SiebelGateway".
Información de consulta en el URI de conexión de Siebel
La información de consulta (query_string) del URI de conexión de Siebel se usa para especificar propiedades de conexión adicionales.
| Propiedad | Descripción |
|---|---|
| SiebelObjectManager | Nombre del administrador de objetos de Siebel en el servidor de empresa. Este parámetro es obligatorio. |
| SiebelEnterpriseServer | Nombre de Siebel Enterprise Server. Este parámetro es obligatorio. |
| Lenguaje | Idioma del administrador de objetos. Este parámetro es opcional. Si no se especifica, el adaptador de Siebel proporciona un valor predeterminado (enu). |
| Transporte | El transporte; solo se admite tcpip. Este parámetro es opcional. Si no se especifica, el sistema Siebel proporciona un valor predeterminado (tcpip). |
| Cifrado | Tipo de cifrado que se debe utilizar entre el adaptador y el sistema Siebel. Los valores admitidos son none, mscrypto o rsa. Este parámetro es opcional. Si no se especifica, el sistema Siebel proporciona un valor predeterminado (ninguno). |
| Compresión | Algoritmo de compresión que se debe utilizar entre el adaptador y el sistema Siebel. Los valores admitidos son ninguno o zlib. Este parámetro es opcional. Si no se especifica, el sistema Siebel proporciona un valor predeterminado (zlib). |
| SiebelServer | Servidor siebel. Necesario para todas las conexiones de servidor de Siebel 7.5 (7.5.2, 7.5.3, etc.); de lo contrario, no establezca este parámetro. |
| SiebelRepository | Repositorio de Siebel. Obligatorio si existe más de un repositorio en el servidor; de lo contrario, opcional. Nota: Si hay más de un repositorio en el servidor, debe especificar un repositorio de destino en el parámetro SiebelRepository. |
Para obtener más información sobre los parámetros de Siebel que se establecen en la información de consulta, consulte la documentación de Siebel.
Uso de caracteres reservados en el URI de conexión
El adaptador de Siebel no admite la especificación de un URI de conexión que tenga caracteres especiales para cualquiera de los valores de parámetro. Si los valores del parámetro de conexión contienen caracteres especiales, asegúrese de realizar una de las siguientes acciones:
Si va a especificar el URI en Visual Studio mediante agregar complemento de referencia del servicio adaptador o consumir complemento de servicio de adaptador, debe especificarlos tal cual en la pestaña Propiedades del URI , es decir, sin usar caracteres de escape. 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 con caracteres de escape adecuados.
Si va a especificar el URI al crear un puerto de envío o recepción en BizTalk Server consola de administración y los parámetros de conexión contienen caracteres reservados, debe especificar los parámetros de conexión mediante caracteres de escape adecuados.
Uso del URI de conexión para conectarse al sistema Siebel
A continuación se muestra un URI de conexión de Siebel de ejemplo.
siebel://Username=YourUserName;Password=YourPassword@Siebel_server:1234?SiebelObjectManager=obj_mgr&SiebelEnterpriseServer=entserver&Language=enu
Nota
Este URI de ejemplo contiene las credenciales del sistema siebel; Debe establecer la propiedad de enlace AcceptCredentialsInUri en true para usar un URI de conexión que contenga credenciales.
Para obtener información sobre cómo establecer una conexión con el sistema Siebel (incluida la configuración de las propiedades de conexión) al:
Use el complemento de proyecto de BizTalk del servicio Consumir adaptador o el complemento Agregar referencia del servicio adaptador de Visual Studio, vea Obtener metadatos para operaciones de Siebel en Visual Studio.
Configure un puerto de envío o un puerto de recepción (ubicación) en una solución de BizTalk Server, consulte Configuración manual de un enlace de puerto físico al adaptador de Siebel.
Use el modelo de canal WCF en una solución de programación; consulte Creación de un canal mediante Siebel.
Usar el modelo de servicio WCF en una solución de programación, consulte Configurar un cliente WCF para un sistema Siebel.
Use la Herramienta de utilidad de metadatos serviceModel de WCF (svcutil.exe), consulte Uso de la herramienta de utilidad de metadatos serviceModel con el adaptador de BizTalk para aplicaciones eBusiness de Siebel.
Consulte también
Crear una conexión con el sistema de Siebel
Desarrollar aplicaciones de Siebel
Desarrollar aplicaciones de Siebel con el modelo de canal WCF3
Desarrollo de aplicaciones SQL mediante el modelo de servicio WCF