File Exporter PCF fuer Power Apps Canvas Apps

Diese Anleitung zeigt einen praktischen Weg fuer Power Apps file export PCF Szenarien in Microsoft Power Platform. Die Komponente nimmt ein JSON Payload mit einem oder mehreren Dokumenten entgegen und laedt die Dateien entweder direkt im Browser herunter oder stellt eine strukturierte Ausgabe bereit, die an Power Automate, SharePoint oder ein anderes Zielsystem uebergeben werden kann.

Der praktische Vorteil ist einfach: Maker bleiben in Canvas Apps, definieren Dateien ueber JSON und entscheiden dann, ob der Export sofort im Browser oder spaeter ueber Automatisierung erfolgt.

Was diese Komponente ist

Dies ist eine PCF Komponente fuer Power Apps Canvas Apps, die textbasierte Dateien aus documentsJson vorbereitet. Sie validiert jeden Eintrag, berechnet Metadaten, erzeugt pro Datei eine base64 Ausgabe und unterstuetzt drei Modi:

• Disabled, nur Ausgabe, kein Browser Download
• Zip, ein Archiv Download
• Separate, ein Browser Download pro gueltiger Datei

Fuer wen das gedacht ist

• Power Platform Maker mit Export Funktionen in Canvas Apps
• Teams, die ein wiederverwendbares Datei Export Muster ohne eigenes Browser Skript brauchen
• Projekte, die generierte Dateien an Power Automate oder SharePoint uebergeben wollen

Get it

• Repository: Just-Boring-Cat/file-exporter-pcf

Kompatibilitaet

• Microsoft Power Platform
• Power Apps Canvas Apps
• Power Automate oder SharePoint Flows, wenn der Browser Download nicht das Endziel ist
• Textbasierte Exportformate wie CSV, TXT, JSON, XML, HTML, Markdown oder SQL

Warum das wichtig ist

Datei Export ist in Business Apps haeufig noetig, aber die Umsetzung verteilt sich oft auf mehrere Stellen. Ein Screen erzeugt CSV, ein anderer startet einen Flow, ein dritter versucht mehrere Dateien mit fragiler Logik herunterzuladen.

Diese Komponente bringt einen klareren Vertrag:

• Ein JSON Input fuer alle Dokumentdefinitionen
• Eine PCF Komponente fuer Validierung und Ausgabe
• Ein Output JSON fuer Power Fx oder einen Flow

Das ist besonders hilfreich, wenn du ein wiederholbares Export Muster ueber mehrere Apps hinweg brauchst.

Typische Einsatzfaelle

• CSV oder TXT Dateien direkt aus einer Canvas App exportieren
• JSON Payloads erzeugen und ueber Power Automate in SharePoint speichern
• Einen ZIP Download statt vieler einzelner Browser Downloads anbieten
• Download im UI deaktivieren, die Dateien aber trotzdem fuer externe Systeme vorbereiten

So funktioniert die Komponente

Der Ablauf ist bewusst einfach:

1. Ein JSON Array an documentsJson uebergeben.
2. Jedes Objekt definiert eine Datei mit fileName, fileExtension, mimeType und contentText.
3. Die Komponente validiert jede Datei und stellt das Ergebnis ueber documentsOutputJson bereit.
4. Danach entscheidest du, ob die Dateien:
   • nur in den App Outputs bleiben,
   • als ZIP heruntergeladen werden,
   • oder einzeln im Browser heruntergeladen werden sollen.

Minimales JSON Beispiel

[
  {
    "id": "doc-001",
    "fileName": "customers",
    "fileExtension": "csv",
    "mimeType": "text/csv",
    "contentText": "Id,Name,Country\n1,Ana,DE\n2,John,US\n3,Mika,JP"
  },
  {
    "id": "doc-002",
    "fileName": "notes",
    "fileExtension": "txt",
    "mimeType": "text/plain",
    "contentText": "This is a simple text file.\nSecond line.\nThird line."
  }
]

Screenshots

Komponenten Vorschau in Canvas Apps

documentsJson Input

Download Modus Auswahl

documentsOutputJson Output

Output und Status Properties

Welchen Download Modus du nutzen solltest

