Импорт из XML

Эта статья (тема) - для персонала IT вашей школы. Работа с данными XML требует базовых навыков программирования.

См. эту статью для более простого способа импортирования данных в программу Расписаний:
Импорт данных из буфера временной памяти компьютера (MS Excel)

Программа aSc Расписания может импортировать данные из файла "aSc Timetables XML"
Вы должны записать данные в этот формат. Здесь - пример файла импорта XML, который есть в программе:

c:TimeTables emplateImport SamplesXMLimport_basicdata.xml

Этот файл XML весьма прост и содержит импорт только главных исходных данных - классы, предметы, учителя и кабинеты.

Примечание: Чтобы создать новый файл расписания из данных XML, сначала создайте новое расписание и затем выберите "Файл - Импортировать - aSc Timetables XML".

Примечание: Вы должны заменить "MyApp" в первой строке на название программы, из которой Вы экспортировали данные (используйте только буквы и пробелы).

Возможно усовершенствовать этот импорт двумя способами:

1) Добавить новые колонки к существующим таблицам в файле XML
2) Добавить новые таблицы, чтобы импортировать некоторые другие данные (например уроки).

Добавление новых колонок в файл XML
Например, можно усовершенствовать импорт XML, чтобы импортировать руководителей классов.

В документации (см. линк внизу) Вы можете найти, что колонка для руководителей классов находится в таблице "классы", и называется "teacherid".
Надо добавить "teacherid" к списку колонок в атрибуте columns="id,name" ноды XML "classes".

Также для каждого класса мы должны добавить атрибут teacherid = "xxx" . Таким образом, файл XML мог быть примерно таким ( часть классов):

<classes options="" columns="id,name,teacherid">
<class id="1" name="5.A" short="5.A" teacherid="1"/>
<class id="2" name="5.B" short="5.B" teacherid="2"/>
</classes>

Так Вы можете усовершенствовать импорт любым числом нужных данных (например цвета учителей, пол, свободное время и т.п.). Полный список поддерживаемых колонок есть в документации.

Примечание: Также возможно импортировать до 3 полей, созданных пользователем, для учителей, классов, предметов и кабинетов. В этом случае надо добавить названия полей в атрибут options="". Пример:

<teachers options="customfield1:Email" columns="id,name,short">
<teacher id="1" name="Bacova" short="Bc" customfield1="bacova@myschool.net"/>
<teacher id="2" name="Belicova" short="Bl" customfield1="belicova@myschool.net"/>
<teacher id="3" name="Benkova" short="Be" customfield1="benkova@myschool.net"/>
</teachers>

Добавление новых таблиц в файл XML
Например, мы можем изменить файл XML для импорта уроков.

В документации (см. линк внизу) описано, что есть несколько таблиц для этой цели. Мы выберем таблицу "classsubjects" и импортируем предметы классов, их число в неделю и учителей. Мы должны добавить такую секцию в файл XML:

<classsubjects options="" columns="classid,subjectid,periodsperweek,teacherid">
<classsubject classid="1" subjectid="1" periodsperweek="5" teacherid="1"/>
<classsubject classid="1" subjectid="2" periodsperweek="3" teacherid="2"/>
<classsubject classid="2" subjectid="1" periodsperweek="5" teacherid="1"/>
<classsubject classid="2" subjectid="3" periodsperweek="4" teacherid="3"/>
</classsubjects>

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

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

Примечание: Если у Вас есть вопросы об импорте из XML, пожалуйста пишите нам в support@asc.sk

См. также: Экспорт в XML