Accéder au contenu principal Passer au contenu complémentaire

QlikView File - Import

Availability-note AWS

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 (uniquement en anglais)
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.

LIMITATIONS
Consultez les limitations générales connues à l'adresse MIMB Known Limitations ou dans Documentation/ReadMe/MIMBKnownLimitations.html où elles sont regroupées

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
*.qvw
*.qvd
  É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  

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – dites-nous comment nous améliorer !