Kongsi melalui

Cipta bantuan berpandu untuk aplikasi Antara Muka Disatukan

  • Artikel

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 iOS tablet dan 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 perkara berikut:

Dayakan anak tetingkap bantuan tersuai untuk persekitaran anda

  1. Buka aplikasi berpandukan model dan kemudian pada bar perintah pilih Tetapan Tetapan. > Tetapan Lanjutan.

  2. Pergi ke Tetapan > Sistem > Pentadbiran.

  3. Pada halaman Pentadbiran, pilih Tetapan Sistem.

  4. Pada tab Umum, di bawah Tetapkan URL Bantuan tersuai, pilih Ya untuk Dayakan Anak Tetingkap Bantuan Tersuai dan Tugasan Dipandu dan kemudian pilih OK.

    Dayakan anak tetingkap bantuan tersuai.

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 jadual boleh disesuaikan dan Tambah parameter pada URL kedua-duanya ditetapkan kepada Tidak.
  • Sesetengah persekitaran mungkin memerlukan anda menetapkan juga Dayakan Laluan Pembelajaran kepada Ya.

Kelayakan yang diperlukan

  • Untuk menulis anak tetingkap bantuan, pembuat aplikasi memerlukan kelayakan cipta, baca, tulis, padam, tambah global dan menambah kepada kelayakan pada jadual Halaman Bantuan. Secara lalai, kedua-dua peranan keselamatan Pentadbir Sistem dan Penyesuai Sistem mempunyai kelayakan ini.
  • Untuk melihat anak tetingkap bantuan dalam aplikasi, pengguna memerlukan kelayakan 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:

  • Permohonan
  • Jadual
  • Borang
  • Bahasa

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.

    Bantuan.

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

    Edit bantuan.

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

Petua

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) (penggunaan untuk kandungan peribadi)
  • YouTube
  • Facebook
  • Vimeo

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.

Sisipkan Belon

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

Sisipkan Tanda Bimbingan

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.

Seret dan lepas

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. Daftar masuk ke Power Apps.
  2. Pada anak tetingkap navigasi kiri, pilih Penyelesaian. Jika item tidak ditemukan dalam anak tetingkap panel sisi, pilih ...Lagi, kemudian pilih item yang anda kehendaki.
  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: Eksport penyelesaian

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: Takrifan 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 tugas dipandu adalah pilihan dalam bahagian Tetapkan URL bantuan tersuai daripada 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 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 adalah untuk mengeksport kandungan anda menggunakan ciri Laluan Pembelajaran > Pustaka Kandungan > Setempatkan > Eksport. 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 <pphml> memberitahu pelayar bantuan bahawa ini ialah dokumen PPHML.

Elemen <pphml> mewakili akar dokumen PPHML.

Elemen <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 <h1> mentakrif tajuk halaman bantuan.

<h1> Ini mesti menjadi elemen pertama dalam <pphml>.

Imej

Mempersembahkan imej dalam halaman bantuan.

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

Definisi dan penggunaan

Elemen <img> membenamkan imej dalam halaman bantuan.

Atribut

  • src: Menentukan URL imej. Atribut ini diperlukan.

  • title: Menentukan tajuk untuk ditunjukkan bersama dengan imej, biasanya sebagai tip alatan 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 <video> membenamkan 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: Menentukan 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 mana titik untuk mula memainkan video.

Perenggan

Mempersembahkan perenggan dalam halaman bantuan.

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

Definisi dan penggunaan

Elemen <p> mentakrifkan perenggan.

Teks dalam perenggan boleh dihiasi dengan cara berikut:

  • Tebal dengan elemen <strong>
  • Italik, dengan elemen <em>
  • Garis lorek dengan elemen <del>
  • Garis bawah, dengan elemen <u>

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 <ul> mentakrifkan senarai berbulet.

Gunakan elemen <ul> bersama dengan elemen <li> 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 <ol> mentakrifkan senarai yang dipesan (bernombor). Gunakan tag <ol> bersama dengan elemen <li> 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 <collapsible> mentakrifkan bahagian kandungan yang pengguna dapat melihat atau sembunyikan atas permintaan.

Atribut

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

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

<a> tag mentakrifkan pautan yang membenarkan pengguna menavigasi dari halaman bantuan ke tapak web atau halaman bantuan lain.

Atribut

  • href: Menentukan URL tapak web atau halaman bantuan untuk menavigasi. Atribut ini diperlukan.
  • target: Menentukan lokasi untuk membuka URL yang dipautkan.
    • Jika tidak wujud atau _self, pautan dianggap sebagai halaman bantuan lain dan ia dibuka dalam pelayar bantuan.
    • Jika _blank, pautan dibuka dalam tetingkap pelayar baharu.
    • Jika _top, pautan dibuka dalam tetingkap pelayar semasa.
    • Jika nilai itu ialah nama 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: pemilih CSS yang menentukan elemen HTML tempat tanda pembimbing 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:pemilih CSS yang menentukan elemen HTML tempat pautan belon akan muncul. Atribut ini diperlukan.
  • title: Menentukan tajuk belon.
  • details: Menentukan kandungan untuk ditunjukkan dalam belon.

Nota

Adakah anda boleh memberitahu kami tentang keutamaan bahasa dokumentasi anda? Jawab tinjauan pendek. (harap maklum bahawa tinjauan ini dalam bahasa Inggeris)

Tinjauan akan mengambil masa lebih kurang tujuh minit. Tiada data peribadi akan dikumpulkan (pernyataan privasi).