Bagikan melalui

Referensi ImportConfig

  • Artikel

File ImportConfig.xml yang digunakan dengan package deployer 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 rincian tentang elemen XML yang valid dan atribut untuk dokumen ini.

configdatastorage Elemen

configdatastorage adalah elemen root.

Atribut ConfigDataStorage

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 Jika true, dan jika installsampledata juga diatur ke true, tunggu data sampel diinstal sebelum menyebarkan paket. Jangan atur ini ke true kapan installsampledatafalse.
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 for 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 for Dynamics 365.
crmmigdataimportfile Nama file file data konfigurasi default (.zip) diekspor menggunakan Configuration Migration tool.

Elemen ConfigDataStorage

Ini adalah elemen turunan yang valid:

Elemen Deskripsi
solutions Berisi 0 atau banyak configsolutionfile elemen yang menjelaskan solusi untuk mengimpor.
filestoimport Berisi
- 1 atau banyak configimportfile elemen
- 0 atau banyak zipimportdetails elemen yang menggambarkan file individual dan file zip yang akan diimpor.
filesmapstoimport Berisi 1 atau banyak configimportmapfile elemen. Urutan file peta dalam elemen ini menunjukkan urutan pengimporannya. 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 mengimpor elemen configdatastorage.solutions .

Atribut file configsolution

Nama Description
solutionpackagefilename Diperlukan 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, kustomisasi tidak terkelola dalam solusi yang ada dipertahankan pada 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 configdatastorage.filestoimport akan diimpor dalam elemen.

Atribut ConfigImportFile

Nama Description
filename Nama file yang berisi data impor.
filetype Nilai ini bisa csv, xml, atau zip. Jika file adalah file .zip, zipimportdetails elemen harus ada dengan zipimportdetail elemen untuk setiap file dalam file .zip.
associatedmap Nama peta data impor Dataverse yang akan digunakan dengan file ini. Jika kosong, Dataverse mencoba menggunakan sistem yang ditentukan impor nama peta data 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 menjadi tim. Nilai yang valid adalah true atau false.
owneruser ID pengguna yang seharusnya 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 yang akan diimpor dalam configdatastorage.filestoimport elemen saat configimportfile.filetype is zip.

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 atau csvxml.
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.

Atribut ConfigImportMapFile

Nama Description
filename Nama file yang berisi data pemetaan.

cmtdatafile Elemen

Menentukan file data konfigurasi lokal bersama dengan ID lokal (diperlukan) 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>

Cmtdatafile atribut

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 dalam proyek Anda. File ini diperlukan untuk mengimpor informasi pengguna ke Dynamics 365 (on-premises) instans di domain yang berbeda.