Разные виды документации

• Онлайн документация для пользователей - описание интерфейса системы управления сайтом, ее основных модулей и наиболее типичных операций. Также в ней содержится полное описание прикладного программного интерфейса.
• Онлайн документация для разработчиков по старому ядру, по ядру D7 и по Rest_API. Предназначена для технических специалистов со знанием PHP и HTML. В ней содержатся сведения о технологиях и основных принципах, заложенных в систему, описание классов и функций по всем продуктам.

Учебные курсы

Онлайн Курсы - это методические пособия по работе с продуктом, которые включают в себя описание и примеры работы с системой.

Для изучения учебных материалов в оффлайне на индексной странице каждого курса размещаются [dw]ссылки на файлы[/dw][di][/di] формата Epub.

Контекстная справка

Контекстная справка выводит в Административной части системы информацию, относящуюся к открытому в данный момент разделу или странице. Доступна как в [ds]1С-Битрикс: Управление сайтом[/ds][di]Обилие справочной информации «1С-Битрикс: Управление сайтом» иной раз создаёт проблему: где искать ответ на свой вопрос? Для облегчения поиска иголки в стоге сена создана Контекстная помощь, доступная только в Административном разделе системы.

Подробнее ...[/di], так и в [ds]Битрикс24 в коробке[/ds][di]Для обучения работе в сервисе Битрикс24 создана специальная служба Поддержки24. К ней можно обратиться нажатием на кнопку со знаком вопроса в "шапке" сервиса...

Подробнее ...[/di].

Мастер магазина

FAQ - Частые вопросы

Частые вопросы - подборка решений наиболее часто встречающихся проблем при работе с продуктом в удобном представлении.

Всплывающие подсказки

Используются в тексте в следующих случаях:

• пояснить какой-то термин;
• дать наглядное представление о команде интерфейса;
• дать дополнительную, но не относящуюся напрямую к выполняемым работам, информацию;
• показать описание и ссылку на страницу компонента в пользовательской документации.

Всплывающие подсказки обозначаются пунктирным подчёркиванием: [dw]пример подсказки[/dw][di]В окне отображается подробное содержимое подсказки. Подсказка может состоять из текста и/или изображения.[/di].

Табы (вкладки)

Текст каждого урока разбит на табы. Другими словами их можно назвать тематическими вкладками. Это сделано с целью избавить читателя от прокрутки экрана и быстро перейти к нужной части урока. Если вам неудобно пользоваться вкладками, то [dw]отключите их[/dw][di][/di], тогда весь урок будет выводиться в виде единого длинного текста.

Спойлеры, скрывающие текст

В спойлерах размещается информация, которая имеет вторичное значение, но может быть полезна «для общего развития». Для открытия спойлера кликните на «+» в спойлере:

Чтобы избежать лишней прокрутки экрана, в спойлерах может быть размещена большая по объёму информация.

Выделение абзаца фоном

Форматирование целых абзацев текста используется для выделения какой-либо информации с целью указать её направленность:

• Определения каких-либо сущностей, явлений, терминов и так далее выводятся в абзацах такого вида:
  Курс – организованная и логически завершенная последовательность страниц, содержащих информацию о некоторой предметной области.

• В Примечании размещается информация, поясняющая текст на странице, на которую стоит обратить внимание. Это могут быть примеры, расширенное объяснение, уточнение, ссылка на дополнительную информацию. Например:
  Примечание: подробное описание формы создания и редактирования теста представлено в документации по продукту.

• Предупреждения – это информация, имеющая критическое значение для работы того или иного функционала продукта. Например:
  Важно! Если курс был деактивирован, то результаты тестов и сертификаты по этому курсу будут недоступны пользователям. Если курс был удален, то результаты тестов и сертификаты этого курса будут также удалены.

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

Форматирование текста

Виртуальная лаборатория

Ценностью тестовой виртуальной лаборатории bitrixlabs.ru является то, что всего за пару кликов у вас будет демосайт на основе «1С-Битрикс: Управление сайтом» в редакции Бизнес. Для создания сайта:

• нажмите кнопку [dw]Создать демо сайт[/dw][di][/di];
• придумайте логин и пароль;
• выберите решение (рекомендуем выбрать решение [dw]Интернет-магазин[/dw][di][/di], чтобы внешний вид сайта совпадал с изображениями на скриншотах курса);
• остальные настройки оставьте по умолчанию.

Ваш демосайт готов к использованию!

Отметим минусы этого варианта:

• сайт на виртуальной лаборатории «живёт» только 3 часа;
• количество лабораторий невелико и они, к сожалению, часто бывают заняты;
• невозможно ознакомиться с другими продуктами компании «1С-Битрикс», например, с коробочной версией «Битрикс24».

Виртуальная машина

Виртуальная машина позволяет установить локальную демоверсию любого продукта компании «1С-Битрикс» на срок до 30 дней. Потом машину можно удалить и поставить заново на очередные 30 дней, потеряв при этом, правда, свои наработки на старой машине.

