Invocar a servicios de integración SQL

Para integrar con una base de datos externa, puede utilizar los servicios de integración SQL disponibles en el kit de herramientas de datos del sistema de IBM® BPM utilizando web Process Designer.

Antes de empezar

Su administrador de IBM BPM debería haber definido el origen de datos utilizando la consola administrativa.

Acerca de esta tarea

El kit de herramientas de datos del sistema incluye servicios de integración SQL para permitirle la fácil integración con datos externos.

Los servicios de integración SQL dan soporte a interacciones de base de datos comunes, lo que incluye soporte de consultas con parámetros. Estos servicios pueden correlacionar automáticamente los resultados de la consulta directamente con el tipo de variable relevante. Los servicios de integración SQL le permiten desarrollar implementaciones para:

  • Leer datos existentes de una base de datos.
  • Insertar nuevos datos en una base de datos.
  • Llamar a procedimientos almacenados en la base de datos.

Al pasar datos entre IBM BPM y una base de datos conectada, los servicios de integración SQL permiten especificar tipos de datos SQL, como por ejemplo enteros, BLOB y CLOB.

Importante: Los servicios del conector SQL en el kit de herramientas de datos del sistema no participan en la transacción del servicio o instancia de proceso circundante.

Los servicios de integración SQL son integraciones basadas en Java que se enlazan a un método específico de la clase Java teamworks.SQLConnector. Aunque no puede modificar los servicios de integración SQL, puede abrirlos en web Process Designer para ver el método implementado por cada uno de ellos y las variables de entrada y salida disponibles, tal como se describe en el procedimiento siguiente.

Procedimiento

  1. Abra web Process Designer.
  2. Abra una aplicación de proceso en la vista Designer.
  3. Pulse la categoría Kits de herramientas para ver una lista de dependencias del kit de herramientas para la aplicación de proceso actual.
  4. Pulse el kit de herramientas Datos del sistema para ver sus contenidos.
  5. Pulse la categoría Servicios y, después, pulse uno de los servicios SQL listados.
    • El servicio Sentencia de ejecución de SQL.
    • El servicio Sentencia de ejecución SQL (SQLResult) proporciona un derivador para el servicio Sentencia de ejecución SQL y devuelve los resultados en un tipo de retorno fijo, SQLResult.
  6. En el diagrama de servicio, seleccione el nodo Tarea de servicio.
  7. Pulse la opción Implementación en las propiedades para mostrar el Servicio externo Java y la operación que se invoca.
  8. Opcional: Puede abrir el servicio externo para ver la clase Java y los métodos que expone.
  9. Cambie desde la vista de diagrama del servicio pulsando la pestaña Variables.
  10. Pulse una variable de entrada o salida para ver sus detalles como, por ejemplo, su tipo y cualquier valor predeterminado.

    Para utilizar un servicio de integración SQL debe especificar las variables de entrada y salida que aparecen listadas en la tabla siguiente.

    Tabla 1. Parámetros de entrada y salida para los servicios de Sentencia de ejecución SQL
    Nombre Tipo Descripción
    sql Serie Este parámetro de entrada proporciona la sentencia SQL. Por ejemplo, si la variable tw.local.sqlSelectSatatement contiene la serie de sentencia SQL SELECT name, place FROM GREETING, especifique el nombre de variable tw.local.sqlSelectSatatement para el parámetro sql
    parameters Lista de SQLParameter Este parámetro de entrada describe el valor, el tipo y la información de modalidad para cada parámetro '?' que utilice en su serie SQL. Para cada parámetro, especifique un objeto SQLParameter con un SQLType, el valor del parámetro y un SQLParameterMode.

    Especifique los SQLType de acuerdo con los java.sql.Types de la especificación JDBC. SQLParameterMode puede ser IN, OUT o INOUT según se define en las especificaciones JDBC de java.sql.ParameterMetaData.
    maxRows Entero Este parámetro de entrada limita el número de filas que se devuelven.
    returnType Serie Este parámetro de entrada proporciona el nombre del tipo de datos de objeto de negocio en el que se devuelven los resultados. Si especifica SQLResult los resultados se transforman automáticamente en una lista de SQLResult, En ese caso, solo tiene que crear una variable de tipo SQLResult y marcarla como variable de lista.
    dataSourceName Serie Este parámetro de entrada es el nombre JNDI del origen de datos que el administrador de IBM BPM ha definido, por ejemplo "jdbc/greetdb".
    results ANY Este parámetro de salida contiene los resultados de la consulta. El objeto de resultados tiene el tipo que ha especificado como returnType.
Tema principal: Invocar un servicio Java