6.2 CSM API String to Cluster.vi

Author: nevstop

Example/Supported Datatype Examples/6.1 Cluster to CSM API String.vi

@@ -251,6 +251,72 @@ Array 是一种复合数据类型，可能包含不同的数据类型。其中
 
 Array 是一种复合数据类型，可能包含不同的数据类型。其中以 Cluster 最为复杂，本范例将展示2D Cluster Array 的 CSM API String 表达字符串。
 
+## Cluster 数据类型支持
+
+### 6.1 Cluster to CSM API String.vi
+
+#### Overview
+
+本范例用于演示 Cluster 的 CSM API String表达。
+
+#### Introduction
+
+Cluster 是一种复杂类型，它由其他的普通数据类型组成。本范例将展示 Cluster 的 CSM API String 表达字符串。在 API String 中，Cluster 可以表达为两种方式。
+
+1. 标签-数据对(Tag:Value)模式
+
+在标签-数据对模式下，输入字符串由多个标签-数据对组成，冒号(:)用于分隔标签和数据，分号(;)用于分隔不同元素。花括号({ 和 })用作边界符号。对于非复杂的混合数据类型，花括号可以省略。
+
+2. 无标签模式
+
+对于簇，也支持仅输入数据字符串，各值之间用分号分隔。
+
+#### Steps
+
+- step1: 标签-数据对(Tag:Value)模式
+- step2: 无标签模式
+
+### 6.2 CSM API String to Cluster.vi
+
+#### Overview
+
+本范例用于演示 Cluster 的 CSM API String表达。
+
+#### Introduction
+
+Cluster 是一种复杂类型，它由其他的普通数据类型组成。本范例将展示 Cluster 的 CSM API String 表达字符串。在 API String 中，Cluster 可以表达为两种方式。
+
+1. 标签-数据对(Tag:Value)模式
+
+在标签-数据对模式下，输入字符串由多个标签-数据对组成，冒号(:)用于分隔标签和数据，分号(;)用于分隔不同元素。花括号({ 和 })用作边界符号。对于非复杂的混合数据类型，花括号可以省略。其他规则如下：
+
+标签对应簇中元素的名称，值会根据对应元素的数据类型进行转换。
+只需描述需要修改的元素，与数据原型一致的元素可以省略。
+通过名称匹配元素，顺序无关紧要。
+对于嵌套簇，子簇元素的标签格式为"父簇标签.子簇元素标签"。
+嵌套簇中，如果子簇元素的标签名称唯一，可以省略父簇的标签。
+
+2. 无标签模式
+
+对于簇，也支持仅输入数据字符串，各值之间用分号分隔。
+
+顺序非常重要。第一个元素值将设置给簇的第一个元素，第二个元素值设置给簇的第二个元素，以此类推。
+如果输入字符串的元素数量少于簇的元素数量，剩余的元素将保持不变。
+如果输入字符串的元素数量多于簇的元素数量，多余的元素将被忽略。
+
+#### Steps
+
+- step1: 空字符串转换为参考数据
+- step2: 可以只通过 tag 名称修改参考数据中的某个元素数据
+- step3：没有标签且个数只有一个的情况下，将直接修改参考数据的第一个元素数据
+- step4: 没有标签且个数只有一个的情况下，将直接修改参考数据的第一个元素数据,第一个是Array的情况
+- step5: 无标签模式
+- step6: 无标签模式, 但是元素个数小于全部个数
+- step7: 可以只通过 tag 名称修改参考数据中的某个元素数据
+- step8：无标签模式，但是其中的boolean 数据使用了其他的表达方式
+- step9: 无标签模式，但是元素个数大于全部个数
+- step10: 多层嵌套下，tag的名称可以包含点号(.)，用于表示嵌套簇的层级, 没有歧义的情况下，可以只写最终元素的名称，或者部分子嵌套层级的名称
+