Следуйте нашей инструкции и вы успешно установите локальную версию. Шаги несложные и сопровождаются наглядными иллюстрациями-всплывашками:

1. Скачайте [dw]VMware Player[/dw][di]VMware Player – программный продукт, позволяющий запускать несколько операционных систем одновременно на одном компьютере.
   
   Помимо VMware Player, вы можете использовать VM VirtualBox для настройки виртуальной машины. Инструкцию по установке в ней вы найдёте немного ниже, в спойлере.[/di] и установите его. Эта программа нужна нам для запуска виртуальной машины с демосайтом. Установка её несложна, просто следуйте шагам мастера установки (для учебных целей укажите бесплатную версию для [dw]НЕкоммерческого использования[/dw][di][/di]).
2. На странице со списком виртуальных машин скачайте [dw]дистрибутив[/dw][di][/di] нашей, уже настроенной, виртуальной машины BitrixVM.
3. Загруженный архив [dw]распакуйте[/dw][di]Такие файлы Вы увидите в папке после распаковки архива:
   [/di] в любую, удобную вам, папку. (Например, в папку на диске С: С:\BitrixVM\).
4. Запустите программу VMware Player и добавьте виртуальную машину BitrixVM, нажав [dw]Open a virtual machine[/dw][di][/di] и выбрав единственный доступный [dw]файл[/dw][di][/di] из папки, в которую был распакован архив.
5. Запустите виртуальную машину с помощью кнопки [dw]Power on[/dw][di][/di]. По окончании загрузки операционной системы отобразится общая информация. Для вас важен IP-адрес, который присваивается автоматически и выводится в поле [dw]bitrix url[/dw][di][/di] (пример адреса: 192.168.1.36). Запомните его.
6. В адресной строке вашего любимого браузера (Chrome, Firefox или любой другой) введите этот адрес. Откроется [dw]окно установки[/dw][di][/di]. Нажмите кнопку Установить.
7. Выберите [dw]демонстрационную версию[/dw][di][/di] нужного вам дистрибутива продуктов компании «1С-Битрикс». Для обучения на наших курсах в большинстве случаев вам подойдет «1С-Битрикс: Управление сайтом» в редакции Бизнес. Если по какой-либо причине вас интересует другая редакция, можете выбрать её.
8. Начнется [dw]загрузка дистрибутива[/dw][di][/di]. Дождитесь её окончания и появится мастер установки решения.
9. Следуйте шагам мастера. Тут нет ничего сложного, только настройки вашего сайта (например, название магазина, реквизиты, логин и пароль администратора и т.д.). Если нужно, то более подробное описание каждого шага мастера есть в примере установки решения: Интернет-магазин.

Установка завершена! Теперь у Вас есть 30 дней на использование демоверсии.

Что дальше?

Начинайте обучение работе с «1С-Битрикс: Управление сайтом». Не забудьте, что для работы с демосайтом в таком варианте вам всегда нужно сначала запускать VMware Player и виртуальную машину (п. 5 инструкции), и только потом открывать сайт по его IP-адресу.

Возможные проблемы и их решение

Информацию об ошибках и способы их решения при установке демоверсии в BitrixVM смотрите в соответствующем уроке учебного курса Виртуальная машина BitrixVM.

  Скрипт BitrixSetup

Скрипт BitrixSetup позволяет устанавливать продукты компании «1С-Битрикс» на хостинг. У многих хостинг-провайдеров имеется бесплатный тестовый период, что удобно для обучения и практики.

Посмотрите видео и вы научитесь устанавливать пробную версию «1С-Битрикс: Управление сайтом» в редакции Бизнес.

   Как узнать, какая редакция сейчас у вас?

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

Чтобы узнать, какая редакция 1С-Битрикс установлена у вас, достаточно перейти [ds]в административном разделе[/ds][di] Административный раздел – часть сайта, где производится
управление модулями системы, структурой сайта, его содержанием, посетителями и
другими составляющими сайта. Недоступен для просмотра обычным посетителям сайта.

Для перехода в Административный раздел служит закладка Администрирование,
расположенная на Панели управления в Публичном разделе сайта.

Подробнее...[/di] сайта на страницу Обновление платформы (Marketplace > Обновление платформы) во вкладку [dw]Установка обновлений[/dw][di] [/di]:

   Информация о редакциях в уроках

Для вашего удобства мы указываем в уроках ограничения по редакциям (т.е. в каких редакциях недоступен описываемый в уроке функционал):

  Как узнать текущую версию продукта?

Когда в уроках упоминается «версия продукта» (без указания конкретного модуля), то имеется в виду версия Главного модуля.

Версию продукта (т.е. версию Главного модуля) можно определить несколькими способами:

• прокрутив в административной панели любую страницу до конца:

  

• на странице Модули (Настройки > Настройки продукта > Модули):

  

  Примечание. На этой странице можно посмотреть текущие версии всех модулей, установленных в системе.

