Zertifikate

Zertifikate sind unveränderliche PDFs, die aus den Daten eines Datensatzes erstellt werden. Sie entwerfen einmal ein wiederverwendbares Zertifikatsformular – einen PDF- oder Bildhintergrund mit platzierten Datenbereichen – und erstellen daraus anschließend Zertifikate für jeden Datensatz, dessen Daten die Anforderungen des Formulars erfüllen. Nach der Ausstellung ist ein Zertifikat eine dauerhafte Kopie: Wenn Sie den Datensatz oder das Formular später bearbeiten, ändert sich ein bereits ausgestelltes PDF niemals.

Wer was tun kann

Für Zertifikatsvorschauen, Vorabprüfungen und die Erstellung werden ausschließlich Felder, Kennungen und Bildressourcen verwendet, die Sie anzeigen dürfen. Ein freigegebener Datensatz gewährt keinen Zugriff auf seine privaten Assets, und der Verweis auf eine Ressource allein erteilt keine Berechtigung, sie einzubetten.

Zertifikatslisten, Details und Downloads berücksichtigen außerdem den Dateidatenschutz des PDFs. Die Kenntnis einer Zertifikat-ID gewährt keinen Zugriff auf ein privates PDF. Für den Zugriff auf die Designs von Zertifikatsformularen ist eine aktuelle Mitgliedschaft im Team erforderlich, dem sie gehören.

Der Zugriff richtet sich nach Ihrer Rolle im aktiven Team:

Teamadministratoren verwalten Formulare: Sie erstellen sie, bearbeiten das Design und die Feldbindungen, importieren sie und archivieren sie.
Alle Teammitglieder können Formulare durchsuchen und aktive Formulare verwenden, um Zertifikats-PDFs aus Datensatzdaten zu erstellen.

Zertifikatsformulare

Öffnen Sie Zertifikatsformulare über die Seitenleiste (/app/certificates/forms). Formulare sind „wiederverwendbare Designs, die Datensatzdaten in erstellte Zertifikats-PDFs einbinden“. Die Liste zeigt den Namen, Status, die Anzahl der Bindungen und die letzte Aktualisierung jedes Formulars an. Verwenden Sie Archivierte anzeigen, um archivierte Formulare einzubeziehen.

In der Liste können Sie ein Formular erstellen (Neues Formular – geben Sie ihm einen Namen; das Design fügen Sie anschließend hinzu), ein Formular kopieren, eine zuvor exportierte Formulardefinition Importieren sowie ein Formular Archivieren oder Wiederherstellen. Der Status eines Formulars lautet entweder Aktiv oder Archiviert – bei der Erstellung werden nur aktive Formulare angeboten.

Der Formulardesigner

Wenn Sie ein Formular öffnen, wird der Designer für Zertifikatsformulare gestartet. Ein Formular besteht aus zwei Komponenten:

Ein Design – laden Sie ein PDF oder Bild hoch (Design hochladen (PDF oder Bild)), das als Hintergrund des Zertifikats verwendet werden soll. Ein Design ist erforderlich, bevor Sie Felder platzieren können. Wenn Sie das Design später ersetzen, werden alle platzierten Felder und ihre Positionen entfernt; bereits ausgestellte Zertifikate bleiben davon unberührt.
Platzierte Felder – Bereiche, die Sie durch Klicken auf dem Design platzieren und jeweils mit einer Datenquelle verknüpfen.

Um beim Entwerfen realistische Werte anzuzeigen, wählen Sie einen Designkontext („Entwerfen anhand von“): entweder einen Datensatz (echte Vorschaudaten) oder eine Datensatzvorlage (nur Feldnamen), aus dem bzw. der Bindungen übernommen werden. Beim Wechseln des Kontexts werden bereits platzierte Felder niemals verändert.

Feldquellen

Jeder platzierte Bereich bezieht seinen Wert aus einer von vier Quellen:

Datensatzfelder – Chips, die die Felder des Datensatzes oder der Vorlage auflisten, anhand dessen bzw. derer Sie das Design erstellen. Bereits vom Formular abgedeckte Felder sind gekennzeichnet. Sie können einen Feldnamen als Alias zu einem vorhandenen Bereich hinzufügen, anstatt ihn erneut zu platzieren.
Systemquellen – Werte, die DICE bei der Erstellung einsetzt: Datensatzname, Datensatzbeschreibung, Datensatz-Miniaturbild, Datensatz-UUID, Datensatzkennungen, Ausstellungsdatum, Name des ausstellenden Teams sowie Vorname, Familienname und vollständiger Name der ausstellenden Person. Systemquellen können einem Feldbereich auch als Rückfallwerte zugewiesen werden, die „der Reihe nach verwendet werden, wenn kein Datensatzfeld übereinstimmt“.
Benutzerdefiniertes Feld – geben Sie einen Feldnamen (sowie optional Aliasse und eine Art) für Daten ein, die im Designkontext noch nicht angezeigt werden.
Statischer Text – wörtlicher Text, der „genau wie eingegeben gedruckt und nicht aus dem Datensatz übernommen wird“.

