Workiva 支援中心

在本連線學習路徑中，我們將建立一個 Chain，說明如何動態地計算闰年。

步驟 1：建立鏈條

• 從工作區中的 Chains 模組，選擇DEV 環境
• 新增Chain
  • 命名鏈，CLP | Variable Transformation | Parsing Date and Time 。
  • 新增說明：Connected Learning Path Chain（連結學習路徑鏈）範本說明了月和年的運行時輸入如何動態生成各種期間密鑰格式並計入闰年。此範本使用 Variable Transformation 來重新格式化日期，以及在動態計算闰年時計算結束週期鍵。
• 儲存鏈

步驟 2：新增運行時輸入

Runtime Inputs 說明 Chain 如何在執行時提示值。這是使 Chain 能夠在多個進程中使用的重要方法。

• 建立指令
  • 在開始節點中加入運行時間輸入
    使用搜尋列搜尋 "runtime"。然後按兩下以自動將指令載入 Start 圓圈。
  • 按一下新增輸入 並選擇DropdownField 。
  • 使用下列內容設定DropdownField ：
    

    顯示名稱	月份
    必要的	已核取
    說明	選擇目前月份

  • 按一下新增選項
  • 使用下列選項進行設定：
    

    值	{"display":"January","value":"01-01"}
    顯示名稱	1 月
    預設	未勾選

• 完成下拉式欄位
  • 為一年中餘下的十一個月新增選項。相應更新值和顯示名稱
    • 範例：{"display":"February","value":"02-01"}
• 新增NumberField Runtime Input
  • 完成下拉式欄位輸入後，新增一個NumberField 輸入
  • 使用下列內容設定NumberField ：
    

    顯示名稱	年
    必要的	已核取
    說明	以 YYYY 格式輸入目前年份
    預設值	<leave blank>
    最小值 (已勾選)	2000
    最大值（已檢查）	2050

• 儲存運行時間輸入

步驟 3：新增指令以建立週期鍵

我們使用 Handlebars Connector 來取得 Runtime Inputs 中指定的值，並建立 YYYY-MM-DD 格式的 period key。

• 從Handlebars Connector 新增Render Text Template Command 到 Chain。
• 將 Start Node (Runtime Inputs) 連接到渲染文字範本 指令
• 編輯指令
  • 命名指令：渲染文本模板 - 創建週期鍵
  • 在範本參數中，輸入下列內容：
    

    {{Year}}-{{Period}}

  • 在變數部分中，按兩下變數 部分中的新增 按鈕，以新增兩個變數。
  • 針對第一個變數，指定變數名稱為年份
    • 注意：變量名稱區分大小寫
  • 在Value 欄位中按一下
    • 在變數窗格中，展開觸發器 ➡ 運行時間 輸入，然後選擇年份
  • 在第二個變數中，指定名稱為Period
  • 在Value 欄位中按一下
    • 在變量窗格中，展開 Trigger ➡ Runtime Inputs ，然後選擇月份
    • 按一下被指定值的Month 變數 (如氣泡所表示)
    • 按一下選擇變形 下拉式
      • 選擇將文字解析為 JSON
      • 按一下正 (+) 符號
      • 再次按一下選擇變形 下拉選項
        • 選擇從 JSON 取得值
        • 按一下加號符號
      • 在從 JSON 、
        • 從 Output 列的下拉式選單中，選擇 "T
          • 注意：T 是在前一步中建立的月份變數。
        • 在 Value 列的欄位中，輸入 "value" 並按下 Enter 鍵
          • 注意：文字值必須小寫，按下 Enter 鍵後會出現灰色氣泡。
      • 按一下「接受」(Accept)。
• 儲存指令

步驟 4：新增執行日期操作的指令

我們使用 Handlebars Connector 來執行幾個日期操作，包括日期數學和重新格式化。

• 從 Handlebars 連接器新增渲染文字範本 指令到連鎖程式
• 連接渲染文字模板 - 建立週期鍵 指令至渲染文字模板指令
• 編輯指令
  • 命名命令：渲染文本模板 - 日期解析
  • 在Template 參數中，輸入以下內容：

Time Period Selected（已選擇的時期）： 

  月：{{Month_Name}} 

年份

  期間鍵:{{Period_Key}} 

  月末週期鍵：{{EOM_Key}}

• • 在範本參數區
    • 按一下年份之後
    • 然後展開觸發器➡ 運行時間輸入，並選擇年份

步驟 5：變數部分

• 按一下變數區中的新增按鈕，新增三個變數
  • 對於第一個變數
    • 指定第一個變數名稱為Month_Name
      • 在值欄位中按一下
        • 在變數窗格中，展開觸發器 ➡ 運行時輸入 ，然後選擇月
      • 按一下 Value 欄位中Month 變數的氣泡
        • 按一下 Select transformation 下拉選項
          • 選擇將文字解析為 JSON ，然後按一下加號 (+) 符號
        • 再次按一下Select transformation 下拉選項
          • 選擇從 JSON 取得值 ，然後按一下加號 (+) 符號
            • 在「從 JSON 取得值」行中，從「輸出」下拉選項中選擇T
            • 在同一行從 JSON 取得值中，在 Value 欄位中輸入顯示 ，然後按 Enter 鍵
            • 按一下「接受」(Accept)。

• 對於第二個變數：
  • 指定變量名稱為Period_Key
    • 在值 欄位中按一下
      • 在變數窗格中，展開渲染文字範本 - 建立週期鍵
        • 選取渲染文字
    • 在 Value 欄位中按一下Rendered Text 變數的氣泡。
      • 按一下Select transformation 下拉選項，然後選取Parse Date / Time ，然後按一下加號 (+) 按鈕
      • 在第一個下拉式方塊中，輸入%Y-%m-%d ，確定後按 Enter
      • 在 Output date format（輸出日期格式）欄位中，輸入%m/%d/%Y
      • 在輸入日期時區下拉選項中，輸入UTC，然後選擇 (UTC) 都柏林、愛丁堡、里斯本、倫敦 時區
      • 重複輸出日期時區欄位的 UTC 選擇
      • 按一下「接受」(Accept)。

• 對於第三個變數：
  • 指定變量名稱為EOM_Key
    • 按一下 Value 欄位。在變數窗格中，展開渲染文字範本 - 建立週期鍵 ，並選擇渲染文字
    • 按一下渲染的文字 變數，該變數被指定為值
      • 按一下Select transformation 下拉選項，然後選擇Add / Subtract Date and Time ，然後按一下加號 (+) 符號
        • 在「格式」下拉方塊中，輸入%Y-%m-%d ，並確定按 Enter。
        • 在操作下拉選項中，選擇添加
        • 在金額欄位中，輸入1
        • 在單位下拉選項中，選擇月
      • 新增添加 / 減去日期 和時間變換
        • 在 Format（格式）下拉方塊中，輸入%Y-%m-%d ，並確定按 Enter。
        • 在操作下拉選項中，選擇減去
        • 在金額欄位中，輸入1
        • 在單位下拉選項中，選擇日
      • 輸出日期時區欄位
      • 按一下「接受」(Accept)。
• 儲存指令

步驟 6：測試連結

現在 Chain 已經完成，我們可以測試結果。

• 發佈 鏈
• 按一下Execute ，然後選擇Run With Inputs。
• 從Month 下拉選項中，選擇February 。在年份輸入中，輸入2024。
• 按一下開始 。在渲染文本模板 - 创建周期密钥 命令的日志 选项卡上查看链的结果。
  • 驗證月底週期 金鑰，即闰年

• 使用二月再次執行 Chain，但輸入2025 作為本次執行的年份。
  • 確認月份在正確的日期結束，即不是闰年

要瞭解更多關於使用 Chains 進行資料轉換的資訊，請查看Connected Learning Paths - Transformation Introduction ！