• с помощью предустановленного [ds]гаджета на Рабочем столе[/ds][di] Гаджеты в продуктах «1С-Битрикс: Управление сайтом» – это особые программные элементы, выполняющие функции уведомления и быстрого перехода к различным элементам управления и настройки системы и её элементов. С помощью гаджетов на Рабочем столе может быть представлена самая разнообразная информация.
  
  Подробнее...[/di]:

  

  Сравнение редакций «1С-Битрикс: Управление сайтом»

Ниже сравниваются возможности всех редакций продукта [ds]«1С-Битрикс: Управление сайтом»[/ds][di] «1С-Битрикс: Управление сайтом» – профессиональная система управления сайтами и интернет-магазинами.

Подробнее... [/di] по следующим категориям: CMS, Интернет-магазин, Маркетинг, Производительность, Безопасность и мобильность. Для просмотра таблицы сравнения кликните по значку справа от названия выбранной категории.

  Запуск тестирования

Для запуска А/В тестирования произведите настройки в пункте административного меню Маркетинг > A/B тестирование. Для этого выберите Изменить в меню действий списка тестов. Если же вы впервые запускаете тестирование, то попадете в настройки автоматически при выборе опции Запустить в меню действий или при нажатии на кнопку Запустить в строке с тестом:

  Форма настроек

Форма настроек тестирования выглядит следующим образом:

Поясним некоторые поля:

• Сайт - выберите сайт, для которого запускается тестирование.
• Длительность теста - выберите время, в течение которого будет производиться тестирование. Можно указать точное количество недель или дней, либо выбрать опцию До ручной остановки теста. В таком случае тестирование будет продолжаться, пока пользователь самостоятельно его не остановит.
• Трафик на тест - укажите процент пользователей, которые участвуют в тестировании. Эта цифра означает общее количество пользователей, участвующих в тестировании. Половина от трафика будет направлена на текущий дизайн, а половина - на новый. Если указано 30%, то новый дизайн увидят только 15%.

• Тесты - два варианта страницы или шаблона сайта, которые будут сравниваться друг с другом. Вариант А - это то, что видят все посетители сайта на данный момент, вариант В - то, что будет тестироваться.

  Если будет проводиться сравнение двух шаблонов сайта, то в открывающемся списке нужно указать сравниваемые шаблоны. Шаблоны будут применены ко всему сайту. Если в одном А/В тестировании есть несколько тестов, направленных на сравнение шаблонов, то проверяться будут условия только первого теста.

  Напоминаем: для того, чтобы изменить внешний вид одной из страниц многостраничного (комплексного) компонента, следует менять его шаблон.

  Если же сравниваются страницы, то в варианте А можно либо выбрать соответствующий файл в системе сайта, либо указать адрес нынешней страницы. Далее можно [dw]скопировать[/dw][di] [/di] содержимое этой страницы в пункт B и внести необходимые изменения, либо же просто в пункте B указать адрес новой страницы. У каждого из вариантов есть кнопка Посмотреть, позволяющая увидеть внешний вид страницы для каждой группы.

  Также можно добавлять дополнительные тесты по нажатии на кнопку Добавить тест.

При нажатии кнопки Сохранить настройки теста будут сохранены и тестирование можно будет запустить.

  Работа в публичном разделе

После того, как тест запущен, появится возможность переключаться между вариантами А и В прямо из панели управления в публичном разделе сайта. Так можно понять, что видят посетители сайта, принадлежащие к каждой из тестируемых групп.

  Документация по теме

• Список A/B-тестов;
• Создание и редактирование A/B-теста.
• Создание физических страниц.
• Разработка шаблона дизайна.

Видеоурок

Как мы выяснили [ds]ранее[/ds][di] Тесты – два варианта страницы или шаблона сайта, которые будут сравниваться друг с другом. Вариант А – это то, что видят все посетители сайта на данный момент, вариант В – то, что будет тестироваться.

Одновременно может быть запущено только одно А/В тестирование, но в рамках него может быть добавлено несколько тестов.

Подробнее...[/di], одновременно может быть запущено только одно А/В-тестирование. Однако в рамках этого тестирования можно добавить несколько тестов. Рассмотрим на примере, как создать и запустить A/B-тестирование с тестами для двух страниц:

• страница Новости – для варианта B скопируем эту страницу и поменяем шаблон компонента, выводящего новости;
• страница О магазине – пусть в варианте B вместо этой страницы показывается страница Контакты.

  Общие параметры теста

На странице Маркетинг > A/B-тестирование добавим [dw]новый тест.[/dw][di] [/di] В открывшейся форме заполним параметры теста:

• Сайт – выбираем сайт, для которого хотим запустить тестирование;
• Длительность теста – выбираем опцию До ручной остановки теста (чтобы тест проводился до тех пор, пока мы сами не заходим его остановить);
• Трафик на тест – выбираем процент всех пользователей сайта, которые будут участвовать в тестировании. В нашем тесте укажем 100%, т.е. в тестировании участвуют все пользователи: половина из них увидит старые версии страниц (вариант A), а половина – новые (вариант B).

  Тест #1 (страница Новости)

Нажимаем кнопку Добавить тест и выбираем пункт [dw]Страница[/dw][di] [/di]:

1 В блоке A прописываем URL тестируемой страницы Новости /news/index.php (либо можно нажать кнопку и [dw]выбрать страницу[/dw][di] [/di] из структуры сайта).

2 Нажимаем кнопку Скопировать страницу. После этого действия в директории /bitrix/abtest автоматически будет создана страница-дубль 3 (блок B), которая полностью будет повторять содержимое страницы, указанной в блоке A.

4 Нажимаем кнопку Редактировать страницу и переходим в форму редактирования:

Дважды кликаем по размещенному на этой странице компоненту [comp include_62967]Новости[/comp] и в [dw]настройках компонента[/dw][di] [/di] меняем текущий шаблон bootstrap_v4 на .default. Сохраняем все внесенные на этой странице изменения.

Возвращаемся в форму создания теста и нажимаем кнопку [dw]Применить[/dw][di] [/di] – наши изменения сохранились, и при этом мы остались в форме редактирования теста. С помощью появившейся кнопки [dw]Посмотреть[/dw][di]
[/di] можно оценить внешний вид страниц (текущей страницы из блока A и изменённой в блоке B).

На этом настройка Теста #1 окончена.

  Тест #2 (страница О магазине)

Тест #2 добавляем аналогично Тесту #1 (нажимаем кнопку Добавить тест и выбираем пункт [dw]Страница[/dw][di] [/di]):

В блоке A прописываем URL тестируемой страницы О магазине /about/index.php (либо можно нажать кнопку и [dw]выбрать страницу[/dw][di] [/di] из структуры сайта).

В блоке B прописываем URL страницы /about/contacts/index.php, которую мы хотим во время тестирования подставлять вместо страницы /about/index.php (либо добавляем из структуры сайта).

Нажимаем кнопку [dw]Применить[/dw][di] [/di] – наши изменения сохранились, и при этом мы остались в форме редактирования теста. С помощью появившейся кнопки [dw]Посмотреть[/dw][di]
[/di] можно оценить внешний вид страниц (текущей страницы из блока A и новой в блоке B).

На этом настройка Теста #2 окончена.

  Результат

В результате у нас создан один A/B-тест, состоящий из двух тестов страниц:

Сохраняем внесенные изменения. Созданный A/B-тест был добавлен в общий список тестов, и теперь его можно запустить:

Далее переходим в публичный раздел сайта, открываем тестируемые страницы Новости и О магазине и с помощью кнопки A/B-тест смотрим, как эти страницы будут отображаться для пользователей из группы B:

  Практические задания

Практические задания состоят из вопроса, скриншота или видео с конечным результатом и объяснением, как это получить в спойлере. Не торопитесь подглядывать в спойлер.

1. Создайте новый A/B-тест:
   • В тесте необходимо сравнить текущий шаблон ("Адаптивный шаблон интернет-магазина") этой страницы с новым шаблоном (например, с шаблоном "Прохождение курса обучения")
   • Длительность теста: неделя
   • На каждый дизайн должно попадать по 25% от общего количества посетителей сайта

   Решение
   Задание составлено по материалам урока: Настройки и запуск тестирования. Результат: 1 Задаём Длительность теста (неделя), а Трафик на тест устанавливаем 50% (на новый и старый дизайны будет направлено по 25% от общего числа посетителей сайта); 2 Так как цель теста - проверить дизайн, то указываем проверяемые шаблоны.

2. Запустите созданный A/B-тест и перейдите на страницу О магазине. Посмотрите, как будет выглядеть эта страница для обеих групп пользователей, участвующих в тестировании.

   Решение
   Задание составлено по материалам урока: Настройки и запуск тестирования. Результат:

Где выполнять задания?

Их можно выполнять:

1. на тестовой виртуальной лаборатории bitrixlabs.ru предоставленной компанией «1С-Битрикс»
либо
2. на установленной на локальный компьютер пробной версии «1С-Битрикс: Управление сайтом».

Подробная информация о настройке каждого варианта представлена в уроке Где практиковаться и выполнять задания.

  Что может модуль LDAP

