Приложение "Парсер формата MLS"

Приложение Парсер формата 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

Дополнительно

Параметры приложения apps.mlsparser