« Guide du filtre Calendar-Loop » (avec invite de copier-coller)

Calendar-Loop : guide des filtres (MECE) pour _bCalendarRek_(...)

La boucle Calendar te permet d'afficher dynamiquement des rendez-vous (onOffice Appointments), par exemple tous les créneaux horaires futurs d'un bien immobilier. Pour t'aider à créer rapidement des filtres corrects, voici la référence complète et clairement structurée.

1) Démarrage rapide : exemple minimal

Période uniquement (obligatoire) :

Exemple standard (futur, non terminé, non annulé) :

2) Syntaxe du filtre (grammaire)

_bCalendarRek_("key:value;key2:op:value2;key3:a,b,c")

• ; signifie ET (toutes les conditions doivent être remplies)

• , signifie OU au sein d'une clé (au moins une valeur suffit)

• key:value est identique à key:=:value

• Pour like , tu utilises des caractères génériques : %TERMIN-SLOT%

3) MECE : quels sont les filtres disponibles ?

A) Paramètres obligatoires (exactement ces deux-là)

1. startDate:YYYY-MM-DD

2. endDate:YYYY-MM-DD

Astuce : « Uniquement futur » = startDate définir sur « aujourd’hui ».

B) Filtres API (côté serveur, performants)

B1) Indicateurs booléens (les valeurs sont MECE : {true,false})

• isCancelled:true|false

• isDone:true|false

• isRecurrent:true|false

B2) Filtres de participants (listes)

• userIds:1,2,3

• groupIds:10,11

B3) Filtres texte/type/créateur (opérateurs SQL)

Ces clés prennent en charge les opérateurs :

• subject

• notes

• type

• createdBy

Opérateurs SQL (liste MECE) :
=, !=, <, <=, >, >=, between, like, not like, in, not in

Exemples :

C) Filtres Propform/PHP (également possibles sur les champs de données)

Tout ce qui est contenu dans les data champs de l'AppointmentList peut faire l'objet d'un filtrage supplémentaire – y compris de manière imbriquée via la notation par points.

Exemples typiques :

• estate.id:12345 (Rendez-vous pour un bien immobilier)

• status.value:active

• confirmationStatus:sent

• private:false

Règle à retenir : l'API filtre ce qu'elle est capable de filtrer. Tout le reste est filtré par Propform par la suite.

4) Valeurs autorisées (MECE) pour les champs typiques

status.value

Valeurs autorisées :

• active

• completed

• canceled

• participantsAvailable

Exemple :

confirmationStatus

Valeurs autorisées :

• canceled

• confirmed

• confirmed and canceled

• not-set

• sent

Exemple :

Booléens

Autorisé : true ou false (recommandé : écrire exactement comme ceci)

5) Exemples pratiques (copier/coller)

5.1 Dates futures d'un bien immobilier, créneaux horaires uniquement

5.2 Rendez-vous futurs d'un bien immobilier fixe

5.3 Uniquement les rendez-vous d'un utilisateur / d'un groupe

5.4 L'objet doit autoriser plusieurs termes (OU)

5.5 Rendez-vous récurrents vs rendez-vous ponctuels

6) Invite de copier/coller pour l'IA (afin que les utilisateurs obtiennent des filtres clairs)

Modèle de message (il suffit de copier et de remplir) :

7) Pièges courants (en bref)

• startDate / endDate sont obligatoires, sinon (selon l'implémentation) des périodes par défaut s'appliquent ou aucun résultat n'est trouvé.

• Si tu utilises des macros telles que _Id dans le filtre, les arguments de boucle doivent être résolus au préalable (propform le fait automatiquement si tu as activé la logique de pré-résolution).

• conflicts Le champ data champ peut, selon la configuration, entraîner des réponses vides → à omettre si nécessaire.