鏈模板旨在提供有關鏈環境中的鍊和鏈運行的全面資訊。它是監控日誌的寶貴補充，提供對鏈活動的額外見解。
- 庫存和追蹤： 它簡化了庫存流程，使用戶能夠快速識別未充分利用或需求量大的鏈。這有助於更好的資源分配和效率。
- 詳細報告：使用者可以產生詳細說明基本元資料（例如 ID、日期、名稱等）的報告，這對於文件記錄和分析非常重要。
- 清理過程：此範本對於識別和刪除測試鍊或使系統混亂的過時鏈非常有用，從而使維護變得更加容易。
- 多個鏈建構者的最佳化：在具有多個鏈開發人員的環境中，此範本提供了鏈使用情況的清晰視圖，促進協調和最佳化工作，以消除不必要的鏈。
總體而言，此範本增強了對監控鍊和鏈運行的控制，使用戶能夠就其管理和維護做出明智的決策。
介紹
鏈模板檢索執行它的工作空間內一個或多個鏈環境的鍊和鏈運行（執行）清單。在運行時，指定報告電子表格來選擇環境、鍊和鏈運行進行分析。
注意： 此範本僅適用於已部署工作區中存在的鏈環境。
模板收集 鏈 上的資料並將其載入到每個指定環境的鏈列表 Wdata 表中。為每個鏈收集的資訊包括：
- 鏈號
- 連鎖名稱
- 建立日期
- 更新日期
- 鏈結網址
- 工作區ID
- 工作區名稱
- 環境ID
- 環境名稱
此外，它還收集有關環境中 Chain Runs 的數據，並將其載入到 Chain Runs Wdata 表中。為每次 Chain Run 收集的資訊包括：
- 鏈號
- 工作區ID
- 環境ID
- 執行者
- 開始於
- 結束於
- 狀態
- 發射型
- 運行ID
一旦收集了所有鏈資料並將其載入到 Wdata 表中，範本就會繼續驗證自上次運行以來的天數中的 選擇清單是否缺少任何新環境。如果發現任何新環境，則選擇清單會相應更新。
範本的最後一步涉及執行 刷新連接 ，以使用範本收集的最新資訊更新連接的工作表。連接的工作表將使用「使用天數」查詢產生的輸出進行更新。
要求
部署鏈
鏈使用追蹤器模板位於 模板 螢幕的 Workiva Chains 部分。
找到它的方法如下：
- 在 Chain Builder 中，前往 Templates 選項卡
- 從頂部選單中選擇 Workiva Chains
- 右上角搜尋 【】 ChainUsageTracker 【】 ，開啟模板
-
找到範本後，點選 【新建鏈 】將其部署到您的工作區
- 按照下面配置模板部分中的步驟配置 模板
配置模板
- 下載檔案 Chain User Tracker.cb 並 將其匯入到您的工作空間
- 下載檔案 Chain Usage Tracker.tar.gz 並將其 匯入到您的工作空間中。此導入將建立必要的 鏈使用追蹤器 電子表格
- 文件成功導入後，找到並打開鏈使用追蹤器電子表格
- 在 參數 表中，根據需要將單元格 B1 中的 使用後天數 閾值更新為大於或等於 -1的值
注意： 值為-1將檢索所有數據
- 使用 進程追蹤 表來監控範本執行的狀態
- 若要讓範本能夠處理特定的 鏈環境，請在 環境 工作表下方新增一個或多個子工作表。刪除或重新命名鏈環境表佔位符表
- 確保每個子 Sheet 的命名 與對應的 鏈環境 完全相同，包括名稱
區分大小寫
- 從 使用天數 Wdata 查詢建立 傳入連接 並配置 Days_Since_Use 和 環境 參數
注意： DEV、Demo 和 SSC 是範例鏈環境名稱。這些環境可能與您的環境名稱不符。根據需要編輯自使用 查詢參數 以來的天數。範本使用 維護Wdata參數 來維護值
變數
| 變數類型 | 變數名 | 可變目的 |
| 鏈變數 | 鍊錶ID | Wdata表用於儲存有關Chain的數據 |
| 鏈變數 | 鏈運行表 ID | Wdata表用於儲存有關Chain Runs的數據 |
| 鏈變數 | 查詢參數名稱 | 使用天數查詢中配置的環境參數的名稱 |
| 鏈變數 | 狀態表名稱 | 報表電子表格中狀態表的名稱或 ID |
| 鏈變數 | 參數表名稱 | 報告電子表格中參數表的名稱或 ID |
注意： 請參閱 尋找 Workiva 檔案和項目的 ID 以取得查找 ID 的協助
運行時輸入
| 輸入類型 | 名稱 | 目的 |
| 文字域 | 報告電子表格 ID | 輸入報告電子表格的 ID |
注意： 請參閱 尋找 Workiva 檔案和項目的 ID 以取得查找 ID 的協助
運行模板
- 點選 執行 按鈕
- 點選 Run With Inputs 按鈕
- 在 鏈使用追蹤器電子表格 ID 中輸入報告電子表格 ID 運行時輸入欄位
- 點選 開始 按鈕
- 模板運行時，導航至鏈使用追蹤器電子表格並查看 流程追蹤 表以監控運行狀態
- 允許模板完成以查看環境子表中的數據
執行結果
以下是鏈使用追蹤器電子表格的輸出範例：
已完成的鏈條：
疑難排解
- 確保子鏈 更新狀態、 將資料載入到 Wdata和 維護 Wdata 參數 都已發布
- 驗證指定的 ID 是否正確。如需在 Workiva 中識別 ID 的協助，請參考 以尋找 Workiva 檔案和項目的 ID
- 驗證 Chain User Tracker.cb 和 Chain User Tracker.tar.gz 檔案是否已成功匯入。參考 匯入Wdata檔案 和 匯入Workiva檔案 幫助文章
- 驗證 使用後的天數 查詢是否具有鏈列表和鏈運行表的正確表 ID
- 驗證參數表中的 使用天數 值大於或等於 -1
- 驗證環境表存在於報表電子表格中，且鏈結環境子表的命名正確
- 如果您重新命名了環境工作表，請調整「使用天數查詢」以使用工作表的自訂名稱
- 如果您重新命名了狀態和/或參數表名稱並透過鏈結變數中的名稱來引用它們，請確保它們的自訂名稱已反映在鏈結變數的值中
- 如果您在使用天數查詢中重新命名了環境參數，請確保查詢參數鏈結變數已更新為使用參數的自訂名稱
- 驗證 Workiva Connector 具有在所選環境中執行命令所需的權限