1.3.33 StpUppField – Updaten eines Feldes im Datensatz
StpUppField(strKeys,strBufName,nPath,nField,nPos,strBuffer[,nCleanToEnd]);
|
Argumente
|
strKeys
Angaben bis zu 6 Schlüsseln. Zulässige Trenner sind „ , ; | “.
| ||||||||||||||||||
|
|
strBufName
Name des Buffers.
Der BufferName ist einer Datenbankdatei zugeordnet.
| ||||||||||||||||||
|
|
nPath
Pfad, über den der Satz gesucht wird.
| ||||||||||||||||||
|
|
nField:
Feld, das angepasst werden soll
| ||||||||||||||||||
|
|
nPos:
Position innerhalb eines Feldes des bestehenden Datensatzes, ab der die Werte mit dem Inhalt von strBuffer überschrieben werden.
Die Länge des einzutragenden Strings wird anhand von strBuffer berechnet.
nPos <= 1 entspricht Bufferanfang.
Ist das Format des Feldes ungleich Cx, d.h. keine Stringfeld, wird nPos ignoriert.
| ||||||||||||||||||
|
|
strBuffer:
Wert der angepasst werden soll.
| ||||||||||||||||||
|
|
nCleanToEnd:
Default ist 0, d.h. wird die Variable der Funktion nicht mitgegeben, erfolgt keine Löschung des Feldinhaltes.
Diese Variable wird nur bei Stringfeldern ausgewertet.
| ||||||||||||||||||
|
Rückgabewert:
|
StpRc
| ||||||||||||||||||
|
Fehlerarten:
|
| ||||||||||||||||||
|
Beschreibung
|
Im Gegensatz zur Funktion StpUppBuf wird die Angabe der Position nicht auf dem gesamten Satz bezogen, sondern auf das Feld, das mit Hilfe der Variablen nField angegeben wird.
Die Funktion sucht zuerst den Datensatz.
Ist der Satz vorhanden, wird das Feld nField mit den Werten in strBuffer ab der Position nPos der Länge der Werte in strBuffer überschrieben.
Zusätzlich kann bei Stringfeldern entschieden werden, ob der restliche Feldinhalt auf Blank zu setzten ist.
Ist das Feld eine Nummer, d.h. Feld mit Format Nx oder Nx.y findet automatisch eine Formatierung des Wertes statt, schlägt sie fehl, wird das Feld auf LowValue gesetzt.
Bei der Umwandlung von Nx.y nach Nz entfallen die Nachkommastellen. Kommas bei Doublewerten werden vor der Formatierung durch Punkte ersetzt.
Nach erfolgreichem Verändern des Feldinhaltes wird der Datensatz in die Datenbank zurückgeschrieben.
Die Formatierung der Feldwerte erfolgt mit Hilfe der Kernsystemfunktion SCKDT::UnFormatText. LowValue - Werte stammen von der Kernsystemfunktion SCKDT::QueryULow.
Weitere Einzelheiten zu den Kernsystemfunktion entnehmen Sie bitte der Beschreibung dieser Kernsystemfunktionen
Der Skripter kann den Returncode auswerten.
Ist die Protokollierung aktiv, werden die zu anzupassenden Sätze, bzw. die Fehler in die Logdatei geschrieben.
|