# Custom Attributes

Mit Custom Attributes (benutzerdefinierten Attributen) kannst Du in nexcore eigene Felder anlegen, um zusätzliche Informationen zu Aufträgen, Ressourcen, Ressourcenzuweisungen oder Kunden zu speichern.

Damit lässt sich das System flexibel an individuelle Prozesse und Datenstrukturen anpassen – ohne dass eine gesonderte Entwicklung notwendig ist.

***

## Aufbau

Die Ansicht ist zweigeteilt:

<table><thead><tr><th width="215.00390625">Bereich</th><th>Beschreibung</th></tr></thead><tbody><tr><td><strong>Entities (linke Seite)</strong></td><td>Zeigt die unterstützten Entitäten, für die benutzerdefinierte Attribute angelegt werden können.</td></tr><tr><td><strong>Attribute (rechte Seite)</strong></td><td>Zeigt die vorhandenen Custom Attributes der ausgewählten Entität. Sie sind in <em>Sections</em> (Abschnitte) gegliedert, die wiederum einzelne Attribute (<em>Definitionen</em>) enthalten.</td></tr></tbody></table>

***

## Unterstützte Entitäten

Aktuell werden folgende Entities unterstützt, zu welchen Du Custom Attributes anfügen kannst:

<table><thead><tr><th width="215.00390625">Entität</th><th>Beschreibung</th></tr></thead><tbody><tr><td><strong>Auftrag</strong></td><td>Ergänze die Standardinformationen zu einem Auftrag aus nexcore mit nützlichen Informationen aus Deinem zuliefernden System. Bspw. Vertreter, Bearbeiter, etc.</td></tr><tr><td><strong>Ressource</strong></td><td>Ergänze die Standardinformationen zu einer Ressource aus nexcore mit nützlichen Informationen aus Deinem zuliefernden System. Bspw. Technische Daten, Gruppenzuordnung, etc.</td></tr><tr><td><strong>Ressourcenzuweisung</strong></td><td>Ergänze die Standardinformationen zu einer Ressourcenzuweisung aus nexcore mit nützlichen Informationen aus Deinem zuliefernden System. Bspw. Name der freimeldenden Person, Zeitpunkt der Freimeldung, etc.</td></tr><tr><td><strong>Kunde</strong></td><td>Ergänze die Standardinformationen zu einem Kunden aus nexcore mit nützlichen Informationen aus Deinem zuliefernden System. Bspw. erweiterte Kontaktdaten, etc.</td></tr></tbody></table>

***

## Sections und Attribute

Jede **Entität** besteht aus beliebig vielen **Sections**, die thematisch zusammengehörige Attribute bündeln (z. B. „Vertreter“, „Technische Daten“, „Kundendetails“).

### Section anlegen

Mit einem Klick auf den Button "+ Section anlegen" erstellst Du in der von Dir gewählten Entität einen neuen Bereich für individuelle Attribute.

In dem sich öffnenden Dialogfeld definierst Du:

<table><thead><tr><th width="197.046875">Feld</th><th>Option / Beschreibung</th></tr></thead><tbody><tr><td><strong>Externe ID (optional)</strong></td><td>Die externe ID der Section, wie Sie in dem zuliefernden System festgelegt ist.</td></tr><tr><td><strong>Name</strong></td><td>Den individuellen Namen für den Bereich.</td></tr><tr><td><strong>Index (automatisch)</strong></td><td>Wird automatisch gesetzt und kann bei Bedarf nachträglich über das Kontextmenü angepasst werden.</td></tr></tbody></table>

### Attribut (Definition) anlegen

Innerhalb einer Section werden die einzelnen **Attribute (Definitionen)** angelegt.

Hierzu klickst Du auf das **Kontextmenü (⋮)** der Section und wählst **"Definition hinzufügen"**

In dem sich öffnenden Dialogfeld definierst Du:&#x20;

<table><thead><tr><th width="197.046875">Feld</th><th>Option / Beschreibung</th></tr></thead><tbody><tr><td><strong>Externe ID (optional)</strong></td><td>Die externe ID des Custom Attributes, wie Sie in dem zuliefernden System festgelegt ist.</td></tr><tr><td><strong>Typ</strong></td><td>Den Typ des Attributes (<code>String</code>, <code>Boolean</code>, <code>Datum + Uhrzeit</code> oder <code>Nummer</code>)</td></tr><tr><td><strong>Name</strong></td><td>Anzeigename des Attributs in nexcore.</td></tr><tr><td><strong>Index</strong></td><td>Wird automatisch gesetzt und kann bei Bedarf nachträglich über das Kontextmenü angepasst werden.</td></tr><tr><td><strong>Key</strong></td><td>Eindeutige technische Kennung (z. B. technischeDaten_arbeitshoehe). Wird für Integrationen oder API-Zugriffe verwendet.</td></tr><tr><td><strong>Umwandlungs-ausdruck (SPEL-Expression)</strong></td><td>Optional: Logik zur automatischen Umwandlung oder Berechnung von Werten. Wird i. d. R. von nexato konfiguriert.</td></tr></tbody></table>

{% hint style="warning" %}
Der Key gibt an, welches Element ausgelesen wird in der JSON, die über die Schnittstelle kommt. Siehe dazu auch die API-Dokumentation.
{% endhint %}

#### Feldtypen im Überblick

Beim Anlegen eines Attributs kannst Du zwischen folgenden Datentypen wählen:

<table><thead><tr><th width="199.56640625">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td><strong>String</strong></td><td>Freitext, z. B. „Baustellenname“, „Kommentar“</td></tr><tr><td><strong>Boolean</strong></td><td>Wahr/Falsch-Wert (z. B. „Fahrerwechsel nötig“)</td></tr><tr><td><strong>Datum + Uhrzeit</strong></td><td>Zeitbasierte Angaben (z. B. „Bereitstellung bis“)</td></tr><tr><td><strong>Nummer</strong></td><td>Zahleneingaben (z. B. „Priorität“, „Anzahl Personen“)</td></tr></tbody></table>

### Sections und Attribute bearbeiten

Über das Kontext-Menü (Drei-Punkte-Symbol) neben der Section oder dem jeweiligen Attribut kannst Du außerdem folgende Anpassungen vornehmen:

<table><thead><tr><th width="225.11328125">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td><strong>Bearbeiten</strong></td><td>Öffnet die Detailansicht zur Anpassung der Einstellungen der Section oder des Attributs.</td></tr><tr><td><strong>Löschen</strong></td><td>Entfernt das Attribut bzw. die Section (nur, wenn es nicht mehr verwendet wird).</td></tr><tr><td><strong>Nach oben verschieben</strong></td><td>Ändert die Reihenfolge der Sections oder darunter befindlicher Attribute.</td></tr><tr><td><strong>Nach unten verschieben</strong></td><td>Ändert die Reihenfolge der Sections oder darunter befindlicher Attribute.</td></tr></tbody></table>

***

## Technische Hinweise

* Änderungen an bestehenden Feldern können Auswirkungen auf API-Nutzung und Automatisierungen haben.
* Die benutzerdefinierten Felder werden kontextbezogen in den jeweiligen Oberflächen angezeigt.
* Über die API können Werte ausgelesen und verarbeitet werden – ideal für Schnittstellenanbindungen.
* Aktuell können Custom Attributes nur über die Schnittstelle geschrieben/geändert werden.

***

## Praxistipp

* Custom Attributes sind ideal, wenn zusätzliche Felder benötigt werden, die über die Standardfunktionen von nexcore hinausgehen – z. B. für Maschinen-Stammdaten, zusätzliche Auftragsinformationen, Projektnummern oder Referenzen aus Drittsystemen.
* Änderungen an bestehenden Attributen sollten sorgfältig vorgenommen werden, da sie Auswirkungen auf Schnittstellen, Formulare oder Berichte haben können.
* In der Regel erfolgt die technische Anlage und Pflege durch nexato oder autorisierte und technisch versierte Administratoren.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nexcore.de/documentation/einstellungen-and-verwaltung/developer/custom-attributes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.