Compartir a través de

Usar el adaptador de base de datos de Oracle con SharePoint

  • Artículo

El Asistente para desarrollo de servicios de adaptador de WCF para Visual Studio permite que el adaptador de Microsoft BizTalk para la base de datos de Oracle y el adaptador de Microsoft BizTalk para Oracle E-Business Suite se consuman directamente como un origen de datos externo en Microsoft SharePoint. El Asistente para agregar desarrollo de servicios que admite esta característica se inicia con la plantilla Servicio de adaptador de WCF para crear un nuevo sitio web de Visual C# en Visual Studio. La plantilla se incluye con el paquete de adaptadores de BizTalk. También debe instalar el SDK del adaptador de línea de negocio (LOB) de Microsoft Windows Communication Foundation (WCF).

Compatibilidad con operaciones de SharePoint

El Asistente para desarrollo de servicios de adaptadores genera un contrato de servicio especial para los adaptadores de Oracle que son compatibles con Microsoft SharePoint. El asistente generará un contrato de servicio que incluye las siguientes operaciones para integrar el adaptador con Microsoft SharePoint:

  • Crear: Compatible con la operación de CreateItem_.

  • Leer: Compatible con la operación de ReadItem_.

  • Actualizar: Compatible con la operación de UpdateItem_.

  • Eliminar: Compatible con la operación de DeleteItem_.

  • Consulta: Compatible con la operación ReadList.

  • Asociado: Compatible con la operación de Associate_.

    El siguiente contrato de servicio se generó mediante para el adaptador de Microsoft BizTalk para oracle Database como ejemplo. El adaptador está configurado para proporcionar acceso a la tabla EMP.

    [System.ServiceModel.ServiceContractAttribute()]  
    public interface ISCOTT_EMP {  
  
    [System.ServiceModel.OperationContractAttribute()]  
    SCOTT_EMP_Record[] ReadList(System.Nullable<int> Limit);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    void CreateItem(SCOTT_EMP_Record Input);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    SCOTT_EMP_Record[] ReadItem_EMPNO(System.Nullable<decimal> EMPNO);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    void UpdateItem_EMPNO(SCOTT_EMP_Record Input);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    void DeleteItem_EMPNO(System.Nullable<decimal> EMPNO);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    SCOTT_EMP_Record[] Associate_DEPTNO(System.Nullable<decimal> DEPTNO);  
}

Crear un nuevo sitio web para hospedar la base de datos de Oracle en IIS

Estos pasos proporcionan un ejemplo mediante el Asistente para desarrollo de servicios de adaptador de WCF para crear un nuevo servicio web WCF que hospeda el adaptador de Microsoft BizTalk para la base de datos de Oracle. El contrato de servicio incluirá operaciones directamente compatibles con Sharepoint. Para que se pueda consumir directamente como un origen de datos externo. El adaptador está configurado para autenticarse con la base de datos de Oracle mediante la cuenta SCOTT . Si la cuenta SCOTT está bloqueada, puede desbloquearla iniciando sesión en SQL Plus como SYSDBA.

<Oracle Installation Bin Directory>\Sqlplus.exe SYS AS SYSDBA

Luego, ejecute el siguiente comando.

SQL> ALTER USER scott ACCOUNT UNLOCK;

Crear el nuevo proyecto de sitio web

  1. Abra Visual Studio.

  2. En Visual Studio, en el menú Archivo , seleccione Nuevo y, a continuación, haga clic en Proyecto.

  3. En el cuadro de diálogo Nuevo proyecto , expanda Otros lenguajes y haga clic en Visual C#. Busque el Servicio de adaptador de WCF en la lista de plantillas y haga clic en él para seleccionarlo.

    Nota

    La plantilla servicio de adaptador de WCF no está disponible si el paquete de adaptadores de BizTalk 2013 no está instalado. En los sistemas x64, instale las versiones x86 y x64 del Paquete de adaptadores de BizTalk 2013.

  4. Especifique ScottEMP como nombre y, a continuación, haga clic en Aceptar. Se inicia el Asistente para desarrollo del servicio adaptador de WCF .

  5. En la página Introducción, haga clic en Siguiente.

  6. En la página Elegir operaciones , especifique el enlace oracleDBBinding .

  7. Elija el botón Configurar . Se muestra el cuadro de diálogo Configurar adaptador .

  8. En la pestaña Seguridad , seleccione Nombre de usuario en el cuadro de lista desplegable Tipo de credencial de cliente.

  9. Escriba SCOTT como Nombre de usuario y escriba la contraseña correcta para la cuenta SCOTT. La contraseña predeterminada de la cuenta SCOTT es tiger.

  10. Haga clic en la pestaña Propiedades de URI , escriba la dirección IP o el nombre de host del servidor oracle en el cuadro ServidorAddress .

  11. Escriba el nombre correcto de la instancia del servicio de base de datos de Oracle en el cuadro ServiceName . Puede copiar la información del nombre de instancia de Oracle Enterprise Manager.

  12. Presione el botón Aceptar en el cuadro de diálogo Configurar adaptador.

  13. En la página Elegir operaciones del asistente, haga clic en el botón Conectar y espere unos instantes para que las categorías se creen para la base de datos de Oracle.

  14. Una vez agregadas las categorías en la lista Seleccionar una categoría , desplácese hacia abajo hasta SCOTT y expándala. A continuación, expanda Tabla y haga clic en la entrada de tabla EMP .

  15. En la lista Categorías y operaciones disponibles , seleccione todas las operaciones de la lista y haga clic en el botón Agregar . Todas las operaciones se agregan a la lista Categorías y operaciones agregadas .

  16. En la página Elegir operaciones , haga clic en el botón Siguiente .

  17. En la página Configurar comportamientos de servicio y punto de conexión , establezca el comportamiento del servicio UseServiceCertificate en false para este ejemplo. A continuación, haga clic en el botón Siguiente .

  18. En la página Configurar enlace de punto de conexión de servicio y dirección , haga clic en el botón Aplicar . A continuación, haga clic en el botón Siguiente .

  19. En la página Resumen , haga clic en el botón Finalizar .

  20. Haga clic en la opción de menú Compilar y, a continuación, haga clic en Compilar solución. Compruebe que la compilación del proyecto se realizó correctamente sin errores.

