Come utilizzare IBM® App Connect con Box

Box è un servizio sicuro di condivisione di file basato sul web che aiuta il vostro team a collaborare. Potete creare e modificare documenti con i vostri colleghi in tempo reale da qualsiasi luogo e su qualsiasi dispositivo.

Con Box, tutto il team può vedere lo stesso insieme di file e può modificarli in tempo reale da qualsiasi luogo e su qualsiasi dispositivo. In questo modo non è necessario inviare copie dei file come allegati di posta elettronica e tutti hanno sempre a portata di mano la versione più recente dei file, rendendo la collaborazione perfetta. Utilizzate App Connect per collegare più app a Box. Così, ad esempio, ogni volta che viene creata una nuova campagna in Salesforce, viene creata automaticamente una cartella in Box, rendendo il vostro team più collaborativo e risparmiando tempo per altre attività.

Versioni di prodotto e API supportate

Per conoscere le versioni del prodotto e delle API supportate da questo connettore, consultare i requisiti di sistema dettagliati alla pagina di supporto IBM.

Collegamento alla scatola

Per collegare App Connect a un account Box, selezionare il tipo di utente:
  • Utente Amministratore
  • Utente non amministratore

Quindi, fornire i seguenti dettagli di connessione:

Metodo di autorizzazione Campo di connessione Descrizione Applicabilità
OAUTH DI BASE Token di accesso Nella console di sviluppo di Box, crea un'applicazione personalizzata utilizzando il metodo Standard OAuth 2.0 (Autenticazione utente) per generare un ID cliente e un segreto cliente. Un token di accesso viene generato a partire dall'ID del cliente, dal segreto del cliente e dall'URI di reindirizzamento. Per ulteriori informazioni, consultare il sito http://ibm.biz/acboxoauth2nosdk. App Connect in containers e App Connect
Aggiorna token Il token di aggiornamento generato dall'ID del client dell'applicazione e dal segreto del client. Per ulteriori informazioni, vedere http://ibm.biz/acboxoauth2nosdk.
ID client L'identificatore univoco che viene generato dopo la creazione di un'applicazione nella console per sviluppatori di Box. Questo valore si trova nella pagina di configurazione dell'applicazione.
Segreto client Il segreto del client dell'applicazione che viene generato dopo la creazione di un'applicazione nella console sviluppatori di Box. Questo valore si trova nella pagina di configurazione dell'applicazione.
OAUTH 2.0 CODICE DI AUTENTICAZIONE
Suggerimento: Autorizzare la connessione a Box accedendo al proprio account.
   App Connect

Per connettersi a Box dalla pagina Connetti > Applicazioni e API di App Connect Designer (in precedenza la pagina Catalogo) per la prima volta, in Box fare clic su Connetti. Quando richiesto, concedere a App Connect l'accesso in lettura e scrittura ai file e alle cartelle archiviate in Box. Questi passaggi creano un account in App Connect. Per ulteriori informazioni, vedere Gestione degli account.

Per ottenere i valori di connessione per Box, vedere Ottenere i valori di connessione per Box.

Suggerimento:
  • Se si è già effettuato l'accesso a Box nella stessa finestra del browser come App Connect, App Connect si collega a quell'account Box senza richiedere l'indirizzo e-mail e la password. Per collegarsi a un altro account Box, è necessario uscire prima da Box o aprire App Connect in una nuova finestra del browser.
  • Se non avete un account Box, potete creare un account individuale per provare Box gratuitamente.

Prima di utilizzare il conto creato in App Connect in un flusso, rinominare l'account con un nome significativo che ne permetta l'identificazione. Per rinominare l'account nella pagina Applicazioni e API, selezionare l'account, aprire il menu delle opzioni (⋮) e fare clic su Rinomina account.

Cosa considerare prima

Prima di utilizzare App Connect Designer con Box, tenete conto delle seguenti considerazioni.

  • (Considerazione generale) È possibile vedere gli elenchi degli eventi e delle azioni di attivazione disponibili nella pagina Applicazioni e API di App Connect Designer.

    Per alcune applicazioni, gli eventi e le azioni dipendono dall'ambiente e dal fatto che il connettore supporti eventi configurabili e la scoperta dinamica delle azioni. Se l'applicazione supporta gli eventi configurabili, viene visualizzato un collegamento Mostra altri eventi configurabili sotto l'elenco degli eventi. Se l'applicazione supporta il rilevamento dinamico delle azioni, viene visualizzato un link Mostra di più sotto l'elenco delle azioni.

  • (Considerazione generale) Se si utilizzano più account per un'applicazione, l'insieme dei campi visualizzati quando si seleziona un'azione per quell'applicazione può variare per i diversi account. Nell'editor di flusso, alcune applicazioni forniscono sempre un insieme curato di campi statici per un'azione. Altre applicazioni utilizzano la scoperta dinamica per recuperare l'insieme dei campi configurati nell'istanza a cui si è connessi. Ad esempio, se si dispone di due account per due istanze di un'applicazione, il primo account potrebbe utilizzare impostazioni pronte per l'uso immediato. Tuttavia, il secondo account potrebbe essere configurato con campi personalizzati aggiuntivi.

