ImportConfig 참조
Package Deployer와 함께 사용되는 ImportConfig.xml 파일에는 가져올 솔루션 및 데이터에 대한 정보가 포함되어 있습니다. 예를 들면 다음과 같습니다.
<?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>
다음 섹션에서는 이 문서의 유효한 XML 요소 및 속성에 대한 세부 정보를 제공합니다.
configdatastorage 요소
configdatastorage 루트 요소입니다.
configdatastorage 특성
이러한 특성은 모두 선택 사항입니다.
| 입력 | Description |
|---|---|
installsampledata |
샘플 데이터를 설치할지 여부입니다. 이는 다른 메서드를 사용하여 설치된 것과 동일한 샘플 데이터입니다. - 샘플 데이터 추가 또는 제거 - 코드를 사용하여 샘플 데이터 추가 및 제거 |
waitforsampledatatoinstall |
true이고 installsampledata가 true로 설정된 경우 패키지를 배포하기 전에 샘플 데이터가 설치될 때까지 기다립니다. installsampledata가 false인 경우 이를 true로 설정하지 마십시오. |
agentdesktopzipfile |
압축을 풀 zip 파일의 파일 이름입니다. .zip 파일 이름을 여기에 지정하는 경우 패키지 배포 프로세스 동안 파일 내용의 압축을 풀 위치를 선택하라는 화면이 추가됩니다. 이 특성은 일반적으로 Dynamics 365용 Unified Service Desk 패키지를 만드는 데 사용됩니다. |
agentdesktopexename |
배포 프로세스가 끝날 때 호출할 zip 파일 또는 URL에 있는 .exe 또는 .msi 파일의 이름입니다. 이 특성은 일반적으로 Dynamics 365용 Unified Service Desk 패키지를 만드는 데 사용됩니다. |
crmmigdataimportfile |
구성 마이그레이션 도구를 사용하여 내보낸 기본 구성 데이터 파일(.zip)의 파일 이름입니다. |
configdatastorage 요소
유효한 하위 요소는 다음과 같습니다.
| 요소 | Descriptions |
|---|---|
solutions |
가져올 솔루션을 설명하는 0개 이상의 configsolutionfile 요소를 포함합니다. |
filestoimport |
포함 - 1개 이상의 configimportfile elements- 가져올 개별 파일과 zip 파일을 설명하는 0개 이상의 zipimportdetails 요소입니다. |
filesmapstoimport |
1개 이상의 configimportmapfile 요소를 포함합니다. 이 요소에 있는 맵 파일의 순서는 가져온 순서를 나타냅니다. 가져오기 위한 데이터 맵 생성에 대해 자세히 알아보세요 |
cmtdatafiles |
가져올 구성 데이터 파일의 현지화된 버전이 포함된 1개 이상의 cmtdatafile 요소를 포함합니다. |
configsolutionfile 요소
configdatastorage.solutions 요소로 가져올 솔루션을 설명합니다.
configsolutionfile 특성
| 입력 | Description |
|---|---|
solutionpackagefilename |
필수의 솔루션의 .zip 파일 이름을 지정하세요. |
overwriteunmanagedcustomizations |
선택 과목 대상 환경에 이미 존재하는 솔루션을 가져올 때 관리되지 않는 사용자 정의를 덮어쓸지 여부입니다. 이 동작을 지정하지 않으면 기존 솔루션의 관리되지 않는 사용자 지정이 대상 환경에서 유지됩니다. |
publishworkflowsandactivateplugins |
선택 과목 솔루션을 가져온 후 대상 환경에서 워크플로를 게시하고 플러그인을 활성화할지 여부입니다. 이 동작을 지정하지 않으면 워크플로가 게시되고 플러그인이 활성화됩니다. |
configimportfile 요소
configdatastorage.filestoimport 요소로 가져올 파일을 설명합니다.
configimportfile 특성
| 입력 | Description |
|---|---|
filename |
가져올 데이터가 들어 있는 파일 이름입니다. |
filetype |
이 값은 csv, xml 또는 zip일 수 있습니다. 파일이 .zip 파일인 경우 .zip 파일의 각 파일에 대해 zipimportdetails 요소가 zipimportdetail 요소와 함께 있어야 합니다. |
associatedmap |
이 파일과 함께 사용할 Dataverse 가져오기 데이터 맵의 이름입니다. 비어 있는 경우 Dataverse는 이 파일에 대해 시스템에서 결정한 가져오기 데이터 맵 이름을 사용하려고 시도합니다. |
importtoentity |
zip 파일에 있는 exe의 이름, URL 또는 프로세스가 끝날 때 호출할 링크를 제공하는 .msi 파일이 될 수 있습니다. |
datadelimiter |
가져올 파일에 사용된 데이터 구분 기호의 이름입니다. 유효한 값은 작은 따옴표 또는 큰 따옴표입니다. |
fielddelimiter |
가져올 파일에 사용된 필드 구분 기호의 이름입니다. 유효한 값은 쉼표, 콜론 또는 작은 따옴표입니다. |
enableduplicatedetection |
데이터 가져오기에 대한 중복 검색 규칙을 사용하도록 설정할지 여부입니다. 유효한 값은 true 또는 false입니다. |
isfirstrowheader |
가져오기 파일의 첫 번째 행에 필드 이름이 포함되어 있는지 여부입니다. 유효한 값은 true 또는 false입니다. |
isrecordownerateam |
가져올 때 레코드의 담당자가 팀이어야 하는지 여부입니다. 유효한 값은 true 또는 false입니다. |
owneruser |
레코드를 담당해야 하는 사용자 ID입니다. 기본값은 현재 로그인한 사용자입니다. |
waitforimporttocomplete |
true의 경우 시스템은 처리하기 전에 가져오기가 완료될 때까지 기다립니다. false의 경우 작업을 큐에 넣고 이동합니다. |
zipimportdetails 요소
configimportfile.filetype이 zip인 경우 configdatastorage.filestoimport 요소에서 가져올 zip 파일에 대해 설명합니다.
configimportfile 요소에 지정된 zip 파일 내의 개별 파일에 대한 정보를 제공하는 1개 이상의 zipimportdetail 요소를 포함합니다.
zipimportdetail 요소
configimportfile 요소에 지정된 zip 파일 내의 개별 파일에 대한 정보를 제공합니다.
zipimportdetail 특성
| 입력 | Description |
|---|---|
filename |
가져올 데이터가 들어 있는 파일 이름입니다. |
filetype |
이 값은 csv 또는 xml일 수 있습니다. |
importtoentity |
zip 파일에 있는 exe의 이름, url 또는 프로세스가 끝날 때 호출할 링크를 제공하는 .msi 파일이 될 수 있습니다. |
configimportmapfile 요소
Dataverse에서 가져올 개별 지도 파일에 대한 정보가 포함되어 있습니다.
configimportmapfile 특성
| 입력 | Description |
|---|---|
filename |
매핑 데이터가 포함된 파일의 이름입니다. |
cmtdatafile 요소
지역화된 구성 데이터 파일을 로캘 ID(필수) 및 사용자 정보 맵 파일(선택 사항)과 함께 지정합니다.
cmtdatafile 예
<cmtdatafiles>
<cmtdatafile filename="data_1033.zip"
lcid="1033"
usermapfilename="UserMap.xml" />
<cmtdatafile filename="data_1041.zip"
lcid="1041"
usermapfilename="" />
</cmtdatafiles>
cmtdatafile 특성
| 입력 | Description |
|---|---|
filename |
매핑 데이터가 포함된 파일의 이름입니다. |
lcid |
LCID(Language Code Identifier)의 문자열 표현입니다. |
usermapfilename |
Dynamics 365 (on-premises)에만 해당됩니다. 프로젝트에서 Configuration Migration Tool을 사용하여 생성된 사용자 맵 파일(.xml)을 포함합니다. 이 파일은 사용자 정보를 다른 도메인의 Dynamics 365 (on-premises) 인스턴스로 가져오는 데 필요합니다. |