Les connecteurs

<aside>

Sommaire

Dans cette page

<aside> 🔌

Cette page explique comment connecter une application Visiativ Process à d’autres services : choisir entre un traitement et un service, configurer son déclenchement, gérer les résultats et les erreurs, puis utiliser les connecteurs standards.

</aside>

Avant de commencer

Identifiez l’action à automatiser et le moment où elle doit s’exécuter.
Vérifiez qu’une connexion aux données externes a été configurée lorsque le connecteur l’exige.
Pour les services externes comme l’e-mail, le SMS ou Salesforce, vérifiez également la configuration du proxy avec l’administration.
Préparez les champs qui fourniront les paramètres et recevront les résultats.

Comprendre les connecteurs

Un connecteur permet à Visiativ Process d’échanger des informations avec une application métier ou avec un autre composant de la plateforme.

Type	Déclenchement	Usage principal
Traitement	Entre deux étapes d’un processus, lors du changement d’étape	Exécuter ponctuellement une action invisible pour l’utilisateur.
Service	Lors d’un événement associé à un élément de conception	Réagir à la création, l’enregistrement, un changement de valeur ou une action du diagramme.

La connexion aux données externes représente la liaison technique avec le système cible. Le connecteur décrit l’action fonctionnelle à exécuter.

Ajouter un connecteur de type traitement

Ouvrez le processus dans l’éditeur de diagramme.
Affichez la palette Traitement située sous la bibliothèque.
Insérez un traitement entre deux étapes.
Ouvrez ses propriétés et configurez le connecteur.
Enregistrez et testez le passage entre les étapes.

Le traitement s’exécute automatiquement lors du changement d’étape et reste invisible pour l’utilisateur.

Traitements standards

Traitement	Utilisation
Envoi d’un e-mail	Envoyer un message à une liste de diffusion ou à des destinataires issus de champs. Permet de définir l’expéditeur, l’objet, le contenu et les pièces jointes.
Envoi d’une invitation	Envoyer une invitation avec un organisateur, des participants, un titre et les informations de l’événement.
Envoi d’un tweet	Publier un message à partir du déroulement d’un processus.
Envoi d’un SMS par OVH	Envoyer un SMS en utilisant une connexion OVH préalablement configurée.

<aside> 💡

Pour l’e-mail et l’invitation, les expéditeurs, destinataires et contenus peuvent être alimentés par du texte, des variables, des formules ou des champs du processus.

</aside>

Ajouter un connecteur de type service

Un service peut être associé à une version de processus, une action du diagramme, un formulaire, un champ, un tableau dynamique, une colonne, une table de données ou une colonne de table.

Configurer les propriétés

Depuis l’élément concerné, ouvrez l’onglet Événements ou la zone de configuration des connecteurs.
Cliquez sur Ajouter un service.
Sélectionnez le Connecteur et le Service.
Renseignez un Libellé de conception et, si nécessaire, un commentaire.
Choisissez l’Événement déclencheur proposé pour ce contexte.
Ajoutez éventuellement une condition d’exécution.
Vérifiez que le service est Actif.

Propriétés et déclenchement d’un service

Renseigner les paramètres

Dans l’onglet Paramètres, associez chaque entrée attendue par le service à une valeur fixe, une formule ou un champ du processus. Les paramètres varient selon le connecteur sélectionné.

Exploiter les résultats

Lorsqu’un service renvoie une ou plusieurs valeurs :

Ouvrez Gestion des résultats.
Cliquez sur Affecter une valeur ou Affecter une liste.
Sélectionnez le champ de destination.
Sélectionnez la valeur renvoyée par le connecteur.
Validez l’association.

Affectation d’une valeur retournée à un champ

Gérer les erreurs

Dans Gestion des erreurs :

choisissez Arrêter l’exécution pour annuler les actions en cours lorsqu’une erreur survient ;
choisissez Ignorer l’erreur pour poursuivre l’exécution ;
activez l’écriture dans le journal du serveur ;
activez si nécessaire la notification par e-mail et sélectionnez les profils, groupes, utilisateurs ou adresses externes à prévenir.

Configuration de la gestion des erreurs

<aside> ⚠️

Utilisez l’option Arrêter l’exécution lorsque la réussite du service est indispensable à la cohérence du processus. Pour une action secondaire, l’option Ignorer l’erreur peut éviter de bloquer le parcours utilisateur.

</aside>

Choisir l’événement déclencheur

Les événements disponibles dépendent du contexte. Ils peuvent notamment s’exécuter :

pendant ou à la fin de la création ;
pendant ou à la fin de l’enregistrement ;
au clic sur Enregistrer ;
avant ou après le chargement du formulaire ;
au changement de valeur d’un champ ;
pendant ou à la fin d’un changement d’étape.

Choisissez l’événement le plus proche du besoin et évitez de déclencher plusieurs fois la même opération pendant un seul parcours.

Utiliser la publication documentaire

Le connecteur de publication documentaire automatise les opérations dans un espace documentaire.

Services disponibles

créer, modifier, déplacer, restaurer ou supprimer un dossier ;
créer ou modifier un document ;
remplacer le fichier joint ;
créer un instantané ;
extraire, annuler l’extraction ou ranger un document ;
déplacer, restaurer, supprimer ou envoyer un document à la corbeille ;
afficher les types de documents.

Pour chaque opération, utilisez un champ contenant une référence vers l’objet concerné, généralement au format Protocol URI. Les services de création peuvent retourner cette référence dans un champ du processus.

<aside> 💡

</aside>

Utiliser le connecteur Annuaire

Le connecteur Annuaire permet d’automatiser les opérations suivantes :

créer ou modifier un utilisateur ;
activer ou désactiver un utilisateur ;
modifier ses groupes, profils, organisation ou localisation ;