В этом месяце непривычно для января большой "выхлоп". И, эксперимент, новый инструмент в документации: Конструктор АПИ.
Подробнее под катом.
|
Разработчикам |
Последние сообщения блогов
Обновление документации в январе 2022
01.02.202210:5901.02.2022 10:59:39
Конструктор API
25.01.202212:0825.01.2022 12:08:15
В документации по старому API и по D7 появился конструктор API. В бета версии. Только для авторизованных пользователей.
Фото:
Обновление документации в ноябре/декабре 2021
24.12.202114:3324.12.2021 14:33:17
В ноябре отболел модной сейчас болезнью. Поэтому не было ноябрьского сообщения. Поэтому отчитаюсь сейчас сразу за два месяца.
Обновление документации в октябре 2021
29.10.202114:5929.10.2021 14:59:32
Продолжаем работу по совершенствованию курсов по вашим отзывам "Тема раскрыта полностью/не полностью". На этот раз работа над курсом Администратор. Бизнес. Правда ещё не полностью закончена работа над Модулями, но там загвоздка в разработчиках. А у них - релиз...
Подробности под катом
Подробности под катом
Обновление документации в сентябре 2021
28.09.202115:2328.09.2021 15:23:36
Основная задача в этом месяце была - правка курса Администратор Модули по результатам оценок пользователей. Поправили много уроков (их здесь не приводим): формулировки, исправление неточностей и так далее. Детально о выпущенном - под катом.
Обновление документации в августе 2021
30.08.202115:2830.08.2021 15:28:51
Всем доброго дня! Несмотря на отпуска выхлоп в этом месяце у нас не плохой. Курсу Админ коробки повезло в количестве добавленных страниц (глава по 1С), Курсу Админ Бизнес - в разнообразии.
Подробности под катом.
Подробности под катом.
Обновление документации в июле 2021
28.07.202112:2428.07.2021 12:24:48
С серединкой лета всех нас! В этом месяце вышло много информации по Rest доке и по API D7. Подробности под катом.
Смарт-процессы и новое API CRM
09.07.202112:2309.07.2021 12:23:59
Всем привет!
Не так давно мы закончили писать первую версию документации по смарт-процессам и новому API CRM. Спасибо Роберту и его команде за оперативную публикацию.
Документация тут - и
Если её внимательно прочитать (а ещё лучше - ознакомиться с исходным кодом), то станет понятно, что у разработчиков появляется возможность внедриться очень глубоко в API "малой кровью" (без модификации ядра). Мы почти не ставили final у классов и методов, только местами.
Однако наличие этой возможности не значит, что ей необходимо очень активно пользоваться.
Как вы знаете, мы поддерживаем обратную совместимость. Но цена этой поддержки - довольно высока. Это в буквальном смысле сковывает нам руки - нам всё время приходится держать в голове необходимость поддержания совместимости, рефакторить сильно нельзя и т.д. Код становится "закостенелым" и буквально превращается в легаси с момента выхода первой его версии.
Теперь, когда у разработчиков есть возможность наследовать классы продукта, это становится ещё сложнее. Т.к. по-хорошему, мы не можем менять даже сигнатуру protected методов.
В связи с этим большая просьба - при наследовании классов придерживайтесь рекомендаций, изложенных на этой странице
Здесь я изложу их ещё раз немного другими словами
1. Не надо наследовать стандартные классы без особой необходимости вообще. Делайте это только в крайнем случае и когда вы полностью отдаете себе отчет, как и что вы делаете
2. Не надо использовать / наследовать те классы, которые в документации помечены соответствующим образом (ParentFieldManager и другие).
3. Если вы наследуете класс, ни в коем случае не меняйте сигнатуру методов добавлением новых аргументов / изменением типов возвращаемых значений и т.д. Если надо передать какие-то дополнительные данные, сделайте отдельный метод для этого
4. Не стоит слишком полагаться на структуру массивов внутри классов. При использовании делайте проверки.
5. Даже следуя этим рекомендациям можно столкнуться с тем, что после установки обновления что-то отвалится из-за каких-то изменений. Пишите тесты, тестируйте обновления не на продакшн-окружении, используйте фича-флаги.
Если после ознакомления с кодом или документацией вам что-то не понравилось - не стесняйтесь писать.
По поводу нового API для старых сущностей - будет, но не сразу. Не так давно мы сделали возможность читать данные о лидах, сделках, контактах и компаниях (выйдет в районе crm 21.800.0). Позже добавим возможность и делать изменения через новое API.
По поводу реста - доделываем прямо сейчас, будет классно.
Не так давно мы закончили писать первую версию документации по смарт-процессам и новому API CRM. Спасибо Роберту и его команде за оперативную публикацию.
Документация тут - и
Если её внимательно прочитать (а ещё лучше - ознакомиться с исходным кодом), то станет понятно, что у разработчиков появляется возможность внедриться очень глубоко в API "малой кровью" (без модификации ядра). Мы почти не ставили final у классов и методов, только местами.
Однако наличие этой возможности не значит, что ей необходимо очень активно пользоваться.
Как вы знаете, мы поддерживаем обратную совместимость. Но цена этой поддержки - довольно высока. Это в буквальном смысле сковывает нам руки - нам всё время приходится держать в голове необходимость поддержания совместимости, рефакторить сильно нельзя и т.д. Код становится "закостенелым" и буквально превращается в легаси с момента выхода первой его версии.
Теперь, когда у разработчиков есть возможность наследовать классы продукта, это становится ещё сложнее. Т.к. по-хорошему, мы не можем менять даже сигнатуру protected методов.
В связи с этим большая просьба - при наследовании классов придерживайтесь рекомендаций, изложенных на этой странице
Здесь я изложу их ещё раз немного другими словами
1. Не надо наследовать стандартные классы без особой необходимости вообще. Делайте это только в крайнем случае и когда вы полностью отдаете себе отчет, как и что вы делаете
2. Не надо использовать / наследовать те классы, которые в документации помечены соответствующим образом (ParentFieldManager и другие).
3. Если вы наследуете класс, ни в коем случае не меняйте сигнатуру методов добавлением новых аргументов / изменением типов возвращаемых значений и т.д. Если надо передать какие-то дополнительные данные, сделайте отдельный метод для этого
4. Не стоит слишком полагаться на структуру массивов внутри классов. При использовании делайте проверки.
5. Даже следуя этим рекомендациям можно столкнуться с тем, что после установки обновления что-то отвалится из-за каких-то изменений. Пишите тесты, тестируйте обновления не на продакшн-окружении, используйте фича-флаги.
Если после ознакомления с кодом или документацией вам что-то не понравилось - не стесняйтесь писать.
По поводу нового API для старых сущностей - будет, но не сразу. Не так давно мы сделали возможность читать данные о лидах, сделках, контактах и компаниях (выйдет в районе crm 21.800.0). Позже добавим возможность и делать изменения через новое API.
По поводу реста - доделываем прямо сейчас, будет классно.
Обновление документации в июне 2021
29.06.202112:4229.06.2021 12:42:41
Летняя жара расслабляет. Но мы работаем. 
На подходе большой пакет API доки по CRM, то что выходит в версии 20.700. Что сделано в этом месяце - под катом.
На подходе большой пакет API доки по CRM, то что выходит в версии 20.700. Что сделано в этом месяце - под катом.Обновление документации в мае 2021
31.05.202117:3131.05.2021 17:31:52
После изменения структуры курса Разработчик Bitrix Framework были нарекания на то, что стало трудно пользоваться им как постоянным источником информации. Нарекания были справедливыми, мы исправились. Теперь в правом углу "шапки" курса есть переключатель на Справочник. Подробности под катом
Обновление документации в апреле 2021
27.04.202115:1527.04.2021 15:15:44
Давно так не везло курсу Администратора коробки Битрикс24. Надеемся, что и другие материалы будут полезны. Подробности под катом.
Обновление документации в марте 2021
29.03.202112:4229.03.2021 12:42:56
В рамках подготовки с серьёзному обновлению сервера очередей выпущен пакет документации. Подробнее под катом.
Обновление документации в феврале 2021
26.02.202115:1226.02.2021 15:12:39
В этом месяце неплохое пополнение для разработчиков в доке и курсе Разработчика.
Обновление документации в январе 2021
29.01.202117:2229.01.2021 17:22:39
Пока разработчики решают на что им поменять Centos 8 были протестированы несколько ОС, на которые можно установить наши продукты. Описание установок вынесено в отдельную главу.
Обновление документации в декабре 2020
22.12.202013:4622.12.2020 13:46:11
Месяц по срокам отчёта - короткий, потому и отчёт короткий. Практически все курсы переведены на новый формат оффланового файла. ДОкументация пока остаётся в прежнем формате chm, но скоро и её переведём. Под катом то, что выпущено в этом месяце.
Обновление документации в ноябре 2020
30.11.202017:5030.11.2020 17:50:12
В этом месяце мы начали переход на новый формат оффлайн файлов. Мы отказывается от формата CHM в пользу формата EPUB. Он более современный, удобный, читается на всех видах устройств. Файлы пока заменены не на всех курсах, и в документации они на какое-то время останутся в старом формате. Подробнее о новинках доки - под катом
Обновление документации в октябре 2020
28.10.202014:5028.10.2020 14:50:31
Бывают месяцы, когда публикуется сразу большой объём работ, который делался в течение нескольких месяцев ранее. Вот в октябре именно такая картина. Был переведён на новый шаблон курс Администратора коробки, был переформатирован курс Разработчик Bitrix Framework. И было опубликовано много чего ещё. Подробности под катом.
Разработчик Bitrix Framework будет недоступен
15.10.202012:3415.10.2020 12:34:27
24 и 25 октября учебный курс будет недоступен в связи с проведением работ по преобразованию его структуры.
Фото:
Обновление документации в сентябре 2020
28.09.202016:0828.09.2020 16:08:59
В этом месяце продолжилась работа по созданию проверчных уроков и практических заданий для админских курсов. Подробнее под катом.
Долгое время сохранения элемента в админской форме или Нормальные герои всегда идут в обход
24.09.202012:4124.09.2020 12:41:52
Периодические обращения с проблемой, означенной в заголовке, и одинаковая причина, вылились в публикацию этого поста.
Итак, симптомы следующие: долгое (60 сек и выше) сохранение элемента/товара через админскую форму редактирования. При импорте и выполнении из консоли проблем не наблюдается. Клиент недоволен, техподдержка в панике. Анализ на стороне хостера выявляет долгий запрос вида:
В тяжелых случаях изменения не сохраняются вообще. В чем же причина?
Итак, симптомы следующие: долгое (60 сек и выше) сохранение элемента/товара через админскую форму редактирования. При импорте и выполнении из консоли проблем не наблюдается. Клиент недоволен, техподдержка в панике. Анализ на стороне хостера выявляет долгий запрос вида:
UPD ATE b_iblock_element SE T TIMESTAMP_X = TIMESTAMP_X, SHOW_COUNTER_START = ifnull(SHOW_COUNTER_START, now()), SHOW_COUNTER = ifnull(SHOW_COUNTER, 0) + 1 WH ERE ID=ИД_сохраняемого_элемента |
Кастомизированный умный фильтр и main 20.5.x
17.09.202019:4317.09.2020 19:43:04
Коллеги, недавно в коробку были выгружены обновления Главного модуля (main) 20.5.x. Текущий статус - бета. В этих обновления существенно переработан план выполнения страницы для повышения производительности и уменьшения времени отдачи контента браузеру.
Для поддержки этих возможностей был доработан компонент умного фильтра каталога (catalog.smart.filter). Измененный компонент доступен после установки обновления инфоблоков iblock 20.0.900. Однако, если на конкретном проекте компонент фильтра был кастомизирован (скопирован или перенесен в свое пространство имен), необходимо будет внести изменения в код самостоятельно.
Для поддержки этих возможностей был доработан компонент умного фильтра каталога (catalog.smart.filter). Измененный компонент доступен после установки обновления инфоблоков iblock 20.0.900. Однако, если на конкретном проекте компонент фильтра был кастомизирован (скопирован или перенесен в свое пространство имен), необходимо будет внести изменения в код самостоятельно.
Фото:
Изменения документации в августе 2020-го года
01.09.202014:1801.09.2020 14:18:05
В этом месяце вышло много уроков для самопроверки и Практических заданий в курсе Администратор. Модули. Ссылки на них давать не буду, так как этот блог не читают неофиты. Сами уроки для самопроверки найдёте в глвах курса. Детально - под катом
Обновление документации в июле 2020
29.07.202011:3029.07.2020 11:30:38
Добавили в этом месяце кнопку отключения/включения табов в шаблонах документации и курсов. Теперь удобно будет не только тем, кто не любит крутить колёсико, но и тем, кто привык к "портянкам". Детали выпущенной документации - под катом.
Детали выпущенной документации - под катом.Обновление документации в июне 2020
29.06.202011:5929.06.2020 11:59:00
Введённые в прошлом месяце табы вызвали (как обычно) неоднозначную реакцию. В курсах разработчков, дейсвительно, табы смотрятся тускло и слабозаметны. Это будет исправлено, задача у сайтостроителей уже стоит. Что сделано в июне месяце - под катом.
Обновление документации в мае 2020
28.05.202017:0428.05.2020 17:04:19
В этом месяце были внесены изменения в шаблоны документации и учебных курсов. В документации появилась тёмная тема, так любимая разработчиками.
Фото:
