Outils pour utilisateurs

Outils du site


docs:admin:routeur

Ceci est une ancienne révision du document !


Présentation du module

Le module routeur permet à EzGED d'envoyer des données vers des services externes ou d'autres applications.

Il s'appuie sur deux types d'objets:

Pour schématiser les services s'occupent du quoi (quelles données on envoi) et les connecteurs du comment (comment communique t-on avec la destination).

L'idée est que les services peuvent-être compatibles avec plusieurs connecteurs mais ce n'est pas une obligation. Certains services comme l'envoi de mail sont de part leur nature ouvert à plusieurs implémentations (et c'est d'ailleurs le cas en standard puisque EzGED propose deux connecteurs compatibles).

D'autres services plus spécifiques pourraient forcer l'utilisation d'un connecteur spécifique.

La nature des données envoyées tout comme les “services” vers lesquels elles sont envoyées peuvent être de natures très différentes. Voici quelques exemples d'usage:

  • Envoyer un mail via un serveur SMTP.
  • Envoyer un mail via une API REST (e.g: API Graph pour Office365).

Interface

Arborescence

(1) Accès à la liste des services disponibles

(2) Pour accéder à la description et au paramétrage du service

(3) Accès à la liste de toutes les instances de connecteurs configurées.

(4) Accès à la description de ce type de connecteur + la liste des instances configurée de ce type.

(5) Formulaire de paramétrage d'une instance de connecteur.

Liste des services disponibles lorsque l'on arrive sur le module routeur

Services

Concernant le vocabulaire qui sera utilisé:

  • On parle de service pour désigner les “types de services”.
  • On parle d'instance de service pour désigner un paramétrage spécifique de ce type de service.

Un service représente du côté EzGED un type de fonctionnalité ou un ensemble de fonctionnalités rendues par un service ou une application externe.

Certains services ne nécessitent pas obligatoirement de paramétrer une instance pour être utilisés. C'est le cas par exemple du service “Envoi de mail” qui à l'heure actuelle est paramétré à la demande pour chacune de ses utilisations comme par exemple:

  1. Lorsque l'utilisateur effectue un envoi de mail via l'interface.
  2. Lorsqu'un script tel que le “tblrouting” effectue des envois de mail.

Connecteur par défaut

Le connecteur par défaut sert à deux choses:

  • définir le connecteur à utiliser pour le service (donc en dehors d'une instance spécifique).
  • définir le connecteur à utiliser si l'instance de service ne précise par un connecteur spécifique.

Prenons comme exemple le service “Envoi de mail”:

Vous pouvez associer au service “Envoi de mail” comme connecteur par défaut une instance du connecteur “SMTP”. Cela signifie que partout où EzGED fait de l'envoi de mail sans référencer une instance spécifique de ce service alors le connecteur SMTP (une instance de ce connecteur) sera utilisé.

Mais si vous avez programmé une instance du service d'envoi de mail vous pouvez décider que pour cette instance vous voulez que les mails soient envoyés via Office365. Dans ce cas vous allez choisir sur cette instance d'utiliser un autre connecteur que celui par défaut.

Paramétrer une instance

Fonctionnalité non disponible pour le moment

Services disponibles

Envoi de mail

Le service “Envoi de mail” est utilisé pour permettre à EzGED d'envoyer des mails.

Dans son implémentation actuelle il sert exclusivement à lier un connecteur compatible avec la fonctionnalité d'envoi de mail qui est par exemple utilisée lorsque:

  • Un utilisateur effectue un envoi de mail
  • Un script comme le tblrouting est exécuté

Connecteurs

Un connecteur implémente la logique permettant de se “connecter” et de communiquer avec une API ou application tierce.

Ajouter une instance

Lorsque vous arrivez sur le module routeur et qu'aucune instance de connecteur n'est configurée vous voyez ceci:

Pour ajouter une nouvelle instance vous pouvez le faire soit depuis la vue de tout les connecteurs en cliquant sur

Connecteurs disponibles

SMTP

Services compatibles: Envoi de mail

Office365

Services compatibles: Envoi de mail

docs/admin/routeur.1679924916.txt.gz · Dernière modification: 2023/03/27 13:48 par florian