Bilgi bankası makaleleriyle çalışma
Dynamics 365 Customer Service'teki yeni bilgi bankası deneyimi, sürüm oluşturma ve çeviri desteğinin yanı sıra zengin bilgi bankası makaleleri oluşturmanızı sağlar. Yeni bilgi bankası deneyimi KnowledgeArticle varlığını, bilgiyi yerel olarak Dynamics 365 Customer Service'te depolamak ve yönetmek için kullanır.
Not
KBArticle, KBArticleTemplate ve KBArticleComment varlıkları artık kullanım dışıdır. Bu, artık bu varlıkları kullanmanızı beklemediğimiz anlamına gelir. Dynamics 365 Customer Service içinde bilgi bankası yönetimi için daha yeni KnowledgeArticle varlığını kullanmanız gerekir. Daha fazla bilgi için bu konunun sonundaki Kullanım dışı bilgi varlıkları bölümüne bakın.
Bilgi bankası makalesi oluşturun
Bilgi bankası makalesi kaydı oluşturduğunuzda Dynamics 365 Customer Service dahili olarak kayıt için bir kök makale oluşturur. Kök makale, gelecekte oluşturabileceğiniz tüm makale sürümleri ve çevirilerle birlikte oluşturduğunuz birincil bilgi bankası makalesi için bir kapsayıcı görevi görür. Aşağıdaki şema KnowledgeArticle varlığı için varlık modelini gösterir.
Bilgi bankası makalesi kaydı oluşturduğunuzda kayıt, Draft durumunda oluşturulur. Yeni KnowledgeArticle varlığı ile içeriğini belirterek ve HTML biçiminde biçimlendirerek bir makale oluşturabilirsiniz. KnowledgeArticle için kendi değerinizi sağlayabilirsiniz.
ArticlePublicNumber özniteliği için kendi değerinizi belirtebilirsiniz. Aksi takdirde değer, web istemcisindeki Dynamics 365 Customer Service ayarları alanında belirttiğiniz biçime göre otomatik olarak oluşturulur. KnowledgeArticle.
ArticlePublicNumber özniteliği, bilgi bankası makalelerine başvurmak ve makalelerde arama yapmak için müşterilere, iş ortaklarına ve diğer harici kullanıcılara açılan kimliği depolar ve bilgi bankası makalesi sürümlerinde ve çevirilerde aynı kalır.
Aşağıdaki örnek kod, bir bilgi bankası makalesi kaydı oluşturmayı gösterir.
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);
Bilgi bankası makalesinin üst ve alt sürümlerini oluşturma
Bilgi bankası makalesi kaydı oluşturduğunuzda üst sürüm otomatik olarak 1 ve alt sürüm 0 olarak ayarlanır. Bilgi bankası makalesinin üst veya alt sürümünü oluşturmak için CreateKnowledgeArticleVersion iletisini (CreateKnowledgeArticleVersion Eylemi ya da CreateKnowledgeArticleVersionRequest) kullanın. İstek iletisinde, üst sürüm oluşturmak için IsMajor öğesini true olarak ayarlayın; alt sürüm oluşturmak için false olarak ayarlayın. Oluşturulan yeni sürüm kaydı şunları kullanır:
KnowledgeArticle.RootArticleIdözniteliğini kullanarak kök bilgi bankası makalesi kaydı ile ilişkisini korur.KnowledgeArticle.PreviousArticleContentIdözniteliğini kullanarak kaydın önceki sürümünü gösterir.
Aşağıdaki örnek kod, CreateKnowledgeArticleVersionRequest kullanarak bir bilgi bankası makalesi kaydının üst sürümünü oluşturmayı gösterir.
CreateKnowledgeArticleVersionRequest versionRequest = new CreateKnowledgeArticleVersionRequest
{
Source = new EntityReference(KnowledgeArticle.EntityLogicalName, knowledgeArticleId),
IsMajor = true
};
CreateKnowledgeArticleVersionResponse versionResponse = (CreateKnowledgeArticleVersionResponse)_serviceProxy.Execute(versionRequest);
Bilgi bankası makalesi çevirisi oluşturma
Bilgi bankası makalesi kaydı için çeviri oluşturmak üzere CreateKnowledgeArticleTranslation Eylemi (Web API'si) veya CreateKnowledgeArticleTranslationRequest (kuruluş servisi) kullanın. Bilgi bankası makalenizi 150'den fazla dilde çevirebilirsiniz ve desteklenen diller hakkında bilgiye yeni LanguageLocale varlığından ulaşabilirsiniz.
Daha fazla bilgi: LanguageLocale Varlığı.
CreateKnowledgeArticleTranslation Eylemi (Web API'si) veya CreateKnowledgeArticleTranslationRequest (kuruluş servisi) kullanıldığında başlık, içerik, açıklama ve anahtar sözcükler kaynak kayıttan yeni kayda kopyalanır ve yeni kaydın dili, istekte belirttiğiniz kayıt kümesine eklenerek yeni bir bilgi bankası makalesi kaydı oluşturulur. Ayrıca yeni kaydın bir üst sürüm veya alt sürüm mü olacağını da belirtmeniz gerekir. Yeni kayıt, KnowledgeArticle kullanır.
ParentArticleContentId özniteliğini kullanarak birincil bilgi bankası makalesi kaydı ile ilişkisini korur.
Bu iletiyi yürütüp bir yanıt aldıktan sonra yanıt nesnesinden bilgi bankası makalesini alın ve ardından çevrilen içeriğe eklemek için başlığı, içeriği, açıklamayı ve anahtar sözcükleri güncelleştirin.
Aşağıdaki örnek kod, CreateKnowledgeArticleTranslationRequest kullanarak bir bilgi bankası makalesi çevirisi oluşturmayı gösterir:
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));
Not
LanguageLocale varlığındaki her dil kaydı için birincil anahtarın (LanguageLocaleId) GUID değeri tüm Dynamics 365 Customer Service kuruluşlarında aynıdır.
Bilgi bankası makalesi yaşam döngüsü: Bilgi bankası makalesinin durumunu değiştirme
Bilgi bankası makalesi, yaşam döngüsü boyunca aşağıdaki durumlarda olabilir:
0: Taslak (bilgi bankası makalesi oluşturulduktan sonra)
1: Onaylandı (bilgi bankası makalesi onaylandıktan sonra)
2: Zamanlandı (bilgi bankası makalesinin yayımlanma zamanı belirlendikten sonra)
3: Yayımlandı (bilgi bankası makalesi yayımlandıktan sonra)
4: Süresi Doldu (bilgi bankası makalesinin, yayımlama sırasında belirtilen son kullanma tarihine göre süresi dolduktan sonra)
5: Arşivlendi (bilgi bankası makalesi arşivlendikten sonra)
6: Atıldı (bilgi bankası makalesi atıldıktan sonra)
Makalenin durumunu değiştirmek üzere KnowledgeArticle.StateCode özniteliğini güncelleştirmek için bilgi bankası makalesi kaydındaki Update iletisini kullanın. Erken atlama türleri için olası durumları ayarlamak üzere KnowledgeArticleState numaralandırmasını kullanın. Daha fazla bilgi: Güncelleştirme kullanarak özel işlemler gerçekleştirme.
Aşağıdaki örnek kod, bir bilgi bankası makalesi kaydını yayımlamayı gösterir.
// 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);
Bilgi bankası makalesi kaydını bir Dynamics 365 Customer Service varlığı kurulumu ile ilişkilendirme
Web istemcisini kullanarak Dynamics 365 Customer Service içinde bir varlık için katıştırılmış bilgi aramasını etkinleştirdiğinizde otomatik olarak çok-çok ilişkisi msdyn_<Entity_Name>_knowledgearticle oluşturulur. Bu ilişkiyi, bir KnowledgeArticle kurulumunu Dynamics 365 Customer Service varlığı kurulumuyla programlama yoluyla ilişkilendirmek veya bağlantılarını kurmak için kullanabilirsiniz. KnowledgeArticle kurulumunu bir varlık kurulumuyla ilişkilendirdiğinizde, kesişim varlığında ilişki için msdyn_<Entity_Name>_knowledgearticle olarak adlandırılan bir kayıt oluşturulur. Örneğin, bir KnowledgeArticle kurulumunu Account kurulumuyla ilk kez ilişkilendirdiğinizde msdyn_account_knowledgearticle olarak adlandırılan bir kesişen varlık ve bu kesişen varlıkta ilişkilendirme eşlemesiyle bir kayıt oluşturulur. Varsayılan olarak Incident (Servis Talebi) varlığı katıştırılmış bilgi bankası araması için etkinleştirilmiştir ve bir KnowledgeArticle kaydını Incident kaydına bağladığınızda KnowledgeArticleIncident kesişim varlığında bir ilişkilendirme kaydı oluşturulur.
Aşağıdaki örnek kod, bir KnowledgeArticle kurulumunun bir Account kurulumuyla ilişkilendirilmesini gösterir:
// 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);
Bilgi bankası makalesi görüntülenme sayısını artırma
KnowledgeArticleViews varlığında, belirli bir gün için bilgi makalesi kaydının görüntülenme sayısını artırmak üzere IncrementKnowledgeArticleViewCountRequest iletisini kullanın. Belirtilen bir günde bilgi bankası makalesi için kayıt yoksa bir kayıt oluşturur ve ardından KnowledgeArticleViews içindeki belirtilen görünüm sayısı değerini ayarlar.
KnowledgeArticleView özniteliği. Belirtilen bir günde bilgi bankası makalesi için zaten bir kayıt varsa yalnızca var olan kaydın KnowledgeArticleViews görünüm sayısını artırır.
KnowledgeArticleView özniteliğindeki görüntülenme sayısını artırır.
Tam metin aramasını kullanarak bilgi bankası makalelerinde arama yapma
Dynamics 365 Customer Service içindeki bilgi bankası makaleleri; sürümleri ve çevirileriyle birlikte tam metin olarak dizinlenir ve SQL Server tam metin aramasını destekler. Tam metin araması hakkında daha fazla bilgi için bkz. SQL Server: Tam Metin Araması.
Aradığınız bilgileri bulmak üzere uygulamalarınızdan bilgi bankası makalesi aramak için FullTextSearchKnowledgeArticleRequest iletisini kullanın. FullTextSearchKnowledgeArticleRequest iletisi, çekim kökü eşlemesi (arama metni için farklı bir zaman çekimi veya ek kullanımına izin verir) kullanmanızı ve belirtilen metne sahip bilgi bankası makalelerini bulmak için sorgu ölçütlerini (filtreleme, düzenleme, sıralama ve sayfalama özelliklerini belirtmek için FetchXML veya QueryExpression kullanarak) belirlemenizi sağlar. Ayrıca arama sonuçlarından aynı makalenin birden çok sürümünü kaldırmayı ve bir metin aramasını bilgi bankası makalesi durumunu filtrelemeyi seçebilirsiniz.
Kullanım dışı bilgi bankası varlıkları
Aşağıdaki eski varlıklar kullanımdan kaldırıldı. Daha fazla bilgi: Kullanım dışı bilgi bankası varlıkları
Eski bilgi bankası varlıklarına 1 Aralık 2020 itibariyle erişilemez. KnowledgeArticle varlığına geçmenizi kesinlikle öneririz. Birleşik Arabirim'de bir bilgi bankası makalesi oluşturma hakkında daha fazla bilgi için bkz. Bilgi bankası makaleleri oluşturma ve yönetme.
Geçiş konusunda yardım için aşağıdakileri kullanın:
- Senaryolarınıza bağlı olarak SDK, WebAPI veya Microsoft Power Automate kullanın.
- MIT lisansı ile açık kaynak geçiş aracını kullanın.
Önemli
- Açık kaynak geçiş aracı, Microsoft tarafından desteklenmez ve aracın senaryolarınıza uyacak şekilde değiştirilmesi gerekebilir.
- Üretimde kullanmadan önce daima bir test ortamı çalıştırın.
- Aracı kullanmadan önce lisansı ve benioku dosyasını denetleyin.