הגדרה של מילים נרדפות

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

כדי להגדיר מילים נרדפות, צריך ליצור אינדקס לפריטים באמצעות סכימת _dictionaryEntry well-known.

פריטים מהסוג _dictionaryEntry יכולים לכלול את המאפיינים הבאים:

כשמשתמש כולל ערך _term בשאילתה, השאילתה האפקטיבית הופכת ל-term OR synonyms. לדוגמה, אם מגדירים את "scifi" עם המילה הנרדפת "science fiction", שאילתה של "scifi" תתאים לפריטים שמכילים את אחד מהמונחים האלה.

כברירת מחדל, מילים נרדפות לא פועלות בשני הכיוונים. שאילתה של "science fiction" תתאים רק לביטוי המדויק הזה, אלא אם תגדירו אותה גם כמונח עם "scifi" כמילה נרדפת. כדי שיהיה אפשר להשתמש במונחים לסירוגין, צריך להגדיר כל אחד מהם בנפרד:

במהלך עיבוד השאילתה, המערכת מסירה את סימני הפיסוק והמקפים לפני שהיא מחילה מילים נרדפות. שאילתה לחיפוש "sci-fi" תואמת למונח "sci fi". כדי לתמוך במונחים עם מקפים, צריך לבצע נורמליזציה של _term כך שייעשה שימוש ברווחים במקום במקפים.

דוגמאות לשימוש חלופי:

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

הגדרת מילים נרדפות גלובליות באמצעות ה-SDK

אפשר להשתמש ב-SDK של מחבר התוכן כדי להגדיר מונחים ומילים נרדפות. פרטים נוספים זמינים במאמר בנושא יצירת מחבר תוכן.

קטע הקוד הזה יוצר RepositoryDoc מרשומה ב-CSV:

/**
 * Creates a document for indexing.
 *
 * For this connector sample, the created document is domain public
 *  searchable. The content is a simple text string.
 *
 * @param record The current CSV record to convert
 * @return the fully formed document ready for indexing
 */
private ApiOperation buildDocument(CSVRecord record) {
  // Extract term and synonyms from record
  String term = record.get(0);
  List<String> synonyms = StreamSupport.stream(record.spliterator(), false)
      .skip(1) // Skip term
      .collect(Collectors.toList());

  Multimap<String, Object> structuredData = ArrayListMultimap.create();
  structuredData.put("_term", term);
  structuredData.putAll("_synonym", synonyms);

  if (Configuration.getBoolean("dictionary.attachedToSearchApp", false).get()) {
    structuredData.put("_onlyApplicableForAttachedSearchApplications", true);
  }

  String itemName = String.format("dictionary/%s", term);

  // Using the SDK item builder class to create the item
  Item item =
      IndexingItemBuilder.fromConfiguration(itemName)
          .setItemType(IndexingItemBuilder.ItemType.CONTENT_ITEM)
          .setObjectType("_dictionaryEntry")
          .setValues(structuredData)
          .setAcl(DOMAIN_PUBLIC_ACL)
          .build();

  // Create the fully formed document
  return new RepositoryDoc.Builder()
      .setItem(item)
      .build();
}

שיקולים חשובים:

• הערכים של מילים נרדפות צריכים להיות ציבוריים בדומיין. לדוגמה, אפשר להגדיר את רשימת ה-ACL ל-DOMAIN_PUBLIC_ACL.
• אל תשתמשו בהגדרות בקובץ התצורה שמבטלות את ההגדרה הזו, כמו defaultAcl.mode=FALLBACK או defaultAcl.public=true.

הגדרת מילים נרדפות ספציפיות לאפליקציית החיפוש

כדי לספק מילים נרדפות ספציפיות לצוות (למשל, לצוות ההנדסה לעומת צוות המכירות), צריך להוסיף לכל מילה נרדפת אינדקס עם _onlyApplicableForAttachedSearchApplications=true. הפעולה הזו מגבילה את המילים הנרדפות לאפליקציות חיפוש שכוללות את מקור הנתונים הספציפי.

דוגמה:

structuredData.put("_onlyApplicableForAttachedSearchApplications", true);