موارد الويب لمشاركة العملاء

موارد الويب هي ملفات ظاهرية مخزنة في قاعدة بيانات Dynamics 365 Customer Engagement (المحلية) ويمكنك استردادها باستخدام عنوان URL فريد.

قدرات موارد الويب

تمثل موارد الويب الملفات التي يمكن استخدامها لتوسيع تطبيق الويب Dynamics 365 Customer Engagement (المحلي) مثل ملفات html وJavaScript وCSS والعديد من تنسيقات الصور. يمكنك استخدام موارد الويب في تخصيصات النموذج أو SiteMapشريط التطبيق لأنه يمكن الرجوع إليها باستخدام بناء جملة URL.

يسمح بناء جملة URL لموارد الويب بالمراجع النسبية للمسار. باستخدام أدوات التطوير الخاصة بك، يمكنك إنشاء مجموعة من الملفات المترابطة على خادم تطوير باستخدام أنواع الملفات المتوافقة مع موارد الويب. بعد ذلك، إذا كنت تستخدم اصطلاح تسمية متناسق ومراجع المسار النسبي، فسيعمل موقع الويب بعد تحميل جميع الملفات إلى Dynamics 365 Customer Engagement (محليا).

نظرا لأنه يتم تخزين موارد الويب في Dynamics 365 Customer Engagement (محليا) وهي مكونات حل، يمكن تصديرها وتثبيتها بسهولة على عمليات النشر المحلية ل Dynamics 365 Customer Engagement (محليا) أو إلى Dynamics 365 for Customer Engagement. تتوفر موارد ويب أيضا لمستخدمي Dynamics 365 ل Microsoft Office Outlook مع الوصول دون اتصال عند عدم الاتصال لأنه تتم مزامنتها مع بيانات المستخدم.

يمكنك استخدام محرر النماذج لإضافة موارد ويب ممكنة للنموذج وتكوينها في نماذج الكيان.

نظرا لأنه يتم تخزين موارد الويب كسجلات في قاعدة البيانات، يمكن إدارتها برمجيا باستخدام التقنيات القياسية لإنشاء السجلات واستردادها وتحديثها. يمكن تحرير موارد الويب المستندة إلى النص (JScript وCSS وXML وXSL و RESX و HTML) وحفظها في التطبيق.

قيود موارد الويب

لا يوجد نوع من موارد الويب التي تدعم قدرات صفحة ASP.NET (.aspx) لتنفيذ التعليمات البرمجية على الخادم. تقتصر موارد الويب على الملفات الثابتة أو الملفات التي تتم معالجتها في المستعرض. يمكن أن يحتوي مورد الويب على تعليمات برمجية تتم معالجتها في المستعرض لتنفيذ استدعاءات خدمة الويب للتفاعل مع بيانات Dynamics 365 Customer Engagement (المحلية). لمزيد من المعلومات، راجع العمل مع بيانات تفاعل العملاء باستخدام موارد الويب.

تتوفر موارد الويب فقط باستخدام سياق أمان تطبيق الويب Dynamics 365 Customer Engagement (المحلي). يمكن فقط لمستخدمي Dynamics 365 Customer Engagement (المحليين) المرخصين الذين لديهم الامتيازات الضرورية الوصول إليها.

قيود الحجم

يتم تحديد الحد الأقصى لحجم الملفات التي يمكن تحميلها بواسطة الخاصية Organization.MaxUploadFileSize . يتم تعيين هذه الخاصية في علامة التبويب البريد الإلكترونيلإعدادات النظام في تطبيق Dynamics 365. يحد هذا الإعداد من حجم الملفات التي يمكن إرفاقها برسائل البريد الإلكتروني والملاحظات وموارد الويب. الإعداد الافتراضي هو 5 ميغابايت.

أنواع موارد ويب

يمكنك استخدام عشرة تنسيقات ملفات لإنشاء موارد ويب. يسرد الجدول التالي كل تنسيق ملف وملحقات الملفات المسموح بها وقيمة النوع التي تستخدمها لكل منها.

