# App exportieren und importieren (/docs/de/analytical-apps/export-import)



Eine Analyse-App laesst sich als einzelne **Bundle-Datei** herunterladen und in einen
anderen Workspace importieren. Nutzen Sie das, um eine App zwischen Workspaces zu
verschieben, einer Kollegin ein fertiges Setup zu uebergeben oder eine Offline-Kopie
einer bewaehrten Konfiguration aufzubewahren.

Das Bundle enthaelt die **Konfiguration** der App, nicht ihre Daten. Diese
Unterscheidung ist das Wichtigste, bevor Sie damit arbeiten, deshalb steht sie unten
ausdruecklich.

## Exportieren [#exportieren]

Oeffnen Sie die App und waehlen Sie **App exportieren** ("Diese App als portables
Bundle herunterladen"). Ein Dialog fragt vor dem Schreiben nach dem Dateinamen,
vorausgefuellt mit der technischen ID der App und dem heutigen Datum. Den Namen
koennen Sie aendern; die Endung `.app-bundle.json` liegt fest, sodass sich auch ein
umbenanntes Bundle importieren laesst.

Der Export nimmt immer eine **veroeffentlichte Version**. Wurde die App nie
veroeffentlicht, gibt es noch nichts zu exportieren - veroeffentlichen Sie sie zuerst.
Aenderungen in einem offenen Entwurf sind nicht enthalten; Sie erhalten den zuletzt
veroeffentlichten Stand, sodass ein Bundle immer eine in sich stimmige, vollstaendige
Konfiguration ist und nie eine halbfertige Bearbeitung.

Der Export erfordert die Rolle **App-Ersteller** oder **Admin** für die App.

## Was im Bundle mitwandert [#was-im-bundle-mitwandert]

* **Die App selbst** - Name, Beschreibung, Symbol und technische ID.
* **Die gesamte Pipeline** - jeder Knoten mit seiner vollstaendigen Konfiguration:
  Datensatzknoten mit ihren Spaltendefinitionen, SQL-Transformationen mit ihren
  Abfragen, Indikatordaten-Bruecken und Analytik-App-Importe.
* **Die Visualisierungs-Leinwand** - die Seiten und alle Widgets darauf.
* **Die Wissensdatenbank** - der Ordnerbaum und der Inhalt jeder Seite.
* **Die [Skills](./skills.mdx) der App** - Name, Beschreibung, deklarierte Eingaben,
  ob der Skill ueber MCP angeboten wird, und der vollstaendige Anweisungstext.

## Was nicht [#was-nicht]

* **Ihre Daten.** Keine Datensatzzeilen, keine hochgeladenen Dateien, keine
  Indikatorwerte. Die importierte App kommt mit fertiger Struktur und leeren Eingaben
  an, bereit dafuer, dass Sie die Daten auf der neuen Seite hochladen oder verbinden.
* **Die Historie.** Versionen, Pipeline-Laeufe und das Pruefprotokoll bleiben bei der
  urspruenglichen App. Die importierte App beginnt eine eigene, neue Historie.
* **Workspace-Spezifisches.** Mitglieder, Berechtigungen und KI-Berechtigungen gehoeren
  zum Workspace, nicht zur App.

## Importieren [#importieren]

Waehlen Sie auf der Seite **Apps** oben rechts die Import-Schaltflaeche (**App-Datei
importieren**) oder die in der Kopfzeile des Bereichs, in den die App kommen soll (oder **App
importieren** auf dem Willkommensbildschirm eines Workspace ohne Apps), und dann eine
Bundle-Datei; von oben rechts fragt Ovidens, in welchen Bereich die App kommt, wenn Sie in mehr
als einen importieren duerfen. Die App wird in diesem Bereich mit der
Konfiguration aus dem Bundle angelegt, und Sie landen direkt darin, bereit zum
Hinzufuegen der Daten.

Ein paar Dinge, die Sie erwarten sollten:

* Die App behaelt die **technische ID** aus dem Bundle. Existiert im Workspace bereits
  eine App mit dieser ID, wird der Import abgelehnt, statt irgendetwas zu ueberschreiben -
  benennen Sie die vorhandene App um oder entfernen Sie sie zuerst.
* Der Import zaehlt gegen das **App-Limit** Ihres Workspace, genau wie eine von Hand
  angelegte App.
* Eine Datei, die kein gueltiges Bundle ist, wird mit einer klaren Meldung abgelehnt,
  und es wird nichts angelegt.
* Jeder Importknoten in der Datei (Analytik-App-Daten oder Indikatordaten) muss eine App
  dieses Workspace nennen, deren Daten Sie lesen koennen, und keine in einem persoenlichen
  Bereich. Trifft das auf einen nicht zu, wird der Import abgelehnt, unter Nennung dieser
  Knoten, und es wird nichts angelegt: Entfernen Sie sie aus der Datei, oder fragen Sie
  zuerst Zugriff auf die Apps an, aus denen sie lesen. Siehe
  [wer eine App aendern kann, die aus einer anderen App importiert](./pipeline/analytic-data.mdx#wer-eine-app-ändern-kann-die-aus-einer-anderen-app-importiert).

Der Import erfordert die Rolle **App-Ersteller** oder **Admin** für den Workspace
oder für den Team-Bereich, in dem neue Apps abgelegt werden.

## Was sich nicht exportieren laesst [#was-sich-nicht-exportieren-laesst]

Die App **Audit Analytics** laesst sich nicht exportieren. Sie wird vom System verwaltet,
ihre Quellen sind fuer das Pruefarchiv des Workspace reserviert, und jeder Workspace hat
bereits eine - portabel ist daran nichts. Siehe
[Audits](../administration/audit-trail.mdx).

## Hinweis zum Wechsel zwischen Workspaces [#hinweis-zum-wechsel-zwischen-workspaces]

Da die Daten nicht mitwandern, ist das Verschieben einer App ein Zwei-Schritt-Vorgang:
Bundle importieren, um die Struktur zu erhalten, und die Daten anschliessend auf der
neuen Seite laden wie bei einer neuen App - Dateien in die Datensatzknoten hochladen
oder die Indikatordaten- und Analytik-App-Knoten auf die Apps richten, aus denen sie in
diesem Workspace lesen sollen. Diese Verbindungen verweisen **ueber die technische ID**
auf andere Apps: Liest die importierte App aus einer anderen App, muss diese hier
existieren und fuer Sie lesbar sein, bevor der Import angenommen wird: importieren Sie sie
zuerst, unter derselben technischen ID.
