# checkEntityName：判断entity name是否为指定值
# 【功能说明】
用来把一个SDO的实体名与指定字符串相比较。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataObjectUtil.checkEntityName，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | entity | DataObject | SDO对象 |
| 参数 | entityName | String | SDO对象对应的实体名称 |
| 返回值 | out0 | boolean | Unknown macro: {span}true：实体名与指定名相等false：实体名与指定名不等 |
抛出异常说明 无。
规则说明 无。
# 【参考案例】
示例：判断对象entity的实体名与com.primeton.das.criteria.criteriaType是否相等。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | entity | DataObject | cust | 变量 | 传引用 |
| 参数 | entityName | String | com.primeton.eos.foundation.example.data.CUST | 常量 | 传引用 |
| 返回值 | out0 | boolean | result | 变量 | 传引用 |
参数描述
- 第一个输入参数：SDO对象实体cust
- 第二个输入参数：实体对象名称com.primeton.eos.foundation.example.data.CUST
- 返回值：当entity的实体名称与com.primeton.eos.foundation.example.data.CUST相同时，返回true；否则返回false
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<cust __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID/>
<CUSTCODE/>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<cust __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID/>
<CUSTCODE/>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<result __type="java:java.lang.Boolean">true</result>
</__root></bizContext>
# concatPropertyValues：把指定属性拼成字符串
# 【功能说明】
遍历实体实例数组中每个实体实例，获取指定属性的值，然后拼成字符串。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataObjectUtil.concatPropertyValues，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | entities | commonj.sdo.DataObject[] | 实体实例数组。 |
| 参数 | propertyName | java.lang.String | 指定的属性名称。 |
| 参数 | roundString | java.lang.String | 用什么字符串包裹属性值。如半角单引号"'"，如果该参数传递的数值为null，则默认为'（半角单引号）。例如：该参数按变量传递，变量未初始化。 |
| 参数 | joinString | java.lang.String | 多个属性值之间用什么字符串连接。如半角逗号","，如果该参数传递的数值为null，则默认为,（半角逗号）。 |
| 参数 | ignoreNullValue | boolean | 是否忽略为null的属性值。 |
| 返回值 | java.lang.String | 拼接好的字符串。 |
抛出异常说明 无。
规则说明 无。
# 【参考案例】
示例：将客户名称拼成按"-"拼接的字符串。
场景描述 无。
参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | entities | commonj.sdo.DataObject[] | custes | 变量 | 传引用 |
| 参数 | propertyName | java.lang.String | CUSTNAME | 常量 | 传引用 |
| 参数 | roundString | java.lang.String | " | 常量 | 传引用 |
| 参数 | joinString | java.lang.String | , | 常量 | 传引用 |
| 参数 | ignoreNullValue | boolean | true | 常量 | 传引用 |
| 返回值 | out0 | java.lang.String | result | 变量 | 传引用 |
参数描述
- 第一个参数是客户实体数组
- 第三个参数代表每个客户名称会以"进行包围，例如："张三"
- 第四个参数代表使用,进行拼接，例如："张三","李四"
- 第五个参数代表忽略为null的客户名称
参数配置 如下图所示：
其他说明 无。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<custes __id="1" __type="java:[Lcommonj.sdo.DataObject;">
<__entry __componentType="java:commonj.sdo.DataObject" __id="2" __index="0"
__type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID __type="java:java.lang.Integer">1</CUSTID>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
<SEX __type="java:java.lang.String">male</SEX>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __id="3" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID __type="java:java.lang.Integer">2</CUSTID>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_2</CUSTNAME>
<BIRTH __type="java:java.util.Date">2009-09-10 00:00:00</BIRTH>
<SEX __type="java:java.lang.String">female</SEX>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<custes __id="1" __type="java:[Lcommonj.sdo.DataObject;">
<__entry __componentType="java:commonj.sdo.DataObject" __id="2" __index="0"
__type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID __type="java:java.lang.Integer">1</CUSTID>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
<SEX __type="java:java.lang.String">male</SEX>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __id="3" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID __type="java:java.lang.Integer">2</CUSTID>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_2</CUSTNAME>
<BIRTH __type="java:java.util.Date">2009-09-10 00:00:00</BIRTH>
<SEX __type="java:java.lang.String">female</SEX>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
<result __type="java:java.lang.String">"cust_1","cust_2"</result>
</__root>
</bizContext>
# convertDataObject：转换单个DataObject的类型
# 【功能说明】
用来将一种类型的DataObject转换成指定类型的DataObject。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataObjectUtil.convertDataObject，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | obj | DataObject | 待转换DataObject，即源实体对象 |
| 参数 | entityName | String | 实体名称，即目标对象的实体名称 |
| 参数 | convertAll | boolean | Unknown macro: {span}true：不管目标对象是否有此属性，将源对象的所有属性都转到目标对象中去； false：只转换目标对象和源对象同名的属性值。 |
| 返回值 | out0 | DataObject | 一个指定实体名称的DataObject对象，即目标对象 |
抛出异常说明 如果数据实体名称对应的实体不存在，会抛出实体类型不存在的异常 如果源对象和目标对象的属性名称相同，但类型不同且无法转换，会抛出类型无法转换的异常
规则说明 无。
# 【参考案例】
示例：将com.primeton.eos.foundation.example.data.CUST实体类型的DataObject转换成com.primeton.eos.foundation.example.data.Person实体类型的对象。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
| 参数 | obj | DataObject | cust | 变量 | 传引用 |
| 参数 | entityName | String | com.primeton.eos.foundation.example.data.Person | 常量 | 传引用 |
| 参数 | convertAll | boolean | false | 常量 | 传引用 |
| 返回值 | out0 | DataObject | result | 变量 | 传引用 |
参数描述
- 第一个输入参数：源实体对象cust，类型为com.primeton.eos.foundation.example.data.CUST
- 第二个输入参数：目标对象的实体名称com.primeton.eos.foundation.example.data.Person
- 第三个输入参数：将源实体对象和目标对象中相同名称的属性的值转移到目标对象中
- 返回值：目标对象。
其它说明
- 如果在调用该运算构件之前，已存在的名称为result的变量，调用该运算构件后，result将会被新的对象覆盖。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<cust __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID __type="java:java.lang.Integer">1</CUSTID>
<CUSTCODE/>
<CUSTNAME/>
<BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
<SEX __type="java:java.lang.String">male</SEX>
<ADDRESS/>
<PHOTO/>
</cust>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<cust __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID __type="java:java.lang.Integer">1</CUSTID>
<CUSTCODE/>
<CUSTNAME/>
<BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
<SEX __type="java:java.lang.String">male</SEX>
<ADDRESS/>
<PHOTO/>
</cust>
<result __id="2" __type="sdo:com.primeton.eos.foundation.example.data.Person">
<NAME/>
<BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
<SEX __type="java:java.lang.String">male</SEX>
</result>
</__root>
</bizContext>
# convertDataObjects：转换一组DataObject的类型
# 【功能说明】
用来将一种类型的DataObject数组转换成指定类型的DataObject数组。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataObjectUtil.convertDataObjects，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | objs | Object | 待转换DataObject数组或List，即源对象数组或List |
| 参数 | entityName | String | 实体名称，即目标对象数组的实体名称 |
| 参数 | convertAll | boolean | Unknown macro: {span}true：不管目标对象是否有此属性，将源对象的所有属性都转到目标对象中去； false：只转换目标对象和源对象同名的属性值。 |
| 返回值 | out0 | DataObject[] | 一个指定实体名的DataObject对象数组，即目标对象数组 |
抛出异常说明 如果数据实体名称对应的实体不存在，会抛出实体类型不存在的异常 如果源对象和目标对象的属性名称相同，但类型不同且无法转换，会抛出类型无法转换的异常
规则说明 无。
# 【参考案例】
示例：将一种类型的DataObject数组转成另一种类型的DataObject数组。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | objs | Object | custes | 变量 | 传引用 |
| 参数 | entityName | String | com.primeton.eos.foundation.example.data.Person | 常量 | 传引用 |
| 参数 | convertAll | boolean | false | 常量 | 传引用 |
| 返回值 | out0 | DataObject[] | result | 变量 | 传引用 |
参数描述
- 第一个输入参数：源实体对象数组custes，类型为com.primeton.eos.foundation.example.data.CUST
- 第二个输入参数：目标对象的实体名称com.primeton.eos.foundation.example.data.Person
- 第三个输入参数：将源实体对象和目标对象中相同名称的属性的值转移到目标对象中
- 返回值：目标对象
其它说明
- 如果在调用该运算构件之前，已存在的名称为result的变量，调用该运算构件后，result将会被新的对象覆盖。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<custes __id="1" __type="java:[Lcommonj.sdo.DataObject;">
<__entry __componentType="java:commonj.sdo.DataObject" __id="2" __index="0"
__type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID __type="java:java.lang.Integer">1</CUSTID>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
<SEX __type="java:java.lang.String">male</SEX>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __id="3" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID __type="java:java.lang.Integer">2</CUSTID>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_2</CUSTNAME>
<BIRTH __type="java:java.util.Date">2009-09-10 00:00:00</BIRTH>
<SEX __type="java:java.lang.String">female</SEX>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<custes __id="1" __type="java:[Lcommonj.sdo.DataObject;">
<__entry __componentType="java:commonj.sdo.DataObject" __id="3" __index="0"
__type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID __type="java:java.lang.Integer">1</CUSTID>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
<SEX __type="java:java.lang.String">male</SEX>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __id="4" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID __type="java:java.lang.Integer">2</CUSTID>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_2</CUSTNAME>
<BIRTH __type="java:java.util.Date">2009-09-10 00:00:00</BIRTH>
<SEX __type="java:java.lang.String">female</SEX>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
<result __id="2" __type="java:[Lcommonj.sdo.DataObject;">
<__entry __componentType="java:commonj.sdo.DataObject" __id="5" __index="0"
__type="sdo:com.primeton.eos.foundation.example.data.Person">
<NAME/>
<BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
<SEX __type="java:java.lang.String">male</SEX>
<CUSTID __type="java:java.lang.Integer">1</CUSTID>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
</__entry>
<__entry __id="6" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.Person">
<NAME/>
<BIRTH __type="java:java.util.Date">2009-09-10 00:00:00</BIRTH>
<SEX __type="java:java.lang.String">female</SEX>
<CUSTID __type="java:java.lang.Integer">2</CUSTID>
<CUSTNAME __type="java:java.lang.String">cust_2</CUSTNAME>
</__entry>
</result>
</__root>
</bizContext>
# createDataObject：创建DataObject对象
# 【功能说明】
用来根据实体名创建一个SDO对象。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataObjectUtil.createDataObject，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | entityName | String | 数据实体全称 |
| 返回值 | out0 | DataObject | 一个指定实体名的DataObject对象 |
抛出异常说明 如果数据实体全称对应的实体不存在，会抛出实体不存在的异常。
规则说明 无。
# 【参考案例】
示例：创建一个com.primeton.eos.foundation.example.data.CUST类型的DataObject。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | entityName | String | com.primeton.eos.foundation.example.data.CUST | 常量 | 传引用 |
| 返回值 | out0 | DataObject | result | 变量 | 传引用 |
参数描述
- 输入参数：要创建的实体对象的全称com.primeton.eos.foundation.example.data.CUST
- 返回值：com.primeton.eos.foundation.example.data.CUST类型的实体对象result
调用前的bizContext
<bizContext>
<__root __id="0" __isNullOrEmpty="empty" __type="java:java.util.HashMap"/>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<result __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID/>
<CUSTCODE/>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</result>
</__root>
</bizContext>
# getSizeOrLength：获取数组或List对象的长度
# 【功能说明】
用来获取数组或List对象的长度。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataObjectUtil.getSizeOrLength，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | Object | 数组对象或Collection/Map对象 |
| 返回值 | out0 | int | 数组对象或Collection/Map对象的长度 |
抛出异常说明 无。
规则说明 Object必须为数组对象或Collection/Map对象，否则返回0。
# 【参考案例】
示例：获取一个数组对象的长度。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | Object | custes | 变量 | 传引用 |
| 返回值 | out0 | int | result | 变量 | 传引用 |
参数描述
- 输入参数：数组对象custes
- 返回值：custes的长度
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<custes __id="1" __type="java:[Lcommonj.sdo.DataObject;">
<__entry __componentType="java:commonj.sdo.DataObject" __id="2" __index="0"
__type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID/>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __id="3" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID/>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_2</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<custes __id="1" __type="java:[Lcommonj.sdo.DataObject;">
<__entry __componentType="java:commonj.sdo.DataObject" __id="2" __index="0"
__type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID/>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __id="3" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID/>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_2</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
<result __type="java:java.lang.Integer">2</result>
</__root>
</bizContext>
# importExcelToDataObject：读取excel将其转化为SDO对象
# 【功能说明】
将符合格式规定的excel文件导入成DataObject实例，excel的每一行将转换为一个DataObject实例。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataObjectUtil.importExcelToDataObject，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | filePath | java.lang.String | excel文件绝对路径。 |
| 参数 | entityName | java.lang.String | DataObject的实体名称（必须是实体的全称），如果为null或者""， 则用com.primeton.das.datatype.AnyType类型。 |
| 参数 | propertyList | java.lang.String | excel中的字段映射格式：[property[:index]][,property[:index]]。 index默认从1开始，1代表excel中的A列， 如果没有写index，就表示是上一个字段的index+1，第一个字段中没有index则为1。 property表示当前实体中的定义属性名，可以用Xpath，如导入员工中包含机构编号，则为"org/orgName"。 |
| 参数 | startLine | int | 数据导入起始行，默认从1开始， 例如startLine为2，代表从第2行开始读取数据，第1行数据将被忽略。 |
| 返回值 | commonj.sdo.DataObject[] | 转换以后的DataObject实例数组。 |
抛出异常说明 无。
规则说明 无。
# 【参考案例】
示例：将存储在excel文件中的客户信息转换为对应的DataObject。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | filePath | java.lang.String | importFile | 变量 | 传引用 |
| 参数 | entityName | java.lang.String | com.primeton.eos.foundation.example.data.CUST | 常量 | 传引用 |
| 参数 | propertyList | java.lang.String | CUSTID:1,CUSTNAME:2,BIRTH:3,ADDRESS:4 | 常量 | 传引用 |
| 参数 | startLine | int | 1 | 常量 | 传引用 |
| 返回值 | out0 | commonj.sdo.DataObject[] | results | 变量 | 传引用 |
参数描述
- 这里是示例案例，因此第一个参数excel文件路径设置为常量，实际情况应该是遍历某个目录，将其中的所有excel文件都导入。 该文件的格式和内容如下表所示：
| CUSTID | CUSTNAME | BIRTH | ADDRESS |
|---|---|---|---|
| 1 | cust_1 | 2009-9-9 | 上海 浦东 |
| 2 | cust_2 | 2009-9-9 | 上海 静安 |
| 3 | cust_3 | 2009-9-9 | 上海 长宁 |
第二个参数entityName为com.primeton.eos.foundation.example.data.CUST
第三个参数根据custs.xls定义为：CUSTID:1,CUSTNAME:2,BIRTH:3,ADDRESS:4
第四个参数1，是因为该excel文件有没有标题行，因此是从第1行开始读取。
参数配置 如下图所示：
其他说明 无。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<currentDir __type="java:java.lang.String">D:\eos6studio\1277\eosserver\working\eos-
default\work\user\com.primeton.eos.foundation.example\com\primeton\eos\
foundation\example\DataObjectUtil</currentDir>
<importFile __type="java:java.lang.String">D:\eos6studio\1277\eosserver\working\eos-
default\work\user\com.primeton.eos.foundation.example\com\primeton\eos\
foundation\example\DataObjectUtil\customer.xls</importFile>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<currentDir __type="java:java.lang.String">D:\eos6studio\1277\eosserver\working\eos-
default\work\user\com.primeton.eos.foundation.example\com\primeton\eos\
foundation\example\DataObjectUtil</currentDir>
<importFile __type="java:java.lang.String">D:\eos6studio\1277\eosserver\working\eos-
default\work\user\com.primeton.eos.foundation.example\com\primeton\eos\
foundation\example\DataObjectUtil\customer.xls</importFile>
<results __id="1" __type="java:[Lcommonj.sdo.DataObject;">
<__entry __componentType="java:commonj.sdo.DataObject" __id="2" __index="0"
__type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID __type="java:java.lang.Double">1.0</CUSTID>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
<SEX/>
<ADDRESS __type="java:java.lang.String">上海 浦东</ADDRESS>
<PHOTO/>
</__entry>
<__entry __id="3" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID __type="java:java.lang.Double">2.0</CUSTID>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_2</CUSTNAME>
<BIRTH __type="java:java.util.Date">2009-09-10 00:00:00</BIRTH>
<SEX/>
<ADDRESS __type="java:java.lang.String">上海 静安</ADDRESS>
<PHOTO/>
</__entry>
<__entry __id="4" __index="2" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID __type="java:java.lang.Double">3.0</CUSTID>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_3</CUSTNAME>
<BIRTH __type="java:java.util.Date">2009-09-11 00:00:00</BIRTH>
<SEX/>
<ADDRESS __type="java:java.lang.String">上海 长宁</ADDRESS>
<PHOTO/>
</__entry>
</results>
</__root>
</bizContext>
# isDataType：是否为基本数据类型
# 【功能说明】
用来判断SDO对象属性的type是否为基本数据类型。以便区分SDO的属性是DataObject还是SDO基本类型。 其中，基本类型如下表所示：
| 类型 | 描述 |
|---|---|
| Boolean | 布尔型 |
| Byte | 二进数 |
| Bytes | 二进数数组 |
| Char | 字符 |
| Date | 日期 |
| Time | 时间 |
| Decimal | 数组 |
| Double | 双精度实数 |
| Float | 单精度实数 |
| Int | 4字节整数 |
| Integer | 4字节整数 |
| Long | 8字节整数 |
| Short | 2字节整数 |
| String | 字符串 |
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataObjectUtil.isDataType，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | entity | DataObject | SDO对象 |
| 参数 | property | String | 属性名 |
| 返回值 | out0 | boolean | Unknown macro: {span}true：为SDO基本数据类型 false：为其他类型 |
抛出异常说明 传入的属性名找不到对应属性的时候，会抛找不到属性的异常。
规则说明 无。
# 【参考案例】
示例：判断role对象的eOSOPERATORROLEs属性的类型是否为基本数据类型。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | entity | DataObject | cust | 变量 | 传引用 |
| 参数 | property | String | CUSTID | 常量 | 传引用 |
| 返回值 | out0 | boolean | result | 变量 | 传引用 |
参数描述
- 第一个输入参数：一个SDO实体对象cust，类型是com.primeton.eos.foundation.example.data.CUST
- 第二个输入参数：cust的一个属性名称CUSTID
- 返回值：如果属性CUSTID是基本类型，返回true；否则返回false
其它说明 如果role的属性名称输入错误，运行时会报找不到属性的错误。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<cust __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID/>
<CUSTCODE/>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<cust __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID/>
<CUSTCODE/>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<result __type="java:java.lang.Boolean">true</result>
</__root>
</bizContext>