Busca con GET /node-types?q=keyword&page=1&pageSize=20 y luego pasa el ID de tipo devuelto a GET /node-types/{nodeType}. Las páginas empiezan en 1 y el tamaño de página es de 1 a 100 (20 de forma predeterminada). Un tipo como browser_gotoUrl es distinto de un ID de nodo del flujo de trabajo como visit.
| Campo del contrato | Qué comprobar |
|---|---|
authorable, runtimeSupported, externalRunnable, documentationComplete | Uso al crear flujos, compatibilidad en tiempo de ejecución, ejecución externa y cobertura de la documentación. |
inputSchema | Tipos, enumeraciones, formatos y estructura. Resuelve $ref con la URL del esquema de la instancia. |
conditionalRules, referenceRules | Campos obligatorios o prohibidos en cada modo, valores resueltos y alcance permitido de las referencias. |
defaults, outputVariants, fieldPolicies | Valores predeterminados de ejecución, salidas por modo y políticas de campo. x-editor-default describe el valor inicial en el editor. |
Escribe editorVersion: 2 y editorParametersVersion: 1. Los nodes de la raíz se ejecutan en orden, con un solo start al principio y un solo end al final. Los nodos anidados usan los blocks que especifica cada contrato. Mantén los ID de nodo únicos en todo el árbol y estables entre ediciones. Asigna a cada nodo y a cada rama un data.title descriptivo. Un grupo no puede contener otro grupo.
Una acción usa type: browser_<action>, el data.browserAction correspondiente y entradas en data.browserUi.inputs. Las entradas de las acciones usan cadenas como ${targetUrl} y ${visit.data.finalUrl}. La salida del nodo Fin y los operandos de las condiciones pueden usar {"type":"ref","content":["visit","data","finalUrl"]}, con un array de segmentos de ruta. Haz referencia solo a variables visibles y a nodos anteriores. Declara las variables personalizadas en start.data.customVariables, actualízalas con browser_updateCustomVariable y léelas como ${custom.<id>}. Después de guardar, usa el árbol normalizado del servidor.
Cuando un campo admite referencias a variables, usa ${…} y reemplaza los puntos suspensivos por el nombre real de la variable o por la ruta de la referencia. El flujo de trabajo resuelve esa referencia en tiempo de ejecución y comprueba el valor resultante según las reglas del campo.
Por ejemplo, "selectorRadio": "${locatorType}" lee el parámetro inicial locatorType. Un valor "XPath" selecciona el modo XPath. El valor resuelto debe ser "CSS" o "XPath", por lo que "TEXT" no supera la validación.
| Campo | Regla |
|---|---|
gotoUrl.url | Cadena obligatoria que admite referencias. Usa una URL HTTP(S) absoluta en las plantillas portables. Para otros esquemas, haz una verificación previa en tu cliente y comprueba cómo los gestiona el navegador. |
gotoUrl.postWaitMs | Número o expresión numérica admitida, con un rango documentado de 0 a 2147483647 milisegundos después de la resolución. El valor predeterminado es 1000; usa 0 para no esperar. Mantén el valor dentro de este rango. |
getUrl.type / key | href (predeterminado), origin o search. El modo search requiere una clave que se resuelva en una cadena no vacía. En el modo href, data.value es la URL actual completa. Consulta el contrato en vivo para los casos en que falta el valor de search. |
browserUi.exception.timeout | Entero de 0 a 2147483647 milisegundos. Cero desactiva el tiempo de espera del nodo, pero se sigue aplicando el presupuesto de tiempo de la ejecución. Valores predeterminados: 30000 para acciones y 0 para nodos de control. Un tiempo de espera explícito en un nodo de control abarca todo su grafo secundario. |
browserUi.exception.policy | Define interrupt, skip o handle de forma explícita. Si se omite un nodo fallido, las referencias a sus datos se resuelven como null; revisa hasNodeErrors de la ejecución. |
retryTimes / retryInterval | Cuando el reintento está habilitado en una acción atómica, se permiten de 1 a 10 intentos adicionales. El intervalo es de 0 a 2147483 segundos. Reintentar puede repetir una acción que ya surtió efecto. |
Una plantilla requiere title (de 1 a 100 caracteres después de quitar los espacios iniciales y finales), description (hasta 1000 caracteres; puede estar vacía), workflow y dependencies (usa [] si no hay plantillas secundarias). Consulta en capabilities.data.limits los límites de tamaño de las solicitudes y del flujo de trabajo, de número de nodos, de profundidad de anidamiento y de ediciones por solicitud. Consulta Flujo de trabajo, variables y nodos de estructura y Modelos de datos para ver los modelos completos.
Siguiente paso: validar y guardar el ejemplo.