Список «Поле» iCalendar (для схемы базы данных по стандарту iCalendar) - PullRequest
32 голосов
/ 28 июня 2009

мое приложение должно иметь дело с календарной информацией (в том числе единичное вхождение, повторение и т. Д.). Чтобы легко взаимодействовать с другими приложениями, я подумал, что было бы неплохо создать мою схему базы данных на основе формата iCalendar (поля, отношения, ограничения) напрямую, чтобы я мог получить объекты, совместимые с iCalendar через ORM, которые я могу легко представить при необходимо.

Я знаю, что RFC доступен, но он довольно сложный из-за всей дополнительной информации, которую я не использую в данный момент.

Может ли кто-нибудь указать мне на более простой источник для создания схемы базы данных на основе стандарта iCal (имеется в виду список полей / имен полей и их взаимосвязь для записей iCal)?

Спасибо!

Ответы [ 5 ]

41 голосов
/ 09 сентября 2009

Я сделал это (только для VEvents, не поддерживая элементы TODO, журналы или что-то в этом роде). Моя реализация выглядит следующим образом (после удаления столбцов, которые не относятся к данному вопросу):

-- One table for each event.  An event may have multiple rRules.
Create Table [vEvent]
    (vEventID Integer Identity(1, 1) Not Null
     Constraint [vEvent.pk]
     Primary Key
     Clustered
    ,title nVarChar(200) Not Null);

-- One table for rRules.
-- My application does NOT support the "bySetPos" rule, so that is not included.
Create Table [rRule]
    (rRuleID Integer Identity(1, 1) Not Null
     Constraint [rRule.pk]
     Primary Key
     Clustered
    ,vEventID Integer Not Null
     Constraint [fk.vEvent.rRules]
     Foreign Key
     References [vEvent] (vEventID)
     On Update Cascade
     On Delete Cascade
    ,[class]            varChar(  12) Not Null Default('public')
    ,[created]         DateTime       Not Null Default(getUTCDate())
    ,[description]     nVarChar(max)      Null
    ,[dtStart]         DateTime       Not Null
    ,[dtEnd]           DateTime           Null
    ,[duration]         varChar(  20)     Null
    ,[geoLat]          Float              Null
    ,[geoLng]          Float              Null
    ,[lastModified]    DateTime       Not Null Default(getUTCDate())
    ,[location]        nVarChar(max)      Null
    ,[organizerCN]     nVarChar(  50)     Null
    ,[organizerMailTo] nVarChar( 100)     Null
    ,[seq]             Integer        Not Null Default(0)
    ,[status]           varChar(   9) Not Null Default('confirmed')
    ,[summary]         nVarChar(  75)     Null
    ,[transparent]     Bit            Not Null Default(0)
    ,[freq]             varChar(   8) Not Null Default('daily')
    ,[until]           DateTime           Null
    ,[count]           Integer            Null
    ,[interval]        Integer        Not Null Default(1)
    ,[bySecond]         varChar( 170)     Null
    ,[byMinute]         varChar( 170)     Null
    ,[byHour]           varChar(  61)     Null
    ,[byDay]            varChar(  35)     Null
    ,[byMonthDay]       varChar( 200)     Null
    ,[byYearDay]        varChar(3078)     Null
    ,[byWeekNo]         varChar( 353)     Null
    ,[byMonth]          varChar(  29)     Null
    ,[wkSt]             Char   (   2)     Null Default('mo'));

-- Class must be one of "Confidential", "Private", or "Public"
Alter Table [rRule]
Add Constraint [rRule.ck.Class]
Check ([class] In ('confidential', 'private', 'public'));

-- Start date must come before End date
Alter Table [rRule]
Add Constraint [rRule.ck.dtStart]
Check ([dtEnd] Is Null Or [dtStart] <= [dtEnd]);

-- dtEnd and duration may not both be present
Alter Table [rRule]
Add Constraint [rRule.ck.duration]
Check (Not ([dtEnd] Is Not Null And [duration] Is Not Null));

-- Check valid values for [freq]. Note that 'single' is NOT in the RFC;
-- it is an optimization for my particular iCalendar calculation engine.
-- I use it as a clue that this pattern has only a single date (dtStart),
-- and there is no need to perform extra calculations on it.
Alter Table [rRule]
Add Constraint [rRule.ck.freq]
Check ([freq] In
    ('yearly'
    ,'monthly'
    ,'weekly'
    ,'daily'
    ,'hourly'
    ,'minutely'
    ,'secondly'
    ,'single')); -- Single is NOT part of the spec!

-- If there is a latitude, there must be a longitude, and vice versa.
Alter Table [rRule]
Add Constraint [rRule.ck.geo]
Check (([geoLat] Is Null And [geoLng] Is Null)
       Or ([geoLat] Is Not Null And [geoLng] Is Not Null));

-- Interval must be positive.
Alter Table [rRule]
Add Constraint [rRule.ck.interval]
Check ([interval] > 0);

-- Status has a set of defined values.
Alter Table [rRule]
Add Constraint [rRule.ck.status]
Check ([status] In ('cancelled', 'confirmed', 'tentative'));

-- Until and Count may not coexist in the same rule.
Alter Table [rRule]
Add Constraint [rRule.ck.until and count]
Check (Not ([until] Is Not Null And [count] Is Not Null));


