Добавяне на контрола за богат текстов редактор към приложение, управлявано от модел

Контролът на богатия текстов редактор е лек, HTML-базиран редактор, изграден върху популярния CKEditor. Тя ви позволява да създавате, поставяте и редактирате форматиран текст във вашите приложения, управлявани от модели. За да форматирате текст в редактора, можете да използвате лентата с инструменти на редактора, да вмъквате HTML етикети или да поставяте форматиран текст от други приложения, като уеб браузър или Word.

Можете да персонализирате външния вид, функциите и поведението на редактора. Модерният текстов опит на контролата е показан на следващата екранна снимка.

В момента богатият текстов редактор е достъпен като две различни изживявания:

• Модерен текстов редактор: Нов опит, който можете да активирате
• Класически текстов редактор: Опит по подразбиране

Съвременни подобрения в текстовия редактор

Съвременният текстов редактор е проектиран да се приведе в съответствие с познатите и интуитивни интерфейси на приложения на Microsoft като Outlook, Word и Word OneNote. Тази актуализация въвежда модерен дизайн, тъмен режим, теми с висок контраст и нова функция за копилот, за да подобрите възможностите си за редактиране на текст.

Бележка

Някои функционалности, които са налични в класическия богат текстов редактор, все още не са налични в съвременния опит. Такива функционалности включват:

• Опции за конфигуриране, както е описано в тази статия за класическата среда
• Споменавания

Активиране на модерния RTF текстов редактор

Класическият RTF текстов редактор е активиран по подразбиране. Изпълнете следните стъпки, за да превключите към модерния RTF текстов редактор.

1. В Dynamics 365 щракнете с десния бутон върху приложението, за което искате да разрешите модерния RTF текстов редактор, и след това изберете ОТВОРИ В APP DESIGNER. Power Apps отваря дизайнера на приложения.
2. В командната лента изберете Настройки. Показва се страницата с настройките.
3. В левия екран, в Настройки изберете Компоненти. Показва се страницата с функции.
4. Задайте превключвателя на Да за някоя или всички от следните опции, в зависимост от вашите нужди:
   • Активирайте модерен опит за контрол на RichTextEditor и описания на имейли: Позволява модерното изживяване за контрол на текстовия редактор за описания на имейли. Тази настройка отменя всички персонализации, които преди това сте направили в класическия (по подразбиране) имейл опит на редактора на RTF текст.
   • Активирайте модерен опит за управление на RichTextEditor за контроли по подразбиране: Разрешава модерното изживяване на RTF текстовия редактор за неконфигурирани по подразбиране екземпляри.
   • Активирайте модерен опит за управление на RichTextEditor за създаване на бележки: Активира модерния богат текстов редактор за бележки. Тази настройка отменя всички персонализации, които преди това сте луди по класическия (по подразбиране) опит за създаване на бележки на редактора на RTF текст.
5. Изберете Записване.
6. В App Designer изберете Публикуване.

Върнете се от модерния богат текстов редактор към класическия опит

Ако трябва да се върнете към класическия RTF текстов редактор, следвайте същите стъпки в Разрешаване на модерния RTF текстов редактор, но премахнете отметката от опциите, които сте избрали в стъпка 4.

Добавяне на контролата RTF текстов редактор към текстова колона

Следната конфигурация е налична в класическия RTF текстов редактор.

Когато форматирате текстова колона като RTF текст, контролата за RTF редактор по подразбиране се добавя автоматично.

1. Влезте в Power Apps.

2. В левия навигационен екран изберете Решения.

3. Отворете решение и таблица в решението.

4. В областта Колони и данни изберете колона с текст.

   Ако таблицата не съдържа текстова колона, изберете + (Нова колона) и въведете име за колоната.

5. В Тип данни изберете вдясно от > Текст и след това изберете подходящата опция TRTF текст въз основа на това дали колоната съдържа един ред текст, или няколко реда.

6. Запишете колоната и след това я добавете към формуляр.

Добавяне на контролата RTF текстов редактор към текстова колона във формуляр

Следната конфигурация е налична в класическия RTF текстов редактор.

1. Влезте в Power Apps.

2. В левия навигационен екран изберете Решения.

3. Отворете решение и таблица в решението.

4. В областта Опит с данните изберете Формуляри и след това намерете формуляра, съдържащ текстовата колона, към която искате да добавите RTF текстовия редактор.

5. Изберете ⋮ > Редактиране > Редактиране в нов раздел.

6. В платното разработчик за формуляри изберете, добавете или създайте текстова колона.

7. В екрана със свойствата на колоните разгънете списъка Компоненти, изберете + Компонент и след това изберете Контрола за RTF текстов редактор.

8. В контролния екран Добавяне на RTF текстов редактор изберете Уеб , телефон и таблет, за да разрешите на приложенията, изпълнявани на всяко устройство, да използват редактора.

   Ако искате да персонализирате редактора, въведете относителния URL адрес на неговия конфигурационен файл, уеб ресурс на JavaScript, който съдържа свойствата, които искате да промените, в полето Статична стойност . Ако оставите това поле празно, редакторът използва конфигурацията си по подразбиране.

9. Изберете Готово.

10. Изберете Запиши и публикувай, за да приложите промените си към формуляра.

Персонализиране на контролата RTF текстов редактор

Следните персонализации са налични в класическия RTF текстов редактор.

Power Apps Позволява ви да променяте свойствата на контролата RTF текстов редактор, за да персонализирате нейния облик, функции и поведение. За да персонализирате конкретен екземпляр на контролата, задайте свойства и техните стойности в отделен конфигурационен файл, форматиран с JSON. За да персонализирате глобалната конфигурация на контролата, променете свойствата в конфигурационния файл по подразбиране.

Нива на персонализиране

До три нива или слоеве на конфигурация могат да бъдат приложени за персонализиране на RTF текстов редактор:

1. На най-фундаментално ниво, всеки екземпляр на контролата взема своята конфигурация от файла RTEGlobalConfiguration_Readonly.json. Файлът е само за четене, така че не можете да променяте тези свойства директно.
2. На следващото ниво всеки екземпляр на контролата взема своята конфигурация от свойствата във файла RTEGlobalConfiguration.json, ако има такива. Тази конфигурация е наслоена върху предишната, така че свойствата в този файл заместват същите именувани свойства във файла само за четене.
3. И накрая, на най-високо ниво, конкретен екземпляр на контролата взема своята конфигурация от конкретен конфигурационен файл, ако има такъв. Тази конфигурация е наслоена върху предишната, така че свойствата в този файл заместват същите именувани свойства в двата файла от по-ниско ниво.

Тук трябва да добавим лека квалификация. Не всички свойства се заменят с тези в конфигурация от по-високо ниво. Свойствата extraPlugins се обединяват, за да позволят използването на широк спектър от външни и външни добавки в конфигурацията по подразбиране. Това ви позволява да активирате и деактивирате добавките, ако е необходимо, в конфигурационния файл за конкретни екземпляри на контролата.

Персонализиране на конкретен екземпляр на RTF текстовия редактор

1. В Visual Studio Code или друг текстов редактор създайте файл и му дайте смислено име.

   Файлът RTEGlobalConfiguration.json съдържа конфигурацията по подразбиране или глобалната конфигурация на редактора на RTF текст. Ако персонализирате контролата в, да речем, формуляр за контакт, може да наименувате файла нещо подобно RTEContactFormConfiguration.json.

2. Копирайте и поставете следните фрагмент от код във файла:

   {
   "defaultSupportedProps": {
     "propertyName": "value",
     "propertyName": "value",
     "propertyName": "value"
   },
   }
   

   Двойката фамилно свойствоИме:стойност не завършва със запетая.

3. Заменете свойствотоИме и стойност с контролните свойства на RTF текстовия редактор, които искате да промените. Стойностите на низове трябва да бъдат оградени в кавички.

   Предоставихме няколко примерни конфигурации за вас, но можете да определите други, които да отговарят на вашите нужди.

4. В Power Apps, създайте уеб ресурс тип JavaScript (JS), като използвате JSON файла, който създадохте в стъпка 1.

5. Добавете контролата RTF текстов редактор към текстова колона във формуляр и в контролния екран Добавяне на RTF текстов редактор > Статична стойност въведете относителния URL адрес на уеб ресурса JavaScript.

   Въпреки че можете да въведете абсолютния URL адрес на уеб ресурса, препоръчваме ви да въведете съответния URL адрес. По този начин уеб ресурсът все още работи, ако го импортирате като решение в друга среда, при условие че относителният път е същият.

   Например, ако URL адресът на уеб ресурса е https://yourorg.crm.dynamics.com/WebResources/rtecontactform, относителният URL адрес е /WebResources/rtecontactform.

6. Изберете Готово.

7. Изберете Запиши и публикувай, за да приложите промените си към формуляра.

Персонализиране на RTF текстовия редактор глобално

Редактируемият глобален конфигурационен файл RTEGlobalConfiguration.json е второто ниво на персонализиране , което можете да приложите. По подразбиране файлът е празен. Това означава, че всички екземпляри на RTF текстовия редактор използват свойствата във файла RTEGlobalConfiguration_Readonly.json само за четене, освен ако не създадете конфигурационен файл за конкретен екземпляр на контролата.

Ако нуждите на бизнеса ви изискват да персонализирате контролата навсякъде, задайте стойностите, от които се нуждаете, във RTEGlobalConfiguration.json файла. Използвайте файла само за четене като пример, за да сте сигурни, че въвеждате двойки свойство-стойност в правилния формат.

Използване на Copilot за прецизиране на текст в редактора

Copilot използва алгоритми за обработка на естествен език, за да помогне за подобряване на писменото съдържание. Можете да добавите Copilot към RTF текстовия редактор и след това да получите предложения за подобряване на граматиката, яснотата или цялостното качество на текста. Научете как да използвате Copilot в RTF текстовия редактор.

Свойства на редактор на богат текст

JSON файлът, който определя "изгледа и усещането" на екземпляр на RTF текстовия редактор, съдържа два набора от свойства:

