"Customer Engagement" žiniatinklio ištekliai

Žiniatinklio ištekliai yra virtualūs failai , saugomi "Dynamics 365 Customer Engagement (on-premises)" duomenų bazėje ir kuriuos galite gauti naudodami unikalų URL adresą.

Žiniatinklio išteklių galimybės

Žiniatinklio ištekliai yra failai, kuriuos galima naudoti norint išplėsti "Dynamics 365 Customer Engagement (on-premises)" žiniatinklio programą, pvz., html failus, "JavaScript" ir CSS, ir kelis vaizdo formatus. Žiniatinklio išteklius galite naudoti formų tinkinimuose, arba programos juostelėje, SiteMapnes juos galima nurodyti naudojant URL sintaksę.

Žiniatinklio išteklių URL sintaksė leidžia santykines kelio nuorodas. Naudodami kūrimo įrankius galite sukurti tarpusavyje susijusių failų grupę kūrimo serveryje naudodami failų tipus, suderinamus su žiniatinklio ištekliais. Tada, jei naudosite nuoseklią pavadinimų suteikimo konvenciją ir santykines kelio nuorodas, svetainė veiks nusiuntus visus failus į "Dynamics 365 Customer Engagement (on-premises)".

Kadangi žiniatinklio ištekliai saugomi "Dynamics 365 Customer Engagement (on-premises)" ir yra sprendimo komponentai, juos galima lengvai eksportuoti ir įdiegti į vietinius "Dynamics 365 Customer Engagement (on-premises)" arba "Dynamics 365 for Customer Engagement‟ diegimus. Žiniatinklio ištekliai taip pat pasiekiami "Dynamics 365 for Microsoft Office Outlook" su prieiga neprisijungus vartotojams, nes jie sinchronizuojami su vartotojo duomenimis.

Formų rengyklę galite naudoti norėdami įtraukti ir konfigūruoti žiniatinklio išteklius į objekto formas.

Kadangi žiniatinklio ištekliai duomenų bazėje saugomi kaip įrašai, juos galima valdyti programiškai, naudojant standartinius įrašų kūrimo, gavimo ir naujinimo metodus. Tekstinius žiniatinklio išteklius (JScript, CSS, XML, XSL, RESX ir HTML) galima redaguoti ir išsaugoti programoje.

Žiniatinklio išteklių apribojimai

Nėra jokio tipo žiniatinklio išteklių, palaikančių ASP.NET(.aspx) puslapio galimybes vykdyti kodą serveryje. Žiniatinklio ištekliai apsiriboja statiniais failais arba failais, kurie apdorojami naršyklėje. Žiniatinklio ištekliuose gali būti kodas, kuris apdorojamas naršyklėje, kad būtų vykdomi žiniatinklio tarnybos iškvietimai, kad būtų galima sąveikauti su "Dynamics 365 Customer Engagement (on-premises)" duomenimis. Daugiau informacijos rasite Darbas su "Customer Engagement" duomenimis naudojant žiniatinklio išteklius.

Žiniatinklio ištekliai pasiekiami tik naudojant "Dynamics 365 Customer Engagement (on-premises)" žiniatinklio programos saugos kontekstą. Jas pasiekti gali tik licencijuoti "Dynamics 365 Customer Engagement (on-premises)" vartotojai, turintys reikiamas teises.

Dydžio apribojimai

Maksimalus failų, kuriuos galima nusiųsti, dydis nustatomas pagal ypatybę Organization.MaxUploadFileSize . Ši ypatybė nustatyta "Dynamics 365" programos sistemos parametrų skirtuke El. paštas. Šis parametras riboja failų, kuriuos galima pridėti prie el. laiškų, pastabų ir žiniatinklio išteklių, dydį. Numatytasis nustatymas yra 5 MB.

Žiniatinklio išteklių tipai

Norėdami sukurti žiniatinklio išteklius, galite naudoti dešimt failų formatų. Šioje lentelėje pateikiamas kiekvieno failo formatas, leidžiami failų plėtiniai ir kiekvienam naudojama tipo reikšmė.

