Show Menu
THEMEN×

CGI-Parameter

CGI-Parameter

CGI-Parameter suchen

Es wird Suchformularcode bereitgestellt, den Sie kopieren und in den HTML-Code Ihrer Site einfügen können ( Design > Auto-Complete > Form Source ).
Sie können auch die Parameter festlegen, die entweder im Suchformular selbst oder über ein Skript aufgeführt werden. Zusätzlich zu den unten aufgeführten Parametern können Sie auch die Backend-Suchparameter verwenden, um die Suche zu steuern.
Siehe CGI-Parameter für die Backend-Suche .
Suchanforderungen bestehen aus einer Basis-URL. Die Basis-URL gibt an, nach welchem Konto der Kunde sucht, und eine Reihe von CGI-Parametern (Schlüssel-Wert-Paare), die angeben, wie die gewünschten Suchergebnisse für das zugehörige Konto zurückgegeben werden.
Die Basis-URL ist mit einem bestimmten Konto und einer gestaffelten oder Live-Umgebung verknüpft. Sie können mehrere Aliase für die Basis-URL von Ihrem Kundenbetreuer anfordern. Beispielsweise kann ein Unternehmen mit dem Namen Megacorp zwei Basis-URLs mit seinem Konto verknüpft haben: https://search.megacorp.com und https://stage.megacorp.com . Die erste URL durchsucht ihren Liveindex und die zweite URL sucht ihren gestaffelten Index.
Es werden drei Formate von CGI-Parametern unterstützt. Standardmäßig ist Ihr Konto so konfiguriert, dass CGI-Parameter wie im folgenden Beispiel mit einem Semikolon getrennt werden:
https://search.megacorp.com?q=shoes;page=2
Wenn Sie es vorziehen, können Sie Ihren Kundenbetreuer dazu veranlassen, Ihr Konto so zu konfigurieren, dass zur Trennung der CGI-Parameter ein kaufmännisches kaufmännisches kaufmännisches Und verwendet wird, wie im folgenden Beispiel:
https://search.megacorp.com?q=shoes&page=2
Ein drittes Format, das so genannte SEO-Format, wird ebenfalls unterstützt, wenn anstelle des Trennzeichens und Gleichheitszeichens ein Schrägstrich verwendet / wird, wie im folgenden Beispiel dargestellt:
https://search.megacorp.com/q/shoes/page/2
Jedes Mal, wenn das SEO-Format zum Senden einer Anforderung verwendet wird, werden alle Ausgabelinks im gleichen Format zurückgegeben.
Parameter für die geführte Suche
Beispiel
Beschreibung
q
q=string
Gibt die Abfragezeichenfolge für die Suche an. Dieser Parameter wird dem sp_q Backend-Suchparameter zugeordnet. Siehe CGI-Parameter für die Backend-Suche .
q#
q#=string
Facting (Suche innerhalb eines bestimmten Felds) erfolgt über nummerierte q- und x-Parameter. Der Parameter q definiert den Begriff, nach dem Sie in der Facette suchen, wie er durch den entsprechenden Parameter "x"gekennzeichnet ist.
Wenn Sie z. B. zwei Facetten haben, die Größe und Farbe heißen, können Sie z. B. q1=small;x1=size;q2=red;x2=color haben. Dieser Parameter wird den sp_q_exact_# Backend-Suchparametern zugeordnet.
Siehe CGI-Parameter für die Backend-Suche .
x nicht unterstützt#
q#=string
Facting (Suche innerhalb eines bestimmten Felds) erfolgt über nummerierte q- und x-Parameter. Der Parameter q definiert den Begriff, nach dem Sie in der Facette suchen, wie er durch den entsprechenden Parameter "x"gekennzeichnet ist.
Wenn Sie z. B. zwei Facetten haben, die Größe und Farbe heißen, können Sie z. B. q1=small;x1=size;q2=red;x2=color haben. Dieser Parameter wird den sp_x_# Backend-Suchparametern zugeordnet.
Siehe CGI-Parameter für die Backend-Suche .
Erfassung
collection=string
Gibt die für die Suche zu verwendende Sammlung an. Dieser Parameter wird dem sp_k Backend-Suchparameter zugeordnet. Siehe CGI-Parameter für die Backend-Suche .
count
count=number
Gibt die Gesamtanzahl der angezeigten Ergebnisse an. Die Standardeinstellung ist unter Settings > Searching > Searches. . Dieser Parameter wird dem sp_c Backend-Suchparameter zugeordnet. Siehe CGI-Parameter für die Backend-Suche .
Seite
page=number
Gibt die Seite der zurückgegebenen Ergebnisse an.
rank
rank=field
Gibt das Rankenfeld an, das für das statische Rang verwendet werden soll. Das Feld muss ein Feld vom Typ Rang mit einer Relevanz größer als 0 sein. Dieser Parameter wird dem sp_sr Backend-Parameter zugeordnet. Siehe CGI-Parameter für die Backend-Suche .
sortieren
sort=number
Gibt die Sortierreihenfolge an.
"0"ist der Standardwert und wird nach Relevanzwert sortiert; "1" sortiert nach Datum; "-1"wird nicht sortiert. Benutzer können einen Feldnamen für den Wert des sp_s Parameters angeben. So werden die Ergebnisse sp_s=title nach den Werten sortiert, die im Titelfeld enthalten sind. Wenn ein Feldname für den Wert eines sp_s Parameters verwendet wird, werden die Ergebnisse nach diesem Feld sortiert und dann nach Relevanz untergeordnet. To enable this feature, click Settings > Metadata > Definitions. Klicken Sie auf der Seite "Definitionen"auf Add New Field oder klicken Sie auf Edit , um einen bestimmten Feldnamen anzuzeigen. Wählen Sie in der Sorting Dropdownliste entweder Ascending oder Descending. Dieser Parameter wird dem sp_s Backend-Suchparameter zugeordnet.
Siehe CGI-Parameter für die #.(../c-appendices/c-cgiparameters.md#reference_582E85C3886740C98FE88CA9DF7918E8).

CGI-Parameter für die Backend-Suche

