項目属性

表 10-5 に、共通デスクトップ環境でサポートされる項目属性をリストします。詳細は、関連するマニュアル・ページを参照してください。項目属性のリストは、拡張命名規則による拡張が可能です。

表 10-5 CSA 項目属性

属性名	記号名	サーバのバージョン	データのバージョン	読み取り専用
Audio Reminder	CSA_ENTRY_ATTR_AUDIO_REMINDER	2-5	1-4	*
Character Set*	CSA_X_DT_ENTRY_ATTR_CHARACTER _SET	5	4	*
Classification	CSA_ENTRY_ATTR_CLASSIFICATION	5	2-4	*
Date Completed	CSA_ENTRY_ATTR_DATE_COMPLETED	5	4	*
Date Created	CSA_ENTRY_ATTR_DATE_CREATED	5	4	○
Description	CSA_ENTRY_ATTR_DESCRIPTION	5	4	*
Due Date	CSA_ENTRY_ATTR_DUE_DATE	5	4	*
End Date	CSA_ENTRY_ATTR_END_DATE	2-5	1-4	*
Exception Dates	CSA_ENTRY_ATTR_EXCEPTION_DATES	5	4	*
Flashing Reminder	CSA_ENTRY_ATTR_FLASHING_ REMINDER	2-5	1-4	*
Last Update	CSA_ENTRY_ATTR_LAST_UPDATE	5	4	○
Mail Reminder	CSA_ENTRY_ATTR_MAIL_REMINDER	2-5	1-4	*
Number Recurrences	CSA_ENTRY_ATTR_NUMBER_ RECURRENCES	5	4	○
Organizer	CSA_ENTRY_ATTR_ORGANIZER	2-5	1-4	○
Popup Reminder	CSA_ENTRY_ATTR_POPUP_REMINDER	2-5	1-4	*
Priority	CSA_ENTRY_ATTR_PRIORITY	5	4	*
Recurrence Rule	CSA_ENTRY_ATTR_RECURRENCE_RULE	5	4	*
Reference Identifier	CSA_ENTRY_ATTR_REFERENCE_ IDENTIFIER	2-5	1-4	○
Repeat Interval*	CSA_X_ENTRY_ATTR_REPEAT_INTERVAL	2-5	1-4	**
Repeat Occurrence*	CSA_X_ENTRY_ATTR_REPEAT_ OCCURRENCE_NUM	2-5	1-4	**
Repeat Times*	CSA_X_ENTRY_ATTR_REPEAT_TIMES	2-5	1-4	**
Repeat Type*	CSA_X_DT_ENTRY_ATTR_REPEAT_TYPE	2-5	1-4	**
Sequence End Date*	CSA_X_ENTRY_ATTR_SEQUENCE_END_ DATE	2-5	1-4	**
Showtimes*	CSA_X_ENTRY_ATTR_SHOWTIME	2-5	1-4	*
Sponsor	CSA_ENTRY_ATTR_SPONSOR	5	4	*
Start Date	CSA_ENTRY_ATTR_START_DATE	2-5	1-4	*
Status	CSA_ENTRY_ATTR_STATUS	2-5	1-4	*
Subtype	CSA_ENTRY_ATTR_SUBTYPE	2-5	1-4	*
Summary	CSA_ENTRY_ATTR_SUMMARY	2-5	1-4	*
Transparency	CSA_ENTRY_ATTR_TIME_ TRANSPARENCY	5	4	*
Type	CSA_ENTRY_ATTR_TYPE	2-5	1-4	○***

* CDE のみ

** データ・バージョン 1 から 3 については、この属性は指定または変更できます。ただし、データ・バージョン 4 については読み取り専用です。データ・バージョン 4 では、エントリ属性 CSA_ENTRY_ATTR_RECURRENCE_RULE から値が取られます。

***カレンダ作成時に指定し、その後は読み取り専用になります。

次のカレンダ属性はサポートされません。

      CSA_ENTRY_ATTR_ATTENDEE_LIST
      CSA_ENTRY_ATTR_EXCEPTION_RULE
      CSA_ENTRY_ATTR_RECURRING_DATES
      CSA_ENTRY_ATTR_SEQUENCE_NUMBER

次の節では、表 10-5 にリストした項目属性について、追加の情報を提供します。

• Organizer

  項目の主催者は、csa_add_entry() を呼び出してカレンダに項目を追加するアプリケーションを実行しているユーザに設定されます。読み取り専用で、項目の追加後に変更できません。

• Reference Identifier

  項目の参照識別子は、カレンダ内の項目の固有な識別子と、カレンダの名前と位置を含んだ文字列です。形式は n:calendar@location です。n は、カレンダ内の項目を固有に識別する番号です。calendar は、カレンダ名です。location は、カレンダが格納されているマシン名です。

• Status

  CDE では、次の追加のステータス値を定義します。

      
