Vous pouvez créer des champs personnalisés (champs de données supplémentaires) sur l’ensemble de votre plateforme Atera. Ils peuvent apparaître dans les formulaires/pages Ticket, Client, Contact, Contrat, SLA, Agent, SNMP, TCP, HTTP et Générique. Vous pouvez également créer des champs personnalisés basés sur des scripts. Une fois ajouté, un champ personnalisé apparaîtra toujours (sauf si vous le modifiez ou le supprimez).

Vous pouvez créer des champs personnalisés (champs de données supplémentaires) sur l’ensemble de votre plateforme Atera. Ils peuvent apparaître dans les formulaires/pages Ticket, Site, Utilisateur, SLA, Agent, SNMP, TCP, HTTP et Générique. Vous pouvez également créer des champs personnalisés basés sur des scripts. Une fois ajouté, un champ personnalisé apparaîtra toujours (sauf si vous le modifiez ou le supprimez).

Emplacements des champs personnalisés

Ajoutez des champs personnalisés aux tickets, sites, utilisateurs, agents et appareils.

Ajoutez des champs personnalisés aux tickets, clients, contacts, contrats, SLA, agents et appareils.

Remarque : Pour les champs personnalisés liés aux tickets, vous pouvez choisir si le champ est visible et modifiable par les utilisateurs dans le Portail de service.

Remarque : Pour les champs personnalisés liés aux tickets, vous pouvez choisir si le champ est visible et modifiable par les contacts dans le Portail client.

Types de champs personnalisés

• Texte : Saisissez une entrée textuelle.
• Nombre : Saisissez une valeur numérique.
• Date : Utilisez un sélecteur de date (format : mm/jj/aaaa).
• Case à cocher : Cochez une case à option unique.
• Liste déroulante : Choisissez parmi une liste d’options.
  • Remarque : Chaque valeur saisie est limitée à 100 caractères.
• Liste déroulante avec dépendances : Utilisez une liste déroulante conditionnelle basée sur les sélections précédentes.
  • Remarque : Chaque valeur saisie est limitée à 100 caractères.
• Basé sur un script (agent uniquement)
  • Texte : Entrée textuelle générée par des scripts.
  • Nombre : Entrée numérique générée par des scripts.

Remarque : Les champs personnalisés prennent en charge les liens HREF, ce qui vous permet de lier directement des documents externes, des tableaux de bord ou d’autres ressources en ligne pertinentes, les rendant ainsi encore plus polyvalents et utiles au quotidien.

Limites de visibilité dans les rapports analytiques

Bien que vous puissiez créer un nombre illimité de champs personnalisés, vous ne pourrez afficher que jusqu’à 60 champs personnalisés de type texte dans les rapports analytiques, ainsi que :

• 30 champs personnalisés de type liste déroulante (sans dépendances)
• 50 champs personnalisés de type case à cocher (booléen)
• 20 champs personnalisés de tout autre type

Si vous dépassez ces limites, les rapports analytiques n’afficheront que les premiers champs créés jusqu’à la limite par type. En d’autres termes, les champs supplémentaires ne seront pas affichés.

Ajouter un champ personnalisé

Pour ajouter un champ personnalisé :

1. Allez dans Admin > Gestion des données > Champs personnalisés.

La page Champs personnalisés s’affiche.

2. Sélectionnez un onglet pour ajouter un nouveau champ personnalisé.

3. Cliquez sur Ajouter un champ.

L’écran Ajouter un champ s’affiche.

4. Remplissez les champs :

• Cible : La cible est déjà sélectionnée par défaut (en fonction de l’onglet choisi).
• Type : Sélectionnez le type de champ.
• Titre : Saisissez le titre du champ.
• Type d’OS : Sélectionnez Windows ou Mac.
  • Disponible uniquement pour les champs personnalisés d’agent.
• Type de sortie : Sélectionnez Texte ou Nombre.
  • Disponible uniquement pour les champs personnalisés d’agent.
• Sous-titre : Saisissez le sous-titre du champ.
  • Disponible pour les champs personnalisés de type liste déroulante avec dépendances.
• Champ obligatoire : Définissez le champ comme « Obligatoire » ou « Non obligatoire »
  • Non disponible pour les champs personnalisés d’agent.
• Paramètres du Portail de service : Décidez si les utilisateurs peuvent modifier le champ dans le Portail de service ou le masquer.
  • Disponible uniquement pour les champs personnalisés de ticket.
• Paramètres du Portail client : Décidez si les contacts peuvent modifier le champ dans le Portail client ou le masquer.
  • Disponible uniquement pour les champs personnalisés de ticket.
• Valeurs : Cliquez sur l’icône plus pour ajouter une nouvelle valeur. Saisissez ensuite la valeur.
  • Disponible pour les champs personnalisés de type liste déroulante et liste déroulante avec dépendances.
• Valeurs enfants : Cliquez sur l’icône plus pour ajouter une nouvelle valeur enfant. Saisissez ensuite la valeur.
  • Disponible pour les champs personnalisés de type liste déroulante avec dépendances.

5. Cliquez sur Ajouter.

Le nouveau champ personnalisé est ajouté et apparaîtra sur le formulaire/la page.

Remarque : Il y a une limite de 50 caractères pour les champs Titre et Sous-titre. De plus, chaque valeur saisie dans une liste déroulante est limitée à 100 caractères.

Créer des statuts de ticket personnalisés

Bien que les champs personnalisés soient modifiables, la plupart des champs par défaut d’Atera ne le sont pas. L’exception concerne le champ « Statut » du ticket, où vous pouvez ajouter des valeurs supplémentaires qui apparaîtront dans tous vos tickets Atera. Pour plus de détails, consultez Statut de ticket personnalisé

Champs personnalisés basés sur des scripts

Les champs personnalisés basés sur des scripts d’Atera permettent une saisie dynamique des données, vous permettant de surveiller n’importe quelle valeur pour plus de fonctionnalités et de flexibilité.

Remarque :

• Disponible pour les utilisateurs Atera Enterprise disposant des droits d’Admin.
• Disponible pour les utilisateurs Atera Superpower disposant des droits d’Admin.
• Les champs personnalisés basés sur des scripts sont compatibles avec les scripts Windows PowerShell (.ps1) et macOS Shell (.sh) sans variables — assurez-vous simplement que le type de script correspond à l’OS.
• Il n’y a pas de limite de caractères pour les champs personnalisés basés sur des scripts.
• Les champs personnalisés basés sur des scripts sont mis à jour toutes les 12 heures, ou à chaque accès à la Console Agent.

Pour ajouter un champ personnalisé basé sur un script :

1. Allez dans Admin > Gestion des données > Champs personnalisés.

La page Champs personnalisés s’affiche.

2. Sélectionnez l’onglet Agent. Puis cliquez sur Ajouter un champ.

L’écran Ajouter un champ s’affiche.

3. Remplissez le formulaire Ajouter un champ :

• Cible : Sélectionnez Agent.
• Type : Sélectionnez Basé sur un script. 
• Type d’OS : Sélectionnez Windows ou Mac.
• Type de sortie : Sélectionnez Texte ou Nombre.
• Titre : Saisissez un titre de champ.
• Script de surveillance : Sélectionnez le script (vous pouvez créer ou générer des scripts — ou en cloner un depuis la Bibliothèque de scripts partagés vers votre onglet Mes scripts).

4. Cliquez sur Ajouter.

Le champ personnalisé basé sur un script apparaît.

La sortie de ces scripts alimente les champs personnalisés que vous avez configurés, rendant les données disponibles directement dans vos agents (sous l’onglet Champs personnalisés).

Champs personnalisés basés sur des scripts couramment utilisés

Vous trouverez ci-dessous des exemples de champs personnalisés basés sur des scripts fréquemment utilisés. Pour savoir comment importer un script dans Atera, veuillez consulter cet article :

• Créer, importer et générer des scripts

Vérifier le TPM

Ce script vérifie si le Trusted Platform Module (TPM) est présent et activé sur un appareil. Le TPM est un composant matériel utilisé pour sécuriser le matériel via des clés cryptographiques intégrées.

Explication du script :

• Le script interroge le statut du TPM via le service Windows Management Instrumentation (WMI).
• Si aucun TPM n’est trouvé, le script affichera « Désactivé ».
• Si un TPM est trouvé et activé, le script affichera « Activé ».
• Si un TPM est trouvé mais n’est pas activé, le script affichera également « TPM trouvé, non activé ».

Lors de l’import du script, assurez-vous qu’il s’exécute avec les privilèges « Système ». De plus, lors de la création du champ personnalisé basé sur un script, définissez le « Type de sortie » sur « Texte ».

# 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"
}
}

Type de châssis

Ce script détermine si un appareil est un ordinateur portable ou de bureau en fonction de son type de châssis. Le type de châssis est une classification matérielle qui identifie la forme physique de l’appareil.

Explication du script :

• Le script récupère le type de châssis via WMI.
• Il vérifie si le type de châssis correspond à l’une des valeurs indiquant généralement un ordinateur portable (par exemple, les types 9, 10, 14, 30 ou 31).
• Si une correspondance est trouvée, le script affichera « Portable ».
• Si aucune correspondance n’est trouvée, le script affichera « Bureau ».

Lors de la configuration du script dans Atera, assurez-vous qu’il s’exécute en tant que « Système » et que le « Type de sortie » est défini sur « Texte ».

# 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"
}

Date d’installation de l’OS

Ce script récupère la date d'installation du système d'exploitation Windows sur un appareil. Connaître la date d'installation de l'OS peut aider à évaluer l'ancienneté du système et à planifier les mises à niveau ou la maintenance.

Explication du script :

• Le script interroge la date d'installation auprès du système d'exploitation via WMI.
• Il convertit la date d'installation dans un format plus lisible (JJ/MM/AAAA).
• La date formatée est ensuite affichée sous forme de chaîne de caractères.

Exécutez le script en utilisant l'option "Système", et lors de la création du champ personnalisé basé sur le script, définissez le "Type de sortie" sur "Texte".

# Script PowerShell pour obtenir la date d'installation de l'OS au format JJ/MM/AAAA

# Récupérer la date d'installation de l'OS depuis le registre
$osInstallDate = (Get-WmiObject -Class Win32_OperatingSystem).InstallDate

# Convertir la date au format JJ/MM/AAAA
$formattedDate = [Management.ManagementDateTimeConverter]::ToDateTime($osInstallDate)

# Afficher la date au format JJ/MM/AAAA
$formattedDate.ToString('dd/MM/yyyy')

Utilisateur actuel

Ce script identifie l'utilisateur actuellement connecté et vérifie s'il dispose des droits administrateur. Cette information est essentielle pour la surveillance de la sécurité et pour s'assurer que les utilisateurs ont le niveau d'accès approprié.

Explication du script :

• Le script récupère le nom d'utilisateur de l'utilisateur actuellement connecté.
• Il vérifie si l'utilisateur possède les droits administrateur.
• Le script affiche ensuite le nom d'utilisateur suivi de son rôle, soit "Admin" soit "Utilisateur".

Assurez-vous que le script est exécuté en tant qu’"Utilisateur actuel" dans Atera, et lors de la création du champ personnalisé basé sur le script, sélectionnez le "Type de sortie" comme "Texte".

# Récupérer le nom d'utilisateur actuel
$currentUserName = [Environment]::UserName

# Vérifier si l'utilisateur actuel est administrateur
$isAdmin = (New-Object Security.Principal.WindowsPrincipal([Security.Principal.WindowsIdentity]::GetCurrent())).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)

# Si l'utilisateur est admin, définir le rôle sur 'Admin', sinon sur 'Utilisateur'
if ($isAdmin) {
$role = 'Admin'
} else {
$role = 'Utilisateur'
}

# Afficher le nom d'utilisateur et le rôle
Write-Output "$currentUserName - $role"

Temps de fonctionnement

Ce script calcule et affiche la durée pendant laquelle un appareil est resté allumé depuis son dernier redémarrage. Suivre le temps de fonctionnement peut être utile pour surveiller la stabilité du système et s'assurer que les appareils sont redémarrés régulièrement.

Explication du script :

• Le script calcule la différence entre la date et l'heure actuelles et la dernière date de démarrage de l'appareil via WMI.
• Il formate ensuite ce temps de fonctionnement en une chaîne indiquant le nombre de jours, d'heures et de minutes pendant lesquels l'appareil a été opérationnel.
• Le temps de fonctionnement formaté est ensuite affiché sous forme de chaîne, au format "X Jours Y Heures Z Minutes" où X, Y et Z représentent les durées respectives.

Lors de la configuration de ce script, assurez-vous qu'il est exécuté avec les privilèges "Système", et définissez le "Type de sortie" sur "Texte" lors de la création du champ personnalisé basé sur le script.

$uptime = (Get-Date) - (Get-CimInstance Win32_OperatingSystem).LastBootUpTime
$formattedUptime = "{0} Jours {1} Heures {2} Minutes" -f $uptime.Days, $uptime.Hours, $uptime.Minutes
$formattedUptime

Modifier ou supprimer des champs personnalisés

Vous pouvez facilement modifier ou supprimer les champs personnalisés que vous créez.

Pour modifier un champ personnalisé :

1. Cliquez sur l'icône de modification du champ personnalisé.

La fenêtre Modifier le champ s'affiche.

2. Mettez à jour le champ personnalisé. Puis cliquez sur Appliquer

Pour supprimer un champ personnalisé :

1. Cliquez sur l'icône de suppression du champ personnalisé.

Une fenêtre de confirmation s'affiche.

2. Cliquez sur Supprimer.

Le champ et ses données sont supprimés de toutes les pages/formulaires associés.