Saltar para o conteúdo
Last updated

Campos comuns e estrutura do fluxo

Pesquise com GET /node-types?q=keyword&page=1&pageSize=20 e, em seguida, passe o ID do tipo retornado para 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 browser_gotoUrl é diferente de um ID de nó do fluxo, como visit.

Campo do contratoO que verificar
authorable, runtimeSupported, externalRunnable, documentationCompleteSuporte à criação de modelos, suporte em tempo de execução, execução externa e cobertura da documentação.
inputSchemaTipos, enumerações, formatos e estrutura. Resolva $ref usando a URL do esquema da instância.
conditionalRules, referenceRulesCampos obrigatórios ou proibidos em cada modo, valores resolvidos e escopo de referência permitido.
defaults, outputVariants, fieldPoliciesValores padrão de execução, saídas por modo e políticas de campo. x-editor-default descreve o valor inicial no editor.

Estrutura do fluxo

Defina editorVersion: 2 e editorParametersVersion: 1. Os nodes da raiz são executados em ordem, com um único start no início e um único end no fim. Os nós aninhados usam os 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 data.title descritivo. Um grupo não pode conter outro grupo.

Uma ação usa type: browser_<action>, o data.browserAction correspondente e entradas em data.browserUi.inputs. As entradas de ação usam strings como ${targetUrl} e ${visit.data.finalUrl}. A saída do nó Fim e os operandos de condição podem usar {"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 start.data.customVariables, atualize-as com browser_updateCustomVariable e leia-as como ${custom.<id>}. Depois de salvar, use a árvore normalizada pelo servidor.

Referências de variáveis

Quando um campo aceita referências de variáveis, use ${…} 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.

Por exemplo, "selectorRadio": "${locatorType}" lê o parâmetro inicial locatorType. O valor "XPath" seleciona o modo XPath. O valor resolvido precisa ser "CSS" ou "XPath"; por isso, "TEXT" não passa na validação.

Campos de exemplo e limites

CampoRegra
gotoUrl.urlString 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.
gotoUrl.postWaitMsAceita 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.
getUrl.type / keyAceita href (padrão), origin ou search. O modo search exige uma chave que seja resolvida como uma string não vazia. No modo href, data.value é a URL atual completa. Para valores de search ausentes, consulte o contrato atual.
browserUi.exception.timeoutAceita 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.
browserUi.exception.policyDefina interrupt, skip ou handle explicitamente. Se um nó com falha for ignorado, as referências aos dados dele serão resolvidas como null; verifique o hasNodeErrors da execução.
retryTimes / retryIntervalQuando 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 segundos. A repetição pode executar de novo uma ação que já surtiu efeito.

Um modelo exige title (de 1 a 100 caracteres, depois de remover os espaços das extremidades), description (até 1000 caracteres, pode ficar vazio), workflow e dependencies (use [] quando não houver modelos filhos). Consulte 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 Fluxo, variáveis e nós de estrutura e Modelos de dados.

Próximo passo: validar e salvar o exemplo.