voir Questions fréquentes & Erreurs connues

Nouveautés sur le noyau

Paramétrage dans l’URL des propriétés des widgets

Principe général

Vous pouvez dorénavant variabiliser certaines parties d’une application pour en définir le contenu via l’URL.

Ce système est conçu autour des propriétés 'exposées' des widgets, qui sont les propriétés définies comme accessibles via l’URL : chacune d'entre elles devient alors accessible via un paramètre dédié dans l’URL.

Note : Limité aujourd'hui à certaines propriétés, ce mécanisme va être étendu au fur et à mesure des versions.

Exemple d’utilisation

L’application ci-dessous permet d’afficher la fiche d’un utilisateur. Le système affiche par défaut le premier enregistrement.

Comment afficher n’importe quelle fiche Employé via l’URL ?

• Allez sur le datasource Employee List et paramétrez les propriétés de la nouvelle section Search : indiquez le champ de recherche (Search Field) et la valeur recherchée (Search Value).
           

• Allez sur la boîte des propriétés de l’application et cliquez sur le nouveau bouton [ Exposed Properties ] pour paramétrer l'URL d'accès.
           

• La fenêtre affiche les propriétés ‘exposées’ (aucune par défaut).
           

• Cliquez sur [ Add properties ] pour ajouter les propriétés de filtrage via l'URL : toutes les propriétés définies comme accessibles via l’URL sont affichées pour l'ensemble des widgets et datasources présents dans l'application.
           

• Sélectionnez la propriété SearchValue du datasource Employee List via la case à cocher et cliquez sur [ Ok ] : la propriété est maintenant disponible dans les propriétés ‘exposées’ et va pouvoir être prise en compte dans l'URL.
  Note : Le système des cases à cocher permet d’exposer plusieurs propriétés en une fois.

• Vous pouvez modifier la valeur existante de la colonne Content/Value : double-cliquez dessus et indiquez la valeur de l'enregistrement que vous souhaitez afficher.

• Cliquez sur le bouton [ Generate URL ] :
  • l'adresse URL correspondante est affichée ;
  • testez le bon affichage de l'enregistrement en cliquant sur Execute URL application.
             
             

Notes :

• Dans l'URL, vous pouvez sélectionner :
  • le nom du paramètre : colonne URL parameter alias. Par défaut, il s'agit du nom de la propriété. Pour des raisons de sécurité, vous pouvez choisir des alias de paramètres ‘anonymes’ comme Param1, Param2 etc…
  • le contenu (partie variable dans l’URL) : colonne Content/Value. Vous pouvez alors modifier par programme le contenu de ce paramètre pour afficher n’importe quelle fiche Employé.

• Pour s’assurer que l’application puisse être lancée sans paramètre, il est important de mettre des valeurs par défaut dans les propriétés exposées.

• Si une valeur est définie dans la propriété Search Value du widget ou du datasource, elle est affichée par défaut dans la fenêtre des propriétés ‘exposées’.
           

Modification sur la boîte de partage de l'application

Le nouveau bouton [ Exposed Properties ] est ajouté, permettant l'accès aux propriétés exposées.

Note : L’URL affichée ne tient pas compte des paramètres car le QR Code doit être en permanence valide. Ce sont donc les valeurs par défaut qui sont utilisées.

Interaction sur les raccourcis

Le fonctionnement pour les raccourcis est identique. Ajoutez les différents paramètres au raccourci, afin qu'ils soient automatiquement transmis à l’application pointée.

Informations de version sur la boîte de login

La version  est maintenant affichée sur la boîte de login.

Support des 6 langues pour les messages système

Les messages système peuvent maintenant être affichés dans les 6 langues standard. Le choix de la langue s’effectue toujours dans la boîte des informations utilisateur.

Évolutions du studio

Duplication d’éléments

Une fonction de duplication a été ajoutée sur les pages, widgets et datasources. Note : Les datasources composites ne sont pas duplicables.

