BarTender標(biāo)簽打印軟件 Web服務(wù)集成響應(yīng)中有什么?
對(duì)于每個(gè)響應(yīng),結(jié)構(gòu)將根據(jù)所選的“內(nèi)容類(lèi)型”設(shè)置而有所不同。
內(nèi)容類(lèi)型格式:
- application / json:具有嵌套在{方括號(hào)}中的信息的json樣式字符串
- text / xml:標(biāo)準(zhǔn)的XML樣式格式。發(fā)送此響應(yīng)時(shí),像Insomnia這樣的可視客戶(hù)端將對(duì)其格式化并使其易于閱讀。
- application / soap-xml:如上所述的標(biāo)準(zhǔn)XML樣式格式,但以SOAP消息而不是純文本形式發(fā)送
- text:XML響應(yīng),格式為無(wú)格式。
%響應(yīng)%變量
樣本響應(yīng)格式為XML:
<Response Version="2.0" AppName="BarTender" AppVersion="2016 R8" AppVersionId="1100" AppVersionMajor="11" AppVersionMinor="0" AppVersionBuild="3146" AppInstancePid="29400" AppInstanceGuid="{303F1806-45E6-451E-9EA6-4C13CA93B299}"> <User>XXXXXXUser> <Server>XXXXXServer> <Command Name="Print Document"> <Print ID="25" GUID="{59C2B1CF-B7E9-4572-B97B-66E4955993D7}" JobLastStatus="Queued" JobCompleted="true" JobName="resttest2.btw"> <JobStatus Completed="true"> <TimeJobStart>2018-07-05T10:38:38.183TimeJobStart> <TimeJobQueued>2018-07-05T10:38:38.261TimeJobQueued> <TimeJobSent>2018-07-05T10:38:38.261TimeJobSent> <LastStatus>QueuedLastStatus> <Description>Print job now waiting to be sent to printer.Description> JobStatus> <Message Id="1750" Guid="{889B2413-F92A-4774-A0E8-E931F25F12EC}" Severity="Information" Category="Printing" Response="OK"> <Text>BarTender successfully sent the print job to the spooler.Job Name: resttest2.btwDocument: resttest2.btwPrinter: Zebra 140XiIII PlusText> Message> Print> Command>Response>
對(duì)于那些希望檢查打印狀態(tài)的人,print標(biāo)簽中的此參數(shù)可能是最佳選擇:
JobCompleted="true"
或以下內(nèi)容:
JobStatus Completed="true"
這些標(biāo)簽確認(rèn)打印作業(yè)已成功發(fā)送到打印后臺(tái)處理程序。此時(shí),它已經(jīng)離開(kāi)了集成控制的領(lǐng)域。消息標(biāo)簽中位于最下方的消息以更易理解的格式報(bào)告了相同的信息。如果存在阻止后臺(tái)處理打印作業(yè)的錯(cuò)誤,則響應(yīng)為:
%Response%
如果Printer Maestro服務(wù)未運(yùn)行,您可能會(huì)得到誤報(bào)(或在這種情況下為誤報(bào)):
<Print ID="29988" GUID="{22999A4F-40C7-4F30-BB44-BED5F93691C8}" JobLastStatus="Unknown" JobCompleted="false" JobName="Label_v1.btw"><JobStatus Completed="false">.....<LastStatus>UnknownLastStatus><Description>Print job status is unknown because the Printer Maestro Service that is running on the computer that the printer is attached to is not responding.Description>JobStatus>
作業(yè)成功完成后,響應(yīng)表明它不僅僅是因?yàn)樗鼰o(wú)法與Printer Maestro服務(wù)進(jìn)行通信。
響應(yīng)變量的值
- JobLastStatus:幾乎總是“排隊(duì)”以指示作業(yè)已被后臺(tái)處理。如果顯示未知,則說(shuō)明集成無(wú)法與Maestro服務(wù)通信。
- JobCompleted:如果已后臺(tái)處理作業(yè),則為“ True”。如果Maestro服務(wù)未正確通信,則可能顯示為false。
- 作業(yè)狀態(tài)已完成:確認(rèn)作業(yè)已完成
- 命令名稱(chēng):Integration上的打印操作的名稱(chēng)
行動(dòng)摘要
樣本成功響應(yīng),格式為JSON:
{ "Version": "1.0", "Status": "RanToCompletion", "WaitStatus": "Completed", "Validated": true, "Messages": [ { "ActionName": "Print Document", "Level": 2, "Text": "BarTender successfully sent the print job to the spooler.\r\n\r\nJob Name: resttest.btw\r\nDocument: resttest.btw\r\nPrinter: Datamax I-4208" } ]}
樣本錯(cuò)誤響應(yīng):
{ "Version": "1.0", "Status": "Faulted", "WaitStatus": "Faulted", "Validated": true, "Messages": [ { "ActionName": "Print Document", "Level": 4, "Text": "BarTender cannot use printer 'fakeprinter' to design, print, or export a template due to a printer setup problem." } ]}
此示例響應(yīng)很短,因?yàn)榇思蓛H列出了一個(gè)操作。此處響應(yīng)的操作是集成本身中列出的操作:
動(dòng)作響應(yīng)的值
- 狀態(tài):值為“ RanToCompletion”和“故障”
- WaitStatus:值是“已完成”和“已故障”
- ActionName:正在打印的動(dòng)作的名稱(chēng)。操作響應(yīng)僅報(bào)告有關(guān)打印操作的信息,即使存在其他操作也是如此。
- 文字:您還可以在管理控制臺(tái)或Integration Builder中的集成消息中看到的消息。