Neue Datums- und Zeitformate (Funktion String) ISO Datumsformat mit Zeit. Neues Format ISO Date GMT mit Zeit. Neues Datumsformat Date RFC 1123

Transkript

1 4D Addendum 12.1 Neue Datums- und Zeitformate (Funktion String) Rich Text Bereiche PHP Datenbank-Eigenschaften Export mit SQL Umbenennung der 4D HTML Tags 4D Server, 64-bit Version Funktion, um Konvertieren von Untertabellen zu vereinfachen Unterstützung von SSL in 4D Internet Commands

2 Neue Datums- und Zeitformate (Funktion String) 4D v12.1 bietet neue automatische Formate für Datum und Zeit, die das Erstellen von Zeitstempeln vereinfachen. Diese Formate sind besonders hilfreich bei XML und Internet. Die neuen Formate sind über den vorhandenen Befehl String verfügbar. Dieser Befehl akzeptiert jetzt zum Verwalten von Kombinationen mit Datum und Zeit den optionalen dritten Parameter KombZeit. Dieser Parameter vom Typ Zeit wird nur verwendet, wenn der Parameter Ausdruck ein Datum ist (siehe unten). ISO Datumsformat mit Zeit Das Datumsformat ISO Date (gibt ein Datum im Format ISO 8601 zurück) kann jetzt ein Ergebnis aus Datum und Zeit erzeugen, wenn im dritten Parameter eine Zeit übergeben wird: $mydate:=string(current date;iso Date) // gibt zum Beispiel T00:00:00 zurück $mydate:=string(current date;iso Date;Current time) // gibt jetzt T18:11:53 zurück Neues Format ISO Date GMT mit Zeit Das neue Datumsformat ISO Date GMT ist ähnlich wie das Format ISO Date, mit dem Unterschied, dass es Datum und Zeit unter Berücksichtigung der Zeitzone angibt (das Format ISO Date gibt das lokale Datum und die lokale Zeit an). $mydate:=string(current date;iso Date GMT;Current time) // gibt T16:11:53Z zurück Beachten Sie, dass das Zeichen "Z" am Ende das GMT Format angibt. Übergeben Sie nur ein Datum, gibt der Befehl das Datum um Mitternacht (lokale Zeit) in GMT Zeit an. Das kann je nach der lokalen Zeitzone dazu führen, dass das Datum vor- oder zurückgestellt wird: $mydate:=string(current date;iso Date GMT) // gibt in Paris, Frankreich T22:00:00Z zurück Neues Datumsformat Date RFC 1123 Sie können über das neue Datumsformat Date RFC 1123 eine Kombination aus Datum und Zeit gemäß den definierten Standards RFC 822 und 1123 erstellen. Dieses Format benötigen Sie z.b., um das Ablaufdatum für Cookies in einem HTTP Header zu setzen. $mydate:=string(current date;date RFC 1123;Current time) // gibt zum Beispiel Fri, 10 Sep :07:20 GMT zurück Die angezeigte Zeit berücksichtigt die Zeitzone (GMT Zone). Übergeben Sie nur ein Datum, gibt der Befehl das Datum um Mitternacht (lokale Zeit) in GMT Zeit an. Das kann je nach der lokalen Zeitzone dazu führen, dass das Datum vor- oder zurückgestellt wird: $mydate:=mydate(current date;date RFC 1123) // gibt in Paris, Frankreich Thu, 09 Sep :00:00 GMT zurück

