Google Sheets moduli
- Argomenti:
- Documenti e contenuti digitali
Creato per:
- Utente
In uno scenario Adobe Workfront Fusion, è possibile automatizzare i flussi di lavoro che utilizzano Google Sheets e collegarlo a più applicazioni e servizi di terze parti.
Per istruzioni sulla connessione dell'account Google Sheets a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base
Requisiti di accesso
Per utilizzare le funzionalità di questo articolo, è necessario disporre dei seguenti diritti di accesso:
Adobe Workfront piano* | Pro o versione successiva |
Adobe Workfront licenza* | Plan, Work |
Adobe Workfront Fusion licenza** |
Requisiti di licenza correnti: nessun requisito di licenza Workfront Fusion. Oppure Requisito licenza legacy: Workfront Fusion per automazione e integrazione del lavoro |
Prodotto |
Fabbisogno prodotto corrente: se disponi del piano Select o Prime Adobe Workfront, la tua organizzazione deve acquistare Adobe Workfront Fusion e Adobe Workfront per utilizzare le funzionalità descritte in questo articolo. Workfront Fusion è incluso nel piano Ultimate Workfront. Oppure Requisiti del prodotto legacy: la tua organizzazione deve acquistare Adobe Workfront Fusion e Adobe Workfront per utilizzare le funzionalità descritte in questo articolo. |
Per conoscere il piano, il tipo di licenza o l'accesso disponibili, contattare l'amministratore Workfront.
Per informazioni sulle Adobe Workfront Fusion licenze, vedere Adobe Workfront Fusion licenze.
Prerequisiti
Per utilizzare i moduli Google Sheets, è necessario disporre di un account Google.
Informazioni API per i fogli di Google
Il connettore Google Sheets utilizza quanto segue:
URL di base | https://sheets.googleapis.com/v4 |
Versione API | v4 |
Tag API | v2.5.7 |
Triggers
Righe di controllo
Recupera i valori da ogni riga appena aggiunta nel foglio di calcolo.
Il modulo recupera solo le nuove righe che non sono state compilate in precedenza. Il trigger non elaborerà una riga sovrascritta.
Selezionare se il foglio di calcolo contiene la riga di intestazione.
-
Sì
Il modulo non recupera la riga di intestazione come dati di output.
I nomi delle variabili nell’output vengono richiamati dalle intestazioni.
-
No
Il modulo recupera anche la prima riga della tabella
I nomi delle variabili nell'output sono denominati A, B, C, D e così via.
A1:F1
.A1:F1
.Valore formattato
I valori verranno calcolati e formattati nella risposta in base alla formattazione della cella. La formattazione si basa sulle impostazioni locali del foglio di calcolo, non sulle impostazioni locali dell'utente richiedente. Ad esempio, se A1
è 1.23
e A2
è =A1
e formattato come valuta, A2
restituirebbe "$1.23"
.
Valore non formattato
I valori verranno calcolati, ma non formattati nella risposta. Ad esempio, se A1
è 1.23
e A2
è =A1
e formattato come valuta, A2
restituirà il numero "1.23"
.
Formula
I valori non verranno calcolati. La risposta includerà le formule. Ad esempio, se A1
è 1.23
e A2
è =A1
e formattato come valuta, A2
restituirebbe "=A1"
.
Numero di serie
Indica che i campi di data, ora, dataora e durata devono essere generati come duplicati in formato "numero seriale", come reso popolare da Lotus 1-2-3. La porzione del numero intero del valore (a sinistra del decimale) conta i giorni dal 30 dicembre 1899. La parte frazionaria (a destra del decimale) conta l’ora come frazione del giorno. Ad esempio, il 1 gennaio 1900 a mezzogiorno sarebbe 2,5, 2 perché sono 2 giorni dopo il 30 dicembre 1899, e 0,5 perché mezzogiorno è mezza giornata. Il primo febbraio 1900 alle 15:00 sarebbe il 33.625. Questo considera correttamente l'anno 1900 come non un anno bisestile.
Stringa formattata
Indica che i campi di data, ora, dataora e durata devono essere generati come stringhe nel formato numero specificato (che dipende dalle impostazioni internazionali del foglio di calcolo).
Azioni
Aggiungi riga
Questo modulo aggiunge una riga a un foglio.
Quando configuri Google Sheets moduli, Workfront Fusion visualizza i campi elencati di seguito. Insieme a questi, potrebbero essere visualizzati ulteriori campi di Google Sheets, a seconda di fattori quali il livello di accesso nell'app o nel servizio. Un titolo in grassetto in un modulo indica un campo obbligatorio.
Se viene visualizzato il pulsante Mappa sopra un campo o una funzione, è possibile utilizzarlo per impostare variabili e funzioni per tale campo. Per ulteriori informazioni, vedere Mappare le informazioni da un modulo all'altro in Adobe Workfront Fusion.
Specificare se si desidera selezionare il foglio di calcolo e il foglio manualmente o mediante mapping.
Nota: la mappatura manuale è utile, ad esempio, quando si crea un nuovo foglio di calcolo in uno scenario Workfront Fusion e si desidera aggiungere dati nel nuovo foglio di calcolo direttamente nello scenario.
Selezionare se il foglio di calcolo contiene la riga di intestazione.
-
Sì
Il modulo non recupera la riga di intestazione come dati di output.
I nomi delle variabili nell’output vengono richiamati dalle intestazioni.
-
No
Il modulo recupera anche la prima riga della tabella
I nomi delle variabili nell'output sono denominati A, B, C, D e così via.
-
User entered
I valori vengono analizzati come se l’utente li avesse digitati nell’interfaccia utente. I numeri rimangono numeri, ma le stringhe possono essere convertite in numeri, date o altri formati seguendo le stesse regole applicate quando si immette testo in una cella tramite l'interfaccia utente Google Sheets.
-
Raw
I valori immessi dall’utente non vengono analizzati e vengono memorizzati così come sono.
Specifica come vengono modificati i dati esistenti quando vengono immessi nuovi dati.
-
Inserisci righe
Le righe vengono inserite per i nuovi dati.
-
Sovrascrivi
I nuovi dati sovrascrivono quelli esistenti nelle aree in cui vengono scritti. L'aggiunta di dati alla fine del foglio consente di inserire nuove righe o colonne in modo da poter scrivere i dati.
Aggiorna riga
Questo modulo consente di modificare il contenuto della cella in una riga selezionata.
Specificare se si desidera selezionare il foglio di calcolo e il foglio manualmente o mediante mapping.
Nota: la mappatura manuale è utile, ad esempio, quando si crea un nuovo foglio di calcolo nello scenario Workfront Fusion e si desidera aggiungere dati al nuovo foglio di calcolo direttamente nello scenario.
Selezionare se il foglio di calcolo contiene la riga di intestazione.
-
Sì
Il modulo non recupera la riga di intestazione come dati di output.
I nomi delle variabili nell’output vengono richiamati dalle intestazioni.
-
No
Il modulo recupera anche la prima riga della tabella
I nomi delle variabili nell'output sono denominati A, B, C, D e così via.
-
User entered
I valori vengono analizzati come se l’utente li avesse digitati nell’interfaccia utente. I numeri rimangono numeri, ma le stringhe possono essere convertite in numeri, date o altri formati seguendo le stesse regole applicate quando si immette testo in una cella tramite l'interfaccia utente Google Sheets.
-
Raw
I valori immessi dall’utente non vengono analizzati e vengono memorizzati così come sono.
Cancella riga
Elimina i valori da una riga specificata.
23
.Elimina riga
Elimina una riga specificata.
23
Ottieni una cella
Recupera un valore da una cella selezionata.
A6
Valore formattato
I valori verranno calcolati e formattati nella risposta in base alla formattazione della cella. La formattazione si basa sulle impostazioni locali del foglio di calcolo, non sulle impostazioni locali dell'utente richiedente. Ad esempio, se A1
è 1.23
e A2
è =A1
e formattato come valuta, A2
restituirebbe "$1.23"
.
Unformatted value
I valori verranno calcolati, ma non formattati nella risposta. Ad esempio, se A1
è 1.23
e A2
è =A1
e formattato come valuta, A2
restituirà il numero "1.23"
.
Formula
I valori non verranno calcolati. La risposta includerà le formule. Ad esempio, se A1
è 1.23
e A2
è =A1
e formattato come valuta, A2
restituirebbe "=A1"
.
Serial number
Indica che i campi di data, ora, dataora e durata devono essere generati come duplicati in formato "numero seriale", come reso popolare da Lotus 1-2-3. La porzione del numero intero del valore (a sinistra del decimale) conta i giorni dal 30 dicembre 1899. La parte frazionaria (a destra del decimale) conta l’ora come frazione del giorno. Ad esempio, il 1 gennaio 1900 a mezzogiorno sarebbe 2,5, 2 perché sono 2 giorni dopo il 30 dicembre 1899, e 0,5 perché mezzogiorno è mezza giornata. Il primo febbraio 1900 alle 15:00 sarebbe il 33.625. Questo considera correttamente l'anno 1900 come non un anno bisestile.
Formatted string
Indica che i campi di data, ora, dataora e durata devono essere generati come stringhe nel formato numero specificato (che dipende dalle impostazioni internazionali del foglio di calcolo).
Aggiorna cella
A5
-
User entered
I valori vengono analizzati come se l’utente li avesse digitati nell’interfaccia utente. I numeri rimangono numeri, ma le stringhe possono essere convertite in numeri, date o altri formati seguendo le stesse regole applicate quando si immette testo in una cella tramite l'interfaccia utente Google Sheets.
-
Raw
I valori immessi dall’utente non vengono analizzati e vengono memorizzati così come sono.
Cancella cella
Elimina un valore da una cella specificata.
A5
.Aggiungi foglio
Crea un nuovo foglio in un foglio di calcolo selezionato.
-
Title
Immettere il nome del nuovo foglio.
-
Index
Immettere la posizione del foglio. Il valore di default è 0 (posiziona il foglio al primo posto)
Creare un foglio di calcolo
Immettere le impostazioni locali del foglio di calcolo in uno dei seguenti formati:
- un codice lingua ISO 639-1 come
en
- un codice del linguaggio ISO 639-2 come
haw
, se non esiste alcun codice 639-1 - una combinazione del codice della lingua ISO e del codice del paese, come
en_US
Quantità di tempo di attesa prima del ricalcolo delle funzioni volatili:
in caso di modifica
Le funzioni volatili vengono aggiornate a ogni modifica.
su modifica e ogni minuto
Le funzioni volatili vengono aggiornate a ogni cambiamento e ogni minuto.
su modifica e su base oraria
Le funzioni volatili vengono aggiornate a ogni modifica e ogni ora.
Selezionare il formato predefinito di tutte le celle del foglio di calcolo.
Text: Formattazione del testo. Esempio: 1000. 12
Number: Formattazione dei numeri. Esempio: 1,000.12
Percent: Formattazione percentuale. Esempio: 10. 12%
Valuta: Formattazione valuta. Esempio: $1,000.12
Date: Formattazione data. Esempio: 9/26/2008
Time: Formattazione dell'ora. Esempio: 3:59:00 PM
Data e ora: Formattazione di data e ora. Esempio: 9/26/08 15:59:00
Scientific Formattazione numeri scientifici. Esempio: 1. 01E+03
Elimina foglio
Elimina un foglio specifico.
Effettuare una chiamata API
Questo modulo di azione ti consente di eseguire una chiamata API personalizzata.
https://sheets.googleapis.com/v4/
.{"Content-type":"application/json"}
. Workfront Fusion aggiunge le intestazioni di autorizzazione.Aggiungi il contenuto body per la chiamata API sotto forma di oggetto JSON standard.
Nota:
Quando si utilizzano istruzioni condizionali come if
nel JSON, inserire le virgolette al di fuori dell'istruzione condizionale.
Ricerche
Cerca righe
Cerca le righe utilizzando le opzioni di filtro.
A-F
Impostare il filtro per la riga in base alla quale eseguire la ricerca.
Per ulteriori informazioni sui filtri, vedere Aggiungere un filtro a uno scenario in Adobe Workfront Fusion.
Valore formattato
I valori verranno calcolati e formattati nella risposta in base alla formattazione della cella. La formattazione si basa sulle impostazioni locali del foglio di calcolo, non sulle impostazioni locali dell'utente richiedente. Ad esempio, se A1
è 1.23
e A2
è =A1
e formattato come valuta, A2
restituirebbe "$1.23"
.
Valore non formattato
I valori verranno calcolati, ma non formattati nella risposta. Ad esempio, se A1
è 1.23
e A2
è =A1
e formattato come valuta, A2
restituirà il numero "1.23"
.
Formula
I valori non verranno calcolati. La risposta includerà le formule. Ad esempio, se A1
è 1.23
e A2
è =A1
e formattato come valuta, A2
restituirebbe "=A1"
.
Numero di serie
Indica che i campi di data, ora, dataora e durata devono essere generati come duplicati in formato "numero seriale", come reso popolare da Lotus 1-2-3. La porzione del numero intero del valore (a sinistra del decimale) conta i giorni dal 30 dicembre 1899. La parte frazionaria (a destra del decimale) conta l’ora come frazione del giorno. Ad esempio, il 1 gennaio 1900 a mezzogiorno sarebbe 2,5, 2 perché sono 2 giorni dopo il 30 dicembre 1899, e 0,5 perché mezzogiorno è mezza giornata. Il primo febbraio 1900 alle 15:00 sarebbe il 33.625. Questo considera correttamente l'anno 1900 come non un anno bisestile.
Stringa formattata
Indica che i campi di data, ora, dataora e durata devono essere generati come stringhe nel formato numero specificato (che dipende dalle impostazioni internazionali del foglio di calcolo).
Cerca righe (avanzate)
Restituisce risultati che corrispondono ai criteri specificati.
Utilizza Google Charts Query Language. Esempio: select * where B = "John"
Per ulteriori informazioni su Google Charts Query Language, vedere Riferimento linguaggio query nella documentazione di Google.
Ottieni valori intervallo
A1:D25
.A1:F1
. Se si lascia vuoto il campo, Workfront Fusion supporrà che l'intestazione si trovi nella prima riga dell'intervallo specificato.Valore formattato
I valori verranno calcolati e formattati nella risposta in base alla formattazione della cella. La formattazione si basa sulle impostazioni locali del foglio di calcolo, non sulle impostazioni locali dell'utente richiedente. Ad esempio, se A1
è 1.23
e A2
è =A1
e formattato come valuta, A2
restituirebbe "$1.23"
.
Valore non formattato
I valori verranno calcolati, ma non formattati nella risposta. Ad esempio, se A1
è 1.23
e A2
è =A1
e formattato come valuta, A2
restituirà il numero "1.23"
.
Formula
I valori non verranno calcolati. La risposta includerà le formule. Ad esempio, se A1
è 1.23
e A2
è =A1
e formattato come valuta, A2
restituirebbe "=A1"
.
Numero di serie
Indica che i campi di data, ora, dataora e durata devono essere generati come duplicati in formato "numero seriale", come reso popolare da Lotus 1-2-3. La porzione del numero intero del valore (a sinistra del decimale) conta i giorni dal 30 dicembre 1899. La parte frazionaria (a destra del decimale) conta l’ora come frazione del giorno. Ad esempio, il 1 gennaio 1900 a mezzogiorno sarebbe 2,5, 2 perché sono 2 giorni dopo il 30 dicembre 1899, e 0,5 perché mezzogiorno è mezza giornata. Il primo febbraio 1900 alle 15:00 sarebbe il 33.625. Questo considera correttamente l'anno 1900 come non un anno bisestile.
Stringa formattata
Indica che i campi di data, ora, dataora e durata devono essere generati come stringhe nel formato numero specificato (che dipende dalle impostazioni internazionali del foglio di calcolo).
Elenca fogli
Questo modulo restituisce un elenco di tutti i fogli di un foglio di calcolo.
Limiti di utilizzo
Se si verifica l'errore 429: RESOURCE_EXHAUSTED
, è stato superato il limite di velocità API.
L'API Google Sheets ha un limite di 500 richieste per 100 secondi per progetto e di 100 richieste per 100 secondi per utente. I limiti per le letture e le scritture vengono tracciati separatamente. Non esiste alcun limite di utilizzo giornaliero.
Ulteriori dettagli sono disponibili all'indirizzo developers.google.com/sheets/api/limits.
Suggerimenti
Come ottenere celle vuote da un Google Sheet
Utilizza il modulo Righe ricerca (avanzate) e utilizza questa formula per ottenere le colonne vuote.
seleziona * dove E è nullo
Aggiungere un pulsante in un foglio per eseguire uno scenario
-
In Workfront Fusion, inserisci il modulo/trigger Webhook > Webhook personalizzati nello scenario e configuralo (vedi Webhook).
-
Copia l’URL del webhook.
-
Esegui lo scenario.
-
In Google Sheets, scegliere Inserisci > Disegno… dalla barra del menu principale.
-
Nella finestra Disegno, fare clic sull'icona della casella di testo nella parte superiore della finestra.
-
Progetta un pulsante e fai clic sul pulsante Salva e chiudi nell'angolo in alto a destra:
-
Il pulsante verrà inserito nel foglio di lavoro. Fai clic sui tre punti verticali nell’angolo in alto a destra del pulsante:
-
Scegli Assegna script… dal menu.
-
Immettere il nome dello script (funzione), ad esempio
runScenario
e fare clic su OK: -
Scegliere Strumenti > Editor di script dalla barra del menu principale.
-
Inserire il codice seguente:
-
Il nome della funzione deve corrispondere al nome specificato nel passaggio 9.
-
Sostituisci l’URL con l’URL del webhook copiato nel passaggio 2.
function runScenario() {
UrlFetchApp.fetch("<webhook copiato>");
}
-
-
Premere Ctrl+S per salvare il file script, immettere il nome di un progetto e fare clic su OK.
-
Torna a Google Sheets e fai clic sul nuovo pulsante.
-
Concedi l'autorizzazione richiesta allo script:
-
In Workfront Fusion verificare che lo scenario sia stato eseguito correttamente.
Memorizzazione delle date in un foglio di calcolo
Se memorizzi un valore Data in un foglio di calcolo senza formattazione, questo verrà visualizzato nel foglio di calcolo come testo in formato ISO 8601. Tuttavia, Google Sheets formule o funzioni che funzionano con date che non comprendono questo testo (esempio: formula =A1+10
) visualizzeranno il seguente errore:
Per consentire a Google Sheets di comprendere la data, formattala con la funzione formatDate (date; format; [timezone]). Il formato corretto passato alla funzione come secondo argomento dipende dalle impostazioni internazionali del foglio di calcolo.
Per determinare il formato corretto:
-
Scegliere le impostazioni File > Foglio di calcolo dal menu principale per verificare/impostare le impostazioni locali.
-
Dopo aver verificato/impostato le impostazioni locali corrette, determinare il formato di data e ora corrispondente scegliendo Formato > Numero dal menu principale. Il formato viene visualizzato accanto alla voce di menu Data e ora:
-
Per comporre il formato corretto da passare alla funzione formatDate(), fare riferimento all'elenco di token per la formattazione di data e ora in Adobe Workfront Fusion.
Esempio: L'utilizzo del formato MM/DD/YYYY HH:mm:ss
per le impostazioni locali degli Stati Uniti:
Sfruttamento di Google Sheets funzioni
Se si dimentica una funzione incorporata, ma è presente in Google Sheets, è possibile sfruttarla. Per ulteriori informazioni, vedere Utilizzare Google Sheets funzioni in Mappare gli elementi utilizzando le funzioni in Adobe Workfront Fusion.
Impedisci a Google Sheets di modificare i numeri in date
È possibile che una stringa di numeri utilizzata come testo venga interpretata come una data in un foglio di lavoro Google. Ad esempio, si digita 1-2019 con l'intento di impostarlo come testo, ma Google lo interpreta come una data. È possibile preformattare il numero come testo normale per impedirlo.
- In Google Sheets, evidenziare la colonna o la cella contenente il numero o i numeri.
- Fare clic su Formato > Numero > Testo normale.
Un'altra soluzione alternativa in Workfront Fusion consiste nel digitare un apostrofo (') prima di un numero, ad esempio '1-2019 o '1/47. L'apostrofo non viene visualizzato nella cella dopo l'invio dei dati da Workfront Fusion.