• Разделът defaultSupportedProps съдържа свойства на добавки, които определят какво може да прави контролата. Не сте ограничени до свойствата на CKEditor и неговите плъгини. Можете също да зададете стойности за свойствата на добавките, които добавяте или създавате.
• Разделът за отделни свойства съдържа свойства, които определят как изглежда контролата.

Примерен конфигурационен файл

Следният код е пример за JSON файл, който съдържа както свойства, така defaultSupportedProps и индивидуални конфигурационни свойства. Ако дадено свойство има стойност по подразбиране, се показва стойността по подразбиране. Ако дадено свойство няма стойност по подразбиране, се показва примерна стойност, за да се илюстрира синтаксисът. Свойствата са описани в двете таблици, които следват.

"defaultSupportedProps": {
  "height": 185,
  "stickyStyle": {
    "font-size": "9pt",
    "font-family": "'Segoe UI','Helvetica Neue',sans-serif"
  },
  "stickyStyles_defaultTag": "div",
  "font_defaultLabel": "Segoe UI",
  "fontSize_defaultLabel": "9",
  "toolbarLocation": "bottom",
  "toolbar": [
  [ "CopyFormatting" ],
  [ "Font" ],
  [ "FontSize" ],
  [ "Bold" ],
  [ "Italic" ],
  [ "Underline" ],
  [ "BGColor" ],
  [ "TextColor" ],
  [ "BulletedList" ],
  [ "NumberedList" ],
  [ "Outdent" ],
  [ "Indent" ],
  [ "Blockquote" ],
  [ "JustifyLeft" ],
  [ "JustifyCenter" ],
  [ "JustifyRight" ],
  [ "Link" ],
  [ "Unlink" ],
  [ "Subscript" ],
  [ "Superscript" ],
  [ "Strike" ],
  [ "Image" ],
  [ "BidiLtr" ],
  [ "BidiRtl" ],
  [ "Undo" ],
  [ "Redo" ],
  [ "RemoveFormat" ],
  [ "Table" ]
 ],
  "plugins": [["button,toolbar,dialogui,dialog,autogrow,notification,clipboard,textmatch,fakeobjects,link,autolink,basicstyles,bidi,blockquote,panelbutton,panel,floatpanel,colorbutton,colordialog,listblock,richcombo,menu,contextmenu,copyformatting,enterkey,entities,popup,find,floatingspace,font,format,htmlwriter,horizontalrule,indent,indentblock,indentlist,justify,lineutils,openlink,list,liststyle,maximize,undo,menubutton,notificationaggregator,xml,ajax,pastetools,pastefromword,pastetext,preview,table,quicktable,removeformat,resize,selectall,showborders,sourcearea,specialchar,stylescombo,tab,tabletools,tableresize,tableselection,widgetselection,widget,wysiwygarea,textwatcher"]],
  "extraPlugins": "accessibilityhelp,autogrow,autolink,basicstyles,bidi,blockquote,button,collapser,colorbutton,colordialog,confighelper,contextmenu,copyformatting,dialog,editorplaceholder,filebrowser,filetools,find,floatpanel,font,iframerestrictor,indentblock,justify,notification,panel,panelbutton,pastefromword,quicktable,selectall,stickystyles,superimage,tableresize,tableselection,tabletools,uploadfile,uploadimage,uploadwidget",
  "removePlugins": "a11yhelp,codemirror,magicline,scayt,showborders",
  "superimageImageMaxSize": 5,
  "disallowedContent": "form[action]; *[formaction]; script; *[on*]",
  "linkTargets": ["notSet", "_blank"],
},
"attachmentEntity": {
  "name": "msdyn_richtextfiles",
  "fileAttributeName": "msdyn_fileblob"
},
"disableContentSanitization": true,
"disableDefaultImageProcessing": false,
"disableImages": false,
"externalPlugins": [
  {
    "name": "EmbedMedia",
    "path": "/WebResources/msdyncrm_/myplugins/embedmedia/"
  }
],
"imageEntity": {
  "imageEntityName": "msdyn_richtextfiles",
  "imageFileAttributeName": "msdyn_imageblob"
},
"readOnlySettings": {
  "height": 500,
  "showFullScreenExpander": true
},
"sanitizerAllowlist": {
  "attributes": [],
  "cssProperties": [],
  "domains": [],
  "protocols": [],
  "tags": []
},
"showAsTabControl": false,
"showFullScreenExpander": false,
"showHtml": false,
"showPreview": false,
"showPreviewHeaderWarning": false,
"allowSameOriginSandbox": false

defaultSupportedProps

Следващата таблица описва най-често използваните свойства, но можете да конфигурирате всички свойства, които CKEditor поддържа. Контролата на редактора на RTF текст използва CKEditor 4.