ملف	ملحقات الملفات	نوع
صفحة ويب (HTML)	.htm، .html	1
ورقة أنماط (CSS)	.المغلق	2
البرنامج النصي (JScript)	.شبيبه	3
البيانات (XML)	.xml	4
صورة (PNG)	‎.png	5
صورة (JPG)	‎.jpg	6
صورة (GIF)	.gif	7
Silverlight (XAP)	.xap	8
ورقة أنماط (XSL)	.xsl, .xslt	9
صورة (ICO)	.ico	10
تنسيق المتجه (SVG)	.svg	11
سلسلة (RESX)	.resx	12

موارد الويب المرجعية

هناك العديد من الطرق التي يمكنك استخدامها للإشارة إلى موارد الويب.

‏‫ملاحظة‬

• استخدم التوجيه عندما $webresource يكون ذلك ممكنا. فقط المراجع التي تستخدم $webresource التوجيه في خريطة الموقع أو أوامر الشريط ستنشئ تبعيات. لا يتم إنشاء التبعيات عندما تشير موارد الويب إلى بعضها البعض.
  • لعرض مورد ويب Silverlight خارج نموذج كيان أو مخطط، قم بإنشاء مورد ويب HTML ليكون صفحة المضيف لمورد ويب Silverlight. ثم استخدم توجيه $webresource: لفتح مورد ويب HTML.

توجيه $webresource

يجب عليك دائما استخدام $webresource التوجيه عند الرجوع إلى مورد ويب من عنصر تحكم شريط أو من منطقة فرعية SiteMap . استخدم التوجيه في $webresource أي مكان يسمح فيه XML بقيمة عنوان URL. يوضح النموذج التالي كيفية استخدامه.

$webresource:<name of Web Resource>  

‏‫ملاحظة‬

عند استخدام $webresource التوجيه، سيقوم Dynamics 365 Customer Engagement (المحلي) بإنشاء تبعيات الحل أو تحديثها.

Xrm.Navigation.openWebResource

The Xrm.Navigation. ستفتح الدالة openWebResource مورد ويب HTML في نافذة جديدة مع معلمات لتمرير اسم مورد الويب، وأي بيانات سلسلة استعلام يتم تمريرها في معلمة البيانات، ومعلومات حول ارتفاع النافذة وعرضها.

يتضمن عنوان URL الذي تم إنشاؤه رمز GUID المميز الفريد بحيث يتم تحميل مورد الويب المخزن مؤقتا.

عنوان URL النسبي

عند الرجوع إلى مورد ويب من المناطق التي لا تدعم استخدام $webresource: التوجيه، يمكن استخدام عنوان URL نسبي. لتمكين ذلك، نوصي باستخدام اصطلاح تسمية متناسق لموارد الويب التي تعكس بنية ملف ظاهري. سيتم دائما تضمين بادئة تخصيص ناشر الحل كبادئة لاسم مورد الويب. يمكن أن يمثل هذا مجلد "الجذر" الظاهري لكافة موارد الويب التي أضافها هذا الناشر. يمكنك بعد ذلك استخدام حرف الشرطة المائلة للأمام (/) لمحاكاة بنية مجلد سيتم تكريمها من قبل خادم الويب.

من مورد ويب آخر، يجب عليك دائما استخدام عناوين URL النسبية للإشارة إلى بعضها البعض. على سبيل المثال، لمورد new_/content/contentpage.htm ويب صفحة ويب للإشارة إلى مورد new_/Styles/styles.cssويب CSS ، قم بإنشاء الارتباط كما يلي:

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

لمورد new_/content/contentpage.htm ويب صفحة ويب لفتح مورد isv_/foldername/dialogpage.htmويب صفحة ويب ، قم بإنشاء الارتباط كما يلي:

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

‏‫ملاحظة‬

