Certyfikaty

Certyfikaty to niezmienne pliki PDF generowane z danych rekordu. Jednorazowo projektujesz formularz certyfikatu wielokrotnego użytku — tło w postaci pliku PDF lub obrazu z rozmieszczonymi strefami danych — a następnie generujesz na jego podstawie certyfikaty dla każdego rekordu, którego dane spełniają wymagania formularza. Wystawiony certyfikat jest trwałą kopią: późniejsza edycja rekordu lub formularza nigdy nie zmienia już wystawionego pliku PDF.

Kto może co robić

Podglądy, kontrola wstępna i generowanie certyfikatów korzystają wyłącznie z pól, identyfikatorów i zasobów graficznych, które masz uprawnienia wyświetlać. Udostępniony rekord nie daje dostępu do swoich prywatnych elementów, a samo odwołanie do zasobu nie daje uprawnienia do jego osadzenia.

Listy, szczegóły i pobieranie certyfikatów również uwzględniają prywatność pliku PDF. Znajomość ID certyfikatu nie daje dostępu do prywatnego pliku PDF. Projekty formularzy certyfikatów wymagają bieżącego członkostwa w zespole, który jest ich właścicielem.

Dostęp zależy od twojej roli w aktywnym zespole:

Administratorzy zespołu zarządzają formularzami: tworzą je, edytują projekt i powiązania pól, importują je i archiwizują.
Wszyscy członkowie zespołu mogą przeglądać formularze i używać aktywnych formularzy do generowania certyfikatów PDF z danych rekordów.

Formularze certyfikatów

Otwórz Formularze certyfikatów z paska bocznego (/app/certificates/forms). Formularze to „projekty wielokrotnego użytku, które powiązują dane rekordów z generowanymi plikami PDF certyfikatów”. Lista pokazuje nazwę, stan, liczbę powiązań i datę ostatniej aktualizacji każdego formularza; użyj opcji Pokaż zarchiwizowane, aby uwzględnić zarchiwizowane formularze.

Z poziomu listy możesz utworzyć formularz (Nowy formularz — nadaj mu nazwę; projekt dodasz w następnym kroku), użyć opcji Kopiuj formularz, zaimportować (Importuj) wcześniej wyeksportowaną definicję formularza oraz zarchiwizować (Archiwizuj) lub przywrócić (Przywróć) formularz. Formularz ma stan Aktywny lub Zarchiwizowany — podczas generowania dostępne są tylko formularze aktywne.

Edytor formularza

Otwarcie formularza uruchamia Edytor formularzy certyfikatów. Formularz składa się z dwóch elementów:

Projekt — prześlij plik PDF lub obraz (Prześlij projekt (PDF lub obraz)), który posłuży jako tło certyfikatu. Projekt jest wymagany, zanim będzie można rozmieszczać pola. Późniejsza zamiana projektu usuwa wszystkie rozmieszczone pola i ich położenia; nie ma to wpływu na już wystawione certyfikaty.
Rozmieszczone pola — strefy, które umieszczasz na projekcie kliknięciem, każda powiązana ze źródłem danych.

Aby podczas projektowania widzieć realistyczne wartości, wybierz Kontekst projektu: jeden rekord (rzeczywiste dane podglądu) lub jeden szablon rekordu (tylko nazwy pól), z którego zostaną utworzone początkowe powiązania. Zmiana kontekstu nigdy nie zmienia już rozmieszczonych pól.

Źródła pól

Każda rozmieszczona strefa odczytuje swoją wartość z jednego z czterech źródeł:

Pola rekordu — elementy z listą pól rekordu lub szablonu, na podstawie którego projektujesz. Pola już objęte formularzem są oznaczone; nazwę pola możesz dodać jako alias do istniejącej strefy, zamiast umieszczać je ponownie.
Źródła systemowe — wartości uzupełniane przez DICE w chwili generowania: Nazwa rekordu, Opis rekordu, Miniatura rekordu, UUID rekordu, Identyfikatory rekordu, Data wystawienia, Nazwa zespołu wystawiającego oraz imię, nazwisko i pełne imię i nazwisko wystawcy. Źródła systemowe można też dołączyć do strefy pola jako wartości zastępcze, „używane po kolei, gdy żadne pole rekordu nie pasuje”.
Pole niestandardowe — wpisz nazwę pola (oraz opcjonalne aliasy i rodzaj) dla danych, których kontekst projektu jeszcze nie pokazuje.
Tekst stały — dosłowny tekst „drukowany dokładnie tak, jak został wpisany — nie jest odczytywany z rekordu”.

Rodzaje pól to Tekst, Liczba, Data, Wartość logiczna i Obraz, a strefa może być renderowana jako zwykły Tekst albo jako kod: QR, Code 128, Code 39 lub PDF417. Strefy mają położenie i rozmiar w milimetrach, czcionkę, rozmiar czcionki, kolor, wyrównanie, obrót, krycie oraz (w przypadku dat) format daty. W strefach tekstowych można też zastosować pogrubienie, kursywę i podkreślenie — przełączniki dotyczą całej strefy.

Każda strefa QR może zawierać logo pośrodku: wybierz obraz (PNG, JPEG lub WebP) we właściwościach strefy, a DICE narysuje go na środku kodu, na podkładce w kolorze tła strefy. Rozmiar i położenie logo są ustalane automatycznie, a poziom korekcji błędów kodu QR rośnie, aby kod nadal dało się zeskanować — nie trzeba niczego dostrajać.

Stabilne strefy QR z Vlinkiem

Dodaj źródło systemowe URL Vlinku, gdy certyfikat potrzebuje trwałego kodu QR. Możesz umieścić je więcej niż raz. Każde umieszczenie otrzymuje własny Vlink w chwili generowania certyfikatu, dzięki czemu dwie strefy QR mogą prowadzić do różnych miejsc docelowych i być później zarządzane niezależnie.

Podczas generowania DICE wyświetla jedną kartę konfiguracji dla każdego umieszczenia Vlinku. Każda karta może wskazywać stronę publiczną rekordu, używać niestandardowego adresu URL HTTP(S) albo pozostać nieskonfigurowana jako szkic. Strona publiczna jest wybrana domyślnie, jeśli istnieje, ale nie jest wymagana dla pozostałych umieszczeń. Kody QR w podglądzie są poglądowe i różne od siebie; ich trwałe adresy URL Vlinków są tworzone dopiero wtedy, gdy klikniesz Wygeneruj.

Jak rozwiązywane są pola — według nazwy, nie według szablonu

Formularz nie jest powiązany z szablonem rekordu. W chwili generowania nazwa pola i aliasy każdej strefy są porównywane z nazwami pól rekordu bez rozróżniania wielkości liter — „Nazwa”, „nazwa” i „NAZWA” wskazują to samo pole. Formularza może użyć każdy rekord, którego nazwy pól pasują, niezależnie od tego, z jakiego szablonu (jeśli w ogóle) go utworzono.

Zaznaczenie strefy jako Wymagane „blokuje generowanie, gdy nie można rozwiązać tej wartości”. Strefy niewymagane są po prostu renderowane jako puste, gdy nic nie pasuje.

Gdy jako kontekst projektu wybrany jest rekord, podgląd oznacza strefy, których nie można rozwiązać, podając przyczyny takie jak brak wartości, niezgodność typu, niejednoznaczne, nie zostanie rozwiązane lub nie zostanie zakodowane (w przypadku formatów kodów), a baner wymienia wymagane pola, których „nie można rozwiązać dla tego rekordu”.

Kontrola wstępna

Za każdym razem, gdy wybierasz formularz dla rekordu, DICE przeprowadza kontrolę wstępną: podaje, ile wymaganych pól udało się rozwiązać („Rozwiązane wymagane pola: 3/4”), oraz ogólny wynik Zgodny lub Niezgodny. Pola spełnione za pomocą aliasu są oznaczone aliasem, który pasował. Generowanie jest możliwe tylko wtedy, gdy kontrola wstępna zakończy się powodzeniem.

Generowanie certyfikatu dla rekordu

