DOCUMENTATION de VISUAL PLANNING 5.3

Définition du contexte d'import de ressources

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

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

Type

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

SGBD

Préciser la technologie de SGBD1) utilisée :

  • MSAccess,
  • MySQL,
  • Oracle,
  • SQL Server,
  • ou PostgreSQL.

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 ORACLE SQLSERVER POSTGRESQL
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

Cchoisir la Table ou la Vue à importer.

Cette liste est vide tant que la base de données 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 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 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 *.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=NomDuContexteImport permettant de faire des exports d'imports.

Cas des valeurs spécifiques

Cela permet d'importer sans fichier source.

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

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 une des dimensions du planning.

Cette correspondance s'effectue champ par champ.

Il convient de remplir le tableau qui contient plusieurs colonnes :

Dimension

Cette colonne prend le nom de la dimension choisie. Elle contient les noms des rubriques et attributs choisis pour l'import.

En cliquant sur , il est possible d'importer :

  • Chaque rubrique de la dimension individuellement,
  • 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,
  • L'identifiant Interne (UID) des ressources.

On ne peut pas importer de valeurs dans les rubriques de type :

  • Total de contrôle,
  • Opération,
  • Géolocalisation (Si Localisation automatique est cochée),
  • et Valeurs d'événements,

Si ces rubriques sont choisies, elles seront automatiquement définies comme clefs.

Source

Choisir pour chaque rubrique ou attribut à exporter, 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 rubriques qui n'ont pas de correspondance suivent le comportement suivant :

  • dans le cas d'une insertion de nouvelles ressources, les valeurs de ces rubriques sont vides,
  • dans le cas d'une modification de ressources existantes (utilisation d'une clef), 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 du champ est la même pour toutes les ressources importées.

Cas particuliers :

Variables globales

Dans une rubrique de type texte, il est possible d'affecter la valeur $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 type :

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

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 ressource dans le planning grâce à cette notion de clef.

Une clef est un identifiant unique formé d'une ou de 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 nouvelles ressources.
  • Si une ou plusieurs rubriques sont cochées comme clef, il s'agit d'une mise à jour de ressources existantes et éventuellement d'insertion de nouvelles ressources.

c.f. Mode d'importation

Onglet Définition

L'onglet Définition recoupe plusieurs types de paramètres :

Paramètres des ressources

Ces informations sont utiles dans le cadre d'un import pour insertion de nouvelles ressources (pas d'utilisation de clef).

Il s'agit des informations qui seront attribuées aux nouvelles ressources importées. Ces paramètres ne sont pas modifiés dans le cas d'une mise à jour de ressources existantes.

Filtre de ressources

Il est possible de préciser quelles sont les ressources à considérer comme présentes dans le planning. (Import pour modification)

Pour cela, il faut choisir un filtre de ressources.

Ce filtre est particulièrement utile dans le cadre d'un import pour mise à jour de ressources existantes.

Mode d'importation

Trois types d'importation sont possibles:

  • Création seulement : cette option permet une simple insertion des ressources,
  • Modification seulement : cette option, avec le choix des clefs, permet une mise à jour simple des ressources existantes,
  • Modification/Création : cette option, avec le choix des clefs, permet une mise à jour des ressources existantes et la création des nouvelles ressources.

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

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

Importation d'événements à suivre

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

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