Propiedades de la instancia de flujo
Las propiedades de la instancia de Flow se utilizan para el intercambio de datos entre diferentes tareas y puntos de decisión con el fin de lograr la función empresarial deseada.
Introducción
El sistema comparte un « URL » de ejecución una vez que se ha orquestado y publicado un flujo específico, siguiendo las instrucciones descritas en la sección «Gestión del diseñador de flujos ». Cada vez que se hace clic en el botón « URL », se genera una nueva instancia del flujo. Para cada una de estas instancias, se asigna un conjunto de propiedades predeterminadas o integradas. Además de las propiedades predeterminadas, la tarea utilizada puede introducir una serie de propiedades personalizadas.
Las propiedades se utilizan para el intercambio de datos entre diferentes tareas y puntos de decisión, con el fin de ayudar a crear la función empresarial adecuada.
Propiedades de la instancia de flujo
Consulte la siguiente lista de propiedades predeterminadas que se inicializan con cada instancia activada.
| Nombre de atributo | Descripción | Tipo |
|---|---|---|
__tenantid |
El nombre del arrendatario al que pertenece el usuario. | Serie |
__locale |
El conjunto de preferencias relacionadas con el idioma o el país para una interfaz de usuario. | Serie |
status |
El estado de la tarea (correcta o fallida). | Serie |
statusDetails |
Descripción del estado de la tarea. | Serie |
error |
El objeto que permite consultar los detalles de los errores detectados por el flujo. | JSON |
themeId |
El UUID de un tema personalizado que el usuario desea configurar para el flujo. Debe declararse como parámetro de consulta al activarse el flujo « URL ». | Serie |
user |
Los datos del usuario se han obtenido del CD. | SCIM |
- Durante la ejecución de las tareas, los parámetros de salida de determinadas tareas se añaden al contexto del flujo de trabajo.
- El estado de las propiedades, los detalles del estado y los errores se restablecen al inicio de cada tarea. En el caso de Page, es posible utilizar esos valores para mostrar al usuario el error correspondiente o los detalles del estado.
- La ejecución URL se puede ampliar con parámetros de consulta adicionales para insertar nuevas propiedades, además de las predeterminadas.
- Los campos de entrada configurados en la tarea «Página» también se conservan en la instancia del flujo.
<input type="text" name="username"></input>Por ejemplo, si una tarea de página tiene un campo de entrada, la propiedad «username» se guarda en la instancia del flujo, lo que se corresponde con el nombre indicado en el campo de entrada
| Nombre de atributo | Descripción | Tipo |
|---|---|---|
applicationId |
El identificador de la aplicación para la que se solicita el acceso. | Serie |
requestorId |
El ID del usuario que ha solicitado el acceso. | Serie |
requestId |
El identificador de la solicitud generada al iniciar las tareas de aprobación. | Serie |
entitlementId |
El identificador del derecho para el que se solicita el acceso. | Serie |
Propiedad de error en la instancia de flujo
Si el flujo detecta algún error durante su ejecución, se genera una propiedad de error en la instancia del flujo. El error es de tipo JSON.
En caso de errores irreversibles, el flujo se redirige a la página de error predeterminada y se cierra la instancia. En caso de error recuperable, es el usuario quien decide qué acción realizar a continuación. La decisión se puede tomar a partir de los valores « messageId, », « messageDescription, » o « taskName, » que figuran en la propiedad «error».
Cuando se produce un error en una tarea concreta, el estado de dicha tarea es failed.
Uso de propiedades al renderizar plantillas
Al igual que en las demás tareas, las propiedades de la instancia del flujo están disponibles para su uso durante la tarea «Página ». Estas propiedades pueden utilizarse para sustituir macros y generar páginas de error o formularios de entrada claros y concisos, necesarios para distintos casos de uso. Las propiedades se pueden utilizar como macros de la siguiente manera: @context.propertyName@.
La macro se puede escribir de la siguiente manera en caso de que una propiedad concreta esté anidada: @context.propertyName.nestedPropertyName@.
Veamos un ejemplo de una propiedad de error. Se puede acceder a la propiedad de la siguiente manera mientras se diseña el flujo: @context.error@. Del mismo modo, se puede acceder al archivo « messageId » correspondiente al error mediante: @context.error.messageId@.
El usuario puede acceder al n-ésimo nodo de nivel dentro de la propiedad mediante una macro, definiendo el nombre de la propiedad y «.» siendo el delimitador.