(Update with the copy of version: 9.0DRAFT)
m (1 révision importée)
Ligne 1 : Ligne 1 :
=Modifier les rapports standard (modèles)=
+
=Manage Report Templates=
{{#anc:Change the standard reports (templates)}}
 
 
<onlyinclude>
 
<onlyinclude>
Vous pouvez créer et utiliser des modèles pour simplifier la création de widgets Les utilisateurs disposant des privilèges appropriés peuvent créer ou modifier les modèles. Vous pouvez ainsi créer des widgets différents à l’aide de votre modèle de rapport.
+
You can create and use templates to simplify widget creationAny users with the appropriate privileges can create or modify the templates. You can then create various widgets using your report template.
  
 
__TOC__
 
__TOC__
  
 
{{CloudStep_Stack
 
{{CloudStep_Stack
|title=Gérer des modèles de rapport standard
+
|title=Settings
|text=Pour gérer les modèles de widgets partagés, sélectionnez '''Paramètres'''.
+
|text=To manage shared widget templates, select '''Manage'''.
  
Pour créer un modèle, le plus simple consiste à cloner et modifier un modèle de widget existant dans Genesys Pulse. Genesys Pulse fournit un ensemble de base de modèles prédéfinis complétés par des statistiques qui sont typiques des activités de génération de rapports traitées par les solutions Genesys. Les utilisateurs disposant des privilèges appropriés peuvent créer ou modifier des modèles disponibles.  
+
The easiest way to create a template is to clone and edit an existing widget template within Genesys Pulse. Genesys Pulse provides a basic set of predefined templates, complete with statistics that are typical for reporting activities handled by Genesys solutions. Any users with the appropriate privileges can create or modify the available templates.  
  
Pour créer un modèle de widget, vous devez ajouter ou configurer :
+
To create a widget template, you must add or configure:
* Au moins un type d'objet.  
+
* One or more object types.  
* Au moins une statistique.  
+
* One or more statistics (at least one non-string statistic).  
* Un type de widget avec des options spécifiques pour afficher les informations.
+
* One widget type with specific options to display the information.
  
{{NoteFormat|Vous pouvez masquer ou afficher les statistiques et options d’affichage lorsque vous créez ou modifiez les widgets.
+
You can hide or unhide the statistics and display options when you create or edit widgets.
 +
{{NoteFormat|You can clone the <tt>Text Widget</tt> template to create your own presets for further use.|2}}
 +
{{NoteFormat|You can edit only user-created templates, unless the '''editable_templates''' option in the '''[pulse]''' section of the Genesys Pulse Application object is set to <tt>true</tt>. Genesys Pulse overwrites any changes made to predefined templates with the original predefined templates every time Genesys Pulse starts, unless you set the '''[pulse]'''/'''install_templates''' option to <tt>false</tt>.}}
  
Vous pouvez modifier uniquement les modèles créés par l'utilisateur. Pulse remplace les modifications apportées aux modèles prédéfinis par les modèles prédéfinis originaux chaque fois que vous démarrez Pulse, à moins que vous n'ayez configuré l’option <tt>install_templates</tt> dans la section <tt>[pulse]</tt> de l'objet d’application GAX sur <tt>faux</tt>.}}
+
|media1=Pulse9.0WidgetTemplate.png
 
 
|media1=Pulse_RTR_85105_ManageDashboard.png
 
 
}}
 
}}
  
 
{{CloudStep_Stack
 
{{CloudStep_Stack
|title=Masquer les modèles aux autres utilisateurs
+
|title=Hide templates from other users
|text=Lorsque vous créez vos modèles de widgets, vous pouvez choisir d’empêcher les autres utilisateurs de les voir et de les utiliser.
+
|text=When you create your widget templates you can choose to prevent others from seeing and using your templates.
  
{{NoteFormat|Pour éviter que d’autres personnes utilisent vos modèles de widgets, vous devez disposer des autorisations GAX : Accès Configmanager, Lire des scripts, et Créer/Contrôler complètement des scripts.}}
+
{{NoteFormat|To prevent other users from using your widget templates, you must have the GAX permissions: Access Configmanager; Read Scripts; and Create/Full Control of Scripts.}}
  
Lorsque vous enregistrez vos modèles, choisissez l'option '''Enregistrer vers Configuration Server Genesys'''.   
+
When you save your  templates, choose the option '''Save to Genesys Configuration Server'''.   
  
Ensuite, à partir de la gestion des modèles, cliquez sur '''Lien vers le Gestionnaire de configuration''' à droite, sous '''Groupes d'accès'''.  
+
Then, from the template management, click '''Link to Configuration Manager''' on the right under '''Access Groups'''.  
  
D’ici, vous pouvez définir les autorisations des utilisateurs sur vos modèles.
+
From here, you can define what permissions people have for your templates.
  
|media1=Pulse_85105_HideTemplate.png
+
|media1=Pulse9.0HideTemplate.png
 
}}
 
}}
  
 
{{CloudStep_Stack
 
{{CloudStep_Stack
|title=Sélectionner des statistiques
+
|title=Select statistics
|text=Dans la définition des statistiques Pulse, vous pouvez spécifier les paramètres de statistiques de votre choix, qu'ils soient disponibles ou non sur un Stat Server dans votre environnement. Cela implique que vous devez également mettre à jour les options Stat Server pour que le Stat Server connecté à Pulse contienne les options correspondantes (les types de statistiques et les filtres, par exemple). Vous pouvez afficher ou masquer les statistiques selon vos besoins.  
+
|text=Within the Genesys Pulse statistic definition, you can specify statistic parameters regardless of whether they are available on any Stat Server in your environment. This means you must also update the Stat Server options to ensure that the Stat Server connected to Genesys Pulse contains the corresponding options (for example, statistic types and filters). You can show or hide statistics as needed.  
  
Vous devez ajouter au moins une statistique non-chaîne.
+
You must add at least one non-string statistic.
  
Choisissez les statistiques et les [[RTRStatProperties|propriétés]] à inclure dans votre modèle. Voir la section dédiée aux [[RTRTemplatesA|modèles de rapport et détails des statistiques]].
+
Choose the statistics and [[RTRStatProperties|properties]] to include in your template. See [[RTRTemplatesA|report templates and statistics details]].
  
Pour que Pulse affiche les détails d’une statistique, sélectionnez-en une. Ces informations incluent les composants de la définition du StatType ainsi que d'autres paramètres qui constituent la demande qu'envoie Pulse à Stat Server. Vous pouvez modifier la définition d'une statistique dans Pulse lors de la création, du clonage ou de la modification d'un modèle.  
+
Genesys Pulse displays statistic details when you select a statistic. This information includes the components of the StatType definition and other parameters that form the request that Genesys Pulse sends to Stat Server. You can modify a statistic definition within Genesys Pulse when you create, clone, or edit a template.  
  
 
|media1=Pulse_85105_PredefStat.png
 
|media1=Pulse_85105_PredefStat.png
Ligne 53 : Ligne 52 :
  
 
{{CloudStep_Stack
 
{{CloudStep_Stack
|title=Groupe de statistiques par colonnes
+
|title=Statistics Group by Columns
|text=Tout d’abord, le StatType avec '''GroupBy''' et '''GroupByColumns''' doivent être définis dans les options de Stat Server.
+
|text=First, the StatType with '''GroupBy''' and '''GroupByColumns''' must be defined in Stat Server Options.
  
Une fois que les statistiques sont définies, vous pouvez créer un modèle avec cette statistique, en utilisant le champ '''Grouper par colonnes'''. Consultez la section '''GroupBy''' sur la [[RTRStatProperties|page Propriétés statistiques]].
+
Once the statistics are defined, you can create a template with that statistic using the '''Group by Columns''' field. See '''GroupBy''' on the [[RTRStatProperties|Statistic Properties page]].
  
Vous pouvez ainsi créer des widgets différents à l'aide de ce nouveau modèle.
+
You can then create widgets using this new template.
  
 
|media1=Pulse_85105_StatGroupBy.png
 
|media1=Pulse_85105_StatGroupBy.png
Ligne 64 : Ligne 63 :
  
 
{{CloudStep_Stack
 
{{CloudStep_Stack
|title=Options d'affichage
+
|title=Select Collectors
|text=Définissez les options d'affichage de votre widget de rapport pour valider votre modèle. Ces options permettent de définir ce que les utilisateurs voient, mais ils peuvent modifier ces options à partir de leurs propres tableaux de bord.
+
|text=Starting with release 8.5.108, Genesys Pulse allows users to assign specific Genesys Pulse Collectors to handle all widgets based on this template. To enable this functionality, you need to set the '''enable_manual_collector_binding''' option to <tt>true</tt> in the '''[pulse]''' section of the Genesys Pulse Application object and assign the role with the <tt>Pulse Manually Bind Collectors</tt> privilege to selected users.
  
<ul><li>Nommer le widget de rapport et lui donner un titre</li>
+
On the screenshot you can see Site 1 and Site 2 as it is a multisite configuration. For a singlesite configuration there will be only one site.
<li>Sélectionnez le [[RTRWidgetTypes|type de widget]] à afficher.</li><li>Sélectionnez des options disponibles supplémentaires.</li>
+
 
<p>
+
|media1=Pulse_85108_TemplateSelectCollectors.png
'''Remarque :''' la valeur maximale des graphiques à barres dans les widgets Liste et KPI correspond à la valeur maximale de tous les objets sélectionnés pour la statistique de ce widget ou à la valeur maximale de l'alerte configurée pour ce widget.</p>
 
<li>Sélectionnez les options associées à la visualisation (les seuils et la taille, par exemple).</li>
 
  <li>Facultatif : pour les modèles configurés pour utiliser des statistiques basées sur les modifications (CurrentStatus et ExtendedCurrentStatus), vous devez '''activer les mises à jour rapides'''. Consultez la section [https://docs.genesys.com/Documentation/EZP/{{ponydocsversion}}/Deploy/RabbitMQ Déploiement de RabbitMQ pour la mise à jour rapide des widgets].</li>
 
</ul>{{NoteFormat|Confirmez que votre environnement peut gérer le nombre de widgets et la fréquence d'actualisation que vous prévoyez d'utiliser. Plus la fréquence d'actualisation est courte, plus les exigences en matière de processeur, de mémoire, de disque et de réseau sont importantes.}}
 
|media1=Pulse_85105_DisplayOptions.png
 
 
}}
 
}}
  
 
{{CloudStep_Stack
 
{{CloudStep_Stack
|title=Alertes
+
|title=Display options
|text=Depuis la version 9.0.000, les alertes peuvent être utilisées pour spécifier des seuils (rouge, orange et vert) pour chaque statistique numérique (format heure, nombre entier, pourcentage ou numéro) dans la section '''Alertes pour la statistique'''. Des valeurs décimales peuvent être spécifiées en tant que valeurs de seuil pour des nombres/statistiques en pourcentage, et des valeurs entières pour d’autres statistiques.
+
|text=Define the display options of your report widget to validate your template. This is what users see, but they can then [[RTRUserAccess#scrollNav-5|change the options on their own dashboard]] while they [[RTRWidgets|create]] or edit widgets.
 +
* Name the report widget and provide title.
 +
* Select the [[RTRWidgetTypes|Widget Type]] to display.
 +
* Select additional available options. <br> '''Note:''' The maximum value for the bar charts in List and KPI widgets is the maximum value of all the objects selected for the statistic in this widget or the maximum value of the alert configured for this widget.
 +
* Select options associated with the visualization (for example, size).
 +
* Optional: For templates configured to use changes-based statistics (CurrentStatus and  ExtendedCurrentStatus), set '''enable quick updates'''. See [https://docs.genesys.com/Documentation/EZP/{{ponydocsversion}}/Deploy/RabbitMQ Deploying RabbitMQ for Quick Widget Updates].
 +
 
 +
{{NoteFormat|Confirm your environment can handle the number of widgets and refresh rate you plan to use. A shorter refresh rate increases demands on the CPU, memory, disk, and network.}}
  
{{NoteFormat|Seules des statistiques numériques non basées sur une formule avec le mode de notification <tt>Basé sur le temps</tt> ou <tt>Basé sur la réinitialisation</tt> sont disponibles dans la section '''Alertes avancées'''.|3}}
+
{{NoteFormat|The Line widget type is not available in the Template Wizard. You can choose this type when you create a widget with individually (not By Group) selected objects.|2}}
  
La section <tt>Alertes avancées</tt> présente les deux modes suivants :
+
|media1=Pulse_9.0_DisplayOptions.png
* '''Générateur'''.  Simplifie les conditions de base de la génération.
 
* '''Avancé'''. Permet de générer une condition complexe en attribuant la valeur booléenne, numérique ou chaîne à la variable <tt>Résultat</tt> en utilisant des expressions JavaScript valides. Spécifiez la condition complexe dans la section <tt>Alertes avancées</tt> quand vous devez utiliser plusieurs statistiques ou envoyer des notifications par e-mail.
 
La section <tt>Alertes avancées</tt> peut ne pas être disponible dans certaines configurations de Genesys Pulse. Consultez la section [https://docs.genesys.com/Documentation/EZP/{{ponydocsversion}}/Deploy/Microservices Microservices] pour en savoir plus.
 
|media1=Pulse_900_TemplateAlertsTab.png
 
 
}}
 
}}
  
 
{{CloudStep_Stack
 
{{CloudStep_Stack
|title=Propager des modifications apportées au modèle
+
|title=Alerts
|text=Lorsque vous avez terminé vos modifications et que vous cliquez sur '''Sauvegarder''', Pulse affiche une liste de tous les widgets utilisateur qui utilisent le modèle. Pulse répertorie les titres et les propriétaires des widgets.  
+
|text=Starting with release 9.0.000, Alerts can be used to specify thresholds (red, orange, and green) for each numerical statistic (Time, Integer, Percentage, or Number format) in the '''Alerts for Statistic'''. Decimal values can be specified as threshold values for Number/Percentage statistics, and integer values for other statistics.
*Sélectionnez les widgets qui doivent être mis à jour.
+
 
*Si nécessaire, Pulse propose une case à cocher '''Remplacer les options d'affichage pour le(s) widget(s) sélectionné(s) ci-dessus'''.  
+
{{NoteFormat|Only numerical non-formula-based statistics (Time, Integer, Percentage, or Number format) with the <tt>Time-Based</tt> or <tt>Reset-Based</tt> notification mode are available in the '''Advanced Alerts'''.|3}}
** Si vous cochez cette case, Pulse met à jour le type, le titre et toutes les autres options d’affichage des widgets (à l’exception de la fréquence d’actualisation), ainsi que les définitions de statistiques et les types d’objets autorisés.  
+
 
**Si vous ne la cochez pas, Pulse met à jour uniquement les définitions de statistiques et les types d’objets autorisés.
+
Specify the complex condition in the <tt>Advanced Alerts</tt> section when you need to use more than one statistic or send email notifications. The <tt>Advanced Alerts</tt> section has the following two modes:
|media1=Pulse_85105_proptempch.png
+
* '''Builder'''.  Simplifies building basic conditions.
 +
* '''Advanced'''. Allows to build complex condition by assigning the boolean, number or string value to the <tt>Result</tt> variable using any valid JavaScript expressions.  
 +
The <tt>Advanced Alerts</tt> section might not be available in certain Genesys Pulse configurations. See [https://docs.genesys.com/Documentation/EZP/{{ponydocsversion}}/Deploy/Microservices Microservices] for more information.  
 +
|media1=Pulse_900_TemplateAlertsTab.png
 
}}
 
}}
  
 
{{CloudStep_Stack
 
{{CloudStep_Stack
|title=Sélectionner des collecteurs
+
|title=Propagate template changes
|text=Depuis la version 8.5.108, Genesys Pulse permet à des utilisateurs d’affecter des collecteurs Pulse spécifiques pour gérer tous les widgets basés sur ce modèle. Pour activer cette fonctionnalité, vous devez définir l’option '''enable_manual_collector_binding''' sur <tt>true</tt> dans la configuration de GAX et attribuer le rôle avec le privilège <tt>Lier manuellement des collecteurs Pulse</tt> pour les utilisateurs sélectionnés.
+
|text=When editing is finished and you click '''Save''', Genesys Pulse displays a list of all user widgets that use the template. Genesys Pulse lists the titles and owners of the widgets.  
 
+
*Select which widgets should be updated.
Sur la capture d’écran, vous pouvez voir Site 1 et Site 2 dans le contexte d’une configuration multisite. Pour une configuration site unique, il n’y a qu’un seul site.
+
*If needed, Genesys Pulse provides the <tt>Overwrite Display Options and Alerts for selected widgets</tt> checkbox.
 
+
** If you select the checkbox, Genesys Pulse updates the widget type, headline, all other display options in the widgets (except refresh rate) and configuration of Alerts for statistics, as well as the statistic definitions and allowed object types.
|media1=Pulse_85108_TemplateSelectCollectors.png
+
**If you do not select the checkbox, Genesys Pulse updates only the statistic definitions and allowed object types.
 +
{{NoteFormat|Changes in Advanced Alerts are not propagated.}}
 +
|media1=Pulse9.0PropagateTemplateChanges.png
 
}}
 
}}
  
{{#anc:What do I do next?}}
+
==What do I do next?==
==Que faire ensuite ?==
+
You might want to learn more about:
Vous pouvez en savoir plus à propos des fonctions suivantes :
+
* [[RTRWidgetTypes|Widget Types]]
* [[RTRWidgetTypes|Types de widgets]]
+
* [[RTRReports|Popular real-time reports]]
* [[RTRReports|Rapports populaires en temps réel]]
+
* [[RTRWidgetExternal|Displaying external content using an IFRAME widget]]
* [[RTRWidgetExternal|Affichage du contenu externe à l’aide d’un widget IFRAME]]
+
*[[RTRStatProperties|Statistic properties]]
*[[RTRStatProperties|Propriétés statistiques]]
+
*[[RTRFormulas|Report formulas]]
*[[RTRFormulas|Formules de rapport]]
+
*[[RTRFunctions|Template function library]]
*[[RTRFunctions|Bibliothèque de fonctions de modèles]]
 
  
  

Version du février 12, 2020 à 00:44

Manage Report Templates

You can create and use templates to simplify widget creation? Any users with the appropriate privileges can create or modify the templates. You can then create various widgets using your report template.

Settings

1

To manage shared widget templates, select Manage.

The easiest way to create a template is to clone and edit an existing widget template within Genesys Pulse. Genesys Pulse provides a basic set of predefined templates, complete with statistics that are typical for reporting activities handled by Genesys solutions. Any users with the appropriate privileges can create or modify the available templates.

To create a widget template, you must add or configure:

  • One or more object types.
  • One or more statistics (at least one non-string statistic).
  • One widget type with specific options to display the information.

You can hide or unhide the statistics and display options when you create or edit widgets.

Conseil
You can clone the Text Widget template to create your own presets for further use.
Important
You can edit only user-created templates, unless the editable_templates option in the [pulse] section of the Genesys Pulse Application object is set to true. Genesys Pulse overwrites any changes made to predefined templates with the original predefined templates every time Genesys Pulse starts, unless you set the [pulse]/install_templates option to false.

Hide templates from other users

1

When you create your widget templates you can choose to prevent others from seeing and using your templates.

Important
To prevent other users from using your widget templates, you must have the GAX permissions: Access Configmanager; Read Scripts; and Create/Full Control of Scripts.

When you save your templates, choose the option Save to Genesys Configuration Server.

Then, from the template management, click Link to Configuration Manager on the right under Access Groups.

From here, you can define what permissions people have for your templates.

Select statistics

1

Within the Genesys Pulse statistic definition, you can specify statistic parameters regardless of whether they are available on any Stat Server in your environment. This means you must also update the Stat Server options to ensure that the Stat Server connected to Genesys Pulse contains the corresponding options (for example, statistic types and filters). You can show or hide statistics as needed.

You must add at least one non-string statistic.

Choose the statistics and properties to include in your template. See report templates and statistics details.

Genesys Pulse displays statistic details when you select a statistic. This information includes the components of the StatType definition and other parameters that form the request that Genesys Pulse sends to Stat Server. You can modify a statistic definition within Genesys Pulse when you create, clone, or edit a template.

Statistics Group by Columns

1

First, the StatType with GroupBy and GroupByColumns must be defined in Stat Server Options.

Once the statistics are defined, you can create a template with that statistic using the Group by Columns field. See GroupBy on the Statistic Properties page.

You can then create widgets using this new template.

Select Collectors

1

Starting with release 8.5.108, Genesys Pulse allows users to assign specific Genesys Pulse Collectors to handle all widgets based on this template. To enable this functionality, you need to set the enable_manual_collector_binding option to true in the [pulse] section of the Genesys Pulse Application object and assign the role with the Pulse Manually Bind Collectors privilege to selected users.

On the screenshot you can see Site 1 and Site 2 as it is a multisite configuration. For a singlesite configuration there will be only one site.

Display options

1

Define the display options of your report widget to validate your template. This is what users see, but they can then change the options on their own dashboard while they create or edit widgets.

  • Name the report widget and provide title.
  • Select the Widget Type to display.
  • Select additional available options.
    Note: The maximum value for the bar charts in List and KPI widgets is the maximum value of all the objects selected for the statistic in this widget or the maximum value of the alert configured for this widget.
  • Select options associated with the visualization (for example, size).
  • Optional: For templates configured to use changes-based statistics (CurrentStatus and ExtendedCurrentStatus), set enable quick updates. See Deploying RabbitMQ for Quick Widget Updates.
Important
Confirm your environment can handle the number of widgets and refresh rate you plan to use. A shorter refresh rate increases demands on the CPU, memory, disk, and network.
Conseil
The Line widget type is not available in the Template Wizard. You can choose this type when you create a widget with individually (not By Group) selected objects.

Alerts

1

Starting with release 9.0.000, Alerts can be used to specify thresholds (red, orange, and green) for each numerical statistic (Time, Integer, Percentage, or Number format) in the Alerts for Statistic. Decimal values can be specified as threshold values for Number/Percentage statistics, and integer values for other statistics.

Avertissement
Only numerical non-formula-based statistics (Time, Integer, Percentage, or Number format) with the Time-Based or Reset-Based notification mode are available in the Advanced Alerts.

Specify the complex condition in the Advanced Alerts section when you need to use more than one statistic or send email notifications. The Advanced Alerts section has the following two modes:

  • Builder. Simplifies building basic conditions.
  • Advanced. Allows to build complex condition by assigning the boolean, number or string value to the Result variable using any valid JavaScript expressions.

The Advanced Alerts section might not be available in certain Genesys Pulse configurations. See Microservices for more information.

Propagate template changes

1

When editing is finished and you click Save, Genesys Pulse displays a list of all user widgets that use the template. Genesys Pulse lists the titles and owners of the widgets.

  • Select which widgets should be updated.
  • If needed, Genesys Pulse provides the Overwrite Display Options and Alerts for selected widgets checkbox.
    • If you select the checkbox, Genesys Pulse updates the widget type, headline, all other display options in the widgets (except refresh rate) and configuration of Alerts for statistics, as well as the statistic definitions and allowed object types.
    • If you do not select the checkbox, Genesys Pulse updates only the statistic definitions and allowed object types.
Important
Changes in Advanced Alerts are not propagated.

What do I do next?

You might want to learn more about:

Comments or questions about this documentation? Contact us for support!