Portail de support Workiva

Avec le connecteur BlackLine® OAuth2, vous pouvez utiliser les commandes dans une chaîne pour interagir avec BlackLine, comme pour :

• Liste et téléchargement des rapports de BlackLine
• Importer et gérer des données dans BlackLine, y compris :
  • Comptes
  • Soldes
  • Taux de change
  • Sous-livres
  • Entités
  • Tâches
  • Utilisateurs

Note: Ce connecteur est construit par Workiva et se connecte à un système tiers. Bien que notre équipe d'assistance puisse vous aider à configurer ce connecteur dans votre espace de travail, nous ne sommes pas en mesure de dépanner ou d'aider à résoudre des problèmes qui proviennent de l'extérieur de la plateforme Workiva.

Conditions préalables

Pour configurer le connecteur, vous aurez besoin de :

• Le nom d'hôte de l'instance BlackLine à laquelle se connecter, par exemple sbus2.api.blackline.com
• Le nom d'utilisateur et la clé API d'un utilisateur d'intégration configuré pour un compte de service BlackLine

  Note : L'utilisateur d'intégration a besoin des rôles d'autorisation API et des autorisations d'intégration, ainsi que des rôles et des champs d'application requis pour les tâches que le connecteur exécutera. Pour créer la clé API dans BlackLine, cliquez sur Generate pour API Key sous User Information sur les détails de l'utilisateur d'intégration.

• Seule la version 2.0 de l'API Blackline est prise en charge.
• Les informations d'identification du client de l'utilisateur de l'intégration et les champs d'application OAuth, fournis par votre équipe d'intégration BlackLine

  Note : Si vous avez besoin de l'ID du client, du secret du client ou des champs d'application, contactez votre représentant BlackLine.

Configurer le connecteur BlackLine OAuth2

Note : pour que le connecteur puisse être utilisé dans les chaînes de votre organisation, un admin de sécurité de l’org. doit d’abord l’activer à partir de Configuration.

1. À partir du Générateur de chaînes, cliquez sur Connexions  compare_arrows, puis sur Créer en haut à droite.
2. Sous Connector Connection, sélectionnez BlackLine OAuth2 et le CloudRunner par défaut.
   
3. Saisissez un nom et une description uniques pour identifier la connexion.
4. Sous Propriétés, entrez les détails de la connexion :
   
   

   Propriété	Détails
   Nom d’utilisateur	Saisissez le nom de l'utilisateur de l'intégration BlackLine.
   Mot de passe	Saisissez la clé API générée pour l'utilisateur de l'intégration BlackLine. Remarque : Pour créer ou actualiser la clé API dans BlackLine, cliquez sur Generate for API Key sous User Information dans les détails de l'utilisateur d'intégration. Il s'agit de et non de le mot de passe utilisé pour se connecter à BlackLine en ligne.
   Identifiant du client	Saisissez l'identifiant client fourni par votre équipe d'intégration BlackLine.
   Secret du client	Saisissez le secret client fourni par votre équipe d'intégration BlackLine.
   Étendues	Saisissez les champs d'application OAuth de l'utilisateur d'intégration, fournis par votre équipe d'intégration BlackLine. Le connecteur utilisera ces mêmes champs d'application.
   Nom d'hôte de l'instance	Saisissez le nom d'hôte de l'instance BlackLine à laquelle se connecter, sans https://. Par exemple, pour l'environnement de développement par défaut, sbus2.api.blackline.com.

   Note : toutes les informations d’identification sensibles sont automatiquement chiffrées et stockées avec un chiffrement Advanced Encryption Standard (AES)-256.

5. Sélectionnez les environnements qui utiliseront la connexion et cliquez sur Enregistrer.
6. Pour tester la connexion, créez et exécutez une chaîne avec la commande List Reports du connecteur BlackLine OAuth2, et vérifiez qu'elle renvoie un résultat valide.

Dépannage

Si la connexion à BlackLine échoue :

• Vérifiez les informations d'identification du client et les champs d'application OAuth fournis par votre équipe d'intégration BlackLine. Si vous avez besoin des champs d'application OAuth ou de l'ID ou du secret du client, contactez votre représentant BlackLine.
• Assurez-vous que le nom d'utilisateur et la clé API de l'utilisateur d'intégration sont corrects.

  Note : La clé API de l'utilisateur d'intégration peut expirer. Pour rafraîchir la clé API dans BlackLine, cliquez sur Generate pour API Key sous User Information sur les détails de l'utilisateur d'intégration.

• Vérifiez que l'utilisateur d'intégration dispose d'une autorisation API et des rôles et champs d'application appropriés pour effectuer les tâches liées aux commandes de la connexion.
• Vérifiez que le nom d'hôte de l'instance BlackLine est correct pour le connecteur.