integration_documentation:response_xml
Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
integration_documentation:response_xml [2019/09/11 09:18] rihad [Additional information for users of Smart Did-You-Mean] |
integration_documentation:response_xml [2020/02/25 11:28] florian |
||
---|---|---|---|
Line 3: | Line 3: | ||
The response format can be set by FINDOLOGIC only. If the XML response format is used, please refer to the following documentation. | The response format can be set by FINDOLOGIC only. If the XML response format is used, please refer to the following documentation. | ||
+ | <note tip>Our library helps requesting the FINDOLOGIC API and also getting the data from the response and mapping it to corresponding objects. Read more at https://github.com/findologic/findologic-api </note> | ||
==== Basic structure of the XML tree ==== | ==== Basic structure of the XML tree ==== | ||
Line 20: | Line 20: | ||
* ''[[#filter]]'' | * ''[[#filter]]'' | ||
* ... | * ... | ||
- | * ''[[#landingpage]]'' | + | * ''[[#landingPage]]'' |
* ''[[#promotion]]'' | * ''[[#promotion]]'' | ||
---- | ---- | ||
+ | |||
+ | See our [[https://github.com/findologic/xml-response-schema/blob/v2.1.0/schema.xsd|xsd scheme]] for further information. | ||
+ | |||
+ | \\ | ||
==== The XML elements in detail ==== | ==== The XML elements in detail ==== | ||
- | \\ | ||
- | === <servers/> === | + | ==== <servers/> ==== |
The servers with which the query was answered. The element need not always be included. | The servers with which the query was answered. The element need not always be included. | ||
+ | |||
<code xml> | <code xml> | ||
<servers> | <servers> | ||
Line 53: | Line 57: | ||
---- | ---- | ||
- | === <query/> === | + | ==== <query/> ==== |
+ | |||
+ | Describes the query that is currently being carried out. | ||
- | Describes the query that is currently being carried out. | ||
<code xml> | <code xml> | ||
<query> | <query> | ||
Line 65: | Line 70: | ||
\\ | \\ | ||
- | ==== Additional information for users of Smart Did-You-Mean ==== | + | === Information for Smart Did-You-Mean === |
Smart Did-You-Mean users receive additional information for better error-tolerant search. A number of constellations listed below are possible, and each variety requires a certain kind of output in the search result visualization. | Smart Did-You-Mean users receive additional information for better error-tolerant search. A number of constellations listed below are possible, and each variety requires a certain kind of output in the search result visualization. | ||
Line 96: | Line 101: | ||
=== Improved query === | === Improved query === | ||
- | The original query has good results, but there is an alternative query that may be more relevant to the user. | + | The original query has results, but there is an alternative query that is more relevant to the user. |
**Response format:** | **Response format:** | ||
Line 156: | Line 161: | ||
Indicates which area of the results has been requested. | Indicates which area of the results has been requested. | ||
- | **Attribute:** | + | **Attributes:** |
* ''first'' | * ''first'' | ||
- | * indicates the first element to be displayed ((0-based, i.e. if the first argument is displayed, the value is 0.)) | + | * Indicates the first element to be displayed ((0-based, i.e. if the first argument is displayed, the value is 0.)). |
* ''count'' | * ''count'' | ||
- | * indicates the total number of elements to be displayed | + | * Indicates the total number of elements to be displayed. |
---- | ---- | ||
- | === <searchedWordCount/> === | + | ==== <results/> ==== |
- | + | ||
- | Indicates the number of searched words from the query. | + | |
- | + | ||
- | ---- | + | |
- | + | ||
- | === <foundWordCount/> === | + | |
- | + | ||
- | Indicates the number of found words from the query. If no results could be found for the complete query, **''<foundWordCount/>''** is correspondingly reduced to the number of words for which result could be found. ((''foundWordCount'' has currently no function)) | + | |
- | + | ||
- | ---- | + | |
- | + | ||
- | === <results/> === | + | |
Provides information on the query output. | Provides information on the query output. | ||
- | <results> | + | <code xml><results> |
<count>2</count> | <count>2</count> | ||
- | </results> | + | </results></code> |
---- | ---- | ||
Line 193: | Line 186: | ||
---- | ---- | ||
- | === <products/> === | + | ==== <products/> ==== |
Indicates the query output of the products found. Depending on the values of ''<first/>''- and ''<count/>''-this may include only a partial range of the entire query output. | Indicates the query output of the products found. Depending on the values of ''<first/>''- and ''<count/>''-this may include only a partial range of the entire query output. | ||
- | <products> | + | <code xml><products> |
- | <product id="666" direct="1"/> | + | <product id="666" relevance="15.265"> |
- | <product id="123" direct="2"/> | + | <product id="123" relevance="14.361"> |
- | </products> | + | </products></code> |
---- | ---- | ||
Line 206: | Line 199: | ||
=== <product/> === | === <product/> === | ||
- | <product id="123" direct="2"> | + | <code xml><product id="123" relevance="14.361"> |
<properties> | <properties> | ||
... | ... | ||
</properties> | </properties> | ||
- | </product> | + | </product></code> |
- | **Attribute:** | + | **Attributes:** |
* ''id'' | * ''id'' | ||
- | * indicates the ID of the respective product transmitted in the export. | + | * Indicates the ID of the respective product transmitted in the export. |
- | * ''direct'' | + | * ''relevance'' |
- | * This parameter will continue to be delivered for legacy reasons, but it is always "0". | + | * Indicates the relevance of the respective product. |
---- | ---- | ||
Line 222: | Line 215: | ||
=== <properties/> === | === <properties/> === | ||
- | <properties> | + | <code xml><properties> |
<property name="propertyName">propertyValue2</property> | <property name="propertyName">propertyValue2</property> | ||
- | </properties> | + | </properties></code> |
| | ||
\\ | \\ | ||
- | == <property/> == | + | === <property/> === |
- | Shows the contents of an [[csv_export_documentation:csv_format#optional_additional_columns|optional export column.]] | + | Shows the contents of the properties that have been imported. |
- | **Attribute:** | + | **Attributes:** |
* ''name'' | * ''name'' | ||
* Shows the name of the exported column. | * Shows the name of the exported column. | ||
Line 238: | Line 231: | ||
---- | ---- | ||
- | === <filters/> === | + | ==== <filters/> ==== |
Shows further filter options from the search service that are sensible due to the results found. The filters in the ''<filter/>''-elements are grouped according to categories. | Shows further filter options from the search service that are sensible due to the results found. The filters in the ''<filter/>''-elements are grouped according to categories. | ||
- | <filters> | + | <code xml> <filters> |
<main> | <main> | ||
<filter> | <filter> | ||
Line 253: | Line 246: | ||
</filter> | </filter> | ||
</other> | </other> | ||
- | </filters> | + | </filters></code> |
| | ||
=== <main/> === | === <main/> === | ||
- | Indicates that the respective filter is configurated as main filter in the [[https://secure.findologic.com/login.symfony/web/app.php/shop/filter|customer account]] | + | Indicates that the respective filter is configurated as main filter in the [[https://secure.findologic.com/login.symfony/web/app.php/shop/filter|customer account]]. |
{{:integration_documentation:main-filter.png?|}} | {{:integration_documentation:main-filter.png?|}} | ||
+ | |||
+ | ---- | ||
=== <other/> === | === <other/> === | ||
- | Indicates that the respective filter is configuratedas other filter in the [[https://secure.findologic.com/login.symfony/web/app.php/shop/filter|customer account]] | + | Indicates that the respective filter is configuratedas other filter in the [[https://secure.findologic.com/login.symfony/web/app.php/shop/filter|customer account]]. |
{{:integration_documentation:other-filter.png?|}} | {{:integration_documentation:other-filter.png?|}} | ||
+ | |||
+ | ---- | ||
=== <filter/> === | === <filter/> === | ||
Line 271: | Line 268: | ||
Indicates a filter category and contains the various values for this filter category in the ''<items/>'' elements. | Indicates a filter category and contains the various values for this filter category in the ''<items/>'' elements. | ||
- | <filter> | + | <code xml><filter> |
<name>cat</name> | <name>cat</name> | ||
<display>Kategorie</display> | <display>Kategorie</display> | ||
Line 280: | Line 277: | ||
... | ... | ||
</items> | </items> | ||
- | </filter> | + | </filter></code> |
---- | ---- | ||
Line 330: | Line 327: | ||
* The filter values are to be displayed in text form. | * The filter values are to be displayed in text form. | ||
* ''color'' | * ''color'' | ||
- | * The filter is to be displayed as a "Color-Picker". | + | * The filter is displayed as a "Color-Picker". |
+ | * ''select'' | ||
+ | * The filter is displayed as a "Dropdown". | ||
* ''image'' | * ''image'' | ||
- | * The filter values are to be displayed in image form. | + | * The filter values are to be displayed in image form. Only available for vendor filter. |
* ''range-slider'' | * ''range-slider'' | ||
* The filter values are to be displayed with a range slider. | * The filter values are to be displayed with a range slider. | ||
Line 343: | Line 342: | ||
Is only output if ''type'' = ''range-slider''. | Is only output if ''type'' = ''range-slider''. | ||
- | <attributes> | + | <code xml><attributes> |
<selectedRange> | <selectedRange> | ||
<min>24</min> | <min>24</min> | ||
Line 354: | Line 353: | ||
<stepSize>1</stepSize> | <stepSize>1</stepSize> | ||
<unit>Zoll</unit> | <unit>Zoll</unit> | ||
- | </attributes> | + | </attributes></code> |
| | ||
---- | ---- | ||
Line 391: | Line 390: | ||
---- | ---- | ||
- | === <items/> === | + | ==== <items/> ==== |
- | <items> | + | <code xml><items> |
<item> | <item> | ||
... | ... | ||
Line 400: | Line 399: | ||
... | ... | ||
</item> | </item> | ||
- | </items> | + | </items></code> |
Contains the individual values for this filter category. | Contains the individual values for this filter category. | ||
Line 410: | Line 409: | ||
Contains further information on this specific filter. | Contains further information on this specific filter. | ||
- | <item selected="1"> | + | <code xml><item selected="1"> |
<name>Subgroup</name> | <name>Subgroup</name> | ||
<display>Subgroup</display> | <display>Subgroup</display> | ||
Line 426: | Line 425: | ||
</items> | </items> | ||
</items> | </items> | ||
- | </item> | + | </item></code> |
* ''selected'' | * ''selected'' | ||
- | * indicates that this filter is selected. | + | * Indicates that this filter is selected. |
''<item/>''-elements can contain further ''<items/>'' in turn. | ''<item/>''-elements can contain further ''<items/>'' in turn. | ||
Line 459: | Line 458: | ||
The number of results for this filter((If according to ''<count/>'' at least 32767 results have been found, this value is only approximated)) | The number of results for this filter((If according to ''<count/>'' at least 32767 results have been found, this value is only approximated)) | ||
the element is optional and is not output in certain cases. | the element is optional and is not output in certain cases. | ||
+ | |||
+ | * <type> ''absolute'' | ||
+ | * Indicates that the frequency shown is the total number of results available after clicking the filter value. | ||
+ | * <type> ''relative'' | ||
+ | * Indicates that the frequency shown is the number of results that will be added after clicking the filter value. (f.e. //+3//) | ||
---- | ---- | ||
Line 486: | Line 490: | ||
---- | ---- | ||
- | === <landingpage/> === | + | ==== <landingPage/> ==== |
Indicates that a landing page has been found for the search term (e.g. for General Terms and Conditions or the imprint page). | Indicates that a landing page has been found for the search term (e.g. for General Terms and Conditions or the imprint page). | ||
Line 500: | Line 504: | ||
---- | ---- | ||
- | === <promotion/> === | + | ==== <promotion/> ==== |
Indicates that a promotion has been found for the search term (e.g. for special seasonal campaigns or special sales). | Indicates that a promotion has been found for the search term (e.g. for special seasonal campaigns or special sales). | ||
Line 519: | Line 523: | ||
==== Example ==== | ==== Example ==== | ||
- | The following example is fictitious and contains all possible elements at the same time. | + | The following example is fictional and contains all possible elements at the same time. |
- | <searchResult> | + | <code xml><searchResult> |
<servers> | <servers> | ||
- | <frontend>frontend.findologic.com</frontend> | + | <frontend>frontend9.findologic.com</frontend> |
- | <backend>frontend.findologic.com</backend> | + | <backend>backend12.findologic.com</backend> |
</servers> | </servers> | ||
<query> | <query> | ||
<limit first="0" count="10"/> | <limit first="0" count="10"/> | ||
<queryString>Test</queryString> | <queryString>Test</queryString> | ||
- | <searchedWordCount>1</searchedWordCount> | ||
- | <foundWordCount>1</foundWordCount> | ||
</query> | </query> | ||
<landingPage link="http://www.example.com/imprint" /> | <landingPage link="http://www.example.com/imprint" /> | ||
Line 538: | Line 540: | ||
</results> | </results> | ||
<products> | <products> | ||
- | <product id="666" direct="1"/> | + | <product id="666" relevance="15.311"/> |
<properties> | <properties> | ||
<property name="propertyName">propertyValue1</property> | <property name="propertyName">propertyValue1</property> | ||
</properties> | </properties> | ||
- | <product id="123" direct="2"/> | + | <product id="123" relevance="14.363"/> |
<properties> | <properties> | ||
<property name="propertyName">propertyValue2</property> | <property name="propertyName">propertyValue2</property> | ||
Line 564: | Line 566: | ||
<name>Unteruntergruppe</name> | <name>Unteruntergruppe</name> | ||
<weight>0.985228</weight> | <weight>0.985228</weight> | ||
- | <frequency>4</frequency> | + | <frequency type="relative">4</frequency> |
<items> | <items> | ||
... | ... | ||
Line 609: | Line 611: | ||
</other> | </other> | ||
</filters> | </filters> | ||
- | </searchResult> | + | </searchResult></code> |