PMS32 Online- Hilfereferenz
Lic - Steuert die Lizenzen in PMS32. Zugriff auf System- und Mandantenpfad
Steuert die Lizenzen in PMS32. Zugriff auf System- und Mandantenpfad
*/ Kurzbeispiel für den Zugriff auf diese Struktur */ Der Zugriff erfolgt über: My.Clients.Lic */ 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 loLic AS My.Clients.Lic */ Setzen der Variablen loLic = My.Clients.Lic */ Jetzt erst die Schleifen durchlaufen... man beachte ALL, dass können ne Menge Sätze sein... REPLACE ALL Feldname1 WITH loLic.Function1(),Feldname2 WITH loLic.Function1(), ... */ Oder in einer Schleife... SCAN lvValue = loLic.Function(Alias.Spalte) + 25 lvValue = loLic.Function2(m.lvValue) REPLACE Feldname WITH m.lvValue,... ENDSCAN */ Es sind auch geschachtelte Aufrufe möglich...
Rückgabe: [Boolean], Reset aller Einstellungen vornehmen.
Variant = My.Clients.Lic.ClearIt()
Variant = My.Clients.Lic.GetICinX03(txUsr as String,tcIC as String) Variant = My.Clients.Lic.GetICinX03(txUsr,tcIC)
Rückgabe:[Variant], Rückgabe der LV-Nummer (erste Stelle der ID) als numerischer oder Char. Wert. Je nach Übergabe von tvLVNumbe
Variant = My.Clients.Lic.GetLVNumber(tvLVNumber as Variant) Variant = My.Clients.Lic.GetLVNumber(tvLVNumber)
Integer = My.Clients.Lic.GetModulCountInUse(tnModul as Double) Integer = My.Clients.Lic.GetModulCountInUse(tnModul)
Ruft die Value einer Property in der Klasse ab.
Die Parameter: tcProperty as String
tcProperty: Name der Property in der Klasse
Variant = My.Clients.Lic.GetProperty(tcProperty as String,tnAsXMLStructure as Variant) Variant = My.Clients.Lic.GetProperty(tcProperty,tnAsXMLStructure)
*/ Vorausgesetzt wird, dass My bekannt ist... LOCAL lnError AS Number lnError = My.Clients.Lic.GetProperty('nError')
Variant = My.Clients.Lic.GetUsrFromXUsr(tcXUser as String) Variant = My.Clients.Lic.GetUsrFromXUsr(tcXUser)
Ruft die Value einer Variablen in der Klasse ab.
Die Parameter: tcVariable as String
Variant = My.Clients.Lic.GetValue(tcScript as String) Variant = My.Clients.Lic.GetValue(tcScript)
*/ Vorausgesetzt wird, dass My bekannt ist... LOCAL lcIdx02 AS String lcIdx02 = My.Clients.Lic.GetValue('My.cIdx02') IF !ISNULL(m.lcIdx02) WAIT WINDOW m.lcIdx02 ELSE */ My in der Klasse nicht bekannt! ENDIF
Rückgabe: [Boolean], Wird nicht mehr benötigt...
Variant = My.Clients.Lic.ResetAllServer(tcTest as String) Variant = My.Clients.Lic.ResetAllServer(tcTest)
Variant = My.Clients.Lic.SetICInX03(txUsr as String,tcIC as String) Variant = My.Clients.Lic.SetICInX03(txUsr,tcIC)
Setzt die Value an die benannte Property.
Die Parameter: tcProperty as String,tvValue as Variant,tnAsObject as Integer
tcProperty: Name der Property in der Klasse
tvValue: Value der Property
tnAsObject: 0=Value, 1=C-Structure, 2=XML
Wird tnAsObject nicht angegeben, so wird 0=Value vorausgesetzt
Variant = My.Clients.Lic.SetProperty(tcProperty as String,tvValue as Variant,tnAsObject as Integer) Variant = My.Clients.Lic.SetProperty(tcProperty,tvValue,tnAsObject)
*/ Als Beispielcode für eine Klasse in einem COM+ Server */ Vorausgesetzt wird, dass My bekannt ist... =My.Clients.Lic.SetProperty('nError',0,0) */ oder auch... =My.Clients.Lic.SetProperty('nError',0)
Variant = My.Clients.Lic.Terminate()
Boolean = My.Clients.Lic.TestAndSetExtern(tnModul as Integer,tcUser as String) Boolean = My.Clients.Lic.TestAndSetExtern(tnModul,tcUser)
Rückgabe: [Boolean], Testet, ob das Modul frei ist und registriert es.
Variant = My.Clients.Lic.TestAndSetModul(tcDbfDir as String,tnModul as Integer,tcUser as String) Variant = My.Clients.Lic.TestAndSetModul(tcDbfDir,tnModul,tcUser)
Rückgabe: [Boolean], Testet, ob das Modul frei ist OHNE es zu aktivieren.
Variant = My.Clients.Lic.TestModul(tcDbfDir as String,tnModul as Integer) Variant = My.Clients.Lic.TestModul(tcDbfDir,tnModul)
Mit dieser Methode kann eine Protokollierung div. Informationen in einem LOG File erfolgen.
Diese Methode ist 'nur' bei den NameSpace Servern von PMS zu finden!
Variant = My.Clients.Lic.WriteSettings(tcWann as String) Variant = My.Clients.Lic.WriteSettings(tcWann)
*/ Als Beispielcode für eine Klasse in einem COM+ Server */ Vorausgesetzt wird, dass My bekannt ist... =My.Clients.Lic.WriteSettings('Heute um 15:00Uhr') */ oder auch... =My.Clients.Lic.WriteSettings(TTOC(DATETIME(),1)) && Ausgabe: JJJJMMTThhmmss
Diese Property gibt es nur bei NameSpace Servern, dies sind Programmteile, die in einem geschützten Speicherbereich ablaufen. Sollten Sie mal von außen auf den NameSpace von PMS32 zugreifen und es fehlt Ihnen die Aufrufinformationen, so kann obiger String aus der Registry ermittelt werden.
String = My.Clients.Lic._Clsid
LOCAL lcClsID AS String lcClsID = My.Clients.Lic._Clsid WAIT WINDOW m.lcClsID
Diese Property gibt es nur bei NameSpace Servern, dies sind Programmteile, die in einem geschützten Speicherbereich ablaufen.
String = My.Clients.Lic._ComServer
LOCAL lcComServer AS String lcComServer = My.Clients.Lic._ComServer WAIT WINDOW m.lcComServer
Boolean = My.Clients.Lic._Isreleased_
Dateiname der Applikation. Wenn unter Vfp gestartet wird! sind diese Werte NICHT gesetzt! Die Property _Name gibt den Klassennamen der EXE bzw. DLL zurück.
Mit diesem Namen und dem Namen der EXE/DLL kann dann die COM+ Klasse instanziiert werden. Gleiches kann man auch aus den Eigenschaften der Programmklasse
EXE/DLL herausfinden.
String = My.Clients.Lic._Name
LOCAL lcComName AS String lcComName = My.Clients.Lic._Name WAIT WINDOW m.lcComName
Variant = My.Clients.Lic._Pcreleaselog_
Die Property _ServerName gibt den kompletten Klassennamen der EXE bzw. DLL zurück.
Mit diesem Namen und dem Namen der EXE/DLL kann dann die COM+ Klasse instanziiert werden.
Gleiches kann man auch aus den Eigenschaften der Programmklasse EXE/DLL herausfinden.
String = My.Clients.Lic._ServerName
LOCAL lcServerName AS String lcServerName = My.Clients.Lic._ServerName WAIT WINDOW m.lcServerName
Die Property gibt den Startmodus des Aufrufers zurück. Es gibt insgesamt 6 Modi:
0 - Unter VFP Entwicklung
1 - Unter VFP-COM Steuerung
2 - Start als COM.EXE
3 - Start als COM.DLL in Singleprocess
4 - Start als EXE (Standard Programmaufruf)
5 - Start als COM.DLL in Multiprocess
Number = My.Clients.Lic._StartMode
*/ Abfrage des Modus WAIT WINDOW My.Clients.Lic._StartMode
Gibt den verwendeten Speicher des Namespace zurück.
Rückgabe ist Byte.
Integer = My.Clients.Lic._Sys1016
LOCAL liBytes AS Integer */ Abfrage des Speichers liBytes = My.Clients.Lic._Sys1016 WAIT WINDOW LTRIM(STR(m.liBytes/1024))+" kB"
Versionsnummer nach PMS32 Konvention. H.U.DD.SSHH.bbbb
Die Property _Version gibt die Programmversion (gilt für DLL, EXE und auch für APP) zurück.
H - Hauptversion
U - Unterversion
DD - Datenbankversion
SS - Servicepack
HH - Hotfix
bbbb- Buildnumber
String = My.Clients.Lic._Version
WAIT WINDOW My.Clients.Lic._Version
VFP Version der VFP-9 dll.
String = My.Clients.Lic._VfpVersion
WAIT WINDOW My.Clients.Lic._VfpVersion
Mit dieser Property kann der Name der Applikation abgerufen werden.
String = My.Clients.Lic.cAppNameExe
*/ Als Beispielcode für eine Klasse in einem COM+ Server */ Vorausgesetzt wird, dass My bekannt ist... LOCAL lcName AS String lcName = My.Clients.Lic.cAppNameExe
String = My.Clients.Lic.cClass
Mandanten-ID. Diese ist in der Datei pms32.pth gespeichert und dient dort zur Zuordnung des Mandante und dessen Pfade.
Auszug aus der Pfaddatei pms32.pth:
*/ Verzeichnis der Microcube - Dateien. Wenn leer dann gleich: cDbfdir
cCubdir = ""
*/ Ein 'anderes' Dokumentenverzeichnis kann angegeben werden. Wenn nicht angegeben dann gleich: cDbfdir+'docs\'
*/ cDocDir = ""
*/ Verzeichnis der Mandantentabellen. Hier ein Beispiel mit UNC Pfaden.
*/ Wird die Freigabe auf dem Server 'versteckt' \pms$\ angegeben, so kann ein Cryptovirius das Verzeichnis nicht finden!
cDbfdir = "\\server\pms$\pms32\daten\demo.32\"
*/ Verzeichnis der Reporttabellen
*/ Gibt man Bilddateien in einem Report mit My.Clients.Path.cFrxDir+'BILDNAME.JPG' an, so kann PMS32 einfach auf einen anderen Rechner kopiert werden!
cFrxdir = "\\server\pms$\pms32\reports\demo.32\"
*/ Beschreibung des Mandanten
cIcx02 = "TESTMANDANT DEMO"
*/ ID der Firmenparameter zum Mandant.
cIdx09 = "DEMO"
*/ Kann unter der Mandanteninformation leer sein, wenn für mehrere Mandanten das 'gleiche' Systemverzeichnis gültig ist.
cSysdir = ""
*/ Willkommens-Information als Hintergrundbild in PMS32
cWelcome= "pms32.htm"
*/ Nummer des Mandanten, beim Einsatz eines BarcodeScanners sollte diese Nummer EINDEUTIG sein!
nNumber = 1
<>
String = My.Clients.Lic.cIdx02
*/ Abfrage der Mandanten-ID WAIT WINDOW My.Clients.Lic.cIdx02 */ Wenn man mittels VFP Zugriff auf die Applikation braucht: */ 1. vfp9.exe öffenen */ 2. In das Startverzeichnis von PMS32 wechseln (MUSS) CD c:\pms\pms32 */ 3. My Instanziieren My = NEWOBJECT("pmsmy","pmsmyhandler.vcx","pmsmyhandler.app") */ 4. Den letzten aktuellen Mandanten zuweisen My.cIdx02 = My.cIdx02 */ 5. Los gehts...
Mit dieser Property kann der letzte Fehler im Klartext abgerufen werden.
String = My.Clients.Lic.cLastError
*/ Vorausgesetzt wird, dass My bekannt ist... LOCAL lcError AS String lcError = My.Clients.Lic.cLastError
String = My.Clients.Lic.cLicDecoded
Methode in der der letzte Fehler auftrat.
Aufbau: [Fehlernummer] [Methode] [Zeilennummer] [Message]
String = My.Clients.Lic.cMethod
*/ Abruf... WAIT WINDOW My.Clients.Lic.cMethod
Netzwerkverzeichnis von PMS32.
Das Verzeichnis ist normalerweise unter: \\server\pms$\pms32\ zu finden...
String = My.Clients.Lic.cNetDir
IF !DIRECTORY(My.Clients.Lic.cNetDir) */ Benötigte Pfade sollten eigentlich da sein! =MESSAGEBOX("Pfad fehlt:" + My.Clients.Lic.cNetDir,64,"Netzwerkverzeichnis") ENDIF
Reset C-Structure
Diese Property ist normalerweise WriteOnly! Sie dient zum Zurücksetzen verschiedener Informationen.
#DEFINE CRI_REMOVE_MENUES "REMOVE-MENUES"
#DEFINE CRI_REMOVE_CSFILES "REMOVE-CS-FILES"
#DEFINE CRI_REMOVE_SCRIPTS "REMOVE-CS-SCRIPTS"
#DEFINE CRI_CHANGE_IDX09 "CHANGE-IDX09"
#DEFINE CRI_LOGIN "USER_LOGIN"
String = My.Clients.Lic.cResetInfos
*/ Verschiedene RESET Befehle... My.Clients.Lic.cResetInfos = "REMOVE-MENUES" My.Clients.Lic.cResetInfos = "REMOVE-CS-FILES" My.Clients.Lic.cResetInfos = "REMOVE-CS-SCRIPTS" My.Clients.Lic.cResetInfos = "CHANGE-IDX09" My.Clients.Lic.cResetInfos = "USER_LOGIN" */ Je nach Klasse wird ein entsprechender RESET ausgeführt!
Verzeichnis der Systemtabellen von PMS32
Das Verzeichnis ist normalerweise unter: \\server\pms$\pms32\dbf\ zu finden...
String = My.Clients.Lic.cSysDir
IF !DIRECTORY(My.Clients.Lic.cSysDir) */ Benötigte Pfade sollten eigentlich da sein! =MESSAGEBOX("Pfad fehlt:" + My.Clients.Lic.cSysDir,64,"Systemverzeichnis") ENDIF
Variant = My.Clients.Lic.e_cError
Error - Message 1. Siehe auch e_nError.
Variant = My.Clients.Lic.e_cMessage1
Message 2 - Fehlermeldung. Siehe auch e_nError
Variant = My.Clients.Lic.e_cMessage2
Fehlermeldung 3. Siehe auch e_nError
Variant = My.Clients.Lic.e_cMessage3
Methode, in der der Fehler auftrat.
Variant = My.Clients.Lic.e_cMethod
Fehlernummer. 0 - Kein Fehler, >0 VFP Fehler, <0 PMS Fehler
Variant = My.Clients.Lic.e_nError
Zeilennummer in der der Fehler auftrat.
Variant = My.Clients.Lic.e_nLine
Name des Computers, auf dem die LIC Datei liegt
Boolean = My.Clients.Lic.l_cComputer
Name des Laufwerks auf dem die LIC Datei liegt
Boolean = My.Clients.Lic.l_cDrive
Name des Kunden.
Boolean = My.Clients.Lic.l_cKDName
Kundennummer der LIC Datei
Boolean = My.Clients.Lic.l_cKDNumber
Ort des Kunden.
Boolean = My.Clients.Lic.l_cKDOrt
Straße des Kunden
Boolean = My.Clients.Lic.l_cKDStrasse
Buchstabe der LV-Nummer, 0-9,A-Z
Boolean = My.Clients.Lic.l_cLVNumber
Freigeschaltete Module in PMS
Boolean = My.Clients.Lic.l_cModule
Stationsnummer aus Lizenzdatei
Boolean = My.Clients.Lic.l_cStation
Ablaufdatum der Lizenz
Boolean = My.Clients.Lic.l_dEndDatum
LV-Kopplung aktiv?
Boolean = My.Clients.Lic.l_lLVActive
Nummer (Präfix) der LV-Kopplung 0-36.
Boolean = My.Clients.Lic.l_nLVNumber
Wieviel Module sind momentan in Benutzung? (SIEHE T_NMODUL)
Boolean = My.Clients.Lic.l_nModulInUse
Fehlernummer des letzten Fehlers.
Ist der Wert kleiner null, so handelt es sich um einen logischen Fehler.
Number = My.Clients.Lic.nError
WAIT WINDOW My.Clients.Lic.nError
Zeilennummer, in der der letzte Fehler auftrat
Number = My.Clients.Lic.nLine
WAIT WINDOW My.Clients.Lic.nLine
Object = My.Clients.Lic.oClass
DateTime = My.Clients.Lic.t_cLicName
DateTime = My.Clients.Lic.t_cModulTitle
Verzeichnis der Systemtabellen (auch incl. LIC-Datei)
DateTime = My.Clients.Lic.t_cPath
Nummer des Moduls, 113 => 113+n
DateTime = My.Clients.Lic.t_nModul
Anzahl der zur Verfügungsstehenden Module aus LIC.
DateTime = My.Clients.Lic.t_nModulAnz
DateTime = My.Clients.Lic.t_nModulUsed
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