Calendriers (CALE)

Un objet Calendrier est un conteneur pour des événements de calendrier. Un événement de calendrier est un ensemble de règles obtenues en sélectionnant certains jours du calendrier. Vous pouvez insérer dans un objet calendrier autant d'événements de calendrier que nécessaire. Vous pouvez également réutiliser les événements de calendrier affectés à un calendrier lorsque vous en définissez un autre. Si vous êtes un utilisateur administrateur, vous devez définir et gérer des objets Calendrier pour l'ensemble de l'entreprise. Si vous êtes développeur et concepteur d'objet, vous pouvez affecter des calendriers à des objets pour leur appliquer des conditions de date. Ces conditions déterminent le moment où les objets doivent être exécutés ou sautés.

Classe de l'objet : Objet actif

Type d'objet/nom court : CALE

Documentation associée importante

• Les calendriers ne sont utiles que lorsque vous leur affectez des événements de calendrier. Consultez la documentation Événements de calendrier avant de commencer à travailler.
• Les rubriques suivantes contiennent des exemples sur le mode d'utilisation des conditions calendaires dans des schedules et des workflows :
  • Exemple : Planifier des tâches avec des conditions calendaires et horaires
  • Exemple : Récupérer des données, mettre à jour la base de données et envoyer un rapport

Présentation

Un calendrier doit contenir au moins un événement de calendrier. Les événements de calendrier se trouvent exclusivement dans les calendriers. Il est impossible d'accéder à des événements de calendrier sans ouvrir l'un des calendriers dans lequel ils sont utilisés. C'est la raison pour laquelle, il est pertinent de créer plusieurs calendriers simples contenant chaque événement de calendrier Non périodique, Hebdomadaire, Mensuel et Annuel. Vous pouvez ensuite créer des calendriers plus complexes les combinant via les événements de calendrier Groupe et Décalage. Cela signifie que la création d'objets calendrier se compose de plusieurs étapes. Vous pouvez l’imaginer en définissant des couches de définitions de date / heure, du plus simple au plus complexe, que vous pouvez combiner.

Exemple

1. Créez un calendrier basique définissant les jours de semaine et les weekends, chacun d'eux étant un événement de calendrier.

2. Créez ensuite la couche suivante dans un objet calendrier définissant les jours ouvrés, obtenus en soustrayant les jours fériés nationaux des jours de la semaine. Vous pouvez réutiliser l'événement Weekends du calendrier basique.

   Le système fournit des événements de calendrier standards pour les jours fériés de la plupart des pays. Vous pouvez les utiliser et les éditer, ou créer les vôtres.

3. Vous pouvez n'exécuter certaines tâches que le dernier jour du mois, à condition que ce soit un jour ouvré. Créez le calendrier à partir de celui des jours ouvrés.

4. Pour les cas où le dernier jour du mois serait un jour non ouvré, vous avez deux possibilités :

   •  Ignorer le traitement de toutes les tâches.
   •  Reporter le traitement au jour ouvré suivant.

   Définissez le calendrier en utilisant la structure du précédent.

Voici quelques cas d'application. L'objet Calendrier est un outil flexible pouvant virtuellement traiter n'importe quelle combinaison d'événements pour gérer les dates de début des exécutions.

Paramètres et calendriers standard

Le client 0 est fourni avec plusieurs calendriers et événements de calendriers standards pouvant être affectés aux objets dans tous les clients de votre système.

UC_CLIENT_SETTINGS - Divers paramètres du client contient les paramètres nécessaires aux objets Calendrier :

• Le code FIRST_DAY_OF_WEEK détermine le premier jour de la semaine, soit un lundi, soit un dimanche.
• Les codes NOW_MINUS et NOW_PLUS déterminent la période de validité des calculs de calendriers. Ils spécifient le nombre d'années passées et futures utilisées pour effectuer les calculs à partir des définitions d'événements de calendriers.

Meilleures pratiques

Créez plusieurs petits objets Calendrier contenant chacun quelques événements de calendrier, plutôt que d'en créer de complexes, plus difficiles à gérer. Cela accroît la flexibilité et permet d'obtenir des calculs de calendriers performants.

Enregistrez les événements de calendrier se référant les uns aux autres dans le même objet Calendrier, afin de faciliter leur transport, importation et exportation. Pour plus d'informations, voir Transport et Importation / exportation de calendriers.

Définir un objet calendrier

Une définition de calendrier se compose des pages suivantes :

• Pages standard toujours accessibles, quel que soit le type d'objet à définir :
• Page Général
• Page Gestion des versions
• Page Documentation

