如何在 BarTender Cloud REST API 中使用数据库覆盖
概述
有时候,您可能希望在打印作业中,用新信息替换标签中数据库字段的信息。这种操作称为数据库覆盖。当您调用 BarTender Cloud REST API 时,可能不清楚在您的发送程序或客户端应用中该如何实现。
本文提供了一个包含数据库覆盖的打印操作示例,您可以将其发送到 BarTender Cloud REST API。
适用范围
BarTender Cloud
信息
文档设置
在介绍示例之前,我们先来设置与打印操作相关的文档。
- 在 BarTender Cloud Designer 中创建一个新文档。
- 点击屏幕左上角的 数据库设置 图标,打开数据库设置向导。
- 点击 文本文件,然后点击 下一步。
- 选择 嵌入式示例数据,然后点击 下一步。
- 粘贴以下示例数据,然后点击 下一步。
- 按照数据库设置向导的其余步骤完成数据库连接。
请求体示例
下面是一个包含数据库覆盖的请求体示例。该示例为 JSON 格式,您也可以使用 YAML。您可以通过右侧的滚动条查看完整示例。
数据库覆盖中的请求体格式(字段数量和顺序)需要与上面设置文档时所用的数据库一致,否则示例无法正常工作。
[
{
"SetVariableAction": {
"VariableName": "EventData",
"VariableValue": "Id,name,year\r\n1,7325856667720,KS2451-Test1,2020\r\n2,7325856667721,KS2451-Test2,2024\r\n3,1234,test3,22"
}
},
{
"PrintBTWAction": {
"DocumentFile": "librarian://main/test.btw",
"Name": "Print Document",
"Printer": "PDF",
"SaveAfterPrint": false,
"Copies": 1,
"ReturnPrintData": "true",
"ReturnPrintSummary": "true",
"PrintToFileFileName": "myOutput.PDF",
"PrintToFileFolder": "librarian://main/pdf/",
"PrintToFileNameVariable": "myPdfOutput",
"MakeUniqueOutputFile": "true",
"DatabaseOverrides": [
{
"Name": "Text",
"Type": "VariableName",
"DataSourceVariableName": "EventData"
}
]
}
}
如需了解更多信息,请参阅下方资源。
其他资源
BarTender Cloud 在线帮助 - 数据库覆盖的 YAML 参考