Frame.io moduli V4

IMPORTANT
Questo articolo descrive la nuova versione del connettore Frame.io. Questo connettore viene utilizzato per connettersi alla versione 4 di Frame.io.
Per istruzioni sulla versione legacy del connettore Frame.io, vedere Connettore legacy Frame.io.

I moduli di Adobe Workfront Fusion Frame.io consentono di monitorare, creare, aggiornare, recuperare o eliminare risorse e commenti nell'account Frame.io.

Workfront offre due connettori Frame.io, in base alla versione di Frame.io a cui ti stai connettendo.

Connettore
Versione Frame.io
Frame.io
V4
Frame.io (legacy)
V3

Per istruzioni sulla versione legacy del connettore Frame.io, vedere Connettore legacy Frame.io.

Per un video introduttivo sul connettore Frame.io, vedi:

Requisiti di accesso

Espandi per visualizzare i requisiti di accesso per la funzionalità in questo articolo.

Per utilizzare le funzionalità di questo articolo, è necessario disporre dei seguenti diritti 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
Licenza Adobe Workfront

Nuovo: Standard

Oppure

Corrente: Lavoro o versione successiva

Licenza Adobe Workfront Fusion**

Corrente: nessun requisito di licenza Workfront Fusion

Oppure

Legacy: Workfront Fusion per l'automazione e l'integrazione del lavoro

Prodotto

Novità:

  • Seleziona o crea un pacchetto Prime Workfront: la tua organizzazione deve acquistare Adobe Workfront Fusion.
  • Pacchetto Ultimate Workfront: è incluso Workfront Fusion.

Oppure

Corrente: la tua organizzazione deve acquistare Adobe Workfront Fusion.

Per ulteriori dettagli sulle informazioni contenute in questa tabella, vedere Requisiti di accesso nella documentazione.

Per informazioni sulle licenze di Adobe Workfront Fusion, vedere Licenze di Adobe Workfront Fusion.

Prerequisiti

Per utilizzare i moduli Frame.io, è necessario disporre di un account Frame.io

Informazioni API Frame.io

Il connettore Frame.io utilizza quanto segue:

URL di base
https://api.frame.io/v4
Versione API
v2
Tag API
v1.0.76

Connetti Frame.io a Adobe Workfront Fusion

È possibile connettersi automaticamente con le credenziali utente, creare manualmente una connessione con le credenziali utente o creare una connessione server-to-server.

Connetti automaticamente con le credenziali utente

Questo metodo crea automaticamente una connessione se si è connessi a Frame.io o alla pagina di accesso a Frame.io per consentire l'accesso.

  1. In qualsiasi modulo di Beta Frame.io, fai clic su Aggiungi accanto alla casella Connessione.
  2. Immettere un nome per la connessione.
  3. Fai clic su Continua.
  4. Se viene richiesto di accedere all'account Frame.io, eseguire questa operazione.
  5. Se fai parte di più organizzazioni Frame.io, seleziona l'organizzazione che desideri utilizzare per questa connessione.

La connessione viene creata.

Creare manualmente una connessione di credenziali utente

È possibile creare una connessione di credenziali utente accedendo a Frame.io o fornendo un ID client o un segreto client.

Per creare una connessione server-to-server, è innanzitutto necessario configurare un'applicazione in Adobe Developer Console.

Creare le credenziali utente in Adobe Developer Console

