Workiva Support Center

Mit dem BlackLine® OAuth2-Konnektor können Sie Befehle in einer Kette verwenden, um mit BlackLine zu interagieren, z. B. um:

• Auflisten und Herunterladen von Berichten aus BlackLine
• Importieren und verwalten Sie Daten in BlackLine, einschließlich:
  • Konten
  • Bilanzen
  • Wechselkurse
  • Nebenbücher
  • Entitäten
  • Aufgaben
  • Benutzer

Hinweis: Dieser Konnektor wird von Workiva hergestellt und verbindet sich mit einem System eines Drittanbieters. Unser Support-Team kann Ihnen zwar bei der Konfiguration dieses Konnektors innerhalb Ihres Arbeitsbereichs behilflich sein, aber wir sind nicht in der Lage, Fehler zu beheben oder anderweitig bei Problemen zu helfen, die ihren Ursprung außerhalb der Workiva-Plattform haben.

Voraussetzungen

Zur Einrichtung des Konnektors benötigen Sie Folgendes:

• Der Hostname der BlackLine-Instanz, mit der eine Verbindung hergestellt werden soll, z. B. sbus2.api.blackline.com
• Der Benutzername und der API-Schlüssel eines Integrationsbenutzers, der für ein BlackLine-Dienstkonto eingerichtet wurde

  Hinweis: Der Integrationsbenutzer benötigt API-Autorisierungsrollen und Integrationsberechtigungen sowie die Rollen und Bereiche, die für die Aufgaben erforderlich sind, die der Konnektor ausführen wird. Um den API-Schlüssel in BlackLine zu erstellen, klicken Sie auf Generieren für API-Schlüssel unter Benutzerinformationen in den Details des Integrationsbenutzers.

• Nur Blackline API Version 2.0 wird unterstützt
• Die Client-Anmeldeinformationen und OAuth-Bereiche des Integrationsbenutzers, die von Ihrem BlackLine-Integrationsteam bereitgestellt werden

  Hinweis: Wenn Sie die Client-ID, das Client-Geheimnis oder die Bereiche benötigen, wenden Sie sich an Ihren BlackLine-Ansprechpartner.

Einrichten des BlackLine OAuth2-Konnektors

Hinweis: Um den Konnektor für die Verwendung in den Ketten Ihrer Organisation verfügbar zu machen, muss ein Sicherheitsadministrator der Organisation ihn zunächst aktivieren unter Konfiguration.

1. Klicken Sie unter Chain-Generator auf Verbindungen  compare_arrows und dann auf Erstellen oben rechts.
2. Wählen Sie unter Connector Connection, BlackLine OAuth2 und den Standard-CloudRunner.
   
3. Geben Sie einen eindeutigen Namen und eine Beschreibung ein, um die Verbindung zu identifizieren.
4. Geben Sie unter Eigenschaften die Details der Verbindung ein:
   
   

   Eigenschaft	Details
   Benutzername	Geben Sie den Benutzernamen des BlackLine-Integrationsbenutzers ein.
   Kennwort	Geben Sie den API-Schlüssel ein, der für den BlackLine-Integrationsbenutzer generiert wurde. Hinweis: Um den API-Schlüssel in BlackLine zu erstellen oder zu aktualisieren, klicken Sie auf Generieren für API-Schlüssel unter Benutzerinformationen in den Details des Integrationsbenutzers. Dies ist nicht das Passwort, das für die Anmeldung bei BlackLine online verwendet wird.
   Kunden-ID	Geben Sie die Kunden-ID ein, die Sie von Ihrem BlackLine-Integrationsteam erhalten haben.
   Client secret	Geben Sie das Client ein, das Sie von Ihrem BlackLine-Integrationsteam erhalten haben.
   Geltungsbereiche	Geben Sie die OAuth-Bereiche des Integrationsbenutzers ein, die Sie von Ihrem BlackLine-Integrationsteam erhalten haben. Der Verbinder wird dieselben Bereiche verwenden.
   Hostname der Instanz	Geben Sie den Hostnamen der BlackLine-Instanz ein, mit der Sie sich verbinden möchten, ohne https://. Zum Beispiel für die Standard-Entwicklungsumgebung: sbus2.api.blackline.com.

   Hinweis: Alle sensiblen Anmeldedaten werden automatisch verschlüsselt und mit Advanced Encryption Standard (AES)-256-Verschlüsselung gespeichert.

5. Wählen Sie die Umgebungen aus, die die Verbindung verwenden sollen, und klicken Sie auf Speichern.
6. Um die Verbindung zu testen, erstellen und führen Sie mit dem Befehl „Berichte auflisten“ des BlackLine OAuth2-Konnektors eine Kette aus und prüfen Sie, ob eine gültige Ausgabe zurückgegeben wird.

Fehlersuche

Wenn die Verbindung zu BlackLine fehlschlägt:

• Überprüfen Sie die von Ihrem BlackLine-Integrationsteam bereitgestellten Client-Anmeldeinformationen und OAuth-Bereiche. Wenn Sie die OAuth-Bereiche oder die Client-ID oder das Geheimnis benötigen, wenden Sie sich an Ihren BlackLine-Vertreter.
• Stellen Sie sicher, dass der Benutzername und der API-Schlüssel des Integrationsbenutzers korrekt sind.

  Hinweis: Der API-Schlüssel des Integrationsbenutzers kann ablaufen. Um den API-Schlüssel in BlackLine zu aktualisieren, klicken Sie auf Generieren für API-Schlüssel unter Benutzerinformationen in den Details des Integrationsbenutzers.

• Vergewissern Sie sich, dass der Integrationsbenutzer über die API-Autorisierung und die richtigen Rollen und Bereiche verfügt, um die mit den Befehlen der Verbindung verbundenen Aufgaben auszuführen.
• Vergewissern Sie sich, dass der richtige Hostname der BlackLine-Instanz für den Konnektor eingegeben wurde.