Workiva 支援中心

平台 API 版本 2022-01-01 將會停用，取而代之的是版本 2026-01-01。為了解決這個問題，Workiva 連接器中的 「執行報告」 和 「列出使用者」 命令現在都新增了一個 API 版 本欄位。更新這些命令，使其遷移到 2026-01-01，以便鍊式反應能夠繼續在受支援的 API 上運行。 

附註

• 預設版本為 2022-01-01。
• 沒有值的步驟使用 2022-01-01。
• 您可以為每個 「執行報告」 和 「列出使用者」 命令實例選擇 2022 或 2026。
• 2022-01-01 版本將於 2027 年 11 月 30 日停止運作。在此日期之前，您需要將步驟調整到 2026 年。
• 其他 Workiva Connector 圖形指令將於 2026 年 11 月 30 日自動移至 2026-01-01，您無需變更它們。 
• 它們的 JSON 輸出可以按不同的順序列出欄位和項目。數值相同。

執行報告

維持不變的項目

• 輸入： 報 告 ID、 預覽內容。
• 輸出： 報告 CSV 檔案。
• 只有當文件準備就緒後，該步驟才會完成。

2026年1月1日有哪些變化

• 該步驟開始匯出報告，大約每秒檢查一次報告狀態，然後下載 CSV 檔案。
• 鍊式日誌將顯示“正在檢查操作狀態...”，狀態為 “已確認”、“ 已排隊”或“ 已啟動”，如果步驟正確完成，則顯示“操作已成功完成”。如果該步驟未正確完成，則會在日誌中記錄訊息「操作失敗」。
• 此步驟的運行時間可能比 2022-01-01 版本更長，因為連接器最多會檢查導出 300 次或最多 10 分鐘，以先到者為準。每秒檢查一次，大約需要 5 分鐘。如果匯出操作屆時尚未完成，則該步驟失敗。
• 提示： 如果鍊式步驟逾時時間短於匯出時間，請延長逾時時間，以便檔案可以到達。
• 錯誤的報告 ID 通常會導致「操作失敗」。
• 無需新的許可。OAuth2 授權仍然需要 graph:read。

切換到 2026 年

1. 開啟流程圖並選擇 「執行報告」 步驟。
2. 將 API 版本 設定為 2026。
3. 保存並運行該鏈。
4. 檢查 報告 輸出是否包含您預期的資料。

疑難排解

列出用戶

維持不變的項目

• 輸入： 組織 ID。
• 輸出： 使用者報告 JSON 檔案和 記錄計數。
• OAuth2授權使用者必須是組織管理員。

2026年1月1日有哪些變化

• 連線中使用的 OAuth2 授權需要具有 organization:read 範圍。
• 如果沒有該範圍，則該步驟將失敗，並傳回「未授權 (401)」或「禁止 (403)」HTML 錯誤，而不是傳回使用者清單。

切換到 2026-01-01

1. 組織安全管理員將 organization:read 新增至 API 授權中，該 API 授權的用戶端 ID 會保存在您的 Workiva 連線中：

   1. 在右上角，點擊使用者圖標，選擇 「管理員」，然後 選擇「組織管理員」。
   2. 在左側選單中，選擇 「安全性」，然後選擇 「設定」 標籤。
   3. 找到該授權文件，然後從 「操作」 功能表中開啟它。
   4. 在 “範圍”中，選擇 “組織：讀取” 並儲存。客戶端密鑰保持不變。

   注意： organization:read 是一個組織範圍。它不是從工作區設定中分配的。有關
   更多信息，請參閱 Workiva 支援頁面 “在組織管理中建立和管理 API 授權”。

2. 開啟流程圖並選擇 「列出使用者」 步驟。
3. 將 API 版本 設定為 2026。
4. 保存並運行該鏈。
5. （可選，但建議）記錄 記錄計 數值。 
   1. 將 API 版本 值改回 2022，然後再次執行該鏈。 
   2. 確認兩次運行的 記錄計 數值相同。

疑難排解

如果我什麼都不做呢？

使用這些命令的步驟將繼續使用 2022-01-01 直到 2027 年 10 月 31 日。此後，設定為 2022-01-01 的步驟將停止運作。

需要協助嗎？

聯絡 Workiva 技術支援。