ICS35.240.99

CCSA18

DB4403

深圳市地方標(biāo)準(zhǔn)

DB4403/T198—2021

課堂教學(xué)行為數(shù)據(jù)交換規(guī)范

Dataexchangespecificationforclassroomteachingbehavior

2021-11-16發(fā)布2021-12-01實(shí)施

深圳市市場(chǎng)監(jiān)督管理局發(fā)布

DB4403/T198—2021

課堂教學(xué)行為數(shù)據(jù)交換規(guī)范

1范圍

本文件規(guī)定了課堂教學(xué)行為的框架與課堂教學(xué)行為數(shù)據(jù)交換的基本要求、交換要求和數(shù)據(jù)要求。

本文件適用于深圳市中小學(xué)市、區(qū)、校三級(jí)課堂教學(xué)行為信息的數(shù)據(jù)交換，支撐深圳市實(shí)現(xiàn)對(duì)教學(xué)

行為數(shù)據(jù)的記錄、追蹤和分析以及開(kāi)展教學(xué)過(guò)程性評(píng)價(jià)，指導(dǎo)差異化教學(xué)。

2規(guī)范性引用文件

本文件沒(méi)有規(guī)范性引用文件。

3術(shù)語(yǔ)和定義

下列術(shù)語(yǔ)和定義適用于本文件。

3.1

課堂classroom

中小學(xué)教師進(jìn)行教學(xué)活動(dòng)的物理空間。

3.2

教學(xué)行為instructionalbehavior

教學(xué)活動(dòng)中的一系列圍繞教學(xué)內(nèi)容展開(kāi)的教與學(xué)行為。

3.3

數(shù)據(jù)交換dataexchange

數(shù)據(jù)采集及交換的技術(shù)行為。

3.4

學(xué)習(xí)者learner

依靠學(xué)習(xí)技術(shù)系統(tǒng)獲取知識(shí)或技能的個(gè)體。

3.5

教師teacher

依靠學(xué)習(xí)技術(shù)系統(tǒng)傳遞知識(shí)或技能的個(gè)體。

3.6

學(xué)習(xí)行為learningbehavior

學(xué)習(xí)活動(dòng)中的一系列行為。

1

DB4403/T198—2021

3.7

知識(shí)點(diǎn)knowledgepoint

知識(shí)、理論、道理、思想等的相對(duì)獨(dú)立的最小單元，是課程中信息傳遞的基本單元。

3.8

互動(dòng)類(lèi)型interacttype

教師與學(xué)習(xí)者借助技術(shù)手段進(jìn)行的交互方式。

4課堂教學(xué)行為框架

4.1課堂教學(xué)行為框架

框架包括課堂教學(xué)行為、課堂學(xué)習(xí)行為、課堂教育資源，見(jiàn)圖1。

圖1課堂教學(xué)行為框架

4.2課堂教學(xué)行為

課堂教學(xué)行為分為：

——教學(xué)準(zhǔn)備行為：記錄教師課前的相關(guān)教學(xué)準(zhǔn)備行為，包括登錄和備課等行為；

——教學(xué)組織行為：記錄教師組織教學(xué)的行為，包括開(kāi)課、授課，下發(fā)練習(xí)、測(cè)試和作業(yè)等行為；

——課堂交互行為：記錄教師引導(dǎo)、激勵(lì)學(xué)生學(xué)習(xí)的行為，發(fā)起討論、投票、搶答、隨機(jī)選人作答、

全班作答、資源分享、教學(xué)答疑和輔導(dǎo)等行為；

——評(píng)價(jià)反饋行為：記錄教師對(duì)學(xué)習(xí)者評(píng)價(jià)的行為，包括查看學(xué)生的作業(yè)、作品、測(cè)試和考試，評(píng)

價(jià)學(xué)生的作業(yè)等行為。

4.3課堂教育資源

課堂教育資源分為：

——教學(xué)資源：教師上課使用的教材資源，包括電子書(shū)、備課、授課等教學(xué)活動(dòng)中使用的資源；

——試題資源：考試、練習(xí)、測(cè)驗(yàn)中使用的題目資源。

2

DB4403/T198—2021

4.4課堂學(xué)習(xí)行為

課堂學(xué)習(xí)行為分為（數(shù)據(jù)應(yīng)符合附錄A的規(guī)定）：

——學(xué)習(xí)軌跡行為：記錄學(xué)習(xí)者的操作行為鏈（點(diǎn)擊流），包括登錄、退出、提交等對(duì)系統(tǒng)頁(yè)面操

