Intégrations et automatisations

La section Admin › Intégrations regroupe tout ce qui concerne les flux de données entrant et sortant d'Aptli, ainsi que toutes les règles qui s'exécutent de manière autonome. Il s'agit d'une arborescence à deux volets :

Systèmes externes : chaque système que vous connectez, ses connexions, et sous chaque connexion, les règles et les appareils qui l’utilisent.
Au sein d’Aptli : les comportements intégrés de chaque module et les règles que vous y ajoutez.

Tout · Externe · Interne, le premier bouton de la barre d’outils, affiche un côté ou les deux. Un nom ouvre son éditeur dans une fenêtre : une règle, une connexion, un système ou un comportement intégré.

État et santé

Le Statut d’une ligne indique si celle-ci est active. La Santé signale le problème le plus grave sur la ligne : exécutions ayant échoué au cours des dernières 24 heures, alarmes actives ou connexion push sans clé. Un problème sur une ligne située plus bas s’affiche en surbrillance sur les lignes situées au-dessus. Cliquez sur une icône pour accéder aux actions correspondant à ce qu’elle signale, telles que Afficher l’activité ou Afficher les alarmes. Les filtres permettent d’afficher uniquement les problèmes.

Connexion d’un système

Nouvelle connexion vous guide tout au long du processus de connexion d’un système externe, dans les deux sens.

Entrant : une source entrante lit les données d’un autre système, par exemple un flux JSON via HTTP, un flux RSS, un service ArcGIS ou OGC, ou encore une base de données PostgreSQL ou SQL Server, selon un calendrier défini. Les appareils et capteurs envoient leurs relevés vers une connexion qui leur est propre.
Sortant : une connexion transmet les modifications d’Aptli à un autre système, en appelant son adresse Web, en écrivant dans sa base de données ou en transmettant un fichier.

La flèche située à côté du bouton « Créer » permet d’ajouter directement une source entrante, ou de Connecter un site Web ou un CMS pour associer un site Web à Aptli.

Votre forfait comprend un certain nombre de connexions. Chaque connexion compte pour une, tout comme une clé API indépendante. Le menu « Nombre » indique combien sont utilisées.

Règles

Une règle comporte trois parties :

Quand : ce qui la déclenche. Un enregistrement est créé ou change de statut, un minuteur arrive à expiration, une planification est exécutée, une lecture ou un événement entrant est reçu.
Si : conditions relatives à l’enregistrement ou à l’événement, telles que la priorité est élevée ou le statut est « terminé ».
Alors : ce qu’elle fait. Les règles peuvent créer une tâche, un ordre de travail, une affectation ou une demande d’assistance, mettre à jour un champ, effectuer un calcul, lancer un minuteur de réponse, envoyer une notification, appeler un autre système, écrire dans une base de données ou transmettre un fichier.

Un fichier transmis peut être au format JSON, CSV, GeoJSON, PDF, Excel ou XML, et envoyé vers un dossier, un stockage compatible S3, un serveur SFTP, une adresse e-mail ou une adresse Web. Il peut contenir l’enregistrement à l’origine de la règle, ou un rapport enregistré généré à ce moment-là.

Nouvelle règle ouvre une règle vide. « Nouvelle règle ici », dans le menu ⋯ d’une ligne, lance une règle déjà associée à cette connexion ou à ce comportement. Le menu ⋯ d’une ligne contient également Historique, Modifications, Envoyer un test, Cloner, Activer, Désactiver et Supprimer.

Cochez les règles pour les activer ou les désactiver simultanément, ou pour les supprimer.

Clés, sources et activité

Le menu « Nombre » affiche les totaux et ouvre trois fenêtres :

Activité : chaque exécution, ce qui l’a déclenchée, ce qu’elle a fait et si elle a fonctionné.
Clés et identifiants : les clés API que d’autres systèmes utilisent pour envoyer des données, ainsi que les mots de passe, jetons et identifiants de base de données stockés qu’Aptli utilise pour y accéder. Une clé secrète enregistrée n'apparaît plus jamais une fois sauvegardée. Elle ne peut être que remplacée.
Sources entrantes : chaque flux à partir duquel Aptli effectue une lecture.

Accès, dans le même menu, permet de définir qui peut utiliser les automatisations.

Règles des autres pages

Certaines pages comportent leurs propres règles, intégrées dans une fenêtre sur cette page, comme les rappels définis sur un ordre de travail. Elles apparaissent également ici, sous Dans Aptli, avec tout ce qui s’exécute automatiquement.