Se non si dispone già di credenziali server-to-server in un progetto Adobe Developer Console, è possibile crearle.

  1. Apri Adobe Developer Console.

  2. Seleziona un progetto esistente nel Adobe Developer Console da utilizzare per questa connessione

    Oppure

    Crea un nuovo progetto in Adobe Developer Console. Per istruzioni, vedere Creare un progetto vuoto.

  3. Nella pagina Panoramica del progetto o nella pagina Introduzione al nuovo progetto, fai clic su Aggiungi API.

  4. Nella pagina visualizzata individuare e fare clic su Frame.io API.

  5. Nella pagina Seleziona tipo di autenticazione selezionare Autenticazione utente e fare clic su Avanti.

  6. Nella pagina Aggiungi credenziali di autenticazione utente, seleziona OAuth Web App e fai clic su Avanti.

  7. Nella pagina Configura credenziali app Web OAuth, immetti quanto segue:

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    URI di reindirizzamento predefinito https://oauth.app.workfrontfusion.com/oauth/cb/frame-io2
    Schema URI di reindirizzamento https://oauth\.app\.workfrontfusion\.com/oauth/cb/frame-io2
  8. Fai clic su Avanti.

  9. Fai clic su Salva API configurata.

  10. Nella pagina del prodotto, fai clic sulla scheda delle credenziali appena create.

    Qui puoi trovare l’ID client e il segreto client.

NOTE
È consigliabile lasciare aperta questa finestra quando si inizia a configurare la connessione in Adobe Workfront Fusion. Puoi copiare l’ID client, quindi recuperare e copiare il segreto client da questa pagina per incollarlo nei campi della connessione.

Configurare una connessione di autenticazione utente

  1. In qualsiasi modulo di Beta Frame.io, fai clic su Aggiungi accanto alla casella Connessione.

  2. Nella casella Crea connessione fare clic su Mostra impostazioni avanzate.

  3. Compila i campi seguenti:

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
    Tipo di connessione Seleziona Autenticazione utente IMS.
    Nome connessione Immettere un nome per la connessione.
    ID client

    Immetti l'ID client Adobe . È disponibile nella sezione Credentials details di Adobe Developer Console.

    Per istruzioni sulla creazione delle credenziali, vedere Creare le credenziali utente in Adobe Developer Console in questo articolo.

    Segreto client

    Immetti Adobe Client Secret. È disponibile nella sezione Credentials details di Adobe Developer Console.

    Per istruzioni sulla creazione delle credenziali, vedere Creare le credenziali utente in Adobe Developer Console in questo articolo.

  4. Se viene richiesto di accedere all'account Frame.io, eseguire questa operazione.

  5. Se fai parte di più organizzazioni Frame.io, seleziona l'organizzazione che desideri utilizzare per questa connessione.

La connessione viene creata.

Creare una connessione server-to-server

Per creare una connessione server-to-server, è innanzitutto necessario configurare un'applicazione in Adobe Developer Console.

Creare credenziali da server a server in Adobe Developer Console

Se non si dispone già di credenziali server-to-server in un progetto Adobe Developer Console, è possibile crearle.

  1. Apri Adobe Developer Console.

  2. Seleziona un progetto esistente nel Adobe Developer Console da utilizzare per questa connessione

    Oppure

    Crea un nuovo progetto in Adobe Developer Console. Per istruzioni, vedere Creare un progetto vuoto.

  3. Nella pagina Panoramica del progetto o nella pagina Introduzione al nuovo progetto, fai clic su Aggiungi API.

  4. Nella pagina visualizzata individuare e fare clic su Frame.io API.

  5. Nella pagina Seleziona tipo di autenticazione selezionare Autenticazione da server a server e fare clic su Avanti.

  6. Immettere un nome per le credenziali. Questo consente di identificare le credenziali in un secondo momento nell’area Credenziali API di Adobe Admin Console.

  7. Fai clic su Avanti.

  8. Nella pagina Seleziona profili di prodotto, seleziona il profilo di prodotto che include l’account Frame.io a cui desideri connetterti.

  9. Fai clic su Salva API configurata.

  10. Nella pagina del prodotto, fai clic sulla scheda delle credenziali appena create.

    Qui puoi trovare l’ID client e il segreto client.

NOTE
È consigliabile lasciare aperta questa finestra quando si inizia a configurare la connessione in Adobe Workfront Fusion. Puoi copiare l’ID client, quindi recuperare e copiare il segreto client da questa pagina per incollarlo nei campi della connessione.

