データをインポートし、重複レコードの識別方法を制御する

顧客データと売上データをアプリにすばやくインポートします。ほとんどのレコードの種類にデータをインポートできます。

Dynamics 365 では、バックグラウンドでインポートが処理されます。インポートが完了したら、正常にインポートされたレコード、インポートに失敗したレコード、または部分的にインポートされたレコードを確認できます。インポートに失敗したレコードを修正するには、それらを別のファイルにエクスポートして修正してから、もう一度インポートします (必要に応じて、前のインポートに関連付けられているすべてのレコードを削除して、最初からやり直すことができます)。

サポートされているファイルの種類

次の種類のファイルからデータをインポートできます。

コンマ区切り値 (.csv) ファイル
Dynamics 365 によって提供される Excel テンプレート
詳細情報: Word または Excel ファイルへのデータのエクスポート

インポート用にファイルを準備する

ファイルが正常にインポートされることを確認するために役立つガイドラインを次に示します。

レコードの種類ごとにレコードを個別のファイルに配置します。
ファイルが次のいずれかの形式であることを確認します。
- .csv ファイル:.csv ファイル拡張子を持つデータファイル。通常、.csv ファイルは、フィールドとレコードで構成され、フィールドはコンマで区切られたテキストとして格納されます。
- Excel テンプレート
インポートファイルが .csv ファイルの場合は、正しく区切られたファイルであることを確認します。データ区切り記号として、二重引用符 (") または単一引用符 (') を使用できます。
ファイルの最初の行が列見出しの行であることを確認します。列見出し (各列のデータにラベルを付けるブックまたはファイルの最初の行で使用されるテキスト) がまだ存在しない場合は追加します。
注

.csv ファイルに次のものが含まれていないことを確認します。
- 最初の行 (ヘッダー行) の複数行。
- 最初の行の引用符。 Dynamics 365 では、データ区切り記号として引用符が使用されます。
- セミコロン (;)またはコンマ (,) で区切られたデータ。 Dynamics 365 では、フィールド区切り記号としてセミコロンとコンマが使用されます。
Important

データは、インポートプロセス中に自動的にマップできる場合、より迅速にインポートできます。列見出しを Dynamics 365 のフィールドの表示名と一致させることができます。表示名は、属性がフォーム、リスト、またはレポートに表示されるときに既定で使用されるラベルです。各属性の 表示名 は、適切なセキュリティロールを持つユーザーが カスタマイズ 領域で変更できます。
すべての必須フィールドにデータが存在することを確認します。

レコードは、すべての必須フィールドがマップされている場合、および必須フィールドにマップされている各ソース列にデータが存在する場合にのみインポートされます。必須フィールドは、レコードを保存する前に必要な属性です。必要なフィールドを事前に決定するか、インポート中に不足している必要なマッピングを特定することができます。どちらの場合も、各レコードに必要なデータがあることを確認します。必要なフィールドを決定するには、新しいレコードを作成しているかのようにレコードの種類のフォームを開き、赤いアスタリスク (*) でマークされているフィールドを識別します。

次の一覧は、一般的にインポートされるレコードの種類の既定の必須フィールドを示しています。
- アカウント: アカウント名
- 連絡先: 姓
- 潜在顧客: トピック、姓、会社名
- 製品: 既定の単位、単位グループ、10 進数がサポートされています

たとえば、次の行は、潜在顧客を含む .csv フォーマットファイルのデータの外観を示しています。最初の行にはフィールド名が含まれており、残りの行はデータとしてインポートされます。

Company,Last Name,First Name,Topic,Email,Mobile Phone
"Designer Bikes""Groth""Brian""Mountain bikes""someone@example.com""555-555-0112"
"Major Sporting Goods""Bedecs""Anna""Components""555-555-0171"

注

既定では、インポートできるファイルの最大サイズは 8 MB です。

Excel テンプレートからレコードをインポートする

次のいずれかの操作を行って、インポートを開始します。
- インポートするエンティティのリストビュー (潜在顧客の一覧など) に移動し、コマンドバーの [Excel からインポート ] を選択します。
- 管理者の場合は、[>>> に移動します。 [ マイインポート ] ページで、ツールバーの [ データのインポート ] ボタンを選択します。
[ ファイルの選択] を選択 してファイルをアップロードします。
[次へ] を選択します。ソースファイル内のすべてのフィールドが自動的にマップされます。
[ インポートの完了] を選択します。

.csv ファイルからレコードをインポートする

「インポート用のファイルを準備する」の説明に従って、インポートファイルを準備します。
次のいずれかの操作を行って、インポートを開始します。
- インポートするエンティティのリストビュー (潜在顧客の一覧など) に移動し、コマンドバーの [CSV からインポート ] を選択します。
- 管理者の場合は、[>>> に移動します。 [ マイインポート ] ページで、ツールバーの [ データのインポート ] ボタンを選択します。
アップロードするファイルを選択します。
[次へ] を選択します。
代替キーが定義されている場合は、[ 代替キー ] ドロップダウンリストから選択します。

代替キーは、主キーを使用するのではなく、インポート時にレコードを一意に識別して更新するために使用されます。一部の外部データシステムでは、主キーが格納されません。このような場合は、代替キーを使用してレコードを一意に識別できます。詳細情報: インポート中の代替キーと重複検出のしくみ
[ データ区切り記号] ドロップダウンリストで、.csv ファイルで使用したデータ区切り記号を選択します。
[ マッピングの確認] を選択します。
[ マッピングの確認 ] ページで、列見出しが Dynamics 365 のフィールドにどのようにマップされているかを確認します。
- 左側の既定では、[マッピングの確認] ページの [プライマリフィールド] セクションには、データを正常にインポートするためにマップする必要があるエンティティに必要なすべてのフィールドが表示されます。
- 代替キーを選択した場合、代替キーのすべてのフィールドも必須フィールドになり、マップする必要があります。
- ソースファイルの列見出しがフィールドの表示名と一致する場合、これらのフィールドは自動的にマップされます。マップされたすべてのフィールドが緑色のチェックマークで表示されます。
- 列見出しが一致しない場合、マップされていないフィールドは赤い感嘆符で表示されます。ファイルのマップされていない列見出しにマップする Dynamics 365 フィールドを選択します。
- マップされていないフィールドだけを簡単にフィルター処理するには、[マップ属性] ドロップダウン リストから [マップ解除] を選択します。
[マッピングの確認] ページの [省略可能なフィールド] セクションの左側に、ソースファイルの列見出しが表示されます。列見出しがフィールドの表示名と一致する場合、対応するドロップダウンリストでフィールドが自動的に選択されます。
- 列見出しが一致しない場合、マップされていないフィールドは赤い感嘆符で表示されます。
- ファイルのマップされていない列見出しにマップする Dynamics 365 フィールドを選択します。
- 1 つ以上の省略可能なフィールドのドロップダウンリストから [無視 ] を選択することもできます。無視された列のデータは、Dynamics 365 Customer Insights - Journeys にインポートされません。
ソースファイル内の列に固定の値セットが含まれている場合は、その列を Option Set 型のフィールドにマップする必要があります。この型の列には、"Yes"、"No"、"Hot"、"Warm"、"Cold" などの値があります。これを行うには、[ ボタンをクリックします。 [ オプションセットマッピング ] セクションが開きます。
- [ ソースオプション値 ] 項目ごとに、[ Dynamics 365 オプション値 ] リストから項目をクリックしてマップし、[OK] をクリックします。
- Dynamics 365 オプション値ドロップダウンリストは、受信ファイルで使用できる値と、Dynamics 365 データベースに既にある値を結合します。例えば次が挙げられます。
  - インポートファイル内の値: 低、高
  - Dynamics 365 に既に含まれる値: コールド、ウォーム、ホット
  - 結果のターゲット値: コールド、ウォーム、ホット、低、高
- インポート後、インポートウィザードはマップされたすべての値を Dynamics 365 に追加しますが、Dynamics 365 にまだ含まれていないマップされていない値をインポートファイルから削除します。たとえば、"Low" ソース値を "Cold" ターゲット値にマップし、"High" ソース値を (新しい) "High" ターゲット値にマップできます。これらのマッピングに基づいて、インポートウィザードは Dynamics 365 ターゲット値として "High" を作成します。ソースをこのターゲット値にマップしていないため、Dynamics 365 ターゲット値として "Low" は作成されません。
  
  注
  
  ソースファイル内の列を、"2 つのオプション" と "複数選択オプションセット" (フィールドに複数の値を含めることができる) のフィールドにマップすることもできます。各 ソースオプション値 を Dynamics 365 オプション 値リストの項目にマップする必要があります。 "複数選択オプションセット" 型のフィールドにマッピングする場合、ソースファイルに Customer Insights - Journeys で使用できない値が含まれている場合、Customer Insights - Journeys に新しい値は作成されません。
ソースファイル内の一部のデータが Customer Insights - Journeys の他の既存のレコードを参照している場合は、ソースファイル内の列を Customer Insights - Journeys のルックアップフィールドにマップする必要があります。

たとえば、顧客レコードを含む Leads.csvという名前のファイルをインポートできます。 Leads.csv の [顧客 ] 列には、関連付けられているアカウントまたは連絡先データが含まれています。これをマップするには、[ ボタンをクリックします。 [ 参照参照] セクションが開き、現在のエンティティに関連するエンティティが一覧表示されます。

エンティティごとに、インポート時に検索するフィールドを選択してレコード間のリレーションシップを保持し、[ OK] を選択します。
次回のマッピング設定を保存するには、[ データマップに名前 を付ける] ボックスに名前を入力します。これにより、次に同様のデータセットをインポートする必要がある場合は、このマッピングをもう一度使用できるようになります。
続行する準備ができたら、[ インポートの完了 ] を選択し、マッピングを使用してそのデータをインポートします。

インポート中の代替キーと重複検出のしくみ

Customer Insights - Journeys でレコードをインポートするときに代替キーと重複検出がどのように機能するかについては、次の点に注意してください。

重複データの検出が無効で、Customer Insights - Journeys で代替キーが定義されていない場合
インポートプロセスによって新しいレコードが作成されます。一致する GUID が見つかった場合、インポートプロセスによってレコードが更新されます。
重複検出が無効で代替キーが選択されている場合
同じ代替キーデータを持つレコードが更新され、Customer Insights - Journeys で他のレコードが作成されます。
重複検出が無効で、代替キーが選択されていない場合
このシナリオでは、代替キーは Customer Insights - Journeys で使用できるため、主キーと見なされます。同じ代替キーを持つレコードは、インポート中にエラーメッセージで失敗します。
重複検出が有効になっていて、代替キーが定義されていない場合
重複検出ルールに従います。インポートプロセスによって新しいレコードが作成されます。一致する GUID が見つかった場合、インポートプロセスによってレコードが更新されます。重複検出ルールと一致するレコードがある場合は、エラーメッセージが表示されます。
重複検出が有効になっていて、代替キーが選択されていない場合 このシナリオでは、代替キーは Customer Insights - Journeys で使用できるため、主キーと見なされます。同じ代替キーを持つレコードは、インポート中にエラーメッセージで失敗します。重複検出ルールも適用されます。重複検出ルールと一致するレコードがある場合は、エラーメッセージが表示されます。重複検出ルールと一致しないレコードは、Customer Insights - Journeys に作成されます。
重複検出が有効になっていて、代替キーが選択されている場合
インポートプロセスでは、代替キーに基づいてレコードが更新され、重複検出が適用されます。代替キーが一致するとレコードが更新されます。それ以外の場合は、システムに作成されます。

インポートの結果を表示し、エラーを修正する

エラーを修復するには、インポートジョブが完了するまで待つ必要があります。

> > > > に移動します。最近のすべてのインポートのインポートジョブがここに一覧表示されます。
一覧でジョブを見つけて、進行状況を確認します。 [状態の理由] 列には、次の値を使用してインポートの状態が表示されます。
- 提出
- パージング
- 変換
- インポート
- 完了済み
インポートが完了すると、[ 成功]、[ 失敗]、[ 部分失敗 ] の列に、正常にインポートされたレコード、インポートに失敗したレコード、または部分的にインポートされたレコードの数が表示されます。
インポートファイルを開いて、インポートされなかったレコードまたは部分的にインポートされたレコードを表示します。インポートファイルレコードをダブルクリックします。
タブを使用して、インポート中のレコードの失敗、成功、または部分的な失敗に関する情報を表示します。
[ 失敗 ] タブで、[ エラー行のエクスポート ] を選択して、インポートできなかった行を新しい .csv ファイルにエクスポートします。このファイルのエラーを修正し、インポートすることができます。

インポートされたレコードを削除する

> > > > に移動します。最近のすべてのインポートのインポートジョブがここに一覧表示されます。
削除するインポートファイルを選択し、次のいずれかの操作を行います。
- インポートソースファイルの削除: インポートログファイルとその詳細を削除します。
- このインポート中にこのエンティティにインポートされたすべてのレコード: 選択したファイルからインポートされたすべてのレコードを削除します。
- .zip ファイルからインポートされたすべてのレコード: インポートファイルからインポートされたレコードと共にインポートファイルを削除します。

Last updated on 2025-08-23