DB32T 3411-2018食品安全電子追溯信息查詢服務(wù)數(shù)據(jù)接口規(guī)范

ICS67.040X00備案號：江蘇省地DB32方標(biāo)準(zhǔn)DBT3411—2018Interfacespecificationsofinformationqueryserviceforfoodsafetyelectronicraceability江蘇省質(zhì)量技術(shù)監(jiān)督局發(fā)布IDB32/T3411—2018 DB32/T3411—2018 H 40 IDB32/T3411—2018前言本標(biāo)準(zhǔn)按照GB/T1.1—2009給出的規(guī)則起草。本標(biāo)準(zhǔn)由江蘇省食品藥品監(jiān)督管理局提出并歸口。本標(biāo)準(zhǔn)起草單位：江蘇省質(zhì)量和標(biāo)準(zhǔn)化研究院、復(fù)旦大學(xué)無錫研究院、中科院計算機網(wǎng)絡(luò)中心、無錫捷瑪科技物聯(lián)有限公司。本標(biāo)準(zhǔn)主要起草人：胡冶、崔兆明、王俊宇、劉毅、曹云、楊博、劉佳、周廣軍、王瑜、錢侃、王開疆、吳雙力、田野。1DB32/T3411—2018食品安全電子追溯信息查詢服務(wù)數(shù)據(jù)接口規(guī)范1范圍本標(biāo)準(zhǔn)規(guī)定了食品安全電子追溯信息查詢服務(wù)的功能要求、數(shù)據(jù)接口。本標(biāo)準(zhǔn)適用于食品安全電子追溯信查查詢服務(wù)的接口實現(xiàn)。2規(guī)范性引用文件下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。GB/T17295國際貿(mào)易計量單位代碼DB32/TXXXX-2018食品安全電子追溯標(biāo)識解析服務(wù)數(shù)據(jù)接口規(guī)范RFC2616超文本傳輸協(xié)議1.1(Hypertexttransferprotocol--HTTP/1.1)RFC4627JSON格式定義(Theapplication/JSONmediatypeforjavascriptobjectnotation)configurationaccessprotocol(XCAP))3術(shù)語和定義下列術(shù)語和定義適用于本文件。3.1信息查詢服務(wù)informationqueryservice提供追溯信息傳輸、查詢和數(shù)據(jù)上報功能的服務(wù)。3.2網(wǎng)元networkelement由軟硬件共同組成的能實現(xiàn)網(wǎng)絡(luò)中的一種或多種邏輯功能的邏輯單元。3.3IQS網(wǎng)元informationqueryservicenetworkelement提供信息查詢服務(wù)的網(wǎng)元。3.4IRS網(wǎng)元identificationresolutionservicenetworkelement提供追溯標(biāo)識注冊和追溯標(biāo)識解析服務(wù)的網(wǎng)元。2DB32/T3411—20183.5DCS網(wǎng)元datacatalogservicenetworkelement提供追溯路徑的建立和查詢服務(wù)的網(wǎng)元。3.6EU網(wǎng)元endusernetworkelement終端用戶所使用的具備追溯查詢能力的軟件系統(tǒng)的統(tǒng)稱。3.7CU網(wǎng)元captureunitnetworkelement負(fù)責(zé)采集數(shù)據(jù)、上傳的網(wǎng)元。3.8SP網(wǎng)元supervisorplatformnetworkelement負(fù)責(zé)接收IQS網(wǎng)元上報的追溯數(shù)據(jù)，并利用追溯數(shù)據(jù)進(jìn)行監(jiān)管行為的網(wǎng)元。3.9追溯代理traceabilityproxy以用戶發(fā)起的HTTP追溯查詢請求為觸發(fā)，代替追溯用戶調(diào)用IRS,DCS和IQS網(wǎng)元的多個接口完成追溯查詢邏輯功能的網(wǎng)元。4縮略語下列縮略語適用于本文件。CU：捕獲單元(CaptureUnit)DNS：域名服務(wù)(DomainNameService)DCS：數(shù)據(jù)目錄服務(wù)(DataCatalogService)EU：終端用戶(EndUser)IQS：信息查詢服務(wù)(InformationQueryService)IRS：標(biāo)識解析服務(wù)(IdentificationResolutionService)JSON：JS對象標(biāo)記(JavaScriptObjectNotation)RFID：射頻識別(RadioFrequencyIdentification)SP：監(jiān)管平臺(SupervisorPlatform)URL：統(tǒng)一資源定位符(UniformResourceLocator)URN：統(tǒng)一資源名稱(UniformResourceName)XML：可擴展標(biāo)記語言(ExtensibleMarkupLanguage)5信息查詢服務(wù)功能要求5.1系統(tǒng)架構(gòu)3DB32/T3411—2018食品安全電子追溯系統(tǒng)應(yīng)由企業(yè)平臺、監(jiān)管平臺和查詢平臺組成，食品安全電子追溯系統(tǒng)的系統(tǒng)架構(gòu)見DB32/TXXXX。信息查詢服務(wù)由IQS網(wǎng)元實現(xiàn)，IQS網(wǎng)元架構(gòu)圖見圖1。圖1IQS網(wǎng)元構(gòu)架5.2信息查詢服務(wù)基本功能信息查詢服務(wù)應(yīng)提供但不限于以下功能：a)傳輸服務(wù)——通過數(shù)據(jù)傳輸接口接收企業(yè)平臺(CU網(wǎng)元)傳輸?shù)淖匪輸?shù)據(jù)；b)查詢服務(wù)——通過查詢接口與查詢平臺交互實現(xiàn)追溯數(shù)據(jù)的查詢。6信息查詢服務(wù)接口要求6.1基本要求食品安全電子追溯系統(tǒng)的各個網(wǎng)元之間應(yīng)通過Internet公共以太網(wǎng)接口互聯(lián)互通。IQS網(wǎng)元與其他網(wǎng)元的物理接口上承載的協(xié)議棧應(yīng)為HTTP或HTTPS協(xié)議棧，數(shù)據(jù)接口應(yīng)使用基于HTTP/HTTPS協(xié)議的JSON格式的消息體傳輸數(shù)據(jù)。IQS接口分為：a)數(shù)據(jù)傳輸接口；b)查詢接口。6.1.1IQS傳輸接口食品生產(chǎn)經(jīng)營企業(yè)信息管理系統(tǒng)通過該接口和IQS網(wǎng)元交互，使用傳輸服務(wù)。IQS傳輸接口分為：a)主數(shù)據(jù)傳輸接口；b)事件傳輸接口；c)資源文件傳輸接口。4DB32/T3411—20186.1.2IQS查詢接口查詢平臺通過該接口和IQS網(wǎng)元交互，使用查詢服務(wù)。6.2接口原語基于服務(wù)的方式定義數(shù)據(jù)接口的使用方法。服務(wù)響應(yīng)流程使用了“請求-Request”“指示-Indication”“響應(yīng)-Response”“確認(rèn)-Confirm”四條服務(wù)原語，原語的順序見圖2。圖2服務(wù)響應(yīng)流程6.3基本數(shù)據(jù)類型IQS網(wǎng)元接口基本數(shù)據(jù)類型見表1。表1基本數(shù)據(jù)類型類型名類型描述類型約束String文本字符串內(nèi)容為所有的有效字符List<>列表類型每一項均為一個子數(shù)據(jù)項，子數(shù)據(jù)項編碼方式與父數(shù)據(jù)項編碼方式相同。Time時間類型UTC時間表示法：YYYY-MM-DDTHH:mm:ss.SSSZ本地時間表示法：YYYY-MM-DDTHH:mm:ss.SSS±zoneoffsetfloat浮點數(shù)類型內(nèi)容為浮點數(shù)類型字符整數(shù)類型內(nèi)容為整形字符file文件流類型內(nèi)容為對文件的操作定義Boolean數(shù)值類型alse6.4接口調(diào)用方式6.4.1請求5DB32/T3411—2018請求接口應(yīng)符合RFC2616中對HTTP請求的規(guī)定，使用Get或者POST方法調(diào)用接口，并將請求參數(shù)按照消息格式用JSON封裝后，包含在HTTP的Request消息的Body中發(fā)送給對方。6.4.2響應(yīng)接口調(diào)用成功后，應(yīng)由IQS網(wǎng)元進(jìn)行處理，處理方式應(yīng)符合RFC4825對XML的規(guī)定或RFC4627對JSON格式的規(guī)定，處理結(jié)束后應(yīng)將處理結(jié)果放置在HTTP的Response消息的Body中，返回給調(diào)用者。HTTP的Response消息應(yīng)符合RFC2616中的規(guī)定。7主數(shù)據(jù)傳輸接口7.1接口基本功能提供食品生產(chǎn)經(jīng)營企業(yè)提供向IQS提交靜態(tài)數(shù)據(jù)的功能。注：靜態(tài)數(shù)據(jù)包括食品生產(chǎn)企業(yè)的企業(yè)基本信息、原料基本信息、供貨廠商基本信息、生產(chǎn)流程基本信息、產(chǎn)成品基本信息、銷售商基本信息、原料及產(chǎn)生品檢驗信息等。7.2接口定義接口名稱：vocabularyCapture。主數(shù)據(jù)傳輸接口請求參數(shù)及響應(yīng)參數(shù)見表2、表7。表2主數(shù)據(jù)傳輸接口請求參數(shù)參數(shù)名稱類型最大長度Byte是否必填描述EPCISMasterDataBodyEPCISMasterDataDocumentType255是主數(shù)據(jù)結(jié)構(gòu)，EPCISMasterDataDocumentType定義見表3表3EPCISMasterDataDocumentType數(shù)據(jù)結(jié)構(gòu)參數(shù)名稱類型最大長度Byte是否必填描述VocabularyLiList<VocabularyListType>單個標(biāo)識最大55是主數(shù)據(jù)列表，VocabularyListType定義見表4VocabularyListType數(shù)據(jù)參數(shù)參數(shù)名稱類型最大長度Byte是否必填描述typeString255是主數(shù)據(jù)類型參數(shù)名稱類型最大長度Byte是否必填描述VocabularyElementListList<VocabularyElementListType>單個標(biāo)識最大255是主數(shù)據(jù)內(nèi)容列表，VocabularyElementListType定義見表56DB32/T3411—2018表5VocabularyElementListType數(shù)據(jù)參數(shù)參數(shù)名稱類型最大長度Byte是否必填描述String255是主數(shù)據(jù)主鍵attributeList<attributeType>單個標(biāo)識最大255是主數(shù)據(jù)屬性，attributeType定義見表6表6attributeType數(shù)據(jù)參數(shù)參數(shù)名稱類型最大長度Byte是否必填描述String255是屬性名稱/編碼valueString255是屬性內(nèi)容表7主數(shù)據(jù)傳輸接口返回參數(shù)參數(shù)名稱類型最大長度Byte是否必填描述StatusString255是返回數(shù)據(jù)傳輸結(jié)果success：傳輸成功，false：傳輸失敗7.3接口調(diào)用靜態(tài)數(shù)據(jù)不隨生產(chǎn)活動而變化，靜態(tài)數(shù)據(jù)因企業(yè)其他活動發(fā)生改變時調(diào)用該接口。接口調(diào)用方向：由CU網(wǎng)元向IQS網(wǎng)元提出請求。注：調(diào)用示例可參見附錄F。8事件傳輸接口8.1接口基本功能提供食品生產(chǎn)經(jīng)營企業(yè)提供向IQS提交動態(tài)數(shù)據(jù)的功能。注：動態(tài)數(shù)據(jù)包括與企業(yè)生產(chǎn)化活動相關(guān)的數(shù)據(jù)，如原輔料及產(chǎn)成品進(jìn)銷存數(shù)量、生產(chǎn)投料等數(shù)據(jù)8.2接口定義接口名稱：Capture。事件傳輸請求參數(shù)及響應(yīng)參數(shù)見表8、表9。表8事件傳輸接口請求參數(shù)參數(shù)名稱類型最大長度Byte是否必填描述7DB32/T3411—2018eventList<EPCISEvent>單個標(biāo)識最大255是事件數(shù)據(jù)結(jié)構(gòu)，EPCISEvent定義見附錄A表9事件傳輸接口響應(yīng)參數(shù)參數(shù)名稱類型最大長度Byte是否必填描述StatusString255是返回數(shù)據(jù)傳輸結(jié)果success：提交成功，falser：提交失敗8.3接口調(diào)用接口調(diào)用方向：由CU網(wǎng)元向IQS網(wǎng)元提出請求。注：調(diào)用示例可參見附錄G。9資源文件傳輸接口9.1接口基本功能提供食品生產(chǎn)經(jīng)營企業(yè)向IQS上傳資源文件的的功能，資源文件應(yīng)包含圖片、視頻、文檔文件等。9.2接口定義接口名稱：resUpload。資源文件傳輸接口請求參數(shù)及響應(yīng)參數(shù)見表10、表11。表10資源文件傳輸接口請求參數(shù)參數(shù)名稱類型最大長度Byte是否必填描述filePathfile255是待上傳文件表11資源文件傳輸接口響應(yīng)參數(shù)參數(shù)名稱類型最大長度Byte是否必填描述statusString255是返回值，用于表示狀態(tài)：success上傳成功，false上傳失敗fileURLString255否返回值為success時，本字段存放可用于訪問的文件URL；否則為空9.3接口調(diào)用接口調(diào)用方向：由CU網(wǎng)元向IQS網(wǎng)元提出請求。注：調(diào)用示例可參見附錄H。8DB32/T3411—201810查詢接口10.1接口基本功能提供從IQS查詢符合條件的靜態(tài)數(shù)據(jù)和動態(tài)數(shù)據(jù)的功能。10.2接口定義接口名稱：poll。查詢接口請求參數(shù)：見表12、表13。表12查詢接口請求參數(shù)參數(shù)名稱類型最大長度Byte是否必填描述queryNameString255是查詢名稱，可使用項目見表13paramsQueryParams255是查詢參數(shù)，根據(jù)不同的查詢名稱，參數(shù)也不同，見表14表13queryName參數(shù)queryName值aramsSimpleEventQuery匿名事件查詢，params定義見附錄BSimpleMasterDataQuery匿名主數(shù)據(jù)查詢，params定義見附錄CAuthenticatedEQuery認(rèn)證用戶事件查詢，params定義見附錄DAuthenticatedMDQuery認(rèn)證用于主數(shù)據(jù)查詢，params定義見附錄E表14查詢接口返回參數(shù)參數(shù)名稱類型是否必填描述queryNameString1-255本參數(shù)與請求參數(shù)中的queryName一致resultsBodyQueryResultsBody1-255返回的查詢結(jié)果，本參數(shù)的類型由請求參queryName決定：當(dāng)queryName為SimpleEventQuery和AuthenticatedEQuery時，本參數(shù)的數(shù)據(jù)類型定義見附錄A；當(dāng)queryName為SimpleMasterDataQuery和AuthenticatedMDQuery時，本參數(shù)的數(shù)10.3接口調(diào)用接口調(diào)用方向：由CU網(wǎng)元、EU網(wǎng)元、SP網(wǎng)元通過追溯代理向IQS網(wǎng)元提出請求。注：調(diào)用示例可參見附錄I。9DB32/T3411—2018附錄A(規(guī)范性附錄)EPCISEvent定義A.1ObjectEvent子類數(shù)據(jù)結(jié)構(gòu)EPCISEvent是一個對于所有IQS事件的基礎(chǔ)類型，ObjectEvent是其一個子類，用于記錄對象事件數(shù)據(jù)，結(jié)構(gòu)見表A.1。表A.1ObjectEvent子類數(shù)據(jù)結(jié)構(gòu)字段名稱字段類型最大長度Byte是否必填描述eventTimeTime255是事件發(fā)生時間recordTimeTime255否這個事件被IQS記錄的日期時間，在事件提交到IQS傳輸接口時必須忽略，由IQS自動記錄；在查詢時可以獲得eventTimeZoneOffsetString255是時間發(fā)生地點時區(qū)與UTC時區(qū)的差值，這個字段的值應(yīng)是字符串，以‘+’或者‘-’14)的數(shù)字，接著是一個冒號，后面是兩若前兩位是14，后兩位必須是00epcListList<EPC>單個標(biāo)識最大255否單件追溯標(biāo)識數(shù)組，EPC定義見A.5.1，epcList與quantityList兩者至少存在1項quantityListList<QuantityElement>單個標(biāo)識最大255否批次追溯標(biāo)識數(shù)組，QuantityElement定義見A.5.2，epcList與quantityList兩者actionAction255是事件導(dǎo)致的物品狀態(tài)變化，ADD：增加;DELETE：移除；OBSERVE：不變bizStepBusinessStepID255否業(yè)務(wù)步驟，值見A.5.7dispositionDispositionID255否物品狀態(tài)，值見A.5.8readPointReadPointID255否事件發(fā)生時刻的業(yè)務(wù)位置標(biāo)識bizLocationBusinessLocationID255否事件發(fā)生后，物品所在業(yè)務(wù)位置標(biāo)識bizTransactionLList<BusinessTransaction>單個標(biāo)識最大255否與事件相關(guān)的事務(wù)單據(jù)數(shù)組，BusinessTransaction定義見A.5.3sourceListList<Source>單個標(biāo)識最大255否在整個事務(wù)中開始的位置，Source定義見A.5.4DB32/T3411—2018字段名稱字段類型最大長度Byte是否必填描述destinationListList<Destination>單個標(biāo)識最大255否在整個事務(wù)中結(jié)束的位置，Destination定義ilmdILMD255否物品主數(shù)據(jù)補充，定義見A.5.6IotextensionList<EvtElementList>單個標(biāo)識最大255否存放事件的詳細(xì)信息，EvtElementList定義A.2AggregationEvent子類數(shù)據(jù)結(jié)構(gòu)定義EPCISEvent是一個對于所有IQS事件的基礎(chǔ)類型，AggregationEvent是其一個子類，用于記錄聚合事件和包含物流包裝的事件，具體內(nèi)容見表A.2。表A.2AggregationEvent子類數(shù)據(jù)結(jié)構(gòu)定義字段名稱字段類型最大長度Byte是否必填描述eventTimeTime255是事件發(fā)生時間recordTimeTime255這個事件被IQS記錄的日期時間，在事件提S記錄；在查詢時可以獲得eventTimeZoneOffsetString255是時間發(fā)生地點時區(qū)與UTC時區(qū)的差值，這個字段的值應(yīng)是字符串，以‘+’或者‘-’開頭，后兩位是在00到14之間(包括00，14)的數(shù)字，接著是一個冒號，后面是兩位若前兩位是14，后兩位必須是00parentIDEPC255否值為OBERSVE時選填，否則為必填childEPCsList<EPC>單個標(biāo)識最大長度為255否單件追溯標(biāo)識數(shù)組，EPC定義見A.5.1，childEPCs與childQuantityList兩者至少存在一項childQuantityLList<QuantityElement>單個標(biāo)識最大長度為255否批次追溯物標(biāo)識數(shù)組，QuantityElement定義見A.5.2actionAction255是ADD：向容器增加;DELETE：從容器移除；OBSERVE：帶容器進(jìn)行業(yè)務(wù)事件bizStepBusinessStepID255否業(yè)務(wù)步驟，值見A.5.7dispositionDispositionID255否物品狀態(tài)，值見A.5.8readPointReadPointID255否事件發(fā)生時刻的業(yè)務(wù)位置標(biāo)識DB32/T3411—2018字段名稱字段類型最大長度Byte是否必填描述bizLocationBusinessLocationID255否事件發(fā)生后，物品所在業(yè)務(wù)位置標(biāo)識bizTransactionListList<BusinessTransaction>單個標(biāo)識最大長度為255否與事件相關(guān)的事務(wù)單據(jù)數(shù)組，BusinessTransaction定義見A.5.3sourceListList<Source>單個標(biāo)識最大長度為255否在整個事務(wù)中開始的位置，Source定義見A.5.4destinationListList<Destination>單個標(biāo)識最大長度為255否在整個事務(wù)中結(jié)束的位置，Destination定A5.4IotextensionList<EvtElementList>單個標(biāo)識最大長度為255否存放事件的詳細(xì)信息，EvtElementList定義A.3TransactionEvent子類數(shù)據(jù)結(jié)構(gòu)定義EPCISEvent是一個對于所有IQS事件的基礎(chǔ)類型，TransactionEvent是其一個子類，用于記錄帶有事務(wù)過程的業(yè)務(wù)事件信息，具體內(nèi)容見表A.3。表A.3TransactionEvent子類數(shù)據(jù)結(jié)構(gòu)定義字段名稱字段類型最大長度Byte是否必填描述eventTimeTime255是事件發(fā)生時間recordTimeTime255這個事件被IQS記錄的日期時間，在事件提S記錄，在查詢時可以獲得eventTimeZoneOffsetString255是時間發(fā)生地點時區(qū)與UTC時區(qū)的差值，這個字段的值應(yīng)是字符串，以‘+’或者‘-’開頭，后兩位是在00到14之間(包括00，14)的數(shù)字，接著是一個冒號，后面是兩位若前兩位是14，后兩位必須是00bizTransactionListList<BusinessTransaction>單個標(biāo)識最大長度為255是與事件相關(guān)的事務(wù)單據(jù)數(shù)組，BusinessTransaction定義見表parentIDEPC255否容器追溯標(biāo)識，EPC定義見A.5.1epcListList<EPC>單個標(biāo)識最大長度為255否單件追溯標(biāo)識數(shù)組，EPC定義見A.5.1quantityListList<QuantityElement>單個標(biāo)識最大長度為255否批次追溯標(biāo)識數(shù)組，QuantityElement定義DB32/T3411—2018字段名稱字段類型最大長度Byte是否必填描述ActionAction255是ADD：事務(wù)發(fā)生時/新增對象時；DELETE事務(wù)結(jié)束時/對象移除時；OBSERVE：事務(wù)進(jìn)行中bizStepBusinessStepID255否業(yè)務(wù)步驟，值見A.5.7DispositionDispositionID255否物品狀態(tài)，值見A.5.8readPointReadPointID255否事件發(fā)生時刻的業(yè)務(wù)位置標(biāo)識bizLocationBusinessLocationID255否事件發(fā)生后，對象所在業(yè)務(wù)位置標(biāo)識sourceListList<Source>單個標(biāo)識最大長度為255否在整個事務(wù)中開始的位置，Source定義見A.5.4destinationListList<Destination>單個標(biāo)識最大長度為255否在整個事務(wù)中結(jié)束的位置，Destination定A5.4IotextensionList<EvtElementList>單個標(biāo)識最大長度為255否存放事件的詳細(xì)信息，EvtElementList定義見A.5.5A.4TransformationEvent子類數(shù)據(jù)結(jié)構(gòu)定義EPCISEvent是一個對于所有IQS事件的基礎(chǔ)類型，TransformationEvent是其一個子類，用于記錄投料產(chǎn)出事件信息，具體內(nèi)容見表A.4。表A.4TransformationEvent子類數(shù)據(jù)結(jié)構(gòu)定義字段名稱字段類型最大長度Byte是否必填描述eventTimeTime255是事件發(fā)生時間recordTimeTime255否這個事件被IQS記錄的日期時間。在事件提S記錄；在查詢時可以獲得eventTimeZoneOffsetString255是時間發(fā)生地點時區(qū)與UTC時區(qū)的差值。這個字段的值應(yīng)是字符串，以‘+’或者‘-’開頭，后兩位是在00到14之間(包括00，14)的數(shù)字，接著是一個冒號，后面是兩位若前兩位是14，后兩位必須是00inputEPCListList<EPC>單個標(biāo)識最大長度為255否單件追溯標(biāo)識數(shù)組，EPC定義見A.5.1，當(dāng)transformationID未賦值時，當(dāng)transformationID賦值時，inputEPCList、inputQuantityList、outputEPCList、outputQuantityList至少存在1項DB32/T3411—2018字段名稱字段類型最大長度Byte是否必填描述inputQuantityLList<QuantityElement>單個標(biāo)識最大長度為255否批次追溯標(biāo)識數(shù)組，QuantityElement定義見A.5.2，當(dāng)transformationID未賦值時，inputEPCList和inputQuantityList至少存在1項,當(dāng)transformationID賦值時，inputEPCList、inputQuantityList、outputEPCList、outputQuantityList至少outputEPCListList<EPC>單個標(biāo)識最大長度為255否單件追溯標(biāo)識數(shù)組，EPC定義見A.5.1。當(dāng)transformationID未賦值時，outputEPCList和outputQuantityList至inputEPCList、inputQuantityList、outputEPCList、outputQuantityList至少outputQuantityListList<QuantityElement>單個標(biāo)識最大長度為255否批次追溯標(biāo)識數(shù)組，QuantityElement定義見A.5.2。當(dāng)transformationID未賦值時，outputEPCList和outputQuantityList至inputEPCList、inputQuantityList、outputEPCList、outputQuantityList至少transformationTransformationID255否變換編號，用于標(biāo)記一個批次物品的多個投料生產(chǎn)事件bizStepBusinessStepID255否業(yè)務(wù)步驟，值見A.5.7dispositionDispositionID255否物品狀態(tài)，值見A.5.8readPointReadPointID255否事件發(fā)生時刻的業(yè)務(wù)位置標(biāo)識bizLocationBusinessLocationID255否事件發(fā)生后，對象所在業(yè)務(wù)位置標(biāo)識bizTransactionListList<BusinessTransaction>單個標(biāo)識最大長度為255否與事件相關(guān)的事務(wù)單據(jù)數(shù)組，BusinessTransaction定義見表A.5.3sourceListList<Source>單個標(biāo)識最大長度為255否在整個事務(wù)中開始的位置，Source定義見A.5.4destinationListList<Destination>單個標(biāo)識最大長度為255否在整個事務(wù)中結(jié)束的位置，Destination定A5.4ilmdILMD255否物品主數(shù)據(jù)補充，定義見A.5.6IotextensionList<EvtElementList>單個標(biāo)識最大長度為255否存放事件的詳細(xì)信息，EvtElementList定義A.5相關(guān)數(shù)據(jù)結(jié)構(gòu)定義DB32/T3411—2018A.5.1EPC數(shù)據(jù)結(jié)構(gòu)定義EPC用于記錄一個用于單件追溯的追溯標(biāo)識，類型為String，使用資源標(biāo)識符形式。A.5.2QuantityElement數(shù)據(jù)結(jié)構(gòu)定義QuantityElement用于記錄批次追溯的追溯標(biāo)識，定義見表A.5。表A.5QuantityElement數(shù)據(jù)結(jié)構(gòu)定義字段名稱字段類型最大長度Byte是否必填描述epcClassString255是用于批次追溯的物品標(biāo)識，使用資源標(biāo)識符形式QuantityString255是數(shù)量，數(shù)量用于形容epcClass如何標(biāo)稱。如果沒有uom字段，數(shù)量必須為正整數(shù)，用于表示epcClass的內(nèi)容的個數(shù)；如果存在uom字段，數(shù)量可以是任何正數(shù)，與uom一起表示epcClass的計量UomString255是epcClass所對應(yīng)的對象的數(shù)量，使用GB/T17295中的通用代碼A.5.3BusinessTransaction數(shù)據(jù)結(jié)構(gòu)定義BusinessTransaction用于記錄事件中事務(wù)相關(guān)的單據(jù)信息，定義見表A.6、A.7所示。表A.6BusinessTransaction數(shù)據(jù)結(jié)構(gòu)定義字段名稱字段類型最大長度Byte是否必填格式說明TypeBizTransTypeID255是單據(jù)類型編號，見表A.7bizTransString255是單據(jù)號碼表A.7BizTransTypeID數(shù)據(jù)結(jié)構(gòu)定義BizTransTypeID值說明po采購訂單poc采購訂單確認(rèn)bol提貨單發(fā)票rma退貨授權(quán)pedigree履歷desadv發(fā)貨通知單DB32/T3411—2018A。7(續(xù))BizTransTypeID值說明recadv收貨通知單prodorder生產(chǎn)通知單A.5.4Source/Destination數(shù)據(jù)結(jié)構(gòu)定義Source/Destination用于記錄開始/結(jié)束的業(yè)務(wù)位置、所有者、管理方信息，定義見表A.8、A.9所示。表A.8Source/Destination數(shù)據(jù)結(jié)構(gòu)定義字段名稱字段類型最大長度Byte是否必填格式說明TypeSourceDestTypeID255是字段類型說明，見表A.9Source/destinationString255是業(yè)務(wù)位置標(biāo)識，使用資源標(biāo)識符表示表A.9SourceDestTypeID數(shù)據(jù)結(jié)構(gòu)定義SourceDestTypeID值說明owning_party表示所有者possessing_party表示管理方location表示業(yè)務(wù)位置A.5.5EvtElementList數(shù)據(jù)結(jié)構(gòu)定義EvtElementList用于記錄事件中的詳細(xì)信息，定義見表A.10、A.11所示。表A.10EvtElementList數(shù)據(jù)結(jié)構(gòu)定義字段名稱字段類型最大長度Byte是否必填描述extNameString255是擴展名稱extContentString255是擴展內(nèi)容extIDString255是擴展信息內(nèi)容區(qū)分，見表A.11resLinkString255是資源鏈接resTypeString255是resLink資源鏈接所指向的目標(biāo)類型0000無內(nèi)容0001圖片0002視頻0003網(wǎng)站0004地圖DB32/T3411—2018表A.11extID數(shù)據(jù)結(jié)構(gòu)定義用途00001表示extContent字段內(nèi)容是以JSON格式保存的投料產(chǎn)出明細(xì)信息00002表示extContent字段內(nèi)容是以JSON格式保存的出廠檢驗明細(xì)信息00003表示extContent字段內(nèi)容是以JSON格式保存的原料自檢明細(xì)信息A.5.6ILMD數(shù)據(jù)結(jié)構(gòu)定義ILMD用于保存事件中額外的主數(shù)據(jù)信息，可由多組屬性組成，每組屬性定義見表A.12所示。表A.12ILMD屬性數(shù)據(jù)結(jié)構(gòu)定義參數(shù)名稱類型最大長度Byte是否必填描述String255是屬性名稱/編碼valueString255是屬性內(nèi)容A.5.7BusinessStepID值定義BusinessStepID用于表示一項具體的業(yè)務(wù)過程。BusinessStepID應(yīng)使用URN形式表示，表A.13中的BusinessStepID在使用時的格式為：urn:epcglobal:cbv:bizstep:BusinessStepID。表A.13BusinessStepID值定義BusinessStepID中文名稱中文說明accepting收貨表示物品在業(yè)務(wù)過程中改變了持有方和/或所有者assembling組裝表示多個物品被組合成一個物品，通常用于聚合事件,它與變換事件不同，輸入的物品依舊存在，這個過程可逆commissioning賦碼將標(biāo)識賦予物理物品的階段creating_class_instance生產(chǎn)單個或批次物品的生產(chǎn)階段decommissioning取消賦碼標(biāo)識與物品之間的關(guān)系取消，以便將來可以重新賦碼arriving送達(dá)表示物品在業(yè)務(wù)過程中到達(dá)某一個業(yè)務(wù)位置collecting集貨表示在業(yè)務(wù)過程中，物品經(jīng)過揀貨后放到一起，準(zhǔn)備進(jìn)入下一個處理consigning托運該階段與staging_outbound,loading,departing,andaccepting互斥，發(fā)生時物品持有方和/或所有者會發(fā)生改變cycle_counting盤點通過清點物品數(shù)量獲得一個準(zhǔn)確的庫存，可用于業(yè)務(wù)需要以外的其他會計用途departing起運/出發(fā)表示在業(yè)務(wù)處理過程中物品離開當(dāng)前位置去目的地destroying銷毀銷毀一個物品，物品之后不會有事件發(fā)生DB32/T3411—2018BusinessStepID中文名稱中文說明encoding編碼將單件/批次標(biāo)識寫入載體的過程holding扣留在業(yè)務(wù)過程中，物品被隔離以便進(jìn)一步檢查installing安裝表示在業(yè)務(wù)過程中一個物品被放入一個復(fù)合物品中l(wèi)oading裝貨表示在業(yè)務(wù)過程中，物品被裝載到運輸工具中disassembling拆解將一個物品分解成多個單獨的組成部分entering_exiting進(jìn)入物品跟隨消費者進(jìn)入或離開特定的場所inspecting檢驗/審查檢驗物品存在的問題killing終結(jié)終止一個RFID標(biāo)識，物品將由其他標(biāo)識來標(biāo)識other其他無法使用核心業(yè)務(wù)詞匯表中的詞匯描述的階段packing物流包表示在業(yè)務(wù)過程中，將物品放入更大的容器用于運輸receiving收貨表示在業(yè)務(wù)過程中，在某個位置接收物品，并放到倉庫repackaging重新包裝表示在業(yè)務(wù)過程中，物品重新進(jìn)行包裝replacing替換表示在業(yè)務(wù)過程中，一個物品被另一個物品替換retail_selling零售表示物品通過貨幣等交換的方式改變所有者為消費者的過程picking揀貨根據(jù)訂單選取物品removing拆卸表示在業(yè)務(wù)過程中一個物品從一個復(fù)合物品中取出的事件repairing修理表示在業(yè)務(wù)過程中有故障的物品被修復(fù)的事件reserving保留表示一組未被賦碼的追溯標(biāo)識提供給第三方使用shipping運輸可以替代staging_outbound,loadingandstaging_outbound放到發(fā)貨區(qū)表示在業(yè)務(wù)過程中，將一個物品移動到運輸發(fā)貨區(qū)stocking上架/出貨表示在業(yè)務(wù)過程中，使物品可以被銷售或放到揀貨區(qū)域transporting運輸物品通過運輸工具從一個位置移動到另外一個位置unpacking拆包拆開封裝物品的箱子或包裝，取出物品stock_taking庫存盤點庫存盤點storing倉儲將物品放到儲存物品的地方unloading卸貨將物品從運輸工具中卸載下來A.5.8DispositionID值定義DispositionID用于表示追溯物品在事件發(fā)生后的狀態(tài)。DispositionID應(yīng)使用URN形式表示，表A.14中的DispositionID在使用時的格式為：urn:epcglobal:cbv:disp:DispositionID。表A.14ISO/IEC19988定義的DispositionID值定義物品狀態(tài)ID中文名稱中文說明active激活被貼標(biāo)的物品進(jìn)入供應(yīng)鏈適用業(yè)務(wù)步驟：commissioningDB32/T3411—2018物品狀態(tài)ID中文名稱中文說明destroyed摧毀物品已不可用適用業(yè)務(wù)步驟：destroyinginactive注銷標(biāo)簽注銷適用業(yè)務(wù)步驟：decommissioningin_transit運輸中物品運輸中適用業(yè)務(wù)步驟：shipping、departingdamaged損壞物品損壞了，無法使用適用業(yè)務(wù)步驟：accepting、inspecting、receiving、removing、repairing、replacingcontainer_closed封箱物品被裝運在封閉的容器內(nèi)適用業(yè)務(wù)步驟：staging_outbound物品狀態(tài)ID中文名稱中文說明encoded編碼標(biāo)識已寫入RFID適用業(yè)務(wù)步驟：encodingin_progressi進(jìn)行中供應(yīng)鏈中物品的默認(rèn)狀態(tài)適用業(yè)務(wù)步驟：receiving、picking、loading、accepting、staging_outbound、arrivingexpired已經(jīng)過期物品已過保質(zhì)期適用業(yè)務(wù)步驟：holding、staging_outbound、storingdisposed銷毀物品已經(jīng)被銷毀no_pedigree_match履歷異常沒有找到符合的履歷，進(jìn)行進(jìn)一步調(diào)查適用業(yè)務(wù)步驟：holding、staging_outbound、storingrecalled召回因為公共安全的原因召回中適用業(yè)務(wù)步驟：holding、staging_outbound、storingreturned送回因各種原因物品退貨中適用業(yè)務(wù)步驟：Receiving、holding、shippingsellable_not_accessible可準(zhǔn)備銷售物品可以銷售，但消費者還不能進(jìn)行購買適用業(yè)務(wù)步驟：receiving、storing、loading、holding、inspectingstolen被盜物品已經(jīng)被偷盜non_sellable_other無法銷售物品不允許銷售適用業(yè)務(wù)步驟：holding、inspecting、staging_outbound、storingreserved已分配單件標(biāo)識被分配給第三方適用業(yè)務(wù)步驟：reservingsellable_accessible上架銷售物品可被銷售，且消費者可以購買適用業(yè)務(wù)步驟：stocking、receivingretail_sold已被購買物品已被消費者購買適用業(yè)務(wù)步驟：retail_sellingunknown物品狀態(tài)未知物品狀態(tài)未知DB32/T3411—2018附錄B(資料性附錄)entQueryparamsQueryparamsBparams參數(shù)名稱類型最大長度Byte是否必填描述eventTypeList<String>單個標(biāo)識最大長度為255否如果指定了該參數(shù)(事件類型)，返回的查詢結(jié)果只包含與指定事件類型匹配的事件，本參數(shù)的取值可以為：ObjectEvent,AggregationEvent,TransactionEvent,或TransformationEvent；如果省略，會返回所有事件GE_eventTimeTime255否如果指定了該參數(shù)，返回的結(jié)果只包含eventTime大于指定時間的事件；如果省略，返回的結(jié)果不考慮eventTime(除非添加了LT_eventTime約束)LT_eventTimeTime255否如果指定了該參數(shù)，返回的結(jié)果只包含eventTime小于指定時間的事件如果省略，返回的結(jié)果不考慮eventTime(除非添加了GE_eventTime約束)GE_recordTimeTime255否如果提供了該參數(shù)，返回的結(jié)果只包含recordTime大于或者等于指定時間的事件如果省略，返回結(jié)果不考慮recordTimeLT_recordTimeTime255否如果指定了該參數(shù)，返回的結(jié)果只包含eventTime小于指定時間的事件如果省略，返回的結(jié)果不考慮recordTimeEQ_actionList<String>單個標(biāo)識最大長度為255否如果指定了該參數(shù)，返回的結(jié)果只包含有action字段并且該字段的取值與指定的參數(shù)值之一匹配的事件。本參數(shù)的取值只能是：ADD,OBSERVE或者DELETE如果省略，返回的事件不考慮action字段EQ_bizStepList<String>單個標(biāo)識最大長度為255否如果指定了該參數(shù)，返回的結(jié)果只包含bizStep字段非空且其取值與參數(shù)指定值之一匹配的事件如果省略該參數(shù)，返回的事件不考慮bizStep字段的值或者該字段是否存在EQ_dispositionList<String>單個標(biāo)識最大長度為255否與EQ_bizStep參數(shù)類似，但是針對的是disposition字段20DB32/T3411—2018參數(shù)名稱類型最大長度Byte是否必填描述EQ_readPointList<String>單個標(biāo)識最大長度為255否如果指定了該參數(shù)，返回的結(jié)果只包含readPoint非空并且readPoint字段的取值與參數(shù)指定值之一匹配的事件，如果本參數(shù)和WD_readPoint參數(shù)同時被省略，那么返回的結(jié)果事件不考慮readPoint字段的值或者該字段是否存在WD_readPointList<String>單個標(biāo)識最大長度為255否如果指定了該參數(shù)，返回的結(jié)果只包含readPoint非空并且readPoint的取值與參數(shù)指定值之一相匹配或是其直接或者間接后繼的事件，如果本參數(shù)和EQ_readPoint參數(shù)同時被省略，那么返回的結(jié)果不考慮readPoint字段的取值或者該字段是否存在EQ_bizTransaction_typeList<String>單個標(biāo)識最大長度為255否本參數(shù)不是單一參數(shù)，如果指定了該種形式的參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含bizTransactionList、業(yè)務(wù)交易列表中某個條目的type子字段與從本參數(shù)提取出的type名稱相同、bizTransction子字段與本參數(shù)對應(yīng)部分指定的值相同EQ_source_typeList<String>單個標(biāo)識最大長度為255否本參數(shù)不是單一參數(shù)，而是一組參數(shù)集。如果指定了該種形式的參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含sourceList、源列表中某個條目的type子字段與從本參數(shù)提取出的type名稱相同、source子字段與本參數(shù)對應(yīng)部分指定的值相同EQ_destination_typeList<String>單個標(biāo)識最大長度為255否本參數(shù)不是單一參數(shù)，如果指定了該種形式的參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含destinationList、目標(biāo)列表中某個條目的type子字段與從本參數(shù)提取出的type名稱相同、destination子字段與本參數(shù)對應(yīng)部分指定的值相同EQ_transformationIDList<String>單個標(biāo)識最大長度為255否如果指定了本參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含transformationID、transformationID與本參數(shù)指定的值之一相等21DB32/T3411—2018參數(shù)名稱類型最大長度Byte是否必填描述MATCH_epcList<String>單個標(biāo)識最大長度為255否本參數(shù)用于查詢指定物品標(biāo)識的相關(guān)事件，如果指定了本參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：epcListchildEPCs字段、Cs參數(shù)指定的EPC模式或URI匹配、如果省略了本參數(shù)，那么返回的事件結(jié)果不考慮不管該兩個字段是否存在MATCH_parentIDList<String>單個標(biāo)識最大長度為255否本參數(shù)用于查詢指定包裝物品標(biāo)識的相關(guān)事件，與MATCH_epc字段類似，但是匹配的是AggregationEvent的parentID字段entparentIDAggregationEvent和TransactionEvent擴展類型的事件類型MATCH_inputEPCList<String>單個標(biāo)識最大長度為255否本參數(shù)用于查詢指定原材料物品標(biāo)識相關(guān)的變換事件，如果指定了本參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含inputEPCList、inputEPCList字段中的某配；如果省略該參數(shù)，返回的事件不考慮inputEPCList字段或者該字段是否存在MATCH_outputEPCList<String>單個標(biāo)識最大長度為255否本參數(shù)用于查詢指定產(chǎn)品物品標(biāo)識相關(guān)的變換事件，如果指定了本參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含outputEPCList、outputEPCList字段中的匹配MATCH_anyEPCList<String>單個標(biāo)識最大長度為255否本參數(shù)用于查詢與指定的物品標(biāo)識相關(guān)的所有事件，如果指定了本參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含epcList，chidlEPCs，ParentID，inputEPCList字段，或者包含outputEPCList、parentID字段或者epcList，childEPCs，inputEPCList，outputEPCList字段中的某個EPC與本參22DB32/T3411—2018參數(shù)名稱類型最大長度Byte是否必填描述MATCH_epcClassList<String>單個標(biāo)識最大長度為255否本參數(shù)用于查詢指定的批次追溯標(biāo)識相關(guān)的事件，如果指定了本參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含quantityList，或者包含childQuantityList、quantityList或childQuantityList字段中的某個EPC與本參數(shù)指定的EPC模式或URI匹配，同時返回結(jié)果中還包含epcsClass字段與本參數(shù)QuantityEvent事件MATCH_inputEPCClassList<String>單個標(biāo)識最大長度為255否本參數(shù)用于查詢批次追溯原材料物品標(biāo)識相關(guān)的事件，如果指定了本參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含inputQuantityList、inputQuantityList字段中的某個EPC與本參數(shù)指定的EPC模MATCH_outputEPCClassList<String>單個標(biāo)識最大長度為255否本參數(shù)用于查詢批次追溯產(chǎn)品物品標(biāo)識相關(guān)的事件，如果指定了本參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含outputQuantityList、outputQuantityList字段中的某個EPC與MATCH_anyEPCClassList<String>單個標(biāo)識最大長度為255否本參數(shù)用于查詢批次追溯標(biāo)識相關(guān)的所有事件，如果指定了本參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含quantityList，childQuantityList,inputQuantityList,或者outputQuantityList字段中的一個、上述字段中EPC類與的某個EPC與本參數(shù)指定的EPC模式或URI匹配，同時返回結(jié)果中還包含epcsClass字段與本參數(shù)指定的件23DB32/T3411—2018參數(shù)名稱類型最大長度Byte是否必填描述EQ_fieldnameList<String>單個標(biāo)識最大長度為255否本參數(shù)不是單一參數(shù)，而是一組參數(shù)集，如果指定了該種形式的參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含fieldname字段，并且該字段的類型是String或者詞匯表類型、滿足a條件的字段值與本參數(shù)指定的參數(shù)之一匹配，F(xiàn)ieldname是一個擴展字段的完全限定名，該擴展字段是由XML命名空間URI和名稱組成的XMLqname，對應(yīng)的查詢參數(shù)可以通過連接EQ_字符串、該擴展字段的命名空間URI，#號符和擴展字段的名稱來創(chuàng)建EQ_fieldnameFloat255否與上面描述的EQ_fieldname類似，但是用于float類型的字段，返回事件結(jié)果滿足以下條件：有fieldname字段、該字段的類型與本參數(shù)的類型匹配(Int，F(xiàn)loat，或者Time)、該字段的值與本參數(shù)指定的ieldnameEQfieldnameGT_fieldnameFloat255否與上面描述的EQ_fieldname類似，但是用于float類型的字段，返回事件結(jié)果滿足以下條件：有fieldname字段、該字段的類型與本參數(shù)的類型匹配(Int，F(xiàn)loat，或者Time)、該字段的值與本參數(shù)指定的ieldnameEQfieldnameEQ_ILMD_fieldnameList<String>單個標(biāo)識最大長度為255否與EQ_fieldname類似，返回的事件結(jié)果符ILMD部分fieldname的值與本參數(shù)指定值匹配24DB32/T3411—2018參數(shù)名稱類型最大長度Byte是否必填描述HASATTR_fieldnameList<String>單個標(biāo)識最大長度為255否本參數(shù)不是單一參數(shù)，而是一組參數(shù)集，如果指定了該種形式的參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含fieldname字段，并且該字段的類型是詞匯表類型、滿足a條件的字段值是主數(shù)據(jù)可以獲得的詞匯表元素、該主數(shù)據(jù)的屬性值不為空，并且屬性名稱與本參數(shù)指定的值相同，F(xiàn)ieldname是一個擴展字段的完全限定名，對于標(biāo)準(zhǔn)字段，它代表字段名稱，例如bizLocaion；對于擴展字段，該擴展字段是由XML命名空間URI和名稱組成的XMLqname。對應(yīng)的查詢參數(shù)可以通過連接EQ_字符串、該擴展字段的命名空間URI，#號符和擴展字段的名稱來創(chuàng)建EQATTR_fieldname_attrnameList<String>單個標(biāo)識最大長度為255否本參數(shù)不是單一參數(shù)，而是一組參數(shù)集，如果指定了該種形式的參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含fieldname字段，并且該字段的類型是詞匯表類型、滿足a條件的字段值是主數(shù)據(jù)可以獲得的詞匯表元素、該主數(shù)據(jù)的有名為attrname的屬性、attrname的值與本參數(shù)指定的屬性值匹配，F(xiàn)ieldname被構(gòu)造為HASATTR_fieldnameorderByString255否如果指定參數(shù)該參數(shù)，則會命名一個單獨字段將查詢結(jié)果排序，orderDirection字段指明是按照升序還是降序排序。如果不指定本字段，返回的事件結(jié)果在列表中的順序是不確定的，本參數(shù)的值必須是evenTime,recordTime或者Int,Float,Time,String擴展字段的完全限定名，完全限定名由EQ_fieldname參數(shù)構(gòu)造，對于String類型的字段，應(yīng)該按照該字符串的Unicode編碼的字典順序排序，或者適合當(dāng)前環(huán)境的排序序列，如果省略該參數(shù)，同一個查詢的兩次執(zhí)行其返回事件結(jié)果的順序也可能不同25DB32/T3411—2018參數(shù)名稱類型最大長度Byte是否必填描述orderDirectionString255否如果本字段和orderBy字段同時被指定，那么返回的查詢結(jié)果會依照orderBy中指明的關(guān)鍵字按升序或者降序排序，本參數(shù)ASC或者DESC(表示降序)如果省略，本參數(shù)的默認(rèn)值為DESCeventCountLimt255否如果指定本參數(shù)，則僅會返回滿足其他查詢條件的前N個事件，N代表本參數(shù)的值，具體返回的結(jié)果由orderBy字段orderDirection中指定的參數(shù)決定，如果省略本參數(shù)，則會返回所有滿足查詢參數(shù)的事件結(jié)果，本參數(shù)和maxEventCount參數(shù)是互斥的，只有當(dāng)指定了orderBy參數(shù)時，才能使用本參數(shù)，maxEventCount與本參數(shù)的區(qū)別是，前者當(dāng)返回結(jié)果超出限制時會引發(fā)異常，但是后者則是限制了返回數(shù)據(jù)的數(shù)量maxEventCountt255否如果指定了本參數(shù)，返回的事件數(shù)最多為該參數(shù)指定的值本參數(shù)和maxEventCount參數(shù)是互斥的，如果省略，返回的事件數(shù)目不受限制26DB32/T3411—2018附錄C(規(guī)范性附錄)SimpleMasterDataQuery時params參數(shù)SimpleMasterDataQuery時params參數(shù)見表C.1。C1SimpleMasterDataQuery時params參數(shù)參數(shù)名稱類型最大長度Byte是否必填描述vocabularyNameList<String>單個標(biāo)識最大長度為255否如果指定了本參數(shù)，只有詞匯元素屬于參數(shù)指定詞匯表的事件才會被返回，該字符串列表中每一個字符串都代表一個詞匯表的URI名稱，如果省略本參數(shù)，需要返回所有的詞匯表includeAttributesBoolean255是如果參數(shù)值為真，返回的結(jié)果中會包含屬性名稱和匹配的詞匯表元素值；如果為假則不包含includeChildrenBoolean255是如果參數(shù)值為真，返回的結(jié)果中會包含匹配詞匯表元素的子列表，如果為假則不包含attributeNamesList<String>單個標(biāo)識最大長度為255否如果指定本參數(shù)，返回事件的屬性必須與本參數(shù)指定的屬性名之一匹配，如果省略，所有屬性與詞匯表元素匹配事件都會被返回(如果想要獲得不包含屬性的詞匯表元素名稱，將includeAtributes的屬性設(shè)置為false)如果includeAtributes的值為false，本參數(shù)的值會忽略EQ_nameList<String>單個標(biāo)識最大長度為255否如果指定本參數(shù)，返回事件的詞匯表元素必須與指定值相同，如果本參數(shù)和WD_name同時被省略，會包含所有的詞匯表元素WD_nameList<String>單個標(biāo)識最大長度為255否如果指定本參數(shù)，返回事件的詞匯表元素與本字段指定詞匯表元素相同，或是指定詞匯表元素的直接或者間接后繼，如果本參數(shù)和EQ_name同時被省略，會包含所有的詞匯表元素HASATTRList<String>單個標(biāo)識最大長度為255否如果指定了本參數(shù)，返回事件的詞匯表元素屬性不為空，并且其名稱與該參數(shù)指定的值之一相同27DB32/T3411—2018參數(shù)名稱類型最大長度Byte是否必填描述EQATTR_attrnameList<String>單個標(biāo)識最否本參數(shù)不是單一參數(shù)，而是一組參數(shù)集，如果指定了該種形式的參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：詞匯表元素由一個非空的屬性attrname，并且該屬性的值與本字段指定的值之一相同maxElementCountt255否如果指定了本參數(shù)，返回的事件中包含的詞匯表元素最多為該參數(shù)指定的數(shù)值，如果省略該參數(shù)，返回結(jié)果中可以包含任意數(shù)目的詞匯表元素28DB32/T3411—2018附錄D(規(guī)范性附錄)AuthenticatedEQuery時params參數(shù)AuthenticatedEQuery時params參數(shù)見表D.1。表D.1AuthenticatedEQuery時params參數(shù)說明參數(shù)名稱類型最大長度Byte是否必填描述userIDString255是用戶名passwordString255是密碼eventTypeList<String>單個標(biāo)識最大長度為255否如果指定了該參數(shù)(事件類型)，返回的查詢結(jié)果只包含與指定事件類型匹配的事件，本參數(shù)的取值可以為：ObjectEvent,AggregationEvent,TransactionEvent,、TransformationEvent；如果省略，會返回所有事件GE_eventTimeTime255否如果指定了該參數(shù)，返回的結(jié)果只包含eventTime大于指定時間的事件；如果省略，返回的結(jié)果不考慮eventTimeLT_eventTimeTime255否如果指定了該參數(shù)，返回的結(jié)果只包含eventTime小于指定時間的事件，如果省略，返回的結(jié)果不考慮eventTime(除非添加了GE_eventTime約束)GE_recordTimeTime255否如果提供了該參數(shù)，返回的結(jié)果只包含recordTime大于或者等于指定時間的事件，如果省略，返回結(jié)果不考慮recordTimeLT_recordTimeTime255否如果指定了該參數(shù)，返回的結(jié)果只包含eventTime小于指定時間的事件，如果省略，返回的結(jié)果不考慮recordTimeEQ_actionList<String>單個標(biāo)識最大長度為255否如果指定了該參數(shù)，返回的結(jié)果只包含有action字段并且該字段的取值與指定的參數(shù)值之一匹配的事件，本參數(shù)的取值只能是：ADD,OBSERVE或者DELETE，如果省略，返回的事件不考慮action字段EQ_bizStepList<String>單個標(biāo)識最大長度為255否如果指定了該參數(shù)，返回的結(jié)果只包含bizStep字段非空且其取值與參數(shù)指定值之一匹配的事件如果省略該參數(shù)，返回的事件不考慮bizStep字段的值或者該字段是否存在29DB32/T3411—2018參數(shù)名稱類型最大長度Byte是否必填描述EQ_dispositionList<String>單個標(biāo)識最大長度為255否與EQ_bizStep參數(shù)類似，但是針對的是disposition字段EQ_readPointList<String>單個標(biāo)識最大長度為255否如果指定了該參數(shù)，返回的結(jié)果只包含readPoint非空并且readPoint字段的取值與參數(shù)指定值之一匹配的事件，如果本參數(shù)和WD_readPoint參數(shù)同時被省略，那么返回的結(jié)果事件不考慮readPoint字段的值或者該字段是否存在WD_readPointList<String>單個標(biāo)識最大長度為255否如果指定了該參數(shù)，返回的結(jié)果只包含readPoint非空并且readPoint的取值與參數(shù)指定值之一相匹配或是其直接或者間接后繼的事件，如果本參數(shù)和EQ_readPoint參數(shù)同時被省略，那么返回的結(jié)果不考慮readPoint字段的取值或者該字段是否存在EQ_bizLocationList<String>單個標(biāo)識最大長度為255否與EQ_readPoint字段類似，但是針對的是bizLocation字段WD_bizLocationList<String>單個標(biāo)識最大長度為255否與WD_readPoint字段類似，但是針對的是bizLocation字段EQ_bizTransaction_typeList<String>單個標(biāo)識最大長度為255否本參數(shù)不是單一參數(shù)，而是一組參數(shù)集。如果指定了該種形式的參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含bizTransactionList、業(yè)務(wù)交易列表中某個條目的type子字段與從本參數(shù)提取出的type名稱相同、bizTransction子字段與本參數(shù)對應(yīng)部分指定的值相同EQ_source_typeList<String>單個標(biāo)識最大長度為255否本參數(shù)不是單一參數(shù)，而是一組參數(shù)集。如果指定了該種形式的參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含sourceList、源列表中某個條目的type子字段與從本參數(shù)提取出的type名稱相同、source子字段與本參數(shù)對應(yīng)部分指定的值相同30DB32/T3411—2018參數(shù)名稱類型最大長度Byte是否必填描述EQ_destination_typeList<String>單個標(biāo)識最大長度為255否本參數(shù)不是單一參數(shù)，而是一組參數(shù)集，如果指定了該種形式的參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含destinationList、目標(biāo)列表中某個條目的type子字段與從本參數(shù)提取出的type名稱相同、destination子字段與本參數(shù)對應(yīng)部分指定的值相同EQ_transformationIDList<String>單個標(biāo)識最大長度為255否如果指定了本參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：包含transformationID、transformationID與本參數(shù)指定的值之一相等MATCH_epcList<String>單個標(biāo)識最大長度為255否本參數(shù)用于查詢指定物品標(biāo)識的相關(guān)事件，如果指定了本參數(shù)，那么返回的結(jié)果事件必須滿足以下條件：epcListchildEPCs字段、參數(shù)指定的EPC模式或URI匹配、如果省略了本參數(shù)，那么返回的事件結(jié)果不考慮不管該兩個字段是否存在MATCH_parentIDList<String>單個標(biāo)識最大長度為255否本參數(shù)用于查詢指定包裝物品標(biāo)識的相關(guān)事件，與MATCH_epc字段類似，但是匹配rentIDAggregationEvent、TransactionEvent擴展類型的事件類型MATCH_inputEPCList<