• Elle peut être lancée :
  • via une icône dédiée  en regard de chaque objet pouvant être dupliqué ;
             
  • pour un widget, directement depuis le volet Conception via le menu contextuel.
             

• Les objets dupliqués apparaissent dans la liste avec le libellé (Copy).
           

• L'objet dupliqué est directement ouvert en mode Édition.

• Lorsque vous copiez un widget, le widget dupliqué est placé sur le volet Conception en dessous du widget source. Vous pouvez alors le déplacer comme les autres widgets.

Recherche

Une fonction de recherche a été ajoutée. Elle est disponible :

• lors de la création de nouveaux widgets / datasources pour un accès rapide au type d'objet à ajouter. Note : La recherche s'effectue également sur les custom widgets.
           

• dans les listes de widgets et datasources, pour un accès rapide à un objet existant.
           

Informations sur les connecteurs evSM dans la boîte ‘Au sujet de…’

Les informations de version sur les connecteurs evSM sont maintenant affichées dans la boîte Au sujet de… : versions  et de l’API

Accès direct à une page dans les widgets conteneurs de pages

Sur les widgets conteneurs de pages - Tab et Sliding Page - une nouvelle icône  permet d'indiquer la page à afficher en mode Édition.

Nouvel éditeur WYSIWYG

Ce nouvel éditeur permet une gestion des contraintes liées aux questionnaires et une gestion des tags plus aisée.

Nouvelle gestion de l’insertion des tags

La gestion des tags s'effectue maintenant via un panneau dédié dans l’éditeur HTML, accessible depuis l'icône , et dans lequel les tags sont regroupés dans 4 catégories disponibles en fonction du contexte.

• Catégorie Page : Permet d'insérer un lien hypertexte et de le configurer
           
  • Page Link : Permet l'ouverture du lien dans une nouvelle page, remplaçant la page courante.
  • Page Popup : Permet l'ouverture du lien dans une fenêtre Popup.

• Catégorie Data Picker : Permet de sélectionner les tags gérés précédemment via le data picker.
  • Ancienne version
             
  • Nouvelle version :
    • Affichage de 2 panneaux consécutifs, le premier permettant de choisir le champ et le deuxième permettant de définir les paramètres d’affichage.
               
    • En fonction du type de champ (Note : Actuellement uniquement pour les datasources Easyvista), plus ou moins de paramètres sont affichés. L'option Cell Value permet de sélectionner une valeur dans le tableau Résultat.

Champ Texte	Champ Date	Champ Numérique

• Catégorie Easyvista : Permet d’insérer des tags métier issus de  via  en regard de chaque élément.
           
  • Document upload : Fonctionnalité décrite dans la section Upload / Download de documents
  • New Request : Lorsque le datasource pointe sur la table SD_CATALOG, permet d’afficher une fenêtre Popup contenant les éléments (questionnaire compris) de création d'une nouvelle demande de service à partir de l’entrée de catalogue.
  • Embed Questionnaire : Similaire à New Request, les informations étant intégrées sous forme d’un panneau déroulant.
  • Status Notification : Affichage du bandeau vert de notification indiquant le statut de la demande créée.

• Catégorie Star Rating : Permet l'affichage des étoiles de notation de l’article de la base de connaissance.
                     

Import / Export des custom widgets et des thèmes

Une nouvelle fonction d’import / export des custom widgets et des thèmes a été ajoutée.

• L'export s’effectue via le menu contextuel des listes de custom widgets et thèmes, au format .tar.gz comme pour les exports d'applications.
           

• L’import s’effectue via le bouton [ Import ] dans la barre d’outils principale de la galerie.
           
  • Le mécanisme de sécurité est identique à celui de l'import des applications pour éviter tout import de fichiers illicites.
  • Attention :
    • Lorsqu'un custom widget ou un thème de même nom existe déjà, il est écrasé pour effectuer sa mise à jour.
    • Les applications utilisant des custom widgets ayant été mis à jour via un import ne sont pas touchées car ceux-ci sont copiés dans l'application.

Gestion des favicon d’une application

La boîte des propriétés de l’application a été modifiée et présente maintenant 3 onglets.

• Apps Icon : Icône de l’application
• Apps Header : Texte affiché dans la barre de titre de l'application en mode Exécution
• Favicon : Icône affichée dans la barre d'onglets du navigateur et icône de raccourci sur l’application sur un mobile
           

Édition des propriétés d’une application depuis la galerie

Les propriétés d’une application sont maintenant accessibles directement depuis la galerie via une fenêtre simplifiée, permettant ainsi une correction du connecteur empêchant l’ouverture de l’application.

Note : L’affichage de l'icône dédiée  est conditionné aux mêmes droits d’accès que l’icône d’édition des applications.

Évolutions sur la liaison avec ev|ITSM

Assistant de mise à jour des incidents

Présentation générale

Un nouvel assistant permet de mettre à jour les incidents  via un custom widget. Il s’appuie sur de nouveaux mécanismes de création de formulaires, actuellement réservés à EasyVista, mais qui seront intégrés au studio dans une version future pour permettre à tous les utilisateurs de personnaliser totalement les assistants intégrés ou d’en créer de nouveaux.

• L'assistant doit être associé à un bouton positionné sur un enregistrement de la table SD_REQUEST.
• Son fonctionnement est identique à celui de  :
  • Si l’incident sélectionné est clôturé, un message d’erreur est affiché.
  • Sinon, le contenu du champ Description est ajouté à la fin de la description existante de l’incident.
  • Création d’une action de type Mise à jour par l’utilisateur.
  • Mise à jour de l’historique des mouvements.

Exemple d’utilisation

Une liste d'incidents  est affichée via un widget Data Viewer.

• Cliquez sur le bouton [ Update Incident Record ] disponible sur la fiche.
           

• L'assistant de mise à jour est lancé.
           

• Renseignez la description puis cliquez sur [ Send ] : l'incident est mis à jour.
           
           

Mise en place de l’assistant

• Créez une nouvelle application Incident Management.
           

• Ajoutez un datasource Easyvista basé sur la liste des incidents.
           

• Ajoutez un widget Data Viewer pour la liste des incidents et un widget Secured Html pour la description de l’incident courant (mode Form).
           

• Créez une nouvelle page dédiée à l'assistant de mise à jour. Note : La case à gauche du nom de la page n’est pas cochée afin de rendre la page invisible dans le menu de l’application.
           

• Insérez le custom widget Update Incident Wizard. Note : Mettez une largeur maximale à la fenêtre pour éviter qu’elle ne soit trop large.
           
           

• Le custom widget contient un widget de type Memo pour la saisie de la description et 2 widgets de type Button [ Cancel ] et [ Send ]. Note : Ces 3 widgets ne sont pas disponibles dans la liste des custom widgets car ils font partie d’une catégorie spécifique forms qui sera mise à disposition dans une version future pour la réalisation de tous les types de formulaires de saisie.

• Vérifiez que le bouton [ Send ] est correctement paramétré tel qu’indiqué ci-dessous.
           

• Ajoutez le bouton d'appel de la liste des incidents sur le widget Data Viewer affiché sur la page principale de l'application :
  • Via la nouvelle fenêtre de saisie des tags, configurez le bouton pour ouvrir une fenêtre Popup et cliquez sur .
             
  • L'éditeur HTML est mis à jour (alignement du bouton à droite).
             

Gestion des uploads / downloads de documents

Upload de documents

La fonction d’upload de documents est accessible depuis le panneau dédié à la gestion des tags dans l’éditeur HTML (disponible en fonction du contexte).
           Via un formulaire depuis un widget Data Viewer (section Form)

