DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Planning
  • Présentation
  • Champ d'une fenêtre, d'une page ou d'un état
  • Création d'un champ Planning (Editeur de fenêtres et de pages)
  • Description d'un planning (Editeur de fenêtres et de pages)
  • Les options du champ (éditeur de fenêtres et de pages)
  • Un menu contextuel proposé automatiquement
  • Un rendez-vous supprimable
  • Modes de remplissage d'un champ Planning
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation

Champ d'une fenêtre, d'une page ou d'un état

Le champ Planning permet d'afficher et de manipuler des plannings automatiquement. Il permet de gérer l'affichage de ressources multiples et trouve sa place dans de nombreuses applications ou sites.
L'affichage s'effectue :
  • à la journée, à la semaine, au mois,
  • WINDEV sur 6 mois ou sur 1 an.
La plage horaire, le premier jour de la semaine, le nombre de jours à afficher sont paramétrables. Ces paramètres se définissent simplement depuis la fenêtre de description du champ.
WINDEVWEBDEV - Code Serveur Remarque : Les champs Planning sont également disponibles dans les états de type Planning. Pour plus de détails sur le fonctionnement des plannings dans les états, consultez Etat de type Planning.
Création d'un champ Planning (Editeur de fenêtres et de pages)
Pour créer un champ Planning :
  1. Sous le volet "Création", dans le groupe "Champs graphiques", déroulez "Temps" et sélectionnez "Planning".
  2. Cliquez dans la fenêtre ou la page à la position où le champ doit être créé.
  3. WINDEVWEBDEV - Code Serveur L'assistant de création du champ Planning se lance. Répondez aux différentes questions et validez.
  4. Le champ apparaît en création.
Remarque : Les dimensions du champ créé sont optimisées pour occuper l'espace disponible à la position indiquée. Si la taille du champ ne vous convient pas, utilisez la combinaison de touches Ctrl + Z : le champ retrouvera sa taille par défaut.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ.
Description d'un planning (Editeur de fenêtres et de pages)

Les options du champ (éditeur de fenêtres et de pages)

