Les fiches - Les applications contextuelles


Une fiche peut être liée à des applications Service Apps.

  • Les applications sont appelées depuis le bandeau latéral droit de la fiche et s'ouvre dans un panneau superposé.
  • Elles présentent des informations contextuelles à l'enregistrement courant de Service Manager via leurs propriétés exposées liées aux champs de la fiche.

Exemples

  • Application affichant tous les incidents du bénéficiaire de l'incident courant
             Contextual apps - Example - Incident.png
     
  • Application recherchant des informations dans une base de connaissance Self Help à partir du titre du ticket  - Open url.png  voir Cas d'utilisation
             Contextual apps - Example - Self Help.png

Remarques

  • Les informations peuvent provenir de Service Manager et de Self Help.
  • L'affichage d'informations provenant de Self Help nécessite :

Attention

  • Seuls les champs possédant un alias et présents sur la représentation principale de la fiche peuvent être liés à une propriété exposée de Service Apps  - Open url.png voir Procédure

Description de l'écran

         Contextual apps.png

Accès : Browse grey points icon.png dans le bandeau supérieur d'une fiche > Éditer la fiche > Applications contextuelles  - Open url.png voir Procédure

Titre pour la docked bar : Nom de l'application affiché dans le bandeau latéral.

Description pour la docked bar : Description de l'application affichée au survol du titre avec la souris.

Page... : Un clic sur la zone affiche la liste des pages de l'application.

  • Sélectionnez la page à exécuter au lancement de l'application.

Propriétés exposées : Liste des propriétés exposées de l'application utilisées par la fiche. À chaque propriété peut correspondre un champ de la fiche, sélectionné via la liste Value.

  • Les propriétés exposées doivent être définies au préalable au niveau de l'application.

Procédure : Comment lier une application contextuelle à une fiche

    Open url.png  voir Cas d'utilisation : Recherche des informations dans une base de connaissance Self Help à partir du titre d'un ticket, via une application contextuelle

Étape 1 : Ajout d'une nouvelle application contextuelle sur la fiche

1. Allez sur la fiche souhaitée.

2. Cliquez sur Browse grey points icon.png dans le bandeau supérieur, puis sur Éditer la fiche.
La représentation principale / conditionnelle de la fiche est affichée.

3. Cliquez sur Applications contextuelles.
La liste les applications déjà liées aux fiches est affichée.
         Contextual apps - Existing list.png

4. Cliquez sur Add icon.png.
La liste des applications auxquelles vous avez accès est affichée.

5. Cliquez sur l'application à lier à la fiche.

6. Renseignez ses propriétés.

  • Saisissez le nom à afficher dans le bandeau latéral de la fiche.
  • Renseignez la description affichée au survol du titre avec la souris.
  • Sélectionnez la page de l'application à ouvrir à son lancement dans la fiche.


Étape 2 : Correspondance entre les propriétés exposées de Service Apps et les champs de la fiche

1. Cliquez sur Ajouter une propriété exposée.

2. Saisissez le nom de l'alias de la propriété exposée telle qu'il est défini au niveau de l'application.

3. Sélectionnez le champ de la fiche auquel la propriété exposée s'applique, via la liste déroulante Valeur.
Seuls les champs possédant un alias et présents sur la représentation principale sont affichés.

4. Renseignez de la même façon toutes les propriétés exposées à utiliser dans la fiche.
 

Que faire si le champ souhaité n'apparaît pas dans la liste déroulante Valeur ?

a. Vérifiez que le champ possède un alias. Dans le cas contraire :

  • Cliquez sur Multilingual labels icon.png en regard du champ Alias.
  • Renseignez les libellés multilingues du champ.
  • Cliquez sur Appliquer les modifications puis sur Fermer l'inspecteur.
  • Cliquez sur Enregistrer sur l'éditeur de fiche.
  • Vérifiez si le champ apparaît dans la liste déroulante Valeur. Sinon, passez à l'étape b..
     

b. Vérifiez que le champ est présent sur la représentation principale.

    Note : Le nom de la représentation et sa nature (principale / conditionnelle) sont affichés en haut de l'éditeur de fiche.
         Form - Name.png

     Dans le cas contraire :

  • Ajoutez le champ sur la représentation via la poignée de déplacement Grip icon.png.
             Form - Drag and drop field to presentation.png
  • Cliquez sur Enregistrer.
  • Vérifiez si le champ apparaît dans la liste déroulante Valeur. Sinon, passez à l'étape c..
     

