1.5.5 StpPreFieldSubSetImport – Auswahl der Felder für den Import
StpPreFieldSubSetImport ( nFieldFile, nFieldInfra, strDDFormat, lHdlError );
Argumente
nFieldFile
Angabe des Feldes des Satzes in der Importdatei, aus dem der Wert zu entnehmen ist. Der Satz in der Importdatei muss vollständig, d.h. es müssen alle Felder, laut DD, in der Importdatei vorhanden sein.
 
NFieldInfra
Nummer des Feldes, in den der Wert zu schreiben ist.
 
strDDFormat (optional)
infra:DD - Zielformat, z.B. N7.3, in das der Wert abgebildet werden soll, bevor er in die Datenbank geschrieben wird. Bei Angabe eines Leerstrings, oder beim Weglassen der Variablen, wird das Zielformat aus dem DD gelesen.
 
lHdlError (Optional)
Hier kann die Behandlung eines Formatfehlers für das gewünschte Feld festgelegt werden.
0
Bei Formatfehler benutze die Standard Warnungsbehandlung (Default)
1
Bei Formatfehler benutze die Standard Fehlerbehandlung
Rückgabewert
Keiner
Beschreibung
Die Funktion bereitet StpImport  vor.
Aus dem Satz der Importdatei entnimmt StpImport die gewünschten Felder, angegeben mit nFieldFile und kopiert diese in die Zielfelder, wie mit Hilfe von nFieldInfra festgelegt.
Beim Kopiervorgang kann auch eine explizite Formatierung vorgenommen werden.
Zusätzlich ist festzulegen, was bei einem Formatierungsfehler zu geschehen hat.
StpImport führt nach Aufruf dieser Funktion nur ein Update, unabhängig des UPP/UPD - Aufrufparameters, auf bestehende Sätze aus, bzw. es werden nur die Werte der Felder aus der Importdatei importiert, die explizit, mit Hilfe dieser Funktion, angegeben sind.
Die anderen Werte, bzw. Felder der Importdatei werden ignoriert.
Bitte berücksichtigen Sie, dass StpImport im Testmodus ausführbar ist. In diesem Fall wird der Import in eine Testdatei, anstelle in die Datenbank, geschrieben
WICHTIG:
Die Sätze der Importdatei müssen vollständig dem DD der Tabelle entsprechen.
Sollen zum Beispiel bestimmte Felder aus einem Export des Teilestammens, Tabelle 6, importiert werden, so muss der zu importierende Satz dem DD der Tabelle 6 entsprechen und vollständig sein.
StpPreFormatField darf NICHT gleichzeitig mit dieser Funktion verwendet werden, da diese Funktion sonst nicht ausgeführt wird.
Bitte berücksichtigen Sie, dass in infra-Werte (LowValues) angezeigt werden können, obwohl das Feld in der Datenbank nur Blanks enthält.
Diese Funktion ist auf jedes Schlüsselfeld, das als Pfad bei StpImport angegeben wird, anzuwenden.
Beispiel: Wenn bei einem Satz die Importfelder 3 und 5 sind und die Schlüsselfelder 2 und 19, so ist die Funktion auch für beide Schlüsselfelder aufzurufen:
StpPreFieldSubSetImport( 3, 2, „N8“, 1 );
StpPreFieldSubSetImport( 5, 19, „N4“, 1 );
Es können nur Sätze angepasst werden, deren Schlüssel vollständig angeben sind und deren Pfad eindeutig ist.
Beim Update wird die StpUPP – Funktion mit dem Maskierungszeichen ‚°’ benutzt.
D.h. falls Teilfelder importiert werden, die das Markierungszeichen als Inhalt haben, kann es zu Seiteneffekten kommen.
Funktionsart
STPFunktion