Приложение "Выгрузка ЦИАН 2"
Приложение "Выгрузка ЦИАН 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 и подчиняться основным настройкам.