Failas	Failų plėtiniai	Tipas
Tinklalapis (HTML)	.htm, .html	1
Stiliaus lapas (CSS)	.Css	2
Scenarijus (JScript)	.js	3
Duomenys (XML)	.xml	4
Vaizdas (PNG)	.png	5
Paveikslėlis (JPG)	.jpg	6
Vaizdas (GIF)	.gif	7
"Silverlight" (XAP)	.xap	8
Stiliaus lapas (XSL)	.xsl, .xslt	9
Vaizdas (ICO)	.ico	10
Vektorinis formatas (SVG)	.svg	11
Styga (RESX)	.resx	12

Informaciniai žiniatinklio ištekliai

Yra keli būdai, kuriuos galite naudoti žiniatinklio ištekliams nurodyti.

Pastaba.

• Jei įmanoma, naudokite $webresource direktyvą. Tik nuorodos, kurios naudoja $webresource direktyvą svetainės struktūroje arba juostelės komandose, nustatys priklausomybes. Priklausomybės nesukuriamos, kai žiniatinklio ištekliai nurodo vienas kitą.
  • Norėdami rodyti "Silverlight" žiniatinklio išteklius už objekto formos ar diagramos ribų, sukurkite HTML žiniatinklio išteklių, kuris bus "Silverlight" žiniatinklio išteklių pagrindinis puslapis. Tada naudokite $webresource: direktyvą, kad atidarytumėte HTML žiniatinklio išteklius.

$webresource direktyva

Direktyvą visada turėtumėte naudoti $webresource nurodydami žiniatinklio išteklius iš juostelės valdiklio arba antrinės SiteMap srities. Naudokite direktyvą visur, $webresource kur XML leidžia URL reikšmę. Toliau pateiktame pavyzdyje parodyta, kaip juo naudotis.

$webresource:<name of Web Resource>  

Pastaba.

Naudojant $webresource direktyvą, "Dynamics 365 Customer Engagement (on-premises)" sukurs arba atnaujins sprendimo priklausomybes.

Xrm.Navigation.openWebResource

Xrm.Navigacija. openWebResource funkcija atidarys HTML žiniatinklio išteklius naujame lange su parametrais, skirtais perduoti žiniatinklio išteklių pavadinimą, bet kokius užklausos eilutės duomenis, kurie turi būti perduoti duomenų parametre, ir informaciją apie lango aukštį ir plotį.

Sugeneruotame URL yra unikalus GUID atpažinimo ženklas, kad būtų įkeltas talpykloje saugomas žiniatinklio išteklius.

Santykinis URL

Nurodant žiniatinklio išteklius iš sričių, kurios nepalaiko direktyvos naudojimo $webresource: , galima naudoti santykinį URL. Norėdami tai įjungti, rekomenduojame naudoti nuoseklią žiniatinklio išteklių, atspindinčių virtualią failo struktūrą, pavadinimų konvenciją. Sprendimo leidėjo tinkinimo priešdėlis visada bus įtrauktas kaip žiniatinklio ištekliaus pavadinimo priešdėlis. Tai gali būti virtualus "šakninis" aplankas, skirtas visiems to leidėjo pridėtiems žiniatinklio ištekliams. Tada galite naudoti pasvirąjį brūkšnį (/), kad imituotumėte aplanko struktūrą, kurią gerbs žiniatinklio serveris.

Iš kito žiniatinklio šaltinio visada turėtumėte naudoti santykinius URL, kad nurodytumėte vienas kitą. Pavyzdžiui, norėdami tinklalapio žiniatinklio išteklius new_/content/contentpage.htm nurodyti CSS žiniatinklio išteklius new_/Styles/styles.css, sukurkite saitą taip:

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

Kad tinklalapio žiniatinklio išteklius new_/content/contentpage.htm atidarytų tinklalapio žiniatinklio išteklius isv_/foldername/dialogpage.htm, sukurkite saitą taip:

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

Pastaba.