CSA_X_DT_STATUS_ACTIVE
      CSA_X_DT_STATUS_DELETE_PENDING
      CSA_X_DT_STATUS_ADD_PENDING
      CSA_X_DT_STATUS_COMMITTED
      CSA_X_DT_STATUS_CANCELLED

• Type

  この値は読み取り専用で、項目の追加後に変更できません。CDE では、次の追加の型の値を定義します。

      
CSA_X_DT_TYPE_OTHER

CDE エントリ属性

CDE 定義済み項目属性は、次のとおりです。

• Show Time

  この属性の値は、項目の開始時間と終了時間をユーザに対して表示するかどうかを示します。csa_update_entry_attributes() により変更できます。この属性は、CSA_VALUE_SINT32 型の属性です。

• Repeat Type

  項目の反復の頻度、すなわち、どれくらいの間隔で項目を繰り返すかを示します。

  この属性は、CSA_VALUE_UINT32 型の属性です。

  次の値が定義されています。

      
CSA_X_DT_REPEAT_ONETIME
      CSA_X_DT_REPEAT_DAILY
      CSA_X_DT_REPEAT_WEEKLY
      CSA_X_DT_REPEAT_BIWEEKLY
      CSA_X_DT_REPEAT_MONTHLY_BY_WEEKDAY
      CSA_X_DT_REPEAT_MONTHLY_BY_DATE
      CSA_X_DT_REPEAT_YEARLY
      CSA_X_DT_REPEAT_EVERY_NDAY
      CSA_X_DT_REPEAT_EVERY_NWEEK
      CSA_X_DT_REPEAT_EVERY_NMONTH
      CSA_X_DT_REPEAT_MON_TO_FRI
      CSA_X_DT_REPEAT_MONWEDFRI
      CSA_X_DT_REPEAT_TUETHUR
      CSA_X_DT_REPEAT_WEEKDAYCOMBO
      CSA_X_DT_REPEAT_OTHER
      CSA_X_DT_REPEAT_OTHER_WEEKLY
      CSA_X_DT_REPEAT_OTHER_MONTHLY
      CSA_X_DT_REPEAT_OTHER_YEARLY

• Repeat Times

  この属性は、項目を繰り返す回数を示します。この属性は、CSA_VALUE_UINT32 型の属性です。

• Repeat Interval

  この属性は、Repeat Type の CSA_X_DT_REPEAT_EVERY_NDAY、CSA_X_DT_REPEAT_EVERY_NWEEK、または CSA_X_DT_REPEAT_EVERY_NMONTH の何倍で項目を繰り返すかを示します。たとえば、この属性の値が 3 であり、Repeat Type が CSA_X_DT_REPEAT_EVERY_NWEEK の場合には、項目は 3 週間ごとに繰り返されます。この属性は、CSA_VALUE_UINT32 型の属性です。

• Repeat Occurrence Number

  項目の Repeat Type が CSA_X_DT_REPEAT_MONTHLY_BY_WEEKDAY の場合、この属性は、項目を繰り返す週を示します。この属性は、CSA_VALUE_SINT32 型の属性です。

• Sequence End Date

  この項目属性は、シーケンスの終了日付を示します。この属性は、CSA_VALUE_DATE_TIME 型の属性です。

反復情報のエントリ属性

データ・バージョン 1 から 3 については、次の属性を使用してエントリの反復情報を指定します。すべて読み取りおよび書き込み属性です。

      CSA_X_DT_ENTRY_ATTR_REPEAT_TYPE
      CSA_X_DT_ENTRY_ATTR_REPEAT_TIMES
      CSA_X_DT_ENTRY_ATTR_REPEAT_INTERVAL
      CSA_X_DT_ENTRY_ATTR_REPEAT_OCCURRENCE_NUM
      CSA_X_DT_ENTRY_ATTR_SEQUENCE_END_DATE

データ・バージョン 4 については、エントリ属性 CSA_ENTRY_ATTR_RECURRENCE_RULE と CSA_ENTRY_ATTR_EXCEPTION_DATES を使用してカレンダ・エントリの反復情報を指定します。CSA_ENTRY_ATTR_RECURRENCE_RULE 属性の情報は、次の属性を使用して問い合わせることができます。

      CSA_X_DT_ENTRY_ATTR_REPEAT_TYPE
      CSA_X_DT_ENTRY_ATTR_REPEAT_TIMES
      CSA_X_DT_ENTRY_ATTR_REPEAT_INTERVAL
      CSA_X_DT_ENTRY_ATTR_REPEAT_OCCURRENCE_NUM
      CSA_X_DT_ENTRY_ATTR_SEQUENCE_END_DATE 

これらの計算された属性は、データ・バージョン 4 に対して読み取り専用です。

データ・バージョンによりサポートされる値

