Bekerja sama dengan Artikel Pengetahuan
Pengalaman pengetahuan baru dalam Dynamics 365 Customer Service memungkinkan Anda membuat artikel pengetahuan kaya bersama dengan dukungan versi dan terjemahan. Pengalaman pengetahuan baru menggunakan entitas KnowledgeArticle untuk menyimpan dan mengelola pengetahuan secara native di Dynamics 365 Customer Service.
Catatan
Entitas KBArticle, KBArticleTemplate dan KBArticleComment sekarang ditolak. Ini berarti bahwa kami mengharapkan Anda tidak menggunakan entitas ini lagi. Anda harus menggunakan entitas KnowledgeArticle yang baru diperkenalkan di Dynamics 365 Customer Service. Untuk informasi lebih lanjut, lihat bagian entitas pengetahuan yang tidak digunakan lagi di akhir topik ini.
Buat artikel pengetahuan
Bila Anda membuat rekaman artikel pengetahuan, Dynamics 365 Customer Service secara internal membuat artikel root untuk rekaman. Artikel root bertindak sebagai wadah untuk artikel pengetahuan utama yang dibuat oleh Anda bersama dengan semua versi artikel dan terjemahan yang mungkin Anda buat di masa mendatang. Diagram berikut menggambarkan model entitas untuk entitas KnowledgeArticle.
Bila Anda membuat rekaman artikel pengetahuan, maka itu dibuat dalam status Draft. Dengan menggunakan entitas KnowledgeArticle baru, Anda dapat membuat artikel dengan menentukan isinya dan memformat dalam format HTML. Anda dapat menentukan nilai Anda sendiri untuk KnowledgeArticle.
Atribut ArticlePublicNumber saat membuat rekaman artikel pengetahuan secara terprogram; jika tidak, nilai secara otomatis dibuat berdasarkan format yang ditentukan di area pengaturan Dynamics 365 Customer Service di klien web. KnowledgeArticle.
Atribut ArticlePublicNumber menyimpan ID yang ditampilkan kepada pelanggan, mitra, dan pengguna eksternal lainnya untuk merujuk dan mencari artikel pengetahuan, dan tetap sama di seluruh versi dan terjemahan artikel pengetahuan.
Kode contoh berikut menunjukkan bagaimana Anda dapat membuat rekaman artikel pengetahuan.
KnowledgeArticle newKnowledgeArticle = new KnowledgeArticle
{
Title = "Sample Knowledge Article",
Content = "<p>This is the article content.</p>"
};
knowledgeArticleId = _serviceProxy.Create(newKnowledgeArticle);
Console.WriteLine("Created {0}", newKnowledgeArticle.Title);
Buat versi mayor dan minor Artikel Pengetahuan
Bila Anda membuat rekaman artikel pengetahuan, versi utama akan secara otomatis diatur ke 1 dan versi minor ke 0. Gunakan pesan CreateKnowledgeArticleVersion (CreateKnowledgeArticleVersion Action atau CreateKnowledgeArticleVersionRequest) untuk membuat versi besar atau kecil dari artikel pengetahuan. Di pesan permintaan, atur IsMajor ke true membuat versi utama; atur ke false membuat versi kecil. Rekaman versi baru yang dibuat menggunakan:
KnowledgeArticle. AtributRootArticleIduntuk mempertahankan asosiasi dengan rekaman artikel pengetahuan root.KnowledgeArticle. AtributPreviousArticleContentIduntuk mengarah ke versi rekaman sebelumnya.
Kode contoh berikut menunjukkan bagaimana Anda dapat membuat versi besar rekaman artikel pengetahuan dengan CreateKnowledgeArticleVersionRequest.
CreateKnowledgeArticleVersionRequest versionRequest = new CreateKnowledgeArticleVersionRequest
{
Source = new EntityReference(KnowledgeArticle.EntityLogicalName, knowledgeArticleId),
IsMajor = true
};
CreateKnowledgeArticleVersionResponse versionResponse = (CreateKnowledgeArticleVersionResponse)_serviceProxy.Execute(versionRequest);
Buat Terjemahan Artikel Pengetahuan
Gunakan CreateKnowledgeArticleTranslation Action (web api) atau CreateKnowledgeArticleTranslationRequest (layanan organisasi) untuk membuat terjemahan untuk rekaman artikel pengetahuan. Anda dapat menerjemahkan artikel pengetahuan di lebih dari 150 bahasa, dan informasi tentang bahasa yang didukung ini tersedia di entitas LanguageLocale baru.
Informasi selengkapnya: LanguageLocale entitas.
Menggunakan CreateKnowledgeArticleTranslation Action (web api) atau CreateKnowledgeArticleTranslationRequest (layanan organisasi) membuat rekaman artikel pengetahuan baru dengan judul, konten, deskripsi, dan kata kunci yang disalin dari rekaman sumber ke rekaman baru, dan bahasa rekaman baru diatur ke yang Anda tentukan di permintaan. Anda juga harus menentukan apakah rekaman baru akan berupa versi besar atau kecil. Rekaman baru menggunakan KnowledgeArticle.
Atribut ParentArticleContentId untuk mempertahankan asosiasi dengan rekaman artikel pengetahuan primer.
Setelah Anda menjalankan pesan ini dan mendapatkan respons, ambil rekaman artikel pengetahuan dari objek respons, lalu Perbarui judul, konten, deskripsi, dan kata kunci untuk menambahkan konten terjemahan.
Kode contoh berikut menunjukkan bagaimana membuat terjemahan artikel pengetahuan dengan CreateKnowledgeArticleTranslationRequest:
CreateKnowledgeArticleTranslationRequest translationRequest = new CreateKnowledgeArticleTranslationRequest
{
Source = new EntityReference(KnowledgeArticle.EntityLogicalName, knowledgeArticleId),
Language = new EntityReference(LanguageLocale.EntityLogicalName, languageLocaleId), //languageLocaleId = GUID of the Primary Key of LanguageLocale record
IsMajor = true // Creating a major version
};
CreateKnowledgeArticleTranslationResponse translationResponse = (CreateKnowledgeArticleTranslationResponse)_serviceProxy.Execute(translationRequest);
// Retrieve the new knowledge article record
KnowledgeArticle respObject = (KnowledgeArticle)_serviceProxy.Retrieve(KnowledgeArticle.EntityLogicalName,
translationResponse.CreateKnowledgeArticleTranslation.Id, new ColumnSet(true));
Catatan
Nilai GUID kunci primer (LanguageLocaleId) untuk setiap rekaman bahasa di entitas LanguageLocale sama di semua organisasi Dynamics 365 Customer Service.
Siklus hidup artikel pengetahuan: mengubah status artikel pengetahuan
Selama siklus hidup, artikel pengetahuan dapat berada di status berikut:
0: draft (setelah artikel pengetahuan dibuat)
1: disetujui (setelah artikel pengetahuan disetujui)
2: dijadwalkan (setelah artikel pengetahuan dijadwalkan akan dipublikasikan)
3: Dipublikasikan (setelah artikel pengetahuan dipublikasikan)
4: kedaluwarsa (setelah artikel pengetahuan kedaluwarsa sesuai tanggal kedaluwarsa yang ditentukan saat mempublikasinya)
5: Diarsip (setelah artikel pengetahuan diarsip)
6: Dibuang (setelah artikel pengetahuan dibuang)
Untuk mengubah status artikel, gunakan pesan Update pada rekaman artikel pengetahuan untuk memperbarui atribut KnowledgeArticle.StateCode. Untuk jenis terikat awal, gunakan enumerasi KnowledgeArticleState untuk mengatur status yang mungkin. Informasi selengkapnya: melakukan operasi khusus menggunakan Pembaruan.
Kode contoh berikut menunjukkan bagaimana mempublikasikan rekaman artikel pengetahuan.
// Retrieve the knowledge article record
KnowledgeArticle myKnowledgeArticle = (KnowledgeArticle)_serviceProxy.Retrieve(
KnowledgeArticle.EntityLogicalName, knowledgeArticleId, new ColumnSet("statecode"));
// Update the knowledge article record
myKnowledgeArticle.StateCode = KnowledgeArticleState.Published;
UpdateRequest updateKnowledgeArticle = new UpdateRequest
{
Target = myKnowledgeArticle
};
_serviceProxy.Execute(updateKnowledgeArticle);
Kaitkan rekaman artikel pengetahuan dengan instans entitas Dynamics 365 Customer Service
Bila Anda mengaktifkan pencarian Embedded Knowledge untuk entitas di Dynamics 365 Customer Service menggunakan klien web, relasi banyak ke banyak, msdyn_<Entity_Name>_knowledgearticle, akan dibuat secara otomatis. Anda dapat menggunakan relasi ini untuk mengaitkan secara programatik atau menautkan instans KnowledgeArticle dengan instans entitas Dynamics 365 Customer Service. Bila Anda mengaitkan instans KnowledgeArticle dengan instans entitas, rekaman untuk relasi dibuat di entitas berpotongan yang disebut msdyn_<Entity_Name>_knowledgearticle. Misalnya, bila Anda mengaitkan instans KnowledgeArticle dengan instans Account untuk pertama kali, entitas berpotongan yang disebut msdyn_account_knowledgearticle dibuat, dan rekaman dengan pemetaan Asosiasi dibuat di entitas berpotongan ini. Secara default, entitas Incident (kasus) diaktifkan untuk pencarian embedded knowledge, dan bila Anda menautkan rekaman KnowledgeArticle ke rekaman Incident, rekaman relasi dibuat di entitas berpotongan KnowledgeArticleIncident.
Kode contoh berikut menunjukkan cara mengaitkan instans KnowledgeArticle dengan instans Account:
// Associate the knowledge article record with an account record
// Step 1: Create a collection of knowledge article records that will be
// associated to the account. In this case, we have only a single
// knowledge article record to be associated.
EntityReferenceCollection relatedEntities = new EntityReferenceCollection();
relatedEntities.Add(new EntityReference(KnowledgeArticle.EntityLogicalName, knowledgeArticleId));
// Step 2: Create an object that defines the relationship between knowledge article record and account record.
// Use the many-to-many relationship name (msdyn_account_knowledgearticle) between knowledge article
// record and account record.
Relationship newRelationship = new Relationship("msdyn_account_knowledgearticle");
// Step 3: Associate the knowledge article record with the account record.
_serviceProxy.Associate(Account.EntityLogicalName, accountId, newRelationship, relatedEntities);
Meningkatkan jumlah tampilan Artikel pengetahuan
Gunakan pesan IncrementKnowledgeArticleViewCountRequest untuk menambahkan jumlah tampilan rekaman artikel pengetahuan untuk hari tertentu dalam entitas KnowledgeArticleViews. Jika rekaman tidak ada untuk artikel pengetahuan untuk hari tertentu, ia akan membuat rekaman, lalu Atur nilai hitungan tampilan yang ditentukan di KnowledgeArticleViews.
Atribut KnowledgeArticleView. Jika rekaman sudah ada untuk artikel pengetahuan untuk hari tertentu, maka hanya akan menambah jumlah tampilan di KnowledgeArticleViews.
Atribut KnowledgeArticleView rekaman yang ada.
Cari artikel pengetahuan menggunakan pencarian teks lengkap
Artikel pengetahuan di Dynamics 365 Customer Service, termasuk versi, dan terjemahannya, adalah teks lengkap yang diindeks, dan mendukung pencarian teks lengkap SQL Server. Untuk informasi lebih lanjut tentang pencarian teks lengkap, lihat SQL Server: pencarian teks lengkap.
Gunakan pesan FullTextSearchKnowledgeArticleRequest untuk mencari artikel pengetahuan dari aplikasi Anda untuk menemukan informasi yang Anda cari. Pesan memungkinkan FullTextSearchKnowledgeArticleRequest Anda menggunakan pencocokan batang infleksi (memungkinkan tenses atau infleksi yang berbeda diganti untuk teks pencarian) dan menentukan kriteria kueri (menggunakan FetchXML atau QueryExpression untuk menentukan pemfilteran, pengurutan, pengurutan, dan paging) untuk menemukan artikel pengetahuan dengan teks tertentu. Anda juga dapat memilih untuk menghapus beberapa versi artikel yang sama dalam hasil pencarian dan memfilter pada status artikel pengetahuan saat mencari teks.
Entitas pengetahuan yang tidak digunakan lagi
Entitas lama berikut ini tidak digunakan lagi. Informasi selengkapnya: Entitas pengetahuan yang tidak digunakan lagi
Entitas pengetahuan lama tidak dapat diakses mulai 1 Desember 2020. Sangat disarankan untuk melakukan pemindahan ke entitas KnowledgeArticle. Untuk informasi selengkapnya tentang membuat artikel pengetahuan di Antarmuka Terpadu, lihat Membuat dan mengelola artikel pengetahuan.
Gunakan bantuan berikut untuk migrasi:
- Gunakan SDK, WebAPI, atau Microsoft Power Automate tergantung pada skenario Anda.
- Gunakan alat migrasi sumber terbuka dengan lisensi MIT.
Penting
- Alat migrasi sumber terbuka tidak didukung oleh Microsoft dan mungkin perlu dimodifikasi agar sesuai dengan skenario Anda.
- Selalu Jalankan lingkungan uji sebelum menggunakan dalam produksi.
- Periksa lisensi dan readme sebelum menggunakan alat.
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk