שתף באמצעות

עבודה עם מאמרי ידע

  • מאמר

הערה

אלה פרטי זמינות התכונות:

Dynamics 365 Contact Center – מוטבע Dynamics 365 Contact Center – עצמאי Dynamics 365 Customer Service
כן ‏‏כן‬ ‏‏כן‬

חווית הידע החדשה מאפשרת לך ליצור מאמרי ידע עשירים יחד עם ניהול גרסאות ותמיכה בתרגום. חוויית הידע החדשה משתמשת בישות KnowledgeArticle לאחסון וניהול ידע באופן טבעי ב- Dynamics 365 Customer Service.

הערה

הישויות KBArticle, KBArticleTemplate וגם KBArticleComment הוצאו משימוש כעת. המשמעות היא שאנחנו לא מצפים שתשתמש בישויות האלה יותר. עליך להשתמש ביישות KnowledgeArticle החדשה יותר לניהול ידע ב- Dynamics 365 Customer Service. למידע נוסף ראה את המקטע ישויות ידע שהוצאו משימוש בסוף נושא זה.

יצירת מאמר ידע

כשאתה יוצר רשומת מאמר ידע, Dynamics 365 Customer Service יוצר באופן פנימי מאמר שורש לרשומה. מאמר השורש משמש כמיכל למאמר הידע העיקרי שנוצר על ידך יחד עם כל גרסאות המאמר והתרגומים שתוכל ליצור בעתיד. התרשים הבא מתאר את מודל הישויות עבור הישות KnowledgeArticle.

מודל ישויות KnowledgeArticle.

כשאתה יוצר רשומת מאמר ידע, הוא נוצר במצב Draft. באמצעות ישות KnowledgeArticle החדשה, אתה יכול ליצור מאמר על ידי ציון התוכן והעיצוב בפורמט HTML. אתה יכול לציין את הערך שלך עבור KnowledgeArticle. תכונה ArticlePublicNumber תוך כדי יצירת תיעוד של מאמר ידע; אחרת, הערך ייווצר באופן אוטומטי לפי הפורמט שציינת באזור ההגדרות של Dynamics 365 Customer Service בלקוח האינטרנט. את KnowledgeArticle. תכונה ArticlePublicNumber שמאחסנת את המזהה שמוצג ללקוחות, לשותפים ולמשתמשים חיצוניים אחרים להתייחסות ולחיפוש מאמרי ידע, ונשאר זהה בכל גרסאות מאמרי הידע והתרגומים.

הקוד הבא לדוגמה מראה כיצד ניתן ליצור רשומת מאמר ידע.

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);

צור גרסאות ראשיות ומשניות של מאמר ידע

כשאתה יוצר רשומת מאמר ידע, הגרסה העיקרית מוגדרת אוטומטית 1 והגרסה המשנית היא 0. השתמש בהודעה CreateKnowledgeArticleVersion (פעולה CreateKnowledgeArticleVersion או CreateKnowledgeArticleVersionRequest) כדי ליצור גרסה ראשית או משנית של מאמר ידע. בהודעת הבקשה, קבע את IsMajor שיהיה true כדי ליצור גרסה ראשית; או false כדי ליצור גרסה משנית. רשומת הגרסה החדשה שנוצרה משתמשת ב:

  • KnowledgeArticle. תכונה RootArticleId לשמירה על הקשר עם רשומת השורש של מאמר הידע.

  • KnowledgeArticle. תכונה PreviousArticleContentId כדי להצביע על הגרסה הקודמת של הרשומה.

הקוד הבא לדוגמה מראה כיצד ניתן ליצור גרסה ראשית של רשומת מאמר ידע באמצעות CreateKnowledgeArticleVersionRequest.

CreateKnowledgeArticleVersionRequest versionRequest = new CreateKnowledgeArticleVersionRequest  
{  
   Source = new EntityReference(KnowledgeArticle.EntityLogicalName, knowledgeArticleId),  
   IsMajor = true  
};  
CreateKnowledgeArticleVersionResponse versionResponse = (CreateKnowledgeArticleVersionResponse)_serviceProxy.Execute(versionRequest);

צור תרגום של מאמר ידע

השתמש בפעולה CreateKnowledgeArticleTranslation (ממשק API) או CreateKnowledgeArticleTranslationRequest (שירות ארגון) ליצירת תרגום לרשומת מאמר ידע. אתה יכול לתרגם את מאמר הידע ליותר מ- 150 שפות, ומידע על שפות נתמכות אלה זמין בישות LanguageLocale החדשה.

מידע נוסף: ישות LanguageLocale.

שימוש בפעולה CreateKnowledgeArticleTranslation (ממשק API) או CreateKnowledgeArticleTranslationRequest (שירות ארגון) יוצר רשומת מאמר ידע חדש עם הכותרת, התוכן, התיאור ומילות המפתח שהועתקו מרשומת המקור לרשומה החדשה ושפת הרשומה החדשה מוגדרת לזו שציינת בבקשה. עליך גם לציין אם הרשומה החדשה תהיה גרסה ראשית או משנית. הרשומה החדשה משתמשת ב- KnowledgeArticle. תכונה ParentArticleContentId לשמירה על הקשר עם הרשומה הראשית של מאמר הידע.

לאחר שתשלח הודעה זו ותקבל תגובה, אחזר את רשומת מאמר הידע מאובייקט התגובה ולאחר מכן עדכן את הכותרת, התוכן, התיאור ומילות המפתח כדי להוסיף את התוכן המתורגם.

הקוד הבא לדוגמה מראה כיצד ליצור תרגום לרשומת מאמר ידע באמצעות 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));

הערה

ערך ה- GUID של המפתח הראשי (LanguageLocaleId) עבור כל רשומת שפה בישות LanguageLocale זהה בכל ארגוני Dynamics 365 Customer Service.

מחזור החיים של מאמר הידע: שנה את מצב מאמר הידע

במהלך מחזור החיים שלו, מאמר ידע יכול להיות במצבים הבאים:

  • 0: טיוטה (לאחר יצירת מאמר ידע)

  • 1: אושר (לאחר אישור מאמר ידע)

  • 2: מתוזמן (לאחר שנקבע מועד לפרסום מאמר הידע)

  • 3: פורסם (לאחר פרסום מאמר ידע)

  • 4: פג תוקף (לאחר שפג התוקף של מאמר ידע, לפי תאריך התפוגה שצוין במהלך הפרסום)

  • 5: בארכיון (לאחר העברת מאמר ידע לארכיון)

  • 6: בוטל (לאחר ביטול מאמר ידע)

כדי לשנות את מצב המאמר, השתמש בהודעה Update ברשומת מאמר הידע כדי לעדכן את התכונה KnowledgeArticle.StateCode. עבור סוגי איגוד מוקדמים, השתמש בספירה KnowledgeArticleState לקביעת המצבים האפשריים. מידע נוסף: בצע פעולות ייעודיות באמצעות עדכון.

הקוד הבא לדוגמה מראה כיצד ניתן לפרסם רשומת מאמר ידע.

// 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);

שייך רשומת מאמר ידע למופע של ישות ב- Dynamics 365 Customer Service

כשאתה מאפשר חיפוש ידע משובץ של ישות ב- Dynamics 365 Customer Service באמצעות לקוח האינטרנט, מערכת יחסים רבים-לרבים, msdyn_<Enity_Name>_knowledgearticle, נוצרת אוטומטית. אתה יכול להשתמש בקשר הזה כדי לשייך או לקשר בין מופע KnowledgeArticle לבין מופע של ישות של Dynamics 365 Customer Service. כשאתה משייך מופע KnowledgeArticle עם מופע ישות, נוצרת רשומה של הקשר בישות מצטלבת שנקראת msdyn_<Enity_Name>_knowledgearticle. לדוגמה, כשאתה משייך מופע KnowledgeArticle עם מופע Account בפעם הראשונה, ישות מצטלבת בשם msdyn_account_knowledgearticle נוצרת, ורשומה עם מיפוי הקשר נוצרת בישות מצטלבת זו. כברירת מחדל, ישות Incident (אירוע) מופעלת לחיפוש הידע המוטמע, וכאשר אתה מקשר בין הרשומה KnowledgeArticle לרשומה Incident, נוצרת רשומת קשר בישות המצטלבת KnowledgeArticleIncident.

הקוד לדוגמה הבא מדגים כיצד לשייך מופע KnowledgeArticle עם מופע 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);

ספירה מצטברת של תצוגות מאמר ידע

השתמש בהודעה IncrementKnowledgeArticleViewCountRequest להגדלת ספירת הצפיות של רשומת מאמר הידע ביום נתון בישות KnowledgeArticleViews. אם רשומה לא קיימת במאמר ידע במשך יום מוגדר, היא תיצור רשומה ואז תגדיר את ערך ספירת התצוגה שצוינה ב- KnowledgeArticleViews. תכונה KnowledgeArticleView. אם כבר קיימת רשומה עבור מאמר ידע ביום שצוין, היא רק תגדיל את ספירת הצפיות ב- KnowledgeArticleViews. תכונה KnowledgeArticleView של הרשומה הקיימת.

חפש מאמרי ידע באמצעות חיפוש טקסט מלא

מאמרי ידע ב- Dynamics 365 Customer Service, כולל הגרסאות והתרגומים שלהם, הם באינדקס של טקסט מלא ותומכים בחיפוש טקסט מלא של SQL Server. למידע נוסף על חיפוש טקסט מלא, ראה SQL Server: חיפוש טקסט מלא.

השתמש בהודעה FullTextSearchKnowledgeArticleRequest לחיפוש מאמר ידע מהיישומים שלך ולמצוא את המידע שאתה מחפש. ההודעה FullTextSearchKnowledgeArticleRequest מאפשרת לך להשתמש בהתאמת שורשים מוטים (מאפשרת להחליף זמן דקדוקי או הטיה אחרת בטקסט החיפוש) ולציין קריטריוני שאילתה (באמצעות FetchXML או QueryExpression כדי לציין סינון, סדר, מיון והחלפה) כדי למצוא מאמרי ידע עם טקסט שצוין. אתה יכול גם לבחור להסיר גרסאות מרובות של אותם מאמרים בתוצאות החיפוש ולסנן את מצב מאמר הידע תוך חיפוש טקסט.

ישויות ידע שהוצאו משימוש

ישויות הדור הקודם הבאות הוצאו משימוש. למידע נוסף: ישויות ידע שיצאו משימוש

ישויות ידע מדור קודם אינן נגישות החל מ- 1 בדצמבר 2020. אנחנו ממליצים בחום לבצע להעביר את הישות KnowledgeArticle. למידע נוסף על יצירת מאמר ידע בממשק מאוחד, ראה צור ונהל מאמרי ידע.  

השתמש בהוראות הבאות לעזרה בהעברה‬:

  • השתמש ב- SDK‏, WebAPI או Microsoft Power Automate בהתאם לתרחישים שלך.
  • השתמש בכלי ההעברה של הקוד הפתוח עם רישיון MIT.

חשוב

  • כלי ההעברה של הקוד הפתוח אינו נתמך על ידי Microsoft וייתכן שיהיה צורך לשנות אותו כך שיתאים לתרחישים שלך.
  • הרץ תמיד סביבת בדיקה לפני השימוש בייצור.
  • בדוק את הרישיון ואת קובץ readme לפני השימוש בכלי.

למידע נוסף