# Marketplace (/docs/de/marketplace)



Der **Marketplace** ist ein Katalog fertiger Apps. Statt eine App von einer leeren
Leinwand aus zu bauen, wählen Sie eine Vorlage, die schon ungefähr das tut, was Sie
brauchen, installieren sie in Ihren Workspace und passen sie von dort aus an.

Sie öffnen ihn über **Marketplace** in der linken Navigation. Alle im Workspace können
darin stöbern.

## Was eine Vorlage ist [#was-eine-vorlage-ist]

Eine Vorlage ist eine **vollständige, funktionierende App**, die jemand veröffentlicht
hat: ihre Datenpipeline, ihre Visualisierung, ihre Wissensdatenbank und ihre Skills.
Viele Vorlagen bringen zusätzlich Daten mit, damit die Diagramme sofort beim ersten
Öffnen etwas anzeigen.

Jede Karte im Katalog sagt Ihnen, was Sie vor sich haben:

* Den **Namen** und eine einzeilige Beschreibung.
* **Beispieldaten** - die Vorlage bringt Beispielzeilen mit, damit die App beim ersten
  Öffnen nicht leer ist. Sie sind dazu gedacht, durch Ihre eigenen ersetzt zu werden.
* **Referenzdaten** - die Vorlage bringt eine Nachschlagetabelle mit, die sie zum
  Rechnen braucht, etwa Emissionsfaktoren oder Einheitenumrechnungen. Diese Daten
  bleiben.
* Ein **Standard**-Kennzeichen, wenn die Vorlage einem veröffentlichten
  Berichtsrahmenwerk folgt.

Klicken Sie eine Karte an, um ihre Detailseite zu öffnen. Dort erklärt die
Veröffentlichung, was die Vorlage tut, welche Daten Sie beisteuern müssen und wie das
Ergebnis zu lesen ist.

## Eine Vorlage installieren [#eine-vorlage-installieren]

Wählen Sie auf der Detailseite **Installieren**. Geben Sie der neuen App einen Namen
und eine technische ID und bestätigen Sie. Dürfen Sie in mehr als einen Bereich
installieren, wählen Sie auch den Bereich, in den die App kommt - der Dialog beginnt mit
**Workspace**, wenn Sie dorthin installieren dürfen. Ovidens erstellt eine **neue App in
Ihrem Workspace** und öffnet sie.

Diese neue App gehört vollständig Ihnen. Sie ist eine Kopie, kein Abonnement: nichts
daran wird mit anderen geteilt, und nichts, was Sie damit tun, wirkt sich auf die
Vorlage oder auf die Kopie eines anderen Workspace aus. Umbenennen, Knoten ergänzen,
SQL umschreiben, Visualisierung ändern - es ist eine gewöhnliche App, sobald sie
existiert.

Zum Installieren brauchen Sie dieselbe Berechtigung wie zum Importieren einer App; sie
gehört zu den Rollen **App-Ersteller** und **Admin** für den Bereich, in den die App
kommt - und in **Mein Bereich** darf jedes Mitglied installieren. Eine Vorlage, die Daten mitbringt, verlangt zusätzlich
die Berechtigung, Daten zu ändern, denn die Installation schreibt diese Zeilen in die
Datasets der neuen App; wer Apps installieren darf, hat sie. Fehlt Ihnen eine davon,
nennt die Schaltfläche **Vorlage verwenden** auf der Detailseite sie, bevor etwas
erstellt wird.

Ist die gewählte technische ID in Ihrem Workspace schon belegt, sagt Ovidens das und
erstellt nichts. Wählen Sie eine andere und versuchen Sie es erneut.

## Die Daten, mit denen eine installierte App kommt [#die-daten-mit-denen-eine-installierte-app-kommt]

Zwei Arten, die sich genau entgegengesetzt verhalten. Welche welche ist, ist das eine,
was Sie lesen sollten, bevor Sie eigene Zahlen erfassen.

### Beispieldaten - zum Leeren gedacht [#beispieldaten---zum-leeren-gedacht]

Beispieldaten existieren, damit die App beim ersten Öffnen etwas anzeigt und Sie die
Form des Ergebnisses sehen, bevor Sie selbst etwas beigesteuert haben. Es sind
Beispiele, nicht Ihre Daten.

Wenn Sie mit echten Zahlen arbeiten wollen, öffnen Sie die App und nutzen
**Beispieldaten entfernen**. Jedes Dataset, das die Vorlage mit Beispielen gefüllt
hat, wird in einem Schritt geleert; die Datasets behalten ihre Spalten, die Struktur
der App bleibt also unberührt und Sie können sofort eigene Zeilen hochladen oder
eintippen.

