使用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範本:

  1. 按一下Adobe Workfront右上角的​ 主功能表 ​圖示 主功能表 ,或(如果有的話)按一下左上角的​ 主功能表 ​圖示 主功能表 ,然後按一下​ 設定 設定圖示

  2. 按一下​ 系統 > 匯入資料(Kick-Starts)

  3. 選取您要包含的資訊型別。

    您選取的每個選項代表匯出試算表中多個索引標籤的集合。 例如,如果您選取​ 報表 ​選項,則建立報表所需的所有物件都會包含在試算表中(檢視、篩選器、群組、報表)。

    您可以使用下列所有物件型別,將資料匯入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檔案

    檢視

    偏好設定

  4. 按一下​ 下載

  5. 繼續進行將您的資料填入試算表範本中,將您的資訊填入空白的範本試算表中。

將您的資料填入試算表範本中 populate-the-spreadsheet-template-with-your-data

試算表中索引標籤(資料表)的概觀

TIP
若要更清楚瞭解當您填入Kick-Start範本時如何需要格式化每個欄中的資訊,請考慮執行一個練習,使用您嘗試匯入物件上的現有Workfront資料匯出Kick-Start。 如需指示,請參閱透過Kick-Starts從Adobe Workfront匯出資料

當您開啟空白的Kick-Start範本時,會有許多標籤(資料表)可供使用。 它們取決於您選取要下載的物件。 每一個都代表應用程式中的物件,例如專案、任務、小時、控制面板和使用者:

當您開啟其中一個標籤時,第2列會顯示每個物件在匯入期間可設定的欄位。 在欄標題中,在「set」一詞之後,欄位名稱會依其在資料庫中的顯示方式顯示。 這些欄位可作為欄標題。

IMPORTANT
若要避免錯誤,請確定下列事項:
  • 請勿刪除Kick-Start試算表的空白第一列。
  • 請勿以任何方式刪除、修改或重新排列這些欄位(欄標題)。 例如,請勿變更其順序或名稱。
  • 將值新增至欄標題中以粗體顯示的每個欄位。 這些代表必填欄位。
但是,如果必要欄位包含系統偏好設定中設定的預設值,則不需要填入該欄位。
例如,在​ PROJ專案 ​索引標籤上,setCondition ​和​ setConditionType ​欄位可以保留空白,但​ setGroupID ​和​ setName ​欄不能保留空白。
  • 系統會自動產生某些欄位,包括​ setResourceRevenue ​和​ setEnteredByID。 如果您在試算表中輸入這些欄位的資料,當您上傳試算表時,kick-start程式會覆寫資料。

匯入記錄 import-a-record

工作表的每一列都對應一個唯一物件。

  1. 在​ isNew ​欄中新增資訊:

    • 如果您要匯入的物件是新的,請輸入​ TRUE ​以匯入資料列中的資料。 此值區分大小寫,且必須一律使用大寫字母

    • 如果物件已在Workfront中,請在​ isNew ​欄中輸入​ FALSE ​以忽略該列。 此值區分大小寫,且必須一律使用大寫字母

      • Workfront中已存在的記錄不會更新。
      • 如果您從Workfront下載含有資料的範本,則現有物件已標示​ FALSE
      • 如果您下載了空白範本,則不需要為現有物件新增列。
  2. 以下列其中一種方式在​ 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

    • 匯入專案時,您必須指定群組ID。

      • 如果群組已存在於Workfront中,您必須將其唯一識別碼新增至專案的​ setGroupID ​欄位。
      • 如果Workfront中不存在群組,您可以將​ 群組群組 ​工作表新增至匯入檔案,將「群組」工作表上的​ isNew ​欄位設定為​ TRUE,並在​ ID ​欄位中指出新群組的數值ID。 新專案的​ setGroupID ​欄位必須與新群組的數值​ ID ​相符。

      範例: ​針對專案,setGroupID ​資料行中顯示的值必須是下列其中一項:

      • Workfront例項中現有群組的GUID
      • 群組群組 ​工作表上ID資料欄中的值(數字) (如果您在匯入期間建立新群組)
  3. 必要欄位的輸入值,以及您要在匯入期間填入的任何其他欄位。

  4. (選用)若要新增自訂資料:

    • 為您要納入匯入程式的每個自訂欄位建立新欄。

    • 為對應自訂欄位命名每個新欄位,如下所示: DE:[自訂欄位在Workfront中出現的名稱]。 例如,您可以建立下列自訂欄位:"DE: Departments"。

    • 在​ setCategoryID ​欄中,輸入此自訂欄位所在的現有自訂表單的GUID。 匯入自訂資料時,此欄位是必填欄位。

    • 如果您需要在自訂欄位中新增多個資料值(例如單選按鈕、核取方塊或清單),請使用「偏好設定」標籤中列出的垂直列自訂資料分隔符號「|」來分隔值。

      範例: ​在DE:Departments欄下輸入A|D以填入自訂表單中的部門A和部門D。

