Custom widget "Close Incident Wizard"


Apps - Custom widget - Close incident wizard icon.png Ce type de widget appartient à la catégorie Custom Widgets > Operation de la bibliothèque des widgets. Il permet de clôturer prématurément l'incident courant.

Le fonctionnement de l’assistant est identique à celui d'Product name - ev itsm.png :

  • Si l’incident sélectionné est clôturé, un message d’erreur est affiché.
  • L'incident est automatiquement clôturé.
    • Le workflow est stoppé. Il enchaîne sur un éventuel workflow de clôture défini pour le sujet de l'incident.
    • Une action Clôture anticipée est automatiquement générée.
    • L'incident prend un méta-statut Clôturé, indiquant une clôture anticipée du traitement.
    • L'incident disparaît de la liste des incidents ouverts.
  • Si des actions en cours ont été clôturées :
    • dans l'historique des actions, la mention Fin anticipée est affichée en regard de chacune d'entre elles ;
    • sur la fiche Action, le champ Action à faire prend la valeur Fin anticipée.
  • Tous les incidents liés sont automatiquement clôturés et prennent le statut de l'incident parent ; ils enchaînent sur un éventuel workflow de clôture défini pour leur sujet.

Exemple

Le bénéficiaire s'aperçoit que son problème est dû à une erreur de manipulation de sa part ; il n'est donc pas nécessaire de continuer à traiter l'incident.

 Open url.png  voir Procédure

  • Affichage de la liste des incidents via un widget Data Viewer ; un clic sur un enregistrement affiche le détail via un widget Secured Html
             Incident - List before close.png
  • Clic sur le bouton [ CLÔTURER L'INCIDENT ] : la boîte de dialogue de l'assistant de clôture est ouverte
             Incident - Close Description.png
  • Saisie du motif de la clôture et clic sur [ CLÔTURER ] : l'assistant effectue la clôture de l'incident ; la liste des incidents est réactualisée
             Incident - List after close.png

Remarques

Open url.png  voir Remarques générales sur les widgets

  • L'accès à l'assistant se fait depuis un widget affichant des enregistrements pointant sur la table SD_REQUEST.
    • L'accès peut se faire sous la forme d'un lien hypertexte ou d'un bouton d'action qui ouvre l'assistant sur l'enregistrement courant.
    • Certaines propriétés du lien / bouton ne peuvent pas être modifiées : il faut alors le supprimer puis le recréer.
  • L'assistant ouvre un formulaire prédéfini par Logo - EasyVista.png :
    • il comprend une zone de type Memo pour la saisie de la description et 2 boutons [ CLOSE ] et [ CANCEL ] permettant la validation ou l'annulation de la clôture ;
    • d'autres widgets vides permettent la mise en forme du formulaire, qu'il est possible de modifier ;
    • il est possible d'ajouter de nouveaux widgets.

Attention

  • Pour le bon fonctionnement de l'assistant :
    • Les 3 widgets Cancel_Button, Close_Button et CloseRequest prédéfinis dans le formulaire ne doivent pas être supprimés.
    • Seules certaines propriétés de ces widgets peuvent être modifiées.

Liste des propriétés

Content

widget Cancel_Button : Bouton d'annulation de la clôture

  • Label : Libellé du bouton. 
  • Scripts : Nom du script qui est exécuté lorsque le bouton est activé. L'option Close modal présélectionnée permet de fermer l'assistant sans effectuer la clôture incident.
  • Text (Note : Non modifiable) : Nom du widget CloseRequest.
     

widget Close_Button : Bouton de validation de la clôture

  • Label : Libellé du bouton. 
  • Scripts : Nom du script qui est exécuté lorsque le bouton est activé. L'option Close Incident présélectionnée permet d'effectuer la clôture de l'incident dans Product name - ev itsm.png.
  • Datasource : Nom du datasource EasyVista pointant sur la liste des incidents dans Product name - ev itsm.png. Il s'agit du même datasource que celui sur lequel pointent les widgets utilisés pour l'affichage de la liste et du détail des incidents.
  • Text (Note : Non modifiable) : Nom du widget CloseRequest.
     

widget CloseRequest : Zone de saisie du motif de la clôture

  • Wysiwyg : Non modifiable.
  • Placeholder : Texte affiché dans la zone descriptive, qui est effacé automatiquement dès que l'utilisateur commence sa saisie.
  • Label : Titre de la zone de saisie.

Theme

 Open url.png  voir Description des propriétés

Procédure : Comment implémenter l'assistant de clôture des incidents

Best Practice icon.png  Pour une mise en oeuvre rapide de cette procédure, utilisez le custom widget Operation > All Incidents List - Line & Details (Large & Small). Vous pouvez également utiliser l'application modèle IT Portal qui contient une page dédiée à l'affichage des incidents.

1. Allez sur l'application souhaitée et ajoutez un datasource EasyVista pointant sur une liste d'incidents :

   Example documentation icon FR.png

  • Query : Home > My Incidents
  • Filter : Open
  • View : List with description

2. Créez une page pour afficher la liste des incidents :

  • créez la page : dans le volet Objets, cliquez sur Apps - Manage pages icon.png puis sur Apps - Add icon.png ;
  • ajoutez un widget Data Viewer sur la page créée pour afficher la liste des incidents :
    • faîtes pointer le widget sur le datasource EasyVista ;
    • définissez le format d'affichage du mode Tile.
  • ajoutez un widget Secured Html pour afficher le détail d'un incident :
    • faîtes pointer le widget sur le datasource EasyVista ;
    • cliquez sur Apps - Edit Html icon.png en regard du champ Html Code et définissez le format d'affichage du détail d'un incident.

3. Créez une page dédiée à l'assistant de clôture d'un incident :

  • créez la page : dans le volet Objets, cliquez sur Apps - Manage pages icon.png puis sur Apps - Add icon.png ;
  • renommez la page et décochez la case en regard de son nom pour la rendre invisible dans l'application ;
  • ajoutez un custom widget Apps - Custom widget - Close incident wizard icon.png Close Incident Wizard (catégorie Custom Widgets > Operation) ;
  • affichez le widget Close_Button et sélectionnez le datasource EasyVista sur lequel pointent les widgets affichant la liste et le détail des incidents ;
  • modifiez si nécessaire les libellés des boutons via les propriétés Label des widgets Close_Button et Cancel_Button.

4. Ajoutez l'accès à l'assistant sur le widget Secured Html affichant le détail des incidents - vous pouvez insérer un lien hypertexte ou un bouton d'action :

  • sélectionnez la page affichant la liste des incidents ;
  • affichez le widget Secured Html ;
  • dans l'inspecteur de propriétés, cliquez sur Apps - Edit Html icon.png en regard du champ Html Code ;
  • dans l'éditeur de texte, positionnez le curseur sur la ligne où doit être affiché le lien hypertexte / bouton ;
  • cliquez sur Apps - Text Editor - Advanced tags icon.png pour afficher le panneau Advanced Tags, puis cliquez sur Page > Page Popup :
             Apps - Text Editor - Advanced tags Page - Page popup.png
    • Select page : nom de la page dédiée à l'assistant, créée à l'étape 3.
    • Link title : libellé du lien hypertexte / bouton permettant d'ouvrir l'assistant.
    • Modal title : titre de la boîte de dialogue ouverte par l'assistant.
    • Choose button type : mode d'ouverture de la boîte de dialogue de l'assistant, qui peut être un lien hypertexte (sélectionnez l'option Link en cliquant à la droite du libellé Link) ou un bouton d'action (sélectionnez l'option Button en cliquant à la gauche du libellé Button).
  • cliquez sur Apps - Add icon.png : le lien hypertexte / bouton est automatiquement inséré sur l'éditeur de texte ;
  • dans l'éditeur de texte, vous pouvez ensuite :
    • utiliser les options d'alignement Apps - Text Editor - Align paragraph icon.png pour positionner le nouveau lien / bouton sur la ligne ;
    • modifier certaines caractéristiques du lien / bouton via les options affichées en cliquant dessus. Note : Si vous souhaitez modifier le nom de la page dédiée à l'assistant, le titre de la boîte de dialogue ouverte par l'assistant ou le mode d'ouverture de la boîte de dialogue, vous devez supprimer le lien / bouton et le recréer.
  • cliquez sur [ OK ].

5. Passez en mode Visualisation via EVApps - GUI - Execute icon.png :

  • lancez l'assistant depuis un incident ;
  • allez dans Product name - ev itsm.png pour vérifier la clôture de celui-ci ainsi que de la création d'une action de type Clôture anticipée.
Tags:
Modifié par Utilisateur inconnu le 2017/09/08 11:27
Créé par Administrator XWiki le 2017/05/23 09:06

Raccourcis

L'actualité mensuelle
•  Newsletter

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

Glossaire

Powered by XWiki ©, EasyVista 2020