Configuración de la actividad Consultar objetos

Debe crearse una consulta en lenguaje de búsqueda de objetos de Sforce (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 dicha actividad controlar de forma dinámica la consulta que está basada en 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 sentencia 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 consultas entre 200 y 2.000 consultas para facilitar el ajuste del rendimiento del Dispositivo de integración.

    Esta opción determina el tamaño de lote que se utilizará en la cabecera SOAP QueryOptions 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 un control dinámico de la consulta basado en la entrada de la orquestación.

Acerca de esta tarea

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.
    Nota: 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.
    Nota: 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 (tipo SOAP) 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 tiene que ir encerrado entre comillas simples (‘), el valor del parámetro se encerrará entre comillas simples durante la sustitución y su contenido se escapará de forma automática.

    En SOQL, se escapan la barra inclinada invertida (\) y la comilla simple (‘).

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

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

    La secuencia se expande en tiempo de ejecución para que sea un valor de conjunto propiamente, por ejemplo:

    Select Id From Account where Id in (‘valor1',‘valor2')

    Parte de una expresión de conjunto Los parámetros dentro de una lista de conjunto 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.