Ficha de acción

Qué hacer, quién y con qué condiciones.

Definición

La ficha de acción describe una operación como una lista cerrada en tres bandas: los parámetros que recibe, los criterios que tienen que cumplirse y los efectos que produce. Cada criterio lleva su mensaje de rechazo, porque basta uno para echar fuera la operación. Sirve para especificar una acción de producto o de proceso antes de construirla.

Editar con tus datos SVG Spec JSON

Una acción no es un botón: son cuatro puertas y una lista cerrada

Datos: tipo · nombre · detalle · rechazo · rol
Buena para: Dejar escrito qué pide una acción, qué la frena y qué cambia cuando se ejecuta.
Evítala cuando: Cuando lo que importa es el orden de varios pasos o las bifurcaciones de un proceso, no las condiciones de una sola acción.
Se lee bien: Entre 3 y 24 elementos; dibuja hasta 30
Datos que faltan: Se niega a dibujar y dice qué valor falta.
Accesibilidad: Lector de pantalla: tabla de datos · respeta «reducir movimiento»

Forma de los datos

Qué columnas pide

Columna	Tipo	Para qué
`tipo`	string	Clase de fila: parametro · criterio · efecto. Es lo que decide en qué banda de la ficha entra la fila; sin ninguna fila de clase «criterio» la pieza se niega a dibujar.
`nombre`	string	El rótulo de la fila. Medido: una fila sin él hace FALLAR el render con su número de fila.
`detalle` · opcional	string	El tipo del parámetro o el matiz del efecto, en la segunda línea. Sin ella la ficha dibuja igual, con 8 textos menos.
`rechazo`	string	Con qué mensaje rechaza un criterio. Obligatoria en las filas de clase «criterio»: una puerta sin mensaje de rechazo se dibujaría sin decir por qué se cerró, y la pieza prefiere fallar.
`rol` · opcional	string	neutro · foco · alerta · ausente · favorable. `ausente` es el criterio o el efecto que se contempla y nadie ha construido.

Tamaños

Ancha por necesidad

Esta pieza necesita anchura para que cada rótulo quepa entero. El motor prefiere decirlo a apretarla.

A menos de 480 px sus rótulos no caben sin pisarse o recortarse, y el motor no la publica así. En el móvil se ve la versión ancha, a tamaño legible y sin recortar, dentro de un marco que se desliza.

Cuándo usarla

Tres preguntas antes de elegirla

¿Hablas de una sola acción?

Si encadenas varias acciones con decisiones entre ellas, un diagrama de flujo de trabajo enseña el recorrido.

Sí: quédate con ficha de acción

No: usa Diagrama de flujo de trabajo

¿Los criterios valen todos a la vez, sin orden entre ellos?

Si las preguntas van en orden y la primera negativa ya decide, la cascada de preguntas lo dibuja.

Sí: quédate con ficha de acción

No: usa Cascada de preguntas

¿Te interesa qué hace la acción, más que los estados del objeto?

Si el foco es el ciclo de vida del objeto sobre el que actúa, usa la máquina de estados.

Sí: quédate con ficha de acción

No: usa Máquina de estados

Código

La misma pieza, con tus datos

import { getPreset, renderComposition } from 'visx-render/node';

const spec = await getPreset('concept-actioncard');
spec.data.rows = misFilas; // tipo, nombre, rechazo
const { svg, warnings } = await renderComposition(spec);

También en React con Chart y prepareComposition. Guía para desarrolladores →

Dudas

¿Qué pasa si no declaro ningún criterio?

La pieza se niega a dibujar: una acción sin criterios no es una ficha de acción.

¿Por qué cada criterio necesita su mensaje de rechazo?

Porque una puerta sin mensaje se dibujaría cerrada sin decir por qué. La pieza prefiere fallar a enseñarla así.

¿Cómo marco algo que falta por construir?

Con el rol «ausente» en ese criterio o efecto: queda en la ficha como contemplado y sin hacer.

¿Qué hace si faltan datos?

Se niega a dibujar y dice qué valor falta.

¿Cómo se ve en el móvil?

A menos de 480 px el motor no la compone sin pisar o cortar rótulos, y lo dice. En el móvil se ve la versión ancha, a tamaño legible, dentro de un marco que se desliza.

Relacionadas

Otras formas de responder «partes de un todo»

Guía para elegir: partes de un todo →