証明書

証明書は、スレッドのデータから生成される変更不能な PDF です。再利用可能な 証明書フォーム（データ領域を配置した PDF または画像の背景）を一度デザインすれば、そのフォームの要件を満たすデータを持つ任意のスレッドから証明書を生成できます。発行後の証明書は永続的なコピーとなり、その後スレッドやフォームを編集しても、発行済みの PDF が変更されることはありません。

実行できる操作と権限

証明書のプレビュー、事前確認、生成では、表示権限があるフィールド、識別子、画像リソースのみが使用されます。スレッドが共有されていても、その非公開アセットへのアクセス権は付与されません。また、リソースへの参照があるだけでは、そのリソースを埋め込む権限は付与されません。

証明書の一覧、詳細、ダウンロードにも、PDF のファイルプライバシーが適用されます。証明書 ID を知っているだけでは、非公開 PDF へのアクセス権は付与されません。証明書フォームのデザインを扱うには、そのフォームを所有するチームの現在のメンバーである必要があります。

アクセス権は、現在アクティブなチームでのロールに従います。

チーム管理者は、フォームの作成、デザインとフィールドバインドの編集、インポート、アーカイブなど、フォームを管理できます。
すべてのチームメンバーは、フォームを閲覧し、アクティブなフォームを使用してスレッドデータから証明書 PDF を生成できます。

証明書フォーム

サイドバーから 証明書フォーム（/app/certificates/forms）を開きます。フォームは「スレッドデータを生成される証明書 PDF にバインドする、再利用可能なデザイン」です。一覧には各フォームの名前、ステータス、バインド数、最終更新日時が表示されます。アーカイブ済みのフォームを含めるには、アーカイブ済みを表示を使用します。

一覧では、フォームの作成（新規フォーム — 名前を指定し、次にデザインを追加します）、フォームをコピー、以前にエクスポートしたフォーム定義のインポート、フォームのアーカイブまたは復元ができます。フォームのステータスは アクティブまたはアーカイブ済みです。生成時に選択できるのは、アクティブなフォームのみです。

フォームデザイナー

フォームを開くと、証明書フォームデザイナーが起動します。フォームは次の 2 つの要素で構成されます。

デザイン — 証明書の背景として使用する PDF または画像をアップロードします（デザインをアップロード（PDF または画像））。フィールドを配置するには、あらかじめデザインが必要です。後からデザインを置き換えると、配置済みのすべてのフィールドとその位置が削除されます。発行済みの証明書には影響しません。
配置済みフィールド — デザイン上をクリックして配置する領域で、それぞれがデータソースにバインドされます。

デザイン中に実際に近い値を確認するには、デザインの参照対象（「参照対象としてデザイン」）を選択します。実際のプレビューデータを使用する 1 つのスレッド、またはフィールド名のみを使用してバインドの基礎とする 1 つのスレッドテンプレートを選べます。参照対象を切り替えても、配置済みのフィールドが変更されることはありません。

フィールドソース

配置した各領域は、次の 4 種類のソースのいずれかから値を取得します。

スレッドフィールド — デザインの参照対象にしているスレッドまたはテンプレートのフィールドを一覧表示するチップです。すでにフォームに含まれているフィールドには印が付きます。フィールドを再度配置する代わりに、そのフィールド名を既存の領域の別名として追加することもできます。
システムソース — 生成時に DICE が入力する値です。スレッド名、スレッドの説明、スレッドのサムネイル、スレッド UUID、スレッドの識別子、発行日、発行元チーム名、および発行者の名、姓、氏名を使用できます。システムソースはフィールド領域のフォールバックとして追加することもでき、「一致するスレッドフィールドがない場合に順番に使用」されます。
カスタムフィールド — デザインの参照対象にまだ表示されていないデータについて、フィールド名に加えて、任意の別名と種類を入力します。
静的テキスト — 「スレッドから取得せず、記述どおりに印刷される」固定テキストです。

フィールドの種類は、テキスト、数値、日付、ブール値、画像です。領域はプレーンなテキストとして、または QR、Code 128、Code 39、PDF417 のコードとして描画できます。領域には、ミリメートル単位の位置とサイズ、フォント、文字サイズ、色、位置合わせ、回転、不透明度、および日付の場合は日付形式を設定できます。テキスト領域には、太字、斜体、下線のスタイルも設定できます。これらの切り替えは領域全体に適用されます。

どの QR 領域にも中央ロゴを追加できます。領域のプロパティで画像（PNG、JPEG、または WebP）を選択すると、DICE が領域の背景色の余白を付け、コードの中央に画像を重ねて描画します。ロゴのサイズと位置は自動的に設定され、コードをスキャン可能に保つために QR の誤り訂正レベルも引き上げられます。調整が必要な項目はありません。

安定した Vlink QR 領域

証明書に永続的な QR コードが必要な場合は、Vlink URL システムソースを追加します。複数回配置できます。証明書の生成時に、配置ごとに個別の Vlink が割り当てられるため、2 つの QR 領域から異なる宛先に移動させ、後からそれぞれを個別に管理できます。

