SQWareManager:MODOP

Généralités

Limites de cette section

Cette section n’a pas la prétention de traiter tous les cas possibles de paramétrage de SQWareAdmin.
Ce chapitre va traiter certains cas d'utilisation majeurs et vous aider à maitriser certaines manipulations de base de la partie SQWareAdmin_Web_Core.

Fonctionnalités principales

Dans cette partie nous allons voir rapidement comment fonctionnent les composants principaux de SQWareAdmin_Web_Core.

L'explorateur d'instance

L'explorateur d'instance permet de naviguer dans les différents objets des instances qui vous ont été autorisées en lecture.

C'est le seul composant qui ne peut pas être fermé, il apparait sur le panneau de gauche au lancement de l'application.

Il fonctionne comme une arborescence, alternant entre dossiers et objets.

Il s'agit du composant de contrôle central, c'est lui qui vous permet notamment de :

• Visualiser l'architecture de vos instances
• Read / Create / Edit / Delete des objets de catalogue (tables, tablespace, logins, etc...)
• (futur) Read / Create / Edit / Delete des données de tables, de vues, etc...

Vous pouvez à tout moment le rafraîchir en effectuant un clic droit dans l'onglet de l'explorateur, et "Refresh" (ou "Rafraîchir")

Navigation

Il est seulement possible de naviguer dans les instances possédant le chevron droit (sorte de flèche) blanc sur sa gauche. Cela signifie que l'instance est liée à une chaîne de connexion (nous y reviendrons plus tard).

Si l'icône à gauche de l'instance est un lien cassé de couleur rouge, cela signifie qu'aucune chaîne de connexion n'est reliée à celle-ci, la navigation est donc impossible.

Lors du déroulage d'un nœud d'arborescence, si une roue de chargement apparaît, cela signifie que le système à besoin de récupérer des informations sur l'instance pour vous les afficher.

Mode sélection

L'explorateur d'instance peut passer en mode sélection, vous pouvez le voir par le "[selection mode]" qui s'affiche dans l'onglet de l'explorateur.

Ce mode signifie que l'onglet de gestion des chaînes de connexion ("CSTR Settings") est ouvert, avec le focus dessus.

L'activation de ce mode modifie le comportement de l'arborescence :

• Désactive la possibilité de naviguer dans les objets
• Désactive le menu contextuel des instances
• Permet uniquement la sélection d'une instance pour y modifier la configuration des chaînes de connexion

Pour revenir au mode d'exploration (mode par défaut), fermez l'onglet "CSTR Settings" ou naviguez sur un autre onglet ouvert.

La chaîne de connexion

La chaîne de connexion est un élément central dans SQWareAdmin, en effet, elle vous permet de vous connecter aux différentes instances de votre parc.

Dans SQWareAdmin, une chaîne de connexion sert forcément à se connecter à une instance enregistrée dans votre Repository, il n'est donc pas possible de se connecter à une instance qui n'aurait pas été enregistrée au préalable dans dbSQWare.

En tant qu'utilisateur vous pouvez créer des chaînes de connexion, peu importe vos droits (tant que vous avez le droit d'accès à la plateforme), sur les instances qui vous ont été ouvertes à la visualisation.

Gestion des chaînes

Pour gérer les chaînes de connexion d'une instance, il suffit d'effectuer un clic droit sur une instance et, dans le menu contextuel, cliquer sur "Access Properties" (ou "Propriétés d'accès").

L'explorateur d'instance va passer en mode "[selection mode]" (cf. Mode sélection).

Il vous suffit de sélectionner l'instance sur laquelle vous souhaitez paramétrer les chaînes.

Le contexte de la page "CSTR Settings" va changer pour vous afficher les informations de l'instance que vous avez sélectionnée, dans la barre orange vous retrouverez :

• Le type de moteur (rdbmstype)
• Le nom de votre instance (dbalias)
• Des actions globales

Un tableau va s'afficher, vide ou contenant des chaînes selon votre contexte.

La sélection d'une chaîne se fait en cliquant sur le bouton radio d'une chaîne du tableau (à gauche des informations de la chaîne).

Dans l'explorateur d'instance en mode "[selection mode]", vous noterez que :

1. Une instance non liée à une chaîne se verra afficher une icône "lien brisé rouge" à gauche de son nom
2. Une instance liée à une chaîne se verra afficher une icône "lien vert" à gauche de son nom

Nous vous conseillons de faire un rechargement d'instance (clic droit sur l'instance, puis "Refresh" (ou "Rafraîchir")) après chaque changement de chaîne.

Les formulaires

Dans SQWareAdmin vous pouvez tomber sur ces types de formulaires :

• Les formulaires de type "classique" : formulaire clé -> valeur uni-dimensionnel
• Les formulaires de type "table" : formulaire d'édition de masse bi-dimensionnel

Formulaires classiques

Les formulaires classiques sont représentés sous la forme d'un tableau à deux colonnes.

Vous pouvez augmenter ou réduire la largeur de ces colonnes en approchant votre curseur de la droite d'une des colonnes et d'effectuer un glissé vers la droite ou la gauche.

Une ligne affichée grisée et en italique est un champ qui n'est pas modifiable.

Pour modifier une valeur, il suffit d'effectuer un double clic sur la valeur, cela affichera l'entrée, un autre clic sera nécessaire pour focus cette entrée.

Lorsqu'un champ est modifié, la ligne de celui-ci apparaît en jaune, une icône "croix rouge" apparaît alors à sa droite. Un clic sur cette icône remplacera la valeur modifiée par sa valeur d'origine.

Formulaires tabulaires

Les formulaires tabulaires sont représentés sous forme de tableau à n colonnes, avec au dessus, une barre d'actions.

Avec cette barre d'action il est possible de :

