|
|
|
|
|
HModifieStructure (Fonction) En anglais : HModifyStructure
Disponible uniquement avec ces types de connexion
Permet de mettre à jour la structure d'un fichier de données 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(<Fichier de données> [, <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.
<Fichier de données> : Chaîne de caractères Nom du fichier de données (défini dans l'analyse) dont la structure doit être mise à jour. Si ce paramètre est égal à "*", la modification automatique des données sera appliquée pour tous les fichiers de données connus (décrits dans l'analyse). Ce paramètre peut également correspondre au nom d'un groupe de fichiers (ou perso-dossier) défini dans l'analyse (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 de l'analyse,
- le GUID de l'analyse et le GUID du fichier sont différents.
| hmsTâcheDeFond | La modification automatique est réalisée à chaud (possible uniquement sur des fichiers de données HFSQL Client/Serveur).
|
Remarque : En mode hmsNormal ou hmsSansContrôle, le fichier de données manipulé ne doit pas être ouvert (par l'application ou par une autre application). <Nouveau mot de passe> : Chaîne de caractères optionnelle - Nouveau mot de passe du fichier de données.
- 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é.
<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 le fichier de données spécifié, la vérification du mot de passe est effectuée lors de la manipulation du fichier de données. 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…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|