Свойство	Описание	Стойност по подразбиране
height	Задава началната височина на областта на съдържанието, в пиксели.	"185"
stickyStyle	Задава шрифта и размера на редактора.	Вижте defaultSupportedProps
stickyStyles_defaultTag	Създава обвивка около текста в областта за съдържание на редактора. Първоначално е зададено на "div", но можете да го промените на "p" или друг алтернативен етикет.	"див"
font_defaultLabel	Задава етикета на шрифта, показван в лентата с инструменти. Етикетът е само за външен вид и не е функционален. Свойството stickyStyle определя шрифта и размера на редактора.	"Segoe UI"
fontSize_defaultLabel	Задава етикета за размер на шрифта, показан в лентата с инструменти. Етикетът е само за външен вид и не е функционален. Свойството stickyStyle определя шрифта и размера на редактора.	"9"
toolbarLocation	Задава местоположението на лентата с инструменти в областта за съдържание на редактора. Поддържаните стойности са "отгоре" и "отдолу".	"дъно"
лента с инструменти	Изброява бутоните на лентата с инструменти за показване.	Вижте defaultSupportedProps
добавки	Изброява предварително зададени добавки, които редакторът може да използва. Добавките в този списък може да са различни от добавките, които са заредени, ако extraPlugins и removePlugins са получили стойност. Ако зададете това свойство на празен низ, редакторът се зарежда без лентата с инструменти.	Вижте defaultSupportedProps
extraPlugins	Добавя добавки към списъка, plugins за да зареди още добавки. Много плъгини изискват други плъгини, за да работят. Редакторът на RTF текст ги добавя автоматично и не можете да използвате това свойство, за да ги замените. Използвайте removePlugins вместо това.	Вижте defaultSupportedProps
removePlugins	Изброява добавките, които не трябва да се зареждат. Използвайте го, за да промените кои добавки се зареждат, без да променяте списъците plugins и extraPlugins .	Вижте defaultSupportedProps
superimageImageMaxSize	Задава максималния размер в мегабайти (МБ), разрешен за вградени изображения, когато се използва добавката за суперизображение.	"5"
забранено съдържание	Позволява ви да забраните на потребителите да вмъкват елементи, които не искате да имате в съдържанието си. Можете да забраните цели елементи или по атрибути, класове и стилове.	Вижте defaultSupportedProps
linkTargets	Позволява ви да конфигурирате кои опции за насочване на връзки са достъпни за потребителите, когато създават връзки: - "notSet": Няма поставена цел - "рамка": Отваря документа в указаната рамка - popupWindow": Отваря документа в изскачащ прозорец - "_blank": Отваря документа в нов прозорец или раздел - "_top": Отваря документа в цялото тяло на прозореца - "_self": Отваря документа в същия прозорец или раздел, където е активирана връзката - "_parent": Отваря документа в родителската рамка	"notSet", "_blank"

Индивидуални имоти

Следващата таблица описва още свойства, които можете да използвате, за да персонализирате контролата RTF текстов редактор.

Свойство	Описание	Стойност по подразбиране
attachmentEntity	За да наложите по-голяма защита на качените файлове с помощта на таблица, различна от тази по подразбиране, задайте това свойство и задайте друга таблица. Синтаксис: "име": "tableName", "fileAttributeName": "attributeNameofBlobReference"	Вижте defaultSupportedProps
disableContentSanitization	Санитизирането на съдържанието премахва някои персонализирани атрибути или етикети от съдържанието на RTF текст. Той е забранен по подразбиране, за да позволи копиране и поставяне на RTF текстово съдържание от външни източници. Този имот се отнася само за режим на редактиране. Когато контролата на редактора е само за четене или забранена, съдържанието винаги се дезинфекцира.	true
disableDefaultImageProcessing	По подразбиране изображенията, които се вмъкват в редактора, се качват в дефинираната attachmentEntity в конфигурацията. На външните потребители може да им липсват привилегии да виждат съдържанието в таблицата. Вместо това задайте това свойство на true, за да съхранявате изображения като base64 низове директно в колоната, конфигурирана да използва контролата RTF текстов редактор.	false
disableImages	Определя дали изображенията могат да бъдат вмъкнати в редактора. Този имот е с най-висок приоритет. Когато това свойство е настроено на истина, изображенията се забраняват, независимо от стойността на свойството imageEntity .	false
externalPlugins	Изброява външни добавки или добавки, които създавате, които могат да се използват в контролата RTF текстов редактор. Синтаксис: "име": "pluginName", "path": "pathToPlugin" (стойността на пътя може да бъде абсолютен или относителен URL адрес)	Никой; вижте defaultSupportedProps за пример
imageEntity	За да наложите по-голяма защита на изображенията с помощта на таблица, различна от тази по подразбиране, задайте това свойство и задайте друга таблица. Синтаксис: "imageEntityName": "tableName", "imageFileAttributeName": "attributeNameofBlobReference"	Вижте defaultSupportedProps
readOnlySettings	Тези свойства определят поведението на колоната, когато се разглежда в състояние само за четене или забранено. Можете да укажете всяко поддържано свойство.	Никой; вижте defaultSupportedProps за пример
sanitizerAllowlist	Изброява други видове съдържание, които могат да се показват в редактора.	Вижте defaultSupportedProps
showAsTabControl	Позволява ви да показвате повече команди над областта за съдържание. Трябва да се настрои на истина, за да се използват следните свойства: showFullScreenExpander, showHtml, showPreview, showPreviewHeaderWarning	false
showFullScreenExpander	Определя дали редакторът може да се използва в режим на цял екран. showAsTabControl трябва да бъде настроен на истина.	false
showHtml	Позволява на потребителите да показват и редактират HTML съдържанието директно. showAsTabControl трябва да бъде настроен на истина.	false
showPreview	Позволява на потребителите да визуализират съдържанието на редактора, рендирано като HTML. showAsTabControl трябва да бъде настроен на истина.	false
showPreviewHeaderWarning	Позволява ви да показвате или скривате предупредителното съобщение, което се показва при визуализиране на съдържание. showAsTabControl и showPreview трябва да бъде настроен на истина.	false
allowSameOriginSandbox	Позволява съдържанието в редактора да се третира от същия произход като приложението за рендиране. Използвайте този имот с повишено внимание. Използвайте само надеждно външно съдържание. Когато това свойство е настроено на истина, всяко външно съдържание може да има достъп до вътрешни ресурси.	false

Примерни конфигурации

Следните примерни конфигурации създават специфични персонализации на RTF текстовия редактор в класическия опит. Можете да ги използвате във вида, в който са, или като отправна точка, за да персонализирате конкретен екземпляр на RTF текстовия редактор или глобално.

Задаване на шрифта по подразбиране на Calibri с 11 пункта

Задайте тези defaultSupportedProps свойства във вашия конфигурационен файл. Всяка стойност, с изключение на последната, трябва да бъде последвана от запетая (,).

"font_defaultLabel": "Calibri",
"fontSize_defaultLabel": "11",
"stickyStyle": {
  "font-size": "11pt",
  "font-family": "Calibri/Calibri, Helvetica, sans-serif;"
},

Накарайте клавиша Enter да вмъкне нов ред вместо блок от абзац

По подразбиране натискането на клавиша Enter създава блок абзац с <p> HTML таг. HTML използва блокове от абзаци за групиране на информация, като например абзаци в документ на Word. Браузърите могат да форматират етикета <p> малко по-различно, така че за визуална последователност може да искате вместо това да използвате етикета за нов ред или нов ред <br\> .

Задайте това defaultSupportedProps свойство във вашия конфигурационен файл. Следвайте тази стойност със запетая (,), освен ако не е последното свойство във файла.

"enterMode": 2,

Поставяне или създаване само на HTML 5 съдържание

Въпреки че контролата за RTF текстов редактор работи най-добре с HTML 5 съдържание, можете да използвате HTML 4 тагове. В някои случаи обаче смесването на HTML 4 и HTML 5 тагове може да създаде предизвикателства за използваемостта. За да се уверите, че цялото съдържание е HTML 5, предоставете всички поддържани HTML 5 тагове в свойството allowedContent . Контролата на редактора преобразува всички несъвместими тагове в техния HTML 5 еквивалент.

Задайте това defaultSupportedProps свойство във вашия конфигурационен файл. Следвайте тази стойност със запетая (,), освен ако не е последното свойство във файла.

"allowedContent": "a(*)[*]{*};abbr(*)[*]{*};address(*)[*]{*};area(*)[*]{*};article(*)[*]{*};aside(*)[*]{*};audio(*)[*]{*};b(*)[*]{*};base(*)[*]{*};bdi(*)[*]{*};bdo(*)[*]{*};blockquote(*)[*]{*};body(*)[*]{*};br(*)[*]{*};button(*)[*]{*};canvas(*)[*]{*};caption(*)[*]{*};cite(*)[*]{*};code(*)[*]{*};col(*)[*]{*};colgroup(*)[*]{*};data(*)[*]{*};datalist(*)[*]{*};dd(*)[*]{*};del(*)[*]{*};details(*)[*]{*};dfn(*)[*]{*};dialog(*)[*]{*};div(*)[*]{*};dl(*)[*]{*};dt(*)[*]{*};em(*)[*]{*};embed(*)[*]{*};fieldset(*)[*]{*};figcaption(*)[*]{*};figure(*)[*]{*};footer(*)[*]{*};form(*)[*]{*};h1(*)[*]{*};h2(*)[*]{*};h3(*)[*]{*};h4(*)[*]{*};h5(*)[*]{*};h6(*)[*]{*};head(*)[*]{*};header(*)[*]{*};hr(*)[*]{*};html(*)[*]{*};i(*)[*]{*};iframe(*)[*]{*};img(*)[*]{*};input(*)[*]{*};ins(*)[*]{*};kbd(*)[*]{*};label(*)[*]{*};legend(*)[*]{*};li(*)[*]{*};link(*)[*]{*};main(*)[*]{*};map(*)[*]{*};mark(*)[*]{*};meta(*)[*]{*};meter(*)[*]{*};nav(*)[*]{*};noscript(*)[*]{*};object(*)[*]{*};ol(*)[*]{*};optgroup(*)[*]{*};option(*)[*]{*};output(*)[*]{*};p(*)[*]{*};param(*)[*]{*};picture(*)[*]{*};pre(*)[*]{*};progress(*)[*]{*};q(*)[*]{*};rp(*)[*]{*};rt(*)[*]{*};ruby(*)[*]{*};s(*)[*]{*};samp(*)[*]{*};section(*)[*]{*};select(*)[*]{*};small(*)[*]{*};source(*)[*]{*};span(*)[*]{*};strong(*)[*]{*};style(*)[*]{*};sub(*)[*]{*};summary(*)[*]{*};sup(*)[*]{*};svg(*)[*]{*};table(*)[*]{*};tbody(*)[*]{*};td(*)[*]{*};template(*)[*]{*};textarea(*)[*]{*};tfoot(*)[*]{*};th(*)[*]{*};thead(*)[*]{*};time(*)[*]{*};title(*)[*]{*};tr(*)[*]{*};track(*)[*]{*};u(*)[*]{*};ul(*)[*]{*};var(*)[*]{*};video(*)[*]{*};wbr(*)[*]{*};",

Поставяне или създаване само на обикновен текст

Задайте тези defaultSupportedProps свойства във вашия конфигурационен файл. Всяка стойност, с изключение на последната, трябва да бъде последвана от запетая (,).

"enterMode": 2,
"shiftEnterMode": 2,
"allowedContent": "*",
"disallowedContent": "*",
"forcePasteAsPlainText": true,
"toolbar": [],
"removePlugins": "contextmenu,liststyle,openlink,tableresize,tableselection,tabletools",

Задайте това отделно свойство във вашия конфигурационен файл. Следвайте тази стойност със запетая (,), освен ако не е последното свойство във файла.

"disableImages": true,

Разрешаване на редактора да използва целия екран

Задайте тези отделни свойства във вашия конфигурационен файл. Всяка стойност, с изключение на последната, трябва да бъде последвана от запетая (,).

"showAsTabControl": true,
"showFullScreenExpander": true,

Разрешаване на преглед и редактиране на HTML съдържание

За да позволите на потребителите да преглеждат и редактират HTML на съдържанието си директно, покажете раздела HTML .

Задайте тези отделни свойства във вашия конфигурационен файл. Всяка стойност, с изключение на последната, трябва да бъде последвана от запетая (,).

"showAsTabControl": true,
"showHtml": true,

Показване на опростена лента с инструменти или пълното й премахване

По подразбиране лентата с инструменти на редактора съдържа всички налични инструменти за форматиране. За да предоставите опростена лента с инструменти, използвайте свойството toolbar и задайте инструментите, които потребителите могат да използват, за да форматират съдържанието си.

Задайте това defaultSupportedProps свойство във вашия конфигурационен файл. Следвайте тази стойност със запетая (,), освен ако не е последното свойство във файла.

"toolbar": [ { "items": [ "FontSize", "Bold", "Italic", "Underline", "BGColor" ] } ],

За да премахнете изцяло лентата с инструменти, задайте стойността на toolbar '[]' (две квадратни скоби).

Добавете нов списък с шрифтове и задайте 20-пикселов Brush Script MT като шрифт по подразбиране

Задайте тези defaultSupportedProps свойства във вашия конфигурационен файл. Всяка стойност, с изключение на последната, трябва да бъде последвана от запетая (,).

"font_names": "Brush Script MT/'Brush Script MT', cursive;Calibri/Calibri, Helvetica, sans-serif;Calibri Light/'Calibri Light', 'Helvetica Light', sans-serif;"
"font_defaultLabel": "Brush Script MT"
"fontSize_sizes": "8/8px;12/12px;20/20px;32/32px"
"fontSize_defaultLabel": "20"
"stickyStyle": {
  "font-size": "20px",
  "font-family": "'Brush Script MT', cursive"
},

Позиционирайте лентата с инструменти в горната част на редактора на обогатен текст

Задайте това defaultSupportedProps свойство във вашия конфигурационен файл. Следвайте тази стойност със запетая (,), освен ако не е последното свойство във файла.

"toolbarLocation": "top",

Стартирайте редактора на височина 30 пиксела и растете, за да се побере в съдържанието

Задайте тези defaultSupportedProps свойства във вашия конфигурационен файл. Всяка стойност, с изключение на последната, трябва да бъде последвана от запетая (,).

"autoGrow_onStartup": false,
"autoGrow_maxHeight": 0,
"autoGrow_minHeight": 30,
"height": 30,

Фиксирайте височината на редактора на 500 пиксела

Задайте тези defaultSupportedProps свойства във вашия конфигурационен файл. Всяка стойност, с изключение на последната, трябва да бъде последвана от запетая (,).

"removePlugins": [ "autogrow" ],
"height": 500,

Направете контекстното меню (щракване с десния бутон) да използва контекстното меню по подразбиране на браузъра

За да замените контекстното меню на контролата на редактора с контекстното меню по подразбиране на браузъра, премахнете добавката за контекстно меню.

Задайте това defaultSupportedProps свойство във вашия конфигурационен файл. Следвайте тази стойност със запетая (,), освен ако не е последното свойство във файла.

"removePlugins": "contextmenu,liststyle,openlink,tableresize,tableselection,tabletools",

Намиране на конфигурацията на контрола на RTF текстов редактор

Ако не сте сигурни откъде идва конфигурацията на екземпляра на RTF текстовия редактор, можете да го намерите с помощта на инструментите за разработчици на браузъра си.

