Centro de suporte da Workiva

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.

1. Em Construtor de cadeia, clique em Conexões compare_arrows e, em seguida, Criar no canto superior direito.
2. Em Conexão do conector, selecione BlackLine OAuth2 e o CloudRunner padrão.
   
3. Digite um nome e uma descrição exclusivos para ajudar a identificar a conexão.
4. 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.

5. Selecione os ambientes para usar a conexão e clique em Save.
6. 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.