Konektor Workiva Chains zapewnia wspólne polecenia dla obszarów roboczych, środowisk i łańcuchów. Obejmuje to polecenia list i get używane do pobierania właściwości, szczegółów przebiegu łańcucha, zdarzeń aktywności logowania i innych.
Pełną listę kompatybilnych poleceń znajdziesz w artykule Workiva Chains commands.
Wymagania
Przed użyciem złącza:
- Administrator bezpieczeństwa organizacji musi włączyć łącznik Workiva Chains na ekranie Konfiguracje.
- Aby uruchomić łańcuch w środowisku testowym, będziesz potrzebować adresów URL, aby zastąpić hosty API i ścieżki bazowe.
- Musisz utworzyć dedykowanego użytkownika integracji z grantem OAuth2 w swoim oprogramowaniu.
- Aby znaleźć identyfikatory łańcucha, zapoznaj się z tym artykułem na stronie , aby znaleźć identyfikatory w Workiva.
Dodatkowe wymagania dla użytkownika integracji
Podczas gdy wszyscy właściciele obszarów roboczych mogą uzyskać dostęp do łańcuchów korzystających z konektora, sam konektor wymaga dedykowanego użytkownika integracji do wykonywania jego poleceń. Korzystanie z dedykowanego użytkownika integracji - zamiast konta użytkownika współpracownika - umożliwia śledzenie aktywności konektora i ograniczenie jego dostępu tylko do tego, co jest potrzebne do wykonywania poleceń.
Podczas konfigurowania użytkownika integracji wymagane są następujące informacje:
- Musisz znać identyfikator grantu i sekret OAuth2 użytkownika integracji.
- Musisz zapewnić użytkownikowi integracji odpowiednie uprawnienia dla każdego polecenia, które konektor będzie wykonywał; na przykład może on być właścicielem arkusza kalkulacyjnego lub obszaru roboczego, z którym konektor wchodzi w interakcję.
- Użytkownik integracji musi zalogować się do Chain Builder przed wykonaniem jakichkolwiek poleceń. Jest to konieczne do założenia konta użytkownika.
Konfiguracja połączenia
Aby skonfigurować złącze Workiva Chains:
- Na stronie Chain Builder kliknij Connections, a następnie Create w prawym górnym rogu.
- W sekcji Connector Connection wybierz Workiva Chains i domyślny CloudRunner.
- W sekcji Basic Info wprowadź unikalną nazwę i opis, które pomogą zidentyfikować złącze.
- W sekcji Properties wprowadź szczegóły połączenia:
Właściwość Szczegóły Podstawowy adres URL Bazowy adres URL; domyślnie https://h.app.wdesk.com/s/wdata/oc/api/ Identyfikator Wprowadź identyfikator dotacji OAuth dla użytkowników integracji. Sekret Wprowadź sekret dla właściwości ID. Zastąpienie hosta IAM Aby zastąpić host URL i ścieżkę podstawową dla punktów końcowych Identify and Access Management (IAM), np. dla środowiska testowego, wprowadź adres URL, którego chcesz użyć. - Wybierz środowiska, w których ma być używane połączenie i kliknij Zapisz.
Zastępowanie adresów URL
W zależności od regionu twojego środowiska produkcyjnego może obowiązywać nadpisany adres URL. Możesz to zweryfikować, porównując z adresem URL używanym do logowania się do Wdesk. Jeśli adres URL zawiera EU lub APAC, wymagane jest zastąpienie.
Uwaga: Informacje o regionie US są podane w celach informacyjnych.
| Pole | Wartość |
|---|---|
| Nadpisanie hosta mózgowego | https://h.app.wdesk.com/s/cerebral |
| Zastąpienie hosta arkuszy kalkulacyjnych | https://api.app.wdesk.com/spreadsheets/v1/ |
| Zastąpienie hosta IAM | https://api.app.wdesk.com/iam/v1/oauth2/token |
| Zastąpienie hosta przez administratora | https://api.app.wdesk.com/admin/v1 |
| Zastąpienie hosta Graph DB | https://api.app.wdesk.com/graphdb/v1/ |
| Zastąpienie hosta API platformy | https://api.app.wdesk.com/platform/v1 |
| Pole | Wartość |
|---|---|
| Nadpisanie hosta mózgowego | https://h.eu.wdesk.com/s/cerebral |
| Zastąpienie hosta arkuszy kalkulacyjnych | https://api.eu.wdesk.com/spreadsheets/v1/ |
| Zastąpienie hosta IAM | https://api.eu.wdesk.com/iam/v1/oauth2/token |
| Zastąpienie hosta przez administratora | https://api.eu.wdesk.com/admin/v1 |
| Zastąpienie hosta Graph DB | https://api.eu.wdesk.com/graphdb/v1/ |
| Zastąpienie hosta API platformy | https://api.eu.wdesk.com/platform/v1 |
| Pole | Wartość |
|---|---|
| Nadpisanie hosta mózgowego | https://h.apac.wdesk.com/s/cerebral |
| Zastąpienie hosta arkuszy kalkulacyjnych | https://api.apac.wdesk.com/spreadsheets/v1/ |
| Zastąpienie hosta IAM | https://api.apac.wdesk.com/iam/v1/oauth2/token |
| Zastąpienie hosta przez administratora | https://api.apac.wdesk.com/admin/v1 |
| Zastąpienie hosta Graph DB | https://api.apac.wdesk.com/graphdb/v1/ |
| Zastąpienie hosta API platformy | https://api.apac.wdesk.com/platform/v1 |