> ## Documentation Index
> Fetch the complete documentation index at: https://www.docusnap.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Datenmodell

> Wie ein Typ aufgebaut ist, wie eine Feldbeschriftung auf eine Eigenschaft im Schema zeigt und welche Typen ausgeliefert werden.

Jedes Asset in Docusnap365 hat einen Typ, und der Typ bestimmt, welche Daten es
tragen kann und wie sie gegliedert sind. Ausgeliefert werden 98 Typen; dazu
kommen die Typen und Felder, die Sie selbst anlegen. Das Schema hinter der
Oberfläche folgt vier Definitionen je Typ — was davon in der Oberfläche
sichtbar ist, steht unter [Was erfasst wird](/docs/de/assets/systems).

## Woraus ein Typ besteht

Ein Typ besteht aus vier Definitionen nebeneinander:

| Definition | Was darin steht |
| - | - |
| `registry` | Beschriftung in beiden Sprachen, Symbol und Segmentschlüssel |
| `dataDefinition` | die Eigenschaften des Typs mit Datentyp und, wo einer gilt, Format |
| `viewDefinition` | die Gliederung der Detailseite: Gruppe › Bereich › Abschnitt › Feld |
| `enumDefinition` | die benannten Wertelisten, auf die einzelne Felder verweisen |

Die `viewDefinition` führen 73 der 98 Typen. Die übrigen haben keine gegliederte
Ansicht — sie tragen Daten, aber keine eigene Detailseite; *Software*,
*Softwareprodukt* und die sieben Integrationstypen sind solche Fälle.

## Kennung und Vererbung

Jeder Typ trägt eine Kennung aus Präfix und Namen: `typedef::windows`,
`typedef::proxmoxLxc`, `typedef::integrationSftp`. Sie ist stabil und
sprachunabhängig; die Beschriftung ist es nicht.

Darunter liegt eine zweite Ebene. Jeder ausgelieferte Typ setzt auf einer
Basisdefinition desselben Namens auf — `typedef::windows` auf `basedef::windows`
—, und jede Basisdefinition geht ihrerseits auf `basedef::object` zurück. Der
Export umfasst die ausgelieferte Ebene; die Basisdefinitionen selbst
stehen nicht darin.

## Von der Beschriftung zum Feld

Ein Feld der Detailseite trägt seine Beschriftung in beiden Sprachen und daneben
die Eigenschaft, aus der sein Wert kommt. Das ist der Weg von dem, was jemand
sieht, zu dem, was Sie abfragen:

| Ebene | Beispiel Windows |
| - | - |
| Gruppe | *Konfiguration* |
| Bereich | *Übersicht* |
| Abschnitt | *Betriebssystem & Identität* |
| Feld | *Vollqualifizierter Hostname* |
| Eigenschaft | `fqdn` |

Ein Feld nennt außerdem, wie sein Wert zu lesen ist — als Text, Ganzzahl,
Dezimalzahl, Ja/Nein-Wert, Zeitpunkt, Datenmenge, Dauer, Frequenz oder
Netzwerkgeschwindigkeit. Zeigt es auf eine Werteliste, steht deren Name daneben:
*Lizenzstatus* führt die Eigenschaft `licenseStatus` und die Liste
`LicenseStatus`.

Felder können ab Werk ausgeblendet sein. Sie stehen dann in der Definition, aber
nicht in der Ansicht — *Aktiver Benutzer* am Typ *Windows* ist ein solches Feld.
Ein- und ausblenden lassen sie sich unter
[Datenmodell anpassen](/docs/de/settings/data-model).

## Wertelisten

Jeder Typ führt die Wertelisten, auf die seine Felder zeigen, selbst; über alle
Typen hinweg sind es 241 verschiedene. Jeder Eintrag trägt drei Angaben: einen
Schlüssel, einen technischen Namen und die Beschriftung in beiden Sprachen.

Beispiel für die Integrationstypen:

| Schlüssel | Name | Beschriftung |
| - | - | - |
| `-1` | `Unset` | *Nicht gesetzt* |
| `0` | `CSV` | *CSV* |
| `1` | `JSON` | *JSON* |
| `2` | `XML` | *XML* |
| `4` | `SOAP` | *SOAP* |
| `5` | `EDIFACT` | *EDIFACT* |
| `6` | `SqlDump` | *SQL-Dump* |
| `7` | `Other` | *Andere* |

<Note>
  Die Schlüssel sind nicht lückenlos — im Beispiel fehlt die `3`. Verlassen Sie
  sich auf den Schlüssel, nicht auf die Position in der Liste.
</Note>

## Die Feldebene

Die 73 Ansichten führen zusammen rund 11 100 Felder. Welche Felder ein Typ
trägt, zeigt die Oberfläche selbst unter Verwaltung › *Datenmodell* › *Typen
und Felder* im Tab *Felder* — dort in einer Liste, in der Standardfelder und
eigene Felder nebeneinander stehen.

Eigene Felder ändern den ausgelieferten Typ nicht. Sie liegen als
Typerweiterung daneben: Löschen Sie die Erweiterung, gehen die eigenen Felder
verloren, der Typ bleibt — siehe
[Datenmodell anpassen](/docs/de/settings/data-model).

## Technische Namen eigener Felder

Wie bei den ausgelieferten Typen zeigt auch bei einem eigenen Feld die
Beschriftung auf einen technischen Namen. Docusnap365 bildet ihn beim Anlegen
aus dem *Anzeigename (Deutsch)*:

* Alle Buchstaben werden klein geschrieben, Umlaute umgeschrieben (ä → ae,
  ö → oe, ü → ue, ß → ss).
* Alle übrigen Zeichen trennen Wörter; am Anfang und am Ende entfallen sie.
* Die Wörter werden mit Binnenmajuskeln zusammengezogen.
* Vorangestellt wird der Präfix Ihrer Subscription: sechs Kleinbuchstaben oder
  Ziffern, das erste Zeichen aus `a` bis `f`.

Aus „Anzahl Kerne“ wird so `anzahlKerne` und mit Präfix etwa
`f71378AnzahlKerne`. Der Präfix trennt eigene Felder von den Eigenschaften der
ausgelieferten Typen: Ein eigenes Feld „Name“ fällt dadurch nicht mit dem
Namen des Assets zusammen.

Ergibt die Ableitung einen technischen Namen, der bereits vergeben ist, hängt
Docusnap365 ohne Meldung eine Zahl an (`f71378AnzahlKerne2`). Beim Anlegen
geprüft wird nur der Anzeigename. Die Oberfläche zeigt den technischen Namen
nirgends an.

## Zahlenfelder

Für Zahlen kennt ein eigenes Feld zwei Feldtypen. *Zahl* nimmt Zahlen mit
Nachkommastellen auf, *Ganzzahl* nur ganze Zahlen. *Ganzzahl* tragen die Felder,
die vor dem 18.09.2026 als Zahlenfeld angelegt wurden; für ein neues Feld lässt
sich dieser Feldtyp nicht wählen. In der Liste im Tab *Felder* heißen beide
*Zahl* — unterscheiden lassen sie sich nur im Dialog *Feld bearbeiten*.

## Die ausgelieferten Typen

Über die Kennung wird ein Typ angesprochen: Sie bleibt stabil, die
Beschriftung kann sich ändern.

| Beschriftung | Kennung |
| - | - |
| *(S)FTP* | `typedef::integrationSftp` |
| *Abteilung* | `typedef::department` |
| *Access Point* | `typedef::accessPoint` |
| *Active Directory* | `typedef::activeDirectory` |
| *Active Directory Benutzer* | `typedef::activeDirectoryUser` |
| *Active Directory Gruppe* | `typedef::activeDirectoryGroup` |
| *Android-Gerät* | `typedef::androidDevice` |
| *Applikation* | `typedef::app` |
| *Benutzer* | `typedef::user` |
| *Business-Service* | `typedef::businessService` |
| *Chassis* | `typedef::chassis` |
| *CRM* | `typedef::crm` |
| *DFS-Domäne* | `typedef::dfsDomain` |
| *DFS-Standalone* | `typedef::dfsStandalone` |
| *DHCP* | `typedef::dhcp` |
| *DNS* | `typedef::dns` |
| *Drucker* | `typedef::printer` |
| *E-Mail* | `typedef::integrationEmail` |
| *Entra ID* | `typedef::entraId` |
| *Entra-ID-Benutzer* | `typedef::entraIdUser` |
| *Entra-ID-Gerät* | `typedef::entraIdDevice` |
| *Entra-ID-Gruppe* | `typedef::entraIdGroup` |
| *Entra-ID-Kontakt* | `typedef::entraIdContact` |
| *Exchange Online* | `typedef::exchangeOnline` |
| *Filer* | `typedef::filer` |
| *Firewall* | `typedef::firewall` |
| *Generisch* | `typedef::generic` |
| *Hyper-V-Server* | `typedef::hypervServer` |
| *Hyper-V-Switch* | `typedef::hypervSwitch` |
| *Hyper-V-VM* | `typedef::hypervVm` |
| *iLO* | `typedef::ilo` |
| *Information* | `typedef::information` |
| *Intune* | `typedef::intune` |
| *Intune-Gerät* | `typedef::intuneDevice` |
| *IP-Telefon* | `typedef::voIP` |
| *iPad* | `typedef::iPad` |
| *iPhone* | `typedef::iPhone` |
| *Kamera* | `typedef::camera` |
| *Linux* | `typedef::linux` |
| *Load Balancer* | `typedef::loadBalancer` |
| *macOS* | `typedef::macOS` |
| *MariaDB-Datenbank* | `typedef::mariaDbDatabase` |
| *MariaDB-Server* | `typedef::mariaDbServer` |
| *Meraki* | `typedef::meraki` |
| *Microsoft 365* | `typedef::m365` |
| *Microsoft Identity* | `typedef::microsoftIdentity` |
| *Microsoft Teams* | `typedef::teams` |
| *Monitor* | `typedef::monitor` |
| *MySQL-Datenbank* | `typedef::mySqlDatabase` |
| *MySQL-Server* | `typedef::mySqlServer` |
| *Network System* | `typedef::networkSystem` |
| *Network System Topology* | `typedef::networkSystemTopology` |
| *Network System Topology V Switch* | `typedef::networkSystemTopologyVSwitch` |
| *NFS* | `typedef::integrationNfs` |
| *NTFS-Server* | `typedef::ntfsServer` |
| *Nutanix* | `typedef::nutanixCluster` |
| *Nutanix-Host* | `typedef::nutanixHost` |
| *Nutanix-Virtual-Switch* | `typedef::nutanixVirtualSwitch` |
| *Nutanix-VM* | `typedef::nutanixVM` |
| *OneDrive* | `typedef::oneDrive` |
| *Oracle* | `typedef::oracle` |
| *Person* | `typedef::person` |
| *Proxmox* | `typedef::proxmoxCluster` |
| *Proxmox Bridge* | `typedef::proxmoxBridge` |
| *Proxmox Linux Container* | `typedef::proxmoxLxc` |
| *Proxmox Node* | `typedef::proxmoxNode` |
| *Proxmox VM* | `typedef::proxmoxQemu` |
| *Prozess* | `typedef::process` |
| *REST API* | `typedef::integrationRestApi` |
| *Router* | `typedef::router` |
| *Samsung* | `typedef::samsung` |
| *Samsung Galaxy Tab* | `typedef::samsungGalaxyTab` |
| *SharePoint Online* | `typedef::sharepointOnline` |
| *SMB* | `typedef::integrationSmb` |
| *Software* | `typedef::software` |
| *Softwareprodukt* | `typedef::softwareProduct` |
| *SQL* | `typedef::integrationSql` |
| *SQL Server-Datenbank* | `typedef::msSqlDatabase` |
| *SQL Server-Instanz* | `typedef::msSqlServer` |
| *Storage Hardware* | `typedef::storageHardware` |
| *Storage Volume* | `typedef::storageVolume` |
| *Switch* | `typedef::switch` |
| *Tape* | `typedef::tape` |
| *Unbekannt* | `typedef::unTyped` |
| *Upload* | `typedef::integrationUpload` |
| *USV* | `typedef::ups` |
| *Veeam* | `typedef::veeam` |
| *VMware* | `typedef::vmware` |
| *VMware Distributed vSwitch* | `typedef::vmwareDVSwitch` |
| *VMware Host* | `typedef::vmwareHost` |
| *VMware VM* | `typedef::vmwareVm` |
| *VMware vSwitch* | `typedef::vmwareVSwitch` |
| *Windows* | `typedef::windows` |
| *Windows Surface* | `typedef::windowsSurface` |
| *XenServer* | `typedef::xenServer` |
| *XenServer Host* | `typedef::xenServerHost` |
| *XenServer Network* | `typedef::xenServerNetwork` |
| *XenServer VM* | `typedef::xenServerVm` |

## Weiterführend

Welche Daten die einzelnen Scans in diese Typen schreiben, steht unter
[Was erfasst wird](/docs/de/assets/systems). Wie Sie das Modell um eigene Typen und
Felder erweitern, unter [Datenmodell anpassen](/docs/de/settings/data-model).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.