Przejdź do głównej zawartości
PlaidCloud

Połączenie z Anaplan

Połącz PlaidCloud z Anaplan, aby przepływ pracy mógł odczytać zapisany widok ścieżką żądań odczytu dużych wolumenów Anaplan, uruchomić istniejącą akcję eksportu lub odczytać jedną albo więcej list Anaplan do wymiaru PlaidCloud. Połączenie dociera do własnego Integration API Anaplan bezpośrednio z chmury — dla tych kroków nie ma ścieżki przez agenta lokalnego. Ten przewodnik opisuje połączenie, uwierzytelnianie, krótkie wprowadzenie do każdego z trzech kroków odczytu oraz kwestie związane z harmonogramem.

Wymagania wstępne

Dział zatytułowany „Wymagania wstępne”

Od administratora obszaru roboczego Anaplan potrzebujesz:

  • Albo nazwy użytkownika i hasła Anaplan, albo certyfikatu CA i jego klucza prywatnego zarejestrowanych dla użytkownika Anaplan przez administratora obszaru roboczego — z dostępem do odczytu do obszaru roboczego i modeli, które będą odczytywać Twoje przepływy pracy. Zobacz Uwierzytelnianie poniżej.
  • Identyfikatora obszaru roboczego i identyfikatora modelu dla modeli, z których będziesz czytać, widocznych w ustawieniach modelu w samej Anaplan. Oba można też wykryć na żywo z poziomu połączenia po jego utworzeniu.
  • Dla Anaplan: odczytaj widok — zapisanego widoku zbudowanego dokładnie z takim wycinkiem wierszy, kolumn i filtrów, jakiego chcesz. Zobacz Anaplan: odczytaj widok poniżej.
  • Dla Anaplan: odczytaj eksport — akcji eksportu, która już istnieje w modelu.
  • Dla Anaplan: odczytaj listę — list Anaplan tworzących hierarchię, którą chcesz odczytać.

Uwierzytelnianie

Dział zatytułowany „Uwierzytelnianie”

Połączenie ma Tryb uwierzytelniania: Podstawowe (domyślne) lub Certyfikat. Istniejące połączenie nadal działa bez zmian jako Podstawowe.

  • Podstawowe loguje się za pomocą nazwy użytkownika i hasła Anaplan.
  • Certyfikat loguje się za pomocą certyfikatu wydanego przez CA i jego klucza prywatnego, obu wklejonych jako tekst PEM. Klucz prywatny musi być RSA i nieszyfrowany, a certyfikat musi być tym, który administrator obszaru roboczego Anaplan zarejestrował dla Twojego użytkownika Anaplan — wydanym przez CA, któremu Anaplan ufa dla Twojego tenanta. PlaidCloud podpisuje losowe wyzwanie kluczem i wymienia je na token Anaplan, zgodnie z własnym przepływem uwierzytelniania certyfikatem Anaplan; po wklejeniu certyfikatu i klucza nie ma nic więcej do zrobienia, a odświeżanie tokenu działa tak samo jak w trybie Podstawowe. Oba pola maskują wklejaną zawartość, oba sekrety są przechowywane w postaci zaszyfrowanej, tak samo jak hasło w trybie Podstawowe, a przełączanie trybów nigdy nie wysyła danych uwierzytelniających drugiego trybu — jeśli przełączysz istniejące połączenie z Podstawowe na Certyfikat, musisz wkleić certyfikat i klucz, ponieważ nie są przenoszone.

Uwierzytelnianie wieloskładnikowe Anaplan dotyczy użytkowników logujących się adresem e-mail i hasłem. Uwierzytelnianie certyfikatem to opcja bez hasła dla zautomatyzowanego połączenia uruchamianego według harmonogramu.

Tryb Certyfikat odmawia działania przed skontaktowaniem się z Anaplan, jeśli wklejonego klucza lub certyfikatu nie można odczytać, klucz jest zaszyfrowany lub nie jest RSA, albo klucz nie pasuje do certyfikatu. Jeśli sama Anaplan odrzuci certyfikat, błąd informuje, czy wygasł; zwykłymi przyczynami są certyfikat niezarejestrowany dla użytkownika Anaplan lub CA, któremu nie ufa się dla Twojego tenanta.

Tworzenie połączenia

Dział zatytułowany „Tworzenie połączenia”

  1. Otwórz Tools > Connections i kliknij New Connection.

  2. Wybierz Anaplan z menu.

  3. Wypełnij pola:

    Pole Wartość
    Nazwa Przyjazna nazwa, na przykład Anaplan Prod.
    Host API Opcjonalny. Pozostaw puste dla standardowego adresu Anaplan https://api.anaplan.com.
    Host uwierzytelniania Opcjonalny. Pozostaw puste dla standardowego adresu Anaplan https://auth.anaplan.com.
    Tryb uwierzytelniania Podstawowe (domyślne) lub Certyfikat. Zobacz Uwierzytelnianie powyżej.
    Nazwa użytkownika Nazwa użytkownika konta Anaplan. Tylko tryb Podstawowe.
    Hasło Hasło konta Anaplan. Tylko tryb Podstawowe.
    Certyfikat CA Tekst PEM certyfikatu X.509 zarejestrowanego w Anaplan. Tylko tryb Certyfikat.
    Klucz prywatny Tekst PEM nieszyfrowanego klucza prywatnego RSA certyfikatu. Tylko tryb Certyfikat.
    Domyślny ID obszaru roboczego Opcjonalny. Wygodne wstępne wypełnienie pola Workspace w kroku odczytu.
    Domyślny ID modelu Opcjonalny. Wygodne wstępne wypełnienie pola Model w kroku odczytu.
    Limit czasu (sekundy) Domyślnie 30.

  4. Kliknij Test Connection. Pomyślny test zgłasza adres e-mail konta Anaplan, na który rozwiązują się dane uwierzytelniające.

  5. Kliknij Create.

