RTF-editori-ohjausobjektin lisääminen mallipohjaiseen sovellukseen

RTF-editorin ohjausobjekti on HTML-pohjainen kevyt editori, joka on muodostettu suositun CKEditorin avulla. Sen avulla voit luoda, liittää ja muokata muotoiltua tekstiä mallipohjaisissa sovelluksissa. Jos haluat muotoilla tekstiä editorissa, voit editorin työkalurivin, lisätä HTML-tunnisteita tai liittää muotoiltua tekstiä muista sovelluksista, kuten selaimesta tai Word.

Voit mukauttaa editorin ulkoasua, ominaisuuksia ja toimintatapoja.

Modernin tekstieditorin parannukset

Nykyaikainen tekstieditori on suunniteltu vastaamaan Microsoft sovellusten, kuten Outlook, Word ja OneNote, tuttuja ja intuitiivisia käyttöliittymiä. Tämä oletuksena määritetty käyttökokemus esittelee modernin rakenteen, tumman tilan, suuren kontrastin teemat ja uuden Copilot ominaisuutta tekstinmuokkausominaisuuksien parantamiseksi.

RTF-editori-ohjausobjektin lisääminen lomakkeen tekstisarakkeeseen

1. Kirjaudu sisään kohtaan Power Apps.

2. Valitse vasemmasta siirtymisruudusta Ratkaisut.

3. Avaa ratkaisu ja avaa taulukko ratkaisussa.

4. Valitse Tietokokemukset-alueella Lomakkeet ja avaa lomake, joka sisältää tekstisarakkeen, johon haluat lisätä RTF-editorin.

5. Valitse lomakkeiden suunnitteluohjelman kaaviossa aiemmin luotu tekstisarake. Vaihtoehtoisesti voit luoda uuden tekstisarakkeen valitsemalla Uusi taulukkosarake, syöttämällä näyttönimen, valitsemalla Tietotyyppi-arvoksi >Rich text ja valitsemalla sitten Tallenna.

   Muistiinpano

   Jos haluat lisätä RTF-editori-ohjausobjektin olemassa olevaan sarakkeeseen, muuta ensin sarakkeen tietotyypiksi Teksti (jos se ei ole jo tekstisarake) ja valitse sitten Muoto käyttäen Rich text -vaihtoehtoa.

6. Laajenna sarakkeen Ominaisuudet-ruudussa Komponentit-luettelo, valitse + Komponentti ja valitse sitten RTF-editori-ohjausobjekti.

7. Valitse Lisää RTF-editorin ohjausobjekti -ruudussa Verkko, Puhelin ja Tabletti, jotta millä tahansa laitteella käytettävät sovellukset voivat käyttää editoria.

   Jos haluat mukauttaa RTF-editorin, kirjoita sen määritystiedoston suhteellinen URL-osoite, JavaScript-verkkoresurssi, joka sisältää muutettavat ominaisuudet, Staattinen arvo -ruutuun. Jos jätät tämän kentän tyhjäksi, editori käyttää oletusmääritystä.

8. Valitse Valmis. Rich text -sarake lisätään lomakkeeseen.

   

9. Valitse Tallenna ja julkaise ottaaksesi muutokset käyttöön lomakkeessa.

RTF-editorin ohjausobjektin lisääminen tekstisarakkeeseen

Voit myös luoda sarakkeen taulukolle, joka käyttää RTF-editori-ohjausobjektia. Seuraavissa vaiheittaisissa ohjeissa näytetään, miten voit luoda tekstisarakkeen, jonka voit myöhemmin lisätä lomakkeeseen mallipohjaista sovellusta varten.

1. Kirjaudu sisään kohtaan Power Apps.

2. Valitse vasemmasta siirtymisruudusta Ratkaisut.

3. Avaa ratkaisu ja taulukko ratkaisussa.

4. Valitse Rakenne-alueella Sarakkeet ja avaa sitten tekstisarake.

   Jos taulukko ei sisällä tekstisaraketta, valitse Uusi sarake ja syötä sarakkeelle nimi.

5. Valitse oikeanpuoleisessa ruudussa Muoto ja valitse sitten Rich text.

6. Tallenna sarake.

RTF-editorin ohjausobjektin mukauttaminen

Alla mainitut mukautukset ovat käytettävissä perinteisessä RTF-editorikokemuksessa.

Power Apps avulla voit muuttaa RTF-editorin ominaisuuksia sen ulkoasun, ominaisuuksien ja toiminnan mukauttamiseksi. Voit mukauttaa ohjausobjektin tietyn esiintymän, määritä ominaisuudet ja niiden arvot erillisessä JSON-muotoisessa määritystiedostossa. Voit muokata ohjausobjektin yleistä määritystä muuttamalla oletusarvoisen määritystiedoston ominaisuuksia.

Mukautustasot

