1С-Битрикс Разработчикам — Поддержка папки /local/

58

16.10.201311:2616.10.2013 11:26:11

В представленной схеме есть одно неудобство: нужно исключать из репозитория «чужие» файлы. Как ни странно, с точки зрения проекта «чужими» файлами являются файлы продукта — они изменяются не разработчиками проекта, а приходят «снаружи» в виде обновлений. Неудобство заключается в том, что нельзя просто исключить папку /bitrix/ — в ней могут находиться в том числе файлы проекта — модули, компоненты, шаблоны сайта и т.д. В итоге файл .hgignore приобретает избыточный вид:

/bitrix/activities/bitrix/
/bitrix/admin
/bitrix/cache
/bitrix/components/bitrix/
/bitrix/gadgets/bitrix
/bitrix/image_uploader
/bitrix/images
/bitrix/js
/bitrix/managed_cache
/bitrix/stack_cache
/bitrix/modules/advertising
/bitrix/modules/bitrix.sitecommunity
...
/bitrix/modules/xdimport
/bitrix/modules/xmpp
/bitrix/modules/.htaccess
/bitrix/otp
/bitrix/sounds
/bitrix/template/
/bitrix/themes
/bitrix/tmp
/bitrix/tools
/bitrix/wizards/bitrix
/bitrix/[^/]*\.php$
/upload
/bitrix/php_interface
/bitrix/panel/
/bitrix/updates/
/bitrix/fonts/

Чтобы сделать жизнь разработчиков проектов удобнее, мы решили в рамках работ по новому ядру вынести основные файлы проекта из папки /bitrix в папку /local. Это позволит изолировать изменяющиеся файлы проекта от папки продукта. По сути, в исключения достаточно будет добавить одну папку /bitrix.

Какие папки обрабатываются в /local?

activities — действия БП;
components — компоненты;
gadgets — гаджеты рабочего стола;
modules — модули;
php_interface — init.php, папка user_lang;
templates — шаблоны сайтов, шаблоны компонентов, шаблоны страниц.

При обработке папок приоритет всегда у /local перед /bitrix. Это означает, что если в /local/templates/ и /bitrix/templates/ будут находиться шаблоны сайта с одинаковым названием, то подключится шаблон из /local.

Мы уверены, что это нововведение позволит более эффективно разрабатывать проекты.

Да, доступно это с версии 14 (в настоящий момент в альфе).

dev.1c-bitrix.ru

1С-Битрикс расположение основных файлов

site.ru/bitrix/

• /admin/ — административные скрипты;
• /components/ — папка для системных и пользовательских компонентов;
  • /bitrix/ * — системные компоненты; править не рекомендуется, т.к. при обновлении они обновляются
    • /имя компонента/
      • component.php — основной файл, тут реализована вся логика компонента, тут идёт выборка из БД, с формированием массива, который передаётся в шаблон
      • .parameters.php (видео)
      • .description.php (видео)
  • /my_components/ — папку можно обозвать как угодно, нужна для хранения своих компонентов
• /modules/ * — каталог с модулями системы, каждый подкаталог имеет свою строго определённую структуру;
• /php_interface/ — вспомогательный служебный каталог, в него входят следующие каталоги и файлы
  • dbconn.php — параметры соединения с базой
  • after_connect.php — подключается сражу же после соединения с базой данных
  • dbconn_error.php — подключается при ошибки соединения с базой данных
  • dbquery_error.php — подключается при ошибки выполнения SQL запроса
  • init.php — дополнительные параметры портала; для подключения своих функций/событий
  • admin_header.php — аналог init.php, но подключается только в административном разделе битрикса, удобен когда нужно вывести доп. кнопки в ShowPanel(), чтобы не захламлять init.php
  • /ID сайта/init.php — дополнительные параметры сайта; файл подключается сразу же после определения специальной константы с идентификатором сайта — SITE_ID
  • /include/site_closed.php — шаблон для публичной части сайта, если она закрыта (настройки>настройки модулей>главный модуль>Публичная часть)

• /templates/ — каталог с шаблонами сайтов и компонентов, в него входя следующие подкаталоги:
  • /.default/ — подкаталог с общими файлами, используемым тем или иным шаблоном по умолчанию, структура данного каталога аналогична ниже прописанной структуре каталога соединяющего конкретный шаблон;
  • /ID шаблона сайта/ — подкаталог с шаблонами сайта, в него входят следующие подкаталоги и файлы:
    • /components/ — каталог с кастомизированными шаблонами компонентов
    • /lang/ — языковые файлы принадлежат как данному шаблону, так и отдельным компонентам;
    • /images/ — каталог с изображениями данного шаблона;
    • /page_templates/ — каталог с изображениями страниц и их основным хранящимся в файле .content.php. Когда пользователь создаёт новую страницу, он может выбрать по какому шаблону из представленных в этом каталоге это будет сделано
    • header.php — шапка шаблона
    • footer.php — подвал шаблона
    • template_style.css — файл стилей для данного шаблона
    • style.css — стили для контент редактора
• .settings.php — параметры соединения с базой (ядро D7)

site.ru/

• .access.php — содержаться указания по правам на папки
• urlrewrite.php — содержит правила для работы ЧПУ

Важно

• при разработке не нужно изменять стандартные компоненты и модули bitrix/components/bitrix/ и bitrix/modules/ т.к. при обновление системы они затрутся 
• не работать напрямую с БД и не менять структуру её таблиц (при обновлении системы название таблиц и поля могут меняться)

cloudurl.ru

Документы и файловое хранилище в Битрикс24

Корпоративный портал от 1С-Битрикс – средство управления информацией в компании. Какую форму может иметь информация? Как правило, это личные сообщения (в том числе задачи), тексты с картинками и старые добрые файлы.
Вообще в работе с файлами прогресс идет медленнее всего. Сколько поколений систем сменилось, а тонны файлов по-прежнему висят тяжким балластом на корпоративных серверах.
Корпортал не сделал чуда в работе с файлами, однако многие важные операции могут стать проще, прозрачнее, понятнее.

Сегодня поговорим о файлах, доступе к ним, общих и частных файловых хранилищах. Скажем даже страшное и манящее слово «документооборот».
Корпортал в этой части удобен и секретарше, и управленцу, и ИТ-специалисту.

Итак, продолжим: документы и файловые хранилища.

Почему файловые хранилища это важно

Как есть?

У вас много файлов. Это не вопрос, это факт. С ростом объемов жестких дисков и низкой ценой на них мы как-то незаметно перестали что-либо удалять. «На всякий случай», «пусть полежит пока» — у вас на личном компьютере несколько десятков гигабайт старых архивов, когда-то любимых игр, нечитанная документация, неразобранные фотки с отпуска и прочий хлам.
Ровно так же происходит в той части корпоративного сервера, которую добрый сисадмин отвел для хранения общих документов.
Для более простого резервирования и восстановления порядка узаконен бардак.
Почти никогда в организациях не борются с копиями. Очень редко ставят квоты (скажем, не более 1 Гб на сотрудника).
Такие файловые хранилища удобны и привычны. Файлопомойка – как старые джинсы. Не жмет, комфортно, но слегка стыдно и есть ощущение, что надо иначе.

Как надо

Конечно, голубая мечта директора и главного ИТ-шника – чтобы был полный порядок. Каждый файл нужен, актуален и имеет архивные копии. Сотрудникам выданы именно те доступы, которые им нужны. Файловое хранилище защищено от вирусов и злоумышленников.
Эта мечта хороша и правильна, но достигать ее только через внедрение корпоративных информационных систем вряд ли получится, нужно еще и перестраивать процессы, а это крайне болезненно.

Тенденции

Главное – все уходит в облака. Гиганты отрасли один за другим запускают облачные сервисы хранения и управления файлами, компании стремятся к хорошо защищенному доступу из любой точки мира с хорошими скоростями и с минимальной ценой владения.
Каждый может эту тенденцию ощутить на себе. Например, недавно я понял что уже с год не обращаюсь к жесткому диску ни на своем компьютере, ни на общем сервере. Все нужные мне документы лежат в интернете. В почте, в корпортале, в Google Docs. Моя личная файлопомойка изжила себя.

Корпортал

Корпортал подобен облаку. Все крутится в нем, у сотрудников только самые обычные программы, которые есть везде.
К Новому году Битрикс собирается запустить собственный облачный ресурс, так что можно будет все инфраструктурные вопросы переложить на компанию-разработчика.

Корпортал может сохранить удобство привычных инструментов и устранить их неприятные недостатки.
Итак, что вам даст перевод файлов в корпоративный портал:
• Доступ не только из головного офиса, но также из филиалов, из дома и даже в командировке. Везде где есть интернет, будут и ваши файлы.
• Поиск по офисным документам, текстовым и pdf-файлам.
• Автоматически ведется история изменений файлов.
• Файлы можно обсуждать прямо в корпортале
• Ваш привычный сценарий работы с файлами будет сохранен: все папки с файлами, размещенные в корпортале, можно подключить в Windows как сетевые диски.

Идеология

В корпортале изначально есть три вида документов (по способу доступа).

Можно создать хранилище документов (оно еще называется библиотекой) с доступом для любых выбранных вами людей. Об этом поговорим далее.

Если на компьютере с Windows включена служба «веб-клиент» (в корпортал входит файл, который ее включает), то можно любую библиотеку документов подключить как сетевой диск.
Есть возможность открытия документов на редактирование прямо в корпортале без скачивания себе.
Можно заблокировать общий файл для редактирования и быть уверенным что одновременно с вами никто файл не изменяет.
Можно прописать сценарий документооборота для файла и запустить последовательную работу нескольких сотрудников над ним.

Пройдемся по пунктам.

Общие документы и документы рабочих групп

Основные возможности файлового хранилища покажу, как всегда, на нашем собственном примере.

Что можно?
Создавать папки, закачивать файлы (записывается, кто и когда загрузил версию, старые версии тоже хранятся), обсуждать, задавать описание, выполнять обычные файловые операции в браузере.
Обратите внимание на строку с кнопками «Загрузить», «Создать папку» и т.п.
Под ссылкой Сетевой диск доступно описание подключения папки в свою операционную систему как диска.
В разделе «Еще» предлагается скачать плагин для Firefox для редактирования файлов в портале.

Сетевые диски и веб-папки

Браузер – хорошо, но все же неудобно. Лучше файловым менеджером или проводником – кто как привык.

Подключим веб-папку.

Можно выполнять все привычные файловые операции, закачивать и редактировать файлы.
Все действия через веб-папки корпортал записывает как изменения от вашего имени, как будто вы работали в браузере.

Создаем свое файловое хранилище. Настройка доступа

Допустим, вам нужно дать доступ к техническим документам людям из разных служб.
Можно сделать рабочую группу, пригласить в нее нужных людей и воспользоваться ее разделом «Файлы». Будет работать.
А можно создать свое собственное файловое хранилище. Это сложнее, но интереснее и более гибко. При создании файлового хранилища вручную можно проще и быстрее настроить хитрую систему доступов к файлам, чем через рабочую группу.
Итак: через рабочую группу – просто, быстро, в 2 клика, все-по умолчанию.
Настройка файлового хранилища «руками» — для любителей тонкой настройки и умного администрирования.
Покажу общую последовательность действий. Поехали.
На первой картинке в этой статье есть кнопка «Добавить библиотеку»
Вводим название, переводит на английский язык Битрикс сам.

Если «Ограничить доступ к разделу (не публиковать)», то ссылку на хранилище будут видеть только указанные вами группы пользователей.
На следующем экране настраивается место в меню корпортала, где будет опубликована ссылка.

Самое интересное – на третьем экране.
Если в пункте «источник данных» выбрать «физическая папка на диске», то сразу можно задать доступ к верхнему уровню хранилища.

Но это не главное. После создания хранилища я могу через файловый менеджер Битрикса указать доступ к каждой папке индивидуально. Эти доступы будут наследоваться сверху вниз и заменяться для внутренних папок, если для них настроено отдельно.
Посмотрите, в разделе «Техническая документация» я создал два подраздела «Клиентам» и «Программистам» (Корзина-Trash создается автоматически). Для каждого подраздела можно вызвать окно с настройкой доступа для него.

Для каждой группы пользователей можно указать свой доступ.

Это гибко, универсально, но требует от внедренца хорошего понимания смысла происходящего.

Мы пользуемся этим приемом для настройки больших файловых хранилищ в компаниях, где очень много различных видов доступа и на каждый случай делать рабочую группу непрактично.

Правим на месте

Хранилище сделано, файлы скопированы, доступы даны. Надо работать.
Скачивать себе файлы и закачивать их назад, разумеется, крайне неудобно.

Неудобно – это слабо сказано. У обычного офисного персонала просто взрывается мозг при попытке понять почему «Загрузить» — это с компьютера в корпортал, а не наоборот и почему файл нужно редактировать локально и потом закачивать.
Эти простые вопросы и их обсуждение у клиентов показывают, как подобная мелочь может сорвать внедрение продукта.

Но решение есть, и им надо пользоваться.
Если сотрудники пользуются MS Internet Explorer (обычно так и бывает, хотя продвинутый народ испытывает к этой программе ненависть), то все просто. Документ открывается без скачивания на компьютер.

Для продвинутых тоже все готово: после установки расширения (оно есть в Битриксе) Mozilla Firefox умеет редактировать документы без скачивания.

Выглядит как и в IE, субъективно работает намного быстрее. Ткнул – открылось.

Что важно – можно не ломать логику конечного пользователя. Ведь бухгалтеру, главному технологу или девочке из отдела маркетинга могут быть непонятны и чужды устремления руководителя и автоматизатора, они вполне могут встретить новую программу в штыки.
Хороший прием: сказать что корпортал это такой новый проводник. Не я придумал, в одной компании спросили: ну то есть это как проводник, да?
Любите и уважайте простого пользователя, и будет вам счастье.

Доступ из любого места, блокировки, история и обсуждения

Корпортал – это сайт. То есть его можно выложить в Интернет и он будет доступен из любого места, подключенного к глобальной сети. Факт простой, но от того не мене приятный.
Ваши файлы, размещенные как написано ранее, теперь доступны сотрудникам отовсюду. Дополнительный трафик, который вы потратите при работе с документами, в 21 веке обычно почти бесплатен, а вот время сотрудников стоит все дороже и дороже.

Блокировки. Интересно и просто реализован в корпортале учет занятости документа. Например, если вы уже редактируете документ, повторно его открыть нельзя ни вам, ни кому-нибудь другому.

Версии. Корпортал хранит историю версий документа, и это очень удобно.

На вкладке «Обсуждение» у каждого файла есть возможность оставлять мнения и комментарии. Это удобно, если в компании часто несколько человек работают над файлом.

Документооборот

Документооборотом называют внедрение маршрутов прохождения документов в организации, когда автоматизированы основные действия и все процессы идут сами без курьеров, потери бумаг и лишней бюрократии.
Корпортал умеет организовывать документооборот по любым последовательным сценариям для страниц сайта.
Как это делается.
Надо прописать маршруты документов. Маршрут – список статусов.
Например: Черновик, Готов, Опубликован.

Эти статусы можно создать в разделе Документооборот панели управления корпорталом.
Для каждого статуса задаются права сотрудников: кто может переводить в этот статус и кто может читать документ в нем.

Таким образом и задаются сценарии (маршруты) документооборота.
В документообороте могут участвовать страницы сайта, то есть файлы, физически размещенные в каталогах.
Более сложные сценарии доступны с использованием модуля «Бизнес-процессы», о котором мы еще поговорим.

Как внедрять?

Мысленно вижу себе читателя, который после просмотра этой большой статьи думает: эх, красота! А как мне это запустить? Ведь у меня так все сложно, часть файлов хранится локально, часть на сервере, а еще мы DropBox пробовали внедрять, а как же моя безопасность и прочее и прочее.
Это правильный и совершенно нормальный подход перед внедрением – все продумать.
Расскажу как это делаем мы. Как, в какой последовательности, с какими паузами.
1. Загрузка пользователей, оргструктура и настройка групп (см статью про оргструктуру). Делает внедренец или сам заказчик.
2. Прописывание иерархии файловых хранилищ и доступов к ним. Нужно убедиться что вы, сотрудники и внедренцы понимают эти доступы одинаково. По возможности надо структуру упростить, перевод на корпортал – самое время для упрощений. Делает заказчик, обсуждает с внедренцем.
3. Оценить объем файлов, режим доступа к ним, посчитать время и деньги. Принять решение что переносить в портал, а что оставить локально или на других ресурсах. Решить где устанавливать корпортал: в офисе или в Сети на хостинге или выделенном сервере (зависит от того, кто: внешние люди или сотрудники и как: из дома или только с рабочего места, будут иметь доступ). Делается совместно.
4. Настроить файловые хранилища. Делает внедренец по разработанной на предыдущем шаге схеме.
5. Протестировать файловые хранилища на предмет правильных доступов для всех групп пользователей.
6. Скопировать файлы. Это не надо делать штатными загрузчиками корпортала, файлы нужно загрузить по FTP или другими способами. Информация о правах доступа хранится отдельно от прав операционной системы, и проблем не будет.
7. Проверить работу у пользователей, внести изменения в реестр, установить расширения для браузеров, побороться с файрволом, если он есть.
8. Все еще раз проверить.
Полная настройка файловых хранилищ в зависимости от сложности доступов и объемов хранения занимает от нескольких часов до нескольких десятков часов.

