1、I C S 3 5.2 4 0.9 9C C S A 1 8DB4403深 圳 市 地 方 标 准D B 4 4 0 3/T 1 9 8 2 0 2 1课 堂 教 学 行 为 数 据 交 换 规 范D a t a e x c h a n g e s p e c i f i c a t i o n f o r c l a s s r o o m t e a c h i n g b e h a v i o r2 0 2 1-1 1-1 6 发 布 2 0 2 1-1 2-0 1 实 施深 圳 市 市 场 监 督 管 理 局发 布D B 4 4 0 3/T 1 9 8 2 0 2 1I目 次前 言
2、I I1 范 围 12 规 范 性 引 用 文 件 13 术 语 和 定 义 14 课 堂 教 学 行 为 框 架 25 总 体 要 求 36 交 换 要 求 47 数 据 要 求 6附 录 A（规 范 性）学 习 行 为 x A P I 规 范 8附 录 B（规 范 性）数 据 交 换 设 计 1 2附 录 C（资 料 性）数 据 交 换 接 口 示 例 1 5附 录 D（规 范 性）基 础 数 据 3 0附 录 E（规 范 性）课 堂 教 学 行 为 数 据 格 式 3 4参 考 文 献 4 4D B 4 4 0 3/T 1 9 8 2 0 2 1I I前 言本 文 件 按 照 G B/T
3、 1.1 2 0 2 0 标 准 化 工 作 导 则 第 1 部 分：标 准 化 文 件 的 结 构 和 起 草 规 则 的 规 定起 草。本 文 件 由 深 圳 市 教 育 局 提 出 并 归 口。本 文 件 起 草 单 位：深 圳 市 教 育 信 息 技 术 中 心、北 京 师 范 大 学、华 中 师 范 大 学、华 南 师 范 大 学、科 大讯 飞 股 份 有 限 公 司、上 海 一 起 作 业 信 息 科 技 有 限 公 司、深 圳 市 海 云 天 科 技 股 份 有 限 公 司、上 海 中 文 在 线文 化 发 展 有 限 公 司、学 科 网(北 京)股 份 有 限 公 司、深 圳
4、市 腾 讯 计 算 机 系 统 有 限 公 司、武 汉 天 喻 教 育 科 技有 限 公 司、深 圳 市 全 景 教 育 科 技 有 限 公 司、武 汉 颂 大 教 育 技 术 有 限 公 司、紫 光 教 育 科 技 有 限 公 司。本 文 件 主 要 起 草 人：张 惠 敏、梁 为、陈 浩、王 奕 奕、纪 显 俐、戴 俊 雄、吴 砥、张 学 波、郑 勤 华、王龙 生、杨 熙、欧 思 泱、王 培 峰、陈 学 艺、刘 青、余 斌、张 露 茜、姜 峰、郑 琦。D B 4 4 0 3/T 1 9 8 2 0 2 11课 堂 教 学 行 为 数 据 交 换 规 范1 范 围本 文 件 规 定 了 课
5、堂 教 学 行 为 的 框 架 与 课 堂 教 学 行 为 数 据 交 换 的 基 本 要 求、交 换 要 求 和 数 据 要 求。本 文 件 适 用 于 深 圳 市 中 小 学 市、区、校 三 级 课 堂 教 学 行 为 信 息 的 数 据 交 换，支 撑 深 圳 市 实 现 对 教 学行 为 数 据 的 记 录、追 踪 和 分 析 以 及 开 展 教 学 过 程 性 评 价，指 导 差 异 化 教 学。2 规 范 性 引 用 文 件本 文 件 没 有 规 范 性 引 用 文 件。3 术 语 和 定 义下 列 术 语 和 定 义 适 用 于 本 文 件。3.1课 堂 c l a s s r
6、o o m中 小 学 教 师 进 行 教 学 活 动 的 物 理 空 间。3.2教 学 行 为 i n s t r u c t i o n a l b e h a v i o r教 学 活 动 中 的 一 系 列 围 绕 教 学 内 容 展 开 的 教 与 学 行 为。3.3数 据 交 换 d a t a e x c h a n g e数 据 采 集 及 交 换 的 技 术 行 为。3.4学 习 者 l e a r n e r依 靠 学 习 技 术 系 统 获 取 知 识 或 技 能 的 个 体。3.5教 师 t e a c h e r依 靠 学 习 技 术 系 统 传 递 知 识 或 技 能
7、 的 个 体。3.6学 习 行 为 l e a r n i n g b e h a v i o r学 习 活 动 中 的 一 系 列 行 为。D B 4 4 0 3/T 1 9 8 2 0 2 123.7知 识 点 k n o w l e d g e p o i n t知 识、理 论、道 理、思 想 等 的 相 对 独 立 的 最 小 单 元，是 课 程 中 信 息 传 递 的 基 本 单 元。3.8互 动 类 型 i n t e r a c t t y p e教 师 与 学 习 者 借 助 技 术 手 段 进 行 的 交 互 方 式。4 课 堂 教 学 行 为 框 架4.1 课 堂 教 学
8、行 为 框 架框 架 包 括 课 堂 教 学 行 为、课 堂 学 习 行 为、课 堂 教 育 资 源，见 图 1。图 1 课 堂 教 学 行 为 框 架4.2 课 堂 教 学 行 为课 堂 教 学 行 为 分 为：教 学 准 备 行 为：记 录 教 师 课 前 的 相 关 教 学 准 备 行 为，包 括 登 录 和 备 课 等 行 为；教 学 组 织 行 为：记 录 教 师 组 织 教 学 的 行 为，包 括 开 课、授 课，下 发 练 习、测 试 和 作 业 等 行 为；课 堂 交 互 行 为：记 录 教 师 引 导、激 励 学 生 学 习 的 行 为，发 起 讨 论、投 票、抢 答、随 机
9、 选 人 作 答、全 班 作 答、资 源 分 享、教 学 答 疑 和 辅 导 等 行 为；评 价 反 馈 行 为：记 录 教 师 对 学 习 者 评 价 的 行 为，包 括 查 看 学 生 的 作 业、作 品、测 试 和 考 试，评价 学 生 的 作 业 等 行 为。4.3 课 堂 教 育 资 源课 堂 教 育 资 源 分 为：教 学 资 源：教 师 上 课 使 用 的 教 材 资 源，包 括 电 子 书、备 课、授 课 等 教 学 活 动 中 使 用 的 资 源；试 题 资 源：考 试、练 习、测 验 中 使 用 的 题 目 资 源。D B 4 4 0 3/T 1 9 8 2 0 2 134
10、.4 课 堂 学 习 行 为课 堂 学 习 行 为 分 为（数 据 应 符 合 附 录 A 的 规 定）：学 习 轨 迹 行 为：记 录 学 习 者 的 操 作 行 为 链（点 击 流），包 括 登 录、退 出、提 交 等 对 系 统 页 面 操作 的 行 为；资 源 学 习 行 为：记 录 学 习 者 学 习 的 资 源 以 及 对 资 源 进 行 的 操 作，包 括 浏 览、使 用、上 传、下 载学 习 资 源 等 行 为；课 堂 交 互 行 为：记 录 学 习 者 与 其 他 学 习 者、教 师、管 理 员 的 交 流 行 为，包 括 发 起 提 问、资 源 分享 等 行 为；评 价 反
11、 思 行 为：记 录 学 习 者 参 与 测 试、评 价 的 行 为，包 括 完 成 并 提 交 练 习、课 堂 实 验、作 业 和测 试，完 成 互 评 和 错 题 订 正，对 自 我、同 伴、教 师 进 行 评 价 等 行 为。5 总 体 要 求5.1 数 据 项 组 成元 数 据 结 构 如 下：中 文 简 称：所 用 的 数 据 元 素 的 名 称，具 有 语 义，面 向 用 户；数 据 项 名：通 常 由 中 文 简 称 的 汉 语 拼 音 首 字 母（大 写）组 成，与 中 文 简 称 一 一 对 应，宜 在 实 际数 据 结 构 中 采 用；类 型：数 据 项 容 纳 的 数 据
12、 类 型，本 文 件 在 数 据 项 中 简 称 其 为 类 型（一 种 属 性）；长 度：数 据 项 能 容 纳 的 最 大 字 符 数（一 种 属 性）；约 束：数 据 项 约 束 状 态 的 描 述，即 必 备 数 据 项 或 可 选 数 据 项（一 种 属 性）；解 释/举 例：数 据 项 属 性 的 说 明 或 举 例。5.2 数 据 类 型5.2.1 字 符 型字 符 型 为 C，在 信 息 系 统 中 取 用 时，可 以 是 可 变 长 度。5.2.2 数 值 型数 值 型 为 N，可 参 与 运 算。5.2.3 二 进 制 类 型二 进 制 类 型 为 B，宜 在 照 片 或
13、超 长 文 本 使 用。5.2.4 文 本 型文 本 型 为 T，用 于 数 量 较 多 的 文 字 描 述。数 据 值 长 度 大 于 1 0 0 0 字 符 时 应 采 用 文 本 型。5.3 约 束数 据 约 束 条 件 有 可 选 数 据 元 素 O 和 必 备 数 据 元 素 M 两 种。5.4 时 间 格 式 定 义系 统 定 义 的 时 间 格 式 为 年-月-日 时：分：秒（y y y y-M M-d d H H:m m:s s）。D B 4 4 0 3/T 1 9 8 2 0 2 145.5 数 据 传 输 方 式结 构 化 数 据 采 取 文 本 形 式 传 输；非 结 构
14、 化 数 据（如 视 频 类、音 频 类）采 用 文 件 方 式 进 行 数 据 传 输，采 取 二 进 制 形 式 存 储。6 交 换 要 求6.1 基 本 要 求6.1.1 数 据 交 换 对 象 是 深 圳 市、区、校 三 级 课 堂 教 学 信 息 系 统 的 课 堂 教 学 行 为 数 据。数 据 交 换 类 别 包括 结 构 化 数 据、非 结 构 化 数 据。其 中，视 频、图 片、音 频、文 档 类 等 附 件 数 据 是 非 结 构 化 数 据，文 本 信息 类、数 据 库 表 数 据 是 结 构 化 数 据。6.1.2 数 据 交 换 可 采 用 不 同 的 数 据 交 换
15、 方 式 进 行（具 体 交 换 设 计 应 符 合 附 录 B 的 规 定），包 括 但 不 限 于：a)库 表 交 换；b)资 源 文 件 交 换；c)服 务 接 口 交 换。6.2 库 表 交 换基 于 数 据 库 表 结 构 形 式 进 行 数 据 交 换，适 用 于 大 量 历 史 数 据 的 交 互 或 适 用 数 据 增 量 更 新 频 繁 的 数 据交 换，结 构 如 图 2 所 示。图 2 基 于 数 据 库 的 交 换 方 式6.3 资 源 文 件 交 换6.3.1 通 过 文 件 交 换 的 形 式 进 行 数 据 交 换，适 用 于 非 结 构 化 资 源 或 更 新
16、频 率 比 较 缓 慢 的 结 构 化 资 源 的数 据 交 换。结 构 如 图 3 所 示。D B 4 4 0 3/T 1 9 8 2 0 2 15图 3 基 于 文 件 的 交 换 方 式6.3.2 资 源 文 件 交 换 方 式 基 于 前 置 机 进 行 网 络 安 全 隔 离，文 件 上 传 和 下 载 接 口 协 议 使 用 H T T P S 协 议，通 过 提 供 访 问 的 U R L，用 户 使 用 H T T P P O S T 方 法 发 送 请 求。6.4 服 务 接 口 交 换6.4.1 将 数 据 服 务 封 装 成 接 口，供 数 据 使 用 方 调 用，适 用
17、 于 小 数 据 量、实 时 性 要 求 较 高 的 数 据 交 换，结 构 如 图 4 所 示。图 4 服 务 接 口 交 换 方 式6.4.2 服 务 数 据 交 换 采 用 R E S T f u l 风 格 A P I，数 据 格 式 统 一 采 用 J S O N 格 式，接 口 示 例 见 附 录 C。接 口协 议 采 用 H t t p s，接 口 编 码 采 用 U T F-8。安 全 验 证 应 根 据 授 权 用 户 和 密 码 产 生 的 随 机 T o k e n 来 访 问 各 A P I。接 口 数 据 的 返 回 格 式 为 J S O N 格 式 字 符 串，接
18、 口 返 回 值 数 据 格 式 应 符 合 表 1 的 要 求。表 1 数 据 格 式J S O N 变量 说明S u c c e s s 调用接口操作成功标志，b o o l e a n 值 t r u e、f a l s eC o d e 返回结果状态标识，0 代表成功，1 代表失败D B 4 4 0 3/T 1 9 8 2 0 2 16表 1 数 据 格 式（续）J S O N 变量 说明M e s s a g e 返回结果的文字说明D a t a 返回的结果数据7 数 据 要 求7.1 课 堂 教 学 行 为 数 据 基 于 框 架 拆 解，主 要 包 括 但 不 限 于 以 下 数
19、 据：a)用 户 登 录 信 息，b)教 师 开 课 信 息，c)教 师 备 课 信 息，d)教 师 授 课 信 息，e)课 堂 互 动 信 息，f)资 源 使 用 信 息，g)作 业 布 置 信 息，h)作 业 报 告 信 息，i)作 业 答 题 信 息，j)课 堂 测 验 信 息，k)课 堂 测 验 报 告，l)试 题 集 信 息，m)题 目 信 息，n)知 识 点 信 息，o)教 材 课 本 信 息，p)教 学 资 源 信 息，q)学 习 行 为 信 息。7.2 元 数 据 应 符 合 表 2 所 示 数 据 交 换 索 引。表 2 数 据 交 换 索 引 表序号 数据类别 数据信息 具
20、体数据要求1基础数据学段信息 见 D.12 年级信息 见 D.23 学科信息 见 D.34 行政区信息 见 D.45 学习者信息 见 D.56 操作行为信息 见 D.67 互动类型信息 见 D.7D B 4 4 0 3/T 1 9 8 2 0 2 17表 2 数 据 交 换 索 引 表（续）序号 数据类别 数据信息 具体数据要求8 基础数据 资源来源信息 见 D.89课堂教学行为数据用户登录信息 见 E.11 0 教师开课信息 见 E.21 1 教师备课信息 见 E.31 2 教师授课信息 见 E.41 3 课堂互动信息 见 E.51 4 资源使用信息 见 E.61 5 作业布置信息 见 E.
21、71 6 作业报告信息 见 E.81 7 作业答题信息 见 E.91 8 课堂测验信息 见 E.1 01 9 课堂测验报告 见 E.1 12 0 试题集信息 见 E.1 22 1 题目信息 见 E.1 32 2 知识点信息 见 E.1 42 3 教材课本信息 见 E.1 52 4 教学资源信息 见 E.1 62 5 学习行为信息 见 C.2D B 4 4 0 3/T 1 9 8 2 0 2 18附 录 A（规 范 性）学 习 行 为 x A P I 规 范A.1 x A P I 规 范 框 架A.1.1 x A P I 规 范 框 架 包 括 操 作 I D，操 作 者，动 作，对 象，结 果
22、 等，如 图 A.1。图 A.1 x A P I 用 户 学 习 行 为 框 架A.1.2 用 户 学 习 行 为 元 素A.1.2.1 操 作 I D操 作 标 示 符。操 作 I D 是 一 个 唯 一 标 识 符，在 一 些 不 必 要 的 场 合 可 以 省 略。A.1.2.2 A c t o r操 作 者。每 一 个 学 习 行 为、每 一 个 学 习 活 动，都 应 有 一 个 提 供 者、参 与 者，代 表 的 是 谁 在 学 习、是由 谁 发 起 了 这 个 活 动。A.1.2.3 V e r b动 作。表 示 操 作 者 的 具 体 操 作 行 为。具 体 动 词 及 其 语
23、 义 如 表 A.1。表 A.1 x A P I 动 作 定 义动作 描述A n s w e r e d 回答V o t e 投票A s k e d 提问A t t e n d e d 参加C o m m e n t e d 评论C o m p l e t e d 完成L o g i n-o u t 退出S t a r t 开始E x p e r i e n c e d 经历F a i l e d 失败I n p u t 输入D B 4 4 0 3/T 1 9 8 2 0 2 19表 A.1 x A P I 动 作 定 义（续）动作 描述I n i t i a l i z e d 初始化I n
24、 t e r a c t e d 交互L a u n c h e d 发布P a s s e d 通过F a i l e d 未通过M a s t e r e d 掌握S e e 观看P r e f e r r e d 偏好R e g i s t e r e d 注册L o g i n-i n 登录M e e t i n g 会议R e s p o n d e d 响应R e s u m e d 继续S c o r e d 得分S h a r e d 分享S u s p e n d e d 暂停T e r m i n a t e d 结束A.1.2.4 O b j e c t对 象。对 象 中
25、 包 含 有 两 个 子 属 性：操 作 对 象 编 码 和 操 作 对 象 名 称。A.1.2.5 R e s u l t结 果。该 属 性 是 可 以 扩 展 的，它 主 要 描 述 一 些 动 作 结 果，如 得 分、通 过 与 否 和 完 成 进 度 等。A.1.2.6 C o n t e x t上 下 文 环 境。该 属 性 提 供 一 些 活 动 中 的 上 下 文 信 息,包 括 但 不 限 于 厂 商 名 称、应 用 名 称、设 备 I P、设 备 类 型、设 备 型 号 等。A.1.2.7 T i m e S t a m p活 动 发 生 时 间。A.1.2.8 S t o
26、r e d T i m e记 录 存 储 时 间。A.1.2.9 A u t h o r i t y授 权。出 于 对 安 全 性 的 考 虑，通 常 存 储 的 行 为 数 据 不 是 任 何 人 都 可 以 访 问 的。该 属 性 就 是 用 来 表 明哪 些 用 户 可 以 访 问 某 些 行 为，同 时 指 定 其 有 效 性。A.2 x A P I 数 据 格 式D B 4 4 0 3/T 1 9 8 2 0 2 11 0具 体 x A P I 数 据 格 式 标 准 见 表 A.2，接 口 示 例 见 表 A.3。表 A.2 x A P I 数 据 格 式 表中文简称 数据项名 类
27、型 长度 约束 解释/举例操作唯一标识 C Z W Y B S C 5 0 M U U I D操作者 C Z Z C 5 0 M j s o n 格式操作行为 C Z X W C 5 0 M j s o n 格式操作对象 C Z D X C 5 0 0 M j s o n 格式操作结果 C Z J G N 1 1 O j s o n 格式上下文环境 S X W H J C 5 0 0 O j s o n 格式发生时间点 F S S J C 2 0 M 存储时间 C C S J C 2 0 M 授权 S Q C 2 0 O j s o n 格式表 A.3 x A P I 数 据 接 口 说 明接
28、口服务地址 h t t p s:/域名地址/接口服务/v 1/x A P I A c t i o n/u s e r A c t i o n A c c e p tH t t p 方法 P O S T接口说明 上报用户观看视频信息方法参数说明名称 D a t a类型 S t r i n g说明 用户登录 信息的 J S O N 字符串，具体字段详见 x A P I 数据格式表参数示例D a t a C Z W Y B S:d 5 0 a b 7 7 f-0 d 1 9-4 4 8 d-a 2 0 a-8 d c 6 e c e 9 e c 8 e,C Z Z:Y H X M:王小川,Y H L
29、 X B M:0 1,C Z X W:C Z X W:S e e,C Z X W M C:观看视频,C Z D X:C Z D X B M:0 9,C Z D X M C:咏鹅,C Z J G:r e s u l t:操作成功,S X W H J:D L I P:2 1 9.1 3 4.1 0 4.2 5 5,Y Y M C:*系统,Y Y T G S:*（应用提供商名称）,S B L X:a n d r o i d 平板,S B H:9 8 4 3 b 7 7 f-9 5 4 y-4 6 7 h-i 8 t 4-8 d c 6 e c e 9 e c 7 e,F S S J:2 0 2 0-
30、1 0-1 2 1 1:3 4:2 3,C C S J:2 0 2 0-1 0-1 2 1 1:3 6:3 3 S B L X:a n d r o i d 平板,S B H:9 8 4 3 b 7 7 f-9 5 4 y-4 6 7 h-i 8 t 4-8 d c 6 e c e 9 e c 7 e,F S S J:2 0 2 0-1 0-1 2 1 1:3 4:2 3,C C S J:2 0 2 0-1 0-1 2 1 1:3 6:3 3 T o k e n A 8 7 6 C A 0 3-7 3 9 2-3 9 7 1-7 8 3 2-3 D 6 5 D D 0 D R T 3 T返回值样
31、例 成功 s u c c e s s：t r u e,c o d e:0,m e s s a g e：同步数据成功,D B 4 4 0 3/T 1 9 8 2 0 2 11 1表 A.3 x A P I 数 据 接 口 说 明（续）返回值样例成功 d a t a：失败 s u c c e s s：f a l s e，c o d e:1，m e s s a g e：同步数据失败，d a t a：D B 4 4 0 3/T 1 9 8 2 0 2 11 2附 录 B（规 范 性）数 据 交 换 设 计B.1 资 源 文 件 交 换 接 口 要 求B.1.1 上 传 文 件 接 口 要 求上 传 文
32、 件 接 口 应 符 合 表 B.1 的 要 求。表 B.1 上 传 文 件 接 口 要 求上传文件接口 参数 参数说明h t t p s:/i p:端口/f i l e U p l o a du p l o a d P a t h 指定上传目录（根路径+相对路径）f i l e N a m e 上传文件名称u s e r N a m e 使用账户a p p S e c r e t 授权密钥B.1.2 下 载 文 件 接 口 要 求下 载 文 件 接 口 应 符 合 表 B.2 的 要 求。表 B.2 下 载 文 件 接 口 要 求上传文件接口 参数 参数说明h t t p s:/i p:端口
33、/f i l e D o w n l o a dt a r g e t F i l e 文件下载路径绝对路径u s e r N a m e 使用账户a p p S e c r e t 授权密钥B.1.3 服 务 端 返 回 状 态服 务 端 返 回 调 用 结 果 返 回 状 态 码 见 表 B.3。表 B.3 服 务 端 返 回 状 态 码状态码 状态说明2 0 0 调用成功4 0 0 鉴权异常：用户不存在、用户密码错误4 0 1 参数为空4 0 2 下载文件不存在、上传时创建文件夹失败B.2 交 换 服 务 方 安 全 要 求B.2.1 交 换 事 务 标 识应 对 每 次 数 据 交 换
34、 指 定 具 有 唯 一 性 的 交 换 事 务 标 识。D B 4 4 0 3/T 1 9 8 2 0 2 11 3B.2.2 身 份 鉴 别通 过 身 份 鉴 别 保 证 数 据 交 换 的 安 全 性，要 求 如 下：a)应 对 数 据 交 换 两 端 进 行 用 户 身 份 鉴 别，确 保 数 据 交 换 两 端 身 份 的 真 实 性；b)应 采 用 如 用 户 名/口 令、一 次 性 口 令、数 字 证 书、标 识 密 码 等 技 术 实 现 交 换 两 端 的 用 户 身 份 鉴别。B.2.3 安 全 传 输安 全 传 输 的 要 求 如 下：a)应 采 用 密 码 技 术 保
35、证 数 据 传 输 通 道 安 全，保 证 传 输 数 据 的 保 密 性 和 完 整 性；b)应 采 用 符 合 国 家 相 关 标 准 规 定 的 数 据 加 密 方 式 与 密 码 算 法；c)应 确 保 安 全 通 道 和 身 份 鉴 别 过 程 的 关 联 性；应 保 证 通 道 安 全 协 议 执 行 过 程 中 被 认 证 方 与 需 认 证方 身 份 信 息 具 有 真 实 对 应 关 系，或 者 保 证 在 已 建 立 的 安 全 通 道 内 执 行 对 使 用 方 一 端 的 身 份 鉴别；d)应 在 交 换 完 成 后 清 除 通 道 历 史 缓 存 数 据；e)应 定
36、期 检 查 或 评 估 数 据 流 动 通 道 的 安 全 性 和 可 靠 性。B.2.4 操 作 抗 抵 赖交 换 敏 感 类 数 据 对 操 作 扛 抵 赖 性 的 要 求 如 下：a)在 交 换 敏 感 类 数 据 时，应 由 数 据 提 供 方 对 发 出 数 据 和 时 间 戳 进 行 数 字 签 名，数 据 使 用 方 应 校 验数 据 提 供 方 数 字 签 名 的 合 法 性；b)在 交 换 敏 感 类 数 据 时，应 由 数 据 使 用 方 对 接 收 到 的 数 据 进 行 确 认，确 认 消 息 应 包 括 交 换 事 务 标识、交 换 数 据 摘 要、时 间 戳、数 据
37、 使 用 方 的 数 字 签 名，宜 包 括 接 收 方 对 数 据 质 量 的 确 认；数 据提 供 方 应 校 验 数 据 使 用 方 数 字 签 名 的 合 法 性。B.2.5 过 程 追 溯B.2.5.1 记 录 项 要 求应 跟 踪 和 记 录 数 据 交 换 全 过 程，确 保 溯 源 记 录 能 满 足 溯 源 过 程 需 要。记 录 项 至 少 包 括:a)本 次 数 据 交 换 事 务 唯 一 性 标 识；b)本 次 数 据 交 换 开 始 时 间、结 束 时 间；c)数 据 提 供 方 对 数 据 使 用 方 的 权 限 审 核 记 录；d)数 据 提 供 方 交 付 记
38、录；e)数 据 传 输 过 程 记 录，记 录 内 容 至 少 包 括：端 点 标 识、I P 地 址、数 据 长 度、传 输 时 间 等；f)若 数 据 传 输 过 程 存 在 异 常，应 有 异 常 记 录、报 警 记 录 等；g)数 据 使 用 方 对 数 据 提 供 方 的 身 份 鉴 别 记 录；h)数 据 使 用 方 的 接 收 状 态 记 录；i)数 据 使 用 方 的 数 据 质 量 认 定 记 录。B.2.5.2 记 录 项 保 存 时 间数 据 交 换 记 录 日 志 应 保 存 6 个 月 以 上，并 保 证 敏 感 类 数 据 交 换 记 录 日 志 的 保 密 性。B
39、.2.6 数 据 质 量 控 制数 据 交 换 中 对 数 据 质 量 控 制 的 要 求 如 下：D B 4 4 0 3/T 1 9 8 2 0 2 11 4a)应 检 验 数 据 的 质 量，包 括 对 数 据 格 式 和 接 口 提 出 统 一 要 求，并 对 获 取 数 据 是 否 满 足 要 求 做 出 认定；b)应 定 义 空 缺 值、内 容 冲 突、不 合 规 约 束 等 数 据 源 质 量 评 价 条 件 并 评 价 数 据 获 取 质 量。D B 4 4 0 3/T 1 9 8 2 0 2 11 5附 录 C（资 料 性）数 据 交 换 接 口 示 例C.1 数 据 交 换
40、接 口 要 求C.1.1 要 求服 务 数 据 交 换 采 用 R E S T f u l 风 格 A P I，数 据 格 式 统 一 采 用 J S O N 格 式。C.1.2 上 报 登 录 信 息 接 口上 报 登 录 信 息 接 口 示 例 见 表 C.1。表 C.1 上 报 登 录 信 息 接 口 示 例接口服务地址 h t t p s:/域名地址/接口服务/v 1/l o g i n/l o g i n I n f o A c c e p tH t t p 方法 P O S T接口说明 上报用户登录信息方法参数说明名称 D a t a类型 S t r i n g说明 用户登录信息的
41、 J S O N 字符串，具体字段详见用户信息表单参数示例D a t a Q X B M:4 4 0 3 0 3,Q X M C:罗湖区,Y Y M C:*系统,Y Y T G S:*（应用提供商名称）,X X B M:1 2 3,X X M C:深圳市*学校,N J M C:一年级,B J M C:三班,X J H:2 3 0 3 4 5,Y H B M:6 5 4 7,Y H M C:王小川,D L M C:z x t 5 6 4 3 2,Y H L X B M:0 1,Y H L X M C:学生,D L I P:2 1 9.1 3 4.1 0 4.2 5 5,S B H:8 6 3 2
42、 5 4 0 3 6 6 9 0 7 6 5,D L S J:2 0 2 0-1 0-1 2 1 1:3 4:2 3 T o k e n A 8 7 6 C A 0 3-7 3 9 2-3 9 7 1-7 8 3 2-3 D 6 5 D D 0 D R T 3 T返回值样例成功 s u c c e s s：t r u e,c o d e:0,m e s s a g e：同步数据成功,d a t a：失败 s u c c e s s：f a l s e，D B 4 4 0 3/T 1 9 8 2 0 2 11 6表 C.1 上 报 登 录 信 息 接 口 示 例（续）返回值样例 失败 c o d
43、 e:1，m e s s a g e：同步数据失败，d a t a：C.1.3 教 师 开 课 信 息 交 换 接 口教 师 开 课 信 息 交 换 接 口 示 例 见 表 C.2。表 C.2 教 师 开 课 信 息 交 换 接 口 示 例接口服务地址 h t t p s:/域名地址/接口服务/v 1/c o u r s e/c o u r s e i n f o r m a t i o nH t t p 方法 P O S T接口说明 教师开课信息交换方法参数说明名称 D a t a类型 S t r i n g说明 用户登录信息的 J S O N 字符串，具体字段详见用户信息表单参数示例D a
44、 t a Q X B M:4 4 0 3 0 3,Q X M C:罗湖区,Y Y M C:*系统,Y Y T G S:*（应用提供商名称）,X X B M:2 3 0 0 0 0 0 0 0 1 0 0 0 4 1 3 3 2 1,X X M C:深圳市*学校,Y H B M:1 5 0 0 0 2 3 1 0 0 0 0 0 0 0 3 5 4 9,Y H X M:李老师,K C B M:1 2 3 4 5 6 7 8 9,K C M C:数学公开课,X D B M:3 1,X D M C:普通初中,N J B M:1 6,N J M C:六年级,X K B M:1 1 0,X K M C:
45、数学,K K Z T M C:1,C Z S J:2 0 2 0-1 0-1 2 1 1:3 4:2 3 T o k e n A 8 7 6 C A 0 3-7 3 9 2-3 9 7 1-7 8 3 2-3 D 6 5 D D 0 D R T 3 T返回值样例成功 s u c c e s s：t r u e,c o d e:0,m e s s a g e：同步数据成功,d a t a：失败 s u c c e s s：f a l s e，c o d e:1，m e s s a g e：同步数据失败，D B 4 4 0 3/T 1 9 8 2 0 2 11 7表 C.2 教 师 开 课 信 息
46、 交 换 接 口 示 例（续）返回值样例 失败 d a t a：C.1.4 教 师 备 课 信 息 交 换 接 口教 师 备 课 信 息 交 换 接 口 示 例 见 表 C.3。表 C.3 教 师 备 课 信 息 交 换 接 口 示 例接口服务地址 h t t p s:/域名地址/接口服务/v 1/c o u r s e/p r e p a r i n g i n f o r m a t i o nH t t p 方法 P O S T接口说明 教师备课信息交换方法参数说明名称 D a t a类型 S t r i n g说明 用户登录信息的 J S O N 字符串，具体字段详见用户信息表单参数示
47、例D a t a X K M C:,数学 N J M C:六年级,K B M C:数学六年级深圳版,Z J X H:1-2-3-4,Z J M C:第一章第二课第三节第四页,L S B M:1 2 3 4 5 6 7 8 9,L S X M:李老师,Z Y B M:6 7 5,X X B M:1 2 3 4 5 6 7 8 9 0,X X M C:深圳市*学校,S F T J F J:1,C Z S J:2 0 2 0-1 0-1 2 1 1:3 4:2 3 T o k e n A 8 7 6 C A 0 3-7 3 9 2-3 9 7 1-7 8 3 2-3 D 6 5 D D 0 D R
48、T 3 T返回值样例成功 s u c c e s s：t r u e,c o d e:0,m e s s a g e：同步数据成功,d a t a：失败 s u c c e s s：f a l s e，c o d e:1，m e s s a g e：同步数据失败，d a t a：C.1.5 教 师 授 课 信 息 交 换 接 口教 师 授 课 信 息 交 换 接 口 示 例 见 表 C.4。表 C.4 教 师 授 课 信 息 交 换 接 口 示 例接口服务地址 h t t p s:/域名地址/接口服务/v 1/c o u r s e/t e a c h i n g i n f o r m a
49、t i o nH t t p 方法 P O S TD B 4 4 0 3/T 1 9 8 2 0 2 11 8表 C.4 教 师 授 课 信 息 交 换 接 口 示 例（续）接口说明 教师授课信息交换方法参数说明名称 D a t a类型 S t r i n g说明 用户登录信息的 J S O N 字符串，具体字段详见用户信息表单参数示例D a t a K C B M:8 9 7 8 7 7 9 3,K C M C:数学公开课,J S B M:8 8 8 9 7 8 9 9,J S M C:李老师,X K M C:数学,B J B M:9 7 8 9 7 7 9 8 8,B J M C:一班,N
50、 J M C:六年级,Z Y B M:6 7 5,C Z S J:2 0 2 0-1 0-1 2 1 1:3 4:2 3 T o k e n A 8 7 6 C A 0 3-7 3 9 2-3 9 7 1-7 8 3 2-3 D 6 5 D D 0 D R T 3 T返回值样例成功 s u c c e s s：t r u e,c o d e:0,m e s s a g e：同步数据成功,d a t a：失败 s u c c e s s：f a l s e，c o d e:1，m e s s a g e：同步数据失败，d a t a：C.1.6 课 堂 互 动 信 息 交 换 接 口课 堂 互