In der Regel interagieren Kunden mit einer Präsentationsebene namens "Geführte Suche". Theoretisch ist es jedoch möglich, die Ebene der geführten Suche zu überspringen und mit der Backend-Core-Suche direkt mit den auf dieser Seite beschriebenen CGI-Parametern zu interagieren.
Sie können CGI-Parameter für die Backend-Suche in der folgenden Tabelle auswählen:
Einzelabfrageunterstützung
Unterstützung mehrerer Abfragen
Beispiele
Beschreibung
1
sp_a
sp_a= string
Gibt die Kontonummer-Zeichenfolge an. Dieser Parameter ist erforderlich und muss eine gültige Kontonummer-Zeichenfolge sein. Sie finden Ihre Kontonummer unter Einstellungen > Kontooptionen > Kontoeinstellungen .
2
sp_advanced
sp_advanced= 0 oder 1
Wenn sp_advanced=1 mit einer Abfrage gesendet wird, wird der gesamte Code zwischen dem <search-if-advanced>- -Tag und dem </search-if-advanced>- -Tag in der Suchvorlage für das Suchformular verwendet. Der gesamte Code zwischen dem Tag <search-if-not-advanced> und dem Tag </search-if-not-advanced> wird ignoriert. Wenn sp_advanced=0 (oder ein anderer Wert) gesendet wird, wird der Vorlagenblock <search-if-advanced> ignoriert und der Vorlagenblock <search-if-not-advanced> verwendet.
3
sp_c
sp_c= number
Gibt die Gesamtanzahl der anzuzeigenden Ergebnisse an. Die Standardeinstellung ist „10“.
4
sp_context_field
sp_context_field= field
Erfasst Kontextinformationen für das angegebene Feld. Die gesammelten Informationen werden in den Suchergebnissen über das Vorlagen-Tag <search-context> ausgegeben. Die Standardeinstellung ist body .
5
sp_d
sp_d= type
Gibt den Typ der zu durchsuchenden Datumsbereiche an. Mögliche Werte für den Typ sind vorhanden, d. h. keine Suche nach Datumsbereichen, benutzerspezifisch, was bedeutet, dass der Wert von sp_date_range verwendet werden sollte, um die zu suchenden Daten zu bestimmen, und spezifisch, was bedeutet, dass die Werte in sp_start_day, sp_start_month , sp_start_year , sp_end_day , □ und zur Bestimmung des zu durchsuchenden Datumsbereichs. sp_d ist nur erforderlich, wenn Ihr Suchformular die Option enthält, entweder nach einem benutzerdefinierten Bereich (über sp_date_range ) oder nach einem bestimmten Start- und Enddatumsbereich zu suchen.
6
sp_d_#
sp_d_#= type
Gibt den Typ der Datumsbereichssuche für die entsprechende sp_q_#- Abfrage an. Das "#"wird durch eine Zahl zwischen 1 und 16 ersetzt (z. B. sp_d_8 , gilt für die nummerierte Abfrage sp_q_8 ).
Sie können type auf any einstellen, d. h. nicht nach Datumsbereichen suchen, benutzerspezifisch. Dies bedeutet, dass der Wert von sp_date_range_# verwendet wird, um die zu suchenden Daten zu bestimmen, und spezifisch, was bedeutet, dass die Werte in sp_q_min_day_#, sp_q_min_month_# , sp_q_year_#, s_q_max_day__q_max_month_# und sp_q_year_# sollten zur Bestimmung des Datumsbereichs verwendet werden. Die Verwendung von sp_d_# ist nur erforderlich, wenn Ihr Suchformular die Option enthält, entweder nach einem benutzerdefinierten Bereich (über sp_date_range_#) oder nach einem bestimmten Start- und Enddatumsbereich zu suchen.
7
sp_date_range
sp_date_range= number
Gibt einen vordefinierten Datumsbereich an, der auf die Suche angewendet werden soll. Werte größer gleich null geben die Anzahl der Tage an, die vor dem heutigen Tag gesucht werden sollen — — Beispielsweise gibt der Wert "0"den Wert "today"an, der Wert "1"den Wert "today"und "gestern", der Wert "30"den Wert "within the last 30 days"usw.
Werte unter null geben einen benutzerdefinierten Bereich wie folgt an:
-1 = "Keine", genau wie bei Angabe eines Datumsbereichs.
-2 = "Diese Woche", die von Sonntag bis Samstag der aktuellen Woche durchsucht.
-3 = "Letzte Woche", die von Sonntag bis Samstag der Woche vor der aktuellen Woche durchsucht wird.
-4 = "Dieser Monat", der Daten innerhalb des aktuellen Monats durchsucht.
-5 = "Letzter Monat", der Daten innerhalb des Monats vor dem aktuellen Monat durchsucht.
-6 = "Dieses Jahr", das Daten innerhalb des aktuellen Jahres durchsucht.
-7 = "Letztes Jahr", das Daten innerhalb des Jahres vor dem aktuellen Jahr durchsucht.
8
sp_date_range_#
sp_date_range_#= number
Gibt einen vordefinierten Datumsbereich an, der auf die entsprechende sp_q_#- Abfrage angewendet werden soll. Das "#"wird durch eine Zahl zwischen 1 und 16 ersetzt (z. B. sp_date_range_8 , gilt für die nummerierte Abfrage sp_q_8 ).
Werte größer als oder gleich null geben die Anzahl der Tage an, die vor dem heutigen Tag gesucht werden sollen. Beispielsweise gibt der Wert 0 heute an; Der Wert 1 gibt heute und gestern an. Der Wert 30 gibt innerhalb der letzten 30 Tage usw. an.
Werte unter null geben einen benutzerdefinierten Bereich wie folgt an:
-1 = "Keine", genau wie bei Angabe eines Datumsbereichs.
-2 = "Diese Woche", die von Sonntag bis Samstag der aktuellen Woche durchsucht.
-3 = "Letzte Woche", die von Sonntag bis Samstag der Woche vor der aktuellen Woche durchsucht wird.
-4 = "Dieser Monat", der Daten innerhalb des aktuellen Monats durchsucht.
-5 = "Letzter Monat", der Daten innerhalb des Monats vor dem aktuellen Monat durchsucht.
-6 = "Dieses Jahr", das Daten innerhalb des aktuellen Jahres durchsucht.
-7 = "Letztes Jahr", das Daten innerhalb des Jahres vor dem aktuellen Jahr durchsucht.
9
sp_dedupe_field
sp_dedupe_field= fieldname
Gibt ein einzelnes Feld an, in dem die Suchergebnisse dedupliziert werden sollen. Alle doppelten Ergebnisse in diesem Feld werden aus den Suchergebnissen entfernt. Beispiel: Wenn für sp_dedupe_field=title nur das oberste Ergebnis für einen bestimmten Titel in den Suchergebnissen angezeigt wird (keine zwei Ergebnisse haben identischen Titelfeldinhalt). Bei Feldern mit mehreren Werten (Listen zulassen) wird der gesamte Feldinhalt zum Vergleich verwendet. Es kann nur ein Feld angegeben werden. Ein "table-qualifier"ist im Feldnamen nicht zulässig.
10
sp_e
sp_e= number
Gibt an, dass für jedes Wort aus der Abfragezeichenfolge eine automatische Platzhaltererweiterung mit mehr als Zeichen durchgeführt werden soll. Mit anderen Worten, sp_e=5 legt fest, dass Wörter mit 5 oder mehr Zeichen, wie "query"oder "number", mit dem Platzhalterzeichen '*' erweitert werden sollten, sodass die Suche einer Suche nach "query*" oder "number*" entspricht. Wörter mit weniger Zeichen werden nicht erweitert, sodass eine Suche nach "Wort"keine automatische Platzhaltererweiterung hätte.
11
sp_e_#
sp_e_#= number
Gibt an, dass für jedes Wort aus der entsprechenden Abfragezeichenfolge sp_q_# eine automatische Platzhaltererweiterung mit mehr als Zeichen durchgeführt wird. Mit anderen Worten, sp_e_2=5 gibt an, dass Wörter mit fünf oder mehr Zeichen in der Abfragezeichenfolge sp_q_2, wie "query"oder "number", mit dem Platzhalterzeichen ' * ' erweitert werden sollten, sodass die Suche einer Suche nach "query*" oder "number*" entspricht. Wörter mit weniger Zeichen werden nicht erweitert, sodass eine Suche nach "Wort"in sp_q_2 keine automatische Platzhaltererweiterung hätte.
12
sp_end_day, sp_end_month, sp_end_year
sp_end_day= number ,sp_end_month= number , sp_end_year= number
Dieses Wertetriplet gibt den Enddatumsbereich für die Suche an und muss als Satz angegeben werden.
13
sp_f
sp_f= string
Gibt den Zeichensatz der Abfrageparameter-Zeichenfolgen an (z. B. sp_q ). Diese Zeichenfolge muss immer mit dem Zeichensatz der Seite übereinstimmen, die das Suchformular enthält.
14
sp_field_table
sp_field_ table=table: field,field...
Definiert eine logische Datentabelle, die aus den angegebenen Feldern besteht. Beispielsweise würde eine Tabelle mit dem Namen "items"aus den Feldern "color", "size"und "price"wie folgt definiert:
sp_field_table=items:color,size,price
Logische Tabellen sind besonders nützlich in Verbindung mit Feldern, in denen "Listen zulassen"aktiviert ist (unter Einstellungen > Metadaten > Definitionen ). Alle CGI-Parameter und Vorlagen-Tags, die einen Feldnamen als Wert annehmen, können optional einen Tabellennamen gefolgt von einem ""angeben. vor dem Feldnamen (z. B. sp_x_1=tablename.fieldname ).
Wenn Sie beispielsweise nach Dokumenten suchen möchten, die ein oder mehrere rote Elemente in der Größe "groß"enthalten (wobei Elemente als parallele Zeilen mit Metadaten dargestellt werden), können Sie Folgendes verwenden:
sp_q_exact_1=red&sp_x_1=items.color& sp_q_exact_2=large&sp_x_2=items.size&sp_field_table=items:color,size,price
15
sp_i
sp_i= Wert
Ignoriert die Suche, wenn Sie Berichte erstellen.
Verwenden Sie diese Abfrage, um bestimmte Backend-Suchvorgänge zu maskieren, z. B. Suchvorgänge, die Sie generiert haben, oder Suchvorgänge, die ein Administrator im Mitgliedercenter generiert. Da ein Endbenutzer diese Sucharten nicht generiert, werden sie nicht in verschiedenen Adobe Search&Promote-Berichten angezeigt.
Gültige Werte sind sp_i=1 und sp_i=2 .
16
sp_k
sp_k= string
Gibt die für die Suche zu verwendende Sammlung an. Die Standardeinstellung ist keine Sammlung, d. h. die Suche sollte die gesamte Site enthalten.
17
sp_l
sp_l= string
Gibt die Sprache der Abfrageparameter-Zeichenfolgen an (z. B. sp_q ). Die Zeichenfolge sollte eine Standard-Gebietsschema-ID sein, die einen ISO-639-Sprachcode und optional einen ISO-3166-Ländercode enthält. Beispiel: "en"oder "en_US"für Englisch oder "ja"oder "ja_JP"für Japanisch.
18
sp_literal
sp_literal= 0 oder 1
Wenn Sie sp_literal=1 festlegen, werden vorübergehend alle Funktionen deaktiviert, die die Wörter in der Abfrage interpretieren könnten. Mit diesem Parameter stimmen nur die wörtlichen Wörter der Abfrage mit den Dokumenten überein, unabhängig von Synonymen, alternativen Wortformen und Klangübereinstimmung.
Beachten Sie, dass sp_literal=0 keine Bedeutung hat und bei Verwendung ignoriert wird.
19
sp_m
sp_m= number
Gibt an, ob Zusammenfassungen angezeigt werden. 1 ist ja, 0 ist nein. Die Standardeinstellung ist „1“.
20
sp_n
sp_n= number
Gibt die Nummer des Ergebnisses an, mit dem die Suchergebnisse gestartet werden. Die Standardeinstellung ist „1“.
21
sp_not_found_page
sp_not_found_page= url
Gibt an, ob eine Umleitung zur angegebenen URL erfolgen soll, wenn keine Suchergebnisse vorliegen.
22
sp_p
sp_p= any/all/phrase
Gibt den Standardtyp der durchzuführenden Suche an. Die Verwendung beliebiger Mittel zur Suche nach Dokumenten, die ein beliebiges Wort aus der Abfragezeichenfolge enthalten. Die Verwendung von all bedeutet, nach Dokumenten zu suchen, die alle Wörter in der Abfragezeichenfolge enthalten. Die Verwendung einer Wortgruppe bedeutet, dass die Abfragezeichenfolge so behandelt wird, als wäre sie eine mit Anführungszeichen versehene Wortgruppe, und alle vom Benutzer eingegebenen Anführungszeichen werden ignoriert.
Bei Wortgruppen und allen wird die Angabe von "+"und "-"vor Suchbegriffen deaktiviert und diese Zeichen werden ignoriert. Wenn sp_p nicht vorhanden ist oder auf eine leere Zeichenfolge oder eine beliebige andere festgelegt ist, sind die standardmäßigen Wörterprefixe "+"und "-"zulässig.
Weitere Informationen zur Verwendung von Plus ("+") und Minus ("-") bei Suchvorgängen finden Sie in der Beschreibung der Suchtipps.
Beispiele zur Verwendung des Parameters sp_p finden Sie im Beispiel für die erweiterte Suche .
23
sp_p_#
sp_p_#= any/all/Satz
Gibt den Standardtyp der Suche an, die mit der entsprechenden sp_q_#- Abfrage durchgeführt werden soll. Das "#"wird durch eine Zahl zwischen 1 und 16 ersetzt (z. B. gilt sp_p_8 für die nummerierte Abfrage sp_q_8 ). Die Verwendung beliebiger Mittel gibt Dokumente zurück, die ein beliebiges Wort aus der Abfragezeichenfolge enthalten. Die Verwendung von allen Mitteln gibt Dokumente zurück, die alle Wörter in der Abfragezeichenfolge enthalten. Die Verwendung einer Wortgruppe bedeutet, dass die Abfragezeichenfolge so behandelt wird, als wäre sie eine vollständige Wortgruppe (und alle vom Benutzer eingegebenen Anführungszeichen werden ignoriert).
Wenn Sie entweder alle oder Wortgruppe angeben, werden alle Plus- und Minuszeichen vor den Suchbegriffen ignoriert . Wenn sp_p_# ausgelassen wird oder wenn sie auf eine leere Zeichenfolge oder eine beliebige andere festgelegt ist, sind die standardmäßigen Präfixe "+"und "-"zulässig. (s)
24
sp_pt
sp_pt= exact/equivalent/compatible
Gibt den Typ der anzuwendenden Zielübereinstimmung an. Die Verwendung von exakt bedeutet, dass die Ertragszielübereinstimmung nur in Dokumenten erfolgt, die exakt mit der Abfragezeichenfolge im Zielinhalt übereinstimmen. Die Verwendung von Entsprechungen ist genau, außer dass die Reihenfolge der Wörter nicht wichtig ist. Durch die Verwendung von kompatiblen Parametern wird automatisch der Zielübereinstimmungstyp basierend auf dem Wert des sp_p- Parameters festgelegt. Die Verwendung der exakten wird verwendet, wenn sp_p vollständig oder Satz ist , ansonsten äquivalent . Der Standardwert von sp_pt ist kompatibel .
25
sp_pt_#
sp_pt_#= exact/equivalent/compatible
Gibt den Typ der Zielübereinstimmung an, die mit der entsprechenden sp_q_#- Abfrage angewendet werden soll. Das "#"wird durch eine Zahl zwischen 1 und 16 ersetzt (z. B. gilt sp_p_8 für die nummerierte Abfrage sp_q_8 ). Die Verwendung von exakt bedeutet, dass die Ertragszielübereinstimmung nur in Dokumenten erfolgt, die exakt mit der Abfragezeichenfolge im Zielinhalt übereinstimmen. Die Verwendung von Entsprechungen ist wie exakt , außer dass die Reihenfolge der Wörter nicht wichtig ist. Durch die Verwendung kompatibler Elemente wird der Zielübereinstimmungstyp automatisch auf Grundlage des Werts des entsprechenden sp_p_#- Parameters festgelegt: Wenn sp_p_# vollständig oder Wortgruppe ist, wird "genau" verwendet, andernfalls wird äquivalent verwendet. Der Standardwert von sp_pt_# ist kompatibel .
26
sp_q
sp_q= string
Gibt die Abfragezeichenfolge für die Suche an. Eine leere Zeichenfolge führt dazu, dass keine Ergebnisse angezeigt werden.
27
sp_q_#
sp_q_#= text
Dieser Parameter ermöglicht die Erstellung mehrerer Abfragen in Suchformularen. Der Parameter sp_q_# enthält die Abfragezeichenfolge, die in der angegebenen nummerierten Abfrage verwendet werden soll. Eine Suchanfrage kann auf bis zu 16 verschiedene nummerierte Abfragen verweisen ( sp_q_1 zu sp_q_16 ).
Wenn Sie beispielsweise das folgende Formular senden, werden alle Dokumente zurückgegeben, die die Wörter "hervorragend"und "Bücher"enthalten.
Search for: <input type="text" name="sp_q" value="great"> Search for: <input type="text" name="sp_q_1" value="books">
28
sp_q_day, sp_q_month, sp_q_year
sp_q_day_#, sp_q_month_#, sp_q_year_#
sp_q_day= integer-Wert
sp_q_month= integer-Wert
sp_q_year= integer value
sp_q_day_#= integer-Wert
sp_q_month_#= integer-Wert
sp_q_year_#= integer-Wert
Mit diesen Parametern wird ein exaktes Datum für eine bestimmte Abfrage angegeben. Die Parameter sp_q_day , sp_q_month und sp_q_year gelten für die Hauptabfrage ( sp_q ).
Der Parameter # wird durch eine Zahl zwischen 1 und 16 ersetzt (z. B. sp_q_day_6 , was für die nummerierte Abfrage sp_q_6 gilt ). Standardmäßig werden alle Datumsangaben relativ zur Greenwich Mean Time durchsucht.
Im folgenden Codeabschnitt können Benutzer in Dokumenten vom Typ "Jan."nach dem Wort "orange"suchen. 1. 2000" in einem benutzerdefinierten Feld mit dem Namen PublishDate :
<input type="hidden" name="sp_x_1" value="PublishDate"> Search for: <input type="text" name="sp_q" value="orange">On : <input type="text" name="sp_q_day_1" size="2" value="1"> Day<input type="text" name="sp_q_month_1" size="2" value="1"> Month <input type="text" name="sp_q_year_1" size="4" value="2000"> Year 
29
sp_q_location
sp_q_location_#
sp_q_location= latitude/longitude OR areacode OR zipcode
sp_q_location_#= latitude/longitude OR areacode OR zipcode
Diese Parameter verbinden einen Ort mit der Haupt- oder nummerierten Abfrage. Die Verwendung von sp_q_location wirkt sich auf die Hauptabfrage sp_q_location_# aus (wobei die # durch eine Zahl von 1 bis 16 ersetzt wird), wirkt sich auf die angegebene nummerierte Abfrage aus. Diese Parameter werden verwendet, um eine minimale und/oder maximale Entfernungsabstandssuche mit den Ortsdaten durchzuführen, die für jede Siteseite indiziert sind. Das Format des Werts bestimmt seine Interpretation.
Ein Wert in der Form DDD (dreistellige Zahl) wird als ein US-Telefonbereich interpretiert. ein Wert in der Form DDDD oder DDDD-DDDD wird als US-Postleitzahl interpretiert; und ein Wert im Format ±DD.DDDD±DDD.DDDD wird als Breiten-/Längengrad-Paar interpretiert. Die Zeichen sind für jeden Wert erforderlich. Beispielsweise gibt +38.6317+120.5509 den Breitengrad 38.6317, den Längengrad 120.5509 an.
30
sp_q_max_relevant_away
sp_q_max_relevant_away _#
sp_q_max_relevant_distance= value
sp_q_max_relevant_distance_#= value
Diese Parameter steuern die Relevanzberechnung, die bei der Suche in der Nähe angewendet wird. Die Verwendung von sp_q_max_relevant_distanziert sich auf die Hauptabfrage sp_q_max_relevant_distanz_# (wobei die # durch eine Zahl zwischen 1 und 16 ersetzt wird), wirkt sich auf die angegebene nummerierte Abfrage aus.
Der Standardwert von sp_q_max_relevant_away ist 100.
Ein perfekter Relevanzwert für die Komponente "Nähe"würde eine Entfernung von 0 darstellen. Ein minimaler Relevanzwert für die Annäherungskomponente würde einen Abstand direkt über dem angegebenen sp_q_max_relevant_distanzwert darstellen .
31
sp_q_min_day, sp_q_min_month, sp_q_min_year
sp_q_max_day, sp_q_max_month, sp_q_max_year
sp_q_min_day_#, sp_q_min_month_#, sp_q_min_year_#
sp_q_max_day_#, sp_q_max_month_#, sp_q_max_year_#
sp_q_min_day= integer value
sp_q_min_month= integer value
sp_q_min_year= integer value
sp_q_max_day= integer value
sp_q_max_month= integer value
sp_q_max_year= integer value
sp_q_min_day_#= integer value
sp_q_min_month_#= integer value
sp_q_min_year_#= integer value
sp_q_max_day_#= integer value
sp_q_max_month_#= integer value
sp_q_max_year_#= integer value
Mit diesen Parametern werden Mindest- und Höchstdatumsbereiche für eine bestimmte Abfrage festgelegt. Die Parameter sp_q_min_day , sp_q_min_month , _q_min_year, sp_q_max_day , sp_q_max_month undsp_q_max_year gelten für die Hauptabfrage ( sp_q).
Das # im Parameternamen wird durch eine Zahl zwischen 1 und 16 ersetzt (z. B. sp_q_min_day_6 gilt für die nummerierte Abfrage sp_q_6 ).
Es ist zulässig, nur ein Mindestdatum, nur ein Höchstdatum oder sowohl ein Mindest- als auch ein Höchstdatum anzugeben. Für einen bestimmten Mindest- oder Höchstsatz müssen jedoch alle drei Datumsparameter angegeben werden (Tag, Monat und Jahr). Standardmäßig werden alle Datumsangaben relativ zur Greenwich Mean Time durchsucht.
Im folgenden Codeabschnitt kann ein Benutzer in Dokumenten mit einem Datum zwischen dem 1. Januar 2000 und dem 31. Dezember 2000 in einem benutzerdefinierten Feld mit dem Namen Veröffentlichungsdatum nach dem Wort "orange"suchen :
<input type="hidden" name="sp_x_1" value="PublishDate">Search for: <input type="text" name="sp_q" value="orange">Between: <input type="text" name="sp_q_min_day_1" size="2" value="1"> Start Day<input type="text" name="sp_q_min_month_1" size="2" value="1"> Start Month <input type="text" name="sp_q_min_year_1" size="4" value="2000"> Start Year And: <input type="text" name="sp_q_max_day_1" size="2" value="31"> End Day <input type="text" name="sp_q_max_month_1" size="2" value="12"> End Month <input type="text" name="sp_q_max_year_1" size="4" value="2000"> End Year
32
sp_q_min, sp_q_max
sp_q_min_#, sp_q_max_#, sp_q_exact_#
sp_q_min= Wert
sp_q_max= Wert
sp_q_min_#= value
sp_q_max_#= value
sp_q_exact_#=value
Diese Parameter geben einen minimalen (und/oder maximalen) Wert an, der auf die Haupt- oder nummerierte Abfrage angewendet werden soll. Die Verwendung von sp_q_min , sp_q_max und sp_q_exact wirkt sich auf die Hauptabfrage ( sp_q ) aus.
Ersetzen Sie # im Parameternamen durch eine Zahl zwischen 1 und 16 (z. B. gilt sp_q_min_8 für die nummerierte Abfrage sp_q_8 ).
Die Verwendung von sp_q_exact_# ist kurz für die Angabe von sp_q_min_# und sp_q_max_# mit demselben Wert. Wenn sp_q_exact_# angegeben ist, werden alle entsprechenden sp_q_min_#- oder sp_q_max_#- Parameter ignoriert.
Die Parameter sp_q_min_# , sp_q_max_# und sp_q_exact_# können optional mehrere "|"-getrennte Werte angeben. So suchen Sie beispielsweise nach Dokumenten mit dem Wert grün oder rot im Feld "Farbe": ...&sp_q_exact_1=green|red&sp_x_1=color .
33
sp_q_nocp
sp_q_nocp _#
sp_q_nocp= 1 oder 0
sp_q_nocp_#= 1 oder 0
Der Standardwert für den Parameter ist 0, d. h., dass Erweiterungen der allgemeinen Wortgruppe durchgeführt werden.
Bei Festlegung auf 1 für die entsprechende Suchabfrage werden keine Erweiterungen für "Allgemeine Wortgruppen"durchgeführt.
Die Verwendung von sp_q_nocp wirkt sich auf den Hauptsuchabfrageparameter sp_q aus . Um diesen Parameter auf eine nummerierte Suchabfrage anzuwenden, ersetzen Sie # im Parameternamen durch die entsprechende Zahl. Beispiel: sp_q_nocp_8 gilt für die nummerierte Suchanfrage sp_q_8 .
34
sp_q_required
sp_q_required _#
sp_q_required= 1 oder 0 oder -1
sp_q_required_#= 1 oder 0 oder -1
Dieser Parameter bestimmt, ob eine Übereinstimmung in der entsprechenden Abfrage (1), darf (0) oder nicht (-1) auftreten muss, damit ein Dokument auf der Ergebnisseite zurückgegeben wird.
Die Verwendung von sp_q_required wirkt sich auf die Hauptabfrage ( sp_q ) aus.
Um eine nummerierte Abfrage zu erhalten, ersetzen Sie das # im Parameternamen durch die entsprechende Zahl ( sp_q_required_8 gilt beispielsweise für die nummerierte Abfrage sp_q_8 ). Der Standardwert des Parameters ist 1 (muss übereinstimmen).
Um nach Dokumenten zu suchen, die das Wort "calc"enthalten, aber NICHT "mac", "win"oder "all"im benutzerdefinierten Feld "platform"enthalten, könnte Ihr HTML-Suchformular die folgenden Zeilen enthalten:
<input type="hidden" name="sp_x_1" value="platform"> Search for: <input type="text" name="sp_q" value="calc"> Exclude: <input type="text" name="sp_q_1" value="mac win all"> <input type="hidden" name="sp_q_required_1" value="-1">
35
sp_redirect_if_one_result
sp_redirect_ if_one_result= 0 or 1
Gibt an, ob zur Suchergebnis-URL umgeleitet werden soll, wenn nur ein Suchergebnis vorhanden ist.
36
sp_referrer
sp_referrer= url
Gibt die URL der verweisenden Stelle für die Suche an. Nützlich für die Suche Umschreiben Regeln, bei denen die Suchergebnisse auf dieselbe Site zurückführen wie das Suchformular.
Der Standardwert ist der vom Browser bereitgestellte Standard-CGI HTTP_REFERRER-Wert.
37
sp_ro
sp_ro= field : Relevanz
Ermöglicht die optionale Suchzeit pro Feldname und Relevanzsteuerung. Das oder im Parameternamen steht für "relevant override". Der Parameter akzeptiert einen oder mehrere Feldnamen, gefolgt von einem Doppelpunkt und einem Relevanzwert von 0 bis 10.
Wenn Sie beispielsweise den Relevanzwert für den Feldnamen "body"auf 10 festlegen möchten, wird der Parameter zum Zeitpunkt der Suche durch einen Kunden wie folgt angezeigt:
sp_ro=body:10
Sie können auch ein Pipe-Trennzeichen verwenden, um mehrere Außerkraftsetzungen der Feldrelevanz in der Parameterzeichenfolge anzugeben. Um beispielsweise den Relevanzwert für die Feldnamen "body"und "title"auf 9 festzulegen, würde der Parameter bei der Durchführung einer Suche wie folgt angezeigt:
sp_ro=body:9|title:9
Hinweis: Die Angabe eines Felds, das nicht an der zugehörigen Suche beteiligt ist, hat keine Auswirkungen. Wenn Sie z. B. sp_ro=title:10 festlegen , der Name des Titelfelds jedoch nicht durchsucht wird, hat der Parameter sp_ro keine Auswirkungen. Mit anderen Worten, wenn Sie einen Feldnamen mit dem Parameter sp_ro angeben, wird dieses Feld nicht automatisch durchsucht. Stattdessen setzt sie die entsprechende Relevanzeinstellung des Felds außer Kraft.
38
sp_s
sp_s= number
Gibt die Sortierreihenfolge an. Null (0) ist der Standardwert und Mittel zur Sortierung nach Relevanzwert. Ein (1) bedeutet, nach Datum zu sortieren, und -1 bedeutet, nicht zu sortieren.
Sie können einen Feldnamen für den Wert des Parameters "sp_s" angeben. So sortiert sp_s=title die Ergebnisse beispielsweise nach den Werten, die im Titelfeld enthalten sind. Wenn ein Feldname für den Wert eines sp_s- Parameters verwendet wird, werden die Ergebnisse nach diesem Feld sortiert und dann nach Relevanz untergeordnet.
Stellen Sie die Sortierung für das referenzierte Feld entweder auf Aufsteigend oder Absteigend unter Einstellungen > Metadaten > Definitionen ein, um diese Funktion zu aktivieren.
Sie können einer einzelnen Abfrage auch mehrere Sortierfelder zuweisen, indem Sie den sp_s- Parameter mehrmals im Suchformular festlegen. In den folgenden Vorlagenzeilen werden die Suchergebnisse zunächst nach Künstlernamen, dann nach Albumnamen und dann nach Nachverfolgungsnamen sortiert.
<input type="hidden" name="sp_s" value="artist"> <input type="hidden" name="sp_s" value="album"> <input type="hidden" name="sp_s" value="track"> Search for: <input type="text" name="sp_q" value="Music Search">
Es ist auch möglich, mit der Tabelle übereinstimmende Felddaten zu sortieren, indem Sie vor dem Feldnamen einen Qualifikator für den Tabellennamen angeben, z. B. items.price. Weitere Informationen zur Tabellenzuordnung finden Sie im Parameter sp_field_table.
Bei der Suche nach der Nähe können Sie die Ergebnisse nach der Nähe sortieren, indem Sie ein "Feld für die Ausgabe der Nähe" angeben.
39
sp_sr
sp_sr= field
Gibt das Rankenfeld an, das für das statische Rang verwendet werden soll. Das Feld muss ein Feld vom Typ Rang mit einer Relevanz größer als 0 sein. Wenn für die Abfrage kein sp_sr- Parameter angegeben ist, wird automatisch ein Feld vom Typ Rank ausgewählt.
Um die statische Rangfolge für eine bestimmte Abfrage zu deaktivieren, fügen Sie einen NULL-Wert für sp_sr ein (z. B. <input type="hidden" name="sp_sr" value=""> ).
40
sp_sfvl_field
sp_sfvl_field= string
Gibt den Namen eines Felds an, das in Verbindung mit dem Tag <search-field-value-list> in der Suchvorlage verwendet werden soll.
Sie können mehrere sp_sfvl_field- Parameter angeben.
41
sp_sfvl_df_count
sp_sfvl_df_count= <integer_value>
Fordert bis zu <integer_value> search-field-value-list dynamic-facet-Felder für diese Suche an.
Der Standardwert lautet 0. Der maximal zulässige Wert ist die aktuelle Anzahl der dynamischen Facet-Felder, die für einen bestimmten Index definiert sind. Ganzzahlwerte, die kleiner als 0 sind, werden als 0 behandelt. Ganzzahlwerte, die oben angegeben wurden, die Anzahl der dynamischen Facetten-Felder werden bei der Anzahl der dynamischen Facetten-Felder begrenzt . Nicht-ganzzahlige Werte werden ignoriert. werden sie als Standardwert behandelt.
Die Suche eines bestimmten Segments wird mit einem maximal zulässigen Wert für sp_sfvl_df_count des Werts für die Anzahl der dynamischen Facetten dieses Segments begrenzt. Beim Zusammenführen von Segmentergebnissen ist der effektive Maximalwert von sp_sfvl_df_count der maximale tatsächliche sp_sfvl_df_count für alle Slices.
42
sp_sfvl_df_exclude
sp_sfvl_df_exclude= < field_name >[|< field_name >|...
Gibt eine Liste spezifischer dynamischer Facet-Felder an, die bei dieser Suche nicht berücksichtigt werden sollen.
Standardmäßig werden alle dynamischen Facettenfelder berücksichtigt.
43
sp_sfvl_df_include
sp_sfvl_df_include= < field_name >[|< field_name >|...
Gibt eine Liste spezifischer dynamischer Facettenfelder an, die in die Suchergebnisse aufgenommen werden sollen.
Hinweis: Der Parameter sp_sfvl_df_count bestimmt die Gesamtanzahl der zurückzugebenden dynamischen Facet-Felder, einschließlich aller über sp_sfvl_df_include angegebenen Felder . Das heißt, dass die Verwendung von sp_sfvl_df_include nicht zulässt, dass die Gesamtanzahl der zurückgegebenen dynamischen Facet-Felder sp_sfvl_df_count überschreitet .
44
sp_staged
sp_staged= 0 oder 1
Wenn sp_staged=1 mit einer Abfrage gesendet wird, handelt es sich bei der ausgeführten Abfrage um eine gestaffelte Suche.
Bei einer gestaffelten Suche werden alle Komponenten verwendet, die derzeit gestaffelt sind, einschließlich des Indexes und der Vorlagen.
45
sp_start_day, sp_start_month, sp_start_year
sp_start_day= number
sp_start_month= number
sp_start_year= number
Dieses Wertetriplet gibt den Startdatumsbereich für die Suche an und stellt ihn als Satz bereit.
46
sp_recommendations_q
sp_sug_q= number
Der Parameter sp_suggerate_q bestimmt, welcher sp_q[_#]- Parameter mit dem Suggest-Dienst verwendet werden soll.
Der Standardwert von sp_vorschläge_q ist 0, d. h., die Suchmaschine verwendet den Wert sp_q , um die Vorschläge zu bestimmen.
Legen Sie sp_suggerieren_q=1 fest, um den Wert von sp_q_1 zur Bestimmung der Vorschläge usw. zu verwenden.
47
sp_t
sp_t= string
Gibt die zu verwendende Transportvorlage an.
Dieser Parameter ist nützlich, wenn Sie das Erscheinungsbild der wichtigsten Suchergebnisse über Ihre Website hinweg steuern möchten, indem Sie für jeden Bereich in Ihrem Suchkonto unterschiedliche Suchtransportvorlagen verwenden.
Die standardmäßige Transportvorlage lautet "search".
48
sp_trace
sp_trace= 0 oder 1
Wenn sp_stage=1 festgelegt , wird die Kernfunktion für die Suchablaufverfolgung in Simulator aktiviert.
Hinweis: Wenn dieser Parameter nicht angegeben ist, werden bei der Kernsuche keine Nachverfolgungsinformationen erfasst und die zugehörigen Kern-Suchvorlagen-Tags haben keine Ausgabe.
49
sp_w, sp_w_control
sp_w= sound-alike-enable
sp_w_control= sound-alike-control
Gibt an, dass die Klangalike-Übereinstimmung für diese bestimmte Abfrage aktiviert oder deaktiviert werden soll.
Das sp_w_control für "Exakt" wird ignoriert. Die Übereinstimmung mit dem Ton ist deaktiviert.
Das sp_w_control für "Alike" wird ignoriert. Klangähnliche Übereinstimmung ist aktiviert
sp_w_control für alles andere ist 1. Die Übereinstimmung mit dem Ton ist deaktiviert.
sp_w_control für alles andere ist alles andere. Die Übereinstimmung mit dem Ton ist aktiviert.
Mit dem Parameter sp_w_control können Sie ein Kontrollkästchen mit negativem oder positivem Wortlaut für die Endbenutzer-Kontrolle der Klangalike-Übereinstimmung erstellen.
Wenn sp_w_control=0 verwendet wird, wird ein Kontrollkästchen mit negativem Wortlaut verwendet, um den sp_w- Parameter wie im folgenden Beispiel festzulegen:
<input type=hidden name="sp_w_control" value="0"><input type=checkbox name="sp_w" value="exact">No Sound-Alike matching
Wenn sp_w_control=1 verwendet wird, wird ein Kontrollkästchen mit positivem Wortlaut verwendet, um den sp_w- Parameter wie folgt festzulegen:
<input type=hidden name="sp_w_control" value="1"><input type=checkbox name="sp_w" value="alike">Sound-Alike matching
Weitere Beispiele zur Verwendung der Parameter sp_w_control und sp_w finden Sie im Beispiel für die erweiterte Suche.
50
sp_x
sp_x= field
Gibt die Felder an, die nach der Abfragezeichenfolge gesucht werden sollen. auf jede Weise alle Felder durchsuchen. title bedeutet nur Suchtitelfelder. desc bedeutet, dass nur Suchfelder mit Dokumentbeschreibung verwendet werden. Schlüssel bedeutet, nur Dokumentsuchbegriffe zu suchen. body bedeutet nur Suchtext. alt bedeutet, dass nur alternativer Text gesucht wird. url bedeutet, nur die URL-Werte zu suchen. target bedeutet nur Suchbegriffe. In diesen Fällen werden die Benutzerspezifikationen der Feldpräfixe "text:", "desc:", "keys:", "body:", "alt:", "url:"und "target:" innerhalb des entsprechenden Parameters "sp_q" ignoriert. Wenn sp_x nicht vorhanden ist oder wenn eine leere Zeichenfolge oder eine beliebige Zeichenfolge festgelegt ist, sind die Standard-Benutzerfeldpräfixe zulässig. Weitere Informationen zu den Feldpräfixen finden Sie in der Beschreibung zu den Suchtipps.
Beispiele mit dem Parameter sp_x finden Sie in der Beschreibung des erweiterten Suchformulars .
Sie können Abfragen erstellen, die alle Felder durchsuchen, die standardmäßig auf Suche unter Optionen > Metadaten > Definitionen eingestellt sind, indem Sie sp_x=any festlegen . Sowohl vordefinierte als auch benutzerdefinierte Felder können als Wert des sp_x- Parameters verwendet werden.
Sie können einer einzelnen Abfrage auch mehrere Felder zuweisen, indem Sie den sp_x- Parameter mehrmals festlegen. Mit den folgenden Vorlagenzeilen können Benutzer sowohl die Felder "Titel"als auch "Autor"für "Große Bücher"abfragen.
<input type="hidden" name="sp_x" value="title"><input type="hidden" name="sp_x" value="author">Search for: <input type="text" name="sp_q" value="Great Books">
51
sp_x_#
sp_x_#= field-name
Dieser Parameter gibt an, welches Feld in der entsprechenden sp_q_#- Abfrage gesucht werden soll. Die Zahl wird durch eine Zahl zwischen 1 und 16 ersetzt (z. B. sp_x_8 ). Der Feldname ist ein beliebiges vordefiniertes oder benutzerdefiniertes Feld.
Wenn für eine bestimmte nummerierte Abfrage kein sp_x_#- Parameter angegeben ist, werden alle Felder, die standardmäßig als Suche nach den Einstellungen unter Einstellung > Metadaten > Definitionen definiert sind, von dieser Abfrage durchsucht.
Wenn Sie beispielsweise das folgende Formular senden, werden alle Dokumente zurückgegeben, die das Wort "hervorragend"enthalten, das auch das Wort "Fitzgerald"im Feld "Autor"enthält:
Search for: <input type="text" name="sp_q" value="great"><input type="hidden" name="sp_x_1" value="author">Search only documents written by: <input type="text" name="sp_q_1" value="Fitzgerald">
Sie können mehrere Feldnamen mit einer bestimmten Abfrage oder einer nummerierten Abfrage verknüpfen, indem Sie in einer einzigen Suchanfrage mehr als eine Instanz desselben Parameters sp_x oder sp_x_# angeben.
Wenn Sie z. B. in den Feldern "body"und "keys"nach dem Wort "blume"suchen möchten, können Sie ein Suchformular mit den folgenden Informationen erstellen:
<input type="hidden" name="sp_x_1" value="body"><input type="hidden" name="sp_x_1" value="keys">Search for: <input type="text" name="sp_q_1" value="flower">

Ein typisches Beispiel für die Verwendung von CGI-Parametern für die Backend-Suche

Die folgenden Linkabfragen starten eine Suche mit "Musik" als Suchabfrage und verwenden alle Standardparameter. Beachten Sie, dass die URL zur Lesbarkeit auf zwei Zeilen aufgeteilt ist. In Ihrem HTML-Code sollte sich dieser Link alle in einer Zeile befinden.
<a href="https://search.atomz.com/search/?sp_q=Music&sp_a=sp99999999"> 
Testing...</a>

Dieselben Funktionen werden typischerweise mit einem Formular definiert:
<form action="https://search.atomz.com/search/"> 
<input size=12 name="sp_q" value="Music"><br> 
<input type=hidden name="sp_a" value="sp99999999"> 
<input type=submit value="Search"><br> 
</form>

Normalerweise sollten Sie beim Starten einer Suche Standardparameter verwenden. Auf diese Weise wird die erste Seite angezeigt, sortiert nach Relevanz, und der Kunde kann andere Seiten und andere Optionen auswählen. Wenn das Suchformular auf Ihrer Site Optionen für Sammlungen enthält, geben Sie den Sammlungsnamen als Parameter an.

Ein detailliertes Beispiel für die Verwendung von CGI-Parametern für die Backend-Suche

Die folgenden Formularabfragen zeigen die 25 Ergebnisse, die mit dem Ergebnis beginnen 10 . Zusammenfassungen werden nicht angezeigt, die Sortierreihenfolge ist nach Datum geordnet und die Sammlung mit dem Namen support wird verwendet. Es werden nur Dokumente zurückgegeben, die innerhalb der letzten 30 Tage datiert wurden.
<form action="https://search.atomz.com/search/"> 
<input size=12 name="sp_q"><br> 
<input type=hidden name="sp_a" value="sp99999999"> 
<input type=submit value="Search"><br> 
<input type=hidden name=sp_n value=10> 
<input type=hidden name=sp_c value=25> 
<input type=hidden name=sp_m value=0> 
<input type=hidden name=sp_s value=1> 
<input type=hidden name=sp_k value="support"> 
<input type=hidden name=sp_date_range value=30> 
</form>