3 Rich Text Bereiche 4D Version 12.1 bietet verschiedene Funktionalitäten, die dem Entwickler mehr Kontrolle über Bereiche in Rich Text (mit Stilelementen) geben. Der Befehl OBJECT SET PLAIN TEXT wurde hinzugefügt, die Funktionsweise einiger vorhandener Befehle wurde geändert. Beachten Sie auch, dass einige Befehle dieses Kapitels jetzt die Systemvariable OK verändern. Neuer Befehl OBJECT SET PLAIN TEXT Der neue Befehl OBJECT SET PLAIN TEXT fügt Plain Text ('Nur Text') ein, der z.b. die Sonderzeichen <, > oder & enthält. Dieser Befehl ergänzt die Verwendung der Befehle OBJECT SET STYLED TEXT und OBJECT Get plain text. Geänderte Befehle Die Funktionsweise folgender Befehle wurde in 4D v12.1 geändert: FONT LIST: Dieser Befehl füllt jetzt auf Mac OS das Array Schrift mit den Namen der Schriftfamilien. In bisherigen 4D Versionen hat dieser Befehl auf Mac OS die Schriftnamen selbst zurückgegeben. OBJECT SET STYLED TEXT ATTRIBUTES: Wird dieser Befehl mit Attribute font name als Parameter AttrName verwendet, müssen Sie in AttrWert den Namen einer Schriftfamilie übergeben. Zum Beispiel: OBJECT SET STYLED TEXT ATTRIBUTES(*;"MyText";0;MAXLONG;Attribute font name;"arial") // Gültig OBJECT SET STYLED TEXT ATTRIBUTES(*;"MyText";0;MAXLONG;Attribute font name;"times BOLD ITALIC") // Nicht gültig (der Befehl führt nichts aus) Deshalb dürfen Sie unter Mac OS nicht den optionalen Parameter * im Befehl FONT LIST übergeben, wenn Sie die Werte mit dem Befehl OBJECT SET STYLED TEXT ATTRIBUTES verwenden wollen. OBJECT SET STYLED TEXT: Sie müssen im Parameter NeuerText Rich Text (mit Stil) übergeben. Übergeben Sie Plain Text, der die Zeichen <, > oder & enthält, wird ein Fehler erzeugt. Wenn Sie Plain Text einfügen wollen, der eines dieser Zeichen enthält, müssen Sie den neuen Befehl OBJECT SET PLAIN TEXT verwenden. Auswirkung auf die Systemvariable OK Ab 4D Version 12.1 ändern nachfolgende Befehle die Systemvariable OK: OBJECT SET STYLED TEXT ATTRIBUTES OBJECT SET STYLED TEXT OBJECT GET STYLED TEXT ATTRIBUTES OBJECT Get plain text OBJECT Get styled text Nach Ausführen dieser Befehle wird die Systemvariable OK auf 1 gesetzt, wenn kein Fehler auftritt, andernfalls auf 0. Das ist insbesondere der Fall, wenn Stil Tags nicht korrekt gewertet werden (inkorrekte oder fehlende Tags). Bei einem Fehler wird die Variable nicht geändert. Tritt ein Fehler in einer Variablen auf, wenn der Text gewertet wird, wandelt 4D den Text in reinen Text um; das hat zur Folge, dass die Sonderzeichen <, > und & in HTML Einheiten umgewandelt werden.

4 PHP Externen PHP Interpreter verwenden In 4D v 12.1 wurde das Vorgehen beim Verwenden eines externen PHP Interpreters oder eigener Module geändert. Auf diese Weise werden jetzt Konfigurationen unterstützt, bei denen die Zugriffsrechte auf den Ordner Programmdateien eingeschränkt sind. Die Initialisierungsdatei FastCGI-php (php.ini), die von 4D gestartet wird, muss jetzt in den Ordner Resources der Datenbank gelegt werden. Wird sie beim ersten Aufruf nicht gefunden, legt 4D diese mit den passenden Konfigurationsoptionen an. Mit dem in 4D integrierten Interpreter können Sie keine eigene Datei php.ini verwenden. Wollen Sie PHP Konfigurationen einsetzen, die von den standardmäßig gelieferten abweichen, müssen Sie einen externen FastCGI-php Interpreter einsetzen (mehr dazu siehe unter PHP Skripte in 4D ausführen) Hinweis: Die Datei php.ini des externen Interpreters muss die Eingabe "auto_prepend_file" enthalten, da diese den kompletten Pfadnamen für das Utility Skript 4D_Execute_PHP.php angibt. Dieses Skript finden Sie unter [4Dapplication]Resources/php/Windows oder /Mac. Fehlt diese Eingabe, lassen sich nur komplette Skripte ausführen: Das Aufrufen einer Routine aus einem Skript heraus funktioniert nicht. Änderung der Funktion PHP Execute command Um die Bearbeitung der über PHP gesendeten Daten zu vereinfachen, wurde die Funktionsweise der Befehle PHP Execute und PHP GET FULL RESPONSE vereinheitlicht. Die empfangenen Werte sind immer die gleichen wie die vom PHP Entwickler zurückgegebenen Werte. Die integrierten Prinzipien der Dateninterpretation werden jetzt unter dem Befehl PHP Execute ausführlich beschrieben.

