Mit Anaplan verbinden
Verbinden Sie PlaidCloud mit Anaplan, damit ein Workflow eine gespeicherte Ansicht über den Large-Volume-Leseanforderungspfad von Anaplan lesen, eine vorhandene Exportaktion ausführen oder eine oder mehrere Anaplan-Listen in eine PlaidCloud-Dimension einlesen kann. Die Verbindung erreicht die Integration API von Anaplan cloud-direkt – für diese Schritte gibt es keinen Pfad über einen lokalen Agent. Diese Anleitung behandelt die Verbindung, die Authentifizierung, eine kurze Einführung in jeden der drei Leseschritte und Hinweise zur Zeitplanung.
Voraussetzungen
Abschnitt betitelt „Voraussetzungen“Von Ihrem Anaplan-Workspace-Administrator benötigen Sie:
- Entweder einen Anaplan-Benutzernamen und ein Kennwort oder ein CA-Zertifikat samt privatem Schlüssel, das Ihr Workspace-Administrator einem Anaplan-Benutzer zugewiesen hat – mit Lesezugriff auf den Workspace und die Modelle, die Ihre Workflows lesen. Siehe Authentifizierung weiter unten.
- Die Workspace-ID und die Modell-ID der Modelle, aus denen Sie lesen. Beide finden Sie in den Modelleinstellungen von Anaplan. Sie lassen sich auch live über die Verbindung ermitteln, sobald diese erstellt ist.
- Für Anaplan: Ansicht lesen – eine gespeicherte Ansicht, die genau den gewünschten Ausschnitt aus Zeilen, Spalten und Filtern enthält. Siehe Anaplan: Ansicht lesen weiter unten.
- Für Anaplan: Export lesen – eine Exportaktion, die im Modell bereits vorhanden ist.
- Für Anaplan: Liste lesen – die Anaplan-Listen, aus denen die zu lesende Hierarchie besteht.
Authentifizierung
Abschnitt betitelt „Authentifizierung“Die Verbindung hat einen Authentifizierungsmodus: Einfach (Standard) oder Certificate. Eine bestehende Verbindung funktioniert unverändert als Einfach weiter.
- Einfach meldet sich mit einem Anaplan-Benutzernamen und einem Kennwort an.
- Certificate meldet sich mit einem von einer CA ausgestellten Zertifikat und dessen privatem Schlüssel an, die beide als PEM-Text eingefügt werden. Der private Schlüssel muss RSA und unverschlüsselt sein, und das Zertifikat muss dasjenige sein, das Ihr Anaplan-Workspace-Administrator Ihrem Anaplan-Benutzer zugewiesen hat – ausgestellt von einer CA, der Anaplan für Ihren Mandanten vertraut. PlaidCloud signiert eine zufällige Challenge mit dem Schlüssel und tauscht sie gemäß dem eigenen Zertifikatsauthentifizierungsablauf von Anaplan gegen ein Anaplan-Token ein; nachdem Zertifikat und Schlüssel eingefügt sind, ist nichts weiter zu tun, und die Token-Erneuerung funktioniert wie im Modus Einfach. Beide Felder maskieren die eingefügten Inhalte, beide Geheimnisse werden wie ein Kennwort im Modus Einfach verschlüsselt gespeichert, und beim Wechseln des Modus werden nie die Anmeldedaten des jeweils anderen Modus gesendet – wenn Sie eine bestehende Verbindung von Einfach auf Certificate umstellen, müssen Sie Zertifikat und Schlüssel einfügen, da sie nicht übernommen werden.
Die Multi-Faktor-Authentifizierung von Anaplan gilt für Benutzer, die sich mit E-Mail-Adresse und Kennwort anmelden. Die Zertifikatsauthentifizierung ist die kennwortlose Option für eine automatisierte, zeitgesteuerte Verbindung.
Der Modus Certificate bricht ab, bevor Anaplan kontaktiert wird, wenn der eingefügte Schlüssel oder das Zertifikat nicht gelesen werden kann, der Schlüssel verschlüsselt oder nicht RSA ist oder der Schlüssel nicht zum Zertifikat passt. Lehnt Anaplan selbst das Zertifikat ab, gibt die Fehlermeldung an, ob es abgelaufen ist; die üblichen Ursachen sind ein Zertifikat, das keinem Anaplan-Benutzer zugewiesen ist, oder eine CA, der für Ihren Mandanten nicht vertraut wird.
Verbindung erstellen
Abschnitt betitelt „Verbindung erstellen“-
Öffnen Sie Tools > Connections und klicken Sie auf
New Connection. -
Wählen Sie im Menü Anaplan aus.
-
Füllen Sie die Felder aus:
Feld Wert Name Ein aussagekräftiger Name, zum Beispiel Anaplan Prod.API-Host Optional. Leer lassen für den Standardwert https://api.anaplan.comvon Anaplan.Authentifizierungshost Optional. Leer lassen für den Standardwert https://auth.anaplan.comvon Anaplan.Authentifizierungsmodus Einfach (Standard) oder Certificate. Siehe Authentifizierung oben. Benutzername Der Benutzername des Anaplan-Kontos. Nur im Modus Einfach. Kennwort Das Kennwort des Anaplan-Kontos. Nur im Modus Einfach. CA-Zertifikat PEM-Text des in Anaplan registrierten X.509-Zertifikats. Nur im Modus Certificate. Privater Schlüssel PEM-Text des privaten RSA-Schlüssels des Zertifikats, unverschlüsselt. Nur im Modus Certificate. Standard-Arbeitsbereichs-ID Optional. Eine Vorbelegung für das Feld „Workspace“ eines Leseschritts. Standard-Modell-ID Optional. Eine Vorbelegung für das Feld „Modell“ eines Leseschritts. Timeout (Sekunden) Standardmäßig 30. -
Klicken Sie auf
Test Connection. Ein erfolgreicher Test meldet die E-Mail-Adresse des Anaplan-Kontos, zu dem die Anmeldedaten gehören. -
Klicken Sie auf
Create.
Anaplan: Ansicht lesen
Abschnitt betitelt „Anaplan: Ansicht lesen“Fügen Sie einen Schritt Anaplan: Ansicht lesen hinzu, um eine gespeicherte Ansicht über den Large-Volume-Leseanforderungspfad von Anaplan zu lesen. Die Ansicht wird genau so gelesen, wie sie in Anaplan gespeichert wurde – in diesem Schritt gibt es keine Auswahl von Zeilen, Spalten oder Seiten. Um einen anderen Ausschnitt zu lesen, erstellen Sie in Anaplan eine andere gespeicherte Ansicht; üblicherweise filtert man dort mit einem booleschen Line Item und einer gespeicherten Ansicht. Eine Datenspalte wird nur dann mit ihrem in Anaplan deklarierten Typ geladen, wenn die Ansicht die Line Items auf der Spaltenachse hat; liegen die Line Items auf den Zeilen (ein gewöhnliches GuV-Layout) oder fehlen sie in der Ansicht, werden stattdessen alle Spalten als Text geladen, und der Schritt weist darauf hin. Eine Ansicht, deren Filter nichts findet, lädt eine leere Tabelle mit einer Warnung. Ein Zahlenwert, den der Schritt nicht eindeutig lesen kann – meist einer, der ebenso gut eine einfache Dezimalzahl oder eine europäische Schreibweise sein könnte –, wird abgelehnt statt geraten, es sei denn, ein anderer Wert in derselben Spalte entscheidet, welche Lesart richtig ist; ein Wert, der sich lesen lässt, wird in voller Genauigkeit und ohne Rundungsfehler geladen. Die vollständige Referenz zu Feldern und Verhalten finden Sie unter Anaplan: Ansicht lesen.
Anaplan: Export lesen
Abschnitt betitelt „Anaplan: Export lesen“Fügen Sie einen Schritt Anaplan: Export lesen hinzu, um eine vorhandene Anaplan-Exportaktion auszuführen und die erzeugte Datei zu laden. Die API kann keine Exportaktion erstellen – erstellen oder bearbeiten Sie sie zuerst in Anaplan –, und der Schritt kann nicht einschränken, was ausgegeben wird: Geladen wird genau das, was die Aktion in Anaplan zum Export vorsieht. Jede Spalte wird als Text geladen. Zahlen werden mit US-Formatierung angefordert; eine Spalte, die dennoch mit Tausendertrennzeichen zurückkommt, wird unverändert als Text geladen, mit einer benannten Warnung statt eines Fehlers bei der Ausführung. Der Schritt bricht ab, statt eine Tabelle zu laden, wenn der Export fehlschlägt, abgebrochen wird, keine Daten liefert, nach Ablauf des Abfragebudgets des Schritts noch läuft oder eine Datei erzeugt, die sich nicht dem Export zuordnen lässt oder deren Zeilenanzahl nicht mit den Angaben von Anaplan übereinstimmt. Die vollständige Referenz finden Sie unter Anaplan: Export lesen.
Anaplan: Liste lesen
Abschnitt betitelt „Anaplan: Liste lesen“Fügen Sie einen Schritt Anaplan: Liste lesen hinzu, um eine oder mehrere Anaplan-Listen in eine PlaidCloud-Dimension einzulesen. Ein Schritt liest eine ganze zusammengesetzte Hierarchie – nennen Sie alle Listen, über die sie sich erstreckt, beginnend mit der Wurzel (zum Beispiel Region, dann Land, dann Filiale), statt sie auf mehrere Schritte zu verteilen; die Staging-Tabelle wird bei jeder Ausführung ersetzt, sodass mehrere Schritte, die auf dieselbe Staging-Tabelle zeigen, jeweils die Zeilen des vorherigen löschen würden. Jede Kante wird mit einem einfachen + aufsummiert, da Anaplan-Listenhierarchien kein Gewicht und kein Vorzeichen pro Kante enthalten. Die Zugriffssteuerung und die Teilmengenzugehörigkeit von Anaplan-Listen werden nicht importiert – es sind Metadaten, keine Dimensionsdaten. Doppelte Knoten-IDs, ein nicht auflösbarer Parent-Verweis, widersprüchliche Parent-Verweise und ein Eigenschaftsname, der mit importierten Metadaten kollidiert, werden alle abgelehnt, bevor etwas geladen wird. Die vollständige Referenz finden Sie unter Anaplan: Liste lesen.
Anaplan als Quelle für Data Foundation
Abschnitt betitelt „Anaplan als Quelle für Data Foundation“Data Foundation kann den in Anaplan gehaltenen Plan – ein Budget, einen Forecast oder die Ergebnisse eines Konsolidierungsmodells – in sein Common Finance Model einlesen. Es holt den Plan herein, nie das Hauptbuch, und liest ausschließlich.
Data Foundation führt eine Exportaktion des Modells so aus, wie sie gespeichert ist; Ihr Anaplan-Administrator erstellt diesen Export daher zuerst. Die Registerkarte Foundation verfasst die Anfrage für ihn. Der Export muss ein flaches Raster mit einer Zeile je Entität, Periode, Konto und Abteilung sein und genau diese Spaltenüberschriften haben:
| Spalte | Enthält |
|---|---|
Entity |
Den Entitätscode. |
Period |
Den Monat im Format YYYY-MM. |
Account |
Den Kontocode. |
Department |
Den Abteilungscode, leer, wenn der Plan keine hat. |
Currency |
Die Währung des Betrags. |
Amount |
Eine einfache Zahl ohne Tausendertrennzeichen, mit dem Vorzeichen, in dem der Plan geführt wird (Erlöse positiv). |
Fügen Sie die Verbindung dann wie jede andere auf der Registerkarte Foundation als Quelle hinzu (siehe ERP verbinden). Eine neue Verbindung fragt nach Benutzername, Kennwort, Workspace-ID und Modell-ID. Anaplan listet keine Entitäten zum Ankreuzen auf, daher fragt das Formular nach einer: Geben Sie unter Name die Entität des Exports ein, die behalten werden soll, oder lassen Sie das Feld leer, um alle Entitäten zu behalten. Füllen Sie dann die Systemeinstellungen aus, die unter diesen Namen angezeigt werden:
| Einstellung | Bedeutung |
|---|---|
export |
Die ID der auszuführenden Exportaktion. |
scenario |
Budget (Standard), Forecast oder Consolidated für die Ergebnisse eines Konsolidierungsmodells, mit denen die Konzern-Gewinn- und Verlustrechnung abgestimmt wird. |
version |
Eine Bezeichnung, die jeder Zeile aufgestempelt wird. Standardmäßig Anaplan. |
Beträge werden unverändert im natürlichen Vorzeichen gelesen. Eine Spalte, die weiterhin mit Tausendertrennzeichen gruppiert zurückkommt, wird gekennzeichnet statt geraten, wie bei Anaplan: Export lesen.
Hinweise zur Zeitplanung
Abschnitt betitelt „Hinweise zur Zeitplanung“Das Anfragenbudget von Anaplan wird mandantenweit geteilt – über alle Integrationen Ihrer Organisation mit diesem Anaplan-Mandanten, nicht nur über PlaidCloud –, und PlaidCloud koordiniert Zeitpläne nicht über gleichzeitige Ausführungen hinweg. Laufen mehrere Anaplan-Schritte in derselben Cron-Minute, kann dieses Budget aufgebraucht sein, bevor einer von ihnen fertig ist. Staffeln Sie die Zeitpläne Ihrer Anaplan-Workflows, statt sie alle gleichzeitig auszuführen.
Verwandte Themen
Abschnitt betitelt „Verwandte Themen“- Anaplan: Ansicht lesen – eine gespeicherte Ansicht lesen, Feldreferenz.
- Anaplan: Export lesen – eine Exportaktion ausführen, Feldreferenz.
- Anaplan: Liste lesen – Listen in eine Dimension einlesen, Feldreferenz.
- Verbindung erstellen und verwalten