4D - Addendum 12.1 Nouveaux formatages date et heure (commande Chaine) Zones de texte riche PHP Propriétés de la base Export via SQL Renommage des balises HTML 4D Commande d'aide à la conversion des sous-tables Disponibilité de 4D Server 64 bits Prise en charge du SSL dans 4D Internet Commands
Nouveaux formatages date et heure (commande Chaine) 4D v12.1 donne accès à de nouveaux formatages automatiques combinés date/heure afin de faciliter la génération de marqueurs de temps. Ces formats sont particulièrement utiles dans le contexte des traitements XML et Web. Ces nouveaux formatages sont accessibles via la commande existante Chaine. Afin de permettre de combiner des dates et des heures, cette commande accepte désormais un troisième paramètre optionnel, heurecomb. Ce paramètre, de type Heure, est utilisable uniquement lorsque le paramètre expression est une date (cf. ci-dessous). Format ISO Date avec heure Le formatage de date ISO Date (retournant une date au format ISO8601) permet désormais de combiner une heure au résultat obtenu lorsque vous passez une heure en troisième paramètre : $madate:=chaine(date du jour;iso Date) // retourne par exemple 2010-09-13T00:00:00 $madate:=chaine(date du jour;iso Date;Heure courante) // retourne désormais 2010-09-13T18:11:53 Nouveau format ISO Date GMT avec heure Le nouveau formatage de date ISO Date GMT est semblable au format ISO Date, à la différence près qu'il exprime la date et l'heure en tenant compte de la zone de fuseau horaire (le format ISO Date exprime la date et l'heure locales). $madate:=chaine(date du jour;iso Date GMT;Heure courante) // retourne 2010-09-13T16:11:53Z A noter le caractère "Z" final qui indique le format GMT. Si vous passez uniquement une date, la commande retourne la date à minuit heure locale exprimée en heure GMT, ce qui peut entraîner un décalage : $madate:=chaine(date du jour;iso Date GMT) // retourne 2010-09-12T22:00:00Z Nouveau format Date RFC 1123 Le nouveau format de date Date RFC 1123 permet de formater un ensemble date/heure suivant la norme définie par les RFC 822 et 1123. Ce format est nécessaire par exemple pour fixer la date d'expiration des cookies dans un en-tête HTTP. $madate:=chaine(date du jour;date RFC 1123;Heure courante) // retourne par exemple Fri, 10 Sep 2010 13:07:20 GMT L'heure est exprimée en tenant compte de la zone de fuseau horaire (heure GMT). Si vous passez uniquement une date, la commande retourne la date à minuit heure locale exprimée en heure GMT, ce qui peut entraîner un décalage : $madate:=chaine(date du jour;date RFC 1123) // retourne Thu, 09 Sep 2010 22:00:00 GMT
Zones de texte riche Plusieurs nouveautés de 4D v12.1 ont pour but de permettre un meilleur contrôle du développeur sur les zones de texte riche (zones multistyles). La commande OBJET FIXER TEXTE BRUT a été ajoutée et le fonctionnement de plusieurs commandes existantes a été modifié. A noter également que plusieurs commandes du même thème modifient désormais la variable OK. Nouvelle commande OBJET FIXER TEXTE BRUT La nouvelle commande OBJET FIXER TEXTE BRUT permet d'insérer du texte brut, contenant par exemple des caractères <, > ou &. Cette commande complète l'emploi des commandes OBJET FIXER TEXTE STYLE et OBJET Lire texte brut. Commandes modifiées Le fonctionnement des commandes suivantes a été modifié dans 4D v12.1 : LISTE DES POLICES : Sous Mac OS, cette commande remplit désormais le tableau polices avec les noms des familles de police. Dans les versions précédentes de 4D, la commande retournait sous Mac OS les noms des polices elles-mêmes. OBJET FIXER ATTRIBUT TEXTE STYLE : Lorsque cette commande est utilisée avec Attribut nom de police comme paramètre nomattribut, vous devez passer un nom de famille de police dans valeurattribut. Par exemple : OBJET FIXER ATTRIBUT TEXTE STYLE(*;"MonTexte";0;MAXLONG;Attribut nom de police;"arial") // Valide OBJET FIXER ATTRIBUT TEXTE STYLE(*;"MonTexte";0;MAXLONG;Attribut nom de police;"times BOLD ITALIC") // non valide, la commande ne fera rien) Par conséquent, sous Mac OS, vous devez veiller à ne pas passer le paramètre * à la commande LISTE DES POLICES si vous souhaitez utiliser les valeurs qu elle retourne avec OBJET FIXER ATTRIBUT TEXTE STYLE. OBJET FIXER TEXTE STYLE : Vous devez passer du texte riche (stylé) dans le paramètre nouvtexte. Si vous passez un texte brut contenant les caractères <, > ou &, une erreur sera générée. Pour pouvoir insérer du texte brut contenant ces caractères, vous devez utiliser la nouvelle commande OBJET FIXER TEXTE BRUT. Valorisation de la variable OK A compter de la version 12.1 de 4D, les commandes suivantes modifient la variable système OK : OBJET FIXER ATTRIBUT TEXTE STYLE OBJET FIXER TEXTE STYLE OBJET LIRE ATTRIBUT TEXTE STYLE OBJET Lire texte brut OBJET Lire texte style A l issue de l exécution de ces commandes, la variable OK prend la valeur 1 si aucune erreur n a été rencontrée et 0 dans le cas contraire. C est le cas notamment lorsque l évaluation des balises de style échoue (balise incorrecte ou manquante). A noter qu en cas d erreur, la variable n est pas modifiée. Lorsqu une erreur se produit sur une variable lors de l évaluation du texte, 4D transforme le texte en texte brut ; par conséquent, les caractères <, > et & seront convertis en entités HTML.
PHP Utilisation d'un interpréteur PHP externe La procédure permettant de faire appel à un interpréteur PHP externe ou des modules personnalisés a été modifiée dans 4D v12.1. Cette modification s est avérée nécessaire pour la prise en charge des configurations dans lesquelles les droits d accès au dossier Program Files sont restreints. Désormais, le fichier d initialisation php.ini du fastcgi-php lançé par 4D doit être situé dans le dossier Resources de la base. Si ce fichier n est pas présent lors du premier appel, 4D le crée avec les options de configuration adaptées. Il n est pas possible d utiliser un fichier php.ini personnalisé avec l interpréteur inclus de 4D. Si vous souhaitez utiliser des options de configurations de php autres que celles fournies par défaut, vous devez gérer un interpréteur fastcgi-php externe (ce point est décrit dans la section Exécuter des scripts PHP dans 4D). Note : Le fichier php.ini de l interpréteur externe doit contenir l entrée "auto_prepend_file" qui fournit le chemin d accès complet au script utilitaire 4D_Execute_PHP.php. Ce script se trouve dans [application 4D]Resources/php/Windows ou /Mac. En l absence de cette entrée, seuls les scripts entiers peuvent être exécutés : l appel d une routine à l intérieur d un script ne fonctionnera pas. Modification de la commande PHP Executer Afin de faciliter le traitement des données renvoyées par PHP, le fonctionnement des commandes PHP Executer et PHP LIRE REPONSE COMPLETE a été unifié (les valeurs reçues sont toujours identiques à celles retournées par le développeur PHP). Les principes mis en oeuvre pour l'interprétation des données sont désormais détaillés dans la description de la commande PHP Executer.
Propriétés de la base Deux nouveautés de 4D v12.1 concernent les paramétrages accessibles via les Propriétés de la base (menu Développement/Propriétés de la base). Délai d écriture du cache Il est désormais possible de définir une valeur en secondes pour le délai entre les écritures automatiques (flush) du cache de données de la base. Cette option est accessible dans la page Base de données/mémoire des Propriétés de la base : Par défaut dans 4D v12.1, la valeur est de 20 secondes. Vous pouvez modifier cette valeur en fonction des spécificités de votre application. Tri des données en japonais La nouvelle option Ordre de tri traditionnel permet de modifier l ordre de tri des caractères pour les données en langue japonaise : Cette option est située dans la page Base de données/stockage des données des Propriétés de la base. Elle n apparaît que dans les bases dont la langue des données est configurée en Japonais. Elle est cochée par défaut pour les nouvelles bases créées en japonais.
Export via SQL Dans 4D v12.1, les mécanismes d'exportation des données de la base via le SQL ont été enrichis afin de permettre aux développeurs de paramétrer plus finement l'opération en fonction de la typologie des données exportées : les commandes SQL EXPORTER BASE et SQL EXPORTER SELECTION admettent un paramètre supplémentaire permettant d'inclure les données binaires dans le fichier d'export, le moteur SQL de 4D prend désormais en charge des données stockées au format hexadécimal. Nouveau paramètre pour les commandes SQL EXPORTER SELECTION et SQL EXPORTER BASE Les commandes SQL EXPORTER BASE et SQL EXPORTER SELECTION admettent un paramètre optionnel supplémentaire : taillelimitechamps. Ce paramètre est pris en compte uniquement lorsque la base contient des champs de type BLOB, Image ou Texte. Vous devez passer dans ce paramètre une valeur en octets indiquant la taille au-dessous de laquelle les champs des types BLOB, Image ou Texte (textes à stockage externe, c'est-à-dire stockés en-dehors des enregistrements) seront exportés à l'intérieur du fichier "Export.SQL" principal, et non dans des fichiers séparés dans les sous-dossiers BLOBs. Ce paramètre permet de contrôler la quantité de fichiers externes générés lors d'un export et donc de réduire la durée de l'opération, en particulier lorsque la base contient de nombreux enregistrements BLOB, Image ou Texte contenant des données de taille réduite. Lorsqu'elles sont incluses dans le fichier "Export.SQL" principal, les données binaires (champs BLOB ou Image) sont stockées au format hexadécimal. Pour pouvoir les interpréter, le moteur SQL de 4D accepte désormais cette notation (cf. ci-dessous). Valeurs littérales en hexadécimal Le moteur SQL de 4D prend désormais en charge la notation hexadécimale pour les valeurs littérales (val_littérale). Les valeurs hexadécimales sont composées de chiffres (0 à 9) et/ou de lettres (A à F) et permettent d'exprimer tout type de données sous forme d'octets. Un octet est toujours défini par deux valeurs hexadécimales. Pour indiquer l'emploi de cette notation dans une commande SQL, vous devez simplement utiliser la syntaxe hexadécimale SQL standard : X'<valeur hexadécimale>' Par exemple, pour la valeur décimale 15, vous pouvez écrire X'0f'. Il est possible de définir une valeur vide (zéro octet) en écrivant X''. Note : Cette fonctionnalité est liée au nouveau paramètre des commandes SQL EXPORTER BASE et SQL EXPORTER SELECTION, puisque les données binaires éventuellement intégrées au fichier d'export sont stockées au format hexadécimal.
Renommage des balises HTML 4D Attention : Pour des raisons techniques, les modifications décrites ci-dessous n'ont pas pu être intégrées dans 4D v12.1. Elles seront disponibles dans la version 12.2 de 4D (et dès la version 12.1 hotfix 1 pour les partenaires). Pour plus de clarté et un meilleur contrôle, des modifications ont été apportées aux balises HTML spéciales dans 4D v12.1 : La nouvelle balise 4DHTML doit être utilisée au lieu de 4DHTMLVAR. Le fonctionnement de la balise 4DHTML est strictement identique à celui de 4DHTMLVAR. La balise 4DVAR est désormais obsolète. Elle est à remplacer suivant le cas par l'une des deux balises spécialisées suivantes : 4DHTML (anciennement 4DHTMLVAR, voir ci-dessus) pour l'insertion d'une variable ou d'une expression 4D en tant qu'expression HTML. 4DTEXT, nouvelle balise permettant d'insérer une variable ou une expression 4D en tant que texte. A la différence de 4DVAR, cette balise ne prend pas en charge le mécanisme permettant d'ajouter du code HTML en passant l'expression Caractere(1) en début de la valeur insérée. Ces nouveautés sont résumées dans le tableau suivant : Valeur de mavar Balise 4D<12.1 Nouvelle balise 4D 12.1 Insertion dans la page Web mavar:="<b>" <!--#4DVAR mavar--> <!--#4DTEXT mavar--> <B> mavar:=caractere(1)+"<b>" <!--#4DVAR mavar--> <!--#4DTEXT mavar--> <B> mavar:="<b>" <!--#4DHTMLVAR mavar--> <!--#4DHTML mavar--> <B> mavar:=caractere(1)+"<b>" <!--#4DVAR mavar--> <!--#4DHTML mavar--> <B> Note de compatibilité : Les balises 4DVAR et 4DHTMLVAR restent prises en charge dans 4D v12.1 et fonctionnent comme dans les versions précédentes. Il est toutefois conseillé de commencer à utiliser la nouvelle nomenclature et de faire migrer le code de vos applications dès que possible.
Commande d'aide à la conversion des sous-tables Les sous-tables ne sont plus prises en charge à compter de la version 11 de 4D. Un mécanisme de compatibilité assure le fonctionnement des anciennes sous-tables dans les bases de données converties, toutefois il est désormais très fortement conseillé de remplacer les sous-tables par des tables liées standard. Afin de faciliter cette opération, une nouvelle commande a été ajoutée dans 4D v12.1 : Lire cle sous enregistrement. Cette commande permet de faire migrer progressivement votre code en vous permettant de déconnecter les traitements du lien spécial créé pour les sous-tables converties (ce qui permet de le supprimer dans un second temps). Si votre base contient des sous-tables converties, n'hésitez pas à tirer parti cette commande pour faire évoluer votre code.
Disponibilité de 4D Server 64 bits A compter de la version 12.1, 4D Server prend en charge les systèmes d exploitation Windows 64 bits. La technologie 64 bits a pour principal avantage de permettre d adresser davantage de mémoire RAM. Cette section précise les particularités relatives à la mise en oeuvre et à l utilisation de la version 64 bits de 4D Server v12.1. Versions Windows minimales 4D Server 64 bits requiert au minimum l un des systèmes d exploitation Windows 64 bits suivants : Windows Vista 64 bits Windows 2003 Server 64 bits Architecture L application 4D Server.exe destinée aux architectures 64 bits est une version spécifique, dédiée à cet environnement. Elle ne s exécute pas sur un système 32 bits. A l inverse, si vous lancez l application standard 4D Server.exe (32 bits) sur un système Windows 64 bits, elle s exécutera, mais en mode émulé. Côté client, tout poste 4D v12 (Mac OS ou Windows) peut se connecter à 4D Server v12 64 bits. Les applications 4D à utiliser sont les versions 32 bits standard (cf. schéma ci-dessous). Compatibilité En mode interprété, les mêmes bases de données 4D peuvent être exécutées avec un 4D Server 64 bits ou un 4D Server 32 bits. Le développement est identique, quelle que soit l application utilisée. En mode compilé, les bases doivent avoir été compilées pour les processeurs 64 bits pour pouvoir être exécutées avec 4D Server 64 bits (cf. paragraphe "Compilation 64 bits"). Une base compilée en 32 bits uniquement et ne contenant pas le code interprété ne peut pas être exécutée avec 4D Server 64 bits. En exécution, les principes suivants sont à noter : Seuls les plug-ins compilés spécifiquement en 64 bits seront chargés par 4D Server 64 bits. Un plug-in 64 bits doit impérativement être construit sous forme de dossier et placé dans le dossier Plugins du serveur (l ancienne architecture basée sur des fichiers.4dx et.rsr placés dans un dossier Win4DX n est plus prise en charge). Les plug-ins 32 bits ne sont pas chargés par 4D Server 64 bits mais peuvent toutefois être stockés dans le dossier Plugins du serveur et distribués sur les postes distants, sans initialisation. Les mécanismes faisant appel au serveur (par exemple l écriture ou la lecture des modèles sur le serveur via la commande WR FIXER PROPRIETE ZONE de 4D Write) ne fonctionneront pas. Le fichier.4dx pour 32 bits doit se trouver dans un sous-dossier nommé /Contents/Windows et le fichier pour 64 bits doit se trouver dans un sous-dossier nommé /Contents/Windows64. Les composants 4D compilés utilisés avec 4D Server 64 bits doivent avoir été compilés en 64 bits. L'espace mémoire utilisable pour l'ensemble des BLOBs chargés par l'application reste limité à 2 Go. QuickTime n est pas pris en charge par 4D Server 64 bits. De manière générale, la manipulation d'images au format PICT est déconseillée : si l'image est 100 % Quickdraw, elle pourra être traitée par 4D Server 64 bits, mais si elle contient du Quicktime, elle ne sera pas chargée. 4D Internet Commands Pour pouvoir utiliser 4D Internet Commands avec 4D Server 64 bits, vous devez installer au minimum la version 12.1 de ce plug in. Vous pouvez télécharger 4D Internet Commands 12.1 depuis le site Web de 4D. Compilation 64 bits
Les applications 4D v12 peuvent désormais être compilées pour les processeurs 32 bits et 64 bits. Pour cela, la nouvelle option Compiler aussi pour les processeurs 64 bits est disponible dans la page "Compilateur" des Propriétés de la base : Lorsque cette option est cochée, le compilateur inclut le code 64 bits et le code 32 bits dans les fichiers.4dc et.4db. Ces fichiers peuvent alors être indifféremment exécutés avec 4D Server 32 bits ou 4D Server 64 bits. Par défaut, cette option n est pas cochée. Note : Pour que vous puissiez compiler une base en 64 bits, elle doit fonctionner en mode Unicode. Dans le cas contraire, une erreur est générée à la compilation. Taille de la mémoire cache Les architectures 64 bits permettant d adresser jusqu à 1 To (1000 Go) de mémoire RAM, la mémoire cache que vous pouvez allouer à l application 4D Server 64 bits est virtuellement illimitée. Note : Par comparaison, les architectures 32 bits sont limitées à 4 Go de RAM. Si la quantité de cache définie dans la page "Base de données/mémoire" des Propriétés de la base ne peut être obtenue, 4D Server alloue la plus grande taille possible et en informe l utilisateur au lancement de l application. Il est alors possible de quitter ou de poursuivre avec la taille proposée. Interface En exécution, vous pouvez distinguer l application 4D Server 64 bits de l application 4D Server standard via un logo apparaissant dans la page Moniteur de la fenêtre d administration du serveur : Note : Ce logo apparaît également dans la fenêtre d A propos de 4D Server. Langage
Commandes modifiées Les commandes suivantes du langage de 4D ont été adaptées aux nouvelles capacités de 4D Server 64 bits : Type version, FIXER PARAMETRE BASE et Lire parametre base. Pour plus d'informations, reportez-vous à la description de ces commandes. Taille de la pile des process La pile d un process exécuté sur 4D Server 64 bits requiert une quantité de mémoire plus importante que sur 4D Server 32 bits (environ le double). Lorsque vous créez un process sur le serveur à l aide de la commande Executer sur serveur ou Nouveau process avec 4D Server 64 bits, il est conseillé de passer dans le paramètre pile une valeur de 128000 octets au minimum et de l'augmenter en cas de chaîne d appel importante ou si vous recevez l'erreur "out of stack". Commandes interdites sur le serveur 64 bits En plus des commandes interdites sur 4D Server "classique" (cf. paragraphe Que ne peut pas faire une procédure stockée (sur le serveur)? ), les commandes suivantes ne peuvent pas être exécutées sur le serveur 64 bits. Si elles sont appelées dans le cadre d une procédure stockée, une boîte de dialogue d alerte apparaît l erreur 67 est retournée. Cette erreur peut être interceptée par une méthode d appel sur erreur installée par la commande APPELER SUR ERREUR. 4D, thème Etats rapides QR Creer zone hors ecran 4D, thème Fenêtres 4D Chart, thème ch_gestion des documents Toutes les commandes de ce thème lorsqu'elles utilisent le paramètre optionnel de type RefFen ch_hors ecran
Prise en charge du SSL dans 4D Internet Commands A compter de la version 12.1 du plug-in 4D Internet Commands, il est possible d'utiliser le protocole SSL avec les commandes d'envoi de messages et de connexion aux serveurs de messagerie. Cette nouveauté permet de renforcer la sécurité des données transférées. Note : L'implémentation du SSL dans 4DIC 12.1 utilise la "méthode implicite". L'utilisation de ce protocole dans 4DIC ne nécessite aucune configuration particulière. L'activation de SSL s'effectue simplement en passant de nouveaux paramètres aux commandes listées ci-dessous. La commande IMAP_Login accepte désormais un paramètre optionnel supplémentaire : paramsession. Passez 1 dans ce paramètre pour que la connexion au serveur IMAP soit effectuée en SSL. La commande SMTP_Send accepte désormais un paramètre optionnel supplémentaire : paramsession. Passez 1 dans ce paramètre pour que l'envoi du message soit effectué en SSL. La commande SMTP_QuickSend accepte désormais un paramètre optionnel supplémentaire : paramsession. Passez 1 dans ce paramètre pour que l'envoi du message soit effectué en SSL. La commande POP3_Login accepte désormais un paramètre optionnel supplémentaire : paramsession. Passez 1 dans ce paramètre pour que la connexion au serveur POP3 soit effectuée en SSL. La commande IT_SetPort accepte désormais trois nouvelles valeurs dans le paramètre protocole : 12 = SMTP SSL 13 = POP3 SSL 14 = IMAP SSL