5 Datenbank-Eigenschaften In 4D v12 sind in den Datenbank-Eigenschaften zwei neue Optionen verfügbar (Menü Design>Datenbank-Eigenschaften). Aktualisierungsrate des Cache Sie können jetzt für die Zeitspanne der automatischen Sicherung des Datenbank Cache einen Wert in Sekunden oder Minuten angeben. Diese Option ist unter Datenbank-Eigenschaften auf der Seite Datenbank/Speicher verfügbar: In 4D v12.1 ist standardmäßig der Wert 20 Sekunden eingestellt. Sie können diesen Wert je nach den spezifischen Anforderungen Ihrer Anwendung ändern. Der Algorithmus zur Sicherung des Datenbank Caches wurde überarbeitet und ist drastisch schneller, deshalb wird jetzt ein deutlich kleinerer Takt wie 20 Sekunden empfohlen (im Unterschied zu früheren Versionen mit mehreren Minuten). Japanische Daten sortieren Sie können die Sortierfolge für Zeichen der japanischen Sprache über die neue Option Traditionelle Sortierfolge setzen: Diese Option ist unter Datenbank-Eigenschaften auf der Seite Datenbank/Datenspeicherung verfügbar. Sie erscheint nur in Datenbanken, für die als aktuelle Datenbanksprache Japanisch gewählt wurde. In Datenbanken, die neu in Japanisch erstellt werden, ist diese Option standardmäßig markiert.

6 Export mit SQL In 4D v12.1 wurden die Mechanismen zum Datenexport aus einer Datenbank über SQL verbessert, so dass Entwickler die Operation je nach dem zu exportierenden Datentyp genauer konfigurieren können: Die Befehle SQL EXPORT DATABASE und SQL EXPORT SELECTION haben einen zusätzlichen Parameter erhalten, über den Sie binäre Daten in die Exportdatei einbinden können. Die 4D SQL Engine unterstützt Daten, die im hexadezimalen Format gespeichert sind. Neue Parameter für die Befehle SQL EXPORT SELECTION und SQL EXPORT DATABASE Die Befehle SQL EXPORT DATABASE und SQL EXPORT SELECTION haben den zusätzlichen optionalen Parameter maxfeldgröße erhalten. Dieser Parameter wird nur berücksichtigt, wenn die Datenbank Felder vom Typ BLOB, Bild oder Text enthält. In diesem Parameter müssen Sie einen Wert in Bytes übergeben, der die maximale Größe angibt, bis zu der Felder vom Typ BLOB, Bild bzw. Text (extern gespeicherter Text, z.b. außerhalb von Datensätzen) in die Hauptdatei "Export.SQL" exportiert werden, anstatt in eigene Dateien innerhalb von BLOB Unterordnern. Über diesen Parameter können Sie die Quantität externer Dateien steuern, die während einem Export generiert werden und so die Dauer der Operation reduzieren, insbesondere wenn die Datenbank eine große Anzahl an BLOB-, Bild- bzw. Text-Dateien enthält, die unter dem in maxfeldgröße festgelegten Grenzwert liegen. Bei Integration in die Hauptdatei "Export.SQL" werden binäre Daten (Felder vom Typ BLOB oder Bild) im hexadezimalen Format gespeichert. Um diese zu interpretieren, unterstützt die 4D SQL Engine jetzt diese Notation (siehe unten). Literal Werte in hexadezimal Die 4D SQL Engine unterstützt jetzt die hexadezimale Notation für literal Werte (literal). Hexadezimale Werte bestehen aus Zahlen (0 bis 9) und/oder Buchstaben (A bis F) und können alle Datentypen als bytes ausdrücken. Ein byte wird immer durch zwei hexadezimale Werte definiert. Um die Verwendung dieser Notation in einem SQL Befehl anzuzeigen, müssen Sie die Standard SQL Syntax für hexadezimale Werte verwenden: X'<hexadecimal value>' So schreiben Sie für den Dezimalwert 15 z.b. X'0f'. Einen leeren Wert (Null byte) definieren Sie mit X''. Hinweis: Diese Funktionalität betrifft den neuen Parameter für die Befehle SQL EXPORT DATABASE und SQL EXPORT SELECTION, da alle binären Daten, die in eine Exportdatei eingebunden werden, im hexadezimalen Format gespeichert werden.

7 Umbenennung der 4D HTML Tags Achtung: Die nachfolgend beschriebenen Änderungen wurden aus technischen Gründen nicht in die aktuelle Version von 4D v12.1 integriert. Sie werden mit v12.2 verfügbar sein (v12.1 hotfix 1 für 4D Gold und Silver-Partner). Für mehr Klarheit und zur besseren Steuerung wurden in 4D v12.1 bestimmte HTML Tags umbenannt: Sie müssen anstelle von 4DHTMLVAR das neue Tag 4DHTML verwenden, die Funktionsweise ist gleich geblieben. Das Tag 4DVAR ist jetzt überholt. Sie sollten es durch eines der nachfolgenden Tags ersetzen: 4DHTML (bisher 4DHTMLVAR, siehe oben), um eine 4D Variable oder einen 4D Ausdruck als HTML Ausdruck einzufügen. 4DTEXT, ein neues Tag, um eine 4D Variable oder Ausdruck als Text einzufügen. Im Unterschied zu 4DVAR ermöglicht dieses Tag nicht, HTML Code durch Voranstellen des Ausdrucks Char(1) vor den eingefügten Wert hinzuzufügen. Hier die Übersicht der neuen Funktionalitäten: Wert von myvar 4D Tag <12.1 Neues Tag in 4D 12.1 Einfügen in eine Web Seite myvar:="<b>" <!--#4DVAR myvar--> <!--#4DTEXT myvar--> <B> myvar:=char(1)+"<b>" <!--#4DVAR myvar--> <!--#4DTEXT myvar--> <B> myvar:="<b>" <!--#4DHTMLVAR myvar--> <!--#4DHTML myvar--> <B> myvar:=char(1)+"<b>" <!--#4DVAR myvar--> <!--#4DHTML myvar--> <B> Hinweis zur Kompatibilität: Die Tags 4DVAR und 4DHTMLVAR werden in 4D v12.1 noch unterstützt und funktionieren wie bisher. Wir empfehlen jedoch, die neue Namensgebung zu verwenden und den Code Ihrer Anwendungen so bald wie möglich daran anzupassen.

