Excel

Le azioni di Excel ti consentono di leggere, aggiornare e creare file Excel nelle tue automazioni. Tutte le azioni di Excel supportano i formati di file xlsx e xlsm. Gli identificatori delle cartelle di lavoro mantengono i riferimenti tra più operazioni.

Nota

Sebbene i valori possano essere letti dai file.xlsm, l'esecuzione di macro non è supportata.

Crea nuova cartella di lavoro

Crea un file Excel vuoto. Emette un identificatore della cartella di lavoro che puoi utilizzare per aggiornare il foglio di calcolo nei passaggi successivi.

Proprietà:

• Identificatore della cartella di lavoro (output): nome della variabile che memorizza il riferimento della cartella di lavoro per azioni future (impostazione predefinita:) workbook_id

Apri cartella di lavoro esistente

Carica un file Excel esistente. Restituisce un identificatore della cartella di lavoro che puoi utilizzare per aggiornare il foglio di calcolo nei passaggi successivi. Supporta solo file Excel (.xlsx).

Proprietà:

• File Excel (obbligatorio): il file.xlsx da aprire, in genere memorizzato in una variabile (ad esempio,) my_file

• Identificatore della cartella di lavoro (output): nome della variabile che memorizza il riferimento della cartella di lavoro (impostazione predefinita:) workbook_id

Requisiti dei file:

• Deve essere un file Excel (.xlsx) valido

• Il file deve essere accessibile come oggetto di file multimediale

Salva cartella di lavoro

Salva gli aggiornamenti in un file Excel. Consente di aggiornare il nome e il tipo di file per la cartella di lavoro salvata.

Proprietà:

• Nome file (obbligatorio): nome del file salvato senza estensione (ad esempio, «Rapporto mensile»)

• Tipo di file (menu a discesa): formato di output, attualmente supporta XLSX (impostazione predefinita: XLSX)

• File salvato (output): variabile che memorizza l'oggetto file salvato (impostazione predefinita:) saved_file

Leggi il foglio

Ottiene dati da un intervallo di celle. L'azione memorizza l'output in una variabile di tabella dati.

Proprietà:

• Identificatore della cartella di lavoro (obbligatorio): la cartella di lavoro da cui leggere (ad esempio,) workbook_id

