Services Web référencés
Vous pouvez configurer l'appel de services Web à l'aide de REST pour renseigner les tables référencées de la base de données Therefore™. Dans le cadre de la configuration, vous définissez des règles permettant d'extraire les données d'un service Web. La configuration de l'appel REST est similaire à la tâche de workflow Appeler service REST. Lorsque vous cliquez avec le bouton droit de la souris sur un service Web référencé, un menu contextuel s'ouvre.
Synchroniser maintenant
Extrait les données d'un service Web qui seront affichées dans une table référencée. Pendant la configuration, vous pouvez configurer un calendrier d'extraction des données (une fois par jour, plusieurs fois par jour, par exemple). Utilisez cette option pour synchroniser immédiatement les données si vous devez les extraire du service Web en dehors des créneaux planifiés.
Supprimer des lignes
Les suppressions dans le service Web ne sont pas automatiquement répercutées dans Therefore™. Cette option permet de supprimer manuellement des lignes dans une table référencée en cas d'erreur de configuration. Elle permet également de consulter la table référencée pour vérifier que la synchronisation fonctionne correctement.
|
Remarque : |
La boîte de dialogue « Service Web référencé » contient trois onglets que vous pouvez configurer.
Données de table
Cet onglet permet de définir la structure de la table référencée dans laquelle seront mémorisées les données issues du service Web.
Nom
Entrez un nom descriptif pour la table référencée qui sera créée.
Colonnes de table référencées
Définissez le nom et les types de données des colonnes de la table référencée. Consultez l'exemple de réponse dans la documentation de votre fournisseur d'API REST pour identifier les colonnes dont vous aurez besoin.
ID unique
Clé primaire de la table. Cet élément unique identifie la table référencée dans la base de données et permet d'identifier la table lorsque vous l'ajoutez à une catégorie.
Nom de colonne
Attribuez un nom aux colonnes de la table référencée. Il n'est pas nécessaire que le nom soit identique au nom correspondant dans la réponse JSON.
Type de données
Sélectionnez le type de données correspondant de la colonne dans la table référencée. Les types de données disponibles sont Texte (=chaîne), Date, Décimal et Entier. En cas de doute, choisissez « Texte ».
Longueur
Longueur du texte ou précision numérique.
Nombre de décimales
Nombre de chiffres après la virgule pour le type de données Décimal.
Ajouter
Ajoute une nouvelle colonne à la table référencée.
Supprimer
Supprime une colonne sélectionnée dans la table référencée.
Synchroniser
Synchroniser maintenant
Démarre immédiatement l'extraction de données à partir du service Web.
Restaurer
Permet de réinitialiser la synchronisation. Les lignes de la table sont supprimées. Utilisez cette option pour supprimer les données de la table en cas d'erreur de configuration. Lorsque la table est référencée dans une catégorie et que les documents sont mémorisés, l'impact de cette option est limité.
Synchronisation
Cet onglet permet de configurer les appels REST vers le service Web à partir duquel sont extraites les données.
| Icône | Description |
|---|---|
|
Ajoute un nouvel appel REST. |
|
Modifie une demande REST. |
|
Supprime une demande REST. |
|
Décale la demande REST vers le haut dans la liste. Les appels sont exécutés de haut en bas par défaut. |
|
Décale la demande REST vers le bas dans la liste. |
Cliquez sur l'icône d'ajout d'un nouvel appel REST ou double-cliquez sur un appel REST existant pour ouvrir une nouvelle boîte de dialogue permettant de configurer la demande REST. Une fois la demande REST configurée, retournez à l'onglet Synchronisation et cliquez sur le bouton « Tester » pour extraire les données du service Web référencé. Après cette étape, les affectations sont disponibles.
Pour obtenir des informations détaillées sur la configuration d'une demande REST, reportez-vous à la page de référence :
Affectations de colonnes de table
Mappez les données dans la réponse JSON sur la colonne appropriée de la table référencée.
Tester
Ouvrez la boîte de dialogue Tester Appeler service REST pour vérifier les données en cours d'extraction selon la configuration en cours.
Tester Appeler service REST
Testez l'appel REST en cours d'exécution selon la configuration actuelle.
Démarrer
Cliquez sur ce bouton pour démarrer le test.
Demandes REST
Nom de l'appel REST en cours de test.
Demande
Nom, méthode, URI et en-têtes de l'appel REST en cours de test.
Code d'état
Code d'état de la demande REST. 2XX correspond à un code de réussite.
Corps de réponse
Réponse REST au format JSON.
Calendrier
Définissez un calendrier de synchronisation des données à partir du service Web.
Une fois par jour
Synchronisez les données une fois par jour à l'heure indiquée.
Plusieurs fois par jour
Synchronisez les données n fois par jour pendant le créneau indiqué.
Désactivé
Les données ne sont pas synchronisées.