生成した帳票をワークスペース横断で検索できるようになりました
変更情報
- 発効日
- 対象
- 全プラン/帳票検索画面(アプリ)・PDF生成API(content.passthrough)
- 変更前
- 生成済みの帳票はデザイン単位の出力履歴からしか辿れず、取引先名や注文番号などの業務値で探すことはできなかった
- 変更後
- ワークスペース横断の帳票検索画面から、生成時に付与したメタデータの値で帳票を検索し、検索結果から直接PDFをプレビューできる
- 破壊的変更
- なし
- 廃止予定
- なし
- 移行方法
- 不要(画面の追加。既存の出力履歴・PDF生成APIの挙動は変更なし。検索対象にするには生成時に content.passthrough でメタデータを付与する)
- 責任者
- プロダクト開発チーム
ワークスペース内で生成した帳票を、単一の検索ボックスから横断的に探せる「帳票検索」画面を追加しました。「あの取引先の請求書、どこだっけ」を、PDFをダウンロードせずにその場で解決できます。
内容
- ワークスペースのすべてのデザインを横断して、生成済みの帳票を検索できるようになりました。これまでのようにデザイン(テンプレート)を選んでから出力履歴を辿る必要はありません
- 検索対象は、PDF生成時に
passthroughで付与したメタデータの値です。取引先名・注文番号・請求書番号などを渡しておくと、その値で帳票を引けます - 検索ボックスに入力した語は、メタデータの値に対する部分一致で照合されます。キー名を指定する必要はありません
- 検索結果からそのままPDFプレビューを開けます
使い方
- PDF生成時に、リクエストの
content.passthroughへ検索したい業務値を入れます
{
"fileName": "invoice.pdf",
"passthrough": { "customerName": "株式会社サンプル", "orderNo": "ORD-2026-001" },
"params": { "customerName": "株式会社サンプル", "amount": 10000 }
}
- アプリの帳票検索画面を開き、検索ボックスに
株式会社サンプルやORD-2026-001のように値を入力します - 一致した帳票が一覧表示されます。そのままPDFプレビューを開けます
ご利用にあたっての注意
- 検索できるのは、メタデータを付けて生成した帳票のみです。
passthroughを指定せずに生成した帳票は、従来どおりデザイン単位の出力履歴から辿ってください - インデックスの対象になるのは
passthroughのトップレベルにある文字列・数値の値です。入れ子のオブジェクトや配列の値は対象外です passthroughの値は生成したPDFのメタデータにも埋め込まれます。PDFを受け取った相手も参照できるため、個人情報や機微な情報は入れないでください- 検索結果はワークスペースのメンバーシップと共有設定に従います。権限のない帳票は表示されません
passthrough の指定方法はPDF生成ガイドをご覧ください。