Componente Entrada de pantalla de botón de acción
Utilice el componente Botón de acción de modo que el usuario que ejecuta pueda desencadenar una acción de pantalla con el clic de un botón en una pantalla. La acción de pantalla ejecuta un flujo iniciado automáticamente activo y los resultados del flujo iniciado automáticamente se pueden mostrar en la misma pantalla que el botón. El uso de este componente significa que necesita menos pantallas de modo que los usuarios puedan completar flujos de pantalla con mayor rapidez.
Ediciones necesarias
| Ver ediciones compatibles. |
Por ejemplo, puede hacer posible que los usuarios seleccionen un registro de cuenta en un componente Búsqueda, hacer clic en un botón para recuperar los registros de contacto asociados con el registro de cuenta y luego mostrar los registros de contacto en un componente Tabla de datos en la misma pantalla.
Configurar el nombre del botón Acción
| Atributo | Descripción |
|---|---|
| Nombre de API | El nombre de API del componente. Un nombre de API puede incluir guiones bajos y caracteres alfanuméricos sin espacios. Debe empezar por una letra y no puede terminar por un guion bajo. Además, no puede incluir dos guiones bajos consecutivos. |
| Etiqueta | Si selecciona Utilizar etiqueta como título de tabla, el texto descriptivo que aparece encima del componente. |
| Desactivado | Si se establece como verdadero, el usuario no puede modificar el valor. El valor predeterminado es falso. Este atributo acepta un recurso con un valor booleano. |
Configurar la acción
| Atributo | Descripción |
|---|---|
| Acción | La acción de pantalla que inicia el flujo iniciado automáticamente. Este es el flujo que se ejecuta cuando el usuario hace clic en el botón representado por el componente Botón de acción. El flujo iniciado automáticamente debe estar activo. |
| Etiqueta | El nombre fácil de usar para la acción asociada con el componente. Este valor puede ser diferente a la etiqueta del flujo que seleccione como la acción. |
| Nombre de API | El nombre de API para la acción asociada con el componente. Este valor puede ser diferente al nombre de API del flujo que seleccione como la acción. Un nombre de API puede incluir guiones bajos y caracteres alfanuméricos sin espacios. Debe empezar por una letra y no puede terminar por un guion bajo. Además, no puede incluir dos guiones bajos consecutivos. |
| Establecer valores de entrada | Especifique el valor de cada campo de entrada requerido por la acción asociada con el componente. Por ejemplo, si selecciona un flujo iniciado automáticamente que requiere un Id. de cuenta como entrada, proporcione el Id. de cuenta. Las variables disponibles para entrada en el flujo iniciado automáticamente aparecen en esta área. |
| Ver valores de salida | Visualice los resultados creados por la acción. Para hacer referencia a una salida en otro lugar del flujo, primero haga referencia al campo Resultados, por ejemplo,
|
Establecer visibilidad de componentes
Especifique la lógica que determina cuándo el flujo muestra el componente.
| Opción | Descripción |
|---|---|
| Cuándo mostrar componente | Configure cuándo se muestra el componente utilizando lógica condicional. Puede establecer los componentes para:
|
Especificar el comportamiento de valores en pantallas revisitadas
Especifique la acción que realiza el componente cuando un usuario introduce un valor, navega a una pantalla anterior y luego vuelve a la pantalla con este componente.
Especificar el comportamiento de otro componente con el atributo de salida En curso
Cuando un usuario hace clic en un botón de acción, el atributo En curso para la acción de pantalla asociada se establece como true. Cuando se completa la acción, el atributo En curso se vuelve a establecer en false.
Utilice el atributo En curso para especificar el comportamiento de otro componente. Por ejemplo, utilícelo para desactivar un componente de pantalla mientras se ejecuta la acción. Establezca el valor del campo Desactivado en el componente como el atributo En curso. Cuando En curso es true, el campo Desactivado también se establece como true. Cuando la acción se completa y En curso se establece como false, el campo desactivado también se establece como falso.
Consideraciones
- Si un usuario ejecuta un flujo con un componente Botón de acción en un navegador web, los resultados de la acción asociada con el componente están disponibles para el navegador. No comparta información confidencial como resultado de un componente Botón de acción.
- Los flujos iniciados automáticamente que incluyen elementos Espera o subflujos con elementos Espera no se admiten como acciones de botón Acción porque el flujo no se reanudará después de un elemento Espera.
- Los botones de acción no son compatibles en componentes Repetidor.
- No se admite el inicio de un flujo con una ruta asíncrona.
- Si un flujo iniciado desde el botón de acción no tiene rutas de fallo y se produce un error, se muestra un mensaje de error genérico debajo del botón de acción. Para mostrar un mensaje de error útil a los usuarios en su lugar, agregue rutas de fallo al flujo iniciado. En cada ruta de fallo, establezca una variable de salida en
{!$Flow.FaultMessage}. A continuación, en la pantalla de flujo con el botón de acción, agregue un componente Mostrar texto que está oculto condicionalmente y contiene un mensaje de error útil junto con la variable de mensaje de fallo.
Nota Incluso si el contenido de un componente Mostrar texto contiene un mensaje de error, los lectores de pantalla no anuncian el contenido como un mensaje de error. - Si una variable de entrada o salida en el flujo iniciado automáticamente de la acción de pantalla es una variable de registro y cambia un nombre de campo en el objeto, el nuevo nombre de campo no se refleja cuando actualiza las entradas y salidas.
- Si una variable de entrada o salida en el flujo iniciado automáticamente de la acción de pantalla es una variable Apex y cambia la estructura del tipo Apex, esos cambios no se reflejan cuando actualiza las entradas y salidas.
