Paramètre obligatoire utilisé dans le cas de la
création d'un abonnement. Il définit la règle de
l’abonnement à appliquer. La valeur attendue
dans ce paramètre est une chaîne de caractères suivant la
spécification iCalendar, ou Internet
Calendar, décrite dans la RFC5545 (voir http://tools.ietf.org/html/rfc5545). Cette spécification permet entre autre de définir
des règles complexes d’abonnement, via la propriété RRULE. Pour des raisons techniques, il
n’est pas possible de définir des périodes d’abonnement inférieures
à une journée. Les mots
clés "SECONDLY" / "MINUTELY" /
"HOURLY" ne sont donc pas pris en compte. Exemples : Pour définir des
échéances de paiement ayant lieu le dernier jour de
chaque mois, pendant 12 mois, la règle s’écrit : RRULE:FREQ=MONTHLY;BYMONTHDAY=28,29,30,31;BYSETPOS=-1;COUNT=12 Cette règle signifie
que si le mois courant ne contient pas de 31, alors le
moteur prendra en compte le 30. Si le 30 n’existe pas,
alors il prendra en compte le 29 et ainsi de suite
jusqu’au 28. Une autre version de
cette règle : RRULE:FREQ=MONTHLY;COUNT=5;BYMONTHDAY=-1 - Pour définir des échéances de paiement ayant
lieu le 10 de chaque mois, pendant 12 mois, alors la règle
d’abonnement s’écrit de la manière suivante : RRULE:FREQ=MONTHLY;COUNT=12;BYMONTHDAY=10
- Pour définir des échéances de paiement ayant
lieu chaque trimestre, jusqu’au 31/12/2016 : RRULE:FREQ=YEARLY;BYMONTHDAY=-1;BYMONTH=1,4,7,10;UNTIL=20161231
Les échéances auront lieu chaque 1er de
janvier, avril, juillet et octobre. Leur nombre total
dépend de la date d’effet de
l’abonnement
(voir paramètre vads_sub_effect_date). - Pour définir un abonnement toutes les semaines, le lundi: RRULE:FREQ=WEEKLY;BYDAY=MO
Les échéances auront lieu tous les lundis. Attention la première échéance sera le prochain lundi. - Pour définir un abonnement toutes les semaines: RRULE:FREQ=WEEKLY
Les échéances auront lieu le jour même si la date d'effet est positionnée à "aujourd'hui" puis tous les 7 jours. - Pour définir un abonnement toutes les deux semaines le lundi, limité à 4 occurences: RRULE:FREQ=WEEKLY;INTERVAL=2;COUNT=4;BYDAY=MO
- Pour définir un abonnement toutes les deux semaines, aujourd’hui et tous les 7 jours: RRULE:FREQ=WEEKLY;INTERVAL=2;
Pour plus de détails
et d'exemples vous pouvez consulter le site http://recurrance.sourceforge.net/.
Champ d'entrée et de sortie, retourné dans la réponse (IPN et
URL de retour). |