Benutzerdefinierte Felder

Sie können benutzerdefinierte Felder (zusätzliche Datenfelder) in Ihrer gesamten Atera-Plattform erstellen. Sie können in Ticket-, Kunden-, Kontakt-, Vertrags-, SLA-, Agent-, SNMP-, TCP-, HTTP- und generischen Formularen/Seiten erscheinen. Sie können auch skriptbasierte benutzerdefinierte Felder erstellen. Sobald Sie ein benutzerdefiniertes Feld hinzugefügt haben, wird es immer angezeigt (sofern es nicht bearbeitet oder gelöscht wird).

Sie können benutzerdefinierte Felder (zusätzliche Datenfelder) in Ihrer gesamten Atera-Plattform erstellen. Sie können in Ticket-, Standort-, Benutzer-, SLA-, Agent-, SNMP-, TCP-, HTTP- und generischen Formularen/Seiten erscheinen. Sie können auch skriptbasierte benutzerdefinierte Felder erstellen. Sobald Sie ein benutzerdefiniertes Feld hinzugefügt haben, wird es immer angezeigt (sofern es nicht bearbeitet oder gelöscht wird).

Positionen benutzerdefinierter Felder

Fügen Sie benutzerdefinierte Felder zu Tickets, Standorten, Benutzern, Agenten und Geräten hinzu.

Fügen Sie benutzerdefinierte Felder zu Tickets, Kunden, Kontakten, Verträgen, SLAs, Agenten und Geräten hinzu.

Hinweis: Für ticketbezogene benutzerdefinierte Felder können Sie festlegen, ob das Feld für Benutzer im Service-Portal sichtbar und bearbeitbar ist.

Hinweis: Für ticketbezogene benutzerdefinierte Felder können Sie festlegen, ob das Feld für Kontakte im Kundenportal sichtbar und bearbeitbar ist.

Typen benutzerdefinierter Felder

Text: Geben Sie einen Text ein.
Zahl: Geben Sie einen numerischen Wert ein.
Datum: Verwenden Sie einen Kalender-Datumswähler (Format: mm/tt/jjjj).
Kontrollkästchen: Aktivieren Sie ein Kontrollkästchen mit einer Option.
Dropdown: Wählen Sie aus einer Liste von Optionen.
- Hinweis: Jeder Eingabewert ist auf 100 Zeichen begrenzt.
Dropdown mit Abhängigkeiten: Verwenden Sie eine bedingte Dropdown-Liste basierend auf vorherigen Auswahlen.
- Hinweis: Jeder Eingabewert ist auf 100 Zeichen begrenzt.
Skriptbasiert (nur für Agenten)
- Text: Texteingabe, gesteuert durch Skripte.
- Zahl: Zahleneingabe, gesteuert durch Skripte.

Hinweis: Benutzerdefinierte Felder unterstützen HREF-Links, sodass Sie direkt auf externe Dokumente, Dashboards oder andere relevante Online-Ressourcen verlinken können. Das macht sie noch vielseitiger und nützlicher im Arbeitsalltag.

Sichtbarkeitsgrenzen für analytische Berichte

Obwohl Sie unbegrenzt viele benutzerdefinierte Felder erstellen können, können Sie in analytischen Berichten nur bis zu 60 textbasierte benutzerdefinierte Felder anzeigen, sowie zusätzlich:

30 Dropdown-Felder (ohne Abhängigkeiten)
50 Kontrollkästchen-Felder (Boolean)
20 benutzerdefinierte Felder eines anderen Typs

Wenn Sie diese Grenzen überschreiten, zeigen analytische Berichte nur die zuerst erstellten Felder bis zur jeweiligen Grenze pro Typ an. Mit anderen Worten: Zusätzliche Felder werden nicht angezeigt.

Benutzerdefiniertes Feld hinzufügen

So fügen Sie ein benutzerdefiniertes Feld hinzu:

1. Gehen Sie zu Admin > Datenverwaltung > Benutzerdefinierte Felder.

Admin > Data management > Custom Fields - EN.jpeg

Die Seite Benutzerdefinierte Felder wird angezeigt.

Custom fields page - MSP - EN.jpeg

2. Wählen Sie einen Tab aus, um ein neues benutzerdefiniertes Feld hinzuzufügen.

3. Klicken Sie auf Feld hinzufügen.

Der Bildschirm Feld hinzufügen erscheint.

Add field window - MSP - EN.jpeg

4. Füllen Sie die Felder aus:

Ziel: Das Ziel ist bereits standardmäßig ausgewählt (basierend auf dem von Ihnen gewählten Tab).
Typ: Wählen Sie den Feldtyp aus.
Titel: Geben Sie den Feldtitel ein.
Betriebssystemtyp: Wählen Sie Windows oder Mac.
- Nur für agentenbezogene benutzerdefinierte Felder verfügbar.
Ausgabetyp: Wählen Sie Text oder Zahl.
- Nur für agentenbezogene benutzerdefinierte Felder verfügbar.
Untertitel: Geben Sie den Untertitel des Feldes ein.
- Verfügbar für Dropdown-Felder mit Abhängigkeiten.
Pflichtfeld: Legen Sie fest, ob das Feld "Pflichtfeld" oder "Kein Pflichtfeld" ist.
- Nicht verfügbar für agentenbezogene benutzerdefinierte Felder.
Service-Portal-Konfigurationen: Entscheiden Sie, ob Benutzer das Feld im Service-Portal bearbeiten können oder es ausgeblendet wird.
- Nur für ticketbezogene benutzerdefinierte Felder verfügbar.
Kundenportal-Konfigurationen: Entscheiden Sie, ob Kontakte das Feld im Kundenportal bearbeiten können oder es ausgeblendet wird.
- Nur für ticketbezogene benutzerdefinierte Felder verfügbar.
Werte: Klicken Sie auf das Plus-Symbol, um einen neuen Wert hinzuzufügen. Geben Sie dann den Wert ein.
- Verfügbar für Dropdown- und Dropdown-mit-Abhängigkeiten-Felder.
Untergeordnete Werte: Klicken Sie auf das Plus-Symbol, um einen neuen untergeordneten Wert hinzuzufügen. Geben Sie dann den Wert ein.
- Verfügbar für Dropdown-mit-Abhängigkeiten-Felder.

5. Klicken Sie auf Hinzufügen.

Das neue benutzerdefinierte Feld wird hinzugefügt und erscheint im Formular/auf der Seite.

Hinweis: Es gibt eine Begrenzung von 50 Zeichen für die Felder Titel und Untertitel. Einzelne Eingabewerte für Dropdowns sind zudem auf 100 Zeichen begrenzt.

Eigene Ticket-Status erstellen

Während benutzerdefinierte Felder bearbeitbar sind, sind die meisten Standardfelder von Atera nicht bearbeitbar. Eine Ausnahme bildet das Ticketfeld "Status", bei dem Sie zusätzliche Werte hinzufügen können, die in all Ihren Atera-Tickets erscheinen. Weitere Informationen finden Sie unter Eigener Ticket-Status

Skriptbasierte benutzerdefinierte Felder

Skriptbasierte benutzerdefinierte Felder von Atera ermöglichen dynamische Dateneingaben, sodass Sie beliebige Werte überwachen und so die Funktionalität und Flexibilität erhöhen können.

Hinweis:

Verfügbar für Atera Enterprise-Nutzer mit Admin-Berechtigungen.
Verfügbar für Atera Superpower-Nutzer mit Admin-Berechtigungen.
Skriptbasierte benutzerdefinierte Felder sind kompatibel mit Windows PowerShell (.ps1) und macOS Shell (.sh) Skripten ohne Variablen – achten Sie lediglich darauf, dass der Skripttyp zum Betriebssystem passt.
Für skriptbasierte benutzerdefinierte Felder gibt es keine Zeichenbegrenzung.
Skriptbasierte benutzerdefinierte Felder werden alle 12 Stunden aktualisiert oder immer dann, wenn Sie die Agent-Konsole aufrufen.

So fügen Sie ein skriptbasiertes benutzerdefiniertes Feld hinzu:

1. Gehen Sie zu Admin > Datenverwaltung > Benutzerdefinierte Felder.

Admin > Data mgmt > Custom fields.jpeg

Die Seite Benutzerdefinierte Felder wird angezeigt.

Agents tab > Add field - EN.jpeg

2. Wählen Sie den Tab Agent aus. Klicken Sie dann auf Feld hinzufügen.

Der Bildschirm Feld hinzufügen erscheint.

Add field window > Select script-based - EN.jpeg

3. Füllen Sie das Formular Feld hinzufügen aus:

Ziel: Wählen Sie Agent aus.
Typ: Wählen Sie Skriptbasiert.
Betriebssystemtyp: Wählen Sie Windows oder Mac aus.
Ausgabetyp: Wählen Sie Text oder Zahl aus.
Titel: Geben Sie einen Feldtitel ein.
Überwachungsskript: Wählen Sie das Skript aus (Sie können Skripte erstellen oder hochladen – oder eines aus der Geteilten Skriptbibliothek in Ihren Tab Meine Skripte klonen).

4. Klicken Sie auf Hinzufügen.

Das skriptbasierte benutzerdefinierte Feld erscheint.

Script-based field added - EN - ITD.jpeg

Die Ausgaben dieser Skripte füllen die von Ihnen eingerichteten benutzerdefinierten Felder und machen die Daten direkt in Ihren Agenten verfügbar (unter dem Tab Benutzerdefinierte Felder).

Script-based custom fields > Agent Console.jpeg

Häufig verwendete skriptbasierte benutzerdefinierte Felder

Nachfolgend finden Sie häufig verwendete skriptbasierte benutzerdefinierte Felder. Wie Sie ein Skript zu Atera hochladen, erfahren Sie in diesem Artikel:

Skripte erstellen, hochladen und generieren

TPM prüfen

Dieses Skript prüft, ob das Trusted Platform Module (TPM) auf einem Gerät vorhanden und aktiviert ist. TPM ist eine Hardwarekomponente, die zur Absicherung von Hardware durch integrierte kryptografische Schlüssel verwendet wird.

Skripterklärung:

Das Skript fragt den TPM-Status über den Windows Management Instrumentation (WMI)-Dienst ab.
Wenn kein TPM gefunden wird, gibt das Skript "Deaktiviert" aus.
Wenn TPM gefunden und aktiviert ist, gibt das Skript "Aktiviert" aus.
Wenn TPM gefunden, aber nicht aktiviert ist, gibt das Skript ebenfalls "TPM gefunden, nicht aktiviert" aus.

Achten Sie beim Hochladen des Skripts darauf, dass es mit "System"-Rechten ausgeführt wird. Außerdem sollte beim Erstellen des skriptbasierten benutzerdefinierten Feldes der "Ausgabetyp" auf "Text" gesetzt werden.

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

Gehäusetyp

Dieses Skript ermittelt, ob ein Gerät ein Laptop oder ein Desktop ist, basierend auf dem Gehäusetyp. Der Gehäusetyp ist eine Hardwareklassifizierung, die die physische Form des Geräts angibt.

Skripterklärung:

Das Skript ruft den Gehäusetyp über WMI ab.
Es prüft, ob der Gehäusetyp einem der Werte entspricht, die typischerweise auf einen Laptop hinweisen (z. B. Gehäusetypen 9, 10, 14, 30 oder 31).
Wenn eine Übereinstimmung gefunden wird, gibt das Skript "Laptop" aus.
Wenn keine Übereinstimmung gefunden wird, gibt das Skript "Desktop" aus.

Stellen Sie bei der Konfiguration des Skripts in Atera sicher, dass es als "System" ausgeführt wird und der "Ausgabetyp" auf "Text" gesetzt ist.

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

Installationsdatum des Betriebssystems

Dieses Skript ruft das Installationsdatum des Windows-Betriebssystems auf einem Gerät ab. Das Wissen über das Installationsdatum des Betriebssystems kann dabei helfen, das Alter des Systems einzuschätzen und Upgrades oder Wartungen zu planen.

Skripterklärung:

Das Skript fragt das Installationsdatum über WMI vom Betriebssystem ab.
Es wandelt das Installationsdatum in ein lesbares Format (TT/MM/JJJJ) um.
Das formatierte Datum wird anschließend als Zeichenkette ausgegeben.

Führen Sie das Skript mit der Option "System" aus und wählen Sie beim Erstellen des skriptbasierten benutzerdefinierten Felds den "Ausgabetyp" "Text".

# PowerShell-Skript, um das Installationsdatum des Betriebssystems im TT/MM/JJJJ-Format zu erhalten

# Installationsdatum des Betriebssystems aus der Registry abrufen
$osInstallDate = (Get-WmiObject -Class Win32_OperatingSystem).InstallDate

# Datum ins TT/MM/JJJJ-Format umwandeln
$formattedDate = [Management.ManagementDateTimeConverter]::ToDateTime($osInstallDate)

# Datum im TT/MM/JJJJ-Format anzeigen
$formattedDate.ToString('dd/MM/yyyy')

Aktueller Benutzer

Dieses Skript ermittelt den aktuell angemeldeten Benutzer und prüft, ob dieser über Administratorrechte verfügt. Diese Information ist wichtig für die Sicherheitsüberwachung und um sicherzustellen, dass Benutzer die passenden Zugriffsrechte haben.

Skripterklärung:

Das Skript ruft den Benutzernamen des aktuell angemeldeten Benutzers ab.
Es prüft, ob der Benutzer Administratorrechte besitzt.
Das Skript gibt dann den Benutzernamen gefolgt von seiner Rolle aus, entweder "Admin" oder "User".

Stellen Sie sicher, dass das Skript als "Aktueller Benutzer" in Atera ausgeführt wird, und wählen Sie beim Erstellen des skriptbasierten benutzerdefinierten Felds den "Ausgabetyp" "Text".

# Aktuellen Benutzernamen abrufen
$currentUserName = [Environment]::UserName

# Prüfen, ob der aktuelle Benutzer ein Admin ist
$isAdmin = (New-Object Security.Principal.WindowsPrincipal([Security.Principal.WindowsIdentity]::GetCurrent())).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)

# Wenn der Benutzer ein Admin ist, Rolle auf 'Admin' setzen, sonst auf 'User'
if ($isAdmin) {
$role = 'Admin'
} else {
$role = 'User'
}

# Benutzernamen und Rolle ausgeben
Write-Output "$currentUserName - $role"

Betriebszeit

Dieses Skript berechnet und zeigt an, wie lange ein Gerät seit dem letzten Neustart in Betrieb ist. Die Überwachung der Betriebszeit kann hilfreich sein, um die Systemstabilität zu kontrollieren und sicherzustellen, dass Geräte regelmäßig neu gestartet werden.

Skripterklärung:

Das Skript berechnet die Zeitdifferenz zwischen dem aktuellen Datum/Uhrzeit und dem letzten Systemstart des Geräts mithilfe von WMI.
Anschließend wird diese Betriebszeit als Zeichenkette formatiert, die die Anzahl der Tage, Stunden und Minuten angibt, die das Gerät in Betrieb ist.
Die formatierte Betriebszeit wird dann als Zeichenkette ausgegeben, im Format "X Tage Y Stunden Z Minuten", wobei X, Y und Z die jeweiligen Zeitspannen darstellen.

Stellen Sie bei der Konfiguration dieses Skripts sicher, dass es mit "System"-Rechten ausgeführt wird, und wählen Sie beim Erstellen des skriptbasierten benutzerdefinierten Felds den "Ausgabetyp" "Text".

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