Q∕GDW 12122.2-2021 數(shù)據(jù)應用服務規(guī)范 第2部分：開放目錄規(guī)范

1、ICS 35. 240Q/GDW國家電網(wǎng)有限公司企業(yè)標準Q/GDW 12122. 22021數(shù)據(jù)應用服務規(guī)范第2部分開放目錄規(guī)范Data application service specificationPart2: Open directory specification2021 -06-25 實施國家電網(wǎng)有限公司 發(fā)布Q/GDW 12122. 22021目 次tti Wii1 翻l2 規(guī)范性引用文件13術i吾轍5C14鵬i吾25開放服務目錄格式要求25. 1開放服務分類標準25.2服務目錄元數(shù)據(jù)規(guī)范25.3服務目錄編碼標準26開放服務目錄建設要求36. 1功能要求36. 2技術要求46.

2、3安全要求46. 4集成要求46. 5部署要求47開放服務目錄檢索要求47. 1服務檢索方式47.2 服務檢索內容4附錄A （資料性附錄） 服務目錄元數(shù)據(jù)規(guī)范表6綱側7IQ/GDW 12122.22021一一第1部分 一一第2部分 一一第3部分 一一第4部分第5部分一一第6部分 一一第7部分 一一第8部分 一一第9部分為規(guī)范國家電網(wǎng)有限公司（以下簡稱公司）開放服務目錄格式要求，開放服務目錄建設要求，開放 服務目錄檢索要求，開放服務共享應用要求，開放服務運行監(jiān)測要求，在合規(guī)的前提下，保障數(shù)據(jù)服務 目錄的規(guī)范可用，制定本部分。數(shù)據(jù)應用服務規(guī)范標準分為10個部分:總則； 開放目錄規(guī)范； 數(shù)據(jù)分類分級

3、規(guī)范; 數(shù)據(jù)脫敏規(guī)范； 全鏈路監(jiān)測規(guī)范； 數(shù)據(jù)服務規(guī)范； 數(shù)據(jù)標簽規(guī)范； 數(shù)據(jù)分析規(guī)范； 數(shù)據(jù)開放共享規(guī)范;一一第10部分：能力成熟度評價規(guī)范。本部分為數(shù)據(jù)應用服務規(guī)范標準的第2部分。本部分由國家電網(wǎng)有限公司互聯(lián)網(wǎng)部提出并解釋。本部分由國家電網(wǎng)有限公司科技部歸口。本部分起草單位：國家電網(wǎng)有限公司大數(shù)據(jù)中心、國網(wǎng)山東省電力公司、國網(wǎng)浙江省電力有限公司、 國網(wǎng)福建省電力有限公司、國網(wǎng)四川省電力公司、國網(wǎng)內蒙古東部電力有限公司、國網(wǎng)重慶市電力公司、 國網(wǎng)陜西省電力公司、國網(wǎng)甘肅省電力公司、國網(wǎng)青海省電力公司、國網(wǎng)信息通信產業(yè)集團有限公司、 全球能源互聯(lián)網(wǎng)研究院有限公司、南瑞集團有限公司。本部分主要起

4、草人：王宏剛、劉識、張帆、楊志、胡錫雙、張舒、林曉靜、周春雷、王勇、王震、 王澍、羅富財、楊帆、王沖、王磊、尹心、司恒斌、蘇蕊、閆潤珍、韓良煜、王婭云、徐欣杰、王曉慧、 董新微。本部分首次發(fā)布。本部分在執(zhí)行過程中的意見或建議反饋至國家電網(wǎng)有限公司科技部。#Q/GDW 12122.220219數(shù)據(jù)應用服務規(guī)范 第2部分：開放目錄規(guī)范1范圍本部分規(guī)定了國家電網(wǎng)有限公司（以下簡稱公司）開放服務目錄格式要求，開放服務目錄建設要求， 開放服務目錄檢索要求等內容。本部分適用于指導公司開放服務目錄的建設和應用。2規(guī)范性引用文件下列文件對于本文件的應用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本

5、文件。 凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。信息安全技術網(wǎng)絡安全等級保護基本要求信息安全技術網(wǎng)絡安全等級保護定級指南信息安全技術應用軟件系統(tǒng)通用安全技術要求信息安全技術信息安全技術信息安全技術GB/TGB/TGB/TGB/TGB/TGB/T222392224028452311683527936639云計算服務安全能力要求 云計算安全參考架構可信計算規(guī)范服務器可信支撐平臺3術語和定義下列術語和定義適用于本文件。3. 1開放服務目錄open serv i ce d i rectory將公司對外開放的數(shù)據(jù)服務，采用信息化方式，以目錄的形式組織起來，通過批量數(shù)據(jù)接口服務

6、、 API接口的形式，支持數(shù)據(jù)服務的調用。3. 2開放服務目錄元數(shù)據(jù) open serv i ce d i rectory metadata用于描述數(shù)據(jù)服務目錄的數(shù)據(jù)，如數(shù)據(jù)服務發(fā)布者、使用對象、應用場景等數(shù)據(jù)，通過元數(shù)據(jù)來描 述公司的各項數(shù)據(jù)服務。3. 3應用程序接口 app I i cat i on program i nterface一組定義、程序及協(xié)議的集合，通常是指一些預先定義的函數(shù)，或指軟件系統(tǒng)不同組成部分銜接的 約定。3. 4統(tǒng)_權限管理平臺 unified author ity management p I atform包括統(tǒng)一身份、統(tǒng)一認證管理、統(tǒng)一授權與安全審計四個核心功能

7、模塊，實現(xiàn)人員身份管理、組織 機構管理、授權管理、合規(guī)性管理、安全審計等模塊功能，實現(xiàn)統(tǒng)一管理、流程規(guī)范、過程受控、備案 審查的目標的用戶權限管理系統(tǒng)。4縮略語下列縮略語適用于本文件。API:應用程序接口 （Application Programming Interface）ISC：統(tǒng)一權限管理平臺（Identity Security Control Platform）5開放服務目錄格式要求5. 1開放服務分類標準數(shù)據(jù)服務采用權限等級控制方式，為系統(tǒng)內外用戶提供不同服務。主要服務方式有基礎數(shù)據(jù)查詢服 務、挖掘分析產品服務以及自助分析查詢服務、批量數(shù)據(jù)接口服務、API服務、分析報告服務。具體分

8、類如下：a）基礎數(shù)據(jù)查詢服務：用戶可根據(jù)業(yè)務需求提出權限申請，進行業(yè)務場景需求基礎數(shù)據(jù)或簡單的 加工數(shù)據(jù)查詢，不支持數(shù)據(jù)導出服務；b）數(shù)據(jù)挖掘服務：系統(tǒng)根據(jù)用戶業(yè)務需求為用戶提供數(shù)據(jù)應用集業(yè)務場景推薦，用戶可直接應用 系統(tǒng)的數(shù)據(jù)應用集業(yè)務場景模型開展數(shù)據(jù)挖掘分析工作，并支持分析結果導出服務；c）自助分析服務：一是用戶可基于系統(tǒng)現(xiàn)有數(shù)據(jù)應用集及數(shù)據(jù)，根據(jù)實際需求進行數(shù)據(jù)應用集組 合查詢及構建；二是系統(tǒng)可根據(jù)用戶需求，提供定制化數(shù)據(jù)應用集構建服務；d）批量數(shù)據(jù)接口服務：批量數(shù)據(jù)接口服務是針對用戶一次請求返回數(shù)據(jù)規(guī)模較大、時效性要求較 低、訪問頻度較低、安全可控性低的批量數(shù)據(jù)服務；e）分析報告服務：

9、根據(jù)用戶需求，按照固定周期或不定期單次請求輸出成品的數(shù)據(jù)分析報告，供 用戶下載或線下提交給用戶使用。5.2服務目錄元數(shù)據(jù)規(guī)范描述數(shù)據(jù)服務目錄所使用的元數(shù)據(jù)及其規(guī)范，用于說明描述服務目錄所使用的字段，包含數(shù)據(jù)服務 名稱、應用場景、分類信息、應用信息、發(fā)布信息、健康狀態(tài)等，完整的元數(shù)據(jù)規(guī)范示例參見附錄A （資 料性附錄）服務目錄元數(shù)據(jù)規(guī)范表。5. 3服務目錄編碼標準5. 3. 1服務目錄編碼原則服務目錄編碼是通過一組數(shù)字、字母、符號等組成的字符串去唯一標識公司內部每一個數(shù)據(jù)服務， 基于此唯一標識，保證各業(yè)務領域對同一數(shù)據(jù)服務的理解和使用的一致，它的設計遵循以下原則：a）統(tǒng)一性原則：公司內部只能使用

