Centro de soporte de Workiva

Con el conector BlackLine® OAuth2, puedes utilizar comandos en una cadena para interactuar con BlackLine, por ejemplo para:

• Enumera y descarga informes de BlackLine.
• Importa y gestiona datos en BlackLine, incluyendo:
  • Cuentas
  • Balances
  • Tipos de moneda
  • Registros auxiliares
  • Entidades
  • Tareas
  • Usuarios

Nota: Este conector ha sido creado por Workiva y conecta con un sistema de terceros. Aunque nuestro equipo de asistencia puede ayudarte a configurar este conector dentro de tu espacio de trabajo, no podemos solucionar ni ayudar de ningún otro modo con los problemas que se originen fuera de la plataforma Workiva.

Requisitos previos

Para configurar el conector, necesitarás:

• El nombre de host de la instancia de BlackLine a la que conectarse, como sbus2.api.blackline.com
• El nombre de usuario y la clave API de un usuario de integración configurado para una cuenta de servicio BlackLine

  Nota: El usuario de integración necesita roles de autorización de API y permisos de integración, así como los roles y ámbitos necesarios para las tareas que realizará el conector. Para crear la clave API en BlackLine, haz clic en Generar para Clave API en Información de usuario en los datos del usuario de la integración.

• Solo se admite la versión 2.0 de la API de Blackline
• Las credenciales de cliente del usuario de integración y los ámbitos de OAuth, proporcionados por tu equipo de integración de BlackLine

  Nota: Si necesitas el Id de cliente, el secreto de cliente o los ámbitos, ponte en contacto con tu representante de BlackLine.

Establecer el conector BlackLine OAuth2

Nota: Para que el conector esté disponible para su uso en las cadenas de tu organización, un administrador de seguridad de la organización primero lo habilita desde Configuración.

1. En el Generador de cadenas, haz clic en Conexiones  compare_arrows y, a continuación, en Crear en la parte superior derecha.
2. En Conector Conexión, selecciona BlackLine OAuth2 y el CloudRunner predeterminado.
   
3. Introduce un nombre que sea único y una descripción para ayudar a identificar la conexión.
4. En Propiedades, ingresa los detalles de la conexión:
   
   

   Propiedad	Detalles
   Nombre de usuario	Introduce el nombre de usuario del usuario de integración de BlackLine.
   Contraseña	Introduce la clave API generada para el usuario de la integración BlackLine. Nota: Para crear o actualizar la clave API en BlackLine, haz clic en Generar para Clave API en Información de usuario en los detalles del usuario de integración. Esto es no la contraseña utilizada para iniciar sesión en BlackLine online.
   ID de cliente	Introduce el ID de cliente proporcionado por tu equipo de integración de BlackLine.
   Secreto de cliente	Introduce el secreto de cliente proporcionado por tu equipo de integración de BlackLine.
   Ámbitos	Introduce los ámbitos OAuth del usuario de integración, proporcionados por tu equipo de integración de BlackLine. El conector utilizará estos mismos ámbitos.
   Nombre del host de la instancia	Introduce el nombre de host de la instancia de BlackLine a la que conectarte, sin la https://. Por ejemplo, para el entorno de desarrollo predeterminado, sbus2.api.blackline.com.

   Nota: Todas las credenciales confidenciales se cifran automáticamente y se almacenan con un cifrado Advanced Encryption Standard (AES)-256.

5. Selecciona los entornos para utilizar la conexión y haz clic en Guardar.
6. Para probar la conexión, crea y ejecuta una cadena con el comando Lista de informes del conector BlackLine OAuth2, y comprueba que devuelve una salida válida.

Solución de problemas

Si falla la conexión a BlackLine:

• Verifica las credenciales de cliente y los ámbitos de OAuth proporcionados por tu equipo de integración de BlackLine. Si necesitas los Ámbitos OAuth o el Id de cliente o secreto, ponte en contacto con tu representante de BlackLine.
• Asegúrate de que el nombre de usuario y la clave API del usuario de la integración son correctos.

  Nota: La clave API del usuario de integración puede caducar. Para actualizar la clave API en BlackLine, haz clic en Generar para Clave API en Información de usuario en los detalles del usuario de la integración.

• Verifica que el usuario de la integración tiene autorización para la API y los roles y ámbitos adecuados para realizar las tareas relacionadas con los comandos de la conexión.
• Verifica que se ha introducido el nombre correcto del host de la instancia de BlackLine para el conector.