-- One table for exceptions to rRules.  In my application, this covers both
-- exDate and rDate.  I do NOT support extended rule logic here;  The RFC says
-- you should support the same sort of date calculations here as are supported
-- in rRules: exceptions can recur, etc.  I don't do that; mine is simply a
-- set of dates that are either "exceptions" (dates which don't appear, even
-- if the rule otherwise says they should) or "extras" (dates which do appear,
-- even if the rule otherwise wouldn't include them).  This has proved
-- sufficient for my application, and something that can be exported into a
-- valid iCalendar file--even if I can't import an iCalendar file that makes
-- use of recurring rules for exceptions to recurring rules.
Create Table [exDate]
    (exDateID Integer Identity(1, 1) Not Null
     Constraint [exDate.pk]
     Primary Key
     Clustered
    ,rRuleID Integer Not Null
     Constraint [fk.rRule.exDates]
     Foreign Key
     References [rRule] (rRuleID)
     On Update Cascade
     On Delete Cascade
    ,[date] DateTime Not Null
    ,[type] varChar(6) Not Null);  -- Type = "exDate" or "rDate" for me; YMMV.

Для этого у меня есть несколько функций CLR в SQL Server 2005+, которые можно использовать для вычисления дат для различных событий. Я нашел следующие формы очень полезными:

Select * From dbo.getDatesByVEventID(@id, @startDate, @endDate)
Select * From dbo.getEventsByDateRange(@startDate, @endDate, @maxCount)

Реализация вышеперечисленного чертовски забавно выяснить!

12 голосов
/ 28 июля 2009

Да, вроде. Sunbird (календарь Mozilla с открытым исходным кодом) основан на sqlite, и я только что скачал и разархивировал их исходный код. В нем есть файлы .sql.

FTP: //ftp.mozilla.org/pub/mozilla.org/calendar/sunbird/releases/0.9/source/

mozilla \ calendar \ provider \ storage \ schema-7.sql - эта схема используется sunbird для создания допустимых файлов iCal, поэтому она не может быть слишком плохой.

1 голос
/ 12 ноября 2016

Большое спасибо Крису Нильсену за его великолепное решение выше. Однако у меня были некоторые проблемы с этим, поэтому я изменил его. Обратите внимание, что решение выше в Python sqlalchemy. Я преобразую это очень скоро.

Мои основные трудности с решением Криса (и они могут не относиться ко всем):

  1. Мне не нужно было много столбцов в его решении. Мне нужны были только столбцы, которые помогли бы мне с событиями и повторениями. Это вина спецификации iCalendar, а не Криса. Мое решение ниже рассматривает только правила повторения с точки зрения их календарных ограничений и ограничений их последовательности.

  2. Некоторые столбцы - наиболее важные dtStart и dtEnd - принадлежат VEVENT, а не RRULE, но Крис поместил их в RRULE. Это смущало меня. VEVENT: https://tools.ietf.org/html/rfc5545#section-3.6.1 РУБЛЬ: https://tools.ietf.org/html/rfc5545#section-3.3.10

  3. Мне также нужно было выяснить, как содержать расписание, которое может иметь различные шаблоны. Например, событие может происходить каждую неделю в пятницу с 18:00 до 21:00, но также и весь день мая. Это требует гибкости с dtStart и dtEnd. По этой причине я создал содержащую таблицу «SCHEDULE», которая поддерживает отношение «многие ко многим» с СОБЫТИЯМИ, тогда как СОБЫТИЯ имеют отношение сдерживания с RRULES.

Ниже мое решение в sqlalchemy. Я преобразую это в SQL как можно скорее.

from app import db
from sqlalchemy import CheckConstraint
from sqlalchemy.ext.associationproxy import association_proxy


class Schedule(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    subtypes_relation = db.relationship('Event', secondary=schedule_event_association,
                                        backref=db.backref('Schedule', lazy='dynamic'))

schedule_event_association = db.Table(
    'schedule_event_association',
    db.Column('schedule_id', db.Integer, db.ForeignKey('schedule.id')),
    db.Column('event_id', db.Integer, db.ForeignKey('event.id')))

class Event(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    dt_start = db.Column(db.DateTime)  # start time
    dt_end = db.Column(db.DateTime) # end time
    tz_id = db.Column(db.String) # Time Zone

    recurrence_rule = db.Column('RecurrenceRule_id',  db.Integer, db.ForeignKey('RecurrenceRule.id'))

# Start date must come before End date
    CheckConstraint('dtEnd is NULL OR dtStart <= dtEnd', name='Valid: Time Period')

class RecurrenceRule(db.Model):
    id = db.Column(db.Integer, primary_key=True)

    # Frequency Type
    freq = db.Column(db.String(8), nullable=False, default='weekly') # type of recurrence

    # Calendar-Based Rules
    byDay = db.Column(db.String(35))   # List of Day of the Week
                                        # "mo,tu,we" for weekly
                                        # "+2MO, -1MO" = second monday, last monday for yearly or monthly
    byMonthDay = db.Column(db.String(200)) # List of Day of the Month
                                            # +1,-1"
                                            # Only for Monthly or Yearly
    byYearDay = db.Column(db.String(3078)) # List Day of the Year
                                            #"+1, -1"
                                            # Only for yearly
                                            # Take care with leap years
    byWeekNo = db.Column(db.String(353)) # Which week of Mon`enter code here`th
                                            # "+5, -3" for fifth and third-to-last
                                            # Only for yearly
    byMonth = db.Column(db.String(29))   # Month of year.

    # Sequence-Based Rules
    until = db.Column(db.DateTime)   # last day of occurence
    count = db.Column(db.Integer)    # number of occurences
    interval = db.Column(db.Integer, nullable=False, default=1) # interval between recurrences
    bysetpos = db.Column(db.String()) # Specifies specific instances of recurrence


# Valid Values
    CheckConstraint(freq in ('yearly', 'monthly', 'weekly', 'daily', 'single'),
                    name='Valid: Frequency Value')
    CheckConstraint(interval > 0, name='Valid: Positive Interval')
    CheckConstraint(byDay is not None and freq in ('daily', 'yearly', 'monthly'))
    CheckConstraint(byWeekNo is not None and freq in ('yearly', 'monthly'))
    CheckConstraint(byYearDay is not None and freq == 'yearly')

# Until and Count may not coexist in the same rule.
    CheckConstraint(not (until is not None and count is not None),
                    name='Valid: Not Both Until and Count')
0 голосов
/ 12 октября 2010
  • вы можете попробовать этот документ для apple icalendar. Вы можете реплицировать поля непосредственно в таблицы базы данных. http://developer.apple.com/library/mac/#DOCUMENTATION/AppleApplications/Reference/SyncServicesSchemaRef/Articles/Calendars.html

  • если вы используете java, ical4j обеспечивает связь между схемой и интерфейсом. Если вы не используете Java, алгоритмы в исходном коде для генерации вхождений и структуры обеспечат хорошую помощь для реализации.

0 голосов
/ 28 июня 2009

iCal - это приложение Apple, которое соответствует стандарту, известному в настоящее время как Icalendar (преемник предыдущего Vcalendar). Я думаю, что в википедии entry есть вся информация, которая вам нужна для ваших целей, и в простом и понятном формате, но не стесняйтесь спрашивать дополнительные указания, если это необходимо !!!

Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...