리본을 사용하여 URL에 매개 변수 전달
게시 날짜: 2017년 1월
적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
리본 동작은 <CommandDefinition> (RibbonDiffXml) 요소의 <Actions> (RibbonDiffXml) 요소에 정의되어 있습니다. 리본을 사용하여 상황별 Microsoft Dynamics 365 정보를 쿼리 문자열 매개 변수로 URL에 전달하는 방법이 여러 가지 있습니다.
<Url> (RibbonDiffXml) 요소를 사용합니다.Url 요소 안에서 PassParams 특성을 사용합니다.
<Url> (RibbonDiffXml) 요소를 <CrmParameter> (RibbonDiffXml) 요소와 함께 사용합니다.Url 요소에서 사용한 경우 이름 특성 값을 설정해야 합니다.
<JavaScriptFunction> (RibbonDiffXml) 요소를 <CrmParameter> (RibbonDiffXml) 요소와 함께 사용합니다.
PassParams 특성을 사용하여 동적 값을 설정합니다.
PassParams 특성을 사용하여 대상 URL에 매개 변수를 전달하면 레코드 또는 사용자의 컨텍스트에 대해 대상 응용 프로그램에 대한 정보를 제공합니다. 리본 컨트롤이 PassParams 특성을 사용하여 구성되어 있으면 모든 매개 변수가 전달됩니다. 다음 표에는 전달되는 매개 변수가 나와 있습니다.
매개 변수 |
이름 |
설명 |
|---|---|---|
typename |
엔터티 이름 |
엔터티의 이름입니다. 사용자 지정 엔터티의 경우 여기에는 새 entityname과 같은 사용자 지정 접두사가 포함됩니다. |
type |
엔터티 유형 코드 |
현재 조직에서 엔터티를 고유하게 식별하는 정수입니다. 참고 Entity Type Code 값은 조직에서 인터티가 작성되는 순서에 따라 결정됩니다. 사용자 지정 엔티티에 대한 Entity Type Codes은 다른 조직에서는 보통 다릅니다. |
id |
개체 GUID |
레코드를 나타내는 GUID(전역 고유 식별자)입니다. |
orgname |
조직 이름 |
조직의 고유한 이름입니다. |
userlcid |
사용자 언어 코드 |
현재 사용자가 사용하는 언어 코드 식별자입니다. |
orglcid |
조직 언어 코드 |
조직의 기본 언어를 표시하는 언어 코드 식별자입니다. |
언어 코드는 4-5자리 로캘 ID입니다. 유효한 로캘 ID 값은 LCID(로캘 ID) 차트에서 확인할 수 있습니다.
참고
엔터티 유형 코드는 Microsoft Dynamics 365 설치 간에 다를 수 있을 수 있으므로 엔터티 유형 코드 대신 엔터티 이름을 사용하는 것이 좋습니다.
예제
다음 샘플에서는 매개 변수 없는 URL을 보여 줍니다.
http://myserver/mypage.aspx
다음 샘플에서는 ‘AdventureWorksCycle’이라는 조직에 대해 리본 컨트롤이 거래처 엔터티에 대해 표시될 때 포함되는 매개 변수를 보여 줍니다. 사용자의 언어와 조직 기본 언어는 영어이고 거래처 레코드의 GUID는 DBD5DBFB-0666-DC11-A5D9-0003FF9CE217입니다.
http://myserver/mypage.aspx?orgname=AdventureWorksCycle&userlcid=1033&orglcid=1033&type=1&typename=account&id=%7BDBD5DBFB-0666-DC11-A5D9-0003FF9CE217%7D
URL에 Querystring 매개 변수 사용
URL 특성에 querystring 매개 변수를 포함할 수 있습니다. 특정 Microsoft Dynamics 365 레코드를 열거나 URL로 양식, 보기, 대화 상자 및 보고서 열기를 사용하여 볼 경우 매우 유용합니다.
참고
URL에서 여러 querystring 매개 변수를 구분하는 데 사용되는 URL에 앰퍼샌드(&) 문자가 포함되어 있을 경우 리본을 가져올 수 없습니다. 이 문자는 XML을 잘못된 것으로 표시합니다. URL 특성 값에서 "&"로 앰퍼샌드 문자를 이스케이프해야 합니다.
전달된 매개 변수 읽기
전달된 매개 변수는 보통 HttpRequest.QueryString 속성을 사용하여 대상 .aspx 페이지에서 읽습니다.추가 정보:HttpRequest.QueryString 속성
참고
URL의 대상이 웹 리소스인 경우 HTML 웹 리소스에 매개 변수 전달 항목에서 식별된 매개 변수만 허용할 수 있습니다. 사용자 지정 값을 전달하는 유일한 기회는 data 매개 변수 안에 포함하는 것입니다. 단일 매개 변수에 여러 값을 포함하려면 일부 특수 처리가 필요합니다.추가 정보:샘플: 데이터 매개 변수를 통해 웹 리소스에 여러 값 전달
참고 항목
명령 및 리본 사용자 지정
URL로 양식, 보기, 대화 상자 및 보고서 열기
<Url> (RibbonDiffXml)
리본 탭 표시 규칙 정의
샘플: 리본 정의 내보내기
Microsoft Dynamics 365
© 2017 Microsoft. All rights reserved. 저작권 정보