Sqlcursor

Cette page d'aide s'applique à Desktop Studio. Ces informations sont aussi disponibles pour Studio.

Soumet une instruction SQL (Structured Query Language) à un serveur de base de données et renvoie un résultat à plusieurs lignes.

Dépendances

  • Utilisez Sqlcursor dans le même but que Sqlselect lorsque plusieurs lignes sont attendues.
  • Cette action ne récupère pas toutes les lignes à la fois. À la place, l’ensemble de données est ouvert et maintenu ouvert pour un accès répétitif.
  • Comme pour Sqlcursor, chaque colonne est stockée dans une variable portant le même nom que la colonne. Initialement, le premier enregistrement sera récupéré. Pour extraire des enregistrements consécutifs, exécutez Sqlnext à plusieurs reprises jusqu’à ce que Sqlnext déclenche sa condition de branche End of Dataset.
  • Si le script ne doit pas continuer à récupérer tous les enregistrements, placez l’action Sqlclose après la condition de branche End of Dataset. Cela fermera manuellement l’ensemble de données. Cela assure que la mémoire de la base de données est libérée et que les verrouillages d’enregistrement potentiels ne seront pas laissés actifs.

Types de scripts pris en charge

The icon for a Generic script type - a rectangle with < and > symbols inside it.

L'icône du type de script Courriel - un grand symbole @ dans un losange.

L'icône du type de script Clavardage - une bulle de clavardage avec des points de suspension à l'intérieur (...), en forme de losange.

L'icône du type de script Téléphone - un combiné téléphonique à l'ancienne avec des lignes courbes indiquant le son qui en sort.

L'icône du type de script de messagerie vocale - un symbole qui ressemble à une cassette - deux cercles assis sur une ligne horizontale.

L'icône pour le type de script d'élément de travail - un morceau de papier avec un coin replié et une liste à puces dessus.

L'icône du type de script SMS - un téléphone intelligent avec une bulle de discussion qui en sort.

L'icône du type de script Digital - un moniteur d'ordinateur avec un téléphone intelligent à côté.

Générique

 courriel Clavardage Téléphone Messagerie vocale Élément de travail SMS Digital

Propriétés d’entrée

Ces propriétés définissent les données que l’action utilise lors de son exécution.

Propriété

Description

Légende

Entrez une courte phrase qui identifie de façon unique cette action dans le script. La légende apparaît sur le canevas du script sous l’icône de l’action. La valeur par défaut est le nom de l’action.

SQLQuery

L’instruction SQL qui sera soumise au serveur de base de données. Il est attendu de cette instruction de retourner des enregistrements.

GlobalVariables

Non utilisé.
Publish

Publie une variable et une valeur à partir du nom de famille récupéré. Par exemple, s'il y avait 3 noms récupérés, seules les données du nom de famille seraient publiées.

TimeoutSec

Nombre de secondes que l'Action attend avant d'expirer. La valeur doit être comprise entre 0 et 60.

Conditions de la branche de résultat

Les conditions de branche de résultat vous permettent de créer des branches dans votre script afin de gérer différents résultats lors de l’exécution d’une action.

Condition

Description

Default

Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.
NoRecords Chemin emprunté s’il n’y a pas de valeurs pour les propriétés spécifiées.
OnError Path taken when the action fails to execute properly. For example, when there is an unexpected problem such as poor connectivity, syntax errors, and so on. The _ERR variable, with a single underscore character, should be populated with a condensed explanation of the problem.