Skip to main content

Eine klassenspezifische Druckvorlage erstellen

Sie können klassenspezifische Druckvorlagen erstellen und für den PDF-Druck von Assets bereitstellen. Dadurch stehen für jeden Einsatzbereich verschiedene Druckvorlagen mit spezifischen Asset-Informationen und in unterschiedlichen Seitenformaten zur Verfügung, z. B. Etiketten, Türschilder, Serviceverträge für Kunden u.a.m.

pdf-druck_klassenspezifisches-asset.png

Abb.: Klassenspezifisches PDF für die Asset-Klasse Computer

Wichtig

Für das Erstellen einer Druckvorlage bis zur Bereitstellung des PDF benötigen Sie grundlegendes Wissen über die jeweiligen Objekte (z.B. Ticket, Asset, Artikel, Kontakt usw.) sowie ausreichend Kenntnisse in JSON, SQL und HTML/CSS.

Grundlegende Informationen zu Druckvorlagen für den PDF-Druck finden Sie unter: Konfiguration von Druckvorlagen

Löst ein Agent mittels Schaltfläche Drucken, den PDF-Druck für ein Asset aus, wird die für die Assetklasse spezifische Druckvorlage verwendet. Dazu muss der Name der Druckvorlage identisch mit dem Namen der Assetklasse sein. Nur so kann die Zuordnung einer Vorlage zur entsprechenden Assetklasse erfolgen.

pdf-druck_asset_klassenspezifisches-template.png

Abb.: Spezifische Vorlage für die Assetklasse "Raum"

Druckvorlagen, die keiner Assetklasse zugeordnet werden können, stehen für alle Assetklassen zur Verfügung. Sie können dazu der Druckvorlage einen Namen vergeben, der nicht gleichlautend mit einer Assetklasse ist.

Agenten von KIX Pro können nach Klick auf die Schaltfläche Drucken auswählen, welche Druckvorlage Sie verwenden möchten. Geben Sie daher der Druckvorlage einen sinnvollen Namen, um die Auswahl der richtigen Vorlage zu erleichtern!

asset-drucken_template-auswahl.png

Abb.: Auswahl der Druckvorlage für den PDF-Druck von Assets

Wenn Sie (klassenspezifische) Druckvorlagen integriert haben, können Sie in der Konfiguration der Macro Action "Konvertieren zu PDF" und im Konsolenkommando Console::Command::Admin::HTMLToPDF::Convert zusätzlich aus diesen Vorlagen auswählen.

Enthält die Druckvorlage Parameter, welche von der aufrufenden Assetklasse nicht geliefert werden können, so bleiben die entsprechenden Felder im PDF leer.

Existieren keine klassenspezifischen Druckvorlagen, dann wird die initiale Standardvorlage für den Asset-Druck verwendet (Name der Standardvorlage: Asset).

Hinweis

Die Macro Action "Konvertieren zu PDF" verwendet den Default nicht. Dort muss zwingend ein Template angegeben werden.

  1. Navigieren Sie zu Menü System > Konsole

  2. Wählen Sie den Konsolenbefehl Console::Command::Admin::HTMLToPDF::Inspect aus.

    (s. auch: Verwendung der Konsole‌)

  3. Setzen Sie als Parameter den Namen der Vorlage: --name Asset

    Optional: Wenn Sie die Struktur einer anderen (spezifischen) Vorlage einsehen möchten, geben Sie deren Namen an.

  4. Klicken Sie auf Ausführen, um den Befehl zu starten.

    In der Konsole wird die Struktur der Vorlage im PEARL-Format angezeigt.

  5. Kopieren Sie den Codeblock 'content' => {...} in einen Texteditor

    Der content dient Ihnen als Grundlage für das Erstellen Ihrer Druckvorlage. Er enthält die im PDF anzuzeigenden Inhalte sowie die Struktur der Vorlage im PERL-Format. Für den Import benötigen Sie jedoch ein valides JSON. Somit müssen Sie den Code entsprechend anpassen (z. B. => durch : und ' durch " ersetzen).

    Sie können den Code auch nutzen, um sich an dessen Struktur zu orientieren, wenn Sie das JSON für die Druckvorlage selbst erstellen.

  6. Bearbeiten Sie den Code, um ein valides JSON zu erstellen und um die Druckvorlage nach Wunsch zu gestalten.

    Orientieren Sie sich dabei an der Der Aufbau einer Druckvorlage sowie an den Bausteine.

Die Vorlage ist nun erstellt und kann in die KIX Datenbank importiert werden. Gehen Sie dazu vor, wie unter Eine Druckvorlage importieren beschrieben.

In diesem Abschnitt: