Navigation

Gérer la navigation entre les différents écrans


FlowerDocs s’appuie sur un mécanisme de place permettant de définir dans l’URL, l’activité (ou écran) sur laquelle se trouve l’utilisateur. Le fait que cette place soit portée par l’URL permet aux utilisateurs de pouvoir :

  • rafraîchir leur navigateur tout en restant dans le même contexte
  • de naviguer à travers l’historique du navigateur (boutons Précédent et Suivant)

Navigation

Pour piloter ces fonctionnalités à travers l’API JS, une API de navigation est mise à disposition :

var navigationJSAPI = JSAPI.get().getNavigationAPI();


Fonction Description
reload() Permet de recharger la place courante sans confirmation
goBack(confirmation) Permet de revenir à la place précédente
- confirmation : booléen permettant de désactiver la confirmation au changement de place s’il y a des modifications non sauvegardées
goToComponentPlace(category, identifiant, confirmation) Permet de rediriger l’utilisateur vers l’écran de modification d’un composant en fournissant :
- category : DOCUMENT, FOLDER, TASK, VIRTUAL_FOLDER
- identifiant : identifiant du composant à ouvrir
- confirmation : booléen permettant de désactiver la confirmation au changement de place s’il y a des modifications non sauvegardées
goTo(place, confirmation) Permet de rediriger l’utilisateur vers une place
- place : identifiant de la place à ouvrir
- confirmation : booléen permettant de désactiver la confirmation au changement de place s’il y a des modifications non sauvegardées

Il est possible de rediriger l’utilisateur vers une place construite à partir de différents tokens.
Exemple : Redirection vers un écran de création de tâche GEC_Step0_Creation

var navigationJSAPI = JSAPI.get().getNavigationAPI();
var placeToken = 'storeTask(GEC_Step0_Creation)';
navigationJSAPI.goTo(flower.docs.PlaceBuilder.build(placeToken),false);


L’API de navigation permet également de surcharger la place par défaut (définie au niveau du profil). Pour cela, il est possible de s’abonner à son ouverture via la fonction registerForPlaceChange(callback)

Exemple : Surcharger la place par défaut par le formulaire de recherche pliSearch

var navigationJSAPI = JSAPI.get().getNavigationAPI();
navigationJSAPI.registerForPlaceChange(function(placeToken, callback){
   callback.go(flower.docs.PlaceBuilder.build("search(pliSearch)"));
});

Place courante

Grâce à l’API de navigation, il est également possible de récupérer la place courante et ses caractéristiques grâce à la méthode getWherePlace().

var navigationJSAPI = JSAPI.get().getNavigationAPI();
var place = navigationJSAPI.getWherePlace();


Cet objet expose les méthodes suivantes :

Fonction Description
getWhereId() Permet d’obtenir l’identifiant de la place courante
getPlaceType() Permet d’obtenir le type de la place courante : HomePlace, SearchPlace, BrowsePlace, ModifyVirtualFolderPlace, ModifyFolderPlace, ReportingPlace , AdminPlace
getSelectedLeaf() Permet d’obtenir l’aggrégation sélectionnée dans le dossier virtuel
getOpenedItems() Permet de récupérer l’arborescence ouverte dans le dossier virtuel
getTemplate() Permet d’obtenir le modèle de recherche sélectionné
getRequest() Permet de récupérer la requête exécutée dans les recherches et les dossiers virtuels (visible dans l’URL)
getSearchDisplayMode() Récupère le mode d’affichage de la recherche : CARD ou TABLE
getVirtualFolderMode() Récupère le mode d’affichage du dossier virtuel : VIEWER ou AGGREGATION
isAdminPlace() Indique si la page est côté administration