Проблемы и решения

Хотелось назвать этот раздел «Ложка дегтя» или «Холодный душ для внедренца».
Я много говорил о том, как все прекрасно работает. Поговорим о проблемах.
1. Сетевые диски удается подключить не сразу и не в любой версии Windows. Требуется добавлять ключи в реестр, перезапускаться, ждать. Решаемо, но требует возни и времени специалиста. Везде, где мы внедряли, вопрос был решен.
2. Иногда сетевые диски работают медленно. Медленно входит в папки. Замечено, что это связано с русскими именами папок, зависит от версии операционной системы. Лечится сменой способа подключения (сетевой диск заменить на веб-папку)
3. Многократная авторизация. При подключении к документам и сетевым дискам Windows, особенно при включенной на максимум защите и безопасности, спрашивает пароль доступа к корпорталу от 1 до 5 раз. Лечится внимательным чтением документации Битрикса, настройкой безопасности, отключением некоторых специфических параметров в самом корпортале. Всегда удается свести к единственной авторизации.
4. Индексация PDF. PDF-ки бывают разные, и при сочетании нестандартной для индексатора кодировки и Glyph-шрифтов русские слова в PDF-файлах корпортал не индексирует. Это серьезная проблема, мы столкнулись с тем что 70% файлов у нашего клиента были именно такие. Битрикс и даже разработчик утилиты-индексатора решить вопрос не помогли, но мы справились.

Резюме

Корпортал позволяет завести файловое хранилище и организовать удобную работу с документами в единой информационной среде.
Файловое хранилище нужно не всем компаниям, однако небольшие фирмы начнут ими пользоваться без всякого внедрения, а крупные и специфические с помощью специалистов решат все вопросы.
Файловые хранилища – полезны.
Работа с файловыми хранилищами поддерживается всеми редакциями 1С-Битрикс24.

Оцените статью:

Спасибо, ваш голос успешно добавлен!

www.intervolga.ru

Создание новой папки

В этом разделе

Административная часть

Форма предназначена для создания новой папки в административном разделе.

Контекстная панель

Форма создания новой папки

Кнопки управления

Пример создания раздела

1. В административной части перейдите в Менеджер файлов: Контент > Структура сайта > Файлы и папки.
2. На контекстной панели выберите Добавить, и далее Добавить папку.
3. В открывшейся форме укажите:
   • Имя папки. Используйте латинские или русские буквы (начиная с 11-й версии модуля), цифры или символы. Недопустимо использование следующих спецсимволов: \ / ? * < > » ‘.
   • Название раздела. Именно это название будет отображено в цепочке навигации в качестве ссылки на созданный раздел.
   • Отметьте флажком поле Создать пункт меню.
   • Выберите Меню и задайте Название пункта в соответствующих полях.
   • Установите флаг в поле Создать индексную страницу раздела, чтобы добавить в новую папку файл index.php. При открытии нового раздела сайта в браузере по умолчанию первой будет показана эта страница.
   • Выберите шаблон индексной страницы. В дистрибутив продукта включен шаблон страниц Стандартная страница, который применяется для всех страниц сайта и представляет собой текстовое сообщение Text here… без определённого стиля.
   • Установите флаг в поле перейти к редактированию, чтобы приступить к редактированию индексной страницы непосредственно после сохранения раздела.
   • Нажмите кнопку Сохранить.
4. Отредактируйте индексную страницу по своему усмотрению и сохраните внесенные изменения.

В результате будет создана папка (раздел), содержащая следующая файл index.php.

Публичная часть

Смотрите также:

© «Битрикс», 2001-2019, «1С-Битрикс», 2019

Наверх

dev.1c-bitrix.ru