Per gestire le cartelle di lavoro di Microsoft Excel® come parte di una catena, aggiungi un passaggio che includa un comando di connessione a Microsoft Excel.
Nota: Il connettore Microsoft Excel supporta le cartelle di lavoro Excel (XLSM) abilitate alle macro, ma non esegue macro Virtual Basic for Applications (VBA) o macro basate su eventi come Workbook Open, BeforeSave o SheetCalculate.
Per abilitare questi comandi, un amministratore IT deve prima creare un connettore Microsoft Excel.
Crea cartella di lavoro da file
Per creare o aggiornare una cartella di lavoro Excel con fogli basati su dati provenienti da file di valori separati da delimitatori, usa il comando Create Workbook from Files.
Tieni presente che ci sono due opzioni di output in base a come è configurato il tuo connettore:
- Se utilizzi un GroundRunner , inserisci un oggetto Javascript Object Notation (JSON).
- Se utilizzi un CloudRunner , specifica le uscite dei comandi o le risorse all'interno della catena.
Proprietà
| Proprietà |
Dettaglio |
| File |
Specifica i file da creare come fogli separati nella cartella di lavoro:
- Per i file basati su uscite o risorse all'interno della catena, clicca su Aggiungi per ogni file, seleziona la sua uscita o risorsa e inserisci il nome del suo foglio (fino a 31 caratteri).
Suggerimento: Per recuperare un file da una posizione di rete, usa il comando File Utilities connettore's Get file precedente nella catena.
- Per specificare i file come JSON, seleziona Abilita la variabile e inserisci il JSON o seleziona l'oggetto JSON dall'output di un comando precedente. Formatta il JSON come:
[
{"file": "fullPathToFile_1", "nome": "sheetName_1"},
{"file": "fullPathToFile_2", "nome": "sheetName_2"}
] Nota: Per includere il file di output di un comando precedente nel JSON, inserisci il percorso completo della sua posizione nella cartella di elaborazione di GroundRunner.
|
| Delimitatore |
Seleziona il delimitatore utilizzato nei file. |
| Nome della cartella di lavoro |
Per creare una nuova cartella di lavoro basata sui file, inserisci un nome univoco che ne faciliti l'identificazione. Nota: Il comando crea automaticamente un'estensione .xlsx se non viene fornita. |
| Cartella di lavoro esistente |
Per aggiungere i dati dei file a una cartella di lavoro esistente anziché a una nuova, seleziona il file della cartella di lavoro da aggiornare. Qualsiasi foglio con un nome inserito in File viene sovrascritto. Importante: Se utilizzi questo comando su un file protetto, la cartella di lavoro risultante non sarà protetta. Questo significa che devi riaggiungere manualmente la crittografia quando lavori con un file protetto. |
Output
| Output |
Tipo di output |
| Cartella di lavoro XLSX |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Comando riuscito |
| 1 |
Errore |
Errore generale |
Elenco di fogli
Per creare un elenco JSON di tutti i fogli di una cartella di lavoro Excel, usa il comando List Sheets.
Proprietà
| Proprietà |
Dettaglio |
| File della cartella di lavoro |
Inserisci la cartella di lavoro XLS o XLSX di cui elencare i fogli. |
| Password |
Se Il file della cartella di lavoro è una cartella di lavoro XLSX protetta da password, inserisci la sua password. |
Output
| Output |
Tipo di output |
| Fogli JSON |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Comando riuscito |
| 1 |
Errore |
Errore generale |
Foglio di lavoro in CSV
Per convertire i dati contenuti nel foglio di una cartella di lavoro Excel in un file tabellare, usa il comando Worksheet to CSV.
Nota: Il comando Worksheet to CSV estrae gli ultimi valori calcolati nel foglio di lavoro; non vengono eseguiti calcoli formula per aggiornare i valori. Per i fogli di lavoro con i calcoli automatici disattivati, calcola e salva manualmente i valori prima dell'esecuzione della catena per garantire l'accuratezza.
Proprietà
| Proprietà |
Dettaglio |
| File della cartella di lavoro |
Inserisci la cartella di lavoro XLS o XLSX con il foglio da convertire in un file tabellare. |
| Password |
Se il file della cartella di lavoro è una cartella di lavoro XLSX protetta da password, inserisci la sua password. |
| Delimitatore |
Seleziona il delimitatore da utilizzare nel file di output. |
| Nome del foglio |
Inserisci il nome del foglio della cartella di lavoro da convertire. Se invece vuoi identificare il foglio con il suo indice, lascia in bianco. |
| Indice dei fogli |
Inserisci la posizione dell'indice del foglio nella cartella di lavoro da convertire, con 1 per il primo foglio e -1 per l'ultimo. Per identificare il foglio con il suo nome, lascia vuoto. |
| Cella iniziale |
Inserisci la cella della prima riga e della prima colonna dei dati del foglio da convertire. |
| Fine colonna |
In notazione A1, inserisci la lettera della colonna (ad esempio A, B o C, senza il numero della riga) in cui finiscono i dati da convertire. Nota: Il comando ignora tutti i dati presenti nel foglio dopo questa colonna. |
| Fine riga |
In notazione A1, inserisci il numero della riga (ad esempio 10, 200, 3000, senza la lettera della colonna) in cui terminano i dati da convertire. Per ignorare la riga, digita 0. Nota: Il comando ignora tutti i dati della colonna successiva a questa riga. |
| Usa valori di cella formattati |
Per convertire i valori di visualizzazione delle celle invece dei loro valori grezzi, ad esempio per la gestione di data e ora, seleziona questa casella. |
| Anteprima dei risultati |
Per abilitare un'anteprima del file di output, seleziona questa casella. |
| Modalità Streaming |
Applicabile solo a file XLSX di grandi dimensioni. Consigliato per file superiori a 20mb. Legge il file in finestre di dati più piccole per ridurre l'utilizzo della memoria. Alcune formule, in particolare quelle che fanno riferimento a celle più lontane nel file, potrebbero non funzionare correttamente quando questa impostazione è attivata in combinazione con l'opzione Valori formattati. |
Output
| Output |
Tipo di output |
| Uscita CSV |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Comando riuscito |
| 1 |
Errore |
Errore generale |