Le bureau Adélia Cloud

Le bureau Adélia Cloud est un espace sur lequel s'affichent les applications Adélia. Il fournit une ergonomie proche des bureaux classiques sur les PC Desktop, à savoir la présence d'une barre de tâches pour gérer les applications actives, la possibilité d'afficher des informations en arrière-plan, et un certain nombre de fonctionnalités supplémentaires.

Le bureau Adélia est une application modulaire qui gère le fond de l'écran (le fond du navigateur Web). Il est possible de l'étendre facilement en utilisant les modules d'extension simples à programmer et à instancier.

Un module d'extension peut ou non avoir une représentation graphique (par exemple le gestionnaire de thème est instancié par le bureau pour permettre le basculement dynamique de thèmes, mais n'a pas de représentation graphique directe sur le bureau).

↑ Haut de page

Le menu contextuel du bureau

Le menu contextuel du bureau affiche les options disponibles à l'utilisateur, en fonction de la configuration. Il peut être masqué intégralement ou partiellement.

Les sous-menus

Nouveau

Permet d'accéder aux options de création des Widgets enregistrés dans la configuration du bureau.

Si aucun Widget n'est disponible, ce menu ne s'affiche pas.

Personnaliser

Permet de basculer entre les thèmes installés. Il n'apparaît que si le gestionnaire de thèmes est instancié dans la configuration du bureau.

Réorganiser les icônes

Ce menu est disponible si le Widget Raccourci est enregistré.

Outils

Permet d'accéder à l'explorateur de fichiers et au gestionnaire des tâches.

Personnaliser le bureau

Permet d'accéder à la configuration du bureau Adélia Cloud.

Paramètres d'exécution

Ouvre la boîte des paramètres d'exécution Adélia.

Exécuter

Ouvre la boîte d'exécution.

Fermer la session

Permet de fermer la session en cours.

↑ Haut de page

Les outils fournis avec le bureau

Explorateur de fichiers

Permet d'afficher le contenu de l'arborescence du VFS accessible à l'utilisateur, de télécharger des fichiers depuis le serveur vers le poste client ou inversement de téléverser des fichiers depuis le poste client sur le serveur.

Attention : la limite de taille de fichiers en téléversement est fixée à 5 Mo.

Le gestionnaire des tâches

Le gestionnaire des tâches permet d'afficher la liste des programmes qui tournent dans la session Cloud active. Il permet notamment de terminer un processus, violemment ou non.

L'interface de configuration du bureau

