Müşteri Etkileşimi için web kaynakları

Web kaynakları, Dynamics 365 Customer Engagement (şirket içi) veritabanında depolanan ve benzersiz bir URL adresi kullanarak alabildiğiniz sanal dosyalardır .

Web kaynaklarının özellikleri

Web kaynakları html dosyaları, JavaScript ve CSS gibi Dynamics 365 Customer Engagement (şirket içi) web uygulamasını ve çeşitli görüntü biçimlerini genişletmek için kullanılabilecek dosyaları temsil eder. Url söz dizimi kullanılarak başvurulabildiğinden, web kaynaklarını form özelleştirmelerinde, SiteMap, veya uygulama şeridinde kullanabilirsiniz.

Web kaynaklarının URL söz dizimi göreli yol başvuruları sağlar. Geliştirme araçlarınızla, web kaynaklarıyla uyumlu dosya türlerini kullanarak bir geliştirme sunucusunda birbirine bağlı dosyalar grubu oluşturabilirsiniz. Ardından tutarlı bir adlandırma kuralı ve göreli yol başvuruları kullanırsanız, tüm dosyaları Dynamics 365 Customer Engagement'a (şirket içi) yükledikten sonra web sitesi çalışır.

Web kaynakları Dynamics 365 Müşteri Katılımı'nda (şirket içi) depolandığından ve çözüm bileşenleri olduğundan, dynamics 365 Customer Engagement'ın (şirket içi) veya Dynamics 365 for Customer Engagement'ın şirket içi dağıtımlarına kolayca dışarı aktarılabilir ve yüklenebilir. Web kaynakları, çevrimdışı olduğunda Çevrimdışı Erişimli Microsoft Office Outlook için Dynamics 365 kullanıcıları tarafından da kullanılabilir çünkü bunlar kullanıcının verileriyle eşitlenir.

Form düzenleyicisini kullanarak varlık formlarınıza form etkin web kaynakları ekleyebilir ve yapılandırabilirsiniz.

Web kaynakları veritabanında kayıt olarak depolandığından, kayıtları oluşturmak, almak ve güncelleştirmek için standart teknikler kullanılarak program aracılığıyla yönetilebilirler. Metin tabanlı web kaynakları (JScript, CSS, XML, XSL, RESX ve HTML) düzenlenebilir ve uygulamada kaydedilebilir.

Web kaynaklarının sınırlamaları

Sunucuda kod yürütmek için bir ASP.NET(.aspx) sayfasının özelliklerini destekleyen bir web kaynağı türü yoktur. Web kaynakları, tarayıcıda işlenen statik dosyalarla veya dosyalarla sınırlıdır. Web kaynağı, Dynamics 365 Customer Engagement (şirket içi) verileriyle etkileşime geçmek üzere web hizmeti çağrılarını yürütmek için tarayıcıda işlenen kod içerebilir. Daha fazla bilgi için bkz. Web kaynaklarını kullanarak Customer Engagement verileriyle çalışma.

Web kaynakları yalnızca Dynamics 365 Customer Engagement (şirket içi) web uygulaması güvenlik bağlamı kullanılarak kullanılabilir. Yalnızca gerekli ayrıcalıklara sahip lisanslı Dynamics 365 Customer Engagement (on-premises) kullanıcıları bunlara erişebilir.

Boyut sınırlamaları

Karşıya yüklenebilecek dosyaların en büyük boyutu Organization.MaxUploadFileSize özelliği tarafından belirlenir. Bu özellik, Dynamics 365 uygulamasındaki Sistem Ayarları'nınE-posta sekmesinde ayarlanır. Bu ayar e-posta iletilerine, notlara ve web kaynaklarına ekleyebileceğiniz dosyaların boyutunu sınırlar. Varsayılan ayar 5 MB'dir.

Web kaynağı türleri

Web kaynakları oluşturmak için on dosya biçimi kullanabilirsiniz. Aşağıdaki tabloda her dosya biçimi, izin verilen dosya uzantıları ve her dosya için kullandığınız tür değeri listelenir.

Dosya	Dosya uzantıları	Türü
Web sayfası (HTML)	.htm, .html	1
Stil Sayfası (CSS)	.Css	2
Komut Dosyası (JScript)	.js	3
Veri (XML)	.xml	4
Resim (PNG)	.png	5
Resim (JPG)	.jpg	6
Resim (GIF)	.gif	7
Silverlight (XAP)	.xap	8
Stil Sayfası (XSL)	.xsl, .xslt	9
Görüntü (ICO)	.ico	10
Vektör biçimi (SVG)	.svg	11
Dize (RESX)	.resx	12

Web kaynaklarına başvurma

Web kaynaklarına başvurmak için kullanabileceğiniz çeşitli yöntemler vardır.

Uyarı

• Mümkün olduğunda yönergesini $webresource kullanın. Yalnızca site haritasında veya şerit komutlarında yönergesini $webresource kullanan başvurular bağımlılıklar oluşturur. Web kaynakları birbirine başvurduğunda bağımlılıklar oluşturulmaz.
  • Silverlight web kaynağını varlık formu veya grafiğin dışında görüntülemek için, Silverlight web kaynağının ana bilgisayar sayfası olacak bir HTML web kaynağı oluşturun. Ardından html web kaynağını açmak için $webresource: yönergesini kullanın.

$webresource yönergesi

Şerit denetiminden veya $webresource alt alandan bir web kaynağına başvururken her zaman yönergesini SiteMap kullanmalısınız. XML'nin $webresource URL değerine izin verdiği her yerde yönergesini kullanın. Aşağıdaki örnekte nasıl kullanılacağı gösterilmektedir.

$webresource:<name of Web Resource>  

Uyarı