Beispieldaten entfernen und eine aktualisierte Referenztabelle übernehmen (siehe unten)
schließen die Einrichtung der App ab und stehen deshalb allen offen, die sie
konfigurieren dürfen: den Rollen **App-Ersteller** und **Admin** auf der App oder ihrem
Bereich. Wer nur Daten erfasst, sieht beides nicht.

Sie müssen nicht leeren. Sobald Sie selbst in ein Dataset schreiben - ein Upload, ein
Einfügen oder eine einzige geänderte Zelle - behandelt Ovidens dieses Dataset nicht
mehr als Beispieldaten und bietet es nicht mehr zum Entfernen an. Ihre Daten sind
nie etwas, das die App zum Wegwerfen anbietet.

### Referenzdaten - zum Behalten gedacht [#referenzdaten---zum-behalten-gedacht]

Referenzdaten sind eine Nachschlagetabelle, die die Vorlage überhaupt zum Rechnen
braucht: eine Liste von Emissionsfaktoren, eine Umrechnungstabelle, ein Satz
Kategorieschlüssel. Sie sind Teil dessen, wofür die Vorlage da ist.

**Beispieldaten entfernen** fasst sie nie an. Sie können sie bearbeiten, wenn Ihre
Organisation andere Werte verwendet, und das ändert nichts an ihrer Behandlung.

Veröffentlicht die Vorlage später eine korrigierte Fassung einer Referenztabelle,
weist die App darauf hin und bietet an, sie zu übernehmen - siehe unten. Das ist der
einzige Inhalt, der nach der Installation überhaupt noch in eine installierte App
wandern kann.

## Wenn die Vorlage später aktualisiert wird [#wenn-die-vorlage-später-aktualisiert-wird]

Weil eine installierte App eine Kopie ist, kommt eine Aktualisierung der Vorlage nie
von selbst an. Sie erhalten stattdessen einen Hinweis auf der App: **eine neuere
Version dieser Vorlage ist verfügbar**, samt der Angabe, was geändert wurde.

Danach entscheiden Sie:

* **Eine aktualisierte Referenztabelle übernehmen.** Enthält die Aktualisierung neue
  Referenzdaten für ein Dataset, das Ihre App als Referenzdaten hält, bietet die App
  an, die Zeilen dieser Tabelle durch die aktuellen zu ersetzen. Ein Dataset auf
  einmal, und nur wenn Sie es verlangen. Ihre eigenen Daten bleiben dabei unberührt.
* **Den Rest von Hand nachziehen.** Konfigurationsänderungen - ein neuer Knoten, eine
  geänderte Berechnung, eine neu gestaltete Seite - werden nicht für Sie angewendet,
  denn Ihre App hat sich seit der Installation weiterentwickelt und nur Sie wissen,
  welche Ihrer Änderungen bleiben sollen. Lesen Sie, was sich geändert hat, und
  übernehmen Sie, was Sie brauchen.
* **Nicht mehr hinweisen lassen.** Wählen Sie **Nicht mehr anzeigen**, und der Hinweis
  verschwindet für diese Version der Vorlage. Erscheint danach eine weitere, kommt der
  Hinweis zurück, denn das ist tatsächlich eine neue Information. Schließen Sie den
  Hinweis über das **X**, gilt das nur für die laufende Sitzung.

Die App zeigt außerdem, woher sie kommt, sodass auch Monate später klar bleibt, aus
welcher Vorlage sie einmal entstanden ist.

## Vorlagen veröffentlichen [#vorlagen-veröffentlichen]

Veröffentlichen ist nicht Teil eines gewöhnlichen Workspace. Der Katalog ist kuratiert:
Vorlagen werden zentral von Ovidens veröffentlicht, sodass jeder Eintrag geprüft ist
und sauber installiert, bevor ihn jemand sieht. Wenn Sie etwas gebaut haben, das Sie im
Katalog sehen möchten, melden Sie sich.

## Verwandte Seiten [#verwandte-seiten]

* [Apps](overview/apps.mdx) - was eine App ist und der Entwurf-und-Veröffentlichen-Zyklus,
  dem jede App folgt, auch eine installierte.
* [Datasets](analytical-apps/pipeline/datasets.mdx) - Daten hochladen und bearbeiten, die
  eine installierte App von Ihnen erwartet.
* [App exportieren und importieren](analytical-apps/export-import.mdx) - eine eigene App
  zwischen Workspaces verschieben; es ist dasselbe portable Format, das eine Vorlage
  nutzt.
