> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/de/api-references/integrations/sap-leanix.md). # SAP LeanIX SAP LeanIX-Integration: Anwendungen als Assets mit Dastra synchronisieren ### Was ist SAP LeanIX? [SAP LeanIX](https://www.leanix.net/) ist eine Plattform für Enterprise Architecture Management. Unternehmen nutzen sie, um ihre Anwendungslandschaft in Form von *Fact Sheets* zu erfassen und zu verwalten. ### Was macht die Integration? Die Integration **importiert Ihre SAP LeanIX Application Fact Sheets in das Asset-Verzeichnis von Dastra und hält sie synchron**: * Jede LeanIX-Anwendung wird zu einem **Asset** in Ihrem Workspace oder aktualisiert ein bereits vorhandenes Asset. * Die Synchronisierung erfolgt **täglich** und kann jederzeit manuell ausgelöst werden. * Bestehende Assets werden aktualisiert und nicht dupliziert: Die Zuordnung erfolgt anhand der ID des LeanIX Fact Sheets und optional anhand eines von Ihnen gewählten Feldes (siehe Deduplizierung weiter unten). * Die Integration löscht niemals Assets — Anwendungen, die nicht mehr in LeanIX vorhanden sind, werden lediglich mit einem Tag gekennzeichnet. ### Voraussetzungen * Die **URL Ihrer SAP LeanIX-Instanz**, z. B. `https://ihr-unternehmen.leanix.net`. * Ein **API-Token** eines LeanIX-*Technical Users*, der von Ihrem LeanIX-Administrator erstellt wurde. Verwenden Sie die Root-URL Ihrer LeanIX-Instanz ohne Workspace-Pfad (z. B. `https://ihr-unternehmen.leanix.net` und nicht `https://ihr-unternehmen.leanix.net/MeinWorkspace`). ### Installation 1. Öffnen Sie **Einstellungen > Integrationen** und wählen Sie **SAP LeanIX** aus. 2. Klicken Sie beim Anwendungsfall für den Import von Anwendungen auf **Integration hinzufügen**. 3. Fügen Sie eine Verbindung hinzu: Geben Sie einen **Verbindungsnamen**, die **Instanz-URL** und das **API-Token** ein und klicken Sie anschließend auf **Verbinden**. Dastra validiert das Token bei Ihrer Instanz.
### Konfiguration Im Konfigurationsschritt legen Sie fest, wie Anwendungen importiert werden: * **Bei Fehlern zu benachrichtigende Benutzer (erforderlich)**: Diese Benutzer erhalten eine E-Mail, wenn eine Synchronisierung fehlschlägt. * **Dastra-Eintrag erstellen, falls nicht vorhanden**: Ist diese Option deaktiviert, werden nur bereits vorhandene Assets aktualisiert. * **Synchronisierte Elemente deduplizieren**: Eingehende Anwendungen werden anhand eines **Abgleichfelds** (Bezeichnung oder Referenz) bestehenden Assets zugeordnet und aktualisiert, anstatt Duplikate zu erzeugen. * **Feldzuordnung (Mapping)**: Legen Sie fest, welches LeanIX-Feld welches Dastra-Feld befüllt.
#### Besonderheiten des Mappings * Die Liste der Quellfelder wird direkt aus Ihrem **LeanIX-Datenmodell** übernommen. Auch Ihre benutzerdefinierten Attribute stehen zur Verfügung, einschließlich ihrer möglichen Werte für die Transkodierung (Wertemapping). * Das Standard-Mapping funktioniert ohne zusätzliche Konfiguration: * **Display name** → **Bezeichnung** * **Description** → **Beschreibung** * **Lifecycle** → **Anwendungsstatus** Dabei ist bereits eine Standard-Transkodierung hinterlegt: * **plan** / **phase-in** → *In Entwicklung* * **active** → *In Produktion* * **phase-out** / **end-of-life** → *Außer Betrieb* Diese Zuordnung kann im Bereich **Erweitert** angepasst werden. * Sie können jedes beliebige LeanIX-Feld (beispielsweise eine interne Anwendungskennung) auf das Feld **Referenz** des Assets abbilden. Dadurch wird die Kennung in Dastra durchsuchbar und kann gleichzeitig als **Abgleichfeld** für die Deduplizierung verwendet werden. ### Wie werden die Daten synchronisiert? Die Synchronisierung wird automatisch **einmal täglich** ausgeführt. Sie können sie außerdem jederzeit manuell starten, indem Sie auf der Karte des Anwendungsfalls **Synchronisierung starten** auswählen. Über **Protokolle anzeigen** können Sie die Synchronisierungsläufe nachverfolgen, einschließlich: * Anzahl der erstellten Elemente * Anzahl der aktualisierten Elemente * Anzahl der markierten Elemente * Details zu aufgetretenen Fehlern #### Gelöschte Anwendungen in SAP LeanIX Wenn ein zuvor importiertes Asset in LeanIX nicht mehr vorhanden ist, wird es von Dastra **nicht gelöscht**. Stattdessen wird das Tag **To-delete-sap-leanix** hinzugefügt, damit Sie das Asset prüfen und über das weitere Vorgehen entscheiden können. Erscheint das entsprechende Fact Sheet später erneut in LeanIX, wird dieses Tag automatisch entfernt. #### Erkannte Duplikate Wenn die Deduplizierung mehrere bestehende Assets findet, die derselben eingehenden Anwendung entsprechen könnten, werden diese Kandidaten mit dem Tag **To-merge-sap-leanix** versehen. Die Entscheidung über eine Zusammenführung erfolgt anschließend manuell. #### Deinstallation der Integration Die importierten Assets bleiben Bestandteil Ihres Workspaces. Bei einer Deinstallation der Integration werden sie **nicht entfernt** und bleiben einschließlich ihrer Tags unverändert erhalten. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://doc.dastra.eu/de/api-references/integrations/sap-leanix.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.