PDF の生成
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Sitecore Content Hub を使用することにより、エンティティのリストから PDF ファイルを生成できます。
次の手順では、アプリケーションの PDF の生成機能を設定する方法について説明します。
- 印刷テンプレート エンティティ (ZIP ファイル) を作成する。
- 印刷エンティティの生成アクションを作成する。
- ページ コンポーネントを設定して、** PDF の生成**アクションを追加する。
印刷テンプレート エンティティを作成する
印刷テンプレート エンティティを作成する
印刷テンプレート エンティティは、PDF ファイルの構造を定義する「.cshtml」、「.json」、および「.css」ファイルを含む ZIP パッケージです。
次の手順では、印刷テンプレート エンティティを作成する方法について説明します。
- [管理] に移動し、[印刷テンプレート] を選択します。
- [新しい印刷テンプレート] ボタンをクリックします。
- テンプレート作成ウィンドウに、名前、ターゲット定義、ある場合はカスタム プロパティを入力します。 [作成] をクリックします。
- [印刷テンプレート] パッケージをアップロードして確認します。
[!注]
- ターゲット定義は、PDF ファイルに配置されるエンティティの定義です。
- カスタム プロパティは、PDF ファイルの生成時にユーザーが入力する必要のあるプロパティです。
- 上記の設定は、エンティティ管理ページを使用して行うこともできます (Manage>Entities>PrintEntityGenerationTemplate)。
印刷テンプレート エンティティを作成した後でも、ZIP パッケージは [ポータル アセット] の管理ページを使用して更新できます。
[!注] 印刷テンプレートの詳細については、印刷テンプレート セクションを参照してください。
印刷エンティティの生成アクションを作成する
印刷エンティティの生成アクションを作成する
印刷テンプレート エンティティを作成したら、次の手順に従って印刷エンティティの生成アクションを作成する必要があります。
- [管理] に移動し、[アクション] を選択します。
- [新しいアクション] ボタンをクリックします。
- 次の情報を入力します。
- 名前: アクションの名前。
- タイプ: 出力エンティティ生成。
- 定義: PDF 生成のターゲット定義。
- テンプレート: 前のセクションで作成した印刷テンプレート エンティティ。
- [保存] をクリックします。
[!注]
- ターゲット定義は、PDF ファイルに配置されるエンティティの定義です。
定義が選択されると、[印刷テンプレート] ドロップダウン メニューに、選択したターゲット定義に対応する印刷テンプレートが読み込まれます。
[!注] 印刷エンティティ生成アクションの詳細については、印刷エンティティ生成アクション セクションを参照してください。
PDF の生成操作を設定する
PDF の生成操作を設定する
印刷テンプレート エンティティと印刷エンティティ生成アクションを作成したら、PDF の生成操作を設定する必要があります。
複数のページのコンポーネントの PDF の生成操作を設定することが可能です。 この例では、[アセットの詳細] ページのエンティティの操作コンポーネントに操作を追加します。
- [管理] に移動し、[ページ] を選択します。
- [アセットの詳細] ページに移動し、[エンティティ操作] コンポーネントを編集します。
- コンポーネントの操作に [PDF の生成] 操作を追加します。
- [PDF の生成] 操作と、前のセクションで作成した [印刷エンティティの生成] アクションをリンクします。
-
ダウンロードの品質を高めるには、[高解像度] ボタンをオンにします。
[!注] 高解像度でのダウンロード オプションが機能するためには、印刷テンプレート パッケージの中の
asset.jsonファイルに以下が含まれる必要があります。"highRes": { "property": "Renditions", "rendition": "thumbnail" } -
変更を保存します。
PDF の生成操作をテストする
PDF の生成操作をテストする
[PDF の生成] 操作をテストする
- 操作が設定されているページ (この場合は、[アセットの詳細] ページ) に移動します。
- [PDF の生成] ボタンをクリックしてください。
- 印刷テンプレート エンティティの設定に従って、追加のプロパティの値を入力します。
- 印刷エンティティ生成ジョブが終了するのを待ってから、生成された PDF ファイルを [ダウンロード] ページからダウンロードします。