RDFカレンダー：イベント情報の公開と活用

iCalendarオブジェクトとコンポーネント

The base of iCalendar data is the iCalendar object (VCALENDAR), which contains several components such as VEVENT or VTIMEZONE. Each of them starts with BEGIN:name line, and ends with END:name line.

iCalendarは、カレンダー全体をひとつのiCalendarオブジェクトとして構成し、その中にイベント情報などのコンポーネントをいくつか持つという形になっています。iCalendarオブジェクトはVCALENDAR、コンポーネントは例えばイベント情報ならVEVENTという名前が与えられ、それぞれのセクションをBEGIN:、END:に名前を続けた行で囲みます。

BEGIN:VCALENDAR
...
BEGIN:VEVENT
...
END:VEVENT
...
END:VCALENDAR

iCalendarオブジェクトの中には複数のコンポーネントを埋め込むことができます。VEVENTのほかに、時差情報を示すVTIMEZONE、アラームの設定を示すVALARM、仕事リストにあたるVTODOなどがあります。VEVENTを複数記述し、関連するスケジュールをまとめてひとつのカレンダーで扱うことも可能です。

BEGIN:VCALENDAR
...
BEGIN:VEVENT
...
END:VEVENT
BEGIN:VEVENT
...
END:VEVENT
BEGIN:VTIMEZONE
...
END:VTIMEZONE
...
END:VCALENDAR

〔補足〕iCalendarは、それ以前に定義されていたvCalendar[VCAL]を受け継ぐ形で定義されています。オブジェクトやコンポーネントの名前が'V'で始まっているのはその名残（というか互換性のために引き継いだもの）です。vCalendar形式は扱うプロパティが若干少ないものの、基本的にはiCalendarと同じ構造です。ただし、データが7ビットに限られているため、日本語の件名などはQuoted-Printable方式でエンコードされてしまう点が大きく異なります。

iCalendarのプロパティ

The iCalendar object and its components have properties. These are name:value pairs to describe event information such as date-time, location as well as basic calendar data. The mandatory calendar properties are VERSION and PRODID. Among many component properties, DTSTART, DTEND and SUMMARY are common to describe most primitive schedules.

VEVENTなどの各コンポーネントの情報（日時、場所など）は、プロパティとして表現します。また、カレンダー全体に共通する情報のためにVCALENDARもプロパティを持ちます。プロパティ名とその値はコロン（:）でつなぎ、1行で記述します。

VCALENDARプロパティとしては、iCalのバージョンを示すVERSIONと、カレンダーを生成したツールを示すPRODIDの2つが必須です。VEVENTにはたくさんの種類のプロパティがありますが、一般的なイベント記述の基本となるのは開始、終了日時を示すDTSTART、DTENDと、件名に相当するSUMMARYです。

これらを用いて、簡単なイベント情報をiCalendarとして記述してみましょう。

BEGIN:VCALENDAR
PRODID:-//kanzaki.com//RDFCal 1.0//EN
VERSION:2.0
BEGIN:VEVENT
DTSTART:20040211T050000Z
DTEND:20040211T070000Z
SUMMARY:オーケストラ・ダスビダーニャ第11回演奏会
END:VEVENT
END:VCALENDAR

いくつかの基本的なポイントだけ、例に沿って整理しておきます。

PRODIDとVERSIONの値

PRODIDの書式は特に定められていませんが、ほかのiCalendarツールと識別できるIDとします。VERSIONは、RFC2445では2.0と定められています。

日時の書式

日時プロパティの値は、ISO8601の完全表記とします。これは例のように年月日を区切り記号なしの8桁の数字で、時分秒をやはり区切りなしの6桁の数字で表記し、'T'でつなぐというものです。W3C-DTFスタイルの2004-02-11という区切記号入りではないので注意が必要です。

基本はUTCで、'Z'を最後に加えて示します（ローカル時刻の記述方法は後述します）。

行の長さと折り返し

プロパティ:値のペアを1行に記述します。長い行（目安として75バイト以上）は改行して、次の行の先頭にスペースもしくはTABを1文字入れることで、行を連続させられます。

改行コード及び文字コード

改行コードは、CR+LFです。

文字コードは基本的にUTF-8です（Content-Typeヘッダでcharsetを指定できることになっていますが、あまりあてにしない方がいいでしょう）。

パラメータと日時/時差情報

The iCalendar properties can have parameters. Time zone information is described with a parameter and VTIMEZONE component.