Le programme de configuration du bureau permet de fixer certains paramètres du bureau (image d'arrière plan, etc.).

Les paramètres d'exécution Adélia

La boîte des paramètres d'exécution Adélia permet de fixer les paramètres du Runtime Adélia (langue d'affichage, contrôle des paramètres, interface des messages d'erreur, etc.).

La boite d'exécution

La boîte exécuter permet d'exécuter un programme Adélia en spécifiant ses paramètres sur la ligne de commande et son répertoire de démarrage relatif au VFS.

↑ Haut de page

Configuration du bureau

Le bureau est extensible via deux types de modules :

les modules simples, destinés à exister en un unique exemplaire,
les modules dynamiques (Widgets) dont il est possible de créer plusieurs instances différentes (par exemple, les raccourcis vers une application).

Le paramétrage initial du bureau est stocké dans un fichier de configuration statique de nom desktop.properties. Ce fichier comprend les références aux classes de module connues du bureau, aux instances de modules configurées statiquement et l'ensemble des paramètres associés.

Le bureau est fourni avec un certain nombre de modules de base :

Classe	Nom	Description
TaskBar	Barre des tâches	Fournit une barre des tâches permettant de gérer les applications actives.
MessageLog	Panneau des messages	Affiche les messages envoyés par les applications Adélia (ENVOYER_MSG).
ThemeManager	Gestionnaire de thèmes d'interface	Permet le basculement dynamique entre les thèmes d'interface.

Les Widgets fournis avec le bureau sont les suivants :

Classe	Nom	Description
Launcher	Lanceur d'application	Permet d'afficher et d'exécuter une liste d'applications Adélia.
Shortcut	Raccourci	Permet d'afficher sur le bureau un raccourci vers une application Adélia.
PostIt	Note	Permet d'afficher une note sur le fond du bureau.
Clock	Horloge analogique	Permet d'afficher une horloge.
IFrame	Page HTML	Permet d'afficher un document HTML dans un IFrame au sein du bureau.

↑ Haut de page

Paramètres du fichier desktop.properties

Les paramètres de base du bureau permettent de définir les modules à instancier statiquement (type barre des tâches, panneau des messages), ainsi que de lister les types de modules accessibles dynamiquement par l'utilisateur.

Par exemple, il est possible de démarrer un bureau vide, sans aucun module d'extension. Il est néanmoins conseillé d'installer au moins la barre des tâches ou un module équivalent permettant de gérer les applications démarrées, sans cela il serait entre autres impossible de réafficher une fenêtre minimisée.

Paramètre	Valeur par défaut	Description
moduleClasses		Liste des classes de module d'extension contribuant au menu contextuel du Desktop.
startupModules	TaskBar	Liste d'instances de modules à créer statiquement au démarrage du Desktop, séparées par des virgules. Il existe deux notations possibles : Pour les modules "mono-instance", le nom d'instance est simplement le nom de la classe du module (TaskBar, MessageLog, ThemeManager. Pour les Widgets (pouvant exister en plusieurs exemplaires), il faut rajouter un nom d'instance. Ce nom est un identifiant alphanumérique libre pour les Widgets configurés statiquement (Shortcut.1 ou Shortcut.shortcut1), créé sous forme d'un uuid unique pour les Widgets instanciés dynamiquement.
allowDesktopMenu	True	Détermine les droits d'accès au menu contextuel du Desktop. Valeurs possibles : True (disponible), False (masqué), nom_role_utilisateur (disponible si l'utilisateur est dans le rôle).
allowFileExplorer	True	Détermine les droits d'accès à l'explorateur de fichiers. Valeurs possibles : True (disponible), False (masqué), nom_role_utilisateur (disponible si l'utilisateur est dans le rôle).
allowProcessManager	True	Détermine les droits d'accès au gestionnaire des tâches. Valeurs possibles : True (disponible), False (masqué), nom_role_utilisateur (disponible si l'utilisateur est dans le rôle).
allowLogManager	True	Détermine les droits d'accès au gestionnaire de traces. Valeurs possibles : True (disponible), False (masqué), nom_role_utilisateur (disponible si l'utilisateur est dans le rôle).
allowAdeliaParameters	True	Détermine les droits d'accès aux paramètres d'exécution Adélia. Valeurs possibles : True (disponible), False (masqué), nom_role_utilisateur (disponible si l'utilisateur est dans le rôle).
allowDesktopParameters	True	Détermine les droits d'accès aux paramètres du bureau (arrière-plan). Valeurs possibles : True (disponible), False (masqué), nom_role_utilisateur (disponible si l'utilisateur est dans le rôle).
allowExecuteBox	True	Détermine les droits d'accès à la boite d'exécution d'une commande. Valeurs possibles : True (disponible), False (masqué), nom_role_utilisateur (disponible si l'utilisateur est dans le rôle).
allowCloseSession	True	Détermine les droits d'accès à la fermeture de la session. Valeurs possibles : True (disponible), False (masqué), nom_role_utilisateur (disponible si l'utilisateur est dans le rôle).
background		Image de fond du bureau (chemin dans le VFS).
backgroundPos	stretch	Positionnement de l'image de fond. Valeurs possibles : stretch : l'image est étirée sur la surface du bureau. cover : l'image est étirée de manière à couvrir intégralement le bureau en conservant les proportions (une partie de l'image peut être masquée). contains : l'image est étirée de manière à couvrir le bureau en hauteur ou en largeur en conservant les proportions (des bandes horizontales ou verticales peuvent apparaître). center : l'image est centrée sur le bureau sans être retaillée. mosaic : l'image est répétée sur toute la surface du bureau.
launch_<index>	n/a	Permet de démarrer automatiquement des applications lors de l'initialisation du bureau (au démarrage de la session Cloud). Pour cela, il faut indiquer dans le fichier de configuration desktop.properties des clés de la forme : launch_<index>=<nom_classe_point_entréeprogramme> <paramètres> L'index est un numérique démarrant à 1, sans rupture de séquence (i. e. si vous configurez launch_1, launch_2 et launch_4, seul les programmes 1 et 2 seront exécutés). Les programmes sont lancés avec le même chemin de démarrage que le bureau dans le VFS (tel que configuré dans wagon.xml, généralement "HOME:\"). Exemples : launch_1=com.hardis.adelia.cloud.common.dialogs.EXPLORmain launch_2=fr.mycompany.MONPGMmain param1 param2
phantomResizing	False	Permet d'activer le redimensionnement des fenêtres en mode fantôme.
optimizedDisplayTabbedWindow	False	Permet d'activer l'optimisation du temps d'affichage des fenêtres à onglets. Cette optimisation entraîne des restrictions sur l'utilisation d'objets graphiques Adélia contenus dans des onglets qui n'ont jamais été sélectionnés (soit par programme, soit par l'utilisateur) lors de l'exécution de la fenêtre : Objet ITEM MENU : le raccourci-clavier associé n'est pas supporté. Objet REQUETE AJAX : l'utilisation de toutes les méthodes n'est pas supportée. Objet LISTE : l'utilisation de la méthode RECUPERER_COORDONNEES_CELLULE n'est pas supportée. Objets ARBORESCENCE et ARBRE LISTE : l'utilisation des propriétés PREMIER_VISIBLE et PREMIERE_LIGNE_VISIBLE n'est pas supportée. Objet BARRE OUTILS : l'utilisation de la propriété HAUTEUR n'est pas supportée.

↑ Haut de page

Paramètres des modules

Les Widgets sont des modules repositionnables, susceptibles d'exister en plusieurs exemplaires. Ils ont donc un nom d'instance qui est unique par rapport à la classe. Leur position est exprimée en pixels.

Pour l'ensemble des Widgets, il est possible de créer statiquement des instances directement dans le fichier desktop.properties. Dans ce cas, il est possible de verrouiller ces modules instanciés par défaut avec le paramètre lock.

Le paramètre lock est constitué par addition des options suivantes :

1	Empêche l'accès au programme de configuration du Widget s'il existe.
2	Empêche la suppression du Widget (temporaire car il est impossible de supprimer définitivement un Widget statique).
4	Empêche de déplacer le Widget sur le bureau.
8	Empêche de retailler le Widget.

Exemple :

Déclaration d'un raccourci vers l'explorateur de fichier, positionné par défaut en 20, 20.

Le raccourci ne pourra pas être modifié mais le repositionnement (lock=3 - 1+2) est autorisé.

Le Widget est instancié statiquement (nom d'instance : "1") dans la liste des modules instanciés au démarrage :

startupModules=TaskBar,MessageLog,ThemeManager,Shortcut.1

Les paramètres du raccourci sont explicités dans le fichier :

Shortcut.1.title=Explorateur de fichiers

Shortcut.1.class=com.hardis.adelia.cloud.common.dialogs.EXPLORmain

Shortcut.1.top=20 Shortcut.1.left=20

Shortcut.1.params=

Shortcut.1.startupDirectory=HOME:\\ Shortcut.1.lock=3

↑ Haut de page

La barre des tâches (TaskBar)

Ce module n'est pas destiné à être instancié en plusieurs exemplaires. Les paramètres de ce module sont exprimés dans le fichier sous la forme TaskBar.<nomParametre>=<valeur>.

Exemple : TaskBar.alwaysOnTop=true

Paramètre	Valeur par défaut	Description
alwaysOnTop	True	La barre des tâches s'affiche par dessus les applications actives. La zone de travail du bureau ne prend pas en compte cette barre.
position	bottom	Position de la barre des tâches sur le bureau : Valeurs possibles : top, bottom, left, right.
allowAlwaysOnTop	True	Détermine les droits d'accès au mode d'affichage de la barre des tâches par rapport aux applications actives. Valeurs possibles : True (disponible), False (masqué), nom_role_utilisateur (disponible si l'utilisateur est dans le rôle).
allowSetPosition	True	Détermine les droits d'accès à la gestion de la position de la barre des tâches sur le bureau. Valeurs possibles : True (disponible), False (masqué), nom_role_utilisateur (disponible si l'utilisateur est dans le rôle).
allowCenterOnDesktop	True	Détermine les droits d'accès à l'option permettant de centrer une application sur le bureau. Valeurs possibles : True (disponible), False (masqué), nom_role_utilisateur (disponible si l'utilisateur est dans le rôle).
allowPinToTaskbar	True	Détermine les droits d'accès à l'option permettant d'épingler une application sur la barre des tâches. Valeurs possibles : True (disponible), False (masqué), nom_role_utilisateur (disponible si l'utilisateur est dans le rôle).
autoActivate	True	Permet d'activer automatiquement la fenêtre au survol de sa vignette.
activationDelay	500	Délai avant activation de la fenêtre au survol de la vignette.

↑ Haut de page

Le panneau d'affichage des messages (MessageLog)

Ce module n'est pas destiné à être instancié en plusieurs exemplaires. Les paramètres de ce module sont exprimés dans le fichier sous la forme MessageLog.<nomParametre>=<valeur>.

Paramètre	Valeur par défaut	Description
revealAutomatically	True	Le panneau se déploie automatiquement si un nouveau message est envoyé.
clearOnAppClear	False	Les messages applicatifs sont supprimés du panneau si l'application effectue un ENVOYER_MSG *EFF_TOUT.
clearOnAppClose	False	Les messages applicatifs sont supprimés du panneau si l'application se termine.
displayLevel2Text	True	Le texte de niveau 2 du message est affiché (sous le texte de niveau 1) lorsque l'application effectue un ENVOYER_MSG. Si la valeur est "False", l'utilisateur peut visualiser le texte de niveau 2 en cliquant sur le texte de niveau 1.
wrapText	False	Si la valeur est "True", les retours à la ligne sont appliqués, si nécessaire, aux textes de niveau 1 et 2 pour que ceux-ci s'affichent entièrement dans le panneau sans qu'il soit utile de paginer.
showAsPopup	False	Si la valeur est "True", les messages sont affichés dans un popup modal sur le bureau. Dans ce mode, le popup s'affiche automatiquement, et les messages sont supprimés lors de la fermeture.

↑ Haut de page

Le gestionnaire de thème (ThemeManager)

Ce module n'est pas destiné à être instancié en plusieurs exemplaires. Les paramètres de ce module sont exprimés dans le fichier sous la forme "ThemeManager.<nomParametre>=<valeur>".

Remarques :

- Le basculement automatique du thème ne fonctionne que si le ThemeManager est instancié (référencé dans la clé "startupModules").
- Le sous-menu de sélection des thèmes n'est disponible que si le ThemeManager contribue au menu du bureau (ie s'il est référencé aussi dans la clé "moduleClasses").

Paramètre	Valeur par défaut	Description
theme		Nom interne du thème à utiliser ou blanc pour utiliser le thème par défaut.
clearOnAppClear	False	Les messages applicatifs sont supprimés du panneau si l'application effectue un ENVOYER_MSG *EFF_TOUT.

↑ Haut de page

Raccourci (Shortcut)

Ce module est un Widget instanciable. Les clés de configuration sont sous la forme suivante :

"Shortcut.<nomInstance>.<nomParametre>=<valeur"

Exemple pour un raccourci créé statiquement :

"Shortcut.1.class=com.hardis.adelia.cloud.common.dialogs.EXPLORmain".

Paramètre	Valeur par défaut	Description
top	0	Position du widget sur le bureau.
left	0	Position du widget sur le bureau.
title		Libellé du raccourci
class		Nom de la classe du programme. Il s'agit du lanceur associé au programme, sous la forme <package>.<NOMIBM>main.
params		Paramètres du programme.
startupDirectory	False	Répertoire de démarrage dans le VFS.

↑ Haut de page

Note (PostIt)

Ce module est un Widget instanciable. Les clés de configuration sont sous la forme suivante :

"PostIt.<nomInstance>.<nomParametre>=<valeur>"

Paramètre	Valeur par défaut	Description
top	0	Position du widget sur le bureau.
left	0	Position du widget sur le bureau.
width	120	Largeur du widget.
height	120	Hauteur du widget.
value		Texte de la note.

↑ Haut de page

Lanceur d'application (Launcher)

Ce module est un Widget instanciable. Les clés de configuration sont sous la forme suivante :

"Launcher.<nomInstance>.<nomParametre>=<valeur>"

Paramètre	Valeur par défaut	Description
top	0	Position du widget sur le bureau.
left	0	Position du widget sur le bureau.
width	120	Largeur du widget.
height	120	Hauteur du widget.
package		Package contenant les programmes à énumérer.
title		Titre du lanceur.

↑ Haut de page

Page HTML (IFrame)

Ce module est un Widget instanciable. Les clés de configuration sont sous la forme suivante :

"IFrame.<nomInstance>.<nomParametre>=<valeur>"

Les options possibles correspondent aux attributs HTML5 acceptés sur le tag IFrame.

Paramètre	Valeur par défaut	Description
top	0	Position du Widget sur le bureau.
left	0	Position du Widget sur le bureau.
width	120	Largeur du Widget.
height	120	Hauteur du Widget.
title		Titre du Frame.
url		URL du document à intégrer (attribut src de l'IFrame).
sandbox		Valeur de l'attribut sandbox. Valeurs possibles : "*none" (pas de sandbox), ou valeur de l'attribut "sandbox" : blanc ou combinaison des options "allow-forms", "allow-same-origin", "allow-scripts" et "allow-top-navigation" séparées par des espaces.
seamless	False	Si la valeur est "True", ajout de l'attribut seamless (affichage du document comme s'il faisait partie intégrante de la page Web).
transparent	False	Masque la barre de titre et la bordure de l'IFrame quand celle-ci n'est pas active. Permet de ne voir que le document embarqué sur le bureau.

↑ Haut de page