Die Anhänge, die das Dokument neben seinen Seiten trägt

Ganze Dateien im PDF mitnehmen — die Daten, aus denen eine Rechnung erzeugt wurde, denselben Auszug in anderer Form —, jede benannt, beschrieben und datiert.

Zählerstände in PDF/A-3u mit angehängter Tabelle, erste Seite

In einem echten PDF ansehen

Zählerstände in PDF/A-3u mit angehängter Tabelle

Die Zählerstände eines Quartals, die ein Mensch auf der Seite liest und ein Abrechnungsprogramm aus der Tabelle in derselben Datei übernimmt.

Das PDF öffnen Das vollständige Beispiel ansehen

Auch zu sehen in: Ein Kontoauszug in PDF/A-4f mit angehängten Daten · Drei Kontoauszüge in einer Datei · Ein getaggtes Preisverzeichnis in PDF/A-3a

Zusammenfassung

Ein PDF kann Dateien in sich tragen, so wie ein Umschlag einen Brief und ein Formular. Wer das Dokument öffnet, sieht eine Liste dessen, was es enthält, und kann jedes davon speichern. So funktioniert eine elektronische Rechnung: Die Seiten sind die Rechnung, die ein Mensch liest, und die enthaltene Datei ist dieselbe Rechnung in einer Form, die ein Programm liest, sodass beide nie Verschiedenes sagen können. Das Wichtigste an jedem Anhang ist, was er für das Dokument ist: die Datei, aus der das Dokument erzeugt wurde, dasselbe anders gesagt oder etwas, das hinzugefügt wurde.

Technisch

Auf der obersten Ebene einer Anfrage geschrieben, unter "attachments"

attachments schreibt die Dateien, die das Dokument neben seinen Seiten enthält, in den Namensbaum /EmbeddedFiles und verknüpft sie über /AF mit dem Dokument, jede unter dem Namen, unter dem die Anfrage auf sie verweist, in der Reihenfolge, in der sie enthalten sind. Die Bytes selbst kommen neben der Anfrage an, als Teil unter diesem Namen. relationship ist die /AFRelationship der Datei; sie hat keinen Standardwert und ist Pflicht: Nur der Absender weiß, ob die Datei die Quelle ist, aus der das Dokument erzeugt wurde, eine Alternative, die dasselbe in anderer Form sagt, die zugrunde liegenden Daten oder eine Ergänzung. modified ist das /ModDate in den /Params der Datei, also wann die Daten der Datei zuletzt angefasst wurden, nicht wann das PDF erzeugt wurde. Eine Seite verweist über page_files auf die Dateien, zu denen sie gehört, und ein Archivdokument enthält sie nach den Regeln seiner Norm.

Anfrageschema

  • attachments — Array, optional, standardmäßig leer.
  • attachments[].name — Zeichenkette, erforderlich. Der Name des mitgelieferten Teils, der die Datei enthält; unter diesem Namen verweist auch der Rest der Anfrage auf sie.
  • attachments[].file_name — Zeichenkette, erforderlich. Der Name, unter dem die Datei angehängt ist und unter dem die Anzeigesoftware sie zum Speichern anbietet.
  • attachments[].description — Zeichenkette, erforderlich. Was die Datei ist, in Worten, für jemanden, der die Liste dessen liest, was das Dokument enthält.
  • attachments[].media_type — Zeichenkette, erforderlich. Der Medientyp der Datei: text/xml für ein XML-Dokument.
  • attachments[].relationship — Zeichenkette, erforderlich, ohne Standardwert. Einer der Werte source, alternative, data, supplement, unspecified.
  • attachments[].modified — Zeichenkette, erforderlich, ein Zeitstempel nach ISO 8601. Wann die Daten der Datei zuletzt geändert wurden, nicht wann das PDF erzeugt wurde.
  • attachments[].thumbnail — Zeichenkette, optional, standardmäßig nicht gesetzt. Der Name eines mitgelieferten Bildes, das die Anzeigesoftware in ihrer Liste der Anhänge für die Datei zeigt, geschrieben als /Thumb der Dateispezifikation. Seine Farben müssen Grau, Rot-Grün-Blau oder eine Palette aus einem der beiden sein, sonst wird die Anfrage abgelehnt; ein Name, unter dem kein Bild mitgeliefert wurde, wird ebenfalls abgelehnt. Erfordert PDF 2.0.
  • attachments[].unlisted — boolescher Wert, optional, standardmäßig false. true nimmt die Datei aus der Liste der Anhänge des Dokuments heraus, sodass die Anzeigesoftware sie dort nicht anbietet; sie bleibt dennoch enthalten und mit allem verknüpft, was auf sie verweist, und eine Aktion, die sie öffnet, wird abgelehnt.
  • attachments[].folder — Ganzzahl, optional. Die Nummer des Ordners aus collection.folders, in den die Datei gelegt wird; fehlt sie, landet die Datei im Stammordner. Eine Nummer, die kein Ordner trägt, wird abgelehnt, ebenso ein Ordner für eine als unlisted markierte Datei.

Geltungsbereich: das ganze Dokument. page_files sagt, welche Seiten welche dieser Dateien beanspruchen; eine Datei, die keine Seite beansprucht, trägt das Dokument selbst.

Eine vollständige Anfrage, die ein PDF erzeugt

{
  "attachments": [
    {
      "name": "statement_4711",
      "file_name": "statement-4711.xml",
      "description": "The statement as a data file",
      "media_type": "text/xml",
      "relationship": "data",
      "modified": "2026-08-03T09:15:00+02:00"
    }
  ],
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 72, "lly": 700, "urx": 523, "ury": 740 },
      "content": ["A page, and a data file carried beside it"],
      "font": "sans",
      "font_size": 12
    }
  ]
}

Die Zeile, die es sendet, in drei Sprachen

Das Dokument als Ganzes

Die Nummern, die die Anzeigesoftware zeigt Hundert Briefe in einer einzigen Datei Was das Dokument über sich sagt Was das Dokument über sich sagt, einmal gesagt Text, den niemand kopieren kann Notizen, die ein Programm in der Datei für sich hinterlässt Die Notizen, die ein Programm auf einer Seite hinterlässt Die Daten, die ein Programm an einen Farbabschnitt hängt Eine Datei, die noch in Jahrzehnten lesbar ist Die Drucknorm, die das Dokument beansprucht Die beanspruchte Norm für variablen Datendruck Das Passwort, das es öffnet, und was damit getan werden darf Eine Rechnung, die Mensch und Maschine gleichermaßen lesen Die Adresse, gegen die relative Links gelesen werden Die PDF-Version, die die Datei angibt Die PDF-Erweiterungen, die die Datei zu nutzen angibt Was ein Bild über sich sagt, und wie es gelesen wird Dateien, die das Dokument nennt, ohne sie zu enthalten Die Anhänge als Portfolio gezeigt Welche Anhänge eine Seite beansprucht Welche Anhänge eine Schrift beansprucht Der Ausweis, den eine einzelne Schrift trägt Welche Anhänge die Karte des Dokuments beansprucht Eine anderswo geschriebene Dokumentkarte Die Bereiche einer Seite, in denen ein Leser misst Der Ausweis, den eine einzelne Seite trägt Die Barrierefreiheitsnorm, die das Dokument beansprucht Die Normen, an denen das fertige Dokument gemessen wird

Wohin als Nächstes

Jeder JSON-Schlüssel einer Anfrage, auf einer Seite Die übrigen einundvierzig Einstellungen einer Anfrage

Die Preise ansehen Die Beispiele ansehen