Requête

Utilisez l’élément Winshuttle Composer Requête pour interroger une source de données, y compris les sources telles que ODBC, OLE DB, LDAP ou une liste SharePoint.

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.

Dans cette page

Remarque : Si vous utilisez l’option Services de profil utilisateur SharePoint, l’utilisateur doit disposer de la version d’entreprise de SharePoint et avoir configuré les services de profil utilisateur SharePoint.

Propriétés de l’élément Requête

Retour au début

Propriété

Description

Nom

Nom descriptif de l’élément.

Connexion de données

Chaîne de connexion à une source de données qui peut être une chaîne de connexion ODBC, LDAP, OLEDB ou un site SharePoint pour les requêtes de liste SharePoint.

Cliquez pour sélectionner une connexion de données (SQL, SharePoint, services Web SOAP ou autre) pour la requête, ou sur Ajouter pour ajouter une nouvelle connexion.

Voir Ajout de connexions de données pour plus d’informations sur l’ajout de connexions de données.

Chaîne de connexion de requête LDAP

Sélectionnez LDAP (Lightweight Directory Access Protocol), puis fournissez la chaîne de connexion au serveur LDAP.

Champ Nom de profil d’utilisateur (Portail seulement)

Nom du champ qui contient le nom de l’utilisateur en cours. Cette fonctionnalité fonctionne en conjonction avec le contrôle Ws.CurrentUser, où le contrôle remplit un champ donné avec le nom de connexion de l’utilisateur en cours.

REMARQUE : Cette option est utilisée uniquement lors de l’utilisation de SharePoint Portal Server (SPS) ou de Microsoft Office SharePoint Server (MOSS).

Racine de portail

Adresse URL de la racine de SPS ou MOSS.

Requête

Requête SQL ou SharePoint à exécuter sur la source de données.

Moment d’exécution

  • Début : Exécute la requête lorsque le formulaire est lancé.
  • Fin : Exécute la requête lorsque le formulaire est envoyée.
  • 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

Définit des valeurs dans le code XML pour interroger des valeurs de retour. Le format est <nom du champ>=<nom du champ de requête>,<nom du champ>=<nom du champ de requête>,....

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 (si 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.

Message vide

Message à afficher à l’attention de l’utilisateur si la requête ne renvoie aucune ligne. Si ce champ est laissé vide, aucun message ne s’affiche.

Ajout d’une requête

Retour au début

La procédure suivante explique comment ajouter et configurer une requête.

  1. Dans l’onglet Éléments, cliquez sur Éléments avancés.
  2. Cliquez sur Requête.

    winshuttle-composer-properties-pane-elements-advanced-elements-query-highlighted

    L’élément Requête est inséré dans l’angle supérieur gauche du formulaire :

    composer-query-inserted-into-form

  3. Cliquez sur le bouton Requête pour ouvrir ses propriétés dans le volet Propriétés.
  4. Sous Connexion de données, sélectionnez la connexion de données de la requête dans le menu déroulant. (Remarque : Vous pouvez cliquer sur Ajouter pour ajouter une connexion de données, si nécessaire).
  5. Pour ajouter une requête, sous Requête, collez le code de requête dans le champ de requête. Par exemple, il peut se présenter comme suit :

    composer-query-properties-query-example-code

    Conseil : Si la requête interroge une liste SharePoint, seule la valeur « filter= » est nécessaire, car une connexion de données Composer SharePoint dispose déjà du nom de la liste SharePoint et des champs de liste SharePoint gérés dans ses propriétés.

    Exemple : SharePointColumn==@[myFieldXPath] qui peut se présenter comme suit dans un scénario réel : Code==@[/my:myFields/my:CurrencyCode]

  6. Sous Moment d’exécution, indiquez quand la requête doit être exécutée :
    • Début : Exécute la requête lorsque le formulaire est lancé
    • Fin : Exécute la requête lorsque le formulaire est terminé
    • Lorsque le champ change : Exécute la requête en cas de modification du champ
  7. Sous Définir les champs, cliquez sur Choisir. Sélectionnez le ou les champs et la ou les colonnes correspondantes qui doivent afficher les données renvoyées par la requête.

  8. Remplissez les informations restantes, si nécessaire. (Voir ci-dessus la description de chaque option).
    • Ajouter à un groupe répétitif
    • Ordinal
    • Effacer les champs lorsque le retour est vide
    • Message vide

Configuration de l’élément Requête pour les services de profil utilisateur SharePoint

Retour au début

Le service de profil utilisateur SharePoint nécessite le nom de connexion de l’utilisateur pour pouvoir retourner des données. Vous pouvez utiliser l’élément Utilisateur en cours pour obtenir le nom de connexion de l’utilisateur connecté et remplir un champ dans le formulaire avec le nom de connexion.

Remarque : Reportez-vous à l’article Microsoft Technet Default user profile properties table pour savoir quand rechercher des propriétés de profil utilisateur SharePoint. Notez que des propriétés contiennent des espaces, mais ils existent à des fins d’affichage uniquement. Le contrôle Requête nécessite le nom interne de la propriété et non pas le nom d’affichage pour envoyer la valeur de la colonne « Propriété de profil utilisateur » dans la table.

Exemples d’utilisation de l’élément Requête avec SQL

Retour au début

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.

Remarque : « top 1 » dans l’exemple ci-dessus est très spécifique à SAL Server. Les autres bases de données peuvent utiliser une syntaxe différente :

Exemple 2

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 déroulantes. 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 qu’une opération équivalente dans SharePoint.

Alternativement, avec une liste SharePoint, vous disposez d’une instruction select et d’une instruction filter, comme indiqué dans la requête ci-dessous.

select VendorNumber, POC; filter=[VendorName]==@[/my:myFields/my:Vendor_Name]

Cet exemple renvoie deux colonnes SharePoint : Numéro du fournisseur et POC, avec un filtre où vendorname = nom du champ de formulaire.

Remarquez @ et les crochets autour de xpath.