Voit käyttää enintään kolmea määritystasoa eli tasoa mukauttaaksesi rtf-editoria:

1. Alimmalla perustasolla jokaisen ohjausobjektin esiintymän määritys perustuu tiedostoon RTEGlobalConfiguration_Readonly.json. Tiedosto on vain -luku, joten et voi muuttaa näitä ominaisuuksia suoraan.

   Muistiinpano

   RTEGlobalConfiguration.json ei koske sähköpostia, tietoartikkeleita, sähköpostimalleja ja allekirjoituksia.

2. Seuraavalla tasolla jokaisen ohjausobjektin esiintymän määritys perustuu RTEGlobalConfiguration.json-tiedoston ominaisuuksiin, jos niitä on. Tämä määritys rakentuu edellisen päälle, joten tämän tiedoston ominaisuudet korvaavat samannimiset vain luku -tiedoston ominaisuudet.

3. Korkeimmalla tasolla ohjausobjektin yksittäisen esiintymän määritys perustuu yksittäiseen määritystiedostoon, jos sellainen on. Tämä määritys rakentuu edellisen päälle, joten tämän tiedoston ominaisuudet korvaavat samannimiset kahden alemman tason tiedoston ominaisuudet.

Järjestelmä ei korvaa kaikkia ominaisuuksia ylätason määrityksen ominaisuuksilla. Ominaisuudet extraPlugins yhdistetään, jotta oletusmäärityksessä voidaan käyttää useita erilaisia ulkoisia ja valmiita laajennuksia. Tämän yhdistämistoiminnon avulla voit aktivoida ja poistaa laajennusten aktivoinnin tarpeen mukaan määritystiedostossa tiettyjä ohjausobjektin esiintymiä varten.

RTF-editorin yksitäisen esiintymän mukauttaminen

1. Luo Visual Studio Code tai muussa tekstieditorissa tiedosto ja anna sille merkityksellinen nimi.

   RTEGlobalConfiguration.json-tiedosto sisältää RTF-editorin oletus- tai yleisen määrityksen. Jos mukautat ohjausobjektia esimerkiksi yhteystietolomakkeessa, voit antaa tiedoston nimeksi jotakin seuraavan kaltaista: RTEContactFormConfiguration.json.

2. Kopioi ja liitä seuraava koodikatkelman tiedostoon:

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

Viimeinen propertyName:value-pari ei pääty pisteeseen.

3. Korvaa propertyName ja arvo niillä RTF-editorin ohjausobjektin ominaisuuksilla, jotka haluat muuttaa. Merkkijonoarvojen on oltava lainausmerkeissä.

   Käytettävissä on muutamia esimerkkimäärityksiä, mutta voit myös määrittää uusia määrityksiä tarpeiden mukaan.

4. Power Apps luo JavaScript (JS) tyyppi verkkoresurssi käyttämällä vaiheessa 1 luomaasi JSON-tiedostoa.

5. Lisää RTF-editorin ohjausobjekti tekstisarakkeeseen lomakkeessa ja syötä Lisää RTF-editorin ohjausobjekti -ruudussa >Staattinen arvo -kohtaan JavaScript-verkkoresurssin suhteellinen URL-osoite.

   Vaikka voit kirjoittaa web-resurssin absoluuttisen URL-osoitteen, suosittelemme, että annat suhteellisen URL-osoitteen. Silloin verkkoresurssi toimii edelleen, jos tuot sen ratkaisuna eri ympäristöön, kunhan suhteellinen polku on sama.

   Jos verkkoresurssin URL-osoite esimerkiksi on https://yourorg.crm.dynamics.com/WebResources/rtecontactform, suhteellinen URL-osoite on /WebResources/rtecontactform.

6. Valitse Valmis.

7. Valitse Tallenna ja julkaise ottaaksesi muutokset käyttöön lomakkeessa.

RTF-editorin yleinen mukauttaminen

Muokattava yleinen määritystiedosto RTEGlobalConfiguration.json on toinen käytettävissä oleva mukautuksen taso. Tiedosto on oletusarvoisesti tyhjä. Tämä tarkoittaa, että kaikki RTF-editorin esiintymät käyttävät vain -luku tiedoston RTEGlobalConfiguration_Readonly.json ominaisuuksia, ellet luo määritystiedostoa tietylle ohjausobjektin esiintymälle.

Jos liiketoimintatarpeesi edellyttävät ohjausobjektin määrittämistä kaikkialla, määritä tarvitsemasi arvot RTEGlobalConfiguration.json-tiedostossa. Käytä vain luku -tiedostoa esimerkkinä varmistaaksesi, että syötät ominaisuus-arvopareja oikeassa muodossa.

tekstin hienosäätäminen editorissa Copilot avulla

Copilot käyttää luonnollisen kielen käsittelyalgoritmeja parantamaan kirjoitettua sisältöä. Voit lisää Copilot tekstimuotoilueditoriin ja saada sitten ehdotuksia tekstisi kieliopin, selkeyden tai yleisen laadun parantamiseksi. Oppi Copilot käyttäminen RTF-editorissa.

