共用方式為


如何匯入資料

使用 Power Apps 的匯入功能,將其他地方儲存的資料匯入您的模型導向應用程式。

每個資料表都有一定會存在於輸入檔案中的必要資料行。 您應該下載 Excel 範本,新增資料,然後將該檔案匯入您的應用程式。 範本可以節省時間和精力。 不要在範本中新增或修改資料行,以免在匯入期間發生問題。

在匯入檔案之前,請確定資料行標題與應用程式中的資料行名稱相符。 在匯入程式期間,系統會嘗試將輸入檔中的資料行名稱對應至應用程式中的資料行名稱。 如果名稱不符,則必須手動對應欄位,否則在匯入過程中可能會發生問題。

如果您是進階使用者並且知道特定 Dataverse 資料表所需的欄位,可以自行定義 Excel、CSV 或 XML 檔案,然後依照本文說明匯入資料至您的應用程式。 下列為支援的檔案格式:

  • Excel 活頁簿 (.xlsx)
  • 逗號分隔值 (.csv)
  • XML 試算表 2003 (.xml)

.zip 檔允許的檔案大小上限為 32 MB。 其他檔案格式允許的檔案大小上限為 8 MB。

下載 Excel 範本

為了避免對應問題,您應該使用 Excel 範本,您可以從應用程式下載該範本。 下載範本後新增您的資料,然後將檔案匯回您的應用程式。 切記不要在範本中新增或修改資料行,以免在匯入期間發生問題。

  1. 開啟您的應用程式,然後從左側導覽中選取資料表。

  2. 在指令列上,選取 Excel 範本>下載範本

  3. 選取要下載的資料表類型和檢視表,或選取編輯資料行,並選擇要加入範本的資料列。

  4. 選取下載

    如何從您的應用程式下載 Excel 範本。

匯入您的資料

使用您在先前步驟中下載的範本 (已使用資料修改),然後將文件匯入您的應用程式中。

  1. 開啟應用程式,然後從左側導覽中選取資料表。

    從網站地圖選取資料表。

  2. 在命令列上,選取要從中匯入的檔案類型:

    • 從 Excel 匯入:如果您使用 Excel 範本,選取從 Excel 匯入
    • 從 CSV 匯入
    • 從 XML 匯入

    顯示 Power Apps 中的三種匯入選項。

  3. 選取選擇檔案,並瀏覽至儲存檔案的資料夾。 選取該檔案並選取開啟,然後選取下一步

    小費

    您一次只能匯入一個檔案。 若要匯入更多檔案,請再次執行精靈。

  4. 選取是否允許重複資料。 如需詳細資訊,請參閱設定重複資料偵測規則以精簡您的資料

  5. 如果是 CSV 和 XML 文件 (如果要匯入 Excel 檔案,請跳過此步驟):

    • 如果是 CSV 檔案:選取下拉式清單,並選取 CSV 檔案所使用的資料分隔符號和欄位分隔符號。

    • 如果是 CSV 或 XML 檔案:如果您已定義其他索引鍵,請從其他索引鍵下拉式清單選取該索引鍵。 其他索引鍵可用來唯一識別和更新匯入期間的資料列。 詳細資訊:定義其他索引鍵以參照資料列

      選取其他索引鍵。

  6. 選取檢閱對應並驗證資料行 (欄位) 是否對應正確。 若所有項目都沒問題,請選取完成匯入

    匯入所選 Excel 檔案並檢查對應。

  7. 選取追蹤進度以查看匯入進度。

    追蹤匯入檔案的進度。

檢閱對應

匯入檔案時,請務必檢查資料行標題並確認其與您應用程式中的資料行 (欄位) 相符,這一點非常重要。

檢閱對應。

圖例:

  1. 主要欄位:顯示資料表中必須對應以成功匯入資料的所有必要欄位。 如果來源檔案的資料行標題符合資料行顯示名稱,這些資料行會自動對應。

  2. 已對應欄位:正確對應的欄位會顯示綠色勾選。

  3. 選擇性欄位:這些是來源檔案中的選擇性欄位標題。 如果資料行標題符合資料行顯示名稱,對應的下拉式清單中會自動選取這些資料行。

  4. 未匹配欄位:如果欄位標題不匹配,未對應的欄位會顯示紅色驚嘆號。 若要正確對應該資料行,請選取一個資料行以對應到檔案的未對應資料行標題。

  5. 忽略 (僅限選擇性欄位):從下拉式清單中選擇忽略。 忽略資料行中的資料不會匯入您的應用程式。

選項組

如果來源檔案中的任何包含固定的值集,您必須將該資料行對應至選項組類型的資料行。 這種類型的資料行有,或之類的值。

為此,選取[選項組] 按鈕。選項集欄位旁的按鈕,選擇值,然後選取確定

選項組值對應功能表。

選項值下拉式清單會結合輸入檔案中可用的值與已經存在您應用程式中的值。 例如:

  • 匯入檔案中的值:Low、High
  • 應用程式中已有的值:Cold、Warm、Hot
  • 結果目標值:Cold、Warm、Hot、Low、High

