NinjaOne Endpoint management: personalizzazione del marchio con l'icona Systray

Argomento

Questo articolo spiega come configurare e utilizzare l'icona Systray come parte del tuo sito NinjaOne personalizzato.

Ambiente

NinjaOne Endpoint Management

Descrizione

NinjaOne consente di creare e distribuire un'icona Systray personalizzata per la propria organizzazione.

Branding: Icona Systray (NinjaOne Inc. 02:05)

Indice

Selezionare una categoria per ulteriori informazioni:

Abilitazione dell'icona Systray
Configurazione dell'icona Systray
- Creazione del menu dell'icona Systray
- Spiegazione delle voci di menu
Distribuzione della configurazione Systray
Eliminazione o modifica dell'icona Systray
Esperienza utente
Utilizzo avanzato
- Segnaposto per le voci di menu
- Segnaposto del modulo di aiuto
Risorse aggiuntive

Abilitazione dell'icona Systray

Prima di poter utilizzare l'icona Systray, è necessario attivarla in NinjaOne. A tal fine, accedere a Amministrazione → Generale → Systray → Abilita.

**Figura 1:** Amministrazione → Generale → Systray → Abilita (clicca per ingrandire)

Una volta abilitata, è possibile utilizzare il pulsante Aggiungi systray per configurarla.

add systray.png — **Figura 2**: Amministrazione → Generale → Systray → Aggiungi systray (clicca per ingrandire)

Configurazione dell'icona Systray

Nella finestra dell'applicazione Systray, fare clic su Aggiungi systray per configurare una nuova icona Systray. Per configurare un systray esistente, fare clic sul pulsante con i tre puntini e selezionare Modifica.

add or edit systray.png — **Figura 3:**Aggiungi o modifica l'icona Systray (clicca per ingrandire)

Nel menu Aggiungi Systray è possibile personalizzare ciò che appare quando gli utenti fanno clic sull'icona Systray.

systray config modal.png — **Figura 4:**Aggiungi opzioni systray (clicca per ingrandire)

Fare clic su Aggiungi Systray, assicurarsi di trovarsi nella scheda Generale, quindi compilare i seguenti campi:

Nome: assegnare all'icona della barra delle applicazioni un nome descrittivo.
Descrizione: aggiungi una descrizione facoltativa.
Suggerimento: aggiungi il testo che appare quando un utente sposta il cursore sull'icona delle informazioni.
Icona del vassoio di sistema del sistema operativo: carica l'immagine grafica che desideri utilizzare come icona del vassoio di sistema. L'immagine deve essere un file JPG o PNG di dimensioni equilaterali comprese tra 16x16 e 128x128 pixel.

Creazione del menu dell'icona Systray

In questo passaggio, configurerai il menu che appare quando gli utenti fanno clic sull'icona Systray.

Aggiunta di voci di menu

Nella scheda Menu Systray, fare clic su Aggiungi voce di menu, quindi selezionare il tipo di voce dal menu a discesa.

systray menu_add menu item.png — **Figura 5:**Aggiungi configurazione menu Systray (clicca per ingrandire)

Configurare le impostazioni della voce di menu. Le opzioni di configurazione variano a seconda del tipo di voce di menu selezionato. Fare riferimento alla tabella Spiegazioni delle voci di menu riportata di seguito per informazioni su ciascun tipo di voce di menu.

**Figura 6:** Configurazione dell'automazione (fare clic per ingrandire)

Modifica delle voci di menu

Per modificare una voce di menu, posizionare il cursore su di essa e fare clic sull'opzione Modifica quando viene visualizzata. È anche possibile trascinare e rilasciare le voci nell'albero dei menu per disporle come desiderato. Al termine, fare clic su Salva modifiche.

**Figura 7:** Modifica voce di menu (clicca per ingrandire)

Eliminazione delle voci di menu

Per eliminare una voce di menu, posizionare il cursore su di essa e fare clic sull'opzione Rimuovi quando viene visualizzata.

**Figura 8:** Rimuovi icona menu (clicca per ingrandire)

Spiegazione delle voci di menu

La tabella seguente illustra i vari tipi di voci di menu.

Tipo di voce di menu	Descrizione
Informazioni	Questa voce consente di includere informazioni sulla propria azienda. È monouso e sarà sempre posizionata al livello principale; non può essere nidificata. Il campo Descrizione supporta l'HTML di base. Il sistema visualizzerà qui l'indirizzo e-mail e il numero di telefono creati in Branding.
Automazione	NinjaOne offrirà solo automazioni compatibili con il sistema operativo selezionato. Quando un utente seleziona un'automazione, l'agente NinjaRMM esegue l'automazione e tutti gli script associati in sequenza. Le automazioni eseguite dal Systray attiveranno un'attività a livello di dispositivo: "Avvio richiesto dall'utente finale del dispositivo". È possibile filtrare queste attività nella dashboard del dispositivo. È possibile aggiungere automazioni non native di NinjaOne. Innanzitutto, aggiungere l'automazione alla Libreria automazioni. Le istruzioni sono disponibili in di NinjaOne. Non eseguire le automazioni Systray come "utente attualmente connesso" sui server desktop remoti. Ciò causerebbe l'esecuzione dello script nella prima sessione in un ambiente multiutente e, di conseguenza, non sarebbe indirizzato a un utente specifico.
Email	Il tipo Email consente di personalizzare un'e-mail che un cliente può inviare. Questa opzione utilizza il programma di posta configurato sul nodo. È inoltre possibile utilizzare variabili di ambiente con la voce di menu Email.
Esci	Questa voce monouso sarà sempre posizionata al livello radice. Non può essere nidificata. La voce inserisce un'opzione "Esci" per consentire agli utenti di chiudere l'eseguibile Systray.
Gruppo	Gruppo consente di creare intestazioni di menu per le voci Systray. Per impostazione predefinita, le voci vengono aggiunte al livello radice. È possibile creare tutti i gruppi necessari.
Modulo di richiesta di assistenza	Questo elemento monouso sarà sempre posizionato al livello principale e non può essere nidificato. Questo tipo di elemento consente di configurare un modulo dinamico che è possibile inoltrare a un indirizzo e-mail, al proprio strumento PSA integrato o a NinjaOne Ticketing. Quando si invia la richiesta al proprio strumento PSA integrato, è possibile scegliere il modello di ticket. Questa opzione non si applica a NinjaOne Ticketing. I campi Oggetto e Descrizione supportano HTML di base e segnaposto. Per impostazione predefinita, tutti i segnaposto disponibili vengono aggiunti al modulo (e sono elencati in forma di testo di seguito). È possibile aggiungere, rimuovere e riorganizzare i segnaposto come desiderato. È possibile troncare qualsiasi campo, il che è utile quando si inoltra a uno strumento PSA che limita la lunghezza dei titoli dei ticket. Ad esempio: `"Richiesta di assistenza da ${client.name?truncate(25)} / ${form.subject?truncate(100)}"` È possibile utilizzare variabili di ambiente con la voce di menu Modulo di richiesta di assistenza. Per ulteriori informazioni, consultare Branding: variabili di ambiente tramite icona Systray. Gli utenti finali possono inviare screenshot e allegare immagini. Se il modulo di richiesta di assistenza è impostato per l'inoltro a uno strumento PSA integrato, l'e-mail apparirà come nota (insieme a tutti gli altri contenuti) sul ticket. L'e-mail non compilerà automaticamente i campi nel PSA né si sincronizzerà con un contatto esistente.
Avvio	Questo tipo di elemento consente di compilare i comandi di avvio che i clienti possono utilizzare. È possibile specificare la posizione e il nome del file eseguibile da avviare insieme agli argomenti della riga di comando. Questa funzione eseguirà le applicazioni come utente connesso. Ecco alcuni esempi di comandi cmd che è possibile eseguire tramite l'icona Systray (questo elenco non è esaustivo): mostra aggiungi/rimuovi programmi: `cmd.exe /c "appwiz.cpl"` mostra gestione computer:`cmd.exe /c "compmgmt.msc"` mostra pannello di controllo:`cmd.exe /c "control panel"` avvia prompt cmd:`cmd.exe` mostra gestione dispositivi:`cmd.exe /c "devmgmt.msc"` mostra utilità gestione disco:`cmd.exe /c "diskmgmt.msc"` mostra visualizzatore eventi:`cmd.exe /c "eventvwr.msc"` mostra connessioni di rete:`cmd.exe /c "control netconnections"` mostra stampanti:`cmd.exe /c "control printers"` mostra MTSC:`cmd.exe /c "mstsc"` mostra servizi:`cmd.exe /c "services.msc"` mostra msinfo:`cmd.exe /c "msinfo32"` mostra task manager: `cmd.exe /c "taskmgr"` mostra nome computer:`cmd.exe /c "Control sysdm.cpl"` mostra informazioni complete sulla configurazione IP:`cmd.exe /k "ipconfig /all"` rilascia l'indirizzo IP: `cmd.exe /k "ipconfig /release"` rinnova l'indirizzo IP:`cmd.exe /k "ipconfig /renew"` svuota la cache del resolver DNS: `cmd.exe /k "ipconfig /flushdns"` Nota: il percorso completo non è necessario per i file eseguibili che risiedono nelle directory elencate nella variabile di ambiente PATH Utilizza il comando open integrato nativamente in macOS per i dispositivi macOS. Ad esempio: `open "/Applications/Google Chrome.app"` Per ulteriori esempi di utilizzo del comando open, utilizzare il comando man open all'interno del terminale nativo o del terminale remoto NinjaOne. Per i dispositivi macOS, è anche possibile utilizzare il seguente esempio per scrivere in un campo personalizzato: `"/Applications/NinjaRMMAgent/programdata/ninjarmm-cli" set Systraymacinstallshottr true`
Separatore	Questo tipo di elemento inserisce un separatore di riga tra le voci di menu o i gruppi.
Statico	Questo comando consente di inserire del testo statico che il sistema mostrerà all'utente.
URL	Questo tipo di elemento consente di configurare URL specifici che i clienti possono avviare secondo necessità. Questo comando è utile se si desidera consentire ai clienti di chiamare tramite Skype o qualsiasi altro URL dinamico.

Distribuzione della configurazione Systray

Dopo aver configurato l'icona Systray, è possibile distribuirla a singole o più organizzazioni.

Passare alla scheda Amministrazione → Organizzazioni.
Selezionare la casella di controllo accanto alle organizzazioni desiderate. È possibile selezionare più di un'organizzazione.
Fare clic su Modifica impostazioni e selezionare Systray dal menu a discesa.

**Figura 9:** Modifica impostazioni→ Systray (clicca per ingrandire)

Attivare l'opzione Abilita Systray, selezionare il modello Systray desiderato, quindi selezionare Applica per salvare le modifiche.

In alternativa, è possibile distribuire l'icona Systray dalla pagina di configurazione dell'organizzazione:

Passare alla scheda Amministrazione → Organizzazioni e selezionare l'organizzazione. La scheda Generale sarà aperta per impostazione predefinita.
Attivare l'interruttore dell'icona Systray, selezionare il modello di icona desiderato dal menu a discesa e fare clic su Salva.

**Figura 10: Modifica** dalla pagina di configurazione (clicca per ingrandire)

Eliminazione o modifica dell'icona Systray

Assicurarsi che l'icona Systray non sia configurata o associata ad alcuna organizzazione prima di tentare di eliminarla. Non è possibile eliminare l'icona Systray predefinita.

Passare a Amministrazione → Generale e aprire la scheda Systray.
Spostare il cursore sulla riga Systray e fare clic sull'icona con i tre puntini.
Selezionare l'azione.

Il sistema visualizzerà un messaggio di errore se l'icona Systray è già configurata con un'organizzazione. Non è possibile eliminare l'icona Systray finché non si elimina la sua configurazione dell'organizzazione. Fare clic sul nome dell'organizzazione nella finestra di dialogo per modificare l'icona Systray di tale organizzazione.

L'esperienza utente

Dopo aver distribuito Systray, il sistema dell'utente mostrerà l'icona designata (o l'icona a forma di ingranaggio predefinita) e gli utenti potranno interagire con i suggerimenti configurati.

Esempio di Microsoft Windows

**Figura 10:** Icona Systraydi Microsoft Windows (fare clic per ingrandire)

Esempio Apple macOS

**Figura 11:** Icona Systraydi Apple macOS (clicca per ingrandire)

Esempio Linux

**Figura 12:** Icona Systraydi Linux (clicca per ingrandire)

Potrebbe essere necessario installare un'estensione del vassoio (come GNOME)per utilizzare l'icona Systray con l'agente Linux. L'estensione del vassoio dipenderà dall'ambiente desktop utilizzato.

Utilizzo avanzato

Segnaposto per le voci di menu

Segnaposto da utilizzare nelle voci di menu (URL, avvio o finestradi dialogo Informazioni ):

${IP_ADDR}: indirizzi IP
${USERNAME}: nome utente dell'utente corrente
${HOSTNAME}: nome host del computer
${DOMAIN}: Dominio del computer a cui il nodo si è collegato
${TIMESTAMP}: timestamp corrente in formato ISO (UTC)
Qualsiasi variabile di ambiente, come ${PROCESSOR_ARCHITECTURE}

Segnaposto del modulo di aiuto

Nome: $ {form.firstName}
Cognome: ${form.lastName}
E-mail: ${form.email}
Telefono: ${form.phone}
Oggetto: ${form.subject}
Descrizione del problema: ${form.body}
Dispositivo: ${node.displayName}
URL Ninja: ${node.url}
Ruolo del dispositivo: ${node.nodeRole}
IP pubblico: ${node.publicIpAddress}
IP privati: ${node.ipAddress}
ID dispositivo: ${node.id}
Organizzazione: $ {client.name}
Descrizione: ${client.description}
URL dell'organizzazione: ${client.url}
Politica: ${policy.name}
Descrizione della politica: ${policy.description}
URL della politica: ${policy.url}

Inoltre, è possibile utilizzare qualsiasi variabile di ambiente configurata nel sistema con il prefisso env.

COMPUTERNAME: ${COMPUTERNAME}
SISTEMA OPERATIVO: ${env.OS}
NUMBER_OF_PROCESSORS: ${NUMBER_OF_PROCESSORS}
ARCHITETTURA_PROCESSORE: ${ARCHITETTURA_PROCESSORE}
DOMINIO_UTENTE: ${DOMINIO_UTENTE}
NOME UTENTE: ${NOME UTENTE}

Risorse aggiuntive

Per ulteriori informazioni, consultare la seguente documentazione:

NinjaOne Endpoint management: personalizzazione del marchio con l’icona Systray