משאבי אינטרנט עבור Customer Engagement

משאבי אינטרנט הם קבצים וירטואליים המאוחסנים במסד הנתונים 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 (מקומי). לקבלת מידע נוסף, ראה עבודה עם נתוני Customer Engagement באמצעות משאבי אינטרנט.

משאבי אינטרנט זמינים רק באמצעות הקשר האבטחה של Dynamics 365 Customer Engagement (מקומי). רק משתמשי Dynamics 365 Customer Engagement (on-premises) מורשים שיש להם את ההרשאות הדרושות יכולים לגשת אליהם.

מגבלות גודל

הגודל המרבי של קבצים שניתן להעלות נקבע על-ידי המאפיין Organization.MaxUploadFileSize . מאפיין זה מוגדר בכרטיסיה דואר אלקטרוני של הגדרות המערכת ביישום Dynamics 365. הגדרה זו מגבילה את גודל הקבצים שניתן לצרף להודעות דואר אלקטרוני, הערות ומשאבי אינטרנט. הגדרת ברירת המחדל היא 5 MB.

סוגי משאבי אינטרנט

באפשרותך להשתמש בעשר תבניות קובץ כדי ליצור משאבי אינטרנט. הטבלה הבאה מפרטת כל תבנית קובץ, סיומות הקבצים המותרות וערך הסוג שבו אתה משתמש עבור כל אחת מהן.

קובץ	סיומות קבצים	Type
דף אינטרנט (HTML)	.htm, .html	1
גליון סגנונות (CSS)	.css	2
Script (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
תבנית וקטור (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 במשאב האינטרנט CSS new_/Styles/styles.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. openWebResource function , או $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)
משאבי אינטרנט של Script (JScript)
משאבי אינטרנט של תמונה
משאבי אינטרנט של גליון סגנונות (XSL)
משאבי אינטרנט של נתונים (XML)
משאבי אינטרנט של גליון סגנונות (CSS)
הודעות ושיטות של משאבי אינטרנט
דוגמה: העברת ערכים מרובים למשאב אינטרנט באמצעות פרמטר הנתונים
דוגמה: ייבוא קבצים ממשאבי אינטרנט
שימוש נתונים של שירות אינטרנט במשאבי אינטרנט
ייעול פיתוח משאבי האינטרנט באמצעות Fiddler AutoResponder