Puoi creare campi personalizzati (campi dati aggiuntivi) in tutta la tua piattaforma Atera. Possono comparire nei moduli/pagine di Ticket, Cliente, Contatto, Contratto, SLA, Agente, SNMP, TCP, HTTP e Generico. Puoi anche creare campi personalizzati basati su script. Una volta aggiunto un campo personalizzato, questo sarà sempre visibile (a meno che non venga modificato o eliminato).
Puoi creare campi personalizzati (campi dati aggiuntivi) in tutta la tua piattaforma Atera. Possono comparire nei moduli/pagine di Ticket, Sito, Utente, SLA, Agente, SNMP, TCP, HTTP e Generico. Puoi anche creare campi personalizzati basati su script. Una volta aggiunto un campo personalizzato, questo sarà sempre visibile (a meno che non venga modificato o eliminato).
Posizioni dei campi personalizzati
Aggiungi campi personalizzati a ticket, siti, utenti, agenti e dispositivi.
Aggiungi campi personalizzati a ticket, clienti, contatti, contratti, SLA, agenti e dispositivi.
Nota: Per i campi personalizzati relativi ai ticket, puoi scegliere se il campo sia visibile e modificabile dagli utenti nel Service Portal.
Nota: Per i campi personalizzati relativi ai ticket, puoi scegliere se il campo sia visibile e modificabile dai contatti nel Customer Portal.
Tipi di campi personalizzati
- Testo: Inserisci un input testuale.
- Numero: Inserisci un valore numerico.
- Data: Usa un selettore di data (formato: mm/gg/aaaa).
- Casella di controllo: Seleziona una casella di controllo a singola opzione.
-
Menu a tendina: Scegli da un elenco di opzioni.
- Nota: Ogni valore inserito è limitato a 100 caratteri.
-
Menu a tendina con dipendenze: Usa un menu a tendina condizionale basato sulle selezioni precedenti.
- Nota: Ogni valore inserito è limitato a 100 caratteri.
-
Basato su script (solo agente)
- Testo: Input testuale generato da script.
- Numero: Input numerico generato da script.
Nota: I campi personalizzati supportano i link HREF, permettendoti di collegarti direttamente a documenti esterni, dashboard o altre risorse online rilevanti, rendendoli ancora più versatili e utili nelle operazioni quotidiane.
Limiti di visibilità nei report analitici
Puoi creare un numero illimitato di campi personalizzati, ma potrai visualizzare solo fino a 60 campi personalizzati di tipo testo nei report analitici, oltre a:
- 30 campi personalizzati a tendina (senza dipendenze)
- 50 campi personalizzati casella di controllo (booleani)
- 20 campi personalizzati di qualsiasi altro tipo
Se superi questi limiti, i report analitici mostreranno solo i primi campi creati fino al limite per ciascun tipo. In altre parole, i campi aggiuntivi non verranno visualizzati.
Aggiungi un campo personalizzato
Per aggiungere un campo personalizzato:
1. Vai su Admin > Gestione dati > Campi personalizzati.
Apparirà la pagina Campi personalizzati.
2. Seleziona una scheda per aggiungere un nuovo campo personalizzato.
Apparirà la schermata Aggiungi campo.
4. Compila i campi:
- Destinazione: La destinazione è già selezionata di default (in base alla scheda scelta).
- Tipo: Seleziona il tipo di campo.
- Titolo: Inserisci il titolo del campo.
-
Tipo di OS: Seleziona Windows o Mac.
- Disponibile solo per i campi personalizzati degli agenti.
-
Tipo di output: Seleziona Testo o Numero.
- Disponibile solo per i campi personalizzati degli agenti.
-
Sottotitolo: Inserisci il sottotitolo del campo.
- Disponibile per i campi personalizzati a tendina con dipendenze.
-
Campo obbligatorio: Imposta il campo come 'Obbligatorio' o 'Non obbligatorio'
- Non disponibile per i campi personalizzati degli agenti.
-
Configurazioni Service Portal: Decidi se gli utenti possono modificare il campo all'interno del Service Portal o nasconderlo alla vista.
- Disponibile solo per i campi personalizzati dei ticket.
-
Configurazioni Customer Portal: Decidi se i contatti possono modificare il campo all'interno del Customer Portal o nasconderlo alla vista.
- Disponibile solo per i campi personalizzati dei ticket.
-
Valori: Clicca sull'icona più per aggiungere un nuovo valore. Poi inserisci il valore.
- Disponibile per i campi personalizzati a tendina e a tendina con dipendenze.
-
Valori figli: Clicca sull'icona più per aggiungere un nuovo valore figlio. Poi inserisci il valore.
- Disponibile per i campi personalizzati a tendina con dipendenze.
5. Clicca su Aggiungi.
Il nuovo campo personalizzato viene aggiunto e apparirà nel modulo/pagina.
Nota: C'è un limite di 50 caratteri sia per i campi Titolo che Sottotitolo. Inoltre, i singoli valori inseriti nei menu a tendina sono limitati a 100 caratteri.
Crea stati personalizzati per i ticket
Mentre i campi personalizzati sono modificabili, la maggior parte dei campi predefiniti di Atera non lo sono. L'eccezione è il campo 'Stato' del ticket, dove puoi aggiungere valori extra che appariranno in tutti i tuoi ticket Atera. Per maggiori dettagli, vedi Stato personalizzato del ticket
Campi personalizzati basati su script
I campi personalizzati basati su script di Atera permettono l'inserimento dinamico dei dati, consentendoti di monitorare qualsiasi valore per una maggiore funzionalità e flessibilità.
Nota:
- Disponibile per gli utenti Atera Enterprise con permessi da Admin.
- Disponibile per gli utenti Atera Superpower con permessi da Admin.
- I campi personalizzati basati su script sono compatibili con script Windows PowerShell (.ps1) e macOS Shell (.sh) senza variabili — assicurati solo che il tipo di script corrisponda al sistema operativo.
- Non c'è limite di caratteri per i campi personalizzati basati su script.
- I campi personalizzati basati su script vengono aggiornati ogni 12 ore, oppure ogni volta che accedi alla Console Agente.
Per aggiungere un campo personalizzato basato su script:
1. Vai su Admin > Gestione dati > Campi personalizzati.
Apparirà la pagina Campi personalizzati.
2. Seleziona la scheda Agente. Poi clicca su Aggiungi campo.
Apparirà la schermata Aggiungi campo.
3. Compila il modulo Aggiungi campo:
- Destinazione: Seleziona Agente.
- Tipo: Seleziona Basato su script.
- Tipo di OS: Seleziona Windows o Mac.
- Tipo di output: Seleziona Testo o Numero.
- Titolo: Inserisci un titolo per il campo.
- Script di monitoraggio: Seleziona lo script (puoi creare o caricare script — oppure clonarne uno dalla Libreria script condivisa nella tua scheda I miei script).
4. Clicca su Aggiungi.
Il campo personalizzato basato su script apparirà.
L'output di questi script popolerà i campi personalizzati che hai configurato, rendendo i dati disponibili direttamente all'interno dei tuoi agenti (nella scheda Campi personalizzati).
Campi personalizzati basati su script più utilizzati
Di seguito sono riportati alcuni dei campi personalizzati basati su script più utilizzati. Per sapere come caricare uno script su Atera, consulta questo articolo:
Verifica TPM
Questo script verifica se il Trusted Platform Module (TPM) è presente e abilitato su un dispositivo. Il TPM è un componente hardware utilizzato per la sicurezza tramite chiavi crittografiche integrate.
Spiegazione dello script:
- Lo script interroga lo stato del TPM utilizzando il servizio Windows Management Instrumentation (WMI).
- Se non viene trovato alcun TPM, lo script restituirà "Disabilitato".
- Se il TPM viene trovato ed è abilitato, lo script restituirà "Abilitato".
- Se il TPM viene trovato ma non è abilitato, lo script restituirà "TPM trovato, non abilitato".
Quando carichi lo script, assicurati che venga eseguito con privilegi "System". Inoltre, quando crei il campo personalizzato basato su script, imposta il "Tipo di output" su "Testo".
# Check if the TPM is present
$tpm = Get-WmiObject -Namespace "Root\CIMv2\Security\MicrosoftTpm" -Class Win32_Tpm
# Determine the TPM status and output the result
if ($tpm -eq $null) {
Write-Output "Disabled"
} else {
if ($tpm.IsEnabled) {
Write-Output "Enabled"
} else {
Write-Output "TPM found, not enabled"
}
}
Tipo di chassis
Questo script determina se un dispositivo è un laptop o un desktop in base al tipo di chassis. Il tipo di chassis è una classificazione hardware che identifica la forma fisica del dispositivo.
Spiegazione dello script:
- Lo script recupera il tipo di chassis tramite WMI.
- Verifica se il tipo di chassis corrisponde a uno dei valori che indicano tipicamente un laptop (come i tipi di chassis 9, 10, 14, 30 o 31).
- Se viene trovata una corrispondenza, lo script restituirà "Laptop".
- Se non viene trovata alcuna corrispondenza, lo script restituirà "Desktop".
Quando configuri lo script in Atera, assicurati che venga eseguito come "System" e che il "Tipo di output" sia impostato su "Testo".
# Get the chassis type(s)
$chassisTypes = Get-WmiObject Win32_SystemEnclosure | Select-Object -ExpandProperty ChassisTypes
# Check if the chassis type indicates a laptop
$isLaptop = $false
foreach ($type in $chassisTypes) {
if ($type -in 9, 10, 14, 30, 31) {
$isLaptop = $true
break
}
}
# Output result
if ($isLaptop) {
Write-Output "Laptop"
} else {
Write-Output "Desktop"
}
Data di installazione OS
Questo script recupera la data di installazione del sistema operativo Windows su un dispositivo. Conoscere la data di installazione del sistema operativo può aiutare a capire l’età del sistema e a pianificare aggiornamenti o interventi di manutenzione.
Spiegazione dello script:
- Lo script interroga la data di installazione dal sistema operativo utilizzando WMI.
- Converte la data di installazione in un formato più leggibile (GG/MM/AAAA).
- La data formattata viene poi restituita come stringa.
Esegui lo script utilizzando l’opzione "Sistema" e, quando crei il campo personalizzato basato su script, imposta il "Tipo di output" su "Testo."
# PowerShell script to get OS installation date in DD/MM/YYYY format
# Get the OS installation date from the registry
$osInstallDate = (Get-WmiObject -Class Win32_OperatingSystem).InstallDate
# Convert the date to DD/MM/YYYY format
$formattedDate = [Management.ManagementDateTimeConverter]::ToDateTime($osInstallDate)
# Display the date in DD/MM/YYYY format
$formattedDate.ToString('dd/MM/yyyy')Utente attuale
Questo script identifica l’utente attualmente connesso e verifica se dispone di privilegi amministrativi. Queste informazioni sono fondamentali per il monitoraggio della sicurezza e per assicurarsi che gli utenti abbiano i livelli di accesso appropriati.
Spiegazione dello script:
- Lo script recupera il nome utente dell’utente attualmente connesso.
- Verifica se l’utente ha privilegi amministrativi.
- Lo script poi restituisce il nome utente seguito dal suo ruolo, ovvero "Admin" o "User".
Assicurati che lo script venga eseguito come "Utente attuale" in Atera e, quando crei il campo personalizzato basato su script, seleziona "Tipo di output" come "Testo."
# Get the current username
$currentUserName = [Environment]::UserName
# Check if the current user is an admin
$isAdmin = (New-Object Security.Principal.WindowsPrincipal([Security.Principal.WindowsIdentity]::GetCurrent())).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
# If the user is an admin, set the role to 'Admin', otherwise set it to 'User'
if ($isAdmin) {
$role = 'Admin'
} else {
$role = 'User'
}
# Output the username and role
Write-Output "$currentUserName - $role"
Uptime
Questo script calcola e mostra da quanto tempo un dispositivo è acceso e funzionante dall’ultimo avvio. Monitorare l’uptime può essere utile per controllare la stabilità del sistema e assicurarsi che i dispositivi vengano riavviati regolarmente.
Spiegazione dello script:
- Lo script calcola la differenza di tempo tra la data e ora attuali e l’ultimo avvio del dispositivo utilizzando WMI.
- Formatta poi questo uptime in una stringa che mostra il numero di giorni, ore e minuti in cui il dispositivo è stato operativo.
- L’uptime formattato viene quindi restituito come stringa, nel formato "X Giorni Y Ore Z Minuti" dove X, Y e Z rappresentano le rispettive durate.
Quando configuri questo script, assicurati che venga eseguito con privilegi "Sistema" e imposta il "Tipo di output" su "Testo" quando crei il campo personalizzato basato su script.
$uptime = (Get-Date) - (Get-CimInstance Win32_OperatingSystem).LastBootUpTime
$formattedUptime = "{0} Days {1} Hours {2} Minutes" -f $uptime.Days, $uptime.Hours, $uptime.Minutes
$formattedUptime
Modificare o eliminare i campi personalizzati
Puoi modificare o eliminare facilmente i campi personalizzati che crei.
Per modificare un campo personalizzato:
1. Fai clic sull’icona di modifica del campo personalizzato.
Si apre la finestra Modifica campo.
2. Aggiorna il campo personalizzato. Poi fai clic su Applica
Per eliminare un campo personalizzato:
1. Fai clic sull’icona di eliminazione del campo personalizzato.
Appare una finestra di conferma.
2. Fai clic su Elimina.
Il campo e i suoi dati verranno rimossi da tutte le pagine/moduli associati.
