Services

GetCatalog2

GetCatalog2
MAIN
  
Rückgabewert
GridStruct
RET
GridStruct
  
Parameterliste
index
IN
RegularStringWithSingleContent
  
attributes
IN
RegularStringWithMultiContent
  
searchExpression
IN
LongStringWithSearchContent
  
sortedBy
IN
LongStringWithOptionalMultiContent
  
resultAmount
IN
RegularNumericValue
  
visibility
IN
Boolean
  
filteredWith
IN
LongString
  
labelAttributes
IN
LongStringWithOptionalMultiOptionalContent
  
Kurzbeschreibung:
Dieser Service liefert von einem bestimmten Index für diejenigen Spalten, welche über den Parameter attributes definiert sind, deren Inhalte mit zugehöriger Häufigkeit. Dies gilt für alle Business-Objekte, welche der Search-Expression genügen. Die Treffer werden, sofern nicht anders angegeben ist, Attribut um Attribut absteigend nach Häufigkeit angezeigt.
Bemerkungen:
Gesucht wird nur in dem Mandanten, der via Kontext mitgegeben wird.
Ist resultAmount nicht angegeben, so werden fix maximal 1000 (DefaultResponseRows) Datensätze retourniert, ansonsten wird die Eingabe gegen 1'000'000 (Obergrenze des Parameter-Datentyps) validiert.
VD: <siehe Validator-Fehler>
(1): System.ServiceBus.GeneralServerError
(2): Search.IndexRepoActualizationFailed
(3): Search.FilteredWithSyntaxFailure
(4): Search.NoIndexRepoEntryForIndexName
(5): Search.NoActRdyIndexForIndexName
(6): Search.NoIndexDefHelperForIndexName
(7): Search.AttributeNotAvailable
(8): Search.AttributeNotSortable
(9): Search.AttributeNotFilterable
(10): Search.AttributeNotAccessible
(11): Search.InvalidSearchExpression
(12): Search.GetCatalog2Failed 

            
Erläuterungen:

            
(1) = Unerwarteter Fehler mit Beschreibung
(2) = IndexRepository-Aktualisierung fehlgeschlagen
(3) = Der Filter-Ausdruck ist ungültig
(4) = Kein IndexRepository-Eintrag für diesen Index
(5) = Kein verfügbarer Index mit diesem Namen
(6) = Der IndexDefinitionHelper ist nicht verfügbar
(7) = Das Attribut steht nicht zur Verfügung
(8) = Das Attribut ist kein Sortier-Attribut
(9) = Das Attribut ist kein Filter-Attribut
(10) = Das Attribut ist kein Rückgabe-Attribut
(11) = Ungültiger Suchausdruck
(12) = Fehler bei der eigentlichen Suche


            

               

                  

                     Notiz
                     
                        
Notiz

                        

                           
index:
Ein Index, der physikalisch zur Verfügung stehen muss.

                           
attributes:
Der Katalog wird über die Werte der Index-Spalten erstellt, welche beim Aufruf unter attributes angegeben werden.
Diese Index-Spalte muss bei der Index-Konfiguration als Rückgabe- und Sortier-Attribut definiert worden sein.
Spezialfall: Mit einem * kann ohne Angabe einer Index-Spalte, die maximale Anzahl Treffer ermittelt werden.
ValueSplit: Funktionalität welche vor der Gruppierung den Attribut-Wert aufsplittet und dann die Teile gruppiert.

                           
searchExpression:
In der searchExpression können Wildcards verwendet und einzelne Suchausdrücke mit AND (Default) und OR verknüpft werden.

                           
sortedby:
Bei sortedBy sind die beiden Sortierkriterien Value und Amount kombiniert zulässig. Die gültigen Sortierrichtungen sind asc, ascending (Default) wie auch desc, descending. Die String-Sortierung erfolgt nach en-US, CaseSensitive. 
Diese Sortierung wirkt innerhalb jedes Attributs.

                           
resultAmount: 
Dieser Parameter gibt an, wieviele Datensätze retourniert werden sollen.

                           
flteredWith:
Die Filterung kann auf allen Spalten erfolgen, welche vorgängig als filterbar definiert wurden. Gefiltert wird in aller Regel über eine Kombination von Ausdrücken der Art (Spalte Operator Wert). 
Die String-Filterung erfolgt normalerweise Case-Insensitiv. Case-Sensitiv gefiltert werden kann über spezielle Operatoren. 

                           
labelAttribute:
Die hier angegebene Index-Spalte muss bei der Index-Konfiguration als Rückgabe- und Sortier-Attribut definiert worden sein.
Wird ein labelAttribute angegeben, so wird (mit Ausnahme von * ) auch eine entsprechende Label-Spalte retourniert, wobei der Inhalt dieser Spalte ab dem ersten Vorkommnis des Attribute-Werts retourniert wird.

                           
resultAttributes:
Als Resultat werden stets die drei Spalten Attribute, Value und Amount retourniert. 
Spezialfall: Im Fall attribute * wird als Attribute ein *, als Value ein * und als Amount die Gesamt-Trefferzahl retourniert.