Бөлісу құралы:


Бірыңғай интерфейс бағдарламасы үшін интерактивті анықтама жасау

Бірыңғай интерфейс бағдарламасына ұйымыңызға бейімделген реттелетін өнім бойынша анықтамалық тәжірибе беру үшін, реттелетін анықтама тақталары мен қадамдық тапсырмаларды пайдаланыңыз. Кесте, пішін және тілге тән анықтаманы және толық мәтін, мазмұн сілтемелері, кескіндер мен бейне сілтемелерін қамтитын анықтаманы қамтамасыз ету үшін реттелетін анықтама тақталарын пайдаланыңыз.

Маңызды

  • Реттелетін анықтама тақталары бұрынғы веб-клиент бағдарламаларымен пайдаланылған алдыңғы оқыту жолымен басқарылатын анықтама мүмкіндіктерін ауыстырады.
  • Арнаулы анықтама тақталары Android және iOS планшеттер мен смартфондар сияқты мобильді құрылғыда жұмыс істейтін Бірыңғай интерфейс қолданбаларымен жұмыс істемейді.

Реттелетін анықтама тақталары және оқыту жолы

Реттелетін анықтама тақталарының жаңа интерактивті анықтаманы ендіру алдыңғы оқыту жолымен басқарылатын оқыту мүмкіндігінен өзгешеленеді. Екі мүмкіндік те бағдарламаңыз үшін реттелетін анықтаманы жасауға мүмкіндік береді. Дегенмен реттелетін анықтама тақталары жиі пайдаланылатын интерактивті анықтама сценарийлері үшін оңтайландырылған.

Реттелетін анықтама тақталары оқыту жолында қолжетімді емес келесі негізгі мүмкіндіктерді ұсынады:

  • Еркін пішімді пішімделген мәтін, оның ішінде таңбалауыштар мен нөмірлеу.
  • Көрнекі түрде байланыстырылған сөзкөмектер мен анықтаманың шығарылған аңғартпалары.
  • Бейне көздеріне, соның ішінде жеке көздерге арналған қосымша опциялар.
  • Анықтама мазмұнын Microsoft Dataverse қызметіне шешіміңіздің бөлігі ретінде сақтау.

Реттелетін анықтама тақталары оқыту жолында қолжетімді емес келесі негізгі мүмкіндіктерді қамтамасыз етпейді:

  • Реттік анықтаманың шығарылған аңғартпалары.
  • Әр рөлдегі анықтама беттері.
  • Смартфондар сияқты әр құрылғының пішін шартына арналған анықтама беттері.

Алғышарттар

Реттелетін анықтама тақталары мүмкіндігін пайдалану үшін ортаға мыналар қажет:

Ортаңыз үшін реттелетін анықтама тақталарын қосу

  1. Модельге негізделген бағдарламаны ашып, пәрмен жолағында Параметрлер Параметрлер. опциясын таңдаңыз > Кеңейтілген параметрлер.

  2. Параметрлер > Жүйе > Басқару тармағына өтіңіз.

  3. Басқару бетінде Жүйелік параметрлер тармағын таңдаңыз.

  4. Реттелетін анықтама URL мекенжайын орнату аймағындағы Жалпы мәліметтер қойыншасында, Реттелетін анықтама тақталары мен қадамдық тапсырмаларды қосу опциясы үшін Иә мәнін таңдап, OK түймесін таңдаңыз.

    Реттелетін анықтама тақталарын қосу.

Маңызды

  • Реттелетін анықтама тақталарын немесе реттелмелі анықтаманы қосуға болады, бірақ бір уақытта екеуі қосылмайды. Реттелетін кестелерге реттелетін анықтаманы пайдалану және Параметрлерді URL мекенжайына үстеу пәрмендерінің Жоқ мәніне орнатылғанын растаңыз.
  • Кейбір орталар Оқыту жолын қосу функциясын Иә мәніне орнатуды талап етуі мүмкін.

