Com o conector BlackLine® OAuth2, você pode usar os comandos em uma cadeia para interagir com a BlackLine, por exemplo, para:
- Listagem e download de relatórios da BlackLine
- Importar e gerenciar dados na BlackLine, inclusive:
- Contas
- Saldos
- Taxas de câmbio
- Subledgers
- Entidades
- Tarefas
- Usuários
Observação: Esse conector foi criado pela Workiva e se conecta a um sistema de terceiros. Embora nossa equipe de suporte possa ajudar a configurar esse conector no seu espaço de trabalho, não podemos solucionar problemas ou ajudar com problemas que se originem fora da plataforma Workiva.
Pré-requisitos
Para configurar o conector, você precisará de:
- O nome do host da instância do BlackLine à qual se conectar, como
sbus2.api.blackline.com - O nome de usuário e a chave de API de um usuário de integração configurado para uma conta de serviço BlackLine
Observação: O usuário de integração precisa de funções de autorização de API e permissões de integração, bem como as funções e os escopos necessários para as tarefas que o conector executará. Para criar a chave de API na BlackLine, clique em Generate para API Key em User Information nos detalhes do usuário de integração.
- Somente a versão 2.0 da Blackline API é compatível
- As credenciais do cliente e os escopos OAuth do usuário de integração, fornecidos pela equipe de integração da BlackLine
Observação: Se precisar do ID do cliente, do segredo do cliente ou dos escopos, entre em contato com o representante da BlackLine.
Configurar o conector BlackLine OAuth2
Observação: Para tornar o conector disponível para uso nas cadeias de sua organização, um administrador de segurança da organização primeiro o habilita em Configuração.
- Em Construtor de cadeia, clique em Conexões e, em seguida, Criar no canto superior direito.
- Em Conexão do conector, selecione BlackLine OAuth2 e o CloudRunner padrão.
- Digite um nome e uma descrição exclusivos para ajudar a identificar a conexão.
- Em Propriedades, digite os detalhes da conexão:
Propriedade Detalhes Nome de usuário Digite o nome de usuário do usuário de integração da BlackLine. Senha Digite a chave de API gerada para o usuário de integração da BlackLine. Observação: Para criar ou atualizar a chave de API na BlackLine, clique em Generate for API Key em User Information nos detalhes do usuário de integração. Este é e não a senha usada para fazer login na BlackLine on-line.
ID do cliente Digite o ID do cliente fornecido pela equipe de integração da BlackLine. Segredo do cliente Digite o segredo do cliente fornecido pela equipe de integração da BlackLine. Escopos Insira os escopos OAuth do usuário de integração, fornecidos pela equipe de integração da BlackLine. O conector usará esses mesmos escopos. Nome do host da instância Insira o nome do host da instância do BlackLine ao qual se conectar, sem o https://. Por exemplo, para o ambiente de desenvolvimento padrão,sbus2.api.blackline.com.Observação: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia Advanced Encryption Standard (AES) 256.
- Selecione os ambientes para usar a conexão e clique em Save.
- Para testar a conexão, crie e execute uma cadeia com o comando List Reports do conector BlackLine OAuth2 e verifique se ele retorna uma saída válida.
Solução de problemas
Se a conexão com a BlackLine falhar:
- Verifique as credenciais do cliente e os escopos do OAuth fornecidos pela equipe de integração da BlackLine. Se precisar dos escopos do OAuth ou do ID ou segredo do cliente, entre em contato com o representante da BlackLine.
- Verifique se o nome de usuário e a chave de API do usuário de integração estão corretos.
Observação: A chave de API do usuário de integração pode expirar. Para atualizar a chave de API na BlackLine, clique em Generate para API Key em User Information nos detalhes do usuário de integração.
- Verifique se o usuário de integração tem autorização de API e funções e escopos adequados para executar as tarefas relacionadas aos comandos da conexão.
- Verifique se o nome correto do host da instância do BlackLine foi inserido para o conector.