使用Kick-Start範本將資料匯入Workfront
Kick-Start是特別格式化的Excel活頁簿,可填入您要匯入Workfront的資料。 Adobe Workfront提供您可用來執行此動作的Kick-Start範本,如Kick-Start資料匯入工具中所述。
此程式分為3項主要工作:
- 首先,您將Kick-Start範本匯出為試算表檔案
- 接著,將您的資料填入試算表中
- 最後,將填入的試算表匯入Workfront
本文會以適當的順序概述其中的每個程式。
存取需求
您必須具有下列存取權才能執行本文中的步驟:
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
---|---|
Adobe Workfront計畫 | 任何 |
Adobe Workfront授權 |
新增:標準 或 目前:計畫 |
存取層級設定 | 系統管理員 |
如需有關此表格的詳細資訊,請參閱Workfront檔案中的存取需求。
限制
您可以使用Kick-Start範本,將大量物件匯入Workfront。 但是,請考量下列限制:
- 以這種方式匯入資料不會更新Workfront中已存在之記錄的資訊。
- 您只能匯入新記錄及其資訊。
- 一次匯入不超過2,000筆記錄,以確保匯入不會逾時
將Kick-Start範本匯出為試算表檔案
匯出Kick-Start範本時,您會收到空白的Excel試算表活頁簿。 將試算表下載到您的電腦後,您可以使用試算表來填入您的資訊,然後將其匯入Workfront。
匯出Kick-Start範本:
-
按一下Adobe Workfront右上角的 主功能表 圖示 ,或(如果有的話)按一下左上角的 主功能表 圖示 ,然後按一下 設定 。
-
按一下 系統 > 匯入資料(Kick-Starts)。
-
選取您要包含的資訊型別。
您選取的每個選項代表匯出試算表中多個索引標籤的集合。 例如,如果您選取 報表 選項,則建立報表所需的所有物件都會包含在試算表中(檢視、篩選器、群組、報表)。
您可以使用下列所有物件型別,將資料匯入Workfront。 (唯一的例外是「存取層級」選項。 匯出中的「存取層級」資料表僅供參考之用,可讓您依ID將存取層級指派給新的使用者帳戶。)
每個物件型別的範本都可以以下列檔案格式匯出,並包含下列頁面:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3 19-row-3 20-row-3 21-row-3 22-row-3 23-row-3 24-row-3 25-row-3 26-row-3 27-row-3 28-row-3 29-row-3 30-row-3 31-row-3 32-row-3 33-row-3 34-row-3 layout-auto 物件 匯出為 匯出的試算表中有 張工作表 儀表板
系統中的所有儀表板都可以匯出。 您在一次匯出中最多可以選取100個特定儀表板。
匯出為ZIP檔案 參數
描述文字
參數選項
參數群組
類別參數
類別
報告
入口網站頁籤區段
儀表板
偏好設定
報告
系統中的所有報表都可以匯出。 您在一次匯出中最多可以選取100個特定報告。
Kick-Starts不支援文字模式篩選器或群組。 若要成功匯出,報表篩選器和群組必須切換至「標準模式」。
匯出為ZIP檔案 參數
描述文字
參數選項
參數群組
類別參數
類別
報告
偏好設定
核准 匯出為Excel檔案 階段核准者
核准階段
核准
核准流程
偏好設定
自訂資料 匯出為Excel檔案 參數
描述文字
參數選項
參數群組
類別參數
類別
偏好設定
費用類型 匯出為Excel檔案 費用類型
偏好設定
時數類型 匯出為Excel檔案 時數類型
偏好設定
團隊 匯出為Excel檔案 小組成員
團隊
偏好設定
使用者 匯出為Excel檔案。 若要檢視完整的選項清單,請按一下 其他選項。 使用者
偏好設定
存取層級 匯出為Excel檔案 存取層級
偏好設定
指派 匯出為Excel檔案 指派
偏好設定
公司 匯出為Excel檔案 公司
偏好設定
電子郵件範本 匯出為Excel檔案 電子郵件範本
偏好設定
費用 匯出為Excel檔案 費用'
偏好設定
外部頁面 匯出為Excel檔案 外部頁面
偏好設定
篩選器 匯出為ZIP檔案 篩選器
偏好設定
群組 匯出為Excel檔案 群組
偏好設定
分組 匯出為ZIP檔案 分組
偏好設定
小時 匯出為Excel檔案 小時
偏好設定
問題 匯出為Excel檔案 問題
偏好設定
職務角色 匯出為Excel檔案 工作角色
偏好設定
里程碑路徑 匯出為Excel檔案 里程碑
里程碑路徑
偏好設定
備註 匯出為Excel檔案 備註
偏好設定
專案組合 匯出為Excel檔案 專案組合
偏好設定
專案 匯出為Excel檔案 佇列
專案
路由規則
佇列主題
偏好設定
資源估計 匯出為Excel檔案 資源估計
偏好設定
風險 匯出為Excel檔案 風險
偏好設定
風險類型 匯出為Excel檔案 風險類型
偏好設定
計分卡 匯出為Excel檔案 計分卡問題
計分卡選項
計分卡
偏好設定
任務 匯出為Excel檔案 任務
偏好設定
範本 匯出為Excel檔案 佇列
範本
路由規則
佇列主題
偏好設定
範本指派 匯出為Excel檔案 範本指派
偏好設定
範本任務 匯出為Excel檔案 範本任務
偏好設定
時程表 匯出為Excel檔案 時程表設定檔
時程表
偏好設定
檢視 匯出為ZIP檔案 檢視
偏好設定
-
按一下 下載。
-
繼續進行將您的資料填入試算表範本中,將您的資訊填入空白的範本試算表中。
將您的資料填入試算表範本中 populate-the-spreadsheet-template-with-your-data
試算表中索引標籤(資料表)的概觀
當您開啟空白的Kick-Start範本時,會有許多標籤(資料表)可供使用。 它們取決於您選取要下載的物件。 每一個都代表應用程式中的物件,例如專案、任務、小時、控制面板和使用者:
當您開啟其中一個標籤時,第2列會顯示每個物件在匯入期間可設定的欄位。 在欄標題中,在「set」一詞之後,欄位名稱會依其在資料庫中的顯示方式顯示。 這些欄位可作為欄標題。
- 請勿刪除Kick-Start試算表的空白第一列。
- 請勿以任何方式刪除、修改或重新排列這些欄位(欄標題)。 例如,請勿變更其順序或名稱。
- 將值新增至欄標題中以粗體顯示的每個欄位。 這些代表必填欄位。
- 系統會自動產生某些欄位,包括 setResourceRevenue 和 setEnteredByID。 如果您在試算表中輸入這些欄位的資料,當您上傳試算表時,kick-start程式會覆寫資料。
匯入記錄 import-a-record
工作表的每一列都對應一個唯一物件。
-
在 isNew 欄中新增資訊:
-
如果您要匯入的物件是新的,請輸入 TRUE 以匯入資料列中的資料。 此值區分大小寫,且必須一律使用大寫字母
-
如果物件已在Workfront中,請在 isNew 欄中輸入 FALSE 以忽略該列。 此值區分大小寫,且必須一律使用大寫字母
- Workfront中已存在的記錄不會更新。
- 如果您從Workfront下載含有資料的範本,則現有物件已標示 FALSE。
- 如果您下載了空白範本,則不需要為現有物件新增列。
-
-
以下列其中一種方式在 ID 欄中新增資訊:
-
如果您要匯入的物件是新的(而且您在 isNew 資料行中輸入 TRUE),請為ID輸入任何數字。 此數字在試算表中必須是唯一的。 例如,如果您匯入三個物件,您可以分別賦予它們ID 1、2、3。
-
如果物件已存在於Workfront中(且 FALSE 位於 isNew 欄),而您正在匯入現有物件的相關新資訊,則ID必須是Workfront中該物件的英數字元GUID。
note tip TIP 若要在Workfront中找出物件的唯一GUID,您可以為該物件建立報表,並將ID欄新增至報表。 該欄中每個物件的值是物件的GUID。 - Workfront中已存在的記錄不會更新。
- 如果您下載含有資料的範本,則現有物件已包含GUID作為ID。
- 您可以在 isNew 資料行中將 FALSE 變更為 TRUE、變更ID,並在匯入前進行必要的資料調整,以根據現有物件匯入新的物件。
-
匯入專案時,您必須指定群組ID。
- 如果群組已存在於Workfront中,您必須將其唯一識別碼新增至專案的 setGroupID 欄位。
- 如果Workfront中不存在群組,您可以將 群組群組 工作表新增至匯入檔案,將「群組」工作表上的 isNew 欄位設定為 TRUE,並在 ID 欄位中指出新群組的數值ID。 新專案的 setGroupID 欄位必須與新群組的數值 ID 相符。
範例: 針對專案,setGroupID 資料行中顯示的值必須是下列其中一項:
- Workfront例項中現有群組的GUID
- 群組群組 工作表上ID資料欄中的值(數字) (如果您在匯入期間建立新群組)
-
-
必要欄位的輸入值,以及您要在匯入期間填入的任何其他欄位。
-
(選用)若要新增自訂資料:
-
為您要納入匯入程式的每個自訂欄位建立新欄。
-
為對應自訂欄位命名每個新欄位,如下所示: DE:[自訂欄位在Workfront中出現的名稱]。 例如,您可以建立下列自訂欄位:"DE: Departments"。
-
在 setCategoryID 欄中,輸入此自訂欄位所在的現有自訂表單的GUID。 匯入自訂資料時,此欄位是必填欄位。
-
如果您需要在自訂欄位中新增多個資料值(例如單選按鈕、核取方塊或清單),請使用「偏好設定」標籤中列出的垂直列自訂資料分隔符號「|」來分隔值。
範例: 在DE:Departments欄下輸入A|D以填入自訂表單中的部門A和部門D。
-
包含日期 include-dates
Workfront可以處理大部分的日期格式。 不過,您必須確保試算表中的日期欄會格式化為日期。 如果欄的格式是一般、數字或文字,匯入將會失敗。
Workfront也接受時間值做為日期的一部分。
例如:07/10/2022 01:30或07/10/2022 1:00 PM。
如果您在日期中省略時間,Workfront會執行下列任一項作業:
- 假設時間是凌晨12:00。 為了檢視您預期的日期結果,系統時區必須與您的時區相符。
- 如果它位在與排程相關聯的物件上,則時間會遞延至排程允許的最早時間。
使用萬用字元 use-wildcards
填入Kick-Start範本試算表時,您可以使用下列萬用字元:
在 setDate 欄位上使用時,此萬用字元會將日期設定為您匯入Kick-Start當天的午夜。
您可以使用篩選器上允許搭配萬用字元的標準語法,來修改萬用字元。
範例: 若您想要專案在匯入當週的星期一開始,無論您實際執行匯入的日期為何,都可以使用 $$TODAYbw。 這會將您的專案計劃開始日期設定為星期日凌晨12:00。 由於專案排程此時可能不允許工作,因此將於星期一上午9:00開始。
在 setDate 欄位上使用時,此萬用字元會根據您在Kick-Start匯入期間建立記錄的時刻設定日期。
您可以使用篩選器上允許搭配萬用字元的標準語法,來修改萬用字元。
範例: 如果您希望專案在匯入後3小時開始,可以使用 $$NOW+3h。
這是特別為Kick-Start使用者匯入新增的萬用字元。 建立Workfront帳戶時,會建立具有系統管理員存取層級的使用者。 在帳戶中建立其他使用者時,指派給預設管理員的使用者名稱可以當做前置詞。
由於使用者名稱在所有客戶中必須是唯一的,因此如果您有多個個人使用非常常見的使用者名稱,例如John Smith,他可能會有一個使用者名稱「jsmith」,這個選項會很有用。 在使用者名稱指派前面加上預設的管理員使用者名稱,即可保證每個使用者名稱都是唯一的(例如: $$CUSTOMER.jsmith)。
提示:若要確保使用者名稱在整個系統內是唯一的,更輕鬆的方式是在 setUsername 欄位中輸入個人的電子郵件地址。
ID的屬性名稱替代 attribute-name-substitution-for-ids
雖然最佳做法是儘可能使用ID,但有時在設定 setAttributeID 值時,不方便將ID從一個工作表交叉參照到另一個工作表。 只要變更欄標題,您就可以依名稱參考值。
範例:
-
專案匯入
匯入專案時,請移至 群組群組 工作表,記下個別群組識別碼,並將它們貼到 專案專案 工作表的正確儲存格(setGroupID 欄)中,以設定專案的 setGroupID。
這在僅處理幾個群組和專案時是可行的,但如果您處理每個群組和專案,則不太現實。
若要對上述範例進行屬性名稱替代,請將 setGroupID 欄標題變更為 #setGroupID群組名稱。 然後,您可以依名稱參照每個專案的群組。
note note NOTE 使用「屬性名稱替代」的選項僅限於現有記錄的參照。 您無法在相同匯入中建立的物件使用名稱替代。 -
使用者匯入
匯入使用者時,從 ROLE Role 索引標籤上的角色清單中填入 setRoleID。
有些角色ID是用於帳戶中已存在的記錄,而其他角色ID則在匯入期間建立。
對於指派給現有角色的新使用者記錄,您可以使用名稱替代。 對於指派給新匯入角色的新使用者記錄,您無法。
以下說明如何在相同的匯入檔案中使用這兩種方法:
-
在試算表中新增一欄至 setRoleID 欄的左側。
-
為新資料行 命名#setRoleID角色名稱。
-
若要將角色指派給現有記錄,請在 #setRoleID ROLE name 欄位中輸入角色名稱。
對於新角色記錄的角色指派,請在setRoleID中輸入您在ROLE Role工作表中指派的ID。
-
將試算表資料匯入Workfront
將資料填入Excel範本中後,您就可以將其資料上傳至Workfront。
Kick-Start匯入支援下列檔案型別:
-
Excel (.xls或.xlsx)
-
壓縮的(.ZIP)檔案(僅包含.xlsx或.xls檔案)
note note NOTE 匯入參照下列物件的Excel試算表時,您必須使用.ZIP檔案: - 報告
- 文件
- 頭像
- 檢視、篩選或分組屬性檔案
使用壓縮的匯入檔案時,.ZIP檔案的名稱必須與.xlsx或.xls檔案相同,而且所有檔案都必須處於相同的結構層級(沒有資料夾)。
若要將範本試算表資料匯入Workfront:
-
按一下Adobe Workfront右上角的 主功能表 圖示 ,或(如果有的話)按一下左上角的 主功能表 圖示 ,然後按一下 設定 。
-
按一下 系統 > 匯入資料(Kick-Starts)。
-
在 使用Kick-Start試算表上傳資料 區段中,按一下 選擇檔案,然後瀏覽並選取填入的試算表。
-
按一下 上傳。
如果Excel檔案上傳至Workfront需要5分鐘以上的時間,應用程式會逾時,且Workfront無法上傳檔案。
嘗試以較小的物件批次匯入資料。
-
(視條件而定)如果您正在使用Workfront Fusion,現在可以開啟FLO或情境。