Samouczek: konfigurowanie kontrolki rich text editor w Power Pages

W samouczku skonfigurujesz składnik edytora tekstu sformatowanego w formularzu Microsoft Dataverse oraz włączysz wyświetlanie edytora tekstu sformatowanego na stronie internetowej.

W tym samouczku zostaną wykorzystane tabela Feedback oraz strona internetowa Kontakt z nami, które są dostępne w szablonach układu Starter.

Wymagania wstępne

  • Witryna korzystająca z jednego z szablonów układu startowego.

Krok 1. Dodawanie składnika kodu do pola w formularzu

  1. W studiu projektowym wybierz obszar roboczy Dane.

  2. Wybierz tabelę Feedback.

  3. Wybierz Formularze i wybierz edycję prostego formularza kontaktowego.

  4. Wybierz pole Wiadomość.

  5. Wybierz + Składnik i wybierz składnik Numer wejściowy.

    Dodawanie składnika RTE do formularza.

  6. Wybierz Gotowe.

  7. Wybierz Zapisz i Opublikuj formularz.

Krok 2. Konfigurowanie składnika kontrolki rich text editor w witrynach internetowych

W poniższych krokach skonfigurujemy istniejącą stronę opinii, możesz także utworzyć własną stronę i dodać własny składnik formularza.

  1. W obszarze roboczym Strony wybierz stronę Skontaktuj się z nami.

  2. Pole Wiadomość powinno zostać wyświetlone w formularzu z komunikatem Włącz składnik niestandardowy, aby zobaczyć to pole w podglądzie.

  3. Zaznacz pole i wybierz Edytuj pole.

  4. Wybierz pole Włącz niestandardowe pole składnika.

    Włącz komponent RTE w studio projektowym.

  5. Wybierz pozycję OK.

  6. Wybierz Synchronizuj.

Uwaga

Aby wyświetlić dane jako tekst sformatowany, może być konieczne zwiększenie rozmiaru znaków w kolumnach tekstowych, aby pomieścić dodatkowe informacje.

Krok 3.1 Dodanie uprawnień tabeli dla tabeli załączników z bogatym tekstem

Aby używać i przechowywać obrazy w edytorze tekstu sformatowanego na portalu, musisz dodać uprawnienia tabeli do tabeli załączników tekstu sformatowanego (msdyn_richtextfile).

  1. Otwórz studio projektowe i wybierz obszar roboczy Zabezpieczenia .

  2. Wybierz uprawnienia do tabeli.

  3. Wybierz + Nowe uprawnienie, aby utworzyć nowe uprawnienie tabeli dla tabeli załączników z tekstem sformatowanym. Nazwa może być dowolna; w tym przykładzie użyto Załącznik RTE.

  4. Dla typu Dostęp wybierz opcję Dostęp globalny.

    Uwaga

    Wybrano typ Dostęp globalny, ponieważ nie istnieje relacja między tabelą skonfigurowaną do używania kontrolki rich text editor a tabelą załączników tekstu sformatowanego.

  5. W sekcji Zezwolenie na zaznacz pola wyboru Odczyt, Zapis, Utwórz i Usuń.

  6. Przypisz odpowiednią rolę internetową do uprawnienia do tabeli.

Ważne

Jeśli chcesz przechowywać obrazy jako ciągi w formacie Base64 bezpośrednio w kolumnie skonfigurowanej do używania kontrolki edytora tekstu sformatowanego, musisz skonfigurować kontrolkę za pomocą pliku konfiguracyjnego JSON. Ustaw opcje disableImages i disableDefaultImageProcessing na true, aby obrazy były renderowane w sposób jednolity dla wszystkich klientów. Korzystanie z tej metody nie wymaga uprawnień do tabeli globalnej w tabeli załączników z tekstem sformatowanym (msdyn_richtextfile).

Krok 3.2. Dodaj ustawienia witryny internetowego interfejsu API

Aby zapisywać załączniki obrazów i plików oraz uzyskiwać do nich dostęp w formancie edytora tekstu sformatowanego, dodaj następujące ustawienia witryny.

  1. Otwórz aplikację Zarządzanie portalami.

  2. Przejdź do Ustawienia witryny.

  3. Utwórz następujące ustawienia witryny. Jeśli dla Twojej witryny istnieje już jedno z tych ustawień witryny, zaktualizuj istniejący rekord zamiast tworzyć duplikat. Wprowadź nazwę, wybierz witrynę internetową, wprowadź określoną wartość, a następnie wybierz pozycję Zapisz i zamknij.

    Nazwa ustawień witryny Wartość
    Webapi/msdyn_richtextfile/enabled prawda
    Webapi/msdyn_richtextfile/fields msdyn_richtextfileid,msdyn_name,msdyn_imageblob,msdyn_fileblob,msdyn_parententityname,msdyn_parententity_fieldname,msdyn_parentid,kod stanu,kod stanu

Ważne

Użyj pełnej jawnej listy kolumn wyświetlanej dla elementu Webapi/msdyn_richtextfile/fields. Kolumna msdyn_fileblob jest wymagana, aby uzyskać dostęp do załączników do plików, mimo że jest to kolumna tylko do odczytu. Niekompletna lista może sprawić, że załączniki obrazów będą działać, podczas gdy załączniki plików nie będą działać.

Krok 4. Podgląd witryny.

  1. W programie Design Studio wybierz opcję Synchronizacja.

  2. Wybierz opcję Podgląd, a następnie wybierz pozycję Pulpit, przejdź do strony Kontakt z nami , aby wyświetlić włączony składnik niestandardowy.

    Składnik RTE w formularzu.

Edytor rtf na formularzu tylko do odczytu

W formularzu tylko do odczytu edytor tekstu sformatowanego wyświetla treść wraz z formatowaniem i obrazami. Zawartość można odczytywać, ale nie edytować ani aktualizować.

Uwaga

Tylko formaty plików PNG, JPG lub GIF są obsługiwane w przypadku przeciągania i upuszczania.

Renderowanie pola zawartości z edytora tekstu sformatowanego przy użyciu języka Liquid lub interfejsu API stron internetowych Pages

Pole zawartości edytora tekstu sformatowanego może być renderowane przy użyciu Liquid lub interfejsu API sieci Web usługi Pages. Jeśli pole zawiera jakiekolwiek pliki obrazów, będą one miały ścieżkę odwołania interfejsu API sieci Web usługi Dataverse. Aby wyświetlić te obrazy na stronie internetowej Strony, musisz zastąpić bieżącą ścieżkę odpowiednią ścieżką interfejsu API stron.

Przykład:

Element obrazu w polu zawartości edytora tekstu sformatowanego zostanie wyświetlony w następujący sposób i będzie zawierał odniesienie do ścieżki internetowego interfejsu API Dataverse:

   <img loading="lazy" src="/api/data/v9.0/msdyn_richtextfiles(d0a473a4-9e95-ee11-be37-000d3a5c393e)/msdyn_imageblob/$value?size=full" style="height:61px; width:376px">

Aby zaktualizować element obrazu, zamień /api/data/v9.0 na /_api, jak pokazano niżej:

   <img loading="lazy" src="/_api/msdyn_richtextfiles(d0a473a4-9e95-ee11-be37-000d3a5c393e)/msdyn_imageblob/$value?size=full" style="height:61px; width:376px">

Zobacz też

  • Last updated on