Moduli Dropbox
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, consulta gli articoli in Creare scenari: indice degli articoli.
Per informazioni sui moduli, consulta gli articoli in Moduli: indice degli articoli.
Requisiti 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 pacchetto Workflow di Adobe Workfront, e qualsiasi pacchetto Automation and Integration di Adobe Workfront. Workfront Ultimate Pacchetti Workfront Prime e Select, con un ulteriore acquisto di Workfront Fusion. |
| Licenze Adobe Workfront |
Standard Work o successiva |
| Licenza di Adobe Workfront Fusion |
Basata sulle operazioni: nessun requisito di licenza Workfront Fusion Basata su connettore (precedente): Workfront Fusion for Work Automation and Integration |
| Prodotto | Se la tua organizzazione dispone di un pacchetto Workfront Select o Prime che non include Workfront Automation and Integration, dovrà acquistare Adobe Workfront Fusion. |
Per ulteriori dettagli sulle informazioni contenute in questa tabella, consulta Requisiti di accesso nella documentazione.
Per informazioni sulle licenze di Adobe Workfront Fusion, consulta 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:
Creare una connessione ad Dropbox
Per creare una connessione per i moduli Dropbox:
-
In qualsiasi modulo, fai clic su Aggiungi accanto alla casella Connessione.
-
Compila i seguenti campi:
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 Connection name (Nome della connessione) Specifica un nome per questa connessione. Ambiente Seleziona se la connessione è per un ambiente di produzione o non di produzione. Tipo Specifica se ti connetti a un account di servizio o a un account personale. ID client Immetti Dropbox Client ID. Client Secret (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
Moduli Dropbox e relativi campi
Quando configuri i moduli Dropbox, in Workfront Fusion vengono visualizzati i campi elencati di seguito. Insieme a questi, potrebbero essere visualizzati altri campi di Dropbox, a seconda di fattori quali il tuo livello di accesso nell’app o nel servizio. Un titolo in grassetto in un modulo indica un campo obbligatorio.
Se visualizzi il pulsante Map (Mappa) sopra un campo o una funzione, puoi utilizzarlo per impostare variabili e funzioni per tale campo. Per ulteriori informazioni, consulta 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 dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
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 dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
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 dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
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 accede la connessione. Puoi mappare queste informazioni nei moduli successivi dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
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 dello 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 dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
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 seguenti campi.
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 dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
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 e gli eventuali campi associati, insieme a eventuali campi e valori personalizzati a cui ha accesso la connessione. Puoi mappare queste informazioni nei moduli successivi dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
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 dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
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 dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
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 dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
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 dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
Altri moduli
Effettuare una chiamata API
Questo modulo di azione consente di effettuare una chiamata autenticata personalizzata all’API Dropbox. In questo modo puoi 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 seguenti campi.
https://api.dropboxapi.com. Ad esempio: /2/files/list_folderAggiungi il contenuto del corpo della chiamata API sotto forma di oggetto JSON standard.
Nota:
Quando utilizzi istruzioni condizionali come if nel codice JSON, racchiudi l’istruzione condizionale tra virgolette.
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")}}