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.
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.
{
"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
Legen Sie den konvertierbaren Posteingang, das Ausgabepräfix, die Paginierungsgröße und den Übergang der Anwendungsdatensätze fest.
- 2
Erstellen Sie eingeschränkte Supabase-Zugangsdaten und speichern Sie das Template für Import, Konvertierung und Speicherung.
- 3
Konvertieren Sie repräsentative DOCX-, PPTX- und ODT-Dateien und überprüfen Sie Layout und Metadaten.
- 4
Führen Sie begrenzte Seiten mit Kontrollpunkten, idempotenten Datensätzen und einem Wiederholungspfad für fehlgeschlagene Objekte aus.
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.