Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.
Auszug
hiddentrue

Nuclos Objektimport: CSV, Standardimport, Direktimport, nuclosProcess, nuclosState, Strukturdefinition, Log-Datei, Transaktion.

globe with meridians Sprache: Deutsch · English

hammer and wrench Objektimport

CSV-Dateien importieren – Standard- vs. Direktimport, mehrere Strukturdefinitionen und Reihenfolge.

Status
colourPurple
titleHow-to
Status
colourBlue
titleAnwendungsentwickler
Status
colourGreen
titleStand: Jul 2026
Status
colourGrey
titlegilt fuer Nuclos 4.2026.x

Panel
bgColor#F4F5F7

Auf dieser Seite

Inhalt
maxLevel2
minLevel2

Was ist der Objektimport?

In der Maske Objektimport weist du einer Quelldatei eine oder mehrere Strukturdefinitionen zu und startest den Import. Menü: Import & Export → Objektimport.

Datei & Importmodus

Unter Datei wird die CSV-Datei in ein Server-Verzeichnis hochgeladen.

ModusVerhalten
Standardimportlegt Daten über Nuclos-Speichermechanismen an – Regeln werden ausgeführt.
Direktimportschreibt direkt in die DB (ohne Regeln) – deutlich schneller bei großen Mengen; zusätzliche Attribute nuclosProcess und nuclosState.
Info
titleDirektimport

Beim Direktimport werden Status und Aktion nur über den Namen importiert (sprachabhängig vom aktuellen Kontext). In Transaktion ausführen liest blockweise ein (Performance); das Ergebnis steht in der Log-Datei.

Image Added

Objektimport-Maske.

Strukturdefinitionen zuweisen

Im Reiter Strukturdefinition werden eine oder mehrere Definitionen zugewiesen. Die Reihenfolge bestimmt die Import-Abfolge – wichtig bei Abhängigkeiten.

Image Added

Strukturdefinitionen zuweisen.

Tipp
titleImport durchführen

How-to (vorhandene Strukturdefinition): Ziel-Entität öffnen → Aktionen → Importieren → Datei hochladen und Strukturdefinition wählen → Importmodus/Vorschau prüfen → Starten → Importprotokoll kontrollieren.

Verwandte Seiten

clipboard Strukturdefinition


Mapping.

Öffnen →

package Import und Export


Übersicht.

Öffnen →

Definition

Menüaufruf: (Import & Export) - (Objektimport)

 In der Maske Objektimport wird der Ablauf des Imports und die Zuweisung von Quelldatei zur Strukturdefinition vorgenommen.

Konfiguration

Zunächst wird unter Datei die Importdatei hochgeladen werden. Die Datei wird in ein festgelegtes Serververzeichnis gelegt. 

Die Datei muss ein *.csv Datei sein. 

Importmodus

Standardimport

Beim Standardimport werden die importierten Daten über Nuclos-Speichermechanismen angelegt. D.h. es werden u.A. Regeln ausgeführt.

Direktimport

Beim Direktimport werden Daten direkt in die Datenbank geschrieben, ohne dass die Nuclos Regeln durchgeführt werden. Diese Importvariante ist besonders bei großen Datenmengen zu empfehlen, weil der Import so wesentlich schneller durchgeführt werden kann. Desweiteren stehen bei dieser Variante zusätzliche Attribute in der Strukturdefinition zur Verfügung:

  • nuclosProcess
  • nuclosState
Info

Status und Aktion werden ausschließlich über den Namen importiert, unabhängig davon welche Felder als Indentifizierer des referenzierten Datensatzes ausgewählt werden. Der Import ist von der im aktuellen Kontext gewählten Sprache abhängig.

Das Flag In Transaktion ausführen bedeutet, dass (wenn aktiviert) Daten blockweise eingelesen und verarbeitet werden. Das kann Performancevorteile haben. In der Log-Datei wird das Importergebnis eingetragen.

Image Removed

Strukturdefnitionen hinzufügen

Im Reiter Strukturdefinition weisen Sie die Strukturdefinition der Datei zu. Es können auch mehrere Strukturdefinitionen für eine Importdatei gelten. Die Reihenfolge sagt dabei aus, in welcher Reihenfolge die Imports durchgeführt werden sollen. Das kann z.B. wichtig sein, wenn Abhängigkeiten bestehen.

Image Removed

HOW TO: IMPORT

Panel
borderColorgreen
titleColorblue
borderWidth10
borderStylesolid
titleHow-to: Import mit vorhandener Strukturdefinition durchführen

closed book How-to: Import mit vorhandener Strukturdefinition durchführen

direct hit  Ziel

Eine Datei mithilfe einer bereits angelegten Strukturdefinition importieren.

bust in silhouette  Voraussetzung

  • Eine vorhandene Strukturdefinition → (Strukturdefinition)

  • Importdatei (z. B. CSV)

  • Berechtigung für Importvorgänge

page with curl Schritte

1. Ziel-Entität öffnen

Öffne die Entität, in die importiert werden soll.

2. Import starten

Wähle:
Aktionen → Importieren

3. Datei auswählen

  • Datei hochladen

  • Passende Strukturdefinition auswählen

4. Einstellungen prüfen

  • Importmodus kontrollieren (z. B. Neu anlegen / Aktualisieren)

  • Vorschau prüfen (falls verfügbar)

5. Import ausführen

Auf Starten / Importieren klicken.

check mark button  Ergebnis prüfen

  • Importprotokoll kontrollieren

  • Datensätze in der Liste prüfen

  • Fehlermeldungen ggf. analysieren