PMS32 Online- Hilfereferenz

MY.FUNCTIONS.DATEIEN

Dateien - Alle Funktionen mit Dateioperationen

Hilfe: Dateifunktionen
Alle Funktionen mit Dateioperationen

Code: Dateifunktionen
*/ Kurzbeispiel für den Zugriff auf diese Struktur
*/ Der Zugriff erfolgt über: My.Functions.Dateien
*/ Wird dieses Objekt in einem REPLACE oder einer Schleife SCAN ... ENDSCAN | FOR ... NEXT benötigt
*/ so sollte vor der Schleife die Objektstruktur in eine Variable geholt werden!
*/ Die Ausführungsgeschwindigkeit wird dadurch sehr vergrößert!
*/ Beispiel:
*/ Definieren einer LOKALEN Variablen
LOCAL loDateien AS My.Functions.Dateien
*/ Setzen der Variablen
loDateien = My.Functions.Dateien
*/ Jetzt erst die Schleifen durchlaufen... man beachte ALL, dass können ne Menge Sätze sein...
REPLACE ALL Feldname1 WITH loDateien.Function1(),Feldname2 WITH loDateien.Function1(), ...
*/ Oder in einer Schleife...
SCAN
	lvValue = loDateien.Function(Alias.Spalte) + 25
	lvValue = loDateien.Function2(m.lvValue)
	REPLACE Feldname WITH m.lvValue,...
ENDSCAN
*/ Es sind auch geschachtelte Aufrufe möglich...
Memberliste von Dateien

Liste der Methoden von Dateien

DeleteAllFiles() - 'Alle' Dateien löschen

Rückgabe:[Boolean], Löscht Dateien auch in Unterverzeichnissen.
Hilfeinformation
Rückgabe:[Boolean], Löscht Dateien auch in Unterverzeichnissen.

Aufrufinformation
Boolean = My.Functions.Dateien.DeleteAllFiles(LPARAMETER tcwhat)
Boolean = My.Functions.Dateien.DeleteAllFiles(LPARAMETER)
Codeinformation


EraseDBF() - Löschen einer Tabelle

 Rückgabe:[Boolean], Löscht eine Tabelle mit allen Dateien .FPT, .CDX, usw.
Hilfeinformation

Rückgabe:[Boolean], Löscht eine Tabelle mit allen Dateien .FPT, .CDX, usw.
Aufrufinformation


Boolean = My.Functions.Dateien.EraseDBF(LPARAMETER tcfile)
Boolean = My.Functions.Dateien.EraseDBF(LPARAMETER)


Codeinformation




EraseFRX() - Löschen eines Reports

 Rückgabe:[Boolean], Löscht Reportdateien.
Hilfeinformation

Rückgabe:[Boolean], Löscht Reportdateien.
Aufrufinformation


Boolean = My.Functions.Dateien.EraseFRX(LPARAMETER tcfile)
Boolean = My.Functions.Dateien.EraseFRX(LPARAMETER)


Codeinformation




EraseFiles() - Löschen von Dateien

 Rückgabe:[Boolean], Löscht mehrere, angegebene Dateien.
Hilfeinformation

Rückgabe:[Boolean], Löscht mehrere, angegebene Dateien.
Aufrufinformation


Boolean = My.Functions.Dateien.EraseFiles(LPARAMETER tcfile1, tcfile2, tcfile3, tcfile4, tcfile5, tcfile6, tcfile7, tcfile8, tcfile9 ,tcfile10, tcfile11, tcfile12, tcfile13, tcfile14, tcfile15, tcfile16, tcfile17, tcfile18, tcfile19)
Boolean = My.Functions.Dateien.EraseFiles(LPARAMETER,tcfile2,tcfile3,tcfile4,tcfile5,tcfile6,tcfile7,tcfile8,tcfile9,tcfile10,tcfile11,tcfile12,tcfile13,tcfile14,tcfile15,tcfile16,tcfile17,tcfile18,tcfile19)


Codeinformation




Evaluate() - Ausführen eines Befehls

 Mit Setzen dieser Property auf .T. kann die Form zentriert werden.
Hilfeinformation

Ausführen eines VFP-Befehls mit EVALUATE().
Achtung! Eventuell müssen Variablen als PRIVATE deklariert werden!ENDTEXT
*
TEXT TO lcMessage NOSHOW TEXTMERGE
Ausführen eines VFP-Befehls mit EVALUATE().
Aufrufinformation


Variant = My.Functions.Dateien.Evaluate(pcExpression AS STRING,pvDefault AS Variant,tvP1 AS Variant,tvP2 AS Variant,tvP3 AS Variant,tvP4 AS Variant, tvP5 AS Variant,tvP6 AS Variant,tvP7 AS Variant,tvP8 AS Variant,tvP9 AS Variant)
Variant = My.Functions.Dateien.Evaluate(pcExpression,pvDefault,tvP1,tvP2,tvP3,tvP4,tvP5,tvP6,tvP7,tvP8,tvP9)


Codeinformation


*/ Mit Evaluate kann eine Befehlszeile ausgeführt werden
*/ Eventuell benutzte Variablen sind PRIVATE zu deklarieren
PRIVATE pnVar1 AS Number , pnVar2 AS Number
LOCAL lnVar AS Number
STORE 2 TO pnVar1,pnVar2
lnVar = My.Functions.Dateien.Evaluate([m.pnVar1+m.pnVar2])
WAIT WINDOW m.lnVar		&& Ergibt 4...	ENDTEXT


ExecScript() - Ausführen eines VFP-Scripts

 Ausführen eines VFP-Scripts incl. der Prüfung, ob ein ALIAS besteht.
Hilfeinformation

Ausführen eines VFP-Scripts incl. der Prüfung, ob ein ALIAS besteht.
Aufrufinformation


Variant = My.Functions.Dateien.ExecScript(_es_pcAlias AS STRING,_es_pcScript AS STRING,_es_tlBoolean AS Boolean, _es_tvP1 AS Variant,_es_tvP2 AS Variant,_es_tvP3 AS Variant,_es_tvP4 AS Variant,_es_tvP5 AS Variant,_es_tvP6 AS Variant, _es_tvP7 AS Variant,_es_tvP8 AS Variant,_es_tvP9 AS V)
Variant = My.Functions.Dateien.ExecScript(_es_pcAlias,_es_pcScript,_es_tlBoolean,_es_tvP1,_es_tvP2,_es_tvP3,_es_tvP4,_es_tvP5,_es_tvP6,_es_tvP7,_es_tvP8,_es_tvP9)


Codeinformation


*/ Mit EXECSCRIPT kann ein VFP-Script ausgeführt werden
LOCAL lcScript AS String,lnVar1 AS Number,lnVar2 AS Number,lnVar AS Number
TEXT TO lcScript NOSHOW TEXTMERGE
LPARAMETERS tnVar1 AS Number @,tnVar2 AS Number @
tnVar1 = m.tnVar1 + 1
tnVar2 = m.tnVar2 - 2
RETURN m.tnVar1 + m.tnVar2
ENDTEXT
*/ Vorbelegen der Variablen (Parameter)
STORE 2 TO lnVar1,lnVar2
lnVar = My.Functions.Dateien.ExecScript("",m.lcScript,0,@lnVar1,@lnVar2)
*/ und das Ergebnis...
WAIT WINDOW m.lnVar
WAIT WINDOW m.lnVar1
WAIT WINDOW m.lnVar2


ExecScriptP() - Ausführen eines VFP-Scripts

 Ausführen eines VFP-Scripts incl. PARAMETER (Collection)
Hilfeinformation

Ausführen eines VFP-Scripts incl. PARAMETER (Collection)
Als Parameter wird eine Collection mit Informationen übergeben!
Aufrufinformation


Variant = My.Functions.Dateien.ExecScriptP(tcScript AS STRING,toPara AS COLLECTION)
Variant = My.Functions.Dateien.ExecScriptP(tcScript,toPara)


Codeinformation


*/ Mit EXECSCRIPTP kann ein VFP-Script ausgeführt werden
LOCAL lcScript AS String,lnVar AS Number,loColl AS Collection
loColl = CREATEOBJECT("Collection")
loColl.Add(2,"Var1")
loColl.Add(2,"Var2")
TEXT TO lcScript NOSHOW TEXTMERGE
LPARAMETERS toColl AS Collection
RETURN toColl.Item("Var1") + toColl.Item("Var2")
ENDTEXT
lnVar = My.Functions.Dateien.ExecScriptP(m.lcScript,m.loColl)
*/ und das Ergebnis...
WAIT WINDOW m.lnVar


FileWithTimestamp() - Versieht eine Datei mit einem Zeitstempel

 Rückgabe: [String] Gibt eine Dateiangabe incl. Zeitstempel zurück. 
Hilfeinformation

Versieht eine Datei mit einem Zeitstempel.
\.  =>  \_.
Aufrufinformation


String = My.Functions.Dateien.FileWithTimestamp(tcFile AS String)
String = My.Functions.Dateien.FileWithTimestamp(tcFile)


Codeinformation


LOCAL lcFile AS String
lcFile = My.Functions.Dateien.FileWithTimestamp("MeineDatei.txt")
? lcFile && "MeineDatei_YYYYMMDDhhmmss.txt"
lcFile = My.Functions.Dateien.FileWithTimestamp("c:\tmp\MeineDatei.txt")
? lcFile && "c:\tmp\MeineDatei_YYYYMMDDhhmmss.txt"



GetCSVCode() - CSV Code ermitteln

 Rückgabe:[String], Ermittelt den Text/Code für eine CSV Datei
Hilfeinformation


Aufrufinformation


String = My.Functions.Dateien.GetCSVCode(tcAlias AS STRING,tcDelimiter AS String)
String = My.Functions.Dateien.GetCSVCode(tcAlias,tcDelimiter)


Codeinformation




GetFileSize() - Dategröße

 Rückgabe:[Number], Gibt die Dateigröße einer Datei in Bytes zurück
Hilfeinformation


Aufrufinformation


Number = My.Functions.Dateien.GetFileSize(tcFile AS STRING,tcUnit AS STRING)
Number = My.Functions.Dateien.GetFileSize(tcFile,tcUnit)


Codeinformation




GetFileText() - Text einer Datei holen

 Rückgabe:[Boolean], Liest eine Datei Zeilenweise aus und stellt sicher, dass nach jeder Zeile ein Chr(13)+chr(10) enthalten ist. Am Ende ist kein Chr(13)+chr(10) mehr.
Hilfeinformation

Rückgabe:[Boolean], Liest eine Datei Zeilenweise aus und stellt sicher, dass nach jeder Zeile ein Chr(13)+chr(10) enthalten ist. Am Ende ist kein Chr(13)+chr(10) mehr.
Aufrufinformation


Boolean = My.Functions.Dateien.GetFileText(LPARAMETER p_dat)
Boolean = My.Functions.Dateien.GetFileText(LPARAMETER)


Codeinformation




GetFilesFrom() - Erstellt eine Collection mit Dateien

 Rückgabe:[Object], Erstellt eine Collection von Dateien.
Hilfeinformation

Rückgabe:[Object], Erstellt eine Collection von Dateien.
Aufrufinformation


Boolean = My.Functions.Dateien.GetFilesFrom(tcDir, tcWild AS STRING, toColl AS COLLECTION,tcExDir,tcExFile AS STRING) AS Boolean)
Boolean = My.Functions.Dateien.GetFilesFrom(tcDir,tcWild,toColl,tcExDir,tcExFile)


Codeinformation




GetParameters() - Parameter to Collection

 Wandelt übergebene Parameter in eine Collection um.
Hilfeinformation

Wandelt übergebene Parameter in eine Collection um.
Umkehrfunktion zu SetParameters.
Aufrufinformation


Variant = My.Functions.Dateien.GetParameters(tvP1 AS Variant,tvP2 AS Variant,tvP3 AS Variant,tvP4 AS Variant,tvP5 AS Variant,tvP6 AS Variant,tvP7 AS Variant,tvP8 AS Variant,tvP9 AS Variant)
Variant = My.Functions.Dateien.GetParameters(tvP1,tvP2,tvP3,tvP4,tvP5,tvP6,tvP7,tvP8,tvP9)


Codeinformation


*/ Hier können mehrere Parameter in eine Collection übertragen werden
LOCAL loCollection AS Collection , lni AS Integer , lcNames AS String
loCollection = My.Functions.Dateien.GetParameters(1,DATE(),TIME())
WAIT WINDOW m.loCollection.Count		&& Anzahl der Werte (3)
*/ Die Namen der Parameter bestimmen
lcNames = ""
FOR m.lni = 1 TO m.loCollection.Count
	lcNames = m.lcNames + ";" + m.loCollection.GetKey(m.lni)
NEXT m.lni
WAIT WINDOW SUBSTR(m.lcNames,2)


GetParametersCount() - Parameter to Collection

 Wandelt übergebene Parameter in eine Collection um.
Hilfeinformation

Wandelt übergebene Parameter in eine Collection um.
Jedoch wird als 'erster' Parameter die Anzahl der Parameter mitgegeben.
Aufrufinformation


Variant = My.Functions.Dateien.GetParametersCount(tnCnt AS Number,tvP1 AS Variant,tvP2 AS Variant,tvP3 AS Variant,tvP4 AS Variant,tvP5 AS Variant,tvP6 AS Variant,tvP7 AS Variant,tvP8 AS Variant,tvP9 AS Variant)
Variant = My.Functions.Dateien.GetParametersCount(tnCnt,tvP1,tvP2,tvP3,tvP4,tvP5,tvP6,tvP7,tvP8,tvP9)


Codeinformation


*/ Hier können mehrere Parameter in eine Collection übertragen werden
*/ Als Beispiel kann nur der Aufruf eines Scripts / einer Methode dienen
LPARAMETERS tp1 AS Variant , tp2 AS Variant , tp3 AS Variant 	&& Es könnten mehr sein!
LOCAL loCollection AS Collection , lni AS Integer
lni = PCOUNT()		&& Wieviele Parameter wurden übergeben?
loCollection = My.Functions.Dateien.GetParametersCount(m.lni,m.tp1,m.tp2,m.tp3)
WAIT WINDOW m.loCollection.Count		&& Anzahl der Werte (?)


LogIt() - Schreiben ein es Strings

 Rückgabe:[Boolean], Hängt den angegebenen String an eine Protokolldatei an. Wenn Datei nicht angegeben, dann LOG\PMSLOG.TXT
Hilfeinformation

Rückgabe:[Boolean], Hängt den angegebenen String an eine Protokolldatei an. Wenn Datei nicht angegeben, dann LOG\PMSLOG.TXT
Aufrufinformation


Boolean = My.Functions.Dateien.LogIt(LPARAMETER p_dat AS String, p_string AS String , p_t3 AS String)
Boolean = My.Functions.Dateien.LogIt(LPARAMETER,p_string,p_t3)


Codeinformation




MakeDirectory() - Erstellt Verzeichnisse

 Rückgabe:[Integer], Erstellt Verzeichnisse.
Hilfeinformation

Rückgabe:[Integer], Erstellt Verzeichnisse.
Aufrufinformation


Integer = My.Functions.Dateien.MakeDirectory(tcdir)
Integer = My.Functions.Dateien.MakeDirectory(tcdir)


Codeinformation




ReadIt() - Lesen einer Zeile

 Rückgabe:[String], Liest eine angegebene Zeile aus einer Datei aus, Low-Level-Funtionen (SCHNELL)
Hilfeinformation

Rückgabe:[String], Liest eine angegebene Zeile aus einer Datei aus, Low-Level-Funtionen (SCHNELL)
Aufrufinformation


String = My.Functions.Dateien.ReadIt(LPARAMETER p_dat, p_zeile)
String = My.Functions.Dateien.ReadIt(LPARAMETER,p_zeile)


Codeinformation




RemoveDirectory() - Löscht ein Verzeichnis

 Rückgabe:[Integer], Löscht Verzeichnisse.
Hilfeinformation

Rückgabe:[Integer], Löscht Verzeichnisse.
Aufrufinformation


Integer = My.Functions.Dateien.RemoveDirectory(tcdir)
Integer = My.Functions.Dateien.RemoveDirectory(tcdir)


Codeinformation




SetParameters() - Collection to Parameter

 Wandelt eine übergebene Collection in Parameter um.
Hilfeinformation

Wandelt eine übergebene Collection in Parameter um.
Umkehrfunktion zu GetParameters.
Aufrufinformation


Variant = My.Functions.Dateien.SetParameters(toPara AS Collection,tvP1 AS Variant @,tvP2 AS Variant @,tvP3 AS Variant @,tvP4 AS Variant @,tvP5 AS Variant @,tvP6 AS Variant @,tvP7 AS Variant @,tvP8 AS Variant @,tvP9 AS Variant @)
Variant = My.Functions.Dateien.SetParameters(toPara,@tvP1,@tvP2,@tvP3,@tvP4,@tvP5,@tvP6,@tvP7,@tvP8,@tvP9)


Codeinformation


*/ Umwandeln einer Collection in Parameter
LOCAL loCollection AS Collection,lnVar1 AS Number,lnVar2 AS Number
loCollection = CREATEOBJECT("Collection")
=loCollection.Add(1,"tvp1")
=loCollection.Add(2,"tvp2")
=My.Functions.Dateien.SetParameters(m.loCollection,@lnVar1,@lnVar2)
WAIT WINDOW m.lnVar1
WAIT WINDOW m.lnVar2


ValidFileName() - Korrekter Dateiname

 Rückgabe:[String], Gibt einen korrekten Namen für eine Datei zurück. Hier kann die Metrik der Zeichen gewählt werden. 0 - 'fast alle', 1 - '0-9+A-Z+div. Sonderzeichen', 2 - '0-9+A-Z,_.'
Hilfeinformation


Aufrufinformation


String = My.Functions.Dateien.ValidFileName(tcFileName AS String,tnMetrik AS Number)
String = My.Functions.Dateien.ValidFileName(tcFileName,tnMetrik)


Codeinformation




Wait42Files() - Warten...

 Rückgabe:[Boolean], Wartet einen agegebene Zeit oder bis eine der zwei angegebenen Dateien vorhanden ist.
Hilfeinformation

Rückgabe:[Boolean], Wartet einen agegebene Zeit oder bis eine der zwei angegebenen Dateien vorhanden ist.
Aufrufinformation


Boolean = My.Functions.Dateien.Wait42Files(LPARAMETER tcfile1, tcfile2, tnsec)
Boolean = My.Functions.Dateien.Wait42Files(LPARAMETER,tcfile2,tnsec)


Codeinformation




Wait4File() - Warten...

 Rückgabe:[Boolean], Wartet einen agegebene Zeit oder bis eine angegebene Datei vorhanden ist.
Hilfeinformation

Rückgabe:[Boolean], Wartet einen agegebene Zeit oder bis eine angegebene Datei vorhanden ist.
Aufrufinformation


Boolean = My.Functions.Dateien.Wait4File(LPARAMETER tcfile, tnsec)
Boolean = My.Functions.Dateien.Wait4File(LPARAMETER,tnsec)


Codeinformation




WriteCSVFile() - Schreiben einer CSV Datei

 Rückgabe:[Boolean], Schreiben einer CVS Datei aus einem Cursor heraus (Delimiter=;)
Hilfeinformation


Aufrufinformation


Boolean = My.Functions.Dateien.WriteCSVFile(tcAlias AS STRING,tcDir AS STRING,tcFile AS STRING @,tcDelimiter AS String)
Boolean = My.Functions.Dateien.WriteCSVFile(tcAlias,tcDir,@tcFile,tcDelimiter)


Codeinformation




WriteIt() - Schreiben eines Strings

 Rückgabe:[Boolean], Schreibt Strings in eine Datei über File-Handle-Funktionen
Hilfeinformation

Rückgabe:[Boolean], Schreibt Strings in eine Datei über File-Handle-Funktionen
Aufrufinformation


Boolean = My.Functions.Dateien.WriteIt(LPARAMETER tcFile, tcString, tvOpt)
Boolean = My.Functions.Dateien.WriteIt(LPARAMETER,tcString,tvOpt)


Codeinformation




_EraseOneFile() - Löscht die angegebene Datei

 Rückgabe:[Boolean], Löscht eine angegebene Datei.
Hilfeinformation

Rückgabe:[Boolean], Löscht eine angegebene Datei.
Aufrufinformation


Boolean = My.Functions.Dateien._EraseOneFile(tcFile)
Boolean = My.Functions.Dateien._EraseOneFile(tcFile)


Codeinformation




_SqlCount() - Anzahl der Datensätze

 Anzahl der Datensätze eines SQL Statements ermitteln.
Hilfeinformation

Anzahl der Datensätze eines SQL Statements ermitteln.
Die Rückgabe ist Number oder .NULL.
Die Datenbankangaben:
      CSYSDIR! => My.Clients.Path.cSysDir
      CDBFDIR! => My.Clients.Path.cDbfDir
      CFRXDIR! => My.Clients.Path.cFrxDir
      CNETDIR! => My.Clients.Path.cNetDir
      CTMPDIR! => My.Clients.Path.cTmpDir
werden unter VFP-Tabellen in den entsprechenden Pfad umgewandelt!
Bei der Verwendung eines SQL-Servers werden diese Informationen gegen den Datenbanknamen im SQL-Server ausgetauscht.
Aufrufinformation


Variant = My.Functions.Dateien._SqlCount(tcSql AS String)
Variant = My.Functions.Dateien._SqlCount(tcSql)


Codeinformation


LOCAL lcSql AS String
lcSql = [SELECT COUNT(*) FROM CSYSDIR!Y01 WHERE idc26="DE " AND ipy01="SU"]
IF My.Functions.Dateien._SqlCount(m.lcSql)>0
	WAIT WINDOW "Es sind Daten vorhanden!"
ENDIF
*/ Bemerkung:
*/ Bei der Angabe der Datenbank, hier CSYSDIR!, wird der Wert gegen den Pfad ausgetauscht!


_SqlExist() - Gibt es Datensätze?

 Werden Datensätze durch den SQL ermittelt?
Hilfeinformation

Werden Datensätze im SQL-Statement ermittelt?
Die Rückgabe ist Boolean oder .NULL.
Die Datenbankangaben:
      CSYSDIR! => My.Clients.Path.cSysDir
      CDBFDIR! => My.Clients.Path.cDbfDir
      CFRXDIR! => My.Clients.Path.cFrxDir
      CNETDIR! => My.Clients.Path.cNetDir
      CTMPDIR! => My.Clients.Path.cTmpDir
werden unter VFP-Tabellen in den entsprechenden Pfad umgewandelt!
Bei der Verwendung eines SQL-Servers werden diese Informationen gegen den Datenbanknamen im SQL-Server ausgetauscht.
Aufrufinformation


Variant = My.Functions.Dateien._SqlExist(tcSql AS String)
Variant = My.Functions.Dateien._SqlExist(tcSql)


Codeinformation


LOCAL lcSql AS String
lcSql = [SELECT ipy01 FROM CSYSDIR!Y01 WHERE idc26="DE " AND ipy01="SU"]
IF My.Functions.Dateien._SqlExist(m.lcSql)		&& Gibt Boolean zurück
	WAIT WINDOW "Es sind Daten vorhanden!"
ENDIF
*/ Bemerkung:
*/ Bei der Angabe der Datenbank, hier CSYSDIR!, wird der Wert gegen den Pfad ausgetauscht!


_SqlRead() - Lesen von SQL Daten

 Ausführen eines SQL-Statements und Rückgabe des angegebenen Cursors.
Hilfeinformation

Ausführen eines SQL-Statements und Rückgabe des angegebenen Cursors.
Die Rückgabe ist Boolean oder .NULL.
Die Datenbankangaben:
      CSYSDIR! => My.Clients.Path.cSysDir
      CDBFDIR! => My.Clients.Path.cDbfDir
      CFRXDIR! => My.Clients.Path.cFrxDir
      CNETDIR! => My.Clients.Path.cNetDir
      CTMPDIR! => My.Clients.Path.cTmpDir
werden unter VFP-Tabellen in den entsprechenden Pfad umgewandelt!
Bei der Verwendung eines SQL-Servers werden diese Informationen gegen den Datenbanknamen im SQL-Server ausgetauscht.
Aufrufinformation


Variant = My.Functions.Dateien._SqlRead(tcSql AS String,tcAlias AS String,tvTable AS Variant,tcIndex AS String)
Variant = My.Functions.Dateien._SqlRead(tcSql,tcAlias,tvTable,tcIndex)


Codeinformation


LOCAL lcSql AS String
lcSql = [SELECT * FROM CSYSDIR!Y01 WHERE idc26="DE " AND ipy01="SU"]
IF My.Functions.Dateien._SqlRead(m.lcSql,"qY01",2)		&& Gibt Boolean zurück
	ACTIVATE _SCREEN
	BROWSE
ENDIF
*/ Bemerkung:
*/ Bei der Angabe der Datenbank, hier CSYSDIR!, wird der Wert gegen den Pfad ausgetauscht!
*/ Die einzelnen Parameter:
*/	tcSql AS String,tcAlias AS String,tvTable AS Variant,tcIndex AS String
*/	Ein muss sind: tcSql AS String,tcAlias AS String
*/	tvTable kann angegeben werden mit:
*/		.F.		=> Cursor incl. __Changed [L] und __New [L], .T. - Tabelle incl.
*/		Bit-0	=> 1 - Als Tabelle, 0 - Als Cursor
*/		Bit-1	=> 1 - Ohne __Changed und __New, 0 - Mit...
*/	tcIndex kann angegeben werden, wenn Indizes auf dem Cursor / der Tabelle benötigt werden.
*/		"IndexKey1#IndexTag1;IndexKey2#IndexTag2;...."
*/		Wird kein IndexTag angegeben und der IndexKey NICHT aus einer Funktion ermittelt, so hat der IndexKey den Namen des IndexTag!
*/		Wird der IndexKey aus einer Funktion gebildet und es ist kein IndexTag angegeben, so erhält der IndexTag den Namen _Index<Nummer>


_SqlReadArray() - SQL Daten in ein Array

 Ausführen eines SQL-Statements in ein Array und Rückgabe der Datensätze.
Hilfeinformation

Ausführen eines SQL-Statements in ein Array und Rückgabe ob Daten ermittelt wurden.
Die Rückgabe ist Boolean oder .NULL.
Die Datenbankangaben:
      CSYSDIR! => My.Clients.Path.cSysDir
      CDBFDIR! => My.Clients.Path.cDbfDir
      CFRXDIR! => My.Clients.Path.cFrxDir
      CNETDIR! => My.Clients.Path.cNetDir
      CTMPDIR! => My.Clients.Path.cTmpDir
