Łącznik Workiva Chains udostępnia wspólne polecenia dla obszarów roboczych, środowisk i łańcuchów. Obejmuje to polecenia list i get służące do pobierania właściwości, szczegółów przebiegów łańcucha, zdarzeń aktywności logowania i nie tylko.
Aby zapoznać się z pełną listą zgodnych poleceń, zobacz artykuł Polecenia łańcuchów Workiva.
Wymagania
Przed użyciem złącza:
- Administrator zabezpieczeń organizacji musi włączyć łącznik Workiva Chains za pomocą ekranu Konfiguracje.
- Aby uruchomić łańcuch w środowisku testowym, będziesz potrzebować adresów URL, które zastąpią hosty i ścieżki bazowe interfejsu API.
- Musisz utworzyć dedykowanego użytkownika integracyjnego z przyznaniem OAuth2 w swoim oprogramowaniu.
- Aby znaleźć identyfikatory łańcucha, zapoznaj się z tym artykułem na temat znajdowania identyfikatorów w Workiva.
Dodatkowe wymagania dla użytkownika integracji
Chociaż wszyscy właściciele obszarów roboczych mogą uzyskać dostęp do łańcuchów korzystających z łącznika, sam łącznik wymaga dedykowanego użytkownika integracyjnego do wykonywania jego poleceń. Korzystając z dedykowanego użytkownika integracyjnego — zamiast konta użytkownika współpracownika — możesz śledzić aktywność łącznika i ograniczyć jego dostęp wyłącznie do elementów niezbędnych do wykonywania poleceń.
Podczas konfigurowania użytkownika integracji wymagane są następujące informacje:
- Musisz znać identyfikator autoryzacji OAuth2 i tajny klucz użytkownika integracji.
- Musisz przyznać użytkownikowi integracji odpowiednie uprawnienia dla każdego polecenia wykonywanego przez łącznik. Może on na przykład być właścicielem arkusza kalkulacyjnego lub obszaru roboczego, z którym łącznik wchodzi w interakcję.
- Użytkownik integracji musi zalogować się do Chain Builder, aby móc wykonywać jakiekolwiek polecenia. Jest to konieczne do założenia konta użytkownika.
Konfiguracja połączenia
Aby skonfigurować łącznik Workiva Chains:
- W Chain Builderkliknij Połączenia na pasku bocznym po lewej stronie, a następnie Utwórz w prawym górnym rogu.
- W obszarze Połączenie łącznikawybierz Łańcuchy Workiva i domyślny CloudRunner.
- W polu Informacje podstawowewprowadź unikalną nazwę i opis, aby ułatwić identyfikację złącza.
-
W obszarze Właściwościwprowadź szczegóły połączenia:
Właściwość Szczegóły Podstawowy adres URL Podstawowy adres URL; domyślnie jest to https://h.app.wdesk.com/s/wdata/oc/api/ Identyfikator Wprowadź identyfikator przyznany przez OAuth użytkownikom integracji. Sekret Wprowadź sekret dla właściwości ID. Nadpisanie hosta IAM Aby zastąpić adres URL hosta i ścieżkę bazową dla punktów końcowych usługi Identify and Access Management (IAM), np. w środowisku testowym, wprowadź zamiast tego używany adres URL. - Wybierz środowiska, w których chcesz używać połączenia i kliknij Zapisz.
Nadpisywanie adresów URL
W zależności od regionu środowiska produkcyjnego może obowiązywać nadrzędny adres URL.Można to zweryfikować, porównując z adresem URL używanym do logowania się do Wdesk.Jeśli adres URL zawiera .apac, .calub .eu, wymagane jest zastąpienie.
Uwaga: Informacje dotyczące regionu USA podano wyłącznie w celach informacyjnych.
| Pole | Wartość |
|---|---|
| Nadpisanie gospodarza mózgowego | https://h.app.wdesk.com/s/cerebral |
| Nadpisanie hosta arkuszy kalkulacyjnych | https://api.app.wdesk.com/spreadsheets/v1/ |
| Nadpisanie hosta IAM | https://api.app.wdesk.com/iam/v1/oauth2/token |
| Nadpisanie hosta administratora | https://api.app.wdesk.com/admin/v1 |
| Nadpisanie hosta bazy danych Graph | https://api.app.wdesk.com/graphdb/v1/ |
| Nadpisanie hosta API platformy | https://api.app.wdesk.com/platform/v1 |
| Pole | Wartość |
|---|---|
| Nadpisanie gospodarza mózgowego | https://h.apac.wdesk.com/s/cerebral |
| Nadpisanie hosta arkuszy kalkulacyjnych | https://api.apac.wdesk.com/spreadsheets/v1/ |
| Nadpisanie hosta IAM | https://api.apac.wdesk.com/iam/v1/oauth2/token |
| Nadpisanie hosta administratora | https://api.apac.wdesk.com/admin/v1 |
| Nadpisanie hosta bazy danych Graph | https://api.apac.wdesk.com/graphdb/v1/ |
| Nadpisanie hosta API platformy | https://api.apac.wdesk.com/platform/v1 |
| Pole | Wartość |
|---|---|
| Nadpisanie gospodarza mózgowego | https://h.ca.wdesk.com/s/cerebral |
| Nadpisanie hosta arkuszy kalkulacyjnych | https://api.ca.wdesk.com/spreadsheets/v1/ |
| Nadpisanie hosta IAM | https://api.ca.wdesk.com/iam/v1/oauth2/token |
| Nadpisanie hosta administratora | https://api.ca.wdesk.com/admin/v1 |
| Nadpisanie hosta bazy danych Graph | https://api.ca.wdesk.com/graphdb/v1/ |
| Nadpisanie hosta API platformy | https://api.ca.wdesk.com/platform/v1 |
| Pole | Wartość |
|---|---|
| Nadpisanie gospodarza mózgowego | https://h.eu.wdesk.com/s/cerebral |
| Nadpisanie hosta arkuszy kalkulacyjnych | https://api.eu.wdesk.com/spreadsheets/v1/ |
| Nadpisanie hosta IAM | https://api.eu.wdesk.com/iam/v1/oauth2/token |
| Nadpisanie hosta administratora | https://api.eu.wdesk.com/admin/v1 |
| Nadpisanie hosta bazy danych Graph | https://api.eu.wdesk.com/graphdb/v1/ |
| Nadpisanie hosta API platformy | https://api.eu.wdesk.com/platform/v1 |