Талап етілетін артықшылықтар

  • Анықтама тақталарын жасау үшін бағдарлама жасаушылары Анықтама беті кестесінде глобалдық жасау, оқу, жазу, жою және үстеу артықшылықтарын қажет етеді. Әдепкі бойынша, "Жүйе әкімшісі" және "Жүйе реттеушісі" қауіпсіздік рөлдерінің екеуі де осы артықшылықтарға ие.
  • Бағдарламадағы анықтама тақталарын көру үшін пайдаланушыларға Анықтама беті кестесінде оқу артықшылығы қажет. Әдепкі бойынша анықтама тақтасының тұтынушысы қауіпсіздік рөлі осы артықшылыққа ие. Әдепкі бойынша, негізгі пайдаланушы қауіпсіздік рөлінде анықтама беті кестесінде артықшылықтар жоқ.

Қосымша ақпарат: Қауіпсіздік рөлдері және артықшылықтары

Мәтінмәндік реттелетін анықтама

Әр анықтама тақтасы осы мазмұндар үшін бірегей болып табылады:

  • Бағдарлама
  • Кесте
  • Пішін
  • Тіл

Анықтама тақтасын шарлау

Әдепкі бойынша, анықтама тақтасы ашық күйде және сіз басқа пішінге өтсеңіз де, алғаш рет ашқан анықтама мазмұнында қалады. Бұл пайдаланушыларды бағдарламаның әртүрлі бөліктеріне бағыттаған кезде, анықтама мазмұнының өзгеріссіз қалуына мүмкіндік береді.

Анықтама тақтасының мазмұнын жасау үшін

  1. Анықтама тақтасын көру үшін, модельге негізделген бағдарламаны ашып, пәрмен жолағында Анықтама түймешігін таңдаңыз.

    Анықтама.

  2. Анықтама тақтасында тік көп нүктені таңдап, Өңдеу опциясын таңдаңыз.

    Анықтаманы өңдеңіз.

    Анықтама тақтасы қазір өңдеу күйінде және курсор анықтама тақтасының тақырыбында орналасқан.

  3. Өңдеу тақтасынан келесі тапсырмаларды орындауға болады:

    • Тікелей анықтама тақтасының аймағына теру арқылы мәтінді енгізіңіз.
    • Пішімделген мәтін мүмкіндіктері арқылы мәтінді пішімдеңіз және таңбалауыш/нөмірленген тізімдер, бөлімдер, бейнелер, кескіндер, сілтемелер, сөзкөмектер және анықтамасын қосыңыз.
  4. Өзгерістерді сақтау үшін Сақтау опциясын таңдаңыз.

Еркін пішімді мәтін

Мәтінді анықтама тақтасының кез келген жеріне орналастыруға болады. Еркін пішімді мәтінді бөлімдерге дейін, ішінде немесе кейін енгізіңіз. Мәтін қалың, көлбеу, асты сызылған және сызылған қаріп пішімдерін қолдайды. Бірнеше деңгейлі болдырмаумен қатар, кесу, көшіру және қою функцияларын пайдалануға болады.

Таңбалауыштар мен нөмірленген тізімдер

Таңбалауышты немесе нөмір белгісін таңдаған кезде, ағымдағы жолға таңбалауыш немесе нөмір қойылады. Егер тізімде бірнеше жолды таңдасаңыз, әр жол таңбаланған немесе нөмірленген болады. Табуляция және шегіністердің ішкі нөмірлері тізімде тураланады.

Бөлімдер

Бөлім жиылатын мәтін ұясы болып табылады. Оның ішіне сілтемелерді немесе еркін пішімді мәтінді қоюға болады. Ұқсас элементтерді топтастыру үшін бөлімді пайдаланыңыз. Әдепкі бойынша бөлім ашық немесе жиылған болуы мүмкін.

Бейне және статикалық кескіндер

Анықтама тақтасына бейнелер мен статикалық кескіндерді енгізуге болады. Бейнелер мен кескіндер интернеттегі мазмұнға сілтеме болып табылады. Реттелетін анықтама тақталары бейне және кескін файлдарын анықтама тақтасында сақтамайды. Анықтама тақтасы ашылған кезде, реттелетін анықтама тақталары мазмұнды көрсету үшін оны сілтемеден шығарады. Егер корпоративтік жеке мазмұнға сілтеме жасағыңыз келсе, Microsoft Stream бейнесіне сілтемені пайдалануға болады.

Кеңес

Анықтама тақтасына қою үшін қажетті бейне немесе кескін сілтемесінің URL мекенжайын көшіруді ұмытпаңыз.

Реттелетін анықтама тақталары келесі бейне көздерін қолдайды:

  • Microsoft Stream (Классикалық) (жеке мазмұн үшін пайдаланыңыз)
  • YouTube
  • Facebook
  • Vimeo

Сілтемелер веб-сайттарға сілтей алады және бірдей терезеде (әдепкі) немесе бөлек терезеде ашылады. Бұрыннан бар анықтама бетіне сілтеме жасау мүмкіндігі әлі қосылған жоқ.

Шығарылған аңғартпалар мен сөзкөмектер

Шығарылған аңғартпалар мен сөзкөмектерді белгілі бір пайдаланушы интерфейсінің элементтеріне бағыттау үшін пайдалануға болады. Шығарылған аңғартпаның ішінде мәтін болуы мүмкін.

Аңғартпа енгізу

Сөзкөмек пайдаланушының назарын сол UI элементіне аудару үшін сөзкөмек көрсеткіші бар элементті жай ғана бөлектейді.

Сөзкөмектерді кірістіру

Автор аңғартпалар мен сөзкөмек белгілердің сипаттарында сүйреп апару мүмкіндігі арқылы мақсатты анықтау қажет. Автор сөзкөмек белгілері үшін мәтінге тақырып және сипаттама енгізе алады.

Сүйреп апарып тастау

Ескерім

  • Аңғартпалар мен сөзкөмек белгілері реттелетін құрамдастармен жақсы жұмыс істемейді. Бұл мүмкіндік әдепкі бірыңғай интерфейс UI құрамдастарына ғана қолданылады.
  • Кезекті анықтама аңғартпалары мен сөзкөмек белгілеріне әлі қолдау көрсетілмейді.

Шешімдер мен реттелетін анықтама тақтасының мазмұны

Барлық анықтама мазмұны Dataverse қызметіндегі анықтама беті құрамдасында шешіміңіздің бір бөлігі ретінде сақталады. Шешіміңізді бір ортадан екінші ортаға, мысалы, сынақтан өндіріске ауыстырған кезде, сіз анықтама жолдарының шешімге қосылатын етіп экспортталатынын анықтай аласыз. Бұл басқа орталарға ауысқан кезде, анықтама мазмұнын шешіміңіздің мүмкіндіктерімен синхрондалған күйде сақтауға мүмкіндік береді. Шешіміңіздің бір бөлігі ретінде, реттелетін анықтама тақталары шешім бағдарламасының жарамдылық кезеңін басқарудың (ALM) барлық стандартты мүмкіндіктерін қолдайды.

Мазмұнды шешімдер арқылы жылжыту

Әдепкі бойынша, барлық жаңа анықтама беттері әдепкі шешімде пайда болады. Егер мазмұнды басқа ортаға жылжытқыңыз келсе, экспорттамас бұрын, алдымен бұрыннан бар анықтама беттерін басқарылмайтын шешімге қосыңыз. Басқарылмайтын шешімге анықтама бетін қосу үшін келесі әрекеттерді орындаңыз:

  1. Power Apps жүйесіне кіріңіз.
  2. Сол жақ навигация тақтасынан Шешімдер параметрін таңдаңыз. Элемент сол жақ тақта бөлігінде болмаса, ...Қосымша параметрін таңдап, қажетті элементті таңдаңыз.
  3. Сізге қажетті басқарылмайтын шешімді ашыңыз.
  4. Пәрмен жолағында Бұрыннан барды қосу опциясын таңдаңыз, содан кейін Анықтама беті қойыншасын таңдаңыз.
  5. Қосу қажет анықтама беттерін таңдап, Қосу түймешігін таңдаңыз. Қосымша ақпарат: Шешімдерді экспорттау

Анықтама бетінің құжаттамасын автоматтандыру

Мазмұнның сақтық көшірмесін жасау немесе оны бастапқы кодты басқару жүйесіне сақтау қажет болуы мүмкін. Сондай-ақ анықтама тақтасының мазмұнында аударма құралдары немесе тексеру құралдары сияқты құжаттаманы автоматтандыру құралдарын пайдалану қажет болуы мүмкін. Реттелетін анықтама тақтасының деректері тікелей Dataverse қызметінде сақталады және оларды осы мақсат үшін экспорттауға және импорттауға болады.

Реттелетін анықтама тақталары реттелетін XML пішімін қолдайды. Бұл пішім төменде құжатталған. Қосымша ақпарат: XML реттелетін анықтама сипаттамасы

Экспортталған кезде әр анықтама беті жеке файл ретінде экспортталады.

Мәнмәтіндік анықтаманың басқарылатын шешімі туралы ақпарат

Реттелетін анықтама тақталары мен қадамдық тапсырмалар мүмкіндігі мәнмәтіндік анықтаманың басқарылатын шешіміндегі шешім құрамдастарынан тұрады. Теңшелетін анықтама тақталары мен басқарылатын тапсырмалар мүмкіндігінен тыс кестелерді пайдаланып жазбаларды теңшеуге немесе жасауға қолдау көрсетілмейді.

Dynamics 365 Sales және Dynamics 365 Service сияқты кейбір бағдарламалар мәнмәтіндік анықтаманың басқарылатын шешім құрамындағы кестелерді пайдалану арқылы жасалған бірінші іске қосу тәжірибелерін қамтитынын ескеріңіз. Мысалы, анықтама беті (msdyn_helppage) және тур (msdyn_tour) кестелері осы бірінші іске қосу тәжірибелерін жасауда пайдаланылады. Қазіргі уақытта реттелетін анықтама тақталары мен қадамдық тапсырмалар мүмкіндігі осы бірінші іске қосу тәжірибелерін жасауға қолдау көрсетпейді.

Жиі қойылатын сұрақтар

Бұл бөлімде реттелетін анықтама беттері туралы жиі қойылатын сұрақтар талқыланған.

Реттелетін анықтама беттері реттелмелі анықтамамен бірдей ме?

Реттелетін анықтама тақталары мен қадамдық тапсырмалар жүйе параметрлерінің Реттелетін анықтама URL мекенжайын орнату бөліміндегі опция болып табылады. Реттелетін анықтама тақталары мен қадамдық тапсырмалар пайдаланушы пішінінің дәл жанында көрсетілетін реттелмелі анықтама тақтасын іске қосады. Осы жүйе параметрлерінің реттелетін анықтаманы орнату бөліміндегі басқа опциялар реттелмелі анықтама мүмкіндіктерін қамтиды. Олар әдепкі бағдарламалардың анықтамасын алдын ала анықтауға және ұйымдағы пайдаланушыларды анықтаманың басқа URL мекенжайына бағыттауға мүмкіндік береді. Не болмаса, жұмыс ағынын сипаттауды жақсарту үшін анықтаманы барынша реттелген кесте үшін алдын ала анықтауға болады.

Реттелетін анықтама туралы қосымша ақпаратты Реттелетін анықтаманы іске қосу және пайдалану бөлімінен қараңыз.

Деректерді оқыту жолынан реттелетін анықтама беттеріне тасымалдаудың жолы қандай?

Оқыту жолында анықтаманың екі түрі бар: анықтама тақталары және реттік анықтаманың шығарылған аңғартпалары. Бұрынғы веб-клиенттің пайдаланушы интерфейсімен терең біріктірілген реттік анықтаманың шығарылған аңғартпасының орындары жаңа реттелетін анықтама тақталарына тасымалданбайды.

Интерактивтік анықтамадағы мәтін көлеміне байланысты, ақпаратты тікелей оқыту жолының пайдаланушы интерфейсінен жаңа реттелетін тақтаның пайдаланушы интерфейсіне көшіру ең оңай тәсіл болуы мүмкін. Дегенмен оқыту жолыңыздың анықтамалық мазмұнын да экспорттауға болады. Бұны жасаудың ең қарапайым әдісі Оқыту жолы > Мазмұн кітапханасы > Локализациялау > Экспорттау мүмкіндігін пайдалану арқылы мазмұнды экспорттау болып табылады. Қажетті жолдарды таңдап, оларды экспорттаңыз. Бұл әр анықтама тақтасы мен қадамдық тапсырма үшін XLIFF файлын жасайды. Содан кейін мазмұнды шығарып алу үшін жалпыға қолжетімді XLIFF өңдегішін немесе XLIFF файлын HTML файлына түрлендіргішін пайдаланыңыз.

