Поділитися через

Посібник: налаштування елемента керування «Редактор форматованого тексту» в Power Pages

  • Стаття

У посібнику показано, як настроїти компонент редактора форматованого тексту у формі Microsoft Dataverse та ввімкнути редактор форматованого тексту для відображення на вебсторінці.

У цьому посібнику використовується таблиця Відгуки й вебсторінка Контактні дані, доступні в шаблонах Макет початківця.

вимоги

  • Версія порталу має бути 9.4.3.x або пізніша.
  • Сайт, що використовує один із шаблонів Макет початківця.

Крок 1. Додавання компонента коду до поля у формі

  1. У студії дизайну виберіть робочу область «Дані».

  2. Виберіть таблицю Відгуки.

  3. Виберіть Форми, а потім виберіть проста форма «Контактні дані» для редагування.

  4. Виберіть поле Повідомлення.

  5. Виберіть + Компонент і виберіть компонент Введення числа.

    Додайте компонент RTE до форми.

  6. Виберіть Готово.

  7. Натисніть Зберегти, а потім – Опублікувати форму.

Крок 2. Налаштування компонента редактора форматованого тексту на вебсторінці

На наступних кроках ми налаштуємо наявну сторінку відгуків. Ви також можете створити власну сторінку та додати власний компонент форми.

  1. У робочій області Сторінки виберіть сторінку Контактні дані.

  2. Поле Повідомлення має з’явитися у формі з повідомленням Увімкнути настроюваний компонент, щоб побачити це поле в попередньому перегляді.

  3. Виберіть поле й натисніть Редагувати поле.

  4. Виберіть поле Увімкнути настроюваний компонент.

    Увімкнення компонента RTE в студії дизайну.

  5. Виберіть ОК.

  6. Виберіть Синхронізувати.

Нотатка

Щоб дані відображалися як форматований текст, можливо, доведеться збільшити розмір текстових стовпців для розміщення додаткових відомостей.

Крок 3.1. Додавання дозволів таблиці для таблиці вкладень форматованого тексту

Для використання та збереження зображень у редакторі форматованого тексту на порталі потрібно додати дозволи таблиці до таблиці вкладень форматованого тексту (msdyn_richtextfile).

  1. Відкрийте студію дизайну й натисніть Налаштувати робочу область.

  2. Виберіть Дозволи таблиць.

  3. Виберіть + Створити нові дозволи щоб створити нові дозволи таблиці для таблиці вкладень форматованого тексту. Можна вибрати будь-яке ім’я; у цьому прикладі використовується ім’я Вкладення RTE.

  4. Для параметра Тип доступу виберіть Глобальний доступ.

    Нотатка

    Тип Глобальний доступ вибрано, оскільки не існує зв’язку між таблицею, налаштованою для використання елемента керування «Редактор форматованого тексту», і таблицею вкладень форматованого тексту.

  5. У розділі Дозвіл на установіть прапорці Читання, Записування, Створення й Видалення.

  6. Призначте відповідну веброль дозволу таблиці.

    Конфігурація дозволів таблиці форматованого тексту.

Важливо

Якщо потрібно зберігати зображення як рядки base 64 безпосередньо у стовпці, налаштованому для використання елемента керування «Редактор форматованого тексту», слід налаштувати елемент керування за допомогою файлу конфігурації JSON. Установіть для параметрів disableImages і disableDefaultImageProcessing значення true, щоб дозволити послідовне відтворення зображень у всіх клієнтах. За використання цього способу не потрібен глобальний дозвіл таблиці на доступ до таблиці вкладення форматованого тексту (msdyn_richtextfile).

Крок 3.2. Додавання параметрів сайту для веб-API.

Щоб зберегти зображення в елементі керування редактором форматованого тексту, необхідно додати кілька параметрів сайту.

  1. Відкрийте програму «Керування порталами».

  2. Перейдіть до Параметрів сайту.

  3. Створіть такі настройки сайту: введіть ім’я, свій веб-сайт і значення true , а потім натисніть Зберегти та закрити.

    Назва параметра сайту Значення
    Webapi/msdyn_richtextfile/enabled істина
    Webapi/msdyn_richtextfile/fields *

Крок 4. Попередній перегляд сайту.

  1. У студії дизайну виберіть Синхронізація.

  2. Виберіть Попередній перегляд, а потім виберіть Робочий стіл, перейдіть на сторінку Контактні дані. Ви побачите, що настроюваний компонент увімкнуто.

    Компонент RTE у формі.

Редактор форматованого тексту у формі лише для читання

У формі лише для читання редактор форматованого тексту відображає вміст із форматуванням і зображеннями. Вміст можна читати, але не можна змінювати або оновлювати.

Нотатка

Для перетягування підтримуються лише формати файлів .PNG, .JPG або .GIF.

Відображення поля вмісту редактора форматованого тексту за допомогою liquid або Pages Web API

Поле вмісту редактора форматованого тексту можна відтворити за допомогою Liquid або Pages Web API. Якщо поле містить будь-які файли зображень, вони матимуть шлях посилання на Dataverse веб-API. Щоб відобразити ці зображення на веб-сторінці Pages, потрібно замінити поточний шлях на відповідний шлях Pages API.

Приклад:

Елемент зображення в полі вмісту редактора форматованого тексту буде відображатися наступним чином, що містить посилання на Dataverse шлях Web API:

   <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">

Щоб оновити елемент зображення, замініть /api/data/v9.0 на /_api , як показано нижче:

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

Див. також