Формування і передача даних

Дані формуються та відправляються на Веб-сервер в модулі „Розклад” програми АС Деканат починаючи з версії 2.4.4.6. Відправлення даних розкладу стає доступним після реєстрації (див. детальніше про процедуру реєстрації в файлі допомоги до програми: "Інтерфейс програми"-"Розклад"-"Веб-розклад").

Попередний перегляд переданих даних

Коли дані будуть завантажені на веб-сервіс, Ви зможете попередньо переглянути їх коректність на сайті, ввівши свій VUZ_ID на сторінці перевірки даних.

Вбудовування Веб-Розкладу у Веб-сайт

Для отримання свого VUZ_ID зверніться за адресою web_vuz@osvita.net. Його буде вислано на адресу, зазначену в договорі з Вашим навчальним закладом.

Для того, щоб швидко приступити до роботи достатньо лише вставити у шаблон Вашого веб-сайту наведений нижче код HTML. Наступні інструкції для налаштування опцій Веб-Розкладу вимагають мінімального знання Javascript.

Для підключення необхідно вставити HTML, що ініціалізує Веб-Розклад. Найкраще це робити у частині head Вашої сторінки.

<script type="text/javascript" src="//vnz.osvita.net/schedule-loader.ashx"></script>
<script type="text/javascript">
    var schedule = new ait.Schedule("#schedule_container", VUZ_ID);
</script>    

В тому місці веб-сайту, в якому необхідно вставити розклад, Ви розміщуєте блок, який вказано першим параметром, тобто:

<div id="schedule_container"></div>

Важливо зазначити, що блоком на сторінці, в який буде завантажено розклад може бути будь який вже існуючий у Вас на сайті блок. Тому в першому параметрі виклику Schedule замість "#schedule_container" можна вказати його CSS-селектор.

У другому параметрі, VUZ_ID, Ви вказуєте ідентифікатор Вашого навчального закладу (ціле число), який Вам буде повідомлено після передачі даних на веб-сервіс.

Для тестування вбудовування розкладу Ви можете скористатись тестовим VUZ_ID: 99999

Розклад співробітника

Для того, щоб Веб-Розклад було завантажено не як для студента, а як для співробітника, необхідно вказати опцію isEmployeeMode: true, наприклад таким чином:

<script type="text/javascript" src="//vnz.osvita.net/schedule-loader.ashx"></script>
<script type="text/javascript">
    var schedule = new ait.Schedule("#schedule_container", VUZ_ID, { isEmployeeMode: true });
</script>    

Опції налаштування

Як видно на попередньому прикладі, опції задаються за допомогою Javascript-об'єкту, що передається третім параметром виклику функції Розкладу.

Доступні наступні опції налаштування Веб-Розкладу:

  • isEmployeeMode, тип: Boolean
    Встановлення в true параметру виводить фільтри розкладу та сам розклад у режимі "для співробітника".
    Значення за замовченням: false
  • isRenderHeader, тип: Boolean
    Встановлення в true параметру виводить заголовок з текстом "Розклад" у верхній частині Веб-Розкладу. Встановіть значення false, якщо на Вашому сайті є власні заголовки на сторінках.
    Значення за замовченням: true
  • isForceTextStyles, тип: Boolean
    Встановлення в true параметру призводить до явного використання налаштувань шрифтів Веб-Розкладу - розміру та родини. Встановіть значення false, якщо хочете, щоб Веб-Розклад виводився в шрифтах, які задані на Вашому сайті. Використання значення false робить неможливим адаптацію "компактного" виду Розкладу, тобто при використанні Веб-Розкладу на сайті, на якому під нього виділено небагато місця (наприклад, 550-600px в ширину). Для таких випадків рекомендується встановити цей параметр в true та підібрати значення textFontSize.
    Значення за замовченням: true
  • textFontSize, тип: Number
    Використовується при встановленному в true параметрі isForceTextStyles. Регулює розмір шрифтів а також розмір елементів управління в Веб-Розкладі. Рекомендується змінювати значення на менше, якщо для Веб-Розкладу виділено недостатньо місця на сайті в ширину.
    Значення за замовченням: 13
  • isFullEmployeeName, тип: Boolean
    Встановлення в true параметру виводить імена викладачів в колонці "Викладач" в розкладах для студентів в повному вигляді, тобто не скорочуючи ініціали. При використанні значення false ініціали викладача скорочуються до однієї букви.
    Значення за замовченням: false
  • isRenderStudyTypeFilter, тип: Boolean
    Встановлення в true параметру додає фільтр "Тип занять", що відображається під вибором дат. Цим фільтром можна звузити вивід тільки занять одного типу (напр. "Лекції" або "Практичні заняття"). Параметр можна використовувати і в режимі розкладу "для студентів", і в режимі розкладу "для співробітників".
    Значення за замовченням: false
  • studyGroupId, тип: String
    Параметром можна зафіксувати вибір конкретної навчальної групи. Тобто буде завжди виводитися розклад тільки цієї групи, якщо Ви хочете мати окремі сторінки для розкладів фіксованих навчальних груп. При цьому не будуть виводитися фільтри "Факультет", "Форма навчання", "Курс" та власне "Навчальна група" (як непотрібні).
    Для того, щоб дізнатися значення studyGroupId конкретної навчальної групи, використайте звичайний розклад та при вибраній навчальній групі подивіться значення випадаючого списку групи через інструменти розробника у браузері. Для цього можна, наприклад, викликати у консолі schedule.$('.ait-schedlfind-sg').val(), де schedule — назва зміної розкладу, яку Ви задали при ініціалізації.
    Параметр використовується тільки в режимі розкладу "для студентів".
    Значення за замовченням: undefined

Приклади

Рекомендовані налаштування для сайту з невеликою кількістю місця для розкладу

<script type="text/javascript" src="//vnz.osvita.net/schedule-loader.ashx"></script>
<script type="text/javascript">
    var schedule = new ait.Schedule("#schedule_container", VUZ_ID, { textFontSize: 12 });
</script>    

Рекомендовані налаштування для сайту з власними стилями та заголовком розкладу

<script type="text/javascript" src="//vnz.osvita.net/schedule-loader.ashx"></script>
<script type="text/javascript">
    var schedule = new ait.Schedule("#schedule_container", VUZ_ID, 
        { isRenderHeader: false, isForceTextStyles: false });
</script>    

Підтримка браузерів

Веб-додаток розкладу коректно виконується в усіх сучасних браузерах (версії, випущені не раніше 2012 року). Окремо можна виділити, що не підтримуються версії Internet Explorer 6-8 та Opera Mini.

Веб-додаток може виконуватись як на сайті, що працює по протоколу http, так і в умовах захищеного протоколу https. Рекомендується посилання скрипта ініціалізації робити протоколо-незалежним, тобто починаючи з "//" (див. приклади).