다음을 통해 공유

양식에 전달된 매개 변수를 사용하여 필드 값 설정

  • 아티클

 

게시 날짜: 2017년 1월

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

이 항목의 내용은 Microsoft Dynamics 365(온라인 및 온-프레미스)에 사용할 수 있습니다. 양식을 여는 데 사용되는 URL의 특성 값을 지정하여 사용자가 만든 새 레코드에 대해 기본 값을 설정할 수 있습니다. 기본적으로 이러한 값은 양식에 설정되지만 레코드를 저장하기 전에 사용자가 변경할 수 있습니다.

이 항목의 내용

필드 레코드 값을 설정하도록 매개 변수 전달

예제: 문자열 필드의 값 설정

조회 필드의 값 설정

예제: 조회 필드의 값 설정

예제: 날짜 필드의 값 설정

예제: 옵션 집합 필드의 값 설정

예제: Xrm.Utility.openEntityForm을 사용하여 새 창 열기

예제: window.open을 사용하여 새 창 열기

필드 레코드 값을 설정하도록 매개 변수 전달

참고

매개 변수 값을 양식에 전달하여 Xrm.Utility.openEntityForm 함수를 사용하여 필드 값을 설정할 수 있습니다. 예제를 보려면 예제: Xrm.Utility.openEntityForm을 사용하여 새 창 열기을 참조하십시오.

URL 주소를 사용하여 새 양식을 열면 extraqs 매개 변수에 인수를 포함하여 필드 값을 설정할 수 있습니다. 다음 요구 사항을 충족해야 합니다.

  • extraqs 매개 변수에 전달된 매개 변수를 인코딩해야 합니다. 매개 변수를 인코딩하려면 encodeURIComponent를 사용하십시오.

  • 쿼리 문자열 인수의 이름은 엔터티에 대한 특성의 이름과 일치하거나 포함해야 합니다.

  • 전달된 값은 유효해야 합니다.

  • 값은 스크립트일 수 없습니다.

잘못된 매개 변수 또는 값을 전달하려고 하면 오류가 발생합니다.

  • 부울 필드의 경우 정수 값 0 또는 1을 사용하거나 텍스트 값 true 또는 false를 사용하여 값을 설정합니다.

  • 날짜/시간 필드의 경우 날짜 텍스트 값을 사용합니다.

예제: 문자열 필드의 값 설정

다음 샘플에서는 새 거래처 레코드의 이름 필드의 값을 "New Account"로 설정합니다.

extraqs 매개 변수의 인코딩되지 않은 값은 “name=New Account”입니다.

/main.aspx?etn=account&extraqs=name%3DNew%20Account&pagetype=entityrecord

조회 필드의 값 설정

다음 표에는 5가지 유형의 조회 필드가 있습니다. 조회 필드를 사용하는 예제는 예제: 조회 필드의 값 설정 및 예제: Xrm.Utility.openEntityForm을 사용하여 새 창 열기를 참조하십시오.

조회 유형

설명

단순 조회

한 유형의 엔터티에 대한 단일 참조를 허용합니다.

고객 조회

거래처 또는 연락처 레코드에 대한 단일 참조를 허용합니다.

담당자 조회

팀 또는 시스템 사용자 레코드에 대한 단일 참조를 허용합니다.

선택 목록 조회

여러 엔터티에 대한 여러 참조를 허용합니다.

관련 조회

여러 엔터티에 대한 단일 참조를 허용합니다.

다음 지침은 쿼리 문자열 인수를 사용하여 양식에 조회 값을 설정할 때 적용됩니다.

  • 단순 조회의 경우 조회에서 표시할 값 및 텍스트를 설정해야 합니다. 특성 이름에 접두사 "name"을 사용하여 텍스트 값을 설정합니다.

    다른 인수는 사용하지 마십시오.

  • 담당자 및 고객 조회의 경우 단순 조회에서 설정한 것과 동일한 방식으로 값과 이름을 설정해야 합니다. 또한 접미사 "type"을 사용하여 엔터티 유형을 지정해야 합니다. 사용 가능한 값은 account, contact, systemuser 및 team입니다.

  • partylist 또는 관련 조회에 대한 값을 설정할 수 없습니다.

예제: 조회 필드의 값 설정

조회 필드의 값을 설정하려면 데이터 값, 이름 값을 사용하고 고객 또는 담당자 조회만 해당 필드의 유형 값을 지정합니다. 다음 샘플에서는 담당자 필드를 사용자 이름 “Mark Folkerts”로 설정합니다.

