Katalogsuche erweitern

Wenn Sie breitere Suchfunktionalitäten bereitstellen möchten, können Sie eine Katalogsuche erweitern, indem Sie die Informationen in der Indexdatei der Katalogsuche aktualisieren. Wenn Sie die Indexdatei aktualisieren möchten, ändern Sie die entsprechende erweiterte XML-Konfigurationsdatei.

1. Kopieren Sie die Datei install_dir /repository/xapi/template/merged/resource/extn/ExtnCatalogSearchConfigProperties. xml.sample in die Datei install_dir /extensions/global/template/resource/ExtnCatalogSearchConfigProperties.xml ODER ändern Sie Ihre vorhandene XML-Erweiterungsdatei.

   Im folgenden Beispiel wird eine ExtnCatalogSearchConfigProperties.xml-Beispielsdatei dargestellt.

   <SearchConfigurations>
     <SearchSystemConfigurations> 
       <MergeFactor Value="2"/> 
         <MaxMergeDocs Value="2147483647"/> 
      </SearchSystemConfigurations>
       <IndexSets> 
       <IndexSet Name="CatalogIndex"> 
         <Locales> 
          <Locale LocaleCode="en_US" 
           SynonymFile="/properties/EnglishSynonym.properties"/> 
           <Locale LocaleCode="fr_FR" 
             QueryParserClass="package.FrenchQueryParser.class"
             AnalyzerClass="package.FrenchAnalyzer.class" 
             SynonymFile="/properties/FrenchSynonym.properties"/> 
          </Locales> 
          <Entities> 
             <Entity Name="Item"> 
                <Attributes> 
                  <Attribute XMLName="MyExtendedDescription" 
                    DefaultWeight="1.0" Index="ANALYZED"
                    Store="Y" UseSynonyms="N" Searchable="Y" Sortable="N"/> 
                  <Attribute IndexFieldName="CustomerItemDescription"
                    DefaultWeight="1.0" Index="ANALYZED" Store="Y" UseSynonyms="N"
                    Searchable="Y" Sortable="N" GetExternalValue="Y"/>
               </Attributes> 
                <Entity Name="CategoryItem" RelationshipName="Category_ItemList"> 
                <Entity Name="Category" RelationshipName="Category"> 
               <Attributes> 
                 <Attribute XMLName="MyCategoryExtendedDescription" 
                   DefaultWeight="1.0" Index="ANALYZED" Store="Y" 
                   UseSynonyms="N" Searchable="Y" Sortable="N"/> 
               </Attributes> 
              </Entity> 
              </Entity> 
              <Entity Name="Asset" RelationshipName="AssetList"> 
               <Attributes> 
                 <Attribute Type="MyManual" DefaultWeight="1.0" Index="ANALYZED" 
                  Store="N" UseSynonyms="N" Searchable="Y" Sortable="N"/> 
                </Attributes> 
               </Entity> 
              </Entity> 
          </Entities> 
        </IndexSet> 
    </IndexSets> 
   </SearchConfigurations>

2. Wenn Sie Systemkonfigurationsdaten für die Indexdatei ändern möchten, ändern Sie die Elemente im Abschnitt "SearchSystemConfigurations" der Datei ExtnCatalogSearchConfigProperties.xml. In der folgenden Tabelle werden die Elemente von "SearchSystemConfiguration" in ExtnCatalogSearchConfigProperties.xml beschrieben.

   Element	Beschreibung
   MergeFactor Value	Gibt die Anzahl an Dokumenten an, die die Open-Source-Suchmaschine "Apache Lucene" im Speicher speichert, bevor diese als einzelne Segmente auf einen Datenträger geschrieben werden. Weitere Informationen zum Festlegen dieses Werts finden Sie auf der Lucene-Website.
   MaxMergeDocs Value	Gibt die Anzahl an Dokumenten an, die in einem Segment enthalten sein können. Weitere Informationen zum Festlegen dieses Werts finden Sie auf der Lucene-Website.

3. Wenn Sie Ländereinstellungsinformationen für die Indexdatei hinzufügen oder ändern möchten, fügen Sie die Elemente im Abschnitt "Locales" (Ländereinstellungen) der Datei ExtnCatalogSearchConfigProperties.xml hinzu oder ändern Sie diese. Im vorherigen Beispiel wird eine ExtnCatalogSearchConfigProperties.xml-Beispieldatei dargestellt, in der der Ländereinstellung "Englisch (US)" eine Synonymdatei und die Ländereinstellung "Französisch" hinzugefügt wurden. In der folgenden Tabelle werden die Elemente der Ländereinstellung in ExtnCatalogSearchConfigProperties.xml beschrieben.

   Element	Beschreibung
   LocaleCode	Gibt den Code für die Ländereinstellung für die Indexdatei an. Wenn Sie eine Ländereinstellung hinzufügen, stellen Sie sicher, dass Sie eine entsprechende Analysefunktion angeben. Die standardmäßige Ländereinstellung lautet "Englisch (US)".
   QueryParserClass	Gibt den Pfad zum Abfrageparser an. Die Anwendung stellt standardmäßig den Abfrageparser "Lucene" bereit.
   AnalyzerClass	Gibt den Pfad zur Analysefunktion an. Die Anwendung stellt die entsprechenden Analysefunktionen für die standardmäßige Ländereinstellung bereit.
   SynonymFile	Gibt den Pfad zur Synonymdatei für die entsprechende Ländereinstellung an. Konfigurieren Sie mithilfe der Synonymdatei die zugehörigen Begriffe für Schlüsselwortsuchen.

