Documentation
Widgets, Raccourcis et automatisations
Ajouter, consulter ou supprimer des mesures avec les widgets, Raccourcis et les App Intents.
Mis à jour le 6 septembre 2026
Les widgets et Raccourcis permettent d’utiliser une série sans ouvrir DataJot. Créez d’abord la série qui recevra les mesures.
Ajouter une mesure avec Raccourcis
- Dans l’app Raccourcis, créez un raccourci et ajoutez l’action DataJot d’ajout de mesure.
- Sélectionnez une série ou renseignez sa clé.
- Fournissez une valeur numérique et, si nécessaire, une date.
- Exécutez le raccourci, puis vérifiez la mesure dans DataJot.
Une valeur fixe, comme 1, convient à un compteur. Pour une valeur variable, ajoutez dans Raccourcis une action qui demande ou récupère la valeur avant de la transmettre à DataJot.
Une action utilisant une clé cible la première série correspondante. Les clés n’étant pas nécessairement uniques, vérifiez la destination avant d’utiliser le raccourci dans une automatisation.
Actions disponibles dans Raccourcis
Certaines actions ciblent une série sélectionnée ; d’autres utilisent sa clé. Le catalogue ci-dessous indique les paramètres et le résultat de chaque action.
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, en, de ou es), 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
- Créez et testez d’abord le raccourci manuellement.
- Dans Raccourcis, créez une automatisation avec le déclencheur souhaité.
- Ajoutez l’exécution du raccourci ou l’action DataJot configurée.
- Testez l’automatisation et vérifiez la série ciblée.
L’app Raccourcis détermine les déclencheurs disponibles et les éventuelles demandes de confirmation. DataJot reçoit uniquement les paramètres transmis à son action.
Widget d’ajout rapide
Le widget d’ajout enregistre une valeur prédéfinie dans une série. Il existe en petit et moyen format et affiche l’agrégat du jour.
Ajoutez le widget depuis l’interface système, puis modifiez-le pour sélectionner la série et la valeur numérique. Chaque appui ajoute une nouvelle mesure.
Le contenu affiché est actualisé périodiquement, environ toutes les quinze minutes. Il ne constitue pas un affichage en temps réel.
Widget graphique
Le widget graphique affiche une série sur une plage d’un jour, d’une semaine, d’un mois, de six mois ou d’un an, ainsi que sa dernière valeur disponible.
Ajoutez le widget depuis l’interface système, puis modifiez-le pour sélectionner la série et la plage. Les formats moyen et grand peuvent également afficher les statistiques activées dans la configuration de la série.
Comme le widget d’ajout, son contenu est actualisé périodiquement et non en temps réel.
Supprimer des mesures avec Raccourcis
Cette action est destructive et DataJot ne demande pas de confirmation dans Raccourcis.
- Ajoutez l’action de suppression par série ou par clé.
- Choisissez Toutes les mesures ou fournissez une période valide.
- Vérifiez la série et la période avant d’exécuter l’action.
Les mesures ciblées sont supprimées définitivement. Testez ce type de raccourci uniquement sur des données que vous pouvez perdre.