作的行為；

——資源學(xué)習(xí)行為：記錄學(xué)習(xí)者學(xué)習(xí)的資源以及對(duì)資源進(jìn)行的操作，包括瀏覽、使用、上傳、下載

學(xué)習(xí)資源等行為；

——課堂交互行為：記錄學(xué)習(xí)者與其他學(xué)習(xí)者、教師、管理員的交流行為，包括發(fā)起提問(wèn)、資源分

享等行為；

——評(píng)價(jià)反思行為：記錄學(xué)習(xí)者參與測(cè)試、評(píng)價(jià)的行為，包括完成并提交練習(xí)、課堂實(shí)驗(yàn)、作業(yè)和

測(cè)試，完成互評(píng)和錯(cuò)題訂正，對(duì)自我、同伴、教師進(jìn)行評(píng)價(jià)等行為。

5總體要求

5.1數(shù)據(jù)項(xiàng)組成

元數(shù)據(jù)結(jié)構(gòu)如下：

——中文簡(jiǎn)稱(chēng)：所用的數(shù)據(jù)元素的名稱(chēng)，具有語(yǔ)義，面向用戶(hù)；

——數(shù)據(jù)項(xiàng)名：通常由中文簡(jiǎn)稱(chēng)的漢語(yǔ)拼音首字母（大寫(xiě)）組成，與中文簡(jiǎn)稱(chēng)一一對(duì)應(yīng)，宜在實(shí)際

數(shù)據(jù)結(jié)構(gòu)中采用；

——類(lèi)型：數(shù)據(jù)項(xiàng)容納的數(shù)據(jù)類(lèi)型，本文件在數(shù)據(jù)項(xiàng)中簡(jiǎn)稱(chēng)其為類(lèi)型（一種屬性）；

——長(zhǎng)度：數(shù)據(jù)項(xiàng)能容納的最大字符數(shù)（一種屬性）；

——約束：數(shù)據(jù)項(xiàng)約束狀態(tài)的描述，即必備數(shù)據(jù)項(xiàng)或可選數(shù)據(jù)項(xiàng)（一種屬性）；

——解釋/舉例：數(shù)據(jù)項(xiàng)屬性的說(shuō)明或舉例。

5.2數(shù)據(jù)類(lèi)型

5.2.1字符型

字符型為C，在信息系統(tǒng)中取用時(shí)，可以是可變長(zhǎng)度。

5.2.2數(shù)值型

數(shù)值型為N，可參與運(yùn)算。

5.2.3二進(jìn)制類(lèi)型

二進(jìn)制類(lèi)型為B，宜在照片或超長(zhǎng)文本使用。

5.2.4文本型

文本型為T(mén)，用于數(shù)量較多的文字描述。數(shù)據(jù)值長(zhǎng)度大于1000字符時(shí)應(yīng)采用文本型。

5.3約束

數(shù)據(jù)約束條件有可選數(shù)據(jù)元素O和必備數(shù)據(jù)元素M兩種。

5.4時(shí)間格式定義

系統(tǒng)定義的時(shí)間格式為年-月-日時(shí)：分：秒（yyyy-MM-ddHH:mm:ss）。

3

DB4403/T198—2021

5.5數(shù)據(jù)傳輸方式

結(jié)構(gòu)化數(shù)據(jù)采取文本形式傳輸；非結(jié)構(gòu)化數(shù)據(jù)（如視頻類(lèi)、音頻類(lèi)）采用文件方式進(jìn)行數(shù)據(jù)傳輸，

采取二進(jìn)制形式存儲(chǔ)。

6交換要求

6.1基本要求

6.1.1數(shù)據(jù)交換對(duì)象是深圳市、區(qū)、校三級(jí)課堂教學(xué)信息系統(tǒng)的課堂教學(xué)行為數(shù)據(jù)。數(shù)據(jù)交換類(lèi)別包

括結(jié)構(gòu)化數(shù)據(jù)、非結(jié)構(gòu)化數(shù)據(jù)。其中，視頻、圖片、音頻、文檔類(lèi)等附件數(shù)據(jù)是非結(jié)構(gòu)化數(shù)據(jù)，文本信

息類(lèi)、數(shù)據(jù)庫(kù)表數(shù)據(jù)是結(jié)構(gòu)化數(shù)據(jù)。

6.1.2數(shù)據(jù)交換可采用不同的數(shù)據(jù)交換方式進(jìn)行（具體交換設(shè)計(jì)應(yīng)符合附錄B的規(guī)定），包括但不限于：

