Compartir a través de


Paso 2: Creación de un archivo de definición de aplicación para los artefactos de Oracle E-Business Suite

Paso 2 de 4

Tiempo de finalización: 15 minutos

Objetivo: La característica Catálogo de datos profesionales de Microsoft SharePoint Server 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 del catálogo de datos profesionales, disponible con el SDK de Microsoft Office SharePoint Server 2007, le permite crear un archivo de definición de aplicación para el Catálogo de datos profesionales. Esta herramienta genera automáticamente un archivo XML para el archivo de definición, por lo que 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 consulta para un empleado en la tabla de interfaz MS_SAMPLE_EMPLOYEE mediante un Elemento Web Business Data List usando el nombre del empleado.

  • Realice una búsqueda de texto completo de Microsoft Office SharePoint Server en la tabla de interfaz de MS_SAMPLE_EMPLOYEE.

    Para cada uno de estos requerimientos, debe completar un conjunto de tareas en la herramienta Editor de definiciones del catálogo de datos empresariales. En este tema se proporcionan instrucciones sobre cómo realizar estas tareas.

Prerrequisitos

Conexión al servicio LOB de WCF y creación de una entidad

Debe conectarse al servicio WCF para extraer el lenguaje de descripción de servicios web (WSDL) para el servicio. Del WSDL, el Editor de Definiciones del Catálogo de Datos Empresariales extrae los métodos. Estos métodos se pueden usar para crear entidades. En este tutorial, se crea una entidad.

Para conectarse al servicio WCF y crear entidades

  1. Inicie el Editor de definición del Catálogo de Datos Empresariales. En el menú Inicio , haga clic en Editor de definición del catálogo de datos profesionales de Microsoft.

  2. En la barra de herramientas, 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. En este tutorial, la dirección URL será:

    https://<COMPUTER_NAME>:<PORT_NUMBER>/MS_SAMPLE_EMPLOYEE/InterfaceTables_FND_APPS_MS_SAMPLE_EMPLOYEE.svc
    

    La dirección URL está disponible cuando se prueba si el servicio WCF se publica correctamente, como se describe en Paso 1: Usar el adaptador de oracle E-Business para crear y publicar un servicio WCF.

  5. Haga clic en Conectar.

  6. Para ver las operaciones seleccionadas en el Asistente para desarrollo de servicios de adaptador de WCF, haga clic en la pestaña Agregar método web . Verá el siguiente método: Seleccione.

  7. Arrastre los métodos Select a la superficie de diseño. A medida que arrastras el método a la Superficie de diseño, se crea una entidad y el método se convierte en parte de esa entidad.

    Agregar el método Select a la Superficie de Diseño

  8. Haz clic en Aceptar.

  9. 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, llámelo MS_SAMPLE_EMPLOYEE y, a continuación, haga clic en Aceptar.

  10. En el Editor de definiciones del Catálogo de datos profesionales, la entidad recién creada aparece como Entity0. Cambie el nombre de la entidad a Employee. Realice los pasos siguientes para cambiar el nombre de la entidad:

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

    2. Seleccione el nodo Entity0 .

    3. En el panel Propiedades, escriba Empleado en el cuadro Nombre .

      Cambiar el nombre de la entidad

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

Al crear un servicio WCF para la operación Select en la tabla de interfaz MS_SAMPLE_EMPLOYEE de Oracle E-Business Suite, especificó las cabeceras de usuario y contraseña como parte de la configuración del comportamiento del punto de conexión en Paso 1: Utilizar el adaptador de Oracle E-Business para crear y publicar un servicio WCF. Debe especificar los mismos valores para la propiedad del método Select.

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

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

  2. Haga clic en el nodo Seleccionar y, en el panel de propiedades, haga clic en el botón de puntos suspensivos (...) en el cuadro de propiedades.

  3. En la ventana Editor de colección PropertyView, haga clic en Agregar y, en el panel Propiedad, escriba HttpHeaderUserName para el cuadro Nombre . Escriba MyUserHeader para el cuadro PropertyValue . Seleccione System.String en el cuadro Tipo .

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

    Agregar una propiedad

  5. Haz clic en Aceptar.

Escenario 1: Consulta de empleados mediante un Elemento Web de Lista de Datos Empresariales

