4D v17.4Get database parameter |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v17.4
Get database parameter
|
Get database parameter ( {laTable ;} sélecteur {; valeurAlpha} ) -> Résultat | ||||||||
Paramètre | Type | Description | ||||||
laTable | Table |
![]() |
Table du paramètre ou Table par défaut si ce paramètre est omis | |||||
sélecteur | Entier long |
![]() |
Code du paramètre de la base | |||||
valeurAlpha | Chaîne |
![]() |
Valeur alpha du paramètre | |||||
Résultat | Réel |
![]() |
Valeur du paramètre | |||||
La commande Get database parameter permet de lire la valeur courante d'un paramètre de la base 4D. Lorsque la valeur du paramètre est une chaîne de caractères, elle est retournée dans le paramètre valeurAlpha.
sélecteur désigne le paramètre de la base à lire. 4D vous propose les constantes prédéfinies suivantes, placées dans le thème Paramètres de la base :
Constante | Type | Valeur | Comment |
4D Server timeout | Entier long | 13 | Portée : Application 4D si valeur positive Conservé entre deux sessions : Oui si valeur positive Valeurs possibles : 0 -> 32 767 Description : Valeur du délai avant déconnexion (timeout) accordé par 4D Server aux postes clients. Par défaut, cette valeur est définie dans la page “Client-Serveur/Options réseau” des Propriétés de la base, sur le poste serveur. Le timeout serveur définit la période maximale de non-réponse du client "autorisée", par exemple s'il effectue une opération bloquante. A l'issue de cette période, 4D Server déconnecte le client. Le sélecteur 4D Server timeout vous permet de fixer un nouveau timeout, exprimé en minutes. Cette possibilité permet en particulier d’augmenter la valeur du timeout avant l’exécution sur le poste client d’une opération bloquante de longue durée, risquant d’entraîner une déconnexion ; par exemple, l’impression d’un grand nombre de pages. Vous disposez en outre de deux possibilités :
|
4D Remote mode timeout | Entier long | 14 | Portée (ancienne couche réseau uniquement) : Application 4D si valeur positive Conservé entre deux sessions : Oui si valeur positive Description : A utiliser dans des cas très spécifiques. Valeur du délai avant déconnexion (timeout) accordé par le poste 4D distant au poste 4D Server. Par défaut, cette valeur est définie dans la page “Client-Serveur/Options réseau” des Propriétés de la base, sur le poste distant. Le sélecteur 4D Remote mode timeout n'est pris en compte que si vous utilisez l'ancienne couche réseau. Avec la couche ServerNet activée, il est ignoré : ce paramétrage est entièrement géré par le sélecteur 4D Server timeout (13). |
Port ID | Entier long | 15 | Portée : 4D local, 4D Server Conservé entre deux sessions : Non Description : Numéro du port TCP utilisé par le serveur Web 4D avec 4D en mode local et 4D Server. Par défaut, la valeur est 80. Le numéro de port TCP est défini dans la page “Web/Configuration” de la boîte de dialogue des Propriétés de la base. Vous pouvez utiliser les constantes du thème Numéros de port TCP pour le paramètre valeur. Le sélecteur Port ID est utile dans le cadre de serveurs Web 4D compilés et fusionnés avec 4D Desktop (pas d’accès au mode Développement). Pour plus d’informations sur le numéro de port TCP, reportez-vous à la section Paramétrages du serveur Web. |
Character set | Entier long | 17 | Portée : 4D local, 4D Server Conservé entre deux sessions : Oui Description : Constante obsolète (conservée par compatibilité uniquement). Il est désormais conseillé d'utiliser les commandes WEB SET OPTION et WEB GET OPTION pour le paramétrage du serveur HTTP. |
Max concurrent Web processes | Entier long | 18 | Portée : 4D local, 4D Server Conservé entre deux sessions : Oui Description : Constante obsolète (conservée par compatibilité uniquement). Il est désormais conseillé d'utiliser les commandes WEB SET OPTION et WEB GET OPTION pour le paramétrage du serveur HTTP. |
Client port ID | Entier long | 22 | Portée : Tous postes 4D distants Conservé entre deux sessions : Oui Valeurs possibles : Voir sélecteur 15 Description : Permet de spécifier ce paramètre pour les postes 4D distants utilisés en tant que serveurs Web. La valeur définie via ce sélecteur est appliquée à tous les postes distants utilisés comme serveurs Web. Si vous souhaitez définir cette valeur pour certains postes distants uniquement, utilisez la boîte de dialogue des Préférences de 4D en mode distant. |
Client character set | Entier long | 24 | Portée : Tous postes 4D distants Conservé entre deux sessions : Oui Valeurs possibles : Voir sélecteur 17 Description : Permet de spécifier ce paramètre pour les postes 4D distants utilisés en tant que serveurs Web. La valeur définie via ce sélecteur est appliquée à tous les postes distants utilisés comme serveurs Web. Si vous souhaitez définir cette valeur pour certains postes distants uniquement, utilisez la boîte de dialogue des Préférences de 4D en mode distant. |
Client max concurrent Web proc | Entier long | 25 | Portée : Tous postes 4D distants Conservé entre deux sessions : Oui Valeurs possibles : Voir sélecteur 18 Description : Permet de spécifier ce paramètre pour les postes 4D distants utilisés en tant que serveurs Web. La valeur définie via ce sélecteur est appliquée à tous les postes distants utilisés comme serveurs Web. Si vous souhaitez définir cette valeur pour certains postes distants uniquement, utilisez la boîte de dialogue des Préférences de 4D en mode distant. |
Maximum Web requests size | Entier long | 27 | Portée : 4D local, 4D Server Conservé entre deux sessions : Oui Description : Constante obsolète (conservée par compatibilité uniquement). Il est désormais conseillé d'utiliser les commandes WEB SET OPTION et WEB GET OPTION pour le paramétrage du serveur HTTP. |
4D Server log recording | Entier long | 28 | Portée : 4D Server, 4D distant Conservé entre deux sessions : Non Valeurs possibles : 0 ou de 1 à N (0 = ne pas enregistrer, 1 à N = numéro séquentiel, accolé au nom du fichier). Description : Démarrage ou arrêt de l’enregistrement des requêtes standard reçues par 4D Server (hors requêtes Web). Par défaut, la valeur est 0 (pas d’enregistrement de requêtes). 4D Server vous permet d’enregistrer dans un fichier d’historique chaque requête reçue par le poste serveur. Lorsque ce mécanisme est activé, deux fichiers sont créés dans le dossier Logs de la base, à côté du fichier de structure. Il sont nommés 4DRequestsLog_N.txt et 4DRequestsLog_ProcessInfo_N.txt où N est le numéro séquentiel de l'historique. Une fois qu'un fichier atteint une taille de 10 Mo, il est refermé et un nouveau fichier est généré, avec un numéro séquentiel incrémenté. Si un fichier du même nom existe déjà, il est directement remplacé. Vous pouvez définir le numéro de départ de la séquence à l'aide du paramètre valeur. Ces fichiers texte stockent dans un format tabulé simple diverses informations concernant chaque requête : heure, numéro de process, utilisateur, taille de la requête, durée de traitement, etc. Ces informations sont particulièrement utiles en phase de mise au point de l’application ou à des fins statistiques. Elles peuvent être importées par exemple dans un logiciel tableur afin d’être traitées. |
Client Web log recording | Entier long | 30 | Portée : Tous postes 4D distants Conservé entre deux sessions : Oui Valeurs possibles : 0 = Ne pas enregistrer (défaut), 1 = Enregistrer au format CLF, 2 = Enregistrer au format DLF, 3 = Enregistrer au format ELF, 4 = Enregistrer au format WLF. Description : Démarrage ou arrêt de l’enregistrement des requêtes Web reçues par les serveurs Web de tous les postes clients. Par défaut, la valeur est 0 (pas d’enregistrement des requêtes). Le fonctionnement de ce sélecteur est identique à celui du sélecteur 29 ; il s’applique toutefois à tous les postes 4D clients utilisés en tant que serveurs Web. Le fichier “logweb.txt” est dans ce cas automatiquement placé dans le sous-dossier Logs du dossier base 4D client (dossier de cache). Si vous souhaitez définir des valeurs pour certains postes clients uniquement, utilisez la boîte de dialogue des Préférences de 4D en mode distant. |
Table sequence number | Entier long | 31 | Portée : Application 4D Conservé entre deux sessions : Oui Valeurs possibles : Toute valeur de type entier long. Description : Ce sélecteur permet de modifier ou de lire le numéro unique courant des enregistrements de la table passée en paramètre. “Numéro courant” signifie “dernier numéro utilisé” : si vous modifiez cette valeur à l’aide de SET DATABASE PARAMETER, le prochain enregistrement sera créé avec comme numéro la valeur passée + 1. Ce nouveau numéro est, lui, retourné par la commande Sequence number ainsi que dans tout champ de la table auquel la propriété "Incrémentation auto" a été affectée en Structure ou via le SQL. Par défaut, le numéro unique est défini par 4D et correspond à l’ordre de création des enregistrements. Pour des informations supplémentaires, reportez-vous à la documentation de la commande Sequence number. |
Debug log recording | Entier long | 34 | Portée : Application 4D Conservé entre deux sessions : Non Description : Démarrage ou arrêt de l’enregistrement séquentiel des événements de programmation de 4D dans le fichier 4DDebugLog, automatiquement placé dans le sous-dossier Logs de la base, à côté du fichier de structure. Un nouveau format texte tabulé, plus compact, est utilisable pour le fichier d’enregistrement des événements "4DDebugLog[_n].txt" à compter de 4D v14 (_n est le numéro de segment du fichier). Valeurs possibles : Entier long contenant un champ de bits (bit field) : valeur = bit1(1)+bit2(2)+bit3(4)+bit4(8)+…). - Le bit 1 (valeur 1) permet de demander à activer le fichier (à noter que toute autre valeur non nulle l’activera également) - Le bit 2 (valeur 2) permet de demander les paramètres d’appel aux méthodes et commandes. - Le bit 3 (valeur 4) permet d’activer le nouveau format tabulé. - Le bit 4 (valeur 8) permet de désactiver l’écriture immédiate de chaque opération sur disque (activée par défaut). L’écriture immédiate est moins rapide mais plus efficace par exemple pour rechercher les causes d’un plantage. Si vous désactivez ce mode, le contenu fichier sera plus compact et il sera généré plus rapidement. - Le bit 5 (valeur 16) permet de désactiver l’enregistrement des appels de plug-ins (activé par défaut). Dans le format non tabulé (ancien format), les durées d’exécution sont exprimées en millisecondes, la valeur "< ms" est affichée si une opération s’exécute en moins d’une milliseconde. Dans le nouveau format tabulé, les durées d’exécution sont exprimées en microsecondes. Exemples : FIXER PARAMETRE BASE(34;1) // active le fichier mode v13 sans les paramètres, avec les durées FIXER PARAMETRE BASE(34;2) // active le fichier mode v13 avec les paramètres et les durées FIXER PARAMETRE BASE(34;2+4) // active le fichier au format v14 avec les paramètres et les durées FIXER PARAMETRE BASE(34;0) // désactive le fichier Afin d’éviter que le fichier n’enregistre une trop grande quantité d’informations, vous pouvez restreindre les commandes 4D à examiner à l’aide du sélecteur 80, Log command list. L’option peut être activée dans tout type d’application 4D (4D tous modes, 4D Server, 4D Volume Desktop), en interprété ou en compilé. Note : Cette option est proposée uniquement à des fins de débogage, elle ne doit pas être utilisée en production car elle peut entraîner une dégradation des performances de l'application ainsi que la saturation du disque dur. Pour plus d’informations sur le format et l’exploitation du fichier 4DDebugLog[_n].txt, veuillez contacter les services techniques de 4D SAS. |
Client Server port ID | Entier long | 35 | Portée : Base de données Conservé entre deux sessions : Oui Valeurs possibles : 0 à 65535 Description : Numéro de port TCP sur lequel 4D Server publie la base de données (à destination des postes 4D distants). Par défaut, la valeur est 19813. La personnalisation de cette valeur permet d’utiliser plusieurs applications 4D client-serveur sur la même machine avec le protocole TCP ; dans ce cas, vous devez spécifier un numéro de port différent pour chaque application. La valeur est stockée dans le fichier de structure de la base. Elle peut être définie avec 4D en mode local mais n’est prise en compte qu’en configuration client-serveur. Lorsque vous modifiez cette valeur, il est nécessaire de redémarrer le poste serveur afin que la nouvelle valeur soit prise en compte. |
Invert objects | Entier long | 37 | Portée : Base de données Conservé entre deux sessions : Oui Valeurs possibles : 0, 1 ou 2 (0 = mode désactivé, 1 = mode automatique, 2 = mode activé). Description : Configuration du mode “inversion des objets”. Ce mode permet d’inverser en mode Application les formulaires, objets, menus, etc. lorsque la base est affichée sous Windows dans une langue de droite à gauche. Ce mode peut également être configuré dans la page Interface/langue droite à gauche des Propriétés de la base.
|
HTTPS Port ID | Entier long | 39 | Portée : 4D local, 4D Server Conservé entre deux sessions : Oui Description : Constante obsolète (conservée par compatibilité uniquement). Il est désormais conseillé d'utiliser les commandes WEB SET OPTION et WEB GET OPTION pour le paramétrage du serveur HTTP. |
Client HTTPS port ID | Entier long | 40 | Portée : Tous postes 4D distants Conservé entre deux sessions : Oui Valeurs possibles : 0 à 65535 Description : Numéro du port TCP utilisé par les serveurs Web des postes clients pour les connexions sécurisées via SSL (protocole HTTPS). Par défaut, la valeur est 443 (valeur standard). Le fonctionnement de ce sélecteur est identique à celui du sélecteur 39 ; il s’applique toutefois à tous les postes 4D distants utilisés en tant que serveurs Web. Si vous souhaitez modifier la valeur de certains postes clients uniquement, utilisez la boîte de dialogue des Préférences de 4D distant. |
Unicode mode | Entier long | 41 | Portée : Base de données Conservé entre deux sessions : Oui Valeurs possibles : 0 (mode compatibilité) ou 1 (mode Unicode) Description : Mode d’exécution courant de la base, relatif au jeu de caractères. 4D prend en charge le jeu de caractères Unicode mais peut fonctionner en mode “compatibilité” (basé sur le jeu de caractères ASCII Mac). Par défaut, les bases de données converties sont exécutées en mode compatibilité (0) et les bases créées à partir de la version 11 sont exécutées en mode Unicode. Le mode d’exécution est contrôlé via une option des préférences et peut également être lu ou (à des fins de test) modifié via ce sélecteur. La modification de cette option nécessite le redémarrage de la base pour être prise en compte. A noter que, dans le cadre d’un composant, il n’est pas possible de modifier cette valeur, mais uniquement de la lire. |
SQL Autocommit | Entier long | 43 | Portée : Base de données Conservé entre deux sessions : Oui Valeurs possibles : 0 (désactivation) ou 1 (activation) Description : Activation ou désactivation du mode SQL auto-commit. Par défaut, la valeur est 0 (mode désactivé) Le mode auto-commit permet de renforcer l'intégrité référentielle de la base. Lorsque ce mode est actif, les requêtes SELECT, INSERT, UPDATE, DELETE (SIUD) sont automatiquement incluses dans des transactions lorsqu'elles sont exécutées en-dehors de toute transaction. Ce mode peut également être défini dans les préférences de la base. |
SQL Engine case sensitivity | Entier long | 44 | Portée : Base de données Conservé entre deux sessions : Oui Valeurs possibles : 0 (casse non prise en compte) ou 1 (casse prise en compte) Description : Activation ou désactivation de la prise en compte de la casse des caractères pour les comparaisons de chaînes effectuées par le moteur SQL. Par défaut, la valeur est 1 (casse prise en compte) : le moteur SQL établit une différence entre les majuscules et les minuscules ainsi qu'entre les caractères accentués lors des comparaisons de chaînes (tris et recherches). Par exemple "ABC" = "ABC" mais "ABC" # "Abc" et "abc" # "âbc" . Dans certains cas, par exemple pour aligner le fonctionnement du moteur SQL sur celui du moteur 4D, vous pourrez souhaiter que les comparaisons de chaînes ne tiennent pas compte de la casse ("ABC"="Abc"="âbc"). Cette option peut également être définie dans la Page SQL des Propriétés de la base. |
Client log recording | Entier long | 45 | Portée : Poste 4D distant Conservé entre deux sessions : Non Valeurs possibles : 0 ou de 1 à N (0 = ne pas enregistrer, 1 à N = numéro séquentiel, accolé au nom du fichier). Description : Démarrage ou arrêt de l'enregistrement des requêtes standard effectuées par le poste client 4D ayant exécuté la commande (hors requêtes Web). Par défaut, la valeur est 0 (pas d'enregistrement des requêtes). 4D vous permet d'enregistrer l’historique des requêtes effectuées par le poste client. Lorsque ce mécanisme est activé, deux fichiers sont créés sur le poste client, dans le sous-dossier Logs du dossier local de la base. Il sont nommés 4DRequestsLog_N.txt et 4DRequestsLog_ProcessInfo_N.txt où N est le numéro séquentiel de l'historique. Une fois que le fichier 4DRequestsLog atteint une taille de 10 Mo, il est refermé et un nouveau fichier est généré, avec un numéro séquentiel incrémenté. Si un fichier du même nom existe déjà, il est directement remplacé. Vous pouvez définir le numéro de départ de la séquence à l'aide du paramètre valeur. Ces fichiers texte stockent dans un format tabulé simple diverses informations concernant chaque requête : heure, numéro de process, taille de la requête, durée de traitement, etc. Ces informations sont particulièrement utiles en phase de mise au point de l'application ou à des fins statistiques. |
Query by formula on server | Entier long | 46 | Portée : Table et process courants Conservé entre deux sessions : Non Valeurs possibles : 0 (utiliser le paramétrage de la base), 1 (exécuter sur le client) ou 2 (exécuter sur le serveur) Description : Emplacement de l’exécution des commandes QUERY BY FORMULA et QUERY SELECTION BY FORMULA pour la table passée en paramètre. Dans le cadre de l’exploitation d’une base en client-serveur, les commandes de recherche "par formule" peuvent exécutées soit sur le serveur soit sur le client :
Si vous passez 0 dans le paramètre valeur, l’emplacement d’exécution des commandes de recherche "par formule" dépendra de la configuration de la base : dans les bases créées avec 4D v11 SQL, les commandes seront exécutées sur le serveur. Dans les bases converties, elles seront exécutées sur le client ou le serveur en fonction des préférences de la base. Passez 1 ou 2 dans valeur pour "forcer" l’exécution des commandes respectivement sur le client ou sur le serveur. Reportez-vous à l'exemple 2. Note : Si vous souhaitez pouvoir activer les jointures "type SQL" (cf. sélecteur Query by formula joins), vous devez toujours exécuter les formules sur le serveur afin qu'elle ait accès aux enregistrements. Attention, dans ce contexte, la formule ne doit pas contenir d'appel à une méthode, sinon elle est automatiquement basculée sur le poste distant. |
Order by formula on server | Entier long | 47 | Portée : Table et process courants Conservé entre deux sessions : Non Valeurs possibles : 0 (utiliser le paramétrage de la base), 1 (exécuter sur le client) ou 2 (exécuter sur le serveur) Description : Emplacement de l’exécution de la commande ORDER BY FORMULA pour la table passée en paramètre. Dans le cadre de l’exploitation d’une base en client-serveur, la commande ORDER BY FORMULA peut être exécutée soit sur le serveur soit sur le client. Ce sélecteur permet de définir l’emplacement de l’exécution de cette commande (serveur ou client). Ce mode peut également être défini dans les préférences de la base. Pour plus d’informations, reportez-vous à la description du sélecteur 46, Query by formula on server. Note : Si vous souhaitez pouvoir activer les jointures "type SQL" (cf. sélecteur Query by formula joins), vous devez toujours exécuter les formules sur le serveur afin qu'elle ait accès aux enregistrements. Attention, dans ce contexte, la formule ne doit pas contenir d'appel à une méthode, sinon elle est automatiquement basculée sur le poste distant. |
Auto synchro resources folder | Entier long | 48 | Portée : Poste 4D distant Conservé entre deux sessions : Non Valeurs possibles : 0 (pas de synchronisation), 1 (synchronisation auto) ou 2 (demander). Description : Mode de synchronisation dynamique du dossier Resources du poste client 4D ayant exécuté la commande avec celui du serveur. Lorsque le contenu du dossier Resources sur le serveur a été modifié ou qu’une demande de synchronisation a été émise (via l’explorateur de ressources ou suite à l'exécution de la commande NOTIFY RESOURCES FOLDER MODIFICATION), le serveur notifie les clients connectés. Trois modes de synchronisation sont alors possibles côté client. Le sélecteur Auto synchro resources folder vous permet de définir le mode à utiliser pour le poste client et la session courante :
|
Query by formula joins | Entier long | 49 | Portée : Process courant Conservé entre deux sessions : Non Valeurs possibles : 0 (utiliser paramétrages de la base), 1 (toujours utiliser les liens auto) ou 2 (utiliser les jointures SQL si possible). Description : Mode de fonctionnement des commandes QUERY BY FORMULA et QUERY SELECTION BY FORMULA relatif à l’utilisation de "jointures SQL". Dans les bases de données créées à compter de la version 11.2 de 4D v11 SQL, ces commandes effectuent des jointures sur le modèle des jointures SQL. Ce mécanisme permet de modifier la sélection d’une table en fonction d’une recherche effectuée sur une autre table sans que les tables soient reliées par un lien automatique (condition nécessaire dans les versions précédentes de 4D). Le sélecteur Query by formula joins vous permet de définir le mode de fonctionnement des commandes de recherche par formule pour le process courant :
|
HTTP compression level | Entier long | 50 | Portée : Application 4D Conservé entre deux sessions : Non Description : Constante obsolète (conservée par compatibilité uniquement). Il est désormais conseillé d'utiliser les commandes WEB SET OPTION et WEB GET OPTION pour le paramétrage du serveur HTTP. |
HTTP compression threshold | Entier long | 51 | Portée : Application 4D Conservé entre deux sessions : Non Description : Constante obsolète (conservée par compatibilité uniquement). Il est désormais conseillé d'utiliser les commandes WEB SET OPTION et WEB GET OPTION pour le paramétrage du serveur HTTP. |
Server base process stack size | Entier long | 53 | Portée : 4D Server Conservé entre deux sessions : Non Valeurs possibles : Entier long positif. Description : Taille de la pile allouée à chaque process système préemptif sur le serveur, exprimée en octets. La taille par défaut est déterminée par le système. Les process système préemptifs (process de type Process base 4D client) sont chargés de contrôler les process clients 4D principaux. La taille allouée par défaut à la pile de chaque process préemptif permet un bon confort d’exécution mais peut s’avérer conséquente lorsque de très nombreux process (plusieurs centaines) sont créés. A des fins d’optimisation, cette taille peut être diminuée sensiblement si les opérations effectuées par la base s'y prêtent (par exemple si la base n’effectue pas de tris sur de grosses quantités d’enregistrements). Des valeurs de 512 voire de 256 Ko sont possibles. Attention, le sous-dimensionnement de la pile est critique et peut nuire au fonctionnement de 4D Server. Le réglage de ce paramètre est à effectuer avec précaution et doit tenir compte des conditions d’utilisation de la base (nombre d’enregistrements, types d’opérations, etc.). Pour être pris en compte, ce paramétrage doit être exécuté sur le poste serveur (par exemple dans la méthode base Sur démarrage serveur). |
Idle connections timeout | Entier long | 54 | Portée : Application 4D sauf si valeur négative Conservé entre deux sessions : Non Valeurs possibles : Valeur entière exprimant une durée en secondes. La valeur peut être positive (nouvelles connexions) ou négative (connexions existantes). Par défaut, la valeur est 20. Description : Délai maximum d’inactivité (timeout) des connexions au moteur de base de données et au serveur SQL de 4D ainsi que, en mode ServerNet (nouvelle couche réseau), au serveur d'applications 4D. Lorsqu’une connexion inactive atteint ce délai, elle est automatiquement mise en veille, ce qui se traduit par le gel de la session client/serveur et la fermeture du socket réseau. Dans la fenêtre d'administration du serveur, le process utilisateur prend l'état "Postponed". Ce fonctionnement est entièrement transparent pour l’utilisateur : dès qu’il y a reprise d’activité sur la connexion mise en veille, le socket est automatiquement rouvert et la session client/serveur restaurée. Ce paramétrage permet, d’une part, d’économiser des ressources sur le serveur : les connexions mises en veille referment le socket et libèrent un processus sur le serveur. D’autre part, il permet d’éviter les pertes de connexions dues aux fermetures par les pare-feux des sockets inactifs. La valeur de timeout des connexions inactives doit pour cela être inférieure à celle du pare-feu. Si vous passez une valeur positive dans valeur, elle s'applique à toutes les nouvelles connexions dans tous les process. Si vous passez une valeur négative, elle s’applique aux connexions ouvertes dans le process courant. Si vous passez 0, les connexions inactives ne sont pas soumises à un timeout. Ce paramètre peut être défini côté serveur et côté client. Si vous passez deux durées différentes, la plus courte sera prise en compte. Généralement, vous n'aurez pas besoin de modifier cette valeur. |
PHP interpreter IP address | Entier long | 55 | Portée : Application 4D Conservé entre deux sessions : Non Valeurs : Chaîne formatée en IPv4 (par exemple "127.0.0.1") ou en IPv6 (par exemple "2001:0db8:0000:0000:0000:ff00:0042:8329") Description : Adresse IP utilisée localement par 4D pour communiquer avec l’interpéteur PHP via fastcgi. Par défaut, la valeur est "127.0.0.1" (les adresses au format IPv6 sont prises en charge à compter de 4D v16R4).. Cette adresse doit correspondre à la machine sur laquelle se trouve 4D. Ce paramètre peut également être défini globalement pour tous les postes via les Propriétés de la base. Pour plus d’informations sur l’interpréteur PHP de 4D, reportez-vous au manuel Mode Développement. |
PHP interpreter port | Entier long | 56 | Portée : Application 4D Conservé entre deux sessions : Non Valeurs : Valeur de type entier long positif. Par défaut, la valeur est 8002. Description : Numéro du port TCP utilisé par l’interpréteur PHP de 4D. Ce paramètre peut également être défini globalement pour tous les postes via les Propriétés de la base. Pour plus d’informations sur l’interpréteur PHP de 4D, reportez-vous au manuel Mode Développement. |
PHP number of children | Entier long | 57 | Portée : Application 4D Conservé entre deux sessions : Non Valeurs : Valeur de type entier long positif. Par défaut, la valeur est 5. Description : Nombre de process enfants à créer et à maintenir localement par l’interpréteur PHP de 4D. Pour des raisons d’optimisation, l’interpréteur PHP crée et utilise un ensemble (pool) de process système appelés "process enfants" pour traiter les demandes d’exécution de scripts. Vous pouvez faire varier le nombre de process enfants en fonction des besoins de votre application. Ce paramètre peut également être défini globalement pour tous les postes via les Propriétés de la base. Pour plus d’informations sur l’interpréteur PHP de 4D, reportez-vous au manuel Mode Développement. Note : Sous Mac OS, tous les process enfants partagent le même port. Sous Windows, chaque process enfant utilise un numéro de port spécifique. Le premier numéro est celui défini pour l’interpréteur PHP, les autres process enfants l’incrémentent. Par exemple, si le port par défaut est le 8002 et que vous lancez 5 process enfants, ils utiliseront les ports 8002 à 8006. |
PHP max requests | Entier long | 58 | Portée : Application 4D Conservé entre deux sessions : Non Valeurs : Valeur de type entier long positif. Par défaut, la valeur est 500. Description : Nombre maximum de requêtes acceptées par l’interpréteur PHP. Lorsque ce nombre maximum est atteint, l’interpréteur retourne des erreurs du type "serveur occupé". Pour des raisons de sécurité ou de performance, vous pouvez modifier cette valeur. Ce paramètre peut également être défini globalement pour tous les postes via les Propriétés de la base. Pour plus d’informations, reportez-vous à la documentation de fastcgi-php. Note : Côté 4D, ces paramètres sont appliqués dynamiquement, il n’est pas nécessaire de quitter le programme pour leur prise en compte. En revanche, si l’interpréteur PHP était déjà lancé, il est nécessaire de le quitter et de le relancer pour qu’il prenne en compte ces modifications. |
PHP use external interpreter | Entier long | 60 | Portée : Application 4D Conservé entre deux sessions : Non Valeurs : 0 = utiliser interpréteur interne, 1 = utiliser interpréteur externe Description : Valeur indiquant si les requêtes PHP de 4D sont adressées à l’interpréteur interne fourni par 4D ou un interpréteur externe. Par défaut, la valeur est 0 (utilisation de l’interpréteur fourni par 4D). Si vous souhaitez utiliser votre propre interpréteur PHP, par exemple pour bénéficier de modules supplémentaires ou d’une configuration spécifique, passez 1 dans valeur. Dans ce cas, 4D ne démarrera pas son interpréteur en cas de requête PHP. L’interpréteur PHP personnalisé doit avoir été compilé en fastcgi et se trouver sur la même machine que le moteur 4D. A noter que dans ce cas, vous devez entièrement gérer l’interpréteur, il n’est ni démarré ni stoppé par 4D. Ce paramètre peut également être défini globalement pour tous les postes via les Propriétés de la base. |
SSL cipher list | Chaîne | 64 | Portée : Application 4D |
Cache unload minimum size | Entier long | 66 | Portée : Application 4D Conservé entre deux sessions : Non Valeurs possibles : Entier long positif > 1. Description : Taille minimum de mémoire à libérer du cache de la base de données lorsque le moteur a besoin d’y faire de la place pour y allouer un objet (valeur en octets). Ce sélecteur a pour but de permettre de réduire le nombre de libérations de données du cache afin d’obtenir des gains de performances. Vous pouvez faire varier ce paramétrage en fonction de la taille du cache et de celle des blocs de données manipulées dans votre base. Par défaut, si ce sélecteur n’est pas utilisé, 4D décharge au minimum 10 % du cache en cas de besoin de place. |
Direct2D status | Entier long | 69 | Portée: Application 4D |
Direct2D get active status | Entier long | 74 | Note : Ce sélecteur peut être utilisé uniquement avec la commande Get database parameter, sa valeur ne peut pas être fixée. Description : Retourne l’implémentation active de Direct2D sous Windows. Valeurs possibles : 0, 1, 2, 3, 4 ou 5 (cf. valeurs du sélecteur 69). La valeur retournée dépend de la disponibilité de Direct2D, du matériel et de la qualité de la prise en charge de Direct2D par le système d’exploitation. Par exemple, si vous exécutez : SET DATABASE PARAMETER(;Direct2D Hardware) - sur Windows 7 et suivants, $mode vaudra 1 si le système détecte un matériel compatible Direct2D, sinon $mode vaudra 3 (contexte logiciel). - sur Windows Vista, $mode vaudra 1 si le système détecte un matériel compatible Direct2D, sinon $mode vaudra 0 (désactivation de Direct2D). - sur Windows XP, $mode vaudra toujours 0 (incompatibilité avec Direct2D). |
Diagnostic log recording | Entier long | 79 | Portée : Application 4D Conservé entre deux sessions : Non Valeurs possibles : 0 ou 1 (0 = ne pas enregistrer, 1 = enregistrer) Description : Démarrage ou arrêt de l’enregistrement du fichier de diagnostic de 4D. Par défaut, la valeur est 0 (pas d’enregistrement). 4D vous permet d’enregistrer de manière continue dans un fichier de diagnostic un ensemble d’événements relatifs au fonctionnement interne de l’application. Les informations contenues dans ce fichier sont destinées à la mise au point des applications 4D et pourront être analysées avec l’aide des services techniques de 4D. Lorsque vous passez 1 dans ce sélecteur, le fichier de diagnostic, nommé NomBase.txt, est automatiquement créé (ou ouvert) dans le dossier Logs de la base. Une fois que le fichier atteint une taille de 10 Mo, il est refermé et un nouveau fichier NomBase_N.txt est généré, avec un numéro séquentiel N incrémenté. A noter qu’il est possible d’inclure des informations personnalisées dans ce fichier à l’aide de la commande LOG EVENT. |
Log command list | Chaîne | 80 | Portée : Application 4D Conservé entre deux sessions : Non Valeurs possibles : Chaîne contenant la liste des numéros des commandes 4D à enregistrer (séparées par des points-virgules), "all" pour enregistrer toutes les commandes ou "" (chaîne vide) pour n’enregistrer aucune commande. Description : Liste des commandes 4D à enregistrer dans le fichier de débogage (cf. sélecteur 34, Debug log recording). Par défaut, toutes les commandes 4D sont enregistrées. Ce sélecteur vous permet de restreindre la quantité d’informations stockées dans le fichier de débogage en limitant les commandes 4D dont vous souhaitez enregistrer l’exécution. Par exemple, vous pouvez écrire : SET DATABASE PARAMETER(Log command list;"277;341") //enregistrer uniquement les commandes CHERCHER et CHERCHER DANS SELECTION |
Spellchecker | Entier long | 81 | Portée : Application 4D Conservé entre deux sessions : Non Valeurs possibles : 0 (défaut) = correcteur macOS (Hunspell désactivé), 1 = correcteur Hunspell actif. Description : Permet d’activer le correcteur orthographique Hunspell sous macOS. Par défaut, sur cette plate-forme le correcteur natif est activé. Vous pouvez souhaiter utiliser le correcteur Hunspell par exemple pour unifier l’interface de vos applications multiplates-formes (sous Windows, seul le correcteur Hunspell est disponible). Pour plus d’informations, reportez-vous à la page Correction orthographique. |
QuickTime support | Entier long | 82 | Portée : Application 4D Conservé entre deux sessions : Oui Valeurs possibles : 0 (défaut) = QuickTime désactivé, 1 = QuickTime activé. Description : Dans 4D à compter de la v14, par défaut les codecs QuickTime ne sont plus pris en charge. Par compatibilité, vous pouvez les réactiver dans votre base à l’aide de ce sélecteur. La modification de cette option nécessite le redémarrage de la base. A noter toutefois que la prise en charge de QuickTime sera définitivement supprimée dans les prochaines versions de 4D. |
Dates inside objects | Entier long | 85 | Portée : Process courant Conservé entre deux sessions : Non Valeurs possibles : String type without time zone (0), String type with time zone (1), Date type (2) (défaut) Description : Définit la manière dont les dates sont stockées dans les objets, ainsi que leur traitement en cas d'importation/exportation en JSON. Lorsque ce sélecteur vaut Date type (valeur par défaut dans les bases créées à compter de 4D v17), les dates 4D sont stockées avec le type date dans les objets, en tenant compte des paramétrages de date locaux. Lorsqu'ils sont exportés au format JSON, les attributs date seront convertis en chaînes qui ne contiennent pas l'heure (Note : ce paramétrage peut être défini au niveau des paramètres de la base via l'option "Utiliser le type date au lieu du format date ISO dans les objets" dans la Page Compatibilité). Si vous passez String type with time zone dans ce sélecteur, les dates 4D seront converties en chaînes ISO en tenant compte du fuseau horaire local. Par exemple, la conversion de la date !23/08/2013! donne "2013-08-22T22:00:00Z" au format JSON lorsque l’opération est effectuée en France en été (GMT+2). Ce principe est conforme au fonctionnement standard de JavaScript. Ce fonctionnement peut être source d’erreurs si vous souhaitez envoyer des valeurs de date en JSON à une personne qui se trouve dans un autre fuseau horaire. C’est le cas par exemple pour l’exportation d’une table avec Selection to JSON en France destiné à être réimporté aux USA avec JSON TO SELECTION. Par défaut, les dates étant réinterprétées dans chaque fuseau horaire, les valeurs stockées dans la base seront différentes. Dans ce cas, vous pouvez modifier le mode de conversion des dates afin qu’il ne tienne pas compte du fuseau horaire en passant String type without time zone dans ce sélecteur. La conversion de la date !23/08/2013! donnera alors "2013-08-23T00:00:00Z" dans tous les cas. |
Use legacy network layer | Entier long | 87 | Portée : 4D local, 4D Server. Conservé entre deux sessions : Oui Description : Fixe ou lit le statut courant de l'ancienne couche réseau pour les connexions client/serveur. L'ancienne couche réseau est obsolète à compter de 4D v14 R5 et doit être progressivement remplacée dans vos applications par la couche réseau ServerNet. ServerNet sera nécessaire dans les prochaines versions de 4D afin de permettre aux applications 4D de tirer parti des futures évolutions réseau. Pour des raisons de compatibilité, l'ancienne couche réseau est toujours prise en charge afin de faciliter la transition des applications existantes (elle reste utilisée par défaut dans les applications converties depuis des versions antérieures à la v14 R5). Passez 1 dans ce paramètre pour utiliser l'ancienne couche réseau (et désactiver ServerNet), et passez 0 pour désactiver l'ancienne couche réseau (et utiliser ServerNet). Cette propriété peut également être définie à l'aide de l'option "Utiliser l'ancienne couche réseau" présente dans la Page Compatibilité des Propriétés de la base (voir section Options réseau et Client-serveur ; dans cette section, vous trouverez aussi un paragraphe décrivant la stratégie de migration. Nous vous recommandons d'activer ServerNet dès que possible). Il est nécessaire de redémarrer l'application pour que ce paramètre soit pris en compte. Valeurs possibles : 0 ou 1 (0 = ne pas utiliser l'ancienne couche, 1 = utiliser l'ancienne couche) Valeur par défaut : 0 dans les applications créées avec 4D v14 R5 ou suivantes, 1 dans les applications converties depuis 4D v14 R4 ou précédentes. |
SQL Server Port ID | Entier long | 88 | Portée : 4D mode local et 4D Server. Conservé entre deux sessions : Oui Description : Permet de lire ou de fixer le numéro du port TCP utilisé par le serveur SQL intégré de 4D en mode local ou de 4D Server. Par défaut, la valeur est 19812. Le numéro de port TCP peut également être défini dans la page "SQL" de la boîte de dialogue des Propriétés de la base. Lorsque ce sélecteur est utilisé en écriture, la propriété de la base est mise à jour. Valeurs possibles : 0 à 65535. Valeur par défaut : 19812 |
Circular log limitation | Entier long | 90 | Portée : 4D local, 4D Server. |
Number of formulas in cache | Entier long | 92 | Portée : Application 4D. Conservé entre deux sessions : Non Valeurs possibles : Entier long positif Valeur par défaut : 0 (pas de cache) Description : Fixe ou lit le nombre maximum de formules à conserver dans le cache des formules, qui est utilisé par la commande EXECUTE FORMULA. Cette limite est appliquée à tous les process, mais chaque process dispose de son propre cache de formules. Placer des formules dans le cache accélère l'exécution de la commande EXECUTE FORMULA en mode compilé puisque chaque formule en cache est tokenisée une seule fois dans ce cas. Lorsque vous modifiez la valeur du cache, son contenu est réinitialisé même si la nouvelle valeur est supérieure à la précédente. Une fois le nombre maximum de formules en cache atteint, toute nouvelle formule exécutée écrase la plus ancienne dans le cache (mode FIFO). Ce paramètre est pris en compte uniquement dans les bases ou les composants compilés. |
Cache flush periodicity | Entier long | 95 | Portée : 4D local, 4D Server Conservé entre deux sessions : Non Valeurs possibles : entier long > 1 (secondes) Description : Permet de lire ou de fixer la valeur courante de périodicité de l'écriture du cache de données sur le disque, exprimée en secondes. Si elle est modifiée, cette valeur remplace la valeur définie par l'option Ecriture cache toutes les <n> secondes/minutes dans la Page Base de données/Mémoire des Propriétés de la base durant la session courante (elle n'est pas stockée dans les Propriétés de la base). |
Tips enabled | Entier long | 101 | Portée : Application 4D Conservé entre deux sessions : Non Valeurs possibles : 0 = message d'aide désactivés, 1 = messages d'aide activés (défaut) Description : Définit ou récupère l'état d'affichage des messages d'aide dans l'application 4D. Par défaut, les messages d'aide sont activées. Notez que ce paramètre fixe tous les messages d'aides, c'est-à-dire les messages d'aide des formulaires et ceux de l'éditeur du mode Développement. |
Tips delay | Entier long | 102 | Portée : Application 4D Conservé entre deux sessions : Non Valeurs possibles : entier long >= 0 (ticks) Description : délai avant que les messages d'aide soient affichés une fois que le curseur de la souris est arrêté sur les objets avec message d'aide. La valeur est exprimée en ticks (1/60e de seconde). La valeur par défaut est de 45 ticks (0,75 seconde). |
Tips duration | Entier long | 103 | Portée : Application 4D Conservé entre deux sessions : Non Valeurs possibles : entier long >= 60 (ticks) Description : Durée maximum de l'affichage du message d'aide. La valeur est exprimée en ticks (1/60e de seconde). La valeur par défaut est de 720 ticks (12 secondes). |
Min TLS version | Entier long | 105 | Portée : 4D Server, 4D Web Server et 4D SQL Server Conservé entre deux sessions : Non Description : Permet de définir la version minimale de Transport Layer Security (TLS), chargé du cryptage et de l'authentification des données entre les applications et les serveurs. Les requêtes de connexion des clients prenant en charge uniquement des versions inférieures à cette version minimale seront rejetées. Ce paramétrage est appliqué globalement à l'ensemble de la couche réseau. S'il est modifié, le serveur doit être redémarré afin d'utiliser la nouvelle valeur. Valeur par défaut : TLSv1_2 Valeurs possibles :
- Le plug-in 4D Internet Commands utilise sa propre couche réseau, par conséquent ce sélecteur n'aura pas d'impact sur sa configuration TLS. - Ce paramétrage est ignoré pour les connexions client-serveur si votre 4D Server utilise l'ancienne couche réseau. |
Times inside objects | Entier long | 109 | Portée : 4D local, 4D Server (tous process) Conservé entre deux sessions : Oui Valeurs possibles : Times in seconds (0) (défaut), Times in milliseconds (1) Description : Définit la manière dont les valeurs de type heure sont converties et stockées dans les propriétés d'objets et les éléments de collections, ainsi que lors des imports/exports JSON et via les zones Web. Par défaut, à compter de 4D v17, les heures sont converties et stockées en nombre de secondes. Dans les versions précédentes, les heures étaient converties et stockées en nombre de millisecondes dans ces contextes. L'utilisation de ce sélecteur peut vous aider lors de la migration de vos applications en rétablissant le fonctionnement précédent lorsque c'est nécessaire. Note : Les méthodes ORDA et le moteur SQL ne tiennent pas compte de ce paramétrage, ces deux environnements manipulent toujours les heures en nombre de secondes. |
Produit : 4D
Thème : Environnement 4D
Numéro :
643
Modifié : 4D v11 SQL Release 4
Modifié : 4D v11 SQL Release 5
Modifié : 4D v12
Modifié : 4D v13
Modifié : 4D v16 R4
4D - Langage ( 4D v17.1)
4D - Langage ( 4D v17.2)
4D - Langage ( 4D v17.3)
4D - Langage ( 4D v17.4)