Vous êtes déjà client NinjaOne ? Connectez-vous pour consulter d'autres guides et les dernières nouvelles.

NinjaOne Plate-forme : L’image de marque avec l’icône Systray

Contenu

Cet article explique comment configurer et utiliser l'icône Systray dans le cadre de votre site NinjaOne personnalisé.

Environnement

Plateforme NinjaOne

Description

NinjaOne vous permet de créer et de déployer une icône Systray personnalisée pour votre organisation. 

Personnalisation : Icône Systray (NinjaOne Inc. 02:05)

Indexer

Sélectionnez une catégorie pour en savoir plus : 

Activation de l'icône Systray

Avant de pouvoir utiliser l'icône Systray, vous devez l'activer dans NinjaOne. Cliquez sur Administration dans le menu de navigation NinjaOne, puis sélectionnez Systray dans le menu déroulant Général et cliquez sur le bouton Activer.

Une fois l'option activée, vous pouvez utiliser le bouton Add systray pour la configurer. 

ajouter systray.png
Image 1 : Ajouter une fenêtre systray pour NinjaOne

Configuration de l'icône Systray

Cliquez sur Ajouter une barre d'état système pour configurer une nouvelle icône de barre d'état système. Pour configurer un systray existant, cliquez sur le bouton ellipse et sélectionnez Modifier

ajouter ou modifier systray.png
Figure 2 : Ajouter ou modifier l'icône Systray

Dans le menu Ajouter Systray, vous pouvez personnaliser ce qui apparaît lorsque les utilisateurs cliquent sur l'icône Systray. 

systray config modal.png
Figure 3 : Options de configuration du Systray

Cliquez sur Add Systray, assurez-vous que vous êtes sur l'onglet General, puis remplissez les champs suivants :

  • Nom : Donnez un nom descriptif à l'icône Systray.
  • Description : Ajouter une description facultative.
  • Info-bulle : Ajouter un texte qui apparaît lorsque l'utilisateur déplace son curseur sur l'icône d'information.
  • Icône de la barre d'état-major du système d'exploitation : Téléchargez l'image graphique que vous souhaitez utiliser comme icône Systray. Cette image doit être un fichier JPG ou PNG de taille équilatérale comprise entre 16x16 et 128x128 pixels.

Création du menu d'icônes Systray

Dans cette étape, vous allez configurer le menu qui apparaît lorsque les utilisateurs cliquent sur l'icône Systray. 

Ajout d'éléments de menu

  1. Dans l'onglet Menu Systray, cliquez sur Ajouter un élément de menu, puis sélectionnez le type d'élément dans la liste déroulante.
systray menu_add menu item.png
Figure 4 : Élément de menu Ajouter une fenêtre systémique
  1. Configurer les paramètres de l'élément de menu. Les options de configuration varient en fonction du type d'élément de menu sélectionné. Consultez le tableau d'explication des éléments de menu ci-dessous pour en savoir plus sur chaque type d'élément de menu.
Retrofit_Systray_ConfigMenuItem.png
Figure 5: Configuration des éléments de menu (cliquer pour agrandir)

Modification des éléments de menu

Pour modifier un élément de menu, placez votre curseur dessus et cliquez sur l'option Modifier lorsqu'elle apparaît. Vous pouvez également faire glisser et déposer des éléments dans l'arborescence du menu pour les disposer comme vous le souhaitez. Lorsque vous avez terminé, cliquez sur Enregistrer les modifications.

Retrofit_Systray_EditMenuItem.png
Image 6 : Élément du menu Édition (cliquer pour agrandir)

Suppression des éléments du menu 

Pour supprimer un élément de menu, placez votre curseur dessus et cliquez sur l'option Supprimer lorsqu'elle apparaît. 

Retrofit_Systray_RemoveMenuItem.png
Figure 7: Supprimer l'icône du menu (cliquer pour agrandir)

Explication des points de menu

Le tableau suivant explique chaque type d'élément de menu.

Type d'élément de menuDescription
À propos

