Premier pas – Export / Import

Export manuel : procédure détaillée #

Étape 1 – Informations complémentaires #

L’écran d’accueil de l’assistant d’export présente le serveur, l’utilisateur et une zone de notes. Les notes sont utiles pour indiquer l’objet de l’export : livraison, correctif, sauvegarde avant modification, etc.

BONNE PRATIQUE – Nommer clairement l’export, utiliser une convention explicite : INSTANCE_ENV_OBJET_YYYYMMDD_HHMM.bib, par exemple RECETTE_TDB_Ventes_20260526_1500.bib.

Étape 2 – Sélection des éléments #

L’écran de sélection contient généralement trois zones : la famille d’objets à gauche, l’arbre de sélection au centre et l’aperçu à droite. L’utilisateur choisit les objets à exporter puis les ajoute à la sélection.

Étape 3 – Prévisualisation et génération du fichier #

La dernière étape permet de contrôler le contenu final et le nom du fichier .bib. Il faut comparer l’aperçu avec la liste attendue avant de générer le fichier.

Dernier contrôle avant génération, si une datasource, une requête ou une connexion attendue n’apparaît pas dans l’aperçu, annuler l’export et corriger les droits/publications avant de recommencer.

Ce qui est inclus dans le fichier .bib #

Ce qui est exclus du fichier .bib #

• Les chaînes de connexion complètes.
• La publication effective aux groupes sur l’environnement cible.
• Une sauvegarde complète de la base BiBOARD.
• Les objets non visibles par l’utilisateur exporteur.
• Les adaptations spécifiques de l’environnement cible : chemin serveur, base, schéma, compte technique, droits SQL.

Import manuel : procédure détaillée #

Étape 1 – Choisir le fichier .bib #

L’assistant d’import commence par le choix du fichier .bib. Il affiche ensuite les informations enregistrées lors de l’export : date, serveur d’origine, utilisateur et notes.

Vérifier l’origine du fichier AVANT import, contrôler que le fichier provient du bon environnement, de la bonne version BiBOARD et du bon périmètre fonctionnel.

Étape 2 – Sélection des éléments à importer #

L’utilisateur peut sélectionner les éléments du fichier .bib à importer. Comme à l’export, les dépendances nécessaires doivent être conservées pour éviter un import partiel inutilisable.

ATTENTION – Décocher une dépendance peut rendre un TDB ou un lot inutilisable. Exemple : importer un TDB sans son Hub ou sa requête peut provoquer des erreurs d’ouverture ou des composants vides.

Étape 3 – Association des connexions, bases et schémas #

Les connexions exportées ne contiennent pas toute la chaîne de connexion. À l’import, il faut associer chaque connexion du fichier à une connexion existante sur l’environnement cible. Selon les cas, il faut aussi adapter les noms de base et de schéma utilisés dans les requêtes.

Étape 4 – Prévisualisation du statut d’import #

La dernière étape affiche le statut attendu : création d’un nouvel objet, mise à jour d’un objet existant, ou erreur. Il est important de lire cette étape avant de valider.

Objet déjà existant : lors de l’import, BiBOARD identifie principalement les objets à partir de leur nom. Si un tableau de bord, une requête, un Hub ou un lot existe déjà avec le même nom dans l’environnement cible, l’objet existant sera remplacé / écrasé. Il faut donc vérifier les noms avant import afin d’éviter de remplacer une configuration existante par erreur.

Ordre logique d’import #

L’assistant importe les objets dans un ordre cohérent avec les dépendances :

1. Horaires
2. Requêtes
3. Hubs
4. PivotHubs
5. Tableaux de bord
6. Lots / tâches

INFO – Pourquoi cet ordre ? Un TDB ne peut être reconstruit correctement que si les Hubs / PivotHubs existent déjà, et un Hub dépend lui-même d’une requête, qui dépend d’une connexion associée.

Publications, droits et sécurité #

Publications après import #

Les catégories peuvent être créées pendant l’import si elles n’existent pas. En revanche, il ne faut pas considérer que les publications aux groupes clients sont automatiquement rétablies.

ATTENTION – Action obligatoire après import : vérifier et refaire les publications nécessaires : TDB aux groupes Web, datasources aux groupes Designer, requêtes aux groupes concernés, connexions aux groupes autorisés, lots aux administrateurs concernés.

Sécurité des connexions #

L’import impose une association vers des connexions déjà configurées dans l’environnement cible.

BONNE PRATIQUE – Créer ou vérifier les connexions cibles avant l’import, avec un compte technique adapté à l’environnement cible et les droits SQL strictement nécessaires.

Exemples concrets #

Exemple 1 – Exporter un TDB complet de recette vers production #

1. Se connecter avec un compte SuperAdmin ou un compte auquel toute la chaîne technique est publiée.
2. Cliquer sur Export.
3. Renseigner les notes : « Livraison TDB ventes v2 vers production ».
4. Dans Tableaux de bord, sélectionner le TDB à exporter.
5. Ajouter à la sélection.
6. Vérifier dans l’aperçu : TDB, Datasources, Requêtes, Connexions.
7. Générer le fichier .bib avec un nom explicite.
8. Sur l’environnement cible, préparer ou vérifier les connexions.
9. Lancer l’import et associer les connexions, bases et schémas.
10. Après import, publier le TDB aux groupes utilisateurs et tester l’ouverture.

Cas à risque : si l’aperçu contient seulement le TDB mais pas les Datasources/Requêtes, l’export est probablement incomplet pour un transfert complet.

Exemple 2 – Exporter uniquement une requête et sa datasource #

1. Sélectionner la datasource dans la famille Datasources.
2. Vérifier que la requête associée est ajoutée automatiquement.
3. Vérifier que la connexion apparaît dans l’aperçu.
4. Exporter le fichier .bib.
5. À l’import, associer la connexion source à la connexion cible.
6. Tester la requête puis le Hub dans l’environnement cible.

Exemple 3 – Importer un TDB quand le nom existe déjà #

Si un TDB du même nom existe déjà sur l’environnement cible, l’import peut mettre à jour l’objet existant. Cette opération peut remplacer ses composants, paramètres, hyperliens ou liens internes selon le contenu importé.

ATTENTION – Avant import sur objet existant : Faire une sauvegarde SQL ou un export .bib de l’objet cible actuel, puis contrôler l’écran de prévisualisation du statut d’import.

Exemple 4 – Export impossible ou incomplet avec un compte client limité #

Un administrateur voit un TDB publié, mais ne voit pas les datasources Studio utilisées par le TDB. Il lance l’export du TDB. L’aperçu n’affiche pas les datasources et requêtes attendues.

Exemple 5 – Import avec changement de base ou de schéma #

En recette, les requêtes pointent vers Datawarehouse_Recette. En production, la base s’appelle Datawarehouse_Prod et le schéma reste dbo. L’étape Connexion permet d’associer la connexion et de remplacer la base source par la base cible.