<img src=“http://travis-ci.org/BrandyMint/bitrix_on_rails.png” /> <img src=“https://codeclimate.com/badge.png” />
Приблуды для использования под рельсами базы 1С:Битрикс.
Для каждого инфоблока что лежит в b_iblock есть своя таблица название которой с номером инфоблока, например b_iblock_element_prop_s7 prop_s - для одиночных свойтсв, prop_m - для множестенный. У каждого инфоблока нескоолько секций (iblock_section), в каждой секции несколько элементов (iblock_element) у каждого элемента разные свойства которые лежат в prop_s/_m. Соответсвенно я эти свойства вытащил в одно место - они все доступны из модели IblockElement. Или напрямую; IblockElement.find(123).НАЗВАНИЕ_СВОЙСТВА или через метод properties
gem 'bitrix_on_rails'
В файл ‘config/initialize/bitrix_on_rails.rb` впишите:
BitrixOnRails.init
-
Адаптер mysql2_downcase для автоматической конвертации заглавных наименований полей в прописные.
Для создания модели элемента инфоблока:
-
наследуем модель от IblockElement
-
в конце файла добавляем BitrixOnRails.send :create_iblock_class, _номер_инфоблока_, _имя_модели_ unless Rails.application.config.cache_classes
-
в config/initializers/bitrix_on_rails.rb в блок BitrixOnRails.configure добавляем c.infoblock _номер_инфоблока_, :extended_class => _имя_модели_
Далее работаем с инфоблоком, как с обычной моделью.
-
Все модели для таблиц b_iblock_*
-
Автоматическая установка свойств из таблиц prop_s*/prop_m* в методы объекта IblockElement. Например IblockElement.find(1).name_emittents, где name_emittent - свойство из prop_s. Все подобные свойства также доступны через метод IblockElement#properties.
-
IblockElementS*
-
Тоже самое и для моделей IblockElementPropertyS*, плюс в них значения полей можно еще и устанавливать:
p = IblockElementPropertyS3.find(1) p.name_emittents='новое имя' p.save 2. Поиск по кодовым названиям полей таблицы IblockElementPropertyS3.find_by_post_id(123) вместо .find_by_property_149(123) Таким образом если мы знаем что инфоблок S3 связан с таблицей постов и хотим получить все свойства поста 63, делаем: IblockElementPropS3.find_by_post_id(63).iblock_element.properties
-
IblockElement.properties выдает хеш соответсвия кодов свойств и названия их полей в prop_s Автоматическое определение привязки элемента к объекту. Например: если мы спрашиваем iblock_element.post
то он ищет ключ :post_id в свойствах элемента, и если находит, то возвращает Post.find_by_id(properties)
-
Все свойства IblockProperty кешируются и доступны через find(id)
-
В IblockElement автоматически добавляются has_one :iblock_element_prop_s* и has_many :iblock_element_prop_m* при создании соответвующих классов.
-
Модель можно расширять инфоблоком с помощью:
class Post << ActiveRecord::Base
has_infoblock(3, :property_19) # где property_19 поле ссылающееся на Post
Создастся класс Post::Elemnt наследуемый от IblockElement
для этой модели автоматически создадутся ассоциации
:iblock_element - класс Post::Element
Класс PostElement будет иметь ассоциации
:property_set (он же iblock_element_prop_sNUMBER) и :m_prop_values а также default_scope с номером инфоблока, поэтому Post::Element.all выдаст только элементы к специфичному инфоблоку
Iblock.get_property_codes(3) # => {:blog_id=>9, :glob_class=>11, :post_id=>13, :post_cafe=>15, :post_analitik=>16, :post_type=>17, :anonim=>18, :file=>20, :status=>21, :auto_rubric=>37, :link_change=>38, :link_company=>123, :post_kitchen=>124, :analyst=>152, :post_toilet=>193, :theme=>280, :post_analitik_bloger=>290, :num_comments=>309, :cnt_thanks=>327, :preview_mpage=>341, :name2=>342, :cnt_complaint=>349, :pr_subscribe=>410, :was_published=>421, :vip_subscribe=>422, :post_skyline=>430, :vip_send_date=>438} # Тоже что и Iblock.find(3).property_codes
Iblock.get_properties(3) # Тоже самое Iblock.find(3).get_properties(3)[13] # => #<IblockProperty id: 13, timestamp_x: "2009-12-17 18:13:59", iblock_id: 3, name: "ID Поста", active: "Y", sort: 600, code: "POST_ID", default_value: "", property_type: "N", row_count: 1, col_count: 30, list_type: "L", multiple: "N", xml_id: nil, file_type: "", multiple_cnt: 5, tmp_id: nil, link_iblock_id: 0, with_description: "N", searchable: "N", filtrable: "Y", is_required: "Y", version: 2, user_type: nil, user_type_settings: nil>
Iblock.get_property(ibock_id, property_id) # Тоже самое Iblock.find(3).get_property(13).code # => :post_id
Подключать просто:
development: adapter: mysql2_downcase encoding: cp1251 ...
bundle exec guard
или
bundle exec rake test
-
Больше примернов использования
-
Спеки
-
С нетерпением жду форков, пулеквестов, замечаний и предложений.
Данил Письменный, Дмитрий Максимов
Copyright © 2011 Red Green Development. See LICENSE.txt for further details.