Ressourcen verwalten (Dateianhänge)

Wie Sie Ressourcen anlegen, Dateien dazu hochladen, ansehen und organisieren.

Mit Ressourcen hängen Sie Dateien (Bilder, PDFs, Dokumente) als vollwertige Elemente an Ihr Modell. Sie erscheinen im Modellnavigator neben den Knoten und lassen sich in Ordnern organisieren.

Was sind Ressourcen?

Eine Ressource ist ein Modellelement, das eine Datei aufnehmen kann. Denken Sie an einen benannten Behälter für ein Dokument oder Bild innerhalb Ihres Modells.

  • Ressourcen liegen im Bereich Ressourcen des Modellnavigators
  • Jede Ressource nimmt eine Datei auf (oder keine — die Datei ist optional). In einem mehrsprachigen Modell kann eine Ressource auch je Sprache eine Datei halten, sodass ein englischer Screenshot und sein deutsches Gegenstück sich eine einzige Ressource teilen
  • Ressourcen haben Bezeichnung, Beschreibung und Tags, genau wie Knoten
  • Ressourcen lassen sich in Ordnern organisieren

Eine Ressource anlegen

  1. Suchen Sie im Modellnavigator den Bereich Ressourcen
  2. Klicken Sie auf +, um eine neue Ressource anzulegen
  3. Geben Sie ihr einen sprechenden Namen (etwa „Architekturdiagramm”, „Anforderungsspezifikation”)

Eine Datei hochladen

  1. Wählen Sie die Ressource im Modellnavigator aus
  2. Suchen Sie im Eigenschaften-Panel den Abschnitt Datei
  3. Klicken Sie auf Datei hochladen
  4. Wählen Sie eine Datei von Ihrem Rechner
  5. Die Datei wird hochgeladen und an die Ressource gehängt
  6. Die Dateiangaben (Name, Typ, Größe) erscheinen im Eigenschaften-Panel

Ansehen und herunterladen

  1. Wählen Sie eine Ressource mit angehängter Datei aus
  2. Klicken Sie im Eigenschaften-Panel auf Ressource ansehen, um die Datei zu öffnen oder herunterzuladen
  3. Die Datei öffnet sich in einem neuen Browser-Tab

Eine Datei entfernen

  1. Wählen Sie die Ressource aus
  2. Klicken Sie im Eigenschaften-Panel auf Datei entfernen
  3. Die Datei wird gelöst — das Ressourcen-Element bleibt im Modell

Ressourcen organisieren

  • Ordner: Ziehen Sie Ressourcen im Modellnavigator in Ordner, genau wie Knoten
  • Tags: Vergeben Sie Tags zur Kategorisierung und Filterung
  • Umbenennen: Ändern Sie die Bezeichnung im Eigenschaften-Panel

Ressourcen und die API

Sie können auch von außerhalb der App mit Ressourcen arbeiten — nützlich, wenn Dateien aus einem Build, einem Berichtsgenerator oder einem Skript stammen.

  • Eine Datei von Ihrem Rechner hochladen — nehmen Sie den Endpunkt Upload Asset der REST-API. Er nimmt die Datei direkt entgegen, legt die Ressource an und hängt die Datei in einem Aufruf an. Bis zu 100 MB.
  • Eine Datei ersetzen oder eine weitere Sprache ergänzen — schicken Sie sie an Attach Asset File mit der ID der Ressource. Die Ressource behält ihre ID, sodass Links darauf gültig bleiben, und ?locale=de ergänzt eine deutsche Datei neben der englischen, statt sie zu ersetzen. So hält ein Skript einen Screenshot in beiden Sprachen aktuell.
  • Eine Datei hochladen, die bereits eine URL hat — ein KI-Assistent oder MCP-Client kann create_asset und danach upload_asset_file aufrufen und Metapad dabei auf einen öffentlichen Link verweisen. Dieser Weg holt die Datei serverseitig ab und erreicht deshalb keine Datei, die nur auf Ihrem Rechner liegt.
  • Den Inhalt einer Datei lesenget_asset_content gibt ein PDF als extrahierten Text zurück, eine Text- oder CSV-Datei unverändert und ein Bild so, dass die KI es tatsächlich ansehen kann. So stellen Sie dem Assistenten eine Frage zu einem Anforderungsdokument, das Sie angehängt haben.
  • Ressourcen finden — nehmen Sie list_assets. Ressourcen werden getrennt von den Knoten geführt, eine normale Knotensuche liefert sie also nicht.

Wie Sie an ein Token kommen, steht in API-Tokens und externer Zugriff; die Details finden Sie in der MCP-API-Referenz und der REST-API-Referenz.

Tipps

  • Ressourcen sind Modellelemente — sie bleiben im Modell erhalten und sind in Exporten enthalten
  • Vergeben Sie sprechende Namen, damit Teammitglieder Ressourcen leicht finden
  • Fassen Sie zusammengehörende Ressourcen in Ordnern zusammen (etwa „Design-Dokumente”, „Screenshots”)
  • Andere Mitarbeitende sehen Ressourcen in Echtzeit

Dieser Inhalt wurde kollaborativ mit KI erstellt.