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 de ressources > Créer un contexte d'import de > Choisir la dimension.

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 à 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'import de ressources.

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

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

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.

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

Définir 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

Définir 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 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.

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.

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

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

Paramètres des ressources

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

Important

Il s'agit d'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.

  • Calendrier horaire : Choisir le calendrier horaire à affecter aux nouvelles ressources,

  • Calendrier journalier : Choisir le calendrier journalier à affecter aux nouvelles ressources,

  • Couleur : Choisir une couleur,

  • Icône : Choisir l'icône par défaut, si les paramètres de la dimension le permettent.

  • Règle de création d'événements : Choisir la règle de création à affecter aux nouvelles ressources.

Filtre de ressources

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

Pour cela, il faut choisir un filtre de ressources.

Important

Ce filtre est 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

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.

Importation d'événements à suivre

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

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, 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 les attributs). Ceci est utile lorsqu'un grand nombre de rubriques est concerné par l'import,

  • L'identifiant Interne (UID) des ressources.

Avertissement

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 à importer 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, 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.

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 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ée à droite du choix de la date.

Valeurs multiples

L'insertion de valeurs multiples est possible dans les rubriques 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 | .

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

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 une rubrique de type "Texte" ou "Multi-lignes", 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 valeurs spécifiques avec le préfixe $+,

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

ghostghostghostghostghost
loading table of contents...