ImportConfig Başvurusu

Package Deployer ile kullanılan ImportConfig.xml dosyası, alınacak çözümler ve veriler hakkında bilgi içerir. Aşağıda bir örnek verilmiştir:

<?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>

Aşağıdaki bölümlerde bu belgenin geçerli XML öğeleri ve öznitelikleri hakkında ayrıntılar sağlanmaktadır.

configdatastorage öğesi

configdatastorage kök öğedir.

configdatastorage öznitelikleri

Bu özniteliklerin tümü isteğe bağlıdır.

Adı	Description
installsampledata	Örnek verileri yükleyip yüklememe. Bu, aşağıdaki diğer yöntemler kullanılarak yüklenen örnek verilerdir: - Örnek veriler ekleyin veya kaldırın - Kod ile örnek verileri ekleme ve kaldırma
waitforsampledatatoinstall	true ise ve installsampledata seçeneği de true olarak ayarlanırsa paketi dağıtmadan önce örnek verilerin yüklenmesini bekler. installsampledatafalse olduğunda bunu true olarak ayarlamayın.
agentdesktopzipfile	Paketten çıkarılacak zip dosyasının dosya adı. Burada bir .zip dosyası adı belirtirseniz paket dağıtım işlemi sırasında dosya içeriğinin paketini açmak istediğiniz konumu seçmenizi isteyen bir ekran ekler. Bu özellik genellikle Unified Service Desk for Dynamics 365 paketleri oluşturmak amacıyla kullanılır.
agentdesktopexename	Zip dosyasındaki .exe veya .msi dosyasının adı veya dağıtım işleminin sonunda çağrılacak URL. Bu özellik genellikle Unified Service Desk for Dynamics 365 paketleri oluşturmak amacıyla kullanılır.
crmmigdataimportfile	Configuration Migration toolnı kullanarak dışarı aktarılan varsayılan yapılandırma veri dosyasının (.zip) dosya adı.

configdatastorage öğeleri

Bunlar geçerli alt öğelerdir:

Öğe	Descriptions
solutions	Alınacak çözümleri açıklayan 0 veya daha fazla configsolutionfile öğe içerir.
filestoimport	Şunu içerir: -1 veya çok fazla configimportfile öğe - 0 veya alınacak zip dosyalarını açıklayan çok sayıda zipimportdetails öğe.
filesmapstoimport	1 veya daha fazla configimportmapfile öğe içerir. Bu öğedeki eşleme dosyalarının sırası, bunların içeri aktarıldığı sırayı belirtir. Alma için veri eşlemeleri oluşturma hakkında daha fazla bilgi edinin
cmtdatafiles	İçe aktarılacak yapılandırma veri dosyasının yerelleştirilmiş sürümünü içeren 1 veya daha fazla cmtdatafile öğe içerir.

configsolutionfile öğesi

configdatastorage.solutions öğesinde alınacak çözümleri açıklar.

configsolutionfile öznitelikleri

Adı	Description
solutionpackagefilename	Gerekli çözümünüzün .zip dosyasının adını belirtin.
overwriteunmanagedcustomizations	İsteğe bağlı Hedef ortamda zaten mevcut olan bir çözümü içe aktarırken yönetilmeyen özelleştirmelerin üzerine yazılıp yazılmayacağı. Bu davranışı belirtmezseniz, varolan çözümdeki yönetilmeyen özelleştirmeler hedef ortamda saklanır.
publishworkflowsandactivateplugins	İsteğe bağlı Çözüm içe aktarıldıktan sonra hedef ortamda iş akışlarının yayınlanıp yayınlanmayacağı ve eklentilerin etkinleştirilip etkinleştirilmeyeceği. Bu davranışı belirtmezseniz, iş akışı yayınlanır ve eklentiler etkinleştirilir.

configimportfile öğesi

configdatastorage.filestoimport öğesinde alınacak dosyaları açıklar.