1. В Microsoft Edge или Google Chrome стартирайте приложението си, управлявано от модела, и отворете формуляр, който има контрола на RTF текстов редактор.
2. Щракнете с десния бутон върху областта за съдържание на RTF текстовия редактор и изберете Инспектиране.
3. В екрана за проверка изберете раздела Конзола .
4. Изберете родителската Main.aspx страница в списъчното поле на командната лента.

1. Изберете иконата Изчисти конзолата в командната лента на екрана за проверка и след това въведете CKEDITOR.config. в конзолата.

1. В конзолата на контролния панел въведете CKEDITOR.config. за показване на различните конфигурации.

1. Изберете конфигурация, като например autoGrow_minHeight, за да се покаже текущата настройка.

Лентата с инструменти на RTF текстовия редактор

Следващата таблица описва инструментите за форматиране, които са налични в RTF текстовия редактор по подразбиране.

Icon	Име	Клавиш за бърз достъп	Описание
	Копиране на форматиране	Ctrl+Shift+C, Ctrl+Shift+V	Приложете външния вид на определен раздел към друг раздел.
	Име на шрифт	Ctrl+Shift+F	Изберете шрифт. Приложението разглежда шрифта, който сте избрали шрифта по подразбиране. Segoe UI е шрифтът по подразбиране, ако не изберете такъв. Когато изберете форматирано съдържание, се показва името на шрифта, приложен към него. Ако вашата селекция съдържа няколко шрифта, се показва първият, приложен към селекцията.
	Размер на шрифт	Ctrl+Shift+P	Променете размера на текста си. Приложението взема предвид размера на шрифта, който сте избрали за размер по подразбиране. 12 е размерът по подразбиране, ако не изберете такъв. Когато изберете форматирано съдържание, се показва размерът на шрифта, приложен към него. Ако вашата селекция съдържа няколко размера, се показва първият, приложен към селекцията.
	bold	Ctrl+B	Направете вашия текст получер.
	Italic	Ctrl+I	Итализирайте своя текст.
	Подчертано	Ctrl+U	Подчертайте своя текст.
	Цвят на фона		Направете своя текст да се откроява, като го подчертавате в ярък цвят.
	Цвят на текста		Променете цвета на текста си.
	Вмъкване/премахване на списък с водещи символи		Създаване на списък с водещи символи.
	Вмъкване/премахване на номериран списък		Създаване на номериран списък.
	Намаляване на отстъпа		Преместете абзаца си по-близо до полето.
	Увеличаване на отстъпа		Преместете абзаца си по-далеч от полето.
	Блоков цитат		Приложете формат за оферта на блоково ниво към вашето съдържание.
	Подравняване отляво	Ctrl+L	Подравнете съдържанието си с левия марж.
	Подравняване в центъра	Ctrl+E	Центрирайте съдържанието си на страницата.
	Подравняване отдясно	Ctrl+R	Подравнете съдържанието си с правилния марж.
	Свържи		Създайте връзка във вашия документ за бърз достъп до уеб страници и други ресурси на облака. Въведете или поставете anchor текста в полето Показван текст и след това въведете или поставете URL адреса в полето URL адрес. По желание изберете тип връзка и протокол, ако връзката е към нещо различно от уеб страница. За да укажете къде трябва да се отваря връзка от тип URL адрес, изберете раздела Цел и след това изберете Цел. · Поставеният или въведен URL адрес автоматично се конвертира във връзка. Например, http://myexample.com става <a href="http://myexample.com">http://myexample.com</a>.
	Премахване на връзка		Премахнете връзката от котва и я направете обикновен текст.
	Горен индекс		Въведете малки букви точно над реда на текста.
	Долен индекс		Въведете малки букви точно под реда на текста.
	Зачеркване		Зачеркнете текст, като начертаете линия през него.
	Image		За да вмъкнете изображение, поставете го от клипборда в областта за съдържание или плъзнете файл с изображение от папка в областта за съдържание. Плъзнете всеки ъгъл на изображението, за да го преоразмерите. Контролата поддържа .png, .jpg. и .gif изображения. За да имате по-голям контрол върху източника, външния вид и поведението на изображението, изберете бутона Изображение . Намерете файла с изображение в локална папка или въведете неговия URL адрес. Ако изображението се съхранява на външен сървър, въведете абсолютния път. Ако е на локален сървър, можете да въведете относителен път. По желание въведете конкретна височина и ширина, за да преоразмерите изображението, и изберете подравняване. Трябва също да въведете алтернативен текст, за да опишете изображението за хора, които използват екранни четци. Ако изображението е и връзка към уеб страница или друг облачен ресурс, въведете URL адреса на ресурса в полето Целеви URL и, ако е необходимо, изберете Цел , където трябва да се отвори връзката.
	Посока на текста от ляво надясно		Променете текста отляво надясно. Тази настройка е по подразбиране.
	Посока на текста от дясно наляво		Променете текста отдясно наляво за двупосочно езиково съдържание.
	Отмяна		Обърнете последната промяна, която сте направили в съдържанието.
	Повторение		Отменете последната отмяна или приложете отново последната промяна, която сте направили в съдържанието.
	Премахване на форматирането		Премахване на цялото форматиране от избрания текст.
	Table		Вмъкнете таблица с броя на редовете и колоните, които сте избрали. За да имате по-голям контрол върху размера и облика на таблицата, изберете бутона Таблица > Още и променете свойствата й. Можете също да щракнете с десния бутон върху таблица, за да прегледате и промените свойствата й. За да промените ширината на колона, плъзнете границата й. Можете да изберете една или повече клетки, редове или колони и да приложите конкретно форматиране, да добавите връзка към избрания текст и да изрежете, копирате и поставите цели редове или колони.
	Настройки за персонализиране		Задайте шрифта и размера на шрифта по подразбиране.
	Помощ за достъпност	Alt + 0	Отворете списъка с клавишни комбинации, които можете да използвате в RTF текстовия редактор.
	Разгъване на лентата с инструменти		Когато прозорецът е твърде тесен, за да покаже цялата лента с инструменти, изберете да разгънете лентата с инструменти на втори ред.

