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 fields [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 champ absents de l'application sont 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 Qlik Sense à 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.
ODBC CONNECT TO connect-string [ ( access_info ) ]
OLEDB CONNECT TO connect-string [ ( access_info ) ]
CUSTOM CONNECT TO connect-string [ ( access_info ) ]
LIB CONNECT TO connection
L'instruction Declare permet de créer des définitions de champ, qui précisent les relations entre des champs ou des fonctions. Un ensemble de définitions de champ peut servir à générer automatiquement des champs dérivés, que vous pouvez ensuite utiliser comme dimensions. Par exemple, vous pouvez créer une définition de calendrier, qui vous sert à générer les dimensions associées, telles que l'année, le mois, la semaine et le jour, à partir d'un champ de date.
definition_name:
Declare [Field[s]] Definition [Tagged tag_list ]
[Parameters parameter_list ]
Fields field_list
[Groups group_list ]
<definition name>:
Declare [Field][s] Definition
Using <existing_definition>
[With <parameter_assignment> ]
L'instruction Derive permet de générer des champs dérivés à partir d'une définition de champ créée à l'aide de l'instruction Declare. Vous pouvez soit spécifier les champs de données pour lesquels les champs doivent être dérivés, soit dériver les champs de manière explicite ou implicite d'après les balises de champ.
Derive [Field[s]] From [Field[s]] field_list Using definition
Derive [Field[s]] From Explicit [Tag[s]] (tag_list) Using definition
Derive [Field[s]] From Implicit [Tag[s]] Using definition
L'instruction DIRECT QUERY vous permet d'accéder à des tables par le biais d'une connexion ODBC ou OLE DB au moyen de la fonction Direct Discovery.
direct-query [path]
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é « distincte » 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 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 table.
drop-table tablename [, tablename2 ...]
drop tables[ tablename [, tablename2 ...]
L'instruction Execute permet d'exécuter d'autres programmes pendant que Qlik Sense est en train de charger des données. Elle s'utilise, par exemple, pour effectuer des conversions nécessaires.
Execute commandline
L'instruction FlushLog oblige Qlik Sense à consigner le contenu du tampon du script dans le fichier journal du script.
L'instruction force oblige Qlik Sense à interpréter les noms et les valeurs de champ des instructions LOAD et SELECT ultérieures comme si elles étaient écrites en lettres majuscules uniquement, en lettres minuscules uniquement, 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. Il est également possible de charger des données à partir de connexions analytiques.
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 ]
[extension pluginname.functionname(tabledescription)]
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 '=' lors de l'exécution du script avant qu'elle soit attribuée à la variable.
Let variablename=expression
Vous pouvez déclarer explicitement une ou plusieurs tables de données internes Qlik Sense comme déconnectées lors de l'exécution du script grâce à l'instruction Loosen Table. Lorsqu'une table est déconnectée, toutes les associations entre les valeurs de champ de la table sont supprimées. Il est possible d'obtenir un effet similaire en chargeant chaque champ de la table déconnectée comme une table indépendante, sans lien. L'emploi de tables déconnectées peut s'avérer pratique lors des tests afin d'isoler temporairement différentes parties de la structure de données. Dans le visionneur de tables, une table déconnectée est signalée par des lignes en pointillé. L'utilisation d'une ou de plusieurs instructions Loosen Table dans le script permet à Qlik Sense d'ignorer toute déconnexion de tables définie avant l'exécution du script.
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 Qlik Sense 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 Qlik Sense 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 ]
L'instruction Store crée un fichier QVD ou text.
Store [ *fieldlist from] table into filename [ format-spec ];
Cette instruction de script permet d'assigner des balises à un ou plusieurs champs ou tables. Si vous tentez d'ajouter une balise à un champ ou une table qui ne figure pas dans l'application, 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[field|fields] fieldlist with tagname
Tag [field|fields] fieldlist using mapname
Tag table tablelist 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
Cette instruction de script permet de supprimer des balises des champs ou des tables. Si vous tentez de supprimer une balise d'un champ ou d'une table qui ne figure pas dans l'application, l'opération est ignorée.
Untag[field|fields] fieldlist with tagname
Tag [field|fields] fieldlist using mapname
Tag table tablelist with tagname