|
|
|
|
|
|
|
|
- Quand utiliser la fonction HPasse ?
- Définir un mot de passe sur un fichier de données
- Supprimer un mot de passe sur un fichier de données
- Gestion du mot de passe (OLE DB et Connecteurs Natifs)
HPasse (Fonction) En anglais : HPass
  Disponible uniquement avec ces types de connexion
Fixe le mot de passe utilisé pour créer ou pour ouvrir un fichier de données. Le mot de passe est stocké et sera utilisé lors de l'ouverture ou de la création du fichier de données, si aucun mot de passe n'est spécifié. Remarques : - Attention : Il est nécessaire de définir un mot de passe pour réaliser un cryptage des données. Le cryptage des données doit être configuré lors de la description du fichier de données dans l'éditeur d'analyses (Onglet "Détail").
- Ce mot de passe peut aussi être spécifié directement dans les fonctions de création (HCréation, HCréationSiInexistant) et d'ouverture du fichier de données (HOuvre).
- Fichiers cryptés dans une connexion HFSQL : Attention : L'ordre d'utilisation des fonctions permettant de se connecter à une base de données HFSQL Client/Serveur est important. Consultez Optimiser les temps de connexion aux bases HFSQL Client/Serveur pour plus de détails.
// Ouverture d'un fichier de données avec mot de passe et contrôle d'erreur
HPasse(CLIENT, "MotDePasse")
SI HCréationSiInexistant(CLIENT) = Faux ALORS
Erreur("Erreur HFSQL : " + HErreurInfo())
RETOUR
FIN
// HErreurMotDePasse permet de savoir si l'erreur rencontrée est une erreur de mot de passe
SI HCréationSiInexistant() = Faux ALORS
// Détail de l'erreur
SI HErreurMotDePasse() = Vrai ALORS
Erreur("Mot de passe invalide")
// Code pour réessayer
FIN
FIN
Syntaxe
<Résultat> = HPasse(<Fichier de données> [, <Mot de passe>])
<Résultat> : Booléen - Vrai si le mot de passe est enregistré,
- Faux en cas d'erreur (mémoire insuffisante par exemple). Les fonctions HErreur et HErreurInfo permettent d'obtenir plus d'informations sur le problème rencontré.
<Fichier de données> : Chaîne de caractères Nom du fichier de données utilisant un mot de passe.
Si ce paramètre correspond à "*", le mot de passe sera utilisé pour tous les fichiers de données 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). Dans ce cas, le mot de passe sera utilisé pour tous les fichiers du groupe.
Si le fichier de données est déclaré avec la fonction HDéclareExterne, <Nom du fichier> correspond au nom de l'alias du fichier de données. <Mot de passe> : Chaîne de caractères optionnelle Mot de passe associé au fichier de données.
Si ce paramètre n'est pas précisé ou correspond à une chaîne vide (""), aucun mot de passe n'est défini pour le fichier de données. La taille du mot de passe n'est pas limitée.
Remarques Quand utiliser la fonction HPasse ? La fonction HPasse doit être appelée : - avant les fonctions d'ouverture ou de création explicites : HOuvre, HCréation, HCréationSiInexistant.
- avant les fonctions HFSQL accédant aux fichiers de données et qui ouvrent automatiquement les fichiers de données si ce n'est pas déjà fait (lecture, recherche, ajout, ...).
Remarques : - Si un mot de passe est précisé dans les fonctions d'ouverture ou de création explicites (fonctions HOuvre, HCréation, HCréationSiInexistant), le mot de passe précisé dans la fonction HPasse n'est pas pris en compte.
- Le mot de passe des fichiers HFSQL est insensible à la casse.
- Pour changer un mot de passe sur un fichier de données existant ou ajouter un mot de passe sur un fichier de données créé sans mot de passe, il faut utiliser la fonction HChangeMotDePasse.
Définir un mot de passe sur un fichier de données Un fichier de données sera protégé par mot de passe uniquement si : - soit la fonction HPasse a été utilisée avant la fonction de création du fichier de données (fonctions HCréation et HCréationSiInexistant),
- soit le mot de passe a été précisé directement dans la fonction de création du fichier de données.
Remarque : Un fichier de données peut être protégé par mot de passe sans être crypté et inversement. Le mot de passe est indépendant du cryptage des données. Le cryptage des données doit être configuré lors de la description du fichier de données dans l'éditeur d'analyses (Onglet "Détail"). Supprimer un mot de passe sur un fichier de données Pour supprimer un mot de passe sur un fichier de données, il est nécessaire de faire une modification automatique des fichiers de données. Pour cela, il suffit de faire une modification dans l'analyse (par exemple modifier la taille d'une rubrique). Dans ce cas, lors de la génération de l'analyse, une modification automatique des fichiers de données sera proposée. Vous pourrez alors modifier ou supprimer le mot de passe associé à un ou plusieurs fichiers de données. Si vos fichiers de données sont en exploitation, il suffira lors de la création du programme d'installation de préciser qu'une modification automatique des fichiers de données doit être effectuée. Le mot de passe sera ainsi supprimé ou modifié. Attention : si vous supprimez le mot de passe de vos fichiers de données, n'oubliez pas d'adapter votre code. Classification Métier / UI : Code métier
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|