Custom widget "Update Incident Wizard"


Apps - Custom widget - Update incident wizard icon.png Ce type de widget appartient à la catégorie Custom Widgets > Operation de la bibliothèque des widgets. Il permet d'effectuer la mise à jour de la description d'un incident au travers d'un formulaire.

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é.
  • La nouvelle description est ajoutée à la fin de la description existante de l’incident, afin de conserver un historique.
  • Une action de type Mise à jour par l’utilisateur est automatiquement générée.
  • L'historique des mouvements est mis à jour.

Exemple

 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 update.png
  • Clic sur le bouton [ MISE À JOUR DESCRIPTION ] : la boîte de dialogue de l'assistant de mise à jour est ouverte
             Incident - Update Description.png
  • Saisie de la nouvelle description et clic sur [ SEND ] : l'assistant effectue la mise à jour de la description ; la fiche de l'incident est réactualisée
             Incident - List after update.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 [ SEND ] et [ CANCEL ] permettant la validation ou l'annulation de la saisie ;
    • 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, Send Button et Update details 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 saisie

  • 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 de mise à jour de l'incident.
  • Text (Note : Non modifiable) : Nom du widget Update details.
     

widget Send Button : Bouton de validation de la saisie

  • Label : Libellé du bouton. 
  • Scripts : Nom du script qui est exécuté lorsque le bouton est activé. L'option Update Incident présélectionnée permet d'effectuer la mise à jour 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 Update details.
     

widget Update details : Zone de saisie de la nouvelle description

  • 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 mise à jour 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 mise à jour de la description 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 - Update incident wizard icon.png Update Incident Wizard (catégorie Custom Widgets > Operation) ;
  • affichez le widget Send 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 Send 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 :
             Create button - Advanced Tags.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 mise à jour de celui-ci ainsi que de la création d'une action de type Mise à jour par l’utilisateur.
Tags:
Modifié par Utilisateur inconnu le 2017/09/08 11:38
Créé par Administrator XWiki le 2017/01/03 11:35

Raccourcis

L'actualité mensuelle
•  Newsletter

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

Glossaire

Powered by XWiki ©, EasyVista 2020