Skip to main content

Microsoft Excel - Driver Alteryx

Alteryx dispone di driver di lettura e scrittura nativi integrati per Microsoft Excel. Per leggere e scrivere fogli .xlsx in Alteryx Designer non è richiesta l'installazione di driver o altre configurazioni di sistema.

Configurazione

Le opzioni del formato file dello Strumento Dati di output disponibili per i file Microsoft Excel (.xlsx) tramite il driver Alteryx forniscono le funzionalità seguenti:

  • Crea nuovo foglio

  • Sovrascrivi file (rimuovi)

  • Sovrascrivi foglio (rilascia)

  • Aggiungi al foglio esistente

Lunghezza e limiti

Durante la lettura e la scrittura di file .xlsx, il driver Alteryx supporta interamente i limiti documentati per le righe e le colonne in Excel.

Numero massimo di righe (limite specificato da Excel)

1,048,575

Numero massimo di colonne (limite specificato da Excel)

16,384

Limiti di lunghezza del nome di colonna e del nome di campo

Il valore consigliato è 256 per la compatibilità con altri formati

Superamento dei limiti di numero di record (1.048.575 righe e 16.384 colonne)

Il superamento dei limiti di colonna genera un errore e il superamento dei limiti di riga causa un file troncato

Superamento del limite di dimensione dei file (4.294.967.295 byte, ~4 GB)

Viene visualizzato il messaggio "I dati che si stanno scrivendo su questo foglio sono troppo grandi. Interruzione del processo."

Tipi di dati

Il driver Alteryx analizza i dati del foglio per determinare un tipo di dati e un nome di campo per ciascuna colonna.

Analisi dei tipi di dati

Se in una colonna è presente una combinazione di tipi di dati, il tipo di dati per la colonna sarà impostato su String/WString.

Valori stringa

Quando possibile, vengono restituite stringhe strette.

Arrotondamento dei numeri

La formattazione assegnata alla cella verrà ignorata. Ad esempio, se una cella contiene il valore 1,27952 e la cella è formattata in modo da visualizzare 2 posizioni decimali, verrà restituito il valore completo di 1,27952 invece di 1,28.

Tipi Data, Ora e Data e ora

Tutte le date e gli orari sono visualizzati in formato Alteryx. Un tipo Data viene formattato in base all'analisi dei dati nella colonna.

  • Se ogni valore nella colonna è solo di tipo Data (ad esempio, 2014/11/04 o 4 maggio senza la componente ora), il tipo di dati sarà impostato su Data come AAAA-MM-GG.

  • Se ogni valore nella colonna contiene solo informazioni temporali senza la componente data, il tipo di dati sarà impostato su Ora come HH:MM:SS.

  • Se i valori dei dati nella colonna sono costituiti da componenti data e da componenti ora, il tipo di dati sarà impostato su Data e ora come AAAA-MM-GG HH:MM:SS.

  • I formati data personalizzati vengono ignorati. Qualsiasi formattazione personalizzata applicata a una data in Excel viene ignorata - Alteryx analizza solo i valori effettivi dei dati. Ad esempio, se una cella contiene un valore completo di data e ora ma è formattata per visualizzare solo la data o solo l'ora, Alteryx ignorerà la formattazione e valuterà invece il valore dei dati non elaborati contenuti nella cella. Ciò può portare a risultati imprevisti se è stata utilizzata la formattazione personalizzata per mostrare o nascondere parti del valore di data/ora.

Nomi di campo

  • Duplicate field/column names: The following column names in the original Excel file: abc, abc, abc, 123, 123, and 123 are read as: abc, abc2, abc3, 123, 123_2, and 123_3.

  • Column names formatted as dates: Column names formatted as dates in the original Excel file (for example, 1/1/2014, 2/1/2014, 3/1/2014) generate column names formatted using the default Alteryx date format: 2014-01-01, 2014-02-01, 2014-03-01.

  • Special characters in sheet and range names: Alteryx now supports all characters supported by Excel for sheet names. If Excel allows a character to be used when naming a sheet, the new driver can read it and does not convert or change any characters.

    These characters are not valid for sheet names: \, /, ?, *, [, and ].

Formatting in Empty Column Cells

Formatting (for example, borders) applied to empty cells can make a row appear present in Alteryx. This affects column header detection. Use the "Start Data Import on Line" option or ensure consistent formatting and avoid unexpected behavior.

Errori delle formule

Quando una formula in un foglio genera un errore, Alteryx restituisce un valore NULL per i campi che non sono di tipo stringa e la stringa di errore effettiva per i campi il cui tipo è stringa.

Intervalli

Il driver Alteryx per Microsoft Excel fornisce:

  • Supporto di lettura per intervalli denominati ed espliciti.

  • Supporto di scrittura per intervalli espliciti. Supporta la sovrascrittura per gli intervalli denominati ma non può crearne di nuovi.

Nota

Alteryx supporta la conservazione della formattazione delle celle durante la sovrascrittura, a eccezione dei modelli.

Nomi dei fogli di output dei dati

Il driver Alteryx per Microsoft Excel fornisce supporto di lettura per un elenco di nomi foglio.

Dates and Excel

Date-Time Precision

While Alteryx now supports date-time precision to sub-seconds, the same high-precision date-time (date-time data with a higher resolution than seconds) is not supported in XLSX. If you attempt to write high-precision date-time data from Alteryx to XLSX, you will receive a Field Conversion Error that indicates that your high-precision date is truncated to seconds, for example:

High precision Time is not supported in XLSX and values are truncated to seconds: field "@1".

There are a couple of options you might consider:

  • As a potential workaround, you might consider formatting your date-time data as a string before you write to XLSX. This allows Excel formulas to work with the data, though fractional seconds are ignored.

  • Alternatively, you can use a Select tool to truncate your date-time data and avoid triggering the above warning in Alteryx.

Dates Prior to 1900

Excel does not support dates before 1900. Calculations involving dates from Jan 1, 1900, to Mar 1, 1900, produce incorrect results. For more information on this issue, go to Microsoft documentation.

Supporto FileTable

Il driver Alteryx supporta la lettura e la scrittura di un file Excel situato in una FileTable di Microsoft SQL Server, accedendo al percorso UNC della FileTable e eseguendo la mappatura nel file come un file archiviato su un'unità di rete. Per scrivere un file Excel in una FileTable di Microsoft SQL Server, l'opzione specifica del formato Attiva il supporto FileTable di SQL Server nello strumento Output deve essere selezionata.

Opzioni di output per il supporto di scrittura di file XLSX

  • Create New Sheet

    • If a file exists, a new sheet is created. If there is already a sheet with the same name, an error displays.

    • If a file doesn't exist, a new file and sheet are created.

  • Append to Existing Sheet

    • If a file exists, data is written in the specified sheet. If the specified sheet doesn’t exist, there is an error.

    • If a file doesn't exist, data is not written.

  • Overwrite Sheet or Range

    • If a file exists, the specified sheet is deleted if it exists, and then data is written in a new sheet with the specified name.

    • If a file doesn't exist, a new file and sheet are created.

  • Overwrite File (Remove)

    • If a file exists, the file is deleted, and data is written in a new sheet in a new file.

    • If a file doesn't exist, a new file and sheet are created.

Ulteriori informazioni per il supporto di scrittura di file XLSX con intervalli

Crea foglio/Sovrascrivi file

Aggiungi foglio

Sovrascrivi foglio

È possibile utilizzare intervalli espliciti.

Non è possibile utilizzare un intervallo denominato poiché un intervallo denominato è legato a un foglio e non è presente alcun foglio.

È possibile utilizzare sia gli intervalli espliciti che quelli denominati.

Un intervallo denominato deve essere stato precedentemente definito per il foglio.

È possibile utilizzare sia gli intervalli espliciti che quelli denominati.

Un intervallo denominato deve essere stato precedentemente definito per il foglio.

I dati non possono contenere più colonne rispetto all'intervallo specificato, ma possono contenerne meno.

Se i dati in entrata non sono sufficienti per riempire l'intervallo, le colonne verranno riempite con valori null.

I dati non possono contenere più colonne rispetto all'intervallo specificato, ma possono contenerne meno.

Se nell'intervallo sono presenti meno colonne in entrata, le colonne non mappate verranno riempite con valori null.

I dati non possono contenere più colonne rispetto all'intervallo specificato, ma possono contenerne meno.

Se i dati in entrata non sono sufficienti per riempire l'intervallo, le colonne verranno riempite con valori null.

I dati vengono scritti a partire dalla cella in alto a sinistra della prima riga dell'intervallo specificato.

I dati vengono aggiunti a partire dalla prima riga disponibile dopo i dati originali. In caso di aggiunta, nessun dato esistente verrà sovrascritto.

I dati non possono essere scritti in un foglio che contiene celle unite.

I nomi delle colonne devono essere inclusi nell'intervallo. Se la prima riga dell'intervallo è vuota, per i nomi di colonna verrà utilizzata la prima riga dell'intervallo che contiene dati. Se i nomi di colonna non corrispondono ai dati in entrata devono essere mappati manualmente ai nomi di output utilizzando Custom Append Mapper (Mapping di aggiunta personalizzato) nello strumento Dati di output.

I dati vengono scritti a partire dalla cella in alto a sinistra della prima riga dell'intervallo specificato.

I dati non possono essere scritti in un foglio che contiene celle unite

I dati possono contenere più righe rispetto all'intervallo specificato.

I dati saranno scritti oltre l'intervallo specificato fino a quando:

  • Tutti i dati sono stati scritti

  • Viene superato il numero massimo di righe (1.048.575)

I dati possono contenere più righe rispetto all'intervallo specificato.

I dati saranno scritti oltre l'intervallo specificato fino a quando:

  • Tutti i dati sono stati scritti

  • Viene superato il numero massimo di righe (1.048.575)

I dati possono contenere più righe rispetto all'intervallo specificato.

I dati saranno scritti oltre l'intervallo specificato fino a quando:

  • Tutti i dati sono stati scritti

  • Viene superato il numero massimo di righe (1.048.575)

  • Vengono rilevati dati esistenti