{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/es/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Campos comunes y estructura del flujo"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"campos-comunes-y-estructura-del-flujo","__idx":0},"children":["Campos comunes y estructura del flujo"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Busca con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /node-types?q=keyword&page=1&pageSize=20"]}," y luego pasa el ID de tipo devuelto a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["browser_gotoUrl"]}," es distinto de un ID de nodo del flujo de trabajo como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["visit"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo del contrato"},"children":["Campo del contrato"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Qué comprobar"},"children":["Qué comprobar"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authorable"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["runtimeSupported"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["externalRunnable"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["documentationComplete"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Uso al crear flujos, compatibilidad en tiempo de ejecución, ejecución externa y cobertura de la documentación."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["inputSchema"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tipos, enumeraciones, formatos y estructura. Resuelve ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$ref"]}," con la URL del esquema de la instancia."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conditionalRules"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referenceRules"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Campos obligatorios o prohibidos en cada modo, valores resueltos y alcance permitido de las referencias."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["defaults"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["outputVariants"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fieldPolicies"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Valores predeterminados de ejecución, salidas por modo y políticas de campo. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x-editor-default"]}," describe el valor inicial en el editor."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"estructura-del-flujo","__idx":1},"children":["Estructura del flujo"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Escribe ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["editorVersion: 2"]}," y ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["editorParametersVersion: 1"]},". Los ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nodes"]}," de la raíz se ejecutan en orden, con un solo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start"]}," al principio y un solo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end"]}," al final. Los nodos anidados usan los ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.title"]}," descriptivo. Un grupo no puede contener otro grupo."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Una acción usa ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type: browser_<action>"]},", el ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.browserAction"]}," correspondiente y entradas en ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.browserUi.inputs"]},". Las entradas de las acciones usan cadenas como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${targetUrl}"]}," y ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${visit.data.finalUrl}"]},". La salida del nodo Fin y los operandos de las condiciones pueden usar ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{\"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 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start.data.customVariables"]},", actualízalas con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["browser_updateCustomVariable"]}," y léelas como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${custom.<id>}"]},". Después de guardar, usa el árbol normalizado del servidor."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"referencias-a-variables","__idx":2},"children":["Referencias a variables"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cuando un campo admite referencias a variables, usa ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${…}"]}," 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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Por ejemplo, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"selectorRadio\": \"${locatorType}\""]}," lee el parámetro inicial ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["locatorType"]},". Un valor ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"XPath\""]}," selecciona el modo XPath. El valor resuelto debe ser ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"CSS\""]}," o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"XPath\""]},", por lo que ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"TEXT\""]}," no supera la validación."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"campos-de-ejemplo-y-límites","__idx":3},"children":["Campos de ejemplo y límites"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Regla"},"children":["Regla"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gotoUrl.url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gotoUrl.postWaitMs"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getUrl.type"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["key"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["href"]}," (predeterminado), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["origin"]}," o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]},". El modo search requiere una clave que se resuelva en una cadena no vacía. En el modo href, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.value"]}," es la URL actual completa. Consulta el contrato en vivo para los casos en que falta el valor de search."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["browserUi.exception.timeout"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["browserUi.exception.policy"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Define ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["interrupt"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["skip"]}," o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["handle"]}," de forma explícita. Si se omite un nodo fallido, las referencias a sus datos se resuelven como null; revisa ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hasNodeErrors"]}," de la ejecución."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retryTimes"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retryInterval"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["segundos"]},". Reintentar puede repetir una acción que ya surtió efecto."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Una plantilla requiere ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}," (de 1 a 100 caracteres después de quitar los espacios iniciales y finales), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}," (hasta 1000 caracteres; puede estar vacía), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["workflow"]}," y ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dependencies"]}," (usa ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[]"]}," si no hay plantillas secundarias). Consulta en ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/es/browser-rpa/api/workflow"},"children":["Flujo de trabajo, variables y nodos de estructura"]}," y ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/es/browser-rpa/api/data-types"},"children":["Modelos de datos"]}," para ver los modelos completos."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Siguiente paso: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/es/browser-rpa/quickstart"},"children":["validar y guardar el ejemplo"]},"."]}]},"headings":[{"value":"Campos comunes y estructura del flujo","id":"campos-comunes-y-estructura-del-flujo","depth":1},{"value":"Estructura del flujo","id":"estructura-del-flujo","depth":2},{"value":"Referencias a variables","id":"referencias-a-variables","depth":2},{"value":"Campos de ejemplo y límites","id":"campos-de-ejemplo-y-límites","depth":2}],"frontmatter":{"seo":{"title":"Campos comunes y estructura del flujo"}},"lastModified":"2026-11-20T14:40:39.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/es/browser-rpa/node-contract-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}