Manuel d'utilisation du générateur QtoQS

L'objectif du Connecteur Qlik Sense est d'interfacer Cegid XRP Ultimate avec le produit BI Qlik Sense.

Cette interface repose sur la génération de fichiers, fichiers script au format Qlik Sense, qui sont constitués par les éléments définis dans les métiers de l'Application Décisionnel.
Cette génération est exécutée à partir d'une soumission nommée QTOQS.
La génération permet de stocker ces fichiers en base de données ou sous forme de fichier.
Dans ce cas de gestion de fichiers, une fois la génération effectuée, il est nécessaire de transférer ces fichiers vers le serveur Qlik Sense puis de relancer le rechargement des données sous Qlik pour mettre à jour l'application.

La couverture fonctionnelle est globale à toutes les applications de Cegid XRP Ultimate.

La gestion de la confidentialité n'est pas disponible pour cette interface.
Cette interface est soumise à une autorisation du module "QTOQS".

Le traitement s'exécute depuis la soumission QTOQS, un traitement est généré à la validation .

Il s'agit d'un traitement comme tous :
- le suivi sous la consultation des travaux,
- une personnalisation pour chaque métier est possible par la Commande "Valeurs par défaut" de la soumission.

Ce traitement permet la création de fichier script à partir d'un métier identifié par son code métier et sa langue.

Tout fichier est un script au format Qlik constitué par des balises et du code SQL contenant toutes les vues, colonnes et jointures de votre métier.

Seuls les codes métier et langue sont obligatoires, les autres critères sont facultatifs on non gérés.

- Métier : code du métier.
- Langue : langue d'un métier.

- Nom du fichier : facultatif
Nom du fichier résultat qui reprend le code métier s'il n'est pas précisé.
Ce fichier résultat prend la terminaison '.qvs' automatiquement si l'extension n'est pas renseignée.

- Options : facultatif
Les options permettent de modifier le stockage des fichiers générés.
L'option B permet de gérer les fichiers en base uniquement.
L'option F permet de gérer les fichiers externes uniquement, fichiers dans le répertoire dédié et dans les fichiers attachés au job.
Si l'option n'est pas renseignée, les deux stockages sont disponibles.

- Nom de base : non utilisé,
- Paramètre 1 : non utilisé,
- Paramètre 2 : non utilisé.

Ce fichier est généré dans un répertoire du serveur de traitements, répertoire portant le nom du métier ou saisi à la soumission.

Pour un serveur sous Linux, le répertoire de localisation par défaut sera le répertoire temporaire (généralement /tmp) du serveur.

Pour un serveur sous Windows, le répertoire de localisation sera le répertoire temporaire de l'utilisateur sous C:\utilisateur\[user]\Appdata\local\temp.
Pour avoir un répertoire unique pour tous les utilisateurs, vous pouvez paramétrer le traitement GWTQTOQS avec l'option JAVA égal à '-Djava.io.temp=C:\temp'.

Ce fichier script créé dans ce répertoire peut être aussi récupéré dans la transaction consultation des travaux et dans les fichiers des travaux associés.

La trace fonctionnelle peut être activée lors du lancement du travail : sous la gestion des traitements, saisir un T dans la zone Debug.

Cette trace recense les étapes réalisées lors de la phase de constitution du fichier.

Sa consultation est possible par le bouton Fichier erreur dans la consultation des travaux.

Dans le cas d'une erreur, se positionner en fin du fichier pour visualiser l'anomalie.

Une trace de constitution de l'ordre SQL est également disponible. Si le paramètre QFEXCEL occurrence TRACE est configuré, un fichier nommé QualiacForExcel_'User'.log sera créé sous ce répertoire.

Ce traitement peut être lancé en mode modification.
Attention, il est recommandé de ne rien supprimer dans le métier, seuls des ajouts ou modifications d'expressions sont souhaitables afin de ne pas influer sur les rapports déjà créés.

Si le fichier résultat existe déjà dans le répertoire final (répertoire relatif au nom du fichier ou si non renseigné le nom du métier), une sauvegarde du fichier existant est réalisée.

Cette copie qui aura le nom au format nom du fichier avec l'ajout comme suffixe de la date et l'heure de cette copie, est faite sous le répertoire constitué su répertoire final suivi de '_SVG'.

Exemple pour un métier TEST avec un nom de fichier non renseigné :
- le répertoire final sera le nom du métier avec TEST ;
- le nom du fichier résultat sera SQL.qvs ;
- la copie se nommera SQL_201909011002.qvs sous le répertoire TEST_SVG.

Le fichier script est constitué de 2 parties :
- la partie LOAD :
Elle définie une table avec ses élements accessibles sous qlik via un nom approprié. Chaque élément est relié avec l'ordre SQL via un identifiant unique.

- la partie SQL.
Cette partie est l'ordre SQL lancé par Qlik pour obtenir les données de la base de l'ERP.

Exemple sous une base Oracle :
// Utilisation include dans le script $Must_Include=[lib://CEGIDRootPath/Shared/Q-BUDGET/Script/10.But.qvs]
But:
LOAD
INTOBBUT AS "Intitulé But",
ABGBUT_100570 AS "Abrégé But",
AUTONUMBERHASH128 (OBBUT_ETSOBBUT,OBBUT_NUMOBBUT) AS "But ID"
;
SQL
SELECT
OBBUT.INTOBBUT,
OBBUT.NUMOBBUT || ' - ' || OBBUT.INTOBBUT   AS ABGBUT_100570,
OBBUT.ETSOBBUT AS OBBUT_ETSOBBUT, OBBUT.NUMOBBUT AS OBBUT_NUMOBBUT
FROM
OPS$DBO.OBBUT   ;

Le paramètre QTOQS permet de compléter la configuration de ce traitement.

Les occurrences sont disponibles dans la gestion des paramètres :

BD
      Permet de paramétrer le schéma de la base de données autres que les valeurs par définis par défaut.

Cette gestion des états permet de ne pas supprimer physiquement des éléments afin de les garder pour une éventuelle réutilisation.
La manipulation des états des éléments le plus fin (élément fils) est généralement suffisante.

Pour chaque entité gérée par ce générateur, voici les diverses gestions possibles des états :

- métier : état actif du métier. La liste des métiers proposés sont des métiers actifs de type générable, rôle à nul ;

- vue : état actif des vues de type colonne ;

- colonne : état actif de la colonne source du métier ;

- expression : état actif de l'expression et de la colonne source du métier ;

- jointure : état actif de l'expression de la jointure, pas de gestion de l'état de la vue de type jointure ;

- filtre : état actif de l'expression du filtre et de la vue filtre.

- Les métiers du Connecteur Qlik Sense doivent être beaucoup plus concentrés que pour toutes les autres interfaces.
En effet, un seul et unique ordre select est constitué avec l'ensemble des éléments (colonnes, jointures et filtres) du métier.

- L'ordre des vues et des colonnes est important pour la constitution de l'ordre SQL.

- La géolocalisation n'est pas défini dans les métiers, les manipulations sous Qlik sont nécessaires.

- Si aucune jointure active n'est définie dans le métier, une erreur générale 'Erreur Boîte de connexion' est indiquée.