Compartir a través de

Uso de la herramienta de utilidad de metadatos de ServiceModel con el adaptador de BizTalk para aplicaciones de comercio electrónico de Siebel

  • Artículo

Puede usar la Herramienta de utilidad de metadatos de ServiceModel (svcutil.exe) para generar una clase de cliente WCF para las operaciones que expone el adaptador de Microsoft BizTalk para aplicaciones eBusiness de Siebel. Después de ejecutar svcutil.exe para generar una clase de cliente WCF, puede incluir el archivo generado en el código y crear instancias de la clase de cliente WCF para realizar operaciones en el sistema Siebel.

El uso de svcutil.exe requiere que proporcione un URI de conexión que contenga credenciales. Dado que, de forma predeterminada, el adaptador de Siebel deshabilita las credenciales en el URI de conexión, debe configurar svcutil.exe para usar un enlace no predeterminado para el adaptador de Siebel. También puede configurar otras propiedades de enlace en el enlace no predeterminado.

En las secciones siguientes se muestra cómo configurar svcutil.exe y cómo usar svcutil.exe para generar código de cliente WCF con el adaptador de Siebel.

Configurar svcutil.exe para un enlace no predeterminado

Para configurar svcutil.exe para usar un enlace no predeterminado, debe crear una copia local de svcutil.exe y, a continuación, crear o modificar una copia local del archivo de configuración de svcutil.exe.config.

  1. Cree una carpeta y copie svcutil.exe en la nueva carpeta. Normalmente, puede encontrar svcutil.exe en la ubicación de instalación de Windows SDK, en concreto, C:\Archivos de programa\Microsoft SDKs\Windows\v6.0\Bin.

  2. Cree un archivo denominado svcutil.exe.config en la nueva carpeta.

  3. Agregue un enlace y un punto de conexión de cliente al archivo svcutil.exe.config. Debe ejecutar svcutil.exe desde la nueva carpeta para asegurarse de que se usa la configuración correcta.

    Importante

    El atributo name del punto de conexión de cliente debe especificar el esquema usado en el URI de conexión. Este valor distingue mayúsculas de minúsculas.

    <configuration>
  <system.serviceModel>
    <client>
      <!-- the name should match the required scheme of the Metadata Exchange endpoint
      and the contract should be "IMetadataExchange" -->
      <endpoint name="siebel"
        binding="siebelBinding"
        bindingConfiguration="SiebelBinding"
        contract="IMetadataExchange" />
    </client>
    <bindings>
      <siebelBinding>
        <binding name="SiebelBinding" acceptCredentialsInUri="true" />
      </siebelBinding>
    </bindings>

  </system.serviceModel>

</configuration>

Nota

Puede establecer cualquiera de las propiedades de enlace del adaptador de Siebel en la configuración de enlace.

Para obtener más información sobre cómo configurar un enlace no predeterminado para svcutil.exe, vea el tema "Punto de conexión de metadatos seguros personalizado" en la documentación de WCF en https://go.microsoft.com/fwlink/?LinkId=96077.

Creación de una clase de cliente WCF con svcutil.exe

Para usar svcutil.exe para generar código de cliente WCF para el adaptador de Siebel, debe proporcionar un URI de conexión que especifique un punto de conexión IMetadataExchange (mex) y la operación o las operaciones para las que desea svcutil.exe generar código. También debe especificar las credenciales de conexión para el sistema Siebel en el URI de conexión.

Nota:

Para poder usar svcutil.exe con el adaptador de Siebel, debe configurarlo para usar un enlace no predeterminado; para obtener información sobre cómo hacerlo, consulte Configuración de svcutil.exe para el adaptador de Siebel.

Especifique un punto de conexión mex y las operaciones de destino en el URI de conexión del adaptador de Siebel de la siguiente manera:

  • Debe incluir el parámetro "wsdl" en el query_string. Si es el primer parámetro de la query_string, se especifica justo después del signo de interrogación (?). Si no es el primer parámetro, debe ir precedido de una y comercial (&).

  • Debe seguir el parámetro "wsdl" por uno o varios parámetros "op". Cada parámetro "op" está precedido por una y comercial (&) y especifica el identificador de nodo de una operación de destino.

    En los dos ejemplos siguientes se muestra cómo dirigirse a varias operaciones mediante svcutil.exe.

    En este ejemplo se crea una clase de cliente WCF para una operación de inserción en el objeto de negocio ACCOUNT\ACCOUNT.

    .\svcutil "siebel://Username=YourUserName; Password=YourPassword@Siebel_server:1234? SiebelEnterpriseServer=ent_server&SiebelObjectManager=obj_mgr&Language=enu&wsdl&op=http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert"

    En este ejemplo se crea una clase de cliente WCF para una operación de inserción y una operación de eliminación en el objeto de negocio ACCOUNT\ACCOUNT.

    .\svcutil " siebel://Username=YourUserName; Password=YourPassword@Siebel_server:1234? SiebelEnterpriseServer=ent_server&SiebelObjectManager=obj_mgr&Language=enu&wsdl&op=http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert& op=http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Delete"

Importante

Debe colocar el URI de conexión entre comillas en la línea de comandos. De lo contrario, svcutil.exe intenta recuperar metadatos para las operaciones que el adaptador de Siebel no admite. Los resultados de este intento no están definidos.

De forma predeterminada, svcutil.exe coloca el código generado en el archivo output.cs; Sin embargo, puede cambiar el nombre del archivo de salida y muchas otras opciones que svcutil.exe usa estableciendo modificadores de línea de comandos.

Svcutil.exe no proporciona la capacidad de buscar operaciones (por ejemplo, mediante caracteres comodín). Debe especificar explícitamente los identificadores de nodo para las operaciones específicas de destino. No se pueden especificar identificadores de nodo que solo hacen referencia a categorías. Para obtener más información sobre los identificadores de nodo que expone el adaptador de Siebel, vea Identificadores de nodo de metadatos.

El complemento Agregar referencia del servicio adaptador de Visual Studio proporciona funcionalidades avanzadas de exploración y búsqueda que pueden simplificar considerablemente la generación de una clase de cliente WCF. Para obtener más información sobre el complemento agregar referencia de servicio de adaptador, vea Generar un cliente WCF o un contrato de servicio WCF para artefactos de solución de Siebel.