提供Web API④：帳票の差し込み印刷
※LinkPrint CLOUD Web APIの概要や本記事内に記載されている用語についての説明はこちらをご確認ください。
差し込み印刷の方法
指定されたテンプレートフォームに対し、指定された印刷データを差し込む方法です。
| 関数名 | LPCA.insertPrintData | ||||||||||||
| 引数① |
必須。
「提供Web API③：印刷データのアップロード」を利用し、対象の印刷データをアップロードすると、「printDataId」が取得できます。この値をご指定ください。 |
||||||||||||
| 引数② |
必須。
「提供API①：テンプレートフォーム一覧の取得」を利用し取得した、対象フォームの「form_id」をご指定ください。 |
||||||||||||
| 引数③ |
必須。
差し込みした結果をどのような形で表示・実行するか、を以下の指定番号からご指定ください。
※「帳票画面」はモバイル端末（iOS/Android）に対応しておりません。 |
||||||||||||
| 引数④ |
引数③で指定番号4を指定した場合に必須。
引数③で指定番号4をご指定された場合の、開発会社様側の処理をご指定ください。 |
||||||||||||
| 引数⑤ |
引数③で指定番号5を指定した場合に必須。
引数③で指定番号5をご指定された場合の、フォーム保存されるテンプレートフォームの名称をご指定ください。 |
||||||||||||
| 引数➅ |
省略可。
開発会社様側で管理しているユーザIDがあり、このユーザID単位で情報の管理が必要であれば、ユーザIDをご指定ください。ユーザIDは100文字以内でご指定ください。ご指定いただいた場合、以下の部分に、ご指定されたユーザIDを表示します。 1.LinkPrint CLOUD 印刷履歴 2.LinkPrint CLOUD 保存フォーム一覧 |
||||||||||||
| 引数⑦ |
省略可。
当処理は、非同期の処理です。差し込み結果が返ってくるまでお時間がかかることがありますので、画面上に「処理中」等のメッセージを表示されたい場合は、メッセージを表示するための関数を開発会社様側でご用意いただき、その関数をご指定ください。 |
||||||||||||
| 引数⑧ |
引数⑦を省略された場合は省略してください。
引数⑦をご指定された場合に、そのメッセージ（「処理中」等）を非表示にするための処理をご指定ください。 |
||||||||||||
| 戻り値 | 差し込みした結果を引数③で指定された方法で実行します。 |
＜フォーム振り分け差し込み印刷の解除＞
フォーム振り分け設定がされているフォームカテゴリを利用したテンプレートフォームに対して、フォーム振り分けをせずに差し込み印刷を行う際、「LPCA.insertPrintData」を実行する前にこちらの関数を実行してください。
| 関数名 | LPCA.not_form_divide_print |
| 引数 | true：フォーム振り分けをせずに差し込み印刷を行う場合 false：当関数に対して「true」で実行した後に解除を実施する場合 ※デフォルトでは「false」状態となっています。 |
| 戻り値 | なし |
＜ポップアップブロックが表示される場合＞
差し込み印刷を行う場合、別ウインドウを起動します。この別ウインドウを起動する際に、ポップアップブロックが発生し、別ウインドウが起動しないことがあります。この場合は、処理開始前に、
「LPCA.open_window();」
を実行ください。エラー等で強制的に別ウインドウを閉じたい場合は、
「LPCA.close_window();」
を実行ください。
<script>
//「処理中」等のメッセージを表示する関数
function waiting(){
//「処理中」等のメッセージを表示する処理
}
//「処理中」等のメッセージを非表示にする関数
function waited(){
//「処理中」等のメッセージを非表示にする処理
}
//PDFのURLを取得した後の処理（開発会社様にご用意いただく処理となります）
function getPdfUrl(url){
//引数のurlに生成したPDFのURLが指定されます。PDFのURLを取得した後の処理を作成いただきます。
}
//「printDataId」の値
var printDataId_val = ‘●●’;
//「form_id」の値
var target_form_id = ‘△△’;
//指し込み結果の表示方法
var insertMethod_val = □□;
（1～5までを指定）
//フォーム保存されるテンプレートフォームの名称
var save_formName = ‘〇〇’;
//開発会社様側で管理しているユーザID
var devsys_userid = ‘▲▲’;
//差し込み処理開始
LPCA.insertPrintData(printDataId_val, target_form_id, insertMethod_val, getPdfUrl, save_formName, devsys_userid, waiting, waited);
</script>