Rich text editorin ominaisuudet

JSON-tiedosto, joka määrittää RTF-editorin esiintymän "ulkonäön ja tunnun" sisältää kaksi ominaisuusjoukkoa:

• defaultSupportedPropsOsa sisältää sellaisten laajennusten ominaisuuksia, jotka määrittävät, mitä ohjausobjekti voi tehdä. Et ole rajoitettu CKEdiorin ja sen laajennusten ominaisuuksiin. Voit myös määrittää arvoja lisäämiesi tai luomiesi laajennusten ominaisuuksille.
• Yksilöllisten ominaisuuksien osa sisältää ominaisuuksia, jotka määrittävät, miltä ohjausobjekti näyttää.

Määritystiedostoesimerkki

Seuraava koodi on esimerkki JSON-tiedostosta, joka sisältää sekä defaultSupportedProps-ominaisuuksia että yksilöllisiä määritysominaisuuksia. Jos ominaisuudella on oletusarvo, oletusarvo on näkyvissä. Jos ominaisuudella ei ole oletusarvoa, näkyviin tulee esimerkkiarvo kuvaamaan syntaksia. Ominaisuudet kuvataan kahdessa seuraavassa taulukossa.

{
    "defaultSupportedProps": {
        "height": 185,
        "stickyStyle": {
            "font-size": "12pt",
            "font-family": "'Segoe UI','Helvetica Neue',sans-serif"
        },
        "enterMode": 1,
        "stickyStyles_defaultTag": "div",
        "font_defaultLabel": "Segoe UI",
        "fontSize_defaultLabel":"12",
        "toolbarLocation": "top",
        "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" ]
        ],
        "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",
        "toolbarcollapser_enableResizer": false,
        "placeholder":"",
        "linkTargets": ["notSet", "_blank"],
        "stylesSet": "default",
        "fontSize_sizes": "8/8px;9/9px;10/10px;11/11px;12/12px;14/14px;16/16px;18/18px;20/20px;22/22px;24/24px;26/26px;28/28px;36/36px;48/48px;72/72px",
        "font_names": "Angsana New/'Angsana New', 'Leelawadee UI', Sathu, serif;Arial/Arial, Helvetica, sans-serif;Arial Black/'Arial Black', Arial, sans-serif;Calibri Light/'Calibri Light', 'Helvetica Light', sans-serif;Calibri/Calibri, Helvetica, sans-serif;Cambria/Cambria, Georgia, serif;Candara/Candara, Optima, sans-serif;Century Gothic/'Century Gothic', sans-serif;Comic Sans MS/'Comic Sans MS';Consolas/Consolas, Courier, monospace;Constantia/Constantia, 'Hoefler Text', serif;Corbel/Corbel, Skia, sans-serif;Cordia New/'Cordia New', 'Leelawadee UI', Silom, sans-serif;Courier New/'Courier New';DaunPenh/DaunPenh, 'Leelawadee UI', 'Khmer MN', sans-serif;Franklin Gothic Book/'Franklin Gothic Book', 'Avenir Next Condensed', sans-serif;Franklin Gothic Demi/'Franklin Gothic Demi', 'Avenir Next Condensed Demi Bold', sans-serif;Franklin Gothic Medium/'Franklin Gothic Medium', 'Avenir Next Condensed Medium', sans-serif;Garamond/Garamond, Georgia, serif;Gautami/Gautami, 'Nirmala UI', 'Telugu MN', sans-serif;Georgia/Georgia, serif;Impact/Impact, Charcoal, sans-serif;Iskoola Pota/'Iskoola Pota', 'Nirmala UI', 'Sinhala MN', sans-serif;Kalinga/Kalinga, 'Nirmala UI', 'Oriya MN', sans-serif;Kartika/Kartika, 'Nirmala UI', 'Malayalam MN', sans-serif;Latha/Latha, 'Nirmala UI', 'Tamil MN', sans-serif;Leelawadee UI/'Leelawadee UI', Thonburi, sans-serif;Lucida Console/'Lucida Console', Monaco, monospace;Lucida Handwriting/'Lucida Handwriting', 'Apple Chancery', cursive;Lucida Sans Unicode/'Lucida Sans Unicode';Mangal/Mangal, 'Nirmala UI', 'Devanagari Sangam MN', sans-serif;Nirmala UI/'Nirmala UI', sans-serif;Nyala/Nyala, Kefa, sans-serif;Palatino Linotype/'Palatino Linotype', 'Book Antiqua', Palatino, serif;Raavi/Raavi, 'Nirmala UI', 'Gurmukhi MN', sans-serif;Segoe UI/'Segoe UI', 'Helvetica Neue', sans-serif;Shruti/Shruti, 'Nirmala UI', 'Gujarati Sangam MN', sans-serif;Sitka Heading/'Sitka Heading', Cochin, serif;Sitka Text/'Sitka Text', Cochin, serif;Sylfaen/Sylfaen, Mshtakan, Menlo, serif;TW Cen MT/'TW Cen MT', 'Century Gothic', sans-serif;Tahoma/Tahoma, Geneva, sans-serif;Times New Roman/'Times New Roman', Times, serif;Times/Times, 'Times New Roman', serif;Trebuchet MS/'Trebuchet MS';Tunga/Tunga, 'Nirmala UI', 'Kannada MN', sans-serif;Verdana/Verdana, Geneva, sans-serif;Vrinda/Vrinda, 'Nirmala UI', 'Bangla MN', sans-serif;メイリオ/Meiryo, メイリオ, 'Hiragino Sans', sans-serif;仿宋/FangSong, 仿宋, STFangsong, serif;微軟正黑體/'Microsoft JhengHei', 微軟正黑體, 'Apple LiGothic', sans-serif;微软雅黑/'Microsoft YaHei', 微软雅黑, STHeiti, sans-serif;新宋体/NSimSun, 新宋体, SimSun, 宋体, SimSun-ExtB, 宋体-ExtB, STSong, serif;新細明體/PMingLiU, 新細明體, PMingLiU-ExtB, 新細明體-ExtB, 'Apple LiSung', serif;楷体/KaiTi, 楷体, STKaiti, serif;標楷體/DFKai-SB, 標楷體, BiauKai, serif;游ゴシック/'Yu Gothic', 游ゴシック, YuGothic, sans-serif;游明朝/'Yu Mincho', 游明朝, YuMincho, serif;隶书/SimLi, 隶书, 'Baoli SC', serif;黑体/SimHei, 黑体, STHeiti, sans-serif;굴림/Gulim, 굴림, 'Nanum Gothic', sans-serif;궁서/Gungsuh, 궁서, GungSeo, serif;돋움/Dotum, 돋움, AppleGothic, sans-serif;맑은 고딕/'Malgun Gothic', '맑은 고딕', AppleGothic, sans-serif;바탕/Batang, 바탕, AppleMyungjo, serif;바탕체/BatangChe, 바탕체, AppleMyungjo, serif;ＭＳ Ｐゴシック/'MS PGothic', 'ＭＳ Ｐゴシック', 'MS Gothic','ＭＳ ゴシック', 'Hiragino Kaku Gothic ProN', sans-serif;ＭＳ Ｐ明朝/'MS PMincho', 'ＭＳ Ｐ明朝', 'MS Mincho', 'ＭＳ 明朝', 'Hiragino Mincho ProN', serif",
        "copyFormatting_allowRules": "b s u i em strong span p div td th ol ul li(*)[*]{*}"
    },
    "readOnlySettings": {
    "height": 500,
    "showFullScreenExpander": true
    },
    "sanitizerAllowlist": {
    "attributes": [],
    "cssProperties": [],
    "domains": [],
    "protocols": [],
    "tags": []
    },
    "disableContentSanitization": true,
    "disableOnLoadEditModeSanitization": true,
    "disableDefaultImageProcessing": true,
    "showFullScreenExpander": false,
    "showAsTabControl": false,
    "showHtml": false
}