1. Ajouter une nouvelle ligne
2. Dupliquer les lignes sélectionnées
3. Supprimer les lignes sélectionnées
4. Restaurer le tableau à son état initial

Les actions sont disponibles ou non selon les droits paramétrés ou selon la configuration interne de l'application.

La notion des champs non modifiables est la même que pour les Formulaires classiques.

Voici les différents retours visuels qui sont effectués lors de la mise à jour du tableau :

• Si vous modifier une cellule, la ligne entière deviendra jaune
• Si vous supprimez une ligne, elle apparaîtra en rouge
• Si vous ajoutez une ligne (ou dupliquez une ligne existante), elle apparaîtra en vert

Cela permet de vous y retrouver lors de la modification d'un tel formulaire.

Tâches d'administration

L'ensemble de ces tâches seront effectuées dans la partie SQWareAdmin_Web_Admin.

Administration

Comment devenir SuperAdmin ?

Le rôle de SuperAdmin s'obtient lorsqu'un utilisateur fait partie d'un groupe qui est granté du type "Admin".

Comment devenir Administrateur ?

Lors de la liaison d'un utilisateur à un groupe, vous pouvez accorder les droits suivants :

• Connexion String Admin : Administrateur de chaine de connexion
• User Admin : Administrateur d'utilisateur

Chaînes de connexion

Comment créer une chaîne de connexion ?

1. Dans la partie SQWareAdmin > Connection strings cliquez sur le bouton Create
2. Sélectionnez l'instance que vous souhaitez utiliser pour cette chaîne de connexion (via son dbalias)
3. Remplissez les champs du formulaire et sauvegardez
4. La chaine apparaît maintenant dans la liste

Comment partager une chaîne de connexion ?

1. Dans la partie SQWareAdmin > Connection strings, ouvrez le formulaire d'édition de la chaîne
2. Allez dans l'onglet Groups, la liste des groupes qui s'affiche représente les groupes auxquels vous avez la permission de partager votre chaîne
3. Liez la chaîne à un groupe
4. Si vous souhaitez que ce partage expire, mentionnez une date d'expiration. Par la suite vous pourrez configurer des alertes pour vous prévenir de l'expiration du partage
5. Validez le formulaire

Votre chaîne de connexion est maintenant partagée à un groupe, vous avez été automatiquement redirigé vers l'interface permettant de paramétrer les droits d'accès/action aux objets d'instances via cette chaîne.

Comment régler les droits d'instance d'une chaîne ?

Vous êtes dans la partie SQWareAdmin > Connection strings > Groups > Instance rights (continuité de la section précédente).

L'interface de réglage des droits est séparée en deux parties :

• Une arborescence qui correspond à l'arborescence d'objets propre à l'instance de votre chaîne de connexion
• Un formulaire de réglage des droits

Les nœuds grisés représentent des dossiers, on ne peut donc pas paramétrer de droits dessus.

1. Cliquez sur un objet, le formulaire apparaît sur la droite
2. Les droits qui vous sont proposés sont ceux disponibles pour cet objet dans la configuration système, accordez des droits en cliquant sur ceux-ci
3. Enregistrez

Les droits sont maintenant valide pour toute personne faisant partie du/des groupes liés à cette chaîne.

Comment accorder des droits de gestion pour une chaîne ?

Dans la partie SQWareAdmin > Connection strings > Rights management

Vous avez un premier formulaire (disponible uniquement pour les propriétaires) qui vous permet de régler si oui ou non un SuperAdmin possède les pleins pouvoirs sur la chaîne.

En dessous, vous devez voir un tableau contenant la liste de tous les utilisateurs qui peuvent gérer votre chaîne.

1. Cliquez sur le bouton d'ajout d'utilisateur
2. Accordez les droits que vous souhaitez (voir ci-dessous)

* cstr_update_rights            : autorise la modification des droits de gestions sur la chaine
* cstr_update_rights_with_admin : autorise le partage du droit "cstr_update_rights" à un autre
* cstr_create_query             : autorise la création de requête sur cette chaîne
* ctsr_instance_rights          : autorise la modification des droits sur les objets d'instance
* cstr_sql_editor               : autorise l'utilisation de l'éditeur de requête sur cette chaîne
* cstr_update_data              : autorise la modification des informations de la chaine
* cstr_view_data                : autorise la visualisation des données sensibles de la chaîne (sauf mot de passe)

Requêtes partagées

Comment créer une requête ?

1. Dans la partie SQWareAdmin > Shared queries, cliquez sur Create
2. Remplissez le formulaire et validez

Pour la gestion des paramètres, imaginons que je souhaite écrire une requête qui récupère des utilisateurs. Et que je souhaite variabiliser un pattern de prénom et leur âge. La requête donnerait :

SELECT
    usr.name,
    usr.age,
    usr.email,
    ...
FROM users AS usr
WHERE (usr.name LIKE {userNamePattern} AND usr.age >= {userAgeMin})

Notez que ce soit pour entrer une chaîne de caractère ou un nombre, je ne met jamais de guillemets.

Maintenant dans le tableau des paramètres qui se trouve à droite je vais rentrer :

# userNamePattern
name         = userNamePattern
type         = string
defaultValue = '%'

# userAgeMin
name         = userAgeMin
type         = integer
defaultValue = 18

Comment partager une requête ?

1. Dans la partie SQWareAdmin > Shared queries > Groups, la liste représente (priorité) :
   • Les groupes qui sont liés à la chaîne utilisée par la requête
   • Les groupes dont vous faites parties
2. Sélectionnez un groupe pour le partage
3. Vous pouvez définir le paramètre Can edit parameters, cela permet aux utilisateurs qui utilisent cette requête de pouvoir toucher la valeur des paramètres que vous avez réglé (userNamePattern, userAgeMin, etc...)