AD/LDAP модуль реализован с учетом особенностей работы протоколов [dw]LDAP[/dw][di]LDAP (англ. Lightweight Directory Access Protocol - протокол прикладного уровня для доступа к службе каталогов X.500, разработанный IETF, относительно простой протокол, использующий TCP/IP и позволяющий производить операции аутентификации (bind), поиска (search) и сравнения (compare), а также операции добавления, изменения или удаления записей.[/di] и [dw]AD[/dw][di]Active Directory («Активный каталог», AD) - службы каталогов корпорации Microsoft для операционных систем семейства Windows Server.[/di], один из которых должен быть установлен на корпоративном сервере.

В основе работы перечисленных протоколов лежит принцип хранения информации в виде записей, обладающих набором атрибутов и хранящихся в базе данных с древовидной иерархической структурой. Таким образом, при настройке на сервере локальной вычислительной сети LDAP или AD протокола информация о группах пользователей будет представляться в следующем виде:

Используя данную структуру хранения данных, модуль AD/LDAP позволяет настраивать соответствие групп пользователей корпоративной сети группам пользователей Bitrix Framework.

Модуль позволяет подключаться к нескольким AD. Обращение к AD серверу происходит при каждой авторизации пользователя, либо при импорте пользователей.

  Таблица соответствий

Соответствие групп пользователей задается в специальной таблице соответствий в административном разделе Bitrix Framework. При этом возможно несовпадение имен групп пользователей Bitrix Framework с именами групп пользователей корпоративной сети. Например, группе пользователей корпоративной сети Techsupport, к которой относятся сотрудники технической поддержки корпоративной сети, может быть поставлена в соответствие группа пользователей Techsupport stuff, созданная в Bitrix Framework. В результате сотрудники службы технической поддержки корпоративной сети смогут выполнять обязанности сотрудников службы технической поддержки Bitrix Framework.

Группы пользователей внутри компании обладают правами на доступ к определенным ресурсам корпоративной сети, а сопоставленные им группы пользователей в Bitrix Framework обладают правами на доступ к ресурсам продукта «1С-Битрикс». Например, группа пользователей Techsupport наделена правами на доступ к почтовому серверу сети, а группа пользователей Bitrix Framework Techsupport stuff обладает правами на доступ к модулю Техническая поддержка.

В соответствии с приведенным выше примером, пользователь, относящийся к группе Techsupport корпоративной сети, при попытке авторизации в системе Bitrix Framework будет добавлен в группу пользователей Techsupport stuff системы Bitrix Framework. После чего в системе автоматически будет заведен аккаунт данного пользователя, на основе данных, хранящихся на корпоративном сервере.

  Пользователь в нескольких группах

Допустима привязка пользователя к одной, двум или более группам. В системе могут быть настроены группы пользователей, для которых не установлено соответствие с группами пользователей в корпоративной сети. Принадлежность пользователей к такой группе задается вручную администратором системы. Все изменения аккаунта пользователя на корпоративном сервере будут автоматически учтены в аккаунте пользователя в системе Bitrix Framework во время его следующей авторизации. При этом изменения затронут пользователей только тех групп, для которых задано соответствие группам пользователей корпоративной сети.

  Итак:

Модуль AD/LDAP позволяет:

• интегрировать проекты, созданные на Bitrix Framework в корпоративную сеть;
• [ds]Импортировать пользователей[/ds][di]Для добавления целого списка пользователей в систему служит специальная страница административного раздела Импорт пользователей (Настройки > Пользователи > Импорт пользователей). Для импорта пользователей из Active Directory / LDAP выполните следующее:
  
  Подробнее ...[/di] корпоративной сети в продукты Bitrix Framework;
• настроить соответствие групп пользователей корпоративной сети и групп пользователей Bitrix Framework;
• автоматически создавать аккаунт пользователя после его регистрации исходя из таблицы соответствий (данные для создания аккаунта запрашиваются из базы данных корпоративного сервера);
• централизованно управлять изменениями аккаунтами пользователей системы через корпоративный сервер.

Модуль AD/LDAP интеграция так же позволяет использовать [dw]NTLM авторизацию[/dw][di]NTLM (NT LAN Manager) - протокол сетевой аутентификации, разработанным фирмой Microsoft для Windows NT[/di]. Чтобы ею воспользоваться, нужен веб-сервер IIS или Apache с модулем mod_ntlm или mod_auth_sspi.

  Кто есть кто в иерархии компании

Необходимо специальным образом определить на AD-сервере принадлежность пользователей к подразделениям, иерархию подразделений компании, а также начальников подразделений. При импорте пользователей в продукты «1С-Битрикс», эта структура также может быть импортирована, при этом пользователям сразу назначаются нужные подразделения. Также, что более просто, можно задать одно фиксированное подразделение всем пользователям из AD.

Для задания структуры компании в AD используются всего 2 специальных [dw]атрибута пользователя[/dw][di]Свойства, в которых передаются начальник подразделения и наименование подразделения, определяются в настройках сервера на закладке Настройка полей. По умолчанию это department и manager.[/di]:

• department - символьное наименование подразделения, к которому относится данный пользователь.
• manager - DN (Distinguished name, уникальный идентификатор в AD) пользователя, являющегося начальником данного пользователя.

На основании этой связи и строится иерархия компании:

• Если начальник находится в другом подразделении, то это определяет связь между подразделениями: подразделение manager'а считается вышестоящим над данным. При этом текущий пользователь будет считаться начальником своего подразделения.
• Если manager - в том же подразделении, то никаких дополнительных действий предпринято не будет, и это единственный способ явно указать, что пользователь сам не является начальником подразделения. Из чего можно сделать вывод, что для всех подчиненных в подразделении должен быть задан начальник из него же.
• Если у пользователя не задано подразделение, но задан начальник, он считается принадлежащим тому же подразделению, что и начальник. Для начальника будут также действовать все те же правила и умолчания, так что такие "умолчательные" определения могут выстроиться в последовательную цепочку.
• Если задано подразделение, но нет начальника - данное подразделение попадает в корень структуры компании, и пользователь сам будет его начальником.
• Если же у пользователя нет ни подразделения, ни начальника, ему будет присвоено подразделение по умолчанию, задаваемое в настройках модуля.

  Пример

Допустим, у нас существует следующая структура:

- Отдел 1
-- Начальник 1
-- Сотрудник 1
-- Отдел 2
   -- Начальник 2
   -- Сотрудник 2

Чтобы построилась такая иерархия, нужно чтобы у всех сотрудников корректно были заданы подразделения, в которых они работают (в атрибуте department), а также, чтобы у обоих сотрудников в поле manager был указан их непосредственный начальник (Начальник 1 и Начальник 2 соответственно). И самый важный момент, у Начальник 2 в атрибуте manager должен быть указан Начальник 1.

  Для Centos 6

1. Загрузите модуль mod_auth_sspi и установите его:

   LoadModule sspi_auth_module modules/mod_auth_sspi.so

2. В файле httpd.conf добавьте строку:

   LoadModule sspi_auth_module modules/mod_auth_sspi.so.

3. В файле .htaccess добавьте следующие строки:

   AuthName "My Intranet"
   AuthType SSPI
   SSPIAuth On
   SSPIPackage NTLM
   SSPIDomain MYDOMAIN
   SSPIPerRequestAuth On 
   SSPIAuthoritative On
   SSPIOfferBasic On
   Require valid-user
   

   При использовании стандартного пакета Битрикс: Веб-окружение указанные строчки в этом файле необходимо не создавать, а раскомментировать.

  Для Centos 7

1. Загрузите модуль auth_ntlm_winbind_module и установите его:

   
     LoadModule auth_ntlm_winbind_module modules/mod_auth_ntlm_winbind.so
   

2. Для SSL обязательно добавьте:

   
     LoadModule ssl_module modules/mod_ssl.so
     # httpd 2.4
     LoadModule socache_shmcb_module modules/mod_socache_shmcb.so

  Для всех видов установки

1. В строке SSPIDomain MYDOMAIN файла .htaccess смените MYDOMAIN на имя вашего домена.
2. Сохраните внесенные изменения.

  Как настроить NTLM для Linux вне BitrixVM

Если вы не используете Виртуальную машину BitrixVM или Linux (BitrixEnv), то вам необходимо настроить ваше окружение для работы с модулем AD/LDAP "1С-Битрикс: Управление сайтом" или "Битрикс24 в коробке". Для этого вам нужно выполнить действия:

1. Добавить хост в домен. (Описания не будет, если вы работаете на собственном окружении, вы знаете как это сделать.)
2. Задать [ds]настройки сервера[/ds][di]Поддержка NTLM-авторизации по умолчанию включена в дистрибутив продукта. Если вы не используете рекомендуемый компанией "1С-Битрикс" пакет, то вам необходимо сделать следующее...
   
   Подробнее ...[/di] Apache под выбранный сайт.
3. Произвести настройки NTLM модуля вашего окружения.
4. Произвести настройки "1С-Битрикс: Управление сайтом".

Если хост уже находится в домене, и на нем находится несколько сайтов, то создайте настройки Apache сервера для сайтов, у которых не включена авторизация в домене.

  Настройка NTLM авторизации

Для настройки NTLM необходимо задать в настройках вашего окружения следующую информацию:

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

Теперь переходите к [ds]настройкам NTLM[/ds][di]Пошаговая настройка. Зарегистрируйте в системе AD/LDAP-сервер...

Подробнее ...[/di] со стороны "1С-Битрикс: Управление сайтом".

  Internet Explorer

Для успешной NTLM авторизации нужно, чтобы веб-сервер находился в зоне Local Intranet.

  Mozilla Firefox

Добавить веб-сервер к списку доверенных URI для автоматической NTLM-авторизации (через параметр network.automatic-ntlm-auth.trusted-uris на странице about:config)

  Настройка

Настройка Highload-блоков выполняется в административном интерфейсе и заключается в следующем:

• создается Highload-блок и определяется таблица, в которой будут храниться его данные;
• настраиваются поля Highload-блока, которые являются пользовательскими свойствами ядра;
• добавляется необходимое число записей в Highload-блок.

Рассмотрим процесс работы с Highload-блоками на примере создания справочника рецептов тортов.

  Создание

Перейдите на страницу Контент > Highload-блоки и нажмите кнопку Добавить Highload-блок. Откроется форма:

Заполните поля на закладке Highload-блок:

• В поле Название сущности задайте название Highload-блока. Название должно начинаться с заглавной буквы и состоять только из латинских букв и цифр.
• В поле Название таблицы в БД укажите название таблицы, в которой будет храниться новый Highload-блок. Название таблицы должно состоять только из строчных латинских букв, цифр и знака подчеркивания.
• Укажите удобные для вас языкозависимые названия Highload-блока.

На закладке Права доступа настройте доступ для пользователей и групп пользователей к Highload-блоку. Выбор необходимых групп или пользователей осуществляется по ссылке Добавить:

Сохраните новый Highload-блок.

  Создание полей сущности

Для добавления полей в Highload-блок перейдите на страницу со списком его полей одним из способов:

• со страницы со списком Highload-блоков выбрать в меню действий необходимого блока пункт [dw]Список полей[/dw][di][/di];
• в форме редактирования нажать на [dw]ссылку с количеством полей[/dw][di][/di] сущности.

В любом случае откроется страница [comp include_userfield_admin]Пользовательские поля[/comp] с установленным фильтром по объекту HLBLOCK_<ID_блока>, где <ID_блока> - это идентификатор Highload-блока, для которого необходимо добавить поля. Тип поля выбирается из [dw]выпадающего списка[/dw][di][/di].

С помощью расположенной на контекстной панели кнопки Добавить создайте необходимые поля для Highload-блока.

Для нашего примера добавим следующие поля: Название торта (UF_NAME) типа Строка, Фото (UF_PHOTO) типа Файл, Время приготовления (UF_TIME) типа Список и Рецепт (UF_RECIPE) типа Файл:

  Создание записей сущности

Чтобы добавить запись в Highload-блок, перейдите на страницу со списком его записей (Контент > Highload-блоки > [языковое_название_Highload-блока], в нашем примере это Рецепты тортов) и нажмите кнопку Добавить запись. Откроется форма с набором созданных полей Highload-блока:

Заполните поля и сохраните запись. Аналогичным образом добавьте необходимое количество записей.

  Документация по теме

• Создание и редактирование Highload-блока

  Шаг 1. Страница Экспорт Highload-блока

Откройте страницу Экспорт Highload-блока (Контент > Highload-блоки > Экспорт/импорт > Экспорт):

  Шаг 2. Параметры выгрузки

Задайте параметры выгрузки:

• Файл для экспорта – укажите путь относительно корня сайта к файлу и сам XML-файл, в который будет выгружена информация из Highload-блока. Чтобы создать новый файл, укажите произвольное название в формате <имя_файла_экспорта>.xml – этот файл будет создан в процессе выгрузки.
• Highload-блок – выберите Highload-блок для экспорта.
• Экспортировать структуру – отметьте опцию для выгрузки структуры Highload-блока: его названия, перечня полей, названия таблицы в базе данных.
• Экспортировать данные – отметьте для выгрузки записей Highload-блока. Файлы при этом выгружаются в папку с названием <имя_файла_экспорта>_files. Она размещается внутри той же папки, где и файл экспорта.

  Шаг 3. Экспорт

Нажмите кнопку Экспортировать. Начинается экспорт Highload-блока, и над формой отображается ход процесса выгрузки. По окончании на странице выводится соответствующее сообщение:

Итак, скачайте файлы и используйте информацию из Highload-блока по своему усмотрению.

  Файл для добавления данных в существующий Highload-блок

• Сделайте [dw]экспорт[/dw][di]
  Подробнее...[/di] данного Highload-блока без выгрузки структуры (не отмечайте опцию Экспортировать структуру).
• Скачайте XML-файл.
• Заполните новые значения в тегах <item>...</item>. Например, в файле описание записи выглядит так:

  		<item>
  			<uf_name>Синяя джинса</uf_name>
  			<uf_file>blue_jeans.jpg</uf_file>
  			<uf_link />
  			<uf_sort>1300</uf_sort>
  			<uf_def>0</uf_def>
  			<uf_xml_id>jeans</uf_xml_id>
  		</item>
  

  Тогда в Highload-блоке запись имеет вид:

  

• Сохраните файл и используйте его для процедуры импорта.

  Файл для добавления нового Highload-блока

• Сделайте [dw]экспорт[/dw][di]
  Подробнее...[/di] любого Highload-блока обязательно вместе со структурой.
• Скачайте XML-файл и откройте его на редактирование:
• Задайте названия для сущности и для ее таблицы в базе данных:

  	<hiblock>
  		<name>Myhighloadblock</name>
  		<table_name>b_my_highload_block</table_name>
  	</hiblock>
  

• Укажите языкозависимые названия:

  	<langs>
  		<lang>
  			<lid>ru</lid>
  			<name>Мой highload-блок</name>
  		</lang>
  	</langs>
  

• Следующая часть файла - это блок с описанием полей Highload-блока, заключенный в теги <fields>...</fields>. Опишите каждое поле в <field>...</field>:

          <field>
              <field_name>UF_NAME</field_name>
              <user_type_id>string</user_type_id>
              <sort>100</sort>
              <multiple>N</multiple>
              <mandatory>N</mandatory>
              <show_filter>Y</show_filter>
              <show_in_list>Y</show_in_list>
              <edit_in_list>Y</edit_in_list>
              <is_searchable>Y</is_searchable>
              <settings>
                  <size>20</size>
                  <rows>1</rows>
                  <regexp />
                  <min_length>0</min_length>
                  <max_length>0</max_length>
                  <default_value />
              </settings>
              <edit_form_label>
                  <ru>Название торта</ru>
              </edit_form_label>
              <list_column_label>
                  <ru>Название торта</ru>
              </list_column_label>
              <list_filter_label>
                  <ru>Название торта</ru>
              </list_filter_label>
              <error_message>
                  <ru />
              </error_message>
              <help_message>
                  <ru />
              </help_message>
          </field>
  

  Параметры поля должны быть составлены так, как это требуют [dw]пользовательские поля[/dw][di][/di].
• После описания полей идет блок с записями - <items>...</items>. Опишите каждую запись в <item>...</item>. Используйте только те поля, которые вы перечислили в предыдущем блоке <fields>...</fields>. Например:

  		<item>
              <uf_name>Наполеон</uf_name>
          </item>
  

• Сохраните файл и используйте его для процедуры импорта.

Видеоурок

   Как добавить данные в Highload-блок

Рассмотрим на примере. Представьте, что у вас есть Highload-блок ColorReference. Он представляет собой справочник цветов и содержит уже некоторое количество записей:

Добавим в него несколько новых записей, а одну запись обновим. Структуру самого Highload-блока изменять не будем.

• Шаг 1. Подготовьте изображения и файл color.xml с данными:

  <?xml version="1.0" encoding="UTF-8"?>
  <hiblock>
  	<items>
  		<item>
  			<uf_name>Ярко-желтый</uf_name>
  			<uf_file>yellow.png</uf_file>
  			<uf_sort>1500</uf_sort>
  			<uf_xml_id>yellow</uf_xml_id>
  		</item>
  		<item>
  			<uf_name>Серый</uf_name>
  			<uf_file>grey.png</uf_file>
  			<uf_sort>1600</uf_sort>
  			<uf_xml_id>grey</uf_xml_id>
  		</item>
  		<item>
  			<uf_name>Коралловый</uf_name>
  			<uf_file>coral.png</uf_file>
  			<uf_sort>1700</uf_sort>
  			<uf_xml_id>coral</uf_xml_id>
  		</item>
  		<item>
  			<uf_name>Оливковый</uf_name>
  			<uf_file>olive.png</uf_file>
  			<uf_sort>1800</uf_sort>
  			<uf_xml_id>olive</uf_xml_id>
  		</item>
  		<item>
  			<uf_name>Розовый</uf_name>
  			<uf_file>rose.png</uf_file>
  			<uf_sort>1900</uf_sort>
  			<uf_xml_id>rose</uf_xml_id>
  		</item>
  		<item>
  			<uf_name>Лазурный</uf_name>
  			<uf_file>azure.png</uf_file>
  			<uf_sort>2000</uf_sort>
  			<uf_xml_id>azure</uf_xml_id>
  		</item>
  	</items>
  </hiblock>
  

• Шаг 2. Загрузите на сайт файл color.xml, скажем, в папку upload. Изображения загрузите в каталог /upload/color_files/.
  Примечание: изображения (любые другие файлы) обязательно должны располагаться в папке с названием <имя_файла_экспорта>_files. Она размещается внутри той же папки, где и файл экспорта.

• Шаг 3. Откройте страницу импорта данных в Highload-блок (Контент > Highload-блоки > Экспорт/импорт > Импорт):
  
  
• Шаг 4. Укажите параметры импорта:
  • В поле Файл для импорта укажите наш файл color.xml.
    
    
  • В поле Highload-блок выберите ColorReference.
  • В нашем примере записи Highload-блока считаются уникальными по внешнему коду. Следовательно, в параметре Поле внешнего ключа выберите значение XML_ID.
    
    Если внешний код из файла совпадет с кодом для существующей записи Highload-блока, то параметры записи будут обновлены в соответствии со значениями в файле.
  • Флаг с опции Импортировать структуру обязательно должен быть снят. Отмечена должна быть только опция Импортировать данные.
  • Опцию Сохранять связи со сторонними сущностями рекомендуется также отметить. Тогда при импорте Highload-блока будут сохранены связи со сторонними сущностями – например, с элементами инфоблока, к которым эти цвета уже привязаны. В противном случае связи будут сброшены.
• Шаг 5. Запустите процесс импорта. По окончании вы увидите [dw]специальное сообщение[/dw][di][/di].
• Шаг 6. Оцените результат импорта. Откройте страницу с записями Highload-блока ColorReference.

  

  Новые записи добавились. При этом обратите внимание, что у нас теперь 2 розовых цвета. Старый розовой цвет не обновился, потому что у него отличается внешний код от кода нового розового цвета. А вот голубой цвет изменил название на лазурный, поскольку у него такой же внешний код, как и у лазурного цвета - azure.