defaultSupportedProps

Seuraavassa taulukossa kuvataan yleisimmin käytettävät ominaisuudet, mutta voit määrittää kaikki CKEditorin tukemat ominaisuudet. RTF-editorin ohjausobjektit käyttävät CKEditor 4:ään.

Yksittäiset ominaisuudet

Seuraava taulukko kuvailee lisää ominaisuuksia, joilla voit mukauttaa RTF-editorin ohjausobjektia.

Esimerkkimäärityksiä

Seuraavat esimerkkimääritykset luovat määritetyt RTF-editorin mukautukset perinteisessä käyttökokemuksessa. Voit käyttää niitä sellaisenaan tai lähtökohtana RTF-editorin yksittäisen esiintymän muokkaamiselle tai yleisesti.

Määritä oletusfontiksi koon 11 Calibri

Määritä nämä defaultSupportedProps -ominaisuudetmääritystiedostossasi. Viimeistä arvoa lukuun ottamatta, kunkin arvon perässä on oltava pilkku (,).

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

Enter-painikkeen määrittäminen lisäämään uuden rivin kappalelohkon sijaan

Enter-näppäimen painaminen luo oletusarvoisesti kappalelohkon, jossa on <p>-HTML-tunniste. HTML käyttää kappalelohkoja tietojen ryhmittelyssä, kuten Word asiakirjan kappaleissa. Selaimet voivat muotoilla p-tunnisteen<> hieman eri tavalla, joten visuaalisen yhdenmukaisuuden vuoksi kannattaa käyttää sen sijaan uutta rivinvaihtotunnistetta tai rivinvaihtotunnistetta <br\>.

