Dateien, die das Dokument nennt, ohne sie zu enthalten

Lassen Sie das Dokument auf eine Datei daneben oder unter einer Adresse verweisen, bei seinen Anhängen aufgeführt, ohne darin mitzureisen.

In einem echten PDF ansehen

Ein Ausschreibungspaket mit drei Losen

Drei Lose, jedes als separate Datei an das Dokument angehängt, beschrieben durch die Spalten, die das Dokument selbst definiert — Los, Versandtag, Betrag —, und neueste zuerst sortiert. Das Deckblatt wiederholt dieselben Spalten offen sichtbar, für Anzeigesoftware, die angehängte Dateien nicht zeigt.

Das PDF öffnen Das vollständige Beispiel ansehen

Zusammenfassung

Manche Dateien sind zu schwer, um sie in ein Dokument zu legen: die Rohdaten einer Vermessung, ein Film eines Ausstellungsraums. Das Dokument kann trotzdem auf sie verweisen. Es führt sie unter seinen Anhängen auf, mit einem Satz, was jede ist, und die Anzeigesoftware öffnet die Datei aus dem Ordner neben dem Dokument oder ruft sie unter ihrer Adresse ab. Nichts von der Datei reist mit dem Dokument.

Technisch

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

Jeder Eintrag wird als Dateispezifikation geschrieben, deren Inhalt ein Pfad oder eine Adresse statt eines Streams ist: ein Pfad vom Dokument zu einer Datei daneben, dessen Bestandteile durch einen Schrägstrich getrennt und ab dem Ordner aufgelöst werden, der das Dokument enthält, oder eine Adresse, die mit ihrem Schema beginnt und in 7-Bit-ASCII geschrieben ist. Auf die Datei wird über ihren Namen verwiesen wie auf einen Anhang — von einer Seite in page_files, einem Bild in images, einem Teil in document_parts —, und sie wird unter den Dateien des Dokuments aufgeführt, wo die Anzeigesoftware den Pfad öffnet oder die Adresse abruft. Der Server ruft nichts ab. Ein Name, den bereits ein Anhang trägt, wird übernommen, wobei der Anhang mit dem Dokument als Ganzem verbunden bleibt.

Anfrageschema

referenced_files — Array, optional, standardmäßig leer.
referenced_files[].name — Zeichenkette, erforderlich. Der Name, unter dem der Rest der Anfrage auf die Datei verweist.
referenced_files[].payload — Objekt, erforderlich, mit einem von zwei Schlüsseln: beside, ein Pfad vom Dokument zur Datei, aufgelöst ab dem Ordner, der das Dokument enthält, wobei ein Pfad ab der Wurzel, ein Laufwerk, eine Adresse oder ein Backslash abgelehnt wird; at, die Adresse, unter der die Datei ausgeliefert wird, beginnend mit ihrem Schema und in 7-Bit-ASCII geschrieben.
referenced_files[].description — Zeichenkette, erforderlich. Was die Datei ist, in Worten, für jemanden, der die Liste der vom Dokument genannten Dateien liest.
referenced_files[].relationship — Zeichenkette, erforderlich. Was die Datei für das Dokument ist: einer der Werte source, alternative, data, supplement, unspecified.

Ein Dokument, das auf diese Weise eine Datei nennt, gibt "version": "2.0" an, sonst führt die Erzeugung zu 400; ein Dokument, das einen Teil von PDF/A beansprucht, nennt keine. Die Datei selbst wird nie gelesen: Ein Pfad, der ins Leere führt, wird trotzdem geschrieben.

Eine vollständige Anfrage, die ein PDF erzeugt

{
  "version": "2.0",
  "referenced_files": [
    {
      "name": "readings",
      "payload": { "beside": "survey/readings.csv" },
      "description": "Every reading of the 2026 survey",
      "relationship": "data"
    }
  ],
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 72, "lly": 700, "urx": 523, "ury": 740 },
      "content": ["The survey, and the file of its readings 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 Die Anhänge, die das Dokument neben seinen Seiten trägt 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