Exemple d'utilisation de la fonctionnalité

• Depuis un objet permettant l'upload de documents, ouvrez l'éditeur HTML.
• Ouvrez le panneau dédié à la gestion des tags via .
• Ouvrez la catégorie Easyvista et cliquez sur  en regard de l'option Document upload : automatiquement l'instruction correspondant à la fonctionnalité est ajoutée sur l'éditeur.
           

• En mode Exécution, un bouton d'upload est affiché. Note : Le libellé du bouton est le même que dans .
           

Download de documents

Attention : 

• Cette fonctionnalité nécessite impérativement la présence de 2 fichiers EXP sur , pour mettre en place les vues gérant les téléchargements de documents : EXP pour la liaison avec les tables SD_REQUEST et AM_ACTION et EXP pour la liaison avec les autres tables.
• Il est recommandé de ne pas modifier les filtres et vues fournis dans les 2 fichiers.
• Vous pouvez renommer les fichiers.

         Téléchargez  EXP tables SD_REQUEST et AM_ACTION

         Téléchargez  EXP autres tables

Exemple d'utilisation de la fonctionnalité

• Ajoutez un datasource Easyvista.
• Si les 2 EXP ont été intégrés, la liste déroulante Query contient 2 requêtes parent APPS - download document liées à l'option de menu Operation > Reports > Reports.
           

• Sélectionnez la requête relative aux documents de la table SD_REQUEST.
• Sélectionnez le filtre à appliquer à la requête. Note : Les 3 filtres correspondent aux filtres disponibles dans  :
  • My Attachments : Afficher uniquement les documents personnels de l'utilisateur connecté 
  • Public : Afficher uniquement les documents publics
             

• Via une relation maître-détail, reliez le datasource au datasource principal (sur SD_REQUEST) pour les incidents.
           

• Ajoutez un widget Data Viewer en mode Grille pour afficher la liste des documents disponibles.
           

• Passez en mode Exécution. Depuis la liste des documents :
  • Un clic sur le libellé d'un document permet de le télécharger.
  • La colonne Public permet de distinguer les documents publics et les documents personnels.
  • Un clic sur  permet de supprimer un document. Note : Pour ne pas afficher cette fonctionnalité, enlevez la colonne Delete via le Data Transformer.

Sélection du service sur les éléments de menu New Request

Sur un widget Menu ayant une entrée de type New Request, la sélection du sujet du catalogue des services est maintenant basée directement sur le catalogue et non plus sur la table table_path.

Cela permet de rendre immédiatement accessible tout nouveau service rajouté dans , à la différence de la table table_path généralement réactualisée qu'une seule fois par jour.

Gestion des variables et contraintes dans les questionnaires

Les questionnaires prennent maintenant en charge les nouvelles fonctions ajoutées dans la dernière version  : les variables dynamiques et les contraintes.

Les contraintes apparaissent différemment par rapport à  : lorsqu'une contrainte n’est pas respectée, le libellé de l’erreur est affiché en rouge au-dessous du champ.

Nouvelles propriétés sur le datasource Easyvista

Le datasource Easyvista intègre maintenant une section Search contenant 2 nouvelles propriétés permettant de filtrer le résultat sur un champ donné (Search Field) et pour une valeur donnée (Search Value).

Note : Ces propriétés sont indispensables pour l’utilisation de la nouvelle fonctionnalité de paramétrage de l’URL (par exemple pour accéder directement à une fiche précise).

Évolutions de la partie REST

Les interfaces REST clientes ont fortement été modifiées afin de les rendre plus simples et plus homogènes. 

Principe général de création de datasources REST

Note : Dans cette nouvelle version , les fonctionnalités REST ont évolué. Cependant, les applications utilisant les fonctionnalités des versions précédentes continuent de fonctionner.

