(Update with the copy of version: 8.5.1draft)
m (1 révision importée)
Ligne 1 : Ligne 1 :
=Modifier les rapports standard (modèles)=
+
=Change the standard reports (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=Manage standard report templates
|text=Pour gérer les modèles de widgets partagés, sélectionnez '''Paramètres'''.
+
|text=To manage shared widget templates, select '''Settings'''.
  
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.  
* 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.
+
{{NoteFormat|You can hide or unhide the statistics and display options when you create or edit widgets.
  
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>.}}
+
You can edit only user-created templates. Pulse overwrites any changes made to predefined templates with the original predefined templates every time Pulse starts, unless you set the <tt>install_templates</tt> configuration option in the <tt>[pulse]</tt> section of the GAX Application object to <tt>false</tt>.}}
  
 
|media1=Pulse_RTR_85105_ManageDashboard.png
 
|media1=Pulse_RTR_85105_ManageDashboard.png
Ligne 25 : Ligne 24 :
  
 
{{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=Pulse_85105_HideTemplate.png
Ligne 40 : Ligne 39 :
  
 
{{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 Pulse statistic definition, you can specify statistic parameters regardless of whether they are available on any StatServer in your environment. This means you must also update the StatServer options to ensure that the StatServer connected to 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.  
+
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 Pulse sends to StatServer. You can modify a statistic definition within 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 [[Documentation:EZP:User: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=Display options
|text=La dernière étape de la validation de votre modèle est la définition des options d'affichage de votre widget de rapport. 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=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.
  
<ul><li>Nommer le widget de rapport et lui donner un titre</li>
+
<ul><li>Name the report widget and provide title</li>
<li>Sélectionnez le [[RTRWidgetTypes|type de widget]] à afficher.</li><li>Sélectionnez des options disponibles supplémentaires.</li>
+
<li>Select the [[RTRWidgetTypes|Widget Type]] to display.</li><li>Select additional available options </li>
 
<p>
 
<p>
'''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>
+
'''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.</p>
<li>Sélectionnez les options associées à la visualisation (les seuils et la taille, par exemple).</li>
+
<li>Select options associated with the visualization (for example, thresholds and size).</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 [http://docs.genesys.com/Documentation/EZP/8.5.1/Deploy/Deploy#t-4 Déploiement de RabbitMQ pour la mise à jour rapide des widgets].</li>
+
   <li>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].</li>
  <li>Si besoin, sélectionnez les statistiques pour les alertes et définissez les valeurs d'alerte (de 1 à 3).</li>
+
</ul>{{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.}}
</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
 
|media1=Pulse_85105_DisplayOptions.png
 
}}
 
}}
  
{{#anc:What do I do next?}}
+
{{CloudStep_Stack
==Que faire ensuite ?==
+
|title=Alerts
Vous pouvez en savoir plus à propos des fonctions suivantes :
+
|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.
* [[RTRWidgetTypes|Types de widgets]]
+
 
* [[RTRReports|Rapports populaires en temps réel]]
+
{{NoteFormat|Only numerical non-formula-based statistics with the <tt>Time-Based</tt> or <tt>Reset-Based</tt> notification mode are available in the '''Advanced Alerts'''.|3}}
* [[RTRWidgetExternal|Affichage du contenu externe à l’aide d’un widget IFRAME]]
+
 
*[[RTRStatProperties|Propriétés statistiques]]
+
The <tt>Advanced Alerts</tt> section has the following two modes:
*[[RTRFormulas|Formules de rapport]]
+
* '''Builder'''.  Simplifies building basic conditions.
*[[RTRFunctions|Bibliothèque de fonctions de modèles]]
+
* '''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. 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 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
 +
|title=Propagate template changes
 +
|text=When editing is finished and you click '''Save''',  Pulse displays a list of all user widgets that use the template. Pulse lists the titles and owners of the widgets.
 +
*Select which widgets should be updated.
 +
*If needed, Pulse provides an '''Overwrite Display Options for widget(s) selected above''' checkbox.
 +
** If you select the checkbox, Pulse updates the widget type, headline, and all other display options in the widgets (except refresh rate), as well as the statistic definitions and allowed object types.
 +
**If you don't select the checkbox, Pulse updates only the statistic definitions and allowed object types.
 +
|media1=Pulse_85105_proptempch.png
 +
}}
 +
 
 +
{{CloudStep_Stack
 +
|title=Select Collectors
 +
|text=Starting with release 8.5.108, Genesys Pulse allows users to assign specific 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 GAX configuration and assign the role with the <tt>Pulse Manually Bind Collectors</tt> 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.
 +
 
 +
|media1=Pulse_85108_TemplateSelectCollectors.png
 +
}}
 +
 
 +
==What do I do next?==
 +
You might want to learn more about:
 +
* [[RTRWidgetTypes|Widget Types]]
 +
* [[RTRReports|Popular real-time reports]]
 +
* [[RTRWidgetExternal|Displaying external content using an IFRAME widget]]
 +
*[[RTRStatProperties|Statistic properties]]
 +
*[[RTRFormulas|Report formulas]]
 +
*[[RTRFunctions|Template function library]]
  
  

Version du août 2, 2018 à 20:04

Change the standard reports (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.

Manage standard report templates

1

To manage shared widget templates, select Settings.

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.
  • One widget type with specific options to display the information.
Important
You can hide or unhide the statistics and display options when you create or edit widgets. You can edit only user-created templates. Pulse overwrites any changes made to predefined templates with the original predefined templates every time Pulse starts, unless you set the install_templates configuration option in the [pulse] section of the GAX Application object 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 Pulse statistic definition, you can specify statistic parameters regardless of whether they are available on any StatServer in your environment. This means you must also update the StatServer options to ensure that the StatServer connected to 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.

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 Pulse sends to StatServer. You can modify a statistic definition within 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.

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.

  • 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, thresholds and 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.

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 with the Time-Based or Reset-Based notification mode are available in the Advanced Alerts.

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. 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 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, Pulse displays a list of all user widgets that use the template. Pulse lists the titles and owners of the widgets.

  • Select which widgets should be updated.
  • If needed, Pulse provides an Overwrite Display Options for widget(s) selected above checkbox.
    • If you select the checkbox, Pulse updates the widget type, headline, and all other display options in the widgets (except refresh rate), as well as the statistic definitions and allowed object types.
    • If you don't select the checkbox, Pulse updates only the statistic definitions and allowed object types.

Select Collectors

1

Starting with release 8.5.108, Genesys Pulse allows users to assign specific 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 GAX configuration 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.

What do I do next?

You might want to learn more about:

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