Buat bantuan terpandu untuk aplikasi berbasis model Anda

Gunakan panel bantuan kustom dan tugas terpandu untuk memberikan pengalaman bantuan dalam produk yang disesuaikan bagi aplikasi Unified Interface Anda sesuai dengan kebutuhan organisasi Anda. Gunakan panel bantuan kustom untuk menyediakan bantuan dan panduan khusus untuk tabel, formulir, dan bahasa yang berisi teks berformat kaya, tautan ke konten, gambar, dan tautan video.

Penting

  • Panel bantuan kustom menggantikan fitur bantuan berpanduan jalur pembelajaran sebelumnya yang digunakan dengan aplikasi klien web lama.
  • Panel bantuan kustom tidak berfungsi dengan aplikasi Antarmuka Terpadu yang berjalan di perangkat seluler, seperti Android iOS tablet dan smartphone.

Panel bantuan kustom dan jalur pembelajaran

Implementasi bantuan terpandu yang baru untuk panel bantuan kustom berbeda dari fitur bantuan terpandu jalur pembelajaran yang sebelumnya. Kedua fitur memungkinkan Anda membuat bantuan kustom untuk aplikasi Anda. Namun, panel bantuan kustom dioptimalkan untuk skenario bantuan terpandu yang paling umum.

Panel bantuan kustom menyediakan fitur kunci berikut yang tidak tersedia dengan jalur pembelajaran:

  • Teks berformat kaya bentuk bebas, termasuk poin dan penomoran.
  • Tanda panduan dan balon bantuan yang terhubung secara visual.
  • Pilihan lainnya untuk sumber video, termasuk sumber pribadi.
  • Penyimpanan konten bantuan di Microsoft Dataverse sebagai bagian dari solusi Anda.

Panel bantuan kustom tidak menyediakan fitur kunci berikut yang tersedia dengan jalur pembelajaran:

  • Balon bantuan berurutan.
  • Halaman Bantuan per peran.
  • Halaman bantuan untuk bentuk dan ukuran per perangkat, seperti smartphone.

Prasyarat

Untuk menggunakan fitur panel bantuan kustom, lingkungan Anda memerlukan pengaturan lingkungan panel bantuan kustom yang diaktifkan.

Aktifkan panel bantuan kustom untuk lingkungan Anda

  1. Masuk ke pusat admin Power Platform di https://admin.powerplatform.microsoft.com.
  2. Pilih Kelola di panel kiri, lalu buka lingkungan yang Anda inginkan.
  3. Pilih Pengaturan pada bilah perintah, lalu pilih Fitur Produk>.
  4. Di bawah fitur bantuan, ubah Aktifkan Panel Bantuan Kustom menjadi Aktif.

Penting

Pastikan bantuan Kustom untuk entitas yang dapat disesuaikan diatur ke Tidak, jika tidak, Anda tidak dapat mengaktifkan Aktifkan Panel Bantuan Kustom. Ini karena Anda tidak dapat menggunakan panel bantuan kustom dan bantuan yang dapat disesuaikan secara bersamaan.

Hak Istimewa yang diperlukan

  • Untuk membuat panel bantuan, pembuat aplikasi memerlukan privilese global untuk membuat, membaca, menulis, menghapus, menambahkan, dan menambahkan ke pada tabel Help Page. Secara default, peran keamanan Penyesuai Sistem dan Administrator sistem sama-sama memiliki hak istimewa ini.
  • Untuk melihat panel bantuan di aplikasi, pengguna memerlukan hak baca di tabel Halaman Bantuan. Secara bawaan, peran keamanan Help Page Consumer memiliki izin ini. Secara default, peran keamanan pengguna Dasar tidak memiliki hak istimewa pada tabel Halaman Bantuan.

Informasi lebih lanjut: peran keamanan dan hak istimewa

Bantuan kustom yang peka terhadap konteks

Setiap panel bantuan unik untuk konteks ini:

  • Tabel
  • Formulir
  • Dasbor
  • Bahasa
  • Aplikasi

Navigasi panel bantuan

Secara default, panel bantuan tetap terbuka dan pada konten bantuan yang pertama kali Anda buka bahkan saat Anda menavigasi ke formulir lain. Hal ini memungkinkan untuk konten bantuan tetap utuh saat Anda mengarahkan pengguna ke berbagai bagian aplikasi.

Untuk menulis konten panel bantuan

  1. Untuk melihat panel bantuan, buka aplikasi berbasis model, lalu pada bilah perintah pilih Bantuan.

    bantuan.

  2. Pada panel Bantuan, pilih elipsis vertikal, lalu pilih Edit.

    Sunting bantuan.

    Panel bantuan sekarang berada di mode edit dan kursor diposisikan pada judul panel bantuan.

  3. Dari panel edit, Anda dapat melakukan tugas berikut:

    • Memasukkan teks dengan mengetik langsung di area panel bantuan.
    • Format teks dengan fitur rich text dan tambahkan daftar berpoin dan bernomor, bagian, video, gambar, tautan, coach mark, dan bantuan balon.

  4. Untuk menyimpan perubahan, pilih Simpan.

Teks bentuk bebas

Teks dapat ditempatkan di mana pun di panel bantuan. Masukkan teks bentuk bebas sebelum, di, atau setelah bagian. Teks mendukung format huruf tebal, miring, garis bawah, dan coret. Potong, salin, dan tempel dapat digunakan, begitu pula urung bertingkat.

Butir dan daftar bernomor

Memilih ikon butir atau nomor akan mengalihkan baris saat ini menjadi berbutir atau bernomor. Jika Anda telah memilih beberapa baris dalam daftar, setiap baris menjadi berbutir atau bernomor. Membuat tab dan inden subnomor sejajar dalam daftar.

Bagian

Bagian adalah kotak teks yang dapat diciutkan. Anda dapat memasukkan tautan atau teks bentuk bebas di dalamnya. Gunakan bagian untuk mengelompokkan item serupa. Bagian dapat berada dalam keadaan terbuka atau diciutkan secara bawaan.

Gambar statis dan video

Anda dapat memasukkan video dan gambar statis ke panel bantuan. Video dan gambar adalah tautan ke konten di internet. Panel bantuan kustom tidak menyimpan file video dan gambar di panel bantuan. Saat panel bantuan dibuka, panel bantuan kustom mengambil konten dari tautan untuk ditampilkan. Anda dapat menggunakan tautan ke video Microsoft Stream jika Anda ingin mereferensi konten pribadi perusahaan.

Tips

Ingatlah untuk menyalin URL tautan untuk video atau gambar yang Anda inginkan sehingga Anda dapat merekatkannya ke panel bantuan.

Panel bantuan kustom mendukung sumber video berikut:

  • Microsoft Stream (Klasik) (digunakan untuk konten pribadi)
  • YouTube
  • Facebook
  • Vimeo

Tautan dapat berupa ke situs web dan terbuka di jendela yang sama (default) atau terbuka di jendela terpisah. Kemampuan untuk menautkan ke halaman bantuan yang ada belum diaktifkan.

Balon dan tanda pelatih

Balon dan tanda pelatih dapat digunakan untuk menunjuk elemen UI tertentu. Balon dapat memiliki teks di dalamnya.

Sisipkan balon

Tanda pelatih hanya menyorot elemen dengan penunjuk pelatih untuk menarik perhatian pengguna ke elemen UI tersebut.

Sisipkan Tanda Pelatih

Penulis harus menentukan target melalui kemampuan tarik dan lepaskan di properti balon dan tanda pelatih. Penulis dapat memasukkan teks untuk judul dan deskripsi untuk tanda pelatih.

Tarik dan lepas

Catatan

  • Balon dan tanda pelatih tidak berfungsi dengan baik dengan komponen kustom. Fitur ini hanya berlaku untuk komponen UI Antarmuka Terpadu default.
  • Balon bantuan berurutan dan tanda pelatih belum didukung.

Solusi dan konten panel bantuan kustom

Semua konten bantuan disimpan di komponen halaman bantuan di Dataverse sebagai bagian dari solusi Anda. Saat Anda memindahkan solusi dari satu lingkungan ke lingkungan lain, misalnya dari lingkungan pengujian ke lingkungan produksi, Anda dapat menentukan agar baris bantuan diekspor sehingga disertakan dalam solusi. Dengan demikian, Anda dapat tetap mensinkronisasi konten bantuan dengan fitur dalam solusi saat bergerak ke lingkungan yang berbeda. Sebagai bagian dari solusi Anda, panel bantuan kustom mendukung semua fitur aplikasi manajemen siklus hidup (ALM) solusi standar.

Memindahkan konten melalui solusi

Secara default, semua halaman bantuan baru akan muncul dalam solusi default. Jika Anda ingin memindahkan konten ke lingkungan lain, terlebih dahulu Tambahkan halaman bantuan yang ada ke solusi yang tidak terkelola sebelum Anda mengekspornya. Untuk menambahkan halaman bantuan ke solusi yang tidak terkelola, ikuti langkah berikut:

  1. Masuk ke Power Apps.
  2. Di panel navigasi kiri, pilih Solusi. Jika item tidak ada di panel panel samping, pilih ... Lebih banyak dan kemudian pilih item yang Anda inginkan.
  3. Buka solusi tidak terkelola yang diinginkan.
  4. Pilih Tambahkan Yang Ada di bilah perintah, lalu pilih Halaman Bantuan.
  5. Pilih halaman bantuan yang ingin Anda tambahkan, lalu pilih Tambahkan. Informasi lebih lanjut: Solusi ekspor

