|
|
|
|
|
|
|
|
|
|
HModifieStructure (Fonction) En anglais : HModifyStructure
  Disponible uniquement avec ces types de connexion
Permet de mettre à jour la structure d'une table HFSQL en effectuant une modification automatique des données (également appelée Synchronisation de la Structure des Données Déployées). Attention: Les liaisons ne sont pas gérées (pas de création ou de mise à jour des liaisons existantes). Pour gérer les liaisons, utilisez la fonction HMiseAJourLiaison.
HModifieStructure(Client, hmsTâcheDeFond)
Syntaxe
<Résultat> = HModifieStructure(<Table> [, <Option> [, <Nouveau mot de passe> [, <Sauvegarde> [, <Jauge>]]]])
<Résultat> : Booléen - Vrai si la modification automatique des données a été effectuée,
- Faux dans le cas contraire. Les fonctions ErreurInfo et HErreurInfo permettent d'identifier l'erreur.
<Table> : Chaîne de caractères Nom de la table (défini dans le schéma des données) dont la structure doit être mise à jour.
Si ce paramètre est égal à "*", la modification automatique des données sera appliquée pour toutes les tables connues (décrites dans le schéma des données).
Ce paramètre peut également correspondre au nom d'un groupe de fichiers (ou perso-dossier) défini dans le schéma des données (non disponible en Android et Android Widget). <Option> : Constante ou combinaison de constantes optionnelle Options de la modification automatique des données: | | hmsNormal
(Valeur par défaut) | Fonctionnement par défaut de la modification automatique des données. | | hmsSansContrôle | La modification automatique des données est effectuée même si:- la description du fichier est plus récente que celle du schéma des données,
- le GUID du schéma des données et le GUID du fichier sont différents.
|  Nouveauté 2025hmsSauvegardeJournal | Lors de la modification automatique des données, les étapes suivantes sont réalisées: - Sauvegarde des fichiers journaux (dans le répertoire de sauvegarde des fichiers journaux).
- Suppression des fichiers journaux.
- Lancement de la modification automatique des données.
| | hmsTâcheDeFond | La modification automatique est réalisée à chaud (possible uniquement sur des tables HFSQL Client/Serveur). |
Remarque: En mode hmsNormal ou hmsSansContrôle, la table manipulée ne doit pas être ouverte (par l'application ou par une autre application). <Nouveau mot de passe> : Chaîne de caractères optionnelle ou Chaîne secrète - Nouveau mot de passe de la table.
- Chaîne vide ("") pour supprimer le mot de passe.
Si ce paramètre n'est pas précisé (ou si ce paramètre correspond à NULL), le mot de passe existant n'est pas modifié. Nouveauté 2025Utilisation de chaînes secrètes : Si vous utilisez le coffre-fort de chaînes secrètes, le type de la chaîne secrète utilisable pour ce paramètre doit être "Chaîne Ansi ou Unicode". Pour plus de détails sur les chaînes secrètes et l'utilisation du coffre-fort, consultez Coffre-fort de chaînes secrètes.
<Sauvegarde> : Chaîne de caractères optionnelle - Répertoire de sauvegarde.
- Chaîne vide ("") pour ne pas faire de sauvegarde (valeur par défaut).
<Jauge> : Nom de champ ou nom de fenêtre optionnel Nom du champ de type Jauge ou nom de la fenêtre permettant de visualiser la progression de la modification automatique des données.
Remarques Mot de passe Si la fonction HModifieStructure est la première fonction manipulant la table spécifiée, la vérification du mot de passe est effectuée lors de la manipulation de la table. Ce mot de passe doit avoir été spécifié via la fonction HPasse. Si le mot de passe est incorrect: - la fonction HErreurMotDePasse renvoie Vrai.
- la fonction HModifieStructure renvoie Faux.
Classification Métier / UI: Code métier
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|