Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Browser
## Panoramica di
Le azioni del browser forniscono un toolkit di automazione completo per l'esecuzione di interazioni web. Le sessioni del browser vengono gestite automaticamente: aperte, mantenute e chiuse secondo necessità. Quick Automate supporta l'identificazione flessibile degli elementi tramite descrizioni in linguaggio naturale basate sull'intelligenza artificiale e selettori precisi. XPath Le funzionalità principali includono il targeting intelligente degli elementi con meccanismi di fallback, funzionalità di riparazione automatica che gestiscono automaticamente i popup e i tentativi falliti, l'estrazione dei dati, incluso il contenuto strutturato delle tabelle, e una suite completa di metodi di interazione, dai clic e dalla digitazione di base alle attività avanzate in più fasi basate sull'intelligenza artificiale.
**Metodi di identificazione degli elementi**
+ **Metodo di descrizione:** utilizza l'intelligenza artificiale per identificare gli elementi utilizzando descrizioni in linguaggio naturale (ad esempio, il «pulsante Accedi»), rendendo le automazioni più resistenti alle modifiche dell'interfaccia utente.
+ **XPath metodo di selezione:** utilizza XPath espressioni precise per il targeting esatto degli elementi (ad esempio,). `//button[text()='Log in']`
+ **Approccio combinato:** quando entrambi i metodi sono abilitati, XPath viene provato prima di ricorrere al metodo di descrizione, combinando precisione e adattabilità.
**Funzionalità di autoriparazione disponibili per digitazioni e clic**
+ **HandlePopups:** rileva e gestisce automaticamente dialoghi, avvisi sui cookie e sovrapposizioni imprevisti, impedendo agli elementi di blocco di interrompere i flussi di lavoro.
+ **ValidateAndRetry:** verifica il successo dell'azione tramite il confronto delle schermate e, se necessario, riprova, riducendo i falsi errori.
## Gestione delle sessioni del browser
Le istanze del browser vengono create automaticamente, gestite durante tutti i flussi di lavoro e pulite correttamente una volta completate. L'`restart_browser`azione consente nuove sessioni quando necessario per scenari quali i timeout di accesso o la scadenza delle sessioni.
## Avvia la sessione del browser
Apre una nuova sessione del browser. Le azioni all'interno del suo ambito interagiscono con questo browser. Al termine, il browser si chiude automaticamente.
**Proprietà:**
+ **Titolo dell'azione** (solo testo): il titolo dell'azione visualizzato nella visualizzazione del processo (impostazione predefinita: Browser)
**Nota**
Tutte le azioni del browser devono essere inserite nell'ambito di una sessione del browser
Ogni ambito del browser è una sessione del browser. Il browser si chiude automaticamente quando vengono completate le azioni all'interno di un ambito.
## Vai alla pagina Web
Passa a un URL specifico. Utilizzato per accedere a una nuova pagina Web nella scheda corrente del browser.
**Proprietà:**
+ **URL** (obbligatorio): l'indirizzo web verso cui navigare (ad esempio, «example.com») Nota: quando lavori con questo URL, fornisci l'URL completo.
## Click
Fa clic su un elemento della pagina Web. Utilizzato per interagire con pulsanti, link o altri elementi cliccabili.
**Proprietà:**
+ **Trova elemento con descrizione** (pulsante di opzione): utilizza la descrizione in linguaggio naturale per identificare l'elemento con l'intelligenza artificiale (impostazione predefinita: ON)
+ **Campo descrizione** (obbligatorio a determinate condizioni): descrizione in linguaggio naturale dell'elemento del browser su cui fare clic (ad esempio, «pulsante Invia»). Non utilizzare l'azione nell'elemento, ma solo la descrizione dell'elemento
+ **Trova elemento con selettore** (pulsante di opzione): usa l' XPath espressione per identificare l'elemento (impostazione predefinita: OFF)
+ **XPath Campo** (obbligatorio condizionalmente): XPath espressione (ad esempio, «//input [@id ='xyz']»)
+ **Autoriparazione (**casella di controllo): usa l'IA per gestire automaticamente i popup imprevisti (impostazione predefinita: OFF, opzionale)
+ **Pulsante del mouse** (menu a discesa): su quale pulsante del mouse fare clic: sinistro, centrale o destro (impostazione predefinita: sinistra, opzionale)
+ **Tipo di clic** (menu a discesa): clic singolo o doppio (impostazione predefinita: singolo, opzionale)
+ **Scarica il file** (pulsante di opzione): abilita se con un clic viene scaricato un file (impostazione predefinita: OFF, opzionale)
+ **File scaricato** (output, obbligatorio a determinate condizioni): nome variabile che memorizza il file scaricato (impostazione predefinita: downloaded\$1file)
**Identificazione degli elementi:**
+ È necessario abilitare almeno un metodo di identificazione degli elementi
+ Quando entrambi i metodi sono abilitati, il XPath selettore viene provato prima di tornare alla descrizione
## Inserisci testo
Digita il testo in un campo di immissione. Utilizzato per compilare moduli, caselle di ricerca o altri input di testo nelle pagine Web.
**Proprietà:**
+ **Testo da inserire** (obbligatorio): il testo che desideri digitare nel campo (ad esempio, «Order \$112345 «)
+ **Trova elemento con descrizione** (pulsante di opzione): utilizza la descrizione in linguaggio naturale per identificare l'elemento con l'intelligenza artificiale (impostazione predefinita: ON)
+ **Campo descrizione** (obbligatorio a determinate condizioni): descrizione in linguaggio naturale (ad esempio, «campo numero dell'ordine»)
+ **Trova elemento con selettore** (pulsante di opzione): utilizza l' XPath espressione per identificare l'elemento (impostazione predefinita: OFF)
+ **XPath Campo** (obbligatorio condizionalmente): XPath espressione (ad esempio, «//input [@id ='xyz']»)
+ **Autoriparazione (**casella di controllo): usa l'IA per gestire automaticamente i popup imprevisti (impostazione predefinita: OFF, opzionale)
+ **Sostituisci testo esistente** (casella di controllo): cancella qualsiasi testo preesistente nel campo prima di digitare (impostazione predefinita: ON)
**Identificazione dell'elemento:**
+ Deve essere abilitato almeno un metodo di identificazione degli elementi. Si consiglia di utilizzare la descrizione dell'elemento e passare al selettore degli elementi solo se necessario.
## Inserisci la credenziale
Digita un nome utente o una password. Utilizzato per accedere in modo sicuro a un sito Web utilizzando credenziali salvate.
**Proprietà:**
+ **Credenziale** (menu a discesa, obbligatorio): scegli quale credenziale salvata utilizzare dal gruppo di automazione
+ **Valore da inserire** (menu a discesa, obbligatorio): scegli se inserire nome utente o password (impostazione predefinita: nome utente)
+ **Trova elemento con descrizione** (pulsante di opzione): utilizza la descrizione in linguaggio naturale per identificare l'elemento con l'intelligenza artificiale (impostazione predefinita: attiva)
+ **Campo descrizione** (obbligatorio a determinate condizioni): descrizione in linguaggio naturale (ad esempio, «campo Nome utente»)
+ **Trova elemento con selettore** (pulsante di opzione): utilizza l' XPath espressione per identificare l'elemento (impostazione predefinita: OFF)
+ **XPath Campo** (obbligatorio a determinate condizioni): XPath espressione (ad esempio, «//input [@id ='username']»)
+ **Autoriparazione (**casella di controllo): usa l'intelligenza artificiale per gestire automaticamente i popup imprevisti (impostazione predefinita: OFF, opzionale)
**Identificazione degli elementi:**
+ È necessario abilitare almeno un metodo di identificazione degli elementi
## Seleziona dal menu a discesa
Sceglie un valore da un menu a discesa. Utilizzato per effettuare selezioni in moduli, filtri o altri menu a discesa sulle pagine Web.
**Proprietà:**
+ **Valore da selezionare** (obbligatorio): l'opzione che desideri selezionare dal campo a discesa (ad esempio, «Completa»)
+ **Trova elemento con descrizione** (pulsante di opzione): utilizza la descrizione in linguaggio naturale per identificare l'elemento con l'intelligenza artificiale (impostazione predefinita: ON)
+ **Campo descrizione** (obbligatorio a determinate condizioni): descrizione in linguaggio naturale (ad esempio, «menu a discesa sullo stato dell'ordine»)
+ **Trova elemento con selettore** (pulsante di opzione): utilizza l' XPath espressione per identificare l'elemento (impostazione predefinita: OFF)
+ **XPath Campo** (obbligatorio a determinate condizioni): XPath espressione (ad esempio, «//select [@id ='xyz']»)
+ **Autoriparazione (**casella di controllo): usa l'IA per gestire automaticamente i popup imprevisti (impostazione predefinita: OFF, opzionale)
**Identificazione degli elementi:**
+ È necessario abilitare almeno un metodo di identificazione degli elementi
## Estrai testo
Legge un valore da una pagina web. Utilizzato per acquisire il testo da un singolo campo.
**Proprietà:**
+ **Trova elemento con descrizione** (pulsante di opzione): utilizza la descrizione in linguaggio naturale per identificare l'elemento con l'intelligenza artificiale (impostazione predefinita: ON)
+ **Campo Descrizione** (obbligatorio a determinate condizioni): descrizione in linguaggio naturale (ad esempio, «campo Importo totale»)
+ **Trova elemento con selettore** (pulsante di opzione): utilizza l' XPath espressione per identificare l'elemento (impostazione predefinita: OFF)
+ **XPath Campo** (obbligatorio condizionalmente): XPath espressione (ad esempio, «//input [@id ='xyz']»)
+ **Autoriparazione (**casella di controllo): usa l'IA per gestire automaticamente i popup imprevisti (impostazione predefinita: OFF, opzionale)
+ **Testo estratto** (output): nome della variabile che memorizza il testo estratto (impostazione predefinita: extracted\$1text)
**Identificazione dell'elemento:**
+ È necessario abilitare almeno un metodo di identificazione degli elementi
## Estrai tabella
Legge i dati da una tabella di pagine Web. Utilizzato per acquisire informazioni strutturate presenti nelle tabelle.
Estrae in modo intelligente i dati strutturati dalle pagine Web utilizzando selettori o targeting in linguaggio naturale. XPath Le funzionalità includono l'estrazione potenziata dall'intelligenza artificiale, l'estrazione di più attributi (testo, collegamenti, ecc.), la generazione automatica di colonne per gli attributi e l'output della tabella di dati per la manipolazione programmatica.
**Proprietà:**
+ **Trova elemento con descrizione** (pulsante di opzione): utilizza la descrizione in linguaggio naturale per identificare l'elemento con l'intelligenza artificiale (impostazione predefinita: ON)
+ **Campo Descrizione** (obbligatorio a determinate condizioni): descrizione in linguaggio naturale (ad esempio, «Tabella dei dettagli dell'ordine»)
+ **Trova elemento con selettore** (pulsante di opzione): utilizza l' XPath espressione per identificare l'elemento (impostazione predefinita: OFF)
+ **XPath Campo** (obbligatorio a determinate condizioni): XPath espressione (ad esempio, «//table [@id ='xyz']»)
+ **Autoriparazione (**casella di controllo): usa l'IA per gestire automaticamente i popup imprevisti (impostazione predefinita: OFF, opzionale)
+ **Estrai più pagine** (pulsante di opzione): continua a estrarre dati da pagine aggiuntive, se esistono (impostazione predefinita: OFF, opzionale)
+ **Selettore del pulsante della pagina successiva** (visualizzato in modo condizionale): XPath espressione per il pulsante della pagina successiva (ad esempio, «//\$1 [@id ='nextButton']», opzionale)
+ **Estrazione intelligente dei dati** (casella di controllo): utilizza l'intelligenza artificiale per estrarre e strutturare dati da tabelle complesse (impostazione predefinita: ON). Non utilizzare per tabelle di grandi dimensioni di 100 righe o più. Questa opzione deve essere utilizzata per tabelle complesse o strutture simili a tabelle, in cui la normale estrazione delle tabelle da un browser Web non riesce
+ **Dati da estrarre (menu a** discesa a selezione multipla): scegli cosa estrarre: selettori di testo, collegamenti (Href) o elementi (Xpath) (impostazione predefinita: testo, opzionale)
+ **Tabella estratta** (output): nome della variabile che memorizza la tabella dei dati estratti (impostazione predefinita: extracted\$1table)
**Identificazione dell'elemento:**
+ È necessario abilitare almeno un metodo di identificazione degli elementi
**Note d'uso:**
+ I tipi di dati aggiuntivi vengono salvati in colonne separate (ad esempio, columnName\$1href per i collegamenti)
+ Disattiva l'estrazione intelligente per tabelle con più di 100 righe per prestazioni migliori
## Fai uno screenshot
Cattura un'immagine della pagina web. Lo screenshot viene salvato in un file per essere utilizzato successivamente nel processo.
**Proprietà:**
+ **Nome file** (opzionale): nome del file di immagine salvato. Generato automaticamente se vuoto (ad esempio, «Immagine dello screenshot»)
+ **Tipo di file** (menu a discesa): scegli il formato dell'immagine: PNG o JPEG (predefinito: PNG, opzionale)
+ **File screenshot** (output): nome variabile che memorizza il file dello screenshot (impostazione predefinita: screenshot\$1file)
## Domande e risposte visive
Rispondi a domande su una pagina web. Utilizza l'intelligenza artificiale per analizzare visivamente la pagina e rispondere a true/false domande sul contenuto.
**Proprietà:**
+ **Domanda** (obbligatorio): inserisci la tua true/false domanda sul contenuto della pagina web (ad esempio, «Il prodotto è disponibile?»)
+ **Autoriparazione** (casella di controllo): utilizza l'intelligenza artificiale per gestire automaticamente i popup imprevisti (impostazione predefinita: OFF, opzionale)
+ **Risposta** (output): nome della variabile che memorizza la true/false risposta (impostazione predefinita: is\$1true)
## Fai clic e carica i file
Carica i file su una pagina web. Utilizzato per automatizzare la selezione dei file facendo clic su un pulsante di caricamento dei file e scegliendo i file da caricare.
**Proprietà:**
+ **File da caricare** (obbligatorio): l'elenco dei file da caricare, in genere archiviato in una variabile (ad esempio, [my\$1file1, my\$1file2])
+ **Trova elemento con descrizione** (pulsante di opzione): utilizza la descrizione in linguaggio naturale per identificare l'elemento con l'intelligenza artificiale (impostazione predefinita: ON)
+ **Campo descrizione** (obbligatorio a determinate condizioni): descrizione in linguaggio naturale (ad esempio, «pulsante Carica»)
+ **Trova elemento con selettore** (pulsante di opzione): utilizza l' XPath espressione per identificare l'elemento (impostazione predefinita: OFF)
+ **XPath Campo** (obbligatorio condizionalmente): XPath espressione (ad esempio, «//input [@id ='xyz']»)
+ **Autoriparazione (**casella di controllo): usa l'IA per gestire automaticamente i popup imprevisti (impostazione predefinita: OFF, opzionale)
+ **Pulsante del mouse** (menu a discesa): su quale pulsante del mouse fare clic: sinistro, centrale o destro (impostazione predefinita: sinistra, opzionale)
+ **Tipo di clic** (menu a discesa): clic singolo o doppio (impostazione predefinita: singolo, opzionale)
**Requisiti del file:**
+ Deve essere una matrice di media/file oggetti
**Identificazione degli elementi:**
+ È necessario abilitare almeno un metodo di identificazione degli elementi
## Inserisci Keystroke
Invia un comando da tastiera o una scorciatoia. Utilizzato per automatizzare la digitazione di singoli tasti o combinazioni di tasti su una pagina Web.
**Proprietà:**
+ **Tasti speciali** (menu a discesa, obbligatorio): seleziona modificatori come Ctrl, Alt, Shift o sequenze di tasti singole come Invio, Tab, Pagedown
+ **Tasto di comando** (opzionale): inserisci il tasto da usare in combinazione con il tasto speciale (ad esempio, «c» per Ctrl\$1c)
+ **Trova elemento con descrizione** (pulsante di opzione): utilizza la descrizione in linguaggio naturale per identificare l'elemento con l'intelligenza artificiale (impostazione predefinita: ON)
+ **Campo descrizione** (obbligatorio a determinate condizioni): descrizione in linguaggio naturale (ad esempio, «Barra di ricerca»)
+ **Trova elemento con selettore** (pulsante di opzione): utilizza l' XPath espressione per identificare l'elemento (impostazione predefinita: OFF)
+ **XPath Campo** (obbligatorio condizionalmente): XPath espressione (ad esempio, «//input [@id ='xyz']»)
+ **Autoriparazione (**casella di controllo): usa l'IA per gestire automaticamente i popup imprevisti (impostazione predefinita: OFF, opzionale)
**Identificazione degli elementi:**
+ Entrambi gli interruttori degli elementi possono essere disattivati: la sequenza di tasti viene inviata al campo attivo corrente se non è definito alcun elemento
## Attendi l'elemento
Verifica la presenza di un elemento. Utilizzato per attendere le modifiche o convalidare le condizioni su una pagina Web. Restituisce true se l'elemento viene trovato entro il tempo di attesa massimo, false in caso contrario.
**Proprietà:**
+ **Titolo dell'azione** (solo testo): nome visualizzato dell'azione
+ **Element Selector** (obbligatorio): XPath espressione per definire l'elemento da controllare (ad esempio, «//input [@id ='xyz']»)
+ **Tempo di attesa massimo** (opzionale): tempo massimo di attesa in secondi per la visualizzazione dell'elemento (impostazione predefinita: 30)
+ **Element Found** (output): nome della variabile che memorizza se l'elemento è stato trovato (True/False) (impostazione predefinita: is\$1found)
**Convalida:**
+ Il tempo di attesa massimo deve essere un numero intero o decimale
## Trova elementi corrispondenti
Ottiene gli elementi che corrispondono a uno schema. Utilizzato per ottenere un elenco di elementi simili su una pagina Web che è possibile elaborare uno per uno.
**Proprietà:**
+ **Element Selector** (richiesto): XPath espressione per definire il modello per gli elementi che si desidera ottenere (ad esempio, «//div [@class ='abc']»)
+ **Elenco di elementi** (output): nome della variabile che memorizza l'elenco degli elementi trovati (predefinito: element\$1list)
**Note d'uso:**
+ L'elenco è vuoto se non vengono trovati elementi corrispondenti
+ Utilizzalo per elaborare più elementi simili come risultati di ricerca o collegamenti ipertestuali
## Attendi una nuova finestra
Verifica l'apertura di una nuova finestra. Utilizzato dopo aver fatto clic su un collegamento o un pulsante che apre una nuova finestra secondaria nella sessione corrente del browser.
**Proprietà:**
+ **Tempo di attesa massimo** (opzionale): tempo massimo di attesa in secondi per la visualizzazione della nuova finestra (impostazione predefinita: 30)
+ **Identificatore di finestra** (output): nome della variabile che memorizza l'identificatore per la nuova finestra (impostazione predefinita: window\$1id)
**Note d'uso:**
+ Se il tempo supera e la finestra non viene trovata, si verifica un'eccezione
+ L'identificatore della finestra può essere utilizzato per cambiare lo stato attivo o chiudere la finestra
**Convalida:**
+ Il tempo di attesa massimo deve essere un numero intero o decimale
## Cambia finestra
Cambia le finestre del browser. Dopo aver spostato lo stato attivo sulla finestra specificata, le azioni successive del browser interagiscono con quella finestra.
**Proprietà:**
+ **Identificatore di finestra** (opzionale): la finestra a cui si desidera passare, in genere memorizzata in una variabile (ad esempio, window\$1id). Lascia vuoto per passare alla finestra principale
## Chiudi finestra
Chiude una finestra del browser. Una volta chiusa, l'automazione torna alla finestra principale della sessione corrente del browser.
**Proprietà:**
+ **Identificatore di finestra** (obbligatorio): la finestra che si desidera chiudere, in genere memorizzata in una variabile (ad esempio, window\$1id)
## Salva negli Appunti
Copia il testo negli appunti. Viene utilizzato per salvare testo da incollare in un secondo momento. Il testo esistente negli appunti viene sostituito.
**Proprietà:**
+ **Testo da salvare** (obbligatorio): il testo che desideri copiare negli appunti (ad esempio, «Order \$112345 «)
## Incolla dagli Appunti
Inserisce il testo dagli appunti. Utilizzato per incollare il testo copiato nei campi delle pagine Web.
**Proprietà:**
+ **Trova elemento con descrizione** (pulsante di opzione): utilizza la descrizione in linguaggio naturale per identificare l'elemento con l'intelligenza artificiale (impostazione predefinita: ON)
+ **Campo descrizione** (obbligatorio a determinate condizioni): descrizione in linguaggio naturale (ad esempio, «campo numero dell'ordine»)
+ **Trova elemento con selettore** (pulsante di opzione): utilizza l' XPath espressione per identificare l'elemento (impostazione predefinita: OFF)
+ **XPath Campo** (obbligatorio condizionalmente): XPath espressione (ad esempio, «//input [@id ='xyz']»)
+ **Autoriparazione (**casella di controllo): usa l'IA per gestire automaticamente i popup imprevisti (impostazione predefinita: OFF, opzionale)
+ **Sostituisci testo esistente** (casella di controllo): cancella qualsiasi testo preesistente nel campo prima di incollarlo (impostazione predefinita: ON)
**Identificazione dell'elemento:**
+ È necessario abilitare almeno un metodo di identificazione degli elementi
## Aggiorna pagina Web
Ricarica la pagina Web corrente. Alcune pagine potrebbero reindirizzare durante l'aggiornamento.
**Proprietà:**
+ **Titolo dell'azione** (solo testo): nome visualizzato dell'azione
## Riavvia il browser
Chiude e riapre il browser. Una nuova sessione inizia da una pagina vuota.
**Proprietà:**
+ **Riavvia tutto** (casella di controllo): chiude e riavvia tutte le finestre del browser, non solo quella corrente (impostazione predefinita: OFF, opzionale)
## Limitazioni
**Incertezza nell'identificazione degli elementi**: se l'IA non è in grado di identificare in modo affidabile gli elementi dell'interfaccia utente, le azioni falliscono con errori ''. LowConfidence In questi casi, utilizza XPath selettori o descrizioni degli elementi più specifici. **Compatibilità dei browser**: il sistema funziona esclusivamente con le istanze del browser Chrome e utilizza Playwright come framework di automazione sottostante, il che significa che la compatibilità è limitata alle tecnologie web supportate da Chrome e potrebbe non funzionare con le funzionalità specifiche dei browser di altri fornitori. **Sfide relative ai contenuti dinamici: le** pagine altamente dinamiche con frequenti modifiche al layout, JavaScript framework pesanti o applicazioni complesse a pagina singola possono richiedere tempi di attesa aggiuntivi, logica di riprova o approcci di gestione specializzati. **Sovraccarico prestazionale**: le funzionalità basate sull'intelligenza artificiale come il targeting degli elementi in linguaggio naturale e le funzionalità di correzione automatica richiedono più tempo di elaborazione rispetto al targeting diretto. XPath