Centrum wsparcia Workiva

Dzięki konektorowi BlackLine® OAuth2 możesz używać poleceń w łańcuchu do interakcji z BlackLine, np. do:

• Wyświetlaj i pobieraj raporty z BlackLine
• Importuj dane i zarządzaj nimi w BlackLine, w tym:
  • Konta
  • Salda
  • Kursy walut
  • Księgi pomocnicze
  • Podmioty
  • Zadania
  • Użytkownicy

Uwaga: To złącze jest zbudowane przez Workiva i łączy się z systemem innej firmy. Chociaż nasz zespół pomocy technicznej może pomóc w skonfigurowaniu tego łącznika w Twojej przestrzeni roboczej, nie jesteśmy w stanie rozwiązywać problemów ani w inny sposób pomagać w przypadku jakichkolwiek problemów, które powstały poza platformą Workiva.

Wymagania wstępne

Aby skonfigurować złącze, będziesz potrzebować

• Nazwa hosta instancji BlackLine, z którą chcesz się połączyć, np. sbus2.api.blackline.com
• Nazwa użytkownika i klucz API użytkownika integracji skonfigurowanego dla konta usługi BlackLine

  Uwaga: Użytkownik integracji potrzebuje ról autoryzacji API i uprawnień integracji, a także ról i zakresów wymaganych do zadań, które będzie wykonywał łącznik. Aby utworzyć klucz API w BlackLine, kliknij Generate dla API Key pod User Information na szczegółach użytkownika integracji.

• Obsługiwany jest tylko interfejs Blackline API w wersji 2.0
• Poświadczenia klienta użytkownika integracji i zakresy OAuth dostarczone przez zespół integracji BlackLine

  Uwaga: Jeśli potrzebujesz identyfikatora klienta, tajnych danych klienta lub zakresów, skontaktuj się z przedstawicielem BlackLine.

Skonfiguruj konektor BlackLine OAuth2

Uwaga: Aby udostępnić łącznik do użytku w łańcuchach organizacji, administrator bezpieczeństwa organizacji najpierw włącza go z Konfiguracja.

1. Na stronie Chain Builder kliknij Connectionscompare_arrows, a następnie Create w prawym górnym rogu.
2. W sekcji Connector Connection wybierz BlackLine OAuth2 i domyślny CloudRunner.
   
3. Wprowadź unikalną nazwę i opis, aby ułatwić identyfikację połączenia.
4. W sekcji Properties wprowadź szczegóły połączenia:
   
   

   Właściwość	Szczegóły
   Nazwa użytkownika	Wprowadź nazwę użytkownika integracji BlackLine.
   Hasło	Wprowadź klucz API wygenerowany dla użytkownika integracji BlackLine. Uwaga: Aby utworzyć lub odświeżyć klucz API w BlackLine, kliknij Generate for API Key pod User Information w szczegółach użytkownika integracji. To jest nie hasło używane do logowania się do BlackLine online.
   Identyfikator klienta	Wprowadź identyfikator klienta dostarczony przez zespół integracji BlackLine.
   Sekret klienta	Wprowadź klucz tajny klienta dostarczony przez zespół ds. integracji BlackLine.
   Zakresy	Wprowadź zakresy OAuth użytkownika integracji, dostarczone przez zespół integracji BlackLine. Złącze będzie korzystać z tych samych zakresów.
   Nazwa hosta wystąpienia	Wprowadź nazwę hosta instancji BlackLine, z którą chcesz się połączyć, bez https://. Na przykład, dla domyślnego środowiska programistycznego, sbus2.api.blackline.com.

   Uwaga: Wszystkie poufne dane uwierzytelniające są automatycznie szyfrowane i przechowywane przy użyciu szyfrowania Advanced Encryption Standard (AES) -256.

5. Wybierz środowiska, w których ma być używane połączenie i kliknij Zapisz.
6. Aby przetestować połączenie, utwórz i uruchom łańcuch z poleceniem List Reports konektora BlackLine OAuth2 i sprawdź, czy zwraca prawidłowe dane wyjściowe.

Rozwiązywanie problemów

Jeśli połączenie z BlackLine nie powiedzie się:

• Zweryfikuj poświadczenia klienta i zakresy OAuth dostarczone przez zespół integracji BlackLine. Jeśli potrzebujesz zakresów OAuth, identyfikatora klienta lub sekretu, skontaktuj się z przedstawicielem BlackLine.
• Upewnij się, że nazwa użytkownika integracji i klucz API są poprawne.

  Uwaga: Klucz API użytkownika integracji może wygasnąć. Aby odświeżyć klucz API w BlackLine, kliknij Generate dla API Key pod User Information na szczegółach użytkownika integracji.

• Sprawdź, czy użytkownik integracji ma autoryzację API oraz odpowiednie role i zakresy do wykonywania zadań związanych z poleceniami połączenia.
• Sprawdź, czy wprowadzono poprawną nazwę hosta instancji BlackLine dla łącznika.