8 4D Server, 64-bit Version 4D Server unterstützt ab Version12 das Betriebssystem Windows 64-bit. Hauptvorteil der 64-bit Technologie ist die Möglichkeit, mehr RAM Speicher zuzuweisen. Dieser Abschnitt beschreibt die Eigenheiten beim Einrichten und Verwenden der 64-bit Version von 4D Server v12.1. Mindestversion unter Windows Ein 64-bit 4D Server benötigt mindestens eins der folgenden Betriebssysteme für Windows 64-bit: Windows Vista 64-bit Windows 2003 Server 64-bit Architektur Das Programm 4D Server.exe für 64-bit Architekturen ist eine Version speziell für diese Umgebung. Sie läuft nicht auf einem 32-bit System. Starten Sie umgekehrt eine Standardversion 4D Server.exe (32 bits) auf einem Windows 64-bit System, läuft sie, aber nur im emulierten Modus. Auf Client-Seite kann sich jeder Rechner mit 4D v12 (Mac OS oder Windows) an eine 64-bit Version von 4D Server v12 anmelden. Als 4D Programm müssen die Standardversionen 32-bit verwendet werden (siehe nachfolgende Übersicht). Kompatibilität Im interpretierten Modus lassen sich die gleichen 4D Anwendungen mit einem 64-bit 4D Server oder einem 32-bit 4D Server ausführen. Die Entwicklung ist identisch, egal welche Anwendung eingesetzt wird. Im kompilierten Modus müssen die Anwendungen für 64-bit Prozessoren kompiliert werden, damit sie mit 64-bit 4D Servern ausführbar sind (siehe Abschnitt "64-bit Kompilierung"). Eine Anwendung, die nur in 32-bit kompiliert wurde und keinen interpretierten Code enthält, ist nicht mit einem 64-bit Server ausführbar. Während der Ausführung müssen Sie folgende Unterschiede beachten: Der 64-bit 4D Server lädt nur Plug-Ins, die speziell für den 64-bit Modus kompiliert sind. Ein 4D Plug-In kann paralle für Windows 32-Bit, 64-bit und Mac OS erstellt werden. Ein 64-bit Plug-In muss als Ordner erstellt sein und im Ordner Plugins des Server liegen. (Die bisherige Architektur mit.4dx und.rsr Dateien im Win4DX Ordner wird nicht mehr unterstützt). 32-bit Plug-Ins werden nicht von einem 64-bit 4D Server geladen. Sie können diese jedoch in den Ordner Plugins des Server legen, diese werden auf die Clients verteilt und sind dort nutzbar, jedoch ohne Initialisierung auf dem Server. Operationen, die den Server aufrufen (z.b. Vorlagen auf dem Server über den 4D Write Befehl WR SET AREA PROPERTY schreiben oder lesen) funktionieren nicht. Die.4DX Datei für 32-bit muss in einem Unterordner mit Namen /Contents/Windows liegen, die Datei für 64-bit in einem Unterordner mit Namen /Contents/Windows64. Kompilierte 4D Komponenten, die mit einem 64-bit 4D Server verwendet werden, müssen in 64 bits kompiliert sein. Die Speichergröße für BLOBs, die von der Anwendung geladen werden, bleibt begrenzt auf 2 GB. QuickTime existiert nur als 32-bit Version und wird deshalb von einem 64-bit 4D Server nicht unterstützt. Wir empfehlen, im allgemeinen nicht mit Bildern im PICT Format zu arbeiten: Ist ein Bild 100% Quickdraw, lässt es sich mit einer 64-bit Version von 4D Server verwalten, enthält es dagegen QuickTime, kann es nicht benutzt werden. 4D Internet Commands Damit Sie 4D Internet Commands mit einem 64-bit 4D Server nutzen können, müssen Sie Version 12.1 dieses Plug-In installieren, diese Version liegt als 64-bit Version vor. Sie können Version 12.1 der 4D Internet Commands von der 4D Web Site laden. 64-bit Kompilierung Anwendungen in 4D v12 lassen sich für 32-bit und 64-bit Prozessoren kompilieren. Dazu verwenden Sie in den Datenbank-

9 Eigenschaften auf der Seite "Compiler" die neue Option Auch für 64-bit Prozessoren kompilieren: Ist diese Option markiert, enthält das Kompilat in den Dateien.4DC und.4db den 64-bit und 32-bit Code. Diese Dateien können dann mit einem 32-bit oder mit einem 64-bit Server laufen. Diese Option ist standardmäßig nicht markiert. Hinweis: Um eine 64-bit Version der Datenbank zu kompilieren, muss sie im Unicode Modus operieren. Andernfalls wird beim Kompilieren ein Fehler erzeugt. Größe des Cache Speichers Da 64-bit Architekturen bis zu 1 TB (1000 GB) für den RAM Speicher erlauben, ist der Cache Speicher, der einem 64-bit 4D Server zuweisbar ist, praktisch unbegrenzt. Hinweis: Zum Vergleich: 32-bit Architekturen sind auf 4 GB RAM begrenzt. Kann die Größe des Cache, der in den Datenbank-Eigenschaften auf der Seite Speicher definiert ist, nicht erreicht werden, weist 4D Server die max. mögliche Größe zu und informiert den Benutzer beim Start der Anwendung. Er kann dann beenden oder mit der angebotenen Größe arbeiten. Oberfläche Während der Ausführung können Sie über ein Logo zwischen dem 64-bit 4D Server und dem standardmäßigen 4D Server unterscheiden. Es erscheint auf der Seite Monitor des Server Verwaltungsfensters: Hinweis: Dieses Logo erscheint auch im Fenster "Über 4D Server". Programmiersprache Geänderte Befehle

10 Folgende Befehle der 4D Programmiersprache wurden an die neuen Fähigkeiten des 64-bit 4D Server angepasst: Version type, SET DATABASE PARAMETER und Get database parameter. Weitere Informationen dazu finden Sie in der Beschreibung dieser Befehle. Größe des Prozess-Stapels Der Prozess-Stapel auf einer 64-bit Version von 4D Server benötigt mehr Speicher als eine 32-bit Version (etwa doppelt soviel). Erstellen Sie auf einem 64-bit 4D Server einen Prozess mit den Funktionen Execute on server oder New process, empfehlen wir, im Parameter Stapel als Mindestwert bytes festzulegen und diesen beim Benutzen einer größeren Methoden Verschachtelung oder bei dem Fehler "out of stack space" zu erhöhen. Vergessen Sie nicht, diesen Parameter zu prüfen, wenn Ihr Code auf einem 64-bit 4D Server ausgeführt werden soll. Nicht erlaubte Befehle auf dem 64-bit Server Zusätzlich zu den Standardbefehlen, die auf 4D Server nicht ausgeführt werden können (siehe Was sollte eine Server Prozedur nicht machen?), lassen sich folgende Befehle nicht auf einem 64-bit Server ausführen. Wird z.b. einer dieser Befehle in einer Serverprozedur aufgerufen, erscheint eine Warnung und Fehler 67 wird zurückgegeben. Dieser Fehler lässt sich über eine Fehlerverwaltungsmethode abfangen, die mit dem Befehl ON ERR CALL installiert wurde. 4D, Kapitel Schnellbericht QR New offscreen area 4D, Kapitel Fenster Alle Befehle dieses Kapitels, wenn sie den optionalen Parameter WinRef nutzen 4D Chart, Kapitel CT Bereich CT New offscreen area

11 Funktion, um Konvertieren von Untertabellen zu vereinfachen Untertabellen werden ab Version 11 von 4D nicht mehr unterstützt. Zur Wahrung der Kompatibilität bisherige Untertabellen in konvertierten Datenbanken emuliert; wir empfehlen jedoch dringend, diese durch standardmäßige verknüpfte Tabellen zu ersetzen. Zur Vereinfachung wurde in 4D v12.1 die Funktion Get subrecord key hinzugefügt. Damit können Sie Ihren Code schrittweise anpassen und die Verarbeitung solcher Verknüpfungen deaktivieren, die speziell für konvertierte Untertabellen angelegt wurden (so dass Sie solche Verknüpfungen später definitiv entfernen können). Enthält Ihre Datenbank konvertierte Untertabellen, ist es eine gute Idee, die Vorteile dieser neuen Funktion zu nutzen, um Ihren Code so zu ändern, dass er Untertabellen nicht mehr verwendet.

12 Unterstützung von SSL in 4D Internet Commands Ab Version 12.1 des Plug-Ins 4D Internet Commands können Sie das SSL Protokoll zum senden oder empfangen von s verwenden. Diese neue Funktionalität verstärkt die Sicherheit der zu übertragenden Daten. Hinweis: Die Implementierung von SSL in 4DIC 12.1 verwendet "implicit method". Die Verwendung dieses Protokolls in 4DIC erfordert keine spezifische Konfiguration. Sie können SSL einfach aktivieren, indem Sie den unten aufgelisteten Befehlen den neuen Parameter übergeben: Der Befehl IMAP_Login hat den zusätzlichen optionalen Parameter sessionparam. Übergeben Sie 1 in diesem Parameter, damit die Verbindung zum IMAP Server mit SSL erfolgt. Der Befehl SMTP_Send hat den zusätzlichen optionalen Parameter sessionparam. Übergeben Sie 1 in diesem Parameter, damit die Meldung mit SSL gesendet wird. Der Befehl SMTP_QuickSend hat den zusätzlichen optionalen Parameter sessionparam. Übergeben Sie 1 in diesem Parameter, damit die Meldung mit SSL gesendet wird. Der Befehl POP3_Login hat den zusätzlichen optionalen Parameter sessionparam. Übergeben Sie 1 in diesem Parameter, damit die Verbindung zum POP3 Server mit SSL erfolgt. Der Befehl IT_SetPort hat drei neue Werte für den Parameter protocol: 12 = SMTP SSL 13 = POP3 SSL 14 = IMAP SSL