Acciones vinculadas a instancias

A continuación, profundizaremos en una serie de acciones que nos permitirán conocer el estado de una instancia de formulario, el token asignado a ella y los valores de las respuesta obtenidas, entre otros aspectos.

Get Form Instance State

Devuelve el estado de una instancia de formulario, es decir, si se encuentra en estado de borrador o confirmada. Presenta los siguientes parámetros:

Parámetros	Dirección	Tipo de dato	Descripción
formInstanceId	In	Texto	ID de la instancia de formulario
state	Out	Texto	Estado de la instancia de formulario
lastSaved	Out	Texto	Fecha y hora del último guardado
Response	Out	Colección	Colección conteniendo todos los datos anteriores de la instancia de formulario

Get Form Instance Response

Incluye las propiedades de Get Form Instance State pero permite también recopilar los datos que hayan sido ingresados en una instancia de formulario, mostrándolos como valores. Sus propiedades son las siguientes:

Parámetros	Dirección	Tipo de dato	Descripción
formInstanceId	In	Texto	ID de la instancia de formulario
formDefinitionID	Out	Texto	ID de la plantilla a la cual pertenece la instancia
formInstanceId	Out	Texto	ID de la instancia de formulario, ya que se incluirá en la salida final
lastSaved	Out	Texto	Fecha y hora del último guardado
state	Out	Texto	Estado de la instancia de formulario
values	Out	Colección	Valores ingresados en la instancia de formulario
Response	Out	Colección	Colección conteniendo todos los datos anteriores de la instancia de formulario

Get Form Instance Token

Permite generar un nuevo token público para una instancia de formulario (por ejemplo, porque se encuentra vencido) definiendo los siguientes parámetros:

Parámetros	Dirección	Tipo de dato	Descripción
formInstanceId	In	Texto	ID de la instancia de formulario
expiresAt	In	Fecha y hora	Fecha de vencimiento del token
formInstanceId	Out	Texto	ID de la instancia de formulario, ya que se incluirá en la salida final
sharedFormToken	Out	Texto	Token que permite visualizar y modificar la instancia generada
URL	Out	Texto	Dirección accesible desde el navegador formada por la URL básica y el token
Response	Out	Colección	Colección conteniendo todos los datos anteriores de la instancia de formulario

Set Form Instance Process Info

Permite brindar a las personas que utilicen el portal o la aplicación de Teams la posibilidad de revisar el estado de los formularios que hayan enviado, el cual se refleja en las columnas “Estado del Proceso” y “Completado”.

Visualización del estado de un formulario en el Portal

Esta acción se configura con los siguientes parámetros:

Parámetros	Dirección	Tipo de dato	Descripción
formInstanceId	In	Texto	ID de la instancia de formulario
status	In	Texto	Estado de procesamiento de la instancia que se mostrará al usuario
endState	In	Texto	Estado de procesamiento final, cuyas opciones son “OK” o “Error”
completionMessage	In	Texto	Mensaje especificando las condiciones en que finalizó la instancia

Delete Form Instance

Permite borrar una instancia de formulario. Sus principales propiedades son:

Parámetros	Dirección	Tipo de dato	Descripción
formInstanceId	In	Texto	ID de la instancia de formulario
force	In	Flag	Fuerza la eliminación de una instancia