Configurare una connessione server-to-server

  1. In qualsiasi modulo di Beta Frame.io, 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 layout-auto html-authored no-header
    Tipo di connessione Selezionare il server IMS al server.
    Nome connessione Immettere un nome per la connessione.
    ID client

    Immetti l'ID client Adobe . È disponibile nella sezione Credentials details di Adobe Developer Console.

    Per istruzioni sulla creazione delle credenziali, vedere Creare credenziali da server a server in Adobe Developer Console in questo articolo.

    Segreto client

    Immetti Adobe Client Secret. È disponibile nella sezione Credentials details di Adobe Developer Console.

    Per istruzioni sulla creazione delle credenziali, vedere Creare credenziali da server a server in Adobe Developer Console in questo articolo.

  3. Fai clic su Continua per salvare la connessione e tornare al modulo.

Frame.io moduli e relativi campi

Quando si configurano Frame.io moduli, in Workfront Fusion vengono visualizzati i campi elencati di seguito. Insieme a questi, potrebbero essere visualizzati ulteriori campi di Frame.io, 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

Risorse

Crea una risorsa

Questo modulo crea una nuova risorsa.

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona l’account o esegui il mapping dell’ID dell’account contenente il progetto per il quale desideri creare una risorsa.
Workspace ID
Seleziona l’area di lavoro o mappa l’ID dell’area di lavoro che contiene il progetto per il quale desideri creare una risorsa.
ID progetto
Seleziona il progetto o mappa l’ID del progetto per il quale desideri creare una risorsa.
Path
Seleziona il percorso in cui desideri creare una risorsa.
Nome File
Immetti il nome del file da utilizzare per questa risorsa.
Dimensioni file
Immettere o mappare la dimensione del file in byte.
URL Source
Se crei un file, immetti l’URL del file da caricare.
Tipo di file multimediale
Seleziona il tipo di file multimediale per questa risorsa.

Eliminare una risorsa

Questo modulo di azione elimina una risorsa specificata.

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona l’account o esegui il mapping dell’ID dell’account che contiene la risorsa da eliminare.
ID risorsa
Seleziona o mappa la risorsa da eliminare.

Ottieni una risorsa

Questo modulo di azione recupera i dettagli della risorsa.

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona l’account o esegui il mapping dell’ID dell’account che contiene la risorsa da recuperare.
ID risorsa
Seleziona o mappa la risorsa da recuperare.

Elencare risorse

Questo modulo di ricerca recupera tutte le risorse nella cartella del progetto specificato.

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona l’account o esegui il mapping dell’ID dell’account che contiene le risorse da elencare.
Numero massimo di risorse restituite
Immettere o mappare il numero massimo di risorse che il modulo deve restituire durante ciascun ciclo di esecuzione dello scenario.

Guarda risorsa eliminata

Questo modulo di attivazione avvia uno scenario quando una risorsa viene eliminata.

Selezionare il webhook che si desidera utilizzare per questo modulo oppure fare clic su Aggiungi accanto al campo Webhook e immettere le informazioni seguenti:

Nome webhook
Immetti un nome per il nuovo webhook.
Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona l’account o esegui il mapping dell’ID dell’account da controllare per le risorse eliminate.

Guarda nuova risorsa

Questo modulo di attivazione avvia uno scenario quando viene creata una nuova risorsa.

Selezionare il webhook che si desidera utilizzare per questo modulo oppure fare clic su Aggiungi accanto al campo Webhook e immettere le informazioni seguenti:

Nome webhook
Immetti un nome per il nuovo webhook.
Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona l’account o esegui il mapping dell’ID dell’account da controllare per le nuove risorse.

Commenti

Crea un commento

Questo modulo di azione aggiunge un nuovo commento o una nuova risposta alla risorsa.

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona l’account o esegui il mapping dell’ID dell’account contenente la risorsa a cui desideri aggiungere un commento.
Workspace ID
Seleziona l’account o mappa l’ID dell’area di lavoro che contiene la risorsa a cui desideri aggiungere un commento.
ID progetto
Seleziona il progetto o mappa l’ID del progetto che contiene la risorsa a cui desideri aggiungere un commento.
Path
Seleziona il percorso della risorsa a cui desideri aggiungere un commento.
Text
Immettere il contenuto del testo del commento o della risposta.
Timestamp
Immetti il numero del fotogramma nel video a cui deve essere collegato il commento.
Page
Se la risorsa è un PDF, immetti o mappa la pagina a cui deve essere allegato il commento.

