Connexions

Une connexion est un lien vers un système externe. Les données proviennent de ce système, y sont envoyées, ou les deux, selon son propre calendrier et avec ses propres identifiants.

Ajouter une connexion

Dans la catégorie concernée, ouvrez ⋯ › Nouvelle connexion ici et sélectionnez le type. La fenêtre qui s’ouvre ne demande que les informations spécifiques à ce type de connexion : une adresse, un calendrier, une requête, un dossier et ses identifiants.

Les types pris en charge par chaque catégorie :

Une connexion qui lit à partir d’une base de données exécute votre requête selon son calendrier et récupère les lignes. Associez-la à un utilisateur de base de données en lecture seule.

Une connexion Système maître désigne les domaines gérés par un autre système, tels que les actifs, le travail ou les facturations. Chaque requête émise pour ces domaines est transmise à ce système, et sa réponse est renvoyée dans la requête. Voir Requêtes.

Enregistrer enregistre la connexion. Une nouvelle clé ou un nouveau code généré par la connexion s’affiche une seule fois, accompagné de la mention « Copiez cette clé maintenant. Elle ne s’affichera qu’une seule fois. »

Identifiants

Identifiants répertorie les secrets détenus par une connexion : un mot de passe, un jeton, une clé API, un secret client. Chacune porte la mention enregistrée ou aucune enregistrée. Une information d’identification enregistrée ne s’affiche plus jamais. Remplacer permet d’en définir une nouvelle.

Associer un site web

Une connexion Site web (WordPress ou Drupal) s’associe au plugin Aptli sur ce site.

1. Enregistrez la connexion, puis cliquez sur Générer un code.
2. Dans l’interface d’administration du site web, ouvrez la page Hub du plugin et saisissez le code.

Un code ne fonctionne qu’une seule fois et expire au bout de 10 minutes. L’option Nouveau code d’appairage, accessible via le menu ⋯ de la connexion, génère un nouveau code et annule tout code précédent. Une fois appairé, le site envoie une copie de chaque publication dès qu’elle est enregistrée. Voir les articles sur les sites web.

Synchroniser des couches de carte avec ArcGIS

Une connexion ArcGIS représente une instance ArcGIS et son authentification. Chaque couche qu'elle garde à jour avec Aptli est une ligne sous la connexion.

1. Enregistrez la connexion avec son adresse, son identifiant client, son adresse de jeton et son secret client.
2. Sur la ligne de la connexion, dans la fenêtre, ouvrez ⋯ › Ajouter une couche.
3. Saisissez l'Adresse de leur couche : l'adresse de la couche elle-même, qui se termine par /FeatureServer/ et son numéro.
4. Choisissez Notre couche, puis Enregistrer.

Chaque couche a sa propre correspondance de champs. Pour chaque champ, À eux (le distant gagne), À nous (jamais écrasé) ou Partagé indique qui en est propriétaire. À l'enregistrement, Aptli refuse la modification d'un champ dont ArcGIS est propriétaire.

Une modification faite sur la carte part vers ArcGIS après sa publication, à la synchronisation suivante de la connexion. Une modification faite dans ArcGIS arrive lors de cette même synchronisation. Synchroniser maintenant en lance une aussitôt.

Aptli associe chaque entité à sa ligne ArcGIS par GlobalID. Une couche sans GlobalID est associée par OBJECTID.

Une couche n'accepte qu'un seul système externe. Aptli refuse une seconde connexion sur une couche qui en a déjà une.

Faire appeler Aptli par ArcGIS quand une couche change

La connexion affiche Leur webhook, une adresse. Un webhook ArcGIS qui l'appelle lance une synchronisation dès qu'une couche est modifiée.

1. Sur la connexion, cliquez sur Générer pour le secret de webhook et copiez-le. Il ne s'affiche qu'une fois.
2. Dans ArcGIS, créez un webhook sur le service d'entités.
3. Indiquez comme URL du hook l'adresse affichée sous Leur webhook.
4. Indiquez comme clé de signature le secret de webhook.
5. Choisissez les événements d'entités à envoyer, puis activez le webhook.

ArcGIS Enterprise signe les webhooks de service d'entités à partir de la version 11.2.

Une connexion Fonctionnalités API OGC / WFS fonctionne de la même façon, avec une ligne par collection. Les modifications repartent par le point de terminaison WFS de la connexion, et chaque couche nomme son type d'entité. Son webhook envoie le secret comme clé « bearer ».

Statut

La fenêtre d’une connexion affiche son Statut :

• ce qu’elle fait, en une phrase, par exemple « Votre système envoie des données à Aptli via push » ;
• Les règles peuvent écouter : les événements qu’elle déclenche ;
• Les règles peuvent agir via cette connexion : ce qu’une règle peut en faire ;
• Utilisée par : les règles et les enregistrements qui l’utilisent.

Envoyer un test vérifie la connexion de bout en bout et affiche Test réussi ou Test échoué avec la raison. Une connexion « push » n’ayant encore rien reçu l’indique : le premier lot qu’elle envoie apparaît dans Activité.

Supprimer une connexion

⋯ › Supprimer met fin à sa planification. La clé d’une connexion « push » est supprimée en même temps.