Instructions normales de script
Les instructions normales servent généralement à manipuler des données d'une manière ou d'une autre. Ces instructions peuvent être écrites sur autant de lignes de script que nécessaire et doivent toujours se terminer par un point-virgule « ; ».
Tous les mots-clés du script peuvent être saisis en majuscules et/ou en minuscules. Les noms des champs et des variables utilisés dans les instructions sont toutefois sensibles à la casse des caractères.
Pour afficher une description succincte et la syntaxe d'une fonction, utilisez le menu déroulant de chaque fonction. Pour plus d'informations, cliquez sur le nom de la fonction dans la description de la syntaxe.
L'instruction alias permet de définir un alias qui servira à renommer un champ chaque fois que celui-ci sera présent dans le script qui suit.
Alias fieldname as aliasname {,fieldname as aliasname}
Cette instruction crée une valeur entière unique pour chaque valeur évaluée distincte d'un champ rencontrée au cours de l'exécution du script.
Autonumber *fieldlist
[Using namespace] ]
L'instruction binary permet de charger les données d'un autre document QlikView, y compris les données de Section Access.
Binary [[path] filename]
Permet d'afficher les commentaires (métadonnées) de champ à partir des bases de données et des tableurs. Les noms de champs absents du document seront ignorés. Si plusieurs occurrences d'un nom de champ sont détectées, la dernière valeur est utilisée.
comment *fieldlist using mapname
comment fieldname with comment
Permet d'afficher les commentaires (métadonnées) de table à partir des bases de données ou des tableurs.
comment-table tablelist using mapname
comment-table tablename with comment
L'instruction CONNECT permet de définir l'accès de QlikView à une base de données générale via l'interface OLE DB/ODBC. Pour ODBC, la source de données doit d'abord être spécifiée à l'aide de l'administrateur ODBC.
L'instruction Directory définit le répertoire dans lequel le programme doit rechercher les fichiers de données dans les instructions LOAD ultérieures, jusqu'à ce qu'une nouvelle instruction Directory soit définie.
Directory [path]
L'instruction Disconnect met fin à la connexion ODBC/OLE DB/personnalisée active. Cette instruction est facultative.
Vous pouvez retirer un ou plusieurs champs Qlik Sense du modèle de données et, de ce fait, de la mémoire à tout moment au cours de l'exécution du script, au moyen d'une instruction drop field. La propriété « distinct » d'une table est supprimée après une instruction drop field.
drop-field fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2 ...]]
drop fields fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2 ...]]
Vous pouvez retirer une ou plusieurs tables internes QlikView du modèle de données et, de ce fait, de la mémoire à tout moment au cours de l'exécution du script, au moyen d'une instruction drop table.
drop-table tablename [, tablename2 ...]
drop tables[ tablename [, tablename2 ...]
L'instruction Execute permet d'exécuter d'autres programmes pendant que QlikView est en train de charger des données. Elle s'utilise, par exemple, pour effectuer des conversions nécessaires.
Execute commandline
L'instruction force oblige QlikView à interpréter les noms de champ des instructions LOAD et SELECT ultérieures comme si elles étaient écrites en lettres majuscules uniquement, en lettres minuscules uniquement, en commençant toujours par une majuscule ou telles qu'elles apparaissent (casse mixte). Cette instruction permet d'associer des valeurs de champ issues de tables élaborées selon différentes conventions.
Force ( capitalization | case upper | case lower | case mixed )
L'instruction LOAD charge des champs à partir d'un fichier, de données définies dans le script, d'une table déjà chargée, d'une page Web, du résultat d'une instruction SELECT ultérieure ou via la génération automatique de données.
Load [ distinct ] *fieldlist
[( from file [ format-spec ] |
from_field fieldassource [format-spec]
inline data [ format-spec ] |
resident table-label |
autogenerate size )]
[ where criterion | while criterion ]
[ group_by groupbyfieldlist ]
[order_by orderbyfieldlist ]
L'instruction let complète l'instruction set, utilisée pour définir des variables de script. Contrairement à l'instruction set, l'instruction let évalue l'expression située à droite du signe = avant d'être attribuée à la variable.
Let variablename=expression
Vous pouvez déclarer explicitement une ou plusieurs tables de données internes QlikView comme déconnectées lors de l'exécution du script grâce à l'instruction Loosen Table. L'utilisation d'une ou de plusieurs instructions Loosen Table dans le script permet à QlikView d'ignorer toute déconnexion de tables définie avant l'exécution du script.
loosen-table tablename [ , tablename2 ...]
Loosen Tables tablename [ , tablename2 ...]
L'instruction map ... using permet de mapper une valeur de champ ou une expression donnée aux valeurs d'une table de mappage précise. La table de mappage est créée par l'instruction Mapping.
Map *fieldlist Using mapname
L'instruction NullAsNull permet de désactiver la conversion des valeurs NULL en valeurs de chaîne définies précédemment au moyen d'une instruction NullAsValue.
NullAsNull *fieldlist
L'instruction NullAsValue spécifie les champs pour lesquels il est nécessaire de convertir en valeur la valeur NULL rencontrée.
NullAsValue *fieldlist
L'instruction Qualify permet d'activer la qualification des noms de champ, autrement dit les noms de champ se voient octroyer le nom de la table comme préfixe.
Qualify *fieldlist
L'instruction rem permet d'insérer des remarques ou des commentaires dans le script ou de désactiver temporairement des instructions de script sans pour autant les supprimer.
Rem string
Cette fonction de script permet de renommer un ou plusieurs champs QlikView existants après leur chargement.
rename-field (using mapname | oldname to newname{ , oldname to newname })
Rename Fields (using mapname | oldname to newname{ , oldname to newname })
Cette fonction de script permet de renommer une ou plusieurs tables internes QlikView existantes après leur chargement.
rename-table (using mapname | oldname to newname{ , oldname to newname })
Rename Tables (using mapname | oldname to newname{ , oldname to newname })
L'instruction section permet de déterminer si les instructions LOAD et SELECT ultérieures doivent être considérées comme des données ou comme une définition des droits d'accès.
Section (access | application)
La sélection de champs à partir d'une source de données ODBC ou d'un fournisseur OLE DB s'effectue au moyen d'instructions SELECT SQL standard. Cependant, l'acceptation des instructions SELECT dépend du pilote ODBC ou du fournisseur OLE DB utilisé.
Select [all | distinct | distinctrow | top n [percent] ] *fieldlist
From tablelist
[Where criterion ]
[Group by fieldlist [having criterion ] ]
[Order by fieldlist [asc | desc] ]
[ (Inner | Left | Right | Full)Join tablename on fieldref = fieldref ]
L'instruction set permet de définir des variables de script. Ces variables peuvent servir à remplacer des chaînes, des chemins d'accès, des lecteurs, etc.
Set variablename=string
L'instruction sleep interrompt l'exécution du script pendant la durée spécifiée.
Sleep n
L'instruction SQL vous permet d'envoyer une commande SQL arbitraire via une connexion ODBC ou OLE DB.
SQL sql_command
L'instruction sqlcolumns renvoie un ensemble de champs qui décrit les colonnes d'une source de données ODBCou OLE DB à laquelle une instruction connect a été adressée.
L'instruction sqltables renvoie un ensemble de champs qui décrit les tables d'une source de données ODBC ou OLE DB à laquelle une instruction connect a été adressée.
L'instruction sqltypes renvoie un ensemble de champs décrivant les types d'une source de données ODBC ou OLE DB à laquelle une instruction connect a été adressée.
Vous pouvez utiliser l'instruction star pour définir la chaîne devant représenter l'ensemble des valeurs d'un champ dans la base de données. Elle affecte les instructions LOAD et SELECT ultérieures.
Star is [ string ]
Cette fonction de script crée un fichier QVD ou CSV.
Store [ *fieldlist from] table into filename [ format-spec ];
Cette fonction de script permet d'attribuer des balises à un ou plusieurs champs. Si vous tentez d'ajouter une balise à un nom de champ qui ne figure pas dans le document, l'opération est ignorée. Si des occurrences de nom de champ ou de balise conflictuelles sont détectées, la dernière valeur est utilisée.
Tag fields fieldlist using mapname
Tag field fieldname with tagname
L'instruction trace écrit une chaîne dans la fenêtre Progression de l'exécution du script et, le cas échéant, la consigne dans le fichier journal du script. Elle s'avère extrêmement pratique pour le débogage. L'utilisation d'expansions $ de variables calculées avant l'instruction trace vous permet de personnaliser le message.
Trace string
L'instruction Unmap désactive le mappage de valeurs de champ spécifié par une instruction Map … Using précédente pour les champs chargés ultérieurement.
Unmap *fieldlist
L'instruction Unqualify permet de désactiver la qualification des noms de champ qui a été précédemment activée par l'instruction Qualify.
Unqualify *fieldlist
Permet de supprimer des balises d'un ou de plusieurs champs. Si vous tentez de supprimer la balise d'un nom de champ qui ne figure pas dans le document, l'opération est ignorée. Si des occurrences de nom de champ ou de balise conflictuelles sont détectées, la dernière valeur est utilisée.
Untag fields fieldlist using mapname
Untag field fieldname with tagname