Odwołanie do konfiguracji importu

Plik ImportConfig.xml używany razem z wdrożeniem pakietu Package Deployer zawiera informacje o rozwiązaniach i danych do zaimportowania. Poniżej przedstawiono przykład:

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

W poniższych sekcjach przedstawiono szczegółowe informacje o prawidłowych elementach i atrybutach języka XML tego dokumentu.

configdatastorage pierwiastek

configdatastorage jest elementem głównym.

Atrybuty configdatastorage

Wszystkie te atrybuty są opcjonalne.

Nazwa/nazwisko	Podpis
installsampledata	Czy zainstalować przykładowe dane. Są to te same przykładowe dane instalowane przy użyciu innych metod: - Dodawanie lub usuwanie przykładowych danych - Dodawanie i usuwanie przykładowych danych za pomocą kodu
waitforsampledatatoinstall	Jeśli wartość to true i właściwość installsampledata również została ustawiona na true, przed wdrożeniem pakietu należy zaczekać na zainstalowanie przykładowych danych. Nie należy ustawiać na true, gdy installsampledata to false.
agentdesktopzipfile	Nazwa pliku ZIP, który ma zostać rozpakowany. W przypadku określenia w tym miejscu nazwy pliku ZIP podczas procesu wdrażania pakietów zostanie dodany ekran z monitem o wybranie lokalizacji, w której ma zostać rozpakowana zawartość pliku. Ten atrybut jest często używany do tworzenia pakietów dla Unified Service Desk dla Dynamics 365.
agentdesktopexename	Nazwa pliku EXE lub MSI w pliku ZIP lub adres URL, który ma zostać wywołany na końcu procesu wdrażania. Ten atrybut jest często używany do tworzenia pakietów dla Unified Service Desk dla Dynamics 365.
crmmigdataimportfile	Nazwa domyślnego pliku danych konfiguracji (ZIP) wyeksportowanego przy użyciu narzędzia Migracja konfiguracji.

elementy configdatastorage

Są to prawidłowe elementy podrzędne:

Element	Opisy
solutions	Zawiera co najmniej 0 configsolutionfile elementów opisujących rozwiązania do zaimportowania.
filestoimport	Zawiera -1 lub wiele configimportfileelementów - 0 lub wiele zipimportdetails elementów opisujących pojedyncze pliki i pliki zip, które mają zostać zaimportowane.
filesmapstoimport	Zawiera 1 lub wiele configimportmapfile elementów. Kolejność plików map w tym elemencie wskazuje kolejność ich importowania. Dowiedz się więcej o tworzeniu map danych do importu
cmtdatafiles	Zawiera 1 lub więcej elementów cmtdatafile, które zawierają zlokalizowaną wersję pliku danych konfiguracji do zaimportowania.

configsolutionfile pierwiastek

Opisano rozwiązania do zaimportowania w elemencie configdatastorage.solutions.

Atrybuty pliku configsolutionfile

Nazwa/nazwisko	Podpis
solutionpackagefilename	Wymagane Określ nazwę pliku .zip rozwiązania.
overwriteunmanagedcustomizations	Opcjonalnie określa, czy podczas importowania rozwiązania, które już istnieje w środowisku docelowym, mają zostać zastąpione wszelkie niezarządzane dostosowania. Jeśli nie określisz tego zachowania, dostosowania niezamane w istniejącym rozwiązaniu będą utrzymywane w środowisku docelowym.
publishworkflowsandactivateplugins	Opcjonalnie określa, czy publikować przepływy pracy i aktywować wtyczki w środowisku docelowym po zaimportowaniu rozwiązania. Jeśli to zachowanie nie zostanie określone, przepływ pracy zostanie opublikowany, a wtyczki zostaną aktywowane.

configimportfile pierwiastek

Opisano pliki do zaimportowania w elemencie configdatastorage.filestoimport.

Atrybuty pliku configimportfile

Nazwa/nazwisko	Podpis
filename	Nazwa pliku zawierającego dane importu.
filetype	Wartością może być csv, xml lub zip. Jeśli plik jest plikiem ZIP, zipimportdetails element musi być obecny wraz z elementem zipimportdetail dla każdego pliku w pliku ZIP.
associatedmap	Nazwa mapowania danych importu w usłudze Dataverse do użycia z tym plikiem. Jeśli to pole jest puste, Dataverse próbuje użyć systemu określają nazwę mapowania danych importu dla tego pliku.
importtoentity	Może być to nazwa pliku EXE w pliku ZIP, adres URL lub plik MSI, który ma udostępnić link do wywołania na końcu procesu wdrażania.
datadelimiter	Nazwa ogranicznika danych używanego w pliku importu. Prawidłowe wartości to pojedynczy cudzysłów lub podwójny cudzysłów.
fielddelimiter	Nazwa ogranicznika pola używanego w pliku importu. Poprawne wartości to przecinek, dwukropek lub pojedynczy cudzysłów.
enableduplicatedetection	Czy reguły wykrywania duplikatów mają być włączone podczas importu danych. Prawidłowe wartości to true i false.
isfirstrowheader	Używany do wskazywania, że pierwszy wiersz pliku importu zawiera nazwy pól. Prawidłowe wartości to true i false.
isrecordownerateam	Wskazuje, czy właścicielem rekordu związanego z raportem powinien być zespół. Prawidłowe wartości to true i false.
owneruser	Wskazuje identyfikator użytkownika, który powinien być właścicielem rekordów. Wartość domyślna to aktualnie zalogowany użytkownik.
waitforimporttocomplete	W przypadku wartości trueprzed kontynuowaniem system czeka na ukończenie importu. W przypadku wartości false zadania są umieszczane w kolejce i następuje przejście dalej.

zipimportdetails pierwiastek

Opisuje pliki zip, które mają być importowane w elemencie configdatastorage.filestoimport bez względu na to, czy configimportfile.filetype to zip.

Zawiera 1 lub więcej elementów zipimportdetail, które podają informacje o indywidualnym pliku w pliku ZIP określonym w elemencie configimportfile.

zipimportdetail pierwiastek

Podają informacje o indywidualnym pliku w pliku ZIP określonym w elemencie configimportfile.

Atrybuty zipimportdetail

Nazwa/nazwisko	Podpis
filename	Nazwa pliku zawierającego dane importu.
filetype	Wartością może być csv lub xml.
importtoentity	Może być to nazwa pliku EXE w pliku ZIP, adres URL lub plik MSI, który ma udostępnić link do wywołania na końcu procesu wdrażania.

configimportmapfile pierwiastek

Zawiera informacje o pliku pojedynczego mapowania, który ma być zaimportowany w Dataverse.

Atrybuty pliku configimportmapfile

Nazwa/nazwisko	Podpis
filename	Nazwa pliku zawierającego dane mapowania.

cmtdatafile pierwiastek

Określa zlokalizowane pliki danych konfiguracji wraz z identyfikatorem ustawień regionalnych (wymaganym) i plikiem mapy informacji o użytkowniku (opcjonalnym).

Przykład pliku cmtdatafile

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

Atrybuty cmtdatafile

Nazwa/nazwisko	Podpis
filename	Nazwa pliku zawierającego dane mapowania.
lcid	Reprezentacja ciągu identyfikatora kodu języka LCID.
usermapfilename	Tylko dla Dynamics 365 (on-premises). Zawiera plik mapowania użytkownika (.xml) wygenerowany przy użyciu narzędzia Configuration Migration Tool. Ten plik jest wymagany do zaimportowania informacji o użytkowniku do wystąpienia Dynamics 365 (on-premises) w innej domenie.