Le champ Planning peut être paramétré directement sous l'éditeur grâce à la fenêtre de description.
Dans l'onglet "Général", il est possible de spécifier la fenêtre ou la page interne à utiliser pour personnaliser l'affichage des rendez-vous. Pour plus de détails, consultez Champ Planning : Personnalisation des rendez-vous.
Dans l'onglet "Détail", les paramètres du champ Planning sont les suivants :
  • Avec boutons de changement de période : Cette option permet d'afficher des boutons afin que l'utilisateur puisse faire défiler les différentes périodes du planning. Ces boutons sont affichés en haut à gauche du planning.
    AndroidiPhone/iPad Cette option n'est pas disponible. En effet, le changement de période se fait grâce à un mouvement de balayage horizontal sur le champ Planning.
  • WEBDEV - Code ServeurAndroidiPhone/iPadPHP Nombre de jours à afficher : Par défaut, l'affichage est réalisé au mois, mais il est également possible d'afficher un planning à la journée, à la semaine (sur 5 ou 7 jours), selon le nombre de rendez-vous, ou selon le nombre de jours spécifié.
  • WINDEV Affichage : Par défaut, l'affichage est réalisé au mois, avec des granularités de déplacement et de durée d'un jour. En cliquant sur les options d'affichage, une fenêtre s'affiche permettant de définir les différentes options d'affichage :
    Il est possible de définir les éléments suivants :
    • Plage totale du planning : journée, semaine (sur 5 ou 7 jours), selon le nombre de rendez-vous, selon le nombre de jours, 6 mois, un an.
    • Granularité des rendez-vous : Correspond à la précision d'affichage du planning. Les rendez-vous peuvent commencer sur un multiple de XX minutes, heures, ... et avoir une durée multiple de XX minutes, heures, ... Le bouton fléché permet de saisir des valeurs prédéfinies. Le verrou permet de lier ou non les valeurs.
    • Plage visualisée : La plage visualisée est calculée à partir de la taille du champ sous l'éditeur. En saisissant la plage à visualiser, vous obtenez la dimension minimale de l'élément selon l'unité choisie.
    • A la validation de cette fenêtre, les caractéristiques sélectionnées sont résumées dans la fenêtre de description du champ.
  • Mode d'affichage des ressources : Par défaut, les ressources sont affichées en ligne.
    WINDEVWEBDEV - Code ServeurPHP Il est également possible de les afficher en colonne.
  • Affichage du temps : Permet de définir :
    • le format de la date affichée pour les colonnes (ou les lignes) "jour" du planning.
    • si l'heure doit être affichée ou non dans le champ.
    • le format de l'heure affichée pour les colonnes (ou les lignes) "jour" du planning.
    • si le numéro de semaine doit être affiché ou non, ainsi que son format. Dans le format, la chaîne '%1' correspond au numéro de semaine. Exemple de format : "Sem. %1".
  • Plage horaire : Permet de définir :
    • la plage horaire visible : Plage horaire qui sera affichée dans le champ.
    • la plage horaire ouvrable : Plage horaire pour laquelle un rendez-vous pourra être défini.
    WINDEV Pour définir des plages horaires spécifiques, utilisez les fonctions PlanningHeureOuvrable et PlanningHeureOuvrableRessource.
  • Rendez-vous : Permet de spécifier les caractéristiques des rendez-vous :
    • WINDEVWEBDEV - Code ServeurPHP Chevauchement : Gestion des chevauchements des rendez-vous. Les rendez-vous peuvent être affichés côte à côte ou légèrement décalés.
    • WEBDEV - Code ServeurAndroidiPhone/iPad Granularité d'un rendez-vous : Précision d'affichage du planning. Par défaut, la granularité est de 30 minutes.
      Il est possible de définir :
      • la granularité de déplacement d'un rendez-vous.
      • la granularité de durée d'un rendez-vous, c'est-à-dire la durée minimale d'un rendez-vous. Attention : par défaut, cette durée est de 24 heures.
    • WINDEViPhone/iPad Affichage continu si plusieurs jours : Permet d'afficher un rendez-vous sur plusieurs jours comme un seul rendez-vous. Si cette option est décochée, les rendez-vous sur plusieurs jours correspondront à autant de rendez-vous qu'il y a de jours.
  • Autres paramètres :
    • WINDEV Autoriser la sélection de périodes : Permet à l'utilisateur de sélectionner une période à l'aide de la souris.
    • Autoriser la saisie directe d'un rendez-vous : Permet à l'utilisateur d'ajouter directement un rendez-vous.
      WINDEVWEBDEV - Code ServeurPHP Il suffit de cliquer dans le champ Planning pour créer le rendez-vous et de saisir directement son libellé au clavier.
      AndroidiPhone/iPad Il suffit de cliquer dans le champ Planning. Un bouton "+" apparaît dans la zone sélectionnée. En cliquant sur ce bouton "+", l'événement "Avant création du rendez-vous" est exécuté. Il est possible d'ouvrir une fenêtre pour saisir les caractéristiques du rendez-vous. Pour plus de détails, consultez Evénements associés à un champ Planning.
    • WINDEVWEBDEV - Code ServeurPHP Afficher et autoriser les rendez-vous à la journée entière : Permet d'indiquer qu'un rendez-vous peut correspondre à une journée entière. Dans ce cas, une zone spécifique est affichée dans le champ Planning. Cette zone permet de saisir les rendez-vous à la journée.
      WINDEV Il est possible de spécifier la hauteur de la zone.
      Exemples :
      • si le planning est affiché avec les ressources en ligne :
        • WINDEV En WINDEV :
        • WEBDEV - Code ServeurPHP En WEBDEV :
      • si le planning est affiché avec les ressources en colonne :
        • WINDEV En WINDEV :
        • WEBDEV - Code ServeurPHP En WEBDEV :
