Con il connettore BlackLine® OAuth2, puoi utilizzare i comandi in una catena per interagire con BlackLine, ad esempio per:
- Elencare e scaricare i report da BlackLine
- Importare e gestire i dati in BlackLine, tra cui:
- Account
- Bilanci
- Tassi di cambio
- Libri mastri sussidiari
- Entità
- Attività
- Utenti
Nota: Questo connettore è stato realizzato da Workiva e si collega a un sistema di terze parti. Sebbene il nostro team di assistenza possa aiutare a configurare questo connettore all'interno del tuo spazio di lavoro, non siamo in grado di risolvere i problemi o di fornire assistenza in altro modo per qualsiasi problema che abbia origine al di fuori della piattaforma Workiva.
Prerequisiti
Per configurare il connettore, avrai bisogno di:
- Il nome dell'host dell'istanza BlackLine a cui connettersi, come ad esempio
sbus2.api.blackline.com - Il nome utente e la chiave API di un utente di integrazione impostato per un account di servizio BlackLine
Nota: L'utente di integrazione ha bisogno dei ruoli di autorizzazione API e dei permessi di integrazione, nonché dei ruoli e degli scope richiesti per le attività che il connettore eseguirà. Per creare la chiave API in BlackLine, clicca su Genera per Chiave API in Informazioni utente nei dettagli dell'utente dell'integrazione.
- È supportata solo la versione 2.0 dell'API Blackline
- Le credenziali cliente e gli scope OAuth dell'utente dell'integrazione, forniti dal team di integrazione BlackLine
Nota: Se hai bisogno dell'ID client, del segreto del client o degli scope, contatta il tuo rappresentante BlackLine.
Configurare il connettore OAuth2 di BlackLine
Nota: Per rendere il connettore disponibile per l'uso nelle catene della tua organizzazione, un amministratore della sicurezza dell'org deve prima abilitarlo da Configurazione.
- Da Builder catena, clicca su Connessioni e poi su Crea in alto a destra.
- In Connector Connection, seleziona BlackLine OAuth2 e il CloudRunner predefinito.
- Inserisci un nome e una descrizione unici per identificare la connessione.
- In Proprietà, inserisci i dettagli della connessione:
Proprietà Dettagli Nome utente Inserisci il nome dell'utente dell'integrazione BlackLine. Password Inserisci la chiave API generata per l'utente dell'integrazione BlackLine. Nota: Per creare o aggiornare la chiave API in BlackLine, clicca su Genera per Chiave API in Informazioni utente nei dettagli dell'utente dell'integrazione. Questa non è la password utilizzata per accedere a BlackLine online.
ID client Inserisci l'ID client fornito dal team di integrazione BlackLine. Segreto del client Inserisci il segreto del client fornito dal team di integrazione BlackLine. Scope Inserisci gli scope OAuth dell'utente dell'integrazione, forniti dal team di integrazione BlackLine. Il connettore utilizzerà questi stessi scope. Nome host dell'istanza Inserisci il nome dell'host dell'istanza BlackLine a cui connetterti, senza https://. Ad esempio, per l'ambiente di sviluppo predefinito,sbus2.api.blackline.com.Nota: Tutte le credenziali sensibili vengono automaticamente crittografate e memorizzate con la crittografia Advanced Encryption Standard (AES)-256.
- Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
- Per testare la connessione, crea ed esegui una catena con il comando Elenca report del connettore BlackLine OAuth2 e verifica che restituisca un output valido.
Risoluzione dei problemi
Se la connessione a BlackLine fallisce:
- Verifica le credenziali del cliente e gli scope OAuth forniti dal team di integrazione BlackLine. Se hai bisogno degli scope OAuth o dell'ID o del segreto del client, contatta il tuo rappresentante BlackLine.
- Assicurati che il nome utente e la chiave API dell'utente dell'integrazione siano corretti.
Nota: La chiave API dell'utente dell'integrazione potrebbe scadere. Per aggiornare la chiave API in BlackLine, clicca su Genera per Chiave API in Informazioni utente nei dettagli dell'utente dell'integrazione.
- Verifica che l'utente dell'integrazione abbia l'autorizzazione API e i ruoli e gli scope appropriati per eseguire le attività relative ai comandi della connessione.
- Verifica che sia stato inserito il nome host corretto dell'istanza BlackLine per il connettore.