Otomatisasi dokumentasi halaman bantuan

Anda mungkin ingin mencadangkan atau menyimpan konten Anda di sistem kontrol kode sumber. Anda juga mungkin ingin menggunakan alat otomatisasi dokumentasi, seperti alat terjemahan atau Checker, di konten panel bantuan. Data panel bantuan kustom disimpan langsung di Dataverse dan dapat diekspor serta diimpor untuk tujuan ini.

Panel bantuan kustom mendukung format XML kustom. Format ini didokumentasikan di bawah ini. Informasi selengkapnya: Bantuan kustom Definisi XML

Saat diekspor, setiap halaman bantuan diekspor sebagai file terpisah.

Tentang solusi terkelola Bantuan Kontekstual

Panel bantuan kustom dan fitur tugas terpandu terdiri atas komponen solusi yang ada dalam solusi terkelola Contextual Help. Menyesuaikan atau membuat rekaman menggunakan tabel di luar panel bantuan kustom dan fitur tugas terpandu tidak didukung.

Perhatikan bahwa beberapa aplikasi, seperti Dynamics 365 Sales dan Dynamics 365 Service, menyertakan pengalaman penggunaan pertama yang dibangun menggunakan tabel yang disertakan dalam solusi terkelola Bantuan Kontekstual. Sebagai contoh, tabel Halaman Bantuan (msdyn_helppage) dan Tur (msdyn_tour) sama-sama digunakan dalam pembuatan pengalaman penggunaan pertama ini. Saat ini, panel bantuan kustom dan fitur tugas terpandu belum mendukung pembuatan pengalaman penggunaan pertama ini.

Tanya jawab

Bagian ini membahas tanya jawab tentang halaman bantuan kustom.

Apakah Halaman Bantuan kustom sama dengan bantuan disesuaikan?

Panel bantuan kustom dan tugas terpandu adalah opsi di bagian Tetapkan URL bantuan kustom di setelan sistem. Panel bantuan kustom dan tugas terpandu mengaktifkan panel bantuan yang dapat disesuaikan yang muncul tepat di sebelah formulir pengguna. Pilihan lain dalam pengaturan sistem ini mengatur agar bagian bantuan kustom terdiri dari fitur bantuan yang dapat disesuaikan. Fitur tersebut memungkinkan Anda mengganti bantuan bawaan aplikasi dan mengarahkan pengguna dalam organisasi Anda ke URL bantuan yang berbeda. Atau, Anda dapat mengganti teks bantuan untuk tabel yang sangat dikustomisasi agar Anda dapat menjelaskan alur kerja dengan lebih baik.

Untuk informasi selengkapnya tentang bantuan yang dapat disesuaikan, lihat Mengaktifkan dan menggunakan bantuan yang dapat disesuaikan.

Bagaimana cara memigrasi data saya dari jalur pembelajaran ke halaman bantuan kustom?

Jalur pembelajaran memiliki dua jenis bantuan: panel bantuan dan balon bantuan berurutan. Lokasi balon bantuan sekuensial terintegrasi secara mendalam dengan UI klien web lama dan tidak dapat dialihkan ke panel bantuan kustom baru.

Tergantung pada seberapa banyak teks yang Anda miliki dalam bantuan terpandu Anda mungkin paling mudah untuk hanya menyalin informasi secara langsung dari antarmuka pengguna jalur pembelajaran ke antarmuka pengguna panel bantuan kustom yang baru. Namun, Anda juga dapat mengekspor konten bantuan jalur pembelajaran. Cara paling sederhana untuk melakukannya adalah mengekspor konten Anda menggunakan fitur Jalur Pembelajaran>Pustaka Konten>Lokalkan>Ekspor. Pilih baris yang diinginkan, lalu ekspor. Ini membuat file XLIFF untuk setiap panel bantuan dan tugas terpandu. Kemudian, gunakan editor XLIFF yang tersedia untuk publik atau XLIFF ke HTML Converter untuk mengambil konten Anda.

Definisi XML bantuan kustom

Bagian ini menjelaskan definisi XML bantuan kustom.

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> memberi tahu peramban bantuan bahwa ini adalah dokumen PPHML.

Elemen ini <pphml> mewakili akar dokumen PPHML.

Elemen <pphml> adalah wadah untuk semua elemen PPHML lainnya.

Judul

Menampilkan judul di halaman bantuan.

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

Definisi dan penggunaan

Elemen <h1> menentukan judul dari halaman bantuan.