Määritä tämä defaultSupportedProps -ominaisuusmääritystiedostossasi. Kirjoita tämän arvon jälkeen pilkku (,), ellei se ole tiedoston viimeinen ominaisuus.

"enterMode": 2,

Salli editorin käyttää koko näyttöä

Määritä nämä yksilölliset ominaisuudetmääritystiedostossasi Viimeistä arvoa lukuun ottamatta, kunkin arvon perässä on oltava pilkku (,).

"showFullScreenExpander": true,

HTML-sisällön tarkastelemisen ja muokkaamisen salliminen

Jotta käyttäjät voivat tarkastella ja muokata sisältönsä HTML:ää, näytä HTML-välilehti.

Määritä nämä yksilölliset ominaisuudetmääritystiedostossasi Viimeistä arvoa lukuun ottamatta, kunkin arvon perässä on oltava pilkku (,).

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

Yksinkertaistetun työkalurivin näyttäminen tai kokonaan poistaminen

Editorityökalurivi sisältää oletusarvoisesti kaikki käytettävissä olevat muotoilutyökalut. Jos haluat antaa käytettäväksi yksinkertaistetun työkalurivin, käytä toolbar-ominaisuutta ja määritä työkalut, joita käyttäjät voivat käyttää sisältönsä muotoilemiseen.

Määritä tämä defaultSupportedProps -ominaisuusmääritystiedostossasi. Kirjoita tämän arvon jälkeen pilkku (,), ellei se ole tiedoston viimeinen ominaisuus.

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

Voit poistaa työkalurivin kokonaisuudessaan määrittämällä toolbar-arvoksi [] (kaksi hakasuljetta).

Lisää uusi fonttiluettelo ja määritä oletusfontiksi 20 pisteen Brush Script MT.

Määritä nämä defaultSupportedProps -ominaisuudetmääritystiedostossasi. Viimeistä arvoa lukuun ottamatta, kunkin arvon perässä on oltava pilkku (,).

"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/8pt;12/12pt;20/20pt;32/32pt"
"fontSize_defaultLabel": "20"
"stickyStyle": {
  "font-size": "20pt",
  "font-family": "'Brush Script MT', cursive"
},

Työkalurivin sijoittaminen RTF-editorin yläosaan

Määritä tämä defaultSupportedProps -ominaisuusmääritystiedostossasi. Kirjoita tämän arvon jälkeen pilkku (,), ellei se ole tiedoston viimeinen ominaisuus.

"toolbarLocation": "top",

Käynnistä editori korkeudella 30 pikseliä ja lisää sitten automaattisesti kokoa sisältöön sopivaksi

Määritä nämä defaultSupportedProps -ominaisuudetmääritystiedostossasi. Viimeistä arvoa lukuun ottamatta, kunkin arvon perässä on oltava pilkku (,).

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

Korjaa editorin korkeudeksi 500 pikseliä

Määritä nämä defaultSupportedProps -ominaisuudetmääritystiedostossasi. Kutakin arvoa viimeistä lukuun ottamatta on seurattava pilkku.

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

Kontekstivalikon (hiiren kakkospainike) määrittäminen käyttämään selaimen oletuskontekstivalikkoa

Voit korvata editorin ohjausobjektin kontekstivalikon selaimen oletusarvoisella kontekstivalikolla poistamalla contextmenu-laajennuksen.

Määritä tämä defaultSupportedProps -ominaisuusmääritystiedostossasi. Kirjoita tämän arvon jälkeen pilkku (,), ellei se ole tiedoston viimeinen ominaisuus.

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

RTF-editorin työkalurivi

Seuraavassa taulukossa on kuvattutyökalut, jotka ovat käytettävissä olevassa RTF-editorissa oletusarvoisesti.

Icon	Nimi	Pikavalintanäppäin	Kuvaus
	Kopioi muotoilu	Ctrl+Vaihto+C, Ctrl+Vaihto+V	Käytä tietyn osan ulkoasua toiseen osaan.
	Fontin nimi	Ctrl+Vaihto+F	Valitse fontti. Sovellus ottaa huomioon fontin, jonka valitset oletusfontiksi. Segoe UI on oletusfontti, jos et valitse fonttia. Muotoiltua sisältöä valittaessa siinä käytetty fontin nimi on näkyvissä. Jos valinta sisältää useita fontteja, ensimmäisenä valinnassa käytetty tulee näkyviin.
	Fontin koko	Ctrl+Vaihto+P	Muuta tekstin kokoa. Sovellus ottaa huomioon fonttikoon, jonka valitset oletuskooksi. Oletuskokona on 12, jos kokoa ei valita. Muotoiltua sisältöä valittaessa siinä käytetty fontin koko on näkyvissä. Jos valinta sisältää useita kokoja, ensimmäisenä valinnassa käytetty tulee näkyviin.
	Lihavoitu	Ctrl+B	Lihavoi teksti.
	Kursivoitu	Ctrl+I	Kursivoit teksti.
	Alleviivaus	Ctrl+U	Alleviivaa teksti.
	Taustaväri		Tee tekstistä erotuttava korostamalla se kirkkaalla värillä.
	Tekstin väri		Muuta tekstin väriä.
	Lisää/poista luettelomerkeillä varustettu luettelo		Luo Luettelomerkeillä varustettu luettelo.
	Lisää/poista numeroitu luettelo		Luo numeroidun luettelon.
	Pienennä sisennystä		Siirrä kappale lähemmäs reunusta.
	Suurenna sisennystä		Siirrä kappale kauemmaksi reunuksesta.
	Sisennetty lainaus		Käytä sisältöön lohkotason tarjouksen muotoa.
	Tasaa vasemmalle	Ctrl+L	Tasaa sisältö vasempaan reunukseen.
	Tasaa keskelle	Ctrl+E	Keskitä sisältö sivulla.
	Tasaa oikealle	Ctrl+R	Tasaa sisältö oikean reunuksen kanssa.
	Linkki		Luomalla linkin asiakirjassa voit käyttää nopeasti verkkosivuja ja muita pilviresursseja. Syötä tai liitä ankkuriteksti Näyttöteksti-ruutuun ja syötä tai liitä URL-osoite URL-ruutuun. Voit myös valita Linkkityypin ja protokollan, jos linkki on jotakin muuta kuin verkkosivu. Voit määrittää, missä URL-tyypin linkki avautuu, valitsemalla Kohde-välilehden ja valitsemalla sitten kohteen. Liitetty tai kirjoitettu URL-osoite muunnetaan automaattisesti linkiksi. Esimerkiksi osoite http://myexample.com muuttuu muotoon <a href="http://myexample.com">http://myexample.com</a>.
	Poista linkitys		Poista linkki ankkurista ja tee siitä pelkkää tekstiä.
	Yläindeksi		Kirjoita pienet kirjaimet juuri tekstirivin yläpuolelle.
	Alaindeksi		Kirjoita pienet kirjaimet juuri tekstirivin alapuolelle.
	Yliviivaus		Yliviivaa tekstiä vetämällä viiva sen läpi.
	Kuva		Voit lisätä kuvan liittämällä sen leikepöydältä sisältöalueelle tai vetää kuvatiedoston kansiosta sisältöalueelle. Muuta kuvan kokoa vetämällä jotakin sen kulmaa. Ohjausobjekti tukee .png-, .jpg- ja .gif-muotoisia kuvia. Voit hallita kuvan lähdettä, ulkoasia ja toimintatapaa laajemmin valitsemalla Kuva-painikkeen. Siirry kuvatiedostoon paikallisessa kansiossa tai syötä sen URL-osoite. Jos kuva on tallennettuna ulkoiselle palvelimelle, syötä absoluuttinen polku. Jos se on paikallisella palvelimella, voit syöttää suhteellisen polun. Vaihtoehtoisesti voit syöttää tietyn korkeuden ja leveyden kuvan koon muuttamiseksi ja valita kohdistuksen. Voit myös syöttää vaihtoehtoista tekstiä kuvaamaan kuvaa henkilöille, jotka käyttävät näytönlukuohjelmaa. Jos kuva on myös linkki verkkosivulle tai toiseen pilviresurssiin, syötä resurssin URL-osoite Kohteen URL-osoite-ruutuun ja valitse tarvittaessa Kohde. jossa linkin pitäisi avautua.
	Tekstin suunta vasemmalta oikealle		Muuta teksti vasemmalta oikealle luettavaksi. Tämä on oletusasetus.
	Tekstin suunta oikealta vasemmalle		Muuta teksti oikealta vasemmalle luettavaksi kahden suunnan kielisisältöä varten.
	Kumoa		Peruuta viimeisin muutos, jonka olet tehnyt sisältöön.
	Tee uudelleen		Kumoa viimeisin kumoamisesi tai ota sisältöön viimeksi tekemäsi muutos uudelleen käyttöön.
	Poista muotoilu		Poista valitun tekstin kaikki muotoilu.
	Table		Lisää taulukko valitsemallasi rivien ja sarakkeiden määrällä. Taulukon koon ja ulkoasun hallintaa voi lisätä valitsemalla Taulukko-painike >Lisää ja muuttamalla sen ominaisuuksia. Voit myös tarkastella taulukkoa ja muuttaa sen ominaisuuksia valitsemalla sen hiiren kakkospainikkeella. Voit muuttaa sarakkeen leveyttä vetämällä sen reunaa. Voit valita vähintään yhden solun, rivin tai sarakkeen ja käyttää yksilöllistä muotoilua, lisätä linkin valittuun tekstiin sekä leikata, kopioida ja liittää kokonaisia rivejä tai sarakkeita.
	Mukauttamisen asetukset		Oletusfontin ja fonttikoon määrittäminen.
	Helppokäyttötoimintojen ohje	Alt + 0	Avaa RTF-editorissa käytettävissä olevien pikanäppäinten luettelo.
	Laajenna työkalurivi		Jos ikkuna on liian kapea näyttämään koko työkalurivin, laajenna työkalurivi toiselle riville valitsemalla se.

