Połączenie z Anaplan
Połącz PlaidCloud z Anaplan, aby przepływ pracy mógł odczytać zapisany widok przez ścieżkę żądań odczytu dużych wolumenów Anaplan, uruchomić istniejącą akcję eksportu lub odczytać jedną albo kilka list Anaplan do wymiaru PlaidCloud. Połączenie korzysta z własnego Integration API Anaplan bezpośrednio z chmury — dla tych kroków nie istnieje ścieżka 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 przez administratora obszaru roboczego Anaplan dla użytkownika Anaplan — z dostępem do odczytu 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 odczytywać dane; widać je w ustawieniach modelu w Anaplan. Oba można też wykryć na żywo z poziomu połączenia po jego utworzeniu.
- Dla kroku Anaplan: odczytaj widok — zapisanego widoku zbudowanego dokładnie z takim wycinkiem wierszy, kolumn i filtrów, jakiego potrzebujesz. Zobacz Anaplan: odczytaj widok poniżej.
- Dla kroku Anaplan: odczytaj eksport — akcji eksportu, która już istnieje w modelu.
- Dla kroku Anaplan: odczytaj listę — list Anaplan, które tworzą hierarchię do odczytania.
Uwierzytelnianie
Dział zatytułowany „Uwierzytelnianie”Połączenie ma Tryb uwierzytelniania: Podstawowe (domyślny) lub Certificate. Istniejące połączenie nadal działa bez zmian jako Podstawowe.
- Podstawowe loguje się nazwą użytkownika i hasłem Anaplan.
- Certificate loguje się certyfikatem wydanym przez urząd CA i jego kluczem prywatnym, oba wklejone 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 — wystawionym przez urząd 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 trzeba nic więcej robić, a odświeżanie tokenu działa tak samo jak w trybie Podstawowe. Oba pola maskują wklejaną treść, a oba sekrety są przechowywane w postaci zaszyfrowanej, tak samo jak hasło w trybie Podstawowe, i przełączenie trybu nigdy nie wysyła poświadczeń drugiego trybu — jeśli zmieniasz istniejące połączenie z Podstawowe na Certificate, 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 Certificate odmawia działania przed nawiązaniem kontaktu z Anaplan, jeśli wklejonego klucza lub certyfikatu nie można odczytać, klucz jest zaszyfrowany lub nie jest typu RSA albo klucz nie pasuje do certyfikatu. Jeśli sam Anaplan odrzuci certyfikat, błąd informuje, czy certyfikat wygasł; najczęstsze przyczyny to certyfikat niezarejestrowany dla użytkownika Anaplan lub urząd CA, któremu nie ufa się dla Twojego tenanta.
Tworzenie połączenia
Dział zatytułowany „Tworzenie połączenia”-
Otwórz Tools > Connections i kliknij
New Connection. -
Wybierz Anaplan z menu.
-
Wypełnij pola:
Pole Wartość Nazwa Przyjazna nazwa, na przykład Anaplan Prod.Host API Opcjonalne. Pozostaw puste dla standardowego adresu Anaplan https://api.anaplan.com.Host uwierzytelniania Opcjonalne. Pozostaw puste dla standardowego adresu Anaplan https://auth.anaplan.com.Tryb uwierzytelniania Podstawowe (domyślnie) lub Certificate. 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 Certificate. Klucz prywatny Tekst PEM prywatnego klucza RSA certyfikatu, nieszyfrowany. Tylko tryb Certificate. Domyślny ID obszaru roboczego Opcjonalne. Ułatwienie: wstępnie wypełnia pole obszaru roboczego w kroku odczytu. Domyślny ID modelu Opcjonalne. Ułatwienie: wstępnie wypełnia pole modelu w kroku odczytu. Limit czasu (w sekundach) Domyślnie 30. -
Kliknij
Test Connection. Pomyślny test zgłasza adres e-mail konta Anaplan, do którego prowadzą poświadczenia. -
Kliknij
Create.
Anaplan: odczytaj widok
Dział zatytułowany „Anaplan: odczytaj widok”Dodaj krok Anaplan: odczytaj widok, aby odczytać zapisany widok przez ścieżkę żądań odczytu dużych wolumenów Anaplan. Widok jest odczytywany dokładnie w takiej postaci, w jakiej zapisano go w Anaplan — ten krok nie ma wyboru wierszy, kolumn ani stron. Aby odczytać inny wycinek, zbuduj inny zapisany widok w Anaplan; zwykle filtruje się tam za pomocą pozycji wierszowej typu Boolean i zapisanego widoku. Kolumna danych trafia do tabeli 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, a krok o tym informuje. Widok, którego filtr nic nie dopasowuje, tworzy pustą tabelę z ostrzeżeniem. Wartość typu Number, której krok nie potrafi odczytać jednoznacznie — najczęściej taka, która może być równie dobrze zwykłą liczbą dziesiętną lub zapisem w stylu europejskim — jest odrzucana zamiast zgadywana, chyba że inna wartość w tej samej kolumnie rozstrzyga, który odczyt jest właściwy; wartość, która zostanie odczytana, trafia z pełną precyzją, bez błędu zaokrąglenia. Pełny opis pól i zachowania znajdziesz w Anaplan: odczytaj widok.
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 wygeneruje. API nie potrafi utworzyć akcji eksportu — zbuduj ją lub zmodyfikuj najpierw w Anaplan — a krok nie może zawęzić tego, co eksportuje: ładuje się dokładnie to, co akcja eksportuje w Anaplan. Każda kolumna trafia jako tekst. Liczby są żądane w formatowaniu amerykańskim; kolumna, która mimo to wraca z separatorami tysięcy, trafia bez zmian, jako tekst, z nazwanym ostrzeżeniem zamiast niepowodzenia uruchomienia. Krok zatrzymuje się zamiast ładować tabelę, gdy eksport się nie powiedzie, zostanie anulowany, nie wygeneruje danych, nadal trwa po wyczerpaniu budżetu odpytywania kroku lub wygeneruje plik, którego nie da się powiązać z eksportem albo którego liczba wierszy różni się od tej, którą zgłasza sam Anaplan. Pełny opis znajdziesz w Anaplan: odczytaj eksport.
Anaplan: odczytaj listę
Dział zatytułowany „Anaplan: odczytaj listę”Dodaj krok Anaplan: odczytaj listę, aby odczytać jedną lub kilka list Anaplan do wymiaru PlaidCloud. Jeden krok odczytuje całą hierarchię złożoną — podaj wszystkie listy, które obejmuje, zaczynając od korzenia (na przykład Region, potem Country, potem Store), zamiast dzielić ją na kilka kroków; tabela pośrednia jest zastępowana przy każdym uruchomieniu, więc kilka kroków skierowanych na jedną tabelę pośrednią usuwałoby wiersze poprzedniego. Każda krawędź jest agregowana zwykłym +, ponieważ hierarchie list Anaplan nie mają wagi ani znaku do odczytania dla poszczególnych krawędzi. 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 zaimportowanymi metadanymi powodują odmowę, zanim cokolwiek zostanie załadowane. Pełny opis znajdziesz w Anaplan: odczytaj listę.
Anaplan jako źródło dla Data Foundation
Dział zatytułowany „Anaplan jako źródło dla Data Foundation”Data Foundation może odczytać plan przechowywany w Anaplan — budżet, prognozę lub wyniki modelu konsolidacji — do swojego Common Finance Model. Wprowadza plan, nigdy księgę, i tylko odczytuje.
Data Foundation uruchamia jedną akcję eksportu modelu w takiej postaci, w jakiej jest zapisana, więc administrator Anaplan najpierw buduje ten eksport. Karta Foundation pisze za niego prośbę. Eksport musi być płaską siatką z jednym wierszem dla każdej jednostki, okresu, konta i działu oraz dokładnie z tymi nagłówkami kolumn:
| Kolumna | Zawiera |
|---|---|
Entity |
Kod jednostki. |
Period |
Miesiąc w formacie YYYY-MM. |
Account |
Kod konta. |
Department |
Kod działu, pusty, gdy plan go nie ma. |
Currency |
Waluta kwoty. |
Amount |
Zwykła liczba bez separatora tysięcy, ze znakiem, w którym prowadzony jest plan (przychody dodatnie). |
Następnie dodaj połączenie jako źródło na karcie Foundation, tak jak każde inne (zobacz Połącz swój ERP). Nowe połączenie prosi o Nazwa użytkownika, Hasło, Workspace ID i Identyfikator modelu. Anaplan nie udostępnia listy jednostek do zaznaczenia, więc formularz prosi o jedną: wpisz jednostkę eksportu do zachowania w polu Nazwa lub pozostaw puste, aby zachować wszystkie jednostki. Następnie wypełnij System settings, które są widoczne pod tymi nazwami:
| Ustawienie | Co oznacza |
|---|---|
export |
Identyfikator akcji eksportu do uruchomienia. |
scenario |
Budget (domyślnie), Forecast lub Consolidated — dla wyników modelu konsolidacji, z którymi uzgadniany jest grupowy rachunek zysków i strat. |
version |
Etykieta nadawana każdemu wierszowi. Domyślnie Anaplan. |
Kwoty są odczytywane takie, jakie są, w znaku naturalnym. Kolumna, która wraca nadal zgrupowana separatorami tysięcy, jest oznaczana, a nie zgadywana, tak jak w Anaplan: odczytaj eksport.
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, a nie tylko przez PlaidCloud — a PlaidCloud nie koordynuje harmonogramów między równoczesnymi uruchomieniami. Kilka kroków Anaplan uruchamianych w tej samej minucie crona może wyczerpać ten budżet, zanim którykolwiek z nich się zakończy. Rozłóż w czasie harmonogramy przepływów pracy Anaplan, zamiast uruchamiać je wszystkie naraz.
Powiązane
Dział zatytułowany „Powiązane”- Anaplan: odczytaj widok — odczyt zapisanego widoku, opis pól.
- Anaplan: odczytaj eksport — uruchomienie akcji eksportu, opis pól.
- Anaplan: odczytaj listę — odczyt list do wymiaru, opis pól.
- Tworzenie połączenia i zarządzanie nim