Sqltable

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 à plusieurs lignes. Cette action renvoie une heure / date basée sur l’emplacement du serveur principal associé à votre compte (plutôt que sur le fuseau horaire UTC). Vous pouvez convertir cette heure/date dans un autre fuseau horaire en utilisant une action Snippet.

 

Dépendances

  • 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.

  • Cette action renvoie toutes les lignes sous forme de tableau.
  • Utilisez Sqltable dans le même but que action lorsque plusieurs lignes sont attendues. Comme pour l’action Sqlselect, les valeurs des colonnes sont stockées dans des variables dont les noms sont identiques à ceux des colonnes. Cependant, dans cette action, plus d’un enregistrement peut être stocké dans chaque variable de colonne. Chaque enregistrement est séparé par le caractère défini dans la propriété RowSeparator. Si la barre verticale par défaut (|) est utilisée, chaque colonne peut être référencée comme un tableau.
  • Les bases de données SQL ne garantissent aucun type d’ordre lorsque vous ne triez pas explicitement les données.
  • Faites attention à ne pas sélectionner une grande quantité de données. AU bout du compte, cela provoquera l’échec du script. Si un accès séquentiel à une grande table est nécessaire, voir l’action Sqlcursor.

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

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. Cette instruction devrait retourner des enregistrements.

RowSeparator

Le caractère délimiteur utilisé pour séparer les enregistrements individuels.

FieldCountVar

Le nom de la variable qui renverra le nombre de champs renvoyés par la requête SQL.

RowCountVar

Le nom de la variable qui renverra le nombre de lignes renvoyées par la requête SQL. La valeur « Var nombre de lignes » créée est très utile avec une action Loop pour déterminer le nombre de fois que vous voulez répéter une séquence.

GlobalVariables

Non utilisé.
Publish Publie une variable et une valeur, tous les éléments de la base de données étant associés à un contact. Si vous souhaitez publier des données spécifiques, utilisez l’action Assign.

MaxRows

Nombre maximal de lignes à récupérer. La valeur par défaut est 100.

TimeoutSec

Le nombre de secondes jusqu’à ce que la requête expire. La valeur par défaut est 10. Le nombre maximum de secondes pris en charge est 30 (bien que des nombres plus élevés puissent être saisis dans le champ).

Branches

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.
Error 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. Cela se produit lorsque la requête SQL n’est pas valide.
Timeout Chemin emprunté s'il n'y a pas de réponse pour le nombre de secondes spécifié.