Langage et paramètres Anglais-US pour les méthodes

A compter de 4D v15, l'éditeur de méthodes de 4D utilise par défaut le mode international "Anglais-US", quelle que soit la langue de l'application 4D ou les paramètres système locaux. Cette nouvelle fonctionnalité rend le code indépendant de toute variation régionale susceptible de perturber son interprétation lorsque différentes versions de l'application 4D sont utilisées (formats de date par exemple) ; en outre, dans la version française de 4D, les commandes et les constantes sont exprimées en "anglais-US". 

Ce nouveau paramétrage par défaut apporte plusieurs bénéfices aux développeurs 4D :

• Il facilite le partage du code entre les développeurs, quels que soient leur pays, paramètres régionaux, ou version de 4D. Une méthode 4D peut désormais être échangée par simple copier/coller ou enregistrée dans un fichier texte, sans aucun problème de compatibilité.
• Il rend également les méthodes 4D compatibles avec l'utilisation d'outils de contrôle des sources, qui requièrent souvent que les exports soient indépendants des paramètres régionaux ou des langues.

Ce paramétrage peut être désactivé via une nouvelle option dans la boîte de dialogue des Préférences de 4D.

La nouvelle option Utiliser langage français et paramètres régionaux système, page Méthodes/Options de la boîte de dialogues des Préférences de 4D, vous permet de désactiver/activer le paramétrage "international" pour les méthodes et le langage 4D :

• Lorsque l'option est désélectionnée (option par défaut dans 4D v15), les paramètres "US-anglais" et le langage anglais sont utilisés dans les méthodes 4D pour l'application 4D locale.
• Lorsque l'option est cochée, les paramètres régionaux définis dans le système sont utilisés dans les méthodes 4D pour l'application 4D locale et le langage 4D est en version française, comme dans les versions précédentes.

Si vous modifiez cette option, vous devez redémarrer l'application 4D afin que le changement soit pris en compte.

Le nouveau paramétrage Anglais-US peut modifier sensiblement votre façon d'écrire des méthodes. Cela concerne le code en mode développement ainsi que les formules saisies dans les applications finales. 

Dans ce nouveau mode, les règles suivantes s'appliquent :

• le séparateur décimal pour les nombres réels est le point (".") dans toutes les versions (et non la virgule (",") comme c'est l'usage en français par exemple).
• les constantes de type date doivent utiliser le format ISO (!YYYY-MM-DD!) dans toutes les versions.
• les noms des commandes et des constantes sont en anglais (cette modification ne concerne que la version française de 4D car le langage est déjà en anglais dans toutes les autres langues de 4D).

Note : L'éditeur de méthodes de 4D v15 inclut des mécanismes spécifiques permettant de corriger automatiquement les saisies incorrectes si nécessaire.

Le tableau suivant illustre les différences de code entre 4D v15 et les versions précédentes :

Note : Dans les versions précédentes de 4D ainsi que dans 4D v15 lorsque la nouvelle préférence est cochée, les formats de date et de réel sont basés sur les paramètres système.

Certains changements affectent uniquement la version française de 4D dans laquelle des dénominations en français étaient utilisées pour le langage (commandes et constantes), ainsi que pour l'aide en ligne et la documentation.

Une nouvelle interface hybride et une documentation adaptée sont proposées dans 4D v15 en configuration par défaut :

• Dans l'éditeur de méthodes, les commandes et les constantes sont affichées et saisies en anglais.
• Dans 4D, les listes de constantes et de commandes ainsi que les suggestions (saisie prédictive) sont en anglais. A noter que les constantes et commandes des plug-ins 4D Write et 4D View ne sont pas impactées.  
• La documentation accompagne cette évolution :
  
  • sur le site web de la documentation de 4D (doc.4d.com), une nouvelle version "français/anglais" est proposée : la documentation est en français mais les éléments du langage 4D sont en anglais ; par défaut, vous accédez à cette version depuis 4D, par exemple en appuyant sur la touche F1.
  • la syntaxe des commandes dans l'éditeur de code est également affichée sous forme hybride.

Note : La documentation des commandes 4D "en français" reste bien entendu disponible sur le site http://doc.4d.com. Pour y accéder directement depuis 4D (via la touche F1), il vous suffit de remplacer /fe/ par /fr/ à la fin de l'URL d'accès à la documentation (page Préférences/Général).

Dans les applications converties depuis les versions précédentes, la configuration Anglais-US du code 4D dans 4D v15 peut nécessiter des adaptations dans certains cas spécifiques. Ces modifications sont nécessaires uniquement dans les contextes ou le code est interprété à la volée, et non tokenisé, par exemple à l'aide de la commande EXECUTER FORMULE. Cela concerne aussi bien le mode Développement que les applications de déploiement (4D en mode distant et les applications 4D fusionnées).

Le tableau suivant liste les différences de fonctionnement dans les applications 4D v15, en fonction du langage d'exécution (les langages non cités seront généralement impactés de la même manière que la version US) :

Gardez à l'esprit que, si nécessaire, la nouvelle option Utiliser langage français et paramètres régionaux système des préférences vous permet de rétablir le fonctionnement de 4D v14.

Comme la préférence Utiliser langage français et paramètres régionaux système est locale à la machine, elle n'est pas incluse dans les applications fusionnées.

Dans le contexte du déploiement d'applications fusionnées, vous disposez de deux possibilités afin d'utiliser les paramètres régionaux :

• Supprimer le répertoire en.lproj situé au premier niveau du dossier Resources de l'application 4D Volume Desktop avant de générer l'application fusionnée finale.

• Editer le contenu du fichier de préférences de 4D v15 sur chaque machine locale et fixer la clé "use_localized_language" à "true".
  L'exemple de code suivant vous permet d'effectuer cette opération. Attention, après son exécution, il est nécessaire de redémarrer l'application 4D pour que la modification soit effective :
   $UserPreference:=Dossier 4D(Dossier 4D actif)+"4D Preferences v15.4DPreferences"
 $ref:=DOM Analyser source XML($UserPreference;Vrai)
 $refElem:=DOM Chercher element XML($ref;"preferences/com.4d/method_editor/options";arrElementRefs)
 
   // On lit la valeur courante
 DOM LIRE ATTRIBUT XML PAR NOM($refElem;"use_localized_language";$attrValue)
 
 Si($attrValue="false")
      // Retour au fonctionnement v14
    DOM ECRIRE ATTRIBUT XML($refElem;"use_localized_language";"true")
 Fin de si
 
 DOM EXPORTER VERS FICHIER($ref;$UserPreference)
 DOM FERMER XML($ref)