Dropbox moduli

In uno scenario 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 il monitoraggio, la ricerca, il recupero, l'inserimento in elenco, la creazione e la 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:

Adobe Workfront piano*
Pro o superiore
Adobe Workfront licenza*
Plan, Work
Adobe Workfront Fusion licenza**

Requisiti di licenza correnti: nessun requisito di licenza Workfront Fusion.

Oppure

Requisiti di licenza legacy: Workfront Fusion per automazione e integrazione del lavoro

Prodotto

Fabbisogno prodotto corrente: se si dispone del piano Select o Prime Adobe Workfront, è necessario 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 Dropbox, è necessario disporre di un account Dropbox.
IMPORTANT
Il 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 Dropbox

Il connettore di Dropbox utilizza quanto segue:

URL di base
https://api.dropboxapi.com/2
Versione API
2
Tag API
  • Dropbox

    v5.3.9

  • Attività Dropbox

    v1.0.12

Crea una connessione a Dropbox

Per creare una connessione per i moduli Dropbox:

  1. Fare clic su Add accanto alla casella Connessione.

  2. Compila i campi seguenti:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
    Connection name 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.
    Client ID Immetti Dropbox Client ID.
    Client Secret Immetti Dropbox Client Secret.
    Account Type Specificare se si desidera connettersi a un account di Dropbox personale o aziendale (Dropbox Business).
  3. Fare clic su Continue per salvare la connessione e tornare al modulo.## Dropbox moduli e relativi campi

Dropbox moduli e relativi campi

Quando configuri Dropbox moduli, Workfront Fusion visualizza 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.

Attiva/Disattiva mappa

Moduli trigger

Watch Files

Questo modulo del tipo Trigger restituisce i dettagli del file quando viene modificato il file in una cartella specificata.

Connection
Per istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Folder
Selezionare la cartella in cui si desidera verificare le modifiche.
Watch also subfolders
Abilita questa opzione per monitorare anche le sottocartelle nella cartella selezionata per i file modificati.
Limit
Immettere o mappare il numero massimo di record che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.

Moduli per ottenere Dropbox file e cartelle

Search Files/Folders

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.

Connection
Per istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Search
Immettere il termine di ricerca.
Folder
Selezionare la cartella in cui si desidera eseguire la ricerca. Se non si seleziona una cartella, questo modulo esegue la ricerca nell'intero Dropbox.
Stato file
Selezionare lo stato del file per limitare la ricerca allo stato selezionato.
Categorie di file
Selezionare le categorie di file per limitare la ricerca alle categorie selezionate.
Estensioni file
Scegliere le estensioni di file che si desidera cercare.
Limite
Immettere o mappare il numero massimo di record che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.

Download a 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.

NOTE
Questo modulo è utile per fornire file ai moduli successivi.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

Connection
Per istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Modalità di selezione dei file
Selezionare se si desidera mappare il percorso del file oppure selezionare il file manualmente.
Percorso file / File

Percorso file

Immetti o mappa il percorso di destinazione del file.

File

Seleziona il file dal menu.

Get a Folder Metadata

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.

Connection
Per istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
ID cartella condivisa
Immetti o mappa l’ID della cartella di cui desideri recuperare i dettagli.

List All Files/Subfolders in a Folder

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.

Connection
Per istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Elenco
Specificare se si desidera recuperare file o cartelle.
Mostra solo file scaricabili
Abilita questa opzione per restituire solo i file scaricabili. Alcuni tipi di file, ad esempio Google Docs, non sono scaricabili.
Cartella
Immettere o mappare la cartella da cui si desidera recuperare file o cartelle.
Limite
Immettere o mappare il numero massimo di record che il modulo deve elencare durante ogni ciclo di esecuzione dello scenario.

List File Revisions

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.

Connection
Per istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Modalità di selezione dei file
Selezionare se si desidera mappare il percorso del file oppure selezionare il file manualmente.
Percorso file / File

Percorso file

Immetti o mappa il percorso di destinazione del file.

File

Seleziona il file dal menu.

Limite
Immettere o mappare il numero massimo di record che il modulo deve elencare durante ogni ciclo di esecuzione dello scenario.

Moduli per la creazione e la modifica di Dropbox file e cartelle

Upload a 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.

Connection
Per istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Folder
Selezionare la cartella di Dropbox in cui caricare il file.
Source File

Immettere o mappare il file che si desidera aggiungere alla cartella Dropbox selezionata in precedenza.

File name

Immettere o mappare il nome del file, inclusa l'estensione.

File data

Immettere o mappare i dati del file (dal modulo precedente, ad esempio Google Drive >Get a File).

Nota: la dimensione massima del file caricato è 150 MB.

Overwrite an existing file
Abilita questa opzione per sostituire il file esistente con il nuovo file. Se questa opzione viene lasciata disattivata, il file caricato viene rinominato.

Create a Folder

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.

Connection
Per istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Folder Name
Immettere il nome della nuova cartella.
Folder

Immetti o mappa il percorso in cui desideri creare una nuova cartella.

Nota:

Se si utilizza un account Dropbox Business (con spazi del team), è necessario rimuovere la barra / oppure non fare clic su Click here per scegliere la cartella per creare una cartella del team nella radice.

Se la barra non viene rimossa, viene restituito l'errore [409] path/malformed_path/...

Auto rename
Abilita questa opzione per rinominare la nuova cartella, se nel percorso di destinazione esiste già una cartella con lo stesso nome.

Create/Overwrite a Text File

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.

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.

Connection
Per istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Select to
Selezionare se si desidera creare o sovrascrivere un file DOC.
Folder
Selezionare il percorso di destinazione in cui si desidera creare un file.
Source File

Immettere o mappare il file da aggiungere alla cartella Dropbox.

Nome file

Immettete il nome del nuovo file DOC (senza estensione).

Contenuto file

Immettete il contenuto del testo del file DOC.

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.

Connection
Per istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Way of selecting files
Selezionare se si desidera mappare o immettere il percorso del file oppure selezionare il file manualmente.
File Path / File

File Path

Immetti o mappa il percorso di destinazione del file.

File

Seleziona il file dal menu.

Requested Visibility

Seleziona se il collegamento è pubblico, per team o con password limitata.

Nota: le opzioni Team only e Access with password sono disponibili solo per gli utenti con versione Dropbox Pro o successiva.

Link's Expiration Date

Immetti la data e l’ora in cui il collegamento scadrà e non sarà più accessibile. Se questo campo viene lasciato vuoto, il collegamento non scade. Per un elenco dei formati di data e ora supportati, vedere Tipo di coercizione in Adobe Workfront Fusion.

Nota: le opzioni Team only e Access with password sono disponibili solo per gli utenti con versioni di Dropbox Pro o successive.

Link's Access Level

Imposta l’autorizzazione per il destinatario del collegamento.

Viewer Gli utenti che utilizzano il collegamento possono visualizzare e commentare il contenuto.

Editor Gli utenti che utilizzano il collegamento possono modificare, visualizzare e commentare il contenuto.

Max Gli utenti che utilizzano il collegamento ricevono il livello di accesso massimo su cui puoi impostare il collegamento.

Restore a 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.

Connection
Per istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Way of selecting files
Selezionare se si desidera mappare o immettere il percorso del file oppure selezionare il file manualmente.
File Path / File

File Path

Immetti o mappa il percorso di destinazione del file.

File

Seleziona il file dal menu.

Revision
Immettere o mappare il numero di revisione della revisione da ripristinare.

Move a File/Folder

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.

Connection
Per istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Way of selecting files
Selezionare se si desidera mappare o immettere il percorso del file oppure selezionare il file manualmente.
File/Folder Path / File/Folder

File/Folder Path

Immettere o mappare il percorso di destinazione al file o alla cartella.

File/Folder

Seleziona il file o la cartella dal menu.

To Folder
Immettere o mappare il percorso di destinazione del file o della cartella.
New Name
Immettere il nuovo nome per il file o la cartella nella nuova posizione.
Auto Rename
Abilitare questa opzione per assicurarsi che, se esiste un file o una cartella con lo stesso nome, il modulo rinomini il nuovo file o la nuova cartella aggiungendo (NUMBER) dopo il nome del file o della cartella. In caso contrario, il file o la cartella nel percorso di destinazione viene sovrascritto.
Allow ownership transfer
Abilita questa opzione per consentire gli spostamenti per proprietario, anche se comporterebbe un trasferimento di proprietà per il contenuto spostato.

Rename a File/Folder

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.

Connection
Per istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Modalità di selezione dei file
Selezionare se si desidera mappare o immettere il percorso del file oppure selezionare il file manualmente.
Percorso file/cartella/File/Cartella

Percorso file/cartella

Immettere o mappare il percorso di destinazione al file o alla cartella.

File/Cartella

Seleziona il file o la cartella dal menu.

Rinomina
Immettere target name per il file, inclusa l'estensione.

Delete a File/Folder

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.

Connection
Per istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Way of selecting files
Selezionare se si desidera mappare o immettere il percorso del file oppure selezionare il file manualmente.
File Path / File

File Path

Immetti o mappa il percorso di destinazione del file.

File

Seleziona il file dal menu.

Altri moduli

Make an API Call

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.

Connection
Per istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
URL

Immettere un percorso relativo a Immettere un percorso relativo a https://api.dropboxapi.com. Ad esempio: /2/files/list_folder

Nota: per un elenco degli endpoint disponibili, consulta la Documentazione API di Dropbox v2.

Method
Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, vedere Metodi di richiesta HTTP.
Headers
Inserisci le intestazioni di richiesta desiderate. Workfront Fusion aggiunge automaticamente le intestazioni di autorizzazione.
Query String
Immettere la stringa di query richiesta.
Body

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.

INFO
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 > Body > voci.
Nel nostro esempio, sono stati restituiti 10 biglietti:

Problemi comuni

Impossibile caricare o aggiornare un file

Esistono diverse situazioni in 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 >Create a shared link 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 tuo 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

  1. Sostituisci www con dl.
  2. 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

    Sostituisci www con dl

  • E per rimuovere ?dl=0

    Rimuovi DL

Per eseguire questa operazione in un unico passaggio, combina le seguenti funzioni:

Sostituisci entrambi

Puoi anche copiarlo e incollarlo nel campo. Sostituisci 1.url con l'URL.

{{replace(replace(1.url; "?dl=0"; ""); "www"; "dl")}}
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3