Anaplan: odczytaj widok

Dział zatytułowany „Anaplan: odczytaj widok”

Dodaj krok Anaplan: odczytaj widok, aby odczytać zapisany widok ścieżką żądań odczytu dużych wolumenów Anaplan. Widok jest odczytywany dokładnie tak, jak został zapisany w Anaplan — w tym kroku nie ma wyboru wierszy, kolumn ani stron. Aby odczytać inny wycinek, zbuduj inny zapisany widok w Anaplan; zwykłym sposobem filtrowania jest tam pozycja wiersza typu Boolean i zapisany widok. Kolumna danych trafia z zadeklarowanym typem Anaplan tylko wtedy, gdy widok umieszcza Line Items na osi kolumn; gdy Line Items są w wierszach (zwykły układ rachunku zysków i strat) lub nie ma ich w widoku, każda kolumna trafia jako tekst, o czym informuje krok. Widok, którego filtr nic nie dopasowuje, ładuje pustą tabelę z ostrzeżeniem. Wartość typu Number, której krok nie potrafi jednoznacznie odczytać — najczęściej taka, która może być równie dobrze zwykłym ułamkiem dziesiętnym, jak zapisem w stylu europejskim — jest odrzucana zamiast zgadywana, chyba że inna wartość w tej samej kolumnie rozstrzyga, które odczytanie jest właściwe; wartość, która daje się sparsować, trafia z pełną precyzją, bez błędu zaokrąglenia. Zobacz Anaplan: odczytaj widok, aby uzyskać pełny opis pól i zachowania.

Anaplan: odczytaj eksport

Dział zatytułowany „Anaplan: odczytaj eksport”

Dodaj krok Anaplan: odczytaj eksport, aby uruchomić istniejącą akcję eksportu Anaplan i załadować plik, który wytwarza. API nie potrafi utworzyć akcji eksportu — najpierw zbuduj ją lub zmień w Anaplan — a krok nie może zawęzić tego, co emituje: ładowane jest dokładnie to, co akcja jest skonfigurowana eksportować w Anaplan. Każda kolumna trafia jako tekst. Liczby są żądane w formacie amerykańskim; kolumna, która mimo to wraca z separatorami tysięcy, trafia bez zmian, jako tekst, z nazwanym ostrzeżeniem zamiast powodować niepowodzenie uruchomienia. Krok zatrzymuje się zamiast ładować tabelę, gdy eksport się nie powiedzie, zostanie anulowany, nie wytworzy danych, nadal działa po wyczerpaniu budżetu odpytywania kroku albo wytworzy plik, którego nie da się powiązać z eksportem lub którego liczba wierszy nie zgadza się z tym, co zgłasza sama Anaplan. Zobacz Anaplan: odczytaj eksport, aby uzyskać pełny opis.

Anaplan: odczytaj listę

Dział zatytułowany „Anaplan: odczytaj listę”

Dodaj krok Anaplan: odczytaj listę, aby odczytać jedną lub więcej list Anaplan do wymiaru PlaidCloud. Jeden krok odczytuje całą hierarchię złożoną — wymień każdą listę, którą obejmuje, zaczynając od korzenia (na przykład Region, potem Country, potem Store), zamiast rozdzielać ją na kilka kroków; tabela pośrednia jest zastępowana przy każdym uruchomieniu, więc kilka kroków wskazujących jedną tabelę pośrednią wymazałoby wiersze poprzedniego. Każda krawędź agreguje się zwykłym +, ponieważ hierarchie list Anaplan nie niosą wagi ani znaku krawędzi do odczytania. Kontrola dostępu do list Anaplan i przynależność do podzbiorów nie są importowane — to metadane, a nie dane wymiaru. Zduplikowane identyfikatory węzłów, odwołanie do rodzica, którego nie można rozwiązać, sprzeczne odwołania do rodzica oraz nazwa właściwości kolidująca z importowanymi metadanymi powodują odmowę, zanim cokolwiek zostanie załadowane. Zobacz Anaplan: odczytaj listę, aby uzyskać pełny opis.

Kwestie związane z harmonogramem

Dział zatytułowany „Kwestie związane z harmonogramem”

Budżet częstotliwości żądań Anaplan jest współdzielony w całym tenancie — przez każdą integrację, którą Twoja organizacja uruchamia względem tego tenanta Anaplan, nie tylko przez PlaidCloud — a PlaidCloud nie koordynuje harmonogramów między równoczesnymi uruchomieniami. Kilka kroków Anaplan startujących w tej samej minucie crona może wyczerpać ten budżet, zanim którykolwiek z nich się zakończy. Rozłóż w czasie harmonogramy swoich przepływów pracy Anaplan, zamiast uruchamiać je wszystkie naraz.

Powiązane

Dział zatytułowany „Powiązane”