Microsoft Dynamics CRM 2015용 웹 리소스
게시 날짜: 2016년 11월
적용 대상: Dynamics CRM 2015
웹 리소스는 Microsoft Dynamics 365 데이터베이스에 저장되는 가상 파일이며 고유 URL 주소를 사용하여 검색할 수 있습니다.
이 항목의 내용
웹 리소스의 기능
웹 리소스 유형
웹 리소스 참조
웹 리소스의 기능
웹 리소스는 Microsoft Dynamics 365 웹 응용 프로그램을 확장하는 데 사용할 수 있는 html 파일, JScript 및 Silverlight 응용 프로그램과 같은 파일을 나타냅니다.URL 구문을 사용하여 참조할 수 있으므로 양식 사용자 지정,SiteMap 또는 응용 프로그램 리본에 웹 리소스를 사용할 수 있습니다.
웹 리소스의 URL 구문에는 상대 경로 참조를 사용할 수 있습니다. 개발 도구를 사용하여 웹 리소스와 호환되는 파일 유형을 사용하여 개발 서버에서 상호 의존적인 파일의 그룹을 만들 수 있습니다. 그런 다음 일관된 명명 규칙과 상대 경로 참조를 사용하면 모든 파일을 Microsoft Dynamics 365에 업로드한 후에 웹 사이트가 작동합니다.
웹 리소스는 Microsoft Dynamics 365에 저장되고 솔루션 구성 요소이므로 Microsoft Dynamics 365 또는 Microsoft Dynamics CRM Online에 쉽게 내보내고 설치할 수 있습니다. 웹 리소스는 사용자의 데이터와 동기화되므로 오프라인에서 Microsoft Office Outlook용 Microsoft Dynamics CRM(오프라인 액세스 가능) 사용자가 사용할 수도 있습니다.
양식 편집기를 사용하여 양식 사용 웹 리소스를 엔터티 양식에 추가하고 구성할 수 있습니다.
웹 리소스는 데이터베이스에 레코드로 저장되므로 레코드 만들고, 검색 및 업데이트하는 표준 기술을 사용하여 프로그래밍 방식으로 관리할 수 있습니다. 텍스트 기반 웹 리소스(JScript, CSS, XML, XSL, and HTML)는 응용 프로그램에 편집하고 저장할 수 있습니다.
웹 리소스의 제한
서버에서 코드를 실행하는 ASP.NET(.aspx) 페이지의 기능을 지원하는 웹 리소스 유형은 없습니다. 웹 리소스는 정적 파일이나 브라우저에서 처리되는 파일로 제한됩니다. 웹 리소스는 Microsoft Dynamics 365 데이터와 상호 작용하기 위해 웹 서비스 호출을 실행하는 브라우저에서 처리되는 코드를 포함할 수 있습니다. 자세한 내용은 웹 리소스에서 웹 서비스 데이터 사용(OData 및 최신 앱 SOAP 끝점)를 참조하십시오.
웹 리소스는 Microsoft Dynamics 365 웹 응용 프로그램 보안 컨텍스트를 사용해야만 사용할 수 있습니다. 필요한 권한이 있는 사용이 허가된 Microsoft Dynamics 365 사용자만 액세스할 수 있습니다.
크기 제한
업로드할 수 있는 최대 파일 크기는 Organization.MaxUploadFileSize 속성에서 결정됩니다. CRM 응용 프로그램의 시스템 설정에 있는 전자 메일 탭에서 이 속성을 설정합니다. 이 설정은 전자 메일 메시지, 메모 및 웹 리소스에 첨부할 수 있는 파일의 크기를 제한합니다. 기본 설정은 5MB입니다.
웹 리소스 유형
웹 리소스를 만들기 위해 10가지 파일 형식을 사용할 수 있습니다. 다음 표에는 각 파일 형식, 허용되는 파일 확장명 및 각각에 대해 사용하는 유형 값이 나와 있습니다.
파일 |
파일 확장명 |
유형 |
|---|---|---|
웹 페이지(HTML) |
.htm, .html |
1 |
스타일시트(CSS) |
.css |
2 |
스크립트(JScript) |
.js |
3 |
데이터(XML) |
.xml |
4 |
이미지(PNG) |
.png |
5 |
이미지(JPG) |
.jpg |
6 |
이미지(GIF) |
.gif |
7 |
Silverlight (XAP) |
.xap |
8 |
스타일시트(XSL) |
.xsl, .xslt |
9 |
이미지(ICO) |
.ico |
10 |
웹 리소스 참조
웹 리소스를 참조하는 데 사용할 수 있는 방법은 여러 가지 있습니다.
참고
-
가능하면 $webresource 지시문을 사용합니다. 사이트 맵 또는 리본 명령에서 $webresource 지시문을 사용하는 참조만 종속성을 설정합니다. 서로 웹 리소스를 참조하는 경우 종속성은 만들어지지 않습니다.
-
엔터티 양식 또는 차트 외부에 Silverlight 웹 리소스를 표시하려면 Silverlight 웹 리소스의 호스트 페이지로 사용할 HTML 웹 리소스를 만듭니다. 그런 다음 $webresource: 지시문을 사용하여 HTML 웹 리소스를 엽니다.
$webresource 지시문
리본 컨트롤 또는 SiteMap 하위 영역에서 웹 리소스를 참조하거나 항상 $webresource 지시문을 사용해야 합니다. XML에서 URL 값을 허용하는 $webresource 지시문을 사용합니다. 다음 샘플에서는 지시문을 사용하는 방법을 줍니다.
$webresource:<name of Web Resource>
참고
$webresource 지시문을 사용할 때 Microsoft Dynamics 365은 솔루션 종속성을 만들거나 업데이트합니다.
Xrm.Utility.openWebResource
Xrm.Utility.openWebResource 함수는 HTML 웹 리소스를 웹 리소스의 이름을 전달하는 매개 변수, 데이터 매개 변수에 전달되는 쿼리 문자열 데이터, 창의 높이 및 너비 정보를 사용하여 새 창에서 엽니다.
생성된 URL에는 캐시된 웹 리소스가 로드되도록 고유한 GUID 토큰이 포함됩니다.
상대 URL
$webresource: 지시문을 사용하여 지원되지 않는 영역에서 웹 리소스를 참조할 경우 상대 URL이 사용될 수 있습니다. 이를 활성화하려면 가상 파일 구조를 반영하는 웹 리소스에 대해 일관된 명명 규칙을 사용하는 것이 좋습니다. 솔루션 게시자의 사용자 지정 접두사는 항상 웹 리소스의 이름에 접두사로 포함됩니다. 해당 게시자가 추가한 모든 웹 리소스에 대한 가상 "루트" 폴더를 나타낼 수 있습니다. 그런 다음 슬래시 문자(/)를 사용하여 웹 서버에서 적용되는 폴더 구조를 시뮬레이션할 수 있습니다.
다른 웹 리소스에서 상대 URLs을 사용하여 서로 참조해야 합니다. 예를 들어 CSS 웹 리소스 new_/Styles/styles.css를 참조하는 웹 페이지 웹 리소스 new_/content/contentpage.htm의 경우 다음과 같이 링크를 만듭니다.
<link rel="stylesheet" type="text/css" href="../styles/styles.css" />
예를 들어 웹 페이지 웹 리소스 isv_/foldername/dialogpage.htm를 여는 웹 페이지 웹 리소스 new_/content/contentpage.htm의 경우 다음과 같이 링크를 만듭니다.
<a href="../../isv_/foldername/dialogpage.htm">Dialog Page</a>
참고
WebResources를 사용하여 상대 URL을 URL에 대한 루트 경로로 사용하지 마십시오. 예를 들어 /WebResources/<name of web resource>를 사용하지 마십시오. 사용자가 서버에서 둘 이상의 조직에 속할 경우 이 경로는 항상 사용자의 기본 조직을 참조합니다. 사용자가 기본 조직을 사용하지 않고 예상 웹 리소스가 사용자의 기본 조직에 포함되어 있지 않을 경우 사용자가 현재 작업 중인 조직에 웹 리소스가 있어도 “파일을 찾을 수 없음” 오류가 발생합니다.
전체 URL
다음 샘플은 웹 리소스를 보는 데 사용할 수 있는 URL의 스타일을 보여 줍니다.
<Microsoft CRM URL>/WebResources/<name of web resource>
응용 프로그램은 이 URL을 처리하고 웹 리소스의 최신 버전이 포함된 파일을 반환합니다. 이 URL은 다음과 같습니다.
<Microsoft CRM URL>/%7B<GUID value>%7D/WebResources/<name of web resource>
사용자 지정 항목을 게시하고 브라우저에서 웹 리소스의 최신 캐시된 버전을 사용하고 있을 경우 GUID 값이 업데이트됩니다. 따라서 GUID 값이 자동으로 포함되므로 웹 리소스에 대한 상대 경로, Xrm.Utility.openWebResource 함수 또는 $webresource 지시문를 사용합니다.Silverlight 웹 리소스처럼 웹 리소스가 클 경우 캐시된 버전을 파일을 사용하지 않으면 성능에 상당한 영향을 미칠 수 있습니다.
다음 샘플에서는 Microsoft Dynamics CRM Online에 대한 URL을 보여 줍니다. 여기서 MyOrganization은 조직의 이름이고, new_/test/test.htm은 웹 리소스의 이름입니다.
https://MyOrganization.crm.dynamics.com/WebResources/new_/test/test.htm
참고
웹 리소스의 이름에 ‘/’ 문자와 파일 확장명을 포함하는 것은 선택적인 최상의 방법입니다.
다음 샘플에서는 온-프레미스 Microsoft Dynamics 365에 대한 URL을 보여 줍니다. 여기서 myServer는 서버 이름입니다.
http://myServer/MyOrganization/WebResources/new_/test/test.htm
Microsoft Dynamics CRM Online 또는 온-프레미스 Microsoft Dynamics 365에서 작업해야 하는 웹 리소스를 참조하는 코드를 작성할 경우 d7d0b052-abca-4f81-9b86-0b9dc5e62a66#BKMK_getClientUrl 함수를 사용해야 합니다.
참고 항목
클라이언트 응용 프로그램 확장 작성
Microsoft Dynamics CRM 2015용 JavaScript 라이브러리
액세스 가능한 웹 리소스 만들기
웹 페이지(HTML) 웹 리소스
Silverlight(XAP) 웹 리소스
스크립트(JScript) 웹 리소스
이미지(JPG, PNG, GIF, ICO) 웹 리소스
스타일시트(XSL) 웹 리소스
데이터(XML) 웹 리소스
CSS 웹 리소스
WebResource 엔터티 메시지 및 메서드
샘플: 데이터 매개 변수를 통해 웹 리소스에 여러 값 전달
샘플: 웹 리소스 유틸리티
샘플: 웹 리소스로 파일 가져오기
웹 리소스에서 웹 서비스 데이터 사용(OData 및 최신 앱 SOAP 끝점)
© 2017 Microsoft. All rights reserved. 저작권 정보