extraqs 매개 변수에 대해 인코딩되지 않은 값은 “ownerid={B8C6E040-656E-DF11-B414-00155DB1891A}&owneridname=Mark Folkerts&owneridtype=systemuser”입니다.

/main.aspx?etn=lead&pagetype=entityrecord&extraqs=ownerid%3D%7bB8C6E040-656E-DF11-B414-00155DB1891A%7d%26owneridname%3DMark%20Folkerts%26owneridtype%3Dsystemuser

다음 샘플은 “Yvonne McKay (sample)”라는 사용자에 대한 기본 연락처 필드를 설정합니다. extraqs 매개 변수의 인코딩되지 않은 값은 “primarycontactid={43b58571-eefa-e311-80c1-00155d2a68c4}&primarycontactidname=Yvonne McKay (sample)”입니다.

/main.aspx?etn=account&pagetype=entityrecord&extraqs=primarycontactid%3D%7B43b58571-eefa-e311-80c1-00155d2a68c4%7D%26primarycontactidname%3DYvonne%20McKay%20(sample)

참고

이와 같은 간단한 조회의 경우 유형 값을 설정할 필요가 없습니다.

예제: 날짜 필드의 값 설정

다음 샘플은 2011년 1월 31일까지의 새로운 기회에 대한 예상 종료 날짜 필드를 설정합니다.extraqs 매개 변수의 인코딩되지 않은 값은 “estimatedclosedate=01/31/11”입니다.

/main.aspx?etn=opportunity&extraqs=estimatedclosedate%3D01%2F31%2F11&pagetype=entityrecord

예제: 옵션 집합 필드의 값 설정

옵션 집합 필드의 값을 설정하려면 옵션에 대해 정수 값을 설정합니다. 다음 샘플에서는 역할 필드 값을 새 연락처 레코드의 “의사 결정자”로 설정합니다.

extraqs 매개 변수의 인코딩되지 않은 값은 accountrolecode=1”입니다.

/main.aspx?etn=contact&extraqs=accountrolecode%3D1&pagetype=entityrecord

예제: Xrm.Utility.openEntityForm을 사용하여 새 창 열기

다음 샘플에서는 다른 여러 필드에서 기본값을 설정하고 Xrm.Utility.openEntityForm 함수를 사용하는 방법을 보여 줍니다.window.open 메서드를 사용한 앞의 예제와 동일합니다.

function OpenNewContact() {
 var parameters = {};
 //Set the Parent Customer field value to “Contoso”.
 parameters["parentcustomerid"] = "2878282E-94D6-E111-9B1D-00155D9D700B";
 parameters["parentcustomeridname"] = "Contoso";
 parameters["parentcustomeridtype"] = "account";
 //Set the Address Type to “Primary”.
 parameters["address1_addresstypecode"] = "3";
 //Set text in the Description field.
 parameters["description"] = "Default values for this record were set programmatically.";
 //Set Do not allow E-mails to "Do Not Allow".
 parameters["donotemail"] = "1";

 // Open the window.
 Xrm.Utility.openEntityForm("contact", null, parameters);
}

예제: window.open을 사용하여 새 창 열기

다음 샘플에서는 여러 다른 필드에 기본값을 설정하고 encodeURIComponent를 사용하여 extraqs 매개 변수의 값을 인코딩하는 방법을 보여 줍니다.window.open 메서드를 사용할 경우 열려 있는 창의 기능을 제어할 수 있습니다.

function OpenNewContact() {
    //Set the Parent Customer field value to “Contoso”.
    var extraqs = "parentcustomerid={F01F3F6D-896E-DF11-B414-00155DB1891A}";
    extraqs += "&parentcustomeridname=Contoso";
    extraqs += "&parentcustomeridtype=account";
    //Set the Address Type to “Primary”.
    extraqs += "&address1_addresstypecode=3";
    //Set text in the Description field.
    extraqs += "&description=Default values for this record were set programatically.";
    //Set Do not allow E-mails to "Do Not Allow".
    extraqs += "&donotemail=1";
    //Set features for how the window will appear.
    var features = "location=no,menubar=no,status=no,toolbar=no";
    // Open the window.
    window.open("/main.aspx?etn=contact&pagetype=entityrecord&extraqs=" +
     encodeURIComponent(extraqs), "_blank", features, false);
}

참고 항목

URL로 양식, 보기, 대화 상자 및 보고서 열기
openEntityForm
사용자 지정 쿼리 문자열 매개 변수를 허용하도록 양식 구성

Microsoft Dynamics 365

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