Aller au contenu principal

Tâches planifiées

L'objectif d'une tâche planifiée est de planifier une appels récurrent vers une API externe pour récupérer des données, les mettre en correspondance et les utiliser pour créer des Enregistrements pour un Formulaire spécifique dans la base de données d'Oort.

Emplacement

Menu des tâches planifiées
Menu d'édition des tâches planifiées

Démarrage rapide / Utilisation de base

Si vous souhaitez mettre en place rapidement une tâche planifiée, vous devez d'abord définir une [Configuration API] (/features-list/api-configuration.md) pour vous authentifier auprès de l'API dont vous avez besoin. Ensuite, vous pouvez suivre les étapes suivantes.

  • Allez sur la page des paramètres des tâches planifiées
  • Cliquez sur le bouton Créer une tâche planifiée
  • Choisissez le statut actif et la configuration de l'API que vous avez créée précédemment
  • Remplissez les autres champs
  • Cliquez sur le bouton Créer

Description de la fonctionnalité

NomLe nom de la tâche planifiée afin de l'identifier rapidement.
StatutLe statut est utilisé pour conserver la configuration d'une tâche planifiée sans pour autant l'éxécuter.
Seul l'état = actif permet de lancer les tâches planifiées.
Horaire planifiéIl s'agit d'une expression de programmation cron utilisée pour indiquer à quelle fréquence la tâche planifiée sera répétée.
L'exemple le plus simple est * * * * * qui déclenchera un appel toutes les minutes. Pour une programmation plus avancée, consultez ce lien.
Configuration d'API nécessaireLa Configuration d'API nécessaire pour s'authentifier auprès de l'API utilisée pour les requêtes.
Convertir enLe Formulaire cible utilisé pour la création des enregistrements. Chaque enregistrement créé à partir des données de l'API externe sera un enregistrement de ce formulaire.
Notifier surSi un Canal est sélectionné, une notification sera envoyée à ce canal chaque fois qu'une requête entraînera la création d'un ou plusieurs nouveaux enregistrements.
CorrespondanceLa table de correspondance permettant de convertir les données externes en enregistrements du formulaire cible.
Il y a deux modes d'édition, un mode avec une interface contextuelle et un autre brut pour pouvoir copier-coller des JSON.
Identificateurs uniquesLes identificateurs uniques permettent de définir les champs qui seront utilisés afin d'éviter la duplication d'enregistrement lors de requêtes successives..