Para crear un archivo de definición de una aplicación que se pueda utilizar para buscar empleados a partir de una Parte Web de lista de datos empresariales, teniendo en cuenta el nombre del empleado, debe realizar el siguiente conjunto de tareas.

  1. En el método Select , cree un filtro y asígnelo al parámetro FILTER .

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

Para crear un filtro y asignarlo al parámetro FILTER

  1. Cree un filtro.

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

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

      Agregar un filtro al método SELECT

    3. En el panel Propiedades, para la propiedad FilterType , seleccione Equals.

    4. En el panel Propiedades, escriba EmployeeName en el cuadro Nombre .

      Especificar propiedades de filtro

  2. Asigne el filtro al parámetro FILTER en el método Select .

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

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

    3. Expanda el nodo FILTER y haga clic en el segundo nodo FILTER .

    4. En el panel Propiedades, seleccione EmployeeName en la lista FilterDescriptor .

      Asigne el filtro al parámetro Select method

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

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

  2. Expanda el nodo Seleccionar, haga clic con el botón derecho en Instancias, a continuación, haga clic en Agregar instancia de método.

    Adición de una instancia de método

  3. En la ventana Crear instancia de método, haga clic en Finder para Tipo de instancia de método. Seleccione Devolver para TipoDeRetornoDescriptor.

    Creación de una instancia de método Finder

  4. Haz clic en Aceptar.

  5. En el panel Propiedades, escriba Finder_Instance en el cuadro Nombre .

    Especificar un nombre para la instancia del método Finder

Escenario 2: Full-Text Buscar en la tabla de interfaz MS_SAMPLE_EMPLOYEE desde Microsoft Office SharePoint Server

Para crear un archivo de definición de aplicación que se pueda usar para realizar una búsqueda de texto completo en MS_SAMPLE_EMPLOYEE tabla de interfaz de Microsoft Office SharePoint Server, debe realizar el siguiente conjunto de tareas.

  • En el método Select , cree un identificador y asígnelo al parámetro FILTER y el valor devuelto que almacena el nombre del empleado.

  • Cree una instancia de método Finder específico para select. El método Specific Finder encontrará un registro específico basado en el identificador, es decir, un nombre de empleado.

  • Cree una instancia de método de enumerador de identificador.

Para crear un identificador y asignarlo al parámetro FILTER y al valor devuelto del nombre del empleado

  1. Cree un identificador para la entidad Employee .

    1. En el panel Objetos de metadatos, expanda el nodo Empleado .

    2. Haga clic con el botón derecho en el nodo Identificadores y seleccione Agregar identificador.

      Creación de un identificador

    3. En el panel Propiedades, escriba EmployeeName en el cuadro Nombre .

    4. Seleccione System.String en el cuadro Tipo .

      Especificar las propiedades del identificador

  2. Asigne el identificador al parámetro FILTER para el método Select .

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

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

    3. Expanda el parámetro FILTER y, a continuación, haga clic en el segundo nodo FILTER .

    4. En el panel Propiedades, seleccione EmployeeName[Employee] en la lista Identificador .

      Establecimiento del identificador del parámetro FILTER

  3. Asocia el identificador con el valor devuelto del nombre del empleado.

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

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

    3. Expanda el nodo Devolver y, a continuación, el segundo nodo Devolver , el nodo Elemento y, a continuación, haga clic en el nodo Nombre .

    4. En el panel Propiedades, seleccione EmployeeName[Employee] en la lista Identificador .

Para crear una instancia de método Finder específico para el método Select

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

  2. Expanda el nodo Seleccionar , haga clic con el botón derecho en Instancias y seleccione Agregar instancia de método para abrir la ventana Crear instancia de método.

    Adición de una instancia de método

  3. En la ventana Crear instancia de método, seleccione Finder específico para Tipo de instancia de método. Seleccione Return para TipoDescriptor de Retorno.

    Adición de una instancia de método Finder específico

  4. Haz clic en Aceptar.

  5. En el panel Propiedades, escriba SpeciFinder_Instance para el cuadro Nombre .

