xml_export_documentation:xml_request_and_response
Differences
This shows you the differences between two versions of the page.
| Next revision | Previous revision Last revision Both sides next revision | ||
|
xml_export_documentation:xml_request_and_response [2019/04/29 17:58] florian [Products that may not be exported] |
xml_export_documentation:xml_request_and_response [2019/09/19 11:34] florian [Procedure of the Export] |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ===== Export documentation: XML format ===== | + | ===== Export documentation: XML request and response===== |
| - | + | ||
| - | The goal of the export is to transfer all products to the FINDOLOGIC-server, so FINDOLOGIC can index them. To achieve this, there has to be a file or function-call reachable from the outside under ''findologic_export.php'' in the root of the shop.((The path can be changed if necessary.)) | + | |
| - | + | ||
| - | The export has to be programmed in an OP style to secure simple extensibility without changing the code of the module itself. | + | |
| + | The goal of the export is to transfer all products to the FINDOLOGIC-server so FINDOLOGIC can index them. To achieve this, there has to be a file or function-call reachable from the outside under ''findologic_export.php'' in the root of the shop.((The path can be changed if necessary.)) | ||
| ---- | ---- | ||
| ==== Parameter of the Export-URL ==== | ==== Parameter of the Export-URL ==== | ||
| - | For the sequential processing of the export ((due to runtime limitations the export has to be sequential)) the following parameters have to be transmitted: | + | For the sequential processing of the export the following parameters have to be transmitted: |
| * ''shopkey'': shopkey of the service | * ''shopkey'': shopkey of the service | ||
| * ''start'': first exported article (Offset) starting with ''0'' | * ''start'': first exported article (Offset) starting with ''0'' | ||
| - | * ''count'': interval-size / how many articles are exported | + | * ''count'': page size / how many articles are exported per page |
| + | |||
| + | <note important>Due to runtime limitations the XML-export has to be paginated.</note> | ||
| All other parameters given in the export URL are passed through each export step. | All other parameters given in the export URL are passed through each export step. | ||
| Line 27: | Line 26: | ||
| ==== Procedure of the Export ==== | ==== Procedure of the Export ==== | ||
| - | The export call delivers [[export_patterns:xml|valid XML]] for the respective products. The XML also contains the information if more products are delivered, thus FINDOLOGIC can send another call. | + | The export call delivers [[xml_export_documentation:xml_format|valid XML]] for the respective products. The XML also contains the information if more products are delivered, thus FINDOLOGIC can send another call. |
| - Call http://www.example.com/findologic_export.php?shopkey=1234&start=0&count=100 from the FINDOLOGIC-import | - Call http://www.example.com/findologic_export.php?shopkey=1234&start=0&count=100 from the FINDOLOGIC-import | ||
| Line 37: | Line 36: | ||
| - Return of the last export-page (''total'' number of products is exported) | - Return of the last export-page (''total'' number of products is exported) | ||
| - Indexing of all products | - Indexing of all products | ||
| + | |||
| + | <note>Please make sure to whitelist the HTTP user agent "FINDOLOGIC" if you are restricting access to the export via user agents.</note> | ||
| ---- | ---- | ||
| Line 48: | Line 49: | ||
| * Active / Inactive (only active products are exported) | * Active / Inactive (only active products are exported) | ||
| * Show / Hide (only shown products are exported) | * Show / Hide (only shown products are exported) | ||
| - | * [...] | ||
| - | **According to this the export has to reflect that logic:** | + | **According to this, the export has to reflect that logic:** |
| * If an article is not shown in the shop, it is not exported. | * If an article is not shown in the shop, it is not exported. | ||
| * If a variant is not shown in the shop, the respective attributes are not exported. | * If a variant is not shown in the shop, the respective attributes are not exported. | ||
| * If a category is not show in the shop, the products only found in this category are not exported, the category itself is not exported as an attribute. | * If a category is not show in the shop, the products only found in this category are not exported, the category itself is not exported as an attribute. | ||