Saltar para o conteúdo

Ler dados do elemento

Tipo de nó: browser_getElement

O que faz

Lê o texto, o HTML ou um atributo nomeado de um ou mais elementos correspondentes.

Configuração no cliente desktop

Configuração do nó "Ler dados do elemento" no cliente desktop

Captura de tela feita na interface em inglês do MoreLogin Desktop V2.73.101.

Entradas

Estes campos ficam em data.browserUi.inputs.

CampoTipo ou valoresObrigatório no esquemaPadrão de execuçãoDescrição e limites
selectorType"selector" / "element" / "frame" (aceita referências de variáveis)Não"selector"Origem do elemento. Valor inicial no editor: "selector"
framestringNão—Variável de iframe
elementstringNão—Variável de elemento
selectorRadio"CSS" / "XPath" (aceita referências de variáveis)Não"CSS"Tipo de seletor. Valor inicial no editor: "CSS". Por exemplo, "${locatorType}"; o valor referenciado deve ser "CSS" ou "XPath".
selectorstringNão—Seletor
outputRange"single" / "all" (aceita referências de variáveis)Não"single"Quando vários objetos de elemento corresponderem. Valor inicial no editor: "single"
serialType"fixed" / "randomInterval" (aceita referências de variáveis)Não"fixed"Quando vários objetos de elemento corresponderem. Valor inicial no editor: "fixed"
serialWorkflowNumberNão1Índice do elemento; inteiro; mínimo após a resolução: 1. Valor inicial no editor: 1
serialMinWorkflowNumberNão—Índice mínimo; inteiro; mínimo após a resolução: 1
serialMaxWorkflowNumberNão—Índice máximo; inteiro; mínimo após a resolução: 1
type"innerText" / "innerHTML" / "attribute" (aceita referências de variáveis)Não"innerText"Tipo de saída. Valor inicial no editor: "innerText"
keystringNão—Nome do atributo / seletor do elemento filho

Requisitos de modo e limites

  • Regras de localização: selectorType=selector exige selector; frame exige frame+selector; element exige uma referência ElementRef de um nó anterior. serial começa em 1. randomInterval usa serialMin/serialMax, e o mínimo não pode ser maior que o máximo. Primeiro, o nó aguarda até que o seletor corresponda a elementos e, depois, escolhe o índice uma única vez: o limite superior do intervalo fica restrito ao número real de correspondências. Se um índice fixo ou o limite inferior do intervalo for maior que o número de correspondências, ELEMENT_NOT_FOUND (reason=range, details.field é serial ou serialMin) será retornado imediatamente, sem nenhuma interação com a página. outputRange só pode ser single/all. type só pode ser innerText/innerHTML/attribute (igual ao editor; use getElementRef para objetos de elemento e getFrame para iframes), e type=attribute exige key (o nome do atributo). Leia as chaves e os valores retornados como um valor único ou um array, de acordo com a ramificação. O nó não aguarda o elemento aparecer: se nada for encontrado, ele é concluído com sucesso imediatamente, um valor único é a string vazia "" (em all, é []), e um atributo ausente é "". Se precisar aguardar, use "Aguardar elemento" antes.
  • Código de validação: RPA_NODE_INPUT_INVALID

Referências de entrada

CampoFormas permitidas
selectorTypeliteral, template
frameliteral, template
elementliteral, template
selectorRadioliteral, template
selectorliteral, template
outputRangeliteral, template
serialTypeliteral, template
serialliteral, numericExpression
serialMinliteral, numericExpression
serialMaxliteral, numericExpression
typeliteral, template
keyliteral, template

Saídas

Modo {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"single"}]}

Campo de saídaTipo ou valores
textstring
matchedCountnumber

Modo {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"all"}]}

Campo de saídaTipo ou valores
textarray<string>
matchedCountnumber

Modo {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"single"}]}

Campo de saídaTipo ou valores
htmlstring
matchedCountnumber

Modo {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"all"}]}

Campo de saídaTipo ou valores
htmlarray<string>
matchedCountnumber

Modo {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"single"}]}

Campo de saídaTipo ou valores
attributestring / null
matchedCountnumber

Modo {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"all"}]}

Campo de saídaTipo ou valores
attributearray<string / null>
matchedCountnumber

Referencie os campos publicados como ${nodeId.data.field}.

Exemplo em JSON

Este exemplo lê para data.text o texto do primeiro elemento que corresponde a .price. Adicione antes um nó "Aguardar elemento" se o elemento carregar de forma assíncrona.

{
  "id": "read_price",
  "type": "browser_getElement",
  "data": {
    "title": "Read the product price",
    "browserAction": "getElement",
    "browserUi": {
      "inputs": {
        "selectorType": "selector",
        "selectorRadio": "CSS",
        "selector": ".price",
        "outputRange": "single",
        "serialType": "fixed",
        "serial": 1,
        "type": "innerText"
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}

Voltar ao catálogo de nós