Udostępnij przez

Zasoby internetowe dla platformy Customer Engagement

Zasoby internetowe to pliki wirtualne , które są przechowywane w bazie danych usługi Dynamics 365 Customer Engagement (lokalnie) i które można pobrać przy użyciu unikatowego adresu URL.

Możliwości zasobów internetowych

Zasoby internetowe reprezentują pliki, których można użyć do rozszerzenia aplikacji internetowej Dynamics 365 Customer Engagement (lokalnej), takiej jak pliki HTML, JavaScript i CSS oraz kilka formatów obrazów. Zasoby internetowe można używać w dostosowaniach formularzy, wstążce aplikacji lub aplikacji, SiteMapponieważ można do nich odwoływać się przy użyciu składni adresu URL.

Składnia adresu URL dla zasobów internetowych umożliwia odwołania do ścieżek względnych. Za pomocą narzędzi programistycznych można utworzyć grupę wzajemnie zależnych plików na serwerze deweloperów przy użyciu typów plików zgodnych z zasobami internetowymi. Następnie, jeśli używasz spójnej konwencji nazewnictwa i odwołań do ścieżek względnych, witryna internetowa będzie działać po przekazaniu wszystkich plików do usługi Dynamics 365 Customer Engagement (lokalnie).

Ponieważ zasoby internetowe są przechowywane w usłudze Dynamics 365 Customer Engagement (lokalnie) i są składnikami rozwiązania, można je łatwo wyeksportować i zainstalować do lokalnych wdrożeń usługi Dynamics 365 Customer Engagement (lokalnie) lub do usługi Dynamics 365 for Customer Engagement. Zasoby internetowe są również dostępne dla użytkowników programu Dynamics 365 for Microsoft Office Outlook z dostępem offline, ponieważ są one synchronizowane z danymi użytkownika.

Możesz użyć edytora formularzy, aby dodać i skonfigurować zasoby internetowe obsługujące formularze do formularzy jednostki.

Ponieważ zasoby internetowe są przechowywane jako rekordy w bazie danych, można nimi zarządzać programowo przy użyciu standardowych technik tworzenia, pobierania i aktualizowania rekordów. Zasoby internetowe oparte na tekście (JScript, CSS, XML, XSL, RESX i HTML) można edytować i zapisywać w aplikacji.

Ograniczenia zasobów internetowych

Brak typu zasobu internetowego obsługującego możliwości strony ASP.NET(.aspx) do wykonywania kodu na serwerze. Zasoby internetowe są ograniczone do plików statycznych lub plików przetwarzanych w przeglądarce. Zasób internetowy może zawierać kod przetwarzany w przeglądarce w celu wykonywania wywołań usługi internetowej w celu interakcji z danymi usługi Dynamics 365 Customer Engagement (lokalnie). Aby uzyskać więcej informacji, zobacz Praca z danymi usługi Customer Engagement przy użyciu zasobów internetowych.

Zasoby internetowe są dostępne tylko przy użyciu kontekstu zabezpieczeń aplikacji internetowej usługi Dynamics 365 Customer Engagement (lokalnie). Tylko licencjonowani użytkownicy Dynamics 365 Customer Engagement (on-premises), którzy mają niezbędne uprawnienia, mogą uzyskać do nich dostęp.

Ograniczenia rozmiaru

Maksymalny rozmiar plików, które można przekazać, jest określany przez właściwość Organization.MaxUploadFileSize . Ta właściwość jest ustawiana na karcie Poczta e-mail w Ustawieniach systemu w aplikacji Dynamics 365. To ustawienie ogranicza rozmiar plików, które mogą być dołączane do wiadomości e-mail, notatek i zasobów internetowych. Ustawienie domyślne to 5 MB.

Typy zasobów sieci Web

Do tworzenia zasobów internetowych można użyć dziesięciu formatów plików. W poniższej tabeli wymieniono każdy format pliku, dozwolone rozszerzenia plików i wartość typu, która jest używana dla każdego z nich.

File Rozszerzenia plików Typ
Strona internetowa (HTML) .htm, .html 1
Arkusz stylów (CSS) .css 2
Skrypt (JScript) js 3
Dane (XML) .xml 4
Obraz (PNG) .png 5
Obraz (JPG) .jpg 6
Obraz (GIF) .gif 7
Silverlight (XAP) .xap 8
StyleSheet (XSL) .xsl, .xslt 9
Obraz (ICO) .ico 10
Format wektorowy (SVG) .svg 11
Ciąg (RESX) Resx 12

Dokumentacja zasobów internetowych

Istnieje kilka metod, których można użyć do odwołowania się do zasobów internetowych.

Uwaga / Notatka

  • Jeśli to możliwe, użyj $webresource dyrektywy . Tylko odwołania, które używają $webresource dyrektywy w mapie witryny lub polecenia wstążki, ustanowią zależności. Zależności nie są tworzone, gdy zasoby internetowe odwołują się do siebie.
    • Aby wyświetlić zasób internetowy silverlight poza formularzem lub wykresem jednostki, utwórz zasób internetowy HTML, aby był stroną hosta zasobu internetowego silverlight. Następnie użyj dyrektywy $webresource: , aby otworzyć zasób internetowy HTML.

dyrektywa $webresource

Zawsze należy używać $webresource dyrektywy podczas odwoływania się do zasobu internetowego z kontrolki wstążki lub z obszaru podrzędnego SiteMap . $webresource Użyj dyrektywy w dowolnym miejscu, w którym kod XML zezwala na wartość adresu URL. W poniższym przykładzie pokazano, jak z niego korzystać.

$webresource:<name of Web Resource>

Uwaga / Notatka

W przypadku korzystania z $webresource dyrektywy usługa Dynamics 365 Customer Engagement (lokalnie) utworzy lub zaktualizuje zależności rozwiązania.

Xrm.Navigation.openWebResource

The Xrm.Navigation. Funkcja openWebResource otworzy zasób internetowy HTML w nowym oknie z parametrami, aby przekazać nazwę zasobu internetowego, wszystkie dane ciągu zapytania, które mają zostać przekazane w parametrze danych, oraz informacje o wysokości i szerokości okna.

Wygenerowany adres URL zawiera unikatowy token GUID, aby załadować buforowany zasób internetowy.

Względny adres URL

W przypadku odwoływania się do zasobu internetowego z obszarów, które nie obsługują używania $webresource: dyrektywy, można użyć względnego adresu URL. Aby to umożliwić, zalecamy użycie spójnej konwencji nazewnictwa dla zasobów internetowych, które odzwierciedlają strukturę plików wirtualnych. Prefiks dostosowywania wydawcy rozwiązania będzie zawsze dołączany jako prefiks nazwy zasobu internetowego. Może to reprezentować wirtualny folder "główny" dla wszystkich zasobów internetowych dodanych przez tego wydawcę. Następnie można użyć ukośnika ukośnika (/), aby zasymulować strukturę folderów, która będzie honorowana przez serwer internetowy.

Z innego zasobu internetowego należy zawsze używać względnych adresów URL, aby się odwoływać. Na przykład aby zasób new_/content/contentpage.htm internetowy strony sieci Web odwołył się do zasobu new_/Styles/styles.cssinternetowego CSS, utwórz link w następujący sposób:

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

Aby zasób internetowy strony internetowej otworzył zasób new_/content/contentpage.htmisv_/foldername/dialogpage.htminternetowy strony internetowej , utwórz link w następujący sposób:

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

Uwaga / Notatka

Nie używaj względnego adresu URL przy użyciu folderu WebResources jako ścieżki głównej adresu URL. Na przykład nie należy używać tego polecenia: /WebResources/<name of web resource>. Gdy użytkownik należy do więcej niż jednej organizacji na serwerze, ta ścieżka będzie zawsze odwoływać się do domyślnej organizacji użytkowników. Jeśli użytkownik nie korzysta z domyślnej organizacji i oczekiwany zasób internetowy nie jest uwzględniony w domyślnej organizacji użytkownika, występuje błąd "Nie znaleziono pliku", mimo że zasób internetowy występuje w organizacji, w ramach których użytkownik aktualnie pracuje.

Pełny adres URL

Poniższy przykład przedstawia styl adresu URL, którego można użyć do wyświetlania zasobów internetowych.

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

Aplikacja przetworzy ten adres URL i zwróci plik zawierający najnowszą wersję zasobu internetowego. Ten adres URL będzie wyglądać następująco:

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

Wartość wersji jest aktualizowana podczas publikowania dostosowań i zapewnia, że przeglądarka korzysta z najnowszej buforowanej wersji zasobu internetowego. W związku z tym użyj ścieżki względnej do zasobu internetowego Xrm.Navigation. funkcja openWebResource lub dyrektywa $webresource (jeśli to możliwe), ponieważ wartość wersji zostanie automatycznie uwzględniona. W przypadku dużych zasobów internetowych może mieć znaczący wpływ na wydajność, jeśli nie używasz buforowanej wersji pliku.

W poniższym przykładzie przedstawiono adres URL usługi Dynamics 365 for Customer Engagement, gdzie MyOrganization jest nazwą organizacji i new_/test/test.htm jest nazwą zasobu internetowego:

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

Uwaga / Notatka

Dołączenie znaku "/" i rozszerzenia nazwy pliku w nazwie zasobu internetowego jest opcjonalnym najlepszym rozwiązaniem.

Poniższy przykład przedstawia adres URL dla lokalnej usługi Dynamics 365 Customer Engagement (lokalnie), gdzie myServer to nazwa serwera:

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

Podczas pisania kodu w celu odwołania się do zasobu internetowego, który będzie musiał działać dla usługi Dynamics 365 for Customer Engagement lub lokalnej usługi Dynamics 365 Customer Engagement (lokalnie), należy użyć funkcji getClientUrl .

Narzędzia Wspólnoty

Oto niektóre narzędzia społeczności, które współpracują z zasobami internetowymi.

Nazwa narzędzia Więcej informacji
WebResourceManager https://github.com/gotdibbs/WebResourceManager
XrmToolkit https://xrmtoolkit.com/Home/Features
Menedżer webresources https://www.xrmtoolbox.com/plugins/MsCrmTools.WebResourcesManager/

Uwaga / Notatka

Narzędzia społeczności nie są produktem usługi Microsoft Dynamics, a firma Microsoft nie rozszerza wsparcia na narzędzia społeczności. Jeśli masz pytania dotyczące narzędzia, skontaktuj się z wydawcą narzędzia.

Zobacz także

Pisanie rozszerzeń aplikacji klienckich dla usługi Dynamics 365 Customer Engagement
Tworzenie dostępnych zasobów sieci Web
Strona sieci Web (HTML) Zasoby sieci Web
Zasoby internetowe programu Silverlight (XAP)
Zasoby internetowe skryptu (JScript)
Zasoby sieci Web obrazu
Zasoby internetowe arkusza stylów (XSL)
Zasoby internetowe danych (XML)
Zasoby sieci Web arkusza stylów (CSS)
Komunikaty i metody zasobów internetowych
Przykład: przekazywanie wielu wartości do zasobu internetowego za pośrednictwem parametru danych
Przykład: importowanie plików jako zasobów internetowych
Korzystanie z danych usługi sieci Web w zasobach sieci Web
Usprawnij opracowywanie zasobów internetowych przy użyciu narzędzia Fiddler AutoResponder

  • Last updated on