DocumentazioneWorkfrontGuida di Workfront

Dropbox moduli

Last update: Thu Mar 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Utente

In un Adobe Workfront Fusion scenario, puoi automatizzare i flussi di lavoro che utilizzano Dropbox o Dropbox Businessnonché a collegarlo 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 nel Dropbox.

Per istruzioni sulla creazione di uno scenario, consulta Creare uno scenario in Adobe Workfront Fusion.

Per informazioni sui moduli, consulta 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**

Fabbisogno di licenza corrente: No Workfront Fusion requisito di licenza.

Oppure

Requisito licenza legacy: Workfront Fusion per l'automazione e l'integrazione del lavoro

Prodotto

Fabbisogno prodotto corrente: se si dispone di Select o Prime Adobe Workfront Pianifica, la tua organizzazione deve acquistare Adobe Workfront Fusion nonché Adobe Workfront per utilizzare la funzionalità descritta in questo articolo. Workfront Fusion è incluso in Ultimate Workfront piano.

Oppure

Requisiti del prodotto legacy: la tua organizzazione deve acquistare Adobe Workfront Fusion nonché Adobe Workfront per utilizzare la funzionalità descritta in questo articolo.

Per conoscere il piano, il tipo di licenza o l'accesso di cui si dispone, contattare Workfront amministratore.

Per informazioni su Adobe Workfront Fusion licenze, consulta Adobe Workfront Fusion licenze.

Prerequisiti

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

Creare una connessione a Dropbox

Per creare una connessione per Dropbox moduli:

  1. Clic 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 il Dropbox Segreto Client.
    Tipo di account Specificare se si desidera connettersi a un account di Dropbox personale o aziendale (Dropbox Business).

  3. Clic Continua per salvare la connessione e tornare al modulo.## Dropbox moduli e relativi campi

Dropbox moduli e relativi campi

Quando si configura Dropbox moduli, Workfront Fusion visualizza i campi elencati di seguito. Oltre a questi, ulteriori Dropbox I campi potrebbero essere visualizzati in base a 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, consulta 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 Dropbox account a Workfront Fusion, vedi 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 Dropbox account a Workfront Fusion, vedi 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. Questo modulo esegue ricerche nell’intero Dropbox se non si seleziona una cartella.
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.

Scaricare 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 Dropbox account a Workfront Fusion, vedi 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.

Ottenere i metadati di una 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 Dropbox account a Workfront Fusion, vedi Creare una connessione a Dropbox in questo articolo.
ID cartella condivisa
Immetti o mappa l’ID della cartella di cui desideri recuperare i dettagli.

Elencare 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 Dropbox account a Workfront Fusion, vedi 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 Dropbox account a Workfront Fusion, vedi 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 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 Dropbox account a Workfront Fusion, vedi Creare una connessione a Dropbox in questo articolo.
Folder
Seleziona la cartella del tuo Dropbox desideri caricare il file in.
File di origine

Immetti o mappa il file che desideri aggiungere al Dropbox cartella 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.

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.

Connection
Per istruzioni sulla connessione Dropbox account a Workfront Fusion, vedi 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 Dropbox Business con spazi del team, è necessario rimuovere la barra /, o non fare clic su Fare clic qui per scegliere la cartella per creare una cartella di team nella radice.

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

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

Creare/sovrascrivere 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 Dropbox account a Workfront Fusion, vedi 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.
File di origine

Immetti o mappa il file che desideri aggiungere al Dropbox cartella.

Nome file

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

Contenuto file

Immettete il contenuto del testo del file DOC.

Creare/aggiornare 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 Dropbox account a Workfront Fusion, vedi 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 Dropbox Pro o versione 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 consulta 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.

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

Ripristinare 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 Dropbox account a Workfront Fusion, vedi 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.

Spostare un file o una 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 Dropbox account a Workfront Fusion, vedi 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 Dropbox account a Workfront Fusion, vedi 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 Dropbox account a Workfront Fusion, vedi 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 al Dropbox API. In questo modo, puoi creare un’automazione del flusso di dati che non può essere eseguita dall’altro Dropbox moduli.

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

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

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

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

Method
Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, consulta 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 quali if nel JSON, inserisci le virgolette al di fuori dell’istruzione condizionale.

INFO
Esempio: La seguente chiamata API restituisce i primi 10 file dalla /Text files cartella nel tuo Dropbox account:
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 file Dropbox o ha utilizzato tutte le risorse Dropbox quota di archiviazione dell'account. È necessario eliminare i file esistenti dal 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 >Creare un collegamento condiviso non si collega direttamente a un’immagine, ma a una Dropbox pagina. Per forzare il download dell'immagine, sostituisci la ?dl=0 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 Workfront Fusion moduli, 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, puoi utilizzare replace() funzione 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