Méthodes de travail - Manuel d'utilisation

A ce jour (2002-06-11), il y a 2 méthodes de travail possibles avec ARIS2 System Manager.

Cette méthode est plus simple mais comprend un gros inconvénient.
Avant de fermer ARIS2 System Manager, vous devrez, le cas échéant, choisir entre annuler les opérations (mises à jour) ou les appliquer au BDC.
...

Cette méthode est plus flexible. Le principe est de travailler avec un fichier intermédiaire.
Elle permet de fermer ARIS2 System Manager pour le ré-ouvrir plus tard et reprendre le travail en cours.
De plus, ce fichier (le BDA de travail) peut être transporté d'un poste vers un autre, et permettant ainsi de changer de lieu de travail ou encore de montrer le projet de mise à jour à des tierces personnes.

Plus loin dans le texte, nous utilisons le terme "détacher un conteneur" pour exprimer l'idée de supprimer la représentation du dit conteneur au sein du programme System Manager. C'est cette représentation qui vous permet d'y accéder, à partir du programme System Manager. Vous comprendrez qu'un conteneur a une existence propre en dehors de l'application (bases de données, fichier sur votre disque dur).

Cependant, l'implémentation (l'aspect fonctionnel) actuel des BDA n'est pas encore parfaite. Il est ainsi possible d'effectuer des actions maladroites pouvant provoquer des incohérences dans votre System ARIS et/ou rendre instable ARIS2 System Manager.
La procédure à suivre est simple et sûre. Il est cependant impératif de bien la comprendre et de ne pas s'en écarter..
De futurs efforts viseront à plus de sécurité et de souplesse dans ce domaine complexe.

C'est simple, il vous suffit de trouver le fichier "ASM_Debug.exe" ARIS2 System Manager

et de l'ouvrir.
Vous pouvez en faire un raccourci sur votre bureau ou dans votre barre des tâches (quick luncher) ou encore une entrée dans votre menu "Démarrer". En effet, il n'existe pas encore d'utilitaire d'installation qui le ferait de manière automatique.

Pour avoir une réponse à cette question, vous pourriez faire appel à vos souvenirs, à savoir l'état de l'application la dernière fois que vous l'avez fermée.

Mais il vaut mieux vérifier de façon logique. Si l'action "ne plus travailler avec le BDA" est accessible dans le menu "Conteneurs" ou via le bouton connexe

