Praktik terbaik untuk menggunakan layanan Pelaporan Organisasi Microsoft Learn
Artikel ini menjelaskan praktik terbaik untuk menggunakan layanan Learn Organizational Reporting.
Memahami Perjanjian Akses dan Berbagi Data Microsoft Learn
Setelah menggunakan layanan berbagi data ini, Anda mengakui dan menerima Perjanjian Akses dan Berbagi Data Microsoft Learn untuk memungkinkan Microsoft berbagi data Learn dengan organisasi Anda untuk pengguna Learn yang masuk dengan ID penyewa organisasi Anda. Baca dan pahami perjanjian ini sebelum menggunakan Microsoft Learn Organizational Reporting Service dan menyertakan output di lingkungan produksi apa pun.
Rencanakan solusi pelaporan apa yang akan Anda gunakan untuk memvisualisasikan data yang ditawarkan dalam layanan ini
Layanan Pelaporan Organisasi Microsoft Learn memberikan data penyelesaian mentah kepada organisasi dan tidak memiliki dasbor apa pun secara default. Anda dapat mengambil data dan mengekspornya ke CSV untuk melihat data dengan cepat, tetapi perlu digabungkan agar berdampak.
Kami telah menyediakan templat Learn Organizational Reporting Power BI untuk penyimpanan SQL DB yang memiliki banyak visualisasi data standar di dalamnya, tetapi Anda juga dapat menggunakan solusi pelaporan pilihan Anda. Rencanakan ke depan apa yang ingin Anda gunakan, sehingga Anda dapat menyambungkannya ke penyimpanan data sebagai bagian dari proses penyiapan.
Memahami Learn con mode tenda l
Untuk menggunakan respons layanan Pelaporan Organisasi Microsoft Learn secara efektif, penting untuk memahami jenis konten yang tersedia di Microsoft Learn dan hubungannya satu sama lain. Tinjau artikel Pelajari tipe konten untuk informasi selengkapnya.
Terutama:
- UID adalah singkatan dari "ID Unik" dan unik untuk setiap objek konten. Jika UID berubah, meskipun judul atau metadata lainnya tetap sama, konten dianggap sebagai objek baru.
- Modul adalah objek inti dalam katalog pelatihan Learn. Mereka semua mampu berdiri sendiri, dalam arti bahwa mereka mengajarkan skenario atau konsep end-to-end di dalamnya dan tidak memerlukan mengambil modul prasyarat. Bagi sebagian orang, ini adalah itu dan mereka bukan bagian dari jalur pembelajaran. Bagi yang lain, mereka dibundel bersama-sama dalam satu atau beberapa jalur pembelajaran yang membawa pengguna melalui membangun konsep yang lebih canggih. Modul tidak harus menjadi bagian dari jalur pembelajaran, atau dapat menjadi bagian dari satu atau beberapa modul.
- Unit tidak ditulis sebagai konten mandiri. Mereka dimaksudkan untuk diambil dalam urutan tertentu untuk modul. Untuk alasan ini, kami menyertakan tautan ke halaman detail modul dan unit pertama dalam catatan modul sehingga pengguna dapat memulai di sana dan melanjutkan melalui konten.
Memahami cara kerja pelokalan di Pelajari dan bagaimana konten yang dilokalkan tercermin dalam output pelaporan org
Microsoft Learn mendukung lebih dari 65 lokal di situs dan sebagian besar konten telah diterjemahkan ke dalam lokal ini. Kami bertujuan untuk membuat konten tersedia dalam semua bahasa yang diajarkan produk dalam konten tersedia di, tetapi tidak semua pengalaman lokal telah menerjemahkan konten yang tersedia.
Ketika rekaman lokal tidak memiliki terjemahan terkait yang tersedia, konten di situs dan respons API "kembali" ke bahasa Inggris sebagai default. Dalam kasus output API, Anda akan melihat metadata bahasa Inggris di respons lokal lainnya saat fallback terjadi. Namun, URL ke konten masih akan menunjuk ke lokal, meskipun konten utama mungkin mundur dan alasannya adalah untuk memungkinkan pengguna masih menavigasi situs di lokal tersebut (yang akan menampilkan header/footer yang diterjemahkan, dan tautan lain yang memiliki terjemahan tersedia).
Ketika pembaruan diterbitkan ke konten bahasa Inggris, alur pelokalan kami berfungsi untuk memperbarui versi yang dilokalkan sesegera mungkin - biasanya dalam beberapa hari setelah perubahan asli. Anda dapat melihat daftar lengkap lokal yang didukung melalui footer situs (pilih tautan ke bahasa tempat Anda melihat situs).
Catatan penyelesaian konten pelatihan kami bersifat lokal-agnostik, artinya, kami tidak membedakan versi konten yang dilokalkan sebagai objek terpisah dalam rekaman penyelesaian pelatihan pengguna kami. Tidak peduli bahasa apa yang pengguna selesaikan pelatihannya, mereka akan menerima kredit untuk objek keseluruhan, dan kami tidak menyimpan referensi ke bahasa apa yang diselesaikannya. Ini berarti jika Anda menerapkan data layanan Learn Organizational Reporting dalam pengalaman pembelajaran Anda, Anda harus memperhitungkan hal ini dan, jika Anda memuat objek konten sebagai objek terpisah, terapkan kesetaraan di antara mereka sehingga tidak peduli bahasa mana yang digunakan pengguna untuk menyelesaikan pelatihan, mereka akan mendapatkan kredit untuk itu dalam bahasa lain dan tidak perlu mengambilnya kembali.
Pahami cara kerja penerapan versi konten di Pelajari dan bagaimana penerapan versi tersebut tercermin dalam output pelaporan org
Terutama, konten sedang diperbarui sepanjang waktu. Kami menerbitkan pembaruan biasanya dua kali sehari. Mereka mungkin kecil, seperti perubahan teks kecil, atau utama, seperti revisi utama, penambahan, atau penghapusan. Secara umum, portofolio konten dikelola sebagai proyek sumber terbuka besar dan sangat diatur dengan ribuan kontributor, dan dengan demikian, perubahan terjadi sepanjang waktu. Jika Anda menggunakan data layanan Learn Organizational Reporting di sistem produksi, Anda harus mengetahui hal ini dan membuat sistem Anda dapat menanganinya.
Saat objek konten baru ditambahkan, objek tersebut akan muncul sebagai objek baru (diidentifikasi oleh UID) dalam respons. Saat konten dimodifikasi, Anda dapat mengetahui berdasarkan nilai last_modified. Ketika konten dihapus, konten akan dihapus dari respons. Meskipun terkadang ada sedikit keterlambatan pada konten yang diperbarui dalam respons API, ketika pengguna mengikuti URL ke konten, mereka akan selalu melihat informasi terbaru. Dalam kasus penghapusan, URL lama akan dialihkan ke konten atau pengalaman baru.
Saat ini tidak ada referensi ke versi konten di luar last_modified tanggal.
Memahami batasan layanan Pelaporan Organisasi
Lihat Batasan dalam artikel gambaran umum fitur Learn Organizational Reporting service.
Merefresh data secara teratur
Jika Anda menggunakan informasi katalog dari data layanan Learn Organizational Reporting untuk mendukung proses bisnis Anda, atau ditampilkan untuk pelanggan sebagai bagian dari pengalaman situs Anda, pastikan Anda me-refresh konten setidaknya sekali sehari.
Terutama, konten sedang diperbarui sepanjang waktu. Kami menerbitkan pembaruan biasanya dua kali sehari. Mereka mungkin kecil, seperti perubahan teks kecil, atau utama, seperti revisi utama, penambahan, atau penghapusan. Secara umum, portofolio konten dikelola sebagai proyek sumber terbuka besar dan sangat diatur dengan ribuan kontributor, dan dengan demikian, perubahan terjadi sepanjang waktu. Jika Anda menggunakan data layanan Pelaporan Organisasi dalam sistem produksi, Anda harus mengetahui hal ini dan membuat sistem Anda dapat menanganinya.
Pastikan informasi Microsoft Entra yang bergabung disegarkan secara teratur
Untuk mengetahui siapa yang dimaksud oleh setiap rekaman penyelesaian, Anda harus menggabungkan data himpunan data Pelaporan Organisasi ke informasi Microsoft Entra Anda, sehingga nama muncul bersama catatan penyelesaian. Jika Anda tidak me-refresh data yang bergabung dengan Microsoft Entra, anda mungkin memiliki catatan penyelesaian dengan data personel kedaluarsa, atau yang kehilangan data PII yang terkait dengannya.
Mereferensikan dokumentasi pengembang
Dokumentasi pengembang layanan Learn Organizational Reporting memiliki daftar lengkap data yang disediakan sebagai bagian dari respons, dan rekomendasi tentang bagaimana setiap bidang direkomendasikan untuk digunakan untuk mendukung pengalaman pembelajaran yang hebat.
Langkah berikutnya
Untuk informasi selengkapnya untuk mendukung Anda dengan Learn Organizational Reporting Service, tinjau artikel berikut ini: