Consulta de la lista de SharePoint

Esta resolución permite usar una lista de SharePoint para asignar tareas a participantes del flujo de trabajo mediante diferentes parámetros o una expresión lógica.

Puede ser útil en las situaciones en que el enrutamiento depende de los valores que seleccione un usuario en un formulario. Por ejemplo, puede enrutar un formulario para su aprobación en función de los valores seleccionados en uno o varios campos, como Centro de fabricación y Ubicación de almacenamiento, si un formulario tiene valores de un campo Centro y Almacén

Parámetros de consulta de la lista de SharePoint

Argumento

Descripción

¿Obligatorio?

allow select

Un valor Sí/No que indica si se permite que el usuario seleccione los participantes del flujo de trabajo si la consulta no devuelve nada. Si lo establece en «Yes» permite que el usuario del formulario interactúe con el control Grupo en el elemento Control de procesos y seleccione o anule la selección de posibles participantes. Cuando se establece en «No», el control Grupo no se muestra y el usuario del formulario no podrá cambiar los participantes.

 

column

Nombre de la columna que se va a consultar.

display

Un valor Sí/No que indica si se visualizará el participante del flujo de trabajo seleccionado.

list

Nombre de la lista que se va a consultar.

poolcolumn

Nombre de la columna que se va a consultar.

 

poollist

Nombre de la lista que se va a consultar.

 

poolquery

Consulta que se va a ejecutar.

 

poolsite

Sitio de SharePoint que contiene la lista que se va a consultar.

 

query

Consulta que se va a ejecutar.

runat

Un valor de inicio/fin que indica cuándo se ejecutará la consulta.

 

site

Sitio de SharePoint que contiene la lista que se va a consultar.

Nota: Las opciones de grupo (poolcolumn, poollist, poolquery, poolsite) permiten al usuario seleccionar de forma interactiva a los participantes de los resultados devueltos de la consulta. Esta resolución de participantes se puede usar con la opción Volver a ejecutar consulta de grupo en el control personalizado Participante del flujo de trabajo para permitirle ejecutar la consulta de grupo cuando se cambia el valor de un formulario.

Ejemplo

poolsite= http://localhost/grant, poolcolumn=people, poolquery= [division]==@[/my:myFields/my:SPDiv], poollist=Divisions, allowselect=false

Argumentos obligatorios

Volver al principio

Los parámetros siguientes son los que se necesitan como mínimo para la resolución de la consulta de la lista de SharePoint.

Site

Introduzca la URL del sitio de SharePoint que contiene la lista de aprobadores.

Ejemplo: Si su lista está en http://mysite/myforms/lists/approvers, introduzca http://mysite/myforms.

Sugerencia: También puede copiar la dirección URL desde su explorador accediendo al sitio y quitando todo lo que haya detrás de la última barra diagonal, incluida esta (normalmente, /default.aspx o /home.aspx).

Mostrar

Se debe usar con un elemento Control de procesos. Cuando se establece en «Yes», el participante que coincida con la consulta se mostrará en el control de procesos.

Lista

Introduzca el nombre de la lista que contiene sus aprobadores.

Ejemplo: Si la URL de su lista es http://mysite/myforms/lists/approvers, el valor de la lista será aprovers.

Column

Este argumento indica qué columna de su lista de SharePoint contiene los nombres de usuario de los aprobadores. Introduzca el nombre de la columna como aparece en la lista en el explorador.

En el ejemplo siguiente, el nombre de la columna sería la columna Nombre de usuario del aprobador porque contiene nombres de usuario.

Query

El argumento de la consulta es una expresión que filtra los aprobadores que desea que coincidan. Mediante el creador de expresiones, puede insertar campos, valores promocionados o usar operadores lógicos.

Por ejemplo, si tiene una lista de SharePoint que contiene aprobadores para áreas de almacenamiento en centros, puede tener este aspecto:

Centro Nombre del centro AlmacénAprobadorNombre de usuario del aprobador
3105ChicagoCH01Gerald Kaufnwh\gkauf
3105ChicagoCH02Adeline Bhattnwh\abhatt
3101Des MoinesDM03Dan Smithsonnwh\dsmithson

Ejemplos de consultas

Volver al principio

Consulta estática

Podría crear una consulta estática (en la que los valores nunca cambian) para extraer siempre Des Moines introduciendo lo siguiente:

[Nombre del centro] == «Des Moines»

Los corchetes [ ] encierran el nombre de la columna de SharePoint de destino. Estas instrucciones indican a la resolución que encuentre y asigne las coincidencias en que Nombre de la planta sea igual a la cadena «Des Moines».

¿Qué sucede si desea dirigirse a alguien en función de varios valores, como Adeline, que aparece más arriba? Puede usar esta instrucción:

[Nombre del centro] == «Chicago» && [Ubicación de almacenamiento] == «CH02»

El símbolo & doble es la Y lógica, lo que significa que ambas partes de la expresión deben coincidir o deben ser verdaderas.

Consulta dinámica

Las consultas también pueden usar valores dinámicos del formulario. Por ejemplo, en lugar de seleccionar en una gran lista de aprobadores, podría tener un formulario que solo requiera que introduzca la ubicación de almacenamiento y el centro de fabricación.

La expresión de la consulta para esta situación sería:

([Nombre del centro] == @[/my:myFields/my:plant]) && ([Ubicación de almacenamiento] == @[/my:myFields/my:storage_location])

Esta consulta combina la columna Nombre del centro de SharePoint con el valor del formulario del campo «Centro». También combina la columna Ubicación de almacenamiento de SharePoint con el campo «storage_location» del formulario. En este ejemplo, podría rellenar un formulario y establecer Centro en 3105 y Ubicación de almacenamiento en CH01 y, a continuación, el formulario se enrutará automáticamente a Gerald Kauf.

Notas importantes

  • Utilice el símbolo @ delante de xpath para los campos al crear instrucciones de consulta que requieran un valor de campo de formulario. El símbolo @ significa que el valor se debe resolver tras ejecutar el formulario, no antes.
  • Incluya cada instrucción entre paréntesis cuando deba comparar varias condiciones en una instrucción lógica (como en el ejemplo anterior). De este modo se indica al motor que evalúe las condiciones de los paréntesis y compare los resultados de sus instrucciones con el resto.

Argumentos de grupo

Volver al principio

Los argumentos de grupo permiten mostrar participantes coincidentes de la resolución con el usuario del formulario, que puede seleccionarlos en la lista.

Si utiliza estos argumentos, se crea un control especial en el elemento Control de procesos que muestra las posibles coincidencias a la izquierda y los usuarios asignados a la derecha.

Estos argumentos requieren que el elemento Control de procesos esté en el formulario. Al usar argumentos de grupo, los argumentos equivalentes que no son de grupo deben eliminarse.

POOLSITE, POOLLIST, POOLCOLUMN, POOLQUERY

Estos cuatro argumentos son idénticos a los que no son de grupo que se describen en Argumentos obligatorios. Use la misma sintaxis y los mismos valores.