Utilisez l’élément Query pour interroger une source de données, y compris les sources telles que ODBC, OLEDB, ou LDAP.
La requête peut être exécutée lorsque le formulaire est envoyé ou lorsqu’un champ change.
Les résultats de la requête peuvent être affichés dans un élément répétitif s’ils contiennent plusieurs éléments.
-
Fournissez la requête en plaçant le nom de colonne de connexion entre crochets quand vous utilisez des types de connexions Bibliothèque de données de solution ou Données de référence.
-
La propriété de filtre de Contrôle de recherche a été désactivée pour la connexion de données userfromgroup.
Retour à Éléments de formulaire
Rubriques connexes : Propriétés de l’élément
|
Propriété |
Description |
|---|---|
|
Nom |
Nom descriptif de l’élément. |
|
Connexion de données |
Le nom de la connexion de données. Ce peut être un serveur SDL, ODBC, OLEDB ou LDAP, par exemple. En cas de connexion de données LDAP utilisée, les paramètres LDAP sont sélectionnés dans le serveur Evolve. |
|
Requête |
Requête à exécuter sur la source de données. Voir l’aide ci-dessous. Si la requête n’est pas fournie, toutes les données de la connexion de données seront renvoyées. |
|
Exécuter à |
Début : exécute la requête lorsque le formulaire est lancé. Fin : exécute la requête lorsque le formulaire est envoyé. Lorsque le champ change : exécute la requête lorsqu’un champ de formulaire change. Appelé par règle : exécute la requête lorsqu’une règle la déclenche, par exemple, lorsque l’utilisateur clique sur un bouton. |
|
Champ |
Exécute la requête lorsque le champ défini est modifié. |
|
Définir des champs |
Liste de valeurs et de champs renvoyés par la requête et séparés par une virgule à définir dans le formulaire. Le format est le suivant : <Form field name>=<Column in Data Connection>, <Form field name>=<Column in Data Connection>, … |
|
Ajouter à un groupe répétitif |
Ajouter les résultats à un groupe répétitif existant. |
|
Ordinal |
Ordre (1, 2, etc.) dans lequel la requête doit être exécutée (quand plusieurs éléments Requête sont utilisés). |
|
Effacer les champs lorsque le retour est vide |
Si la requête ne renvoie aucune ligne et que vous sélectionnez cette option, les champs de formulaire sont effacés. Cette propriété fonctionne avec Exécution lorsque : « Modification de champ » et « Appelé par une règle » uniquement. |
|
Message vide |
Message à afficher si la requête ne renvoie aucune ligne. Si ce champ est laissé vide, aucun message ne s’affiche. Cette propriété fonctionne avec Exécution lorsque : « Modification de champ » et « Appelé par une règle » uniquement. |
Exemples d’utilisation de l’élément Requête avec SQL
Certains exemples de Requête à utiliser pour les requêtes SQL sont fournis ci-dessous.
Exemple 1
|
select top 1 Profession from [Job Title Taxonomy] where ProfessionID = [/my:myFields/my:PO13_Descriptions/my:PO13_Descriptions_Input/my:Search_Term] |
Cette requête renvoie une seule ligne et un seul champ, où une colonne de table est égale à la valeur d’un champ de formulaire. Notez les crochets autour du nom de table (car il contient des espaces) et le xpath complet du nom de champ de formulaire avec des crochets.
« top 1 » dans cet exemple est spécifique au serveur SQL. Les autres bases de données peuvent utiliser une syntaxe différente.
Exemple 2
|
select Profession from [Job Title Taxonomy] where EmployeeName like '[/my:myFields/my:PO13_Descriptions/my:PO13_Descriptions_Input/my:Search_Term]%' |
Les guillemets simples doivent être utilisés autour du xpath, car cette valeur est une chaîne avec des espaces potentiels.. Le signe de pourcentage est utilisé comme caractère générique après la valeur xpath pour garantir le retour de tous les résultats commençant par la valeur provenant de EmployeeName.
Des guillemets simples sont nécessaires autour des valeurs de type chaîne.
Exemple 3
|
select distinct ProfessionID from [Job Title Taxonomy] |
Cet exemple renvoie des valeurs uniques de ProfessionID à partir de la table. Les résultats sont ensuite associés à une section répétitive d’un formulaire, qui est ensuite utilisée comme entrée pour les valeurs Liste déroulante. Comme les tables qui en résultent peuvent être volumineuses, l’utilisation de SQL pour ce type d’opération est plus rapide et plus efficace.
Exemple 4
Avec une bibliothèque de données de solution et de données de référence, vous disposez d’une instruction select et filter, comme indiqué dans la requête ci-dessous.
Valeur provenant du champ formulaire : [VendorName]=[/my:myFields/my:Vendor_Name]
Cela permet de renvoyer les données quand vendorname est égal à la valeur du champ formulaire Vendor_Name.
Valeur directe : [VendorName]='Vendor1'
Cela renvoie les données où vendorname est égal à Vendor_1.
Exemple 5
Si la valeur est numérique, les valeurs de chaîne entre guillemets simples ne sont pas nécessaires.
[Country]=='[/my:myFields/my:Country]' ET [Region]=='[/my:myFields/my:Region]'