Publicación del nuevo servicio en IIS

En este ejemplo, publicará el servicio host del adaptador en el servidor web IIS local.

  1. En Explorador de soluciones para Visual Studio, haga clic con el botón derecho en el proyecto ScottEmp y haga clic en Propiedades. Se muestran las pestañas de project Designer.

  2. Haga clic en la pestaña Web y, a continuación, haga clic en la opción Usar servidor web IIS local .

  3. Haga clic en el botón Crear directorio virtual.

  4. Abra un explorador web en la dirección http://localhost/ScottEmp/ISCOTT_EMP.svcdel servicio . Debe recibir un mensaje que indica "Ha creado un servicio" que indica que el adaptador está hospedado en IIS.

Agregar el origen de datos externo a un sitio de SharePoint mediante SharePoint Designer

En esta sección se describe cómo agregar el servicio WCF como origen de datos externo a un nuevo sitio web mediante SharePoint Designer.

  1. Abra sharePoint Designer y cree un nuevo sitio web.

  2. En SharePoint Designer, expanda Navegación y haga clic en Tipos de contenido externo en la lista Objetos de sitio.

  3. Haga clic en el botón de menú Tipo de contenido externo para crear un nuevo tipo de contenido externo.

  4. Haga clic en el texto situado junto a Nombre para editar el nombre del nuevo tipo de contenido externo. Escriba OracleEMP como nombre.

  5. Haga clic en el vínculo de texto situado junto a Sistema externo, que dice Haga clic aquí para detectar orígenes de datos externos y operaciones. Se abrirá la Designer operación para el tipo de contenido externo OracleEMP.

  6. Haga clic en el botón Agregar conexión en la pantalla de detección.

  7. En el cuadro de diálogo Selección de tipo de origen de datos externo, elija Servicio WCF y haga clic en el botón Aceptar .

  8. En el cuadro de diálogo Conexión WCF, en el cuadro Dirección URL de metadatos del servicio , escriba https://localhost/ScottEmp/ISCOTT_EMP.svc?wsdl

  9. En el cuadro Service Endpoint URL (Dirección URL del punto de conexión de servicio ), escriba https://localhost/ScottEmp/ISCOTT_EMP.svc

  10. Haga clic en el botón Aceptar para cerrar el cuadro de diálogo Conexión WCF.

  11. Una vez rellenada la información del origen de datos, expanda el https://localhost/ScottEmp/ISCOTT_EMP.svc origen de datos y expanda Métodos web.

  12. Haga clic con el botón derecho en el método web ReadList y haga clic en Nueva operación de lista de lectura. Se inicia el cuadro de diálogo de configuración Leer lista.

  13. En el cuadro de diálogo Leer lista, haga clic en Devolver parámetros y haga clic en EMPNO en los elementos del origen de datos. Haga clic en map to identifier (Asignar a identificador).

  14. Haga clic en Finalizar en el cuadro de diálogo Leer lista.

  15. Para guardar el nuevo origen de datos externo, escriba Ctrl+s.

Probar la conexión del origen de datos externo

  1. En el nuevo sitio web, haga clic en el botón Crear listas y formularios . Aparece el cuadro de diálogo Crear lista y formulario para OracleEMP.

  2. Escriba OracleEMP_List en Nombre de lista y haga clic en el botón Aceptar .

  3. Una vez creada la lista, haga clic en el botón Vista de resumen del menú.

  4. Haga clic en OracleEMP_List en Listas externas.

  5. Haga clic en el botón Vista previa del explorador del menú para probar la operación ReadList del adaptador.

Solución de problemas

  • En las máquinas de 64 bits, debe asegurarse de que los componentes de cliente de Oracle de 32 bits también están instalados. Esto se debe a que Visual Studio y los asistentes se ejecutarán como un proceso de 32 bits que requiere acceso a componentes de 32 bits durante el desarrollo.