Referensi ImportConfig

File ImportConfig.xml yang digunakan dengan penyebar paket berisi informasi tentang solusi dan data yang akan diimpor. Berikut ini adalah contohnya:

<?xml version="1.0" encoding="utf-16"?>
<configdatastorage 
   installsampledata="true"
   waitforsampledatatoinstall="true"
   agentdesktopzipfile=""
   agentdesktopexename=""
   crmmigdataimportfile="data_1033.zip">
   <solutions>
      <configsolutionfile 
         solutionpackagefilename="SampleSolutionOne_1_0_managed.zip"
         overwriteunmanagedcustomizations="false"
         publishworkflowsandactivateplugins="true" />
      <configsolutionfile 
         solutionpackagefilename="SampleSolutionTwo_1_0_managed.zip"
         overwriteunmanagedcustomizations="false"
         publishworkflowsandactivateplugins="true" />
      <configsolutionfile 
         solutionpackagefilename="SampleSolutionThree_1_0_managed.zip" />
   </solutions>
   <filestoimport>
      <configimportfile filename="SampleOption.csv"
         filetype="CSV"
         associatedmap="SampleOption"
         importtoentity="sample_option"
         datadelimiter=""
         fielddelimiter="comma"
         enableduplicatedetection="true"
         isfirstrowheader="true"
         isrecordownerateam="false"
         owneruser=""
         waitforimporttocomplete="false" />
      <configimportfile filename="File.zip"
         filetype="ZIP"
         associatedmap="FileMapName"
         importtoentity="FileEntity"
         datadelimiter=""
         fielddelimiter="comma"
         enableduplicatedetection="true"
         isfirstrowheader="true"
         isrecordownerateam="false"
         owneruser=""
         waitforimporttocomplete="true" />
      <zipimportdetails>
         <zipimportdetail filename="subfile1.csv"
            filetype="csv"
            importtoentity="account" />
         <zipimportdetail filename="subfile2.csv"
            filetype="csv"
            importtoentity="contact" />
      </zipimportdetails>
   </filestoimport>
   <filesmapstoimport>
      <configimportmapfile filename="SampleOption.xml" />
   </filesmapstoimport>
   <cmtdatafiles>
      <cmtdatafile filename="data_1033.zip"
         lcid="1033"
         usermapfilename="UserMap.xml" />
      <cmtdatafile filename="data_1041.zip"
         lcid="1041"
         usermapfilename="" />
   </cmtdatafiles>
</configdatastorage>

Bagian berikut memberikan detail tentang elemen dan atribut XML yang valid untuk dokumen ini.

configdatastorage Elemen

configdatastorage adalah elemen akar.

ConfigDataStorage Atribut

Semua atribut ini bersifat opsional.

Nama	Description
installsampledata	Apakah akan menginstal data sampel. Ini adalah data sampel yang sama yang diinstal menggunakan metode lain ini: - Menambahkan atau menghapus data sampel - Menambahkan dan menghapus data sampel dengan kode
waitforsampledatatoinstall	If true, dan if installsampledata juga diatur ke, true menunggu data sampel diinstal sebelum menyebarkan paket. Jangan atur ini ke true kapan installsampledata ada false.
agentdesktopzipfile	Nama file zip untuk dibuka paketnya. Jika Anda menentukan nama file .zip di sini, maka akan ditambahkan layar selama proses penyebaran paket yang meminta Anda untuk memilih lokasi yang akan Anda gunakan untuk membongkar isi file. Atribut ini biasanya digunakan untuk membuat paket untuk Unified Service Desk untuk Dynamics 365.
agentdesktopexename	Nama file .exe atau .msi di file zip atau URL yang akan dipanggil di akhir proses penyebaran. Atribut ini biasanya digunakan untuk membuat paket untuk Unified Service Desk untuk Dynamics 365.
crmmigdataimportfile	Nama file file data konfigurasi default (.zip) diekspor menggunakan Configuration Migration tool.

ConfigDataStorage

Ini adalah elemen turunan yang valid:

Elemen	Deskripsi
solutions	Berisi 0 atau banyak configsolutionfile elemen yang menjelaskan solusi untuk diimpor.
filestoimport	Berisi - 1 atau banyak configimportfile elemen - 0 atau banyak zipimportdetails elemen yang menjelaskan file individual dan file zip yang akan diimpor.
filesmapstoimport	Berisi 1 atau banyak configimportmapfile elemen. Urutan file peta dalam elemen ini menunjukkan urutan impornya. Pelajari lebih lanjut cara membuat peta data untuk diimpor
cmtdatafiles	Berisi 1 atau banyak cmtdatafile elemen yang berisi versi lokal dari file data konfigurasi yang akan diimpor.