Les options d'édition à la souris sont les suivantes :
  • WINDEVWEBDEV - Code ServeurPHP Modification de la durée. Il est possible d'autoriser ou non l'utilisateur à modifier la durée d'un rendez-vous.
  • Déplacement. Il est possible d'autoriser ou non l'utilisateur à déplacer un rendez-vous.
  • WINDEVAndroidiPhone/iPad Autoriser le changement de ressource par l'utilisateur. Si cette option est cochée, l'utilisateur pourra lors du déplacement d'un rendez-vous l'associer à une ressource différente.
  • WINDEVAndroidiPhone/iPad Autoriser le chevauchement par l'utilisateur. Si cette option est cochée, l'utilisateur pourra lors du déplacement de rendez-vous les faire se chevaucher. Dans ce cas, les options définies pour le chevauchement des rendez-vous (décalage ou côte à côte) seront prises en compte.
Les options concernant la dimension des zones sont les suivantes :
  • WINDEVWEBDEV - Code ServeurPHP si les ressources sont affichées en ligne :
    • WEBDEV - Code ServeurPHP Largeur minimale d'une heure. La largeur de la journée est calculée en fonction du nombre d'heures affichées.
    • Hauteur minimale d'une ressource.
    • Largeur de l'entête des ressources.
  • WINDEVWEBDEV - Code ServeurPHP si les ressources sont affichées en colonne :
    • Largeur minimale d'une ressource.
    • WEBDEV - Code ServeurPHP Hauteur minimale d'une heure. La hauteur de la journée est calculée en fonction du nombre d'heures affichées.
    • Hauteur de la rupture (pour le changement de journée)
  • AndroidiPhone/iPad les ressources sont toujours affichées en ligne. Il est possible de paramétrer les éléments suivants :
    • Hauteur d'une ressource.
    • Largeur de l'en-tête des ressources.
La plupart de ces paramètres sont modifiables par programmation. Pour plus de détails, consultez Propriétés associées au champ Planning.
WINDEV

Un menu contextuel proposé automatiquement

Le champ Planning peut afficher un menu contextuel spécifique proposant des fonctionnalités automatiques à l'utilisateur. Ce menu est proposé par les FAA (Fonctionnalités Automatiques de vos Applications).
A partir du moment où au moins une ressource est présente dans le planning, ce menu permet à l'utilisateur de :
  • Modifier le mode d'affichage du planning : affichage au jour, à la semaine, au mois ou encore affichage uniquement de la journée en cours.
  • Ajouter, supprimer ou modifier un rendez-vous lors de la sélection d'une plage horaire.
  • Copier le contenu d'un rendez-vous.
  • Imprimer le contenu du champ Planning.
Pour plus de détails sur les fonctionnalités de ce menu contextuel (notamment l'impression), consultez Fonctionnalités automatiques du champ Planning.
WEBDEV - Code Serveur

Un rendez-vous supprimable

Le champ Planning donne à l'utilisateur la possibilité de supprimer le rendez-vous sélectionné grâce à la croix rouge affichée en haut à droite du rendez-vous.
Lorsque l'utilisateur clique sur cette croix :
  • le rendez-vous est supprimé du champ Planning.
  • si le champ Planning est lié à un fichier de données ou à une variable, le rendez-vous est supprimé du fichier de données.
Remarque : Si le champ est lié à une variable ou un fichier de données, il est possible de ne pas autoriser la suppression (option "Autoriser la suppression (supprime aussi dans la source de données)" dans l'onglet "Contenu" de la fenêtre de description du champ).
Liste des exemples associés :
WD Planning Exemples complets (WINDEV) : WD Planning
[ + ] Cet exemple illustre la gestion d'un planning graphique.

Dans cet exemple, nous abordons les principaux thèmes suivants :
1/ le champ planning
2/ les fonctions Google agenda
Le champ Planning Exemples unitaires (WEBDEV) : Le champ Planning
[ + ] Utilisation du champ Planning. Deux utilisations sont présentées :
- Remplissage du planning par programmation,
- Remplissage du planning par databinding à partir d'une variable du code.
WW_Planning Exemples complets (WEBDEV) : WW_Planning
[ + ] Cet exemple permet d'afficher de façon dynamique les tâches des différents collaborateurs.
Il est possible d'ajouter, de modifier ou de supprimer des tâches dans le planning, simplement en cliquant sur les éléments du planning.
Toutes les manipulations sont effectuées grâce à AJAX.
Cet exemple utilise également le déplacement de champ par programmation.
Version minimum requise
  • Version 16
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 07/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale