|
|
|
|
|
|
|
|
|
|
- Comment décrire une table par programmation?
- Liste des propriétés HFSQL utilisables pour décrire une table par programmation
- Les types de tables pouvant être décrits avec la fonction HDécritTable
- Syntaxe 2: Description de table (compatibilité 5.5)
HDécritTable (Fonction) En anglais : HDescribeFile
 Non disponible avec ce type de connexion
Décrit une table par programmation. Après l'appel à la fonction HDécritTable: - la table peut être manipulée comme n'importe quelle table décrite dans le schéma des données.
- la description de la table ne peut plus être modifiée.
- la variable de description de la table est ré-initialisée. Une nouvelle description de table peut être effectuée.
Pour annuler la description de table par programmation, utilisez la fonction HAnnuleDéclaration.
UnFichier est une Description de Fichier
UneRubrique est une Description de Rubrique
Client est une Source de Données
UnFichier.Nom = "Client"
UnFichier.Type = hFichierNormal
UnFichier.CryptageFic = hCryptageStandard
UneRubrique.Nom = "NOM"
UneRubrique.Type = hRubTexte
UneRubrique.Taille = 40
UneRubrique.TypeClé = hCléUnique
HDécritRubrique(UnFichier, UneRubrique)
UneRubrique.Nom = "PRENOM"
UneRubrique.Type = hRubTexte
UneRubrique.Taille = 40
HDécritRubrique(UnFichier, UneRubrique)
HDécritFichier(UneTable)
...
HCréation(Client)
Client.Nom = "Dupont"
Client.Prénom = "André"
HAjoute(Client)
UneDescriptionFichier est une Description de Fichier
UneRubrique est une Description de Rubrique
sdSource est une Source de Données
UneDescriptionFichier.Nom = "CLIENT"
UneDescriptionFichier.Type = hFichierNormal
UneDescriptionFichier.CryptageFic = hCryptageStandard
UneRubrique.Nom = "NOM"
UneRubrique.Type = hRubTexte
UneRubrique.Taille = 40
UneRubrique.TypeClé = hCléUnique
HDécritRubrique(UneDescriptionFichier, UneRubrique)
UneRubrique.Nom = "PRENOM"
UneRubrique.Type = hRubTexte
UneRubrique.Taille = 40
HDécritRubrique(UneDescriptionFichier, UneRubrique)
HDécritFichier(sdSource, UneDescriptionTable)
HCréation (sdSource)
Syntaxe <Résultat> : Booléen - Vrai si la description de la table est valide et peut être utilisée,
- Faux en cas de problème. La fonction HErreurInfo permet d'identifier l'erreur.
<Table> : Variable de type Description de fichier Nom de la variable de type Description de Fichier (voir paragraphe Notes) permettant de décrire la table. Le nom de la table sera défini grâce à la propriété Nom.
Décrire une table par programmation via une source de données Masquer les détails
<Résultat> = HDécritTable(<Source de données> , <Table>)
<Résultat> : Booléen - Vrai si la description de la table est valide et peut être utilisée,
- Faux en cas de problème. La fonction HErreurInfo permet d'identifier l'erreur.
<Source de données> : Variable de type Source de données Nom de la variable de type Source de données associée à la table. <Table> : Variable de type Description de fichier Nom de la variable de type Description de Fichier (voir paragraphe Notes) permettant de décrire la table. Le nom de la table sera défini grâce à la propriété Nom. Remarques Comment décrire une table par programmation? Pour décrire une table par programmation, il faut: - Solution 1 (syntaxe 1): Description directe
- Utiliser des variables de type Description de Fichier, Description de Rubrique, Description de Liaison et Description d'IndexFullText (si nécessaire).
- Décrire les caractéristiques de la table, de ses rubriques, de ses liaisons et de ses index full-text (si nécessaire) grâce aux propriétés HFSQL.
- Fixer la description des rubriques avec la fonction HDécritRubrique.
- Fixer la description des index full-text avec la fonction HDécritIndexFullText.
- Fixer la description de la table (fonction HDécritTable, syntaxe 1) et des liaisons si nécessaire (fonction HDécritLiaison).
- Solution 2 (syntaxe 2): Description à l'aide d'une source de données
Cette solution permet d'associer la table décrite à une source de données. Dans ce cas, lorsque cette variable sera supprimée, la table sera également supprimée.
Attention: Pour utiliser cette syntaxe, il est nécessaire d'utiliser une source de données "automatique". Pour plus de détails, consultez Description du projet: Onglet Compilation. - Déclarer une variable de type Source de données.
- Utiliser des variables de type Description de Fichier, Description de Rubrique, Description de Liaison et Description d'IndexFullText (si nécessaire).
- Décrire les caractéristiques de la table, de ses rubriques, de ses liaisons et de ses index full-text (si nécessaire) grâce aux propriétés HFSQL.
- Fixer la description des rubriques avec la fonction HDécritRubrique.
- Fixer la description des index full-text avec la fonction HDécritIndexFullText.
- Associer la description de la table à la source de données (fonction HDécritTable, syntaxe 2) et des liaisons si nécessaire (fonction HDécritLiaison).
Liste des propriétés HFSQL utilisables pour décrire une table par programmation Les propriétés suivantes sont disponibles en lecture et écriture.
| | | CompressionMmo | La propriété CompressionMmo permet de paramétrer le mode de compression de la table MMO (contenant les mémo binaires et texte) associé à la table. | | CryptageFic | La propriété CryptageFic permet de paramétrer le mode de cryptage de la table. | | CryptageMmo | La propriété CryptageMmo permet de paramétrer le mode de cryptage du fichier mémo (d'extension .MMO) associé à la table. | | CryptageNdx | La propriété CryptageNdx permet de paramétrer le mode de cryptage du fichier d'index (d'extension .NDX) associé à la table. | | CxAccès | La propriété CxAccès permet de gérer le type d'accès à la table lors de la connexion OLE DB à une table spécifique. | | CxAccèsDécrit | La propriété CxAccèsDécrit permet de gérer le type d'accès à la table lors de la connexion OLE DB à une table spécifique. | | CxBaseDeDonnées | La propriété CxBaseDeDonnées permet de gérer la source de données OLE DB lors de la connexion OLE DB à une table spécifique. | | CxBaseDeDonnéesDécrite | La propriété CxBaseDeDonnéesDécrite permet de gérer la source de données OLE DB lors de la connexion OLE DB à une table spécifique. | | CxLibelléDécrit | La propriété CxLibelléDécrit permet de gérer le libellé de la connexion à la source de données OLE DB. | | CxMotDePasseDécrit | La propriété CxMotDePasseDécrit permet de définir le mot de passe utilisé pour ouvrir le fichier lors d'une connexion OLE DB (fichier défini par programmation uniquement). | | CxProviderOLEDB | La propriété CxProviderOLEDB permet de gérer le nom du provider OLE DB (appelé aussi serveur OLE DB). | | CxProviderOLEDBDécrit | La propriété CxProviderOLEDBDécrit permet de gérer le nom du provider OLE DB (appelé aussi serveur OLE DB). | | CxUtilisateur | La propriété CxUtilisateur permet de paramétrer le nom de l'utilisateur utilisé lors de la connexion OLE DB à une table spécifique. | | CxUtilisateurDécrit | La propriété CxUtilisateurDécrit permet de paramétrer le nom de l'utilisateur utilisé lors de la connexion OLE DB à une table spécifique. | | Format | La propriété Format permet de paramétrer le format des données de la table. | | GrosFichier | La propriété GrosFichier permet de paramétrer la taille maximale possible d'une table. | | Journalisation | La propriété Journalisation permet de:- connaître le mode de journalisation utilisé pour une table (table définie sous l'éditeur de schémas des données ou définie par programmation).
- définir le mode de journalisation utilisé pour une table (lors de la description de la table par programmation uniquement).
| | MotDePasseWDD55 | La propriété MotDePasseWDD55 permet de spécifier le mot de passe du schéma des données au format 5.5 lors de la description par programmation d'une table au format Hyper File 5.5 dans un schéma des données au format HFSQL Classic. | | Nom | La propriété Nom permet de connaître:- le nom de la police associée à une variable de type Police.
- le nom d'un champ, d'un état ou d'un bloc d'un état.
- le nom d'un champ, d'un groupe de champs ou d'une fenêtre.
- le nom d'un champ, d'un groupe de champs ou d'une page.
| | Nom55 | La propriété Nom55 permet de gérer le nom logique d'une table au format Hyper File 5.5 non migré et présent dans un schéma des données au format WINDEV 19. | | NomDécrit | La propriété NomDécrit permet de gérer le nom logique des tables HFSQL (sans tenir compte des éventuelles modifications effectuées par la fonction HAlias). | | NomPhysique | La propriété NomPhysique permet de gérer le nom physique des tables HFSQL. | | NomPhysiqueDécrit | La propriété NomPhysiqueDécrit permet de gérer le nom physique des tables HFSQL. | | Répertoire | La propriété Répertoire permet de gérer le répertoire physique des tables HFSQL. | | RépertoireDécrit | La propriété RépertoireDécrit permet de gérer le répertoire physique des tables HFSQL. | | RépertoireJournal | La propriété RépertoireJournal permet de gérer le répertoire du fichier journal décrit dans le schéma des données. | | RubriqueTexteComplétée | La propriété RubriqueTexteComplétée permet de paramétrer la gestion des rubriques texte dans une table HFSQL. | | Sécurisé | La propriété Sécurisé permet de paramétrer le niveau de sécurité du cryptage des tables. | | Type | La propriété Type permet de connaître:- le type d'un élément décrit par programmation (description de rubrique ou de fichier) ou non (fichier ou rubrique défini sous l'éditeur de schémas des données, vue ou requête).
- le type d'un objet.
- le type de la valeur stockée dans un variant.
| | WDD55 | La propriété WDD55 permet de:- Connaître le nom et le chemin complet du fichier WDD au format Hyper File 5.5.
- Définir le nom et le chemin complet du fichier WDD au format Hyper File 5.5.
|
Les types de tables pouvant être décrits avec la fonction HDécritTable La propriété Type permet de spécifier le type de la table à créer. Les types suivants peuvent être créés avec la fonction HDécritTable: | | | hTableAS400 | Fichier AS 400 | | hTableNormale | Fichier normal | | hTableOLEDB | Fichier OLE DB | | hTableOracle | Fichier Oracle | | hTableSQLAzure | Fichier SQL Azure | | hTableSQLServer | Fichier SQL Server | | hTableSybase | Fichier Sybase | | hTableXBase | Fichier xBase |
Classification Métier / UI: Code métier
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|