Documentation
Widgets, Raccourcis et automatisations
Ajouter, créer, lire, exporter ou supprimer des données DataJot avec les widgets, Raccourcis et les App Intents.
Mis à jour le 17 juillet 2026
L’une des forces de DataJot est de ne pas vous obliger à saisir chaque valeur à la main. Une fois la série créée, vous pouvez ajouter des mesures depuis un widget, depuis un raccourci manuel ou depuis une automatisation Raccourcis.
Avant de configurer un widget ou un raccourci, créez d’abord la série qui recevra les mesures. La page Séries détaille cette étape.
Ajouter une mesure sans ouvrir l’app
L’action la plus importante est l’ajout de mesure. Elle reçoit une série cible et une valeur numérique, puis DataJot ajoute cette valeur dans l’historique de la série.
Pour un compteur, la valeur peut être fixe. Par exemple, un raccourci “Ajouter un café” peut ajouter 1 à la série “Cafés”.
Pour une valeur variable, le raccourci peut demander la valeur avant de l’envoyer à DataJot. C’est plus adapté à une température, un poids, un relevé de compteur ou une mesure que vous lisez manuellement.
Actions disponibles dans Raccourcis
DataJot expose plusieurs App Intents dans l’app Raccourcis. Certains ciblent directement une série sélectionnée, d’autres ciblent la première série dont la clé correspond. Les actions par clé sont pratiques pour les automatisations stables, car elles ne dépendent pas du nom affiché de la série.
Ajouter des valeurs
AddMeasureIntent
Nom affiché: Ajouter une valeur
Description
Ajoute une nouvelle valeur à une série sélectionnée. Sert aussi à configurer le widget d’ajout.
Paramètres
series obligatoire, newValue avec 1.0 par défaut, date optionnelle.
Retour / effet
Crée une mesure. Si date est vide, DataJot utilise la date courante. Recharge les timelines WidgetKit.
AddMeasureByKeyIntent
Nom affiché: Ajouter une valeur par clé de série
Description
Ajoute une valeur à la première série dont la clé correspond.
Paramètres
seriesKey obligatoire, newValue avec 1.0 par défaut, date optionnelle.
Retour / effet
Crée une mesure sur la première série trouvée par key. Recharge les widgets.
Créer des catégories et séries
CreateCategoryIntent
Nom affiché: Créer une catégorie
Description
Crée une catégorie DataJot.
Paramètres
name obligatoire, key, descriptionText, color optionnels.
Retour / effet
Retourne une CategoryEntity. Le nom et la clé sont nettoyés ; un nom vide est refusé.
CreateSeriesIntent
Nom affiché: Créer une série
Description
Crée une série DataJot complète.
Paramètres
name obligatoire, puis key, category, descriptionText, unitLabel, iconName, color, precision, aggregationMethod, chartType, defaultView optionnels.
Retour / effet
Retourne une SeriesEntity. Si unitLabel est fourni, une unité personnalisée 1:1 est créée.
CreateSeriesFromTemplateIntent
Nom affiché: Créer une série à partir d’un modèle
Description
Crée une série DataJot depuis un modèle.
Paramètres
template obligatoire, category, nameOverride optionnels.
Retour / effet
Retourne une SeriesEntity. DataJot charge les modèles selon la locale courante (fr ou en), réutilise les unités et configurations existantes quand possible, puis supprime la clé du modèle pour la nouvelle série.
Lire les séries et les agrégats
FetchSeriesListIntent
Nom affiché: Récupérer les séries
Description
Récupère les séries, éventuellement filtrées par catégorie.
Paramètres
category optionnelle.
Retour / effet
Retourne [SeriesEntity], triées par nom.
FetchSeriesAggregateIntent
Nom affiché: Récupérer l’agrégat d’une série
Description
Récupère le dernier agrégat non vide d’une série.
Paramètres
series obligatoire, from, to optionnels, granularity avec day par défaut, aggregationMethod optionnelle.
Retour / effet
Retourne SeriesAggregateEntity avec série, période, granularité, méthode, date, valeur et nombre de mesures. Fenêtre par défaut : les 30 derniers jours si aucune date n’est fournie.
FetchSeriesAggregateByKeyIntent
Nom affiché: Récupérer l’agrégat par clé de série
Description
Même logique que FetchSeriesAggregateIntent, mais cible la première série correspondant à une clé.
Paramètres
seriesKey obligatoire, from, to, granularity, aggregationMethod.
Retour / effet
Retourne SeriesAggregateEntity.
Exporter et supprimer des mesures
ExportSeriesCSVIntent
Nom affiché: Exporter la série au format CSV
Description
Exporte une série en CSV.
Paramètres
series obligatoire, scope avec all par défaut, from, to optionnels.
Retour / effet
Retourne un IntentFile CSV. Le scope all ignore les dates ; le scope period exige au moins from ou to. Les bornes seules sont acceptées.
ExportSeriesCSVByKeyIntent
Nom affiché: Exporter la série au format CSV par clé de série
Description
Même export que ExportSeriesCSVIntent, mais par clé de série.
Paramètres
seriesKey obligatoire, scope, from, to.
Retour / effet
Retourne un fichier CSV pour la première série dont la clé correspond.
DeleteSeriesMeasuresIntent
Nom affiché: Supprimer les valeurs d’une série
Description
Supprime toutes les valeurs d’une série ou celles d’une période.
Paramètres
series obligatoire, scope avec all par défaut, from, to.
Retour / effet
Retourne SeriesMeasureDeletionResultEntity avec la série et le nombre de mesures supprimées. Le scope period exige from et to. Recharge les widgets.
DeleteSeriesMeasuresByKeyIntent
Nom affiché: Supprimer les valeurs par clé de série
Description
Même suppression que DeleteSeriesMeasuresIntent, mais par clé de série.
Paramètres
seriesKey obligatoire, scope, from, to.
Retour / effet
Supprime les mesures de la première série dont la clé correspond et retourne le nombre supprimé.
Automatiser une mesure
Une automatisation Raccourcis permet d’ajouter une mesure sans intervention au moment de l’enregistrement.
Par exemple, vous pouvez créer une automatisation qui se déclenche à heure fixe, lit ou demande une valeur, puis l’ajoute à la bonne série DataJot. Le but est de réduire la saisie répétitive : DataJot reçoit la valeur, l’enregistre avec une date, puis l’historique reste consultable dans l’app.
Commencez simple. Testez d’abord le raccourci manuellement, vérifiez que la mesure arrive dans la bonne série, puis seulement ensuite utilisez-le dans une automatisation.
Widget d’ajout rapide
Le widget d’ajout de mesure sert aux valeurs que vous ajoutez souvent.
Si vous suivez les cafés, vous pouvez configurer un widget avec la série “Cafés” et la valeur 1. Chaque appui ajoute une mesure. Avec une agrégation en somme, DataJot peut ensuite afficher le total du jour ou de la semaine.
Ce widget est disponible en petit et moyen format. Il affiche aussi la valeur agrégée du jour pour la série configurée.
Widget graphique
Le widget graphique sert à consulter une série rapidement depuis l’écran d’accueil.
Vous choisissez une série et une plage : jour, semaine, mois, six mois ou année. Le widget affiche le graphique correspondant et la dernière valeur disponible.
En moyen et grand format, il peut aussi afficher des statistiques selon la configuration de la série. En petit format, l’affichage est plus compact.
Exemples utiles
Un compteur d’habitude peut utiliser une valeur fixe de 1.
Une mesure de poids peut demander la valeur au moment du raccourci.
Une mesure relevée régulièrement peut être ajoutée par une automatisation, à condition que le raccourci fournisse une valeur numérique fiable.
Dans tous les cas, gardez des noms de séries explicites. C’est ce qui rend les widgets et les raccourcis plus faciles à configurer sans se tromper de destination.