se trouvant parmi les boutons principaux de l'application et, également, dans la fenêtre présentant les conteneurs, si l'action est accessible, la réponse est donc oui (il existe un BDA), dans le cas contraire, la réponse est non (il n'existe pas de BDA).

Possibilités:

oui : Etat 2 : BDA de travail, sans opérations
non : Etat 0 : Rien

Vous êtes dans cet état, lorsqu'il n'y a pas d'opérations en suspens et lorsqu'il n'y a pas de BDA de travail.
Nous considérerons ici, que vous restez dans cet état, même si vous consultez (ouvrir conteneurs, créer tableau, etc.).

Possibilités : (voir plus loin)

Travailler directement sur le BDC :
- Définir des nouveaux objets
- Définir des nouvelles versions d'objets existants
Travailler avec un BDA de travail :
- Créer un BDA de travail
Fermer ARIS2 System Manager

Vous travaillez directement sur le BDC et vous avez, soit défini de nouveaux objets ARIS, soit défini de nouvelles versions d'objets existants (voir plus loin : définir).
Attention : nous considérons cet état à partir du moment où, après avoir travaillé sur vos propositions de nouveaux objets ou (exclusif) de nouvelles versions, vous ne "savez pas quoi faire".

Possibilités : (voir plus loin)

Annuler les opérations
Appliquer les opérations au BDC

Vous êtes dans cet état, lorsque vous travaillez avec un BDA et que vous n'avez aucune opération en suspens (non encore enregistrée).

Possibilités : (voir plus loin)

Appliquer le BDA de travail sur le BDC
Détacher le BDA de travail
Définir de nouveaux objets
Définir de nouvelles versions d'objets existants

Vous êtes dans cet état, lorsque vous travaillez avec un BDA et que vous avez quelques opérations en suspens, suite à la définition de propositions, de nouveaux objets ARIS et/ou de nouvelles versions d'objets existants.

Possibilités : (voir plus loin)

Enregistrer les opérations dans le BDA de travail
Annuler les opérations
Définir de nouveaux objets
Définir de nouvelles versions d'objets existants

Ces "actions" sont le principal sujet du document "ArisInsert.doc".

Nous entendons par "définir", l'ensemble de manipulations nécessaires à la définition d'une proposition, c'est-à-dire :

Pour de nouveaux objets : créer les objets, via la fenêtre "libellé et création de nouveaux objets" puis, l'édition des propriétés (certaines propriétés sont obligatoires !) : éditer les libellés, éditer les descriptifs, éditer les données, ...
Pour les propositions de nouvelles versions d'objets existants : l'édition des propriétés concernées.
La création en elle-même est implicite à l'édition d'une propriété.

Remarque importante :

Lorsque vous n'utilisez pas de BDA de travail, il n'est pas possible de référencer des propositions de nouveaux objets au sein d'une proposition de nouvelle version d'un objet existant. C'est pourquoi les deux actions sont représentées séparément dans le schéma.
Vous devez donc, d'abord appliquer les opérations constituant vos propositions de nouveaux objets, avant de définir vos propositions de nouvelle version. Et inversement...
Attention, sans BDA de travail, il est possible de créer des propositions de nouveaux objets et de nouvelles versions. Seulement, étant donné que vous ne pourrez pas référencer vos nouveaux objets (sous la forme de proposition), vous risquez de vous trouver dans une impasse ! C'est pourquoi, il est conseillé de définir et appliquer :

vos propositions de nouveaux objets dans un premier temps.
vos propositions de nouvelles versions d'objets existants dans un second temps.

La création de propositions de nouveaux objets, de nouvelles versions, la définition et/ou redéfinition des propriétés constituent une suite d'opérations.

Ces opérations, sont visibles dans la fenêtre "les opérations" accessible via le menu "Fenêtre" ou le bouton connexe .
Hoo, c'est joli !.. ^_^

Lorsque vous utilisez un BDA de travail, vous pouvez référencer vos nouveaux objets au sein de nouvelles versions d'objets existants. Les deux actions n'en "font" alors qu'une.

Si vous utilisez un BDA de travail, vous vous trouvez maintenant dans l'état 3 : BDA de travail et opérations.

Si vous n'utilisez pas de BDA, vous vous trouvez maintenant dans l'état 1 :opérations, sans BDA de travail.

Vous souhaitez travailler avec un BDA de travail et vous êtes dans l'état 0 (rien).

Vous devez donc créer un nouveau BDA.

Vous devez avoir adopté une méthode de travail concernant vos BDA.
En effet, un BDA est un fichier. Vous devez donc adopter des règles de nomenclature pour ces fichiers, ainsi qu'un dossier sur votre disque dur où vous allez placer ces fichiers.
Supposons donc, que votre dossier soit "C:\ARIS2_System_Manager_BDAs\" et que vous nommiez les fichiers en reprenant la date et un numéro séquentiel, par exemple:
BDA_2002-02-01_01 (ou un nom qui évoque le contenu du BDA, suivi de la date et d'un n° séquentiel).

Pour cela, vous devez utiliser la fenêtre "Les Conteneurs" accessible via le menu "Fenêtre", ou le bouton connexe .

Ha bâ voui ...

Typiquement, vous avez votre BDC d'ouvert.
Clickez sur le bouton "ajouter, créer un nouveau conteneur" .

La fenêtre "Créer un nouveau conteneur" s'ouvre sous vos yeux !
^_^ B - D - A ^_^

Si nécessaire, sélectionnez une implémentation supportant les conteneurs de type BDA. Pour l'instant, "Belgium/UCL/SESA/ARIS2/StaticImpCont2".
Ensuite, clickez sur le bouton représentant un BDA fermé .

... PIANO !

1) Cherchez, créez votre dossier ...
2) Saisissez le nom de votre nouveau BDA
3) Clickez sur "Ouvrir" ("Open" en anglais ;-)

Sans aucun doute !

Et voilà, vous avez votre nouveau BDA !

Vous êtes maintenant dans l'état 2 : BDA, sans opérations

Vous avez défini des propositions de nouveaux objets ou de nouvelles versions d'objets existants.

Si vous travaillez avec un BDA de travail, vous êtes dans l'état 3 : BDA de travail et opérations.
Si vous travaillez directement sur le BDC, vous êtes dans l'état 1 : opérations sans BDA.

