Von jsreport zu Formfeed wechseln

1. Vorlagen importieren

Exportieren Sie aus dem jsreport Studio oder der jsreport-Kommandozeile, öffnen Sie dann Vorlagen, wählen Sie Importieren und jsreport und wählen Sie die Vorlagen aus der Datei; Entwürfe anlegen macht aus jeder eine Handlebars-Vorlage. Die Kommandozeile macht dasselbe mit formfeed import jsreport. Jede Abbildung steht in der Migrationsanleitung.

• Behalten. Handlebars-Markup, Kopf- und Fußzeilenvorlagen mit Seitenzahlen, Papier, Ränder, Skalierung, Seitenbereiche, PDF-Metadaten und die Beispieldaten.
• Aufgelöst. Assets werden zu Data-URIs oder eingebettetem CSS, Untervorlagen und Komponenten werden eingefügt, toJS wird zu json.
• Gemeldet. Eigene JavaScript-Helfer mit jedem Aufruf, Skripte, pdf-utils-Operationen sowie Engines und Rezepte, die Formfeed nicht hat.

2. Eigene Helfer ersetzen

jsreport führt Ihre Helfer als Code auf Ihrem Server aus; Formfeed führt keinen eigenen Code aus. Formatierung, Datumsangaben, Summen, QR-Codes und Barcodes sind eingebaute Helfer, alles andere berechnen Sie in Ihrer Anwendung und senden es mit den Daten.

3. Die API umstellen

Veröffentlichen Sie zuerst jeden importierten Entwurf: Die API rendert die veröffentlichte Version. Dann wird aus dem Report-Endpunkt von jsreport ein Rendering, das die Vorlage mit ihrem Slug nennt (ihrem jsreport-Namen in Kleinbuchstaben mit Bindestrichen) und die Daten sendet, die die Anfrage an jsreport trug. Batches, Webhooks, Idempotenzschlüssel und Ausgabespeicher gehören zur API.

curl https://api-eu.formfeed.dev/v1/renders \
  -H "Authorization: Bearer ff_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "template": "invoice", "data": { "number": "R-7", "total": 12.5 } }'

Was Sie nicht mehr betreiben

• Kein Report-Server. Kein Chromium zu patchen, keine Warteschlange zu dimensionieren, kein Speicher aufzuräumen. Rendering, Speicher und signierte Download-Links gehören zum Dienst.
• Verarbeitung in der EU. Datenbank und Rendering in Frankfurt, Ausgaben in der EU gespeichert, mit Auftragsverarbeitungsvertrag.
• Vorlagen als Dateien. Vorlagen weiterhin im eigenen Repository und in der CI getestet, mit der Engine der API.

FAQ

Welche Vorlagen lassen sich importieren?

Handlebars-Vorlagen mit dem Rezept chrome-pdf oder chrome-image; das Rezept html wird eine PDF-Vorlage. jsrender-, EJS- und Pug-Vorlagen werden mit einem Fehler importiert, damit Sie sie neu schreiben können. Excel-, Word- und andere Rezepte werden gemeldet und nur zum Nachschlagen als PDF-Vorlagen importiert. Word-Ausgaben lassen sich als Word-Vorlage nachbauen (ab Starter): Ihre eigene .docx-Datei mit Handlebars-Tags, befüllt mit denselben Daten.

Muss ich Untervorlagen einzeln importieren?

Nein. Untervorlagen und Komponenten werden in die Vorlagen eingefügt, die sie verwenden.

Was passiert mit großen Bildern und Schriften?

Dateien bis 256 KB werden als Data-URIs eingebettet. Größere werden zu Verweisen {{asset "logo.png"}} auf die Dateibibliothek des Workspace: Laden Sie jede Datei dort einmal unter demselben Namen hoch, auf der Seite Dateien oder mit formfeed files push.