URL로 양식, 보기, 대화 상자 및 보고서 열기
게시 날짜: 2017년 1월
적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
URL 주소를 지정할 수 있는 요소를 사용하면 다른 응용 프로그램의 Microsoft Dynamics 365 양식, 보기, 대화 상자 및 보고서에 대한 링크를 포함할 수 있습니다. 이런 방식으로 사용자가 응용 프로그램을 전환하지 않고도 정보를 보고 작업을 수행할 수 있도록 다른 응용 프로그램, 보고서 또는 웹 사이트를 쉽게 확장할 수 있습니다.
참고
-
URL 주소를 지정할 수 있는 양식, 보기, 대화 상자 및 보고서는 Microsoft Dynamics 365 보안을 건너뛸 수 없습니다. 보안 역할에 따라 사용이 허가된 Microsoft Dynamics 365 사용자만 표시되는 데이터 및 레코드에 액세스할 수 있습니다.
-
웹 리소스를 사용하여 응용 프로그램 내에서 엔터티 양식을 프로그래밍 방식으로 열 때 Xrm.Utility.openEntityForm를 사용합니다.window.open은 사용하지 마십시오.
-
응용 프로그램 외부에서 페이지에 Xrm.Utility.openEntityForm 함수에 대한 액세스가 없을 경우 window.open 또는 링크를 사용하여 엔터티에 대한 특정 레코드 또는 양식을 엽니다. 전체 응용 프로그램은 모든 업데이트된 엔터티에 대해 열립니다.
이 항목의 내용
URL 주소를 지정할 수 있는 양식 및 보기
Main.aspx 페이지에 대한 쿼리 문자열 매개 변수
보기의 URL 복사
사이트 맵을 사용하여 응용 프로그램 탐색에 보기를 표시합니다.
URL을 사용하여 대화 프로세스 시작
URL을 사용하여 보고서 열기
URL 주소를 지정할 수 있는 양식 및 보기
모든 엔터티 양식 및 보기는 main.aspx 페이지에 표시됩니다. 표시되는 이 페이지 컨트롤에 전달된 쿼리 문자열 매개 변수입니다. 예를 들면 다음과 같습니다.
온-프레미스 Microsoft Dynamics 365에 대해 새 거래처 엔터티 레코드 양식을 열려면:
http://mycrm/myOrg/main.aspx?etn=account&pagetype=entityrecordMicrosoft Dynamics 365(온라인)에 대해 거래처 엔터티 레코드 양식을 열려면(여기서 id는 {91330924-802A-4B0D-A900-34FD9D790829}):
http://myorg.crm.dynamics.com/main.aspx?etn=account&pagetype=entityrecord&id=%7B91330924-802A-4B0D-A900-34FD9D790829%7DMicrosoft Dynamics 365(온라인)에 대해 종료된 영업 기회 보기를 열려면:
http://myorg.crm.dynamics.com/main.aspx?etn=opportunity&pagetype=entitylist&viewid=%7b00000000-0000-0000-00AA-000010003006%7d&viewtype=1039탐색 모음 또는 명령 모음 없이 Microsoft Dynamics 365(온라인)에 대해 활성 연락처 보기를 열려면
http://myorg.crm.dynamics.com/main.aspx?etn=contact&pagetype=entitylist&viewid={00000000-0000-0000-00AA-000010001004}&viewtype=1039&navbar=off&cmdbar=false
참고
showModalDialog 또는 showModelessDialog를 사용하여 대화 상자 창에서 엔터티 양식을 열 수 없습니다.
다른 엔터티 양식에 포함된 IFrame 내에 엔터티 양식을 표시할 수 없습니다.
일반적으로 getClientUrl 메서드를 사용하여 온-프레미스 Microsoft Dynamics 365 및 Microsoft Dynamics 365(온라인)에 대해 조직 루트 URL을 검색합니다.
Main.aspx 페이지에 대한 쿼리 문자열 매개 변수
팁
레코드의 id 값을 가져오려면 명령 모음의 링크 보내기 단추를 사용합니다. 다음은 전자 메일 응용 프로그램에서 열 수는 항목의 예입니다.
<http://mycrm/myOrg/main.aspx?etc=4&id=%7b899D4FCF-F4D3-E011-9D26-00155DBA3819%7d&pagetype=entityrecord>.
URL에 전달된 id 매개 변수는 레코드에 대한 인코딩된 id 값입니다. 이 예에서 id 값은 {899D4FCF-F4D3-E011-9D26-00155DBA3819}입니다. GUID의 인코딩된 버전은 여는 괄호와 닫는 괄호 "{" 및 "}"를 "%7B" 및 "%7D"로 각각 대체합니다.
다음은 엔터티 양식 또는 보기를 열기 위해 main.aspx 페이지에 사용되는 쿼리 문자열 매개 변수입니다.
매개 변수 |
설명 |
|---|---|
etn |
엔터티의 논리적 이름입니다. 중요 엔터티의 정수 코드가 포함된 etc(엔터티 유형 코드) 매개 변수는 사용하지 않습니다. 이 정수 코드는 다른 조직의 사용자 지정 엔터티와 다를 수 있습니다. |
extraqs |
양식의 선택 사항입니다. 이 매개 변수에는 이 매개 변수 내에 인코딩된 매개 변수가 포함되어 있습니다. 이 매개 변수를 사용하여 값을 양식에 전달합니다. 자세한 내용은 양식에 전달된 매개 변수를 사용하여 필드 값 설정을 참조하십시오. 엔터티에 정의된 양식이 두 개 이상일 경우 이 매개 변수를 사용하면 양식의 ID 값과 동일한 값을 가진 인코딩된 매개 변수 formid를 전달하여 열 양식을 지정할 수 있습니다. 예를 들어 ID가 ‘6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf’인 양식을 열려면 extraqs 매개 변수에 formid%3D6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf%0D%0A 값을 포함하십시오. |
pagetype |
페이지의 유형입니다. 두 가지 가능한 값은 다음과 같습니다.
|
ID |
양식의 선택 사항입니다. 특정 엔터티 레코드를 열 때 사용합니다. 엔터티에 대해 인코딩된 GUID 식별자를 전달합니다. GUID의 인코딩된 버전은 여는 괄호와 닫는 괄호 "{" 및 "}"를 “%7B” 및 “%7D”로 각각 대체합니다. 예를 들어 {91330924-802A-4B0D-A900-34FD9D790829}는 %7B91330924-802A-4B0D-A900-34FD9D790829%7D입니다. |
viewid |
보기에 필요합니다. 보기를 정의하는 savedquery 또는 userquery 엔터티 레코드의 ID입니다. 보기의 URL을 가져오는 가장 쉬운 방법은 복사하는 것입니다. 자세한 내용은 보기의 URL 복사을 참조하십시오. |
viewtype |
보기 유형을 정의합니다. 가능한 값은 다음과 같습니다.
|
navbar |
사이트 맵에 정의된 영역 및 하위 영역을 사용하여 탐색 모음을 표시할지 여부와 응용 프로그램 탐색을 사용할 수 있는지 여부를 제어합니다.
|
cmdbar |
명령 모음을 표시할지 여부를 제어합니다. 참고 이 기능은 Unified Service Desk for Microsoft Dynamics 365 응용 프로그램의 요구 사항을 지원합니다.
|
보기의 URL 복사
Microsoft Dynamics 365의 여러 보기를 사용하면 사용자는 특정 보기의 URL을 복사하거나 메시지에 포함된 특정 보기의 URL로 전자 메일을 보낼 수 있습니다. 이 기능을 사용하면 사용자 간에 쉽게 연락할 수 있으며 SharePoint 사이트와 같이 사용자가 다른 응용 프로그램에 포함할 수 있는 보기의 URL에 대한 액세스를 가져올 수 있는 방법이 노출됩니다.
참고
사이트 맵을 사용하여 응용 프로그램 탐색에 보기를 포함하기 위해 이 URL을 사용하지 마십시오. 자세한 내용은 사이트 맵을 사용하여 응용 프로그램 탐색에 보기를 표시합니다.을 참조하십시오.
URL에 의해 표시되는 페이지에는 전체 보기가 포함됩니다. 리본은 포함되지만 응용 프로그램 탐색은 포함되지 않습니다.
보기의 URL 가져오기
사용할 보기를 엽니다.
명령 모음에서 링크 보내기를 클릭한 후 현재 보기를 클릭합니다.
링크를 메모장에 붙여넣고 편집하여 텍스트의 URL 부분만 추출합니다.
참고
-
내 거래처와 같은 사용자 컨텍스트를 매개 변수로 사용하는 보기는 복사할 수 없습니다.
-
시스템 엔터티에 대한 시스템 보기를 나타내는 GUID는 온-프레미스 Microsoft Dynamics 365 설치에 대해 동일합니다. 사용자 지정 엔터티 및 사용자 지정 보기에 대한 GUID는 각 Microsoft Dynamics 365 설치에 대해 고유합니다.
사이트 맵을 사용하여 응용 프로그램 탐색에 보기를 표시합니다.
사이트 맵을 사용하여 응용 프로그램 탐색을 사용자 지정할 경우 보기의 URL 복사의 단계를 통해 응용 프로그램에서 복사한 보기 URL을 사용하여 URL로 설정하지 마십시오. 해당 URL은 리본이 포함된 페이지를 표시하고 <SubArea> (SiteMap) Url 특성에 사용된 경우 원치 않은 결과가 나옵니다.
SubArea에 대해 응용 프로그램 내에 엔터티 레코드 목록을 표시하려면 Entity 특성 값을 설정합니다. 그러면 해당 엔터티에 대한 기본 보기를 표시하고 올바른 제목과 아이콘을 제공합니다.
하지만 특정 초기 기본 보기를 사용하는 SubArea 요소가 있을 경우 다음 Url 패턴을 사용합니다.
Url=“/_root/homepage.aspx?etn=<entity logical name >&viewid=%7b<GUID value of view id>%7d”
이 URL을 사용할 경우 <Titles> (SiteMap) 및 <Descriptions> (SiteMap)에 대해 적절한 값을 지정하고 엔터티에 대한 아이콘도 지정해야 합니다.
참고
/_root/homepage.aspx 페이지를 사용하여 보기를 지정하면 보기 선택이 계속 표시됩니다. 사용자가 보기를 변경하면 Microsoft Dynamics 365에서 사용자의 최신 선택을 기억하고 브라우저를 닫았다가 다시 열면 초기 기본 보기가 표시됩니다.
URL을 사용하여 대화 프로세스 시작
일반적인 사용자 지정을 사용하면 사용자가 특정 레코드의 컨텍스트에서 특정 대화 프로세스를 시작할 수 있습니다. 예를 들어 대화 프로세스에 대한 입력 매개 변수로 현재 레코드에 대한 id 값을 사용하여 특정 엔터티에 대한 리본에 사용자 지정 단추를 추가하려고 할 수 있습니다.
대화를 시작하려면 다음과 같은 작업을 수행해야 합니다.
대화의 고유 식별자입니다.
대화가 만들어지는 엔터티의 논리적 이름입니다.
대화를 실행할 레코드의 고유 식별자입니다.
팁
대화의 고유 식별자를 가져오려면 설정으로 이동하여 기본 솔루션에서 프로세스를 선택합니다. 프로세스를 선택한 다음 명령 모음의 작업 옵션에서 링크 복사를 클릭합니다. 그러면 대화를 편집할 링크를 클립보드에 복사합니다(예 [조직 url]/sfa/workflow/edit.aspx?id=%7b6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976%7d).
다음 샘플에서는 대화를 시작하는 URL 및 쿼리 문자열 매개 변수를 보여 줍니다.
[organization url]/cs/dialog/rundialog.aspx?DialogId=[dialog unique identifier]&EntityName=[entity logical name]&ObjectId=[unique identifier for the record]
예를 들어 id가 {6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976}이고 거래처 레코드 id가 {40C9ADFD-90A8-DF11-840E-00155DBA380F}인 대화를 시작하려면 다음 예제에서 URL을 사용합니다.
[organization url]/cs/dialog/rundialog.aspx?DialogId=%7b6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976%7d&EntityName=account&ObjectId=%7b40C9ADFD-90A8-DF11-840E-00155DBA380F%7d
팁
Internet Explorer 이외의 브라우저의 경우 대화 프로세스가 링크에서 시작되면 마침 단추가 작동하지 않을 수 있습니다. 데이터가 저장되지만 사용자가 창을 닫으려면 창에서 닫기 단추를 클릭해야 합니다. 다른 창에서 JavaScript를 사용하여 창을 열지 않은 경우 다른 브라우저에서는 window.close 메서드를 제공하지 않기 때문입니다. 단순히 링크를 제공하는 대신 가능한 경우 JavaScript 및 window.open 메서드를 사용하여 대화 프로세스를 시작하십시오.
다음 예와 같이 JavaScript 함수를 만들어 대화를 시작할 수도 있습니다.
function openDialogProcess(dialogId, entityName, objectId)
{
var url = Xrm.Page.context.getClientUrl() +
"/cs/dialog/rundialog.aspx?DialogId=" +
dialogId + "&EntityName=" +
entityName + "&ObjectId=" +
objectId;
window.open(url);
}
URL을 사용하여 보고서 열기
적절한 매개 변수 값을 [organization url]/crmreports/viewer/viewer.aspx URL로 전달하여 보고서를 열 수 있습니다.
이 URL은 다음 매개 변수를 허용합니다.
작업
이 매개 변수에 가능한 두 값은 run 또는 filter입니다.run을 사용하면 보고서가 기본 필터를 사용하여 표시됩니다.filter를 사용하면 보고서는 보고서 실행 단추를 선택하여 보고서를 표시하기 전에 사용자가 편집할 수 있는 필터를 표시합니다.helpID
이 매개 변수는 선택 사항입니다.Microsoft Dynamics 365에 포함된 보고서의 경우 이 매개 변수의 값을 사용하면 이 페이지에 대한 도움말이 선택된 경우 도움말 단추를 사용하여 이 보고서에 대한 적절한 내용을 표시할 수 있습니다. 값은 보고서 FileName 특성 값과 일치해야 합니다.ID
이 매개 변수는 보고서 ReportId 특성 값입니다.
다음 예제에서는 Microsoft Dynamics 365에서 보고서를 열 때 사용할 수 있는 URL을 보여 줍니다.
기본 필터를 사용하여 연락 중단 서비스 케이스 보고서를 엽니다.
[organization url]/crmreports/viewer/viewer.aspx?action=run&helpID=Neglected%20Cases.rdl&id=%7b8c9f3e6f-7839-e211-831e-00155db7d98f%7d최상위 참조 자료 문서 보고서를 열면 사용자에게 필터 값을 설정하라는 메시지를 표시합니다.
[organization url]/crmreports/viewer/viewer.aspx?action=filter&helpID=Top%20Knowledge%20Base%20Articles.rdl&id=%7bd84ec390-7839-e211-831e-00155db7d98f%7d
다음 함수는 URL의 값을 올바르게 인코딩하는 방법을 보여 줍니다.
function getReportURL(action,fileName,id) {
var orgUrl = GetGlobalContext().getClientUrl();
var reportUrl = orgUrl +
"/crmreports/viewer/viewer.aspx?action=" +
encodeURIComponent(action) +
"&helpID=" +
encodeURIComponent(fileName) +
"&id=%7b" +
encodeURIComponent(id) +
"%7d";
return reportUrl;
}
참고 항목
클라이언트에서 Microsoft Dynamics 365 확장
양식에 전달된 매개 변수를 사용하여 필드 값 설정
사용자 지정 쿼리 문자열 매개 변수를 허용하도록 양식 구성
사이트 맵을 사용하여 응용 프로그램 탐색 변경
명령 및 리본 사용자 지정
Microsoft Dynamics 365 양식용 코드 작성
Microsoft Dynamics 365용 웹 리소스
URL을 사용하여 대화 시작
Microsoft Dynamics 365
© 2017 Microsoft. All rights reserved. 저작권 정보