分享方式:


網頁 (HTML) Web 資源

 

發佈日期: 2016年11月

適用對象: Dynamics CRM 2015

使用網頁 (HTML) Web 資源,建立用戶端擴充功能的使用者介面元素。

本主題內容

HTML Web 資源的功能

HTML Web 資源的限制

為 HTML Web 資源使用文字編輯器

避免編輯受管理的解決方案的 Web 資源

從 HTML Web 資源參照其他 Web 資源

將參數傳遞至 HTML Web 資源

HTML Web 資源的功能

由於 HTML Web 資源只是串流至使用者的瀏覽器,可能包括在使用者的瀏覽器呈現的任何內容。

HTML Web 資源的限制

  • HTML Web 資源不可包含任何必須在伺服器上執行的程式碼。ASP.NET 頁面無法上傳為 HTML Web 資源。

  • HTML Web 資源只能接受有限數目的查詢字串參數。其他資訊:將參數傳遞至 HTML Web 資源

為 HTML Web 資源使用文字編輯器

在 Web 資源表單提供的文字編輯器只能用於非常簡單的 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>

避免編輯受管理的解決方案的 Web 資源

因為 Web 資源中 HTML 功能會透過使用文字編輯器變更,建議您使用受管理屬性將複雜 HTML Web 資源設定為不可針對受管理解決方案自訂的。 在解決方案視窗中檢視 Web 資源時,開啟 [受管理的屬性] 對話方塊,將 [可自訂的] 屬性設定為 false

從 HTML Web 資源參照其他 Web 資源

您可以在 Microsoft Dynamics 365 外建立一組使用任何 Web 資源檔案類型的相關檔案。 如果您永遠使用相對路徑和匯入一致命名慣例且反映網站資料夾結構的每個 Web 資源,您會發現 HTML Web 資源會維護相關 CSS, XML, JScript、影像和匯入為 Web 資源的 Silverlight 檔案的連結。

例如,如果建立使用下列 [資料夾]/檔案結構的 Web 應用程式專案:

  • page.htm

  • [Styles]

    • style.css
  • [Scripts]

    • script.js

當您將這些檔案匯入為 Web 資源時,若您的解決方案發行者自訂首碼為「new」,以下列方式命名:

  • new_/page.htm

  • new_/Styles/style.css

  • new_/Scripts/script.js

當您遵循此模式時,您的 new_/page.htmHTML Web 資源可使用相對路徑最常見的方式來參照其他檔案,如下列範例所示。

<script src="Scripts/script.js" type="text/javascript"></script>
<link href="Styles/style.css" rel="stylesheet" type="text/css" />

解決方案發行者自訂首碼成為解決方案中所有 Web 資源的虛擬根資料夾。 如果您變更自訂首碼,在 HTML Web 資源中的相對路徑不會變更。

備註

  • 已新增至表單的 HTML Web 資源無法使用表單中載入之 JavaScript 程式庫所定義的全域物件。HTML Web 資源可能會使用 parent.Xrm.Pageparent.Xrm.Utility,與表單內的 Xrm.PageXrm.Utility 物件互動,但是無法使用上層存取表單指令碼所定義的全域物件。 您必須在 HTML Web 資源中載入 HTML Web 資源所需的任何程式庫,因此這些程式庫不相依於表單中載入的指令碼。

  • 包含在程式碼中 Web 資源之間的參照不會做為解決方案相依性追蹤。

由於 Microsoft Dynamics CRM for Microsoft Office Outlook with Offline Access 使用者也下載 Web 資源,使用者離線時會存取 Web 資源內容。

將參數傳遞至 HTML Web 資源

HTML Web 資源只接受下表中的參數。

參數

名稱

描述

typename

實體名稱

實體的名稱。

type

實體類型代碼

整數,唯一識別特定組織的實體。

id

物件 GUID

代表記錄的 GUID。

orgname

組織名稱

組織唯一名稱。

userlcid

使用者語言碼

目前使用者使用的語言識別代碼。

orglcid

組織語言碼

語言識別代碼,代表組織的基礎語言。

data

選擇性資料參數

可傳遞的選擇性值。

formid

表單識別碼

代表表單識別碼的 GUID。

entrypoint

進入點

字串值。 此參數是用來做為選擇性值傳遞至開啟的 Web 資源,以做為實體的自訂說明內容方式。 啟用時,自訂說明 URL 將會包含 "form" 或 "hierarchychart" 的值。其他資訊:新增自訂說明內容

pagemode

僅供內部使用。

安全性

僅供內部使用。

tabSet

僅供內部使用。

若要在資料參數中傳遞多個值,您必須以資料參數值編碼參數,然後包含邏輯,在 HTML Web 資源中使用指令碼解碼多個參數。範例:透過資料參數傳遞多個值到一個 Web 資源中 主題示範一個解決傳遞多個參數值的方法。

另請參閱

Microsoft Dynamics CRM 2015 的 Web 資源
建立可存取的 Web 資源
CSS Web 資源
指令碼 (JScript) Web 資源
資料 (XML) Web 資源
影像 (JPG、PNG、GIF、ICO) Web 資源
Silverlight (XAP) Web 資源
樣式表 (XSL) Web 資源

© 2017 Microsoft. 著作權所有,並保留一切權利。 著作權