a)庫(kù)表交換；

b)資源文件交換；

c)服務(wù)接口交換。

6.2庫(kù)表交換

基于數(shù)據(jù)庫(kù)表結(jié)構(gòu)形式進(jìn)行數(shù)據(jù)交換，適用于大量歷史數(shù)據(jù)的交互或適用數(shù)據(jù)增量更新頻繁的數(shù)據(jù)

交換，結(jié)構(gòu)如圖2所示。

圖2基于數(shù)據(jù)庫(kù)的交換方式

6.3資源文件交換

6.3.1通過(guò)文件交換的形式進(jìn)行數(shù)據(jù)交換，適用于非結(jié)構(gòu)化資源或更新頻率比較緩慢的結(jié)構(gòu)化資源的

數(shù)據(jù)交換。結(jié)構(gòu)如圖3所示。

4

DB4403/T198—2021

圖3基于文件的交換方式

6.3.2資源文件交換方式基于前置機(jī)進(jìn)行網(wǎng)絡(luò)安全隔離，文件上傳和下載接口協(xié)議使用HTTPS協(xié)議，

通過(guò)提供訪(fǎng)問(wèn)的URL，用戶(hù)使用HTTPPOST方法發(fā)送請(qǐng)求。

6.4服務(wù)接口交換

6.4.1將數(shù)據(jù)服務(wù)封裝成接口，供數(shù)據(jù)使用方調(diào)用，適用于小數(shù)據(jù)量、實(shí)時(shí)性要求較高的數(shù)據(jù)交換，

結(jié)構(gòu)如圖4所示。

圖4服務(wù)接口交換方式

6.4.2服務(wù)數(shù)據(jù)交換采用RESTful風(fēng)格API，數(shù)據(jù)格式統(tǒng)一采用JSON格式，接口示例見(jiàn)附錄C。接口

協(xié)議采用Https，接口編碼采用UTF-8。安全驗(yàn)證應(yīng)根據(jù)授權(quán)用戶(hù)和密碼產(chǎn)生的隨機(jī)Token來(lái)訪(fǎng)問(wèn)各API。

接口數(shù)據(jù)的返回格式為JSON格式字符串，接口返回值數(shù)據(jù)格式應(yīng)符合表1的要求。

表1數(shù)據(jù)格式

JSON變量說(shuō)明

Success調(diào)用接口操作成功標(biāo)志，boolean值true、false

Code返回結(jié)果狀態(tài)標(biāo)識(shí)，0代表成功，1代表失敗

5

DB4403/T198—2021

表1數(shù)據(jù)格式（續(xù)）

JSON變量說(shuō)明

Message返回結(jié)果的文字說(shuō)明

Data返回的結(jié)果數(shù)據(jù)

7數(shù)據(jù)要求

7.1課堂教學(xué)行為數(shù)據(jù)基于框架拆解，主要包括但不限于以下數(shù)據(jù)：

a)用戶(hù)登錄信息，

b)教師開(kāi)課信息，

c)教師備課信息，

d)教師授課信息，

e)課堂互動(dòng)信息，

f)資源使用信息，

g)作業(yè)布置信息，

h)作業(yè)報(bào)告信息，

i)作業(yè)答題信息，

j)課堂測(cè)驗(yàn)信息，

k)課堂測(cè)驗(yàn)報(bào)告，

l)試題集信息，

m)題目信息，

n)知識(shí)點(diǎn)信息，

o)教材課本信息，

p)教學(xué)資源信息，

q)學(xué)習(xí)行為信息。

7.2元數(shù)據(jù)應(yīng)符合表2所示數(shù)據(jù)交換索引。

表2數(shù)據(jù)交換索引表

序號(hào)數(shù)據(jù)類(lèi)別數(shù)據(jù)信息具體數(shù)據(jù)要求

1學(xué)段信息見(jiàn)D.1

2年級(jí)信息見(jiàn)D.2

3學(xué)科信息見(jiàn)D.3

4基礎(chǔ)數(shù)據(jù)行政區(qū)信息見(jiàn)D.4

5學(xué)習(xí)者信息見(jiàn)D.5

6操作行為信息見(jiàn)D.6

7互動(dòng)類(lèi)型信息見(jiàn)D.7

6

DB4403/T198—2021

表2數(shù)據(jù)交換索引表（續(xù)）

序號(hào)數(shù)據(jù)類(lèi)別數(shù)據(jù)信息具體數(shù)據(jù)要求

