데이터 가져오기 실행
게시 날짜: 2017년 1월
적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
데이터 가져오기는 Microsoft Dynamics 365 서버에서 직접 실행됩니다. 데이터 가져오기를 실행하려면 다음 순서로 다음 작업을 실행하는 비동기 작업으로 설정하여 백그라운드에서 실행합니다.
가져올 파일에 포함된 원본 데이터를 구문 분석합니다.
데이터 맵을 사용하여 구문 분석된 데이터를 변환합니다.
변환된 데이터를 Microsoft Dynamics 365에 업로드합니다.
적절한 권한이 있는 모든 Microsoft Dynamics 365 사용자가 데이터 가져오기를 수행할 수 있습니다.
이 항목의 내용
데이터 원본 구문 분석
구문 분석된 데이터 변환
대상 서버에 변환된 데이터 업로드
로그 실패
감사 데이터 가져오기
데이터 원본 구문 분석
원본 데이터 구문 분석에는 특정 가져오기(데이터 가져오기)에 연결된 모든 가져올 파일의 구문 분석이 포함됩니다.
구문 분석된 데이터는 가져온 모든 파일에 대해 만들어진 임시 구문 분석 테이블에 저장됩니다. 구문 분석 테이블의 이름은 ImportFile.ParsedTableName 특성에 저장됩니다. 원본 파일 열 머리글은 ImportFile.HeaderRow 특성에 지정됩니다. 원본 파일에 열 머리글이 포함된 첫 번째 행이 없으면 이 특성은 시스템에서 생성된 기본 열 머리글을 지정합니다.
ParseImportRequest 메시지를 사용하여 구문 분석된 데이터를 구문 분석 테이블에 저장합니다.GetDistinctValuesImportFileRequest 메시지와 RetrieveParsedDataImportFileRequest 메시지를 사용하여 구문 분석 테이블에서 데이터를 검색합니다.
다음 표에는 가져올 파일을 구문 분석하고 구문 분석 테이블에서 구문 분석된 데이터를 검색하는 데 사용할 수 있는 메시지가 나와 있습니다.
메시지 |
설명 |
|---|---|
지정된 가져오기(데이터 가져오기)에 연결된 모든 가져올 파일을 구문 분석하는 비동기 작업을 제출합니다. 이 요청의 ImportId 속성에서 연결된 가져오기(데이터 가져오기)의 ID를 전달합니다. 백그라운드에서 실행되고 데이터 구문 분석을 수행하는 비동기 작업의 ID는 메시지 응답의 AsyncOperationId 속성에서 반환됩니다. |
|
목록 값이 포함된 원본 파일의 열에 대해 고유한 값을 반환합니다. 이 요청의 ImportFileId 속성에서 연결된 가져올 파일의 ID를 전달합니다. 고유한 값은 메시지 응답의 Values 속성에서 문자열 배열로 반환됩니다.ParseImportRequest 메시지를 사용하여 구문 분석 테이블을 만든 후에만 이 메시지를 사용합니다. 중요 ImportRecordsImportRequest 메시지를 사용한 후에는 이 메시지를 사용하지 마십시오.ImportRecordsImportRequest 메시지에서 제출된 가져오기 작업이 실행을 마친 후에는 구문 분석 파일에 액세스할 수 없습니다. |
|
구문 분석 테이블에서 데이터를 검색합니다. 이 요청의 ImportFileId 속성에서 연결된 가져올 파일의 ID를 전달합니다. 구문 분석된 데이터는 메시지 응답의 Values 속성에서 2차원 문자열 배열로 반환됩니다. 데이터는 원본 파일의 열 순서와 같은 열 순서로 반환됩니다.ParseImportRequest 메시지를 사용하여 구문 분석 테이블을 만든 후에만 이 메시지를 사용합니다. 중요 ImportRecordsImportRequest 메시지를 사용한 후에는 이 메시지를 사용하지 마십시오.ImportRecordsMessage 메시지에서 제출된 가져오기 작업이 실행을 마친 후에는 구문 분석 파일에 액세스할 수 없습니다. |
구문 분석된 데이터 변환
변환하는 동안 데이터에 대한 특정 가져오기(데이터 가져오기)에 연결된 모든 사용 가능한 데이터 매핑 및 변환을 적용하여 구문 분석된 데이터를 변경합니다.
TransformImportRequest 메시지를 사용하여 구문 분석된 데이터를 변환하는 비동기 작업을 제출합니다. 요청의 Import.ImportId 특성에 연결된 가져오기(데이터 가져오기)의 고유 식별자를 전달합니다. 백그라운드에서 실행되고 변환을 수행하는 비동기 작업의 고유 식별자는 메시지 응답의 AsyncOperationId 속성에서 반환됩니다.
대상 서버에 변환된 데이터 업로드
변환을 완료한 후 데이터는 Microsoft Dynamics 365 서버에 업로드할 준비가 됩니다.
ImportRecordsImportRequest 메시지를 사용하여 변환된 데이터를 업로드하는 비동기 작업을 Microsoft Dynamics 365에 제출합니다. 요청의 ImportId 속성에 연결된 가져오기(데이터 가져오기)의 고유 식별자를 지정해야 합니다. 백그라운드에서 실행되고 데이터를 Microsoft Dynamics 365에 업로드하는 비동기 작업의 고유 식별자는 메시지 응답의 AsyncOperationId 속성에서 반환됩니다. 지정된 가져오기(데이터 가져오기)에 연결된 모든 가져올 파일을 가져옵니다.
각 가져오기 작업에는 가져오기 작업에서 만든 레코드의 ImportSequenceNumber 특성에 저장되는 고유한 일련 번호가 있습니다.Organization.CurrentImportSequenceNumber 특성에는 시스템에서 실행한 마지막 가져오기 작업의 고유한 일련 번호가 있습니다. 이러한 고유한 일련 번호를 사용하여 가져오기 작업에 속하는 레코드를 추적할 수 있습니다.
로그 실패
데이터 가져오기 실패는 데이터 구문 분석, 변환 또는 업로드하는 동안 발생할 수 있습니다. 실패 이유 및 레코드에 대한 기타 자세한 정보는 가져오기 로그(ImportLog) 엔터티에 캡처됩니다.
가져오지 못한 레코드 수를 확인하려면 레코드의 ImportFile.FailureCount 특성을 검색합니다. 가져오는 동안 일부 실패한 레코드 수를 확인하려면 ImportData.HasError 특성을 검색합니다.HasError 특성이 true이면 일부 실패가 발생하고, false이면 레코드를 성공적으로 가져옵니다.
감사 데이터 가져오기
Microsoft Dynamics 365 엔터티에는 레코드를 만들고 마지막으로 수정한 날짜와 시간 및 레코드를 만들고 수정한 사람을 추적하는 데 사용되는 기본 특성이 네 개 있습니다.
createdon 특성은 레코드를 만든 날짜와 시간을 지정합니다.createdon 특성의 데이터를 가져오려면 이 데이터가 들어 있는 원본 열을 overriddencreatedon 특성에 매핑합니다. 가져오는 동안 레코드의 createdon 특성은 데이터를 가져온 날짜와 시간으로 설정되는 overriddencreatedon 특성 및 overriddencreatedon 특성에 매핑된 값으로 업데이트됩니다.overriddencreatedon 특성에 매핑되는 원본 값이 없을 경우 createdon 특성은 데이터를 가져온 날짜와 시간으로 설정되고 overriddencreatedon 특성은 어떤 값으로도 설정되지 않습니다.
참고
가져오는 동안 createdon 특성의 값을 다시 정의하려면 prvOverrideCreatedOnCreatedBy 권한이 있어야 합니다. 권한 이름은 가져오는 동안 createdby 특성을 다시 정의할 수도 있음을 의미합니다. 하지만 이 기능은 현재 지원되지 않습니다.
데이터를 modifiedon, createdby 및 modifiedby 특성에 가져올 수 없습니다. 데이터를 만들고 수정한 사람과 데이터를 수정한 시간과 관련된 데이터를 저장해야 할 경우 Microsoft Dynamics 365에서 사용자 지정 특성을 만들어 원본 열을 새 사용자 지정 특성에 매핑할 수 있습니다.
참고 항목
데이터 가져오기
데이터 가져오기 구성
블로그 게시물: 첨부 파일을 프로그래밍 방식으로 가져오는 방법
데이터 가져오기 엔터티
Microsoft Dynamics 365
© 2017 Microsoft. All rights reserved. 저작권 정보