Die Anhänge als Portfolio gezeigt

Geben Sie an, wie die Anzeigesoftware die Anhänge anordnet: die Spalten, was jede Datei darin einträgt, die Reihenfolge und welche Datei sich zuerst öffnet.

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

Ein Dokument kann ganze Dateien in sich tragen, und eine Anzeigesoftware, der nicht mehr gegeben ist, zeigt eine Liste von Dateinamen — die nichts darüber sagt, welche wann hereinkam oder zu welchem Betrag. Hier geben Sie stattdessen die Tabelle an: die Spalten, die ein Mensch oben liest, was jeder Anhang in jede davon einträgt, die Spalte, nach der die Zeilen geordnet werden, und die Datei, die sich zuerst öffnet. Für vier Spalten muss gar nichts angegeben werden, weil sie von der Datei selbst abgelesen werden: der Name, unter dem sie angehängt ist, was sie in Worten ist, wann sie zuletzt geändert wurde und wie viele Bytes sie umfasst.

Technisch

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

collection schreibt die /Collection des Dokuments, sein /Schema aus Spalten und sein /Sort, und die eigenen Werte jedes Anhangs gelangen als /CI neben seiner Dateispezifikation in die Datei. Die Dateien einer Sammlung sind genau die, die attachments enthält, keine anderen. Eine Spalte verknüpft sich über key, das niemandem angezeigt wird, mit dem Wert, den eine Datei angibt; data sagt, was die Spalte enthält, und die vier Arten, die vom Anhang selbst abgelesen werden — file_name, description, modified, size —, nehmen keinen Wert aus der Datei an, sodass nichts ihr widersprechen kann. Ein Zeitpunkt wird nach ISO 8601 angegeben, wie jeder Zeitpunkt des Schemas, und gelangt so in die Datei, wie PDF einen Zeitpunkt schreibt. Ein sort, das einen Schlüssel nennt, den keine Spalte trägt, wird nicht abgelehnt: Die Anzeigesoftware ordnet die Zeilen dann nach eigenem Ermessen. Die Deklaration hebt die vom Dokument angegebene Version auf 1.7.

Anfrageschema

  • collection — Objekt, optional. Fehlt es, bleiben die Anhänge eine bloße Liste von Namen.
  • collection.view — Zeichenkette, optional, standardmäßig rows. Einer der Werte rows (jede Datei in einer eigenen Zeile), tiles (jede als kleines Bild) und hidden (nichts angezeigt, bis der Leser danach fragt).
  • collection.opens_on — Zeichenkette, optional. Die zuerst geöffnete Datei, unter dem Namen, unter dem sie angehängt ist. Fehlt sie, öffnet sich das Dokument selbst, und ein Name, den kein Anhang trägt, wird nicht abgelehnt.
  • collection.columns — Array, optional. Die Spalten der Tabelle, in ihrer Reihenfolge.
  • columns[].key — Zeichenkette, erforderlich. Was die Spalte mit dem Wert verknüpft, den eine Datei für sie angibt. Er wird niemandem angezeigt.
  • columns[].title — Zeichenkette, erforderlich. Die Überschrift, die ein Mensch liest.
  • columns[].data — Zeichenkette, erforderlich. Einer der Werte text, date und number, die die Datei angibt, sowie file_name, description, modified und size, die vom Anhang abgelesen werden.
  • columns[].hidden — boolescher Wert, optional, standardmäßig false. Ob die Spalte verborgen bleibt, bis der Leser sie anfordert.
  • collection.sort — Objekt, optional. key, die Spalte, nach der die Zeilen geordnet werden, und ascending, ob die Reihenfolge aufsteigt. Beide erforderlich, sobald das Objekt vorhanden ist.
  • collection.folders — Objekt, optional. Die Wurzel der Ordner, in denen die Dateien gruppiert sind: id, eine Zahl, und name, beide erforderlich; description; created und modified, Zeitpunkte nach ISO 8601; columns, was der Ordner für die Spalten der Sammlung angibt, geschrieben wie bei einer Datei; children, die Ordner, die er enthält, jeder auf dieselbe Weise geschrieben. Zwei gleich nummerierte Ordner, zwei gleich benannte Dinge in einem Ordner, ohne Rücksicht auf Groß- und Kleinschreibung, und ein Name, der kein Dateiname sein kann, werden abgelehnt. Ordner lassen das Dokument als PDF 2.0 schreiben.
  • attachments[].columns — Array, optional. Was eine Datei angibt, ein Eintrag pro Spalte: key und der Wert unter der Art, die diese Spalte enthält — text, date oder number.

Geltungsbereich: das ganze Dokument. attachments trägt die Dateien; dies sagt nur, wie sie angeordnet werden.

Eine vollständige Anfrage, die ein PDF erzeugt

{
  "attachments": [
    {
      "name": "lot_a",
      "file_name": "lot-a.xml",
      "description": "Earthworks and site clearance",
      "media_type": "text/xml",
      "relationship": "source",
      "modified": "2026-07-14T09:30:00+02:00",
      "columns": [
        { "key": "lot", "text": "Earthworks and site clearance" },
        { "key": "sent", "date": "2026-07-14T09:30:00+02:00" },
        { "key": "total", "number": 18400 }
      ]
    }
  ],
  "collection": {
    "view": "rows",
    "opens_on": "lot_a",
    "columns": [
      { "key": "lot", "title": "Lot", "data": "text" },
      { "key": "sent", "title": "Sent", "data": "date" },
      { "key": "total", "title": "Total", "data": "number" },
      { "key": "weight", "title": "Bytes", "data": "size", "hidden": true }
    ],
    "sort": { "key": "sent", "ascending": false }
  },
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 72, "lly": 700, "urx": 523, "ury": 740 },
      "content": ["Tender pack: the lots travel inside this document"],
      "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 Dateien, die das Dokument nennt, ohne sie zu enthalten 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