printAndSaveRecord

Erzeugt ein PDF aus einem Datensatz oder einer Carbone-Vorlage, speichert es im internen Dateisystem von Ninox und gibt den Pfad als Link zurück

Diese Funktion erstellt ein PDF aus einem angegebenen Datensatz, entweder in einem Ninox-Layout oder einer Carbone-Vorlage, speichert es im internen Dateisystem und stellt einen Downloadlink zur Verfügung.

Sie können diesen Link für internen Zugriff verwenden oder die Datei mit der Funktion importFile als Anhang in einem Datensatz speichern.

Achtung: Diese Funktion kann nur auf dem Client ausgeführt werden. Weitere Informationen finden Sie in der Dokumentation zum Ausführungskontext.

Carbone-Vorlagen

Die Funktion printAndSaveRecord unterstützt Carbone-Vorlagen und ermöglicht optional die Eingabe eines JSON-Objekts, um Felder des Datensatzes in der Vorlage zu überschreiben. Zusätzlich bietet sie eine erweiterte Konfiguration über den _options-Parameter, einschließlich Features wie Testdruck, Passwortschutz und PDF-Versionierung.

Syntax

printAndSaveRecord(nid, string)

printAndSaveRecord(nid, string, JSON)

Parameter

• record: Der als PDF zu speichernde Datensatz.

• myLayout: Das Layout oder die Carbone-Vorlage zur PDF-Formatierung.

• data (optional): Ein JSON-Objekt, welches die Daten im Datensatz in der Carbone-Vorlage überschreibt.

• _options (optional): Zusätzliche Konfigurations-Optionen für Carbone-Vorlagen.

_options-Konfiguration:

• testPrint: boolean, Standard ist false. Bei true wird ein Test-PDF mit Carbone-Wasserzeichen gedruckt, ohne Carbone-Token zu verbrauchen.

• pdfPassword: string. Schützt das PDF mit einem Passwort.

• pdfVersion: number. Gibt die PDF-Version an:

  • 0: Standard

  • 15: PDF 1.5

  • 16: PDF 1.6

  • 1: PDF/A-1

  • 2: PDF/A-2

  • 3: PDF/A-3

Hinweis: _options-Konfigurationen sind kombinierbar, so dass Sie mehrere Einstellungen in einem Funktionsaufruf anwenden können. Sie können zum Beispiel sowohl pdfPassword als auch pdfVersion aktivieren, um zusätzliche Anpassungen vorzunehmen.

Rückgabewert

link: Eine URL zur gespeicherten PDF-Datei im internen Dateisystem von Ninox.

Beispiele

printAndSaveRecord(record, myLayout)

Diese Funktion erstellt und speichert ein PDF für den festgelegten Datensatz in einem Ninox-Layout oder einer Carbone-Vorlage und gibt den Link zur Datei zurück.

Beispiel:

printAndSaveRecord(this, "Rechnungen")

Ergebnis:

Ein Link zum generierten PDF im Layout Rechnungen: https://dbde0000.ninox.com/AbCD1234/12345xYZzyX/loadfile/Rechnungen.pdf?

printAndSaveRecord(record, myLayout, data)

Diese Version funktioniert speziell mit Carbone-Vorlagen und erlaubt zusätzliche Konfigurationen.

1. Die Daten des Datensatzes überschreiben

Speichert einen Datensatz in einer Carbone-Vorlage als PDF im internen Dateisystem und gibt einen Link zurück. Die Daten des Datensatzes können mit einem JSON-Objekt überschrieben werden.

Beispiel:

printRecord(this, "Rechnungen", {
Datum: format(if Datum = null then Datum else today(), "DD.MM.YYYY")
})

Ergebnis:

Ein Link zum PDF, das einen Eintrag im Feld Datum enthält: https://dbde0000.ninox.com/AbCD1234/12345xYZzyX/loadfile/Rechnungen.pdf?

Wenn es keinen Eintrag im Feld Datum gibt, wird das heutige Datum eingesetzt, zum Beispiel 28.08.2024 am 28. August 2024.

2. Carbone-Vorlage befüllen (ohne _options)

Beispiel:

printAndSaveRecord(this, "Rechnungen", { 
Name: "Charlie Lee", 
Alter: 45 
})

Ergebnis:

Ein Link zum PDF, in dem Name und Alter durch die angegebenen Werte ersetzt sind: https://dbde0000.ninox.com/AbCD1234/12345xYZzyX/loadfile/Rechnungen.pdf?

3. Testdruck mit Carbone-Wasserzeichen

Hinweis: Testdrucke verbrauchen keine Carbone-Token.

Beispiel:

printAndSaveRecord(this, "Rechnungen", { 
Name: "Charlie Lee", 
Alter: 45, 
_options: { 
    testPrint: true 
  }
})

Ergebnis:

Ein Link zum Test-PDF mit Carbone-Wasserzeichen: https://dbde0000.ninox.com/AbCD1234/12345xYZzyX/loadfile/Rechnungen.pdf?

4. Passwortgeschütztes PDF

Beispiel:

printAndSaveRecord(this, "Rechnungen", {
  Name: "Charlie Lee",
  Alter: 45,
  _options: {
    pdfPassword: "1234"
  }
})

Ergebnis:

Ein Link zum PDF, das durch das Passwort 1234 geschützt ist: https://dbde0000.ninox.com/AbCD1234/12345xYZzyX/loadfile/Rechnungen.pdf?

5. PDF-Versionierung

Beispiel:

printAndSaveRecord(this, "Rechnungen", {
Name: "Charlie Lee",
Alter: 45,
_options: {
    pdfVersion: 1
  }
})

Ergebnis:

Ein Link zum PDF, das dem PDF/A-1-Standard entspricht: https://dbde0000.ninox.com/AbCD1234/12345xYZzyX/loadfile/Rechnungen.pdf?

Siehe auch

importFile, importiert eine Datei über eine URL und speichert diese als Anhang eines Datensatzes

printRecord, druckt einen bestimmten Datensatz in einem bestimmten Layout als PDF und öffnet die Datei im Standard-Programm.

Möchten Sie mehr über dieses Thema erfahren? Schauen Sie sich dazu den entsprechenden Abschnitt in unserem Video-Tutorial an.