Cet article explique comment créer des Champs de données Cloudbeds (CDF) formulés dans les Rapports Cloudbeds, incluant à la fois les champs calculés basiques et les Formules avancées.
Les CDF formulés te permettent de créer des colonnes personnalisées en utilisant des Champs de données Cloudbeds (CDF) existants, ce qui rend possible des calculs ou des résultats descriptifs qui ne sont pas disponibles par défaut dans les rapports standards.
Les Formules avancées étendent cette fonctionnalité en supportant une logique au niveau de la ligne, des conditions basées sur CASE, ainsi que des résultats numériques ou textuels. Cela te permet de construire une logique plus flexible et basée sur des règles, comme des indicateurs d’arrivée ou de départ, des comptages conditionnels, ou des drapeaux personnalisés directement dans un rapport, sans avoir à exporter les données.
Notes :
- Il n’est pas possible de joindre des CDF provenant de différents types de rapports.
- Tu peux créer des CDF formulés lors de la personnalisation des Rapports Cloudbeds ou en modifiant un rapport enregistré.
Vérifié : registre 'vous' cohérent, aucun anglicisme injustifié, 'carrousel' utilisé pour 'slider', 'téléverser' utilisé pour l'upload, 'rapport d'aspect' cohérent, 'widget' en minuscules, liste des faux amis vérifiée, accord en genre/nombre correct, casse de phrase appliquée aux titres, capitalisation des libellés d'interface cohérente, 'établissement' utilisé pour 'property', phrases complètes vérifiées, erreurs sources signalées.
- Dans le rapport, cliquez sur formulated CDF.
-
- L’option formulated CDF se trouve également dans la section Colonnes en cliquant sur +Ajouter.
Si vous ne voyez pas l’option formulated CDF, cela peut signifier deux choses — vérifiez les raisons et solutions ci-dessous :
- Si vous consultez l’un des rapports Cloudbeds, cliquez sur Enregistrer sous pour personnaliser le rapport.
- Si vous créez un nouveau rapport mais ne l’avez pas encore enregistré, assurez-vous qu’au moins une colonne est ajoutée au schéma de table, puis cliquez sur Enregistrer. Consultez comment créer vos propres rapports.
- Cliquez sur Ajouter+.
- Ajoutez un nom et une description pour le nouveau formulated CDF.
- Sélectionnez le type de données :
- Chaîne de caractères : Ce type de données vous permet de combiner plusieurs dimensions en une seule colonne.
- Row-level calculated CDF / Aggregation calculated CDF : Ces types de données vous permettent de créer des équations avec vos métriques et de choisir le format (nombre, pourcentage ou devise). Utilisez les symboles mathématiques pour joindre deux CDF existants.
Important à savoir :
- Métriques : Données numériques pouvant être additionnées, comptées ou moyennées.
- Dimensions : Données non numériques telles que des champs de saisie textuelle.
- Sélectionnez le champ de données que vous souhaitez utiliser dans la barre de recherche ou en regardant la liste des champs.
- Cliquez sur Ajouter.
- Cliquez sur Enregistrer.
Ajouter le CDF formulé au Schéma de table
- Cliquez sur Schéma.
- Dans la section Colonnes, cliquez sur +Ajouter.
- Sélectionnez le nouveau CDF formulé en cochant la case.
- Exécutez le rapport. Vous verrez maintenant la nouvelle colonne avec le CDF formulé.
Une fois que vous avez créé et ajouté un Champ de données Cloudbeds formulé à votre rapport, vous pouvez utiliser les Formules avancées pour construire une logique conditionnelle adaptée à vos besoins de reporting.
Ce type de logique est couramment utilisé pour créer des indicateurs personnalisés et des colonnes calculées telles que :
- Indicateurs d’arrivée ou de départ
- Comptages conditionnels (par exemple, compter uniquement les réservations confirmées ou enregistrées)
- Champs personnalisés de statut ou de classification pour le reporting opérationnel ou analytique
Les Formules avancées sont créées en sélectionnant Formule au niveau de la ligne comme Type lors de la création d’un CDC formulé.
Créer une formule avancée (au niveau de la ligne)
Suivez les étapes ci-dessous pour créer une formule avancée en utilisant une logique au niveau de la ligne et des conditions CASE.
- Ouvrez les Colonnes formulées et cliquez sur Ajouter + pour créer une nouvelle colonne formulée.
- Saisissez un Nom et une Description facultative pour identifier clairement l’objectif de la formule.
- Dans Type, sélectionnez Formule au niveau de la ligne. Cette option permet une logique conditionnelle évaluée pour chaque ligne du rapport.
- Dans Retourner le résultat en, choisissez le format de sortie : Nombre (pour les calculs et agrégations) ou Texte (pour des valeurs descriptives).
- Dans Formule, sélectionnez Case. Le générateur de formule affichera une structure CASE avec les sections WHEN, THEN et ELSE.
- Cliquez sur Ajouter pour définir plus de condition(s).
- Utilisez Correspondre à toutes ou Correspondre à une pour contrôler la manière dont plusieurs conditions sont évaluées :
- Correspondre à toutes : Toutes les conditions doivent être vraies pour que le résultat s’applique.
- Correspondre à une : Au moins une condition doit être vraie pour que le résultat s’applique.
- Définis les valeurs à retourner :
- Sous QUAND, spécifie la ou les condition(s) qui doivent être remplies.
- Sous ALORS, définis le résultat retourné (valeur) lorsque la condition est remplie.
- Sous SINON, définis le résultat retourné (valeur) lorsque la condition n’est pas remplie.
- Ajoute des règles de condition en sélectionnant un champ de données, un opérateur et une valeur. Utilise Ajouter une règle pour inclure des conditions supplémentaires dans le même bloc QUAND.
- Clique sur Enregistrer pour créer la formule avancée.
Définis toujours une valeur SINON. Cela évite d’obtenir des résultats vides (nuls) pour les lignes qui ne correspondent à aucune condition QUAND.
Les résultats numériques peuvent être agrégés (par exemple, additionnés ou moyennés), tandis que les résultats textuels servent de dimensions descriptives dans les rapports.
Les champs de données Cloudbeds formulés (CDF) peuvent utiliser une logique de date relative pour catégoriser automatiquement les enregistrements en fonction de conditions temporelles.
Cela permet aux rapports de se mettre à jour automatiquement sans nécessiter d’ajustements quotidiens des filtres. Par exemple, tu peux catégoriser les réservations selon que la date de séjour soit antérieure de plus de 7 jours à aujourd’hui.
Les cas d’utilisation courants incluent :
- Le vieillissement des revenus ou des soldes de folio
- L’analyse de la fenêtre de réservation
- Le regroupement automatique des séjours historiques vs à venir
- Les classifications opérationnelles basées sur le temps
Exemple de scénario
Tu souhaites qu’un rapport catégorise automatiquement les réservations selon que la date de séjour soit antérieure de plus de 7 jours.
Tu peux créer une formule qui compare la date de séjour à une date relative telle que Aujourd’hui − 7 jours.
Comment créer une classification par date relative
- Va dans Reporting → Cloudbeds Insights.
- Clique sur Ajouter → Rapport.
- Sélectionne le type de rapport approprié (par exemple Réservations ou Financier).
- Ajoute un champ de date tel que Date de séjour ou Date de service au Schéma de table.
- Ajoute les métriques nécessaires à ton analyse.
- Enregistre le rapport.
- Ajoute un Champ de données Cloudbeds formulé (CDF).
- Crée une formule CASE ou IF qui compare le champ de date à une date relative (par exemple, 7 jours avant aujourd’hui).
- Ajoute le nouveau CDF à ton rapport en tant que colonne, groupe ou filtre.
Le rapport catégorisera désormais automatiquement les enregistrements selon la formule, sans nécessiter de mises à jour manuelles.
Note :
Si ton compte n’a pas les CDF formulés activés, utilise plutôt les filtres de date relative dans l’interface utilisateur.
Exemple : Indicateur d’arrivée (1 = arrivée, 0 = pas une arrivée)
Ce exemple montre comment créer un indicateur d’arrivée à l’aide d’une formule avancée. Un indicateur d’arrivée est utile dans les rapports hôteliers car il te permet d’identifier rapidement et de compter les réservations qui doivent arriver à une date de séjour spécifique.
Les établissements utilisent couramment un indicateur d’arrivée pour :
- Préparer les listes d’arrivées quotidiennes pour la Réception et les Opérations (planification du personnel, préparation des chambres, organisation des clients)
- Mesurer les tendances du volume d’arrivées dans le temps
- Construire des tableaux de bord qui distinguent les arrivées des clients en séjour ou en départ
La formule renvoie 1 lorsqu’une réservation correspond à tes règles d’arrivée et 0 sinon. Comme le résultat est numérique, la colonne peut être sommer pour calculer le total des arrivées dans un rapport.
Vérifié : registre 'vous' cohérent, aucun anglicisme injustifié, 'carrousel' utilisé pour 'slider', 'téléverser' utilisé pour l'upload, 'rapport d'aspect' cohérent, 'widget' en minuscules, liste des faux amis vérifiée, accord en genre/nombre correct, casse de phrase appliquée aux titres, capitalisation des libellés d'interface cohérente, 'établissement' utilisé pour 'property', phrases complètes vérifiées, erreurs sources signalées.- Créez une nouvelle colonne formulée nommée Arrivée.
- Définissez le Type sur Formule au niveau de la ligne.
- Définissez Retourner le résultat en sur Nombre.
- Dans Formule, sélectionnez Case, puis configurez la logique CASE :
-
QUAND (Correspondre à tout) : Ajoutez les conditions qui représentent une arrivée dans votre établissement. Une approche courante est la suivante :
- La date de check-in est égale à la Date du Séjour (ou au champ de date sélectionné dans le rapport)
- Le statut de la réservation est un statut actif pertinent pour les arrivées (par exemple, Confirmation en attente, Confirmée, et En séjour)
- ALORS : 1
- SINON : 0
-
QUAND (Correspondre à tout) : Ajoutez les conditions qui représentent une arrivée dans votre établissement. Une approche courante est la suivante :
- Cliquez sur Enregistrer.
Le champ de date exact et les statuts de réservation disponibles peuvent varier selon le type de rapport. Si tes résultats te semblent inattendus, vérifie que tu utilises le bon champ de date (séjour vs. réservation) et l’ensemble de statuts prévu.
Ajouter la formule avancée au rapport
Après avoir enregistré une formule avancée, ajoute-la au tableau du rapport pour qu’elle apparaisse comme une nouvelle colonne dans tes résultats.
- Ouvre Plan.
- Dans la section Colonnes, clique sur + Ajouter.
- Sous Formulées, sélectionne la case à cocher pour la formule que tu as créée (par exemple, Arrivée).
- Lance le rapport pour confirmer que la nouvelle colonne est visible et renvoie des valeurs.
Les champs de données Cloudbeds formulés existent uniquement dans le rapport où ils ont été créés.
Si tu essaies de supprimer un CDC actuellement utilisé dans le rapport, le système empêchera la suppression.
Pour supprimer le champ :
- Supprime le CDC de tous les éléments du rapport.
- Enregistre le rapport.
- Supprime le CDC.
Questions fréquentes
Oui. Lors de la création d’un Champ de données Cloudbeds (CDC) formulé, tu peux choisir le format de sortie.
Formats de sortie pris en charge :
- Nombre
- Pourcentage
- Devise
Les administrateurs peuvent configurer une précision globale d’arrondi des devises dans Insights → Gérer.
Pour l’instant, il n’est pas possible de définir le nombre de décimales pour chaque CDC individuel.
Non. L’éditeur de formules ne détecte pas automatiquement les références circulaires.
Oui, mais tu dois les distinguer manuellement. Il est recommandé d’utiliser des préfixes tels que :
- Personnalisé
- Calculé
- Dérivé
Non. Cloudbeds Insights ne suit pas :
- qui a modifié une formule
- la logique précédente de la formule
Commentaires
Vous devez vous connecter pour laisser un commentaire.