表 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 定義済み項目属性は、次のとおりです。
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 から取られます。