Otwórz rekord i znajdź jego kartę Certyfikaty („Niezmienne pliki PDF wygenerowane z danych tego rekordu”).
Kliknij Wygeneruj certyfikat. W oknie dialogowym wybierz Formularz certyfikatu — lub wybierz ＋ Nowy formularz na podstawie tego rekordu…, aby utworzyć formularz wstępnie wypełniony polami tego rekordu.
Przejrzyj wynik kontroli wstępnej wybranego formularza dla tego rekordu.
Opcjonalnie ustaw Nazwę certyfikatu — jest ona „wyświetlana na liście certyfikatów i używana jako nazwa pobieranego pliku”, a domyślnie odpowiada nazwie formularza. Jeśli formularz zawiera strefy QR z Vlinkiem, skonfiguruj każde miejsce docelowe niezależnie. Kliknij Podgląd certyfikatu, aby najpierw obejrzeć wyrenderowany plik PDF.
Kliknij Wygeneruj. Po pomyślnym zakończeniu zobaczysz komunikat Wystawiono certyfikat, a certyfikat pojawi się na karcie wraz z datą wystawienia.

Na karcie każdy certyfikat oferuje opcje Pobierz (plik PDF) i Unieważnij.

Generowanie wsadowe

Aby wystawić ten sam certyfikat dla wielu rekordów naraz:

Na liście rekordów zaznacz wiele rekordów i wybierz Wygeneruj certyfikaty. Otworzy się strona Wsadowe generowanie certyfikatów (/app/certificates/batch) z zaznaczonymi rekordami w kolejce. Partia może obejmować maksymalnie 100 rekordów.
Wybierz formularz certyfikatu. DICE przeprowadza kontrolę wstępną każdego rekordu w kolejce i oznacza go jako Zgodny, Niezgodny (z listą brakujących pól) lub Brak dostępu (nie możesz wyświetlić tego rekordu w tym kontekście). Po poprawieniu danych rekordu użyj działania ponownego sprawdzenia.
Kliknij Wystaw zgodne (N). Certyfikaty są „wystawiane pojedynczo”; każdy wiersz przechodzi przez stan Wystawianie… → Wystawiony lub Niepowodzenie.
Następnie użyj opcji Ponów nieudane (N) dla niepowodzeń, usuń wiersze za pomocą opcji Usuń z partii i użyj opcji Eksportuj CSV, aby zachować zapis przebiegu.

Unieważnianie certyfikatu

Wystawionych certyfikatów nie można edytować ani usuwać — można je unieważnić. „Unieważnienie oznacza, że na certyfikacie nie można już polegać. Plik PDF i jego skrót pozostają bez zmian”.

Na karcie Certyfikaty rekordu kliknij Unieważnij obok certyfikatu.
Wybierz Powód: Wystawiony omyłkowo, Nieprawidłowe dane rekordu, Niewłaściwy formularz, Zduplikowany certyfikat lub Inny.
Opcjonalnie dodaj Notatkę wewnętrzną (prywatną), a następnie potwierdź, klikając Unieważnij.

Unieważnione certyfikaty pozostają na liście ze stanem Unieważniony i nadal można je pobrać do własnej dokumentacji.

Wskazówki dotyczące cyklu życia formularza

Archiwizuj wycofuje formularz z użycia bez wpływu na wystawione już na jego podstawie certyfikaty; Przywróć przywraca go. Zarchiwizowane formularze nie pojawiają się w oknie dialogowym generowania.
Kopiuj formularz tworzy duplikat formularza (wraz z projektem i powiązaniami), dzięki czemu możesz wprowadzać zmiany bez naruszania oryginału.
Eksportuj formularz w edytorze i Importuj go na liście formularzy, aby przenieść projekt między zespołami — formularz musi mieć projekt i nazwę, zanim będzie można go wyeksportować.

Rekordy — dane, z których generowane są certyfikaty
Pierwsze kroki — wprowadzenie dla nowych użytkowników
FAQ — dostępność modułów i rozwiązywanie problemów

Pomoc techniczna i zgłoszenia Zgłoś problem z dokumentacją