• La création peut s'effectuer à partir de 2 modèles de datasources REST disponibles dans la catégorie Online :
  • REST : type de datasource déjà existant, permettant de créer des sources de données de façon directe et utilisé pour des créations rapides d'applications ;
  • REST (Connector) : nouveau type de datasource, permettant de créer des sources de données basées sur un connecteur prédéfini, de profiter de ressources déjà paramétrées et d'utiliser l'authentification OAuth.

• Trois types d’authentification REST sont maintenant disponibles, qui conduisent à trois types de datasources avec des paramétrages correspondants. Le tableau ci-dessous résume les différentes possibilités accessibles en fonction du type de connecteur choisi.

Type de datasource		Type d'authentification
		None	Basic	OAuth
REST	Création d'un datasource
	Ressources	1	1
	Sélecteur	1	1
REST (Connector)	Création d'un datasource
	Ressources	n	n	n
	Sélecteur	1 par ressource	1 par ressource	1 par ressource

• Le schéma ci-dessous résume l’héritage entre services, connecteurs et datasources REST.

Évolutions des interfaces de paramétrage

Les interfaces de paramétrage ont été homogénéisées et simplifiées. Les fonctions sont aussi disponibles de façon transverse (en particulier la gestion de ressources qui a été étendue aux APIs REST sans authentification ou avec une authentification Basic).

Mise en place de sources de données REST via les connecteurs

Les interfaces REST sont maintenant totalement supportées par le système des connecteurs, ce qui permet d'utiliser les alias et les contextes d’exécution. Cela vous permet, par exemple, de développer des applications REST sur des comptes de développement avant de les passer sur des comptes de production, sans nécessité de changer quoi que ce soit aux applications.

• Ouvrez la boîte de paramétrage des connecteurs via .

• Sélectionnez le type de connecteur REST.
           

• Sélectionnez le type d'authentification souhaité.
           

Fonctions communes aux différents types d'authentification

1. Choix du service :

• Via la liste URL, vous accédez à une liste de services pré-enregistrés.
           
           

• Si vous accédez à une API REST sans authentification ou avec une authentification Basic et que le service n’existe pas, vous pouvez le définir pour le réutiliser plus rapidement par la suite.
           
  • Cliquez sur .
             
  • Spécifiez le nom du service, l’URL de base et l'icône permettant de l'identifier rapidement.

• Pour modifier ou supprimer un service existant, cliquez dessus pour afficher le menu contextuel. Note : Les services fournis en standard ne sont ni modifiables ni supprimables.
           

2. Gestion des ressources : Celle-ci a été étendue pour intégrer la notion de sélecteur par défaut pour une ressource donnée.

• Via la liste Default Resource, sélectionnez la ressource souhaitée.
           

• Cliquez sur  en regard du champ pour accéder au module de gestion des ressources : la liste des ressources existantes est affichée.
           

• Cliquez sur une ressource pour modifier les propriétés. Note : Le nom complet de l’URL, ressources comprises figure en clair sous le champ URI.
           

3. Gestion du sélecteur : Un sélecteur par défaut peut être défini au niveau de chaque ressource. Note : Cette pratique est vivement recommandée. 

• Cliquez sur  en regard du champ Default Property OK. Vous accédez à la boîte de dialogue de choix du sélecteur.
           

4. Gestion des variables dans l’URL : L’URL du service doit parfois être personnalisée afin d’y faire figurer des informations comme l’account ou l’API_KEY.
     

• La personnalisation s’effectue via des tags dédiés ajoutés dans l'URL :
  • soit sous la forme {nom_du_tag} dans la partie principale de l’URL ;
  • soit via des paramètres introduits par ? ou &. 

• Le système réorganise automatiquement l’URL afin qu’elle soit en permanence valide (les paramètres étant toujours situés en fin d’URL).

• Chaque tag est transformé en zone de saisie dans la boîte de dialogue, à renseigner lors de la création du connecteur. 

• Il est aussi possible de rajouter des tags sur la partie Ressource.
           

