Modifications du script de chargement
Qlik Cloud ne prend pas en charge l'utilisation de chemins d'accès au système de fichiers Windows dans les fonctions, les instructions et les variables. À la place, des connexions de bibliothèque, qui sont des chaînes de connexion à des fichiers de script et de données, sont utilisées, par exemple, lib://DataFiles/myData.txt.
Limitations
L'utilisation de plusieurs instructions, variables et fonctions applicables à QlikView et à Qlik Sense Client-Managed (en mode standard ou hérité) est impossible ou limitée dans Qlik Cloud. En règle générale, ces restrictions sont imposées sur les instructions, variables et fonctions associées aux chemins d'accès au système de fichiers Windows.
L'emploi d'instructions non prises en charge dans le script de chargement de données génère une erreur au moment de l'exécution du script. Les messages d'erreur sont consignés dans le fichier journal du script. En revanche, l'utilisation de variables et fonctions non prises en charge ne génère pas de messages d'erreur ni d'entrées dans le fichier journal. Elle entraîne le renvoi de la valeur NULL.
Pendant l'édition du script de chargement de données, rien ne vous indique qu'une variable, instruction ou fonction donnée n'est pas prise en charge.
Applicabilité des variables, instructions et fonctions dans Qlik Cloud
Si vous envisagez de réutiliser des scripts de chargement de données provenant de QlikView ou de Qlik Sense Client-Managed dans Qlik Cloud, consultez les tableaux suivants pour voir quelles variables, instructions et fonctions sont prises en charge et leurs conditions.
Variables système
Variable | Applicabilité | Définition |
---|---|---|
Floppy |
Non pris en charge |
Renvoie la lettre du premier lecteur de disquette trouvé, normalement a:. |
CD |
Non pris en charge |
Renvoie la lettre du premier lecteur de CD-ROM trouvé. Si aucun lecteur de CD-ROM n'est trouvé, la valeur c: est renvoyée. |
QvPath |
Non pris en charge |
Renvoie la chaîne de navigation jusqu'à l'exécutable Qlik Sense. |
QvRoot |
Non pris en charge |
Renvoie le répertoire racine de l'exécutable Qlik Sense. |
QvWorkPath |
Non pris en charge |
Renvoie la chaîne de navigation jusqu'à l'application Qlik Sense active. |
QvWorkRoot |
Non pris en charge |
Renvoie le répertoire racine de l'application Qlik Sense active. |
WinPath |
Non pris en charge |
Renvoie la chaîne de navigation jusqu'à Windows. |
WinRoot |
Non pris en charge |
Renvoie le répertoire racine de Windows. |
$(include=...) | Entrée prise en charge : Chemin d'accès via la connexion à la bibliothèque | La variable Include/Must_Include spécifie un fichier qui contient le texte à inclure dans le script et à évaluer comme code de script. Elle n'est pas utilisée pour ajouter des données. Il est possible de stocker des parties du code de script dans un fichier texte distinct afin de les réutiliser dans d'autres applications. Il s'agit d'une variable définie par l'utilisateur. |
Instructions de script normales
Instruction | Applicabilité | Définition |
---|---|---|
Binary | Entrée prise en charge : Chemin d'accès via la connexion à la bibliothèque | L'instruction binary s'utilise pour charger des données issues d'une autre application. |
Connect | Non pris en charge | 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. |
Directory | Entrée prise en charge : Chemin d'accès via la connexion à la bibliothèque | 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. |
Execute | Non pris en charge | 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. |
LOAD from ... | Entrée prise en charge : Chemin d'accès via la connexion à la bibliothèque | 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. |
Store into ... | Entrée prise en charge : Chemin d'accès via la connexion à la bibliothèque | L'instruction Store crée un fichier QVD, Parquet, CSV ou TXT. |
Instructions de contrôle de script
Instruction | Entrée prise en charge | Sortie renvoyée | Définition |
---|---|---|---|
For each... filelist mask/dirlist mask |
Connexion à la bibliothèque |
Connexion à la bibliothèque |
La syntaxe filelist mask génère une liste de tous les fichiers, séparés par des virgules, qui se trouvent dans le répertoire actif et qui correspondent à l'instruction filelist mask. La syntaxe dirlist mask génère une liste de tous les répertoires, séparés par des virgules, qui se trouvent dans le répertoire actif et qui correspondent au masque de nom de répertoire. |
Fonctions de fichier
Fonction | Entrée prise en charge | Sortie renvoyée | Définition |
---|---|---|---|
Attribute() | Connexion à la bibliothèque | Renvoie sous forme de texte la valeur des balises méta de différents fichiers multimédia. | |
ConnectString() | Nom de la connexion à la bibliothèque | Renvoie la chaîne connect active pour les connexions ODBC ou OLE DB. | |
FileDir() |
|
Connexion à la bibliothèque | La fonction FileDir renvoie une chaîne contenant le chemin d'accès au répertoire dans lequel figure le fichier de table en cours de lecture. |
FilePath() |
|
Connexion à la bibliothèque | La fonction FilePath renvoie une chaîne contenant le chemin d'accès complet au fichier de table en cours de lecture. |
FileSize() |
Connexion à la bibliothèque |
La fonction FileSize renvoie un entier contenant la taille en octets du fichier filename ou, si aucun argument filename n'est spécifié, du fichier de table en cours de lecture. | |
FileTime() |
Connexion à la bibliothèque |
La fonction FileTime renvoie un horodatage au format UTC de la dernière modification d'un fichier spécifié. Si aucun fichier n'est spécifié, la fonction renvoie un horodatage au format UTC de la dernière modification du fichier de table actuellement lu. | |
GetFolderPath() |
Non pris en charge |
Résultat renvoyé : chemin absolu |
La fonction GetFolderPath renvoie la valeur de la fonction Microsoft Windows SHGetFolderPath. Cette fonction utilise comme données d'entrée le nom d'un dossier Microsoft Windows et renvoie le chemin d'accès complet au dossier. |
QvdCreateTime() | Connexion à la bibliothèque | Cette fonction de script renvoie l'horodatage de l'en-tête XML à partir d'un fichier QVD, le cas échéant. Dans le cas contraire, la valeur NULL est renvoyée. Dans l'horodatage, l'heure est indiquée dans le fuseau horaire UTC. | |
QvdFieldName() | Connexion à la bibliothèque | Cette fonction de script renvoie le nom du numéro de champ fieldno contenu dans un fichierQVD. S'il n'existe pas de champ, NULL est renvoyé. | |
QvdNoOfFields() | Connexion à la bibliothèque | Cette fonction de script renvoie le nombre de champs contenus dans un fichier QVD. | |
QvdNoOfRecords() | Connexion à la bibliothèque | Cette fonction de script renvoie le nombre d'enregistrements contenus dans un fichier QVD. | |
QvdTableName() | Connexion à la bibliothèque | Cette fonction de script renvoie le nom de la table stockée dans un fichier QVD. |
Fonctions système
Fonction | Applicabilité | Définition |
---|---|---|
DocumentPath() |
Non pris en charge |
Cette fonction renvoie une chaîne contenant le chemin d'accès complet à l'application Qlik Sense active. |
GetRegistryString()
|
Non pris en charge |
Renvoie la valeur d'une clé de registre existante avec un chemin de registre donné. Cette fonction peut s'utiliser aussi bien dans les graphiques que dans les scripts. |