웹 페이지(HTML) 웹 리소스
게시 날짜: 2017년 1월
적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
웹 페이지(HTML) 웹 리소스를 사용하여 클라이언트 확장에 대해 사용자 인터페이스 요소를 만듭니다.
이 항목의 내용
HTML 웹 리소스의 기능
HTML 웹 리소스의 제한
HTML 웹 리소스에 대한 텍스트 편집기 사용
관리형 솔루션에 대한 웹 리소스의 편집 방지
HTML 웹 리소스에서 다른 웹 리소스를 참조합니다.
HTML 웹 리소스에 매개 변수 전달
HTML 웹 리소스의 기능
HTML 웹 리소스는 사용자의 브라우저로 스트리밍되므로 사용자의 브라우저에 렌더링되는 모든 콘텐츠를 포함할 수 있습니다.
HTML 웹 리소스의 제한
HTML 웹 리소스에는 서버에서 실행해야 하는 코드가 포함될 수 없습니다.ASP.NET 페이지는 HTML 웹 리소스로 업로드할 수 없습니다.
HTML 웹 리소스는 쿼리 문자열 매개 변수의 제한된 수만 허용합니다.추가 정보:HTML 웹 리소스에 매개 변수 전달
HTML 웹 리소스에 대한 텍스트 편집기 사용
웹 리소스 양식에 제공되는 텍스트 편집기는 매우 간단한 HTML 편집에 사용됩니다. 더 복잡한 HTML 문서의 경우 외부 편집기의 코드를 편집하고 찾아보기 단추를 사용하여 파일의 콘텐츠를 업로드해야 합니다.
예를 들어 페이지의 콘텐츠를 렌더링하는 스크립트가 필요한 더 복잡한 HTML 페이지는 다음 샘플과 같이 시작합니다.
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title></title>
<script src="Script/Script.js" type="text/javascript"></script>
<link href="CSS/Styles.css" rel="stylesheet" type="text/css" />
</head>
<body onload="SDK.ImportWebResources.showData()">
<div id="results" />
</body>
</html>
문서가 텍스트 편집기에 열려서 저장된 후 HTML은 이렇게 변경됩니다.
<HTML><HEAD><TITLE></TITLE>
<META charset=utf-8></HEAD>
<BODY contentEditable=true onload=SDK.ImportWebResources.showData()>
<SCRIPT type=text/javascript src="Script/Script.js"></SCRIPT>
<LINK rel=stylesheet type=text/css href="CSS/Styles.css">
<DIV id=results></DIV></BODY></HTML>
관리형 솔루션에 대한 웹 리소스의 편집 방지
텍스트 편집기를 사용하여 변경되는 웹 리소스의 HTML에 대한 기능 때문에 관리되는 속성을 사용하여 복잡한 HTML 웹 리소스를 관리형 솔루션에 대해 사용자 지정할 수 없도록 설정하는 것이 좋습니다. 솔루션 창에서 웹 리소스를 볼 때 관리형 속성 대화 상자를 열어 사용자 지정 가능 속성을 false로 설정합니다.
HTML 웹 리소스에서 다른 웹 리소스를 참조합니다.
Microsoft Dynamics 365 밖에서 웹 리소스 파일 유형 중 하나를 사용하는 관련 파일 집합을 만들 수 있습니다. 상대 경로를 사용하고 웹 사이트의 폴더 구조를 반영하는 일관된 명명 규칙으로 각 웹 리소스를 가져오는 데 항상 주의를 기울일 경우 HTML 웹 리소스는 관련 CSS, XML, JScript, 이미지 및 웹 리소스로 가져온 Silverlight 파일에 대한 링크를 유지합니다.
예를 들어 다음 [폴더]/파일 구조를 사용하는 웹 응용 프로그램 프로젝트를 만들 경우
page.htm
[Styles]
- style.css
[Scripts]
- script.js
이러한 파일을 웹 리소스로 가져올 때 다음과 같은 방법으로 솔루션 게시자 사용자 지정 접두사가 "new"인 이름을 지정할 수 있습니다.
new_/page.htm
new_/Styles/style.css
new_/Scripts/script.js
이 패턴을 따르면 new_/page.htmHTML 웹 리소스는 다음 예제와 같이 상대 경로를 사용하는 가장 일반적인 방법으로 다른 파일을 참조할 수 있습니다.
<script src="Scripts/script.js" type="text/javascript"></script>
<link href="Styles/style.css" rel="stylesheet" type="text/css" />
솔루션 게시자 사용자 지정 접두사는 솔루션의 모든 웹 리소스에 대한 가상 루트 폴더가 됩니다. 사용자 짖어 접두사를 변경하면 HTML 웹 리소스 내의 상대 경로가 변경되지 않습니다.
참고
-
양식에 추가된 HTML 웹 리소스는 양식에 로드된 JavaScript 라이브러리에서 정의한 전역 개체를 사용할 수 없습니다.HTML 웹 리소스는 parent.Xrm.Page 또는 parent.Xrm.Utility을 사용하여 양식 내의 Xrm.Page 또는 Xrm.Utility 개체와 상호 작용할 수 있지만 양식 스크립트에 정의된 전역 개체는 상위 항목을 사용하여 액세스할 수 없습니다. 양식에서 로드한 스크립트에 종속되지 않도록 HTML 웹 리소스가 HTML 웹 리소스 내에서 필요한 라이브러리를 로드해야 합니다.
-
웹 리소스 간 코드에 포함된 참조는 솔루션 종속성으로 추적되지 않습니다.
웹 리소스도 Microsoft Office Outlook용 Microsoft Dynamics 365(오프라인 액세스 가능)의 사용자를 위해 다운로드되므로 사용자는 오프라인으로 작업하는 동안에도 웹 리소스 콘텐츠에 액세스할 수 있습니다.
HTML 웹 리소스에 매개 변수 전달
HTML 웹 리소스는 다음 표의 매개 변수만 허용할 수 있습니다.
매개 변수 |
이름 |
설명 |
|---|---|---|
typename |
엔터티 이름 |
엔터티의 이름입니다. |
type |
엔터티 유형 코드 |
특정 조직에서 엔터티를 고유하게 식별하는 정수입니다. |
id |
개체 GUID |
레코드를 나타내는 GUID입니다. |
orgname |
조직 이름 |
조직의 고유한 이름입니다. |
userlcid |
사용자 언어 코드 |
현재 사용자가 사용 중인 언어 코드 식별자입니다. |
orglcid |
조직 언어 코드 |
조직의 기본 언어를 표시하는 언어 코드 식별자입니다. |
data |
선택적 데이터 매개 변수 |
전달할 수 있는 선택적 값입니다. |
formid |
양식 Id |
양식 ID를 나타내는 GUID입니다. |
진입점 |
진입점 |
문자열 값. 이 매개 변수는 엔터티에 대한 사용자 지정 도움말로 열린 웹 리소스에 옵션 값으로 전달됩니다. 사용하도록 설정되면 사용자 지정 도움말 URL은 “form” 또는 “hierarchychart”의 값을 포함합니다.추가 정보:사용자 지정 도움말 콘텐츠 추가 |
pagemode |
내부 전용입니다. |
|
보안 |
내부 전용입니다. |
|
tabSet |
내부 전용입니다. |
데이터 매개 변수에 둘 이상의 값을 전달하려면 매개 변수를 데이터 매개 변수의 값으로 인코딩한 후 HTML 웹 리소스에서 스크립트를 사용하는 여러 매개 변수를 디코딩하는 논리를 포함해야 합니다.샘플: 데이터 매개 변수를 통해 웹 리소스에 여러 값 전달 항목은 여러 매개 변수 값을 전달하여 소개하는 방식에 대해 설명합니다.
참고 항목
Microsoft Dynamics 365용 웹 리소스
액세스 가능한 웹 리소스 만들기
CSS 웹 리소스
스크립트(JScript) 웹 리소스
데이터(XML) 웹 리소스
이미지(JPG, PNG, GIF, ICO) 웹 리소스
Silverlight(XAP) 웹 리소스
스타일시트(XSL) 웹 리소스
Microsoft Dynamics 365
© 2017 Microsoft. All rights reserved. 저작권 정보