Se aplica a:
- Winshuttle Foundation
Propiedades del complemento Inicio de procesos de formulario
« Volver a la tabla de complementos
Temas relacionados
El complemento Inicio de procesos de formulario le permite el inicio de un/os formulario/s secundario/s desde el formulario primario. Además, este complemento, desde una lista de usuarios, puede iniciar un proceso separado para cada usuario, y se pueden copiar datos del formulario original al secundario con el elemento Intercambio de datos de formulario.
En esta página
- Ejemplo de cómo utilizar el Inicio de procesos de formulario
- Tabla de parámetros del complemento Inicio de procesos de formulario
- Ejemplo de la solución Inicio de procesos de formulario
- Ejemplos adicionales
Ejemplo de uso
Un usuario lanza un formulario y lo utiliza para buscar una lista de registros. Si el registro ya existe, el usuario lanzará un formulario de Cambiar registro (desde el formulario principal) que se asignará a uno o más usuarios dependiendo de una lista o grupo de SharePoint de usuarios asignados para editar el registro. Si la lista de SharePoint contiene diez personas, se inicia un nuevo proceso y formulario para cada miembro del grupo de SharePoint. Esto equivaldría a 10 formularios y procesos, uno por cada miembro del grupo de SharePoint.
Hay tres mecanismos por los cuales se puede leer un formulario que ha iniciado el complemento:
- Grupo de SharePoint inicia un formulario y proceso para cada persona del grupo.
- Lista de SharePoint inicia un formulario y proceso para cada fila de una lista de SharePoint determinada y asigna usuarios específicos de la lista a calles específicas.
- Grupo de repetición permite que una consulta basada en los campos de un grupo de repetición pueda devolver o no un usuario. Los resultados de la consulta se usarán para resolver las calles.
En el mecanismo Grupo de repetición, puede asignar los campos de sección de repetición en el formulario secundario. Los parámetros que se utilizan son:
- repeatinggroup: XPath del grupo de repetición del formulario principal.
- fielddestinationxpath: XPath del campo del formulario secundario.
- repeatinggroupfieldxpath: XPath del campo de sección de repetición del formulario principal.
Para asignar campos de grupos de repetición, especifique los parámetros repeatinggroup, fielddestinationxpath y repeatinggroupfieldxpath. Los dos últimos parámetros están indexados, así que también se pueden asignar varios campos de la sección de repetición del formulario principal a los campos del formulario secundario.
Propiedades del complemento Inicio de procesos de formulario
Par de valores |
Descripción |
|
autosyncfields
|
Copia automáticamente todos los nombres de campos con nombres comunes entre el formulario principal y el secundario. NOTA: Si se especifica autosyncfields, esta operación se produce antes de cualquier configuración explícita de valores de campo, especificada a través de sourcefield[index], etc. |
|
destinationfield[index] |
Nombre de un campo del formulario de destino. Los valores de campo de origen con un índice determinado se copiarán en el campo de destino con el mismo índice en el nuevo formulario. |
|
fielddestinationxpath[index] |
Xpath del campo del formulario secundario. Para que funcione esta configuración, SingleProcess (más adelante) se debe establecer en false. Muchos grupos de repetición no son compatibles. |
|
form |
Nombre del formulario que desea iniciar. Nota: Este formulario se debe publicar antes de usar el complemento Inicio de procesos de formulario. El nombre de la plantilla asociada con esta propiedad es el nombre de la lista de SharePoint correspondiente que se crea al publicar un formulario. |
| groupcolumn | Especifique un nombre de grupo que se recuperará de SharePoint. Los usuarios se añadirán a los grupos de la columna usercolumn de SharePoint y el proceso se asignará a los usuarios de los grupos. |
|
newthread |
Configuración Yes/No. Si es Yes, se inicia un subproceso de segundo plano para procesar las invocaciones del proceso. Si se establece en Yes, el explorador será más flexible, en especial, con muchos usuarios asignados. |
|
processname |
Nombre del proceso que desea iniciar. NOTA: Este proceso se debe publicar antes de usar el complemento Inicio de procesos de formulario y debe tener un formulario correspondiente asociado. |
|
query |
Consulta que se usará al recuperar filas de SharePoint. |
|
repeatinggroupfieldxpath[index] |
Xpath del campo del grupo de repetición del formulario principal. |
|
repeatinggroup |
Xpath del grupo de repetición. SingleProcess se debe establecer en false para que funcione esta configuración. |
|
resolveswimlanes |
Este parámetro booleano se debe establecer en YES cuando desee que un proceso principal ejecute las resoluciones de participantes de la calle del proceso secundario. El valor predeterminado es NO. |
|
singleprocess
|
Cuando se usa con la opción Grupo de SharePoint, especifica que solo se debe iniciar un único proceso y las personas del grupo de SharePoint se deben gestionar como un equipo en una asignación de equipos. |
|
site |
Sitio de FormEx de SharePoint que contiene el formulario y el proceso que desea iniciar. |
|
sitegroup |
Grupo que desea asociar con la calle designada en la propiedad Calle. Si se usa sitegroup, solo se puede usar una única calle. Se pueden asignar varias calles a través de listas de SharePoint. Nota: Este parámetro no funcionará con las configuraciones RepeatingGroupFieldXpath, FieldDestinationXpath y RepeatingGroup. |
|
sourcefield[index] |
Nombre de un campo del formulario de origen. |
|
swimlane |
Calle que se va a asignar al iniciarse a través del mecanismo Grupo de SharePoint. |
|
swimlane[index] |
Nombre de la calle en la posición especificada por el índice. Solo se usa al utilizar el mecanismo Lista de SharePoint. |
|
usercolumn |
Columna desde la cual se recuperarán las personas. Nota: Debe tener el formato de DOMINIO/NOMBREDEUSUARIO. Por ejemplo: WS/JohnD |
|
usercolumn[index] |
Nombre de la columna de usuario en la posición especificada por el índice. Solo se usa al utilizar el mecanismo Lista de SharePoint. Nota: Debe tener el formato de DOMINIO/NOMBREDEUSUARIO. Por ejemplo: WS/JohnD |
|
userlist |
Lista de la cual se recuperarán los usuarios. |
|
usersite |
Sitio del cual se recuperarán los usuarios. |
Ejemplo de la solución Inicio de procesos de formulario
Un usuario inicia el formulario Crear registro y realiza una búsqueda para comprobar si ya existe un registro. En este caso, el registro existe, así que el usuario marca una casilla para confirmarlo y, a continuación, envía el formulario. Entonces, el flujo de trabajo abre el formulario Cambiar registro y transfiere todos los datos que el usuario ya ha introducido en el formulario original o anterior (según corresponda). Finaliza Crear proceso, el usuario recibe una tarea Cambiar formulario y, a continuación, continúa con el nuevo proceso.
Los elementos de esta situación funcionan como se describe a continuación.
|
Flujo de trabajo de inicio de cambio
|
Formulario de inicio de cambio Nota: Si los campos se van a actualizar desde Formulario de inicio de cambio, deben tener el mismo nombre en ambos formularios.
|
- Asegúrese de que haya una calle llamada Solicitante y añada una tarea. Las demás calles puede configurarlas como desee.
Nota: Coincidirá con un campo que se creará en el formulario Crear.
- Añada algunos campos, incluidos algunos que también incorporará al proceso Crear formulario.
- El flujo de trabajo se puede diseñar según sus requisitos o especificaciones. En este ejemplo, hemos añadido el complemento «Inicio de procesos de formulario» seguido de una tarea, de manera que podemos asegurarnos de que se sigue la ruta correcta en el flujo de trabajo. (Esta tarea se puede quitar después de probarse).
- Cree el formulario de inicio. Tenga en cuenta que, si los campos se van a actualizar en el formulario de inicio de cambio, deben tener el mismo nombre en ambos formularios.
- Esta lista desplegable del formulario decide si se debe iniciar el nuevo formulario o no. En la opción 1 de este ejemplo, se inicia el nuevo formulario.
- El campo Solicitante se rellena mediante el control de usuario actual. Nota: Este campo se puede quitar de la vista una vez que haya finalizado la prueba si ya no es necesario
- El campo Nombre del formulario se rellena mediante el control de nombre de formulario. Nota: Este campo se puede quitar de la vista una vez que haya finalizado la prueba si ya no es necesario
- En el panel Propiedades, establezca los campos Solicitante y Nombre del formulario para que sean el campo Promocionado a SharePoint.
- Guarde e implemente ambos formularios. Implemente el formulario de cambio en primer lugar.
- Deberá definir estos parámetros (consulte la tabla siguiente) en el editor de argumentos del complemento para el complemento Inicio de procesos de formulario.
Nota: Siempre debe definir un usuario para el formulario iniciado en el complemento.
| Site | URL del sitio del formulario, es decir, donde se encuentra el formulario que iniciará el complemento |
| ProcessName | Nombre del proceso que activará el proceso inicial. Por ejemplo, Formulario de inicio de cambio. |
| Form | Nombre del formulario que activará la solución inicial. Normalmente es el mismo que ProcessName (Formulario de inicio de cambio, como en el ejemplo anterior). |
| Swin Lane | Nombre de la calle del formulario de cambio que tiene la primera tarea que se va a activar. En este ejemplo, el nombre de la calle es Solicitante. |
| UserSite |
URL del sitio del cual se recuperará el nombre de usuario de la primera tarea del formulario de cambio. En este ejemplo, hemos utilizado el nombre del usuario que inició el proceso de creación desde el campo «Solicitante» (que promocionamos a un campo de SharePoint en el paso 8 más arriba) en el formulario de creación en la lista de formularios.
|
| UserList |
Nombre de la lista en la que recuperará el nombre de usuario del proceso Cambiar desde Crear formulario de inicio.
|
| UserColumn |
Nombre de la columna de SharePoint de la que se recuperará el nombre de usuario. En este ejemplo, Solicitante. |
| Query |
[Title]==FormName. Es la consulta que se usa para seleccionar el nombre de usuario correcto en la lista. [Title] es la primera columna de la lista de SharePoint Crear formulario de inicio. @[FormName] es el nombre de la columna promocionada de la lista de SharePoint. |
| AutoSyncFields | Establezca este parámetro en Yes. Copia el contenido de todos los campos que comparten un nombre común en dos formularios. |
Ejemplos adicionales
Esperar a los procesos secundarios
Se puede configurar el flujo de trabajo para esperar a que los procesos secundarios se completen antes de que continúe el flujo de trabajo principal. Por ejemplo, si se crea el formulario Nueva contratación, el formulario secundario podría ser Tareas de TI. Al usar el complemento Esperar al proceso secundario, se puede pausar el formulario Nueva contratación mientras se completa el formulario secundario Tareas de TI.
Al usar el complemento Esperar al proceso secundario inmediatamente después del complemento Inicio de procesos de formulario, añada un nodo de espera para proporcionar el tiempo suficiente para que el complemento secundario se lance. De lo contrario, el complemento Esperar al proceso secundario podría completarse de forma prematura. El tiempo de espera lo determina la velocidad con la que su tarea svservice puede procesar el tipo de tarea formprocesslaunch svservice.
A continuación se ofrecen ejemplos rápidos de «formularios cortos» de parámetros y configuraciones que puede usar para obtener diferentes funciones.
Ejemplo 1
|
Este ejemplo inicia un nuevo proceso llamado Proceso de formulario de comentario que se ejecuta en un nuevo formulario de comentario para cada usuario del grupo Comentador de SharePoint. Asignará el usuario a la calle Comentarios de cada proceso. |
Ejemplo 2
|
Este ejemplo inicia un nuevo proceso llamado Proceso de formulario de comentario que se ejecuta en un nuevo formulario de comentario por cada fila de la lista Usuarios asignados de comentarios en el sitio http://acme.com/admin. El usuario del campo Comentador se asignará a la calle Comentarios y el usuario del campo UserManager se asignará a la calle Administradores. |
Ejemplo 3
|
Este ejemplo consulta la lista de usuarios Usuarios asignados de comentarios en el sitio http://acme.com/admin por cada fila del grupo de repetición. Si se encuentra un usuario, se inicia un nuevo proceso llamado Proceso de formulario de comentario que se ejecuta en un nuevo formulario de comentarios en el que field1 y field2 del grupo de repetición del formulario principal se asignan a field1 y field2 respectivamente en el formulario secundario, para esa fila del sitio http://acme.com/sv/FormEx. El usuario del campo Comentador devuelto por la consulta se asignará a la calle Comentarios. |
Ejemplo 4
|
Este ejemplo consulta la lista de usuarios Usuarios asignados de comentarios en el sitio http://acme.com/admin por cada fila del grupo de repetición. Si se devuelve un usuario, se inicia un nuevo proceso llamado Proceso de comentario de formulario. Si Proceso de comentario de formulario se ejecuta en un nuevo formulario de comentario, en el que field1 y field2 de los grupos de repetición del formulario principal se asignan a field1 y field2 del formulario secundario para esa fila del sitio http://acme.com/sv/FormEx. El usuario del campo Comentador devuelto por la consulta se asignará a la calle Comentarios. Las resoluciones de participantes de la calle del proceso secundario también se ejecutarán porque ResolveSwim Lanes está establecido en true. |