智能设备数据归一化功能说明书

一、功能概述

此功能主要用于处理 JSON 数据，读取指定字段并进行字段名映射，实现智能设备数据的归一化。提供了 `$cq.data_converter_jsontransform` 函数用于处理 JSON 字符串，同时提供了 `$cq("[sector]").数据_转换_json转换提取` 和 `$cq.数据_转换_json转换提取` 方法，可对不同 HTML 元素内的 JSON 数据进行处理。

二、核心函数与调用格式

1. $cq.data_converter_jsontransform

$cq.data_converter_jsontransform(jsonStr, targetField = "persons", fieldMapping = null);

该函数用于处理 JSON 字符串，读取指定字段并映射字段名。

2. $cq("[sector]").数据_转换_json转换提取

$cq("[sector]").数据_转换_json转换提取(targetField = "persons", fieldMapping = null);

该方法用于对指定 HTML 元素内的 JSON 数据进行处理。

3. $cq.数据_转换_json转换提取

$cq.数据_转换_json转换提取(jsonStr, targetField = "persons", fieldMapping = null);

该方法调用 `$cq.data_converter_jsontransform` 函数处理 JSON 字符串。

三、参数说明

1. $cq.data_converter_jsontransform 参数

2. $cq("select").数据_转换_json转换提取 参数

3. $cq.数据_转换_json转换提取 参数

四、返回值

1. $cq.data_converter_jsontransform 返回值

返回处理后的 `persons` 数据列表（数组形式），若处理过程中出错则返回空数组。

2. $cq("[sector]").数据_转换_json转换提取 返回值

无明确返回值，会直接修改指定 HTML 元素内的 JSON 数据。

3. $cq.数据_转换_json转换提取 返回值

同 `$cq.data_converter_jsontransform`，返回处理后的 `persons` 数据列表（数组形式），若处理过程中出错则返回空数组。

五、使用示例

1. 使用 $cq.data_converter_jsontransform 示例

const jsonStr = '{"persons": [{"id": 1, "name": "张三"}, {"id": 2, "name": "李四"}]}';
const fieldMapping = { "id": "card_id", "name": "card_name" };
const result = $cq.data_converter_jsontransform(jsonStr, "persons", fieldMapping);
console.log(result);
        

2. 使用 $cq("[sector]").数据_转换_json转换提取 示例

// 假设存在一个 id 为 'jsonDataDiv' 的 div 元素，其 innerText 包含 JSON 数据
const jsonDiv = document.getElementById('jsonDataDiv');
$cq(jsonDiv).数据_转换_json转换提取("persons", { "id": "card_id", "name": "card_name" });
        

3. 使用 $cq.数据_转换_json转换提取 示例

const jsonStr = '{"persons": [{"id": 1, "name": "张三"}, {"id": 2, "name": "李四"}]}';
const result = $cq.数据_转换_json转换提取(jsonStr, "persons", { "id": "card_id", "name": "card_name" });
console.log(result);
        

六、注意事项

• 若 `jsonStr` 不是有效的 JSON 字符串，会在控制台输出 JSON 解析错误信息。
• 若 JSON 数据中不存在 `targetField` 指定的字段，会抛出错误并在控制台输出相应信息。
• 若未传入 `fieldMapping` 参数，会使用默认的字段映射规则。
• `$cq("[sector]").数据_转换_json转换提取` 方法仅对 `input`、`td`、`cyberdiv` 等部分 HTML 元素有效，会根据元素类型修改其 `value` 或 `innerText`。