Considerazioni sulla connessione del post

  • Quando si utilizza l'azione Create file per aggiungere un file a Box, si applicano i seguenti punti.
    • Specificare una cartella padre per il file che si desidera creare. Questa cartella deve esistere in Box e può essere selezionata da un elenco precompilato di cartelle Box dell'account.
      Creare campi di file per Box con cartella selezionata
      Suggerimento: Per specificare un valore dinamico (restituito da un evento o da un'azione precedente) per una cartella invece di un valore statico dall'elenco popolato, passare alla modalità avanzata. L'elenco viene convertito in una casella di testo, che può essere utilizzata per mappare l'ID della cartella da un nodo precedente.
      Specificare un valore dinamico per una cartella utilizzando la modalità avanzata
    • Se non si fornisce un'estensione per il nome del file, per impostazione predefinita viene creato un file di testo (.txt).
    • Utilizzare il campo Tipo di file per indicare se il contenuto del file deve essere trattato come testo normale (Text ) o se deve essere applicata la codifica Base64 (Binary ) per formati di file come PDF e Microsoft Word.
  • Quando si utilizza l'azione Create folder per creare una cartella Box, la cartella viene creata per impostazione predefinita a livello di radice. Quando una cartella viene creata a livello di radice, il valore predefinito di 0 (zero) viene visualizzato nel campo ID genitore.
    Creare campi di cartelle per Box

    Nell'interfaccia utente di Box, questo ID si trova nella cartella principale URL.

    ID genitore nella cartella principale di una casella URL

    Per specificare una cartella padre diversa per la cartella che si sta creando, sovrascrivere l'ID predefinito di 0 con un valore codificato o un valore mappato. La cartella parent deve esistere.

    • Per ottenere l'ID codificato di una cartella padre, aprire la cartella in Box. L'ID della cartella viene visualizzato come una sequenza di numeri alla fine di URL nella barra degli indirizzi del browser. Ad esempio, nella cartella URL https://app.box.com/folder/31234567893, l'ID della cartella è 31234567893.
    • Se il flusso contiene un'azione precedente che restituisce un ID cartella (ad esempio, un'azione "Recupera cartelle"), è possibile specificare l'ID genitore come campo mappato.
      Il campo ID genitore mostra un valore mappato
  • Quando si recupera o si trasferisce il contenuto di un file, se il contenuto del file deve essere analizzato o trasformato utilizzando le funzioni JSONata, la dimensione massima del file è di 10 MB. Altrimenti, la dimensione massima del file è di 50 MB.

    Per l'azione Create file , è possibile specificare il contenuto del file specificando il testo o mappando il contenuto da un nodo precedente del flusso. Se si esegue una mappatura sul contenuto, specificare solo un singolo valore mappato e non aggiungere un prefisso di una stringa di testo al valore mappato. Gli esempi validi e non validi sono riportati nella tabella seguente.

    Esempi validi Esempi non validi
    Esempio valido che mostra il campo Contenuto del file mappato solo su testo
    Esempio valido che mostra il campo Contenuto file mappato solo sul contenuto del file Box
    Esempio non valido che mostra il campo contenuto di Box File mappato su testo preimpostato e contenuto di Box File
    Esempio non valido che mostra il campo Contenuto del file mappato sia sul contenuto del file Box che sul testo aggiunto
    Esempio non valido che mostra il campo Contenuto file mappato su due istanze di Contenuto file di Box
  • Quando si utilizza l'azione Recupera metadati file, è necessario specificare una condizione di filtro. Fornire l'ID di un file Box (condizione ID ) oppure fornire una stringa di ricerca (condizione stringa di ricerca ) da ricercare nel nome, nella descrizione e nei commenti dei file.
  • Quando si utilizza l'azione "Crea attività" per aggiungere un'attività a un file Box, è necessario specificare l'ID del file (campo ID elemento ). È possibile mappare il valore dell'ID da un'azione precedente (ad esempio, Recupera metadati del file ) o specificando un ID di file noto (ad esempio, dall'indirizzo del file nell'interfaccia del browser web Box https://app.box.com/file/File_ID).
  • Quando si utilizza un'azione Recupera contenente il parametro Campi (ad esempio, l'azione Recupera file cestinato ), lo schema di risposta include molte proprietà che non vengono restituite per impostazione predefinita dall'API di Box. Anche se queste proprietà appaiono nell'editor di mappatura, i loro valori non vengono popolati a meno che non vengano richiesti esplicitamente.

    Recupero dei file cestinati in Box

    Per recuperare i valori di queste proprietà, è necessario specificare i loro nomi nel parametro Fields come elenco separato da virgole. Se non si includono i nomi delle proprietà nel parametro Fields, la risposta non conterrà i valori di tali proprietà, anche se sono state mappate. Ad esempio, se si desidera recuperare il nome, la versione del file e la descrizione, inserire name,file_version,description nell'input Campi. La risposta includerà quindi i valori di queste proprietà.