Que faire si la fiche s'ouvre sur une représentation conditionnelle ?

Vérifiez que le champ est présent dans la représentation conditionnelle. Dans le cas contraire :

  • Ajoutez le champ sur la représentation conditionnelle via la poignée de déplacement Grip icon.png.
  • Cliquez sur Enregistrer.

Étape 3 : Ajout de l'application contextuelle sur la fiche

1. Cliquez sur Ajouter à la docked bar.

2. Fermez la fenêtre.
Vous revenez sur l'éditeur de fiche.

3. Cliquez sur Enregistrer et Fermer.
L'application est ajoutée dans le bandeau latéral de la fiche.

4. Cliquez sur l'application et contrôlez le bon affichage des informations contextuelles à la fiche.

Cas d'utilisation : Rechercher dans Self Help des informations contextuelles au titre d'un ticket

Dans Service Apps

Étape 1 : Création d'une application contenant un projet Self Help

1. Créez une application  - Open url.png voir Procédure

2. Implémentez un projet Self Help dans l'application.  Open url.png voir Procédure détaillée

         Self Help project implemented in an app.png

Étape 2 : Ajout de la propriété exposée Search Value du datasource

1. Ouvrez la boîte de dialogue Exposed properties via Apps - Application properties icon.png ou EVApps - GUI - Share icon.png, puis cliquez sur Exposed properties.

2. Ajoutez la propriété exposée Search Value du datasource permettant de rechercher une valeur particulière parmi les enregistrements.

  • Cliquez sur Add Properties.
  • Sélectionnez la propriété Search Value du datasource DS Self Help, puis cliquez sur OK.
             Apps - Exposed properties - Example Self Help search - Add properties.png

La propriété exposée du datasource est ajoutée à la liste des propriétés déjà utilisées dans l'application.
         Apps - Exposed properties - Example Self Help search - Property added.png

  • (optionnel) Modifiez la valeur par défaut de l'alias pour donner un nom explicite à la propriété exposée : Search Value in Self Help.
  • Cliquez sur Close.
    Note : Ne renseignez pas la colonne Content/Value : la valeur à rechercher dans le datasource est déterminée dynamiquement dans Service Manager à partir du titre du ticket courant.


Dans Service Manager

Étape 3 : Ajout de l'application contextuelle dans Service Manager

1. Allez sur la fiche Incident.

2. Cliquez sur Tools icon.png dans le bandeau supérieur, puis sur Éditer la fiche.

3. Cliquez sur Applications contextuelles.

4. Ajoutez l'application créée précédemment, via Add icon.png

  • Renseignez le nom de l'application à afficher dans le bandeau latéral de la fiche et sa description affichée au survol du titre avec la souris.
  • Sélectionnez la page de l'application sur laquelle est implémenté le projet Self Help.
     

Étape 4 : Paramétrage de la propriété exposée de l'application

1. Cliquez sur Ajouter une propriété exposée.

2. Saisissez le nom de l'alias que vous avez donné à la propriété exposée dans l'application : Search Value in Self Help.

3. Sélectionnez dans la colonne Value le champ Title de la fiche Incident.
Quelle que soit la fiche Incident, le contenu du titre du ticket courant va être automatiquement recherché dans le projet Self Help de l'application.

4. Cliquez sur Ajouter à la docked bar.

Étape 5 : Test de l'application contextuelle sur la fiche Incident

1. Fermez la fenêtre, puis cliquez sur Enregistrer et Fermer.
L'application est ajoutée dans le bandeau latéral de la fiche Incident.

2. Cliquez sur l'application et contrôlez le bon affichage des informations Self Help contextuelles au titre du ticket.

         Apps - Exposed properties - Example Self Help search.png

Tags:
Modifié par Christine Daussac le 2021/04/02 20:47
Créé par Administrator XWiki le 2021/02/19 18:18

Raccourcis

L'actualité mensuelle
•  Newsletter

Tous les changements
•  Service Manager
•  Service Apps
•  Self Help
•  Service Bots

Powered by XWiki ©, EasyVista 2021