다음을 통해 공유


Microsoft Dynamics 365용 웹 리소스

 

게시 날짜: 2017년 1월

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

웹 리소스는 Microsoft Dynamics 365 데이터베이스에 저장되는 가상 파일이며 고유 URL 주소를 사용하여 검색할 수 있습니다.

이 항목의 내용

웹 리소스의 기능

웹 리소스 유형

웹 리소스 참조

웹 리소스의 기능

웹 리소스는 Microsoft Dynamics 365 웹 응용 프로그램을 확장하는 데 사용할 수 있는 html 파일, JavaScript 및 Silverlight 응용 프로그램과 같은 파일을 나타냅니다.URL 구문을 사용하여 참조할 수 있으므로 양식 사용자 지정,SiteMap 또는 응용 프로그램 리본에 웹 리소스를 사용할 수 있습니다.

웹 리소스의 URL 구문에는 상대 경로 참조를 사용할 수 있습니다. 개발 도구를 사용하여 웹 리소스와 호환되는 파일 유형을 사용하여 개발 서버에서 상호 의존적인 파일의 그룹을 만들 수 있습니다. 그런 다음 일관된 명명 규칙과 상대 경로 참조를 사용하면 모든 파일을 Microsoft Dynamics 365에 업로드한 후에 웹 사이트가 작동합니다.

웹 리소스는 Microsoft Dynamics 365에 저장되고 솔루션 구성 요소이므로 Microsoft Dynamics 365 또는 Microsoft Dynamics 365(온라인)에 쉽게 내보내고 설치할 수 있습니다. 웹 리소스는 사용자의 데이터와 동기화되므로 오프라인에서 Microsoft Office Outlook용 Microsoft Dynamics 365(오프라인 액세스 가능) 사용자가 사용할 수도 있습니다.

양식 편집기를 사용하여 양식 사용 웹 리소스를 엔터티 양식에 추가하고 구성할 수 있습니다.

웹 리소스는 데이터베이스에 레코드로 저장되므로 레코드 만들고, 검색 및 업데이트하는 표준 기술을 사용하여 프로그래밍 방식으로 관리할 수 있습니다. 텍스트 기반 웹 리소스(JScript, CSS, XML, XSL, and HTML)는 응용 프로그램에 편집하고 저장할 수 있습니다.

웹 리소스의 제한

서버에서 코드를 실행하는 ASP.NET(.aspx) 페이지의 기능을 지원하는 웹 리소스 유형은 없습니다. 웹 리소스는 정적 파일이나 브라우저에서 처리되는 파일로 제한됩니다. 웹 리소스는 Microsoft Dynamics 365 데이터와 상호 작용하기 위해 웹 서비스 호출을 실행하는 브라우저에서 처리되는 코드를 포함할 수 있습니다. 자세한 내용은 웹 리소스를 사용하여 Dynamics 365 데이터 작업를 참조하십시오.

웹 리소스는 Microsoft Dynamics 365 웹 응용 프로그램 보안 컨텍스트를 사용해야만 사용할 수 있습니다. 필요한 권한이 있는 사용이 허가된 Microsoft Dynamics 365 사용자만 액세스할 수 있습니다.

크기 제한

업로드할 수 있는 최대 파일 크기는 Organization.MaxUploadFileSize 속성에서 결정됩니다. Dynamics 365 응용 프로그램의 시스템 설정에 있는 전자 메일 탭에서 이 속성을 설정합니다. 이 설정은 전자 메일 메시지, 메모 및 웹 리소스에 첨부할 수 있는 파일의 크기를 제한합니다. 기본 설정은 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 365(온라인)에 대한 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 365(온라인) 또는 온-프레미스 Microsoft Dynamics 365에서 작업해야 하는 웹 리소스를 참조하는 코드를 작성할 경우 getClientUrl 함수를 사용해야 합니다.

참고 항목

클라이언트에서 Microsoft Dynamics 365 확장
Microsoft Dynamics 365용 JavaScript 라이브러리
액세스 가능한 웹 리소스 만들기
웹 페이지(HTML) 웹 리소스
Silverlight(XAP) 웹 리소스
스크립트(JScript) 웹 리소스
이미지(JPG, PNG, GIF, ICO) 웹 리소스
스타일시트(XSL) 웹 리소스
데이터(XML) 웹 리소스
CSS 웹 리소스
WebResource 엔터티 메시지 및 메서드
샘플: 데이터 매개 변수를 통해 웹 리소스에 여러 값 전달
샘플: 웹 리소스 유틸리티
샘플: 웹 리소스로 파일 가져오기
웹 리소스를 사용하여 Dynamics 365 데이터 작업

Microsoft Dynamics 365

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