PARAMÉTRAGE

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

Création d'un contexte d'import

La création d'un nouveau contexte d'import s'effectue depuis lesParamètres généraux > Cliquer droit sur Imports d'événements > Créer un contexte d'import d'événements.

La partie correspondante 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 facultative à ce contexte.

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'import d'événements.

Appel via "URL"

L'activation de 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 Access.

Activé

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

Déclencheurs

Cette option permet de définit les déclencheurs dans le cas d'un import 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

Définir l'adresse mail qui sera 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

Préciser la ou les adresses mail pour être définies comme destinataires lors 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'import

Onglet Source

La source unique de l'import peut être de type :

Selon le type choisi, les paramètres nécessaires à l'import diffèrent.

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 source 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),

  • UTF8,

  • Windows-1252 (Windows).

Chemin

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

  • Un fichier de type CSV,

  • Une adresse URL,

  • Un texte de type Export=Nom_Du_Contexte_Import permettant de faire des exports d'imports.

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

Spécifier la Feuille du fichier source à importer.

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 :

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

Il faut 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ée n'est pas précisée.

Condition SQL

Il est possible de préciser une condition SQL permettant notamment de filtrer les données à importer.

Cette condition dépend exclusivement de la structure de la table externe utilisée comme source.

Il ne s'agit pas d'une requête SQL mais bien d'une condition SQL.

Pour une requête définie telle que SELECT * FROM TABLE WHERE CONDITION, il suffit d'ôter la mention SELECT * FROM TABLE WHEREpour ne garder que la CONDITION.

Exemples :

Sens métier

Exemple de Requête SQL

Condition SQL pouvant correspondre

Toutes les personnes de Nantes

SELECT * FROM Personnel WHERE Agence LIKE ‘Nantes’

Agence LIKE ‘Nantes’

Tous les chantiers dont la durée est de 10,5 Jours

SELECT * FROM Client.Chantier WHERE Duration = 10.5

Duration = 10.5

Toutes les personnes dont le nom contient la lettre B

SELECT * FROM Personnel WHERE Personnel.nom LIKE '%B%'

Personnel.nom LIKE '%B%'

Cas des valeurs spécifiques

Cela permet d'importer sans nécessité de fichier source.

Les valeurs à importer sont définies directement dans le contexte d'import en les saisissant directement dans le champ Valeur.

Ce type d'import est particulièrement adapté pour la fonctionnalité d'affectation automatique.

Format des dates

Choisir le format des dates attendu lors de l'import.

  • dd/MM/yyyy,

  • yyyy-MM-dd,

  • MM/dd/yyyy,

  • ou dd.MM.yyyy.

Mode d'importation

Trois types d'importation sont possibles:

  • Création seulement : cette option permet une simple insertion des événements,

  • Modification seulement : cette option, avec le choix des chefs, permet une mise à jour simple des événements existants,

  • Modification/Création : cette option, avec le choix des clefs, permet une mise à jour des événements existants et la création des nouveaux événements.

Filtre d'événements

Il est possible de définir les événements à considérer comme présents dans le planning lors d'un import pour modification.

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

Important

Ce filtre est particulièrement utile dans le cadre d'un import pour mise à jour d'événements existants.

Procédure stockée

Avertissement

Ce paramètre n'est utile et accessible que dans le cas d'un import depuis 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.

Onglet Correspondance

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

Cette correspondance s'effectue champ par champ.

Il convient de remplir le tableau qui contient plusieurs colonnes :

Propriété

Cette colonne contient l'ensemble des propriétés ou rubriques pouvant être importées.

En cliquant sur , il est possible d'importer :

  • 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'import,

  • 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.

Avertissement

  • Dans le cas de l'import d'événements journaliers en utilisant le paramètre de la date de fin, il est nécessaire que la valeur à importer soit à J+1 pour que l'événement se termine à la date J.

  • Si une correspondance est faite avec une rubrique de type Opération, celle-ci sera automatiquement cochée comme clef.

Source

Choisir, pour chaque propriété ou rubrique à importer, le champ de la source correspondant.

Le nom de chaque élément à importé doit être choisi dans la liste des champs de la source. Les noms des champs en correspondance n'ont pas besoin d'être identiques. Cette correspondance est valable pour chaque enregistrement de la source.

Les propriétés et rubriques qui n'ont pas de correspondance suivent le comportement suivant :

  • dans le cas d'une insertion de nouvelles ressources, les valeurs de ces entités sont vides,

  • dans le cas d'une modification de ressources existantes, les valeurs ne sont pas modifiées.

Valeur

Dans le cas où l'information ne provient pas de la source, il est possible d'entrer manuellement la valeur de certains champs grâce à cette colonne. Cette valeur est la même pour tous les événements importés.

Variables globales

Dans une rubrique de type Texte, il est possible d'affecter les valeurs ci-dessous comme valeur statique d'un import.

  • $USERNAME: La valeur prise est alors l'identifiant de l'utilisateur qui lance l'import,
  • $NOW: La valeur prise est alors la date courante (jour et heure) au moment de l'import,
  • $DATENOW: La valeur prise est alors le jour courant au moment de l'import,

    $TIMENOW: La valeur prise est alors l'heure courante au moment de l'import.

Note

Les formats de date en sortie respectent le format donné par le langage du serveur.

Maintenant

Dans une rubrique ou propriété de type Date, il est possible de donner la date du déclenchement de l'import (“Maintenant”) comme valeur de la date à importer.

Pour cela il faut cocher la case situé à droite du choix de la date.

Valeurs multiples

L'insertion de valeurs multiples est possible dans les rubriques de formulaires de type :

  • Rubrique de type Liste à choix multiple,

  • Rubrique de type Attachement.

Pour cela il faut spécifier, dans la source, les valeurs à importer séparées entre elles par le caractère | .

Affectation automatique

Dans le cas de l'import de valeurs spécifiques, il est possible d'effectuer une affectation automatique de ressources à des événements existants. (c.f. Affectation)

La fenêtre suivante apparait :

Trois informations peuvent alors être renseignées :

Tri croissant

Si cette case est cochée, le choix des ressources à affecter a lieu de manière croissante. Dans le cas contraire, elle est décroissante.

Rubriques de tri

Choisir la ou les rubriques qui définissent le ou les critères d'affectation automatique.

Exemple : Si la rubrique Nom est la seule rubrique de tri et que la case tri croissant est cochée, les ressources sont affectées dans l'ordre alphabétique de leur Nom :

  1. Affectation d'Albert au premier événement,

  2. Puis affectation de Bertrand au second événement,

  3. Etc...

Filtre de ressources

Ce filtre permet de définir les ressources pouvant être affectées aux événements.

Pour que l'affectation automatique puisse n'avoir lieu que sur les ressources disponibles, il faut choisir un filtre de ressources avec le critère sur filtre d'évènements > Ne contient aucun évènement du filtre > A demander.

Clef

Pour chaque entrée présente dans la source de l'import, il est possible de vérifier si elle existe déjà comme événement dans le planning grâce à cette notion de clef.

Une clef est un identifiant unique formé d'une ou plusieurs propriétés et/ou rubriques. La clef permet ainsi de distinguer s'il s'agit d'insertion ou de mise à jour.

Deux cas sont possibles :

  • Si aucune propriété/rubrique n'est cochée comme clef, il s'agit d'un insertion de nouveaux événements.

  • Si un ou plusieurs entités/rubriques sont cochés comme clef, il s'agit d'une mise à jour d'événements existants et éventuellement d'insertion de nouveaux événements.

c.f. Mode d'importation

Clef Parent

Cette fonctionnalité n'est utile que dans le cas d'une hiérarchie verticale (c.f. Hiérarchie d'événements).

Pour chaque entrée présente dans la source de l'import, il est possible de vérifier si son événement-père existe déjà comme événement dans le planning grâce à cette notion de clef.

La clef parent permet ainsi de retrouver l'événement père pour créer ou mettre à jour ses événements-fils.

Si l'événement-père n'existe pas, alors ses événements-fils ne peuvent être importés ou mis à jour.

Modification d'un contexte d'import

Pour modifier un contexte d'import, 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'import), puis cliquer sur Valider pour enregistrer les modifications.

Suppression d'un contexte d'import

Pour supprimer un contexte d'import, 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.

Concaténation de valeurs

Il est possible, lors de l'importation dans la note de l'événement ou dans une rubrique de type "Texte" ou "Multi-lignes" des formulaires, de concaténer la valeur importée avec la valeur existante au lieu de remplacer cette dernière.

Ce mécanisme est mis en œuvre si la valeur importée commence par le caractère $+.

Dans le cas d'une rubrique de type Multi-lignes, la valeur importée est ajoutée sur une nouvelle ligne.

Trois cas sont possibles :

  • Utilisation de la colonne Valeur avec le préfixe $+,

  • Import de valeur spécifique avec le préfixe $+,

  • Ajout du préfixe $+ dans la source.

ghostghostghostghostghost
loading table of contents...