RTF-editorin käyttäminen offline-tilassa

RTF-editorin ohjausobjekti on käytettävissä, kun työskentelet offline-tilassa, mutta siitä puuttuu joitakin totuttuja ominaisuuksia ja toimintoja. Editorin oletusmäärityksellä ladut kuvat eivät ole käytettävissä, kun työskentelet offline-tilassa.

Seuraavat laajennukset ovat RTF-editorissa käytettävissä offline-tilassa:

• ajax, autogrow, basicstyles, bidi, blockquote, button, confighelper, contextmenu, dialog, dialogui, editorplaceholder, enterkey, entiteetit, fakeobjects, floatingspace, floatpanel, format, horizontalrule, htmlwriter, indent, indentblock, indentlist, justify, lineutils, list, listblock, maximize, menu, menubutton, notification, notificationaggregator, panel, panelbutton, popup, preview, removeformat, resize, richcombo, selectall, showborders, sourcearea, specialchar, stylescombo, tab, textmatch, textwatcher, toolbar, undo, widgetselection, wysiwygarea, xml

Seuraavat muotoilutyökalut ovat käytettävissä RTF-editorissa offline-tilassa:

• Lihavointi, kursivointi, alleviivaus, luettelomerkilliset ja numeroidut luettelot, sisennyksen pienentämine ja suurentaminen, sisennetty lainaus, tasaus vasemmalle, tasaus keskelle, tasaus oikealle, yliviivaus, kaksisuuntainen teksti, kumoaminen ja tekeminen uudelleen sekä muotoilun poistaminen

RTF-editorin käytön parhaat käytännöt

• RTF-kentät tallentavat HTML-tunnisteita muotoilua varten sekä käyttäjän syöttämät tiedot. Kun määrität RTF-tekstikenttien enimmäismäärän, jätä tilaa sekä HTM-tunnisteille että käyttäjätiedoille.

• Parhaan suorituskyvyn saavutat pitämällä HTML-sisällön koon enintään 1 megatavussa. Suuremmissa koissa saatat huomata hitaampia vasteaikoja lataamisessa ja muokkaamisessa.

• Oletusmäärityksessä kuvat eivät vaikuta negatiivisesti suorituskykyyn, koska ne tallennetaan erillään HTML-sisällöstä. Kuvat kuitenkin tallennetaan tekstisarakkeeseen base64, kun ne lataavalla käyttäjällä ei ole oikeuksia msdyn_richtextfiles-taulukossa. Base64-sisältö on suuri, joten et yleensä halua tallentaa kuvia osana sarakkeen sisältöä.

• Jos käytössäsi on järjestelmänvalvojan tai peruskäyttäjän käyttöoikeusrooli, käyttäjän mukauttamistoiminto toimii oletusarvoisesti. Jos näitä rooleja ei ole, käyttäjän mukautuksen laajennus toimii vain, jos käyttäjällä on taulukon msdyn_customcontrolextendedsettings luonti-, luku- ja kirjoitusoikeus.

• Oletusmäärityksessä rikastetun tekstin editori, jos vedät ja pudotat kuvatiedoston tekstieditoriin, se lataa sisäkkäisen kuvan taulukkoon msdyn_richtextfiles. Upotetun kuvan näkyvin kaikille asianmukaisille käyttäjille edellyttää, että kohteessa msdyn_richtextfiles on käytössä oikeat oikeudet.

RTF-editorin rajoitukset

Kun käytät RTF-editoria, ota huomioon tässä osassa luetellut rajoitukset. Jos sinulla on kysyttävää ominaisuuksien saatavuudesta, ota yhteyttä Microsoft Customer Support.

RTF-editorin rajoituksia ovat muun muassa seuraavat:

• Et voi käyttää rtf-editorin sisältöä ulkoisista lähteistä, kuten Microsoft Word, Excel jne.
• Rtf-editori tukee seuraavia liitetiedostotyyppejä: .aac, .avi, .csv, .doc, .docx, .gif, .html, .jpeg, .mid, .midi, .mp3, .mp4, .mpeg, .msg, .pdf, .png, .ppt, .pptx, .svg, .txt, .vsd, .wav, .xls, .xlsm ja .xlsx. Voit määrittää ympäristöllesi sallitut laajennukset lisäasetuksissa valitsemalla Hallinto>Yleinen>Määritä liitteiden estetyt tiedostopäätteet ja poistamalla tiedostopäätteet, jotka haluat sallia.
• Rtf-editori ei tue Microsoft laajennuksia.

Sähköpostimallit ja allekirjoitukset:

• Jos sähköpostimallin hahmontamisessa ilmenee ongelmia, suosittelemme, että luot sen uudelleen modernissa editorissa.
• Sisäkkäiset HTML-rakenteet, kuten syvälle sisäkkäiset <div>- tai <taulukko>-elementit, voivat aiheuttaa hahmonnusongelmia RTF-editorissa. Suosittelemme HTML-rakenteen yksinkertaistamista poistamalla tarpeettomat sisäkkäiset <div>- tai <taulukko>-tunnisteet sen varmistamisesi, että hahmonnus on yhdenmukainen kaikissa asiakasohjelmissa.

HTML-tunnisteet

Seuraavia HTML-tunnisteita ei enää tueta, tai ne korvataan modernilla vaihtoehdolla RTF-editorissa.

HTML-määritteet

Seuraavia HTML-määritteitä ei enää tueta, tai ne korvataan modernilla vaihtoehdolla RTF-editorissa.

Usein kysyttyjä kysymyksiä

Miksi kirjoitetut merkit näytetään hitaasti?

Jos editorissa on paljon sisältöä, vasteaika voi kasvaa. Saavutat parhaan suorituskyvyn pitämällä sisällön koon enintään 1 megatavussa. Oikeinkirjoituksen tai kieliopin tarkistus voi myös hidastaa kirjoittamisen suorituskykyä.

Miksi sisältöäni ei hahmonneta, ennen kuin editori on päivitetty?

Tämä ongelma ilmenee, kun mukautettu koodi lisää sisältöä RTF-editoriin käynnistämättä ohjausobjektin uudelleenhahmonnusta. RTF-editori ei tunnista ulkoisia päivityksiä automaattisesti, ellei sille ilmoiteta erikseen.

Voit kiertää ongelman jommallakummalla seuraavista toimista:

• Käytä tapahtuman kuuntelutoimintoa (esimerkiksi formContext.data.entity.addOnSave) käynnistääksesi päivityksen sisällön lisäämisen jälkeen.

• Käytä formContext.ui.refreshRibbon()-funktiota tai vastaavaa ohjelmointirajapintaa pakottaaksesi päivityksen.

Esimerkki:

window.top.addEventListener('rteEditorReady', (event) => {
    const { parentEntity } = event.detail;

    if (parentEntity?.typeName === 'email' &&
        parentEntity?.fieldName === 'description') {

        const descriptionAttr = Xrm.Page.getAttribute("description");
        if (descriptionAttr) {
            descriptionAttr.setValue(emailSignature);
        }
    }
}, { once: true });

Tässä esimerkissä tapahtuman kuuntelutoiminto poistetaan automaattisesti tapahtuman käynnistimien rteEditorReady jälkeen. Tämä lähestymistapa varmistaa, että kuuntelutoiminto suoritetaan vain kerran, mikä auttaa estämään muistivuodot ja tarpeettoman resurssien käytön.

Miksi en saa ladattua kuvaa? Miksi kuvan esikatselu ei lataudu?

Jos kuvatiedoston nimi polkuineen on pitkä, tiedoston lataaminen ei ehkä onnistu tai esikatselua ei näytetä. Kokeile tiedoston nimen lyhentämistä tai sen siirtämistä sijaintiin, jolla on lyhyempi polku, ja yritä latausta uudelleen.

Miksi tekstissäni näkyy HTML-koodia?

Jos käytät RTF-editorin ohjausobjektia sarakkeessa, jota ei ole muotoiltu rtf-tekstiä varten, sisältö näkyy pohjana olevassa HTML:ssä muotoillun tekstin sijaan.

Mikä on HTML-sisällön kokorajoitus?

Parhaan suorituskyvyn saavutat pitämällä HTML-sisällön koon enintään 1 megatavussa. Suuremmissa koissa saatat huomata hitaampia vasteaikoja lataamisessa ja muokkaamisessa.

Voit ratkaista tämän ongelman varmistamalla, että sarakkeen muotoiluksi on määritetty Rich text.

Ylitin merkkirajan, mutta merkkejä on vähemmän kuin raja. Miksi?

Tietokanta tallentaa koko HTML-muotoilun, ei vain merkkejä, mikä vie ylimääräistä tilaa.

Miksi en näe nykyaikaista rtf-editoria?

Modernin RTF-editorin ohjausobjekti kuuluu mallipohjaisten sovellusten uuteen ulkoasuun eikä näy, ellei sovellusasetus ole käytössä. Jos asetus ei ole käytössä, saatat nähdä editorin vanhemman version.

Liittyvät tiedot

• Luo ja muokkaa Microsoft Dataverse sarakkeita Power Apps-portaalin avulla
• Käyttö Copilot rtf-editorissa sähköpostille