연습: 개발자 확장을 사용하여 Microsoft Dynamics CRM 2015에 연결하는 콘솔 응용 프로그램 빌드

아티클
07/06/2017

게시 날짜: 2016년 11월

적용 대상: Dynamics CRM 2015

이 연습에서는 개발 확장을 사용하여 Microsoft Dynamics CRM 2015에 연결하고 연락처 레코드를 만드는 간단한 콘솔 응용 프로그램을 작성하는 방법을 보여 줍니다.

Walkthroughs\Portal\ConsoleAppWalkthrough 폴더에서 이 연습에서 생성하는 샘플 코드를 찾을 수 있습니다.

이 항목의 내용

초기 바인딩 유형 생성

Visual Studio에서 새 콘솔 응용 프로그램 프로젝트 만들기

초기 바인딩 유형 생성

“Microsoft.Xrm.Client.CodeGeneration” 확장으로 CrmSvcUtil.exe 도구를 실행하여 엔터티 클래스와 서비스 컨텍스트를 생성합니다. 다음은 Microsoft Dynamics 365의 인스턴스를 가리키는 Xrm.cs라는 파일을 만드는 예제 명령입니다. Microsoft.Xrm.Client.CodeGeneration.dll 파일은 CrmSvcUtil.exe 파일과 동일한 디렉터리에 있거나 이 명령을 실행할 때 시스템 전역 어셈블리 캐시에 있어야 합니다. 표시되는 첫 번째 명령은 온-프레미스 조직을 위한 것입니다. 두 번째 명령은 CRM Online 조직을 위한 것입니다. 두 명령 모두 줄 바꿈 없이 단일 명령줄로 실행되어야 합니다.
```
    CrmSvcUtil.exe
    /codeCustomization:"Microsoft.Xrm.Client.CodeGeneration.CodeCustomization, Microsoft.Xrm.Client.CodeGeneration"/out:Xrm.cs /url:http://<myserver>/<myorg>/XRMServices/2011/Organization.svc 
    /domain:<mydomain> /username:<myusername> /password:<mypassword> /namespace:Xrm /serviceContextName:XrmServiceContext
```
```
    CrmSvcUtil.exe
    /codeCustomization:"Microsoft.Xrm.Client.CodeGeneration.CodeCustomization, Microsoft.Xrm.Client.CodeGeneration"
    /out:Xrm.cs /url:https://<mydomain>.api.crm.dynamics.com/XRMServices/2011/Organization.svc
    /username:<myusername>@<mydomain>.onmicrosoft.com /password:<mypassword> /namespace:Xrm /serviceContextName:XrmServiceContext
```
팁

CrmSvcUtil 도구는 SDK 다운로드의 Bin 폴더에서 사용하거나 Microsoft.CrmSdk.CoreToolsNuGet 패키지를 설치하여 사용할 수 있습니다.

Visual Studio에서 새 콘솔 응용 프로그램 프로젝트 만들기

“ConsoleAppWalkthrough”라는 새 콘솔 응용 프로그램 프로젝트를 만듭니다. 아직 .NET Framework 4.5.2를 설치하지 않은 경우 .NET Framework 설치에서 개발자 팩을 얻을 수 있습니다.
SDK\bin 폴더에서 다음 참조를 추가합니다. 간단히 Microsoft.CrmSdk.ExtensionsNuGet 패키지를 설치하여 이 단계와 다음 단계를 건너뛸 수 있습니다.
- AntiXSSLibrary.dll
- Microsoft.Crm.Sdk.Proxy.dll
- Microsoft.Xrm.Client.dll
- Microsoft.Xrm.Portal.dll
- Microsoft.Xrm.Portal.Files.dll
- Microsoft.Xrm.Sdk.dll
.NET에서 다음 참조를 추가합니다.
- System.IdentityModel.dll
- Microsoft.ServiceBus.dll
- System.Data.Services.dll
- System.Data.Services.Client.dll
- System.Runtime.Serialization.dll
콘솔 프로젝트가 대상 프레임워크로 .NET Framework 4.5.2 클라이언트 프로필이 아닌 .NET Framework 4.5.2를 지정하는지 확인합니다. 솔루션 탐색기에서 ConsoleAppWalkthrough 프로젝트를 선택하고 Alt-Enter를 클릭하여 프로젝트의 속성을 확인합니다.
Visual Studio에서 프로젝트를 마우스 오른쪽 단추로 클릭하고 추가를 클릭한 후 기존 항목을 클릭합니다.
초기 바인딩 유형을 생성할 때 만든 “xrm.cs” 파일을 선택합니다.
프로젝트를 다시 마우스 오른쪽 단추로 클릭하고 추가를 클릭한 후 새 항목을 클릭합니다.
옵션에서 응용 프로그램 구성 파일을 선택한 후 추가를 클릭합니다.

App.config 구성 파일을 특정 연결 문자열로 편집합니다.

<?xml version="1.0"?>
<configuration>
  <configSections>
    <section name="microsoft.xrm.client" type="Microsoft.Xrm.Client.Configuration.CrmSection, Microsoft.Xrm.Client"/>
  </configSections>
  <connectionStrings>   <add name="Xrm" connectionString="Server=http://crmserver/contoso; Domain=CONTOSO; Username=Administrator;Password=pass@word1"/></connectionStrings>
  <microsoft.xrm.client>
    <contexts default="Xrm">
      <add name="Xrm" type="Xrm.XrmServiceContext, Xrm" connectionStringName="Xrm"/>
    </contexts>
  </microsoft.xrm.client>
  <startup>
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5.2"/>
  </startup>
</configuration>

프로젝트(이 예제에서는 “Xrm”)를 만들 때 1단계에서 사용한 using 문을 네임스페이스에 추가합니다.

프로그램 클래스에 다음 코드를 추가합니다.

static void Main(string[] args)
{
    var xrm = new XrmServiceContext("Xrm");

    WriteExampleContacts(xrm);

    //Create a new contact called Allison Brown.
    var allisonBrown = new Xrm.Contact
    {
        FirstName = "Allison",
        LastName = "Brown",
        Address1_Line1 = "23 Market St.",
        Address1_City = "Sammamish",
        Address1_StateOrProvince = "MT",
        Address1_PostalCode = "99999",
        Telephone1 = "12345678",
        EMailAddress1 = "allison.brown@example.com"
    };

    xrm.AddObject(allisonBrown);
    xrm.SaveChanges();

    WriteExampleContacts(xrm);

    Console.WriteLine("Press any key to exit.");
    Console.ReadKey();
}

/// <summary>
/// Use all contacts where the email address ends in @example.com.
/// </summary>
private static void WriteExampleContacts(XrmServiceContext xrm)
{
    var exampleContacts = xrm.ContactSet
        .Where(c => c.EMailAddress1.EndsWith("@example.com"));

    //Write the example contacts.
    foreach (var contact in exampleContacts)
    {
        Console.WriteLine(contact.FullName);
    }
}

솔루션을 디버깅하고 테스트합니다. 그러면 Dynamics 365 조직에 연락처를 만듭니다.

참고 항목

Microsoft Dynamics CRM 2015용 포털 개발자 가이드
Dynamics CRM 2015용 포털 연습
연습: 개발자 확장을 사용하여 Microsoft Dynamics CRM 2015에 연결하는 웹 응용 프로그램 빌드

다음을 통해 공유

연습: 개발자 확장을 사용하여 Microsoft Dynamics CRM 2015에 연결하는 콘솔 응용 프로그램 빌드

이 항목의 내용

초기 바인딩 유형 생성

Visual Studio에서 새 콘솔 응용 프로그램 프로젝트 만들기

참고 항목

추가 리소스