Compartir a través de

Paso 2: Crear un archivo de definición de aplicación para operaciones de componentes empresariales de Siebel

  • Artículo

Paso 2 de 4

Tiempo de finalización: 15 minutos

Objetivo: Business Data Catalog expone e incorpora datos de aplicaciones de línea de negocio (LOB) en portales. Para incorporar estos datos en el sitio del portal, debe crear un archivo de definición de aplicación que Microsoft Office SharePoint Server pueda consumir.

La herramienta Editor de definiciones de Business Data Catalog permite crear un archivo de definición de aplicación para business Data Catalog. Esta herramienta genera automáticamente el XML para el archivo de definición. Por lo tanto, no es necesario crear manualmente el archivo en un editor XML.

El propósito de la aplicación de Microsoft Office SharePoint Server que está creando es realizar una operación de consulta en el componente empresarial Cuenta para recuperar una lista de registros. Para ello, debe completar un conjunto de tareas en el Editor de definiciones de Business Data Catalog. En este tema se proporcionan instrucciones sobre cómo realizar estas tareas.

Requisitos previos

Crear un archivo de definición de aplicación

En esta sección se proporcionan instrucciones paso a paso para crear un archivo de definición de aplicación para el servicio WCF.

Conexión al servicio WCF y creación de entidades

Debe conectarse al servicio WCF para extraer el lenguaje de descripción de servicios web (WSDL) para el servicio. En el WSDL, el Editor de definiciones de Business Data Catalog extrae los métodos. Estos métodos se pueden usar para crear entidades. En este ejemplo, debe crear una entidad para la operación Consulta en el componente empresarial Cuenta.

Para conectarse al servicio WCF y crear entidades

  1. Inicie el Editor de definiciones de Business Data Catalog. En el menú Inicio, haga clic en Editor de definiciones de Microsoft Business Data Catalog.

  2. En la herramienta, haga clic en Agregar sistema LOB.

  3. En la ventana Agregar sistema LOB, haga clic en Conectar al servicio web.

  4. En el cuadro DIRECCIÓN URL, escriba la dirección URL del servicio WCF. La dirección URL debe tener el formato siguiente:

    https://<computer_name>/Siebel_Account/BusinessObjects_Account_Account_Operation.svc?wsdl

    donde, BusinessObjects_Account_Account_Operation.svc es el archivo de servicio creado para el contrato de Siebel.

    La dirección URL que debe escribir está disponible al probar si el servicio WCF se publica correctamente, como se describe en Paso 1: Publicar las operaciones de componentes empresariales de Siebel como un servicio WCF.

  5. Haga clic en Conectar.

  6. Haga clic en la pestaña Agregar método web para ver las operaciones seleccionadas en el Asistente para desarrollo del servicio adaptador de WCF. Verá el método Query .

    Agregar métodos web a la aplicación BDC

  7. Arrastre el método Query a la superficie de diseño y, a continuación, haga clic en Aceptar.

  8. En el cuadro de diálogo Escriba el nombre del sistema LOB , escriba un nombre en el cuadro Nombre del sistema loB . En este ejemplo, escriba Siebel_Accounty, a continuación, haga clic en Aceptar. Se crea una entidad, Entity0, en el Editor de definiciones de Business Data Catalog.

    Importante

    La herramienta Editor de definiciones de Business Data Catalog no controla los tipos de datos enumerados. Por lo tanto, la herramienta Editor de definiciones de Business Data Catalog importa los campos hasta que encuentra un tipo de datos enumerado y omite los campos restantes. La herramienta Editor de definiciones de Business Data Catalog también produce un error. Puede omitir este error y continuar haciendo clic en Aceptar. Puede agregar manualmente los campos obligatorios en el archivo de definición de aplicación en una fase posterior.

  9. Cambie los nombres de entidad para usar nombres más descriptivos. En este ejemplo, cambie Entity0 a Account.

    1. Expanda el nodo Siebel_Account y, a continuación, expanda el nodo Entidades .

    2. Seleccione el nodo Entity0 .

    3. En el panel Propiedades, escriba Cuenta en el campo Nombre .

      Cambie el nombre de la entidad

Especificar encabezados de nombre de usuario y contraseña para métodos

Al crear un servicio WCF para las operaciones de componentes empresariales seleccionados en el sistema Siebel, especificó los encabezados de nombre de usuario y contraseña como parte de la configuración del comportamiento del punto de conexión (Paso 1: Publicar las operaciones de componentes empresariales de Siebel como un servicio WCF). Debe especificar los mismos valores para las propiedades del método.

