盈帆数据报表工具之如何使用参数盈帆数据报表工具之如何使用参数报表的使用中难免需要使用到参数，这些参数需要与实际的报表内容相关联。通常情况下在SQL中需要把使用到的参数参与其中，最终根据参数的实际值，显示相应的数据内容。例如：常用的日期参数，使用日期参数来筛选不同时间段的数据内容等。
盈帆报表数据工具中包括：模板参数、用户参数、特殊参数等，使用场景略有不同。 模板参数盈帆数据报表工具中点击“模板”-》“模板参数”，弹出模板参数界面，可设置模板参数。
属性点击模板参数中的“+”，添加一个模板参数，模板参数的属性设置中包括：每行参数数量、左边留白、上边留白、间隔像素；名称、默认值、数据类型、联动参数、宽度；绑定设置等。
控件类型是下拉框或多选下拉框时，需要设置绑定的数据源、数据字段索引与显示字段索引。数据字段索引与显示字段索引需要设置数据源字段所在位置，索引位置从“1”开始。需要注意的是，设置的数据源不能使用当前模板参数，否则会造成循环，不能正常显示报表。
控件类型是下拉树或多选下拉树时，需要设置树的层次，并绑定每一层次的数据源、数据字段索引与显示字段索引。数据字段索引与显示字段索引需要设置数据源字段所在位置，索引位置从“1”开始。需要注意的是，设置的数据源不能使用当前模板参数，否则会造成循环，不能正常显示报表。
控件类型是日期编辑框时，可以设置显示的日期格式，日期格式包括：yyyy-MM-dd、yyyy/MM/dd、yyyyMMdd。
控件类型是日期时间编辑框时，可以设置显示的时间格式，日期格式包括：yyyy-MM-dd HH:mm:ss、yyyy/MM/dd HH:mm:ss、yyyyMMdd HH:mm:ss。
控件类型是日期编辑框(年月)时，可以设置显示的日期格式，日期格式包括：yyyy-MM、yyyy/MM、yyyyMM。
控件类型是自定义下拉框列表时，需设置显示值与绑定值。
使用方式模板参数通常情况下可以在数据集的SQL中使用，也可以在单元格中作为变量来进行公式计算。在使用是需要使用“@{模板参数名称}”格式来使用。在SQL中使用名为param1的模板参数，数据类型设置为“字符串”，实际使用时，可如下方式使用： “select 地区,业务员,供应商,产品名称,订购数量 from 产品销量 where 业务员=@{param1}” 最终使用此数据集的字段时，会根据实际传递的参数来显示相应的数据内容。在单元格中，可以直接将此参数作为变量来使用，可参与公式的计算。 用户参数在盈帆数据报表中，提供了默认的用户参数，使用用户参数可获取当前用户的数据信息，包括：用户账号“@{efUserName}”、用户名称“@{efName}”、角色名称“@{efRoleName}”、部门第一级“@{efDeptName1}”、部门第二级“@{efDeptName2}”、E-mail“@{efEmail}”、微信“@{efWechat}”、钉钉“@{efTalkding}”等。 特殊参数模板参数绑定的类型是下拉树或者多选下拉树时，作为子树时需要注意，子树关联的数据集需要使用“@{parentNodeValue}”来最为父参数使用，例如：层次1使用的数据集SQL语句是：“select 省份 from 城市销量 group by 省份”，层次2使用的数据集SQL语句需要使用“@{parentNodeValue}”来代替选择的省份参数：“select 城市 from 城市销量 where 省份='@{parentNodeValue}' group by 城市”。具体例子可参考“参数下拉树多选”模板。 使用多数据集相关联的数据集时，作为需要关联的数据集可以使用“@{parent.单元格}”，再在表单中，将关联的单元格父格设置为主数据集的字段单元格。例如：数据集设置为“select 省份,城市,成本,销售额,利润额,运营费用,税费,总工资,其他 from 城市销量 where 省份=@{parent.C5}”，它的字段设置父格为C5，C5单元格的内容是实际需要筛选的省份。具体例子可参考“折叠树”模板。 使用筛选功能时，如果需要对数据集里面的字段进行筛选，需要使用“@{字段名称}”的方式进行筛选。 |
