Utiliser les widgets du portail

Les widgets définissent le contenu des pages de votre portail. Vous pouvez utiliser les widgets du système de base fournis avec Portail de services, cloner et modifier des widgets, ou développer des widgets personnalisés pour répondre à vos propres besoins.

Lorsque vous créez ou mettez à jour une page dans le Portail de services Designer, vous pouvez facilement ajouter des widgets en effectuant une recherche dans le filtre de widget et en faisant glisser un widget sur la page. Vous pouvez également accéder à tous les enregistrements de widgets à partir de la plateforme à l’adresse Tous > Portail de services > Widgets.

Widgets du système de base

Vous pouvez utiliser les widgets du système de base inclus Portail de services pour commencer à configurer les pages du portail. Les widgets du système de base sont en lecture seule afin que vous puissiez profiter des futures mises à jour. Toutefois, pour chaque instance d’un widget du système de base que vous ajoutez à une page, vous pouvez configurer les options d’instance disponibles pour ce widget.

Pour obtenir la liste des widgets du système de base et des informations sur leurs options d’instance, consultez la Bibliothèque de widgetssection .

Instances de widget

Lorsque vous ajoutez un widget à une page à l’aide de Service Portal Designer, il crée une instance de widget. Une instance de widget est une référence à un widget qui contient un emplacement, des propriétés et des CSS spécifiques à cette instance. Ajouter plusieurs fois le même widget à la même page crée plusieurs instances.

Toutes les instances de widget pointent vers un widget. Si vous modifiez ce widget, toutes ses instances de widget reçoivent également ce changement. Vous pouvez également apporter des modifications spécifiques à une instance de widget, et seule cette instance de widget est affectée.

Par exemple, l’image suivante comprend quatre instances du système Widget Lien icône de base avec des configurations différentes spécifiques à chaque instance.

Figure 1. Widgets de liens d’icônes

Remarque :

Pour les widgets qui ne contiennent aucune information par défaut, vous devez configurer les options de leurs instances de widget avant qu’ils n’apparaissent sur une page de portail.

Menu contextuel du widget

À partir de n’importe quelle page de Portail de services rendue, vous pouvez CTRL + clic droit sur un widget pour afficher plus d’options de configuration dans un menu contextuel.

Par exemple, accédez à Portail de services > Accueil du Portail de services pour ouvrir un exemple de page de portail. CTRL + clic droit sur Base de connaissances sur cette page.

Figure 2. Menu contextuel du widget

Remarque :

Vous devez avoir le rôle administrateur ou sp_admin pour afficher le menu contextuel du widget. Lorsque vous empruntez l’identité d’un utilisateur sans l’un de ces rôles, vous pouvez toujours voir le menu. Toutefois, un utilisateur normal connecté sans ces rôles ne peut pas voir le menu.

Tableau 1. Options du menu contextuel du widget

Option	Description
Performances des widgets	Temps nécessaire au chargement d’un widget
Options d’instance	Spécifiez l’instance d’un widget. Les options d’instance de widget varient en fonction du widget que vous sélectionnez. Par exemple, les options d’instance pour le widget Horloge cool comprennent des fuseaux horaires différents pour chaque instance, de sorte que vous pouvez avoir la même horloge quatre fois sur une page, mais avec des fuseaux horaires différents.
Instance dans l’éditeur de page	Ouvre cette instance du widget dans l’éditeur de page
Créateur de page	Ouvre le widget dans Service Portal Designer, qui vous permet d’ajouter des conteneurs, des colonnes et des widgets. Vous pouvez ajouter un style du Service Portal Designer au widget ou à la page sur laquelle le widget se trouve.
Afficher les personnalisations de widget	Affiche les niveaux de personnalisation des widgets sur la page afin que vous puissiez diagnostiquer les problèmes de page. Pour plus d'informations, consultez Diagnostics des widgets.
Modifier l'arrière-plan du conteneur	Modifiez la mise en page dans laquelle le widget se trouve.
Schéma des options de widget	Définissez les options que vous pouvez sélectionner pour l’instance d’un widget. Pour plus d’informations sur la configuration de vos propres options d’instance, reportez-vous à la section Schéma de l’option de widget.
Widget dans une fenêtre contextuelle	Ouvre le formulaire de widget dans une fenêtre contextuelle afin que vous puissiez apporter des modifications rapides au widget.
Widget dans l’Éditeur	Ouvre le widget dans l’éditeur de widget. Vous pouvez utiliser l’éditeur de widget pour configurer des modèles HTML, CSS, des scripts clients, des scripts de service et des données de démonstration pour le widget.
Se connecter à la console : $scope.data	L’objet $scope.data transmet les données du serveur au contrôleur côté client. Au lieu d’ajouter des messages ou des alertes console.log dans le code du contrôleur, vous pouvez enregistrer l’objet $scope.data sur la console du navigateur et y afficher les données.
Se connecter à la console : $scope	Similaire à l’objet $scope.data, sauf qu’il enregistre tout $scope à la console.

Widgets personnalisés

Les widgets du système de base sont en lecture seule afin que vous puissiez profiter des futures mises à jour. Pour apporter des modifications, vous pouvez cloner des widgets du système de base. Cependant, les widgets clonés sont considérés comme des widgets personnalisés et ne bénéficient pas des futures mises à jour apportées aux widgets à partir desquels ils ont été clonés. Vous pouvez également créer des widgets à partir de zéro. Pour en savoir plus sur le clonage ou la création de widgets, reportez-vous à la section Développement de widgets personnalisés.

• Configurer les instances de widget
  Créez des instances uniques de widgets en configurant les options pour chaque instance.
• Bibliothèque de widgets
  Vous pouvez utiliser les widgets du système de base tels quels dans votre Portail de services ou les cloner en fonction des besoins de votre entreprise.