利用 Power Apps 的匯入功能,將儲存在其他地方的資料匯入你的模型驅動應用程式。
每個資料表都有一定會存在於輸入檔案中的必要資料行。 下載一個 Excel 範本,加入你的資料,然後將檔案匯入你的應用程式。 範本可以節省時間和精力。 不要在範本中新增或修改資料行,以免在匯入期間發生問題。
在匯入檔案前,請確保欄位標題與應用程式中的欄位名稱相符。 在匯入程式期間,系統會嘗試將輸入檔中的資料行名稱對應至應用程式中的資料行名稱。 如果欄位不匹配,你必須手動映射欄位,否則匯入過程中可能會遇到問題。
如果你是進階使用者,且知道某個 Dataverse 表格所需的欄位,請自行定義 Excel、CSV 或 XML 來源檔案。 接著依照本文的步驟,了解如何匯入資料至您的應用程式。 下列為支援的檔案格式:
- Excel 活頁簿 (.xlsx)
- 逗號分隔值 (.csv)
- XML 試算表 2003 (.xml)
.zip 檔允許的檔案大小上限為 32 MB。 其他檔案格式允許的檔案大小上限為 8 MB。
下載 Excel 範本
為了避免對應問題,您應該使用 Excel 範本,您可以從應用程式下載該範本。 下載範本後新增您的資料,然後將檔案匯回您的應用程式。 切記不要在範本中新增或修改資料行,以免在匯入期間發生問題。
開啟您的應用程式,然後從左側導覽中選取資料表。
在指令列上,選取 Excel 範本>下載範本。
選取要下載的資料表類型和檢視表,或選取編輯資料行,並選擇要加入範本的資料列。
選取下載。
匯入您的資料
使用您在先前步驟中下載的範本 (已使用資料修改),然後將文件匯入您的應用程式中。
開啟應用程式,然後從左側導覽中選取資料表。
在命令列上,選取要從中匯入的檔案類型:
- 從 Excel 匯入:如果您使用 Excel 範本,選取從 Excel 匯入。
- 從 CSV 匯入
- 從 XML 匯入
選取選擇檔案,並瀏覽至儲存檔案的資料夾。 選取該檔案並選取開啟,然後選取下一步。
小費
您一次只能匯入一個檔案。 若要匯入更多檔案,請再次執行精靈。
選取是否允許重複資料。 欲了解更多資訊,請參閱 設定重複偵測規則以保持資料乾淨。
如果是 CSV 和 XML 文件 (如果要匯入 Excel 檔案,請跳過此步驟):
如果是 CSV 檔案:選取下拉式清單,並選取 CSV 檔案所使用的資料分隔符號和欄位分隔符號。
如果是 CSV 或 XML 檔案:如果您已定義其他索引鍵,請從其他索引鍵下拉式清單選取該索引鍵。 其他索引鍵可用來唯一識別和更新匯入期間的資料列。 如需詳細資訊,請參閱定義其他索引鍵以參考資料列。
選取檢閱對應並驗證資料行 (欄位) 是否對應正確。 若所有項目都沒問題,請選取完成匯入。
選取追蹤進度以查看匯入進度。
檢閱對應
匯入檔案時,檢閱資料行標題並確認其與您應用程式中的資料行 (欄位) 相符。
圖例:
主要欄位:顯示此表格中所有必填欄位,您必須對應這些欄位,資料才能成功匯入。 如果來源檔案的資料行標題符合資料行顯示名稱,這些資料行會自動對應。
已對應欄位:正確對應的欄位會顯示綠色勾選。
選用欄位:這些欄標題是來源檔案中的選用標題。 如果資料行標題符合資料行顯示名稱,對應的下拉式清單中會自動選取這些資料行。
未匹配欄位:如果欄位標題不匹配,未對應的欄位會顯示紅色驚嘆號。 若要正確對應該資料行,請選取一個資料行以對應到檔案的未對應資料行標題。
忽略 (僅限選擇性欄位):從下拉式清單中選擇忽略。 忽略資料行中的資料不會匯入至您的應用程式。
選項組
如果來源檔案中的任何資料行包含固定值集,請將該資料行對應至選項組類型的資料行。 這種類型的資料行有是和否,或低和高之類的值。
為此,選取
選項集欄位旁的按鈕,選擇值,然後選取確定。
選項值下拉式清單會結合輸入檔案中可用的值與已經存在您應用程式中的值。 例如:
- 匯入檔案中的值:Low、High
- 應用程式中已有的值:Cold、Warm、Hot
- 結果目標值:Cold、Warm、Hot、Low、High
匯入之後,匯入精靈會在您的應用程式中新增所有對應的值,但會捨棄匯入檔案中尚不存在於應用程式中的未對應值。 例如,您可以將來源值「低」對應至目標值「沒有興趣」,但是將來源值「高」對應至 (新) 目標值「高」。 根據這些對應,匯入精靈會在您的應用程式中建立「高」做為目標值。 它不會在您的應用程式中建立「低」做為目標值,因為您未將任何來源對應至此目標值。
Note
您可以將來源檔案中的欄位對應到「二選一選項」或「多選選項集」欄位。 當對應到「多重選取選項集」時,如果來源檔案包含應用程式中無法使用的值,且匯入對應設定為 NotMapped,則可能會在 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。
檢視匯入狀態,並更正錯誤
匯入完成後,您可以查看成功匯入、未匯入或部分匯入的紀錄。
在 「我的匯入」中,監控匯入進度。
狀態欄顯示匯入的狀態。 狀態會經歷下列值:
- 已提交
- 解析中
- 轉換中
- 匯入中
- 已完成
Note
對於包含自我參照查閱的資料表,在 匯入 階段期間會分兩個階段解析關係。 在第一個階段,會建立基本記錄。 在第二階段,自我參照會更新以確保資料完整性。
匯入完成後,成功、失敗及部分失敗欄位會分別顯示成功匯入、匯入失敗或部分匯入的紀錄數量。
選取匯入工作,以檢視未匯入或部分匯入的記錄。
請選擇適當的分頁,查看匯入過程中紀錄的失敗、成功或部分失效資訊。
在失敗索引標籤上,將無法匯入的列匯出至新的檔案。 選取匯出錯誤列。
更正此檔案中的錯誤,然後再將其匯入。
刪除匯入的記錄
如果要重新匯入資料或由於某種原因不再需要該資料,則可以刪除匯入檔案和匯入的記錄。
選取要刪除的匯入檔案,接著進行下列其中一個動作:
刪除匯入來源檔案。 此選項會刪除匯入記錄檔及其詳細資料。
刪除已匯入記錄。 此選項會刪除所有從選取的檔案匯入的記錄。
全部刪除. 此選項會刪除匯入檔案以及從匯入檔案匯入的記錄。
限制
- Excel 匯入不支援虛擬表格或彈性表格
- Excel 匯入會更新主資料表中的欄位,但會忽略相關資料表中的欄位。
- Excel 匯入工作只有在檔案大小低於 1 MB 時才會平行執行。 大於 1 MB 的檔案會循序處理,以避免資源耗盡。
Note
若要啟用平行處理,請將每個檔案保持在 1 MB 以下。 對於 .zip 檔案,解壓縮的大小也必須低於 1 MB。 帶有特殊字元的檔案,即使原始檔案看起來較小,其計算後的大小仍可能超過 1 MB。