Actividad Consultar objetos

Utilice Sforce Object Query Language (SOQL) para ejecutar una consulta en uno o varios tipos de objeto de Salesforce.com desde esta actividad y devolver un conjunto de resultados. La actividad Consultar objetos ejecuta automáticamente una llamada query o queryAll, seguida por continuas llamadas queryMore para todos los hijos y objetos devueltos desde Salesforce.com.

Nota: La ejecución de la actividad Consultar objetos puede dar lugar a que Salesforce.com abra un cursor para realizar un seguimiento de los resultados de la consulta. Si la actividad alcanza el límite de cursor que Salesforce.com permite para cada usuario o si dicho cursor caduca, el Dispositivo de integración vuelve a intentar la actividad.

Utilización de la actividad Consultar objetos

  1. En el separador Actividades, abra el directorio de Salesforce.com para buscar la actividad Consultar objetos.
  2. Añada la actividad a la orquestación.

    La lista de comprobación y el resumen de la actividad se visualizan debajo de la orquestación.

  3. Seleccione un punto final de Salesforce.com.

    Para obtener instrucciones sobre cómo crear o editar un punto final de Salesforce.com, consulte Creación o edición de un punto final de Salesforce.com.

  4. Configure la actividad especificando una consulta y estableciendo opciones de consulta.
  5. Especifique los parámetros Retry (reintento) y Time out (tiempo de espera) para la actividad.
  6. Correlacione la entrada de la actividad.
  7. Correlacione la salida de la actividad.

Correlacionar la entrada de la actividad Consultar objetos

  1. En la lista de comprobación, seleccione Correlacionar entradas.

    El elemento parameters se visualiza en el panel A actividad. El elemento parameters tiene un elemento hijo para cada parámetro que se ha especificado en la consulta SOQL. El contexto del parámetro en la consulta determina el tipo de parámetro. Si no ha especificado ningún parámetro, entonces no se visualizarán elementos hijo bajo el elemento parameters.

  2. Pulse con el botón derecho del ratón sobre el nodo predeterminado y elija Mostrar parámetros opcionales para visualizar parámetros de entrada para esta actividad:
    • MruHeader
    • CallOptions
    • connection
    • sessionInfo
  3. Pulse Seleccionar entradas... y seleccione las variables de entrada o variables de la correlación.

    Para obtener instrucciones sobre como crear variables, consulte Creación de variables.

  4. Correlacione los parámetros de entrada con la variable o variables, según proceda.

    Para obtener instrucciones sobre correlaciones, consulte Creación de una correlación.

Correlacionar la salida de la actividad Consultar objetos

  1. En la lista de comprobación, seleccione Correlacionar salidas.

    El elemento objects se visualiza en el panel De actividad. El parámetro de resultado tiene un único elemento denominado objects (objetos) con un único elemento repetitivo que lleva el nombre del objeto impulsor de la consulta. El objeto impulsor es el primer objeto denominado en la cláusula FROM de la consulta. Por ejemplo, en la siguiente sentencia SOQLAccount es el objeto impulsor:

    Select Name from Account, Account.Contacts

    El objeto impulsor tiene elementos hijos que corresponden a los campos o relaciones listados en la cláusula SELECT de una consulta. El esquema se define de la siguiente manera:
    • Para campos, el tipo de campo coincide con el tipo de SOAP del campo. El tipo de campo es nillable si el tipo de SOAP es nillable.
    • Para las relaciones de elementos padre, el nombre del elemento es el nombre del padre. Si no hay ningún padre cuando la actividad ejecuta la consulta, entonces el elemento está ausente. Los campos o relaciones del padre aparecen inmediatamente debajo del elemento de relación.
    • Para las relaciones de elementos hijo, el nombre del elemento es el nombre del hijo. El elemento de relación tiene un único elemento repetitivo denominado de acuerdo con el tipo de objeto del objeto hijo. Los campos y relación del hijo aparecen debajo el elemento de tipo de objeto. Si no hay hijos cuando la actividad ejecuta la consulta, entonces el elemento está ausente.
    • Si no ha seleccionado campos ni relaciones pero en su lugar ha solicitado count() en la cláusula SELECT, todo el elemento del tipo de objeto se sustituye con un elemento denominado count del tipo unsignedInt.
     
  2. Pulse Seleccionar salidas... y seleccione las variables de salida o variables de la correlación.

    Para obtener instrucciones sobre como crear variables, consulte Creación de variables.

  3. Correlacione los parámetros de salida con la variable o variables, según proceda.

    Para obtener instrucciones sobre correlaciones, consulte Creación de una correlación.




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