Centrum wsparcia Workiva

Dzięki konektorowi NetSuite® Token Authentication możesz używać poleceń w łańcuchu do interakcji z NetSuite. Na przykład, za pomocą tego złącza możesz:

• Pobierz pliki z NetSuite
• Wyświetl listę zapisanych wyszukiwań w NetSuite
• Pobierz dane dotyczące standardowego rekordu NetSuite lub zapisanego wyszukiwania

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 umożliwić połączenie, konektor korzysta z interfejsu API REST NetSuite. Aby skonfigurować złącze, będziesz potrzebować

• NetSuite, z włączonym uwierzytelnianiem opartym na tokenach (TBA)
• Identyfikator konta NetSuite, z którym chcesz się połączyć

  Uwaga: Aby wyświetlić identyfikator konta w NetSuite, wybierz Konfiguracja, Integracje, Preferencje usług sieci Web. Identyfikator pojawia się również zazwyczaj w pierwszym ciągu adresu URL, tuż przed app.netsuite.com.

• Rekord integracji i token dostępu utworzony w NetSuite dla łącznika
• Klucz i klucz tajny konsumenta rekordu integracji

  Uwaga: Jeśli nie masz klucza tajnego lub klucza konsumenta, edytuj rekord integracji i zresetuj jego poświadczenia.

• Identyfikator i klucz tajny tokena dostępu. Jeśli nie masz identyfikatora lub hasła tokena dostępu, musisz utworzyć nowy token.

Uwaga: Aby wejść w interakcję z NetSuite RESTlet przy użyciu uwierzytelniania OAuth 2.0, użyj zamiast tego konektora HTTP Request.

Włącz integrację w NetSuite

Aby umożliwić konektorowi interakcję z NetSuite, wymaga on uwierzytelniania opartego na tokenach (TBA) i własnego rekordu integracji.

Krok 1. Włącz usługi internetowe SOAP i uwierzytelnianie oparte na tokenach

Aby włączyć usługi internetowe SOAP i TBA dla NetSuite:

1. W NetSuite wybierz Konfiguracja, Firma, Włącz funkcje.
2. Na karcie SuiteCloud w sekcji SuiteScript wybierz Client SuiteScript i Server SuiteScript.
   
3. Pod SuiteTalk (Web Services), wybierz SOAP web services.
   
4. W sekcji Zarządzaj uwierzytelnianiem wybierz Uwierzytelnianie oparte na tokenach.
5. Kliknij Zapisz.

Krok 2. Utwórz rekord integracji

Po włączeniu TBA utwórz rekord integracji dla łącznika:

1. W NetSuite wybierz Konfiguracja, Integracje, Zarządzaj integracjami, Nowa.
2. Aby ułatwić identyfikację integracji, wprowadź unikalną nazwę i opis, na przykład Workiva Integration.
   
3. W sekcji Uwierzytelnianie wybierz Uwierzytelnianie oparte na tokenach i wyczyść TBA: Przepływ autoryzacji.
4. Kliknij Save, a następnie zapisz klucz użytkownika i klucz tajny na stronie potwierdzenia.

Uwaga: Klucz i klucz tajny konsumenta pojawiają się tylko na stronie potwierdzenia rekordu integracji. Pamiętaj, aby zapisać te wartości we właściwościach konektora i traktować je jak hasło.

Krok 3. Utwórz rolę integracji

Ze względów bezpieczeństwa utwórz dedykowaną rolę w NetSuite do zarządzania integracjami:

1. Wybierz Setup, Users/Roles, Manage roles, New.
   
2. W sekcji General wprowadź unikalną nazwę, która pomoże zidentyfikować rolę, np. Workiva/NetSuite Integration.
3. W sekcji Authentication wybierz Web services only role , aby umożliwić roli łączenie się wyłącznie z interfejsem API NetSuite, a nie logowanie się bezpośrednio do NetSuite.
4. W sekcji Uprawnienia, dodaj uprawnienia, aby włączyć integrację, takie jak uprawnienia pełnego poziomu do wszystkich odpowiednich Transakcji, Raportów i List w NetSuite.
5. Na karcie Konfiguracja w sekcji Uprawnienia dodaj uprawnienia pełnego poziomu dla:
   
   • Usługi internetowe SOAP
   • Załóż firmę
   • Uwierzytelnianie oparte na tokenach:
     • Aby włączyć uwierzytelnianie roli tylko za pomocą tokenów dostępu, Zaloguj się przy użyciu tokenów dostępu
     • Aby umożliwić roli tworzenie i odwoływanie własnych tokenów dostępu, Tokeny dostępu użytkownika
       
     
6. Kliknij Zapisz.

Krok 4. Przypisz rolę do użytkownika integracji

Po utworzeniu roli integracji przypisz ją do użytkownika integracji łącznika:

1. W NetSuite wybierz Konfiguracja, Użytkownicy/Role, Zarządzaj użytkownikami.
2. Wybierz lub utwórz użytkownika integracji dla łącznika.
   

   Uwaga: Zalecamy utworzenie oddzielnego użytkownika dla każdego złącza lub integracji.

3. W sekcji Roles przypisz rolę integracji do użytkownika.

Krok 5. Utwórz token dostępu użytkownika integracji

Aby utworzyć token dostępu dla użytkownika integracji:

1. W NetSuite wybierz Konfiguracja, Użytkownicy/Role, Tokeny dostępu, Nowy.
2. Kliknij Nowy token dostępu.
   
3. W sekcji Nazwa aplikacji wybierz rekord integracji.
4. Na stronie User wybierz użytkownika integracji.
5. W sekcji Role wybierz rolę integracji.
6. Kliknij Zapisz.
7. Zwróć uwagę na identyfikator i sekret utworzony dla tokena; będziesz ich potrzebować we właściwościach konektora.

   Uwaga: Ze względów bezpieczeństwa identyfikator i klucz tajny pojawiają się tylko podczas tworzenia tokena dostępu. Traktuj je jak hasło. Jeśli nie masz identyfikatora tokena lub tajnego dla właściwości konektora, utwórz nowy token dla użytkownika integracji.

Skonfiguruj konektor NetSuite Token Authentication

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 NetSuite Token Authentication 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
   Identyfikator konta	Wprowadź identyfikator konta NetSuite, z którym chcesz się połączyć.
   Klucz konsumenta	Wprowadź klucz konsumenta dla rekordu integracji łącznika.
   Tajemnica konsumencka	Wprowadź klucz tajny dla właściwości Consumer Key.
   Identyfikator tokenu	Wprowadź identyfikator tokena dostępu łącznika.
   Tajny token	Wprowadź sekret dla właściwości Token ID.
   Piaskownica	Aby połączyć się z kontem NetSuite w piaskownicy, zaznacz to pole.

   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 Saved Searches konektora i sprawdź, czy zwraca prawidłowe dane wyjściowe.

Rozwiązywanie problemów

Pola niestandardowe

Pamiętaj, że interfejs API NetSuite nie może zwracać pól niestandardowych. Alternatywnie, Data Prep może tworzyć transformacje, które naśladują logikę pola niestandardowego Netsuite.

Połączenia

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

• Sprawdź identyfikator konta wprowadzony dla złącza. Aby wyświetlić identyfikator konta w NetSuite, wybierz Setup, Integrations, Web Services Preferences. Identyfikator pojawia się również zazwyczaj tuż przed app.netsuite.com w adresie URL.
• Zweryfikuj klucz konsumenta i klucz tajny rekordu integracji łącznika. W razie potrzeby edytuj rekord integracji i zresetuj jego poświadczenia, aby utworzyć nowy klucz klienta i klucz tajny.
• Zweryfikuj identyfikator i klucz tajny tokena dostępu łącznika. W razie potrzeby utwórz nowy token dla łącznika.