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à.

# Excel
<a name="actions-excel"></a>

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
<a name="create-new-workbook"></a>

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
<a name="open-existing-workbook"></a>

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
<a name="save-workbook"></a>

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
<a name="read-sheet"></a>

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
<a name="read-cell"></a>

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
<a name="write-to-sheet"></a>

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
<a name="write-to-cell"></a>

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 \$112345 «)
+ **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
<a name="write-new-row"></a>

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
<a name="create-new-sheet"></a>

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
<a name="copy-sheet"></a>

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
<a name="rename-sheet"></a>

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
<a name="delete-sheet"></a>

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
<a name="set-cell-color"></a>

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
<a name="get-cell-color"></a>

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
<a name="hide-rows"></a>

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
<a name="unhide-rows"></a>

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
<a name="excel-best-practices-limitations"></a>

### Gestione degli identificatori delle cartelle di lavoro
<a name="excel-workbook-identifier-management"></a>
+ 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
<a name="excel-range-specifications"></a>
+ 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
<a name="excel-performance-optimization"></a>
+ 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
<a name="excel-limitation"></a>

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