Sumber daya web untuk Customer Engagement

Sumber daya web adalah file virtual yang disimpan dalam database Dynamics 365 Customer Engagement (lokal) dan yang dapat Anda ambil dengan menggunakan alamat URL unik.

Kemampuan sumber daya web

Sumber daya web mewakili file yang dapat digunakan untuk memperluas aplikasi web Dynamics 365 Customer Engagement (lokal) seperti file html, JavaScript, dan CSS, dan beberapa format gambar. Anda dapat menggunakan sumber daya web dalam penyesuaian formulir, pita SiteMap, atau aplikasi karena dapat direferensikan dengan menggunakan sintaks URL.

Sintaks URL untuk sumber daya web memungkinkan referensi jalur relatif. Dengan alat pengembangan, Anda dapat membuat sekelompok file yang saling bergantung pada server pengembangan dengan menggunakan jenis file yang kompatibel dengan sumber daya web. Kemudian, jika Anda menggunakan konvensi penamaan yang konsisten dan referensi jalur relatif, situs web akan berfungsi setelah Anda mengunggah semua file ke Dynamics 365 Customer Engagement (lokal).

Karena sumber daya web disimpan di Dynamics 365 Customer Engagement (lokal) dan merupakan komponen solusi, sumber daya web dapat dengan mudah diekspor dan diinstal ke penyebaran lokal Dynamics 365 Customer Engagement (lokal) atau ke Dynamics 365 for Customer Engagement. Sumber daya web juga tersedia untuk pengguna Dynamics 365 for Microsoft Office Outlook dengan Akses Offline saat offline karena disinkronkan dengan data pengguna.

Anda dapat menggunakan editor formulir untuk menambahkan dan mengonfigurasi sumber daya web yang diaktifkan formulir ke dalam formulir entitas Anda.

Karena sumber daya web disimpan sebagai rekaman dalam database, sumber daya tersebut dapat dikelola secara terprogram dengan menggunakan teknik standar untuk membuat, mengambil, dan memperbarui rekaman. Sumber daya web berbasis teks (JScript, CSS, XML, XSL, RESX, dan HTML) dapat diedit dan disimpan dalam aplikasi.

Keterbatasan sumber daya web

Tidak ada jenis sumber daya web yang mendukung kemampuan halaman ASP.NET(.aspx) untuk mengeksekusi kode di server. Sumber daya web terbatas pada file statis atau file yang diproses di browser. Sumber daya web dapat berisi kode yang diproses di browser untuk menjalankan panggilan layanan web untuk berinteraksi dengan data Dynamics 365 Customer Engagement (lokal). Untuk informasi selengkapnya, lihat Bekerja dengan data Customer Engagement menggunakan sumber daya web.

Sumber daya web hanya tersedia dengan menggunakan konteks keamanan aplikasi web Dynamics 365 Customer Engagement (lokal). Hanya pengguna Dynamics 365 Customer Engagement (lokal) berlisensi yang memiliki hak istimewa yang diperlukan yang dapat mengaksesnya.

Batasan ukuran

Ukuran maksimum file yang dapat diunggah ditentukan oleh properti Organization.MaxUploadFileSize . Properti ini diatur di tab EmailPengaturan Sistem di aplikasi Dynamics 365. Pengaturan ini membatasi ukuran file yang dapat dilampirkan ke pesan email, catatan, dan sumber daya web. Pengaturan default adalah 5 MB.

Jenis sumber daya web

Anda dapat menggunakan sepuluh format file untuk membuat sumber daya web. Tabel berikut mencantumkan setiap format file, ekstensi file yang diizinkan, dan nilai jenis yang Anda gunakan untuk masing-masing.

File	Ekstensi file	Tipe
Halaman web (HTML)	.htm, .html	1
Lembar Gaya (CSS)	.css	2
Skrip (JScript)	.js	3
Data (XML)	.xml	4
Gambar (PNG)	.png	5
Gambar (JPG)	.jpg	6
Gambar (GIF)	.gif	7
Cahaya perak (XAP)	.xap	8
StyleSheet (XSL)	.xsl, .xslt	9
Gambar (ICO)	.ico	10
Format vektor (SVG)	.svg	11
String (RESX)	.resx	12

Referensi sumber daya web

Ada beberapa metode yang dapat Anda gunakan untuk mereferensikan sumber daya web.

Nota

• Jika memungkinkan, gunakan $webresource arahan. Hanya referensi yang menggunakan $webresource direktif dalam peta situs atau perintah pita yang akan membuat dependensi. Dependensi tidak dibuat saat sumber daya web saling mereferensikan.
  • Untuk menampilkan sumber daya web Silverlight di luar formulir atau bagan entitas, buat sumber daya web HTML untuk menjadi halaman host untuk sumber daya web Silverlight. Kemudian gunakan arahan $webresource: untuk membuka sumber daya web HTML.

$webresource arahan

Anda harus selalu menggunakan direktif saat $webresource mereferensikan sumber daya web dari kontrol pita atau dari SiteMap sub area. Gunakan direktif di $webresource mana pun XML mengizinkan nilai URL. Contoh berikut menunjukkan cara menggunakannya.

$webresource:<name of Web Resource>  

Nota

Saat menggunakan $webresource direktif, Dynamics 365 Customer Engagement (lokal) akan membuat atau memperbarui dependensi solusi.

Xrm.Navigasi.OpenWebResource

Xrm.Navigasi. openWebResource akan membuka sumber daya web HTML di jendela baru dengan parameter untuk meneruskan nama sumber daya web, data string kueri apa pun yang akan diteruskan dalam parameter data, dan informasi tentang tinggi dan lebar jendela.

URL yang dihasilkan menyertakan token GUID unik sehingga sumber daya web yang di-cache akan dimuat.

URL relatif

Saat mereferensikan sumber daya web dari area yang tidak mendukung penggunaan $webresource: direktif, URL relatif dapat digunakan. Untuk mengaktifkan ini, sebaiknya gunakan konvensi penamaan yang konsisten untuk sumber daya web yang mencerminkan struktur file virtual. Awalan penyesuaian penerbit solusi akan selalu disertakan sebagai awalan ke nama sumber daya web. Ini dapat mewakili folder "root" virtual untuk semua sumber daya web yang ditambahkan oleh penerbit tersebut. Anda kemudian dapat menggunakan karakter garis miring maju (/) untuk mensimulasikan struktur folder yang akan dihormati oleh server web.

Dari sumber web lain, Anda harus selalu menggunakan URL relatif untuk mereferensikan satu sama lain. Misalnya, untuk sumber daya new_/content/contentpage.htm web halaman web untuk mereferensikan sumber daya new_/Styles/styles.cssweb CSS , buat tautan sebagai berikut:

<link rel="stylesheet" type="text/css" href="../styles/styles.css" />  

Untuk sumber daya new_/content/contentpage.htm web halaman web untuk membuka sumber daya isv_/foldername/dialogpage.htmweb halaman web , buat tautan sebagai berikut:

<a href="../../isv_/foldername/dialogpage.htm">Dialog Page</a>  

Nota

Jangan gunakan URL relatif menggunakan folder WebResources sebagai jalur root untuk URL. Misalnya, jangan gunakan ini: /WebResources/<name of web resource>. Ketika pengguna milik lebih dari satu organisasi di server, jalur ini akan selalu mengacu pada organisasi default pengguna. Jika pengguna tidak menggunakan organisasi default mereka dan sumber daya web yang diharapkan tidak disertakan dalam organisasi default pengguna, kesalahan "File Tidak Ditemukan" terjadi meskipun sumber daya web terjadi di organisasi tempat pengguna saat ini bekerja.

URL lengkap

Contoh berikut menunjukkan gaya URL yang dapat Anda gunakan untuk melihat sumber daya web.

<Microsoft CRM URL>/WebResources/<name of web resource>  

Aplikasi akan memproses URL ini dan mengembalikan file yang berisi versi terbaru dari sumber daya web. URL ini akan terlihat seperti ini:

<Microsoft CRM URL>/%7B<version value>%7D/WebResources/<name of web resource>  

Nilai versi diperbarui saat Anda menerbitkan penyesuaian dan memastikan bahwa browser menggunakan versi cache terbaru dari sumber daya web. Karena itu, gunakan jalur relatif ke sumber daya web, Xrm.Navigation. openWebResource , atau $webresource Directive (jika memungkinkan) karena nilai versi akan secara otomatis disertakan. Untuk sumber daya web besar, dapat ada implikasi performa yang signifikan jika Anda tidak menggunakan versi file yang di-cache.

Contoh berikut menunjukkan URL untuk Dynamics 365 for Customer Engagement, di mana MyOrganization nama organisasi Anda, dan new_/test/test.htm merupakan nama sumber daya web:

https://MyOrganization.crm.dynamics.com/WebResources/new_/test/test.htm  

Nota

Menyertakan karakter '/' dan ekstensi nama file dalam nama sumber daya web adalah praktik terbaik opsional.

Contoh berikut menunjukkan URL untuk Dynamics 365 Customer Engagement lokal (lokal), di mana myServer nama server:

https://myServer/MyOrganization/WebResources/new_/test/test.htm  

Saat Anda menulis kode untuk mereferensikan sumber daya web yang perlu berfungsi untuk Dynamics 365 for Customer Engagement atau Dynamics 365 Customer Engagement lokal (lokal), Anda harus menggunakan fungsi getClientUrl .

Alat komunitas

Berikut adalah beberapa alat komunitas yang bekerja dengan sumber daya web.

Nama alat	Informasi selengkapnya
Pengelola Sumber Daya Web	https://github.com/gotdibbs/WebResourceManager
Toolkit Xrm	https://xrmtoolkit.com/Home/Features
Manajer Sumber Daya Web	https://www.xrmtoolbox.com/plugins/MsCrmTools.WebResourcesManager/

Nota

Alat komunitas bukan produk Microsoft Dynamics dan Microsoft tidak memperluas dukungan ke alat komunitas. Jika Anda memiliki pertanyaan yang berkaitan dengan alat, silakan hubungi penerbit alat tersebut.

Lihat juga

Menulis Ekstensi Aplikasi Klien untuk Dynamics 365 Customer Engagement
Membuat Sumber Daya Web yang Dapat Diakses
Sumber Daya Web Halaman Web (HTML)
Sumber Daya Web Silverlight (XAP)
Sumber Web Skrip (JScript)
Sumber Daya Web Gambar
Sumber Daya Web Stylesheet (XSL)
Sumber Daya Web Data (XML)
Sumber Daya Web Style Sheet (CSS)
Pesan dan Metode Sumber Daya Web
Sampel: Meneruskan beberapa nilai ke sumber daya web melalui parameter data
Sampel: Mengimpor File sebagai Sumber Daya Web
Menggunakan Data Layanan Web di Sumber Daya Web
Sederhanakan pengembangan sumber daya web menggunakan Fiddler AutoResponder