werden unter VFP-Tabellen in den entsprechenden Pfad umgewandelt!
Bei der Verwendung eines SQL-Servers werden diese Informationen gegen den Datenbanknamen im SQL-Server ausgetauscht.
Aufrufinformation


Variant = My.Functions.Dateien._SqlReadArray(tcSql AS String,toObject AS Object,taArray)
Variant = My.Functions.Dateien._SqlReadArray(tcSql,toObject,taArray)


Codeinformation


LOCAL lcSql AS String , laErg[1] , loObject AS Object
lcSql = [SELECT * FROM CSYSDIR!Y01 WHERE idc26="DE " AND ipy01="SU"]
*/ Ausführen in ein lokales Array
IF My.Functions.Dateien._SqlReadArray(m.lcSql,.NULL.,@laErg)			&& Es gibt Datensätze...
	*/ FOR i = ... NEXT i
ENDIF
*/ Ausführen in ein Objekt-Array
loObject = CREATEOBJECT("EMPTY")
=ADDPROPERTY(loObject,"aErg[1]")
IF My.Functions.Dateien._SqlReadArray(m.lcSql,m.loObject,"aErg")		&& Es gibt Datensätze...
	*/ FOR i = ... NEXT i
ENDIF


_SqlReadCollection() - SQL Daten in eine Collection

 Ausführen eines SQL-Statements in eine Collection und Rückgabe der Collection.
Hilfeinformation

Ausführen eines SQL-Statements in eine Collection und Rückgabe der Collection.
Die Rückgabe ist Collection oder .NULL.
Die Datenbankangaben:
      CSYSDIR! => My.Clients.Path.cSysDir
      CDBFDIR! => My.Clients.Path.cDbfDir
      CFRXDIR! => My.Clients.Path.cFrxDir
      CNETDIR! => My.Clients.Path.cNetDir
      CTMPDIR! => My.Clients.Path.cTmpDir
werden unter VFP-Tabellen in den entsprechenden Pfad umgewandelt!
Bei der Verwendung eines SQL-Servers werden diese Informationen gegen den Datenbanknamen im SQL-Server ausgetauscht.
Aufrufinformation


Variant = My.Functions.Dateien._SqlReadCollection(tcSql AS String,tcIndex AS String)
Variant = My.Functions.Dateien._SqlReadCollection(tcSql,tcIndex)


Codeinformation


LOCAL lcSql AS String , loColl AS Collection
lcSql = [SELECT * FROM CSYSDIR!Y01 WHERE idc26="DE " AND ipy01="SU"]
*/ Normale Ausführung OHNE Indexangabe.
*/ Die Keys der Collection sind fortlaufend nummeriert!
loColl= My.Functions.Dateien._SqlReadCollection(m.lcSql)
WAIT WINDOW loColl.GetKey(1)		&& "0000001"
*/ Hat der SQL einen eindeutigen Key so kann dieser benutzt werden!
loColl= My.Functions.Dateien._SqlReadCollection(m.lcSql,"ipy01")
WAIT WINDOW loColl.GetKey(1)		&& "SU0"


_SqlReadValue() - SQL Abfrage einer Value

 Ausführen eines SQL-Statements und Rückgabe der Value des ERSTEN Feldes.
Hilfeinformation

Ausführen eines SQL-Statements und Rückgabe der Value des ERSTEN Feldes.
Die Rückgabe ist Variant oder .NULL.
Die Datenbankangaben:
      CSYSDIR! => My.Clients.Path.cSysDir
      CDBFDIR! => My.Clients.Path.cDbfDir
      CFRXDIR! => My.Clients.Path.cFrxDir
      CNETDIR! => My.Clients.Path.cNetDir
      CTMPDIR! => My.Clients.Path.cTmpDir
werden unter VFP-Tabellen in den entsprechenden Pfad umgewandelt!
Bei der Verwendung eines SQL-Servers werden diese Informationen gegen den Datenbanknamen im SQL-Server ausgetauscht.
Aufrufinformation


Variant = My.Functions.Dateien._SqlReadValue(tcSql AS String,tiValue AS Integer)
Variant = My.Functions.Dateien._SqlReadValue(tcSql,tiValue)


Codeinformation


LOCAL lcSql AS String , lvValue AS Variant
*/ Gibt den Inhalt der ERSTEN Spalte zurück
lcSql = [SELECT bezei,kurz,master FROM CSYSDIR!Y01 WHERE idc26="DE " AND ipy01="SU"]
lvValue = My.Functions.Dateien._SqlReadValue(m.lcSql)		&& y01.Bezei
*/ Gibt den Inhalt der ZWEITEN Spalte zurück
lcSql = [SELECT bezei,kurz,master FROM CSYSDIR!Y01 WHERE idc26="DE " AND ipy01="SU"]
lvValue = My.Functions.Dateien._SqlReadValue(m.lcSql,2)	&& y01.Kurz


_SqlUpdate() - Einen Cursor updaten

 UPDATE eines lokalen Cursors gegenüber der angegebenen Tabelle durchführen.
Hilfeinformation

UPDATE eines lokalen Cursors gegenüber der angegebenen Tabelle durchführen.
Die Rückgabe ist Boolean oder .NULL.
Der Cursor MUSS die Spalten __Changed und __New enthalten!
Außerdem MUSS die Zieltabelle die Spalte LastUpd enthalten!
Aufrufinformation