Съвет

За да използвате вградената правописна проверка на браузъра, натиснете клавиша Ctrl, докато щраквате с десния бутон върху текста, който искате да проверите. В противен случай менюто за щракване с десния бутон (контекст) предоставя контекстно форматиране за избрания от вас елемент.
Алтернатива на вградената проверка на правописа на вашия браузър е разширението за браузър Microsoft Editor. Microsoft Editor работи безпроблемно с контрола на RTF текстовия редактор и когато е активиран, осигурява бърза и лесна вградена граматика и възможности за проверка на правописа.

Използване на RTF текстовия редактор офлайн

Контролата за RTF текстов редактор е налична, когато работите офлайн, макар и без някои от функциите и функционалността, с които сте свикнали. Изображенията, които качвате с помощта на конфигурацията по подразбиране на редактора, не са налични, когато работите офлайн.

Следните добавки са достъпни за RTF текстовия редактор, когато е офлайн:

• Ajax, autogrow, basicstyles, bidi, blockquote, button, confighelper, contextmenu, dialog, dialogui, editorplaceholder, enterkey, entities, fakeobjects, floatingspace, floatpanel, format, horizontalrule, htmlwriter, indent, indentblock, indentlist, justify, lineutils, list, listblock, maximize, menubutton, notificationaggregator, panel, panelbutton, popup, preview, removeformat, resize, richcombo, selectall, showborders, sourcearea, specialchar, stylescombo, tab, textmatch, textwatcher, лента с инструменти, отмяна, widgetselection, wysiwygarea, xml

Следните инструменти за форматиране са налични в RTF текстовия редактор, когато е офлайн:

• Получер, курсив, подчертаване, списъци с водещи символи и номериране, намаляване и увеличаване на отстъпа, блокиране на цитат, подравняване отляво, центрирано подравняване, подравняване надясно, зачеркване, двупосочен текст, отмяна и връщане и премахване на форматирането

Най-добри практики за използване на редактора на богат текст

• Полетата с RTF текст съхраняват HTML тагове за форматиране заедно с въведените от потребителя данни. Когато задавате максималния размер на RTF текстови полета, уверете се, че разрешавате както HTML таговете, така и данните на потребителя.

• За най-добра производителност запазете HTML съдържанието си до 1 MB или по-малко. При по-големи размери може да забележите по-бавно време за реакция при зареждане и редактиране.

• В конфигурацията по подразбиране изображенията не влияят отрицателно на производителността, тъй като се съхраняват отделно от HTML съдържанието. Изображенията обаче се съхраняват като base64 съдържание в текстовата колона, когато потребителят, който ги качва, няма разрешения в таблицата msdyn_richtextfiles . Съдържанието на Base64 е голямо, така че обикновено не искате да съхранявате изображения като част от съдържанието на колоната.

• Ако имате системен администратор или основен потребителски права за достъп, функцията за персонализиране на потребителя работи по подразбиране. Ако нямате тези роли, трябва да имате привилегии да създавате, четете и пишете в таблицата msdyn_customcontrolextendedsettings , за да работи добавката за персонализиране на потребителя.

Често задавани въпроси

Защо въведените знаци се показват бавно?

Ако имате много съдържание в редактора, времето за реакция може да се увеличи. Запазете съдържанието до 1 MB или по-малко за най-добра производителност. Проверките на правописа или граматиката също могат да забавят производителността на писане.

Защо не мога да кача изображение? Защо визуализацията на изображението не се зарежда?

Ако името на файла с изображението, включително пътят, е дълго, файлът може да не успее да се качи или визуализацията може да не се покаже. Опитайте да съкратите името на файла или да го преместите на място с по-кратък път, след което да го качите отново.

Защо виждам HTML в текста си?

Ако контролата RTF текстов редактор се използва в колона, която не е форматирана за RTF текст, съдържанието се появява в основния HTML, вместо като форматиран текст.

За да разрешите този проблем, вижте уверете се, че форматът на колоната е зададен на RTF текст.

Вижте също

• Създаване и редактиране на колони за Microsoft Dataverse с помощта на портала на Power Apps
• Използвайте Copilot в RTF текстов редактор за имейл

Бележка

Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)

Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).