Extrair Dados Estruturados

UiPath.Core.Activities.ExtractData

Extrai dados de uma página da Web indicada. Você pode especificar quais informações extrair fornecendo uma cadeia de caracteres XML no campo ExtrairMetadados, no painel Propriedades. Isso pode ser facilmente gerado com todas as propriedades definidas usando o assistente de Extração de Dados.

Propriedades

Entrada

• ExtractMetadata - Uma cadeia de caracteres XML que permite definir quais dados extrair da página da Web indicada.
• Target.Selector - Propriedade de texto usada para localizar um determinado elemento da interface do usuário quando a atividade é executada. Na verdade, é um fragmento XML especificando atributos do elemento GUI que você está procurando e de alguns de seus pais.
• Target.TimeoutMS - Especifica a quantidade de tempo (em milissegundos) para aguardar a execução da atividade antes que o erro SelectorNotFoundException seja lançado. O valor padrão é 30000 milissegundos (30 segundos).

• Target.WaitForReady - Antes de executar as ações, aguarde o destino ficar pronto. As seguintes opções estão disponíveis:

  • Nenhum — não espera por nada, exceto o elemento de interface gráfica do alvo existir antes de executar a ação. Por exemplo, você pode usar essa opção se quiser recuperar apenas o texto de uma página web ou clicar em um botão específico, sem precisar esperar todos os elementos da interface gráfica carregarem. Observe que isso pode ter consequências indesejadas se o botão depender de elementos ainda não carregados, como scripts.

  • Interativo/completo - espera que todos os elementos da interface do usuário no aplicativo de destino existam antes de executar a ação.

    Para avaliar se um aplicativo está no estado Interativo ou Concluído, as seguintes tags são verificadas:

  • Aplicativos de área de trabalho — uma mensagem wm_null é enviada para verificar a existência das tags,<wnd> ,<ctrl> ,<java> ou. <uia>Se existirem, a atividade é executada.
  • Aplicativos web:
  1. Internet Explorer - A tag <webctrl> é usada para verificar se o estado Pronto do documento HTML está definido como Concluído. Além disso, o estado Ocupado deve ser definido como “Falso”.
  2. Outros - A tag <webctrl> é usada para verificar se o estado Pronto do documento HTML está Concluído.
  • Aplicativos SAP — primeiro a presença da tag <wnd> é verificada e, depois disso, uma API específica do SAP é usada para detectar se a sessão está ocupada ou não.
• Target.Element - Use a variável UiElement retornada por outra atividade. Esta propriedade não pode ser usada junto com a propriedade Selector. Este campo suporta apenas variáveis UiElement.
• Target.ClippingRegion - Define o retângulo de recorte, em pixels, relativo ao UiElement, nas seguintes direções: esquerda, superior, direita, inferior. Ele suporta números positivos e negativos.

Opções

• AtrasoEntrePáginasEmMs - O período, em milissegundos, a se esperar até que a próxima página seja carregada. (Caso o tempo de carregamento da página seja mais longo, este valor deverá ser maior.)
• NúmeroMáxDeResultados - O número máximo de resultados a serem extraídos. Se o valor for 0, todos os elementos identificados são adicionados à saída. O valor padrão é 100.
• SeletorDePróximoLink - O seletor que identifica o link/botão usado para navegar para a próxima página. Deve ser relativo à propriedade ExistingUiElement.
• EnviarMensagensDaJanela - Se selecionado, no caso em que os dados a serem extraídos abrangem várias páginas, o clique que altera a página é executado enviando uma mensagem específica para o aplicativo de destino. Esse método de entrada pode funcionar em segundo plano, é compatível com a maioria dos aplicativos desktop, mas não é o mais rápido dos métodos. Por padrão, esta caixa de seleção fica desmarcada. Se nem essa caixa de seleção nem SimularClique estiverem selecionadas, o método padrão simula o clique usando o driver de hardware. O método padrão é o mais lento e pode não funcionar em segundo plano, mas é compatível com todos os aplicativos da área de trabalho.
• SimularClique - Se selecionado, no caso em que os dados a serem extraídos abrangem várias páginas, simula o clique que altera a página usando a tecnologia do aplicativo de destino. Este método de entrada é o mais rápido dos três e funciona em segundo plano. Por padrão, esta caixa de seleção fica desmarcada. Se nem esta caixa nem as caixas de seleção EnviarMensagensDaJanela estiverem marcadas, o método padrão executará o clique usando o driver de hardware. O método padrão é o mais lento e pode não funcionar em segundo plano, mas é compatível com todos os aplicativos da área de trabalho.

Saída

• DataTable - As informações extraídas da página da web indicada. Este campo suporta apenas variáveis DataTable.

Comum

• NomeDeExibição - o nome de exibição da atividade.

• ContinuarComErro — especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

  Observação: se essa atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, nenhum erro será capturado quando o projeto for executado.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.