アメリカのように国内でも時差のある環境では、スケジュールにその情報を加えられないと、予定をうまく共有できません。国際的なイベントや、世界のどこからでもリアルタイムに参加できる電話会議、IRCミーティングなどではなおさらです。また、夏時間を導入している場合、国によってその開始、終了日が違っており、これを確認する手段も必要です。iCalendarには、パラメータとVTIMEZONEコンポーネントを介して、これらを扱う仕組みが組み込まれています。

DTSTART;VALUE=DATE:20031105
DTEND;VALUE=DATE:20031109
SUMMARY:学園祭

時差情報を記述するVTIMEZONEコンポーネント

VTIME component is used to describe time zone information.

TZIDパラメータで時間帯の名前を示しても、それがUTCとどれだけずれがあるのか、いつが夏時間なのかは分かりません。そこで、カレンダーのコンポーネントのひとつとしてVTIMEZONEを加え、そこにこれらの情報を記述します。VTIMEZONEはやや複雑ですが、基本的にはつぎのようなプロパティとサブコンポーネントで構成されます。

TZID

時間帯の識別名。日時プロパティなどで用いたTZIDパラメータと対応させる。

STANDARD, DAYLIGHT

標準時間と夏時間がいつからいつまでで、それぞれUTCとどれだけの時差があるかを記述します。サブコンポーネントの内部は次のようなプロパティで構成されます（ここで示す意味はSTANDARDの場合で、括弧内がDAYLIGHTに対応します）。

DTSTART, DTEND

標準時間（夏時間）の開始日時と終了日時。ローカル時刻で記述する。

TZOFFSETFROM

標準時間（夏時間）になる「前」には、UTCとどれだけの時差があったか

TZOFFSETTO

標準時間（夏時間）では、UTCとどれだけの時差があるか

日本のように夏時間がない時間帯は、STANDARDサブコンポーネントだけを記述しますが、その場合でもTZOFFSETTOだけでなくDTSTARTとTZOFFSETFROMも必要です。ここでのDTSTARTは過去の適当な日時を、TZOFFSETFROMはTZOFFSETTOと同じ値を記述しておきます（日本標準時は1888年1月1日に始まっているのでこの年でもいいのですが、コンピュータによっては古い日付は処理に問題を来す危険もあるので、1970年など）。例として、Asia/TokyoのVTIMEZONEを書いてみましょう。

BEGIN:VTIMEZONE
TZID:Asia/Tokyo
BEGIN:STANDARD
DTSTART:19700101T000000
TZOFFSETFROM:+0900
TZOFFSETTO:+0900
END:STANDARD
END:VTIMEZONE

このコンポーネントをiCalendar内に加えておくことで、イベントの日時を日本時間で表記できるようになります。

コンポーネントとプロパティによるRDFトリプル

RDFical defines iCalendar object and components as rdfs:Class'es and their components as rdf:Property's. Names are follow RDF convention. To connect Vcalendar and components such as Vevent, the schema defines 'component' property (which is not present in iCalendar spec).

RDFは、リソースを“主語―述語→目的語”のトリプルで記述します。iCalendarのコンポーネントとプロパティ:値という組み合わせはちょうどこの形に一致しており、うまい具合に扱えそうです。一般にRDFでは、クラス名は大文字ではじめ、プロパティ名は小文字とする習慣があるので、iCalendarの語彙もそれに従って変換します。

VEVENTコンポーネントのSUMMARYプロパティをRDF/XMLとして記述してみます：

<Vevent>
 <summary>オーケストラ・ダスビダーニャ第11回演奏会</summary>
</Vevent>

これは分かりやすいですね。ここから元のiCalendarを復元するのも簡単です。このRDFは、次のようなグラフを表しています。

VCALENDARオブジェクト中のVEVENTなどのコンポーネントを示すのは、少し工夫が必要です。iCalendarでは、後者は前者の中に直接含まれており、両者の関係を示すプロパティがないからです。ここでは、「VCALENDARはコンポーネントとしてVEVENTを持つ」と言いたいわけですから、componentというプロパティを導入してトリプルを組み立てます。

<Vcalendar>
 <component>
  <Vevent>
   <summary>オーケストラ・ダスビダーニャ第11回演奏会</summary>
  </Vevent>
 </component>
</Vcalendar>

日時のプロパティ

DTSTART, DTENDなどの日時は、iCalendarではいくつかの記述方法がありますが、2005年版RDFicalでは、直接dtstart、dtendプロパティのリテラル値として、世界標準時による日時を記述します（タイムゾーンをデータ型として記述する案もありますが、コンセンサスが得られていないので、ここでは扱いません）。