Para especificar encabezados de nombre de usuario y contraseña para el método Query

  1. En el panel Objetos de metadatos, expanda el nodo Cuenta y, a continuación, expanda el nodo Métodos .

  2. Haga clic en el nodo Consulta y, en el panel Propiedades, haga clic en el botón de puntos suspensivos (...) en el campo Propiedades .

  3. En el cuadro de diálogo Editor de colección PropertyView, haga clic en Agregar y, en el panel Propiedades, escriba HttpHeaderUserName para el campo Nombre . Del mismo modo, escriba MyUserHeader para el campo PropertyValue . Seleccione System.String en el campo Tipo .

    Agregar una propiedad

  4. En la ventana Editor de la colección PropertyView, haga clic en Agregar y, en el panel Propiedades, escriba HttpHeaderPassword para el campo Nombre . Del mismo modo, escriba MyPassHeader para el campo PropertyValue . Seleccione System.String en el campo Tipo .

  5. Haga clic en OK.

Configuración de un único Sign-On para conectarse a un sistema Siebel

Una vez que haya terminado de realizar todos los procedimientos de este tema, habrá creado un XML de definición de aplicación que se puede importar en una aplicación de SharePoint. Desde la aplicación, invocará las operaciones de componentes empresariales de Siebel (expuestas como métodos web) para recuperar los datos pertinentes del sistema Siebel. Para habilitar esto, debe crear una asignación entre un usuario en el sistema Siebel y el usuario de la aplicación de SharePoint. Esta asignación se crea en el sitio web de Administración central de SharePoint después de haber importado el XML de definición de aplicación.

Sin embargo, para crear la asignación, debe establecer una propiedad SecondarySsoApplicationId en el Editor de definiciones de Business Data Catalog.

Para establecer la propiedad SecondarySsoApplicationId

  1. En el panel Objetos de metadatos, expanda el nodo Siebel_Account y, a continuación, expanda el nodo Instancias .

  2. Haga clic en Siebel_Account_Instance y, en el panel Propiedades, haga clic en el botón de puntos suspensivos (...) en el campo Propiedades .

  3. En la ventana Editor de la colección PropertyView, haga clic en Agregar y, en el panel Propiedades, escriba SecondarySsoApplicationId para el campo Nombre . Del mismo modo, escriba SiebelSSO para el campo PropertyValue . Seleccione System.String en el campo Tipo .

    Agregue la propiedad SSO

  4. Haga clic en OK.

Requisito: Realizar una operación de consulta en el componente de negocio de la cuenta

El primer requisito de este ejemplo es crear una definición de aplicación que se pueda usar para realizar una operación de consulta en el componente de negocio Cuenta. Para lograr este requisito, debe realizar el siguiente conjunto de tareas:

  • En el método Query, cree un filtro y asígnelo al parámetro en el que se realiza la operación Query. Para el componente de negocio Cuenta, realizará una consulta mediante el parámetro SearchExpr . Por lo tanto, asignará el filtro al parámetro SearchExpr .

  • Cree una instancia de método Finder para el método Query. Un método Finder recupera una lista de registros basados en un filtro.

Para crear un filtro y asignarlo al parámetro SearchExpr

  1. Cree un filtro para el método Query.

    1. En el panel Objetos de metadatos, expanda el nodo Cuenta y, a continuación, expanda el nodo Métodos .

    2. Expanda el método Query, haga clic con el botón derecho en Filtrosy, a continuación, haga clic en Agregar filtro.

      Agregar filtro a un método

    3. En el panel Propiedades, escriba SearchExpression para el campo Nombre .

    4. En la propiedad FilterType , seleccione Equals.

      Especifique un nombre de filtro y escriba

  2. Asigne el filtro al parámetro SearchExpr en el método Query.

    1. En el panel Objetos de metadatos, expanda el nodo Cuenta y, a continuación, expanda el nodo Métodos .

    2. Expanda el método Query y, a continuación, expanda el nodo Parámetros .

    3. Expanda el nodo AccountQueryInputRecord y, a continuación, expanda el segundo nodo AccountQueryInputRecord .

    4. Haga clic en el nodo SearchExpr y, en el panel Propiedades, seleccione SearchExpression en la lista FilterDescriptor.

      Asignar un parámetro a un filtro

      Importante

      AccountQueryInputRecord también contiene un nodo QueryFields, que a su vez contiene un nodo Item. Debe eliminar el nodo Elemento ; de lo contrario, es posible que la operación Consulta en el componente de negocio Cuenta no proporcione los resultados deseados. Para eliminar el nodo Elemento , haga clic con el botón derecho en el nodo y seleccione Eliminar.

Para crear una instancia de método Finder para el método Query

  1. En el panel Objetos de metadatos, expanda el nodo Cuenta y, a continuación, expanda el nodo Métodos .

  2. Expanda el nodo Consulta , haga clic con el botón derecho en Instanciasy, a continuación, haga clic en Agregar instancia de método para abrir la ventana Crear instancia de método.

    Captura de pantalla que muestra cómo agregar una instancia de método Finder.

  3. En la ventana Crear instancia de método, haga clic en Finder para el tipo de instancia de método.

  4. Haga clic en Returnfrom Return TypeDescriptor section (Devolver tipodescriptor ).

    Captura de pantalla que muestra dónde ver la sección Return TypeDescriptor.

  5. Haga clic en OK.

  6. En el panel Propiedades, escriba QueryAccount para el campo Nombre .

    Especifique un nombre para la instancia de método

Quitar los parámetros del tipo System.Nullable

Los parámetros devueltos para la función Query pueden contener parámetros de tipo System.Nullable. Debido a la presencia de estos parámetros en la definición de la aplicación, es posible que reciba un error al presentar datos de Siebel en un portal de SharePoint. Por lo tanto, debe quitar los parámetros del tipo System.Nullable de la definición de la aplicación.

Además, para cada parámetro de tipo System.Nullable, el Editor de definiciones de Business Data Catalog crea otro parámetro del tipo System.Boolean y anexa "Especificado" al nombre del parámetro. Por ejemplo, el parámetro AccountRole es de tipo System.Nullable. Por lo tanto, el Editor de definiciones de Business Data Catalog agrega un parámetro AccountRoleSpecified a la lista de parámetros. También debe quitar estos parámetros.

Nota

Para ver el tipo de parámetro, seleccione el parámetro en el Editor de definiciones de Business Data Catalog y examine el valor de la propiedad TypeName en el panel Propiedades.

Nota

Puede omitir este paso si la aplicación no contiene ningún parámetro del tipo System.Nullable.

Para quitar los parámetros del tipo System.Nullable para el método Query

  1. En el panel Objetos de metadatos, expanda el nodo Cuenta y, a continuación, expanda el nodo Métodos .

  2. Expanda el nodo Consulta y, a continuación, expanda el nodo Parámetros .

  3. Expanda el nodo Return y, a continuación, expanda el segundo nodo Return .

  4. Haga clic con el botón derecho en el parámetro que desea eliminar y seleccione Eliminar.

  5. En el cuadro de diálogo, haz clic en Aceptar.

Exportar la definición de aplicación a un archivo

Ahora ha creado una definición de aplicación que contiene los metadatos de la instancia del sistema Siebel. Debe exportar esta definición a un archivo XML, que se puede importar en Microsoft Office SharePoint Server.

Para exportar la definición de la aplicación a un archivo

  1. Haga clic con el botón derecho en el nodo Siebel_Account en el panel Objetos de metadatos y, a continuación, haga clic en Exportar.

  2. Guarde el archivo como Siebel_Account.xml.

Modificar el archivo de definición de aplicación para incluir parámetros específicos

Como se mencionó anteriormente en este tema, la herramienta Editor de definiciones de Business Data Catalog no controla los tipos de datos enumerados. La herramienta Editor de definiciones de Business Data Catalog importa los campos hasta que encuentra un tipo de datos enumerado y omite los campos restantes. Por lo tanto, es posible que se omitan determinados campos que desee en la aplicación. Puede editar manualmente el archivo de definición de aplicación para incluir esos campos.

Nota

Debe asegurarse de que los parámetros que va a agregar están presentes en el archivo .cs generado por el Asistente para desarrollo del servicio de adaptador de WCF en el paso 1: Publicar las operaciones de componentes empresariales de Siebel como un servicio WCF.

En este archivo de definición de aplicación, agregará o quitará parámetros devueltos para el método QueryAccount .

Para modificar el archivo de definición de aplicación

  1. Abra el archivo de definición de aplicación, Siebel_Account.xml, mediante Visual Studio o cualquier otro editor.

  2. Modifique el archivo de definición de aplicación para reemplazar los parámetros del método QueryAccount .

    1. En el archivo de definición de aplicación, busque lo siguiente:

      <TypeDescriptor TypeName="BDC.AccountQueryRecord,Siebel_Account" Name="Item">

    2. Dentro de la <TypeDescriptors> etiqueta , reemplace los elementos existentes <TypeDescriptor> por lo siguiente:

      
<TypeDescriptor TypeName="System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=<token>" Name="Id" />
<TypeDescriptor TypeName="System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=<token>" Name="Country" />
<TypeDescriptor TypeName="System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=<token>" Name="Name" />
<TypeDescriptor TypeName="System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=<token>" Name="Location" />

    3. Guarde y cierre el archivo.

    Sugerencia

    Puede importar el archivo de definición de aplicación actualizado de nuevo en la herramienta Editor de definiciones de Business Data Catalog para ver los campos recién agregados. Sin embargo, antes de importar tendrá que quitar la aplicación "Siebel_Account" existente de la herramienta Editor de definiciones de Business Data Catalog.

Pasos siguientes

Ahora debe crear una aplicación de SharePoint para recuperar datos de un sistema Siebel. Vea Paso 3: Crear una aplicación de SharePoint para recuperar datos de Siebel para obtener instrucciones.

Consulte también

Tutorial 1: Presentación de datos de un sistema de Siebel en un sitio de SharePoint