8基礎(chǔ)數(shù)據(jù)資源來(lái)源信息見(jiàn)D.8

9用戶(hù)登錄信息見(jiàn)E.1

10教師開(kāi)課信息見(jiàn)E.2

11教師備課信息見(jiàn)E.3

12教師授課信息見(jiàn)E.4

13課堂互動(dòng)信息見(jiàn)E.5

14資源使用信息見(jiàn)E.6

15作業(yè)布置信息見(jiàn)E.7

16作業(yè)報(bào)告信息見(jiàn)E.8

課堂教學(xué)

17作業(yè)答題信息見(jiàn)E.9

行為數(shù)據(jù)

18課堂測(cè)驗(yàn)信息見(jiàn)E.10

19課堂測(cè)驗(yàn)報(bào)告見(jiàn)E.11

20試題集信息見(jiàn)E.12

21題目信息見(jiàn)E.13

22知識(shí)點(diǎn)信息見(jiàn)E.14

23教材課本信息見(jiàn)E.15

24教學(xué)資源信息見(jiàn)E.16

25學(xué)習(xí)行為信息見(jiàn)C.2

7

DB4403/T198—2021

附錄A

（規(guī)范性）

學(xué)習(xí)行為xAPI規(guī)范

A.1xAPI規(guī)范框架

A.1.1xAPI規(guī)范框架包括操作ID，操作者，動(dòng)作，對(duì)象，結(jié)果等，如圖A.1。

圖A.1xAPI用戶(hù)學(xué)習(xí)行為框架

A.1.2用戶(hù)學(xué)習(xí)行為元素

A.1.2.1操作ID

操作標(biāo)示符。操作ID是一個(gè)唯一標(biāo)識(shí)符，在一些不必要的場(chǎng)合可以省略。

A.1.2.2Actor

操作者。每一個(gè)學(xué)習(xí)行為、每一個(gè)學(xué)習(xí)活動(dòng)，都應(yīng)有一個(gè)提供者、參與者，代表的是誰(shuí)在學(xué)習(xí)、是

由誰(shuí)發(fā)起了這個(gè)活動(dòng)。

A.1.2.3Verb

動(dòng)作。表示操作者的具體操作行為。具體動(dòng)詞及其語(yǔ)義如表A.1。

表A.1xAPI動(dòng)作定義

動(dòng)作描述

Answered回答

Vote投票

Asked提問(wèn)

Attended參加

Commented評(píng)論

Completed完成

Login-out退出

Start開(kāi)始

Experienced經(jīng)歷

Failed失敗

Input輸入

8

DB4403/T198—2021

表A.1xAPI動(dòng)作定義（續(xù)）

動(dòng)作描述

Initialized初始化

Interacted交互

Launched發(fā)布

Passed通過(guò)

Failed未通過(guò)

Mastered掌握

See觀(guān)看

Preferred偏好

Registered注冊(cè)

Login-in登錄

Meeting會(huì)議

Responded響應(yīng)

Resumed繼續(xù)

Scored得分

Shared分享

Suspended暫停

Terminated結(jié)束

A.1.2.4Object

對(duì)象。對(duì)象中包含有兩個(gè)子屬性：操作對(duì)象編碼和操作對(duì)象名稱(chēng)。

A.1.2.5Result

結(jié)果。該屬性是可以擴(kuò)展的，它主要描述一些動(dòng)作結(jié)果，如得分、通過(guò)與否和完成進(jìn)度等。

A.1.2.6Context

上下文環(huán)境。該屬性提供一些活動(dòng)中的上下文信息,包括但不限于廠(chǎng)商名稱(chēng)、應(yīng)用名稱(chēng)、設(shè)備IP、

設(shè)備類(lèi)型、設(shè)備型號(hào)等。

A.1.2.7TimeStamp

活動(dòng)發(fā)生時(shí)間。

A.1.2.8StoredTime

記錄存儲(chǔ)時(shí)間。

A.1.2.9Authority

授權(quán)。出于對(duì)安全性的考慮，通常存儲(chǔ)的行為數(shù)據(jù)不是任何人都可以訪(fǎng)問(wèn)的。該屬性就是用來(lái)表明

哪些用戶(hù)可以訪(fǎng)問(wèn)某些行為，同時(shí)指定其有效性。

A.2xAPI數(shù)據(jù)格式

9

DB4403/T198—2021

具體xAPI數(shù)據(jù)格式標(biāo)準(zhǔn)見(jiàn)表A.2，接口示例見(jiàn)表A.3。

表A.2xAPI數(shù)據(jù)格式表