<Vevent>
 <dtstart>2004-02-11T05:00:00Z</dtstart>
 <dtend>2004-02-11T07:00:00Z</dtend>
 <summary>オーケストラ・ダスビダーニャ第11回演奏会</summary>
</Vevent>

形式がDATEであってもDATE-TIMEであっても同じプロパティを用います。時刻表記に時差オフセット（+09:00など）を用いたいところですが、今のところiCalendar仕様との整合性を重視して、これは使わないことになっています。

ここまでの要素をまとめて、[例3]のiCalendarを、RDFで表現してみましょう。

<rdf:RDF
  xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns="http://www.w3.org/2002/12/cal/icaltzd#">
 <Vcalendar>
  <prodid>-//kanzaki.com//RDFCal 1.0//EN</prodid>
  <version>2.0</version>
  <component>
   <Vevent>
    <dtstart>2004-02-11T05:00:00Z</dtstart>
    <dtend>2004-02-11T07:00:00Z</dtend>
    <summary>オーケストラ・ダスビダーニャ第11回演奏会</summary>
   </Vevent>
  </component>
 </Vcalendar>
</rdf:RDF>

リソースを目的語とするプロパティ

会議などでは主催者（ORGANIZER）や出席者（ATTENDEE）が誰であるかも重要な情報になります。iCalendarではこれらを基本的にメールアドレスで表現し、パラメータとして氏名などの名称（CN: Common name）を加えます。

[例12] ORGANIZER;CN:オーケストラ・ダスビダーニャ:MAILTO:info@dasubi.org

プロパティ値がせっかくURIになっているので、RDFicalではこれをrdf:resourceで参照し、リソース目的語として扱います。メールアドレスは、iCalendarではCAL-ADDRESS型と定義されているので、calAddressプロパティを用意し、やはりrdf:parseType="Resource"で構造化します。

<Vevent>
 ...
 <organizer rdf:parseType="Resource">
  <calAddress rdf:resource="mailto:info@dasubi.org"/>
  <cn>オーケストラ・ダスビダーニャ</cn>
 </organizer>
</Vevent>

出席者も、同様の構文でattendeeプロパティを用いて、メールアドレス（およびCommon Name）を構造化して記述します。

次のセクションは、やや古い2002年モデルを説明するので、RDFicalの主要な語彙まで飛ばして進んで差し支えありません。

RDFicalをカレンダーとして表示する

SemaviewのフリーソフトeventSherpaは、iCalendarのほかRDFicalデータを直接取り込んでカレンダー表示することができます。

当サイトのRDFicalデータは、スタイルシートを使って疑似カレンダー表示を行っています（XSLTによるRDFical表示例）。また、後で述べるように、XSLT等を使ってRDFicalをiCalendarに変換することで、iCal, Mozilla Calendar, Outlookなどでカレンダーデータを利用できるようになります。

RDFicalのクラス

クラスは、VCALENDARオブジェクトとVEVENT、VTIMEZONEコンポーネントの3つだけが定義されています。

RDFicalのプロパティ

RDFicalでは、iCalendarでいう「プロパティ」に加え、データタイプ、パラメータ、サブコンポーネントもRDFプロパティとして定義しています。代表的なものを取り上げます。

RSSに単純にイベント情報を加える

A simple way to embed iCalendar vocab in RSS item is to use foaf:topic in order to relate the webpage of the event and the event itself.

RSSは'Site' Summaryなので、イベントを告知しているページをitem要素とし、そこにfoaf:topicでイベントそのもののメタデータを埋め込むのが自然でしょう。以下、foaf:、i:をそれぞれFOAF、RDFicalの名前空間とし、RSSの名前空間をデフォルトとして記述します。

<item rdf:about="http://www.dasubi.org">
 <title>オーケストラ・ダスビダーニャ第11回演奏会</title>
 <description>ダスビついに5番を！　指揮: 長田 雅人; 
 ショスタコーヴィチ: 「馬あぶ」組曲; 交響曲第5番</description>
 <foaf:topic>
  <i:Vevent>
   <i:dtstart>2004-02-11T05:00:00Z</i:dtstart>
   <i:dtend>2004-02-11T07:00:00Z</i:dtend>
   <i:location>東京芸術劇場大ホール</i:location>
  </i:Vevent>
 </foaf:topic>
</item>

