Aller au contenu principal

Services

Un service compose plusieurs étapes en un seul appel : lire une ligne, la contrôler, appeler un point d'accès, bifurquer selon la réponse, écrire, répondre. Il se construit en le dessinant — sans code — et s'utilise de deux façons : un écran l'appelle depuis un bouton, ou il est exposé comme point d'accès d'API, qu'une tâche, l'assistant ou un système extérieur appelle comme un autre.

Accès : Liberty Next → Logique → Services, pour les superutilisateurs. Un service est l'action partagée qu'un écran appelle avec call_action ; voir Actions et cycle de vie pour les actions d'un écran.


Vue d'ensemble​

Servicescheck_credit4 étape(s) · 2 entrée(s)POST /api/http/studio/check_creditExécuterExposerFluxListe− 100% +Début+REQUÊTEcustomercustomers_getCONDITIONplafond dépassé ?amount > limitVraiFauxMESSAGErefuserplafond atteintPOINT D'ACCÈSreserveerp.reserve_creditRéponseL'ÉTAPEREQUÊTEcrm.customers_get ▾ENTRÉESID = INPUT.customerLes étapes suivantes lisentcustomer.first_row.LIMITUne ligne par serviceétapes, entrées, points d'accèsLe + d'un lienajoute une étape à cet endroitUne condition bifurquevoies Vrai et FauxExécuterréponse + étapes exécutéesExposerdevient un point d'accès d'APIL'étape choisiemodifiée à côté du flux

La liste​

Chaque ligne donne le service, son nombre d'étapes et d'entrées, et les points d'accès qu'il sert déjà (POST /api/http/<connecteur>/<point d'accès>). Nouveau service en ajoute un. Sur une ligne : Exécuter, Exposer, Rechercher les usages, Rechercher les dépendances, Renommer, Cloner, Supprimer. Un clic ouvre son concepteur.


Le flux​

Le concepteur s'ouvre sur la vue Flux ; Liste présente les étapes sous forme de liste.

Le flux se lit de gauche à droite : Début, qui montre les entrées ; une carte par étape ; Réponse, qui montre ce que le service retourne. Une condition se divise en deux voies, Vrai et Faux ; une boucle ou un groupe encadre ses propres étapes. La disposition découle de la structure du service : rien n'est placé à la main. Un flux long continue sur la ligne suivante, et le zoom (− / % / +) est mémorisé sur le poste.

  • Un clic sur une carte ouvre l'étape dans le panneau latéral : sa cible, la correspondance de ses entrées.
  • Le + d'un lien ajoute une étape à cet endroit.
  • Sans sélection, le panneau modifie Le service : Libellé, Description, Entrées (Ajouter une entrée).
ÉtapeRôle
RequêteExécute une requête d'un connecteur.
Point d'accèsAppelle un point d'accès d'API. Si le point d'accès indique où se trouvent ses lignes, les étapes suivantes les lisent par nom de colonne : <étape>.first_row.<COLONNE>, <étape>.rows.
FonctionAppelle une fonction du plugin d'une application.
ServiceAppelle un autre service.
ConditionBifurque selon un test.
Pour chaqueRépète ses étapes pour chaque ligne.
Message, NotificationInforme l'utilisateur, ou envoie une notification.
RéponseIndique ce que le service retourne.

Une étape lit les entrées du service par INPUT.<nom> et le résultat d'une étape précédente par le nom de cette étape.


Exécuter​

Exécuter essaie le service tel qu'il est enregistré : un champ par entrée (sa valeur par défaut en indication), puis le résultat — Terminé en N ms, la Réponse qu'il donnerait comme point d'accès, et les Étapes exécutées.

Les étapes s'exécutent réellement

Une étape qui écrit, écrit. Un service qui modifie des données s'essaie sur un environnement de test, ou avec des entrées prévues pour cela.


Exposer comme point d'accès​

Exposer crée un point d'accès d'API servi par le service. Un écran, une action, une tâche, l'assistant ou un appelant extérieur l'appelle ensuite comme n'importe quel point d'accès.

ChampSignification
Sur le connecteurUn connecteur d'API de l'installation, ou celui du Studio — studio, créé à la première utilisation.
Nom du point d'accèsL'identifiant du service par défaut.
Il modifie des donnéesÀ cocher si une étape écrit : l'assistant demande alors avant de l'appeler.

Les entrées du service deviennent les paramètres du point d'accès. La fenêtre répond avec l'adresse et la permission : Exposé : POST … — permission api:<connecteur>:<point d'accès>.

Le service s'exécute avec la permission du point d'accès : qui peut appeler le point d'accès exécute toutes ses étapes, sans nouveau contrôle étape par étape — un service composé s'accorde en bloc. Le périmètre de données de l'appelant s'applique toujours à chaque requête. Ce que le service retourne est la réponse ; ses messages l'accompagnent ; une étape en échec est l'erreur du point d'accès.


Où un service est utilisé​

Rechercher les usages liste les écrans qui appellent le service et les points d'accès qu'il sert ; un renommage les suit. Dans le Studio, un service sélectionné éclaire les écrans qui l'appellent. Un service voyage dans un paquet avec les écrans et les points d'accès qui en ont besoin.


Conseils & bonnes pratiques​

  • Donner à chaque étape un nom qui dit ce qu'elle contient (client, commandes_ouvertes) : les étapes suivantes la lisent par ce nom.
  • Placer les contrôles en premier et les écritures en dernier : une condition qui arrête tôt ne laisse rien à moitié fait.
  • Exposer un service quand le même enchaînement sert à un écran et à une tâche ou à un système extérieur : une définition, une permission.
  • Couvrir un service exposé par un cas de test.

Voir aussi​