• CSA_ENTRY_ATTR_STATUS

  データ・バージョン 1 はこの属性をサポートしません。

  データ・バージョン 2 と 3 は次の値をサポートします。

  CSA_X_DT_STATUS_ACTIVE
  CSA_X_DT_STATUS_DELETE_PENDING
  CSA_X_DT_STATUS_ADD_PENDING
  CSA_X_DT_STATUS_COMMITTED
  CSA_X_DT_STATUS_CANCELLED
  

  データ・バージョン 4 はすべての状態値をサポートします。

  CSA_STATUS_ACCEPTED
  CSA_STATUS_NEEDS_ACTION
  CSA_STATUS_SENT
  CSA_STATUS_TENTATIVE
  CSA_STATUS_CONFIRMED
  CSA_STATUS_REJECTED
  CSA_STATUS_COMPLETED
  CSA_STATUS_DELEGATED
  CSA_X_DT_STATUS_ACTIVE
  CSA_X_DT_STATUS_DELETE_PENDING
  CSA_X_DT_STATUS_ADD_PENDING
  CSA_X_DT_STATUS_COMMITTED
  CSA_X_DT_STATUS_CANCELLED
  

• CSA_ENTRY_ATTR_SUBTYPE

  データ・バージョン 1 から 3 は次の値をサポートします。

  CSA_SUBTYPE_APPOINTMENT
  CSA_SUBTYPE_HOLIDAY
  

  データ・バージョン 4 はすべての定義値と、アプリケーションで定義する次のような値をサポートします。

  CSA_SUBTYPE_APPOINTMENT 
  CSA_SUBTYPE_CLASS   
  CSA_SUBTYPE_HOLIDAY   
  CSA_SUBTYPE_MEETING  
  CSA_SUBTYPE_MISCELLANEOUS   
  CSA_SUBTYPE_PHONE_CALL   
  CSA_SUBTYPE_SICK_DAY  
  CSA_SUBTYPE_SPECIAL_OCCASION   
  CSA_SUBTYPE_TRAVEL  
  CSA_SUBTYPE_VACATION
  

• CSA_ENTRY_ATTR_TYPE

  データ・バージョン 1 から 3 は次の値をサポートします。

  CSA_TYPE_EVENT  
  CSA_TYPE_TODO   
  CSA_X_DT_TYPE_OTHER
  

  データ・バージョン 4 は次のすべての定義値をサポートします。

  CSA_TYPE_EVENT  
  CSA_TYPE_TODO   
  CSA_TYPE_MEMO   
  CSA_X_DT_TYPE_OTHER
  

  ---

  注 -

  次に示すように、タイプとサブタイプの組み合わせによっては、データ・バージョン 1 から 3 でサポートします。

  ---

  データ・バージョン 1 でサポートする組み合わせ

  サブタイプ CSA_SUBTYPE_APPOINTMENT を持つ CSA_TYPE_EVENT
  サブタイプ値を持たない CSA_X_DT_TYPE_OTHER
  

  データ・バージョン 2 と 3 でサポートする組み合わせ

  サブタイプ CSA_SUBTYPE_APPOINTMENT を持つ CSA_TYPE_EVENT 
  サブタイプ CSA_SUBTYPE_HOLIDAY を持つ CSA_TYPE_EVENT 
  サブタイプ値を持たない CSA_TYPE_TODO 
  サブタイプ値を持たない CSA_X_DT_TYPE_OTHER
  

• CSA_X_ENTRY_ATTR_REPEAT_TYPE

  データ・バージョン 1 から 3 については、この属性を使用してエントリの反復のタイプを指定します。

  データ・バージョン 1 と 2 でサポートする値

  CSA_X_DT_REPEAT_ONETIME 
  CSA_X_DT_REPEAT_DAILY   
  CSA_X_DT_REPEAT_WEEKLY   
  CSA_X_DT_REPEAT_BIWEEKLY  
  CSA_X_DT_REPEAT_MONTHLY_BY_DATE  C
  SA_X_DT_REPEAT_YEARLY
  

  データ・バージョン 3 でサポートする値

  CSA_X_DT_REPEAT_ONETIME 
  CSA_X_DT_REPEAT_DAILY   
  CSA_X_DT_REPEAT_WEEKLY   
  CSA_X_DT_REPEAT_BIWEEKLY  
  CSA_X_DT_REPEAT_MONTHLY_BY_WEEKDAY   
  CSA_X_DT_REPEAT_MONTHLY_BY_DATE  
  CSA_X_DT_REPEAT_YEARLY   
  CSA_X_DT_REPEAT_EVERY_NDAY  
  CSA_X_DT_REPEAT_EVERY_NWEEK   
  CSA_X_DT_REPEAT_EVERY_NMONTH  
  CSA_X_DT_REPEAT_MON_TO_FRI   
  CSA_X_DT_REPEAT_MONWEDFRI   
  CSA_X_DT_REPEAT_TUETHUR 
  CSA_X_DT_REPEAT_WEEKDAYCOMBO  C
  SA_X_DT_REPEAT_OTHER
  

  データ・バージョン 4 については、これは読み取り専用属性です。この値は、エントリ属性 CSA_ENTRY_ATTR_RECURRENCE_RULE から取られます。