Funktionsbibliothek Standard1
Beschreibung:
Mit der Funktionsbibliothek "Standard1" kann in alle Makros ein erweitereter Befehlsumfang eingebunden werden. Hierzu wird die Funktionsbibliothek über den Befehl
MacroInclude "Standard1"
in das Makro eingebunden. Anschließend können die in der Funktionsbibliothek vorhandenen Funktionen direkt in den eigenen Macros genutzt werden. Viele Hilfsmittel setzen die Installation dieser Makrobibliothek voraus. Um diese Makrobibliothek nutzen zu können müssen Sie mindestens über die AG-VIP SQL 1.21.002 oder höher verfügen. Eine Beschreibung der durch diese Bibliothek verfügbaren neuen Funktionen finden Sie nachfolgend.
Einrichtung:
- Bitte laden Sie die ZIP-Datei am Ende dieses Artikels herunter.
- Enpacken Sie die Dateien im Ordner <AGVIP SQL Installationsverzeichnis>\Samples
(bpw. C:\Programme\AG-VIP SQL\Samples) - Klicken Sie unter Administration -> Makro Includes -> Import
Wählen Sie nun die Datei "Standard1.agminc" - Fügen Sie anschließend die Zeile MacroInclude "Standard1" im Kopfbereich des Makros ein, indem Sie eine Funktion aus dieser Bibliothek verwenden wollen.
WICHTIGE HINWEISE:
Nehmen Sie bitte keine Veränderungen in den Funktionen dieser Bibliothek vor. Wir erweitern diese beständig. Wenn Sie eine aktuellere Version dieser Bibliothek zum Einsatz bringen wollen, würden Ihre Änderungen verloren gehen.
Wenn Sie an den Funktionen Anpassungen vornehmen wollen, erstellen Sie bitte eine Kopie dieser Bibliothek. (Z.B. mit dem Namen "AngepassteStandard1"). Damit bleibt Ihr System auch bei Anpassungen "Updatefähig".
Vorraussetzungen zur Nutzung dieser Funktionsbibliothek:
Es muss mindestens AG-VIP SQL 1.21.002 Build 454 vom 22.11.2010 auf dem System installiert sein.
Einige wenige Funktionen nutzen spezielle Shell-Objekte o.ä. die nicht in einer 64-Bit Umgebung lauffähig sind. Sofern diese jedoch nicht aufgerufen werden kann die Bibliothek auch unter 64-Bit Systemen verwendet werden.
Beschreibung der durch diese Funktionsbibliothek verfügbaren Funktionen:
1. Allgemein
2. Datum, Uhrzeit und Zahlen
3. Interaktion und Dateizugriff
4. Hilfsmittel- und Systemfunktionen
5. Datenbank
1. Allgemein:
- getTempDir() - Gibt das temporäre Verzeichnis auf dem Client zurück.
- getComputerName() - Gibt den Namen des Clientcomputers zurück.
- getOS() - Gibt den Namen des Clientbetriebssystems zurück.
- getBit() - Ermittelt ob ein System ein 32 oder 64 Bit Betriebssystem nutzt.
- getHomeDir() - Gibt das Homeverzeichnis des angemeldeten Windowsbenutzer zurück.
- getUser() - Gibt den Namen das angemeldeten Windowsbenutzer zurück.
- getDialprefix(ISOCountry) - Gibt für 'DEU' z.B. 49 zurück.
- ReplaceCHR(strText, sChr, nChr) - Gibt den Text mit ersetztem Inhalt zurück.
- URLDecode(strText) - Gibt den angegebenen Text als Klartext zurück, wenn er URLDecoded ist.
- URLEncode(strText) - Gibt den übergebenen Text als URL für die Adresse eines Browsers zurück. (z.B. werden leerzeichen mit %20 ersetzt)
- makeHTMLtags(strText) - Gibt den Text als umgewandelten HTML-Text zurück (Umlaute etc.)
- checkFields(goback, doMsg, fields) - Nimmt eine Inhaltsprüfung auf das entsprechende Feld vor und bricht einen Speichervorgang mit einer Meldung ab.
- checkFieldFilled(fieldname) - Nimmt eine Inhaltsprüfung auf das entsprechende Feld vor.
- getFieldType(fieldname) - Gibt den Feldtyp zurück. (Als verständlichen Text)
- CreateSalutation() - Erzeugt für die aktive Adresse eine Briefanrede anhand der Felder Titel, Anrede und Nachname in deutscher Sprache.
- CreateShortName(searchPosLength) - Erzeugt einen Kurznamen aus den Feldern, Name1 und Nachname.
- getIPAddresses() - Gibt die IP-Adressen des Clientcomputers zurück.
- ISOtoCountry(ISOCountry) - Gibt für eine ISO-Länderbezeichnung den Landesnamen zurück. (DEU -> Deutschland)
- isoCode(value, TypeIn, TypeOut) - Konvertiert einen Wert entweder in den Namen des Landes, den ISO-Alpha-2, den ISO-Alpha-3, den Numerischen ISO-Code, die Domainendung, den IOC-Code, den UN/LOCODE oder den ISO-3166-2 Code. Die Eingabe und Ausgabe kann frei zwischen den Formaten konvertiert werden.
- getHsNr(Strasse) - Versucht aus dem übergebenen Wert die Hausnummer zu extrahieren.
- getStrName(Strasse) - Versucht den Strassenteil aus dem übergebenen Wert zu extrahieren.
- getPosHsNrInStrasse(Strasse) - Systembibliothek (Verwendung in Hilfsmitteln oder Subfunktion)
- ConvertUtf8(s) - Ermittelt den UTF8-Wert einer Zeichenkette.
- Utf8(ByVal c) - Ermittelt den UTF8-Wert eines Zeichens. Systembibliothek (Verwendung in Hilfsmitteln oder Subfunktion)
2. Datum, Zeit und Zahlen
- CreateCheckDigit((iAccountNo, iBankcodeNo) - Systembibliothek (Verwendung in Hilfsmitteln oder Subfunktion)
- CreateIban(iAccountNo, iBankcodeNo) - Erstellt eine IBAN aus Kontonummer und Bankleitzahl (Für Konten in Deutschland)
- getAge(startDate, endDate) - Gibt das Alter in Jahren zurück.
- isBirthday(birthday, myDate) - Ermittelt ob an dem Datum myDate der Geburtstag für das Datum birthday liegt.
- enDate(myDate) - Gibt ein gegebenes Datum im englischen Format zurück.
- enNumber(myNumber) - Gibt für eine gegebene Zahl die Zahl im englischen Format zurück.
- onlyDigits(Nummer) - Gibt aus einem übergebenen Wert nur die Zahlen zurück.
- DateSernumber(myDate) - Gibt ein gegebens Datum serialisiert als Nummer zurück. (20110822 für den 22.08.2011)
- DateAddWorkDays1(startDate, days) - Rechnet zu einem Datum Werktage hinzu und gibt das neue Datum aus.
- DateAddWorkDays2(startDate, days) - Rechnet zu einem Datum Werktage unter Berücksichtigung bundeseinheitlicher Feiertage in Deutschland hinzu.
- listLegalDates(startDate, endDate) - Gibt eine Liste der bundeseinheitlichen Feiertage zwischen zwei Dati zurück.
- isLeapYear(CYear) - Ermittelt ob eine Jahreszahl ein Schaltjahr ist. Systembibliothek (Verwendung in Hilfsmitteln oder Subfunktion)
- GetEasternSunday(CYear) - Gibt den Ostersonntag für ein Jahr zurück. Systembibliothek (Verwendung in Hilfsmitteln oder Subfunktion)
- Get4Advent(CYear) - Gibt den 4. Advent in einem Jahr zurück. Systembibliothek (Verwendung in Hilfsmitteln oder Subfunktion)
- GetLegalDate(myDate) - Gibt den bundeseinheitlichen Feiertag zu einem Datum zurück.
3. Interaktion und Dateizugriff
- openPath(sPath) - Öffnet den übergebenen Pfad als URL, im Windowsexplorer oder eine im Clientsystem registrierte Datei.
- PopUpBox(Message, isType, Title, sektimeout) - Erstellt ein Popupfenster über Wshell.PopUp)
- saveFileFromWeb(sSource, sDest) - Speichert eine Datei aus einer Webadresse (FTP/WWW) in einem angegebenen Pfad.
- displayIEWindows(body, width, height) - Generiert ein Internetexplorerfenster als PopUp.
- checkFileExist(sFile) - Prüft ob eine Datei vorhanden ist.
- AppendLinetotxtFile(sline, sFile) - Fügt an eine Datei eine Zeile an.
- readtxtFile(sFile) - Liest den Inhalt einer Datei
- sPass(strLength) - Erzeugt ein zufälliges Passwort mit angegebener Länge.
- CheckNext(strnext, Strpass, strSeed, strDebug) - Systembibliothek (Verwendung in Hilfsmitteln oder Subfunktion)
- GenIt(MFactor) - Systembibliothek (Verwendung in Hilfsmitteln oder Subfunktion)
- sGUID() - Erzeugt eine neue GUID
- htmlTop() - Erzeugt den Kopfteil einer HTML-Datei
- htmlEnd() - Erzeugt den Fußteil einer HTML-Datei.
4. Hilfsmittel- und Systemfunktionen
- getFieldStrValue(sField,sDevider,bEscapeHTML, bDebug) - Systembibliothek (Verwendung in Hilfsmitteln oder Subfunktion)
- SetText(EmailText, html, Kennzeichenlistentrennzeichen, bDebug) - Systembibliothek (Verwendung in Hilfsmitteln oder Subfunktion)
- createSMTPMail(.....) - Systembibliothek (Verwendung in Hilfsmitteln oder Subfunktion)
- createMailToEmail(.....) - Systembibliothek (Verwendung in Hilfsmitteln oder Subfunktion)
- SendNotesMail(.....) - Systembibliothek (Verwendung in Hilfsmitteln oder Subfunktion)
- CreateNotesMail(.....) - Systembibliothek (Verwendung in Hilfsmitteln oder Subfunktion)
- abortSave(msg) - Bricht einen aktuellen Speichervorgang ab.
- showError(msg, abort, logPath) - Erzeugt eine Fehlermeldung und bricht ggf. den aktuellen Speichervorgang ab und schreibt ggf. ein Logeintrag.
- writeLog(msg, LogPath) - Schreibt einen Logeintrag.
- checkVer(needVersion) - Erlaubt die benötigte Version der Standard1-Bibliothek zu prüfen.
- xordecode(key, value) - Erlaubt eine einfache XOR-Decodierung.
- xorencode(key, value) - Erlaubt eine einfache XOR-Verschlüsselung.
5. Datenbank (Bitte beachten Sie das wir für direkte Datenbankzugriffe keinen Support leisten!)
- getinternalAddressTable(Adresstabellenname) - Gibt den internen Adresstabellennamen der übergebenen Adresstabelle aus.
- getinternalProjectTable(AdressTablename, ProjectTablename) - Gibt den internen Namen einer Projekttabelle zu einer gegebenen Adresstabelle und einer Projekttabelle aus.
- getinternalRelationTable(AdressTablename, RelationTablename) - Gibt den internen Namen einer Zusatztabbelle zu einer gegebenen Adresstabelle und einer Zusatztabelle aus.
- getServerName() - Gibt den SQL-Servernamen zurück mit dem eine Verbindung besteht.
- getServerVersion() - Gibt die Version und Plattform des SQL-Servers zurück, zu dem eine Verbindung besteht.
Angehängte Dateien: