Áú»¢¶Ä²©

This is a translation of the original English documentation page. Help us make it better.

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

Custom intervals correlation

Keep in mind that when configuring custom intervals the value of Update interval is taken into account. The following table shows correlation between custom intervals and Update interval.

Update interval Flexible Scheduling Result
0 Error
0 non-zero Flexible
0 non-zero Scheduling
non-zero Update interval
non-zero non-zero Flexible
non-zero non-zero Update interval and Scheduling