• Sauvegarder les données
  • Procédure générale
  • Sélection des données à sauvegarder
    • Utilisateurs
    • Profils utilisateurs
    • Rôles
    • Groupes d'autorisations
    • Fichiers système
    • Bibliothèques
    • Fichiers de traductions
    • Sources de données
    • Autres
  • Options
• Restaurer les données
  • Restaurer les données depuis une archive
  • Restaurer une sauvegarde automatique
  • Statut des éléments de la sauvegarde
  • Restauration de modèles de données et modèles dépendants
• Migration des connexions aux bases de données et des serveurs de fichiers

Sauvegarder les données

La sauvegarde manuelle des données s'effectue depuis le module Configuration de DigDash.
Il faudra sélectionner les éléments que vous souhaitez sauvegarder puis générer la sauvegarde sous la forme d'un fichier zip qui vous permettra ensuite de les restaurer sur le nouvel environnement ou la nouvelle version.

Procédure générale

Pour sauvegarder les données :

1. Depuis la page d'accueil, allez dans Configuration puis Gestion des sauvegardes
2. Cliquez sur Sauvegarde.
3. Dans la boîte de connexion, saisissez le nom et le mot de passe de l'utilisateur.
   ➡ La page Sauvegarde s'affiche.
   Le menu à gauche permet de naviguer dans les différents types d'éléments. La liste des éléments correspondant au type sélectionné est affichée dans la zone centrale.
   
    
4. Sélectionnez les données à sauvegarder : consultez le paragraphe Sélection des données à sauvegarder ci-dessous pour une description détaillée des éléments.
5. Cliquez sur le bouton Télécharger.
   ➡ La fenêtre Options s'affiche.
6. Sélectionnez les options de votre choix : consultez le paragraphe Options ci-dessous pour plus de détails.
7. Cliquez enfin sur Télécharger pour obtenir le fichier de sauvegarde (fichier .zip).

Sélection des données à sauvegarder

Vous pouvez choisir de sélectionner directement l'ensemble des données en cliquant sur le bouton Sélectionner tout en haut à gauche ou de sélectionner, dans chacune des sections, les éléments que vous souhaitez sauvegarder.

Utilisateurs

Cette section liste les données relatives à chaque utilisateur. Elle permet notamment de sauvegarder les modèles de données, flux et tableaux de leur rôle personnel.
Vous pouvez cocher ici la case devant chaque utilisateur afin de sélectionner tous les éléments correspondants à celui-ci ou sélectionner les éléments un à un.
De même, vous pouvez cocher la case devant un élément (par exemple, Portefeuilles) afin de sélectionner cet élément pour tous les utilisateurs.
Il est également possible de sélectionner l'ensemble des données de la section en cliquant sur le bouton Sélectionner tous les résultats.

Profils utilisateurs

Cette section liste les profils utilisateurs. Consultez le paragraphe Gérer les profils utilisateur pour en savoir plus sur les profils utilisateur.

Rôles

Cette section liste les données relatives à chaque rôle.
La sélection des éléments se fait sur le même principe que pour les utilisateurs.
Il est néanmoins possible d'effectuer une sélection plus fine au niveau des portefeuilles, tableaux de bord et modèles de données. Pour ceux-ci, un compteur indique entre parenthèses le nombre d'éléments sélectionnés / le nombre d'éléments disponibles. Cliquez sur ce compteur pour accéder à la liste détaillée des éléments. Par exemple, pour un portefeuille, vous pourrez sélectionner les flux un à un.

Groupes d'autorisations

Cette section liste la définition des groupes d'autorisations fournis par DigDash ou ajoutés par l'utilisateur. Les groupes d’autorisations sont uniquement stockés dans LDAP.

Fichiers système

Cette section liste les fichiers système communs à tous les utilisateurs et les rôles (répertoire appdata>/Enterprise Server/ddenterpriseapi/config).

Bibliothèques

Cette section liste les bibliothèques de tous les utilisateurs et rôles en lien avec les différents gestionnaires. Ces fichiers peuvent être présents ou pas selon les paramètres utilisés par les flux ou les modèles de données (répertoire appdata>/Enterprise Server/ddenterpriseapi/config). 
Un compteur indique entre parenthèses le nombre d'éléments sélectionnés / le nombre d'éléments disponibles pour chaque dictionnaire. Vous pouvez cliquer sur ce compteur pour accéder à la liste détaillée des éléments et les sélectionner un à un. Vous pouvez également visualiser quels éléments sont assignés à un rôle et lequel.

Fichiers de traductions

Cette section liste les dictionnaires de traductions regroupant les messages dans différentes langues (répertoire appdata>/Enterprise Server/ddenterpriseapi/config).
Chaque fichier de traduction suivants peut être accompagné d’un fichier correspondant à la langue choisie. Par exemple les fichiers dm.properties, dm_fr.properties, dm_es.properties sont les traductions de messages correspondant au langue anglais (défaut), français et espagnol.

Sources de données

Cette section liste les sources de données figurant dans le serveur de fichiers Common Datasources.

Autres

Cette section liste les autres fichiers liés à la configuration des tableaux de bord.

Options

Restaurer les données

Restaurer les données depuis une archive

Pour restaurer des données depuis un fichier archive :

1. Depuis la page d'accueil, allez dans Configuration puis Gestion des sauvegardes.
2. Cliquez sur Restauration.
   ➡ La page Restauration s'affiche.