中文簡(jiǎn)稱(chēng)數(shù)據(jù)項(xiàng)名類(lèi)型長(zhǎng)度約束解釋/舉例

操作唯一標(biāo)識(shí)CZWYBSC50MUUID

操作者CZZC50Mjson格式

操作行為CZXWC50Mjson格式

操作對(duì)象CZDXC500Mjson格式

操作結(jié)果CZJGN11Ojson格式

上下文環(huán)境SXWHJC500Ojson格式

發(fā)生時(shí)間點(diǎn)FSSJC20M—

存儲(chǔ)時(shí)間CCSJC20M—

授權(quán)SQC20Ojson格式

表A.3xAPI數(shù)據(jù)接口說(shuō)明

接口服務(wù)地址https://{域名地址}/{接口服務(wù)}/v1/xAPIAction/userActionAccept

Http方法POST

接口說(shuō)明上報(bào)用戶(hù)觀(guān)看視頻信息

名稱(chēng)Data

方法參數(shù)說(shuō)明類(lèi)型String

說(shuō)明用戶(hù)登錄信息的JSON字符串，具體字段詳見(jiàn)xAPI數(shù)據(jù)格式表

Data{CZWYBS":"d50ab77f-0d19-448d-a20a-8dc6ece9ec8e",

"CZZ":"{\"YHXM\":\"王小川\",\"YHLXBM\":\"01\"}",

"CZXW":"{\"CZXW\":\"See\",\"CZXWMC\":\"觀(guān)看視頻\"}",

"CZDX":"{\"CZDXBM\":\"09\",\"CZDXMC\":\"詠鵝\"}",

"CZJG":"{\"result\":\"操作成功\"}",

"SXWHJ":"{\"DLIP\":\"55\",

\"YYMC\":\"***系統(tǒng)\"\",

\"YYTGS\":\"***（應(yīng)用提供商名稱(chēng)）\",

參數(shù)示例\"SBLX\":\"android平板\",

\"SBH\":\"9843b77f-954y-467h-i8t4-8dc6ece9ec7e\"}",

"FSSJ":"2020-10-1211:34:23",

"CCSJ":"2020-10-1211:36:33"}

\"SBLX\":\"android平板\",

\"SBH\":\"9843b77f-954y-467h-i8t4-8dc6ece9ec7e\"}",

"FSSJ":"2020-10-1211:34:23",

"CCSJ":"2020-10-1211:36:33"}

TokenA876CA03-7392-3971-7832-3D65DD0DRT3T

{"success"：true,

返回值樣例成功"code":0,

"message"："同步數(shù)據(jù)成功",

10

DB4403/T198—2021

表A.3xAPI數(shù)據(jù)接口說(shuō)明（續(xù)）

成功"data"：[]}

{"success"：false，

返回值樣例"code":1，

失敗

"message"："同步數(shù)據(jù)失敗"，

"data"：[]}

11

DB4403/T198—2021

附錄B

（規(guī)范性）

數(shù)據(jù)交換設(shè)計(jì)

B.1資源文件交換接口要求

B.1.1上傳文件接口要求

上傳文件接口應(yīng)符合表B.1的要求。

表B.1上傳文件接口要求

上傳文件接口參數(shù)參數(shù)說(shuō)明

uploadPath指定上傳目錄（根路徑+相對(duì)路徑）

https://ip:端口fileName上傳文件名稱(chēng)

/fileUploaduserName使用賬戶(hù)

appSecret授權(quán)密鑰

B.1.2下載文件接口要求

下載文件接口應(yīng)符合表B.2的要求。

表B.2下載文件接口要求

上傳文件接口參數(shù)參數(shù)說(shuō)明

targetFile文件下載路徑絕對(duì)路徑

https://ip:端口

userName使用賬戶(hù)

/fileDownload

appSecret授權(quán)密鑰

B.1.3服務(wù)端返回狀態(tài)

服務(wù)端返回調(diào)用結(jié)果返回狀態(tài)碼見(jiàn)表B.3。

表B.3服務(wù)端返回狀態(tài)碼

狀態(tài)碼狀態(tài)說(shuō)明

200調(diào)用成功

400鑒權(quán)異常：用戶(hù)不存在、用戶(hù)密碼錯(cuò)誤

401參數(shù)為空

402下載文件不存在、上傳時(shí)創(chuàng)建文件夾失敗

B.2交換服務(wù)方安全要求

B.2.1交換事務(wù)標(biāo)識(shí)

應(yīng)對(duì)每次數(shù)據(jù)交換指定具有唯一性的交換事務(wù)標(biāo)識(shí)。

12

DB4403/T198—2021

B.2.2身份鑒別

通過(guò)身份鑒別保證數(shù)據(jù)交換的安全性，要求如下：

a)應(yīng)對(duì)數(shù)據(jù)交換兩端進(jìn)行用戶(hù)身份鑒別，確保數(shù)據(jù)交換兩端身份的真實(shí)性；

b)應(yīng)采用如用戶(hù)名/口令、一次性口令、數(shù)字證書(shū)、標(biāo)識(shí)密碼等技術(shù)實(shí)現(xiàn)交換兩端的用戶(hù)身份鑒

別。

B.2.3安全傳輸

安全傳輸?shù)囊笕缦拢?/p>

a)應(yīng)采用密碼技術(shù)保證數(shù)據(jù)傳輸通道安全，保證傳輸數(shù)據(jù)的保密性和完整性；

b)應(yīng)采用符合國(guó)家相關(guān)標(biāo)準(zhǔn)規(guī)定的數(shù)據(jù)加密方式與密碼算法；

c)應(yīng)確保安全通道和身份鑒別過(guò)程的關(guān)聯(lián)性；應(yīng)保證通道安全協(xié)議執(zhí)行過(guò)程中被認(rèn)證方與需認(rèn)證

方身份信息具有真實(shí)對(duì)應(yīng)關(guān)系，或者保證在已建立的安全通道內(nèi)執(zhí)行對(duì)使用方一端的身份鑒

別；

d)應(yīng)在交換完成后清除通道歷史緩存數(shù)據(jù)；

e)應(yīng)定期檢查或評(píng)估數(shù)據(jù)流動(dòng)通道的安全性和可靠性。

B.2.4操作抗抵賴(lài)

交換敏感類(lèi)數(shù)據(jù)對(duì)操作扛抵賴(lài)性的要求如下：

a)在交換敏感類(lèi)數(shù)據(jù)時(shí)，應(yīng)由數(shù)據(jù)提供方對(duì)發(fā)出數(shù)據(jù)和時(shí)間戳進(jìn)行數(shù)字簽名，數(shù)據(jù)使用方應(yīng)校驗(yàn)

數(shù)據(jù)提供方數(shù)字簽名的合法性；

b)在交換敏感類(lèi)數(shù)據(jù)時(shí)，應(yīng)由數(shù)據(jù)使用方對(duì)接收到的數(shù)據(jù)進(jìn)行確認(rèn)，確認(rèn)消息應(yīng)包括交換事務(wù)標(biāo)

識(shí)、交換數(shù)據(jù)摘要、時(shí)間戳、數(shù)據(jù)使用方的數(shù)字簽名，宜包括接收方對(duì)數(shù)據(jù)質(zhì)量的確認(rèn)；數(shù)據(jù)

提供方應(yīng)校驗(yàn)數(shù)據(jù)使用方數(shù)字簽名的合法性。

B.2.5過(guò)程追溯

B.2.5.1記錄項(xiàng)要求

應(yīng)跟蹤和記錄數(shù)據(jù)交換全過(guò)程，確保溯源記錄能滿(mǎn)足溯源過(guò)程需要。記錄項(xiàng)至少包括:

a)本次數(shù)據(jù)交換事務(wù)唯一性標(biāo)識(shí)；

b)本次數(shù)據(jù)交換開(kāi)始時(shí)間、結(jié)束時(shí)間；

c)數(shù)據(jù)提供方對(duì)數(shù)據(jù)使用方的權(quán)限審核記錄；

d)數(shù)據(jù)提供方交付記錄；

e)數(shù)據(jù)傳輸過(guò)程記錄，記錄內(nèi)容至少包括：端點(diǎn)標(biāo)識(shí)、IP地址、數(shù)據(jù)長(zhǎng)度、傳輸時(shí)間等；

f)若數(shù)據(jù)傳輸過(guò)程存在異常，應(yīng)有異常記錄、報(bào)警記錄等；

g)數(shù)據(jù)使用方對(duì)數(shù)據(jù)提供方的身份鑒別記錄；

h)數(shù)據(jù)使用方的接收狀態(tài)記錄；

i)數(shù)據(jù)使用方的數(shù)據(jù)質(zhì)量認(rèn)定記錄。

B.2.5.2記錄項(xiàng)保存時(shí)間

數(shù)據(jù)交換記錄日志應(yīng)保存6個(gè)月以上，并保證敏感類(lèi)數(shù)據(jù)交換記錄日志的保密性。

