Áú»¢¶Ä²©

This is the documentation page for an unsupported version of Áú»¢¶Ä²©.
Is this not what you were looking for? Switch to the current version or choose one from the drop-down menu.

2 Custom intervals

Aper?u

Il est possible de cr¨¦er des r¨¨gles personnalis¨¦es concernant le temps o¨´ un ¨¦l¨¦ment est v¨¦rifi¨¦. Les deux m¨¦thodes pour cela sont les intervalles flexibles, qui permettent de red¨¦finir l'intervalle de mise ¨¤ jour par d¨¦faut, et la planification, gr?ce ¨¤ laquelle une v¨¦rification d'¨¦l¨¦ment peut ¨ºtre ex¨¦cut¨¦e ¨¤ un moment ou une s¨¦quence de temps sp¨¦cifique.

Intervalles flexibles

Les intervalles flexibles permettent de red¨¦finir l'intervalle de mise ¨¤ jour par d¨¦faut pour des ±è¨¦°ù¾±´Ç»å±ð²õ sp¨¦cifiques. Un intervalle flexible est d¨¦fini avec Intervalle et ±Ê¨¦°ù¾±´Ç»å±ð o¨´ :

  • Intervalle - l'intervalle d¡¯actualisation pour la p¨¦riode sp¨¦cifi¨¦e
  • ±Ê¨¦°ù¾±´Ç»å±ð - la p¨¦riode pendant laquelle l'intervalle flexible est actif (voir les ±è¨¦°ù¾±´Ç»å±ð²õ pour la description d¨¦taill¨¦e du format de la ±Ê¨¦°ù¾±´Ç»å±ð)

Jusqu'¨¤ sept intervalles flexibles peuvent ¨ºtre d¨¦finis. Si plusieurs intervalles flexibles se chevauchent, la plus petite valeur d'intervalle est utilis¨¦e pour la p¨¦riode de chevauchement. Notez que si la plus petite valeur o¨´ les intervalles se chevauchant est '0', aucune interrogation n'aura lieu. En dehors des intervalles flexibles, l'intervalle d¡¯actualisation par d¨¦faut est utilis¨¦.

Notez que si l'intervalle flexible est ¨¦gal ¨¤ la longueur de la p¨¦riode, l'¨¦l¨¦ment sera v¨¦rifi¨¦ une seule fois. Si l'intervalle flexible est sup¨¦rieur ¨¤ la p¨¦riode, l'¨¦l¨¦ment peut ¨ºtre v¨¦rifi¨¦ une fois ou il peut ne pas ¨ºtre v¨¦rifi¨¦ du tout (une telle configuration n'est donc pas conseill¨¦e). Si l'intervalle flexible est inf¨¦rieur ¨¤ la p¨¦riode, l'¨¦l¨¦ment sera v¨¦rifi¨¦ au moins une fois.

Si l'intervalle flexible est d¨¦fini sur '0', l'¨¦l¨¦ment n'est pas interrog¨¦ pendant la p¨¦riode d'intervalle flexible et reprend l'interrogation en fonction de l'intervalle d¡¯actualisation par d¨¦faut une fois la p¨¦riode termin¨¦e.

Exemples :

Intervalle ±Ê¨¦°ù¾±´Ç»å±ð Description
10 1-5,09:00-18:00 L'¨¦l¨¦ment sera v¨¦rifi¨¦ toutes les 10 secondes pendant les heures de travail.
0 1-7,00:00-7:00 L'¨¦l¨¦ment ne sera pas v¨¦rifi¨¦ pendant la nuit.
0 7-7,00:00-24:00 L'¨¦l¨¦ment ne sera pas v¨¦rifi¨¦ le dimanche.
60 1-7,12:00-12:01 L'¨¦l¨¦ment sera v¨¦rifi¨¦ ¨¤ 12h00 tous les jours. Notez que cela a ¨¦t¨¦ utilis¨¦ comme une solution de contournement pour les contr?les planifi¨¦s et ¨¤ partir de Áú»¢¶Ä²© 3.0, il est recommand¨¦ d'utiliser des intervalles de planification pour ces v¨¦rifications.

Intervalles de planification

Les intervalles de planification sont utilis¨¦s pour v¨¦rifier les ¨¦l¨¦ments ¨¤ des moments pr¨¦cis. Alors que les intervalles flexibles sont con?us pour red¨¦finir l'intervalle d¡¯actualisation par d¨¦faut des ¨¦l¨¦ments, les intervalles de planification sont utilis¨¦s pour sp¨¦cifier un calendrier de contr?le ind¨¦pendant, qui est ex¨¦cut¨¦ en parall¨¨le.

Un intervalle de planification est d¨¦fini comme suit : md<filter>wd<filter>h<filter>m<filter>s<filter> o¨´ :

  • md - jours du mois
  • wd - jours de la semaine
  • h - heures
  • m - minutes
  • s ¨C secondes

<filter> est utilis¨¦ pour sp¨¦cifier les valeurs du pr¨¦fixe (jours, heures, minutes, secondes) et est d¨¦fini comme : [<from>[-<to>]][/<step>][,<filter>] o¨´ :

  • <from> et <to> d¨¦finissent la plage de valeurs correspondantes (incluses). Si <to> est omis alors le filtre correspond ¨¤ une plage <from> - <from>. Si <from> est ¨¦galement omis, le filtre correspond ¨¤ toutes les valeurs possibles.
  • <step> d¨¦finit les sauts de la valeur num¨¦rique dans la plage. Par d¨¦faut, <step> a la valeur 1, ce qui signifie que toutes les valeurs de la plage d¨¦finie correspondent.

Alors que les d¨¦finitions de filtre sont facultatives, au moins un filtre doit ¨ºtre utilis¨¦. Un filtre doit avoir une plage ou la valeur <step> »å¨¦´Ú¾±²Ô¾±±ð.

Un filtre vide correspond ¨¤ '0' si aucun filtre de niveau inf¨¦rieur n'est d¨¦fini ou ¨¤ toutes les valeurs possibles dans le cas contraire. Par exemple, si le filtre d'heure est omis, seule l'heure '0' correspondra, ¨¤ condition que les filtres minutes et secondes soient ¨¦galement omis, sinon un filtre d'heures vide correspondra ¨¤ toutes les valeurs d'heure.

Les valeurs <from> et <to> valides pour leur pr¨¦fixe de filtre respectif sont :

±Ê°ù¨¦´Ú¾±³æ±ð Description <from> <to>
md Jour du mois 1-31 1-31
wd Jour de la semaine 1-7 1-7
h Heures 0-23 0-23
m Minutes 0-59 0-59
s Secondes 0-59 0-59

La valeur <from> doit ¨ºtre inf¨¦rieure ou ¨¦gale ¨¤ la valeur <to>. La valeur <step> doit ¨ºtre sup¨¦rieure ou ¨¦gale ¨¤ 1 et inf¨¦rieure ou ¨¦gale ¨¤ <to> - <from>.

La valeur des jours, des heures, des minutes et des secondes ¨¤ un seul chiffre peuvent ¨ºtre pr¨¦fix¨¦es avec 0. Par exemple, md01-31 et h/02 sont des intervalles valides, mais md01-031 et wd01-07 ne le sont pas.

Dans l'interface Áú»¢¶Ä²©, plusieurs intervalles de planification sont entr¨¦s dans des lignes s¨¦par¨¦es. Dans l'API Áú»¢¶Ä²©, ils sont concat¨¦n¨¦s en une seule cha?ne avec un point-virgule ; en tant que s¨¦parateur.

Si un instant correspond ¨¤ plusieurs intervalles, il n'est ex¨¦cut¨¦ qu'une seule fois. Par exemple, wd1h9;h9 ne sera ex¨¦cut¨¦ qu'une seule fois le lundi ¨¤ 9h.

Exemples :

Intervalle Description
m0-59 ex¨¦cut¨¦ chaque minute
h9-17/2 ex¨¦cut¨¦ toutes les 2 heures en commen?ant ¨¤ 9:00 (9:00, 11:00 ...)
m0,30 or m/30 ex¨¦cut¨¦ toutes les heures ¨¤ hh:00 et hh:30
m0,5,10,15,20,25,30,35,40,45,50,55 or m/5 toutes les 5 minutes
wd1-5h9 du lundi au vendredi ¨¤ 9:00
wd1-5h9-18 du lundi au vendredi ¨¤ 9:00,10:00,...,18:00
h9,10,11 or h9-11 chaque jour ¨¤ 9:00, 10:00 et 11:00
md1h9m30 chaque premier jour de chaque mois ¨¤ 9:30
md1wd1h9m30 chaque premier jour de chaque mois ¨¤ 9:30 si c'est un lundi
h9m/30 ex¨¦cut¨¦ ¨¤ 9:00, 9:30
h9m0-59/30 ex¨¦cut¨¦ ¨¤ 9:00, 9:30
h9,10m/30 ex¨¦cut¨¦ ¨¤ 9:00, 9:30, 10:00, 10:30
h9-10m30 ex¨¦cut¨¦ ¨¤ 9:30, 10:30
h9m10-40/30 ex¨¦cut¨¦ ¨¤ 9:10, 9:40
h9,10m10-40/30 ex¨¦cut¨¦ ¨¤ 9:10, 9:40, 10:10, 10:40
h9-10m10-40/30 ex¨¦cut¨¦ ¨¤ 9:10, 9:40, 10:10, 10:40
h9m10-40 ex¨¦cut¨¦ ¨¤ 9:10, 9:11, 9:12, ... 9:40
h9m10-40/1 ex¨¦cut¨¦ ¨¤ 9:10, 9:11, 9:12, ... 9:40
h9-12,15 ex¨¦cut¨¦ ¨¤ 9:00, 10:00, 11:00, 12:00, 15:00
h9-12,15m0 ex¨¦cut¨¦ ¨¤ 9:00, 10:00, 11:00, 12:00, 15:00
h9-12,15m0s30 ex¨¦cut¨¦ ¨¤ 9:00:30, 10:00:30, 11:00:30, 12:00:30, 15:00:30
h9-12s30 ex¨¦cut¨¦ ¨¤ 9:00:30, 9:01:30, 9:02:30 ... 12:58:30, 12:59:30
h9m/30;h10 ex¨¦cut¨¦ ¨¤ 9:00, 9:30, 10:00