• La page spécifique à l'objet vous permettant d'ajouter des événements de calendriers. Les événements de calendrier proposés sont les suivants :

  • Événements de calendrier uniques
  • Événements de calendrier hebdomadaires
  • Événements de calendrier mensuels
  • Evénements de calendrier Groupe
  • Événements de calendrier Décalage

Pour plus d'informations, voir Exemples d'objets calendrier.

Page Calendrier

Cette page vous permet de définir les principales propriétés de l'objet. Elle se compose des éléments suivants :

Barre d'outils contenant les boutons suivants

• Modifier

  Indique si l'objet est en mode édition ou lecture seule

• Enregistrer

Volet de navigation de gauche

Ouvre les pages de définition d'objet accessibles

Section centrale principale

• Les dates sélectionnées par les événement de calendrier affectés sont en surbrillance. Vous pouvez sélectionner une autre année pour vérifier les dates dans le futur ou le passé.
• Le bouton Filtre ouvre un volet à droite, vous permettant de limiter le nombre d'entrées qui s'affichent dans le volet Événements de calendrier.

Volet Événements de calendrier

Liste des événements de calendrier affectés au calendrier, voir Événements de calendrier. Faites un clic droit sur un événement de calendrier pour ouvrir un menu contextuel contenant les fonctions disponibles pour cet événement de calendrier.

Filtrer des événements de calendrier dans un calendrier

Utilisez la fonction Filtre pour trouver l'événement de calendrier qu'il vous faut dans les calendriers contenant plusieurs événements.

1. Sélectionnez le bouton Filtre de la barre d'outils Calendrier pour ouvrir le volet de filtre.

2. Les critères de filtrage proposés sont les suivants :

   • Événements de calendrier

     Saisissez le nom ou une partie du nom de l'événement de calendrier. Par défaut, le filtre utilise des caractères génériques implicites au début et à la fin de la chaîne de caractères saisie. Par exemple, saisir WORKDAYS déclenche en réalité une recherche pour *WORKDAYS*. La liste déroulante suggère également les résultats suivants :

     • LOCAL_WORKDAYS
     • WORKDAYS_LOCAL
     • LOCAL_WORKDAYS_25

   • La période de validité expire dans

   • Non valide

     Ces options ne sont utiles que pour les événements de calendrier non périodiques. Utilisez ces options pour rechercher des événements de calendrier en fonction de leurs dates d'expiration.

   • Saisie requise

     Limitez les résultats aux événements de calendrier sélectionnant des dates comprises dans la plage de temps saisie ici. Vous disposez des options suivantes :

     • Saisissez les dates dans De et À pour spécifier une période.
     • Saisissez la même date dans les deux champs pour filtrer les événements de calendrier contenant un certain jour.
     • Saisissez une date dans l'un des champs pour filtrer les événements de calendrier avec des dates de début et de fin particulières.

3. Sélectionnez le bouton Filtre en bas du volet.

   Le contenu du volet Événements de calendrier n'affiche alors que ceux correspondant à vos critères de filtrage. La légende indique que la liste est filtrée en affichant une icône de filtre. La légende lit, par exemple, Événements de calendrier (4 sur 15). Cela signifie que ce calendrier contient 15 événements de calendrier, dont seulement 4 s'affichent actuellement en raison des paramètres de filtrage.

Dupliquer des objets Calendrier

L'exemple ci-dessous illustre le comportement du système lors de la duplication de calendriers :

• Le calendrier A contient plusieurs événements de calendrier, dont deux sont Groupe et Décalage. Les deux se réfèrent à un autre événement du calendrier A.
• Le calendrier A est dupliqué, sa copie s'appelle Calendrier B.
• Les événements de calendrier Groupe et Décalage du calendrier B ne se réfèrent pas à l'événement de calendrier de B mais à celui du calendrier A.

Pour plus d'informations, voir Dupliquer des objets.

Transport et Importation / exportation de calendriers

Lors de l'importation de calendriers, il est important de tenir compte des considérations suivantes :

• Si vous importez le calendrier A et que le calendrier B contient des événements de calendrier faisant référence à A, vous devez également importer ces événements de calendrier.
• Après l'importation, le calendrier est recalculé et des erreurs peuvent apparaître dans le fichier log. Si le calcul est effectué avant la lecture des événements de calendrier, des messages d'erreur peuvent se produire. Vous pouvez ignorer ces messages, aucune intervention manuelle n'est requise.

Pour plus d'informations, voir Importer / exporter des objets et Conteneur de transport.

Voir aussi :