ここでは例を単純化するために日時をUTC表記にしています。tzidプロパティを併記してローカル時刻を記述するには、ファイル内にVtimezone要素も含めて関連づけなければなりません（イベントが日本以外では意味がないなら、tzidなしの時間帯に関わらない時刻でも大きな問題はなさそうですが、エージェントによる自動的な探索のためには、時間帯情報は重要です）。

<item rdf:about="http://www.dasubi.org">
 <title>オーケストラ・ダスビダーニャ第11回演奏会</title>
 <description>ダスビついに5番を！　指揮: 長田 雅人; 
 ショスタコーヴィチ: 「馬あぶ」組曲; 交響曲第5番</description>
 <i:dtstart>2004-02-11T14:00:00</i:dtstart>
 <i:dtend>2004-02-11T16:00:00</i:dtend>
 <i:location>東京芸術劇場大ホール</i:location>
</item>

<item rdf:about="http://www.dasubi.org">
 <title>オーケストラ・ダスビダーニャ第11回演奏会</title>
 <description>ダスビついに5番を！　指揮: 長田 雅人; 
 ショスタコーヴィチ: 「馬あぶ」組曲; 交響曲第5番</description>
 <ev:startdate>2004-02-11T14:00+09:00</ev:startdate>
 <ev:enddate>2004-02-11T16:00+09:00</ev:enddate>
 <ev:location>東京芸術劇場大ホール</ev:location>
</item>

<item rdf:about="http://www.dasubi.org">
 ...
 <ev:item>
  <rdf:Description>
   <ev:startdate>2004-02-11T14:00+09:00</ev:startdate>
   <ev:enddate>2004-02-11T16:00+09:00</ev:enddate>
  </rdf:Description>
 </ev:item>
</item>

iCalendar対応プログラムとの連動も念頭に置いた記述

In order to make roundtrip between iCalendar and RDFical, necessary components should be embedded in the same RSS file. It is possible to include a complete Vcalendar section independent from the feed section, and to connect each item and corresponding Vevent with rdf:nodeID mechanism.

RSSにこれらRDFicalのプロパティを記述しても、今のところRSSリーダーはその情報を表示してくれない（たぶん）ので、メリットがなかなか実感できないかも知れません。しかし、RSSを経由して見つけたイベント情報を、そのままOutlookやiCalなどのPIMツールに取り込めるとなれば、いろいろな利用方法が考えられます。

RSSからRDFicalのプロパティを抜き出して、それをiCalendarのフォーマットに戻してやるためには、iCalendarとして必要な一通りの情報をRSSのどこかに記述しておかなければなりません。RDFならrdf:resourceあるいはrdf:nodeID属性を使って外のノードを参照できるので、これらを全てitem要素内に詰め込むのではなく、itemとVeventを別々に記述することができます。

<rdf:RDF xmlns="http://purl.org/rss/1.0/"
 ...>
 <channel ...>
 ...
 </channel>
 ...
 <item rdf:about="http://www.dasubi.org">
  <title>オーケストラ・ダスビダーニャ第11回演奏会</title>
  <description>ダスビついに5番を！　指揮: 長田 雅人; 
  ショスタコーヴィチ: 「馬あぶ」組曲; 交響曲第5番</description>
  <foaf:topic rdf:nodeID="c01"/>
 </item>
 ...
 ...
 <Vcalendar xmlns="http://www.w3.org/2002/12/cal/icaltzd#">
  ...
  <component>
   <Vevent rdf:nodeID="c01">
    <dtstart>2004-02-11T05:00:00Z</dtstart>
    <dtend>2004-02-11T07:00:00Z</dtend>
    <summary>オーケストラ・ダスビダーニャ第11回演奏会</summary>
   </Vevent>
  </component>
  ...
  <component>
   <Vtimezone>
   ...
   </Vtimezone>
  </component>
 </Vcalendar>
</rdf:RDF>

RSSリーダーは普通にitem要素を読めばtitleやdescriptionを表示できます。RDFを収集するエージェントなら、RSSによるページ情報だけでなく、関連するイベントも取り込んでデータベースなどに登録することが可能です。さらに、RSSからiCalendarデータを抽出変換するXSLTは、単独のRDFicalと同様にVcalendar以下のノードを処理するだけでよいことになります。

RDFicalと位置情報

カレンダーにとって位置情報は重要です。iCalendarにはGEOプロパティが用意されていて、緯度・経度データを記述できますが、RDFicalでこれをどう扱うかはまだ確定していません。

現状での応用を位置に関するメタデータとその応用のページにまとめたので、参照してください。