Migration
Von PDFMonkey zu Formfeed wechseln
PDFMonkey-Code-Vorlagen sind HTML mit Liquid, und Formfeed verwendet ebenfalls Liquid. Der Importer liest Ihre Vorlagen über die PDFMonkey-API und wandelt die Stellen um, an denen deren Ruby-Liquid abweicht. Sie prüfen einen Bericht, statt Vorlagen neu zu schreiben.
Kostenloser Plan mit 100 Einheiten im Monat, keine Kreditkarte
1. Vorlagen importieren
Öffnen Sie Vorlagen, wählen Sie Importieren und PDFMonkey. Mit einem geheimen API-Schlüssel und Ihrer Workspace-ID listen Sie die Vorlagen auf, wählen die gewünschten aus und analysieren sie; Entwürfe anlegen macht aus jeder eine Liquid-Vorlage mit den Beispieldaten als Standard-Datensatz. Der Schlüssel wird nur für diese Anfrage verwendet und nie gespeichert. Die Kommandozeile macht dasselbe mit formfeed import pdfmonkey. Jede Umwandlung steht in der Migrationsanleitung.
- Umgewandelt. strftime-Datumsformate zu date-fns, in_time_zone zur Zeitzone des date-Helfers, with_delimiter zur Zahlenformatierung mit passenden Trennzeichen, slice_by zu chunk, Snippets und Partials eingefügt.
- Abgebildet. Papierformat, Ausrichtung, Ränder, die einfache und die erweiterte Kopf- und Fußzeile mit Seitenzahlen, SCSS zu CSS kompiliert, Tailwind auf den Tailwind-Modus von Formfeed umgestellt, Bildvorlagen als Bildvorlagen in 1200 × 630, was Sie unter Seiteneinrichtung ändern.
- Gemeldet. Filter ohne Gegenstück, Ganzzahl-Divisionen, die Ruby abrundet, $docPayload-Skripte und PDF-Formularfelder, jeweils mit Zeile und Alternative.
2. Die API umstellen
Veröffentlichen Sie zuerst jeden importierten Entwurf: Die API rendert die veröffentlichte Version. Dann ersetzen Sie den Aufruf des Documents-Endpunkts von PDFMonkey durch ein Rendering, das die Vorlage mit ihrem Slug nennt (dem Template-Identifier von PDFMonkey in Kleinbuchstaben mit Bindestrichen) und die Nutzdaten als data sendet. Asynchrone Renderings mit Webhook ersetzen wartende Dokumente und ihre Webhook-Ereignisse.
curl https://api-eu.formfeed.dev/v1/renders \
-H "Authorization: Bearer ff_live_..." \
-H "Content-Type: application/json" \
-d '{ "template": "order-confirmation", "data": { "order": { "id": "A-1" } } }'Was anders ist
- Ein Editor mit Diagnosen. Autovervollständigung aus Ihren Beispieldaten, Fehler schon beim Tippen und eine paginierte Vorschau mit Kopf- und Fußzeilen.
- Drei Vorlagensprachen. Liquid für Ihre importierten Vorlagen, Jinja2 und Handlebars, wenn ein Team sie bevorzugt, alle mit denselben Helfern.
- Vorlagen als Dateien. Vorlagen im eigenen Repository, offline in der Vorschau und in der CI getestet, mit derselben Engine wie die API.
- Rechnungen und Codes eingebaut. QR-Codes, Barcodes, EPC-Zahlcodes und Währungsformat ohne JavaScript-Bibliotheken.
FAQ
- Lassen sich Builder-Vorlagen importieren?
- Nein. PDFMonkey dokumentiert das Format seines visuellen Builders nicht, daher werden nur Code-Vorlagen importiert. Builder-Vorlagen werden aufgelistet und übersprungen.
- Was ist mit Snippets?
- Die API von PDFMonkey liefert den Code von Snippets nicht. Fügen Sie die Snippets, die die Vorlagen laden, im Import-Dialog ein oder übergeben Sie sie der Kommandozeile mit --snippet; sie werden in jede Vorlage eingefügt.
- Wird mein PDFMonkey-API-Schlüssel gespeichert?
- Nein. Er wird einmal zum Lesen der Vorlagen gesendet und danach verworfen.