لا تستخدم عنوان URL نسبيا باستخدام مجلد WebResources كمسار جذر لعنون URL. على سبيل المثال، لا تستخدم هذا: /WebResources/<name of web resource>. عندما ينتمي مستخدم إلى أكثر من مؤسسة واحدة على خادم، سيشير هذا المسار دائما إلى المؤسسة الافتراضية للمستخدمين. إذا لم يكن المستخدم يستخدم مؤسسته الافتراضية ولم يتم تضمين مورد الويب المتوقع في المؤسسة الافتراضية للمستخدم، يحدث خطأ "ملف غير موجود" على الرغم من أن مورد الويب يحدث في المؤسسة التي يعمل فيها المستخدم حاليا.

عنوان URL الكامل

يوضح النموذج التالي نمط عنوان URL الذي يمكنك استخدامه لعرض موارد الويب.

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

سيقوم التطبيق بمعالجة عنوان URL هذا وإرجاع الملف الذي يحتوي على أحدث إصدار من مورد الويب. سيبدو عنوان URL هذا كما يلي:

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

يتم تحديث قيمة الإصدار عند نشر التخصيصات والتأكد من أن المستعرض يستخدم أحدث إصدار مخزن مؤقتا من مورد الويب. لهذا السبب، استخدم مسارا نسبيا إلى مورد ويب، Xrm.Navigation. افتح الدالةWebResource أو توجيه $webresource (عندما يكون ذلك ممكنا) لأنه سيتم تضمين قيمة الإصدار تلقائيا. بالنسبة لموارد الويب الكبيرة، يمكن أن تكون هناك آثار كبيرة على الأداء إذا لم تستخدم الإصدار المخزن مؤقتا من الملف.

يظهر النموذج التالي عنوان URL ل Dynamics 365 for Customer Engagement، حيث MyOrganization هو اسم مؤسستك، وهو new_/test/test.htm اسم مورد الويب:

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

‏‫ملاحظة‬

يعد تضمين الحرف '/' وملحق اسم الملف في اسم مورد الويب من أفضل الممارسات الاختيارية.

يظهر النموذج التالي عنوان URL ل Dynamics 365 Customer Engagement المحلي (المحلي)، حيث myServer هو اسم الخادم:

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

عند كتابة التعليمات البرمجية للإشارة إلى مورد ويب يحتاج إلى العمل إما ل Dynamics 365 for Customer Engagement أو Dynamics 365 Customer Engagement المحلي (المحلي)، يجب عليك استخدام الدالة getClientUrl .

أدوات المجتمع

فيما يلي بعض أدوات المجتمع التي تعمل مع موارد الويب.

اسم الأداة	مزيد من المعلومات
WebResourceManager	https://github.com/gotdibbs/WebResourceManager
XrmToolkit	https://xrmtoolkit.com/Home/Features
WebResources Manager	https://www.xrmtoolbox.com/plugins/MsCrmTools.WebResourcesManager/

‏‫ملاحظة‬

أدوات المجتمع ليست منتج Microsoft Dynamics ولا تقوم Microsoft بتوسيع الدعم إلى أدوات المجتمع. إذا كانت لديك أسئلة تتعلق بأداة، فيرجى الاتصال بناشر الأداة.

(راجع أيضًا )

كتابة ملحقات تطبيق العميل ل Dynamics 365 Customer Engagement
إنشاء موارد ويب يمكن الوصول إليها
موارد ويب لصفحة ويب (HTML)
موارد ويب Silverlight (XAP)
موارد ويب للبرنامج النصي (JScript)
موارد ويب للصورة
موارد ويب ورقة الأنماط (XSL)
موارد ويب للبيانات (XML)
موارد ويب ورقة الأنماط (CSS)
رسائل موارد ويب وأساليبها
نموذج: تمرير قيم متعددة إلى مورد ويب من خلال معلمة البيانات
نموذج: استيراد الملفات كموارد ويب
استخدام بيانات خدمة ويب في موارد ويب
تبسيط تطوير موارد الويب باستخدام Fiddler AutoResponder