設計ガイド
設計ガイド
Ragic ではレコードをカスタム PDF、Word、PNG フォーマットにエクスポートすることができます。例えば、「販売注文」を会社が通常使用する PDF フォーマットにエクスポートします。
リストページまたはフォームページで、ツールからカスタム印刷レポートを選択します。
または、レポート作成からカスタム印刷レポートを選択します。
このページが表示されます。
以下の手順に従ってテンプレートを作成してください。
注意： SYSAdmin のみが、カスタム印刷レポートテンプレートの作成および設定を行うことができます。
1. テンプレートの確認
最初に、システムはWordテンプレートを既にお持ちかどうか確認します。
テンプレートをお持ちの場合は、「はい、自分のWordファイルをテンプレートとしてアップロードしたい」を選択します。 テンプレートをお持ちでない場合は、「 いいえ、修正用にデフォルトのテンプレートを提供してください」を選択してください。
2. テンプレートのダウンロード
「いいえ、修正用にデフォルトのテンプレートを提供してください」を選択すると、以下のページが表示されます。「ダウンロード」をクリックしてデフォルトテンプレートをダウンロードしてください。
備考： 現在、初期状態で用意されているのはWordテンプレートのみです。これをベースとして編集し、好みのレポートレイアウトやファイル形式（たとえば Excel や PowerPoint）に調整できます。ダウンロードした Word テンプレートは、パソコン上で編集して保存すると、その内容がオンラインのカスタム印刷レポートのプレビューに自動的に反映されるため、手動で再アップロードする必要はありません。Excel または PowerPoint 形式で出力したい場合は、それぞれ対応する Excel テンプレートまたは PowerPoint テンプレートを別途アップロードしてください。
3. テンプレートの編集
次に、テンプレートを希望するレイアウトに合わせて編集し、必要に応じてフィールドの追加・削除や、Excel 形式・PowerPoint 形式への変換を行えます。編集時の注意事項については、こちらのセクションをご参照ください。
Word テンプレート
Excel テンプレート
PowerPoint テンプレート
一般的なフィールドパラメータについては、テンプレートアップロードページにあるフィールド値構文リファレンスをご参照ください。個別のパラメータ、特殊な書式設定、または関連する使用例については、こちらのセクションをご参照ください。
フィールドの構文をクリックすると、そのパラメータがコピーされ、テンプレートにすばやく貼り付けることができます。
注意： 独立フィールドと子テーブルフィールドでは構文が異なります。
独立フィールド:
子テーブル： 下記の図にある構文を参照し、[i] 行と [i+1] 行のみを追加してください。[i+1] 行には、1つのフィールドの構文を記入するだけで、その行全体のデータを表すことになります。
1つのシート内に、同じソースシートを参照する複数の子テーブルが含まれている場合、システムは区別のために子テーブルの位置をフィールドパラメータに追加します。テンプレート内に子テーブルの位置を手動で追加する必要がある場合は、フィールド値構文参照やフィールド情報から確認できます。
4. テンプレートのアップロード
「はい、自分のWordファイルをテンプレートとしてアップロードしたい」を選択するか、テンプレートをダウンロード後「次へ」をクリックすると、以下のページに進みます。ここで編集済みテンプレートをアップロードできます。
以下のウィンドウからプレビューすることも可能です。
レポート名：画面上部でレポート名を変更できます。カスタム印刷レポートは複数作成できるため、識別しやすいよう、簡潔でわかりやすい名前を付けることをおすすめします。
ファイル形式：プレビュー画面右上で、ダウンロード時のファイル形式を選択できます。レポートは PDF、PNG 画像、または Word 文書としてダウンロードできます。
各テンプレート形式で対応している出力ファイル形式は以下のとおりです。
| テンプレート形式 | 対応する出力形式 |
|---|---|
| Word テンプレート | DOCX、PDF、PNG |
| Excel テンプレート | XLSX、PDF |
| PowerPoint テンプレート | PPTX、PDF |
アスペクト比と画像スケール：
PNG として出力する場合は、アスペクト比と画像スケールを調整して、出力解像度や表示品質を設定できます。スケールを大きくするほど、解像度が高くなり、画像もより鮮明になります。
出力内容は、選択した比率に応じて調整されます。表示崩れや内容の切れを防ぐため、テンプレートのレイアウト比率が選択した比率と合っていることをご確認ください。
全ての設定が完了したら、「レポート保存」をクリックします。
備考： 高度な設定については、こちらのセクションをご参照ください。
次のページが表示されます。
ページ下部の「完了」をクリックすると、画面右下にレポートボタンが追加され、カスタム印刷レポートの利用を開始できます。
一般的なフィールドパラメータについては、こちらをご参照ください。以下では、個別のパラメータと関連する使用例を紹介します。
画像アップロードフィールドが正しく表示されない場合は、初期テンプレートを再ダウンロードしてください。
カスタマイズ済みテンプレートを使用していて再ダウンロードが難しい場合は、代わりにフィールドパラメータの後ろに IMG:html を追加してください。
備考：
1. Excel テンプレートおよび PowerPoint テンプレートでは、このパラメータは利用できません。これらの形式で画像を出力したい場合は、こちらの説明をご参照ください。なお、この方法が適用できるのは単一画像フィールドのみで、複数画像フィールドには対応していません。
2. 出力画像のサイズは、「最大高さ」と「最大幅」で調整できます。必要に応じて、こちらの説明を参照し、画像フィールドのテンプレートを調整して出力サイズを制御することもできます。なお、この方法が適用できるのは単一画像フィールドのみで、複数画像フィールドには対応していません。
3. 画像フィールドで複数画像アップロードが有効になっており、アップロードされた画像が 1 枚だけアップロードされていて、かつ「最大高さ」と「最大幅」が指定されていなければ、画像はデフォルトで 300px × 300px で表示されます。指定している場合は、その設定に従って表示されます。複数画像がアップロードされている場合は、レイアウト崩れを防ぐため、画像総数に応じて各画像のサイズが自動調整されます。そのため、アップロードされる画像が多いほど、各画像は小さく表示され、出力サイズが指定した寸法と完全には一致しない場合があります。
自由入力フィールドで alt+enter を使って改行を入れている場合、テンプレート内のフィールド構文を手動で調整し、フィールド構文の後ろに :convCRLF を追加する必要があります。これにより、ダウンロードしたファイルでも改行を含んだ内容が正しく表示されます。
自由入力フィールドで BBCode を使用している場合、または テキストエディタ で書式を設定しており、出力時にもその書式を保持したい場合は、フィールドパラメータを適切に調整する必要があります。（Excel テンプレートおよび PowerPoint テンプレートには対応していません。）
利用できる 2 種類のパラメータについては、以下の表をご参照ください。
| パラメータ形式 | html 形式 | html(inline) 形式 |
|---|---|---|
| 例 | {d.1002578:html} | {d.1002581:html(inline)} |
| 対応する BBCode | br, b, i, u, s, li, ol, ul, img, url, color | b, i, u, s, color（URL、画像、改行を生成する BBCode には対応していません） |
| 適した用途 | フィールド値に改行が含まれ、段落やリストなどを含む完全な書式を保持したい場合 | レイアウト上の都合で、フィールド値を 1 行のまま表示しつつ、基本的な書式のみを適用したい場合 |
例：
以下の画像にあるレコードを、2 種類の異なるパラメータ形式で出力すると、次のような結果になります。
html 形式
html(inline) 形式
Markdown フィールドを使用していて、出力時にもその書式を保持したい場合は、フィールド構文の後ろに :html を追加してください。（Excel テンプレートおよび PowerPoint テンプレートには対応していません。）
備考：
1. 見出し（#） 構文を使用する場合は、テンプレート内の任意の場所に {o.preReleaseFeatureIn=5002000} を追加してください。
2. 現在、引用（Blockquotes） 構文には対応していません。
出力したファイルに現在の日付と時刻を表示したい場合は、テンプレートに次のパラメータを追加してください：{c.now:formatD('YYYY-MM-DD HH:mm:ss')}
備考：
1. formatD() で使用できる日付・時刻の書式については、こちらのページをご参照ください。
2. パラメータ内では半角のシングルクォーテーションを使用してください。使用できるのは ' のみで、’ は使用できません。
3. 時刻は、会社設定で指定した時間帯に基づいて表示されます。
テンプレートに特定のパラメータを追加することで、指定したファイルアップロードフィールドに保存されている PDF ファイルを、最終的に出力される PDF ドキュメントへ結合できます。結合したファイルは、出力結果の先頭または末尾のいずれかに追加できます。以下の例では、ファイルアップロードフィールドのパラメータが「d.1234567」であることを前提としています。
末尾に追加する場合
テンプレート内の任意の場所に、以下のパラメータを追加してください：
{d.1234567FILE_URL[i]:appendFile}
{d.1234567FILE_URL[i+1]}
先頭に追加する場合
テンプレート内の任意の場所に、以下のパラメータを追加してください：
{d.1234567FILE_URL[i]:appendFile(start)}
{d.1234567FILE_URL[i+1]}
これらのパラメータを含むテンプレートをアップロードすると、指定したフィールドにアップロードされているすべての PDF ファイルが、最終ドキュメントの先頭または末尾に自動的に結合されます。
シート内に複数のファイルアップロードフィールドがある場合は、必要に応じて各フィールドに同じ形式のパラメータを設定してください。要件に応じて、一部のフィールドは先頭に結合し、別のフィールドは末尾に結合するよう設定することもできます。
備考： 結合後の最大ファイルサイズは 100 MB です。
レポート名の横にあるギアアイコンをクリックし、高度な設定を選択すると、以下の項目を設定できます。
アクセス権限：
このレポートを利用できるグループを設定します。
ファイル名参照フィールド：
ダウンロードされるファイル名に使用するシート内のフィールドを指定します。
ボタンを非表示：
リストページまたはフォームページで、アクションボタンを非表示にするかどうかを選択できます。
以下の項目は、ファイル形式がPDFのときのみ利用できます。
PDF を開くためのパスワードを設定する：
この設定を有効にすると、パスワードを設定できます。ダウンロードした PDF ファイルを開く際に、そのパスワードの入力が必要になります。
フィールド値を PDF パスワードとして設定する：
この設定を有効にすると、シート内のフィールド値をパスワードとして指定できます。
たとえば、「受注書」の場合、顧客の「追跡番号」をパスワードとして使用できます。顧客は納品書の「追跡番号」を入力して、自分の受注詳細 PDF を開くことになります。
備考：
1. この設定とPDF を開くための固定パスワードを設定するは同時には使用できません。
2. 指定したフィールド値が空の場合、ダウンロードされた PDF はパスワード保護されません。
3. 複数レコードをダウンロードして 1 つの PDF に結合した場合、その PDF にはパスワードは設定されません。
直接ダウンロードせず印刷プレビューを使う：
この設定を有効にすると、レポートボタンをクリックした際に新しいウィンドウで印刷用ページ画面が開き、ファイルをダウンロードせずに印刷できます。
複数レコードのダウンロードでは、印刷プレビューに対応しているのは1 つのファイルとして保存の場合のみです。
個別ファイルとして保存（zip 圧縮）およびファイルアップロードフィールドに保存には対応していません。
カスタム印刷レポートのページを再度開くと、新しいレポートを追加したり、既存のレポートを編集したりできます。
また、レポート名の横にある歯車アイコンをクリックすると、レポート名の変更、高度な設定の設定、またはテンプレート／レポートのダウンロードを行えます。
編集したいレポートをクリックして、修正版のテンプレートを再度アップロードできます。
ギアアイコンをクリックしてこのバージョンのテンプレートをダウンロードを選択すると、このレポート用に保存されたテンプレートをダウンロードしてさらに修正可能です。
テンプレートの追加、編集、削除は全て変更履歴に記録されます。該当するバージョンのファイルをダウンロードするには、テンプレートリンクをクリックしてください。
レポート左側をドラッグすると、レポートの表示順を変更できます。
更新した順序は、シート右下に表示されるレポートボタンにも反映されます。
このページでレポート横の「X」をクリックして保存済みレポートを削除できます。
注意: レポートが保存されると対応するアクションボタンが自動生成されます。このボタンはアクションボタンの削除機能では削除できず、カスタムプリントレポート設定ページから該当レポートを削除することでのみ削除可能です。
保存後、印刷したいレコードのフォームページに移動します。右下に、保存したカスタム印刷レポート用のアクションボタンが表示されます。このボタンをクリックすると、ファイルのダウンロードが開始されます。
SYSAdmin は、カスタム印刷レポートページにアクセスし、レポートを選択して、レポート名横の ギアアイコンをクリックし、レポートをダウンロード を選択することもできます。
注意： 一部のフィールドが正しくダウンロードされない場合は、こちらのセクションをご参照ください。
まず、リストページ右下のアイコンをクリックして、ボタンバーを開きます。
カスタム印刷レポートボタンをクリックして、対象レコードの範囲と出力方法を選択します。
エクスポート方法は 2 種類あります：
(1) ファイルアップロードフィールドに保存
シートに ファイルアップロード フィールドが含まれている場合、この方法を選択すると、エクスポートしたファイルを各レコードの該当フィールドにアップロードできます。
(2) ファイルとして保存
各レコードを 個別ファイル（ZIP 圧縮） として保存するか、すべてのレコードを 1 つのファイル にまとめて保存するかを選択できます。
備考： 複数レコードを 1 つのファイルにまとめて出力できるのは、PDF、XLSX、PPTX 形式のみです。
1. 現在、 フォームページ形式のみご利用いただけます。リストページのフォーマットをダウンロードするには、差し込み印刷を参照してください。
2. シートのフィールド数が多く、幅が大きすぎる場合、ダウンロードされたテンプレートではページからはみ出したフィールドが表示されないことがあります。テンプレートにフィールドを追加するには、フィールド値の文法参照を参照してください。
3. ダウンロードされたテンプレートは、子テーブルフィールドを自動的に下部に配置します。子テーブルの位置を変更したい場合は、手動で調整する必要があります。異なる子テーブルが同じ行に配置されると、レポートの印刷時に問題が発生する可能性があります。
4. 現在、出力した PDF ファイルに結合できるのは、ファイルアップロードフィールド内の PDF ファイルのみです。テンプレートの調整方法については、こちらの説明をご参照ください。
5. 現在、Word テンプレートで特定の BBCode を使用しているフィールドは、出力ファイルに表示されません。対応している BBCode とテンプレートの調整方法については、こちらの説明をご参照ください。
6. サインフィールドまたはバーコードフィールドが正しく表示されない場合は、初期テンプレートを再度ダウンロードしてください。カスタマイズ済みテンプレートを使用していて、初期テンプレートの再ダウンロードが難しい場合は、こちらの説明をご参照ください。
7. オンプレミス・プライベートサーバーで、画像アップロードフィールドが正しく出力されない場合は、こちらのセクションをご参照ください。
8. 現在、承認式フィールドで署名を返すものは、以下の通りダウンロードしたファイルに表示することができません：
(1) APPROVAL.STEP([stepIndex]).SIG([email])
(2) APPROVAL.STEP([stepIndex]).SIGIMG([email], [width], [height])
9. Excel テンプレートの制限事項：
(1) 画像はセル内に挿入できず、セルの上に配置する形式のみ対応しています。また、子テーブル内の単一画像フィールドには対応していません。
(2) :html パラメータには対応していないため、BBCode、Markdown、複数画像フィールドは出力できません。
10. PowerPoint テンプレートの制限事項：
(1) 子テーブル内の単一画像フィールドには対応していません。
(2) :html パラメータには対応していないため、BBCode、Markdown、複数画像フィールドは出力できません。
貴重なご意見をありがとうございます！
