T-YNZYC 0099-2023 基于射頻識別的中藥（中成藥）生產追溯系統 第4部分：數據接口規范_第1頁
T-YNZYC 0099-2023 基于射頻識別的中藥（中成藥）生產追溯系統 第4部分：數據接口規范_第2頁
T-YNZYC 0099-2023 基于射頻識別的中藥（中成藥）生產追溯系統 第4部分：數據接口規范_第3頁
T-YNZYC 0099-2023 基于射頻識別的中藥（中成藥）生產追溯系統 第4部分：數據接口規范_第4頁
T-YNZYC 0099-2023 基于射頻識別的中藥（中成藥）生產追溯系統 第4部分：數據接口規范_第5頁
已閱讀5頁，還剩32頁未讀， 繼續免費閱讀

下載本文檔

版權說明：本文檔由用戶提供并上傳，收益歸屬內容提供方，若內容存在侵權，請進行舉報或認領

文檔簡介

ICSCCS65.020.99B00體YNZYC標準RadiofrequencyIdentified-basedChinesemedicine(proprietaryChmedicine)productiontraceabilitysystem-Part4:DatainterfacespecificatiIT/YNZYC0099—2023本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結構和起草規則》的規定起草。請注意本文件的某些內容可能涉及專利。本文件的發布機構不承擔識別這些專利的責任。本文件由云南省中藥材種植養殖行業協會提出并歸口。本文件起草單位：昆明高新區生物醫藥產業促進會、云南省中藥材種植養殖行業協會、云南前海高新技術產業研究院有限公司、云南鈺津供應鏈科技有限公司、昆藥集團股份有限公司、昆明中藥廠有限公司、云南三七科技有限公司本文件主要起草人：徐朝能、蘇豹、張自騫、陳曉虹、丁劍、李納、李艷、李學芬、尹容梅、胡倆劍、張雪、鄭輝、田孟齊、唐婉筠、劉輝、江明、孫建寧、孫高飛、楊輝T/YNZYC0099—20232基于射頻識別的中藥（中成藥）生產追溯系統第4部分：數據接口規范本文件規定了中成藥行業基于射頻識別的生產追溯系統的外部數據接口等。本文件適用于中成藥行業基于射頻識別的生產追溯系統與外部系統之間的數據交互。2規范性引用文件下列文件中的條款通過本文件的引用而成為本文件的條款。凡是注日期的引用文件，其隨后所有的修改單（不包括勘誤的內容）或修訂版均不適用于本文件，然而，鼓勵根據本文件達成協議的各方研究是否可使用這些文件的最新版本。凡是不注日期的引用文件，其最新版本適用于本文件。3術語和定義3.1網絡服務WebService用于開發分布式的互操作，是一個平臺獨立的，低耦合的，自包含的、基于可編程的web的應用程序，可使用開放的XML（標準通用標記語言下的一個子集）標準來描述、發布、發現、協調和配置這些應用程序，用于開發分布式的互操作的應用程序。3.2可擴展標記語言ExtensibleMarkupLanguageXML英文全稱ExtensibleMarkupLanguage，稱為可擴展標記語言，標準通用標記語言的子集，是一種用于標記電子文件使其具有結構性的標記語言。可擴展標記語言是一種元標記語言，即定義了用于定義其他特定領域有關語義的、結構化的標記語言，又將文檔分成許多部件并對這些部件加以標識。3.3簡單對象訪問協議SOAP簡單對象訪問協議是交換數據的一種協議規范，是一種輕量的、簡單的、基于XML（標準通用標記語言下的一個子集）的協議，它被設計成在WEB上交換結構化的和固化的信息。3.4系統數據接口SystemDataInterface是軟件系統之間的數據交換協議，用來規定系統間信息交互的訪問方式、數據格式、數據內容、處理規則、交互機制等通信規范。4技術實現4.1通訊方式T/YNZYC0099—20233數據接口以WebService方式進行發布，采用http通訊協議進行同步通訊，支持SOAP1.1、SOAP1.2訪問協議。接口服務程序部署到在應用服務端IIS服務器上，通過Intranet/Internet/專線對外圍系統提供查詢服務。所有接口均采用報文數據作為web服務具體方法的參數完成業務數據交換。4.2報文規范從文檔結構，報文分為報文頭和報文體兩部分；從交互方式，報文分為請求報文和響應報文兩類，即輸入和輸出。報文以xml標簽形式封裝，數據對象及字段英文名即為xml報文中標簽名。報文頭標簽名為<head></head>,報文體標簽為<Data></Data>，報文范例如下。取樣通知通知案例：<?xmlversion="1.0"encoding="gb2312"?><msg><head><f_info_id>value</f_info_id><f_release>v0.1</f_release><f_info_type>1</f_info_type><f_time>2016/06/0100:00:00</f_time><f_remark01/></head><data><tabletablename=”表名”f_info_id=”消息id”f_qc_batch_id=”批次id”f_qc_batch_code=”批次號”f_qc_segment_name=”工藝過程”f_date_code=”日期”……><rowaction="insert"f_info_id=”value”f_qc_task_id=”value”f_qc_task_code=”value”f_qc_task_name=”value”f_class_code=”value”……/><rowaction="insert"f_info_id=”value”f_qc_task_id=”value”f_qc_task_code=”value”f_qc_task_name=”value”f_class_code=”value”……/></table></data></msg>4.3報文約定a)各數據類型若無特別需求均為字符型。b)日期數據默認格式為“yyyyMMdd”，例2016-06-01，報文內容為2016/06/01。c)時間字段默認格式為“yyyyMMddHHmmss”，例如2016-06-0116:25:16，報文內容為2016/06/01d)回執包報文頭交易流水號（infoid），與請求包報文頭交易流水號保持一致。e)報文內容所有字母必須小寫。f)報文數據格式具有規則結構，不允許自定義報文格式。4.4消息類型1T/YNZYC0099—20234234.5消息環節123454.6表類型0123454.7狀態定義01否0是11231234T/YNZYC0099—2023512345業務實現5.1業務流程該接口規定了生產追溯系統與其他系統之間的數據交互方式，主要包括消息接收通知、通知接收回執、消息狀態變更通知與通知接收回執、消息處理狀態反饋與反饋接收回執、結果反饋與反饋接收回執、結果變更通知與通知接收回執、結果作廢通知與通知接收回執等主要流程，其業務流程如下圖所示。圖1業務流程5.2消息訪問通知的下達與接收回執消息訪問通知的下達由交互系統發起，按照其消息需求的時間、頻次進行下達。通知的接收回執由生產追溯系統發起，須在通知接收后實時反饋。業務流程如圖2所示5.2.1消息訪問通知下達交互系統向生產追溯系統下達相應的消息訪問（狀態為下達狀態）通知，生產追溯系統收到消息訪問通知后，須向交互系統發送通知接收回執的消息。其處理方式分以下三種情況：T/YNZYC0099—20236a)交互系統在一定時間內未收到生產追溯系統的通知接收回執，再次發送消息訪問通知；b)交互系統收到生產追溯系統的通知接收回執，但回執狀態為失敗。此時交互系統須進行失敗原因檢查和處理后，再次發送消息訪問通知；c)交互系統收到生產追溯系統的通知接收回執，且回執狀態為成功，消息發出系統將更新相應通知的狀態為“下達”。圖2消息訪問通知下達流程T/YNZYC0099—20235.2.2消息訪問通知接收與回執生產追溯系統收到消息訪問通知后，須及時解析相應的數據格式，并及時向消息發出系統反饋通知的接收回執信息。其中，數據格式解析正確則反饋接收成功，否則反饋接收失敗。業務流程如下圖3所示：圖3消息訪問通知接收流程5.3通知狀態變更與接收回執通知狀態變更通知由交互系統發起，須做到實時作廢及時通知。通知狀態變更通知接收回執由生產追溯系統發起，須在通知狀態變更通知接收后及時的反饋。T/YNZYC0099—202385.3.1通知狀態變更通知下達交互系統向生產追溯系統下達狀態變更通知，生產追溯系統收到通知后，須向交互系統發送通知接收回執的消息。其處理方式分以下四種情況：a)交互系統判斷是否收到生產追溯系統通知狀態變更通知的接收回執，若在一定時間內未收到接收回執，須再次發送；b)交互系統收到生產追溯系統的通知狀態變更通知的接收回執，但回執狀態為失敗。此時交互系統須進行失敗原因檢查和處理后，再次發送通知狀態變更通知；c)交互系統收到生產追溯系統的通知狀態變更通知的接收回執，回執狀態為成功，但是否可變更狀態為否。交互系統須進行失敗原因檢查和處理后，再次發送通知狀態變更通知；d)交互系統收到生產追溯系統的通知狀態變更通知的接收回執，回執狀態為成功，且是否可變更狀態為是，交互系統將作廢相應的消息訪問通知。業務處理流程如圖4所示：T/YNZYC0099—20239圖4通知狀態變更通知下達流程5.3.2通知狀態變更通知接收與回執生產追溯系統收到通知狀態變更通知后，須及時解析相應的數據格式。其處理方式分以下兩種情況：a)數據格式解析異常則須及時向交互系統反饋接收失敗回執；b)數據格式解析正常，生產追溯系統須及時判斷當前的處理情況是否能狀態變更。若能狀態變更，須及時向交互系統反饋可狀態變更的回執，并及時對相應通知狀態變更；若不能狀態變更，須及時向交互系統反饋不可狀態變更的回執。業務處理流程如圖5所示：圖5通知狀態變更通知接收流程T/YNZYC0099—20235.4通知處理狀態反饋與接收回執通知處理狀態的反饋由生產追溯系統發起，須做到通知狀態變更的實時反饋。通知處理狀態反饋接收回執由交互系統發起，須做到反饋接收后實時回執。5.4.1通知處理狀態反饋生產追溯系統向交互系統反饋相應的消息訪問通知處理狀態，交互系統收到通知處理狀態反饋后，須向生產追溯系統發送反饋接收回執的消息。其處理方式分以下四種情況：a)生產追溯系統在一定時間內未收到交互系統的通知狀態反饋的接收回執，須再次發送；b)生產追溯系統收到交互系統的通知狀態反饋的接收回執，但回執狀態為失敗。此時生產追溯系統向系統管理員及相關人員發送通知狀態反饋發送失敗的消息，由系統管理員及相關人員采取相應的處理措施；c)生產追溯系統收到交互系統的通知狀態反饋的接收回執，若回執狀態為成功，但是否可變更狀態為否。此時生產追溯系統向系統管理員及相關人員發送通知狀態變更反饋發送失敗的消息，由系統管理員及相關人員采取相應的處理措施；d)生產追溯系統收到交互系統的通知狀態反饋的接收回執，回執狀態為成功，且是否可變更狀態為是，生產追溯系統將更新相應通知的狀態為“處理”。業務處理流程如圖6所示：T/YNZYC0099—2023圖6通知執行狀態反饋流程5.4.2通知處理狀態接收與回執交互系統接收到生產追溯系統的通知處理狀態變更反饋后，須及時解析相應的數據格式，并及時向生產追溯系統反饋通知狀態變更的接收回執信息。其處理方式分以下兩種情況：a)數據格式解析異常則須及時向生產追溯系統反饋接收失敗回執；b)數據格式解析正常，交互系統須及時判斷本地相應通知狀態是否可變更。若能變更，須及時向交互系統反饋可變更的回執，并及時變更相應通知狀態為處理狀態；若不能變更，須及時向生產追溯系統反饋不可變更的回執。業務處理流程如圖7所示：圖7通知處理狀態反饋接收與回執流程T/YNZYC0099—20235.5通知處理結果反饋與接收回執通知處理結果反饋由生產追溯系統發起，須做到每個通知處理完成后實時的結果反饋，其中通知的處理結果需要反饋兩套數據，分別為原始數據和校準后數據。通知處理結果反饋接收回執由交互系統發起，須做到反饋接收后實時回執。5.5.1通知處理結果反饋生產追溯系統處理完成某個消息訪問通知后，根據相應通知的結果數據格式，向交互系統反饋該結果（包括原始結果和校準后結果）信息（狀態為提交）。其處理方式如下所示：a)生產追溯系統在一定時間內未收到交互系統的通知處理結果反饋的接收回執，須再次發送，發送預定次數后仍未收到接收回執。此時生產追溯系統向系統管理員及相關人員發送通知處理結果反饋發送失敗的消息，由系統管理員及相關人員采取相應的手工干預措施；b)生產追溯系統收到交互系統的通知處理結果反饋的接收回執，但回執狀態為失敗。此時生產追溯系統向系統管理員及相關人員發送通知處理結果反饋發送失敗的消息，由系統管理員及相關人員采取相應的處理措施；c)生產追溯系統收到交互系統的通知處理結果反饋的接收回執，且回執狀態為成功，生產追溯系統將更新相應通知結果的狀態為“提交”。業務處理流程如圖8所示：T/YNZYC0099—2023圖8通知處理結果反饋流程5.5.2通知處理結果接收與回執交互系統收到通知處理結果反饋后，須解析相應的數據格式，并向生產追溯系統發送反饋接收回執的消息。其處理方式分為以下三種情況：a)第一，數據格式解析異常，則須及時向生產追溯系統反饋接收失敗回執；b)第二，數據格式解析正常，則須及時向生產追溯系統反饋接收成功回執；c)第三，交互系統根據通知處理結果反饋信息存儲通知結果，同時更新相應通知狀態為“完成”狀態。業務處理流程如圖9所示：圖8通知處理結果接收與回執T/YNZYC0099—20235.6處理結果作廢反饋與接收回執5.6.1處理結果作廢反饋生產追溯系統向交互系統反饋相應的通知處理結果作廢狀態，交互系統收到通知處理結果作廢反饋后，須向生產追溯系統發送反饋接收回執的消息。其處理方式分以下四種情況：a)生產追溯系統在一定時間內未收到交互系統的通知處理結果作廢反饋的接收回執，須再次發送，發送預定次數后仍未收到接收回執。此時生產追溯系統向系統管理員及相關人員發送通知處理結果作廢反饋發送失敗的消息，由系統管理員及相關人員采取相應的處理措施；b)生產追溯系統收到交互系統的通知處理結果作廢反饋的接收回執，但回執狀態為失敗。此時生產追溯系統向系統管理員及相關人員發送通知處理結果作廢反饋發送失敗的消息，由系統管理員及相關人員采取相應的處理措施；c)生產追溯系統收到交互系統的通知處理結果作廢反饋的接收回執，若回執狀態為成功，但是否可變更狀態為否。此時生產追溯系統向系統管理員及相關人員發送通知處理結果作廢反饋發送失敗的消息，由系統管理員及相關人員采取相應的處理措施；d)生產追溯系統收到交互系統的通知處理結果作廢反饋的接收回執，回執狀態為成功，且是否可變更狀態為是，生產追溯系統將更新相應通知處理結果狀態為“作廢”。圖9處理結果作廢反饋流程T/YNZYC0099—20235.6.2處理結果作廢接收與回執交互系統接收到生產追溯系統的通知處理結果作廢反饋后，須及時解析相應的數據格式，并及時向生產追溯系統反饋通知處理結果作廢的接收回執信息。其處理方式分以下兩種情況：a)數據格式解析異常則須及時向生產追溯系統反饋接收失敗回執；b)數據格式解析正常，交互系統須及時判斷本地相應通知處理結果是否可作廢。若能作廢，須及時向交互系統反饋可作廢的回執，并及時變更相應通知處理結果狀態為作廢狀態；若不能作廢，須及時向生產追溯系統反饋不可作廢的回執。業務處理流程如圖11所示：圖11通知處理結果作廢反饋接收與回執流程T/YNZYC0099—2023應用接口示例A.1通知、反饋接收回執XML格式<?xmlversion="1.0"encoding="gb2312"?><msg><head><f_info_id>value</f_info_id><f_release>v0.1</f_release><f_info_type>3</f_info_type><f_time>2016/06/0100:00:00</f_time><f_remark01/></head><data><tabletablename=“”section=“4”tabletype=“0”f_info_id=“消息id”f_state=“回執狀態”f_is_operate=“可操作狀態”f_describe=“回執信息描述”f_remark01=“備用字段1”><rowaction=“insert”f_info_id=“”f_state=“”f_is_operate=“”f_describe=“”f_remark01=“”/></table></data></msg>A.2消息訪問通知XML格式<?xmlversion="1.0"encoding="gb2312"?><msg><head><f_info_id>value</f_info_id><f_release>v0.1</f_release><f_info_type>1</f_info_type><f_time>2016/06/0100:00:00</f_time><f_remark01/></head><data><tabletablename=“”section=“4”tabletype=“1”f_task_id=“通知id”f_task_code=“通知編號”f_task_time=“通知時間”f_item_code=“數據項”f_item_name=“數據名稱”f_unit=“計量單位”f_class_code=“班次”f_work_group=“工作組”f_enterprise_code=“藥企”f_factory_code=“工廠f_process_code=“工藝環節”f_work_unit=“工作單元”f_process_period=“過程段”f_site=“取值點”f_value=“取值規范”f_f_task_state=“通知狀態”f_order_no=“順序號”f_remark01=“備用字段1”f_remark02=“備用字段2”f_remark03=“備用字段3”f_remark04=“備用字段4”><rowaction=“insert”f_task_id=“”f_task_code=“”f_task_time=“”f_item_code=“”f_item_name=“”f_unit=“”f_class_code=“”f_work_group=“”f_enterprise_code=“”f_factory_code=“”f_process_code=“”f_work_unit=“”f_process_period=“”f_site=“”f_samp_demand=“”f_task_state=“”f_order_no=“”f_remark01=“”f_remark02=“”f_remark03=“”f_remark04=“”/><rowaction=“insert”f__task_id=“”f__task_code=“”f_task_time=“”f_item_code=“”f_item_name=“”f_unit=“”f_class_code=“”f_work_group=“”f_enterprise_code=“”f_factory_code=“”f_process_code=“”f_work_unit=“”f_process_period=“”f_site=“”f_samp_demand=“”f_task_state=“”f_order_no=“”f_remark01=“”f_remark02=“”f_remark03=“”f_remark04=“”/></table></data></msg>A.3通知狀態變更通知XML格式<?xmlversion="1.0"encoding="gb2312"?><msg><head><f_info_id>value</f_info_id><f_release>v0.1</f_release><f_info_type>1</f_info_type><f_time>2016/06/0100:00:00</f_time><f_remark01/></head><data><tabletablename=“”section=“4”tabletype=“2”f_task_id=“通知id”f_task_code=“通知號”f_task_state=“通知狀態”f_reason=“變更原因”f_remark01=“備用字段1”f_remark02=“備用字段2”f_remark03=“備用字段3”f_remark04=“備用字段4”><rowaction=“insert”f_qc_task_id=“”f_task_code=“”f_task_state=“”f_reason=“”f_remark01=“”f_remark02=“”f_remark03=“”f_remark04=“”></table></data></msg>A.4通知處理狀態反饋XML格式<?xmlversion="1.0"encoding="gb2312"?><msg><head><f_info_id>value</f_info_id><f_release>v0.1</f_release><f_info_type>1</f_info_type><f_time>2016/06/0100:00:00</f_time><f_remark01/></head><data><tabletablename=“”section=“4”tabletype=“3”f_task_id=“通知id”f_task_code=“通知號”f_task_state=“通知狀態”f_reason=“變更原因”f_remark01=“備用字段1”f_remark02=“備用字段2”f_remark03=“備用字段3”f_remark04=“備用字段4”><rowaction=“insert”f_task_id=“”f_task_code=“”f_task_state=“”f_reason=“”f_remark01=“”f_remark02=“”f_remark03=“”f_remark04=“”></table></data></msg>A.5通知處理狀態反饋XML格式<?xmlversion="1.0"encoding="gb2312"?><msg><head><f_info_id>value</f_info_id><f_release>v0.1</f_release><f_info_type>1</f_info_type><f_time>2016/06/0100:00:00</f_time><f_remark01/></head><data><tabletablename=“”section=“4”tabletype=“41”f_result_id=“結果id”f_batch_number=“批次號”f_batch_code=“標簽編碼”f_tag_type=“標簽類型”f_site_code=“取值點”f_class_code=“班次”f_work_group=“工作組”f_samp_method=“取值方法”f_value=“結果值”f_samp_time=“取值時間”f_operate_user=“操作員”f_describe=“備注”f_samp_state=“結果狀態”f_remark01=“備用字段1”f_remark02=“備用字段2”f_remark03=“備用字段3”f_remark04=“備用字段4”><rowaction=“insert”f_result_id=“”f_batch_number=“”f_tag_code=“”f_tag_type=“”f_site_code=

溫馨提示

  • 1. 本站所有資源如無特殊說明，都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
  • 2. 本站的文檔不包含任何第三方提供的附件圖紙等，如果需要附件，請聯系上傳者。文件的所有權益歸上傳用戶所有。
  • 3. 本站RAR壓縮包中若帶圖紙，網頁內容里面會有圖紙預覽，若沒有圖紙預覽就沒有圖紙。
  • 4. 未經權益所有人同意不得將文件中的內容挪作商業或盈利用途。
  • 5. 人人文庫網僅提供信息存儲空間，僅對用戶上傳內容的表現方式做保護處理，對用戶上傳分享的文檔內容本身不做任何修改或編輯，并不能對任何下載內容負責。
  • 6. 下載文件中如有侵權或不適當內容，請與我們聯系，我們立即糾正。
  • 7. 本站不保證下載資源的準確性、安全性和完整性, 同時也不承擔用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。

評論

0/150

提交評論