• Nome del foglio (obbligatorio): nome del foglio di lavoro o della scheda (predefinito: «Sheet1")

• Intervallo di celle (opzionale): specifica dell'intervallo: supporta più formati:

  • Cella iniziale: «A2" (legge tutti i dati dal punto di ancoraggio)

  • Intervallo esatto: «A1:B10"

  • Intervallo di colonne: «A:B»

  • Intervallo di righe: "1:3»

  • Vuoto: legge l'intero foglio

• Includi intestazioni (casella di controllo): se abilitata, considera la prima riga come intestazioni di colonna. Se disattivata, utilizza la denominazione predefinita (Colonna0, Colonna1, ecc.) (impostazione predefinita: TRUE)

• Tabella dati (output): variabile che memorizza i dati estratti (impostazione predefinita:excel_table)

Gestione delle formule:

• L'azione calcola automaticamente le formule e memorizza i risultati nella tabella di dati.

Leggi la cella

Ottiene il valore da una cella. Utilizzato per leggere il valore di una singola cella da un foglio di lavoro.

Proprietà:

• Identificatore della cartella di lavoro (obbligatorio): la cartella di lavoro da cui leggere (ad esempio,) workbook_id

• Nome del foglio (richiesto): nome del foglio di lavoro (predefinito: «Sheet1")

• Riferimento di cella (richiesto): posizione della cella (ad esempio, «A1")

• Valore della cella (output): variabile che memorizza il contenuto della cella (impostazione predefinita:) cell_value

Scrivi sul foglio

Emette una tabella di dati su un foglio. Utilizzato per scrivere un intervallo di righe e colonne in un foglio di lavoro.

Proprietà:

• Tabella dati (richiesta): la tabella di dati da scrivere (ad esempio,my_table)

• Identificatore della cartella di lavoro (richiesto): cartella di lavoro di destinazione (ad es.) workbook_id

• Nome del foglio (obbligatorio): foglio di lavoro di destinazione (predefinito: «Sheet1")

• Inizia dalla cella (opzionale): posizione iniziale per il posizionamento dei dati (impostazione predefinita: «A1")

• Includi intestazioni (casella di controllo): scrive le intestazioni delle colonne quando abilitata (impostazione predefinita: TRUE)

Scrivi su una cella

Restituisce un valore a una cella. Utilizzato per aggiornare singole celle in un foglio di lavoro.

Proprietà:

• Valore da scrivere (obbligatorio): contenuto della cella (ad esempio, «Order #12345 «)

• Identificatore della cartella di lavoro (richiesto): cartella di lavoro di Target (ad esempio,) workbook_id

• Nome del foglio (obbligatorio): foglio di lavoro di destinazione (predefinito: «Sheet1")

• Riferimento di cella (richiesto): posizione della cella di destinazione (ad esempio, «A1")

Scrivi una nuova riga

Aggiunge una riga di dati al foglio. La nuova riga viene aggiunta alla fine dei dati esistenti.

Proprietà:

• Valori di riga (obbligatorio): matrice di valori per la nuova riga, a partire dalla prima colonna (ad esempio, ["Q1", «Sales», 100])

• Identificatore della cartella di lavoro (richiesto): cartella di lavoro di destinazione (ad es.) workbook_id

• Nome del foglio (obbligatorio): foglio di lavoro di destinazione (predefinito: «Sheet1")

Convalida dei dati:

• È necessario fornire valori come formato di matrice

• I valori vengono scritti in sequenza a partire dalla prima colonna

Crea nuovo foglio

Aggiunge un foglio di lavoro vuoto. Il nuovo foglio viene aggiunto alla fine della cartella di lavoro.

Proprietà:

• Identificatore della cartella di lavoro (obbligatorio): cartella di lavoro di destinazione (ad esempio,) workbook_id

• Nome del foglio (richiesto): nome per il nuovo foglio di lavoro (ad esempio, «Dati di vendita»)

Copia foglio

Crea una copia del foglio di lavoro. Il nuovo foglio viene creato all'interno della stessa cartella di lavoro.

Proprietà:

• Identificatore della cartella di lavoro (obbligatorio): cartella di lavoro di destinazione (ad esempio,) workbook_id

• Nome del foglio da copiare (richiesto): nome del foglio di lavoro di origine (ad esempio, «Foglio originale»)

• Nuovo nome del foglio (richiesto): nome per il foglio duplicato (ad esempio, «Foglio originale (copia)»)

Rinomina foglio

Aggiorna il nome di un foglio di lavoro esistente.

Proprietà:

• Identificatore della cartella di lavoro (obbligatorio): cartella di lavoro di destinazione (ad esempio,) workbook_id

• Nome del foglio corrente (richiesto): nome del foglio di lavoro esistente (ad esempio, «Sheet1")

• Nome del foglio aggiornato (richiesto): nuovo nome per il foglio di lavoro (ad esempio, «Dati Q1")

Elimina foglio

Rimuove un foglio da una cartella di lavoro. Impossibile eliminare l'ultimo foglio rimanente di una cartella di lavoro.

Proprietà:

• Identificatore della cartella di lavoro (obbligatorio): cartella di lavoro di destinazione (ad esempio,) workbook_id

• Nome del foglio da eliminare (obbligatorio): foglio di lavoro da rimuovere (ad esempio, «Sheet1")

Vincoli:

• Impossibile eliminare l'ultimo foglio rimasto in una cartella di lavoro

Imposta il colore della cella

Aggiorna il colore di sfondo delle celle. Utilizzato per evidenziare un intervallo specifico di celle.

Proprietà:

• Colore della cella (richiesto): formato di codice esadecimale RGB (ad esempio, FF0000 "" per rosso)

• Identificatore della cartella di lavoro (obbligatorio): cartella di lavoro di Target (ad esempio,) workbook_id

• Nome del foglio (richiesto): foglio di lavoro di destinazione (ad esempio, «Sheet1")

• Intervallo di celle (richiesto): Intervallo di formato - supporta:

  • Cella singola: «A1"

  • Intervallo esatto: «A1:B10"

  • Intervallo di colonne: «A:B»

  • Intervallo di righe: "1:3»

Ottieni Cell Color

Legge il colore di sfondo della cella. Emette il colore in formato di codice esadecimale RGB (ad esempio, "FF0000" per rosso).

Proprietà:

• Identificatore della cartella di lavoro (obbligatorio): cartella di lavoro di origine (ad esempio,) workbook_id

• Nome del foglio (richiesto): foglio di lavoro di origine (ad esempio, «Sheet1")

• Riferimento di cella (richiesto): cella da leggere (ad esempio, «A1")

• Colore della cella (output): variabile che memorizza il codice esadecimale RGB (impostazione predefinita:) cell_color

Nascondi righe

Nasconde le righe nel foglio. I dati rimangono intatti ma non sono visibili.

Proprietà:

• Identificatore della cartella di lavoro (obbligatorio): cartella di lavoro di destinazione (ad esempio,) workbook_id

• Nome del foglio (richiesto): foglio di lavoro di destinazione (ad esempio, «Sheet1")

• Riga iniziale (obbligatorio): primo numero di riga da nascondere (la numerazione di Excel parte da 1)

• Riga finale (opzionale): ultimo numero di riga da nascondere. Se è vuota, viene nascosta solo la riga iniziale

Numerazione delle righe:

• I numeri di riga di Excel iniziano da 1 (non da 0)

• È necessario fornire valori interi

Mostra righe

Rende visibili le righe nascoste. Utilizzato per mostrare righe precedentemente nascoste.

Proprietà:

• Identificatore della cartella di lavoro (obbligatorio): cartella di lavoro di destinazione (ad esempio,) workbook_id

• Nome del foglio (richiesto): foglio di lavoro di destinazione (ad esempio, «Sheet1")

• Riga iniziale (obbligatorio): primo numero di riga da mostrare (la numerazione di Excel parte da 1)

• Riga finale (opzionale): ultimo numero di riga da mostrare. Se è vuota, viene resa visibile solo la riga iniziale

Migliori pratiche e limitazioni

Gestione degli identificatori delle cartelle di lavoro

• Memorizza gli identificatori delle cartelle di lavoro in variabili descrittive (ad esempio,) sales_workbook report_file

• Riutilizza lo stesso identificatore per più azioni sulla stessa cartella di lavoro

• Crea o apri sempre una cartella di lavoro prima di eseguire operazioni sui dati

Specifiche dell'intervallo

• Utilizza intervalli esatti («A1:B10") per operazioni precise sui dati

• Usa intervalli di colonne («A:B») quando lavori con colonne intere

• Usa gli intervalli di righe (» 1:3 «) per le operazioni di intestazione o di riepilogo

• Lascia l'intervallo vuoto per elaborare interi fogli

Ottimizzazione delle prestazioni

• Leggi interi intervalli quando possibile anziché singole celle

• Operazioni di scrittura in batch utilizzando tabelle di dati anziché scritture di singole celle

• Salva le cartelle di lavoro solo quando tutte le modifiche sono state completate

Limitazione

La compatibilità dei file è limitata solo al formato Excel moderno (.xlsx), mentre i file Excel precedenti (.xls) non sono supportati.