Plattformen und Integrationen # Supabase-Storage-Dokumente in PDF normalisieren Einen kontrollierten Supabase-Storage-Dokumentenstapel importieren, unterstützte Office-Dateien zu PDF normalisieren und in ein separates Präfix exportieren. Veröffentlicht am 1. September 2026 ## Wichtigste Erkenntnisse * Beschränken Sie das Import-Präfix auf unterstützte Office-Formate; ein gemischter Bucket ist kein Konvertierungsvertrag. * Paginieren Sie rekursive Importe und setzen Sie für jede abgeschlossene Seite einen Kontrollpunkt, statt anzunehmen, dass eine Assembly die gesamte Bibliothek abdeckt. * Schreiben Sie PDFs in ein separates Präfix, damit nachfolgende Importläufe nicht ihre eigenen Ergebnisse konsumieren. Supabase Storage kann Produktdokumente aufbewahren, ohne das System zu sein, das sie konvertiert. Ein Batch-Workflow ist nützlich, wenn eine Anwendung Office-Dateien angesammelt hat, die eine konsistente PDF-Repräsentation für die Prüfung, den Download oder die nachgelagerte Indizierung benötigen. Das sichere Design behandelt die Konvertierung als versioniertes Derivat, statt das Originalobjekt zu überschreiben. ## In diesem Leitfaden 1. [Einen konvertierbaren Dokumenten-Posteingang erstellen](#supabase-document-processing-workflow-section-1) 2. [Rekursive Importe paginieren und mit Kontrollpunkten versehen](#supabase-document-processing-workflow-section-2) 3. [Das Supabase-PDF-Template erstellen](#supabase-document-processing-workflow-section-3) 4. [Das PDF und den Anwendungsdatensatz prüfen](#supabase-document-processing-workflow-section-4) 5. [Wiederholungen und Aufbewahrung pro Objekt gestalten](#supabase-document-processing-workflow-section-5) 6. [Den Batch unabhängig vom Nutzerverkehr beobachten](#supabase-document-processing-workflow-section-6) ## Worauf es besonders ankommt * Verwenden Sie nach Möglichkeit separate Template-Zugangsdaten für Lesen und Schreiben oder eng begrenzte S3-Zugangsschlüssel. * Erfassen Sie Quellpfad, Quellversion, Assembly-ID, Ausgabepfad und Workflow-Version in der Anwendungsdatenbank. * Behandeln Sie die Bucket-Berechtigungen des gespeicherten Objekts als Zugriffskontrolle, und erfassen Sie den Zielpfad statt einer Ergebnis-URL als Identität des Dokuments. ## Einen konvertierbaren Dokumenten-Posteingang erstellen Richten Sie den rekursiven Import nicht auf einen gemischten Produktions-Bucket. Erstellen Sie ein Posteingang-Präfix, dessen Vertrag auf die für die PDF-Konvertierung ausgewählten Office- und Textformate beschränkt ist. Bilder, Archive und nicht zugehörige Anwendungsobjekte liegen außerhalb des Umfangs dieses Workflows, also leiten Sie diese explizit um oder schließen Sie sie aus. PDF ist keine unterstützte Eingabe für /document/convert, leiten Sie vorhandene PDFs daher um diesen Step herum. Schreiben Sie den Vertrag in den Upload- oder Anwendungspfad, der den Posteingang befüllt. Validieren Sie Dateiname, erkannten Typ, Größe, Mandantenzugehörigkeit und Dokumentstatus, bevor Sie die Verarbeitung planen. Die Dateiendung eines Speicherobjekts ist nützlich für die Weiterleitung, aber keine maßgebliche Inhaltsvalidierung. ## Rekursive Importe paginieren und mit Kontrollpunkten versehen /supabase/import kann ein Verzeichnis rekursiv durchlaufen und mit page\_number und files\_per\_page paginieren. Behandeln Sie jede Seite als begrenzte Ausführung. Speichern Sie die Seitenanfrage und die beobachteten Quellobjekte in der Anwendung, damit ein Absturz oder eine Wiederholung fortgesetzt werden kann, ohne anzunehmen, dass der Bucket unverändert geblieben ist. Halten Sie das normalisierte Ausgabepräfix außerhalb des importierten Posteingangs. Andernfalls kann ein späterer rekursiver Lauf auf seine eigenen PDFs stoßen, für deren Verarbeitung dieser Konvertierungszweig nicht ausgelegt ist. Ein separater Bucket ist noch eindeutiger, wenn sich Aufbewahrung oder Berechtigungen unterscheiden. ### Posteingang Enthält nur Quellformate, die für die aktuelle Konvertierungsrichtlinie zulässig sind. ### Normalisierte Ausgabe Enthält versionierte PDFs und ist von jedem Posteingang-Durchlauf ausgeschlossen. ### Datenbankeintrag Ordnet jede Quellversion ihrer Assembly, ihrem Ausgabeobjekt und ihrem Workflow-Status zu. ## Das Supabase-PDF-Template erstellen Das Template importiert das begrenzte Posteingang-Präfix, konvertiert jedes ausgegebene Office-Dokument in PDF und speichert jedes Ergebnis unter einem normalisierten Pfad, der die Assembly-Eindeutigkeit enthält. /supabase/store erfordert einen Dateipfad statt eines Verzeichnisses, daher muss der Pfad mit einem konkreten Dateinamensausdruck enden. Das Beispiel verweist auf separate Namen für Lese- und Schreib-Zugangsdaten. Supabase stellt eine S3-kompatible Speicherverbindung bereit; bewahren Sie deren Endpunkt und Zugangsschlüssel in Template-Zugangsdaten auf. Speichern Sie den Ausgabe-Bucket und -Pfad als dauerhafte Identität. Setzen Sie sign\_urls\_for nur, wenn die Anwendung eine ablaufende signed\_ssl\_url benötigt; wird es weggelassen, erfolgt keine URL-Signierung. Eine begrenzte Supabase-Office-Dokumentseite in versionierte PDFs konvertieren ``` { "allow_steps_override": false, "steps": { "office_inbox": { "robot": "/supabase/import", "credentials": "supabase-document-read", "path": "documents/office-inbox/", "recursive": true, "page_number": 1, "files_per_page": 100 }, "normalized_pdf": { "use": "office_inbox", "robot": "/document/convert", "format": "pdf" }, "supabase_output": { "use": "normalized_pdf", "robot": "/supabase/store", "credentials": "supabase-document-write", "path": "documents/normalized-pdf-v1/${assembly.id}/${unique_prefix}/${file.url_name}", "result": true } } } ``` ## Das PDF und den Anwendungsdatensatz prüfen Testen Sie DOCX-, ODT-, PPTX-, XLSX-, HTML- und Markdown-Fixtures nur, wenn das Produkt diese Eingaben zusagt. Prüfen Sie Seitenzahl, Schriftarten, Tabellen, Formeln, Links, Kopfzeilen und nicht-lateinischen Text. Nicht unterstützte oder für die Wiedergabetreue kritische Dateien sollten in einen sichtbaren Prüfstatus gelangen, statt stillschweigend als normalisiert markiert zu werden. Aktualisieren Sie nach dem Export die Anwendungsdatenbank idempotent mit Quellpfad und -version, Workflow-Version, Assembly-ID, Ausgabe-Bucket und -Pfad sowie Endstatus. Supabase Storage aktualisiert nicht die Datenbankzeile, die das Dokument repräsentiert; die Anwendung muss diese Beziehung abgleichen. ## Wiederholungen und Aufbewahrung pro Objekt gestalten Ein fehlerhaftes Dokument sollte nicht erfordern, eine komplette Verzeichnisseite erneut zu verarbeiten. Verfolgen Sie Erfolg und Fehlschlag pro Quellidentität und wiederholen Sie nur die Quellobjekte, die die Anwendung nicht als abgeschlossen erfasst hat. Der Beispielpfad ist pro Lauf eindeutig, daher schreibt eine erneute Verarbeitung derselben Quelle ein neues Objekt; die Deduplizierung erfolgt über den Quelle-zu-Ergebnis-Eintrag der Anwendung, der vor der Erstellung einer weiteren Assembly geprüft wird. Bewahren Sie Originale auf, bis die Aufbewahrungsrichtlinie der Anwendung eine Löschung erlaubt und die normalisierten PDFs die Prüfung bestanden haben. Erfassen Sie getrennt, ob das PDF eine Anzeige-Rendition oder das geprüfte Aktenexemplar ist, statt diese geschäftliche Rolle vom Ausgabepräfix bestimmen zu lassen. ## Den Batch unabhängig vom Nutzerverkehr beobachten Führen Sie große Normalisierungsdurchläufe über eine Queue oder einen geplanten Worker aus statt über eine interaktive Anfrage. Überwachen Sie Seiten-Kontrollpunkte, Fehler auf Objektebene, Assembly-Dauer, Ausgabebytes und Supabase-Exportfehler. Stellen Sie eine für Operatoren sichtbare Liste ungelöster Quellobjekte bereit, statt Anbieterantworten in Protokollen zu verstecken. Drosseln Sie die Arbeitslast, damit rekursive Importe, Dokumentkonvertierung und Schreibvorgänge Anwendungsdatenbanken oder den Speicherzugriff nicht überlasten. Nutzen Sie zunächst einen kleinen, repräsentativen Rollout und erhöhen Sie die Nebenläufigkeit erst, nachdem Abschluss-, Wiederholungs- und Webhook-Verhalten unter realistischen Dateien gemessen wurden. ## Wissenswerte technische Details * /supabase/import akzeptiert einen einzelnen Pfad, ein Array von Pfaden oder einen Verzeichnispfad. Rekursive Importe verwenden page\_number und files\_per\_page. * /document/convert unterstützt Office- und Textformate einschließlich DOCX, ODT, PPTX, XLSX, HTML und Markdown, mit PDF als verfügbarer Ausgabe. * PDF ist keine unterstützte Eingabe für /document/convert. Leiten Sie vorhandene PDFs um die Konvertierung herum und konvertieren Sie nur unterstützte Quellformate. * /supabase/store benötigt einen Dateipfad statt eines Verzeichnispfads und kann Assembly Variables in diesem Pfad enthalten. * /supabase/store setzt den Content-Type-Header standardmäßig auf den erkannten MIME-Typ der verarbeiteten Datei. Setzen Sie sign\_urls\_for, um eine ablaufende signed\_ssl\_url zurückzugeben; wird es weggelassen, erfolgt keine URL-Signierung. * Supabase-Import und -Speicherung nutzen dessen S3-kompatible Speicherverbindung. Template-Zugangsdaten halten den Endpunkt und die Zugriffsschlüssel aus den gespeicherten Instructions heraus. ## Ein praxisnaher Ansatz 1. 1\ Legen Sie den konvertierbaren Posteingang, das Ausgabepräfix, die Paginierungsgröße und den Übergang der Anwendungsdatensätze fest. 2. 2\ Erstellen Sie eingeschränkte Supabase-Zugangsdaten und speichern Sie das Template für Import, Konvertierung und Speicherung. 3. 3\ Konvertieren Sie repräsentative DOCX-, PPTX- und ODT-Dateien und überprüfen Sie Layout und Metadaten. 4. 4\ Führen Sie begrenzte Seiten mit Kontrollpunkten, idempotenten Datensätzen und einem Wiederholungspfad für fehlgeschlagene Objekte aus. Ein vierstufiger Medienworkflow ## Wann Transloadit hilfreich ist Verwenden Sie diesen Workflow für die stapelweise Normalisierung einer bereits in Supabase Storage vorliegenden Dokumentbibliothek. Verwenden Sie /supabase/import für eine begrenzte Datei oder ein paginiertes Präfix, /document/convert für die unterstützte Office-zu-PDF-Konvertierung und /supabase/store für das resultierende Objekt. Beschränken Sie den Posteingang auf konvertierbare Formate, trennen Sie Eingabe- und Ausgabepräfix, und gleichen Sie jeden exportierten Pfad mit dem zugehörigen Supabase-Datenbankeintrag ab. ## Architekturgrenze Supabase Storage ist verantwortlich für die Quell- und Ausgabeobjekte, während die Anwendung für Mandantenzugriff, Datenbankeinträge, Dokumentstatus, Aufbewahrung und Veröffentlichung zuständig ist. Transloadit verarbeitet nur die vom gespeicherten Workflow ausgewählten Objekte und aktualisiert Anwendungszeilen nicht automatisch. ## Häufig gestellte Fragen ### Kann der Posteingang bereits vorhandene PDFs enthalten? Nein. PDF ist kein unterstütztes Eingabeformat für /document/convert. Halten Sie PDFs aus diesem Office-Datei-Posteingang heraus oder leiten Sie sie am Konvertierungs-Step vorbei. ### Kann eine Assembly einen gesamten Bucket konvertieren? Rekursive Importe können Verzeichnisse abdecken, aber begrenzte Seiten mit dauerhaften Kontrollpunkten sind für große oder sich ändernde Bibliotheken sicherer. ### Warum ein separates Ausgabepräfix verwenden? Es verhindert, dass rekursive Importe generierte PDFs als neue Quelldokumente einlesen, und erleichtert Aufbewahrung, Rollback und Berechtigungen. ### Welche Ergebnis-URL sollte die Anwendung speichern? Speichern Sie den Ziel-Bucket und den Pfad als dauerhafte Identität, nicht eine Ergebnis-URL. Setzen Sie sign\_urls\_for, wenn die Anwendung eine ablaufende signed\_ssl\_url benötigt; ist der Wert nicht gesetzt, signiert /supabase/store keine URL. ### Aktualisiert Transloadit unsere Supabase-Datenbankzeile? Nein. Die Anwendung muss das Assembly-Ergebnis selbst mit ihren Mandanten-, Dokument- und Versionseinträgen abgleichen. ## Erstellen Sie den Workflow Entwickeln Sie das Konzept mithilfe der Robot-Dokumentation und funktionsfähiger Demos zu einer getesteten Assembly weiter. ### Relevante Robots * [/supabase/import EN (English)](/docs/robots/supabase-import.md) * [/document/convert](/de/docs/robots/document-convert.md) * [/supabase/store EN (English)](/docs/robots/supabase-store.md) * [Aus Supabase Storage importieren EN (English)](/docs/robots/supabase-import.md) * [Office-Dokumente in PDF konvertieren](/de/docs/robots/document-convert.md) * [Nach Supabase Storage exportieren EN (English)](/docs/robots/supabase-store.md) * [Supabase-Zugangsdaten schützen](/de/docs/topics/template-credentials.md) * [Nicht überlappende Ausgabepfade erstellen](/de/docs/topics/assembly-variables.md) * [API-Dokumentation lesen](/de/docs.md) * [Funktionsfähige Demos entdecken EN (English)](/demos.md) * [Kostenlosen Workspace erstellen](/c/signup/) Plattformen und Integrationen ## Mit verwandten Leitfäden fortfahren * [Anpassbare Medienverarbeitungs-Workflows mit Transloadit](/de/guides/customizable-media-processing-workflows.md)\ Entwerfen Sie ein wiederverwendbares Template mit Validierung, Variablen, parallelen Derivaten, sicherem Speicher und beobachtbarem Abschluss. * [Vollständiger Leitfaden für Digital-Asset-Workflows](/de/guides/digital-asset-workflows.md)\ Gestalten Sie einen Digital-Asset-Workflow von Aufnahme und Verarbeitung über Prüfung und Veröffentlichung bis zu Aufbewahrung und Löschung. * [Hochgeladene Dokumente in PDF konvertieren und in Box speichern](/de/guides/upload-convert-documents-pdf-box.md)\ Wandeln Sie hochgeladene Office-Dateien in konsistente PDFs um und legen Sie sie in einem kontrollierten Box-Ordner ab, ohne Speicherzugangsdaten offenzulegen. * [Externen Speicher für einen Medienworkflow wählen](/de/guides/external-storage-media-workflows.md)\ Externes Speicherziel für Transloadit-Workflows wählen: Speichermodelle, Zugangsdaten, Zugriffskontrollen, URL-Verhalten und Massenimport-Bedarf vergleichen. * [Bilder aus Google Cloud Storage verarbeiten und sicher zurückschreiben](/de/guides/google-storage-image-processing-workflow.md)\ Bilder aus Google Cloud Storage im Batch importieren, begrenzte WebP-Derivate erstellen und in ein separates, kontrolliertes Präfix exportieren. * [Datei-Uploads, Bildoptimierung und Video-Encoding an einen tus-Server](/de/guides/file-uploads-image-optimization-video-encoding-tus-server.md)\ Dateien empfangen, Bilder optimieren oder Videos mit Transloadit codieren und das ausgewählte Ergebnis an einen tus-kompatiblen Server übergeben.