Die Feldarten sind Text, Zahl, Datum, Boolesch und Bild. Ein Bereich kann als einfacher Text oder als Code dargestellt werden: QR, Code 128, Code 39 oder PDF417. Bereiche verfügen über Position und Größe in Millimetern, Schriftart, Schriftgröße, Farbe, Ausrichtung, Drehung und Deckkraft sowie bei Datumsangaben über ein Datumsformat. Textbereiche unterstützen außerdem die Formatierungen Fett, Kursiv und Unterstrichen – die Umschalter gelten für den gesamten Bereich.

Jeder QR-Bereich kann ein zentriertes Logo enthalten: Wählen Sie in den Eigenschaften des Bereichs ein Bild (PNG, JPEG oder WebP) aus, und DICE zeichnet es auf einer Fläche in der Hintergrundfarbe des Bereichs über die Mitte des Codes. Größe und Platzierung des Logos werden automatisch festgelegt, und die Fehlerkorrektur des QR-Codes wird erhöht, damit der Code scanbar bleibt – Sie müssen nichts konfigurieren.

Stabile Vlink-QR-Bereiche

Fügen Sie die Systemquelle Vlink-URL hinzu, wenn ein Zertifikat einen dauerhaften QR-Code benötigt. Sie können sie mehrmals platzieren. Jede Platzierung erhält bei der Erstellung des Zertifikats einen eigenen Vlink, sodass zwei QR- Bereiche zu unterschiedlichen Zielen führen und anschließend unabhängig voneinander verwaltet werden können.

Während der Erstellung zeigt DICE für jede Vlink-Platzierung eine Konfigurationskarte an. Jede Karte kann auf die Öffentliche Seite des Datensatzes verweisen, eine benutzerdefinierte HTTP(S)-URL verwenden oder als Entwurf unkonfiguriert bleiben. Die Öffentliche Seite ist standardmäßig ausgewählt, sofern eine vorhanden ist, für die anderen Platzierungen ist sie jedoch nicht erforderlich. Die QR-Codes in der Vorschau sind repräsentativ und unterscheiden sich voneinander; ihre dauerhaften Vlink-URLs werden erst erstellt, wenn Sie auf Erstellen klicken.

Wie Felder aufgelöst werden – nach Namen, nicht nach Vorlage

Ein Formular ist nicht an eine Datensatzvorlage gebunden. Bei der Erstellung werden der Feldname und die Aliasse jedes Bereichs ohne Berücksichtigung der Groß-/Kleinschreibung mit den Feldnamen des Datensatzes abgeglichen – „Name“, „name“ und „NAME“ werden alle als dasselbe Feld aufgelöst. Jeder Datensatz mit übereinstimmenden Feldnamen kann das Formular verwenden, unabhängig davon, mit welcher Vorlage er gegebenenfalls erstellt wurde.

Wenn Sie einen Bereich als Erforderlich markieren, „wird die Erstellung blockiert, wenn dieser Wert nicht aufgelöst werden kann“. Nicht erforderliche Bereiche werden einfach leer dargestellt, wenn keine Übereinstimmung gefunden wird.

Wenn ein Datensatz als Designkontext ausgewählt ist, kennzeichnet die Vorschau Bereiche, die nicht aufgelöst werden können, mit Gründen wie kein Wert, Typkonflikt, mehrdeutig, nicht auflösbar oder nicht codierbar (bei Codeformaten). Außerdem wird ein Banner mit den erforderlichen Feldern angezeigt, die „für diesen Datensatz nicht aufgelöst werden können“.

Vorabprüfung

Wann immer Sie ein Formular für einen Datensatz auswählen, führt DICE eine Vorabprüfung durch: Sie gibt an, wie viele erforderliche Felder aufgelöst werden („3/4 erforderlichen Feldern werden aufgelöst“), und liefert als Gesamtbewertung Kompatibel oder Nicht kompatibel. Felder, die über einen Alias erfüllt werden, sind mit dem übereinstimmenden Alias gekennzeichnet. Die Erstellung ist nur zulässig, wenn die Vorabprüfung erfolgreich ist.

Ein Zertifikat für einen Datensatz erstellen