• L’URL obtenue pouvant vite devenir complexe, vous pouvez la prévisualiser via > situé à droite de la zone Preview.
             https://xxxxxx.easyvista.eu/api/v1/80000/requests?max_rows=100
           

Connecteur REST sans authentification

Dans la boîte de paramétrage, tapez l’URL du service ainsi que les éventuelles ressources.

Connecteur REST avec une authentification Basic

Lorsque des informations de connexion sont enregistrées, tout datasource basé sur le connecteur hérite des informations.

 Notes : 

• Les informations peuvent être surchargées. 
• Pour ne pas les récupérer dans le datasource, vous devez les effacer.

Connecteur REST avec une authentification OAuth

L’authentification est déléguée au service choisi. 

Cliquez sur  en regard du champ Authentication parameter pour renseigner les informations correspondantes dans l’application hôte.

Création des datasources basés sur un connecteur REST

• Sélectionnez le connecteur souhaité.
           
• Vous accédez à l'inspecteur de propriétés.
           
  • Les champs indiqués avec  peuvent être directement renseignés après avoir choisi le connecteur (pour autant qu’ils aient été renseignés à ce niveau).
  • Le champ Additionnal Query String permet de saisir des paramètres supplémentaires (&) non disponibles via le connecteur.

Création directe de sources de données REST

Sans authentification

Le fonctionnement reste inchangé : il suffit de saisir l’URI et de positionner le sélecteur correct pour accéder aux données.
         

Avec une authentification Basic

Liste des nouveaux connecteurs REST fournis en standard

Avec une authentification Basic

Avec une authentification OAuth

Évolutions sur les widgets

Widget YouTube

Ce widget dispose maintenant d’une propriété Loop permettant une lecture en boucle de la vidéo (la vidéo est relancée automatiquement à la fin de chaque visionnage).

Accès aux données des datasources via JavaScript

Liste des fonctions ajoutées

2 fonctions ont été ajoutées permettant l’accès public aux informations des widgets.

Si le widget est de type datasource, 2 autres fonctions s’ajoutent à l’objet JSON Widget obtenu :

Exemple d’utilisation

Comment afficher dans un widget HTML un graphe à bulles

• Récupérez les données au format JSON disponible sur le site d3js.org : copiez le contenu et collez-le dans un fichier texte nommé flare.json.
           

• Allez sur votre application , ajoutez un datasource JSON et téléchargez le fichier flare.json.

Renommez le datasource pour l'identifier facilement.    flare

• Ajoutez un widget Html Script, ouvrez l'éditeur HTML, passez en mode source via l'icône ) et insérez le script disponible sur le site d3js.org.

Voir le script du site d3js.org

• Supprimez les lignes ci-dessous.

• Ajoutez en haut du script les lignes ci-dessous. Notes :
  • window.parent permet d'accéder à la fonction.
  • Indiquez le nom du datasource dans l'instruction getWidgetsByName, entre des caractères ' '.
              getWidgetsByName('flare')

Voir le script complet corrigé

• Passez en mode Exécution pour afficher le diagramme à bulles.
           

Widget Search Filter

Le widget Search Filter permet maintenant la recherche multi-colonnes, via 5 champs de recherche combinés par l'opérateur OU.

Note : Le widget reste totalement compatible avec les versions précédentes possédant un seul champ de recherche.

Modifications diverses

Lancement direct d’applications dans la galerie

Si l’utilisateur a accès en mode Exécution à une seule application dans la galerie, cette application est lancée directement sans affichage de la galerie.

Gestion de la touche <Retour arrière> sur mobile

Lorsqu’une application est utilisée sur les navigateurs de mobiles (Chrome sous Android, Safari sous iOS, Internet Explorer sous Windows Phone), la touche <Retour arrière> permet de revenir à la page précédente. Auparavant, elle provoquait la sortie de l’application.