用法和示例

若要配置日期选择器 Web 扩展,必须指定以下参数:

  • 主题:指定颜色主题。选项是“"鲜艳"”和“"淡雅"”。默认为“"淡雅"”。
  • 模式:指定颜色。值为“"浅色"”、“"深色"”、“"高对比度"”和 “""”。空字符串值 “""” 等同于 “"浅色"” 值。
  • 标签:设置控件的标签。空字符串值 “""” 隐藏标签、所需指示符和带有工具提示的信息图标。
  • 值:表示日期选择器当前值的日期数字表示形式,例如日期选择器为 YYYY-MM-DD,日期时间选择器为 YYYY-MM-DD'T'hh:mm:ss。当值更改时,将执行已编辑单元格操作的单元格引用。
  • 必填:定义是否要求选择元素。如果未提供,则默认为 “"TRUE"”。
  • 信息:为“信息”图标提供工具提示文本。空字符串 “""” 隐藏信息图标。
  • 提示文本:将提示文本定义为字符串,如果未选择日期,则显示该提示。空字符串 “""” 显示日期格式,这取决于区域设置。
  • 脏标志:表示所选日期是否已更改。使用 “"TRUE"” 或空字符串 “""” 来使用脏标志指示符。使用 “"FALSE"” 以忽略标记。
  • 类型:定义使用默认日期选择器还是日期时间选择器。
  • 日期范围:包含逗号分隔的开始和结束日期以及禁用范围和日期的条件列表。如果未提供,则日期范围为 2000-01-01 至 2099-12-31。
  • 状态:将控件状态定义为 “"已启用"”、“"已禁用"” 或 “"只读"”。如果未提供,默认为 “"已启用"”。
  • 错误:如果以字符串形式提供错误文本,则控件将呈现错误状态。使用空字符串 “""” 隐藏错误状态。

此示例显示如何创建日期选择器并将此选择存储在报告变量中以供进一步处理。

  1. 创建 Application Studio 报告。
  2. 创建名为 Selected_Date 的报告变量。
  3. 在“属性 - 报告”窗格中,将“即时写回”选项设置为“自动”。
  4. 在单元格 B5:C6 中插入日期选择器 Web 扩展。
  5. 在 “Web 扩展格式”对话框中,指定以下值:
    主题
    指定 “="鲜艳"”
    模式
    指定 “="浅色"”
    标签
    指定 “="开始日期"”
    值
    指定 “=B9”
    必填
    指定 “="TRUE"”
    信息
    指定 “="设置员工开始日期"”
    提示文本
    指定 “=""”
    脏标志
    指定 “=""”
    类型
    指定 “="日期"”
    数据范围
    指定 “=""”
    状态
    指定 “="已启用"”
    错误
    指定 “=""”
  6. 单击 B9 单元格并添加 Getproperty("XML_properties","key","property") 函数:
    =
    	IF(
    		GETPROPERTY(ReportVariables.Selected_Date.Text,"ID1","value")="",
    		NOW(),
    		GETPROPERTY(ReportVariables.Selected_Date.Text,"ID1","value“))
  7. 为 B9 单元格用以下设置定义操作:
    • 操作
      类型
      指定“设置参数”
      条件
      指定 “=TRUE”
      模式
      指定“编辑单元格”
    • 参数
      名称
      指定 “Selected_Date”
      属性
      指定“Value(.Text)”
      值
      指定 =SETPROPERTY(ReportVariables.Selected_Date.Text,"ID1","value",B9)
  8. 单击“确定”。
  9. 在 Web 浏览器中保存并查看报告。