Cipta bantuan berpandu untuk apl dipacu model anda

Gunakan anak tetingkap bantuan tersuai dan tugas dipandu untuk memberi aplikasi Antara Muka Disatukan anda sebagai pengalaman bantuan produk tersuai yang disesuaikan dengan organisasi anda. Gunakan anak tetingkap bantuan tersuai untuk menyediakan bantuan Jadual, borang dan panduan khusus bahasa termasuk dengan teks, pautan kandungan, imej dan pautan video yang kaya.

Penting

• Anak tetingkap bantuan tersuai menggantikan ciri bantuan laluan pembelajaran berpandu sebelumnya yang digunakan dengan aplikasi klien web legasi.
• Anak tetingkap bantuan tersuai tidak berfungsi dengan apl Antara Muka Disatukan yang berjalan pada peranti mudah alih, seperti Android tablet dan iOS telefon pintar.

Anak tetingkap bantuan tersuai dan laluan pembelajaran

Pelaksanaan bantuan berpandu baharu anak tetingkap bantuan tersuai berbeza daripada ciri bantuan berpandu laluan pembelajaran sebelumnya. Kedua-dua ciri ini membolehkan anda mencipta bantuan tersuai untuk aplikasi anda. Walau bagaimanapun, anak tetingkap bantuan tersuai dioptimumkan untuk senario bantuan berpandu paling umum.

Anak tetingkap bantuan tersuai menyediakan ciri utama berikut yang tidak tersedia dengan laluan pembelajaran:

• Teks kaya bentuk bebas termasuk bulet dan penomboran.
• Tanda pembimbing dan belon bantuan yang dipautkan secara ketara.
• Pilihan lanjut untuk sumber video termasuk sumber peribadi.
• Storan kandungan bantuan dalam Microsoft Dataverse sebagai sebahagian daripada penyelesaian anda.

Anak tetingkap bantuan tersuai tidak menyediakan ciri utama berikut yang tersedia dengan laluan pembelajaran:

• Belon bantuan berjujukan.
• Halaman bantuan setiap peranan.
• Halaman bantuan untuk setiap faktor bentuk peranti seperti telefon pintar.

Prasyarat

Untuk menggunakan ciri anak tetingkap bantuan tersuai, persekitaran anda memerlukan tetapan persekitaran anak tetingkap bantuan tersuai didayakan.

Dayakan anak tetingkap bantuan tersuai untuk persekitaran anda

1. Daftar masuk ke pusat pentadbir Power Platform di https://admin.powerplatform.microsoft.com.
2. Dalam Tetapan untuk persekitaran yang dipilih, pilih Ciri Produk>.
3. Di bawah Ciri bantuan, hidupkan Dayakan Anak Tetingkap Bantuan Tersuai kepada Dihidupkan.

Penting

Anda boleh mendayakan anak tetingkap bantuan tersuai atau bantuan boleh disesuaikan tetapi bukan kedua-duanya pada masa yang sama. Sahkan bahawa Gunakan bantuan untuk entiti boleh disesuaikan ditetapkan kepada Tidak.

Kelayakan yang diperlukan

• Untuk mengarang anak tetingkap bantuan, pembuat aplikasi memerlukan cipta, membaca, menulis, memadam, menambah dan menambah keistimewaan global pada jadual Halaman Bantuan. Secara lalai, kedua-dua peranan keselamatan Pentadbir Sistem dan Penyesuai Sistem mempunyai kelayakan ini.
• Untuk melihat anak tetingkap bantuan dalam apl, pengguna memerlukan keistimewaan baca pada jadual Halaman Bantuan. Secara lalai, peranan keselamatan Pengguna Halaman Bantuan mempunyai kelayakan ini. Secara lalai, peranan keselamatan Pengguna Asas tidak mempunyai sebarang kelayakan pada jadual Halaman Bantuan.

Maklumat lanjut: Peranan keselamatan dan kelayakan

Bantuan tersuai sensitif konteks

Setiap anak tetingkap bantuan adalah unik untuk konteks ini:

• Table
• Borang
• Papan pemuka
• Bahasa
• Permohonan

Navigasi anak tetingkap bantuan

Secara lalai, anak tetingkap bantuan kekal terbuka dan pada kandungan bantuan yang pertama kali dibuka oleh anda walaupun anda menavigasi ke borang yang berbeza. Ini membenarkan kandungan bantuan kekal utuh apabila anda mengarahkan pengguna ke bahagian aplikasi yang berbeza.

Untuk mengarang kandungan anak tetingkap bantuan

1. Untuk melihat anak tetingkap bantuan, buka aplikasi dipacu model dan kemudian pada bar perintah pilih Bantuan.

   

2. Pada anak tetingkap Bantuan, pilih elips menegak dan kemudian pilih Edit.

   

   Anak tetingkap bantuan kini dalam mod edit dan kursor diletakkan pada tajuk anak tetingkap bantuan.

3. Dari anak tetingkap edit anda boleh melaksanakan tugas berikut:

   • Masukkan teks dengan menaip secara terus dalam kawasan anak tetingkap bantuan.
   • Format teks melalui keupayaan teks kaya dan tambah senarai peluru/bernombor, bahagian, video, imej, pautan, tanda bimbingan dan bantuan belon.

4. Untuk menyimpan perubahan anda, pilih Simpan.

Teks bentuk bebas

Teks boleh diletakkan di mana-mana dalam anak tetingkap bantuan. Masukkan teks bentuk percuma sebelum, dalam atau selepas bahagian. Teks menyokong format fon tebal, italik, garis bawah dan garis lorek. Potong, salin dan tampal boleh digunakan termasuk buat asal berbilang tahap.

Senarai bulet dan bernombor

Memilih ikon bulet atau nombor akan menogol baris semasa untuk dibuletkan atau dinomborkan. Jika anda telah memilih berbilang baris dalam senarai, setiap baris menjadi berbulet atau bernombor. Penggunaan tab dan mengengsot subnombor sejajar dalam senarai.

Bahagian

Bahagian ialah kotak teks boleh runtuh. Anda boleh meletakkan pautan atau teks bentuk bebas dalamnya. Gunakan bahagian untuk mengumpulkan item serupa. Bahagian boleh sama ada dibuka atau diruntuh secara lalai.

Video dan imej statik

Anda boleh menyisipkan video dan imej statik ke dalam anak tetingkap bantuan anda. Video dan imej adalah pautan ke kandungan pada internet. Anak tetingkap bantuan tersuai tidak menyimpan fail video dan imej dalam anak tetingkap bantuan anda. Apabila anak tetingkap bantuan dibuka, anak tetingkap bantuan tersuai membawa kandungan dalam pautan untuk memaparkannya. Anda boleh menggunakan pautan ke video Microsoft Stream jika anda mahu merujuk kandungan peribadi korporat.

Tip

Jangan lupa untuk menyalin URL pautan bagi video atau imej yang anda mahu supaya anda boleh menampalnya ke dalam anak tetingkap bantuan anda.

Anak tetingkap bantuan tersuai menyokong sumber video berikut:

• Microsoft Stream (Klasik) (digunakan untuk kandungan peribadi)
• YouTube
• Facebook
• Vimeo

Pautan

Pautan boleh ke tapak web dan dibuka dalam tetingkap (lalai) yang sama atau dibuka dalam tetingkap yang berasingan. Keupayaan untuk memaut ke halaman bantuan sedia ada masih belum didayakan.

Belon dan tanda pembimbing

Belon dan tanda pembimbing boleh digunakan untuk menunjukkan elemen UI tertentu. Belon boleh mempunyai teks dalamnya.

Tanda bimbingan hanya menyerlahkan elemen dengan penunjuk bimbingan untuk menarik perhatian pengguna kepada elemen UI.

Pengarang perlu untuk mentakrifkan sasaran melalui keupayaan seret dan lepas dalam sifat belon dan tanda bimbingan. Pengarang boleh memasukkan teks untuk tajuk dan perihalan untuk tanda bimbingan.

Nota

• Belon dan tanda bimbingan tidak berfungsi dengan baik dengan komponen tersuai. Ciri ini hanya digunakan untuk komponen UI Antara Muka Disatukan lalai.
• Bantuan jujukan belon dan tanda bimbingan tidak disokong lagi.

Penyelesaian dan kandungan anak tetingkap bantuan tersuai

Semua kandungan bantuan disimpan dalam komponen halaman bantuan dalam Dataverse sebagai sebahagian daripada penyelesaian anda. Apabila anda menggerakkan penyelesaian anda daripada satu persekitaran kepada yang lain, seperti daripada menguji untuk pengeluaran, anda boleh mentakrifkan baris bantuan anda dieksport supaya ia disertakan dalam penyelesaian. Ini membolehkan anda menyimpan kandungan bantuan anda segerak dengan ciri dalam penyelesaian anda kerana ia bergerak ke persekitaran yang berbeza. Sebagai sebahagian daripada penyelesaian anda, panel bantuan tersuai menyokong semua ciri pengurusan kitaran hayat aplikasi (ALM) penyelesaian.

Mengalihkan kandungan melalui penyelesaian

Secara lalai, semua halaman bantuan baharu muncul dalam penyelesaian lalai. Jika anda ingin memindahkan kandungan anda ke persekitaran yang lain, tambah dahulu halaman bantuan sedia ada ke dalam penyelesaian tidak terurus sebelum anda mengeksportnya. Untuk menambah halaman bantuan kepada penyelesaian tidak terurus, ikuti langkah-langkah berikut:

1. Log masuk Power Apps.
2. Pada anak tetingkap navigasi kiri, pilih Penyelesaian. Jika item tiada dalam anak tetingkap panel sisi, pilih ... Lagi dan kemudian pilih item yang anda mahukan.
3. Buka penyelesaian tak terurus yang anda mahu.
4. Pilih Tambah Sedia Ada pada bar perintah, dan kemudian pilih Halaman Bantuan.
5. Pilih halaman bantuan yang anda mahu tambah dan kemudian pilih Tambah. Maklumat lanjut: Penyelesaian eksport

Pengautomatikan dokumentasi halaman bantuan

Anda mungkin ingin menyandarkan atau menyimpan kandungan anda dalam sistem kawalan kod sumber. Anda mungkin juga ingin menggunakan alat pengautomatikan dokumentasi seperti alat terjemahan atau pemeriksa pada kandungan anak tetingkap bantuan. Data anak tetingkap bantuan tersuai disimpan secara terus dalam Dataverse dan boleh dieksport dan diimport untuk tujuan ini.

Anak tetingkap bantuan tersuai menyokong format XML tersuai. Format ini didokumenkan di bawah. Maklumat lanjut: Definisi XML bantuan tersuai

Apabila dieksport, setiap halaman bantuan dieksport sebagai fail berasingan.

Tentang penyelesaian terurus Bantuan Kontekstual

Anak tetingkap bantuan tersuai dan ciri tugas dipandu terdiri daripada komponen penyelesaian dalam penyelesaian terurus Bantuan Kontekstual. Menyesuaikan atau mencipta rekod menggunakan jadual di luar anak tetingkap bantuan tersuai dan ciri tugas dipandu tidak disokong.

Perhatikan bahawa sesetengah aplikasi, seperti Dynamics 365 Sales dan Dynamics 365 Service, termasuk pengalaman pelaksanaan pertama yang dibina menggunakan jadual yang disertakan dalam penyelesaian terurus Bantuan Kontekstual. Contohnya, kedua-dua jadual Halaman Bantuan (msdyn_helppage) dan Lawatan (msdyn_tour) digunakan dalam penciptaan pengalaman pelaksanaan pertama ini. Pada masa ini, ciri anak tetingkap bantuan tersuai dan tugas dipandu tidak menyokong mencipta pengalaman pelaksanaan pertama ini.

Soalan lazim

Bahagian ini membincangkan soalan lazim tentang halaman bantuan tersuai.

Adakah halaman bantuan tersuai sama seperti bantuan boleh disesuaikan?

Anak tetingkap bantuan tersuai dan tugasan berpandu ialah pilihan dalam bahagian Tetapkan URL bantuan tersuai pada tetapan sistem. Anak tetingkap bantuan tersuai dan tugas dipandu mendayakan anak tetingkap bantuan boleh disesuaikan yang ditunjukkan di sebelah borang pengguna. Pilihan lain dalam tetapan sistem ini menetapkan bahagian bantuan tersuai yang terdiri daripada ciri bantuan boleh disesuaikan. Ia membenarkan anda untuk mengganti bantuan aplikasi lalai dan menghalakan pengguna dalam organisasi anda ke URL berbeza untuk bantuan. Secara alternatif, anda boleh mengganti bantuan untuk jadual yang sangat tersuai supaya anda boleh menerangkan aliran kerja anda dengan lebih baik.

Untuk mendapatkan maklumat lanjut tentang bantuan boleh disesuaikan, lihat Dayakan dan gunakan bantuan boleh disesuaikan.

Bagaimanakah cara memindahkan data saya daripada laluan pembelajaran kepada halaman bantuan tersuai?

Laluan pembelajaran mempunyai dua jenis bantuan: membantu anak tetingkap dan belon bantuan berjujukan. Lokasi belon bantuan berjujukan berintegrasi dengan UI klien web legasi dan tidak boleh dipindahkan ke anak tetingkap bantuan tersuai yang baharu.

Bergantung pada bilangan teks yang anda miliki dalam bantuan berpandu anda, ia mungkin paling mudah untuk menyalin maklumat secara terus dari antara muka pengguna laluan pembelajaran ke antara muka pengguna anak tetingkap bantuan tersuai yang baharu. Walau bagaimanapun, anda juga boleh mengeksport kandungan bantuan laluan pembelajaran anda. Cara paling mudah untuk melakukan ini ialah mengeksport kandungan anda menggunakan ciri Eksport>Setempat>Perpustakaan Kandungan>Laluan Pembelajaran . Pilih baris yang anda mahu dan eksportnya. Ini mencipta fail XLIFF untuk setiap anak tetingkap bantuan dan tugas dipandu. Kemudian, gunakan editor XLIFF yang tersedia secara umum atau XLIFF untuk penukar HTML untuk mendapatkan semula kandungan anda.

Takrifan XML bantuan tersuai

Bahagian ini menerangkan takrifan XML bantuan tersuai.

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>

Definisi dan penggunaan

Elemen ini <pphml> memberitahu penyemak imbas bantuan bahawa ini adalah dokumen PPHML.

Elemen ini <pphml> mewakili akar dokumen PPHML.

Elemen ini <pphml> ialah bekas untuk semua elemen PPHML yang lain.

Tajuk

Mempersembahkan tajuk dalam halaman bantuan.

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

Definisi dan Penggunaan

Elemen ini <h1> mentakrifkan tajuk halaman bantuan.

<h1> Ini mesti menjadi elemen pertama di dalamnya <pphml>.

Imej

Mempersembahkan imej dalam halaman bantuan.

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

Definisi dan penggunaan

Elemen membenamkan <img> imej dalam halaman bantuan.

Atribut

• src: Menentukan URL imej. Atribut ini diperlukan.

• title: Menentukan tajuk untuk dipaparkan bersama-sama dengan imej, biasanya sebagai petua alat tuding.

• alt: Menentukan teks alternatif untuk imej. Teks ini digunakan oleh pembaca skrin.

Video

Mempersembahkan video dalam halaman bantuan.

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

Definisi dan penggunaan

Elemen membenamkan <video> video, seperti tutorial atau filem latihan, dalam halaman bantuan.

Sumber yang disokong

• Microsoft Stream
• YouTube
• Facebook
• Vimeo

Atribut

• src: Menentukan URL video. Atribut ini diperlukan.

• allowFullScreen: Menentukan sama ada pengguna boleh menukar video kepada skrin penuh. Nilai mungkin "benar" atau "palsu". Atribut ini tidak disokong untuk semua sumber video.

• autoplay: Menyatakan bahawa video akan mula dimainkan sebaik sahaja halaman bantuan dimuatkan. Nilai mungkin "benar" atau "palsu". Atribut ini tidak disokong untuk semua sumber video.

• startTime: Menentukan, dalam beberapa saat, dari titik mana untuk mula memainkan video.

Perenggan

Mempersembahkan perenggan dalam halaman bantuan.

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

Definisi dan penggunaan

Elemen mentakrifkan <p> perenggan.

Teks dalam perenggan boleh dihiasi dengan cara berikut:

• Berani, dengan <strong> elemen
• Italic, dengan <em> elemen
• Coretan, dengan <del> elemen
• Garis bawah, dengan <u> elemen

Hiasan ini boleh digabungkan. Contohnya, buat pecahan teks yang kedua-duanya tebal dan digariskan.

Senarai berbulet

Mempersembahkan senarai berbulet dalam halaman bantuan.

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

Definisi dan penggunaan

Elemen ini <ul> mentakrifkan senarai berbulet.

Gunakan elemen bersama-sama <ul> dengan <li> elemen untuk mencipta senarai berbulet.

Senarai bernombor

Mempersembahkan senarai bernombor dalam halaman bantuan.

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

Definisi dan penggunaan

Elemen ini <ol> mentakrifkan senarai tertib (bernombor). Gunakan <ol> tag bersama-sama dengan <li> elemen untuk mencipta senarai bernombor.

Boleh runtuh

Mempersembahkan bahagian boleh runtuh dalam halaman bantuan.

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

Definisi dan penggunaan

Elemen ini <collapsible> mentakrifkan bahagian kandungan yang boleh dilihat atau disembunyikan oleh pengguna atas permintaan.

Atribut

• collapsed: Menentukan sama ada bahagian diruntuhkan atau dikembangkan pada mulanya. Nilai mungkin adalah "benar" (diruntuhkan) atau "palsu" (dikembangkan).

Pautan

Mempersembahkan pautan dalam halaman bantuan.

Pautan ke tapak web yang dibuka dalam tetingkap pelayar baharu:

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

Pautan ke halaman bantuan lain:

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

Definisi dan penggunaan

Teg <a> mentakrifkan pautan, yang membolehkan pengguna menavigasi dari halaman bantuan ke tapak web atau ke halaman bantuan lain.

Atribut

• href: Menentukan URL tapak web atau halaman bantuan yang hendak dilayari. Atribut ini diperlukan.
• target: Menentukan tempat untuk membuka URL yang dipautkan.
  • Jika tidak hadir atau _self, pautan diandaikan ke halaman bantuan lain dan ia dibuka dalam penyemak imbas bantuan.
  • Jika _blank, pautan dibuka dalam tetingkap penyemak imbas baharu.
  • Jika _top, pautan dibuka dalam tetingkap penyemak imbas semasa.
  • Jika nilainya ialah nama an iframe, pautan dibuka dalam iframe itu.

Tanda pembimbing

Mempersembahkan tanda pembimbing dalam halaman bantuan.

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

Definisi dan penggunaan

Tanda pembimbing ialah elemen interaktif yang boleh digunakan untuk menarik perhatian pengguna ke titik tertentu dalam UI pengehosan aplikasi pelayar bantuan.

Atribut

• target:selector CSS yang menentukan elemen HTML di mana tanda jurulatih akan ditunjukkan. Atribut ini diperlukan.

Belon

Mempersembahkan belon dalam halaman bantuan.

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

Definisi dan penggunaan

Belon ialah elemen interaktif yang boleh digunakan untuk membantu pengguna melaksanakan tindakan dalam UI pengehosan aplikasi pelayar bantuan.

Atribut

• target:selector yang CSS menentukan elemen HTML di mana pautan belon akan muncul. Atribut ini diperlukan.
• title: Menentukan tajuk belon.
• details: Menentukan kandungan yang akan dipaparkan di dalam belon.