Configuración de la actividad Consultar objetos

Debe crear una consulta SForce Object Search Language (SOSL) para configurar la actividad Buscar objetos. Las siguientes secciones se explican los pasos para configurar la actividad Buscar objetos , crear una consulta SOSL y suministrar reglas de sintaxis SOSL para IBM® Cast Iron.

Procedimiento

  1. En la Lista de comprobación, seleccione Configurar.

    Se abrirá la ventana Especificar consulta.

  2. Cree una consulta SOSL en la ventana Especificar consulta.
  3. (Opcional) Puede especificar parámetros dinámicos en la cláusula de búsqueda de la sentencia SOSL. A continuación, puede correlacionar estos parámetros dinámicamente como los parámetros de entrada de la actividad, lo que permitirá a esta controlar de forma dinámica la consulta en base a la entrada de la orquestación. Utilice el símbolo del dólar ($) para denotar un parámetro, seguido del nombre del parámetro.
  4. Pulse el icono Validar , para validar la consulta.
    Si la consulta no es válida, el icono Comentarios de validación se mostrará en la esquina inferior izquierda de la ventana Especificar consulta. En el caso de las consultas no válidas:
    1. Pulse el icono Comentarios de validación en la esquina inferior izquierda de la ventana Especificar consulta para obtener una lista de errores de validación.
    2. Utilice el icono Renovar para renovar los metadatos y volver a validar la cláusula SOSL.
  5. En la Lista de comprobación, seleccione Consultar para configurar opciones de consulta determinadas.

    Se abrirá el panel Opciones de consulta.

  6. Seleccione Incluir elementos suprimidos en la consulta (ejecutar una operación queryAll), para consultar los registros eliminados además de los existentes. Si no selecciona esta opción, el Dispositivo de integración sólo consultará los registros existentes.
  7. Especifique un Tamaño de lote de consulta entre 200 y 2.000 consultas para contribuir a afinar el rendimiento del Dispositivo de integración.

    Esta opción determina el tamaño de lote que se utilizará en la cabecera QueryOptions SOAP para todas las llamadas de consulta y no afecta al número de resultados devueltos por la actividad. Esta opción está establecida de forma predeterminada en 500 consultas.

Creación de consultas SOSL

Al crear una consulta SOQL, puede utilizar parámetros dinámicos en la cláusula WHERE de la sentencia SOQL. Studio puede, a continuación, correlacionar estos parámetros dinámicamente como los parámetros de entrada de la actividad. Esto permite tener un control dinámico de la consulta en base a la entrada de la orquestación.

About this task

El lenguaje de búsqueda SForce Object Query Language no define una sintaxis para las consultas parametrizadas; sin embargo, Cast Iron sí impone algunas reglas de sintaxis SOQL de propietario. Puede utilizar parámetros en las expresiones simples o en las complejas.

Reglas de sintaxis SOSL para Cast Iron
  • Utilice el símbolo del dólar ($) para denotar un parámetro. Detrás del signo del dólar ($), especifique una serie de caracteres alfanuméricos. El primer carácter debe ser una letra [a-zA-Z], seguida opcionalmente de una o varias letras [a-zA-Z], dígitos [0-9], o ( _ ) guiones bajos.
    Note: Los nombres de parámetros distinguen entre mayúsculas y minúsculas; por lo tanto, los parámetros $a y $A se consideran parámetros diferentes.
    La tabla siguiente contiene ejemplos de declaraciones de parámetro válidas y no válidas:
    Parámetro Válido o no válido
    $AnAccount válido
    $a123_456 válido
    $123a no válido
    $_id no válido
  • Debe declarar los parámetros en el lado derecho de una expresión en una cláusula WHERE.
  • Los parámetros pueden aparecer más de una vez en una sentencia SOQL dada. Sin embargo, aunque el parámetro aparezca más de una vez en la sentencia SOQL, solo se incluirá una vez en la correlación de parámetros de entrada. La actividad sustituirá con el mismo valor todas las ubicaciones en las que se utilice el parámetro en tiempo de ejecución.
    Note: Si utiliza el mismo nombre de parámetro y existe una no coincidencia de tipo, se producirá un error. Por ejemplo, el siguiente SOQL genera un error porque $param se utiliza como serie y como tipo de fecha:

    SELECT Name from Account where Name like $param and createdDate > $param

  • El tipo de campo en el que se compara el parámetro determina su tipo y si el parámetro se utilizará en una expresión simple, una expresión compleja o como parte de una expresión.
    Tipo de expresión Descripción
    Expresiones simples Por ejemplo: Select ID from Account where Name = $NameParam

    El SoapType del campo del lado izquierdo de la expresión determina el tipo de parámetro. Si el tipo de campo es nulo y el operador es ( = ) o ( != ), el parámetro es nulo. Al establecer xsi:nil=true en el parámetro, se establece el valor del parámetro como nulo cuando se sustituye. Si el tipo del parámetro necesita incluirse entre comillas simples (‘), el valor del parámetro se enmarca entre comillas simples durante la sustitución y su contenido se escapa de forma automática.

    En SOQL, las barras inclinadas invertidas (\) y las comillas simples (‘) se escaparán.

    Expresiones complejas Por ejemplo: Select ID From Account where ID in $idList

    El tipo de parámetro es una secuencia de repetición del SoapType del campo situado en la parte izquierda de la expresión. El parámetro no es nulo y tiene minOccurs=1, maxOccurs=unbounded en el elemento.

    La secuencia se amplía en tiempo de ejecución para que sea un valor complejo apropiado, por ejemplo:

    Select Id From Account where Id in (‘value1',‘value2')

    Parte de una expresión compleja Los parámetros dentro de una lista completa se tratan como un tipo de parámetro de expresión simple, por ejemplo: SELECT Name from Account where BillingState IN (‘California', $state2)

    En este ejemplo, el tipo de parámetro $state2 es el SoapType del campo Account BillingState y no es un elemento repetitivo. El parámetro no es nulo.




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/Configuring_the_Query_Objects_Activity.html