匯入之後,匯入精靈會在您的應用程式中新增所有對應的值,但會丟棄匯入檔案中不存在於您應用程式中的未對應值。 例如,您可以將來源值「低」對應至目標值「沒有興趣」,但是將來源值「高」對應至 (新) 目標值「高」。 根據這些對應,匯入精靈會在您的應用程式中建立「高」做為目標值。 它不會在您的應用程式中建立「低」做為目標值,因為您未將任何來源對應至此目標值。

Note

您可以將來源檔案中的欄位對應到「二選一選項」或「多選選項集」欄位。 在對多選選項集進行對應時,如果來源檔案包含應用程式中不存在的值,且匯入對應設定為 未對應,則可能會在 Dataverse 中建立新值。 如果對應設定為 忽略,則可以成功匯入記錄。 而且,對於「多選選項集」欄位,不會匯入值,也不會在目標環境中建立新值。

地圖查詢資料行

如果來源檔案中的部分資料參照到您應用程式中的其他現有資料列,您必須將來源檔案中的資料行對應至您應用程式中的查詢資料行。

例如,您可能想匯入名稱為 Leads.csv 的檔案,內含客戶資料行。 Leads.csv 中的客戶欄包含相關聯的客戶或連絡人資料。 若要對應這一項,請選取查閱資料行旁的查閱參照按鈕按鈕。 查閱參照區段隨即開啟,列出與目前資料表相關的資料表清單。

查詢參照區段。

對每個資料表,選取匯入期間要搜尋的資料行,以保留資料列之間的關係,然後選取確定

儲存對應設定

若要儲存對應設定供下次使用,請在為資料對應命名方塊中輸入名稱。 如此一來,下次匯入類似的資料集時,就可以再次使用相同的對應。

在此為資料對應命名。

開啟匯入記錄檔

啟動匯入後,您可以監控匯入作業的狀態,並在匯入記錄中查看結果。

在匯入精靈的最後一步中,選擇追蹤進度以查看匯入作業的進度。

匯入精靈中最後一個步驟的螢幕擷取畫面。

如果錯過了此步驟,請將以下程式碼追加到應用程式 URL: &newWindow=true&pagetype=entitylist&etn=importfile&viewid=a2927069-e4dc-4e8f-8fb1-d2f6c40c427e&viewType=1039

例如,如果您的應用程式 URL 是 https://org12345.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444,則用於查看匯入紀錄的 URL 就是 https://org12345.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&newWindow=true&pagetype=entitylist&etn=importfile&viewid=a2927069-e4dc-4e8f-8fb1-d2f6c40c427e&viewType=1039

檢視匯入狀態,並更正錯誤

完成匯入後,您可以查看哪些記錄匯入成功、匯入失敗,或只有部分匯入。

  1. 開啟匯入記錄

  2. 我的匯入頁面上,監視匯入進度。

    狀態欄顯示匯入的狀態。 狀態會經歷下列值:

    • 已提交
    • 解析中
    • 轉換中
    • 匯入中
    • 已完成

    Note

    對於包含自我參照查閱的資料表,在 匯入 階段期間會分兩個階段解析關係。 在第一個階段,會建立基本記錄。 在第二階段,自我參照會更新以確保資料完整性。

  3. 匯入完成後,成功失敗部分失敗欄會顯示成功匯入、無法匯入或部分匯入的記錄數目。

  4. 選取匯入工作,以檢視未匯入或部分匯入的記錄。 匯入記錄螢幕擷取畫面,包含**成功**、**失敗**與**部分失敗**欄位。

  5. 選取適當索引標籤查看匯入期間記錄失敗、成功或部分失敗的相關資訊。

  6. 失敗索引標籤上,將無法匯入的列匯出至新的檔案。 選取匯出錯誤列

  7. 更正此檔案中的錯誤,然後再將其匯入。

刪除匯入的記錄

如果要重新匯入資料或由於某種原因不再需要該資料,則可以刪除匯入檔案和匯入的記錄。

  1. 開啟匯入記錄

  2. 選取要刪除的匯入檔案,接著進行下列其中一個動作:

    • 刪除匯入來源檔案。 此選項會刪除匯入記錄檔及其詳細資料。

    • 刪除已匯入記錄。 此選項會刪除所有從選取的檔案匯入的記錄。

    • 全部刪除. 此選項會刪除匯入檔案以及從匯入檔案匯入的記錄。

限制

  • Excel 匯入不支援虛擬表格彈性表格
  • Excel 匯入會更新主資料表中的欄位,但會忽略相關資料表中的欄位。
  • Excel 匯入工作只有在檔案大小低於 1 MB 時才會平行執行。 大於 1 MB 的檔案會循序處理,以避免資源耗盡。

Note

若要啟用平行處理,請將每個檔案保持在 1 MB 以下。 對於 .zip 檔案,解壓縮的大小也必須低於 1 MB。 請注意,即使原始檔案看起來較小,具有特殊字元的檔案的計算大小也可能超過 1 MB。

請參閱

下載資料匯入範本