Upgrade Web APIs and schemata

[izumin5210]

📄 API document (staging)

TODO

• access token（現状だとそもそもoauthいらない？）
• lectures from the class
• lectures from the lecturer
• lecturers
• reschedulings from the class
• reschedulings from the lecturer

[izumin5210]

from: #6

[izumin5210]

@ismail-a

時間割XMLに有効期間をつけてみる案です．
アプリ側では授業変更について，この期間を超えていても表示されるように調整しておく予定です．

<Common>
  <Institution>Akashi National College of Technology</Institution>
  <AcademicYear>2014</AcademicYear>
  <AcademicTerm>後期</AcademicTerm>
  <StartedOn>2014-10-01</StartedOn>
  <EndedOn>2015-04-01</endedOn>
</Common>

[ismail-a]

@izumin5210
時間割XMLのスキーマ案（変更後）ってどこかにありますか？
色々と変更・追加したい内容は#6で議論していましたが、まとまったやつが見つからない・・・

[ismail-a]

@izumin5210 @yamasy1549

とりあえず、#6の議論を追ってみて、学務システムのxlsファイルから新フォーマットのXMLを自動生成するスクリプトを作成しました。
出力結果を以下に置いておきます。
http://ubi-www.akashi.ac.jp/~ismail/tmp/timetable201504.xml

電気の4、5年のデータが何故かxlsファイルにないので、明日にでも教務係に確認します。
いくらか気になる点があるけど、対応しようとすると手入力が必要になって大変なのでこれくらいにしておきたいです。
・使用教室の情報が学務システムに入っていない
・教員名が姓しか入っていない
・男子体育と女子体育は学務システムのデータ上では科目名に区別がない
　・女子体育は科目IDの末尾に"B"という文字が入っているので機械的にSpecialTargetを指定できた
　・一応例外処理で科目名の区別はできます
・留学生科目であることを判別するデータがないので「日本語」を例外的に対応

他、何か抜けている点があったらいってください。

[izumin5210]

@ismail-a
確認しました
ありがとうございます！