Dokument
Das Dokument-Feature ermöglicht es deinen Flows, Dateien direkt in Business Central zu speichern, zu verwalten und in der Vorschau anzuzeigen. Dokumente werden häufig für E-Mail-Anhänge, generierte Berichte, importierte Datendateien oder andere binäre Inhalte verwendet, die ein Flow verarbeiten muss.
Typische Einsatzszenarien sind:
- Einen von einem Flow-Schritt generierten PDF-Bericht speichern.
- Eine per HTTP-Anfrage empfangene Datei an einen Business-Central-Datensatz anhängen.
- CSV- oder XML-Dateien zur Weiterverarbeitung importieren.
- HTML-Vorlagen für automatisierte E-Mails bereithalten.
Datenstruktur
Jedes Dokument speichert die folgenden Informationen:
| Feld | Typ | Beschreibung |
|---|---|---|
| ID | Integer | Eindeutiger Bezeichner, wird automatisch vergeben. |
| Name | Text | Der Dateiname inklusive Erweiterung. |
| Inhaltstyp | Text | Der MIME-Typ der Datei (z. B. application/pdf, text/html). |
| Länge | Integer | Dateigröße in Bytes, wird beim Import berechnet. |
| Daten | Media | Der eigentliche Dateiinhalt, gespeichert über den BC-Media-Typ. |
Der Media-Typ stellt eine Cloud-kompatible Speicherung sicher, die sowohl mit Business Central Online als auch mit On-Premises-Umgebungen funktioniert.
Seiten
Dokumentliste
Die Dokumentliste zeigt alle gespeicherten Dokumente mit Name, Inhaltstyp und Größe. Nutze sie zum Durchsuchen und Verwalten deiner Dokumente.
- Importieren-Aktion: Erstellt einen neuen Dokumentdatensatz und öffnet die Dateiauswahl zum Hochladen.
- Vorschau-FactBox: Auf der rechten Seite wird eine Live-Vorschau des ausgewählten Dokuments angezeigt.
Dokumentkarte
Die Dokumentkarte bietet eine Detailansicht eines einzelnen Dokuments mit einem großen Vorschaubereich.
- Importieren-Aktion: Eine Datei für dieses Dokument hochladen oder ersetzen.
- Exportieren-Aktion: Die Dokumentdatei auf den lokalen Rechner herunterladen.
Vorschau
Die Vorschau passt sich dem Inhaltstyp des Dokuments an:
| Inhaltstyp | Vorschau |
|---|---|
PDF (application/pdf) | Eingebetteter Viewer über einen iFrame. |
HTML (text/html) | Gerenderter HTML-Inhalt. |
Bilder (image/png, image/jpeg etc.) | Inline-Bildanzeige. |
Textbasiert (text/plain, application/json, application/xml etc.) | Vorformatierter Text in Monospace-Schrift. |
| Sonstige | Dateimetadaten (Name, Typ, Größe) mit dem Hinweis, dass keine Vorschau verfügbar ist. |
Die Vorschau ist sowohl auf der Dokumentkarte als auch als FactBox in der Dokumentliste verfügbar.
Dokumente in Flows verwenden
Dokumente sind dafür konzipiert, von Flow-Schritten erstellt und genutzt zu werden. Ein typisches Muster sieht so aus:
- Ein Trigger oder eine Action erzeugt Dateiinhalte (z. B. einen HTTP-Response-Body, einen generierten Bericht).
- Der Flow erstellt einen Dokumentdatensatz und importiert den Inhalt.
- Spätere Schritte können das Dokument lesen, an eine E-Mail anhängen oder exportieren.
Best Practices
- Inhaltstyp explizit setzen: Gib immer den korrekten MIME-Typ an, damit Vorschau und nachgelagerte Verarbeitung korrekt funktionieren.
- Aussagekräftige Namen verwenden: Gib die Dateierweiterung im Namen an (z. B.
rechnung-2024-001.pdf), damit Dokumente leicht zu identifizieren sind. - Nach Gebrauch aufräumen: Wenn Dokumente nur vorübergehend während der Flow-Ausführung benötigt werden, lösche sie danach, um den Speicher sauber zu halten.