|
|
|
|
|
|
|
|
- Accès à une base de données présente sur le Terminal Mobile (Pocket PC)
- Gérer les colonnes des bases de données standard du Terminal Mobile (tâches, contacts, ...)
- Parcours des enregistrements correspondant à une condition
cdbLitRecherche (Fonction) En anglais : cdbReadSeek Positionne sur le premier enregistrement d'un fichier de données dont la valeur d'une colonne spécifique est égale à une valeur recherchée (recherche à l'identique). L'enregistrement est lu. En général, la fonction cdbLitRecherche permet de se positionner dans le fichier de données pour effectuer une boucle de parcours parmi les enregistrements correspondant à une condition. La fonction cdbLitSuivant permet de lire l'enregistrement suivant correspondant à la condition. Après l'exécution de la fonction cdbLitRecherche, plusieurs cas peuvent se présenter : - un enregistrement correspondant à la condition a été trouvé et chargé en mémoire : la fonction cdbLitRecherche renvoie Vrai, la fonction cdbTrouve renvoie Vrai.
- le fichier de données est vide ou il n'existe pas d'enregistrement correspondant à la condition : aucune lecture n'est effectuée, la fonction cdbLitRecherche renvoie Faux et la fonction cdbEnDehors renvoie Vrai.
Attention : A partir de Windows Mobile 5, l'accès à une base de données standard (tâches, contacts, rendez-vous, ...) n'est plus possible depuis une application Windows (et donc depuis une application WINDEV standard). | | | | | Accessible depuis le PC | Accessible depuis le simulateur | Accessible depuis le Terminal Mobile (Pocket PC) | | Base CDB | Oui | Oui | Oui | | Base de données standard | Non | Non | Oui |
// Recherche du premier enregistrement pour lequel le nom du client est Dupont
ResRecherche = cdbLitRecherche("MaBase", "Client", "Nom", "Dupont")
// Enregistrement trouvé ?
TANTQUE cdbTrouve("MaBase", "Client") = Vrai
        Compteur ++
        cdbLitSuivant("MaBase", "Client")
FIN
// Nombre d'enregistrements trouvés ?
Info("Nombre de clients ayant pour nom Dupont : " + Compteur)
// Recherche du premier enregistrement pour lequel le nom du client commence par Dupont
ResRecherche = cdbLitRecherche("MaBase", "Client", OX3A16001F, "Dupont", ...
cdbParIdentifiant + cdbCommencePar)
...
Syntaxe
<Résultat> = cdbLitRecherche(<Base de données> , <Fichier de données> , <Colonne> , <Valeur recherchée> [, <Option>])
<Résultat> : Booléen - Vrai si un enregistrement a été trouvé,
- Faux dans le cas contraire (par exemple si la colonne ne correspond pas à une clé). En cas d'erreur, il est possible de connaître le détail de l'erreur grâce à la fonction ErreurInfo.
<Base de données> : Chaîne de caractères (avec guillemets) - Nom de la base de données préalablement ouverte avec la fonction cdbOuvre,
- Chaîne vide ("") pour manipuler une des bases de données standard du Terminal Mobile (tâches, contacts, ...).
<Fichier de données> : Chaîne de caractères (avec guillemets) Fichier de données à manipuler. Ce paramètre correspond :- soit au nom du fichier de données à manipuler.
- soit à la constante correspondant à une des bases de données standard :
| | | cdbContact | Base de données "Contacts" | | cdbTâche | Base de données "Tâches" | | cdbRendezVous | Base de données "Rendez-Vous" |
Si ce paramètre correspond à une chaîne vide (""), la fonction cdbLitRecherche va manipuler le dernier fichier de données utilisé par la dernière fonction de gestion des bases de données du Terminal Mobile (fonction commençant par les lettres cdb). <Colonne> : Entier ou chaîne de caractères (avec guillemets) Colonne de type clé à manipuler. Ce paramètre peut correspondre :- soit au nom de la colonne.
- soit à l'identifiant de la colonne. Dans ce cas, la constante cdbParIdentifiant doit être spécifiée dans le paramètre <Option>.
- soit à l'indice de la colonne.
Dans le cas d'une base de données standard du Terminal Mobile (tâches, contacts, ...), utilisez une des constantes présentes dans le fichier "cdbConst.WL". Pour plus de détails, consultez les remarques. <Valeur recherchée> : Type de la valeur recherchée Valeur à rechercher. <Option> : Constante ou combinaison de constantes optionnelle de type entier Options à prendre en compte :
| | | cdbCommencePar | Recherche de type "Commence par" (recherche générique).
Ce type de recherche peut être réalisé uniquement sur les colonnes de type texte.
Par défaut, une recherche à l'identique est réalisée. | | cdbParIdentifiant | Indique que le paramètre <Colonne> correspond à l'identifiant de la colonne. |
Ces deux constantes peuvent être combinées. Remarques Accès à une base de données présente sur le Terminal Mobile (Pocket PC) Le tableau ci-dessous présente les actions nécessaires pour accéder à une base de données présente sur le Terminal Mobile : | | | | Base de données | Base de données standard (tâches, contacts, rendez-vous, ...) | | Application WINDEV standard | - Établir une connexion entre le poste en cours et le Terminal Mobile (fonction ceConnecte).
- Ouvrir la base de données à manipuler (fonction cdbOuvre).
| Établir une connexion entre le poste en cours et le Terminal Mobile (fonction ceConnecte). | | Application WINDEV Mobile | Ouvrir la base de données à manipuler (fonction cdbOuvre). | Aucune action spécifique n'est nécessaire. |
Rappel : A partir de Windows Mobile 5, l'accès à une base de données standard (tâches, contacts, rendez-vous, ...) n'est plus possible depuis une application Windows (et donc depuis une application WINDEV standard). Gérer les colonnes des bases de données standard du Terminal Mobile (tâches, contacts, ...) Pour gérer les différents colonnes des bases de données standard du Terminal Mobile (tâches, contacts, ...) : 1. Intégrez le fichier "cdbConst.wl" dans votre projet. Ce fichier liste l'ensemble des identifiants des colonnes des bases de données standard du Terminal Mobile (tâches, contacts, ...). Pour utiliser ce fichier dans votre projet, il est nécessaire d'utiliser le mot-clé EXTERNE de la façon suivante :
// -- Code d'initialisation du projet
EXTERNE "cdbConst.wl"
2. Utilisez les constantes présentes dans le fichier "cdbConst.wl" :
ResRech = cdbLitRecherche("", cdbContact, CDB_CONTACT_NOMAFFICHE, "Dupont", cdbParIdentifiant)
Remarque : la recherche ne peut être effectuée que sur une colonne clé. Les colonnes clé pour les bases de données standard du Terminal Mobile sont les suivantes :
| | | Base de données Contacts | Prénom
Nom affiché
Société | | Base de données Tâches | Objet
Priorité
Etat | | Base de données RendezVous | Date
Durée |
Cas particulier : Recherche sur la clé "Nom affiché" :Cette rubrique étant composée du Nom et du Prénom, il est conseillé de faire une recherche de type "Commence Par". Parcours des enregistrements correspondant à une condition En général, la fonction cdbLitRecherche permet de se positionner dans le fichier de données pour effectuer une boucle de parcours parmi les enregistrements correspondant à une condition. La fonction cdbLitSuivant permet de lire l'enregistrement suivant correspondant à la condition. Pour ne plus tenir compte de la recherche lors du passage à l'enregistrement suivant, il suffit d'utiliser une des fonctions suivantes : Limitation : Lors d'une recherche, il n'est pas possible de se positionner sur l'enregistrement précédent correspondant à la condition recherchée (fonction cdbLitPrécédent). La recherche n'est pas annulée et la fonction cdbLitPrécédent retourne Faux.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|