Mithilfe eines Import-Dialogs kann man Dateien im Excel- oder CSV-Format importieren. Genauer, wenn die Import-Datei eine Tabelle enthält, deren Zeilen Fachobjekte beschreiben,  die in der TL-App modelliert sind, so legt der Import-Dialog entsprechende Fachobjekte an, wobei die Spaltennamen als Attributnamen und Spaltenwerte als Attributwerte dienen.

Konfiguration

Reihenfolge

Um einen Import-Dialog zu konfigurieren, muss man auf die Reihenfolge achten:

1. Im Abschnitt "Einlesen der Excel-Datei" muss man eine Beispieldatei hochladen, um beim Ausfüllen der Konfigurationseigenschaften einfach aus den vorhandenen Spaltennamen auszuwählen. Selbst wenn die eigentliche Import-Datei mehrere Blätter und Tabellen mit Daten enthält, wurde sie eventuell vom Kunden noch nicht zur Verfügung gestellt oder sie ist zu groß um als Beispiel zu dienen. Deshalb muss die Beispieldatei nur das zu importierende Blatt mit dem Tabellenkopf enthalten.
2. Im Abschnitt "Import-Konfiguration":
   1. "Umrechnungen": Manche Spaltenwerte muss man eventuell umrechnen, bevor man sie als Schlüssel in einem Objekt-Verzeichnis (s.u.) verwenden kann.
   2. "Objekt-Verzeichnisse": Man muss für jeden relevanten Typ ein Objekt-Verzeichnis (s.u.) anlegen, bevor man mit den Objekten arbeiten kann.
   3. "Importschritte": Eine grobe Richtlinie für die Reihenfolge wäre:
      1. Als erstes sollte man Objekte erstellen.
      2. Dann Objekte nachschlagen oder Referenzen zwischen Objekten erstellen.

Generell, da viele Konfigurationsoptionen nur aus den bereits ausgefüllten Konfigurationseigenschaften automatisch berechnet werden, funktionieren manche optionale bzw. polymorphe Eigenschaften erst nach erneutem Einfügen bzw. Auswahl. Deswegen wäre es zum Beispiel nicht ratsam, zuerst die Importschritte nicht ausgefüllt als reine Platzhalter in richtiger Reihenfolge zusammenzubauen.

Objekt-Verzeichnisse

Jedes Objekt-Verzeichnis spielt die Rolle einer transienten Teildatenbank, die automatisch mit den Objekten des konfigurierten Typs befüllt wird. Der (eventuell zusammengesetzte) Schlüssel wird gemäß gegebener Konfiguration bestimmt:

• für die bereits vorhandenen (persistenten) Objekte - aus den Attributen;
• für die neu importierten Objekte - aus den Spaltenwerten.

Argumente

Viele Ausdrücke im Import werden (statt üblicher, fest vorgegebener Argumente) auf Gruppe "Argumente" angewandt, wo man Argumente folgender Typen selbst konfigurieren kann:

• Modell - repräsentiert das Import-Modell.
• Spalte - repräsentiert den Wert einer Spalte aus der Import-Datei.
• Objekt(e) - repräsentiert ein oder mehrere Objekte, die unter "Importschritte" erstellt oder nachgeschlagen wurden und als Objekt-Argument einen Namen bekamen.

Beispiel

Im TL-Demo unter

Administration > Fach. Administration > Personen > Importieren...

befindet sich ein Import-Dialog, dessen Konfiguration im Designmodus eingesehen werden kann.