Para crear una instancia de método Id Enumerator para el método Select

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

  2. Expanda el nodo Seleccionar , haga clic con el botón derecho en Instancias y seleccione Agregar instancia de método para abrir la ventana Crear instancia de método.

    Adición de una instancia de método

  3. En la ventana Crear instancia de método, seleccione Enumerador de identificadores para Tipo de instancia de método. Seleccione Retorno para Return TypeDescriptor.

    Creación de una instancia del método Id Enumerator

  4. Haz clic en Aceptar.

  5. En el panel Propiedades, escriba IDEnumerator_Instance para el cuadro Nombre .

Establecer parámetros predeterminados para las instancias de método

El método Select requiere que especifique los nombres de columna. Por lo tanto, debe especificar un valor predeterminado para el parámetro COLUMN_NAMES para las instancias del método Finder, Specific Finder e Id Enumerator creadas anteriormente. Además, también debe especificar un valor predeterminado para el parámetro FILTER para la instancia del método Id Enumerator.

Para establecer los parámetros predeterminados para las instancias de método

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

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

  3. Expanda el nodo COLUMN_NAMES y, a continuación, seleccione el parámetro COLUMN_NAMES .

  4. En el panel de propiedades, haga clic en el botón de elipsis (…) en el cuadro DefaultValues.

  5. En el cuadro de diálogo Editor de colección DefaultValueView, haga clic en Agregar y, en el panel de propiedades, haga clic en Finder_Instance en la lista SelectMethodInstance.

    Especificación del valor predeterminado para la instancia de Finder

  6. Escriba * en el cuadro Valor .

  7. Del mismo modo, repita los pasos 5 y 6 para agregar valores predeterminados para las instancias de método SpecificFinder_Instance y IDEnumerator_Instance .

  8. En el cuadro de diálogo Editor de colección DefaultValueView, haga clic en Aceptar.

  9. A continuación, agregue un valor predeterminado para el parámetro FILTER para la instancia del método IDEnumerator_Instance . Expanda el nodo FILTER y, a continuación, seleccione el parámetro FILTER .

  10. En el panel de Propiedades, haga clic en el botón de puntos suspensivos (…) junto al cuadro DefaultValues.

  11. En el cuadro de diálogo Editor de colección DefaultValueView, haga clic en Agregar y, en el panel de propiedades, haga clic en IDEnumerator_Instance en la lista SeleccionarMétodoInstancia.

  12. Escriba % en el cuadro Valor .

    Valores predeterminados para la instancia del enumerador de ID

  13. En el cuadro de diálogo DefaultValueView Collection Editor, haga clic en Aceptar.

Configurar un único Sign-On para conectarse a Oracle E-Business Suite

Una vez que haya terminado de realizar todos los procedimientos de este tema, habrá creado un archivo de definición de aplicación que se puede importar en una aplicación de SharePoint. Desde la aplicación, se invocan los métodos para recuperar datos relevantes de Oracle E-Business Suite. Para habilitarlo, debe crear una asignación entre un usuario de Oracle E-Business Suite y el usuario de la aplicación de SharePoint. Puede crear esta asignación en la consola de Administración central de SharePoint después de haber importado el archivo de definición de aplicación.

Sin embargo, para crear la asignación, debe establecer una propiedad SecondarySsoApplicationId en el Editor de Definiciones del Catálogo de Datos Empresariales.

Para establecer la propiedad SecondarySsoApplicationId

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

  2. Haga clic en MS_SAMPLE_EMPLOYEE_Instance y, en el panel de Propiedades, haga clic en el botón de puntos suspensivos (…) junto al cuadro de Propiedades.

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

    Adición de la propiedad SSO

  4. 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 metadatos de instancia de Oracle E-Business Suite. 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. En el panel Objetos de metadatos, haga clic con el botón derecho en el nodo MS_SAMPLE_EMPLOYEE y, a continuación, haga clic en Exportar.

  2. Guarde el archivo como Employee.xml.

Pasos siguientes

Ahora debe crear una aplicación de SharePoint para recuperar datos de Oracle E-Business Suite. Para obtener instrucciones, vea Paso 3: Crear una aplicación de SharePoint para recuperar datos de Oracle E-Business Suite.

Véase también

Tutorial: Presentar datos de Oracle E-Business Suite en un sitio de SharePoint