Sqlselect

This help page is for Desktop Studio. This information is also available for CXone Studio.

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

Dépendances

  • Utilisez une action Sqlcursor lorsque des résultats sur plusieurs lignes sont requis.
  • Une requête retourne habituellement une ou plusieurs colonnes de données. Lorsque CXone retourne les données du serveur de base de données au script, chaque colonne individuelle est stockée dans une variable avec le même nom.
  • Vous devrez déterminer si vous voulez une connexion standard, chiffrée ou VPN à votre fournisseur de base de données.
  • Utilisez l’ SETDB action pour choisir le groupe DB Connector dans lequel vous souhaitez effectuer des requêtes. Sans Setdb, la base de données CXone par défaut est utilisée. Cette base de données est un dictionnaire générique de tables fourni à tous les clients.

Types de scripts pris en charge

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

The icon for the Email script type - a large @ symbol in a diamond.

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

The icon for the Voicemail script type - a symbol that looks like a cassette tape - two circles sitting on a horizontal line.

The icon for the Work Item script type-a piece of paper with one corner folded down and a bullet list on it.

The icon for the SMS script type - a smart phone with a chat bubble coming out of it.

The icon for the Digital script type - a computer monitor with a smartphone next to it.

Générique

Courriel Clavardage Téléphone Messagerie vocale Élément de travail SMS Numérique

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

Caption

Saisissez une courte phrase qui identifie de manière unique cette action dans le script. La légende apparaît dans le canevas de script sous l’icône d’action. The default is the action name.

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.

Cette propriété publie tout ce qui est associé à un contact dans la base de données.

Si vous souhaitez publier des données spécifiques, utilisez l’action Assign.

TimeoutSec

Nombre de secondes pendant lesquelles l’action attend d’être exécutée avant de s’arrêter. 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

Chemin emprunté à moins que le script ne remplisse une condition exigeant qu’il prenne l’une des autres branches. Elle est également prise si les autres branches de l’action ne sont pas définies.
NoRecords Chemin emprunté s'il n'y a pas de valeurs pour les propriétés spécifiées. Cela se produit lorsque les données ne sont pas renvoyées de la base de données.
OnError Chemin emprunté lorsque l’action ne s’exécute pas correctement. Par exemple, en cas de problème inattendu tel qu’une mauvaise connectivité, des erreurs de syntaxe, etc. La variable _ERR, avec un seul caractère de soulignement, doit être remplie avec une explication condensée du problème.
OnTimeout Chemin emprunté s'il n'y a pas de réponse pour le nombre de secondes spécifié.

Exemple de script

Cet exemple montre comment cette action peut être utilisée dans les scripts. Il ne s’agit pas d’un texte complet. Des scripts supplémentaires peuvent être nécessaires.

Cet exemple montre la logique qui peut être utilisée avec l’action SQLSELECT dans votre script. L’action SETDB définit le groupe DB Connector qui contient la base de données que vous souhaitez interroger. SQLSELECT soumet une requête ou une procédure stockée. Elle renvoie un seul enregistrement au script. Les données identifiées dans l’instruction SELECT sont renvoyées au script sous forme de variables et de valeurs individuelles.

Les actions SNIPPET de cet exemple contiendraient une logique permettant de traiter chaque branche de manière appropriée. La branche NoRecords est utilisée lorsque la requête ne renvoie aucun résultat.

Téléchargez ce script.