BarTender標簽打印軟件 Web服務(wù)集成響應(yīng)中有什么?
對于每個響應(yīng),結(jié)構(gòu)將根據(jù)所選的“內(nèi)容類型”設(shè)置而有所不同。
內(nèi)容類型格式:
- application / json:具有嵌套在{方括號}中的信息的json樣式字符串
- text / xml:標準的XML樣式格式。發(fā)送此響應(yīng)時,像Insomnia這樣的可視客戶端將對其格式化并使其易于閱讀。
- application / soap-xml:如上所述的標準XML樣式格式,但以SOAP消息而不是純文本形式發(fā)送
- text:XML響應(yīng),格式為無格式。
%響應(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>
對于那些希望檢查打印狀態(tài)的人,print標簽中的此參數(shù)可能是最佳選擇:
JobCompleted="true"
或以下內(nèi)容:
JobStatus Completed="true"
這些標簽確認打印作業(yè)已成功發(fā)送到打印后臺處理程序。此時,它已經(jīng)離開了集成控制的領(lǐng)域。消息標簽中位于最下方的消息以更易理解的格式報告了相同的信息。如果存在阻止后臺處理打印作業(yè)的錯誤,則響應(yīng)為:
%Response%
如果Printer Maestro服務(wù)未運行,您可能會得到誤報(或在這種情況下為誤報):
<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)表明它不僅僅是因為它無法與Printer Maestro服務(wù)進行通信。
響應(yīng)變量的值
- JobLastStatus:幾乎總是“排隊”以指示作業(yè)已被后臺處理。如果顯示未知,則說明集成無法與Maestro服務(wù)通信。
- JobCompleted:如果已后臺處理作業(yè),則為“ True”。如果Maestro服務(wù)未正確通信,則可能顯示為false。
- 作業(yè)狀態(tài)已完成:確認作業(yè)已完成
- 命令名稱:Integration上的打印操作的名稱
行動摘要
樣本成功響應(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" } ]}
樣本錯誤響應(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īng)的操作是集成本身中列出的操作:
動作響應(yīng)的值
- 狀態(tài):值為“ RanToCompletion”和“故障”
- WaitStatus:值是“已完成”和“已故障”
- ActionName:正在打印的動作的名稱。操作響應(yīng)僅報告有關(guān)打印操作的信息,即使存在其他操作也是如此。
- 文字:您還可以在管理控制臺或Integration Builder中的集成消息中看到的消息。