Saltar para o conteúdo

Localizar elemento

Tipo de nó: browser_getElementRef

O que faz

Localiza um elemento e retorna um handle para ações posteriores no elemento.

Configuração no cliente desktop

Configuração do nó "Localizar 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 alvo. Valor inicial no editor: "selector"
framestringNão—iframe
elementstringNão—Referência de elemento
selectorRadio"CSS" / "XPath" (aceita referências de variáveis)Não"CSS"Tipo de seletor. Valor inicial no editor: "CSS"
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"object" (aceita referências de variáveis)Não"object"Tipo de saída. Valor inicial no editor: "object"

Requisitos de modo e limites

  • O nó localiza e retorna uma referência real de elemento. A referência só pode ser reutilizada dentro da mesma execução ou, na depuração, dentro da mesma época.
  • 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

Saídas

Modo outputRange eq "single"

Campo de saídaTipo ou valores
elementElementRef
matchedCountnumber

Modo outputRange eq "all"

Campo de saídaTipo ou valores
elementarray<ElementRef>
matchedCountnumber

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

Exemplo em JSON

Um objeto de nó completo para o array nodes de um fluxo ou para os blocks de outro nó.

{
  "id": "find_button",
  "type": "browser_getElementRef",
  "data": {
    "title": "Find the submit button",
    "browserAction": "getElementRef",
    "browserUi": {
      "inputs": {
        "selectorType": "selector",
        "selectorRadio": "CSS",
        "selector": "button[type=submit]",
        "outputRange": "single",
        "serialType": "fixed",
        "serial": 1,
        "type": "object"
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}

Voltar ao catálogo de nós