DocumentazioneWorkfrontGuida di Workfront

Dropbox moduli

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Utente

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. In questo modo è possibile automatizzare attività quali il monitoraggio, la ricerca, il recupero, l'inserimento in elenco, la creazione e la modifica di file e cartelle nel Dropbox.

Se hai bisogno di istruzioni per la creazione di uno scenario, consulta Creare uno scenario in Adobe Workfront Fusion.

Per informazioni sui moduli, vedere Moduli in Adobe Workfront Fusion.

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 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. Fai clic su Aggiungi 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
    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 il Dropbox Client ID.
    Segreto client Immetti Dropbox Client Secret.
    Tipo di account Specificare se si desidera connettersi a un account di Dropbox personale o aziendale (Dropbox Business).

  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 all'altro in Adobe Workfront Fusion.

Moduli trigger

File di controllo

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.
Guarda anche le sottocartelle
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

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.

Connection
Per istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
- Ricerca
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.

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.

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.

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.

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.

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.

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 i documenti di Google, 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.

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.

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

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.

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.

Nome file

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

File data

Immetti o mappa i dati del file (da un modulo precedente, ad esempio Google Drive >Get a File).

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

Sovrascrive un file esistente
Abilita questa opzione per sostituire il file esistente con il nuovo file. Se questa opzione viene lasciata disattivata, il file caricato viene rinominato.

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.

Connection
Per istruzioni sulla connessione dell'account Dropbox a Workfront Fusion, vedere Creare una connessione a Dropbox in questo articolo.
Nome cartella
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 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 automaticamente
Abilita 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.

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.
Seleziona per
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.

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.

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 / File

Percorso File

Immetti o mappa il percorso di destinazione del file.

File

Seleziona il file dal menu.

Visibilità richiesta

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

Nota: le opzioni Solo team e Accesso con password sono disponibili solo per gli utenti con versione Dropbox Pro o successiva.

Data di scadenza del collegamento

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 Solo team e Accesso con password sono disponibili solo per gli utenti che dispongono di Dropbox Pro o versioni successive.

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.

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

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.

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 / File

Percorso File

Immetti o mappa il percorso di destinazione del file.

File

Seleziona il file dal menu.

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

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.

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.

Nella Cartella
Immettere o mappare il percorso di destinazione del file o della cartella.
Nuovo Nome
Immettere il nuovo nome per il file o la cartella nella nuova posizione.
Rinomina automaticamente
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.
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.

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 il nome destinazione per il file, inclusa l'estensione.

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.

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 / File

Percorso File

Immetti o mappa il percorso di destinazione del file.

File

Seleziona il file dal menu.

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.

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 in Adobe Workfront Fusion.
Headers
Inserisci le intestazioni di richiesta desiderate. Workfront Fusion aggiunge automaticamente le intestazioni di autorizzazione.
Stringa Di Query
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 > Corpo > 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 dal Dropbox >creazione di 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 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

  • 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")}}
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43