PARAMÉTRAGE

Il est nécessaire d'enregistrer des contextes d'import avant de les déclencher.

Création d'un contexte d'export

La création d'un nouveau contexte d'export s'effectue depuis le panneau des Paramètres généraux > Clic droit sur Exports d'événements > Créer un contexte d'export d'événements.

La partie basse s'active alors :

Entrer alors les différentes caractéristiques puis cliquer sur :

  • Valider pour sauvegarder le contexte,

  • Rétablir sinon.

Ces caractéristiques sont les suivantes :

Nom

Donner un nom à ce contexte d'import.

Description

Donner une description à ce contexte. Cette donnée est facultative.

Historique

Il s'agit de la date, de l'heure de la création et de la dernière modification du contexte ainsi que du login qui a effectué ces actions.

Cette caractéristique est non modifiable.

Définition

Il s'agit de la Définition de ce contexte.

c.f. Définition du contexte d'export d'événements.

Marquer le traitement

Cette case, si elle est cochée, permet de sauvegarder la date, l'heure et le login de l'utilisateur qui a exporté l'événement.

c.f. ci-dessous.

Appel via "URL"

L'activation cette l'option permet d'autoriser le déclenchement de ce contexte par URL en dehors de VISUAL PLANNING.

Activer l'authentification

L'activation de cette option permet de protéger l'URL via Basic Access Authentication.

Identifiant

Définir l'identifiant (login) de l'URL, si l'authentification a été activée.

Mot de passe

Définir le mot de passe de l'URL, si l'authentification a été activée.

Création/modification d'événements

Cette case permet d'activer le déclenchement du contexte lors de la création et/ou modification d'événements.

Attention

Elle ne peut pas être activée dans le cas d'un fichier sur le disque ou d'une base de données MSAccess.

Activé

Cette case à cocher permet d'activer le déclenchement par service de l'export.

Déclencheurs

Cette option permet de définit les déclencheurs dans le cas d'un export par service.

Reporting activé

Cette case à cocher permet d'envoyer un rapport par mail du résultat de chaque déclenchement de l'import.

Avertissement

Prérequis : Le serveur SMTP doit être paramétré car il s'agit de mails automatiques. c.f. Envoi automatique de mails

Expéditeur

Préciser l'adresse mail qui est prise en compte comme expéditeur lors du reporting par mail.

Ce paramètre n'est actif et nécessaire que si la case Reporting activé est cochée.

Destinataires

Définir la ou les adresses mail qui seront destinataires du reporting par mail.

Ce paramètre n'est actif et nécessaire que si la case Reporting activé est cochée.

Définition du contexte d'export

Onglet Destination

Format type
Cas du fichier *.CSV

Il est alors nécessaire de préciser les paramètres :

Type

Dans ce cas, la valeur doit être Fichier Csv.

Séparateur

Le Séparateur de valeurs dans le fichier de destination peut être :

  • Point virgule,

  • Point,

  • Espace,

  • Virgule,

  • Tabulation

  • ou Barre verticale.

Encodage

Le type d'Encodage est à choisir suivant le système d'exploitation du serveur :

  • Défaut (Encodage système) : c'est l'encodage de la machine client,

  • UTF8 : l'encodage pour les systèmes exploitation anglophone (Windows, UNIX),

  • Windows-1252 (Norme européenne).

Chemin

Spécifier le Chemin d'accès, ce dernier peut contenir :

  • Un fichier de destination de type CSV. Si le fichier n'existe pas, il est créé au moment de l'export,

  • Une adresse URL,

  • Un texte de type Import=NomDuContexteExport permettant de faire des imports d'exports.

Cas du fichier Excel

Il est alors nécessaire de préciser les paramètres :

Type

Dans ce cas, la valeur doit être Fichier Excel.

Chemin

Définir le chemin d'accès au fichier source au format *.XLS ou *.XLSX.

Feuille

Définir la Feuille du fichier source à importer.

Cas du fichier XML

Il est alors nécessaire de préciser les paramètres :

Type

Dans ce cas, la valeur doit être Fichier XML.

Chemin

Définir le chemin d'accès au fichier source au format *.XML.

Cas de la base de données

Si l'import s'effectue depuis une base de données, il faut choisir le type Base de données.

Il est alors nécessaire de préciser les paramètres suivants :

Type

Dans ce cas, la valeur doit être Base de données.

SGBD

Préciser la technologie de SGBD utilisée :

  • MSAccess,

  • MySQL,

  • Oracle,

  • SQLServer,

  • PostgreSQL,

  • ou MariaDB.

Paramètres de connexion

Les paramètres de connexion diffèrent selon le type de SGBD choisi. En cliquant sur Paramètres de connexion, une nouvelle fenêtre apparaît :

 

MSAccess

MySQL, SQLServer, PostgreSQL, MariaDB

ORACLE

SID

  

Mot de passe

Chemin d'accès

  

Port

 

Serveur

 

Login

 

Pour valider ces paramètres, cliquer sur :

  • OK,

  • ou Annuler pour revenir en arrière.

Base de données

Préciser le nom de la Base de données d'où il faut importer.

Table

Choisir la Table ou la Vue à importer.

Cette liste est vide tant que la base de données n'est pas précisée.

Ajouter si aucune correspondance

Avertissement

Ce paramètre n'est utile et accessible que dans le cas d'un export vers une base de données (autre que MSAccess).

Dans le cas d'un export vers une table, l'export est considéré par défaut une insertion de nouvelle données.

Cette case, si elle est cochée, permet de vérifier dans la base de données de destination si la donnée existe déjà, et de la créer uniquement si elle n'existe pas.

La clef utilisée pour cette vérification est définie dans l'onglet Correspondance.

Format des dates

Il faut choisir le format auquel les dates vont être écrites lors de l'export, parmi :

  • dd/MM/yyyy,

  • yyyy-MM-dd,

  • MM/dd/yyyy,

  • ou dd.MM.yyyy.

Filtre

Il est possible de limiter l'export à certains événements.

Pour cela, il faut sélectionner un filtre d'événements.

Période

Il est aussi possible de choisir la période de temps dans laquelle se trouvent les événements à exporter.

Type d'intersection

Il est enfin possible de choisir l'intersection des événements avec la période de temps, parmi les choix possibles :

  • Intersecte la période,

  • Recouvre la période,

  • Entièrement dans la période,

  • Débute dans la période,

  • Finit dans la période.

Procédure stockée

Avertissement

Ce paramètre n'est utile et accessible que dans le cas d'un export vers une base de données (autre que MSAccess).

Il faut définir le nom d'une procédure stockée.

Les procédures stockées doivent avoir uniquement les deux paramètres suivants :

  • retcode d'utilisation OUT et de type INTEGER : doit prendre la valeur 0 en cas de succès,

  • message d'utilisation OUT et de type VARCHAR : doit contenir un texte explicatif qui sera mis à disposition de l'utilisateur.

Contexte d'importation à suivre

Avertissement

Ce paramètre n'est utile et accessible que dans le cas d'un export vers une base de données (autre que MSAccess).

Cela permet de lancer un autre contexte d'importation une fois la procédure stockée exécutée.

Il faut choisir un contexte d'import parmi ceux disponibles dans la liste.

La liste des imports proposés sont du type :

  • Base de données,

  • URL.

Onglet Correspondance

Cet onglet permet de faire la correspondance entre la source qui est un ensemble d'événements du planning et la destination qui est, selon le cas, un fichier, une feuille ou une table.

Cette correspondance s'effectue champ par champ.

Il convient de remplir le tableau qui contient plusieurs colonnes :

Propriété

Cette colonne contient les noms des rubriques et paramètres choisis pour l'export.

En cliquant sur , il est possible d'exporter :

  • Les propriétés générales et temporelles des événements,

  • Chaque rubrique de chaque dimension,

  • Le nom de chaque ressource sous la forme de ses rubriques d'identification,

  • Plusieurs rubriques en une seule fois lorsque l'utilisateur clique sur (Sélectionner tous les attributs). Ceci est utile lorsqu'un grand nombre de rubriques est concerné dans l'export,

  • Chaque rubrique de chaque formulaire,

  • La valeur fixe, la valeur par unité et le coefficient de chaque poste de valorisation,

  • L'identifiant Interne (UID) des événements.

Attention

Concernant les rubriques calculées, seules les rubriques journaliers peuvent être exportées.

Destination

Choisir pour chaque rubrique ou propriété à exporter, le champ de la destination correspondant. Si aucune destination n'est saisie, la propriété ou la rubrique n'est pas exportée.

  • Dans le cas d'un fichier, le nom est par défaut celui de la rubrique ou propriété. Il est possible de modifier ce nom.

  • Dans le cas d'une table, les noms sont choisis dans la liste des champs de la table de destination.

Clef

Pour l'export vers une table de base de données, il est possible de choisir une clef en cochant une ou plusieurs cases Clef?.

c.f. Ajouter si aucune correspondance

Dans le cas d'un export vers un fichier, il est possible de définir l'ordre des colonnes dans le fichier d'export en utilisant les flèches . Cet ordre définit aussi l'ordre des ressources exportées dans le fichier.

Modification d'un contexte d'export

Pour modifier un contexte d'export, aller dans le panneau des Paramètres Généraux, puis Cliquer sur le contexte à modifier.

La partie correspondante s'active alors. Modifier les paramètres (c.f. Création d'un contexte d'export), puis cliquer sur Valider pour enregistrer les modifications.

Suppression d'un contexte d'export

Pour supprimer un contexte d'export, aller dans le panneau des Paramètres Généraux, puis Cliquer droit sur le contexte > Supprimer.

Le message suivant apparaît :

Il faut alors cliquer sur :

  • Oui pour supprimer définitivement le contexte,

  • Non pour annuler la suppression.

ghostghostghostghostghost
loading table of contents...