웹 페이지(HTML) 웹 리소스

  • 아티클

 

게시 날짜: 2016년 11월

적용 대상: Dynamics CRM 2015

웹 페이지(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 CRM(오프라인 액세스 가능)의 사용자를 위해 다운로드되므로 사용자는 오프라인으로 작업하는 동안에도 웹 리소스 콘텐츠에 액세스할 수 있습니다.

HTML 웹 리소스에 매개 변수 전달

HTML 웹 리소스는 다음 표의 매개 변수만 허용할 수 있습니다.

매개 변수

이름

설명

typename

엔터티 이름

엔터티의 이름입니다.

type

엔터티 유형 코드

특정 조직에서 엔터티를 고유하게 식별하는 정수입니다.

id

개체 GUID

레코드를 나타내는 GUID입니다.

orgname

조직 이름

조직의 고유한 이름입니다.

userlcid

사용자 언어 코드

현재 사용자가 사용 중인 언어 코드 식별자입니다.

orglcid

조직 언어 코드

조직의 기본 언어를 표시하는 언어 코드 식별자입니다.

data

선택적 데이터 매개 변수

전달할 수 있는 선택적 값입니다.

formid

양식 Id

양식 ID를 나타내는 GUID입니다.

진입점

진입점

문자열 값. 이 매개 변수는 엔터티에 대한 사용자 지정 도움말로 열린 웹 리소스에 옵션 값으로 전달됩니다. 사용하도록 설정되면 사용자 지정 도움말 URL은 “form” 또는 “hierarchychart”의 값을 포함합니다.추가 정보:사용자 지정 도움말 콘텐츠 추가

pagemode

내부 전용입니다.

보안

내부 전용입니다.

tabSet

내부 전용입니다.

데이터 매개 변수에 둘 이상의 값을 전달하려면 매개 변수를 데이터 매개 변수의 값으로 인코딩한 후 HTML 웹 리소스에서 스크립트를 사용하는 여러 매개 변수를 디코딩하는 논리를 포함해야 합니다.샘플: 데이터 매개 변수를 통해 웹 리소스에 여러 값 전달 항목은 여러 매개 변수 값을 전달하여 소개하는 방식에 대해 설명합니다.

참고 항목

Microsoft Dynamics CRM 2015용 웹 리소스
액세스 가능한 웹 리소스 만들기
CSS 웹 리소스
스크립트(JScript) 웹 리소스
데이터(XML) 웹 리소스
이미지(JPG, PNG, GIF, ICO) 웹 리소스
Silverlight(XAP) 웹 리소스
스타일시트(XSL) 웹 리소스

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