Disabled

Nutze Disabled, wenn die Komponente nur die Dateien vorbereiten soll. Das ist der sicherste Modus, wenn SharePoint, Power Automate oder ein anderes externes System das Speichern uebernimmt.

Zip

Nutze Zip, wenn du einen zuverlaessigen Browser Download mit nur einer Datei willst. In der Praxis ist das die beste eingebaute Option fuer Nutzer, die einen klaren Ein Klick Download erwarten.

Separate

Nutze Separate, wenn wirklich jede Datei einzeln heruntergeladen werden soll. Das ist nur best effort, weil Browser oder Host Umgebungen mehrere Downloads begrenzen koennen.

Nutzung in Canvas Apps

1. Loesung in die Umgebung importieren.
2. Die Komponente auf einem Canvas Screen platzieren.
3. documentsJson an einen JSON String binden.
4. downloadMode passend zur User Journey setzen:
   • Disabled fuer Output only Flows
   • Zip fuer ein Archiv
   • Separate fuer einzelne Dateien
5. documentsOutputJson, isValid, validDocumentCount oder downloadResultJson in Power Fx auslesen.

Output JSON in Power Fx parsen

Wenn du die verarbeitete Ausgabe direkt in der App weiterverwenden willst, kannst du documentsOutputJson in eine Collection umwandeln.

ClearCollect(
    colDocs,
    ForAll(
        Table(ParseJSON(FileExporterComponent1.documentsOutputJson)),
        {
            id: Text(Value.id),
            fileName: Text(Value.fileName),
            fileExtension: Text(Value.fileExtension),
            fullFileName: Text(Value.fullFileName),
            mimeType: Text(Value.mimeType),
            contentText: Text(Value.contentText),
            base64: Text(Value.base64),
            sizeBytes: Value(Text(Value.sizeBytes)),
            isValid: Boolean(Value.isValid),
            errorMessage: Text(Value.errorMessage)
        }
    )
)

Das ist hilfreich, wenn du einen Bestaetigungs Screen bauen, nur gueltige Dokumente filtern oder das finale Payload an einen Flow uebergeben willst.

SharePoint und Power Automate Muster

Ein sehr praktischer Einsatz ist das Speichern der generierten Dateien ausserhalb des Browsers.

Empfohlenes Muster:

1. downloadMode = Disabled setzen.
2. Auf das aktualisierte documentsOutputJson warten.
3. Den JSON String an Power Automate senden.
4. Parse JSON im Flow verwenden.
5. Ueber die Dokumente loopen.
6. Jedes base64 Feld in Binary umwandeln.
7. Dateien in SharePoint oder ein anderes Zielsystem schreiben.

So entsteht ein sauberer Handoff zwischen App UI und Speicher Workflow.

Wichtige Properties und Outputs

Nutzbare Inputs:

• documentsJson
• downloadMode
• archiveFileName
• displayModeInput
• Button Styling Inputs

Nutzbare Outputs:

• documentsOutputJson
• downloadResultJson
• documentCount
• validDocumentCount
• isValid
• errorMessage
• lastAction
• changeToken
• selectToken

Haeufige Fehler vermeiden

• Separate fuer kritische Multi File Downloads verwenden, ZIP ist meistens robuster.
• Erwarten, dass die Komponente Dateien direkt hochlaedt, sie bereitet nur Outputs vor.
• isValid und errorMessage vor dem Flow Handoff nicht pruefen.
• Browser Download nutzen, obwohl eigentlich SharePoint Storage das Ziel ist, dafuer besser Disabled plus documentsOutputJson.

Naechste Schritte

• Mit einem einfachen CSV oder TXT Export starten.
• Entscheiden, ob Nutzer einen ZIP Download oder einen externen Storage Flow brauchen.
• Einen Power Automate Handoff ergaenzen, wenn SharePoint oder ein anderes Backend die Dateien speichern soll.

Fazit

Wenn du ein Power Apps file export PCF Muster fuer Microsoft Power Platform brauchst, bietet diese Komponente eine praktische Grundlage: JSON rein, validierte Dateien raus, plus eine klare Wahl zwischen Browser Download und Automation Handoff.