B.2.6數(shù)據(jù)質(zhì)量控制

數(shù)據(jù)交換中對(duì)數(shù)據(jù)質(zhì)量控制的要求如下：

13

DB4403/T198—2021

a)應(yīng)檢驗(yàn)數(shù)據(jù)的質(zhì)量，包括對(duì)數(shù)據(jù)格式和接口提出統(tǒng)一要求，并對(duì)獲取數(shù)據(jù)是否滿(mǎn)足要求做出認(rèn)

定；

b)應(yīng)定義空缺值、內(nèi)容沖突、不合規(guī)約束等數(shù)據(jù)源質(zhì)量評(píng)價(jià)條件并評(píng)價(jià)數(shù)據(jù)獲取質(zhì)量。

14

DB4403/T198—2021

附錄C

（資料性）

數(shù)據(jù)交換接口示例

C.1數(shù)據(jù)交換接口要求

C.1.1要求

服務(wù)數(shù)據(jù)交換采用RESTful風(fēng)格API，數(shù)據(jù)格式統(tǒng)一采用JSON格式。

C.1.2上報(bào)登錄信息接口

上報(bào)登錄信息接口示例見(jiàn)表C.1。

表C.1上報(bào)登錄信息接口示例

接口服務(wù)地址https://{域名地址}/{接口服務(wù)}/v1/login/loginInfoAccept

Http方法POST

接口說(shuō)明上報(bào)用戶(hù)登錄信息

名稱(chēng)Data

方法參數(shù)說(shuō)明類(lèi)型String

說(shuō)明用戶(hù)登錄信息的JSON字符串，具體字段詳見(jiàn)用戶(hù)信息表單

{"QXBM":440303,

"QXMC":"羅湖區(qū)",

"YYMC":"***系統(tǒng)",

"YYTGS":"***"（應(yīng)用提供商名稱(chēng)）,

"XXBM":123,

"XXMC":"深圳市**學(xué)校",

"NJMC":"一年級(jí)",

"BJMC":"三班",

Data"XJH":"230345",

參數(shù)示例

"YHBM":6547,

"YHMC":"王小川",

"DLMC":"zxt56432",

"YHLXBM":"01",

"YHLXMC":"學(xué)生",

"DLIP":"55,

"SBH":"863254036690765",

"DLSJ":"2020-10-1211:34:23"}

TokenA876CA03-7392-3971-7832-3D65DD0DRT3T

{"success"：true,

"code":0,

成功

返回值樣例"message"："同步數(shù)據(jù)成功",

"data"：[]}

失敗{"success"：false，

15

DB4403/T198—2021

表C.1上報(bào)登錄信息接口示例（續(xù)）

"code":1，

返回值樣例失敗"message"："同步數(shù)據(jù)失敗"，

"data"：[]}

C.1.3教師開(kāi)課信息交換接口

教師開(kāi)課信息交換接口示例見(jiàn)表C.2。

表C.2教師開(kāi)課信息交換接口示例

接口服務(wù)地址https://{域名地址}/{接口服務(wù)}/v1/course/courseinformation

Http方法POST

接口說(shuō)明教師開(kāi)課信息交換

名稱(chēng)Data

方法參數(shù)說(shuō)明類(lèi)型String

說(shuō)明用戶(hù)登錄信息的JSON字符串，具體字段詳見(jiàn)用戶(hù)信息表單

{"QXBM":440303,

"QXMC":"羅湖區(qū)",

"YYMC":"***系統(tǒng)",

"YYTGS":"***"（應(yīng)用提供商名稱(chēng)）,

"XXBM":2300000001000413321,

"XXMC":"深圳市**學(xué)校",

"YHBM":"1500023100000003549",

"YHXM":"李老師",

"KCBM":"123456789",

Data

參數(shù)示例"KCMC":"數(shù)學(xué)公開(kāi)課",

"XDBM":"31",

"XDMC":"普通初中",

"NJBM":"16",

"NJMC":"六年級(jí)",

"XKBM":"110",

"XKMC":"數(shù)學(xué)",

"KKZTMC":"1",

"CZSJ":"2020-10-1211:34:23"}

TokenA876CA03-7392-3971-7832-3D65DD0DRT3T

{"success"：true,

"code":0,

成功

"message"："同步數(shù)據(jù)成功",

返回值樣例"data"：[]}

{"success"：false，

失敗"code":1，

"message"："同步數(shù)據(jù)失敗"，

16

DB4403/T198—2021

表C.2教師開(kāi)課信息交換接口示例（續(xù)）

返回值樣例失敗"data"：[]}

C.1.4教師備課信息交換接口

教師備課信息交換接口示例見(jiàn)表C.3。

表C.3教師備課信息交換接口示例

接口服務(wù)地址https://{域名地址}/{接口服務(wù)}/v1/course/preparinginformation

Http方法POST

接口說(shuō)明教師備課信息交換

名稱(chēng)Data

方法參數(shù)說(shuō)明類(lèi)型String

說(shuō)明用戶(hù)登錄信息的JSON字符串，具體字段詳見(jiàn)用戶(hù)信息表單

{"XKMC":,"數(shù)學(xué)"

"NJMC":"六年級(jí)",

"KBMC":"數(shù)學(xué)六年級(jí)深圳版",

"ZJXH":"1-2-3-4",

"ZJMC":"第一章第二課第三節(jié)第四頁(yè)",

"LSBM":"123456789",

Data

參數(shù)示例"LSXM":"李老師",

"ZYBM":"675",

"XXBM":"1234567890",

"XXMC":"深圳市**學(xué)校",

"SFTJFJ":"1",

"CZSJ":"2020-10-1211:34:23"}

TokenA876CA03-7392-3971-7832-3D65DD0DRT3T

{"success"：true,

"code":0,

成功

"message"："同步數(shù)據(jù)成功",

"data"：[]}

返回值樣例

{"success"：false，

"code":1，

失敗

"message"："同步數(shù)據(jù)失敗"，

"data"：[]}

C.1.5教師授課信息交換接口

教師授課信息交換接口示例見(jiàn)表C.4。

表C.4教師授課信息交換接口示例

接口服務(wù)地址https://{域名地址}/{接口服務(wù)}/v1/course/teachinginformation

Http方法POST

17

DB4403/T198—2021

表C.4教師授課信息交換接口示例（續(xù)）

接口說(shuō)明教師授課信息交換

名稱(chēng)Data

方法參數(shù)說(shuō)明類(lèi)型String

說(shuō)明用戶(hù)登錄信息的JSON字符串，具體字段詳見(jiàn)用戶(hù)信息表單

{"KCBM":89787793,

"KCMC":"數(shù)學(xué)公開(kāi)課",

"JSBM":"88897899",

"JSMC":"李老師",

"XKMC":"數(shù)學(xué)",

Data

參數(shù)示例"BJBM":"978977988",

"BJMC":"一班",

"NJMC":"六年級(jí)",

"ZYBM":"675",

"CZSJ":"2020-10-1211:34:23"}

TokenA876CA03-7392-3971-7832-3D65DD0DRT3T

{"success"：true,

"code":0,

成功

"message"："同步數(shù)據(jù)成功",

"data"：[]}

返回值樣例

{"success"：false，

"code":1，

失敗

"message"："同步數(shù)據(jù)失敗"，

"data"：[]}

C.1.6課堂互動(dòng)信息交換接口

課堂互動(dòng)信息交換接口示例見(jiàn)表C.5。

表C.5課堂互動(dòng)信息交換接口示例

接口服務(wù)地址https://{域名地址}/{接口服務(wù)}/v1/course/classroomInteraction

Http方法POST

接口說(shuō)明教師課堂互動(dòng)信息交換

名稱(chēng)Data

方法參數(shù)說(shuō)明類(lèi)型String

說(shuō)明用戶(hù)登錄信息的JSON字符串，具體字段詳見(jiàn)用戶(hù)信息表單

{"HDBM":45678,

"QXBM":"440303",

"QXMC":"羅湖區(qū)",

參數(shù)示例Data

"YYMC":"***系統(tǒng)",

"YYTGS":"***"（應(yīng)用提供商名稱(chēng)）,

"XXBM":"1234567890",

18

DB4403/T198—2021

表C.5課堂互動(dòng)信息交換接口示例（續(xù)）

"XXMC":"深圳市**學(xué)校",

"JSBM":"123456789",

"JSXM":"李老師",

"ZYBM":"675",

"XDBM":"31",

"XDMC":"普通初中",

"NJBM":"16",

"NJMC":"六年級(jí)",

"XKBM":"110",

Data

參數(shù)示例"XKMC":"數(shù)學(xué)",

"HDLXBM":"2",

"HDLXMC":"舉手",

"BJBM":"234324234",

"BJMC":"七年級(jí)一班",

"KCBM":"232234324",

"KCMC":"數(shù)