Öffnen Sie den Datensatz und suchen Sie die Karte Zertifikate („Unveränderliche PDFs, die aus den Daten dieses Datensatzes erstellt wurden.“).
Klicken Sie auf Zertifikat erstellen. Wählen Sie im Dialogfeld ein Zertifikatsformular aus – oder wählen Sie ＋ Neues Formular aus diesem Datensatz…, um ein Formular zu erstellen, das mit den Feldern dieses Datensatzes vorausgefüllt ist.
Prüfen Sie das Ergebnis der Vorabprüfung des ausgewählten Formulars für diesen Datensatz.
Legen Sie optional einen Zertifikatsnamen fest – er wird „in der Zertifikatsliste angezeigt und als Dateiname für den Download verwendet“ und entspricht standardmäßig dem Formularnamen. Wenn das Formular Vlink-QR-Bereiche enthält, konfigurieren Sie jedes Ziel unabhängig. Klicken Sie auf Zertifikatsvorschau, um zunächst das gerenderte PDF zu prüfen.
Klicken Sie auf Erstellen. Bei erfolgreicher Erstellung wird Zertifikat ausgestellt angezeigt, und das Zertifikat erscheint mit seinem Ausstellungsdatum auf der Karte.

Auf der Karte bietet jedes Zertifikat die Optionen Herunterladen (das PDF) und Ungültig machen.

Stapelerstellung

So stellen Sie dasselbe Zertifikat gleichzeitig für mehrere Datensätze aus:

Wählen Sie in der Liste Datensätze mehrere Datensätze aus und wählen Sie Zertifikate erstellen. Dadurch wird Zertifikate stapelweise erstellen (/app/certificates/batch) geöffnet und Ihre Auswahl in die Warteschlange gestellt. Ein Stapel ist auf 100 Datensätze begrenzt.
Wählen Sie ein Zertifikatsformular aus. DICE führt für jeden Datensatz in der Warteschlange eine Vorabprüfung durch und kennzeichnet ihn als Konform, Nicht konform (mit einer Liste der fehlenden Felder) oder Nicht anzeigbar (Sie können diesen Datensatz in diesem Kontext nicht anzeigen). Verwenden Sie nach der Korrektur der Datensatzdaten die Aktion zur erneuten Prüfung.
Klicken Sie auf N konforme ausstellen. Zertifikate werden „einzeln nacheinander ausgestellt“; jede Zeile durchläuft Wird ausgestellt… → Ausgestellt oder Fehlgeschlagen.
Verwenden Sie anschließend N fehlgeschlagene erneut versuchen für fehlgeschlagene Vorgänge, entfernen Sie Zeilen mit Aus Stapel entfernen und verwenden Sie CSV exportieren, um eine Aufzeichnung des Laufs zu erhalten.

Ein Zertifikat ungültig machen

Ausgestellte Zertifikate können weder bearbeitet noch gelöscht werden – sie können ungültig gemacht werden. „Durch das Ungültigmachen wird das Zertifikat als nicht mehr verlässlich gültig gekennzeichnet. Das PDF und sein Hash bleiben unverändert.“

Klicken Sie auf der Karte „Zertifikate“ des Datensatzes neben dem Zertifikat auf Ungültig machen.
Wählen Sie einen Grund: Irrtümlich ausgestellt, Falsche Datensatzdaten, Falsches Formular, Doppeltes Zertifikat oder Sonstiges.
Fügen Sie optional eine Interne Notiz (privat) hinzu und bestätigen Sie anschließend mit Ungültig machen.

Ungültig gemachte Zertifikate bleiben in der Liste mit der Kennzeichnung Ungültig erhalten und können weiterhin für Ihre Unterlagen heruntergeladen werden.

Tipps zum Lebenszyklus von Formularen

Mit Archivieren wird ein Formular außer Betrieb genommen, ohne dass bereits daraus ausgestellte Zertifikate verändert werden; mit Wiederherstellen wird es wieder verfügbar. Archivierte Formulare werden im Erstellungsdialog nicht angezeigt.
Mit Formular kopieren wird ein Formular einschließlich seines Designs und seiner Bindungen dupliziert, sodass Sie es weiterentwickeln können, ohne das Original zu verändern.
Exportieren Sie ein Formular im Designer und Importieren Sie es aus der Formularliste, um ein Design zwischen Teams zu übertragen – ein Formular benötigt ein Design und einen Namen, bevor es exportiert werden kann.

Datensätze – die Daten, aus denen Zertifikate erstellt werden
Erste Schritte – Orientierung für neue Benutzer
FAQ – Modulverfügbarkeit und Fehlerbehebung

Ein Problem mit der Dokumentation melden