Приложение "Выгрузка ЦИАН 2": различия между версиями

Материал из CMS Sitebill Wiki
Перейти к навигации Перейти к поиску
Строка 41: Строка 41:
  
 
== Дополнительные фиды ==
 
== Дополнительные фиды ==
 +
 +
С версии 0.3.2 есть возможность создавать дополнительные кастомные фиды. Стандартный фид продолжает существовать по алиасу из настройки '''apps.cianexporter2.standart_alias''' и подчиняться основным настройкам.

Версия 13:09, 28 августа 2019

Приложение "Выгрузка ЦИАН 2"

Основные настройки

Параметр Название Описание
apps.cianexporter2.export_mark Поле checkbox-типа для участия в выгрузке Системное имя поля типа checkbox отмеченное значение которого обозначает доступность для выгрузки в стандартном фиде. Ограничение работает одновременно с ограничением из настройки apps.cianexporter2.date_field.
apps.cianexporter2.standart_alias Алиас стандартной выгрузки Алиас стандартного фида. Может иметь произвольный вид, допустимый для URL страницы. Не указывается домен и протокол. Не используются лидирующие и замыкающие слеши.
apps.cianexporter2.externals Дополнительные объекты Дополнительные объекты, собираемые вместе с данными об объявлении. См. #Дополнительные объекты
apps.cianexporter2.date_field Ситемное имя поля ограничивающей даты Системное имя поля типа date или dtdatetime, значение которого значение которого в будущем относительно текущего момента, обозначает доступность для выгрузки в стандартном фиде. Ограничение работает одновременно с ограничением из настройки apps.cianexporter2.export_mark.
apps.cianexporter2.commercial_by_days Использовать ограничение доступности выгрузки по дням для коммерческой Включает режим доступности выгрузки коммерческих объектов в определенные дни, указанные в настройке apps.cianexporter2.commerce_allowed_days. Если выгрузка происходит вне дней, указанных в настройке apps.cianexporter2.commerce_allowed_days, то коммерческие объекты не будут выдаваться в нее
apps.cianexporter2.commerce_allowed_days Дни доступности выгрузки коммерческой Указанные через запятую номера дней недели доступности коммерческих объектов. (1 - пн, 2 - вт, ... , 7 - вс). Например: 1,2,3,4,5 - с пн по пт. или 1,3,5,7 - пн, ср, пт, вс. Не допускается указание в виде диапазона (1-5). Если перечень дней доступности не будет указан, но будет включена настройка apps.cianexporter2.commercial_by_days, то коммерческие объекты в фид не попадут.
apps.cianexporter2.use_user_limits Использовать ограничение количества выгружаемых Включение режима, ограничивающего количество выгружаемых объектов для каждого пользователя некоторым лимитом, указанным в данных его профиля (настройка apps.cianexporter2.user_profile_limit_field).
apps.cianexporter2.user_profile_limit_field Системное имя поля с лимитом на выгрузку в профиле Системное имя поля в модели объекта user в котором хранится числовое значение лимита выгружаемых объектов в фид для каждого пользователя. Если включен режим ограничения лимитами и в этой настройке не указано значение системного поля-источника или указано, но само поле в модели не существует или существует, но имеет не числовое значение, то лимит для этого пользователя будет установлен в 0.

Дополнительные объекты

Если возникает необходимость в Маппере приложения обозначить условия на основании значений данных не самого объекта, а связанных с ним объектов, то необходимо декларировать эти объекты в настройке apps.cianexporter2.externals.
Например, у нас в приложении Жилые комплексы, каждый комплекс имеет признак-checkbox с системным именем is_newbuild, который обозначает является ли ЖК новостройкой или нет. А объявления имеют признак complex_id, который ссылается на один из ЖК из списка строений в базе Жилых комплексов. В Маппере мы имеем возможность создать условие для определения является ли выгружаемый объект объектом в новостройке. Логично предположить, что "новостроечность" объекта будет обозначать случай, когда объект привязан к ЖК у которого свойство is_newbuild отмечено. Но это свойство не объекта, а связанного с ним объекта.

Для того, что бы реализовать такое условие, мы должны объявить подбор информации о связанном ЖК вместе с данными объявлений. Поэтому в настройке apps.cianexporter2.externals мы указываем следующую строку

complex_id=complex

Она означает, что при сборке данных об объявлении при выгрузке, будет получен связанный через поле complex_id объект и его данные будут интегрированы в данные объекта под псевдонимом complex. И в прописівании условий мі сможем использовать запись вида

complex.is_newbuild

А для доступа к имени ЖК

complex.name

Дополнительные фиды

С версии 0.3.2 есть возможность создавать дополнительные кастомные фиды. Стандартный фид продолжает существовать по алиасу из настройки apps.cianexporter2.standart_alias и подчиняться основным настройкам.