Elimina commento

Questo modulo elimina un commento esistente.

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona l’account o esegui il mapping dell’ID dell’account che contiene il commento da eliminare.
ID commento
Inserisci o mappa l’ID del commento da eliminare.

Visualizza un commento

Questo modulo di azione recupera i dettagli del commento specificato.

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona l’account o esegui il mapping dell’ID dell’account che contiene il commento di cui desideri recuperare i dettagli.
ID commento
Seleziona il commento di cui desideri recuperare i dettagli.

Elenca commenti

Questo modulo di ricerca recupera tutti i commenti della risorsa specificata.

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona o mappa l’account contenente la risorsa da cui desideri recuperare i commenti.
Workspace ID
Seleziona o mappa l’area di lavoro contenente la risorsa da cui desideri recuperare i commenti.
ID progetto
Seleziona il progetto contenente la risorsa da cui desideri recuperare i commenti.
Path
Seleziona il percorso da cui si trova la risorsa da cui desideri elencare i commenti.
Numero massimo di commenti restituiti
Immettere o mappare il numero massimo di commenti che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.

Aggiorna un commento

Questo modulo modifica un commento esistente.

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona o esegui il mapping dell'account contenente il progetto contenente la risorsa su cui desideri aggiornare un commento.
ID commento
Seleziona il commento da aggiornare.
Text
Immetti il contenuto del testo del commento.
Timestamp
Immetti il numero del fotogramma nel video a cui è collegato il commento.
Page
Se la risorsa è un PDF, immetti o mappa la pagina a cui è associato il commento.

Osserva commento aggiornato

Questo modulo di attivazione avvia uno scenario quando un commento viene aggiornato.

Selezionare il webhook che si desidera utilizzare per questo modulo oppure fare clic su Aggiungi accanto al campo Webhook e immettere le informazioni seguenti:

Nome webhook
Immetti un nome per il nuovo webhook.
Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona l’account o esegui il mapping dell’ID dell’account da controllare per i commenti aggiornati.

Guarda nuovo commento

Questo modulo di attivazione avvia uno scenario quando viene creato un commento.

Selezionare il webhook che si desidera utilizzare per questo modulo oppure fare clic su Aggiungi accanto al campo Webhook e immettere le informazioni seguenti:

Nome webhook
Immetti un nome per il nuovo webhook.
Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona l’account o mappa l’ID dell’account che desideri controllare per i nuovi commenti.

Cartelle

Creare una cartella

Questo modulo di azione crea una nuova cartella in Frame.io.

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona o mappa l’account in cui desideri creare una cartella.
Workspace ID
Seleziona o mappa l’area di lavoro in cui desideri creare una cartella.
ID progetto
Seleziona la posizione in cui desideri creare una cartella.
Path
Seleziona il percorso in cui desideri creare una cartella.
Nome
Immettere o mappare un nome per la nuova cartella.

Progetti

Creare un progetto

Questo modulo crea un nuovo progetto in Frame.io.

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona o esegui il mapping dell’account nel punto in cui desideri creare un progetto.
Workspace ID
Seleziona o mappa l’area di lavoro in cui desideri creare un progetto.
Nome
Inserisci o mappa un nome per il nuovo progetto.

Invita utenti al progetto Frame.io

Questo modulo di azione invita gli utenti al progetto Frame.io specificato.

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona o mappa l’account contenente il progetto a cui desideri invitare un utente.
Workspace ID
Seleziona o mappa l’area di lavoro contenente il progetto a cui desideri invitare un utente.
ID progetto
Seleziona o mappa il progetto a cui desideri invitare un utente.
ID utente
Seleziona o mappa l’utente che desideri invitare al progetto.

Elenca progetti

Questo modulo di ricerca recupera tutti i progetti per il team specificato.

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona o mappa l’account contenente la risorsa da cui desideri recuperare i progetti.
Workspace ID
Seleziona o mappa l’area di lavoro contenente la risorsa da cui desideri recuperare i progetti.
Numero massimo di progetti restituiti
Inserisci o mappa il numero massimo di progetti desideri che il modulo venga restituito durante ogni ciclo di esecuzione dello scenario.

Condivisioni

Aggiungere una risorsa a un collegamento di condivisione

Questo modulo aggiunge una risorsa a un collegamento di condivisione in Frame.io.

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona o mappa l’account contenente il collegamento di condivisione a cui desideri aggiungere una risorsa.
ID collegamento condivisione
Seleziona o mappa il collegamento di condivisione a cui desideri aggiungere una risorsa.
ID risorsa
Inserisci o mappa l’ID della risorsa da aggiungere al collegamento di condivisione.

Creare un collegamento di condivisione

Questo modulo crea un nuovo collegamento di condivisione in Frame.io.

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Selezionare o mappare l'account in cui si desidera creare un collegamento di condivisione.
Workspace ID
Seleziona o mappa l’area di lavoro in cui desideri creare un collegamento di condivisione.
ID progetto
Seleziona o mappa il progetto in cui desideri creare un collegamento di condivisione.
Accesso
Seleziona se il collegamento ha accesso pubblico o limitato.
Risorse
Per ogni risorsa che desideri aggiungere al collegamento di condivisione, fai clic su Aggiungi elemento e immetti l'ID della risorsa.
Descrizione
Immettere o mappare una descrizione per il collegamento di condivisione.
Nome
Immettere o mappare la data di scadenza del collegamento di condivisione.
Nome
Immettere o mappare un nome per il nuovo collegamento di condivisione.
Nome
Immettere o mappare una passphrase per il collegamento di condivisione.

Aree di lavoro

Crea un’area di lavoro

Questo modulo di azione crea un nuovo workspace in Frame.io

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona o mappa l’account in cui desideri creare un’area di lavoro.
Name
Immettere o mappare un nuovo nome per l'area di lavoro.

Elencare aree di lavoro

Questo modulo elenca tutte le aree di lavoro di un account.

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona o mappa l’account contenente la risorsa da cui desideri recuperare le aree di lavoro.
Numero massimo di aree di lavoro restituite
Inserisci o mappa il numero massimo di aree di lavoro desideri che il modulo venga restituito durante ogni ciclo di esecuzione dello scenario.

Altro

Effettuare una chiamata API personalizzata

Questo modulo ti consente di eseguire una chiamata API personalizzata.

Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
URL

Immettere un percorso relativo a https://api.frame.io. Esempio: /v4/me

Nota: per l'elenco degli endpoint disponibili, fare riferimento al riferimento API Frame.io.

Method
Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, vedere Metodi di richiesta HTTP.
Headers

Aggiungi le intestazioni della richiesta sotto forma di oggetto JSON standard.

Ad esempio: {"Content-type":"application/json"}

Workfront Fusion aggiunge automaticamente le intestazioni di autorizzazione.

Stringa di query
Immettere la stringa di query richiesta. Per ogni parametro che si desidera includere nella stringa di query, fare clic su Add item e immettere il nome del campo e il valore desiderato.
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.

Valore metadati controllo aggiornato

Questo modulo di attivazione avvia uno scenario quando un commento viene aggiornato.

Selezionare il webhook che si desidera utilizzare per questo modulo oppure fare clic su Aggiungi accanto al campo Webhook e immettere le informazioni seguenti:

Nome webhook
Immetti un nome per il nuovo webhook.
Connection
Per istruzioni sulla creazione di una connessione a Frame.io, vedere Connettere Frame.io ad Adobe Workfront Fusion in questo articolo.
ID account
Seleziona l’account o esegui il mapping dell’ID dell’account da controllare per verificare la presenza di valori di metadati aggiornati.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3