套打模板GetDataSourceValue取数函数用法

2021年1月（补丁号：PT-146864）版本开始，套打模板中文本、条形码以及数据表格单元格支持使用GetDataSourceValue("单据体标识","字段标识")来拼接多个字段；函数常用于在固定条款内容中拼接单据上的字段值，具体用法如下：

一、函数的取数来源

①GetDataSourceValue("单据体标识","字段标识")中，由两部分组成，第一部分是单据体标识，也就是取值的字段所在的表体（如单据头、明细信息表体），在套打模板中使用鼠标“右键”打开“增加实体动态字段界面”，右上角这个“实体标识”为FPOOrderEntry，也就是这个单据体的标识；

②GetDataSourceValue("单据体标识","字段标识")中，第二部分的字段标识，也就是实际字段取值的标识，可在右侧数据源中查询，如物料编码·名称，对应的标识为FMaterialId.FName，结合第①点，物料名称的取值可以转换为函数GetDataSourceValue("FPOOrderEntry","FMaterialId.FName")

二、实际应用场景中，GetDataSourceValue("单据体标识","字段标识")可用于多个字段以及固定值的拼接，效果图如下：

示例① 

物料名称：GetDataSourceValue("FPOOrderEntry","FMaterialId.FName")

示例② 

单据GetDataSourceValue("FBillHead","FBillNo")上物料GetDataSourceValue("FPOOrderEntry","FMaterialId.FName")数量GetDataSourceValue("FPOOrderEntry","FQty")

（公式中FBillHead为单据头的实体表示，FBillNo为单据编号的字段标识）

三、GetDataSourceValue("单据体标识","字段标识","字段格式串")

使用GetDataSourceValue("单据体标识","字段标识")函数拼多个值后，再设置单元格格式会发现设置不生效，这里GetDataSourceValue("单据体标识","字段标识")函数与GetValue函数是类似的，同样支持在函数中携带数据源

套打GetValue取数函数允许传入格式化字符串

①以拼接数量字段携带单元格格式为例，数量GetDataSourceValue("FPOOrderEntry","FQty")取值效果如下，单元格直接设置的格式并没有生效

②可以通过在函数中带入格式串的方式来携带格式；

设置好单元格格式后，点击自定义，可以转换成对应的”格式串“（0.00;[red](0.00)），把格式串放进GetDataSourceValue("单据体标识","字段标识","字段格式串")函数中，函数为GetDataSourceValue("FPOOrderEntry","FQty","0.00;[red](0.00)"),此时预览的效果就可以携带格式了