Définition des services d'interface de données transactionnelles de type Base de données
Cette rubrique décrit le processus de création d'un service d'interface avec Entité de données = Données transactionnelles et Type d'interface = Base de données.
Pour créer un service d'interface :
- Sélectionner Configuration > Commun > Services d'interface > Services d'interface.
- Cliquez sur Nouveau. Une fenêtre Nouveau service d'interface s'affiche.
- Entrez les informations suivantes :
- Type d'interface
- Le type de l'interface. Sélectionner Base de données.
- Entité de données
- Entité de données à mapper avec l'interface. Sélectionner Données transactionnelles.
- Sens d'interface
- Sens du flux de données. Valeurs possibles :
- Importer
- Exporter
- Importation et exportation
- Cliquez sur OK. Une nouvelle page Services d'interface s'affiche.
-
Saisissez les informations suivantes dans l'onglet Détails de l'interface :
- Nom
- Nom unique du service d'interface.
- Nom d'affichage
- Nom qui s'affiche pour le service d'interface. Si ce paramètre n'est pas défini, la valeur indiquée dans le champ Nom est utilisée par défaut.Remarque : Cette option est activée pour l'entité définie par le système.
- Type d'interface
- Le type de l'interface. Cette valeur est extraite par défaut de la fenêtre Nouveau service d'interface.
- Entité de données
- Entité de données à mapper avec l'interface. Cette valeur est extraite par défaut de la fenêtre Nouveau service d'interface.
- Sens d'interface
- Sens du flux de données. Cette valeur est extraite par défaut de la fenêtre Nouveau service d'interface.
- Module
- Module dans lequel le service d'interface est défini.
- Système
- Indique le statut du service d'interface. Valeurs possibles :
- Actif(ve) (activé(e))
- Inactif(ve) (désactivé(e))
-
Saisissez les informations suivantes dans l'onglet Source de données :
- Source de données
- Source de données de type Base de données définie dans SCP.
- Source
- Indique le type de l'interface de source de données. Options possibles :
- Table : Si vous sélectionnez cette option, les champs Tables et Filtre d'importation s'affichent.
- Requête : Si vous sélectionnez cette option, le champ Requête s'affiche.
Remarque : Pour le Type d'interface = Exporter & Importer et-exporter, la source est définie sur Table uniquement. - Tables
- Table de base de données à laquelle le service d'interface est applicable.
- Filtre d'importation
- Texte SQL permettant de définir les critères de filtrage pour la transmission des données via le service d'interface de la table source.Remarque : Si ce paramètre n'est pas défini, toutes les données de la table source indiquée s'appliquent.
- Requête
- Demande SQL (jusqu'à 4000 caractères) permettant d'extraire les données requises pour l'interface de la source de données spécifiée.Remarque : Vous devez cliquer sur Vérifier pour valider la requête indiquée. Si la requête rencontre un problème, ce message d'avertissement s'affiche :
La requête de service d'interface saisie a retourné une erreur [détails d'erreur RDBMS].
-
Cliquez sur l'onglet Comportement importation.
Remarque : Cet onglet n'est affiché que si le champ Sens d'interface contient la valeur Importer ou Importer et exporter.
-
Saisissez les informations suivantes dans l'onglet importation :
- Effacez la table de destination avant d'importer
- Indique si toutes les lignes de la table cible doivent être effacées ou si les données doivent être ajoutées à l'enregistrement en sortie existant avant l'exécution de l'interface et l'importation des lignes. Scénarios possibles :
- Actif(ve) : Supprimer et insérer
- Désactivé(e) : Ajouter
-
Cliquez sur l'onglet Comportement exportation.
Remarque : Cet onglet n'est affiché que si le champ Sens d'interface contient la valeur Exporter ou Importer et Exporter.
-
Saisissez les informations suivantes dans l'onglet Comportement exportation :
- Type d'exportation
- Comportement d'exportation pour les données ou enregistrements nouveaux et existants. Valeurs possibles :
- Insérer seulement : Insère de nouvelles lignes dans la table de destination
- Mettre à jour seulement : Met à jour la ligne existante disponible dans la table de destination
- Insérer et mettre à jour : Les deux
- Effacer la table de destination avant d'exporter
- Indique si toutes les lignes de la table cible doivent être effacées ou si les données doivent être ajoutées à l'enregistrement en sortie avant d'exécuter l'interface et d'exporter les lignes. Scénarios possibles :
- Actif(ve) : Supprimer et insérer
- Désactivé(e) : Ajouter
- Cliquer dans l'onglet Mappages. Cet onglet affiche les attributs de données transactionnelles à mapper entre la connexion SCP et celle de la source de données.
- Ajouter un nouvel attribut si nécessaire. Reportez-vous à la rubrique Ajout d'un nouvel attribut de données transactionnelles.
- Cliquez sur l'onglet Import/Export Measures. Cet onglet affiche la liste des mesures à mapper dans l'interface.
- Ajouter une mesure si nécessaire. Reportez-vous à la rubrique Ajout d'une mesure.
-
Cliquez sur l'onglet Exporter les constantes. Cet onglet contient la liste d'attributs de la source de données spécifiée, à mapper avec une valeur constante lors de l'exportation.
Cet onglet n'est affiché que si le champ Sens d'interface contient la valeur Exportation ou importation et Exportations.
- Ajoutez une constante d'exportation, si nécessaire. Reportez-vous à la rubrique Ajout de constantes d'exportation de données transactionnelles.
- Cliquez sur Enregistrer. Les modifications apportées au service d'interface sont appliquées.