Cette rubrique vous permet d'inclure des informations sur votre entreprise. Il est à usage unique et se trouve toujours au niveau de la racine ; il ne peut pas être imbriqué.

  • Le champ Description est compatible avec le langage HTML de base.
  • Le système affichera l'adresse électronique et le numéro de téléphone créés sous Branding ici. 
Automatisation
  • NinjaOne ne propose que des automatismes compatibles avec le système d'exploitation sélectionné.
  • Lorsqu'un utilisateur sélectionne une automatisation, l'agent NinjaRMM exécute l'automatisation et tous les scripts associés dans l'ordre.
  • Les automatismes exécutés à partir du Systray déclenchent une activité au niveau de l'appareil : "Démarrage demandé par l'utilisateur final du dispositif" Vous pouvez filtrer ces activités sur le tableau de bord de l'appareil.
  • Vous pouvez ajouter des automatismes qui ne sont pas natifs de NinjaOne. Tout d'abord, ajoutez l'automatisation à la bibliothèque d'automatisation. Les instructions se trouvent dans la section Premiers pas avec la bibliothèque d'automatisation de NinjaOne (Scripting).
  • Ne pas exécuter les automatismes Systray en tant qu'"utilisateur connecté" sur les serveurs de bureau à distance. Dans ce cas, le script s'exécute lors de la première session dans un environnement multi-utilisateurs et ne cible donc pas un utilisateur en particulier. 
E-mail
  • Le type d'email vous permet de personnaliser un email qu'un client peut vous envoyer.  
  • Cette option utilise le programme de messagerie configuré sur le nœud.
  • Vous pouvez également utiliser des variables d'environnement avec l'option de menu Email.
QuitterCet élément à usage unique se trouve toujours au niveau de la racine. Il ne peut pas être imbriqué. L'élément insère une option "exit" pour permettre à vos utilisateurs de fermer l'exécutable Systray.
GroupeLe groupe vous permet de créer des titres de menu pour vos éléments Systray. Par défaut, les éléments sont ajoutés au niveau de la racine. Vous pouvez créer autant de groupes que nécessaire.
Formulaire de demande d'aide
  • Cet élément à usage unique se trouve toujours au niveau de la racine ; il ne peut pas être imbriqué.
  • Ce type d'élément vous permet de configurer un formulaire dynamique que vous pouvez transmettre à une adresse e-mail, à votre outil PSA intégré ou à NinjaOne Ticketing.
  • Lorsque vous envoyez la demande à votre outil d'auto-assistance intégré, vous pouvez choisir le modèle de ticket. Cette option ne s'applique pas à la billetterie NinjaOne.
  • Les champs Sujet et Description prennent en charge le HTML de base et les caractères de remplacement. Par défaut, tous les éléments de substitution disponibles sont ajoutés au formulaire (et sont répertoriés sous forme de texte ci-dessous). Vous pouvez ajouter, supprimer et réorganiser les espaces réservés à votre guise.
  • Vous pouvez tronquer n'importe quel champ, ce qui est utile lorsque vous transmettez à un outil PSA qui limite la longueur des titres des tickets. Voici un exemple de la façon de procéder : "Demande d'aide de ${client.name?truncate(25)} / ${form.subject?truncate(100)}"
  • Vous pouvez utiliser des variables d'environnement avec l'élément de menu Formulaire de demande d'aide. Voir Branding : Variables d'environnement vis Systray Icon pour plus d'informations.
  • Les utilisateurs finaux peuvent soumettre des captures d'écran et inclure des images en pièce jointe.
  • Si votre formulaire de demande d'aide est configuré pour être transmis à un outil d'ASP intégré, l'e-mail apparaîtra comme une note (avec tous les autres contenus) sur le ticket. L'e-mail ne remplira pas automatiquement les champs de votre PSA et ne sera pas synchronisé avec un contact existant.
Lancement
  • Ce type d'élément vous permet de remplir des commandes de lancement que vos clients peuvent utiliser. Vous pouvez spécifier l'emplacement et le nom de fichier de l'exécutable à lancer, ainsi que des arguments de ligne de commande.
  • Cette fonction permet d'exécuter les applications en tant qu'utilisateur connecté.
  • Voici quelques exemples de commandes cmd que vous pouvez exécuter à partir de l'icône Systray (cette liste n'est pas exhaustive) :
    • afficher les programmes ajoutés/supprimés: cmd.exe /c "appwiz.cpl"
    • afficher la gestion de l'ordinateur : cmd.exe /c "compmgmt.msc"
    • afficher le panneau de configuration : cmd.exe /c "panneau de configuration"
    • lancer l'invite cmd :  cmd.exe
    • afficher la gestion des périphériques : cmd.exe /c "devmgmt.msc"
    • afficher l'utilitaire de gestion des disques : cmd.exe /c "diskmgmt.msc"
    • afficher la visionneuse d'événements : cmd.exe /c "eventvwr.msc"
    • afficher les connexions réseau : cmd.exe /c "control netconnections"
    • afficher les imprimantes : cmd.exe /c "contrôler les imprimantes"
    • afficher MTSC : cmd.exe /c "mstsc"
    • afficher les services : cmd.exe /c "services.msc"
    • afficher msinfo : cmd.exe /c "msinfo32"
    • afficher le gestionnaire des tâches : cmd.exe /c "taskmgr"
    • afficher le nom de l'ordinateur : cmd.exe /c "Contrôle sysdm.cpl"
    • afficher les informations complètes sur la configuration IP : cmd.exe /k "ipconfig /all"
    • libérer l'adresse IP : cmd.exe /k "ipconfig /release"
    • renouveler l'adresse IP : cmd.exe /k "ipconfig /renew"
    • purger le cache du résolveur DNS : cmd.exe /k "ipconfig /flushdns"
      • Remarque : Le chemin complet n'est pas requis pour les exécutables résidant dans les répertoires énumérés dans la variable d'environnement PATH

  • Utilisez la commande open intégrée à macOS pour les appareils macOS.  Par exemple :

    ouvrir "/Applications/Google Chrome.app"

  • Pour plus d'exemples d'utilisation de la commande open, utilisez la commande man open dans le terminal natif ou le terminal distant NinjaOne.
  • Pour les appareils macOS, vous pouvez également utiliser l'exemple suivant pour écrire dans un champ personnalisé :
    "/Applications/NinjaRMMAgent/programdata/ninjarmm-cli" set Systraymacinstallshottr true
SéparateurCe type d'élément insère un séparateur de ligne entre les éléments de menu ou les groupes.
StatiqueCette commande vous permet de saisir un texte statique que le système affichera à l'utilisateur.
URLCe type d'élément vous permet de configurer des URL spécifiques que vos clients peuvent lancer selon leurs besoins.  Cette commande est utile si vous souhaitez permettre à vos clients de vous appeler via Skype ou toute autre URL dynamique. 

Déploiement de la barre d'état système

Après avoir configuré l'icône Systray, vous pouvez la déployer dans une ou plusieurs organisations.

  1. Naviguez vers l'onglet AdministrationOrganisations.
  2. Cochez la case en regard des organisations souhaitées. Vous pouvez sélectionner plusieurs organisations.
  3. Cliquez sur Modifier les paramètres et sélectionnez Systray dans le menu déroulant.
Retrofit_Systray_EditOrg.png
Image 8 : Modifier les paramètres de Systray (cliquer pour agrandir)
  1. Activez le commutateur Enable systray, sélectionnez le modèle de systray souhaité, puis sélectionnez Apply pour enregistrer les modifications.

Vous pouvez également déployer l'icône Systray à partir de la page de configuration de l'organisation :

  1. Naviguez vers l'onglet AdministrationOrganisations et sélectionnez l'organisation. L'onglet Général est ouvert par défaut.
  2. Activez l'interrupteur à bascule de l' icône Systray, sélectionnez le modèle d'icône souhaité dans le menu déroulant et cliquez sur Enregistrer.
Retrofit_Systray_ActivateFromOrg.png
Image 9 : Édition à partir de la page de configuration  (cliquer pour agrandir)

Suppression ou modification de l'icône Systray

Assurez-vous que l'icône Systray n'est pas configurée ou associée à une organisation avant de tenter de la supprimer. Il n'est pas possible de supprimer le Systray par défaut. 
  1. Naviguez vers AdministrationGénéral et ouvrez l'onglet Systray.
  2. Placez votre curseur sur la ligne Systray et cliquez sur l'icône de l'ellipse (trois points).
  3. Sélectionnez l'action. 

Le système affiche un message d'erreur si l'icône Systray est déjà configurée avec une organisation. Vous ne pouvez pas supprimer l'icône Systray tant que vous n'avez pas supprimé sa configuration d'organisation. Cliquez sur le nom de l'organisation dans la boîte de dialogue pour modifier l'icône Systray de cette organisation. 

L'expérience de l'utilisateur

Après avoir déployé le Systray, le système de l'utilisateur affichera l'icône que vous avez désignée (ou l'icône d'engrenage par défaut), et les utilisateurs pourront interagir avec les infobulles que vous avez configurées.

Exemple de Microsoft Windows

Figure 10 : Microsoft Icône Windows Systray

Apple macOS Exemple

Image 11 : Icône Systray de macOS Apple 

Exemple sur Linux

image__20_.png
Image 12 : Icône Linux Systray
Il se peut que vous deviez installer une extension de plateau (telle que GNOME) pour utiliser l'icône Systray avec l'agent Linux. L'extension du plateau dépend de l'environnement de bureau utilisé.

Utilisation avancée

Éléments de substitution pour les éléments de menu

Caractères de remplacement à utiliser dans les éléments de menu(URL, lancement ou boîte de dialogue"À propos" ) :

  • ${IP_ADDR}: Adresses IP
  • ${USERNAME}: Nom d'utilisateur de l'utilisateur actuel
  • ${HOSTNAME}: Nom d'hôte de la machine
  • ${DOMAIN}: Machine du domaine que le nœud a rejoint
  • ${TIMESTAMP}: Horodatage actuel au format ISO (UTC)
  • Toute variable d'environnement, telle que ${PROCESSOR_ARCHITECTURE} 

Éléments de substitution du formulaire d'aide

  • Prénom : ${form.firstName}
  • Nom de famille : ${form.lastName}
  • Courriel : ${form.email}
  • Téléphone : ${form.phone}
  • Sujet : ${form.subject}
  • Description du problème : ${form.body}
  • Appareil : ${node.displayName}
  • URL Ninja : ${node.url}
  • Rôle de l'appareil : ${node.nodeRole}
  • IP publique : ${node.publicIpAddress}
  • IP privées : ${node.ipAddress}
  • ID de l'appareil : ${node.id}
  • Organisation : ${client.name}
  • Description : ${client.description}
  • URL de l'organisation : ${client.url}
  • Politique : ${nom.politique}
  • Description de la politique : ${policy.description}
  • URL de la politique : ${policy.url}

En outre, vous pouvez utiliser n'importe quelle variable d'environnement configurée dans le système à l'aide de la commande env. Préfixe.

  • NOM DE L'ORDINATEUR : ${NOM DE L'ORDINATEUR}
  • OS : ${env.OS}
  • NOMBRE_DE_PROCESSEURS : ${NOMBRE_DE_PROCESSEURS}
  • ARCHITECTURE_DU_PROCESSEUR : ${ARCHITECTURE_DU_PROCESSEUR}
  • DOMAINE UTILISATEUR : $ {DOMAINE UTILISATEUR}
  • NOM D'UTILISATEUR : ${NOM D'UTILISATEUR}

Ressources supplémentaires :

Reportez-vous à la documentation suivante pour plus d'informations :

FAQ

Pour aller plus loin