包含日期 include-dates

Workfront可以處理大部分的日期格式。 不過,您必須確保試算表中的日期欄會格式化為日期。 如果欄的格式是一般、數字或文字,匯入將會失敗。

TIP
最受歡迎的格式為YYYY/MM/DD格式。
例如:07/10/2023。

Workfront也接受時間值做為日期的一部分。

例如:07/10/2022 01:30或07/10/2022 1:00 PM。

如果您在日期中省略時間,Workfront會執行下列任一項作業:

  • 假設時間是凌晨12:00。 為了檢視您預期的日期結果,系統時區必須與您的時區相符。
  • 如果它位在與排程相關聯的物件上,則時間會遞延至排程允許的最早時間。
NOTE
使用UNIX時間戳記時,必須在值的末尾加上三個額外的零。
例如,如果您的時間戳記是7336899000的,您會在儲存格中輸入7336899000000。

使用萬用字元 use-wildcards

填入Kick-Start範本試算表時,您可以使用下列萬用字元:

萬用字元
行為
$$今天

setDate 欄位上使用時,此萬用字元會將日期設定為您匯入Kick-Start當天的午夜。

您可以使用篩選器上允許搭配萬用字元的標準語法,來修改萬用字元。

範例: 若您想要專案在匯入當週的星期一開始,無論您實際執行匯入的日期為何,都可以使用 $$TODAYbw。 這會將您的專案計劃開始日期設定為星期日凌晨12:00。 由於專案排程此時可能不允許工作,因此將於星期一上午9:00開始。

$$NOW

setDate 欄位上使用時,此萬用字元會根據您在Kick-Start匯入期間建立記錄的時刻設定日期。

您可以使用篩選器上允許搭配萬用字元的標準語法,來修改萬用字元。

範例: 如果您希望專案在匯入後3小時開始,可以使用 $$NOW+3h

$$USER.ID
setAssignedToID 或其他以使用者ID為基礎的欄位上使用時,此萬用字元會指派工作或以其他方式將記錄與執行匯入的個人建立關聯。
$$客戶

這是特別為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。

      使用者的角色ID

將試算表資料匯入Workfront

將資料填入Excel範本中後,您就可以將其資料上傳至Workfront。

Kick-Start匯入支援下列檔案型別:

  • Excel (.xls或.xlsx)

  • 壓縮的(.ZIP)檔案(僅包含.xlsx或.xls檔案)

    note note
    NOTE
    匯入參照下列物件的Excel試算表時,您必須使用.ZIP檔案:
    • 報告
    • 文件
    • 頭像
    • 檢視、篩選或分組屬性檔案
    使用壓縮的匯入檔案時,.ZIP檔案的名稱必須與.xlsx或.xls檔案相同,而且所有檔案都必須處於相同的結構層級(沒有資料夾)。

若要將範本試算表資料匯入Workfront:

  1. 按一下Adobe Workfront右上角的​ 主功能表 ​圖示 主功能表 ,或(如果有的話)按一下左上角的​ 主功能表 ​圖示 主功能表 ,然後按一下​ 設定 設定圖示

  2. 按一下​ 系統 > 匯入資料(Kick-Starts)

  3. 在​ 使用Kick-Start試算表上傳資料 ​區段中,按一下​ 選擇檔案,然後瀏覽並選取填入的試算表。

  4. 按一下​ 上傳。

    如果Excel檔案上傳至Workfront需要5分鐘以上的時間,應用程式會逾時,且Workfront無法上傳檔案。

    嘗試以較小的物件批次匯入資料。

  5. (視條件而定)如果您正在使用Workfront Fusion,現在可以開啟FLO或情境。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43