Yönergeyi $webresource kullanırken Dynamics 365 Customer Engagement (şirket içi), çözüm bağımlılıklarını oluşturur veya güncelleştirir.

Xrm.Navigation.openWebResource

The Xrm.Navigation. openWebResource işlevi, web kaynağının adını, veri parametresine geçirilecek sorgu dizesi verilerini ve pencerenin yüksekliği ve genişliği hakkındaki bilgileri geçirmek için parametreler içeren yeni bir pencerede bir HTML web kaynağı açar.

Oluşturulan URL, önbelleğe alınan web kaynağının yüklenmesi için benzersiz GUID belirtecini içerir.

Göreli URL

Yönergesini kullanmayı $webresource: desteklemeyen alanlardan bir web kaynağına başvururken göreli URL kullanılabilir. Bunu etkinleştirmek için, sanal dosya yapısını yansıtan web kaynakları için tutarlı bir adlandırma kuralı kullanmanızı öneririz. Çözüm yayımcısının özelleştirme ön eki her zaman web kaynağının adına bir ön ek olarak eklenir. Bu, söz konusu yayımcı tarafından eklenen tüm web kaynakları için sanal bir "kök" klasörü temsil edebilir. Ardından, web sunucusu tarafından kabul edilecek bir klasör yapısının benzetimini yapmak için eğik çizgi karakterini (/) kullanabilirsiniz.

Başka bir web kaynağından, her zaman birbirine başvurmak için göreli URL'ler kullanmalısınız. Örneğin, CSS web kaynağına new_/content/contentpage.htm başvurmak üzere web sayfası web kaynağı new_/Styles/styles.cssiçin bağlantıyı aşağıdaki gibi oluşturun:

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

Web sayfası web kaynağının new_/content/contentpage.htm web sayfası web kaynağını isv_/foldername/dialogpage.htmaçması için bağlantıyı aşağıdaki gibi oluşturun:

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

Uyarı

URL'nin kök yolu olarak WebResources klasörünü kullanarak göreli URL kullanmayın. Örneğin, şunu kullanmayın: /WebResources/<name of web resource>. Bir kullanıcı bir sunucudaki birden fazla kuruluşa ait olduğunda, bu yol her zaman kullanıcıların varsayılan kuruluşuna başvurur. Kullanıcı varsayılan kuruluşunu kullanmıyorsa ve beklenen web kaynağı kullanıcının varsayılan kuruluşuna dahil değilse, web kaynağı kullanıcının çalışmakta olduğu kuruluşta gerçekleşse bile "Dosya Bulunamadı" hatası oluşur.

Tam URL

Aşağıdaki örnek, web kaynaklarını görüntülemek için kullanabileceğiniz URL'nin stilini gösterir.

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

Uygulama bu URL'yi işler ve web kaynağının en son sürümünü içeren dosyayı döndürür. Bu URL şöyle görünür:

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

Özelleştirmeleri yayımladığınızda sürüm değeri güncelleştirilir ve tarayıcının web kaynağının önbelleğe alınmış en son sürümünü kullanmasını sağlar. Bu nedenle, Xrm.Navigation adlı bir web kaynağının göreli yolunu kullanın. sürüm değeri otomatik olarak dahil edildiğinden openWebResource işlevi veya $webresource Yönergesi (mümkün olduğunda). Büyük web kaynakları için, dosyanın önbelleğe alınmış sürümünü kullanmazsanız önemli performans etkileri olabilir.

Aşağıdaki örnekte Dynamics 365 for Customer Engagement URL'si gösterilmektedir. Burada MyOrganization kuruluşunuzun adı ve new_/test/test.htm web kaynağının adı verilmiştir:

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

Uyarı

Web kaynağının adına '/' karakteri ve dosya adı uzantısı eklemek isteğe bağlı en iyi yöntemdir.

Aşağıdaki örnekte şirket içi Dynamics 365 Customer Engagement (şirket içi) için bir URL gösterilmektedir ve burada myServer sunucu adı verilmiştir:

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

Dynamics 365 for Customer Engagement veya şirket içi Dynamics 365 Customer Engagement (şirket içi) için çalışması gereken bir web kaynağına başvurmak için kod yazdığınızda getClientUrl işlevini kullanmanız gerekir.

Topluluk araçları

Web kaynaklarıyla çalışan topluluk araçlarından bazıları aşağıdadır.

Araç adı	Daha Fazla Bilgi
WebResourceManager	https://github.com/gotdibbs/WebResourceManager
XrmToolkit	https://xrmtoolkit.com/Home/Features
WebResources Yöneticisi	https://www.xrmtoolbox.com/plugins/MsCrmTools.WebResourcesManager/

Uyarı

Topluluk araçları Microsoft Dynamics'in bir ürünü değildir ve Microsoft, topluluk araçlarına desteği genişletmez. Bir araçla ilgili sorularınız varsa lütfen aracın yayımcısına başvurun.

Ayrıca bakınız

Dynamics 365 Müşteri Katılımı için İstemci Uygulama Uzantıları Yazma
Erişilebilir Web Kaynakları Oluşturma
Web Sayfası (HTML) Web Kaynakları
Silverlight (XAP) Web Kaynakları
Betik (JScript) Web Kaynakları
Görüntü Web Kaynakları
Stil Sayfası (XSL) Web Kaynakları
Veri (XML) Web Kaynakları
Stil Sayfası (CSS) Web Kaynakları
Web Kaynağı İletileri ve Yöntemleri
Örnek: Veri Parametresi Aracılığıyla Bir Web Kaynağına Birden Çok Değer Geçirme
Örnek: Dosyaları Web Kaynağı Olarak İçeri Aktarma
Web Kaynaklarında Web Hizmeti Verilerini Kullanma
Fiddler AutoResponder kullanarak web kaynağı geliştirmeyi kolaylaştırın