Створення довідки з інструкціями для додатка на основі моделі

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

Важливо

Настроювані області довідки заміняють попередню функцію керованої довідки навчального шляху, що використовувалася із застарілими програмами веб-клієнта.
Настроювані панелі довідки не працюють із програмами єдиного інтерфейсу, запущеними на мобільних пристроях, наприклад Android iOS планшетах і смартфонах.

Настроювані області довідки та навчальний шлях

Нова реалізація керованої довідки для настроюваних областей довідки відрізняється від функції керованої довідки навчального шляху, що їй передувала. Обидві функції дозволяють створити настроювану довідку для вашої програми. Однак настроювані області довідки оптимізовані для найбільш поширених сценаріїв використання керованої довідки.

Настроювані області довідки пропонують такі ключові функції, що не є доступними при використанні навчального шляху:

Форматований текст довільної форми, зокрема маркери та нумерація.
Візуально цілісні помітки лектора та довідкові виноски.
Більше варіантів джерел відео, зокрема приватні джерела.
Зберігання вмісту довідки в Microsoft Dataverse в якості частини вашого рішення.

Настроювані області довідки не мають таких ключових функцій, що доступні при використанні навчального шляху:

Послідовні довідкові виноски.
Сторінки довідки для кожної ролі.
Сторінки довідки для кожного форм-фактору пристрою, наприклад, для смартфонів.

вимоги

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

Увімкніть настроювані області довідки для вашого середовища

Увійдіть у Центр адміністрування Power Platform на сторінці https://admin.powerplatform.microsoft.com.
В області ліворуч виберіть елемент Керування , а потім відкрийте потрібне середовище.
На панелі команд виберіть Налаштування , а потім виберіть Характеристики продукту>.
У розділі Функції довідки встановіть прапорець Увімкнути користувацькі панелі довідки у положення Увімкнено.

Важливо

Переконайтеся, що для настроюваної довідки для настроюваних сутностей установлено значення Ні, інакше не можна ввімкнути параметр Увімкнути настроювані області довідки. Це пояснюється тим, що одночасно не можна використовувати як настроювані області довідки, так і настроювану довідку.

Необхідні права

Щоб створювати панелі довідки, виробникам програм потрібно глобально створювати, читати, записувати, видаляти, додавати та додавати до привілеїв у таблиці «Сторінка довідки». За замовчуванням ролі безпеки системного адміністратора та настроювача системи включають це право.
Щоб переглядати панелі довідки в програмі, користувачам потрібні права на читання в таблиці «Сторінка довідки». За замовчуванням роль безпеки «Користувач сторінки довідки» має такий дозвіл. За замовчуванням у роль безпеки «Основний користувач» немає прав на таблицю «Довідка».

Додаткові відомості: Ролі безпеки і права

Контекстна настроювана довідка

Кожна область довідки є унікальною для таких контекстів:

Table
Форма
Приладна дошка
Language
Додаток

За замовчуванням область довідки лишається відкритою і відображає вміст довідки, який ви відкрили першим, навіть якщо ви переходите до іншої форми. Це дозволяє лишити вміст довідки незмінним, якщо ви спрямуєте користувачів до інших областей програми.

Для створення власного вмісту області довідки

Щоб переглянути область довідки, відкрийте програму, керовану моделлю, а потім на панелі команд виберіть пункт Довідка.
В області довідки виберіть вертикальний три крапки, а потім натисніть кнопку Редагувати.

Тепер область довідки перебуває в режимі редагування, а курсор знаходиться у заголовку області довідки.
У області редагування можна виконати наступні завдання:
- Введіть текст, набираючи його прямо в області довідки.
- Виконайте форматування тексту за допомогою можливостей редактора форматованого тексту й додайте маркіровані чи нумеровані списки, розділи, відео, зображення, посилання, помітки лектора й довідкові виноски.
Щоб зберегти зміни, натисніть Зберегти.

Текст довільної форми

Текст можна розміщати будь-де в межах області довідки. Введіть текст довільної форми перед розділами, в розділах або після них. Текст підтримує формати шрифту «жирний», «курсив», «підкреслений» та «закреслений». Можна використовувати команди «вирізати», «копіювати» та «вставити», а також скасування кількох дій.

Маркери та нумеровані списки

Якщо вибрати піктограму маркера або номера, поточний рядок перетвориться на маркірований або нумерований. Якщо вибрати кілька рядків у списку, кожен рядок стане маркірованим або нумерованим. Табуляція та відступ пронумерує відповідно до списку.

Розділи

