ぐうたログ：So-net blog

	ブログをはじめるログイン

2011年09月07日｜ 2011年09月13日｜2011年09月20日ブログトップ

アラームコンポーネント（VALARM）　[iCalendar]

コンポーネント系の最後になりますが、「VALARM」です。「VEVENT」と「VTODO」に含まれる場合のあるコンポーネントですね。単独で存在できるのかどうかは、今のところ不明。アラームを定義するためのコンポーネントです。

定義は下記の通り。

alarmc     = "BEGIN" ":" "VALARM" CRLF
             (audioprop / dispprop / emailprop)
             "END" ":" "VALARM" CRLF

audioprop  = *(
           ;
           ; 'action' and 'trigger' are both REQUIRED,
           ; but MUST NOT occur more than once.
           ;
           action / trigger /
           ;
           ; 'duration' and 'repeat' are both OPTIONAL,
           ; and MUST NOT occur more than once each;
           ; but if one occurs, so MUST the other.
           ;
           duration / repeat /
           ;
           ; The following is OPTIONAL,
           ; but MUST NOT occur more than once.
           ;
           attach /
           ;
           ; The following is OPTIONAL,
           ; and MAY occur more than once.
           ;
           x-prop / iana-prop
           ;
           )

dispprop   = *(
           ;
           ; The following are REQUIRED,
           ; but MUST NOT occur more than once.
           ;
           action / description / trigger /
           ;
           ; 'duration' and 'repeat' are both OPTIONAL,
           ; and MUST NOT occur more than once each;
           ; but if one occurs, so MUST the other.
           ;
           duration / repeat /
           ;
           ; The following is OPTIONAL,
           ; and MAY occur more than once.
           ;
           x-prop / iana-prop
           ;
           )

emailprop  = *(
           ;
           ; The following are all REQUIRED,
           ; but MUST NOT occur more than once.
           ;
           action / description / trigger / summary /
           ;
           ; The following is REQUIRED,
           ; and MAY occur more than once.
           ;
           attendee /
           ;
           ; 'duration' and 'repeat' are both OPTIONAL,
           ; and MUST NOT occur more than once each;
           ; but if one occurs, so MUST the other.
           ;
           duration / repeat /
           ;
           ; The following are OPTIONAL,
           ; and MAY occur more than once.
           ;
           attach / x-prop / iana-prop
           ;
           )

「audioprop」「dispprop」「emailprop」の3つのパートに別れていますね。それぞれがサブコンポーネントになるんでしょうか？　プロパティもそれぞれについて、定義されています。別々にまとめてみます。なお、「M」は「必須」、「M/O」は「場合によっては必須」、「O」は「オプション」です。

audioprop
action	M	二つ以上設定しない（MUST NOT）
trigger	M	二つ以上設定しない（MUST NOT）
duration	M/O	二つ以上設定しない（MUST NOT）。「repeat」が設定された場合は必須（MUST）
repeat	M/O	二つ以上設定しない（MUST NOT）。「duration」が設定された場合は必須（MUST）
attach	O	二つ以上設定しない（MUST NOT）
x-prop	O	二つ以上設定してもよい（MAY）
iana-prop	O	二つ以上設定してもよい（MAY）
dispprop
action	M	二つ以上設定しない（MUST NOT）
description	M	二つ以上設定しない（MUST NOT）
trigger	M	二つ以上設定しない（MUST NOT）
duration	M/O	二つ以上設定しない（MUST NOT）。「repeat」が設定された場合は必須（MUST）
repeat	M/O	二つ以上設定しない（MUST NOT）。「duration」が設定された場合は必須（MUST）
x-prop	O	二つ以上設定してもよい（MAY）
iana-prop	O	二つ以上設定してもよい（MAY）
emailprop
action	M	二つ以上設定しない（MUST NOT）
description	M	二つ以上設定しない（MUST NOT）
trigger	M	二つ以上設定しない（MUST NOT）
summary	M	二つ以上設定しない（MUST NOT）
attendee	M	二つ以上設定してもよい（MAY）
duration	M/O	二つ以上設定しない（MUST NOT）。「repeat」が設定された場合は必須（MUST）
repeat	M/O	二つ以上設定しない（MUST NOT）。「duration」が設定された場合は必須（MUST）
attach	O	二つ以上設定してもよい（MAY）
x-prop	O	二つ以上設定してもよい（MAY）
iana-prop	O	二つ以上設定してもよい（MAY）