Suggerimenti per la risoluzione dei problemi

Quando vengono aggiunte a un flusso, alcune azioni di Box effettuano immediatamente una chiamata API a Box per recuperare l'insieme di oggetti esistenti su cui l'azione può essere completata o contro cui può essere completata. Ad esempio, l'azione Create file effettua una prima chiamata per ottenere l'elenco delle cartelle esistenti in cui è possibile creare il file. Se si vede unNot connectedquando si aggiungono azioni di questo tipo, ma non si riscontra questo errore per altre azioni di Box (che in genere effettuano una chiamata solo quando il flusso viene eseguito), la connessione tra App Connect e Box potrebbe essere interrotta.

Casella / L'azione Crea file mostra il messaggio 'Non connesso'

Per ristabilire una connessione interrotta, è necessario riautorizzare l'account Box aggiornando i dettagli di connessione per tale account.

Eventi e azioni

Eventi in scatola

Questi eventi riguardano le modifiche dell'applicazione che attivano un flusso per iniziare a completare le azioni del flusso.

Nota: gli eventi non sono disponibili per le modifiche in questa applicazione. È possibile attivare un flusso in altri modi, ad esempio a intervalli programmati o a date e orari specifici.

Azioni in scatola

Il flusso completa queste azioni su questa applicazione.

Oggetto Azione Descrizione
Segnalibri Crea segnalibro Crea un segnalibro in Box
Elimina segnalibri Elimina un collegamento web da un account Box
Recuperare i segnalibri Ottiene informazioni su un collegamento web
Aggiorna segnalibri Aggiorna un link web
Collaborazioni Creare collaborazione Crea una collaborazione in Box
Eliminare le collaborazioni Elimina una collaborazione dall'account Box
Recuperare le collaborazioni Ottiene informazioni sulle collaborazioni
Aggiornare le collaborazioni Aggiornamenti di una collaborazione
Commenti Creare un commento Crea un commento in Box
Cancellare i commenti Elimina un commento da un account Box
Recuperare i commenti Ottiene informazioni sui commenti
Commenti di aggiornamento Aggiornamenti un commento
File Copia file Crea una copia di un file in un'altra cartella. La versione originale del file non verrà alterata.
Crea file Crea un file in una cartella specificata dell'account Box
Elimina i file Elimina un file dall'account Box
Recuperare il contenuto del file Scarica un file dal proprio account Box
Recuperare i metadati dei file Ottiene informazioni sui file presenti nell'account Box
Aggiornare i file Aggiorna il contenuto di un file specifico
Recuperare le versioni dei file Recupera un elenco delle versioni precedenti di un file
Recuperare il file cestinato Recupera un file che è stato spostato nel cestino
Elementi cartella Recuperare gli elementi della cartella Ottiene tutti gli elementi della cartella
Cartelle Copiare la cartella Crea una copia di una cartella in un'altra cartella
Crea cartella Aggiunge una nuova cartella in Box
Eliminare le cartelle Elimina una cartella da un account Box
Recuperare le cartelle Ottiene informazioni sulle cartelle
Aggiornare le cartelle Aggiorna le impostazioni di una cartella specifica
Adesioni al gruppo Creare l'appartenenza al gruppo Crea l'appartenenza a un gruppo su un gruppo
Eliminare le appartenenze ai gruppi Elimina l'appartenenza a un gruppo da un gruppo di account Box
Recuperare le appartenenze ai gruppi Ottiene informazioni sui membri del gruppo
Aggiornare le appartenenze ai gruppi Aggiorna l'appartenenza a un gruppo
Link condivisi Creare o aggiornare un link condiviso Crea o aggiorna un link condiviso
Recuperare i link condivisi Ottiene informazioni sui collegamenti condivisi
Assegnazione dei compiti Creare l'assegnazione di un compito Crea un'assegnazione di attività per un'attività in Box
Eliminare le assegnazioni dei compiti Elimina un'assegnazione di attività per un'attività nell'account Box
Recuperare le assegnazioni dei compiti Recupera le assegnazioni di attività per un'attività in Box
Aggiornare le assegnazioni dei compiti Aggiorna un'assegnazione di attività per un'attività nell'account Box
Attività Crea attività Crea un'attività su un file
Elimina compiti Elimina un'attività da un account Box
Recuperare le attività Ottiene informazioni sui compiti
Aggiornare le attività Aggiorna un'attività

Altri elementi sono disponibili dopo aver collegato App Connect a Box.

Esempi

Quadro di comando per un modello che utilizza Box
Quadro di comando per un modello che utilizza Box
Quadro di comando per un modello che utilizza Box

Utilizzate i modelli per creare rapidamente i flussi per Box

Imparate a usare i modelli di App Connect per creare rapidamente flussi che completano le azioni su Box. Ad esempio, aprite Discover e cercate Box.

Per saperne di più

Quadro di comando per un modello che utilizza Box