10、一套數(shù)據(jù)服務編碼，以方便不同業(yè)務部門之間的溝通和數(shù)據(jù)的 交換；b）唯一性原則：每一個數(shù)據(jù)服務只能有唯一一個數(shù)據(jù)服務編碼進行標識，不同數(shù)據(jù)服務編碼不允 許重復，同一個編碼也只能唯一對應到一個數(shù)據(jù)服務上；c）可讀性原則：數(shù)據(jù)服務編碼作為數(shù)據(jù)服務分類、檢索的關鍵詞和索引，需要具備一定的可讀性， 讓用戶通過編碼可以初步判斷其對應的數(shù)據(jù)服務；d）擴展性原則：數(shù)據(jù)服務的編碼要適當考慮數(shù)據(jù)服務管理未來幾年的業(yè)務發(fā)展趨勢，其編碼長度 要留有適當?shù)臄U展可能而不影響整個編碼體系。5. 3. 2服務目錄編碼規(guī)則采用混合分類方法，對數(shù)據(jù)服務進行分類，主要通過以下四個方面進行分類編碼：a）行政區(qū)劃：總部、省（市）級公司

11、、地市級公司；b）服務分類：業(yè)務領域、分析方法、關鍵技術；c）應用場景：內外部應用場景分類；d）服務時間：年、月、日、時、分。編碼方法：編碼采用4層結構，如圖1所示：XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX圖1服務目錄編碼規(guī)則圖6開放服務目錄建設要求6. 1功能要求功能要求具體如下：a）目錄信息收集：按照公司的相關規(guī)定和要求，對在數(shù)據(jù)共享負面清單里的數(shù)據(jù)服務，按照服務 目錄格式要求，收集、獲取相關的信息，自動形成開放服務的目錄信息；b）開放服務目錄發(fā)布：根據(jù)開放服務的目錄信息，以目錄分類標準、元數(shù)據(jù)規(guī)范、編碼標準為依 據(jù)，自動形成開放服務目錄并進行發(fā)布；c）開放服務目錄維護

12、功能：對開放服務目錄的信息進行維護，根據(jù)數(shù)據(jù)服務建設情況，對開放服 務目錄進行動態(tài)更新；d）權限管理：為不同的用戶，提供不同的數(shù)據(jù)服務的訪問權限，包含檢索、調用的權限等。6.2技術要求為實現(xiàn)數(shù)據(jù)共享和便捷應用，采用國網(wǎng)云平臺和數(shù)據(jù)中臺進行開放服務目錄的建設。具體要求如下：a）服務API接口技術要求：為提升不同平臺不同類型數(shù)據(jù)共享能力，服務API接口要保障系統(tǒng)各 部分各單元的內聚性，降低組成單元間的耦合程度，應用編程接口需保障系統(tǒng)的可維護性和可 擴展性；同時，遵循API命名規(guī)范、域名規(guī)范、API路徑規(guī)范及版本控制規(guī)范；b）消息格式接口規(guī)范：為保障數(shù)據(jù)交互安全，數(shù)據(jù)交互應采用鏈路加密手段；每個項目

13、要有且僅 有一個自己唯一的域名和端口，符合域名規(guī)范；同時保證API路徑規(guī)范，必須在路徑中添加 API目錄。6. 3安全要求業(yè)務應用的安全要求應滿足GB/T 22239 GB/T 22240, GB/T 28452、GB/T 31168、GB/T 35279和GB/T 36639的要求。6. 4集成要求與國網(wǎng)云平臺和數(shù)據(jù)中臺進行集成，可以將數(shù)據(jù)中臺服務注冊到開放服務目錄；與ISC進行集成， 進行統(tǒng)一的權限控制。6.5部署要求數(shù)據(jù)分析服務部署前應在具備CNAS資質的機構中完成功能、性能和安全措施測試；數(shù)據(jù)分析服務應 部署在國網(wǎng)云平臺或數(shù)據(jù)中臺。7開放服務目錄檢索要求7. 1服務檢索方式應支持服務使

14、用者從本地、遠程查詢所需服務數(shù)據(jù)；應支持目錄樹、關鍵字、熱點服務等檢索方式， 應支持模糊查詢、組合條件等檢索方式，應提供標準檢索接口和人機交互檢索界面等服務形式。具體要 求如下：a）目錄樹一一根據(jù)服務目錄樹逐層定位檢索；b）關鍵字根據(jù)服務名稱集中定位檢索；c）熱點服務根據(jù)服務檢索頻率快速檢索；d）組合條件一一根據(jù)組合條件快速檢索。7.2服務檢索內容服務檢索內容一般包括（不限于）：服務名稱、服務接口、服務屬性、功能說明、訪問地址、服務 提供方、訪問策略、應用場景、模型描述等。服務檢索內容組織方式如下：a）采用分級方式展示檢索內容；b）一級展示內容應展示對數(shù)據(jù)服務的概要描述信息，應包含服務創(chuàng)始人，

15、服務應用場景，服務業(yè) 務價值等；c）二級展示內容應展示數(shù)據(jù)服務的詳細信息，應包含采用的數(shù)據(jù)、應用的模型、模型結果、應用 形式等。附錄A（資料性附錄）服務目錄元數(shù)據(jù)規(guī)范表表A. 1服務目錄元數(shù)據(jù)規(guī)范表數(shù)據(jù)服務名稱：【數(shù)據(jù)服務唯一的中文名稱】應用場景：【用于描述數(shù)據(jù)服務的應用場景】分類信息一級主題：【數(shù)據(jù)服務的一級分類】二級主題：【數(shù)據(jù)服務的二級分類】三級主題：【數(shù)據(jù)服務的三級分類】應用fe息功能描述：【用于描述數(shù)據(jù)服務所實現(xiàn)的功能】應用次數(shù)：【數(shù)據(jù)服務的應用次數(shù)】開放權限：【數(shù)據(jù)服務可以應用的范圍，部門/省內/全國】內容概述：【用于描述數(shù)據(jù)服務的功能】數(shù)據(jù)來源系統(tǒng)：【用于描述數(shù)據(jù)服務的數(shù)據(jù)來源信

16、息】調用方式：【用于描述數(shù)據(jù)服務調用方式、接a、參數(shù)】發(fā)布單位：【發(fā)布單位中文名稱】發(fā)布部門：【發(fā)布部門中文名稱】發(fā)布信息發(fā)布人：【發(fā)布責任人】公開等級：【數(shù)據(jù)集的公開等級（部門/省內/全國）1發(fā)布曰期：【數(shù)據(jù)集的發(fā)布日期】更新曰期：【數(shù)據(jù)集更新日期】數(shù)據(jù)集形式：【數(shù)據(jù)集接入的形式，如api等】數(shù)據(jù)應用服務規(guī)范第2部分開放目錄規(guī)范目 次1 _髖92 編制主要原則93與其他標準文件的關系94主要工作過程95 標準結構和內容96 紋側101 編制背景本部分依據(jù)國家電網(wǎng)有限公司關于下達2020年第一批技術標準制修訂計劃的通知（國家電網(wǎng) 科2020） 21號）文的要求編寫。本部分的編制背景為建立數(shù)據(jù)應

17、用服務的開放目錄規(guī)范，從而解決數(shù)據(jù)服務開放目錄不統(tǒng)一、難以 管理等問題。本部分編制的主要目的是指導公司開放服務目錄的建設和應用。2 編制主要原則本部分主要根據(jù)以下原則編制：a）堅持先進性與實用性相結合、統(tǒng)一性與靈活性相結合、可靠性與經濟性相結合的原則，以標準 化為引領，服務公司科學發(fā)展；b）認真研宄國內外現(xiàn)行相關的IEC標準、國家標準、行業(yè)標準、企業(yè)標準，保障目錄規(guī)范具有先 進性；c）嚴格按照國網(wǎng)互聯(lián)網(wǎng)部相關對于數(shù)據(jù)應用服務的措施，制定開放目錄編制的技術要求和管理要 求。3 與其他標準文件的關系本部分與相關技術領域的國家現(xiàn)行法律、法規(guī)和政策保持一致。本部分不涉及專利、軟件著作權等知識產權問題。

18、本部分引用了 GB/T 22239-2008中的相關規(guī)定。4 主要工作過程2020年5月，成立標準編寫小組，收集國際/國內標準及相關資料，召開啟動會，討論標準框架及內 容組成。2020年5月底，完成標準大綱編寫，組織召開大綱研討會，形成標準大綱。2020年6月，完成標準初稿編寫，召開第一次專家研討會，根據(jù)與會專家意見，修改完善本標準， 形成征求初步標準。2020年10月，召開第二次專家研討會，根據(jù)與會專家意見，修改完善本標準，形成征求意見稿。 2020年10月，根據(jù)征求的意見，對征求意見稿（初稿）進一步修改形成標準送審稿。2020年11月，公司互聯(lián)網(wǎng)技術標準專業(yè)工作組在北京組織召開了標準審查會，審查結論為：審查組 經過協(xié)商一致，同意修改后報批。2020年11月，修改形成標準報批稿。5 標準結構和內容數(shù)據(jù)應用服務規(guī)范分為下列10個部分：第1部分：總則；一一第2部分 一一第3部分 一一第4部分第5咅P分一一第6部分 一一第7部分 一一第8部分 一一第9部分開放目錄規(guī)范； 數(shù)據(jù)分類分級規(guī)范； 數(shù)據(jù)脫敏規(guī)范； 全鏈路監(jiān)測規(guī)范； 數(shù)據(jù)