生成時には、Vlink の配置ごとに設定カードが 1 枚表示されます。各カードでは、スレッドの公開ページを指定するか、カスタム HTTP(S) URL を使用するか、設定せず下書きのままにできます。公開ページが存在する場合はデフォルトで選択されますが、ほかの配置に公開ページを設定する必要はありません。プレビュー用の QR コードはそれぞれを区別できる見本です。永続的な Vlink URL が作成されるのは、生成をクリックしたときだけです。

フィールドの解決方法 — テンプレートではなく名前で照合

フォームはスレッドテンプレートに関連付けられていません。生成時には、各領域のフィールド名と別名が、スレッドのフィールド名に対して大文字と小文字を区別せず照合されます。「Name」、「name」、「NAME」はすべて同じフィールドとして解決されます。どのテンプレートから作成されたスレッドかにかかわらず、フィールド名が一致すれば、そのスレッドでフォームを使用できます。テンプレートを使用せずに作成したスレッドでも同様です。

領域を必須にすると、「この値を解決できない場合は生成がブロック」されます。必須でない領域は、一致するものがなければ空のまま描画されます。

スレッドがデザインの参照対象として選択されている間、プレビューでは解決できない領域にフラグが付きます。理由には、値なし、型の不一致、曖昧、解決不可、コード形式の場合はエンコード不可などがあります。また、「このスレッドに対して解決できない」必須フィールドを一覧表示するバナーも表示されます。

事前確認

スレッドでフォームを選択するたびに、DICE は事前確認を実行します。解決できた必須フィールドの数（「必須フィールド 4 件中 3 件を解決」）と、互換性ありまたは互換性なしという総合判定が表示されます。別名によって満たされたフィールドには、一致した別名が表示されます。生成できるのは、事前確認に合格した場合のみです。

スレッドの証明書を生成する

スレッドを開き、その証明書カード（「このスレッドのデータから生成された変更不能な PDF。」）を見つけます。
証明書を生成をクリックします。ダイアログで証明書フォームを選択するか、**＋このスレッドから新規フォームを作成…**を選択して、このスレッドのフィールドを基にしたフォームを作成します。
選択したフォームについて、このスレッドに対する事前確認の結果を確認します。
必要に応じて証明書名を設定します。これは「証明書一覧に表示され、ダウンロード時のファイル名として使用」され、デフォルトではフォーム名になります。フォームに Vlink QR 領域が含まれている場合は、各宛先を個別に設定します。最初に描画された PDF を確認するには、証明書をプレビューをクリックします。
生成をクリックします。成功すると証明書を発行しましたと表示され、証明書が発行日とともにカードに表示されます。

カードでは、各証明書に対してダウンロード（PDF）と無効とするを実行できます。

一括生成

多数のスレッドに対して同じ証明書を一度に発行するには、次の手順に従います。

スレッド一覧で複数のスレッドを選択し、証明書を生成を選択します。選択したスレッドがキューに追加された状態で、証明書を一括生成（/app/certificates/batch）が開きます。1 回の一括処理は 100 スレッドまでに制限されます。
証明書フォームを選択します。DICE はキュー内のすべてのスレッドを事前確認し、それぞれに準拠、非準拠（不足しているフィールドの一覧を含む）、または表示不可（この参照範囲ではそのスレッドを表示できない）のラベルを付けます。スレッドデータを修正した後は、再確認アクションを使用します。
準拠している N 件を発行をクリックします。証明書は「1 件ずつ発行」され、各行の状態が発行中…から発行済みまたは失敗へ移行します。
その後、失敗した項目には失敗した N 件を再試行を使用し、行を取り除くには一括処理から取り除くを使用します。実行記録を保存するにはCSV をエクスポートを使用します。

証明書を無効にする

発行済みの証明書は編集も削除もできませんが、無効とすることができます。「無効とすると、その証明書は信頼の根拠として使用できないことを示す状態になります。PDF とそのハッシュは変更されません。」

スレッドの証明書カードで、対象の証明書の横にある無効とするをクリックします。
理由として、誤って発行、スレッドデータが不正確、フォームが間違っている、証明書が重複、またはその他を選択します。
必要に応じて**内部メモ（非公開）**を追加し、無効とするで確定します。

無効にした証明書は無効と表示されたまま一覧に残り、記録用として引き続きダウンロードできます。

フォームのライフサイクルに関するヒント

アーカイブすると、そのフォームから発行済みの証明書に影響を与えることなく、フォームの使用を終了できます。復元すると再び使用可能になります。アーカイブ済みのフォームは生成ダイアログに表示されません。
フォームをコピーすると、デザインとバインドを含むフォームが複製されるため、元のフォームに影響を与えずに変更を重ねられます。
デザイナーからフォームをエクスポートし、フォーム一覧からインポートすると、デザインをチーム間で移動できます。フォームをエクスポートするには、デザインと名前が必要です。

スレッド — 証明書の生成元となるデータ
はじめに — 新規ユーザー向けの概要
FAQ — モジュールの利用可否とトラブルシューティング

ドキュメントの問題を報告