Workiva Support Center

在这个关联学习路径中，我们将创建一个链，说明如何动态地考虑闰年。

步骤 1：创建链

• 在工作区的“链式模块”中，选择 DEV 环境
• 添加一个新的链
  • 命名链， CLP | 变量转换 | 解析日期和时间。
  • 添加描述： “关联学习路径链”模板展示了如何通过运行时输入月份和年份来动态生成各种期间键格式并处理闰年。此模板使用变量转换来重新格式化日期，并计算结束期间键，同时动态地处理闰年。
• 拯救链条

步骤 2：添加运行时输入

运行时输入 说明了链如何在执行时提示输入值。这是使 Chains 能够在多个流程中使用的重要方法。

• 创建命令
  • 向“开始”节点添加运行时输入
    使用搜索栏搜索“运行时”。然后双击即可将命令自动加载到开始圆圈中。
  • 点击 添加输入 并选择 下拉字段。
  • 使用以下内容配置 DropdownField ：
    

    显示名称	月份
    必要	已核取
    描述	选择当前月份

  • 点击 添加选项
  • 请使用以下选项进行配置：
    

    值	{"display":"一月","value":"01-01"}
    显示名称	1 月
    默认	未检查

• 填写下拉菜单字段
  • 添加一年中剩余十一个月的选项。请相应地更新值和显示名称。
    • 示例： {"display":"二月","value":"02-01"}
• 添加一个 NumberField 运行时输入
  • 完成下拉字段输入后，添加一个 数字字段 输入
  • 使用以下内容配置 NumberField ：
    

    显示名称	年
    必要	已核取
    描述	请以 YYYY 格式输入当前年份
    默认值	<leave blank>
    最小值（已检查）	2000
    最大值（已勾选）	2050

• 保存运行时输入

步骤 3：添加创建期间键的命令

我们使用 Handlebars 连接器来获取运行时输入中指定的值，并创建 YYYY-MM-DD 格式的周期键。

• 从 Handlebars 连接器向链添加 渲染文本模板 命令
• 将起始节点（运行时输入）连接到 渲染文本模板 命令
• 编辑命令
  • 命令名称： 渲染文本模板 - 创建句点键
  • 在“模板”参数中，输入以下内容：
    

    {{年份}}-{{期间}}

  • 在“变量”部分，单击 “变量 ”部分上的 “添加 ”按钮两次，添加两个变量。
  • 对于第一个变量，请将变量名称指定为 Year
    • 注意：变量名区分大小写
  • 点击 值 字段
    • 在“变量”窗格中，展开 “触发器”➡“运行时 输入”，然后选择 “年份”。
  • 在第二个变量中，将名称指定为 周期
  • 点击 值 字段
    • 在“变量”窗格中，展开 T触发器 ➡ 运行时输入 并选择“月份”。
    • 单击分配给该值的 月份 变量（如气泡所示）。
    • 点击 选择变换 下拉菜单
      • 选择 将文本解析为 JSON
      • 点击加号（+）符号
      • 再次单击 “选择变换 ”下拉菜单
        • 选择从 JSON 获取值
        • 点击加号
      • 在从 JSON 获取值时，
        • 从“输出”列的下拉菜单中选择“T”。
          • 注： T 是在上一步中确定的月份变量
        • 在“值”列的字段中，输入“值”，然后按 Enter 键。
          • 注意：文本值必须为小写字母，按下 Enter 键后将显示为灰色气泡。
      • 点击 接受
• 保存命令

步骤 4：添加执行日期操作的命令

我们使用 Handlebars Connector 来执行多个日期操作，包括日期运算和重新格式化。

• 从 Handlebars 连接器向链添加 渲染文本模板 命令
• 将 渲染文本模板 - 创建句点键 命令连接到渲染文本模板命令
• 编辑命令
  • 命令名称： 渲染文本模板 - 日期解析
  • 在 模板 参数中，输入以下内容：

已选择时间段：

月份：{{Month_Name}}

年：

周期键：{{Period_Key}}

月末期间键：{{EOM_Key}}

• • 在模板参数部分
    • 点击年份
    • 然后展开“触发器 ➡ 运行时输入”，并选择“年份”。

步骤 5：变量部分

• 点击“变量”部分的“添加”按钮，添加三个变量。
  • 对于第一个变量：
    • 第一个变量名指定为 Month_Name
      • 单击“值”字段
        • 在“变量”窗格中，展开 “触发器”➡“运行时输入” ，然后选择 “月份”
      • 单击“值”字段中 “月份 ”变量的气泡
        • 点击 选择变换 下拉菜单
          • 选择 “将文本解析为 JSON” ，然后单击加号 (+) 符号
        • 再次单击 “选择变换 ”下拉菜单
          • 选择 “从 JSON 获取值” ，然后单击加号 (+) 符号
            • 在“从 JSON 获取值”行中，从“输出”下拉列表中选择 T
            • 在同一行“从 JSON 获取值”语句中，在“值”字段中输入 并显示 ，然后按 Enter 键。
            • 点击 接受

• 对于第二个变量：
  • 指定变量名称为 Period_Key
    • 点击 值 字段
      • 在“变量”窗格中，展开 渲染文本模板 - 创建句点键
        • 选择 已渲染文本
    • 单击“值”字段中“ 渲染文本 ”变量的气泡
      • 单击 “选择转换 ”下拉菜单，选择 “解析日期/时间” ，然后单击加号 (+) 按钮。
      • 在第一个下拉框中，输入 %Y-%m-%d 并务必按 Enter 键。
      • 在“输出日期格式”字段中，输入 %m/%d/%Y
      • 在“输入日期时区”下拉菜单中，输入 UTC，然后选择 (UTC) 都柏林、爱丁堡、里斯本、伦敦 时区
      • 对“输出日期时区”字段重复选择 UTC 时间
      • 点击 接受

• 对于第三个变量：
  • 指定变量名称为 EOM_Key
    • 点击“值”字段。在“变量”窗格中，展开 “渲染文本模板 - 创建句点键 ” ，然后选择 “渲染文本”。
    • 单击已分配给值的 Rendered Text 变量
      • 点击 “选择转换 ”下拉菜单，选择 “添加/减去日期和时间” ，然后点击加号 (+) 符号。
        • 在“格式”下拉框中，输入 %Y-%m-%d ，然后按 Enter 键。
        • 在“操作”下拉菜单中，选择 添加
        • 在“金额”栏中，输入 1
        • 在“单位”下拉菜单中，选择 月
      • 添加额外的 添加/减去日期 和时间转换
        • 在“格式”下拉框中，输入 %Y-%m-%d ，然后按 Enter 键。
        • 在“运算”下拉菜单中，选择 “减去”。
        • 在“金额”栏中，输入 1
        • 在“单位”下拉菜单中，选择 天
      • 输出日期时区字段
      • 点击 接受
• 保存命令

步骤 6：测试链条

现在链条已经完成，我们可以测试结果了。

• 发布 链
• 点击 执行 ，然后选择 使用输入运行
• 从 月份 下拉列表中，选择 二月。在“年份”输入框中，输入 2024
• 点击 开始。在 渲染文本模板 - 创建期间键 命令 的 [] 日志 选项卡上查看链的结果
  • 确认 月末结算周期 键值，例如闰年

• 使用二月再次执行链式操作，但这次执行的年份输入 2025 。
  • 确认该月结束的日期是否正确，即是否为闰年。

要了解有关使用 Chains 进行数据转换的更多信息，请查看 连接学习路径 - 转换简介！