Розділ – це текстове поле, яке можна згорнути. Ви можете розмістити в ньому посилання або текст довільної форми. Використовуйте розділи для групування подібних елементів. За замовчуванням розділ може бути відкритим або згорнутим.

Відео та статичні зображення

Ви можете вставляти відео та статичні зображення у вашу область довідки. Відео та зображення — це посилання на вміст в інтернеті. Настроювані області довідки не зберігають відеофайли та файли зображень у вашій області довідки. Коли область довідки відкривається, настроювані області довідки завантажують вміст за посиланням, щоб відобразити його. Ви можете використовувати посилання на відео Microsoft Stream, якщо хочете навести корпоративний приватний вміст.

Порада

Не забудьте скопіювати URL-адресу потрібного відео або зображення, щоб потім вставити його у вашу область довідки.

Настроювані довідкові сторінки підтримують такі джерела відео:

Microsoft Stream (Класичний) (використовувати для приватного контенту)
YouTube
Facebook
Vimeo

Посилання

Посилання можуть вести на веб-сторінки і відкриватися у тому ж вікні (за замовчуванням) або в окремому вікні. Наразі немає можливості додати посилання на наявну довідкову сторінку.

Довідкові виноски та помітки лектора

Виноски та помітки лектора можуть вказувати на певні елементи інтерфейсу користувача. Виноска може мати на собі текст.

Вставити виноску

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

Вставити помітку лектора

Автору потрібно визначити цільовий об’єкт, перетягнувши можливості у властивостях виносок та поміток лектора. Автор може ввести текст заголовка та опису для поміток лектора.

Перетягнути

Нотатка

Виноски й помітки лектора працюють не надто добре з користувацькими компонентами. Ця функція застосовується лише до стандартних компонентів єдиного інтерфейсу.
Послідовні довідкові виноски й помітки лектора наразі не підтримуються.

Рішення і вміст настроюваних областей довідки

Увесь вміст довідки зберігається у компоненті довідкової сторінки в Dataverse в якості частини вашого рішення. Під час переміщення рішення з одного середовища до іншого, наприклад, з тестового до виробничого, можна визначити, які рядки довідки буде експортовано та додано до рішення. Це дозволить вам підтримувати вміст довідки у відповідності до функцій вашого рішення, яке переходить до інших середовищ. Як частина рішення, настроювані області довідки підтримують усі стандартні функції керування життєвим циклом рішення.

Перенесення вмісту за допомогою рішень

За замовчуванням усі нові довідкові сторінки з’являються у рішенні за замовчуванням. Якщо ви хочете перенести вміст до іншого середовища, спершу додайте наявні довідкові сторінки до некерованого рішення, і лише після цього експортуйте їх. Щоб додати довідкову сторінку до некерованого рішення, виконайте такі дії:

авторизуйтесь Power Apps.
На лівій панелі навігації виберіть Рішення. Якщо елемента немає на бічній панелі, виберіть ... Більше , а потім виберіть потрібний елемент.
Відкрийте потрібне некероване рішення.
Виберіть «Додати існуючий » на панелі команд, а потім виберіть «Сторінка довідки».
Виберіть сторінки довідки, які потрібно додати, а потім натисніть кнопку Додати. Додаткова інформація: Експортні рішення

Автоматизація документації довідкових сторінок

Вам може знадобитися зробити резервну копію або зберегти вміст в системі керування вихідним кодом. Також зручно буває використовувати засоби автоматизації документації, наприклад, засоби перекладу або перевірки, для роботи над вмістом області довідки. Дані настроюваної області довідки зберігаються безпосередньо в Dataverse і для цієї мети можуть бути імпортовані або експортовані.

Настроювані довідкові сторінки підтримують настроюваний формат XML. Цей формат описано далі в документі. Додаткові відомості: Користувацька довідка Визначення XML

Під час експорту кожна довідкова сторінка експортується як окремий файл.

Відомості про кероване рішення «Контекстна довідка»

Настроювані області довідки та функції відстежуваних завдань складаються з компонентів рішення в керованому рішенні «Контекстна довідка». Настроювання або створення записів за допомогою таблиць за межами настроюваних областей довідки та функції відстежуваних завдань не підтримується.

Зауважте, що деякі програми, як-от Dynamics 365 Sales і Dynamics 365 Service, містять інтерфейси першого запуску, створені за допомогою таблиць, включених до керованого рішення «Контекстна довідка». Наприклад, для створення цих інтерфейсів першого запуску використовуються як таблиця «Сторінка довідки» (msdyn_helppage), так і таблиця «Демонстрація» (msdyn_tour). Наразі настроювані області довідки та функції відстежуваних завдань не підтримують створення цих інтерфейсів першого запуску.

Запитання й відповіді

У цьому розділі наведено обговорення поширених питань щодо настроюваних довідкових сторінок.

Настроювані довідкові сторінки —це те ж саме, що й настроювана довідка?

Настроювані панелі довідки та керовані завдання є параметром у розділі Установити користувацьку URL-адресу довідки системних параметрів. Настроювані області довідки та відстежувані завдання вмикають область настроюваної довідки, яку можна побачити поруч з формою користувача у правому верхньому куті. Інші варіанти в розділі настройки настроюваної довідки у параметрах системи охоплюють функції настроюваної довідки. Вони дозволяють змінити довідку програм за замовчуванням та спрямувати користувачів у вашій організації на іншу URL-адресу для отримання довідки. Або можна замінити довідку для таблиці з широкими можливостями настроювання, щоб краще описати робочий цикл.

Щоб отримати додаткові відомості про настроювану довідку, перегляньте статтю Увімкнення та використання настроюваної довідки.

Як перенести дані з навчального шляху до настроюваних довідкових сторінок?

Навчальний шлях пропонує два типи довідки: області довідки та послідовні довідкові виноски. Положення послідовних довідкових виносок глибоко інтегровані із застарілим інтерфейсом користувача веб-клієнта і не можуть бути перенесені до нових настроюваних областей довідки.

В залежності від того, скільки тексту містить ваша інтерактивна довідка, найпростішим способом може виявитись просте копіювання даних безпосередньо з інтерфейсу користувача навчального шляху до нового інтерфейсу настроюваних областей довідки. Проте, ви можете експортувати також вміст довідки шляху навчання. Найпростіший спосіб зробити це – експортувати контент за допомогою функції Learning Path>Content Library>Localize>Export . Виберіть потрібні рядки, а потім експортуйте їх. Буде створено файл 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: визначає, чи може користувач перемкнути відео на весь екран. Може мати значення "true" або "false". Цей атрибут не підтримується для деяких джерел відео.
autoplay: указує, що відео почне відтворюватися, як тільки завантажиться сторінка довідки. Може мати значення "true" або "false". Цей атрибут не підтримується для деяких джерел відео.
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: визначає, чи розділ згорнуто або розгорнуто спочатку. Може мати значення "true" (згорнутий) або "false" (розгорнутий).

Зв’язок

Представляє посилання на довідковій сторінці.

Посилання на веб-сторінку, яке відкриється у новому вікні переглядача:

<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, посилання відкривається в поточному вікні браузера.
- Якщо значенням є ім’я an iframe, посилання відкривається в цьому iframe.

Помітка лектора

Представляє помітку лектора на довідковій сторінці.

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

Визначення та використання

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

Атрибути

target: CSS selector , який вказує елемент HTML, над яким буде показана позначка тренера. Цей атрибут є обов’язковим.

Виноска

Представляє виноску на довідковій сторінці.

<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: CSS selector, який вказує елемент HTML, над яким буде з’являтися посилання на виноску. Цей атрибут є обов’язковим.
title: Указує назву повітряної кулі.
details: визначає вміст, який буде відображатися всередині повітряної кульки.

Зворотний зв’язок

Чи була ця сторінка корисна?

Last updated on 2025-07-23

Створення довідки з інструкціями для додатка на основі моделі

Настроювані області довідки та навчальний шлях

вимоги

Увімкніть настроювані області довідки для вашого середовища

Необхідні права

Контекстна настроювана довідка

Навігація в області довідки

Для створення власного вмісту області довідки

Текст довільної форми

Маркери та нумеровані списки

Розділи

Відео та статичні зображення

Посилання

Довідкові виноски та помітки лектора

Рішення і вміст настроюваних областей довідки

Перенесення вмісту за допомогою рішень

Автоматизація документації довідкових сторінок

Відомості про кероване рішення «Контекстна довідка»

Запитання й відповіді

Настроювані довідкові сторінки —це те ж саме, що й настроювана довідка?

Як перенести дані з навчального шляху до настроюваних довідкових сторінок?

Визначення настроюваного XML для довідки

PPHML

Визначення та використання

Заголовок

Визначення та використання

Зображення

Визначення та використання

Атрибути

Відео

Визначення та використання

Підтримувані джерела

Атрибути

Абзац

Визначення та використання

Маркірований список

Визначення та використання

Нумерований список

Визначення та використання

Згортання

Визначення та використання

Атрибути

Зв’язок

Визначення та використання

Атрибути

Помітка лектора

Визначення та використання

Атрибути

Виноска

Визначення та використання

Атрибути

Зворотний зв’язок

Додаткові ресурси