Vous pouvez annuler les opérations dans l'ordre inverse de vos actions via l'action "annuler la dernière modification" accessible via le menu "Modifications" ou le bouton connexe .
Vous pouvez également annuler la totalité des opérations par l'action "annuler toutes les modifications" du même menu ou le bouton connexe .

Si vous avez annulé toutes les opérations et que vous travaillez avec un BDA de travail, vous êtes dans l'état 2 : BDA de travail, sans opérations.
Si vous avez annulé toutes les opérations et que vous travaillez directement sur le BDC, vous êtes dans l'état 0 : Rien.

Si vous n'avez pas annulé toutes les opérations, vous restez dans le même état.

Vous travaillez avec un BDA et vous avez défini de nouveaux objets et/ou de nouvelles versions d'objets existants.
Vous êtes donc dans l'état 3 : BDA de travail et opérations.

Vous souhaitez maintenant sauvegarder vos opérations dans votre BDA de travail.
Ok, c'est possible ^_^

Il vous suffit de déclencher l'action "enregistrer les opérations" accessible via le menu "Modifications", ou le bouton connexe .

Vous êtes maintenant dans l'état 2 : BDA, sans opérations (rassurez-vous, nous ne parlons plus, ici, de vos opérations précédentes qui elles, ont bel et bien été enregistrées dans le BDA ;-)

Par détacher, nous entendons, supprimer le lien au sein de System Manager. Le fichier lui, reste présent sur votre disque dur.
Cette opération est nécessaire dans les cas suivants :

Vous avez appliqué le BDA de travail. Vous devez donc le détacher avant d'en créer un nouveau.
Situation exceptionnelle, vous ne souhaitez plus travailler avec le BDA de travail, mais directement sur le BDC. Que vous l'ayez appliqué ou non, vous devez le détacher.

Fermez le conteneur constituant votre BDA de travail.
Fermer conteneur ^o^
Clickez droit (menu contextuel) sur le BDA de travail puis,
clickez gauche sur l'option "fermer le conteneur sélectionné"

... le BDA est maintenant fermé, et vous ne travaillez plus avec.
'a pu !

Détachez maintenant le conteneur, en le sélectionnant et en pressant la touche [Delete] (supprimer) ou en clickant sur le bouton connexe "détacher le conteneur (ne plus le voir ici)".
Le fichier constituant le conteneur reste néanmoins sur votre disque dur. Gardez ce fichier, car l'ensemble des fichiers BDA constitue un historique qui pourra être exploité (consulté) dans les évolutions futures de ARIS2 System Manager.

Vous êtes maintenant dans l'état 0 : Rien.

Vous travaillez avec un BDA et vous avez rempli ce dernier de propositions, de nouveaux objets et/ou nouvelles versions d'objets existants.
Vous n'avez, de plus, aucune opération en suspens.
Vous êtes, en somme, dans l'état 2 : BDA de travail, sans opérations.

Vous êtes maintenant sûr que ces propositions sont acceptables et correctement définies.

Vous allez donc "appliquer", c'est-à-dire :

transformer les propositions de nouveaux objets en une première version de nouveaux objets du système ARIS,
et les propositions de nouvelles versions d'objets existants en nouvelles versions de ces objets.

Actuellement, le BDC ne contient jamais qu'une version de chaque objet. Avant d'effectuer ce genre d'opérations, il vous est conseillé d'effectuer une sauvegarde du BDC. Cela peut être fait de manière automatique et journalière au travers de backups automatiques configurés au sein du SGBD(serveur de bases de données).

Sélectionnez le BDC.
Houlala !...

Clickez sur le bouton "appliquer, enregistrer, valider le BDA de travail sur le BDC ! !" .

La fenêtre "Appliquer BDA sur BDC ..." s'ouvre alors ...
Ha ba voui ^_^

Le bouton "Go go go !" (voir grosse flèche rouge sur l'image ci-dessus) est actif lorsqu'il n'y a aucun problème.
Vous pouvez alors clicker ce bouton, ...

La question vous est posée, si vous êtes sûr de vouloir appliquer le BDA. Ceci, pour des raisons de sécurité ^_^
Heu belebele... ?
Clickez "Yes" (oui) ...

Si tout s'est bien passé, un message vous avertit que votre BDA a bien été appliqué.
Waw !
Clickez simplement sur "OK" ...

Le bouton "Go go go !" est maintenant désactivé ...
Humm....
Fermez la fenêtre ...

... et détachez le BDA de travail !

Problèmes éventuels :

Le bouton "Go go go !" peut ne pas être actif dans les cas suivants :

Votre BDA de travail est vide car vous n'avez encore enregistré aucune proposition dans votre BDA !
Vous avez déjà appliqué votre BDA !
Vous (et vos collègues) travaillez en parallèle, sur plusieurs BDA en même temps (attention : voir section ad hoc).
Ainsi, votre BDA a peut-être été créé avant les dernières modifications apportées au BDC, soit via un autre BDA, soit via la méthode directe.
Si vous avez bien compris comment travailler en parallèle et les difficultés que cela entraîne, vous pouvez alors cocher la case "Accepter la concurence de BDAs (travail en parallèle)".

2 cases à cocher apparaissent alors, correspondant au cas suivants :
- Vous travaillez en parallèle, et il vous arrive de travailler longtemps sur un même BDA. Ainsi, il peut arriver qu'au sein de l'un de ces BDAs, vous créiez une proposition de nouvelle version d'un objet qui, depuis la création de ce BDA, a déjà été mis à jour (dans le BDC, donc...). Le test qui est fait pour vous éviter la concurrence de nouvelles versions d'un même objet, se basant sur la date de création de votre BDA, est alors trop "sévère".
  Si vous êtes dans un tel cas de figure, cocher la case "Ne pas se baser sur la date de création du BDA" résoudra le "problème" (Le bouton "Go go go !" devient actif et vous pouvez clicker dessus et ainsi, donc, appliquer votre BDA !).
- Certaines propositions de nouvelles versions sont "obsolètes" car leur date est moins récente que la version la plus récente présente dans le BDC.
  Peut-être avez-vous déjà appliqué le BDA !
  Si telle n'est pas la raison et que vous comprenez le pourquoi de cette aberration, vous pouvez cocher la case "Fermer les yeux !". Ainsi, plus aucun test n'est fait, le bouton "Go go go !" est actif et vous pouvez appliquer en clickant dessus.
  Notez que du fait que plus aucun test n'est effectué, il vous est ainsi possible également, d'écraser une version "parallèle" ou même plus récente, créée par un collègue.

Les autres problèmes sont insolubles ici (problèmes de lecture du fichier BDA, de connexion au BDC, etc.).

Vous travaillez directement sur le BDC et vous avez défini de nouveaux objets et/ou de nouvelles versions d'objets existants.
Vous êtes donc dans l'état 1 : opérations sans BDA de travail.

Vous êtes maintenant sûr que ces propositions sont acceptables et correctement définies.

Vous allez donc appliquer, transformer les propositions de nouveaux objets en de premières versions de nouveaux objets du système ARIS, et les propositions de nouvelles versions d'objets existants en nouvelles versions de ces objets.

Dans la fenêtre "les conteneurs", sélectionnez le BDC (ouvert) ...
marant le zoeil !

Et clickez sur le bouton "! enregistrer directement dans le BDC !" ...

... et voilà. Ce même bouton est maintenant désactivé, et si vous ouvrez la fenêtre des opérations , vous constaterez qu'il n'y a plus d'opération en suspens ^_^

Vous êtes dans l'état 0 : Rien.

Vous avez suffisamment travaillé pour aujourd'hui ou encore, vous attrapez mal à la tête à force d'utiliser ARIS2 System Manager. Vous allez donc fermer l'application.

Pour ce faire, vous êtes dans l'état 0 : Rien ou dans l'état 2 : BDA sans opérations.
Si vous n'êtes pas dans l'un de ces états, vous n'êtes peut-être pas conscient que les éventuelles opérations en suspens vont être perdues ! ? Si tel est le cas et que vous demandez la fermeture de l'application, vous verrez ce message, cette question : Houlala !!!
Il vous incombe de répondre à cette question, en votre âme et conscience !

Pour fermer l'application, vous pouvez
- utiliser la combinaison de touches bien connue Alt+F4
- ou clicker sur la petite croix en haut à droite de la fenêtre principale
- ou encore, clicker droit (contextuel) sur l'icône de la barre des tâches représentant ARIS2 System Manager et clicker gauche sur l'option "fermer".

Il y a encore quelques bogues sur lesquels nous travaillons (à résoudre ;-). Aussi, des messages d'erreur peuvent apparaître à l'occasion. Dans ce cas, clickez sur "ok" de chacun d'eux ... Si (cas improbable) ces messages étaient trop nombreux, à l'aide d'un Ctrl+Alt+Del, fermez l'application avec un "fin de tâche" !

A bientôt ^_^