3. Cliquez sur Parcourir pour sélectionner le fichier zip correspondant à la sauvegarde que vous souhaitez restaurer.
   
   
   ➡ La page Restauration affiche les données contenues dans la sauvegarde. Elles sont toutes sélectionnées par défaut.
   Le nom du fichier et le mode de restauration (incrémental ou pas) sont indiqués en bas à gauche.
   
    
4. Vous pouvez modifier les éléments sélectionnés de la même façon que pour la sauvegarde.
   • Dans la section Rôles, une astérisque est ajoutée aux compteurs des portefeuilles, tableaux de bord et modèles de données dans le cas où la restauration est incrémentale (de même, dans la section Bibliothèques) : les éléments existants dans l'environnement de restauration seront complétés plutôt qu'écrasés par les éléments issus de la sauvegarde. 
   • Lorsque vous cliquez sur un compteur pour afficher le détail des éléments, vous pouvez visualiser leur statut en comparaison aux éléments déjà présents dans votre environnement : nouveau, identique, plus ancien, etc. Consultez le paragraphe Statut des éléments de la sauvegarde pour plus de détails.
5. Cliquez sur Restaurer en haut de la page.
   ➡ Un message vous indique que les données ont été rechargées et vous invite à redémarrer le serveur. 
   Dans le cas de la restauration d'un modèle de données dont la structure a été modifiée, un message s'affiche afin de proposer la mise à jour automatique des éventuels modèles de données dépendants (Union, Jointure et Transformateur). Consultez le paragraphe Restauration de modèle de données et modèles dépendants pour plus de détails.

Restaurer une sauvegarde automatique

Une sauvegarde automatique de votre environnement est effectuée avant restauration d'une archive ou par le service de maintenance automatique environnement avant le nettoyage des fichiers. Il est possible de restaurer ces sauvegardes :

1. Sur la page Restauration, sélectionnez une sauvegarde dans la liste déroulante Choisir une sauvegarde automatique enregistrée :
   • les sauvegardes automatiques régulières effectuées par le service de maintenance ont la mention (Automatique);
   • les sauvegardes automatiques effectuées avant restauration ont la mention (Pré-restauration).
     
      

2. Cliquez sur Charger.
   ➡ L'interface de restauration s'affiche alors de la même manière que pour la restauration depuis un fichier archive. Procédez de même que ci-dessus pour la suite de la restauration.

Statut des éléments de la sauvegarde

Comme indiqué précédemment, lorsque vous cliquez sur un compteur pour afficher le détail des éléments, vous pouvez visualiser leur statut en comparaison aux éléments déjà présents dans votre environnement.

Les éléments peuvent avoir les statuts suivants :

Restauration de modèles de données et modèles dépendants

Lors de la restauration de modèles de données avec des modifications de structure (ajout/suppression de dimensions ou mesures, modification de noms de colonne, etc) par rapport à celui de l'environnement courant, il est possible de mettre à jour automatiquement les modèles dépendants (Union, Jointure ou Transformateur utilisant le modèle de données). Par exemple, si l'on restaure un modèle de données dans lequel une mesure calculée a été ajoutée, une jointure utilisant ce modèle pourra automatiquement disposer de cette mesure calculée.

Lors du clic sur Restaurer, tous les modèles dépendants des modèles restaurés — Union, Jointure ou Transformateur — sont recherchés. 
Un message listant les modèles dépendants impactés par les modifications des modèles restaurés s'affiche alors:

• Cliquez sur OK pour "propager" la mise à jour des modèles restaurés aux modèles dépendants.
  Pour chaque modèle mis à jour, un calcul de dépendances est effectué pour que tous les modèles soient mis à jour (si un transformateur utilise un modèle issu d'une union, il sera mis à jour automatiquement après l'union).
  ➡ Un message d'information indique les modèles mis à jour avec succès.
  

• Cliquez sur Annuler si vous souhaitez mettre à jour les modèles de données manuellement plus tard.

Migration des connexions aux bases de données et des serveurs de fichiers

Afin de faciliter la migration de ces éléments, Il est possible de modifier leurs identifiants afin que ceux-ci soient identiques entre les serveurs de développement et production.

Lors de la première migration entre un serveur de développement et un serveur de production :

1. Effectuez une sauvegarde complète de l'environnement de développement.
2. Restaurez la sauvegarde sur l'environnement de production.
3. Modifiez les chaînes de connexion vers les bases de données et les serveurs de fichiers sur l'environnement de production depuis, respectivement, le Gestionnaire de connexions aux bases de données et le Gestionnaire des serveurs de fichiers dans le Studio.

Lors des migrations suivantes vers des environnements de production :

1. Faire un sauvegarde sélective des données : modèles de données, portefeuilles, tableaux de bord modifiés ou nouveaux,...

2. Restaurez la sauvegarde sur l'environnement de production.
3. Si des modifications ont été apportées aux connexions ou serveurs de fichiers dans l'environnement de développement, reportez les manuellement sur l'environnement de production.

Pour les nouvelles connexions ou les nouveaux serveurs de documents, reportez l'identifiant utilisé sur l'environnement de développement :

• Pour reporter l’identifiant de connexion base de données, ouvrez le Gestionnaire de connexions aux bases de données dans le Studio. Éditez la connexion à modifier puis cliquez sur le bouton Éditer à droite du champ Identifiant pour modifier ce dernier.
  
   
• Pour reporter l’identifiant d'un serveur de documents, ouvrez Gestionnaire des serveurs de fichiers dans le Studio. Éditez le serveur de fichiers à modifier puis cliquez sur le bouton Éditer à droite du champ Identifiant pour modifier ce dernier.