Парсер формата MLS: различия между версиями

Материал из CMS Sitebill Wiki
Перейти к навигации Перейти к поиску
 
(не показано 6 промежуточных версий этого же участника)
Строка 1: Строка 1:
 +
== Страница дубль. Удалить. ==
 
Приложение Парсер формата MLS предназначено для загрузки в сайт данных из XML, сформированных согласно требованиям MLS.
 
Приложение Парсер формата MLS предназначено для загрузки в сайт данных из XML, сформированных согласно требованиям MLS.
 
<br />
 
<br />
Строка 12: Строка 13:
 
Загрузка данных происходит из XML файла. Предварительно, файл с данными должен быть помещен на сервер в папку, указанную в настройке apps.mlsparser.parser_root (Папка для загрузки файлов). Файл должен быть валидным документом XML и иметь расширение '.xml'. В имени файла могут содержаться цифры, латинские буквы и подчеркивание.<br />
 
Загрузка данных происходит из XML файла. Предварительно, файл с данными должен быть помещен на сервер в папку, указанную в настройке apps.mlsparser.parser_root (Папка для загрузки файлов). Файл должен быть валидным документом XML и иметь расширение '.xml'. В имени файла могут содержаться цифры, латинские буквы и подчеркивание.<br />
  
После этого может быть вызван парсер данных. Парсер вызывается GET-запросом по адресу http://сайт/apps/mlsparser/parser.php
+
После этого может быть вызван парсер данных. Парсер вызывается GET-запросом по адресу <nowiki>http://сайт/apps/mlsparser/parser.php</nowiki>
 
Вместе с вызовом в переменной запроса '''file''' необходимо передать имя файла с данными (имя передается без расширения файла).<br />
 
Вместе с вызовом в переменной запроса '''file''' необходимо передать имя файла с данными (имя передается без расширения файла).<br />
  
Строка 29: Строка 30:
 
<pre>678_3_25</pre>
 
<pre>678_3_25</pre>
  
Соответствующие данные должны быть переданы с данными в XML загружаемого файла, либо указаны в [[Параметры приложения apps.mlsparser|настройках]] приложения.
+
Соответствующие данные должны быть переданы с данными в XML загружаемого файла, либо указаны в [[Параметры приложения apps.mlsparser|настройках]] приложения.<br />
 +
 
 +
Загрузка географических данных, в данный момент, производится в несвязанном виде. Передав в данных об положении объекта в Страна:"Россия", Регион:"Калининградская область", вы добьетесь того, что в данных объекта будут указаны соответствующие страна и регион, но между собой они не будут связаны, если только они уже не были связаны, либо вы их не свяжете в последствии.<br />
 +
 
 +
 
 +
=== Загрузка изображений. ===
 +
 
 +
Загрузка данных происходит из ZIP-архива. Предварительно, фотографии должен быть помещены на сервер в ZIP-архиве, указанную в настройке apps.mlsparser.parser_root (Папка для загрузки файлов). Архив должен быть одноуровневым, не содержать внутри вложенных папок, а только загружаемые изображения. Файл должен иметь расширение '.zip' и являться правильным архивом формата ZIP. В имени файла могут содержаться цифры, латинские буквы и подчеркивание.<br />
 +
 
 +
Запуск загрузчика изображений производится GET-запросом по адресу <nowiki>http://сайт/apps/mlsparser/photo.php</nowiki>
 +
Вместе с вызовом в переменной запроса '''file''' необходимо передать имя архива с изображениями (имя передается с или без  расширения файла).<br />
 +
 
 +
Пример:
 +
<pre>
 +
http://somesite.ru/apps/mlsparser/photo.php?file=img_data_20140621
 +
или
 +
http://somesite.ru/apps/mlsparser/photo.php?file=img_data_20140621.zip
 +
</pre>
 +
, где будет предпринята попытка загрузить в существующие на сайте объявления соответствующие изображения из файла <pre>http://somesite.ru/cache/upl/img_data_20140621.zip</pre>
 +
По завершении импорта изображений, исходный файл с данными будет удален с сервера.<br />
 +
 
 +
Принцип формирования имен изображения для загрузки описан в [[Параметры приложения apps.mlsparser]]<br />
 +
 
 +
При загрузке изображений для некоторого объявления изменению будут подвергнуты изображения ТОЛЬКО этого объявления. Если будет передана в архиве хоть одно изображение, привязанные до этого момента изображения к объявлению, будут удалены и новые будут добавлены. Иными словами происходит полная замена изображений.<br />
 +
 
 +
