Condulta de documentos de Domino

La actividad Consultar documento se utiliza para consultar documentos de la base de datos del servidor de Lotus® Domino® que coincidan con los valores especificados en los campos del documento.

Puede especificar uno o más de los siguientes criterios en los datos de entrada enviados en la solicitud saliente.
  • Datos de negocio del documento: cuando se especifican los datos de negocio del documento en la sección Entrada de correlación, el conector lee todos los datos válidos de la entrada de correlación. El conector busca en la base de datos los documentos que coinciden con estos datos válidos. En la respuesta se devuelven todos los documentos coincidentes que pueden representarse utilizando el esquema de salidas de correlación.
  • ParentDocumentUNID: cuando se especifica un ParentDocumentUNID válido en la sección Correlacionar entrada, el conector consultará todos los documentos hijo de este documento padre. En la respuesta se devuelven todos los documentos coincidentes que pueden representarse utilizando el esquema de correlación de salida.
  • No hay datos establecidos: Cuando no se proporciona un dato en la entrada de correlación, el conector consulta los documentos que se pueden representar utilizando el esquema de salida de correlación.
También se pueden buscar documentos mediante dos métodos de búsqueda:
  1. Método de búsqueda en base de datos: Dados una criterios de selección para un documento, devuelve todos los documentos de una base de datos que cumplen los criterios. De forma predeterminada, la actividad utiliza el método de búsqueda en base de datos para buscar documentos. Para establecer explícitamente la búsqueda en este tipo, establezca el valor del parámetro opcional searchType en NORMAL_SEARCH en la sección de entrada de correlación. Este método soporta la búsqueda de documentos basándose en los siguientes tipos de criterios de búsqueda:
    1. Valores únicos: Puede especificar un único valor en los criterios de búsqueda. Por ejemplo, el conector puede consultar documentos basándose en una único número, palabra o fecha especificados en el campo de búsqueda. Puede obtener más información sobre los valores de búsqueda que se pueden especificar en los campos de tipo de fecha y número en los siguientes puntos.
      • Números: Puede especificar un número de doble dígito o un valor entero como criterio de búsqueda en el campo Tipo de número. Puede utilizar esta función de búsqueda para consultar los documentos en los que un campo Tipo de número es igual a un determinado valor. Por ejemplo, para consultar documentos en los que el sueldo del empleado sea igual a 1234,56, especifique el valor 1234,56 en el campo EmployeeSalary.
      • Fecha: Puede especificar una fecha como el criterio de búsqueda en cualquier campo Tipo de fecha. Por ejemplo, para consultar documentos en los que el día de cumpleaños sea igual a 1982/11/22, se especifica el valor 1982/11/22 en el campo Cumpleaños.
    2. Valores múltiples: Puede especificar varios valores como criterio de búsqueda en cualquier tipo de campo de Lotus Domino. Esta característica puede utilizarse para buscar documentos con los valores especificados durante el tiempo de ejecución. Por ejemplo, puede configurar el conector para recuperar documentos que coincidan con las palabras especificadas en los criterios de búsqueda.
    3. Búsqueda textual de contenido de texto enriquecido: Puede especificarse en tiempo de ejecución el texto para buscar documentos que tienen contenido en texto enriquecido. El conector realiza una búsqueda utilizando el texto especificado en el campo RichText y recupera todos los documentos coincidentes. El conector soporta búsquedas de contenido textual tanto únicas como múltiples en el campo RichText. También pueden proporcionarse sufijos comodín como, por ejemplo, *, para buscar documentos en el campo RichText.
    4. Búsqueda utilizando varios campos: Puede especificar valores de búsqueda en más de un campo. En esta configuración, la actividad utiliza el operador lógico AND para agrupar las cadenas de búsqueda. Por ejemplo, se puede especificar un único valor, varios valores, RichText o ParentDocumentUNID en diferentes campos. La actividad devuelve sólo el contenido de búsqueda que coincide con todos los criterios especificados.

  2. Método de búsqueda indexada/búsqueda de texto completo en base de datos: Realiza una búsqueda de texto completo de todos los documentos de una base de datos. Cuando la base de datos está completamente indexada, el método de búsqueda indexado es más rápido que el método de búsqueda en base de datos. El método ordena los datos de salida por índice de frecuencia. Cuando la colección se ordenan por frecuencia, la frecuencia más alta aparece primero. Para establecer explícitamente la búsqueda en este tipo, establezca el valor del parámetro opcional searchType en FULL_TEXT_SEARCH en la sección de entrada de correlación.
    1. Búsqueda utilizando varios campos: El método indexado también da soporte a la búsqueda utilizando varios campos. Puede especificar los valores de búsqueda en más de un campo. En esta configuración, el conector utiliza el operador lógico AND para agrupar las cadenas de búsqueda. Por ejemplo, puede especificar un único valor, varios valores o ParentDocumentUNID en distintos campos. El conector devuelve una operación lógica AND de todos los criterios de búsqueda especificados, devolviendo coincidencias exactas y casi exactas de los campos de tipo cadena y coincidencias exactas de los campos de tipo numérico.
    Nota: El método de búsqueda indexado no funciona para los campos RichText, Attachments y Date.
Utilización de la actividad Consultar documento
  1. Pulse con el botón derecho del ratón sobre Orquestación en el panel Proyecto y seleccione Nueva orquestación para crear o abrir una orquestación. Se mostrará el panel de la orquestación.
  2. Seleccione el separador Actividades y expanda la carpeta Domino.
  3. Arrastre Consultar actividad desde la carpeta Domino a la orquestación. Se mostrará una representación gráfica de la orquestación junto con la Lista de comprobación.
  4. Pulse Elegir punto finaly, a continuación, seleccione el punto final de Domino.

    Para obtener instrucciones sobre cómo crear o editar un punto final de Domino, consulte Creación o edición de un punto final para una actividad de Domino.

  5. Pulse Configurar en la lista de comprobación. Se mostrará el panel Configurar.
    • Pulse Examinar para seleccionar una base de datos existente en el panel Examinar bases de datos de Domino. El panel Examinar bases de datos de Domino muestra todas las bases de datos del punto final seleccionado.
    • Pulse Siguiente para seleccionar un formulario existente en el panel Examinar bases de datos de Domino. El panel Examinar bases de datos de Domino muestra todos los formularios presentes en la base de datos seleccionada del servidor de Domino.
      Nota: El botón Siguiente solo se activa una vez seleccionado el nombre de la base de datos.
    • Campos con nombres canónicos acepta campos que pueden tener valores de nombres canónicos como, por ejemplo, John Smith/IBM/COUNTRY, separados por coma. Especifique nombres canónicos en este campo si desea convertir los valores de estos campos a direcciones de correo electrónico de internet como, por ejemplo, johnsmith@country.ibm.com. Algunos ejemplos de nombre de campo son Para, De, CC, Presidente, Asistentes obligatorios, etc.

  6. Seleccione las Entradas de correlación en la lista de comprobación. Los esquemas XML generados a partir del objeto seleccionado de la actividad Consultar documentos se muestran como nodos bajo el parámetro de entrada de la solicitud en el panel A actividad.

    En el caso de los tipos de formulario que coincidan en varias bases de datos, podrá especificarse el nombre de la base de datos como parte de los parámetros opcionales en la correlación de entradas, donde la misma orquestación se puede utilizar para realizar operaciones de salida en diferentes bases de datos. Para ello deberá especificarse el nombre de base de datos en el parámetro opcional databaseName (descrito en la tabla 1). Si el parámetro databaseName se rellena con un valor, la operación de salida se realizará en la base de datos especificada en el parámetro databaseName. Si no se especifica ningún valor, se utilizará el nombre de base de datos especificado durante la configuración para realizar la operación de salida.

    El parámetro de entrada opcional se describe en la tabla siguiente:

    Tabla 1. Parámetro de entrada opcional
    Nombre del parámetro Descripción
    databaseName databaseName es el nombre de la base de datos en la que se consulta el documento. Si se establece un valor para este parámetro, se sustituirá el valor de la base de datos especificado en el panel de configuración. Este parámetro es útil cuando hay que consultar documentos con la misma estructura (formulario) en varias bases de datos utilizando la misma orquestación.
    El conector de Domino también soporta conexión de punto final dinámica a un servidor de Domino distinto. En tiempo de ejecución, si desea conectar dinámicamente a un servidor Domino distinto del configurado en la página de punto final, añada los nuevos parámetros opcionales en las dominoConnectionProperties de las correlaciones de entrada. Los parámetros de dominoConnectionProperties se describen en la tabla siguiente:
    Tabla 2. Parámetros de conexión opcionales
    Parámetros Descripción
    Parámetros de dominoConnectionProperties
    hostName Especifica el nombre de host o la dirección IP de la máquina en la que se ejecuta el servidor Domino.
    diiopPort Especifica el puerto del protocolo Inter-ORB de Internet de Domino (DIIOP) que permite a las aplicaciones o applets Java™ acceder de forma remota a los datos de Domino utilizando CORBA. El valor predeterminado es 63148.
    username Especifica el nombre de usuario para conectarse con el servidor Domino.
    Parámetros de connectionPool
    minimumConnections Especifica el número mínimo de conexiones de servidor Domino que el Dispositivo de integración mantiene abiertas en la agrupación de conexiones. Se admite la introducción de 0 (cero). El valor predeterminado es 5.
    maximumConnections Especifica el número máximo de conexiones de servidor Domino que el Dispositivo de integración puede mantener abiertas en la agrupación de conexiones. La introducción de un 0 (cero) significa que el número máximo de conexiones es ilimitado. El valor predeterminado es 25.
    maxIdleTime Especifica la cantidad de tiempo en minutos que una conexión de servidor Domino puede estar abierta y en estado inactivo antes de que el Dispositivo de integración la cierre. La introducción de un 0 (cero) significa que las conexiones se cerrarán cuando se devuelvan a la agrupación (sin tiempo de inactividad). El valor predeterminado es 120 minutos.
    maxWait Especifica la cantidad de tiempo en segundos que el Dispositivo de integración espera a una conexión cuando se han terminado todas las conexiones de la agrupación. Si tras el tiempo de espera no se obtiene ninguna conexión, se emite una excepción. El valor predeterminado es 300 segundos.
    reclaimConnections Especifica el intervalo en el que el conector comprueba las conexiones desocupadas. Las conexiones desocupadas son reclamadas hasta que se alcanza el número mínimo de conexiones, tal como se especifica en el parámetro Mínimo de conexiones. El valor predeterminado es 5 minutos.
    password Especifica la contraseña asociada al nombre de usuario para conectarse al servidor Domino.
  7. Cree una correlación entre las variables de orquestación y el parámetro de entrada de la actividad.
    Nota: Los valores deben proporcionarse durante el tiempo de ejecución para todos los elementos obligatorios de la estructura de entrada. Se puede indicar un valor especificando un valor predeterminado para el elemento o enlazando el elemento con un nodo de entrada. Durante el tiempo de ejecución, si no se suministra ningún valor para un elemento obligatorio, la actividad lanza una excepción que es notificada por la consola de gestión web (WMC). Si no se proporciona un valor en tiempo de ejecución para un parámetro opcional de entrada, no se lanza ninguna excepción durante el tiempo de ejecución.
  8. Seleccione el tipo de búsqueda que se utilizará para la actividad:
    Tabla 3. Tipo de búsqueda
    Nombre de parámetro Descripción
    searchType Especifica el tipo de búsqueda que se utilizará para esta actividad. Los valores son:
    • NORMAL_SEARCH: Utiliza el método de búsqueda de la base de datos de Domino.
    • FULL_TEXT_SEARCH: Utiliza el método de búsqueda de texto completo en base de datos de Domino.
    Cuando no se especifica ningún valor, se utiliza NORMAL_SEARCH.
  9. Seleccione las Salidas de correlación en la lista de comprobación. Los esquemas XML generados para contener la respuesta de la actividad se muestran como nodos bajo el parámetro de salida en el panel Desde actividad.

    Nota: El conector de Domino maneja los campos añadidos dinámicamente que están presentes en el documento de Domino y que no se han generado en las estructuras de correlación de entrada/salida. Mientras se recuperan los documentos mediante esta actividad, los datos de estos campos están disponibles en la sección correlacionar salidas bajo AdditionalFields.

    queryUsingTimestamp es el parámetro que se utiliza para consultar documentos basados en indicaciones de fecha y hora. La propiedad timestamp es una propiedad recursiva. Pueden definirse groupFields, name, operator y value bajo la propiedad timestamp.

    Los parámetros de salida opcionales se describen en la tabla siguiente:

    Nombre de parámetro Descripción
    queryUsingTimestamp
    A continuación se muestran las propiedades de timestamp:
    Tabla 4. Propiedades de timestamp
    Propiedad de valores
    groupFields Pueden especificarse múltiples valores: AND, OR, (,), AND(, OR(, )AND, )OR, )AND(, y )OR(.
    Nota: Pueden tenerse varias condiciones. groupFields debe utilizarse cuando se tienen varias condiciones.
    name Especifique uno de los valores siguientes: createdTimestamp or lastModifiedTimestamp
    operator Especifique uno de los valores siguientes: GREATER_THAN (mayor que), GREATER_THAN_OR_EQUAL_TO (mayor o igual que), EQUAL_TO (igual a), LESS_THAN (menor que), LESS_THAN_OR_EQUAL_TO (menor o igual que) y NOT_EQUAL_TO (no igual a)
    value Especifica los valores de fecha y hora. Por ejemplo, 26-09-2013 12:05:00 PM EST.
    Nota: Si no se indica el huso horario, se utilizará el huso horario del servidor de forma predeterminada.

    Nota:
    • No se soporta la consulta de documentos basada en el operador NOT_EQUAL_TO (!=) en búsquedas de texto completo.
    • La consulta de documentos utilizando la hora no está soportada en las búsquedas de texto completo. Por ejemplo, [_RevisionDate] = 05/06/2013 09:30:00.
    • La consulta de documentos utilizando el operador EQUAL_TO con indicación de fecha y hora no funciona con el tipo de búsqueda normal. Por ejemplo, @Modified = [05/06/2013 09:14:22].
    • Cuando se consultan documentos en búsquedas de tipo de texto completo, solo pueden consultarse documentos basados en Date (fecha), pero no en DateTime (fecha y hora). Por ejemplo, lastModfiedDateTime >= 05/20/2013 20:00:00 no está soportada en las búsquedas de texto completo.
  10. Cree una correlación entre los parámetros de salida y las variables de orquestación.
Ha configurado la actividad Consultar documentos de Domino.



Comentarios | Notices


Icono de fecha y hora Última actualización: Friday, November 8, 2013


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/Domino_query_outactivity.html