{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/pt/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Campos comuns e estrutura do fluxo"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"campos-comuns-e-estrutura-do-fluxo","__idx":0},"children":["Campos comuns e estrutura do fluxo"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pesquise com ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /node-types?q=keyword&page=1&pageSize=20"]}," e, em seguida, passe o ID do tipo retornado para ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /node-types/{nodeType}"]},". As páginas começam em 1 e o tamanho da página vai de 1 a 100 (padrão 20). Um tipo como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["browser_gotoUrl"]}," é diferente de um ID de nó do fluxo, 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 do contrato"},"children":["Campo do contrato"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"O que verificar"},"children":["O que verificar"]}]}]},{"$$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":["Suporte à criação de modelos, suporte em tempo de execução, execução externa e cobertura da documentação."]}]},{"$$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, enumerações, formatos e estrutura. Resolva ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$ref"]}," usando a URL do esquema da instância."]}]},{"$$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 obrigatórios ou proibidos em cada modo, valores resolvidos e escopo de referência permitido."]}]},{"$$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 padrão de execução, saídas por modo e políticas de campo. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x-editor-default"]}," descreve o valor inicial no editor."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"estrutura-do-fluxo","__idx":1},"children":["Estrutura do fluxo"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Defina ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["editorVersion: 2"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["editorParametersVersion: 1"]},". Os ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nodes"]}," da raiz são executados em ordem, com um único ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start"]}," no início e um único ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end"]}," no fim. Os nós aninhados usam os ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blocks"]}," especificados por cada contrato. Mantenha os IDs de nó únicos em toda a árvore e estáveis entre edições. Dê a cada nó e a cada ramificação um ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.title"]}," descritivo. Um grupo não pode conter outro grupo."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Uma ação usa ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type: browser_<action>"]},", o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.browserAction"]}," correspondente e entradas em ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.browserUi.inputs"]},". As entradas de ação usam strings como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${targetUrl}"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${visit.data.finalUrl}"]},". A saída do nó Fim e os operandos de condição podem usar ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{\"type\":\"ref\",\"content\":[\"visit\",\"data\",\"finalUrl\"]}"]},", com um array de segmentos de caminho. Faça referência apenas a variáveis visíveis e a nós anteriores. Declare variáveis personalizadas em ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start.data.customVariables"]},", atualize-as com ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["browser_updateCustomVariable"]}," e leia-as como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${custom.<id>}"]},". Depois de salvar, use a árvore normalizada pelo servidor."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"referências-de-variáveis","__idx":2},"children":["Referências de variáveis"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quando um campo aceita referências de variáveis, use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${…}"]}," e substitua as reticências pelo nome real da variável ou pelo caminho da referência. O fluxo resolve essa referência em tempo de execução e verifica o valor resultante de acordo com as regras do campo."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Por exemplo, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"selectorRadio\": \"${locatorType}\""]}," lê o parâmetro inicial ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["locatorType"]},". O valor ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"XPath\""]}," seleciona o modo XPath. O valor resolvido precisa ser ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"CSS\""]}," ou ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"XPath\""]},"; por isso, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"TEXT\""]}," não passa na validação."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"campos-de-exemplo-e-limites","__idx":3},"children":["Campos de exemplo e limites"]},{"$$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":"Regra"},"children":["Regra"]}]}]},{"$$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":["String obrigatória; aceita referências. Use uma URL HTTP(S) absoluta em modelos portáveis. Para outros esquemas de URL, faça a pré-verificação no seu cliente e confira como o navegador os trata."]}]},{"$$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":["Aceita um número ou uma expressão numérica suportada; após a resolução, o intervalo documentado é de 0 a 2147483647 milissegundos. O padrão é 1000; defina 0 para não aguardar. Mantenha o valor dentro desse intervalo."]}]},{"$$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":["Aceita ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["href"]}," (padrão), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["origin"]}," ou ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]},". O modo search exige uma chave que seja resolvida como uma string não vazia. No modo href, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.value"]}," é a URL atual completa. Para valores de search ausentes, consulte o contrato atual."]}]},{"$$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":["Aceita um inteiro de 0 a 2147483647 milissegundos. Zero desativa o tempo limite do nó, mas o limite de tempo da execução continua valendo. O padrão é 30000 para ações e 0 para nós de controle. Um tempo limite explícito em um nó de controle abrange todo o grafo de nós filhos."]}]},{"$$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":["Defina ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["interrupt"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["skip"]}," ou ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["handle"]}," explicitamente. Se um nó com falha for ignorado, as referências aos dados dele serão resolvidas como null; verifique o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hasNodeErrors"]}," da execução."]}]},{"$$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":["Quando a repetição está ativada em uma ação atômica, são permitidas de 1 a 10 tentativas adicionais. O intervalo é de 0 a 2147483 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["segundos"]},". A repetição pode executar de novo uma ação que já surtiu efeito."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Um modelo exige ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}," (de 1 a 100 caracteres, depois de remover os espaços das extremidades), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}," (até 1000 caracteres, pode ficar vazio), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["workflow"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dependencies"]}," (use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[]"]}," quando não houver modelos filhos). Consulte ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["capabilities.data.limits"]}," para ver os tamanhos de solicitação e de fluxo, o número de nós, a profundidade de aninhamento e as edições por solicitação. Os modelos de dados completos estão em ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt/browser-rpa/api/workflow"},"children":["Fluxo, variáveis e nós de estrutura"]}," e ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt/browser-rpa/api/data-types"},"children":["Modelos de dados"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Próximo passo: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt/browser-rpa/quickstart"},"children":["validar e salvar o exemplo"]},"."]}]},"headings":[{"value":"Campos comuns e estrutura do fluxo","id":"campos-comuns-e-estrutura-do-fluxo","depth":1},{"value":"Estrutura do fluxo","id":"estrutura-do-fluxo","depth":2},{"value":"Referências de variáveis","id":"referências-de-variáveis","depth":2},{"value":"Campos de exemplo e limites","id":"campos-de-exemplo-e-limites","depth":2}],"frontmatter":{"seo":{"title":"Campos comuns e estrutura do fluxo"}},"lastModified":"2026-11-20T14:40:39.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/pt/browser-rpa/node-contract-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}