DOCUMENTATION de VISUAL PLANNING 5.3

Définition du contexte d'import d'événements

Cette page décrit les paramètres nécessaires à la définition d'un contexte d'Import d'Evénements.

Les paramètres des autres types de contextes d'import/export sont disponibles ici :

Spécifier les caractéristiques de l'import dans les onglets existants.

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.

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 SGBD1) utilisée :

  • MSACCESS,
  • MYSQL,
  • ORACLE,
  • ou SQLSERVER.

c.f. plannings_et_bases_de_donnees

Paramètres de connexion

Les paramètres de connexion diffèrent selon le type de SGBD choisi. Après un clic gauche, une nouvelle fenêtre apparaît :

MSACCESS MYSQL ORACLE SQLSERVER
SID
Mot de passe
Chemin d'accès
Port
Serveur
Login

Pour valider ces paramètres, il faut effectuer un :

  • Clic sur OK
  • ou sur Annuler pour revenir en arrière.

Base de données

Il faut préciser le nom de la Base de données d'où 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. Généralement, pour une requête définie telle que :

SELECT * FROM TABLE WHERE CONDITION

Il suffit d'ôter la mention :

SELECT * FROM TABLE WHERE

pour ne garder que :

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

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

Feuille

Spécifier la Feuille du fichier source à importer.

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,
  • ou Tabulation.

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=NomDuContextImport permettant de faire des exports d'imports.

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.

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

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

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 clé.

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.

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.

Cas particuliers :

Variables globales

Dans une rubrique de type texte, il est possible d'affecter la variable $USERNAME comme valeur statique d'un import.

La valeur prise est alors l'identifiant de l'utilisateur qui lance l'import.

c.f. Déclencheurs d'import/export

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 types:

Pour cela il faut spécifier dans la source des données 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)

S'il s'agit du nom de la dimension, 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ènement > 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 rubriques. La clef permet ainsi de distinguer s'il s'agit d'insertion ou de mise à jour.

Deux cas sont possibles :

  • Si aucune rubrique n'est cochée comme clef, il s'agit d'un insertion de nouveaux événements.
  • Si une ou plusieurs rubriques sont cochées 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.

c.f. clef

Onglet Définition

Format des dates

Il faut choisir le format des dates attendu lors de l'import.

  • dd/MM/yyyy
  • yyyy-MM-dd
  • MM/dd/yyyy
  • dd.MM.yyyy

Mode d'importation

Trois types d'importation sont possibles:

  • Création seulement : cette option permet une simple insertion des nouveaux é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 préciser quelles sont les événements à considérer comme présents dans le planning. (Import pour modification)

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

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

Procédure stockée

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

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.

c.f. Enchaînement d'import/export

1) Système de Gestion de Base de Données
Imprimer/exporter
Langages
Traductions de cette page: