Dropbox moduli
In uno scenario di Adobe Workfront Fusion, è possibile automatizzare i flussi di lavoro che utilizzano Dropbox o Dropbox Business, nonché collegarli a più applicazioni e servizi di terze parti. Ciò consente di automatizzare attività quali monitoraggio, ricerca, recupero, inserimento in elenco, creazione e modifica di file e cartelle in Dropbox.
Per istruzioni sulla creazione di uno scenario, vedere gli articoli in Creare scenari: indice articolo.
Per informazioni sui moduli, vedere gli articoli in Moduli: indice articolo.
Requisiti di accesso
Per utilizzare le funzionalità di questo articolo, è necessario disporre dei seguenti diritti di accesso:
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Pacchetto Adobe Workfront | Qualsiasi |
| Licenza Adobe Workfront |
Nuovo: Standard Oppure Corrente: Lavoro o versione successiva |
| Licenza Adobe Workfront Fusion** |
Corrente: nessun requisito di licenza Workfront Fusion Oppure Legacy: Workfront Fusion per l'automazione e l'integrazione del lavoro |
| Prodotto |
Novità:
Oppure Corrente: la tua organizzazione deve acquistare Adobe Workfront Fusion. |
Per ulteriori dettagli sulle informazioni contenute in questa tabella, vedere Requisiti di accesso nella documentazione.
Per informazioni sulle licenze di Adobe Workfront Fusion, vedere Licenze di Adobe Workfront Fusion.
Prerequisiti
- Per utilizzare i moduli Dropbox, è necessario disporre di un account Dropbox.
- Per utilizzare il connettore Dropbox, è innanzitutto necessario creare un'applicazione in Dropbox.
> Per ulteriori informazioni, consulta la sezione "Creazione di un’applicazione" nella guida per gli sviluppatori di Dropbox. - Durante la creazione dell'applicazione, utilizzare il seguente URI di reindirizzamento:
https://app.workfrontfusion.com/oauth/cb/dropbox - Dropbox deve approvare le applicazioni con più di 50 utenti.
> Per ulteriori informazioni, cerca "Approvazione produzione" nella guida per gli sviluppatori di Dropbox.
Informazioni API di Dropbox
Il connettore Dropbox utilizza quanto segue:
Crea una connessione a Dropbox
Per creare una connessione per i moduli Dropbox:
-
In qualsiasi modulo, fai clic su Aggiungi accanto alla casella Connessione.
-
Compila i campi seguenti:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header Nome connessione Immettere un nome per la connessione. Environment Seleziona se la connessione è per un ambiente di produzione o non di produzione. Type Specificare se ci si connette a un account di servizio o a un account personale. ID client Immetti Dropbox Client ID. Segreto client Immetti Dropbox Client Secret. Tipo di account Seleziona se ti stai connettendo a un account Dropbox personale o a un account aziendale (Dropbox Business). Exclude dropbox-api-path-root header Abilita questa opzione per escludere l’intestazione dropbox-api-path-root per le app Dropbox con accesso alla cartella delle app -
Fai clic su Continua per salvare la connessione e tornare al modulo.## Dropbox moduli e relativi campi
Dropbox moduli e relativi campi
Quando si configurano Dropbox moduli, in Workfront Fusion vengono visualizzati i campi elencati di seguito. Insieme a questi, potrebbero essere visualizzati ulteriori campi di Dropbox, 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 a un altro.
Moduli trigger
File di controllo
Questo modulo del tipo Trigger restituisce i dettagli del file quando viene modificato il file in una cartella specificata.
Moduli per ottenere Dropbox file e cartelle
Scarica un file
Questo modulo di azione scarica un file da una cartella.
È possibile specificare il file e la relativa posizione.
Il modulo restituisce l’ID del file e dei campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Ottieni metadati cartella
Questo modulo di azione recupera i dettagli della cartella condivisa.
Specifica l’ID della cartella.
Il modulo restituisce l’ID della cartella e dei campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Elenca tutti i file/sottocartelle in una cartella
Questo modulo di azione elenca i file o le cartelle presenti in una cartella specifica.
Specifica l’ID della cartella.
Il modulo restituisce gli ID dei file o delle cartelle e di tutti i campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Elenca revisioni file
Questo modulo di azione recupera tutte le revisioni di file (una cronologia delle versioni) di un determinato file.
Specifica l’ID del file.
Il modulo restituisce tutti i campi standard associati al record, insieme a tutti i campi e i valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Cerca file/cartelle
Questo modulo di ricerca cerca i record in un oggetto in Dropbox che corrispondono alla query di ricerca specificata.
Puoi mappare queste informazioni nei moduli successivi nello scenario.
Moduli per la creazione e la modifica di Dropbox file e cartelle
Creare una cartella
Questo modulo di azione crea una nuova cartella.
Specificate il percorso e il nome della cartella.
Il modulo restituisce l’ID della cartella e dei campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Crea/Sovrascrivi un file di testo
Questo modulo di azione crea un file DOC o sovrascrive il contenuto di un file esistente.
È possibile specificare il file di origine e la cartella.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Crea/aggiorna un collegamento di condivisione
Questo modulo crea un collegamento pubblico a un file.
Specificare il file e le informazioni sul collegamento.
Il modulo restituisce l’ID del collegamento e di tutti i campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Eliminare un file o una cartella
Questo modulo di azione elimina un file o una cartella.
Specificare il file o la cartella.
Il modulo restituisce l’ID del record ed eventuali campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Sposta file/cartella
Questo modulo di azione sposta un file o una cartella in una posizione diversa.
È possibile specificare il file o la cartella e come e dove si desidera spostarlo.
Il modulo restituisce l’ID del file o della cartella e dei campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Rinominare un file o una cartella
Questo modulo di azione rinomina un file o una cartella.
Specificare il file o la cartella e il nuovo nome.
Il modulo restituisce l’ID del file o della cartella e dei campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Ripristina un file
Questo modulo ripristina una versione precedente di un file.
È possibile specificare il file e il numero della revisione desiderata.
Il modulo restituisce l’ID della versione e tutti i campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Carica un file
Questo modulo di azione carica un file in una cartella.
È possibile specificare informazioni quali la posizione del file, il file che si desidera caricare e un nuovo nome facoltativo per il file.
Il modulo restituisce l’ID del file e dei campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Altri moduli
Effettuare una chiamata API
Questo modulo di azione consente di effettuare una chiamata autenticata personalizzata all'API Dropbox. In questo modo è possibile creare un'automazione del flusso di dati che non può essere eseguita dagli altri moduli Dropbox.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
https://api.dropboxapi.com. Ad esempio: /2/files/list_folderAggiungi 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.
Esempio:
La chiamata API seguente restituisce i primi 10 file dalla cartella /Text files nell'account Dropbox:
URL: /2/files/list_folder
Corpo:
{
"path": "/Text files",
"limit": 10,
"recursive": false,
"include_deleted": false
}
Le corrispondenze della ricerca si trovano nell'output del modulo in Bundle > Corpo > voci.
Nel nostro esempio, sono stati restituiti 10 biglietti.
Problemi comuni
Impossibile caricare o aggiornare un file
Di seguito sono riportati alcuni possibili motivi per cui il caricamento o l’aggiornamento di un file non riesce:
- Il file caricato è troppo grande e supera la dimensione massima consentita per il piano Dropbox oppure hai utilizzato tutta la quota di archiviazione dell'account Dropbox. È necessario eliminare i file esistenti dall'account Dropbox o aggiornare il piano.
- La cartella selezionata in precedenza, in cui viene caricato il file, non esiste più. Lo scenario si interrompe e devi selezionare nuovamente la cartella di destinazione.
L’immagine a cui si fa riferimento tramite un collegamento condiviso non viene riprodotta
L'URL restituito da Dropbox >Crea un collegamento condiviso non è collegato direttamente a un'immagine, ma a una pagina Dropbox. Per forzare il download dell'immagine, sostituire ?dl=0 finale con ?dl=1. Per forzare il rendering dell'immagine (ad esempio, in un browser Web o in Facebook Messenger), aggiungi &raw=1 all'URL.
Se devi ottenere il collegamento diretto o non elaborato dell’immagine per il sito web o per altri moduli di Workfront Fusion, devi modificare l’URL condiviso iniziale nel modo seguente:
URL originale:
https://www.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png?dl=0
- Sostituisci
wwwcondl. - Rimuovi
?dl=0.
URL finale:
https://dl.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png
Per modificare automaticamente l'URL, è possibile utilizzare la funzione replace() due volte:
-
Sostituisci www con dl
-
E per rimuovere ?dl=0
Per eseguire questa operazione in un unico passaggio, combina le seguenti funzioni:
Puoi anche copiarlo e incollarlo nel campo. Sostituisci 1.url con l'URL.
{{replace(replace(1.url; "?dl=0"; ""); "www"; "dl")}}