Nenaudokite santykinio URL, naudodami aplanką WebResources kaip šakninį URL kelią. Pavyzdžiui, nenaudokite šio: /WebResources/<name of web resource>. Kai vartotojas priklauso daugiau nei vienai serverio organizacijai, šis kelias visada nurodo vartotojo numatytąją organizaciją. Jei vartotojas nenaudoja savo numatytosios organizacijos ir numatomas žiniatinklio išteklius nėra įtrauktas į vartotojo numatytąją organizaciją, įvyksta klaida "Failas nerastas", net jei žiniatinklio išteklius atsiranda organizacijoje, kurioje vartotojas šiuo metu dirba.

Visas URL

Toliau pateiktame pavyzdyje parodytas URL, kurį galite naudoti žiniatinklio ištekliams peržiūrėti, stilius.

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

Programa apdoros šį URL ir pateiks failą, kuriame yra naujausia žiniatinklio ištekliaus versija. Šis URL atrodys taip:

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

Versijos reikšmė atnaujinama, kai publikuojate tinkinimus, ir užtikrina, kad naršyklė naudoja naujausią talpykloje saugomą žiniatinklio išteklių versiją. Dėl šios priežasties naudokite santykinį kelią į žiniatinklio išteklius Xrm.Navigation. openWebResource funkcija arba $webresource direktyva (jei įmanoma), nes versijos reikšmė bus automatiškai įtraukta. Dideliems žiniatinklio ištekliams gali būti reikšmingų pasekmių našumui, jei nenaudosite talpykloje saugomos failo versijos.

Toliau pateiktame pavyzdyje parodytas "Dynamics 365 for Customer Engagement‟ URL, kuriame MyOrganization yra jūsų organizacijos pavadinimas ir new_/test/test.htm žiniatinklio ištekliaus pavadinimas:

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

Pastaba.

Simbolio "/" ir failo vardo plėtinio įtraukimas į žiniatinklio ištekliaus pavadinimą yra neprivaloma geriausia praktika.

Toliau pateiktame pavyzdyje parodytas vietinės "Dynamics 365 Customer Engagement (on-premises)" URL, kuriame myServer yra serverio pavadinimas:

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

Kai rašote kodą, kad nurodytumėte žiniatinklio išteklius, kurie turės veikti "Dynamics 365 for Customer Engagement‟ arba vietinėje "Dynamics 365 Customer Engagement (on-premises)", turėtumėte naudoti funkciją getClientURL .

Bendruomenės įrankiai

Štai keletas bendruomenės įrankių, kurie veikia su žiniatinklio ištekliais.

Įrankio pavadinimas	Daugiau informacijos
WebResourceManager	https://github.com/gotdibbs/WebResourceManager
XrmToolkit	https://xrmtoolkit.com/Home/Features
Žiniatinklio išteklių vadybininkas	https://www.xrmtoolbox.com/plugins/MsCrmTools.WebResourcesManager/

Pastaba.

Bendruomenės įrankiai nėra "Microsoft Dynamics" produktas ir "Microsoft" nepalaiko bendruomenės įrankių. Jei turite klausimų, susijusių su įrankiu, susisiekite su įrankio leidėju.

Taip pat žr.

"Dynamics 365 Customer Engagement‟ kliento taikomųjų programų plėtinių rašymas
Neįgaliesiems pritaikytų žiniatinklio išteklių kūrimas
Tinklalapio (HTML) žiniatinklio ištekliai
"Silverlight" (XAP) žiniatinklio ištekliai
Scenarijaus (JScript) žiniatinklio ištekliai
Vaizdo žiniatinklio ištekliai
Stiliaus aprašo (XSL) žiniatinklio ištekliai
Duomenų (XML) žiniatinklio ištekliai
Stiliaus lapo (CSS) žiniatinklio ištekliai
Žiniatinklio išteklių pranešimai ir metodai
Pavyzdys: kelių reikšmių perdavimas žiniatinklio ištekliui naudojant duomenų parametrą
Pavyzdys: Failų importavimas kaip žiniatinklio ištekliai
Žiniatinklio tarnybos duomenų naudojimas žiniatinklio ištekliuose
Supaprastinkite žiniatinklio išteklių kūrimą naudodami "Fiddler AutoResponder"