QlikView File - Import
Prérequis du pont
Ce pont :n'est supporté que sous Microsoft Windows.
nécessite une installation de l'outil pour accéder à son SDK.
Spécifications du pont
| Fournisseur | QlikTech |
| Nom de l'outil | QlikView |
| Version de l'outil | 11.2 à 12.x |
| Site Web de l'outil | http://www.qlik.com/us/products/qlikview |
| Méthodologie supportée | [Business Intelligence] Rapport BI (Source relationnelle, Parsage d'expressions, Structure de rapports) via une API COM sur un fichier QVW ou QVD |
| Profiling de données |  |
| Collecte incrémentale | |
| Collecte multi-modèle | |
| Navigation dans le référentiel distant pour sélectionner un modèle | |
SPÉCIFICATIONS
Outil : QlikTech/QlikView version 11.2 à 12.x via une API COM sur un fichier QVW ou QVD
Consultez http://www.qlik.com/us/products/qlikview
Métadonnées : [Business Intelligence] Rapport BI (Source relationnelle, Parsage d'expressions, Structure de rapports)
Composant : QlikView version 11.2.0
VUE D'ENSEMBLE
Ce pont importe des métadonnées de reporting Business Intelligence (BI) depuis un document QlikView Working (QVW) ou un fichier QlikView Data (QVD).
AVERTISSEMENT : Ce pont utilise l'API COM d'un client basé Windows et/ou SDK devant être (a) correctement installé, (b) avoir une licence adéquate au nom de l'utilisateur Windows capable d'exécuter cet outil et (c) capable d'accéder au contenu du serveur de l'outil. De plus :
(1) Comme recommandé par le fournisseur de l'outil, le serveur de l'outil ne doit pas être installé ou coexister sur la machine où le client de l'outil (et le pont) est installé/en cours d'exécution, à cause de conflits potentiels de ressources, notamment par rapport à l'API COM.
(2) Les outils basés sur l'API COM Windows sont connus pour être instables après des échecs répétés ou un manque de ressources système et nécessitent un redémarrage de Windows pour fonctionner à nouveau correctement.
(3) Si ce pont s'exécute en tant qu'application, la connexion doit être faite par le même utilisateur que pour Windows.
Si ce pont est exécuté en tant que service Windows, allez dans le gestionnaire des services Windows, cliquez-droit sur le service MIMB Application Server et allez dans l'onglet "Log On" pour définir le nom du compte sous lequel le service va s'exécuter.
- Logiciel QlikView installé :
Ce pont requiert que le logiciel QlikView et son API COM/OLE soient installés sur la machine l'exécutant.
- Le logiciel QlikView n'est pas en cours d'exécution :
Étant donné que la connectivité à l'API se fait via une automatisation basée sur COM, veillez à fermer toutes les instances QlikView et consultez le Gestionnaire de tâches pour confirmer qu'aucun processus QlikView n'est en cours d'exécution, car cela pourrait interférer avec le démarrage de ce pont.
- Log d'exécution QlikView disponible :
Ce pont requiert le log d'exécution de document Qlik, car certaines métadonnées critiques (par exemple les tables des data stores sources exacts pour le lignage) ne peuvent pas être directement extraits des scripts Qlik en raison de leur aspect dynamique (p. ex. utilisation de boucles, sous-routines, définitions de variable).
Le log d'exécution est censé être à proximité du document QVW (dans le même répertoire).
FOIRE AUX QUESTIONS
Q : Que faire si ce pont semble s'arrêter un long moment sans afficher de message de log après "Connecté à la version xx.xx.xxxxx.x de QlikView" ?
R : Problème de fenêtre pop-up : Étant donné que la connectivité à l'API se fait via une automatisation basée sur COM, l'import peut être bloqué, car un message de boîte de dialogue peut être émis par QlikView et attendre une réponse. Pour résoudre ce problème, recherchez des fenêtres en arrière-plan pouvant être la boîte de dialogue demandant l'attention de l'utilisateur. Parfois, par exemple si ce pont est exécuté en tant que service plutôt que directement en tant qu'application, pour être certain de voir ce message, réexécutez ce pont en tant qu'application plutôt qu'en tant que service.
Q : Comment créer les fichiers de log d'exécution utilisés par ce pont ?
R : Les fichiers de log d'exécution sont générés par QlikView lorsqu'un script de document QVW est exécuté. Activez la génération des fichiers de log dans le menu de QlikView Paramètres > Propriétés du document > Général > Générer un fichier de log. Ensuite, exécutez le script du document QVW.
Q : Quand dois-je générer des fichiers de log d'exécution ?
R : Les fichiers de log d'exécution contiennent des informations qui aident le pont à comprendre les expressions de scripts. Si le script contient des variables, boucles ou instructions de script dynamiques, les fichiers de log d'exécution peuvent être utiles.
Q : Pourquoi mon import produit-il un lignage incorrect si les tables ont le même nom, dans différents projets ?
R : Par exemple, le document charge des données des tables X et Y vers la table Z. Il stocke ensuite les données de la table Z vers le fichier abc123.qvd. Il supprime ensuite la table Z.
Puis il charge les données des tables Y et W vers la table Z et stocke le fichier qwe123.qvd. Il supprime ensuite la table Z.
Puis il charge les données des tables T et X vers la table Z et stocke le fichier asq123.qvd.
Ce document réutilise le nom de la table Z dans trois instructions SQL SELECT différentes. (SELECT > STORE > DROP)
Afin de maintenir le lignage, je dois créer les trois tables susmentionnées, mais je ne peux créer trois tables du même nom. Le pont détecte les tables supprimées et les traite comme des tables temporaires, accordant à chacune un nom unique. Le format de ce nom est : name_Md5(application id)_removedTableNumber.
LIMITATIONS
Consultez les limitations générales connues à l'adresse https://metaintegration.com/Products/MIMB/Help/#!Documents/mimbknownlimitations.html
SUPPORT
Fournissez un package de dépannage avec le log de débogage. Le log de débogage peut être défini dans l'interface ou dans conf/conf.properties avec MIR_LOG_LEVEL=6
Q : Comment fournir au Support les informations nécessaires pour reproduire un problème ?
R : Fournissez une archive des fichiers impliqués dans le problème (QVW, QVD, logs d'exécution, scripts externes). Si vous souhaitez supprimer des données confidentielles de ces fichiers, demandez à un script de s'en charger.
Paramètres du pont
| Nom du paramètre | Description | Type | Valeurs | Défaut | Périmètre | ||
| Fichier | Document QlikView Working (QVW) ou fichier QlikView Data (QVD). Dans le cas d'un document QVW, son log d'exécution doit être à proximité de lui (dans le même répertoire). |
Fichier |
|
Éléments obligatoires | |||
| ID utilisateur | Identifiant de l'utilisateur spécifié dans la section Accès pour protéger le document QlikView. Si l'identifiant de l'utilisateur est incorrect, le pont restera en suspens, à cause d'une fenêtre contextuelle de QlikView qui attendra un identifiant d'utilisateur correct. |
Chaîne de caractères | |||||
| Password | Mot de passe pour l'identifiant utilisateur spécifié dans la section Accès pour protéger un document QlikView. | MOT DE PASSE | |||||
| Fermer après l'exécution | Fermez l'application QlikView après l'import du document. "False (Faux)" L'application reste ouverte sur le Bureau après l'exécution du pont. "True (Vrai)" L'application est fermée après l'exécution du pont. Notez que l'application est démarrée sur la même machine que celle sur laquelle est exécuté le pont. Si ce pont est exécuté à distance sur un serveur distant, ce paramètre doit être défini sur "Vrai", sinon l'application continuera à s'exécuter sur le serveur. |
BOOLEAN | true | ||||
| Miscellaneous | -database.type <liste de types de base de données de connexion> Si l'accès aux bases de données est possible grâce à des connexions ODBC génériques, il est alors essentiel de connaître le type de base de données exact afin de parser correctement cette syntaxe SQL spécifique de base de données pour le lignage. La liste de types de base de données de connexion doit être spécifiée sous la forme d'une paire de valeurs séparées par une virgule : <Connection name>=<Database type> Les types de base de données supportés par le parsing SQL sont : ACCESS CASSANDRA DB2 DENODO HIVE MYSQL NETEZZA ORACLE POSTGRESQL PRESTO REDSHIFT SALESFORCE SAP HANA SNOWFLAKE SQL SERVER SYBASE TERADATA VECTORWISE VERTICA Spécifiez la connexion de base de données par défaut sans nom de connexion, par exemple : -database.type ORACLE Si plusieurs connexions de base de données sont utilisées, spécifiez alors chaque type de base de données en utilisant le nom de la connexion associée, par exemple : -database.type MyConnectionName=ORACLE Il est possible de mélanger le type de base de données par défaut et plusieurs types de base de données de connexion, par exemple : -database.type ORACLE , MyConnectionName1=TERADATA , MyConnectionName1=DB2 OPTIONS QLIK -directory <instruction> Une instruction DIRECTORY de document Qlik est utilisée pour définir le chemin d'accès au répertoire pour les instructions LOAD suivantes. Si ce répertoire n'est pas accessible, utilisez alors une instruction DIRECTORY pour le rediriger vers un autre répertoire. Pour y parvenir, copiez l'instruction DIRECTORY depuis un log d'exécution de document Qlik, ajoutez "=" et spécifiez le chemin d'accès à un autre répertoire. Dans le cas suivant, le dossier 'c:\folder' est redirigé vers le dossier 'd:\folder2', par exemple : -directory [c:\folder1]=[d:\folder2] Si le chemin d'accès après l'instruction DIRECTORY est vide, toutes les instructions DIRECTORY sont redirigées vers le répertoire spécifié, par exemple : -directory []=[d:\folder2] -file.path <répertoire du fichier> Un document Qlik peut avoir des instructions telles que INCLUDE, STORE, LOAD qui fonctionnent avec un chemin d'accès au fichier. Si le chemin d'accès au fichier original n'est pas accessible par ce pont d'import, il enregistre les erreurs suivantes : - "Impossible d'ouvrir le fichier Include : '\\inaccessible\scripts\include.txt" - "Impossible d'effectuer le processus de dépendance, car le document source '\\inaccessible\QVDs\file.qvd' n'est pas accessible" Vous pouvez résoudre les erreurs en copiant les fichiers inaccessibles dans des chemins d'accès accessibles. Si les fichiers dont vous avez besoin sont situés dans "\\inaccessible\folder", copiez-les dans C:\accessible\folder et donnez l'instruction au pont d'import de les lire depuis leur nouvel emplacement, par exemple : -file.path [\\inaccessible]=[c:\accessible] L'option file.path vous permet de remplacer une partie du chemin d'accès du fichier d'origine par une autre en spécifiant plusieurs options file.path, par exemple : -file.path [\\inaccessible]=[c:\accessible], [\\inaccessible2]=[c:\accessible2] Le pont d'import applique plusieurs options -file.path dans l'ordre fourni. -file.path [\\a]=[c:\a], [\\aa]=[c:\aa] - La mauvaise façon -file.path [\\aa]=[c:\aa], [\\a]=[c:\a] - La bonne façon Assurez-vous de ne pas spécifier le file.path à l'extérieur du chemin d'accès au répertoire dans lequel sont placés les documents QlikView à importer. -log.notavailable Le log d'exécution du document Qlik est requis, car des métadonnées essentielles (p. ex. tables de data store sources exactes pour le lignage) ne peuvent pas être extraites directement à partir des scripts Qlik en raison de leur aspect dynamique (p. ex. utilisation de boucles, sous-routines, définitions de variable). Cette option permet d'effectuer l'import même si le log d'exécution n'est pas disponible. Dans ce cas, des métadonnées essentielles pour le lignage peuvent manquer. -qvd.as.file Si ce paramètre est spécifié, le pont importe des fichiers QVD à partir d'instructions LOAD, STORE en tant que fichiers usuels (type CSV ou TXT). Les fichiers QVD peuvent être inaccessibles. Il n'est pas nécessaire d'écraser les chemins des fichiers QVD inaccessibles à l'aide de -file.path. Si ce paramètre n'est pas spécifié, le pont importe des fichiers QVD en tant que modèles OLAP. Les fichiers QVD doivent être accessibles par ce pont d'import (consultez -file.path pour plus d'informations). |
Chaîne de caractères |
Mapping du pont
| Meta Integration Repository (MIR) Métamodèle (se base sur le standard OMG CWM) |
"Fichier QlikView" Métamodèle QlikView (QVW) |
Mapping des commentaires |
| Attribut | Colonne source | |
| Comment | Commentaire | |
| Description | Définition | |
| DesignLevel | Niveau de conception | |
| InitialValue | Valeur initiale | |
| Name (Nom) | Name (Nom) | |
| NativeId | Identifiant natif | |
| Facultatif | Nullable | |
| PhysicalName | Nom physique | |
| Position | Position | |
| Classe | Table source | |
| Name (Nom) | Name (Nom) | |
| ConnectionPackage | Schéma de la connexion | |
| Name (Nom) | Name (Nom) | |
| DesignPackage | Tables | |
| Name (Nom) | Name (Nom) | |
| Dimension | Table | |
| Description | Description | |
| Name (Nom) | Name (Nom) | |
| NativeId | Identifiant natif | |
| NativeType | Type natif | |
| DimensionAttribute | Colonne | |
| Comment | Commentaire | |
| Description | Définition | |
| DesignLevel | Niveau de conception | |
| InitialValue | Valeur initiale | |
| Name (Nom) | Name (Nom) | |
| NativeId | Identifiant natif | |
| Facultatif | Nullable | |
| PhysicalName | Nom physique | |
| Position | Position | |
| Filter | Condition | |
| Name (Nom) | Name (Nom) | |
| Mesurer | Mesurer | |
| Comment | Commentaire | |
| Description | Définition | |
| DesignLevel | Niveau de conception | |
| InitialValue | Valeur initiale | |
| Name (Nom) | Name (Nom) | |
| NativeId | Identifiant natif | |
| Facultatif | Nullable | |
| PhysicalName | Nom physique | |
| Position | Position | |
| Rapport | Document | |
| Name (Nom) | Name (Nom) | |
| ReportAttribute | Champ, Groupe, Variable système, Variable, Expression, Champ système | |
| Name (Nom) | Name (Nom) | |
| ReportAxis | Axe | |
| Description | Définition | |
| Name (Nom) | Name (Nom) | |
| NativeId | Identifiant natif | |
| Position | Position | |
| ReportChart | Curseur, Graphique | |
| Description | Définition | |
| Name (Nom) | Name (Nom) | |
| NativeId | Identifiant natif | |
| Position | Position | |
| ReportDataSet | Variables, Champs, Groupes, Variables système, Expressions, Champs système | |
| Name (Nom) | Name (Nom) | |
| ReportField | Champ de texte, Champ de bouton | |
| Description | Définition | |
| Name (Nom) | Name (Nom) | |
| NativeId | Identifiant natif | |
| Position | Position | |
| ReportList | Zone de liste | |
| Description | Définition | |
| Name (Nom) | Name (Nom) | |
| NativeId | Identifiant natif | |
| Position | Position | |
| ReportMatrix | Table Pivot | |
| Description | Définition | |
| Name (Nom) | Name (Nom) | |
| NativeId | Identifiant natif | |
| Position | Position | |
| ReportPage | Feuille | |
| Description | Définition | |
| Name (Nom) | Name (Nom) | |
| NativeId | Identifiant natif | |
| Position | Position | |
| ReportTable | Tableau simple, Zone de statistiques, Zone de table, Rechercher un objet, Zone d'entrée, Liste multiple | |
| Description | Définition | |
| Name (Nom) | Name (Nom) | |
| NativeId | Identifiant natif | |
| Position | Position | |
| ReportText | Zone de texte, Texte de bouton | |
| Description | Définition | |
| Name (Nom) | Name (Nom) | |
| NativeId | Identifiant natif | |
| Position | Position | |
| Valeur | Valeur | |
| StoreConnection | Connexion | |
| Name (Nom) | Name (Nom) | |
| StoreType | Type de magasin | |
| SystemMajorVersion | Version majeure du système | |
| SystemMinorVersion | Version mineure du système | |
| SystemReleaseVersion | Version du système | |
| SystemType | Type du système | |
| StoreModel | Modèle QVW | |
| Name (Nom) | Name (Nom) | |
| StoreType | Type de magasin | |
| SystemMajorVersion | Version majeure du système | |
| SystemMinorVersion | Version mineure du système | |
| SystemReleaseVersion | Version du système | |
| SystemType | Type du système |