Microsoft Dynamics 365 的 Web 資源
發行︰ 2017年1月
適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online
Web 資源就是儲存在 Microsoft Dynamics 365 資料庫中而且可以使用唯一 URL 位址擷取的「虛擬檔案」(Virtual File)。
本主題內容
Web 資源的功能
Web 資源類型
參考 Web 資源
Web 資源的功能
Web 資源代表可用來擴充 Microsoft Dynamics 365 Web 應用程式的檔案，例如 html 檔案、JavaScript 和 Silverlight 應用程式。 您可以使用表單自訂、SiteMap 或應用程式功能區中的 Web 資源，因為它們可以使用 URL 語法參考。
Web 資源的 URL 語法允許相對路徑參考。 透過開發工具，您就可以使用與 Web 資源相容的檔案類型在開發伺服器上建立一組彼此相依的檔案。 然後，如果您使用一致的命名慣例和相對路徑參考，則在您上傳所有檔案至 Microsoft Dynamics 365 之後，網站將會運作。
由於 Web 資源儲存在 Microsoft Dynamics 365 而且為解決方案元件，因此可輕鬆匯出並安裝到 Microsoft Dynamics 365 的內部部署的部署和 Microsoft Dynamics 365 (線上) 中。 Web 資源也可供 Microsoft Dynamics 365 for Microsoft Office Outlook with Offline Access 的使用者離線使用，因為這些資源會與使用者的資料同步。
您可以使用表單編輯器新增啟用表單功能的 Web 資源至實體表單中並進行設定。
由於 Web 資源會儲存為資料庫中的記錄，因此可以透過程式設計的方式管理，使用標準技術建立、擷取及更新記錄。 文字為主的 Web 資源 (JScript, CSS, XML, XSL, and HTML) 可以編輯並儲存在應用程式中。
Web 資源的限制
沒有任何一種類型的 Web 資源支援 ASP.NET(.aspx) 頁面的功能在伺服器上執行程式碼。 Web 資源限於靜態檔案或瀏覽器中處理的檔案。 Web 資源可以包含瀏覽器中處理的程式碼來執行 Web 服務呼叫，以便與 Microsoft Dynamics 365 資料互動。 如需詳細資訊，請參閱使用 Web 資源處理 Dynamics 365 資料。
Web 資源只能使用 Microsoft Dynamics 365 Web 應用程式安全性內容提供。 只有具有必要權限的授權 Microsoft Dynamics 365 使用者才能存取它們。
大小限制
可上傳的檔案大小上限是由 Organization.MaxUploadFileSize 屬性所決定。 此屬性是在 Dynamics 365 應用程式中 [系統設定] 的 [電子郵件] 索引標籤上進行設定。 此設定限制可附加至電子郵件訊息、附註和 Web 資源的檔案大小。 預設設定是 5 MB。
Web 資源類型
您可以使用十種檔案格式建立 Web 資源。 下表列出每一種檔案格式、允許的副檔名，以及針對每一個使用的類型值。
檔案 |
副檔名 |
類型 |
|---|---|---|
網頁 (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 |
參考 Web 資源
有數種方法可用來參考 Web 資源。
注意
-
但請盡可能使用 $webresource 指示詞。 只有在網站地圖或功能區命令中使用 $webresource 指示詞的參考才會建立相依性。 當 Web 資源互相參考時，不會建立相依性。
-
若要在實體表單或圖表外部顯示 Silverlight Web 資源，請建立 HTML Web 資源以做為 Silverlight Web 資源的主機頁面。 然後使用 $webresource: 指示詞來開啟 HTML Web 資源。
$webresource 指示詞
從功能區控制項或 SiteMap 子區域參考 Web 資源時，您應一律使用 $webresource 指示詞。 在 XML 允許 URL 值的任何位置使用 $webresource 指示詞。 下列範例將示範如何使用它。
$webresource:<name of Web Resource>
注意
使用 $webresource 指示詞時，Microsoft Dynamics 365 將建立或更新解決方案相依性。
Xrm.Utility.openWebResource
Xrm.Utility.openWebResource 函式將在新視窗中開啟 HTML Web 資源，並包含傳遞 Web 資源名稱的參數、任何要在資料參數中傳遞的任何查詢字串資料，以及有關視窗高度與寬度的資訊。
產生的 URL 包含唯一的 GUID Token，以便載入快取的 Web 資源。
相對 URL
使用 $webresource: 指示詞從不支援的區域參考 Web 資源時，可以使用相對 URL。 若要啟用此功能，建議您針對 Web 資源使用可反映虛擬檔案結構的一致命名慣例。 解決方案發行者自訂首碼將一律加入做為 Web 資源名稱的首碼。 這可以代表該發行者新增的所有 Web 資源的虛擬「根」資料夾。 然後您可以使用正斜線字元 (/) 模擬 Web 伺服器授權的資料夾結構。
若是從其他 Web 資源，您應該一律使用相對 URLs 彼此參考。 例如，若要讓網頁 Web 資源 new_/content/contentpage.htm 參考 CSS Web 資源 new_/Styles/styles.css，請建立連結，如下所示：
<link rel="stylesheet" type="text/css" href="../styles/styles.css" />
若要讓網頁 Web 資源 new_/content/contentpage.htm 開啟網頁 Web 資源 isv_/foldername/dialogpage.htm，請建立連結，如下所示：
<a href="../../isv_/foldername/dialogpage.htm">Dialog Page</a>
注意
請不要使用相對 URL，它會使用 WebResources 資料夾做為 URL 的根路徑。 例如，請不要使用此路徑：/WebResources/<name of web resource>。 當使用者屬於伺服器上的多個組織時，此路徑一律參考使用者預設組織。 如果使用者不使用其預設組織，而且預期的 Web 資源未包含在使用者的預設組織內，則會發生「找不到檔案」錯誤，即使 Web 資源確實發生在使用者目前工作所在的組織中。
完整 URL
下列範例示範您可用來檢視 Web 資源的 URL 樣式。
<Microsoft CRM URL>/WebResources/<name of web resource>
應用程式將處理此 URL，並傳回包含最新版 Web 資源的檔案。 此 URL 如下所示：
<Microsoft CRM URL>/%7B<GUID value>%7D/WebResources/<name of web resource>
GUID 值會在您發行自訂時更新，並確保瀏覽器使用最新的快取版 Web 資源。 基於這個理由，請使用 Web 資源的相對路徑、Xrm.Utility.openWebResource 函式或 $webresource 指示詞 (盡可能)，因為 GUID 值將會自動包含。 若是大型 Web 資源，像是 Silverlight Web 資源，如果您不使用檔案的快取版本，則可能會大幅影響效能。
下列範例示範 Microsoft Dynamics 365 (線上) 的 URL，其中 MyOrganization 是組織的名稱，而 new_/test/test.htm 是 Web 資源的名稱：
https://MyOrganization.crm.dynamics.com/WebResources/new_/test/test.htm
注意
在 Web 資源的名稱中包含 '/' 字元與副檔名，是選擇性的最佳做法。
下列範例將示範內部部署 Microsoft Dynamics 365 的 URL，其中 myServer 是伺服器名稱：
http://myServer/MyOrganization/WebResources/new_/test/test.htm
當您撰寫程式碼來參考 Microsoft Dynamics 365 (線上) 或內部部署 Microsoft Dynamics 365 將會需要的 Web 資源時，您應使用 getClientUrl 函式。
另請參閱
在用戶端上擴充 Microsoft Dynamics 365
Microsoft Dynamics 365 適用的 JavaScript 程式庫
建立可存取的 Web 資源
網頁 (HTML) Web 資源
Silverlight (XAP) Web 資源
指令碼 (JScript) Web 資源
影像 (JPG、PNG、GIF、ICO) Web 資源
樣式表 (XSL) Web 資源
資料 (XML) Web 資源
CSS Web 資源
WebResource 實體訊息和方法
範例：透過資料參數傳遞多個值到一個 Web 資源中
範例：Web 資源公用程式
範例：匯入檔案為 Web 資源
使用 Web 資源處理 Dynamics 365 資料
Microsoft Dynamics 365
© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權