XML реттелетін анықтама сипаттамасы

Бұл бөлімде XML реттелетін анықтама сипаттамасы сипатталған.

PPHML

<pphml>
    <h1>FAQ</h1>
    <collapsible title="What is PPHML?">
        <p>PPHML is a domain specific language for help content. It is used to create help content that includes elements such as images, videos, balloons, coach marks, etc.</p>
    </collapsible>
    <collapsible title="What does PPHML stand for?">
        <p>PPHML stands for Power Platform Help Markup Language</p>
    </collapsible>
</pphml>

Сипаттамасы мен пайдаланылуы

<pphml> элементі анықтама браузеріне бұл PPHML құжаты екенін көрсетеді.

<pphml> элементі PPHML құжатының түбірін көрсетеді.

<pphml> элементі барлық басқа PPHML элементтеріне арналған контейнер болып табылады.

Тақырып

Анықтама бетіндегі тақырыпты көрсетеді.

<h1>This will be displayed at the top of the help page</h1>

Сипаттамасы мен пайдаланылуы

<h1> элементі анықтама бетінің тақырыбын анықтайды.

<h1> бұл <pphml> ішіндегі бірінші элемент болуы тиіс.

Сурет

Анықтама бетіндегі кескінді көрсетеді.

<img src="smiley.gif" alt="Smiley face" title="Smiley face"/>

Сипаттамасы мен пайдаланылуы

<img> элементі анықтама бетіне кескінді ендіреді.

Төлсипаттар

  • src: кескіннің URL мекенжайын анықтайды. Бұл атрибут міндетті болып табылады.

  • title: кескінмен бірге әдетте көрсеткішті апару сөзкөмегі ретінде көрсетілетін тақырыпты көрсетеді.

  • alt: кескінге арналған балама мәтінді көрсетеді. Бұл мәтін экраннан оқу бағдарламаларымен пайдаланылады.

Бейне

Анықтама бетіндегі бейнені көрсетеді.

<video src="https://www.youtube.com/watch?v=WSWmn7WM3i4" />

Сипаттамасы мен пайдаланылуы

<video> элементі анықтамалық бетке нұсқаулық немесе оқыту фильмі сияқты бейнені ендіреді.

Қолдау көрсетілетін көздер
  • Microsoft Stream
  • YouTube
  • Facebook
  • Vimeo

Төлсипаттар

  • src: бейненің URL мекенжайын көрсетеді. Бұл атрибут міндетті болып табылады.

  • allowFullScreen: пайдаланушының бейнені толық экранға ауыстыра алатындығын анықтайды. Мүмкін мәндер "шын" немесе "жалған" болып табылады. Бұл атрибутқа барлық бейне көздері үшін қолдау көрсетілмеуі мүмкін.

  • autoplay: анықтама беті жүктелгеннен кейін бірден бейнені ойнатудың басталуын көрсетеді. Мүмкін мәндер "шын" немесе "жалған" болып табылады. Бұл атрибутқа барлық бейне көздері үшін қолдау көрсетілмеуі мүмкін.

  • startTime: бейнені ойнатуды бастау нүктелерін секунд бойынша көрсетеді.

Абзац

Анықтама бетіндегі абзацты көрсетеді.

<p>This is some text in a paragraph.</p>

Сипаттамасы мен пайдаланылуы

<p> элементі абзацты анықтайды.

Абзац ішіндегі мәтінді келесі жолдармен пішімдеуге болады:

  • Қалың, <strong> элементімен
  • Көлбеу, <em> элементімен
  • Сызылған, <del> элементімен
  • Асты сызылған, <u> элементімен

Бұл пішімдеулерді біріктіруге болады. Мысалы, қалың және асты сызылған мәтін бөлігін жасаңыз.

Таңбаланған тізім

Анықтама бетіндегі таңбаланған тізімді көрсетеді.

<ul>
    <li>Coffee</li>
    <li>Tea</li>
    <li>Milk</li>
</ul>

Сипаттамасы мен пайдаланылуы

<ul> элементі таңбаланған тізімді анықтайды.

Таңбаланған тізімдерді жасау үшін <ul> элементін <li> элементімен бірге пайдаланыңыз.

Нөмірленген тізім

Анықтама бетіндегі нөмірленген тізімді көрсетеді.

