Mit Anaplan verbinden

Verbinden Sie PlaidCloud mit Anaplan, damit ein Workflow eine gespeicherte Ansicht über den Large-Volume-Leseweg von Anaplan lesen, eine vorhandene Exportaktion ausführen oder eine oder mehrere Anaplan-Listen in eine PlaidCloud-Dimension lesen kann. Die Verbindung erreicht die Integration API von Anaplan Cloud-direkt — für diese Schritte gibt es keinen lokalen Agent-Pfad. Dieser Leitfaden behandelt die Verbindung, die Authentifizierung, eine kurze Einführung in jeden der drei Leseschritte und Überlegungen zum Zeitplan.

Voraussetzungen

Von Ihrem Anaplan Workspace Administrator benötigen Sie:

Entweder einen Anaplan-Benutzernamen und ein Kennwort oder ein CA-Zertifikat und dessen privaten Schlüssel, die Ihr Workspace Administrator einem Anaplan-Benutzer zugeordnet hat — mit Lesezugriff auf den Workspace und die Modelle, die Ihre Workflows lesen. Siehe Authentifizierung weiter unten.
Die Workspace-ID und Modell-ID der Modelle, aus denen Sie lesen, sichtbar in den Modelleinstellungen von Anaplan. Beide lassen sich nach dem Erstellen auch live über die Verbindung ermitteln.
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 bereits vorhandene Exportaktion im Modell.
Für Anaplan: Liste lesen — die Anaplan-Listen, aus denen die Hierarchie besteht, die Sie lesen möchten.

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 Kennwort an.
Certificate meldet sich mit einem von einer CA ausgestellten Zertifikat und dessen privatem Schlüssel an, beide als PEM-Text eingefügt. Der private Schlüssel muss RSA und unverschlüsselt sein, und das Zertifikat muss dasjenige sein, das Ihr Anaplan Workspace Administrator Ihrem Anaplan-Benutzer zugeordnet 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 gegen ein Anaplan-Token ein, entsprechend dem eigenen Zertifikatsauthentifizierungsablauf von Anaplan; nach dem Einfügen von Zertifikat und Schlüssel ist nichts weiter zu tun, und die Token-Erneuerung funktioniert wie im Modus Einfach. Beide Felder maskieren, was Sie einfügen, und beide Geheimnisse werden wie ein Kennwort im Modus Einfach verschlüsselt gespeichert; beim Wechsel des Modus werden nie die Anmeldedaten des 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 und Kennwort anmelden. Die Zertifikatsauthentifizierung ist die kennwortlose Option für eine automatisierte, zeitgesteuerte Verbindung.

Der Modus Certificate lehnt 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, nennt der Fehler, ob es abgelaufen ist; übliche Ursachen sind ein Zertifikat, das keinem Anaplan-Benutzer zugeordnet ist, oder eine CA, der für Ihren Mandanten nicht vertraut wird.

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 sprechender Name, zum Beispiel `Anaplan Prod`.
API-Host	Optional. Leer lassen für das Anaplan-Standardziel `https://api.anaplan.com`.
Authentifizierungshost	Optional. Leer lassen für das Anaplan-Standardziel `https://auth.anaplan.com`.
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 als Komfortfunktion für das Feld Workspace eines Leseschritts.
Standard-Modell-ID	Optional. Eine Vorbelegung als Komfortfunktion für das Feld Model 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

Fügen Sie einen Anaplan: Ansicht lesen-Schritt hinzu, um eine gespeicherte Ansicht über den Large-Volume-Leseweg 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; ein boolesches Line Item plus eine gespeicherte Ansicht ist dort der übliche Weg zum Filtern. Eine Datenspalte landet nur dann mit ihrem deklarierten Anaplan-Typ, wenn die Ansicht Line Items auf der Spaltenachse hat; sind die Line Items in den Zeilen (ein gewöhnliches GuV-Layout) oder fehlen sie in der Ansicht, landet jede Spalte stattdessen als Text, und der Schritt weist darauf hin. Eine Ansicht, deren Filter nichts findet, landet als leere Tabelle mit einer Warnung. Ein Number-Wert, 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 klärt, welche Lesart richtig ist; ein Wert, der sich parsen lässt, landet in voller Genauigkeit, ohne Rundungsfehler. Die vollständige Feld- und Verhaltensreferenz finden Sie unter Anaplan: Ansicht lesen.

Anaplan: Export lesen

Fügen Sie einen Anaplan: Export lesen-Schritt hinzu, um eine bereits 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 eingrenzen, was sie ausgibt: Es landet genau das, was die Aktion in Anaplan zum Export konfiguriert hat. Jede Spalte landet als Text. Zahlen werden mit US-Formatierung angefordert; eine Spalte, die dennoch mit Tausendertrennzeichen zurückkommt, landet unverändert als Text, mit einer benannten Warnung, statt die Ausführung scheitern zu lassen. Der Schritt hält an, statt eine Tabelle zu laden, wenn der Export fehlschlägt, abgebrochen wird, keine Daten erzeugt, noch läuft, nachdem das Abfragebudget des Schritts aufgebraucht ist, oder eine Datei erzeugt, die sich nicht dem Export zuordnen lässt oder deren Zeilenanzahl von der abweicht, die Anaplan selbst meldet. Die vollständige Referenz finden Sie unter Anaplan: Export lesen.

Anaplan: Liste lesen

Fügen Sie einen Anaplan: Liste lesen-Schritt hinzu, um eine oder mehrere Anaplan-Listen in eine PlaidCloud-Dimension zu lesen. Ein Schritt liest eine ganze zusammengesetzte Hierarchie — nennen Sie jede Liste, die sie umfasst, beginnend mit der Wurzel (zum Beispiel Region, dann Country, dann Store), statt sie auf mehrere Schritte zu verteilen; die Staging-Tabelle wird bei jeder Ausführung ersetzt, sodass mehrere Schritte, die auf eine Staging-Tabelle zeigen, jeweils die Zeilen des vorherigen löschen würden. Jede Kante wird mit einem einfachen + aggregiert, da Anaplan-Listenhierarchien kein Gewicht und kein Vorzeichen pro Kante zum Lesen mitbringen. Die Listenzugriffssteuerung und Teilmengenmitgliedschaft von Anaplan werden nicht importiert — sie sind Metadaten, keine Dimensionsdaten. Doppelte Knoten-IDs, ein nicht auflösbarer Elternverweis, widersprüchliche Elternverweise 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.

Überlegungen zum Zeitplan

Das Anfragebudget von Anaplan wird mandantenweit gemeinsam genutzt — über jede Integration, die Ihre Organisation gegen diesen Anaplan-Mandanten betreibt, nicht nur über die von PlaidCloud — und PlaidCloud koordiniert Zeitpläne nicht über gleichzeitige Ausführungen hinweg. Mehrere Anaplan-Schritte, die in derselben Cron-Minute starten, können dieses Budget aufbrauchen, bevor einer von ihnen fertig wird. Staffeln Sie Ihre Anaplan-Workflow-Zeitpläne, statt sie alle gleichzeitig auszuführen.