Entendendo a estrutura de eventos recorrentes no SharePoint (RecurrenceData)

Entendendo a estrutura de eventos recorrentes no SharePoint (RecurrenceData)

A funcionalidade de eventos recorrentes, presente nas listas do tipo Calendário do SharePoint, pode ser muito interessante e útil. Para aprender como agendar um evento, veja esse link: http://office.microsoft.com/pt-br/sharepoint-server-help/agendar-eventos-e-etapas-com-um-calendario-HA101729898.aspx.

Existem alguns truques que, se usados corretamente, podem facilitar e muito a vida de um desenvolvedor.

O primeiro passo é entender como o SharePoint se comporta com esses eventos, ao salvar um item de calendário, internamente. Para isso, o primeiro passo é observar alguns campos internos (fRecurrence, fAllDayEvent, EventType):

Tipo Descrição fRecurrence fAllDayEvent EventType
Evento Único Um evento criado com o checkbox “Dia todo” e “Recorrência” desmarcados. False False 0
Evento de um dia inteiro Um evento criado com o checkbox “dia todo” marcado. False True 0
Evento Recorrente Um evento criado com o checkbox “recorrência” marcado. Tem um ícone de recorrência na visualização de Todos os Eventos. Aparece como um único evento mestre, mas nas visões de calendários todas as instâncias são mostradas. True False 1
Evento de dia todo recorrente Igual o item acima, mas com o checkbox “dia todo” marcado. True True 1
Exceção da recorrência Criado com a edição de uma instância de um evento recorrente. Tem um ícone de recorrência “riscado”. True False 4
Exceção da recorrência de eventos de dia todo Igual acima, mas com um evento de dia todo. True True 4
Item deletado de uma recorrência Criado deletando uma instância de um evento recorrente. O título é alterado para começar com “Deletado: “ na view de Todos os Eventos e não aparece nas visualizações de calendário. True False 3
Item deletado de uma recorrência de dia todo. Igual acima, mas para eventos de dia todo. True True 3


O quadro acima, mostra como o SharePoint se comporta durante o salvamento de um item na lista de calendário. Entretanto, alguns campos "default" podem ter comportamentos diferentes de acordo com o cenário de teste. Vejam:

Campo Valor para evento único Valor para evento recorrente
EventDate Data e hora de ínicio Data e hora de início de quando o evento recorrente foi criado, que pode ser uma data anterior a primeira instância de um evento recorrente;
EndDate Data e hora de término Data e hora da última instância de um evento recorrente. Para eventos recorrentes sem data de término, esta é uma data calculada a vários anos no futuro.
Duration O tempo em segundos entre a data de início e término A duração em segundos de uma instância individual do evento recorrente.


A maior confusão está no armazenamento desses itens, a forma como é mostrado na visão de calendário sugere que ao criarmos um evento recorrente, são gerados vários itens, um para cada ocorrência da recorrência desejada.

Entretanto, a engine do SharePoint armazena apenas
1 ITEM na lista. Todas as recorrências são apenas SOMBRAS ou projeções. Tudo isso é controlado pelo campo RecurrenceData.

Vejam alguns exemplos:

Tipo de recorrência Valor do campo RecurrenceData
Diariamente, a cada um dia, sem data de término <recurrence><rule><firstDayOfWeek>su</firstDayOfWeek>

<repeat><daily dayFrequency=”1″ /></repeat>

<repeatForever>FALSE</repeatForever>

</rule></recurrence>

Semanalmente, toda segunda, terça e quarta, terminando em 31/05/2007 <recurrence><rule><firstDayOfWeek>su</firstDayOfWeek>

<repeat><weekly mo=”TRUE” tu=”TRUE” we=”TRUE” weekFrequency=”1″ /></repeat>

<windowEnd>2007-05-31T22:00:00Z</windowEnd>

</rule></recurrence>

Mensalmente, toda terceira quarta-feira a cada 2 meses, sem data de término <recurrence><rule><firstDayOfWeek>su</firstDayOfWeek>

<repeat><monthlyByDay we=”TRUE” weekdayOfMonth=”third” monthFrequency=”2″ /></repeat>

<repeatForever>FALSE</repeatForever>

</rule></recurrence>

Anualmente, todo dia 18 de maio, termina após 10 ocorrências. <recurrence><rule><firstDayOfWeek>su</firstDayOfWeek>

<repeat><yearly yearFrequency=”1″ month=”5″ day=”18″ /></repeat>

<repeatInstances>10</repeatInstances>

</rule></recurrence>

Para os desenvolvedores, todo o truque está no objeto SPQuery, utilizando a propriedade ExpandRecurrence que "explode" os itens, gerando uma sombra de vários itens com o mesmo ID do original.

using(SPSite site = new SPSite("http://localhost/"))
using (SPWeb web = site.RootWeb)
{
SPList calendarList = web.Lists.TryGetList("Calendar");
if (calendarList != null)
{
SPQuery query = new SPQuery();
// Aqui que a mágica acontece
query.ExpandRecurrence = true;
query.Query = "<Where><Eq><FieldRef Name='EventDate' IncludeTimeValue='False'/><Value Type='DateTime'>"+SPUtility.CreateISO8601DateTimeFromSystemDateTime(DateTime.Now)+"</Value></Eq></Where>";
// Pesquisar apartir do começo do mês atual
query.CalendarDate = new DateTime(DateTime.Now.Year, DateTime.Now.Month, 1);
// Retorna todos os itens (incluindo as ocorrências de um
// evento recorrente que aparecem na visão de calendário
// do mês atual para frente
// Exemplo: Se tem apenas 1 item na lista, com 10 ocorrências
// nesse mês, o resultado serão 10 SPListItem com o mesmo ID de
// item, mudando apenas as informações sobre a data para conter
// uma única ocorrência
SPListItemCollection calendarItems = calendarList.GetItems(query);
foreach (SPListItem item in calendarItems)
{
Console.WriteLine(item["Title"] + ": começa " + item["EventDate"].ToString() + " e termina "+ item["EndDate"].ToString());
}
}
}
Classificar por: Data da Publicação | Mais Recente | Mais Úteis
Comentários
Página 1 de 1 (1 itens)