<ol>
    <li>First step</li>
    <li>Second step</li>
    <li>Third step</li>
</ol>

Сипаттамасы мен пайдаланылуы

<ol> элементі реттелген (нөмірленген) тізімді анықтайды. Нөмірленген тізімдерді жасау үшін <ol> тегін <li> элементімен бірге пайдаланыңыз.

Жиылатын

Анықтама бетіндегі жиылатын бөлімді көрсетеді.

<collapsible title="This is a Section">
    <p>This is a paragraph inside a section</p>
    <img src=smiley.gif" title="This is an image inside a section" />
</collapsible>

Сипаттамасы мен пайдаланылуы

<collapsible> элементі пайдаланушы сұрау бойынша көрсете алатын немесе жасыра алатын мазмұнның бөлімін анықтайды.

Төлсипаттар

  • collapsed: бөлімнің бастапқыда жиылған немесе кеңейтілген күйде болғанын көрсетеді. Мүмкін мәндер "шын" (жиылған) немесе "жалған" (кеңейтілген) болып табылады.

Анықтама бетіндегі сілтемені көрсетеді.

Жаңа браузер терезесінде ашылатын веб-сайтқа сілтеме:

<a href="https://www.microsoft.com" target="_blank">Microsoft Home Page</a>

Басқа анықтама бетіне сілтеме:

<a href="./LearnMore">Learn More</a>

Сипаттамасы мен пайдаланылуы

<a> тегі пайдаланушыға анықтама бетінен веб-сайтқа немесе басқа анықтама бетіне өтуге мүмкіндік беретін сілтемені анықтайды.

Төлсипаттар

  • href: өту қажет веб-сайттың URL мекенжайын немесе анықтама бетін көрсетеді. Бұл атрибут міндетті болып табылады.
  • target: байланыстырылған URL мекенжайын ашу орнын анықтайды.
    • Егер жоқ немесе _self болса, сілтеме басқа анықтама бетіне сілтеме ретінде есептеліп, анықтама браузерінде ашылады.
    • Егер _blank болса, сілтеме жаңа браузер терезесінде ашылады.
    • Егер _top болса, сілтеме ағымдағы браузер терезесінде ашылады.
    • Егер мән iframe атауы болса, сілтеме сол iframe ішінде ашылады.

Сөзкөмек

Анықтама бетіндегі сөзкөмекті көрсетеді.

<coachmark target="#my-html-button">Click to highlight the HTML element with id [my-html-button]</coachmark>

Сипаттамасы мен пайдаланылуы

Сөзкөмек анықтама браузерін орналастыратын бағдарламаның пайдаланушы интерфейсіндегі белгілі бір нүктеге пайдаланушының назарын аудару үшін пайдалануға болатын интерактивті элемент болып табылады.

Төлсипаттар

  • target: сөзкөмек көрсетілетін HTML элементін көрсететін CSS таңдау құралы. Бұл атрибут міндетті болып табылады.

Шығарылған аңғартпа

Анықтама бетіндегі шығарылған аңғартпаны көрсетеді.

<balloon target="#my-html-button" title="This button submits the form" details="Please click this button to continue and submit the form">Click to show a balloon over the HTML element with id [my-html-button]</balloon>

Сипаттамасы мен пайдаланылуы

Шығарылған аңғартпа пайдаланушы анықтама браузерін орналастыратын бағдарламаның пайдаланушы интерфейсіндегі әрекетті орындауға көмектесу үшін пайдалануға болатын интерактивті элемент болып табылады.

Төлсипаттар

  • target: шығарылған аңғартпа сілтемесі пайда болатын HTML элементін көрсететін CSS таңдау құралы. Бұл атрибут міндетті болып табылады.
  • title: шығарылған аңғартпа тақырыбын көрсетеді.
  • details: шығарылған аңғартпаның ішінде көрсетілетін мазмұнды көрсетеді.

Ескерім

Сіз құжат тіліңіздің артықшылықтары туралы айта аласыз ба? Қысқа сауалнамаға қатысыңыз. (бұл сауалнама ағылшын тілінде екеніне назар аударыңыз)

Сауалнама шамамен жеті минут уақытыңызды алады. Жеке деректер жиналмайды (құпиялылық туралы мәлімдеме).