configimportfile öznitelikleri

Adı	Description
filename	İçeri aktarma verilerini içeren dosyanın adı.
filetype	Bu değer csv, xml veya zip olabilir. Dosya bir .zip dosyasıysa, .zip dosyasındaki her dosya için bir zipimportdetails öğesi ile bir zipimportdetail öğesi bulunmalıdır.
associatedmap	Bu dosyayla kullanılacak Dataverse içeri aktarma veri eşlemesinin adı. Boşsa, Dataverse bu dosya için sistem tarafından belirlenen içeri aktarma veri eşlemesi adını kullanmaya çalışır.
importtoentity	İşlemin sonunda çağrılacak bir bağlantı sağlamak için zip dosyasındaki exe, URL veya .msi dosyasının adı olabilir.
datadelimiter	İçeri aktarma dosyasında kullanılan veri sınırlayıcının adı. Geçerli değerler tek tırnak veya çift tırnaktır.
fielddelimiter	İçeri aktarma dosyasında kullanılan alan sınırlayıcının adı. Geçerli değerler virgül, iki nokta üst üste veya tek tırnaktır.
enableduplicatedetection	Veri içeri aktarmada yinelenen öğe algılaması kurallarının etkinleştirilip etkinleştirilmeyeceği. Geçerli değerler true veya false şeklindedir.
isfirstrowheader	İçeri aktarma dosyasının ilk satırının alan adları içerip içermediği. Geçerli değerler true veya false şeklindedir.
isrecordownerateam	İçeri aktarma kaydı sahibinin takım olmasının gerekip gerekmediği. Geçerli değerler true veya false şeklindedir.
owneruser	Kayıtların sahibi olması gereken kullanıcının kimliği. Varsayılan değer, o anda oturum açmış kullanıcıdır.
waitforimporttocomplete	true ise sistem, ilerlemeden önce içeri aktarmanın tamamlanmasını bekler. false ise işleri kuyruğa alır ve devam eder.

zipimportdetails öğesi

configimportfile.filetypezip olduğunda configdatastorage.filestoimport öğesinde içe aktarılacak zip dosyalarını açıklar.

configimportfile öğesinde belirtilen zip dosyası içindeki tek bir dosya hakkında bilgi sağlayan 1 veya daha fazla zipimportdetail öğesi içerir.

zipimportdetail öğesi

configimportfile öğesinde belirtilen zip dosyası içindeki tek bir dosya hakkında bilgi sağlayın.

zipimportdetail öznitelikleri

Adı	Description
filename	İçeri aktarma verilerini içeren dosyanın adı.
filetype	Bu değer csv veya xml olabilir.
importtoentity	İşlemin sonunda çağrılacak bir bağlantı sağlamak için zip dosyasındaki exe, URL veya .msi dosyasının adı olabilir.

configimportmapfile öğesi

Dataverse'e aktarılacak bireysel harita dosyası hakkında bilgi içerir.

configimportmapfile öznitelikleri

Adı	Description
filename	Eşleme verilerini içeren dosyanın adı.

cmtdatafile öğesi

Yerel ayar kimliği (gerekli) ve kullanıcı bilgileri eşleme dosyası (isteğe bağlı) ile birlikte yerelleştirilmiş yapılandırma veri dosyalarını belirtir.

cmtdatafile örneği

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

cmtdatafile öznitelikleri

Adı	Description
filename	Eşleme verilerini içeren dosyanın adı.
lcid	LCID dil kodu tanımlayıcısının dize gösterimi.
usermapfilename	Yalnızca Dynamics 365 (on-premises) için. Projenizdeki Configuration Migration tool kullanılarak oluşturulan kullanıcı eşleme dosyasını (.xml) içerir. Bu dosya, kullanıcı bilgilerini farklı bir etki alanındaki Dynamics 365 (on-premises) örneğine aktarmak için gereklidir.