Если переданы изображения для объявления, которое нет или невозможно идентифицировать на сайте по параметрам, переданым в названиях картинок, вставка или обновление не будут проведены.<br />
 +
 
 +
Если вы не передавали изображений к конкретному объявлению, то его изображения не подвергнутся изменению.<br />
 +
 
 +
Загрузка изображений в данный момент поддерживается только для способа хранения изображений в элементе типа uploadify_image<br />

Текущая версия на 21:03, 23 июня 2014

Страница дубль. Удалить.

Приложение Парсер формата MLS предназначено для загрузки в сайт данных из XML, сформированных согласно требованиям MLS.

Загрузка данных осуществляется в два этапа:

1. Загрузка собственно данных.

2. Загрузка изображений.

Загрузка данных.

Загрузка данных происходит из XML файла. Предварительно, файл с данными должен быть помещен на сервер в папку, указанную в настройке apps.mlsparser.parser_root (Папка для загрузки файлов). Файл должен быть валидным документом XML и иметь расширение '.xml'. В имени файла могут содержаться цифры, латинские буквы и подчеркивание.

После этого может быть вызван парсер данных. Парсер вызывается GET-запросом по адресу http://сайт/apps/mlsparser/parser.php Вместе с вызовом в переменной запроса file необходимо передать имя файла с данными (имя передается без расширения файла).

Пример:

http://somesite.ru/apps/mlsparser/parser.php?file=data_20140621

, где будет предпринята попытка распарсить и импортировать в сайт данные из файла

http://somesite.ru/cache/upl/data_20140621.xml

В случае физического существования файла, его соответствия формату XML и наличию в нем данных, данные из него будут импортированы в сайт. Исходный файл с данными будет удален с сервера.


Данные загружаются с учетом существования. Каждая запись из исходного файла будет сличена с уже существующими в сайте записями и, при наличии существующей аналогичной, будет произведено обновление записи. В противном случае - вставка.


Существование записей проверяется по ключу уникальности. Ключ уникальности - это строка состоящая из трех частей - значений полей uniq_id, internal_type_id и user_id соединенных подчеркиванием.

Например:

678_3_25

Соответствующие данные должны быть переданы с данными в XML загружаемого файла, либо указаны в настройках приложения.

Загрузка географических данных, в данный момент, производится в несвязанном виде. Передав в данных об положении объекта в Страна:"Россия", Регион:"Калининградская область", вы добьетесь того, что в данных объекта будут указаны соответствующие страна и регион, но между собой они не будут связаны, если только они уже не были связаны, либо вы их не свяжете в последствии.


Загрузка изображений.

Загрузка данных происходит из ZIP-архива. Предварительно, фотографии должен быть помещены на сервер в ZIP-архиве, указанную в настройке apps.mlsparser.parser_root (Папка для загрузки файлов). Архив должен быть одноуровневым, не содержать внутри вложенных папок, а только загружаемые изображения. Файл должен иметь расширение '.zip' и являться правильным архивом формата ZIP. В имени файла могут содержаться цифры, латинские буквы и подчеркивание.

Запуск загрузчика изображений производится GET-запросом по адресу http://сайт/apps/mlsparser/photo.php Вместе с вызовом в переменной запроса file необходимо передать имя архива с изображениями (имя передается с или без расширения файла).

Пример:

http://somesite.ru/apps/mlsparser/photo.php?file=img_data_20140621
или
http://somesite.ru/apps/mlsparser/photo.php?file=img_data_20140621.zip

, где будет предпринята попытка загрузить в существующие на сайте объявления соответствующие изображения из файла

http://somesite.ru/cache/upl/img_data_20140621.zip

По завершении импорта изображений, исходный файл с данными будет удален с сервера.

Принцип формирования имен изображения для загрузки описан в Параметры приложения apps.mlsparser

При загрузке изображений для некоторого объявления изменению будут подвергнуты изображения ТОЛЬКО этого объявления. Если будет передана в архиве хоть одно изображение, привязанные до этого момента изображения к объявлению, будут удалены и новые будут добавлены. Иными словами происходит полная замена изображений.

Если переданы изображения для объявления, которое нет или невозможно идентифицировать на сайте по параметрам, переданым в названиях картинок, вставка или обновление не будут проведены.

Если вы не передавали изображений к конкретному объявлению, то его изображения не подвергнутся изменению.

Загрузка изображений в данный момент поддерживается только для способа хранения изображений в элементе типа uploadify_image