Variant = My.Functions.Dateien._SqlUpdate(tcTable AS STRING,tcAlias AS STRING,tcIdName AS STRING,tcFilter AS String)
Variant = My.Functions.Dateien._SqlUpdate(tcTable,tcAlias,tcIdName,tcFilter)


Codeinformation


LOCAL lcSql AS String , tlUpdate AS Boolean
lcSql = [SELECT * FROM CDBFDIR!B01 WHERE b01.artnr='SIE.3TH']
*/ Lesen der Daten vom Backend
IF My.Functions.Dateien._SqlRead(m.lcSql,"qB01",1)
	*/ Ändern der Daten...
	SELECT qB01
	REPLACE ALL match WITH "LEISTUNGSSCHALTER",__Changed WITH .T.
	tlUpdate = My.Functions.Dateien._SqlUpdate("B01",ALIAS(),"IDB01")
	IF NOT m.tlUpdate
		WAIT WINDOW My.Functions.Dateien.cLastError
	ENDIF
ENDIF


_SqlUpdateAll() - Eine Cursorliste updaten

 UPDATE eines lokalen Cursors gegenüber der angegebenen Tabelle durchführen.
Hilfeinformation

UPDATE mehrerer lokaler Cursor gegenüber den angegebenen Tabellen durchführen.
Die Rückgabe ist Boolean oder .NULL.
Die Cursor MUSS die Spalten __Changed und __New enthalten!
Außerdem MUSS die Zieltabelle die Spalte LastUpd enthalten!
Aufrufinformation


;Filter1 = My.Functions.Dateien._SqlUpdateAll(tcList AS STRING)
;Filter1 = My.Functions.Dateien._SqlUpdateAll(tcList)


Codeinformation


LOCAL tlUpdate AS Boolean
*/ Lesen der Daten vom Backend
IF My.Functions.Dateien._SqlRead([SELECT * FROM CDBFDIR!B01 WHERE b01.artnr='SIE.3TH'],"qB01",1) AND ;
	My.Functions.Dateien._SqlRead([SELECT d03.* FROM CDBFDIR!D03 INNER JOIN CDBFDIR!B01 ON d03.idd03=b01.idd03 WHERE b01.artnr='SIE.3TH'],"qD03",1)
	*/ Ändern der Daten...
	UPDATE qB01 SET lang = qD03.bez, __Changed = .T. FROM qD03 WHERE qB01.idd03=qD03.idd03
	UPDATE qD03 SET ekpdatum = My.xDate, __Changed = .T.
	tlUpdate = My.Functions.Dateien._SqlUpdateAll("B01;QB01;IDB01#D03;QD03;IDD03")
	IF NOT m.tlUpdate
		WAIT WINDOW My.Functions.Dateien.cLastError
	ENDIF
ENDIF
*/ Hinweis:
*/	Der Update der einzel angegebenen Cursor wird mit einer Transaktion durchgeführt!
*/	Läuft einer der Updates auf einen Fehler wird die Änderung rückgängig gemacht!
*/ Der String ist folgendermaßen aufgebaut:
*/	"Tableinfo1#Tableinfo2#Tableinfo3#..."
*/ Tableinfo:
*/	Tabelle;Cursor;ID-Field[;Filter]


fAppendFile() - Dateien zusammenfassen

 Rückgabe:[Integer], Fürgt zwei Dateien zusammen in der Zieldatei und löscht die QuellDatei.
Hilfeinformation

Rückgabe:[Integer], Fürgt zwei Dateien zusammen in der Zieldatei und löscht die QuellDatei.
Aufrufinformation


Integer = My.Functions.Dateien.fAppendFile(LPARAMETER tcZiel, tcQuelle)
Integer = My.Functions.Dateien.fAppendFile(LPARAMETER,tcQuelle)


Codeinformation




fEmpty() - Leere Datei?

 Rückgabe:[Boolean], Prüft ob eine angegebene Datei leer ist. Gibt .T. zurück, wenn die Datei nicht vorhanden ist.
Hilfeinformation

Rückgabe:[Boolean], Prüft ob eine angegebene Datei leer ist. Gibt .T. zurück, wenn die Datei nicht vorhanden ist.
Aufrufinformation


Boolean = My.Functions.Dateien.fEmpty(LPARAMETER tcfile)
Boolean = My.Functions.Dateien.fEmpty(LPARAMETER)


Codeinformation




fMove() - Datei verschieben

 Rückgabe:[Boolean], Verschiebt eine angegebene Datei.
Hilfeinformation

Rückgabe:[Boolean], Verschiebt eine angegebene Datei.
Aufrufinformation


Boolean = My.Functions.Dateien.fMove(LPARAMETER tcdat, tcDir)
Boolean = My.Functions.Dateien.fMove(LPARAMETER,tcDir)


Codeinformation




getFileInfoString() - Intern

 Rückgabe:[String], Gibt einen String zurück Zwecks Vergleich (Infos kommen aus aDir)
Hilfeinformation

Rückgabe:[String], Gibt einen String zurück Zwecks Vergleich (Infos kommen aus aDir)
Aufrufinformation


String = My.Functions.Dateien.getFileInfoString(tcFile AS STRING)
String = My.Functions.Dateien.getFileInfoString(tcFile)


Codeinformation




Liste der Properties von Dateien


cLastError - Letzter Fehler

 Mit dieser Property kann der letzte Fehler im Klartext abgerufen werden.
Hilfeinformation

Mit dieser Property kann der letzte Fehler im Klartext abgerufen werden.
Aufrufinformation


String = My.Functions.Dateien.cLastError