configsolutionfile Elemen

Menjelaskan solusi untuk diimpor dalam configdatastorage.solutions elemen.

Configsolutionfile atribut

Nama	Description
solutionpackagefilename	Wajib Tentukan nama file .zip solusi Anda.
overwriteunmanagedcustomizations	Opsional Apakah akan menimpa penyesuaian yang tidak dikelola saat mengimpor solusi yang sudah ada di lingkungan target. Jika Anda tidak menentukan perilaku ini, penyesuaian yang tidak dikelola dalam solusi yang ada dipertahankan di lingkungan target.
publishworkflowsandactivateplugins	Opsional Apakah akan menerbitkan alur kerja dan mengaktifkan plug-in di lingkungan target setelah solusi diimpor. Jika Anda tidak menentukan perilaku ini, alur kerja diterbitkan dan plug-in diaktifkan.

configimportfile Elemen

Menjelaskan file yang akan diimpor dalam configdatastorage.filestoimport elemen.

Configimportfile atribut

Nama	Description
filename	Nama file yang berisi data impor.
filetype	Nilai ini bisa berupa, csvxml, atau zip. Jika file adalah file .zip, zipimportdetails elemen harus hadir dengan zipimportdetail elemen untuk setiap file dalam file .zip.
associatedmap	Nama peta data impor Dataverse yang akan digunakan dengan file ini. Jika kosong, Dataverse coba gunakan sistem yang ditentukan nama peta data impor untuk file ini.
importtoentity	Dapat berupa nama file exe di file zip atau URL atau file .msi untuk memberikan tautan yang akan dipanggil di akhir proses.
datadelimiter	Nama pembatas data yang digunakan dalam file impor. Nilai yang valid adalah tanda kutip tunggal atau tanda kutip ganda.
fielddelimiter	Nama pembatas bidang yang digunakan dalam file impor. Nilai yang valid adalah koma atau titik dua, atau tanda kutip tunggal.
enableduplicatedetection	Apakah akan mengaktifkan aturan deteksi duplikat pada impor data. Nilai yang valid adalah true atau false.
isfirstrowheader	Apakah baris pertama file impor berisi nama bidang. Nilai yang valid adalah true atau false.
isrecordownerateam	Apakah pemilik catatan impor harus sebuah tim. Nilai yang valid adalah true atau false.
owneruser	ID pengguna yang harus memiliki catatan. Nilai default adalah pengguna yang saat ini masuk.
waitforimporttocomplete	Jika true, sistem menunggu proses impor selesai sebelum melanjutkan. Jika false, pekerjaan diantre dan bergerak terus.

zipimportdetails Elemen

Menjelaskan file zip untuk diimpor dalam configdatastorage.filestoimport elemen saat adalah configimportfile.filetypezip.

Berisi 1 atau lebih zipimportdetail elemen yang memberikan informasi tentang file individual dalam file zip yang ditentukan dalam configimportfile elemen.

zipimportdetail Elemen

Berikan informasi tentang file individual dalam file zip yang ditentukan dalam configimportfile elemen.

Atribut ZipImportDetail

Nama	Description
filename	Nama file yang berisi data impor.
filetype	Nilai ini bisa berupa csv atau xml.
importtoentity	Dapat berupa nama file exe di file zip atau URL atau file .msi untuk memberikan tautan yang akan dipanggil di akhir proses.

configimportmapfile Elemen

Berisi informasi tentang file peta individual untuk diimpor Dataverse.

Configimportmapfile atribut

Nama	Description
filename	Nama file yang berisi data pemetaan.

cmtdatafile Elemen

Menentukan file data konfigurasi yang dilokalkan bersama dengan ID lokal (wajib) dan file peta informasi pengguna (opsional).

Contoh CMTDATAFILE

<cmtdatafiles>
   <cmtdatafile filename="data_1033.zip"
      lcid="1033"
      usermapfilename="UserMap.xml" />
   <cmtdatafile filename="data_1041.zip"
      lcid="1041"
      usermapfilename="" />
</cmtdatafiles>

Atribut CMTDATAFILE

Nama	Description
filename	Nama file yang berisi data pemetaan.
lcid	Representasi string dari pengidentifikasi kode bahasa LCID.
usermapfilename	Hanya untuk Dynamics 365 (on-premises) . Berisi file peta pengguna (.xml) yang dihasilkan menggunakan alat Migrasi Konfigurasi di project Anda. File ini diperlukan untuk mengimpor informasi pengguna ke Dynamics 365 (on-premises) instans di domain yang berbeda.