Prerequisiti

  • Per utilizzare i moduli Dropbox, è necessario disporre di un account Dropbox.
IMPORTANT
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:

URL di basehttps://api.dropboxapi.com/2
Versione API2
Tag API
  • Dropbox

    v5.3.9

  • Dropbox Business

    v1.0.12

Crea una connessione a Dropbox

Per creare una connessione per i moduli Dropbox:

  1. In qualsiasi modulo, fai clic su Aggiungi accanto alla casella Connessione.

  2. Compila i campi seguenti:

    Nome connessioneImmettere un nome per la connessione.
    EnvironmentSeleziona se la connessione è per un ambiente di produzione o non di produzione.
    TypeSpecificare se ci si connette a un account di servizio o a un account personale.
    ID clientImmetti Dropbox Client ID.
    Segreto clientImmetti Dropbox Client Secret.
    Tipo di accountSeleziona se ti stai connettendo a un account Dropbox personale o a un account aziendale (Dropbox Business).
    Exclude dropbox-api-path-root headerAbilita questa opzione per escludere l’intestazione dropbox-api-path-root per le app Dropbox con accesso alla cartella delle app
  3. Fai clic su Continua 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

File di controllo

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

ConnectionPer istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
FolderSelezionare la cartella in cui si desidera verificare le modifiche.
Guarda anche le sottocartelleAbilita questa opzione per monitorare anche le sottocartelle nella cartella selezionata per i file modificati.
LimitImmettere 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

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.

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

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

ConnectionPer istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Modalità di selezione dei fileSelezionare 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.

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.

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

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.

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

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.

ConnectionPer istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Modalità di selezione dei fileSelezionare 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.

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

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.

ConnectionPer istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
- RicercaImmettere il termine di ricerca.
FolderSelezionare la cartella in cui si desidera eseguire la ricerca. Se non si seleziona una cartella, questo modulo esegue la ricerca nell'intero account Dropbox.
Stato fileSelezionare lo stato del file da includere nella ricerca.
Categorie di fileSelezionare le categorie di file da includere nella ricerca.
Estensioni filePer ogni estensione di file da includere nella ricerca, fare clic su Aggiungi elemento e immettere o mappare l'estensione di file.
LimiteImmettere o mappare il numero massimo di record che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.

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

Crea 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.

ConnectionPer istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Nome cartellaImmettere 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 Fare clic qui 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/...

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

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.

ConnectionPer istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Seleziona per

Selezionare se si desidera creare o sovrascrivere un file DOC.

  • Crea Selezionare la cartella in cui si desidera creare un file.

  • Sovrascrivi

    Seleziona la modalità di selezione del file da sovrascrivere, quindi mappa il percorso del file o seleziona il file.

Source File

Seleziona un file di origine da un modulo precedente o mappane il contenuto.

Se stai creando un file, seleziona Vuoto.

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.

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

Percorso File

Immettete o mappate il percorso del file di destinazione.

File

Selezionare il file di destinazione.

Visibilità richiesta

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

Nota:

Solo team è disponibile solo per gli account Dropbox Business. Access with password è disponibile solo per Dropbox Pro o account Dropbox Business.

Data di scadenza del collegamentoImmetti 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.
Livello di accesso di Link

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. Questo livello di accesso è disponibile solo per i documenti basati su cloud.

  • Max

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

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.

ConnectionPer istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Modalità di selezione dei fileSelezionare se si desidera mappare o immettere il percorso del file oppure selezionare il file manualmente.
Percorso file o cartella / File o 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.

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.

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

Percorso file/cartella

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

file/cartella

Seleziona se stai spostando un file o una cartella, quindi il file o la cartella.

Nella CartellaImmettere o mappare il percorso di destinazione del file o della cartella.
Nuovo NomeImmettere il nuovo nome per il file o la cartella nella nuova posizione.
Rinomina automaticamenteAbilitare 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.
Consenti trasferimento proprietàAbilita questa opzione per consentire gli spostamenti per proprietario, anche se comporterebbe un trasferimento di proprietà per il contenuto spostato.

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.

ConnectionPer istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Modalità di selezione dei fileSelezionare 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 se stai spostando un file o una cartella, quindi il file o la cartella.

RinominaImmettere il nuovo nome del file, inclusa l'estensione.

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.

ConnectionPer istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Modalità di selezione dei fileSelezionare se si desidera mappare o immettere 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.

RevisioneImmettere o mappare il numero di revisione della revisione da ripristinare.