Daten in Tabelle importieren

Diese Aktion liest Daten aus einer formatierten CSV-Textdatei und importiert sie in eine SQL-Datenbank.

Die Über-Gruppe gibt die ausgewählte Aktion an.

• Name: ermöglicht es Ihnen, einen benutzerdefinierten Namen anzugeben. So können Sie Aktionen in der Liste der Aktionen in der Lösung leichter erkennen. Standardmäßig werden Aktionsnamen vom Typ der jeweiligen Aktion abgeleitet.
• Beschreibung: benutzerdefinierte Informationen über die Aktion. Geben Sie eine Beschreibung ein, um den Zweck und die Rolle einer Aktion in einer Lösung zu erklären.
• Aktionstyp: Nur-Lesen-Informationen über den ausgewählten Aktionstyp.

Für diese Aktion gelten folgende Regeln:

• Die Tabelle muss in der SQL-Datenbank bereits vorhanden sein.

• Die Tabelle muss einen PRIMARY KEY enthalten.

• Die erste Zeile in einer Textdatei muss Feldnamen definieren.

• Die Feldnamen in der Textdatei müssen den Feldnamen in der Datenbanktabelle entsprechen.

• Bietet die Textdatei für ein Feld keinen Wert, wird NULL in der Datenbank eingetragen. Akzeptiert das Feld keine NULL-Werte, wird eine leere Zeichenfolge ("") geschrieben.

• Werte für Felder mit automatischem Zähler werden ignoriert. Die Werte für solche Felder werden aus der Datenbank bezogen.

• Wenn der Wert aus der Textdatei nicht der Struktur des Feldes entspricht, wird die Aktion abgebrochen und eine Fehlermeldung angezeigt. Dies passiert zum Beispiel, wenn ein alphanumerischer Wert in ein numerisches Feld eingegeben wird.

• Wenn Sie Datensätze in der Maske filtern und nur solche anzeigen, die einer bestimmten Bedingung entsprechen, können Sie nur Datensätze importieren, die entweder keinen Wert für das Filterfeld liefern oder aber den in der Maske definierten Welt für den Filter liefern.

• Nur Filter mit der Bedingung „gleich“ sind erlaubt (nicht „größer als“, „kleiner als“, „enthält“ oder ähnliche).

• Wenn die Textdatei Felder enthält, die nicht in der SQL-Datenbank definiert sind, werden diese beim Import ignoriert. Es werden nur bekannte Felder importiert.

Die Gruppe Einstellungen wählt die Tabelle aus.

• Tabelle legt eine vordefinierte Tabelle aus dem Dropdown-Menü fest oder erstellt mithilfe des Datenbank-Assistenten eine neue.

Die Gruppe Datei-Textstruktur gibt die Parameter der Textdatenbank an.

• Trennzeichen: gibt die Art von Trennzeichen in der Datendatei an. Wählen Sie ein vordefiniertes Trennzeichen aus oder erstellen Sie ein eigenes.

• Textbegrenzer: gibt den Textbegrenzer an. Wählen Sie ein vordefiniertes Trennzeichen aus oder fügen Sie ein eigenes ein

• Datei-Codierung: gibt die in der Datendatei verwendete Zeichencodierung an. Auto legt die Codierung automatisch fest. Wählen Sie, falls nötig, den bevorzugten Codierungstyp aus der Dropdown-Liste aus.

Aktionsausführung und Fehlerhandhabung

Jede Aktion kann als bedingungsabhängige Aktion festgelegt werden. Bedingungsabhängige Aktionen werden nur ausgeführt, wenn die festgelegten Bedingungen erfüllt sind. Um diese Bedingungen zu definieren, klicken Sie auf Optionen für Ausführung und Fehlerhandhabung anzeigen.

Die Ausführungsoptionen sind:

• Aktiviert: gibt an, ob die Aktion aktiviert oder deaktiviert ist. Nur aktivierte Aktionen werden ausgeführt. Diese Funktion kann beim Testen einer Druckmaske verwendet werden.
• Bedingung: definiert einen einzeiligen Programmierausdruck, welcher einen booleschen Wert bereitstellen muss (wahr oder falsch). Ist das Ergebnis des Ausdrucks wahr, wird die Aktion ausgeführt. Bedingungen sorgen dafür, dass Aktionen nicht jedes Mal ausgeführt werden müssen.

Die Fehlerhandhabung-Optionen sind:

• Fehler ignorieren : gibt an, ob ein Fehler ignoriert werden soll. Wenn aktiviert, wird die Ausführung von Aktionen selbst dann fortgesetzt, wenn die aktuelle Aktion fehlschlägt.

  Hinweis

  Geschachtelte Aktionen, die von der aktuellen Aktion abhängig sind, werden im Fall eines Fehlers nicht ausgeführt. Die Aktionsausführung wird bei der nächsten Aktion fortgesetzt, die sich auf derselben Ebene wie die aktuelle Aktion befindet. Der Fehler wird protokolliert, führt aber nicht zu einer Unterbrechung der Ausführung von Aktionen.

Beispiel

Am Ende des Druckvorgangs möchten Sie eventuell mittels der Aktion HTTP-Anfrage einen Statusbericht an eine externe Anwendung senden. Wenn die Druckaktion fehlschlägt, wird die Aktionsverarbeitung angehalten. Um die Berichterstellung trotz fehlgeschlagener Druckaktion auszuführen, muss für die Aktion Etikett drucken die Option Fehler ignorieren aktiviert sein.

• Fehler in Variable speichern : ermöglicht Ihnen, eine Variable auszuwählen oder zu erstellen, in der der Fehler gespeichert werden soll. Dieselbe Fehlerbeschreibung wird zudem in den internen Variablen ActionLastErrorId und ActionLastErrorDesc gespeichert.