Création de services d’interface

Le service d’interface permet à l’utilisateur d’importer ou d’exporter des données dans une table SCV depuis/vers un fichier CSV ou Excel. Cette rubrique décrit le processus de création d'un service d'interface pour lequel Entité de données = Table SCV et Type d'interface = CSV.

Pour créer un service d'interface :

  1. Sélectionner Configuration > Commun > Services d'interface > Services d'interface.
  2. Cliquez sur Nouveau. Une fenêtre Nouveau service d'interface s'affiche.
  3. Entrez les informations suivantes :
    Type d'interface
    Le type de l'interface. Sélectionner CSV.
    Entité de données
    Entité de données à mapper avec l'interface. Sélectionner Table SCV.
    Remarque : La case Colonne par mesure s'affiche si la valeur définie pour le champ Entité de données est Valeur de scénario.
    Sens d'interface
    Sens du flux de données. Valeurs possibles :
    • Importer
    • Exporter
  4. Cliquez sur OK. Une nouvelle page Services d'interface s'affiche.
  5. 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.
    Système
    Indique le statut du service d'interface. Valeurs possibles :
    • Actif(ve) (activé(e))
    • Inactif(ve) (désactivé(e))
    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.
  6. Saisissez les informations suivantes dans l'onglet Source de données :
    Source de données
    Nom de la source de données (Fichier, FTP ou Amazon S3) définie dans SCP. La définition saisie dans la source de données est utilisée lors de l'exécution du service d'interface à l'aide d'une macro.
    Remarque : Si vous importez ou exportez manuellement des données à l'aide d'un service d'interface de fichier, recherchez le fichier à utiliser sur votre machine locale.
    Utiliser modèle nom fichier
    Grille ou expression permettant de définir le nom du fichier. Cette opération prend en charge l'importation de plusieurs fichiers ainsi que le classement et le regroupement des fichiers pour l'importation de la dernière version. Le nom de fichier contenant l'élément correspondant est importé.
    Remarque : Cette option n'est affichée que si la valeur définie pour le champ Type d'interface est Importer.
    Fichiers
    Nom du fichier à utiliser pour le service d'interface. Les fichiers affichés dépendent de la source de données définie. Si les fichiers ne s'affichent pas, cliquer sur Plus (+) pour ajouter le fichier requis.
    Remarque : Si l'option Utiliser modèle nom fichier est activée, le libellé champ apparaît en tant que modèle de nom de fichier et vous pouvez utiliser l'expression régulière comme nom de fichier. Les variables suivantes sont acceptées avec un trait de soulignement entre elles comme séparateur :
    • Tout caractère alphabétique (A-Z)
    • Tout caractère alphanumérique (A-Z, 0-9)
    • Tout caractère numérique
    Noms de champ dans ligne d'en-tête
    Indique le contenu de la première ligne du fichier qui est importé ou exporté. Si cette option est définie comme active, les scénarios possibles sont les suivants :
    • Une fois le fichier importé, sa première ligne contient des libellés de champ et peut être ignorée.
    • Une fois le fichier exporté, sa première ligne contient les en-têtes de champs.
  7. Sélectionner le nom de table SCV requis dans l’onglet Table SCV. Les données de l'onglet Mappages s'affichent en fonction de la table SCV sélectionnée.
    Remarque : 
    • Lors de l'importation du fichier, toutes les tables enregistrées dans Z_REG_TABLE (TABLE_REG_SZ) dont le champ table_area = Boîte de réception ou %_Import sont répertoriées.
    • Lors de l’exportation du fichier, toutes les tables et vues SCV sont répertoriées.
  8. Saisissez les informations suivantes dans l'onglet Détail de fichier :
    Délimiteur de fichier
    Type de délimiteur de fichiers. Options possibles :
    • Virgule
    • Onglet
    • Pipe
    Remarque : Par défaut, la valeur définie est Virgule.
    Format numéro
    Format de nombre pour les valeurs à valider lors de l’importation de données dans des champs numériques de la base de données SCV. Les valeurs numériques sont exportées selon le format défini.
    Format de date
    Format de date des valeurs à valider lors de l'importation de données dans les champs de date de la base de données SCV. Les valeurs de date sont exportées selon ce format défini.
    Remarque : Vous devez saisir les indicateurs de Mois et d'Heures en majuscules.
  9. Cliquer sur l onglet Traitement de fichier.
    Remarque : Cet onglet n'est affiché que si le champ Sens d'interface contient la valeur Importer.
  10. Entrez les informations suivantes :
    Classer les fichiers par
    Ordre (ascendant) dans lequel les fichiers sont organisés dans le répertoire, selon la valeur indiquée. Les variables suivantes peuvent être utilisées :
    • %file_1 = première variable du nom de fichier
    • %file_2 = seconde variable dans le nom de fichier
    Remarque : Cette option n'est activée que si l'option Utiliser modèle nom fichier est définie comme active dans l'onglet Source de données.
    Importer le dernier fichier
    Indique la grille d'importation du service d'interface. Scénarios possibles :
    • Actif(ve) : Importe le fichier le plus récent en fonction de l'horodatage des fichiers ou de la valeur spécifiée pour l'option Classer les fichiers par.
    • Désactivé(e) : Importer tous les fichiers d'une commande soit selon leur horodatage (l'heure système à laquelle le fichier est enregistré), soit selon la valeur spécifiée pour l'option Classer les fichiers par.
    Remarque : 
    • Cette option n'est activée que si l'option Utiliser modèle nom fichier est définie comme active.
    • L'horodatage dépend du système d'exploitation source.
    Grouper les fichiers par
    Critère sur lequel sont classés les fichiers dans un groupe. Dans chaque groupe, les fichiers sont classés selon la valeur indiquée pour l'option Classer les fichiers par. Ou sinon, ils sont classés en fonction de la date et de l'heure les plus récentes. Le dernier fichier de chaque groupe est importé.
    Remarque : Cette option n'est activée que si l'option Utiliser modèle nom fichier est définie comme active.
    Renommer le fichier après importation
    Les variables en fonction desquelles les fichiers importés avec succès sont renommés. Les variables servant à l'attribution d'un nouveau nom sont les suivantes :
    • %file = Nom de fichier complet
    • %file_0 = Nom de fichier sans extension

    Exemples :

    • %file_save : TAR_MD_BOM_20170705060012.csv a été renommé TAR_MD_BOM_20170705060012_save.csv.
    • %file_0_complete : Le fichier TAR_MD_BOM_20170705060012.csv est renommé TAR_MD_BOM_20170705060012_complete
  11. Saisissez les informations suivantes dans l'onglet Comportement importation :
    Effacer 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 les lignes. Scénarios possibles :
    • Actif(ve) : Supprimer et insérer
    • Désactivé(e) : Ajouter
    Effacer en fonction de la colonne/valeur source
    Condition selon laquelle les enregistrements sont supprimés de la table cible. Scénarios possibles :
    • Si aucune valeur n'est indiquée dans ces champs, tous les enregistrements sont supprimés de la table cible.
    • Dans le cas contraire, seuls sont supprimés les enregistrements pour lesquels les valeurs saisies dans les champs Colonne source et Valeur sont identiques.
    Remarque : Ces options ne sont activées que si l'option Effacer table de destination avant importation est définie comme active.
  12. Cliquez sur l'onglet Filtre d'exportation. Cet onglet vous permet de définir les conditions permettant de filtrer les données à l'exportation.
  13. Entrez les informations suivantes :
    Colonne
    Nom de colonne de la table SCV.
    Opérateur
    Opérateur utilisé pour définir la condition de filtre. Valeurs possibles :
    • Egal à
    • Pas égal
    • Comme
    • N’est pas comme
    • Est nul
    • N’est pas nul
    Valeur
    Valeur à laquelle la condition de filtre s'applique.
  14. Cliquez sur l'onglet Comportement exportation.
    Remarque : Cet onglet n'est affiché que si la valeur définie pour le paramètre de sens d'interface est Importer.
  15. Entrez les informations suivantes :
    Ajouter horodatage au nom de fichier
    Indique si un horodatage doit être ajouté au nom du fichier exporté.
    Remarque : 
    • L'horodatage doit être indiqué au format UTC puis ajouté au nom du fichier avant l'extension et précédé d'un trait de soulignement. Par exemple, Nomfichier_20171030135355.csv.
    • Par défaut, la valeur est définie comme inactive.
    Inclure guillemets pour valeurs exportées
    Indique si les valeurs exportées doivent figurer entre guillemets.
    Remarque : Par défaut, la valeur est définie comme active.
  16. Cliquer dans l'onglet Mappages. L'onglet Mappages affiche la liste des attributs. La liste d’attributs est définie par défaut en fonction de la table SCV sélectionnée.
  17. Ajouter un nouvel attribut, si nécessaire. Reportez-vous à la rubrique Ajout d'un attribut.
  18. Cliquez sur l'onglet Importer les constantes. Cet onglet contient une liste d'attributs de la table SCV qui doivent être mappés avec une valeur constante lors de l'importation des données.
    Remarque : 
    • Cet onglet n'est affiché que si le champ Sens d'interface contient la valeur Importer.
    • La valeur spécifiée dans cet onglet remplace les données mappées dans l'onglet Mappage.
  19. Ajoutez une constante d'importation, si nécessaire. Reportez-vous à la rubrique Ajout d'une constante d'importation.
  20. Cliquez sur l'onglet Exporter les constantes. Cet onglet contient une liste d'attributs de la table SCV à mapper avec une valeur constante pendant l'exportation.
    Remarque : Cet onglet n'est affiché que si le champ Sens d'interface contient la valeur Exporter.
  21. Ajoutez une constante d'exportation, si nécessaire. Reportez-vous à la rubrique Ajoutez une constante d'exportation.
  22. Cliquez sur Enregistrer.