データのインポート方法

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 つのインポート オプションを表示します。

  3. ［ファイルを選択］して、ファイルが保存されているフォルダーを参照します。 ファイルを選択し、開く を選択してから、次へ を選択します。

    チップ

    一度にインポートできるファイルは 1 つだけです。 さらにファイルを取り込むには、もう一度ウィザードを実行してください。

  4. 重複を許可するかどうかを選択します。 詳細については、「データをクリーンに保つために重複検出ルールを設定する」を参照してください。

  5. CSV および XML ファイルの場合 (Excel ファイルをインポートする場合は、この手順をスキップしてください):

    • CSV ファイルの場合: ドロップダウン リストを選択し、CSV ファイルに使用されるデータ区切り文字とフィールド区切り文字を選択します。

    • CSV および XML ファイルの場合: 代替キーを定義している場合は、代替キー ドロップダウン リストから選択してください。 代替キーは、インポート中に行を一意に識別して更新するために使用されます。 詳細については、行を参照するための代替キーの定義を参照してください。

      代替キーの選択

  6. マッピングの確認 を選択し、列 (フィールド)が正しくマップされていることを確認します。 すべて適切に見える場合は、インポートを完了 を選択します。

    選択した Excel ファイルをインポートしてマッピングを確認します。

  7. 進捗状況の追跡 を選択して、インポートの進行状況を確認します。

    インポートするファイルの進行状況を追跡します。

マッピングの確認

ファイルをインポートするときに、列見出しを確認し、それらがアプリの列 (フィールド) と一致することを確認します。

マッピングの確認

凡例:

  1. プライマリ フィールド: データを正常にインポートするためにマップする必要がある、テーブルの必須列がすべて表示されます。 ソースファイルの列見出しが列の表示名と一致する場合、これらの列は自動的にマッピングされます。

  2. マップ済みの列: 正しくマップされた列は、緑色のチェック マークで表示されます。

  3. 任意フィールド: これらの列見出しは、ソース ファイルでは任意です。 列見出しが列の表示名と一致する場合は、対応するドロップダウン リストでその列が自動的に選択されます。

  4. 一致しない列: 列見出しが一致しない場合、マップされていない列には赤い感嘆符が表示されます。 列を正しくマップするには、ファイルのマップされていない列見出しにマップする列を選択します。

  5. 無視 (オプション フィールドのみ): ドロップダウン リストから無視を選択します。 無視された列のデータはアプリにインポートされません。

オプション セット

ソース ファイル内の列に固定の値セットが含まれている場合は、その列を Option Set 型の列にマップします。 この種類の列には、はいやいいえ、または低、高などの値が含まれます。

これを行うには、オプション セット列の横にある オプション セット ボタン。 ボタンを選択し、値を選択してから、OK を選択します。

オプション セット値のマッピング メニュー

オプション値ドロップダウン リストでは、受信ファイルで利用可能な値が既にアプリにある値と結合されます。 たとえば:

  • インポート ファイルでの値: 低、高
  • 既にアプリにある値: 低温、中温、高温
  • 結果のターゲット値: 寒い、暖かい、暑い、低、高

インポート後、インポート ウィザードは、マップされたすべての値をアプリに追加しますが、アプリにまだ存在しない、マップされていない値はインポート ファイルから除外します。 たとえば、[低] ソース値を [寒い] ターゲット値にマップし、[高] ソース値を (新しい) [高] ターゲット値にマップすることができます。 これらのマッピングに基づいて、インポート ウィザードで、[高] がアプリでターゲット値として作成されます。 このターゲット値に対してはソースをマップしなかったので、[低] はアプリのターゲット値として作成されません。

注

ソース ファイル内の列を [2 つのオプション] 列または [複数選択オプション セット] 列にマップできます。 "複数選択オプション セット" にマッピングする場合、ソース ファイルにアプリで使用できない値が含まれており、インポート マッピングが NotMapped に設定されていると、Dataverse に新しいオプション値が作成される可能性があります。 マッピングが [無視] に設定されている場合は、レコードを正常にインポートできます。 [複数選択オプション セット] フィールドの場合、値はインポートされず、ターゲット環境に新しい値は作成されません。

マップ参照列

ソース ファイルに、アプリ内の他の既存の行を参照するデータが含まれている場合は、ソース ファイル内の列をアプリの参照列にマップします。

たとえば、顧客の行を含む Leads.csv という名前のファイルをインポートできます。 の Leads.csv 列には、関連付けられているアカウントまたは取引先責任者データが含まれています。 この列をマップするには、参照列の横にある[参照]ボタンを選択します。 検索リファレンス セクションが開き、現在のテーブルと関連するテーブルの一覧を表示します。

検索リファレンス セクション。

それぞれのテーブルに対し、行間の関係を保持するためにインポート時に検索する列を選択して、OKを選択します。

マッピング設定を保存

マッピング設定を保存するには、[データ マップに名前を付ける] ボックスに名前を入力します。 同様のデータ セットをインポートする場合は、同じマッピングを使用できます。

データ マッピングに名前を付けます。

インポート ログを開く

インポートを開始した後、インポート ジョブのステータスを監視し、インポート ログで結果を表示できます。

インポート ウィザードの最後の手順で、進行状況の追跡 を選択して、インポート ジョブの進行状況を表示します。

インポート ウィザードの最後のステップのスクリーンショット。

この手順を実行していない場合は、アプリの 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. My Imports で、インポートの進行状況を監視します。

    ステータス 列にはインポートのステータスが表示されます。 ステータスは次の値を順にとります。

    • 提出済み
    • 解析
    • 変換
    • インポート中
    • 完了

    注

    自己参照参照を含むテーブルの場合、 リレーションシップはインポート 段階で 2 つのフェーズで解決されます。 最初のフェーズでは、基本レコードが作成されます。 2 番目のフェーズでは、自己参照が更新され、データの整合性が確保されます。

  3. インポートが完了すると、[成功]、[失敗]、[部分的な失敗] 列には、正常にインポートされたレコード、インポートに失敗したレコード、または部分的にインポートされたレコードの数が表示されます。

  4. インポート ジョブを選択して、インポートされなかったレコードや部分的にインポートされたレコードを確認します。 **成功**、**失敗**、**部分的な失敗**列を含むインポート レコードのスクリーンショット。

  5. インポート中のレコードの失敗、成功、または部分的な失敗に関する情報を表示するには、適切なタブを選択します。

  6. Failures タブでは、インポートに失敗した行を新しいファイルに出力します。 エラー行のエクスポート を選択します。

  7. このファイルのエラーを修正してから、インポートしてください。

インポートしたレコードを削除

データを再インポートする場合、または何らかの理由でデータが必要ない場合は、インポート ファイルとインポートされたレコードを削除できます。

  1. インポート ログを開きます。

  2. 削除するインポートファイルを選択し、以下のいずれかの操作を行います:

    • インポート元ファイルを削除 このオプションはインポートログファイルとその詳細を削除します。

    • インポートされたレコードの削除。 このオプションは選択したファイルからインポートしたすべてのレコードを削除します。

    • すべて削除 このオプションは、インポートファイルからインポートしたレコードとインポートファイルを削除します。

制限事項

  • Excel インポートは、仮想テーブル または エラスティック テーブルではサポートされていません
  • Excel インポートはプライマリ テーブルのフィールドを更新しますが、関連テーブルのフィールドは無視されます。
  • Excel インポート ジョブは、ファイル サイズが 1 MB 未満の場合にのみ並列で実行されます。 1 MB を超えるファイルは、リソースの枯渇を回避するために順番に処理されます。

注

並列処理を有効にするには、各ファイルを 1 MB 未満にしてください。 .zip ファイルの場合、圧縮解除されたサイズも 1 MB 未満である必要があります。 特殊文字を含むファイルのサイズは、元のファイルのサイズが小さい場合でも 1 MB を超える場合があります。

関連項目

データ インポート用のテンプレートのダウンロード

  • 最終更新: