샘플: 날짜 및 시간 동작 변환

아티클
07/06/2017

게시 날짜: 2016년 11월

적용 대상: Dynamics CRM 2015

이 샘플은 ConvertDateAndTimeBehaviorRequest 메시지를 사용하여 UTC 값을 UserLocal부터 DateOnly까지 특성의 동작을 변경하기 전에 시스템에 있는 Dynamics 365에서 날짜 및 시간 특성의 DateOnly 값으로 변환하는 방법을 보여줍니다.추가 정보:데이터베이스에 있는 기존 날짜 및 시간 값의 동작 변환.

이 샘플은 Microsoft Dynamics CRM Online 2015 업데이트 1용입니다. 이는 날짜 및 시간 동작 변환에서 다운로드할 수 있습니다.

필수 조건

Microsoft Dynamics CRM Online 2015 업데이트 1 조직에 액세스합니다.
CRM 조직의 시스템 관리자 역할에서 이 샘플에 표시된 ConvertDateAndTimeBehaviorRequest 메시지를 사용하도록 할 수 있습니다. 그렇지 않으면 이 예제는 실패합니다.
DateTimeAttributeBehavior Visual Studio 프로젝트를 다운로드합니다.
DateTimeAttributeBehavior Visual Studio 프로젝트를 열고 Microsoft.CrmSdk.CoreAssemblies 버전 7.1.0-preview NuGet 패키지를 설치합니다. 지침은 NuGet 패키지 설치를 참조하십시오.

NuGet 패키지를 설치한 후에 샘플을 실행하는 방법과 예상되는 결과에 대한 자세한 내용은 샘플 실행를 참조하십시오.

이 항목의 내용

이 샘플의 기능

NuGet 패키지 설치

샘플 실행

이 샘플의 기능

ConvertDateandTimeBehavior 클래스 Run 메서드는 샘플에 대한 Dynamics 365의 해당 버전을 실행하고 있는지 확인합니다.
CreateRequiredRecords 메서드는 샘플에 필요한 레코드를 만듭니다.
1. UserLocal 동작을 사용하여 Account 엔터티에 대한 샘플 날짜 및 시간 특성을 만듭니다.
2. 새로운 날짜 및 시간 특성에서 March 31, 2015 11:00 PM UTC 값으로 샘플 계정 레코드를 만듭니다.
3. DateOnly에 날짜 및 시간 특성의 동작을 변경합니다.
4. 새로운 날짜 및 시간 특성에서 March 31, 2015 11:00 PM UTC 값으로 다른 샘플 계정 레코드를 만듭니다. 특성은 이제 DateOnly이므로 시간 부분은 무시되며 시스템에 March 31, 2015 00:00:00로 저장됩니다.
5. 두 계정 레코드에서 날짜 및 시간 특성의 값을 검색합니다. 동작이 변경되기 때문에 두 값은 March 31, 2015 00:00:00로 표시됩니다. 그러나 첫 번째 계정 레코드의 값은 데이터베이스에서 계속 UTC(March 31, 2015 11:00 PM)에 있습니다.

ConvertDateAndTimeBehaviorRequest SDK 메시지를 실행하여 날짜 및 시간 특성의 UTC 값을 DateOnly 값으로 변환하기 위한 비동기 작업을 만듭니다. SDK 메시지의 변환 규칙은 CRM에서 인도 표준시(IST) 시간대 코드에 따라 값을 변환합니다(190).


ConvertDateAndTimeBehaviorRequest request = new ConvertDateAndTimeBehaviorRequest()
{
    Attributes = new EntityAttributeCollection() 
            { 
                new KeyValuePair<string, StringCollection>("account", new StringCollection() 
                { "new_sampledatetimeattribute" }) 
            },
    ConversionRule = DateTimeBehaviorConversionRule.SpecificTimeZone.Value,
    TimeZoneCode = 190, // Time zone code for India Standard Time (IST) in CRM
    AutoConvert = false // Conversion must be done using ConversionRule
};

// Execute the request
ConvertDateAndTimeBehaviorResponse response = (ConvertDateAndTimeBehaviorResponse)_serviceProxy.Execute(request);

변환 후에 두 계정 레코드에서 날짜 및 시간 특성의 값을 검색합니다. 첫 번째 계정 레코드의 UTC 값은 인도 표준시(IST) 시간대에 따라 변환이 발생하므로 3월 31일이 아닌 4월 1일로 변환됩니다. 두 번째 계정 레코드의 값은 이미 DateOnly 값이므로 영향을 받지 않습니다.
마지막으로 DeleteRequiredRecords 메서드는 샘플을 실행하는 동안 만들어진 엔터티 레코드와 사용자 지정 날짜 및 시간 특성을 삭제할 것인지 묻는 메시지를 표시합니다.
1. y를 입력하고 ENTER 키를 눌러 조직에서 엔터티 레코드 및 사용자 지정 특성을 삭제합니다.
2. n를 입력하고 ENTER 키를 눌러 조직에 엔터티 레코드 및 사용자 지정 특성을 유지합니다. 원래 상태로 되돌리려면 나중에 수동으로 삭제해야 합니다.

NuGet 패키지 설치

다음 단계를 사용하여 이 샘플에 필요한 어셈블리를 설치합니다.

이 샘플을 다운로드하고 파일 압축을 풉니다.
C# 폴더로 이동하고 Visual Studio를 사용하여 DateTimeAttributeBehavior.sln 파일을 엽니다.
Visual Studio에서 DateTimeAttributeBehavior 프로젝트를 마우스 오른쪽 단추로 클릭하고 NuGet 패키지 관리를 선택합니다.
미리 보기 릴리스의 경우 검색 조건에서 Stable Only 대신 Include Prerelease를 선택해야 합니다. 그런 다음 “Microsoft Dynamics CRM 2015 SDK core assemblies”를 검색합니다.7.1.0-preview 버전을 선택했는지 확인합니다.
설치를 클릭합니다. 이 패키지 설치를 완료하려면 사용 조건에 동의해야 합니다.

샘플 실행

Visual Studio에서 솔루션 및 필요한 NuGet 패키지를 설치한 상태에서 F5 키를 누릅니다.

이전에 Microsoft Dynamics 365 관리형 코드 샘플 중 하나를 실행하지 않은 경우 코드를 실행하려면 정보를 입력해야 합니다. 그렇지 않으면 이전에 설정한 Dynamics 365 서버 중 하나에 대한 번호를 입력합니다.

프롬프트	설명
CRM 서버 이름 및 포트[crm.dynamics.com] 입력	Microsoft Dynamics CRM 서버의 이름을 입력합니다. 기본값은 북미의 경우 Microsoft Dynamics CRM Online(crm.dynamics.com)입니다. 예: crm5.dynamics.com
이 조직이 Microsoft 온라인 서비스에서 프로비전되었습니까? (y/n) [n]	이 조직이 Microsoft 온라인 서비스에서 프로비전된 조직인 경우 y를 입력합니다. 그렇지 않으면 n을 입력합니다.
도메인\사용자 이름을 입력합니다.	Microsoft 계정을 입력합니다.
암호를 입력합니다.	암호를 입력합니다. 문자는 창에 “*”를 표시합니다. 암호는 나중에 다시 사용할 수 있도록 Microsoft 자격 증명 관리자에 안전하게 저장됩니다.
조직 번호 지정(1-n) [1]	표시된 조직 목록에서 해당 번호를 입력합니다. 기본값은 1이며, 목록에서 첫 번째 조직을 나타냅니다.

샘플은 이 샘플의 기능에서 설명하는 작업을 수행하고 추가 옵션을 묻는 메시지가 나타날 수 있습니다.
샘플이 완료되면 ENTER 키를 눌러 콘솔 창을 닫습니다.

참고 항목

ConvertDateAndTimeBehaviorRequest
날짜 및 시간 특성의 동작 및 형식
Customize 특성 메타데이터 메시지

다음을 통해 공유

샘플: 날짜 및 시간 동작 변환

필수 조건

이 항목의 내용

이 샘플의 기능

NuGet 패키지 설치

샘플 실행

참고 항목

추가 리소스