Codeinformation


*/ Vorausgesetzt wird, dass My bekannt ist...
LOCAL lcError AS String
lcError = My.Functions.Dateien.cLastError


cLogDir - LOG-Dateien

 Verzeichnis der LOG-Dateien
Hilfeinformation

Verzeichnis der LOG-Dateien
Normalerweise zu finden unter c:\benutzer\\appdata\local\temp\pms32\
Nach Beenden von PMS32 sind dir Daten unter: \\server\pms$\pms32\log\TERMINAL # USER\ zu finden...
Aufrufinformation


String = My.Functions.Dateien.cLogDir


Codeinformation


IF !DIRECTORY(My.Functions.Dateien.cLogDir)
	*/ Benötigte Pfade sollten eigentlich da sein!
	=MESSAGEBOX("Pfad fehlt:" + My.Functions.Dateien.cLogDir,64,"LOG-Dateien")
ENDIF


cMethod - Methode des Fehlers

 Methode in der der letzte Fehler auftrat.
Hilfeinformation

Methode in der der letzte Fehler auftrat.
Aufbau: [Fehlernummer] [Methode] [Zeilennummer] [Message]
Aufrufinformation


String = My.Functions.Dateien.cMethod


Codeinformation


*/ Abruf...
WAIT WINDOW My.Functions.Dateien.cMethod


lShowThermos - Thermosanzeige

 Thermosanzeige bei der Ausführung
Hilfeinformation

Thermosanzeige bei der Ausführung
Aufrufinformation


Boolean = My.Functions.Dateien.lShowThermos


Codeinformation


My.Functions.Dateien.lShowThermos = .T.


nError - Fehlernummer d. Fehlers

 Fehlernummer des letzten Fehlers.
Hilfeinformation

Fehlernummer des letzten Fehlers.
Ist der Wert kleiner null, so handelt es sich um einen logischen Fehler.
Aufrufinformation


Number = My.Functions.Dateien.nError


Codeinformation


WAIT WINDOW My.Functions.Dateien.nError


nLine - Zeilennummer d. Fehlers

 Zeilennummer, in der der letzte Fehler auftrat
Hilfeinformation

Zeilennummer, in der der letzte Fehler auftrat
Aufrufinformation


Number = My.Functions.Dateien.nLine


Codeinformation


WAIT WINDOW My.Functions.Dateien.nLine


nRecords - Verarbeitete Datensätze

 Verarbeitete Datensätze
Hilfeinformation

Verarbeitete Datensätze
Aufrufinformation


Number = My.Functions.Dateien.nRecords


Codeinformation


WAIT WINDOW My.Functions.Dateien.nRecords


nSeconds - Ausführungszeit

 Ausführungszeit in Sekunden
Hilfeinformation

Ausführungszeit in Sekunden
Aufrufinformation


Number = My.Functions.Dateien.nSeconds


Codeinformation


WAIT WINDOW My.Functions.Dateien.nSeconds


nStatus - Status der Ausführung

 Status der Ausführung
Hilfeinformation

Status der Ausführung
Aufrufinformation


Number = My.Functions.Dateien.nStatus


Codeinformation


WAIT WINDOW My.Functions.Dateien.nStatus


oSelected - Datenumgebung

 Merkt sich die Datenumgebung für eine Verarbeitung.
Hilfeinformation

Merkt sich die Datenumgebung für eine Verarbeitung.
Beim Release der Variable wird die vorherige Datenumgebung wieder hergestellt.
Aufrufinformation


Object = My.Functions.Dateien.oSelected


Codeinformation


LOCAL loSelected AS My_Fu_Selected
loSelected = My.Functions.Dateien.oSelected
*/ Danach können Tabellen und Cursor geöffnet werden...

*/ Mit dem Nachfolgenden Befehl wird der obige Zustand der Datenumgebung wieder hergestellt
RELEASE loSelected


oThermos - temp. Thermos

 Instanziiert einen temporären Thermos
Hilfeinformation

Instanziiert einen temporären Thermos
Aufrufinformation


Object = My.Functions.Dateien.oThermos


Codeinformation


LOCAL loThermos AS My_Sy_Thermos
*/ Instanziieren
loThermos = My.Functions.Dateien.oThermos

loThermos.AutoCenter = .T.
loThermos.cFaktor(1,1/10,.F.,"Info-1...")
loThermos.cFaktor(1,2/10,.F.,"Info-2...")
*/ ...
*/ Schliesst den Thermos
RELEASE loThermos





Siehe auch :
Hauptmenü / 
Hauptindex / 
Such Index / 
Cursor Index / 
Programm Module / 
Tabellen Index / 
Tabellenmodule / 
Masken Index / 
Programmcode Index / 
Servicepacks / 
My.Struktur / 
Funktionen / 
Sonstiges Index

 Lokale Benutzerhilfe : Meine eigene Hilfe / 
Zurück zur PMS32 - Hilfe






Dateiversion:1.0.04#3648 - H.U.DD#SSFF 02.12.2022 

Senden Sie Ihren Kommentar zu diesem Thema an das Entwicklungsteam von PMS32 
Weitere Informationen finden Sie unter der aktuellen 
PMS32 WEB-Hilfe

Die Informationen dieser Mitteilung sind vertraulich und nur für Sie bestimmt. Unbefugtes Weiterleiten,
 Veröffentlichen, Kopieren usw. sind untersagt und werden gerichtlich verfolgt. 
© PMS Compelec GmbH 2022 ® el-Projekt