<h1> Ini pasti elemen pertama di dalamnya <pphml>.

Gambar

Menyajikan gambar di halaman bantuan.

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

Definisi dan penggunaan

Elemen <img> menyematkan gambar di halaman bantuan.

Atribut

  • src: Menentukan URL gambar. Atribut ini harus ada.

  • title: Menentukan judul yang akan ditampilkan bersama dengan gambar, biasanya sebagai tooltip hover.

  • alt: Menentukan teks alternatif untuk gambar. Teks ini digunakan oleh pembaca layar.

Video

Menyajikan video di halaman bantuan.

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

Definisi dan penggunaan

Elemen <video> menyematkan video, seperti tutorial atau video pelatihan, di halaman bantuan.

Sumber yang didukung
  • Microsoft Stream
  • YouTube
  • Facebook
  • Vimeo

Atribut

  • src: Menentukan URL video. Atribut ini harus ada.

  • allowFullScreen: Menentukan apakah pengguna dapat mengalihkan video ke layar penuh. Nilai yang mungkin adalah "true" atau "false". Atribut ini tidak didukung untuk semua sumber video.

  • autoplay: Menentukan bahwa video akan mulai diputar segera setelah halaman bantuan dimuat. Nilai yang mungkin adalah "true" atau "false". Atribut ini tidak didukung untuk semua sumber video.

  • startTime: Menentukan, dalam hitungan detik, dari titik mana untuk mulai memutar video.

Paragraf

Menyajikan paragraf di halaman bantuan.

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

Definisi dan penggunaan

Elemen <p> mendefinisikan sebuah paragraf.

Teks di dalam paragraf dapat dihias dengan cara berikut:

  • Tebal, dengan elemen <strong>
  • Miring, dengan elemen <em>
  • Coret, dengan elemen <del>
  • Garis bawahi, dengan elemen <u>

Dekorasi ini dapat dikombinasikan. Misalnya, buat fragmen teks yang tebal dan bergaris bawah.

Daftar Butir

Menyajikan daftar butir di halaman bantuan.

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

Definisi dan penggunaan

Elemen <ul> mendefinisikan daftar berpoin.

Gunakan elemen <ul> bersama elemen <li> untuk membuat daftar berbutir.

Daftar Bernomor

Menyajikan daftar bernomor di halaman bantuan.

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

Definisi dan penggunaan

Elemen ini <ol> mendefinisikan daftar yang diurutkan (bernomor). Gunakan <ol> tag bersama dengan <li> elemen untuk membuat daftar bernomor.

Dapat diciutkan

Menampilkan bagian yang dapat diciutkan di 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> menentukan bagian konten yang dapat dilihat atau disembunyikan pengguna sesuai permintaan.

Atribut

  • collapsed: Menentukan apakah bagian terlipat atau diperluas saat pertama kali ditampilkan. Nilai yang mungkin adalah "true"(diciutkan) atau "false" (diperluas).

Menyajikan tautan di halaman bantuan.

Tautan ke situs web yang terbuka di jendela browser baru:

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

Tautan ke halaman bantuan lainnya:

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

Definisi dan penggunaan

Tag <a> menentukan link, yang memungkinkan pengguna menavigasi dari halaman bantuan ke situs web, atau ke halaman bantuan lain.

Atribut

  • href: Menentukan URL situs atau halaman bantuan yang akan dinavigasi. Atribut ini harus ada.
  • target: Menentukan tempat membuka URL yang ditautkan.
    • Jika tidak ada atau _self, tautan diasumsikan ke halaman bantuan lain dan dibuka di browser bantuan.
    • Jika _blank, tautan dibuka di jendela browser baru.
    • Jika _top, tautan dibuka di jendela browser saat ini.
    • Jika nilainya adalah nama iframe, tautan akan dibuka di iframe tersebut.

Tanda pelatih

Menyajikan tanda pelatih di halaman bantuan.

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

Definisi dan penggunaan

Tanda pelatih adalah elemen interaktif yang dapat digunakan untuk menarik perhatian pengguna ke titik tertentu di UI aplikasi yang menghosting browser bantuan.

Atribut

  • target: selektor CSS yang menentukan elemen HTML yang di atasnya coach mark akan ditampilkan. Atribut ini harus ada.

Balon

Menyajikan balon di 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

Balon adalah elemen interaktif yang dapat digunakan untuk membantu pengguna melakukan tindakan di UI aplikasi yang menghosting browser bantuan.

Atribut

  • target: selektor CSS yang menentukan elemen HTML tempat tautan balon akan muncul. Atribut ini harus ada.
  • title: Menentukan judul balon.
  • details: Menentukan konten yang akan ditampilkan di dalam balon.
  • Last updated on