4. Wenn Sie Artikelinformationen für die Indexdatei hinzufügen möchten, fügen Sie die Attribute im Abschnitt "Item" (Artikel) der Datei ExtnCatalogSearchConfigProperties.xml hinzu. Im vorherigen Beispiel wird eine ExtnCatalogSearchConfigProperties.xml-Beispieldatei dargestellt, in der das Attribut "MyExtendedDescription" und das Attribut "CustomerItemDescription" hinzugefügt wurden. In der folgenden Tabelle werden die Elemente des Attributs "Item" (Artikel) in ExtnCatalogSearchConfigProperties.xml beschrieben.
   Hinweis: Sie können der erweiterten XML-Konfigurationsdatei für den Katalogsuchindex Attribute hinzufügen, aber weder Attribute noch Entitäten hinzufügen. Eine Liste mit standardmäßig unterstützten Attributen finden Sie in der Datei installationsverzeichnis/repository/xapi/template/merged/resource/CatalogSearchConfigProperties.xml.
5. Wenn Sie der Indexdatei zugehörige Kataloginformationen hinzufügen möchten, fügen Sie die Attribute im Abschnitt "Category" (Kategorie) der Datei ExtnCatalogSearchConfigProperties.xml hinzu. Im vorherigen Beispiel wird eine ExtnCatalogSearchConfigProperties.xml-Beispieldatei dargestellt, in der das Kategorieattribut "MyCategoryExtendedDescription" hinzugefügt wurde. In der folgenden Tabelle werden die Elemente des Attributs "Category" in ExtnCatalogSearchConfigProperties.xml beschrieben.
6. Wenn Sie Assetinformationen für die Indexdatei hinzufügen möchten, fügen Sie Attribute im Abschnitt "Asset" der Datei ExtnCatalogSearchConfigProperties.xml hinzu. Im vorherigen Beispiel wird eine ExtnCatalogSearchConfigProperties.xml-Beispieldatei dargestellt, in der das Asset mit dem Assettyp "MyManual" hinzugefügt wurde. In der folgenden Tabelle werden die Attribute für CatalogSearchConfigProperties.xml beschrieben.
   Hinweis : Die Anwendung ruft YCMParseAssetUE auf, um den Inhalt des Assets für den entsprechenden Asset-Typ zu analysieren.

   Attribut	Beschreibung
   XMLName	Bei Artikel- und Kategorieattributen der Entität "Item" (Artikel) gibt dieses Attribut den XML-Attributnamen für das Feld an.
   IndexFieldName	Gibt den Feldnamen des Attributs wie im Index gespeichert an. Die Werte für "IndexFieldName" müssen in der gesamten Konfigurationsdatei eindeutig sein. Wenn "IndexFieldName" in der XML-Konfigurationsdatei nicht konfiguriert ist, leitet das System einen Wert dafür auf der Grundlage der Formel Entity Name.XMLName ab.
   Typ	Bei Assetattributen gibt dieses Attribut den Assettyp in der Datenbank an.
   Standardgewichtung	Gibt die Gewichtung eines Begriffs an. Der Standardwert lautet '1'.
   Inhalt	Gibt eine der folgenden Optionen zum Speichern von Feldwerten an: Analyzed - speichert den Wert als durchsuchbares Segment. Wenn beispielsweise ein Benutzer nach "Desktop Computers" sucht und der Indexierungsparameter für das Feld analysiert wird, enthalten die Ergebnisse Artikel mit den Begriffen "Desktop Computer", "Desktop" und "Computer". Non_analyzed - speichert den Wert so, wie er in der Datenbank angezeigt wird, und erfordert für die Rückgabe des Wertes eine exakte Übereinstimmung. Wenn im vorherigen Beispiel die Suche nach "Desktop Computers" in einem Feld des Typs "non_analyzed" ausgeführt wurde, würde die Suche nur Artikel mit dem Begriff "Desktop Computer" zurückgeben.
   Geschäft	Gibt eine der folgenden Optionen zum Speichern von Feldwerten an: Y - speichert den Wert des Attributs im Index, sodass er als Suchausgabe zurückgegeben werden kann. Wenn das Attribut "GetExternalValue" auf "Y" festgelegt ist, wird "Store" als "Y" behandelt. N - speichert den Wert nicht und behält nur Daten im Index für das Attribut bei, die einem proprietären Format entsprechen und nur bei der Suche verwendet werden.
   UseSynonyms	Gibt eine der folgenden Optionen zum Einschließen von Synonymem in der Suche an: Y - gibt an, dass Suchabfragen Synonyme einschließen. N - gibt an, dass Suchabfragen keine Synonyme einschließen.
   Durchsuchbar	Gibt eine der folgenden Suchoptionen für das Feld an: Y - gibt an, dass das Feld als mögliches Suchkriterium eingeschlossen wird, wenn eine Suchabfrage erstellt wird. N - gibt an, dass das Feld nicht als mögliches Suchkriterium eingeschlossen wird, wenn eine Suchabfrage erstellt wird. Beispielsweise wird der Parameter 'Searchable' für das Feld 'Is_Superseded' in der Standard-XML-Datei auf 'N' und der Parameter' Store 'auf' Y ' gesetzt. Benutzer können nicht nach dem Feld 'Is_Superseded' in einer Abfrage suchen. Jedoch werden bei Abfragen von ersetzten Artikeln, die veraltet sind, die ersetzten Artikel zurückgegeben.
   Sortierbar	Gibt eine der folgenden Sortieroption für das Feld an: Y - gibt an, dass Suchergebnisse nach diesem Feld sortiert werden. N - gibt an, dass Suchergebnisse nicht nach diesem Artikel sortiert werden.
   GetExternalValue	Gibt eine der folgenden Optionen für das Feld an: Y - gibt an, dass der Wert für dieses Attribut über einen Benutzerexit von einer externen Quelle abgerufen wird. N - gibt an, dass der Benutzerexit nicht aufgerufen wird.