가져올 데이터 맵 만들기

게시 날짜: 2017년 1월

적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Microsoft Dynamics 365으로 데이터를 가져오려면 적절한 데이터 맵을 제공해야 합니다.

데이터 맵의 예는 SDK의 SDK\Resources\DataImportMaps\ 위치에서 찾을 수 있습니다.Microsoft Dynamics CRM SDK 패키지를 다운로드합니다.

데이터 맵을 사용하여 원본 파일에 포함된 데이터를 Microsoft Dynamics 365 엔터티 특성에 매핑합니다. 원본 파일의 각 열을 적합한 특성에 매핑해야 합니다. 매핑되지 않은 열의 데이터는 데이터 가져오기 작업 중에 가져오지 않습니다.

데이터 맵은 가져오기 맵(데이터 맵) 엔터티로 나타납니다.CreateRequest 메시지를 사용하여 새 맵을 만들거나 IOrganizationService.Update 메서드를 사용하여 기존 맵을 업데이트할 수 있습니다. 지도는 ImportMap.Name 특성에 포함되어 있는 고유 이름을 가집니다.ImportMap.Source 특성을 사용하여 만들어지는 이 데이터 맵에 대해 가져오기 원본의 이름을 지정할 수 있습니다.

이 항목의 내용

열, 목록 값 및 조회 매핑

담당자 매핑

메모와 첨부 파일

데이터 맵 가져오기 및 내보내기

열, 목록 값 및 조회 매핑

원본 파일의 열, 목록 값 또는 조회 값을 Microsoft Dynamics 365 특성에 매핑하려면 다음 매핑을 사용합니다.

열 매핑

원본 파일의 열을 Microsoft Dynamics 365 엔터티 특성에 매핑합니다. 열 매핑의 경우 열 매핑(ColumnMapping) 엔터티를 사용합니다. 원본 및 대상 특성 간에 1:1(일대일) 또는 1:N(일대다) 관계를 사용할 수 있습니다. 예를 들어 거래처 주소 정보를 청구지 주소 및 운송지 주소 모두에 차례로 매핑할 수 있습니다.

목록 값 매핑

원본 파일의 목록 값을 OptionSetValue 유형의 Microsoft Dynamics 365 특성에 매핑합니다. 목록 값 매핑의 경우 선택 목록 매핑(PicklistMapping) 엔터티를 사용합니다.

원보 파일 열에 지정된 값이 OptionSetValue, Status, State, Boolean과 같은 목록 값일 경우 열 매핑 외에도 목록 값 매핑도 추가로 제공해야 합니다. 예를 들어 원본 파일의 "bill" 및 "ship" 목록 값을 OptionSetValue 유형의 bill 및 ship 값에 매핑합니다.

조회 매핑

원본 파일의 조회 값을 EntityReference 유형의 Microsoft Dynamics 365 특성에 매핑합니다. 조회 매핑의 경우 조회 매핑(LookupMapping) 엔터티를 사용합니다.

원본 파일에 지정된 값이 엔터티를 참조할 경우 이 값에 대해 조회 매핑을 제공해야 합니다.LookupMapping.LookupSourceCode 특성을 사용하여 원본 파일 내부 또는 Microsoft Dynamics 365 내부에서 참조된 엔터티를 검색할지 여부를 지정합니다. 초기 바인딩 유형을 사용할 경우 LookupSourceType 열거형을 사용하여 조회 값을 설정할 수 있습니다. 원본 파일 내부를 검색하려면 LookupSourceType.Source 값을 사용합니다.Microsoft Dynamics 365 내부를 검색하려면 LookupSourceType.System 값을 사용합니다. LookupSourceCode 값 목록은 이 엔터티에 대한 선택 목록 값을 참조하십시오.조직에 대한 엔터티 메타데이터를 보려면 조직에 대한 메타데이터 찾아보기에 설정된 메타데이터 브라우저 솔루션을 설치하십시오. SDK 다운로드의 최상위 폴더에 포함된 EntityMetadata.xlsx라는 Excel 파일에서 사용자 지정되지 않은 조직의 메타데이터를 볼 수도 있습니다. 조회 매핑을 여러 개 지정할 수 있습니다. 비동기 변환 작업은 사용 가능한 모든 매핑을 처리합니다. 참조되는 레코드 찾아 레코드 고유 식별자를 사용하여 구문 분석 테이블을 업데이트합니다. 자세한 내용은 데이터 가져오기 실행을 참조하십시오.

담당자 매핑

담당자 매핑을 사용하여 원본 파일에 지정된 사용자를 Microsoft Dynamics 365의 사용자에 매핑합니다. 로깅 정보는 Microsoft Dynamics 365 사용자 로그온 이름을 사용합니다. 담당자 매핑의 경우 담당자 매핑(OwnerMapping) 엔터티를 사용합니다.

메모와 첨부 파일

메모와 첨부 파일에 대한 매핑은 다른 엔터티에서 다르게 처리됩니다. 메모와 첨부 파일은 Microsoft Dynamics 365의 레코드에 추가 정보를 추가하기 위해 사용됩니다.Microsoft Dynamics 365 데이터베이스에서 메모는 텍스트로 저장되고 첨부 파일은 파일로 저장됩니다.

Microsoft Dynamics 365에서 메모를 만들려면 주석(메모) 엔터티에서 Annotation.IsDocument 특성을 false로 설정합니다. 첨부 파일을 만들려면 IsDocument를 true로 설정합니다.

메모와 첨부 파일을 매핑하려면 다음 설정을 사용합니다.

• ColumnMapping.SourceAttributeName 특성을 “true” 또는 “false”로 설정합니다. “true” 값은 첨부 파일을 나타냅니다. "false" 값은 메모를 나타냅니다.

• ColumnMapping.TargetAttributeName 특성을 IsDocument로 설정합니다.

• 초기 바인딩 유형을 사용할 경우 ColumnMapping.ProcessCode 특성을 ImportProcessCode 열거형의 ImportProcessCode.Internal 값으로 설정합니다. ProcessCode 값 목록은 이 엔터티에 대한 선택 목록 값을 참조하십시오.

원본 데이터가 메모를 나타내는 경우 메모의 텍스트를 Annotation.NoteText 특성에 매핑합니다. Salesforce 파일을 사용하여 작업하는 경우 일반적으로 고유 식별 번호로 디스크에 저장됩니다. 첨부 파일을 가져오려면 원본 파일에 포함된 파일 식별 번호를 Annotation.DocumentBody 특성에 매핑해야 합니다.DocumentBody 특성은 첨부 파일의 내용을 저장합니다.

가져오기 비동기 작업은 원본 특성 이름이 “true” 및 “false”로 설정된 매핑을 확인하여 메모와 첨부 파일을 검색합니다. 첨부 파일 매핑을 찾으면 디스크에서 지정된 파일을 찾아 파일 내용을 첨부 파일로 Microsoft Dynamics 365에 업로드합니다. 파일이 없으면 오류가 반환됩니다.

주석(메모) 엔터티에 대한 매핑을 제공하지 않으면 가져오기 작업은 해당 메모에 대해 기본 매핑을 생성합니다.

데이터 맵 가져오기 및 내보내기

기존 데이터 맵을 XML 파일에 내보내고 XML 데이터 매핑을 Microsoft Dynamics 365에 가져올 수 있습니다.Microsoft Dynamics 365에서 데이터 맵을 내보내려면 ExportMappingsImportMapRequest 메시지를 사용합니다. XML 데이터 매핑을 가져와 Microsoft Dynamics 365에서 데이터 맵을 만들려면 ImportMappingsImportMapRequest 메시지를 사용합니다.

참고 항목

데이터 가져오기
가져올 변환 매핑 추가
가져올 변환 매핑 추가

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 저작권 정보