Vous êtes sur la page 1sur 1024

Manuel

Version 11.0 pour Microsoft Windows Premire dition, Lund, Sude, octobre 2011 Auteur : QlikTech International AB

Copyright 1994-2011 QlikTech International AB, Sude. Conformment aux lois internationales sur les droits d'auteur, ni la documentation ni le logiciel ne peuvent tre copis, photocopis, reproduits, traduits ou enregistrs sur un support lectronique ou sous une forme lisible par les ordinateurs, en totalit ou en partie, sans l'autorisation crite pralable de QlikTech International AB, sauf dans les cas dcrits dans la licence du logiciel. QlikTech et QlikView sont des marques dposes de QlikTech International AB. Microsoft, MS-DOS, Windows, Windows NT, Windows 2000, Windows 2003, Windows XP, Windows Vista, Windows 2008, SQL Server, FoxPro, Excel, Access et MS Query sont des marques de Microsoft Corporation. IBM, AS/400 et PowerPC sont des marques d'International Business Machines Corporation. Borland, Paradox et dBASE sont des marques de Borland International. ORACLE et SQL*Net sont des marques d'Oracle Corporation. MacOS est une marque d'Apple Corporation. Sun Java et JavaBeans sont des marques de Sun Microsystems, Inc.

Sommaire

Table des matires


Partie 1 Introduction
1 Avant de commencer
1.1 Conventions 1.2 Services techniques QlikTech

17
19
19 20

2 Nouveauts de QlikView 11
2.1 2.2 2.3 2.4 2.5 Caractristiques gnrales Amliorations du client AJAX Serveur QlikView QlikView WorkBench API

21
21 23 24 26 26

3 Problmes de compatibilit avec les versions antrieures de QlikView


3.1 Compatibilit des formats de fichiers 3.2 Environnements client/serveur mixtes

27
27 27

4 QlikView Personal Edition

29

Partie 2 Installation
5 Installation de QlikView
5.1 5.2 5.3 5.4 5.5 5.6 5.7 Packages d'installation de QlikView Tlchargement et lancement du programme d'installation de QlikView Desktop Au cours de l'excution du programme d'installation Enregistrement Distribution en rseau de QlikView diteur de fichiers d'activation de licences Mise jour de QlikView

31
32
32 33 33 34 34 34 36

6 OLEDB et ODBC
6.1 OLEDB 6.2 Quand a-t-on besoin de l'interface ODBC ? 6.3 Crer des sources de donnes ODBC

37
37 37 38

Partie 3 Navigation et bases


7 Lancement de QlikView
7.1 7.2 7.3 7.4 Syntaxe de ligne de commande Page de dmarrage Connexion au serveur Traitement par lots

39
40
40 41 43 45

8 Assistant Mise en route 9 Fichier QlikView


9.1 Fichiers de projet QlikView 9.2 Contrle de la source

47 55
55 56

10 Commandes de menu
10.1 10.2 10.3 10.4 Menu Fichier Menu dition Menu Affichage Menu Slection

57
57 61 62 63

Sommaire

10.5 Menu Disposition 10.6 Menu Paramtres 10.7 Menu Favoris 10.8 Menu Rapports 10.9 Menu Outils 10.10 Menu Objet 10.11 Menu Fentre 10.12 Menu Aide

64 65 65 66 66 67 67 68

11 Barres d'outils et barre d'tat


11.1 11.2 11.3 11.4 11.5 11.6 11.7 11.8 Barres d'outils Barre d'outils Standard Barre d'outils Navigation Barre d'outils Conception Barre d'outils Feuilles Barre d'outils Favoris Personnaliser (les barres d'outils) Barre d'tat

71
71 71 73 73 76 76 76 80

12 Prfrences utilisateur
12.1 Prfrences utilisateur: Gnral 12.2 Prfrences utilisateur: Enregistrer 12.3 Prfrences utilisateur: diteur 12.4 Prfrences utilisateur: Conception 12.5 Prfrences utilisateur: Objets 12.6 Police 12.7 Prfrences utilisateur: Exporter 12.8 Prfrences utilisateur: Impression 12.9 Prfrences utilisateur: Messagerie 12.10 Prfrences utilisateur: Emplacements 12.11 Prfrences utilisateur: Scurit 12.12 Prfrences utilisateur: Licence

81
81 85 86 89 91 93 94 97 98 99 101 102

13 Exportation et impression
13.1 13.2 13.3 13.4 13.5 13.6 13.7 13.8 14.1 14.2 14.3 14.4 14.5 14.6 14.7 14.8 Imprimer: Gnral Imprimer: Disposition Imprimer: En-tte/Pied de page Date et heure Imprimer la feuille Aperu avant impression Options du Presse-papiers Exporter/Exporter le contenu Slection d'une seule valeur de champ Jeu de couleurs Styles de slection Indicateur Slection multiple dans un champ Dplacement de slections Verrouiller des valeurs de champs slectionnes Slections actives

105
105 106 108 109 110 110 111 112

14 Logique et slections

113
113 113 114 115 115 116 117 117

Sommaire

14.9 Slection dans les autres objets 14.10 Rechercher 14.11 Bote de dialogue de recherche avance 14.12 Mode AND dans les listes de slection 14.13 Tables dconnectes 14.14 tats alternatifs

118 120 123 125 126 129

15 Favoris
15.1 15.2 15.3 15.4 15.5 15.6 Types de favoris Bote de dialogue Ajouter un favori Bote de dialogue Favoris Exporter des favoris Importer des favoris tats alternatifs et favoris

131
131 131 133 136 136 138

16 Rapports
16.1 Menu Rapports 16.2 diteur de rapports

139
139 140

17 Alertes
17.1 17.2 17.3 17.4 17.5 Cration d'alertes Utilisation des alertes Alertes Bote de dialogue Alertes Assistant Alerte

159
159 159 160 161 164

18 Vue d'ensemble des variables 19 Vue d'ensemble des expressions 20 Fichiers internes
20.1 20.2 20.3 20.4 Rfrences de fichiers dans la disposition QlikView Fichiers internes dans les documents QlikView Fichiers internes dans le fichier de programme QlikView Sons

171 173 175


175 175 175 176

Partie 4 Script
21 Introduction au chargement de donnes
21.1 Chargement des donnes partir des fichiers 21.2 Chargement des donnes partir des bases de donnes

177
178
178 179

22 Variables et champs
22.1 22.2 22.3 22.4 23.1 23.2 23.3 23.4 23.5 23.6 23.7 23.8 Champs Champs de saisie Variable Autres entits dans QlikView Assistant Instruction Set Rechercher/Remplacer (script) Script masqu Visionneur de tables Proprits des liaisons de donnes Connexion la source de donnes Crer une instruction Select Ouvrir des fichiers locaux

181
181 182 183 183

23 Bote de dialogue diter le script

185
192 193 194 194 198 200 201 205

Sommaire

23.9 Ouvrir des fichiers Internet ou Ouvrir un document QlikView 23.10 Assistant Donnes intgres 23.11 Assistant Table de restriction d'accs 23.12 Assistant Fichier

205 207 209 209

24 Syntaxe de script
24.1 24.2 24.3 24.4 24.5 Instructions de script et mots-cls Noms des tables Variables de script Expansions$ Guillemets

239
239 295 296 303 305

25 Expressions de script
25.1 Oprateurs 25.2 Fonctions d'agrgation 25.3 Autres fonctions

307
307 310 328

26 Structures de donnes
26.1 Instructions de chargement de donnes 26.2 Excution du script 26.3 26.4 26.5 26.6 26.7 26.8 Champs systme Tables logiques Associations entre tables logiques Renommer des champs Concatnation de plusieurs tables en une Join et keep

395
395 395 395 396 397 399 400 401

27 valuation des donnes charges


27.1 Bases de donnes gnriques 27.2 Tableaux croiss 27.3 Faire correspondre des intervalles des donnes discrtes 27.4 Utiliser la syntaxe IntervalMatch tendue pour rsoudre des problmes de dimensions changeant progressivement 27.5 Hirarchies 27.6 Liens smantiques 27.7 Lier des informations des valeurs de champs 27.8 Nettoyage de donnes 27.9 Caractres gnriques dans les donnes 27.10 Manipulation des valeurs NULL dans QlikView 27.11 Jeu de caractres

407
407 408 409 411 412 414 417 418 420 421 423

28 Fichiers QVD
28.1 28.2 28.3 28.4 29.1 29.2 29.3 29.4 29.5 29.6 Objectif des fichiers QVD Cration de fichiers QVD Lecture des donnes de fichiers QVD Utilisation de fichiers QVD pour le chargement incrmentiel Authentification et autorisation Scurit dans QlikView Publisher Scurit utilisant une section d'accs dans le script QlikView Sections dans le script Niveaux d'accs dans Section Access Champs systme d'accs de section

425
425 426 426 427

29 Scurit

433
433 433 433 433 434 434

Sommaire

29.7 Restrictions concernant les fonctionnalits QlikView 29.8 Rduction de donnes dynamique 29.9 Droits d'accs hrits 29.10 Chiffrement

436 436 437 438

Partie 5 Feuille et objets de feuille


30 Proprits du document
30.1 Proprits du document: Gnral 30.2 Proprits du document: Ouverture 30.3 Proprits du document: Feuilles 30.4 Proprits du document: Serveur 30.5 Proprits du document: Planificateur 30.6 Proprits de la zone de saisie: Contraintes et Proprits du document: Variables 30.7 Proprits du document: Scurit 30.8 Proprits du document: Dclencheurs 30.9 Proprits du document: Groupes 30.10 Proprits du document: Tables 30.11 30.12 30.13 30.14 30.15 30.16 30.17 Proprits du document: Trier Proprits du document: Prsentation Proprits du document: Nombre Proprits du document: Brouillage Police Disposition Lgende

439
440
440 448 450 452 455 456 459 461 464 466 469 470 472 474 475 476 481

31 Feuille
31.1 Cration 31.2 Navigation 31.3 Feuille: Menu Objet 31.4 Proprits de la feuille 31.5 Proprits de la feuille: Gnral 31.6 Slectionner des champs/Proprits de la feuille: Champs 31.7 Proprits de la feuille: Objets 31.8 Proprits de la feuille: Scurit 31.9 Proprits de la feuille: Dclencheurs 31.10 Proprits de la range d'onglets

485
485 485 486 486 487 489 490 492 493 494

32 Objets de feuille
32.1 Objets locaux et objets stocks sur le serveur 32.2 Menu Objet 32.3 Glisser-dposer dans Microsoft Office

495
495 496 496

33 Liste de slection
33.1 33.2 33.3 33.4 33.5 33.6 33.7 33.8 33.9 Liste de slection: Menu Objet Proprits de la liste de slection: Gnral Proprits de la liste de slection:Expressions Proprits de la liste de slection: Trier Proprits de la liste de slection: Prsentation Proprits: Nombre Police Disposition Lgende

497
497 501 505 513 514 517 519 520 524

Sommaire

33.10 Affichage sous forme d'arbre d'une liste de slection

526

34 Zone de statistiques
34.1 34.2 34.3 34.4 34.5 34.6 35.1 35.2 35.3 35.4 35.5 35.6 35.7 35.8 Zone de statistiques: Menu Objet Proprits de la zone de statistiques: Gnral Proprits de la zone de statistiques: Nombre Police Disposition Barre de titre Liste multiple: Menu Objet Proprits de la liste multiple: Gnral Proprits de la liste de slection: Trier Proprits de la liste multiple: Prsentation Proprits de la liste multiple: Nombre Police Disposition Barre de titre

529
529 531 534 535 535 535

35 Liste multiple

537
537 540 542 543 547 548 549 549

36 Zone table
36.1 Utiliser la zone table 36.2 Zone table: Menu Objet 36.3 Proprits de la zone table: Gnral 36.4 Proprits de la zone table: Trier 36.5 Proprits de la zone table: Prsentation 36.6 Proprits du graphique: Style 36.7 Proprits de la zone table: Nombre 36.8 Police 36.9 Disposition 36.10 Barre de titre

551
551 551 557 559 559 561 562 563 563 563

37 Zone des slections actives


37.1 37.2 37.3 37.4 37.5 38.1 38.2 38.3 38.4 38.5 38.6 38.7 38.8 38.9 Zone de slections actives: Menu Objet Proprits de la zone des slections actives: Gnral Police Disposition Barre de titre Utilisation de la zone de saisie Zone de saisie: Menu Objet Proprits de la zone de saisie: Gnral Proprits de la zone de saisie: Prsentation Proprits de la zone de saisie: Contraintes et Proprits du document: Variables Proprits de la zone de saisie: Nombre Police Disposition Barre de titre

565
565 567 569 570 570

38 Zone de saisie

571
571 571 573 575 577 579 580 580 580

39 Bouton
39.1 Bouton: Menu Objet 39.2 Proprits du bouton: Gnral 39.3 Actions

581
581 583 585

Sommaire

39.4 Police 39.5 Disposition 39.6 Barre de titre

591 591 591

40 Objet texte
40.1 40.2 40.3 40.4 40.5 40.6 41.1 41.2 41.3 41.4 41.5 Objet texte: Menu Objet Proprits de l'objet texte: Gnral Actions Police Disposition Barre de titre Objet Ligne/flche: Menu Objet Proprits d'objet ligne/flche: Gnral Actions Disposition Barre de titre

593
593 594 598 598 598 598

41 Objet Ligne/flche

599
599 600 602 602 602

42 Objet curseur/calendrier
42.1 Utilisation d'un objet curseur/calendrier 42.2 Objet curseur/calendrier: Menu Objet 42.3 Proprits de l'objet curseur/calendrier: Gnral 42.4 Proprits de l'objet curseur/calendrier: Prsentation (Mode curseur) 42.5 Proprits de l'objet curseur/calendrier: Prsentation (Mode Calendrier) 42.6 Trier 42.7 Nombre 42.8 Police 42.9 Disposition 42.10 Barre de titre

603
603 603 605 608 609 609 609 609 610 610

43 Objet Favori
43.1 43.2 43.3 43.4 43.5 43.6 44.1 44.2 44.3 44.4 44.5 44.6 44.7 45.1 45.2 45.3 45.4 45.5 Objets Favori dans les tats alternatifs Objet favori: Menu Objet Proprits de l'objet favori: Gnral Police Disposition Barre de titre Objet de recherche : Menu Objet Proprits de l'objet de recherche: Gnral Proprits de l'objet de recherche: Prsentation Proprits de l'objet de recherche: Trier Police Disposition Barre de titre Conteneur : Menu Objet Proprits du conteneur: Gnral Proprits du conteneur: Prsentation Police Disposition

611
611 611 612 614 614 615

44 Objet de recherche

617
617 618 621 622 622 622 623

45 Conteneur

625
625 626 628 629 629

Sommaire

45.6 Barre de titre

629

46 Objet personnalis
46.1 46.2 46.3 46.4 47.1 47.2 47.3 47.4 Objet personnalis: Menu Objet Proprits de l'objet personnalis: Gnral Disposition Barre de titre Configuration du volet Objets Partags Ajout et partage d'objets Bote de dialogue Objets stocks sur le serveur

631
631 632 633 634

47 Volet des Objets Serveur

635
635 635 636 637

48 Thmes de disposition
48.1 propos des thmes de disposition QlikView 48.2 Application d'un thme la disposition 48.3 Assistant Crateur de thmes

641
641 642 643

Partie 6 Graphiques
49 Introduction
49.1 49.2 49.3 49.4 49.5 49.6 Nouveau graphique Slections dans les graphiques et les tableaux Changement rapide de type de graphique Dimensionner et dplacer des composants de graphique Proprits du graphique Proprits du graphique: Gnral

647
648
650 651 652 652 653 653

50 Histogramme
50.1 Nouveau graphique 50.2 Histogramme: Menu Objet 50.3 Gnral 50.4 Proprits du graphique: Dimensions 50.5 Proprits du graphique: Limites dimensionnelles 50.6 Proprits du graphique: Expressions 50.7 Proprits du graphique: Trier 50.8 Proprits du graphique: Style 50.9 Proprits du graphique: Prsentation (histogramme, courbe, combin, radar, graphique Mekko) 50.10 Proprits du graphique: Axes (histogramme, courbe, combin, radar, graphique Mekko) 50.11 Proprits du graphique: Couleurs 50.12 Proprits du graphique: Nombre 50.13 Police 50.14 Disposition 50.15 Barre de titre

659
659 659 662 663 668 672 683 684 687 694 697 700 701 701 701

51 Courbe
51.1 51.2 51.3 51.4 51.5 51.6 51.7 Nouveau graphique Courbe: Menu Objet Gnral Dimensions Dimension Limits Expressions Trier

703
703 704 706 706 706 706 706

10

Sommaire

51.8 Style 51.9 Proprits du graphique: Prsentation (histogramme, courbe, combin, radar, graphique Mekko) 51.10 Axes 51.11 Couleurs 51.12 Nombre 51.13 Police 51.14 Disposition 51.15 Barre de titre

707 707 710 710 710 710 710 710

52 Combin
52.1 52.2 52.3 52.4 52.5 52.6 52.7 52.8 Combin: Menu Objet Gnral Dimensions Dimension Limits Expressions Trier Style Proprits du graphique: Prsentation (histogramme, courbe, combin, radar, graphique Mekko)

713
713 716 716 716 716 716 716 717 720 720 720 720 720 720

52.9 Axes 52.10 Couleurs 52.11 Nombre 52.12 Police 52.13 Disposition 52.14 Barre de titre

53 Radar
53.1 Radar: Menu Objet 53.2 Gnral 53.3 Dimensions 53.4 Dimension Limits 53.5 Expressions 53.6 Trier 53.7 Style 53.8 Proprits du graphique: Prsentation (histogramme, courbe, combin, radar, graphique Mekko) 53.9 Axes 53.10 Couleurs 53.11 Nombre 53.12 Police 53.13 Disposition 53.14 Barre de titre

721
721 724 724 724 724 724 724 725 728 728 728 728 728 728

54 Nuage de points
54.1 54.2 54.3 54.4 54.5 54.6 54.7 54.8 54.9 Nuage de points: Menu Objet Gnral Dimensions Dimension Limits Proprits du graphique: Expressions (nuage de points) Trier Style Proprits du graphique: Prsentation (nuage de points, bulles) Proprits du graphique: Axes (nuage de points, bulles)

729
729 732 732 732 732 733 733 733 738

11

Sommaire

54.10 54.11 54.12 54.13 54.14

Couleurs Nombre Police Disposition Barre de titre

740 740 740 740 740

55 Bulles
55.1 Bulles: Menu Objet 55.2 Dimensions 55.3 Dimension Limits 55.4 Expressions 55.5 Trier 55.6 Style 55.7 Proprits du graphique: Prsentation (nuage de points, bulles) 55.8 Axes 55.9 Couleurs 55.10 Nombre 55.11 Police 55.12 Disposition 55.13 Barre de titre

741
741 744 744 744 744 744 744 748 748 748 749 749 749

56 Secteurs
56.1 Secteurs: Menu Objet 56.2 Dimensions 56.3 Dimension Limits 56.4 Expressions 56.5 Trier 56.6 Style 56.7 Proprits du graphique: Prsentation (secteurs) 56.8 Couleurs 56.9 Nombre 56.10 Police 56.11 Disposition 56.12 Barre de titre

751
751 753 754 754 754 754 754 755 756 756 756 756

57 Entonnoir
57.1 Entonnoir: Menu Objet 57.2 Gnral 57.3 Dimensions 57.4 Dimension Limits 57.5 Expressions 57.6 Trier 57.7 Style 57.8 Proprits du graphique: Prsentation (Entonnoir) 57.9 Couleurs 57.10 Nombre 57.11 Police 57.12 Disposition 57.13 Barre de titre

757
757 760 760 760 760 760 760 761 762 762 762 762 763

58 Blocs
58.1 Blocs: Menu Objet

765
765

12

Sommaire

58.2 Gnral 58.3 Dimensions 58.4 Dimension Limits 58.5 Expressions 58.6 Style 58.7 Proprits du graphique: Prsentation (blocs) 58.8 Couleurs 58.9 Nombre 58.10 Police 58.11 Disposition 58.12 Barre de titre

767 768 768 768 768 768 770 770 770 770 770

59 Jauge
59.1 59.2 59.3 59.4 59.5 Jauge: Menu Objet Gnral Dimensions Expressions Trier

773
773 775 776 776 776 776 776 779 779 780 780 780 780

59.6 Style 59.7 Proprits du graphique: Prsentation (jauge) 59.8 Actions 59.9 Couleurs 59.10 Nombre 59.11 Police 59.12 Disposition 59.13 Barre de titre

60 Graphique Mekko
60.1 Graphique Mekko: Menu Objet 60.2 Gnral 60.3 Dimensions 60.4 Dimension Limits 60.5 Expressions 60.6 Trier 60.7 Style 60.8 Proprits du graphique: Prsentation (histogramme, courbe, combin, radar, graphique Mekko) 60.9 Axes 60.10 Couleurs 60.11 Nombre 60.12 Police 60.13 Disposition 60.14 Barre de titre

781
781 783 783 784 784 784 784 784 787 787 787 787 788 788

61 Tableau crois dynamique


61.1 61.2 61.3 61.4 61.5 61.6 61.7 Utiliser le tableau crois dynamique Tableau crois dynamique: Menu Objet Gnral Dimensions Expressions Trier Proprits du graphique: Prsentation (tableau crois dynamique)

789
789 792 795 796 796 796 796

13

Sommaire

61.8 Proprits du graphique: Indicateurs visuels 61.9 Proprits du graphique: Style 61.10 Nombre 61.11 Police 61.12 Disposition 61.13 Barre de titre

798 799 800 800 800 800

62 Tableau simple
62.1 Utiliser le tableau simple 62.2 Tableau simple: Menu Objet 62.3 Gnral 62.4 Dimensions 62.5 Dimension Limits 62.6 Expressions 62.7 Proprits du graphique: Trier (Tableau simple) 62.8 Proprits du graphique: Prsentation (tableau simple) 62.9 Proprits du graphique: Indicateurs visuels 62.10 Proprits du graphique: Style 62.11 62.12 62.13 62.14 63.1 63.2 63.3 63.4 Nombre Police Disposition Barre de titre Menu Fichier Menu dition Menu Paramtres Assistant Colormix

801
801 802 805 805 805 805 806 807 810 811 812 812 812 812

63 Bote de dialogue diter l'expression

813
816 817 817 817

64 Assistant Bote moustaches


64.1 Assistant Bote moustaches : dfinition des donnes 64.2 Prsentation de l'assistant Bote moustaches

821
821 822

65 Assistant Graphique instantan


65.1 Lancement de l'Assistant Graphique instantan

823
823

66 Assistant de cration de graphique temporel


66.1 Lancement de l'Assistant Graphique temporel

833
833

67 Assistant Graphique de statistiques


67.1 67.2 67.3 67.4 68.1 68.2 68.3 68.4 68.5 68.6 Lancement de l'Assistant Graphique de statistiques Test Khi2 Test T pour chantillons apparis Test t pour chantillons indpendants tats alternatifs et expressions de graphique Expansion textuelle avec des variables Oprateurs Fonctions de la catgorie Agrgation du graphique Fonctions synthtiques de dimension Autres fonctions

841
841 841 842 844

68 Expressions de graphique

847
848 849 849 852 888 888

69 Exemples
69.1 Exemples de qualificateurs agrgatifs 69.2 Exemples d'tats alternatifs dans les expressions de graphique

919
919 920

14

Sommaire

70.1 Exemples de fonctions de la catgorie Rang du graphique 71.1 Exemples de fonctions de la catgorie Inter-enregistrements du graphique

923 927

72 Agrgations imbriques et autres considrations 73 Formules calcules


73.1 Saisir une formule calcule 73.2 Messages d'erreur 73.3 Formule calcule

933 939
939 939 939

74 Groupes de champs
74.1 Groupes hirarchiques 74.2 Groupes non hirarchiques (cycliques)

941
941 942

75 Messages d'erreur personnaliss

943

Partie 7 Formats des nombres


76 Types de donnes dans QlikView
76.1 Reprsentation des donnes dans QlikView 76.2 Interprtation des nombres 76.3 Dates et heures

945
946
946 946 949

77 Formats d'interprtation et fonctions de mise en forme


77.1 77.2 77.3 77.4 Nombres Dates Heures Date et heure

953
953 953 954 954

Partie 8 Macros et automatisation


78 Utiliser l'automatisation et les macros avec QlikView
78.1 L'interface d'automatisation de QlikView 78.2 Comment l'automatisation et les macros peuvent contrler QlikView

957
958
958 958

79 Interprteur de macros interne


79.1 79.2 79.3 79.4 Appeler des macros Fonctions de bibliothque spciales pour JScript diter le module Dbogueur

961
961 962 963 966

80 Prendre le contrle d'un document QlikView


80.1 Accder aux documents QlikView partir d'un autre programme 80.2 Accder des documents QV partir de l'interprteur de macros interne

969
969 969

81 Appels de fonctions VBScript partir du script


81.1 Transfert de paramtres

971
972

82 Utilisation de macros de documents QV sur le serveur QV


82.1 82.2 82.3 82.4 82.5 Macros sur le serveur QlikView Limites de la fonctionnalit des macros Limites du dclenchement de macros Fonctions VBScript Exportation ct serveur

973
973 973 973 974 974

Partie 9 Annexe
A Limitations et conditions requises
A.1 Limitations de la quantit de donnes charger A.2 Configuration systme requise A.3 Bibliothques de liens dynamiques (DLL) ncessaires

975
976
976 976 978

15

Sommaire

B Raccourcis clavier
B.1 Raccourcis du menu Fichier B.2 Raccourcis du menu dition B.3 Raccourcis du menu Affichage B.4 Raccourcis du menu Slections B.5 Raccourcis du menu Paramtres B.6 Raccourcis du menu Favoris B.7 Raccourcis du menu Outils B.8 Raccourcis du menu Objet (Liste de slection, Zone Statistiques et Liste multiple) B.9 Raccourcis clavier du script B.10 Raccourcis des touches F

979
979 980 980 980 981 981 981 981 981 982

C Optimisation des performances de l'application


C.1 C.2 C.3 C.4 C.5 C.6 C.7 C.8 C.9 D.1 D.2 D.3 D.4 D.5 D.6 E.1 E.2 E.3 E.4 Introduction Count (Distinct 'Nomdechamp') If ( Condition(Text),....) Sum ( If (Condition, 'Nomdechamp')) If ( Condition, Sum('Nomdechamp')..) If ( Condition1, Sum('Nomdechamp'), If (Condition2, Sum('Nomdechamp').. Trier du texte Lgendes et objets texte dynamiques Dclencheurs de macros ( en cas de modification ) Installation Documents QlikView Scripts et chargement de donnes Logique QlikView Disposition Partager des documents QlikView avec d'autres personnes Scurit et intgrit des donnes Le droit de modifier des donnes Le droit d'afficher des donnes Intgrit des donnes

983
983 983 984 984 985 985 986 986 986

D Foire Aux Questions

987
987 987 988 989 991 991

E Problmes de protection des donnes

993
993 993 993 993

F Backus-Naur Form Glossaire Index

995 997 1011

16

Partie 1 Introduction

Partie 1 Introduction

17

18

1 Avant de commencer
Bienvenue sur QlikView, la solution d'accs aux donnes qui facilite l'analyse et l'exploitation d'informations provenant de diffrentes sources de donnes. QlikView facilite la comprhension des images et le reprage des connexions, mme dans des ensembles de donnes volumineux et complexes. Les informations que vous intgrez partir de diffrentes sources sont ensuite rapidement disponibles sur le rseau. Les informations pertinentes parviennent au destinataire souhait. La technologie associative permet la cration d'une interface unique pour la prsentation et l'analyse interactives de tous types d'informations. QlikView gre les informations de manire conviviale et similaire au fonctionnement du cerveau humain. Il cre progressivement des connexions entre les informations traites. Ce n'est pas la base de donnes, mais bien vous qui posez une question. Cliquez simplement sur l'lment sur lequel vous souhaitez obtenir des informations. Les systmes de recherche d'informations conventionnels impliquent une approche du haut vers le bas, alors que QlikView vous dirige directement vers les donnes indpendamment de leur emplacement dans la structure de donnes. Dans les systmes conventionnels, la rcupration des donnes est souvent une tche difficile ncessitant des connaissances sur la structure des bases de donnes et la syntaxe du langage de requte. L'utilisateur est bien souvent limit par des routines de recherche prdfinies. QlikView rvolutionne le processus de recherche en permettant de choisir librement des donnes d'un simple clic parmi celles affiches l'cran. QlikView possde de nombreux domaines d'application. Vous tes cependant le seul dcider de la manire dont s'excute le programme. QlikView vous donne un aperu cohrent et unifi des donnes prsentes dans les diffrentes bases de donnes (que ce soit les vtres ou celles de quelqu'un d'autre), quelles soient centrales ou locales. Vous pouvez utiliser QlikView avec pratiquement toutes les bases de donnes. QlikView vous permet de :
l l l l l l l l l

crer une interface utilisateur final souple destine un entrept de donnes faire des instantans des relations entre les donnes faire des prsentations bases sur vos donnes crer des tableaux et des graphiques dynamiques raliser des analyses statistiques associer vos donnes des descriptions et des lments multimdia dvelopper vos propres systmes experts crer de nouveaux tableaux en regroupant des informations provenant de plusieurs sources crer votre propre systme de veille stratgique.

Certaines applications de QlikView regroupent les domaines suivants : la finance, les ressources humaines, l'analyse de march, la satisfaction client, la gestion de projet, le contrle de la production, les inventaires et achats de produits. Vous pouvez mlanger les applications pour obtenir des vues d'ensemble encore plus compltes.

1.1 Conventions
Avant de commencer utiliser QlikView, il est important de comprendre les termes et les conventions de notation utiliss dans la documentation. On expliquera dans cette section certains de ces termes.

Conventions gnrales
l

Le mot choisir concerne l'excution d'une commande de menu dans la barre d'outils ou dans une bote de dialogue.

19

Le mot slectionner signifie mettre un objet en surbrillance dans une liste ou sur une feuille pour que l'action suivante porte dessus. On l'utilise aussi pour la mise en surbrillance de valeurs de champs, c'est--dire les slections logiques dans les donnes. Les listes numrotes (par exemple 1, 2, 3...) servent dcrire des procdures comprenant deux tapes ou plus qui se suivent dans un ordre donn. Les listes puces, telles que celle-ci, fournissent des informations sans indiquer d'ordre suivre.

Conventions relatives la souris


l l

l l

Les descriptions du Manuel supposent que le bouton gauche est configur comme le bouton principal et le bouton droit comme le bouton secondaire (configuration par dfaut dans Windows). Pointer sur... signifie dplacer la souris, et donc le curseur, jusqu' ce que le bout du pointeur se trouve sur l'objet voulu. Cliquer sur... signifie pointer sur l'objet voulu, puis appuyer sur le bouton et le relcher immdiatement sans bouger la souris. Double-cliquer sur... signifie appuyer rapidement deux fois sur le bouton de la souris. Faire un clic droit signifie cliquer avec le bouton droit de la souris.

Conventions relatives au clavier


l l l

Les noms des touches sont donns en petites majuscules, par exemple Appuyez sur ENTRE. Dans QlikView, les touches Retour et Entre ont le mme effet. Le symbole + utilis entre deux noms de touches indique que l'on doit appuyer sur les deux touches en mme temps. Par exemple, ctrl+s signifie que l'on doit appuyer sur la touche ctrl tout en appuyant sur s. La virgule , utilise entre deux noms de touches indique que l'on doit appuyer sur les deux touches successivement.

1.2 Services techniques QlikTech


Contactez-nous si vous avez besoin d'aide ou d'une formation supplmentaire ou de renseignements propos du dveloppement de l'application. Pour plus d'informations sur nos services techniques, rendez-vous sur notre page d'accueil l'adresse : http://www.qlikview.com

Sige de QlikTech International


QlikTech International Tlphone : +1 (888)-828-9768 150 N. Radnor Chester Road Fax : 610-975-5987 Suite E220 Radnor, PA 19087 USA Pour connatre l'emplacement de nos autres bureaux, consultez notre site (voir plus haut).

20

2 Nouveauts de QlikView 11
L'quipe de dveloppement QlikView a une nouvelle fois pris en compte les ides et les suggestions des utilisateurs, des clients et des partenaires. Suite notre dveloppement et vos commentaires, nous pouvons dsormais prsenter QlikView 11 avec plusieurs nouvelles fonctions et amliorations. Nous pensons que tout le monde y trouvera son compte. La plupart des nouvelles fonctions sont prsentes plus en dtail ci-dessous.

2.1 Caractristiques gnrales


Amlioration du chargement des hirarchies
Le chargement des hirarchies a t repens. Le prfixe hirarchique s'excute deux fois plus vite que dans QlikView 10. Les autres modifications incluent une meilleure volutivit avec des hirarchies extrmement complexes. La syntaxe du chargement des hirarchies n'a pas t modifie.

Menu droulant des onglets du script de chargement


Un menu droulant de slection des onglets de script a t ajout la barre d'outils de l'diteur de script. Il offre aux utilisateurs une alternative au clic sur les onglets du script de chargement pour parcourir ces derniers. Pour plus d'informations, voir Bote de dialogue diter le script (page 185).

lot OEM
QlikView propose un nouveau mcanisme permettant d'empcher les documents QlikView baliss au moyen d'un ID d'application d'tre excuts sur un autre serveur QlikView sans ID correspondant. L'utilisation de cette fonction est rserve aux partenaires OEM uniquement.

Notation BNF des info-bulles du script de chargement


L'diteur de script QlikView affiche dsormais la notation (syntaxe) BNF dans les info-bulles.

Extensions de documents
Les extensions de documents sont des objets d'extension dpourvus d'interface utilisateur. Elles peuvent tre utilises pour personnaliser les pages AJAX gnres ou comme sources de donnes des fins d'intgration. Bien que cette fonction tait prvue dans cette version, elle n'est disponible que dans un build spar (20747).

Aide contextuelle de l'diteur de script


L'aide contextuelle ne fonctionnait pas dans QlikView 10. Ce problme a t rgl dans QlikView 11. Toutefois, le texte d'aide n'a pour l'instant pas t compltement mis jour pour QlikView 11.

tats alternatifs
QlikView permet aux utilisateurs de dtacher des graphiques du modle de donnes sous-jacent. Lorsqu'un graphique est dtach, l'objet ne rpond plus aux slections de l'utilisateur. Si ce dernier rattache l'objet, celui-ci est instantanment mis jour pour reflter l'tat actuel des slections. Les tats alternatifs s'apparentent ce comportement. Le dveloppeur QlikView peut crer plusieurs tats au sein d'un document QlikView pour les appliquer des objets prcis contenus dans le document. L'utilisateur final a la possibilit de crer des copies de ces objets (objets serveur) afin de les dfinir dans des tats diffrents. Les tats

21

alternatifs ne sont pas accessibles dans le script de chargement (load). Ils font partie des fonctions de l'interface utilisateur.
La diffrence la plus significative entre le dtachement et les tats alternatifs est le fait que TOUS les objets dfinis dans un tat donn rpondent aux slections de l'utilisateur effectues dans l'tat en question. Les objets dfinis dans un tat donn ne sont pas affects par les slections que l'utilisateur effectue dans d'autres tats. Voir aussi: tats alternatifs (page 129)

Collaboration de sessions
QlikView 11 inclut une autre nouvelle fonction de collaboration, savoir la collaboration de sessions. Cette fonction permet aux utilisateurs de la version serveur de QlikView de partager leur session QlikView avec d'autres personnes, situes aussi bien l'intrieur qu' l'extrieur de l'entreprise. Grce cette fonction, les utilisateurs ont la possibilit d'explorer et d'laborer de nouvelles analyses au sein d'un environnement collaboratif. La collaboration de session est uniquement disponible dans le cadre d'une connexion un serveur QlikView et au moyen d'un client AJAX. Le plug-in client QlikView ne prend pas en charge cette fonction.

Remarques et commentaires
QlikView 11 inclut une autre nouvelle fonction de collaboration, savoir les notes et commentaires. Cette fonction permet aux utilisateurs de crer et de partager des remarques sur les objets QlikView. Les remarques sont partages avec d'autres utilisateurs de QlikView qui peuvent y rpondre en laissant leurs propres commentaires. Les utilisateurs peuvent enregistrer un instantan (favori) des donnes avec chaque note ou commentaire.

Limites dimensionnelles
QlikView est en mesure de prsenter les valeurs Autres et Total sous diffrents types de graphiques. QlikView permet galement aux utilisateurs de configurer des graphiques devant afficher les valeurs X suprieures et infrieures dans diffrentes versions. Dans les versions antrieures, ces manipulations taient gres par le moteur de gnration de graphiques. partir de QlikView11, ces fonctionnalits ont t dplaces vers le moteur de calcul. Autrement dit, les utilisateurs seront en mesure de dfinir ces options pour tous les types de graphiques l'exception des jauges et des tableaux croiss dynamiques. La bote de dialogue des proprits du graphique comporte un nouvel onglet intitul Limites dimensionnelles qui permet aux utilisateurs de configurer ces options.

Activation conditionnelle des expressions et des dimensions


Il est dsormais possible d'activer et de dsactiver les dimensions et les expressions de faon conditionnelle. Les onglets Dimensions et Expressions des botes de dialogue des proprits comportent de nouveaux champs d'expression et cases cocher qui permettent d'utiliser cette fonction.

Intgration du contrle de la source


QlikView 11 peut s'intgrer des systmes de contrle de la source. Cette fonction est disponible lors de l'utilisation d'un bureau QlikView. Le menu Fichier comprend une nouvelle option permettant aux dveloppeurs de QlikView de connecter un document QlikView un systme de contrle de la source. Cette fonction est compatible avec les fichiers de projet XML produits par le bureau QlikView et offre une intgration de base aux systmes tiers de contrle de la source. Pour que cette fonction soit oprationnelle, l'interface de programmation MSSCCI doit tre implmente sur le systme de contrle de la source. L'intgration de la fonction de contrle de la source de QlikView11 est compatible avec Microsoft Team Foundation Server.

22

Chargement des mappages


Vous pouvez dsormais directement charger des mappages partir d'un fichier QVD. Il est inutile d'annuler l'optimisation du chargement QVD lorsque vous chargez un mappage. Cette fonction est disponible depuis QlikView 10, mais elle n'tait pas documente.

Objet conteneur
L'objet conteneur dispose d'une nouvelle faon d'afficher les objets, savoir le mode grille. Ce mode permet aux utilisateurs de visualiser et de manipuler plusieurs objets la fois dans un objet conteneur.

Actions
QlikView 11 contient six nouvelles actions:
l l l l l l

Effacer le champ Dfinir le nom de l'tat Copier le contenu de l'tat Permuter le contenu de l'tat Recharger Mise jour dynamique

Pour plus d'informations, voir Bote de dialogue Ajouter une action (page 585).

2.2 Amliorations du client AJAX


En dehors des nouvelles fonctions de disposition listes ci-dessus, plusieurs fonctions spcifiques AJAX ont t ajoutes:

Pivotement dans les tableaux croiss dynamiques


L'objectif est d'avoir une parit entre le client C et le client AJAX. Il est dsormais possible de pivoter un tableau crois dynamique dans le client AJAX. Par exemple, si un tableau crois dynamique a trois dimensions et plusieurs expressions, il est dsormais possible d'organiser les colonnes dans n'importe quel ordre.

Mises niveau de l'interface utilisateur


Plusieurs mises niveau mineures ont t ajoutes au client AJAX:
l l

Tri par colonne dans les listes de slection. Un nouvel onglet est disponible dans IE9, Firefox4 (et versions ultrieures) et Chrome12 (et versions ultrieures). Les barres de dfilement d'objets on t amliores.

Botes de dialogue des proprits


La prsentation et l'apparence des botes de dialogue des proprits ont t modifies dans le client AJAX. Ces changements ont t apports dans le but d'amliorer l'aspect et la convivialit des botes de dialogue. Les nouvelles botes de dialogue sont disponibles dans le client AJAX et dans WebView sur le bureau QlikView.

23

AJAX on Small Devices


AJAX on Small Devices (AJAX pour petits appareils) permet de prendre en charge l'exploration des donnes QlikView sur les petits appareils tactiles, comme les smartphones. Les applications existantes peuvent tre utilises sans tre modifies, les fonctions de QlikView tant excutes avec le dfilement et le zoom intgrs du petit appareil. Il est possible d'afficher le document QlikView dans une disposition qui redessine automatiquement l'objet pour l'adapter aux petits appareils ou dans sa disposition d'application d'origine. Pour plus d'informations, voir Bote de dialogue Ajouter une action (page 585).

2.3 Serveur QlikView


Aide de QMC
Une aide contextuelle a t ajoute la QMC.

LDAP
Le fournisseur de service d'annuaire DSP (Directory Service Provider) LDAP configurable pour la prise en charge LDAPs (LDAP via SSL) a t amlior de manire mieux prendre en charge les besoins de nos clients.

Enregistrement d'audit par document


Certaines organisations exigent qu'un enregistrement d'audit utilisateur soit gnr de faon ce que chaque requte soit consigne et pouvoir identifier qui a fait quoi a posteriori. Le serveur QlikView 10 est en mesure de le faire; toutefois, le bouton agit sur la totalit du serveur: soit tous les documents sont enregistrs, soit aucun. Dans la version11, cette fonction peut tre dfinie par document.

Activation et dsactivation du tlchargement de documents par document et par utilisateur


Dans de nombreuses situations, le responsable du systme peut vouloir empcher certaines donnes dures de sortir du serveur QlikView. Dans ce cas, le tlchargement du fichier .qvw, l'impression et l'exportation ne sont pas autorises; seule la session interactive avec le serveur QlikView est permise. Cette fonctionnalit est disponible dans la version 10, au niveau du document. Dans la version 11, ceci est dsormais galement possible au niveau de chaque utilisateur.

Activation et dsactivation de l'exportation et de l'impression par document et par utilisateur


Dans de nombreuses situations, le responsable du systme peut vouloir empcher l'exportation dans Excel et l'impression. Dans la version 11, ceci est dsormais possible au niveau de chaque document et de chaque utilisateur.

Scriptlets pour la cration de fichiers QVD


Il est dsormais possible d'ajouter la cration de fichiers QVD par le biais d'un scriptlet. Cette action est ralise sous Tches secondaires.

24

Diffusion par e-mail dans un document QVW


Il est dsormais possible de diffuser un fichier QVW aux messageries lectroniques des destinataires dfinis dans un champ du document.

Email d'alerte aux administrateurs des documents


Il est dsormais possible d'envoyer un email d'alerte aux administrateurs des documents.

Suivi des licences


L'utilisation des licences a t ajoute aux journaux QVS.

Performances de distribution et de rechargement


Les performances de rechargement et de distribution ont t amliores:
l

QlikView 11 Publisher peut dsormais ouvrir les documents source sans donnes avant d'excuter une tche de rechargement. Il est dornavant inutile de charger les donnes du document dans la mmoire et de recharger ensuite le document. Les performances de la boucle et de la rduction seront amliores dans une future version.

Interface utilisateur de la console de gestion


l l l l l

l l l

Les incohrences de l'IU ont t supprimes. L'actualisation des tableaux dans la QMC a t globalement amliore. La page tat est ouverte et mise jour plus rapidement. Il est dsormais possible de dvelopper toutes les tapes d'une chane de tches par un clic droit. Il est dsormais possible de supprimer un utilisateur de toutes les diffusions o il est explicitement cibl. Un filtre de recherche a t ajout aux documents Source et Utilisateur. Des alertes ont t ajoutes pour l'tat du service. Les types de regroupements et d'utilisateurs ont t rendus plus cohrents parmi les services.

Rduction avec champs verrouills


Dans les versions antrieures de QlikView, la rduction tait impacte par les champs verrouills (en rduisant en effet les valeurs verrouilles). Dans la version 11, la rduction ignore les champs verrouills.

Enregistrement dans le service de diffusion


Le traitement des enregistrements et des erreurs n'est pas totalement fiable et porte parfois confusion. Une seule vritable erreur peut parfois apparatre sous la forme de trois erreurs ou plus. Une tche qui s'est termine sans problme peut parfois gnrer plusieurs avertissements car le QVB n'a pas rpondu pendant quelques secondes. Ce comportement est dsormais rgl.

QMC et QMEC fusionnes en QMC


La QMC a t supprime et QEMC a t renomme QMC.

Modification du point d'accs


L'aspect et la convivialit du point d'accs ont chang, notamment avec l'ajout de nouvelles fonctionnalits de recherche.

25

Amliorations EDX
Le dmarrage d'un EDX renverra dsormais un numro de session pour permettre d'interroger l'tat de la session plutt que de la tche. Une fois la session termine, l'tat contient une liste de toutes les tches (et numros de session) ayant t dclenches, permettant le suivi continu de l'tat. Cette fonctionnalit est disponible via l'API.

Amliorations de l'quilibrage de charge


Le rapport sur la charge de la mmoire et de l'UC sur les serveurs QlikView physiques a t amlior. L'algorithme d'quilibrage de charge a galement t amlior. Il est possible de modifier la formule d'quilibrage de charge utilise, mais uniquement par le biais du fichier de configuration. Ceci est intentionnel et n'est pas affich sur l'IU car elle ne doit pas tre modifie dans une installation normale.

MSI Installation pour le serveur QlikView


La convivialit de MSI a t revue.

2.4 QlikView WorkBench


QlikView Workbench a t mis jour de manire intgrer de nouvelles fonctions:
l l

QlikView Workbench inclut dsormais un assistant permettant de crer des objets d'extension. Auparavant, Workbench ne pouvait tre utilis que dans le cadre d'un projet de site Web ASP.NET. Il est dsormais possible de se connecter un QVW via JavaScript/une balise div sans avoir besoin d'un composant dll .NET.

2.5 API
La version 11 inclut des mises jour de toutes les API, y compris COM, QlikView Management Service et JavaScript. Toutes les nouvelles API sont conues en tenant compte des nouvelles fonctionnalits et de la rtrocompatibilit. En outre, QlikView proposera une nouvelle API dorsale pour grer l'accs aux groupes du serveur QlikView et rcuprer les listes de documents.

API COM
QlikView offre de nouvelles API pour l'automatisation des tats alternatifs.

API du service de gestion QlikView


Cette version inclut les mises jour suivantes de l'API du service de gestion QlikView:
l l l l l l l l

tat du service Configuration et gestion des licences du serveur QlikView et de QlikView Publisher (pas les CAL) Paramtres du service de diffusion de QlikView Configuration de la collaboration des documents utilisateurs (pour le mode restreint) Ouverture/accs aux donnes des documents source (par exemple, les champs et favoris) Statistiques QVS Recherche et validation des utilisateurs DSC Importation de tches/communication du service de gestion de QlikView distance

API JavaScript QlikView


La documentation JavaScript de la version 11 a t mise jour.

26

3 Problmes de compatibilit avec les versions antrieures de QlikView


L'quipe de dveloppement a fait tout son possible pour faire en sorte ue la migration vers la version 11 de QlikView soit la plus lgre possible. Et nous pensons avoir atteint cet objectif (surtout depuis les versions QlikView 7.52, 8, 9 et 10). Ce document rpertorie les domaines concerns.

3.1 Compatibilit des formats de fichiers


Compatibilit des formats de fichiers dans QlikView7, 8, 9, 10 et 11
QlikView 7.52 et plus partagent le mme format de fichier que QlikView 11. Vous pouvez travailler avec les diffrentes versions sans vous soucier de cet aspect. Les nouvelles fonctions de document QlikView 11 ne sont bien entendu pas compatibles avec QlikView 7.52, 8, 9 et 10, mais sont conserves mme si le document est ouvert et modifi partir d'une version prcdente. Le fonctionnement des fichiers issus de diffrentes versions est trs similaire celui des fichiers Microsoft Office jusqu' prsent.

Compatibilit de lecture des formats de fichiers avec les versions antrieures de QlikView
QlikView 11 ouvre tous les fichiers crs dans QlikView 7.52 et les versions ultrieures. Si vous avez besoin d'ouvrir des fichiers de versions prcdentes de QlikView, vous devez utiliser QlikView 7.52. Contactez votre revendeur QlikView pour obtenir un exemplaire gratuit. L'quipe de dveloppement a toujours dploy ses efforts pour faire en sorte qu'un document de la nouvelle version ressemble le plus possible celui de l'ancienne version. Cependant, l'ajout de nouvelles fonctions peut parfois affecter l'apparence des anciens documents.

Enregistrement aux formats de fichiers prcdents depuis QlikView 11


QlikView11 ne permet pas d'enregistrer des documents dans un format antrieur la version 7.52 de QlikView.

3.2 Environnements client/serveur mixtes


QlikView 11 <-> QlikView 7/8/9/10
Le serveur QlikView 7.52 et plus fonctionne en continu avec les clients QlikView 11 de mme que le serveur QlikView 11 avec les clients QlikView 7.52 et plus. Naturellement, pour profiter des fonctionnalits spcifiques de QlikView 11, vous devez disposer du serveur et du client de cette version. QlikView 11 est incompatible avec les versions 7.51 et antrieures de QlikView.

Versions antrieures
Le serveur QlikView 11 n'est pas compatible avec les clients QlikView 6. De la mme manire, les serveurs QlikView 6 ne sont pas compatibles avec les clients QlikView 11.

27

28

4 QlikView Personal Edition


Avec QlikView Personal Edition, QlikTech propose une version gratuite de QlikView destine une utilisation personnelle. Elle est destine aux particuliers, aux tudiants et aux petites start-ups. QlikView Personal Edition correspond la version complte du bureau QlikView et utilise le mme pack d'installation. La seule diffrence rside dans le fait que QlikView Personal Edition fonctionne sans cl de licence. Si, un moment donn, votre organisation ou vous-mme dcidez d'acheter une licence complte de QlikView, cette installation de Personal Edition deviendra automatiquement une version complte du Bureau QlikView ne ncessitant aucun logiciel supplmentaire ni modification de vos documents QlikView. QlikView Personal Edition n'est pas limit en termes de dure et de fonctionnalits ; toutefois, quelques points doivent tre respects concernant la manipulation des documents QlikView. Dans QlikView Personal Edition, chaque document est sauvegard avec une cl utilisateur qui relie le fichier l'ordinateur sur lequel il est cr. Ceci signifie :
l

QlikView Personal Edition peut uniquement ouvrir des fichiers crs avec cette version particulire de QlikView. Ceci signifie qu'avec QlikView Personal Edition, vous ne pouvez pas utiliser vos documents QlikView sur d'autres ordinateurs, vous ne pouvez pas partager vos documents QlikView avec un autre utilisateur non inscrit ni ouvrir un document QlikView d'un autre utilisateur ( l'exception des documents spcialement prpars par QlikTech des fins personnelles). Nanmoins, les documents crs dans QlikView Personal Edition peuvent tre utiliss avec une copie autorise de QlikView Desktop et galement tre publis sur un serveur QlikView. Vous ne pouvez pas importer une mise en page de document entier (feuilles/objets/paramtres de scurit, etc. au format XML, sans les donnes) dans QlikView Personal Edition.

Si vous devez changer d'ordinateur, vous ne pourrez plus ouvrir vos documents prcdemment crs avec QlikView Personal Edition. Dans ce cas, vous pouvez dcider de rcuprer vos fichiers. La rcupration de fichiers signifie qu'une nouvelle cl utilisateur est gnre, attribue l'ancien document et utilise pour tous les fichiers ultrieurs, et pas uniquement pour le fichier en question. Une fois qu'un fichier a t rcupr, vous ne pouvez plus l'utiliser sur l'ordinateur sur lequel vous l'avez cr. QlikView accepte quatre modifications de cl utilisateur sur un document. Par la suite, le message d'erreur La longueur de cl maximale a t atteinte est affich et le document ne peut plus tre ouvert. La seule possibilit consiste le recrer partir de son fichier de travail. Par consquent, vous ne devriez pas rcuprer des documents QlikView que vous n'avez pas crs (documents d'un forum, d'un collgue, etc.). Agir de la sorte vous fera utiliser l'une de vos tentatives de rcupration restantes. En tant qu'utilisateur de QlikView Personal Edition, vous pouvez tout moment mettre le logiciel niveau vers une version plus rcente et continuer travailler sur vos documents. Les dernires versions peuvent tre tlcharges sur la page de tlchargement QlikView et installes sur l'ordinateur existant.

Remarque ! Si vous avez utilis toutes vos tentatives de rcupration, le tlchargement d'une nouvelle version ou de la mme version ne rinitialisera pas le compteur.
Les utilisateurs de QlikView Personal Edition ne bnficient pas de l'assistance par tlphone ou par email de QlikTech mais ils peuvent obtenir l'excellente aide de notre communaut active d'utilisateurs, QlikCommunity. L'ensemble de son contenu est accessible nos membres, mais vous devez vous inscrire pour poster des questions sur le forum, tlcharger des fichiers ou vous inscrire des formations. La section Share QlikViews de QlikCommunity comprend un nombre incalculable d'applications QlikView qui ont aid nos membres dcouvrir des utilisations nouvelles, diffrentes et mme amusantes de QlikView. Toutes ces applications ont t prpares pour pouvoir tre utilises dans QlikView Personal Edition. Le tutoriel QlikView est l'un des meilleurs moyens de dcouvrir les fonctions de QlikView ; il donne des conseils utiles comme des exemples d'expressions, des blocs de codes et des conseils de conception. Le

29

Tutoriel et les fichiers correspondants peuvent tre tlchargs sur la page de tlchargement QlikView. Ces documents sont galement adapts QlikView Personal Edition.

30

Partie 2 Installation

Partie 2 Installation

31

5 Installation de QlikView
Lors de l'acquisition de QlikView, vous recevez un courriel contenant des informations sur le contrat de licence, ainsi que le(s) numro(s) de srie et le(s) numro(s) de contrle ncessaires. Pour obtenir des informations sur les systmes d'exploitation pris en charge et la configuration systme requise, voir Annexe (page 975).

5.1 Packages d'installation de QlikView


Vous avez le choix entre plusieurs packages d'installation QlikView. Les installations de QlikView Desktop, QlikView Server, QlikView WorkBench et QlikView WebParts sont disponibles en version 32bits et 64bits. Pour en savoir plus sur QlikView Server, QlikView WorkBench et QlikView WebParts, consultez la documentation relative chacun de ces produits.

Packages d'installation de QlikView Desktop


Les packages d'installation de QlikView Desktop comprennent les composants suivants:
l l l l l l

Application QlikView Plug-in QlikView pour Internet Explorer Thmes QlikView Exemples de QlikView Fichiers d'aide disponibles dans plusieurs langues, slectionnables partir de l'interface utilisateur Manuel de rfrence de QlikView en anglais

Vous pouvez slectionner Personnalise au cours de l'installation afin de rduire le nombre de composants installs.

Packages de la documentation et du didacticiel de QlikView


Vous pouvez tlcharger et installer sparment la documentation de QlikView. Veuillez noter que la plupart des informations figurant dans le manuel de rfrence de QlikView sont disponibles dans les fichiers d'aide, lesquels sont automatiquement inclus dans l'installation standard de QlikView. Les fichiers d'aide sont disponibles dans toutes les langues que vous pouvez slectionner partir de l'interface utilisateur. Le package d'installation complet de la documentation et du didacticiel comprend les composants suivants:
l l l l

Manuel de rfrence de QlikView Server Manuel de rfrence de QlikView WorkBench Manuel de rfrence de QlikView WebParts Manuel de rfrence de QlikView, disponible dans toutes les langues que vous pouvez slectionner partir de l'interface utilisateur Didacticiel de QlikView, disponible dans toutes les langues que vous pouvez slectionner partir de l'interface utilisateur Guide API (document QlikView)

Le package d'installation complet de la documentation et du didacticiel de QlikView Desktop comprend les composants suivants:
l

Manuel de rfrence de QlikView, disponible dans toutes les langues que vous pouvez slectionner partir de l'interface utilisateur

32

Partie 2 Installation

Didacticiel de QlikView, disponible dans toutes les langues que vous pouvez slectionner partir de l'interface utilisateur Guide API (document QlikView)

Le package d'installation de la documentation et du didacticiel de QlikView Desktop dans une langue spcifique comprend les composants suivants:
l l

Manuel de rfrence de QlikView dans la langue slectionne Didacticiel de QlikView dans la langue slectionne

5.2 Tlchargement et lancement du programme d'installation de QlikView Desktop


Procdez de la faon suivante: 1. Rendez-vous sur le site Internet www.qlikview.com/download et slectionnez un package d'installation QlikView Desktop. 2. Inscrivez-vous ou connectez-vous pour lancer le tlchargement de QlikView. 3. Double-cliquez sur le fichier Setup.exe pour dmarrer l'installation. Le programme d'installation devrait alors dmarrer.

5.3 Au cours de l'excution du programme d'installation


1. Commencez par slectionner la langue d'installation souhaite dans la liste droulante, puis cliquez sur OK. 2. Patientez pendant la prparation de l'installation, en suivant les instructions affiches l'cran. 3. Lorsque la bote de dialogue Bienvenue s'ouvre, lisez les informations qu'elle contient, puis cliquez sur Suivant. 4. Le contrat de licence du logiciel s'affiche. Lisez-le, cliquez sur J'accepte le contrat de licence (le cas chant), puis sur Suivant. 5. Dans la bote de dialogue Informations client, vous pouvez indiquer qui l'installation est destine. Cliquez sur Suivant pour continuer. 6. Si vous prfrez choisir un autre dossier de destination au lieu de l'emplacement dfini par dfaut pour l'installation du programme, cliquez sur Modifier dans la bote de dialogue Dossier de destination. Cliquez ensuite sur Suivant. 7. La bote de dialogue Type d'installation s'affiche. Si vous slectionnez Complte, les fonctions suivantes seront installes dans le chemin d'accs spcifi dans la bote de dialogue prcdente: Le programme QlikView et son fichier d'aide, le plug-in de QlikView pour Internet Explorer, ainsi que des exemples de fonctions et fonctionnalits de QlikView. Si vous slectionnez Personnalise, lorsque vous cliquez sur Suivant, une bote de dialogue s'affiche dans laquelle vous pouvez indiquer les fonctions installer. Effectuez les slections voulues, puis cliquez sur Suivant. 8. L'installation est prsent prte tre lance. Cliquez sur Installer pour la lancer. 9. Dans la dernire bote de dialogue, cliquez sur Terminer pour achever le processus d'installation. Remarque: Veillez toujours saisir le numro de licence QlikView sur le compte qui a install le logiciel; sinon, il pourrait ne pas fonctionner correctement.

Journalisation de l'installation
Lors de l'excution de Setup.exe, un fichier journal est consign dans le dossier temp de l'utilisateur. Il s'intitule QlikViewx86.wil dans la version x86 et QlikViewx64.wil dans la version 64bits. Chaque fois que l'installation est excute, un nouveau fichier est gnr et crase l'ancien journal.

33

Fichier de paramtres QlikView


Depuis la version10, tous les paramtres de QlikView sont enregistrs dans un fichier au lieu d'tre consigns dans le registre. Le fichier Settings.ini se trouve dans le dossier C:\Users\username\AppData\Roaming\QlikTech\QlikView sous Windows Vista et Windows7. Sur les systmes plus anciens, il se trouve dans C:\Documents and Settings\username\Application Data\QlikTech\QlickView. Les paramtres de QlikView OCX se trouvent dans le mme fichier.

5.4 Enregistrement
Aucun enregistrement n'est ncessaire si vous avez obtenu votre licence QlikView sur un serveur QlikView ou si vous possdez l'dition personnelle QlikView. Il est cependant possible d'acqurir un numro de srie pour ce produit et de le saisir sous l'onglet Prfrences utilisateur: Licence. L'enregistrement de QlikView vous permet de travailler hors ligne sans contact avec un serveur QlikView pendant des priodes prolonges (suprieures 30 jours). Contactez votre revendeur QlikView pour plus de dtails.

Remarque: L'enregistrement ncessite un accs au rseau ou une activation par tlphone (facultative).
Une fois votre copie de QlikView installe et ventuellement enregistre, vous pouvez commencer utiliser le logiciel.

5.5 Distribution en rseau de QlikView


Ce type d'installation est utile si vous possdez plusieurs licences et souhaitez vous assurer que tous les utilisateurs possdent la mme version de QlikView. Chaque utilisateur a cependant toujours besoin d'un numro de licence distinct. Pour distribuer une installation de QlikView, vous devez disposer du fichier d'installation excutable. Les numros de srie et de contrle ne sont pas ncessaires avant le dmarrage de votre premire session QlikView sur l'ordinateur client. QlikView11 utilise la mthode Microsoft Windows Installer (cration de packages MSI). Pour en savoir plus sur les faons d'installer un package MSI, rendez-vous sur la page que Microsoft consacre Windows Installer :
l

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/msi/setup/ windows_installer_start_ page.asp

5.6 diteur de fichiers d'activation de licences


Vous pouvez galement mettre jour votre licence et examiner le fichier d'activation de licence en slectionnant Mise jour de la licence dans le menu Aide. Cette opration ne ncessite pas d'accs rseau.

34

Partie 2 Installation

diteur de fichiers d'activation de licence

Dans cette bote de dialogue, l'utilisateur peut consulter ou modifier le fichier d'activation de licence.

Cl de licence active
Il s'agit de la cl de licence active de la licence QlikView qui est normalement saisie lors de l'installation initiale du programme. Il est galement possible de la saisir ou de la modifier ultrieurement via l'onglet Prfrences utilisateur: Licence. Il est aussi possible d'excuter QlikView sans acheter de cl de licence. Dans ce cas, un bail de licence provenant d'un serveur QlikView (appel CAL, licence d'accs client) ou une dition personnelle QlikView est ncessaire.

Fichier d'activation de licence actif


Fichier texte contenant les informations pertinentes pour la licence installe. Il est requis pour activer la cl de licence.

Contacter le serveur d'activation de licences


Cliquez sur ce bouton si la zone de texte Fichier d'activation de licence actif au-dessus est vide, afin de contacter le serveur d'activation de licence.

Problmes relatifs au fichier d'activation de licences


Un ficher d'activation de licence (fichier LEF, License Enabler File) est ncessaire pour vrifier la validit d'une cl de licence QlikView. Pendant l'initialisation de la cl de licence, le serveur d'activation de licences QlikTech est contact via Internet. Si les informations fournies sont correctes, un fichier d'activation de licence est automatiquement transfr sur votre ordinateur. Normalement, cette procdure se remarque peine, car tout se passe en arrire-plan. Il arrive cependant que la procdure choue, soit parce que vous ne parvenez pas contacter le serveur d'activation de licences, soit parce qu'un pare-feu empche le transfert du fichier d'activation de licence. La bote de dialogue chec de la licence s'affiche alors pour vous informer du problme.

35

Si vous ne parvenez pas obtenir un fichier d'activation de licence valide par la procdure normale et que vous estimez y avoir droit, vous pouvez l'obtenir directement du support technique de QlikTech. Lorsque vous copiez le fichier texte directement dans l'diteur de fichiers d'activation de licences, assurez-vous qu'il ne reste pas d'espaces vides dans le texte.

5.7 Mise jour de QlikView


Le menu Aide de QlikView comprend l'option Mise jour de QlikView... Si cette option est slectionne, le site de mise jour de QlikView s'affiche sur Internet, o vous trouverez les mises jour ventuelles de votre version de QlikView. Les mises jour disponibles dpendent des informations de votre licence QlikView et de votre systme d'exploitation.

36

6 OLEDB et ODBC
6.1 OLEDB
QlikView prend en charge l'interface OLEDB qui permet la connexion des sources de donnes externes. De nombreuses bases de donnes externes sont accessibles via le fournisseur OLEDB de Microsoft pour pilotes ODBC.

6.2 Quand a-t-on besoin de l'interface ODBC ?


Pour accder une base de donnes gnrale, il est ncessaire que l'interface ODBC (Open DataBase Connectivity) soit installe. L'alternative consiste exporter les donnes de la base de donnes dans un fichier lisible par QlikView. En gnral, des pilotes ODBC sont installs avec le systme d'exploitation. Vous pouvez acheter des pilotes supplmentaires chez des revendeurs de logiciels, les trouver sur Internet ou ils peuvent tre fournis par le fabricant de SGBD. Certains pilotes sont distribus gratuitement. L'interface ODBC dcrite ici est l'interface prsente sur l'ordinateur client. Si l'utilisation d'ODBC est prvue pour accder une base de donnes relationnelle multi-utilisateur sur un serveur de rseau, un logiciel SGBD supplmentaire permettant un client d'accder la base de donnes sur le serveur peut tre ncessaire. Contactez le fournisseur de SGBD pour plus d'informations sur le logiciel requis. QlikView fonctionne avec des pilotes ODBC 32 bits et 64 bits. Cependant, il est trs important d'utiliser les versions correspondantes des pilotes ODBC et la version du programme. La version 32 bits de QlikView ne fonctionne qu'avec les pilotes ODBC 32 bits. Toutefois, la version 64 bits fonctionne avec les pilotes ODBC 32 et 64bits.

Le bon pilote ODBC est-il install ?


Sur une plateforme 64 bits, il est possible d'utiliser des applications 32 bits et 64 bits. Il est galement possible d'excuter des pilotes ODBC 32 bits et 64 bits. Lorsque vous utilisez les versions 64 bits d'ODBC et de QlikView, l'administrateur des sources de donnes ODBC se trouve dans le Panneau de configuration, Outils d'administration. Lorsque vous utilisez les versions 32 bits d'ODBC et de QlikView, vous devez dmarrer l'administrateur 32 bits via le fichier excutable odbcad32.exe, situ dans le dossier SysWOW64, en gnral l'adresse c:\windows\SysWOW64. Selon Microsoft, dans les versions 64 bits des systmes d'exploitation, le dossier system32 (en gnral situ sous c:\windows\system32) ne contient que des fichiers 64 bits. S'il existe galement une version 32 bits du fichier, il se trouve dans le dossier syswow64. Voir http://technet.microsoft.com pour plus d'informations. Dans un systme d'exploitation 32 bits, la configuration est trs facile car tous les fichiers et pilotes sont 32 bits. Un administrateur des sources de donnes ODBC devrait tre install sur le systme. (Pour ODBC 32 bits sur un systme d'exploitation 64 bits, lancez odbcad32.exe.) Activez l'onglet Pilotes ODBC pour identifier les pilotes installs.

37

Bote de dialogue Administrateur de sources de donnes ODBC, onglet Pilotes.

Si le pilote dont vous avez besoin ne se trouve pas dans l'onglet Pilotes ODBC, contactez le fournisseur de logiciel pour obtenir le bon pilote.

6.3 Crer des sources de donnes ODBC


Une source de donnes ODBC doit tre cre pour la base de donnes laquelle vous souhaitez accder. Cela peut tre fait au cours de l'installation ODBC ou ultrieurement. Avant de commencer crer des sources de donnes, vous devez savoir si vous voulez qu'il s'agisse de sources de donnes utilisateur ou systme. Les sources de donnes utilisateur sont inaccessibles, moins que le bon identifiant utilisateur n'ait t utilis la connexion. Pour partager les sources de donnes avec d'autres utilisateurs, des sources de donnes systme doivent tre cres. 1. Ouvrez nouveau la bote de dialogue Administrateur de sources de donnes ODBC. 2. Cliquez sur l'onglet Sources de donnes utilisateur pour crer des sources de donnes utilisateur, ou sur l'onglet Sources de donnes systme pour crer des sources de donnes systme. 3. Cliquez sur le bouton Ajouter. La bote de dialogue Crer une nouvelle source de donnes doit s'afficher et donner une liste des pilotes ODBC installs. 4. Si le bon pilote ODBC figure dans la liste, slectionnez-le et cliquez sur le bouton OK. Une bote de dialogue spcifique au pilote de base de donnes slectionn apparat. Nommez la source de donnes et dfinissez les paramtres ncessaires. Cliquez sur le bouton OK lorsque vous avez fini.

38

Partie 3 Navigation et bases

Partie 3 Navigation et bases

39

7 Lancement de QlikView
Lancement de QlikView Lancez QlikView partir du menu Dmarrer, Programmes ou par un double-clic sur un document QlikView. Pour lancer QlikView partir de la ligne de commande, utilisez les paramtres dcrits la section suivante.

7.1 Syntaxe de ligne de commande


Le dclenchement de la ligne de commande QlikView peut tre dcrit par la syntaxe suivante (pour une description de la notation de la syntaxe, voir Backus-Naur Form (page 995)):

[ chemin ]Qv.exe[ { commutateur } fichierdudocument ] Le chemin est soit le chemin absolu, soit le chemin relatif par rapport au rpertoire ouvert.
fichierdudocument::= [ chemin ] nomdefichierdudocument

nomdefichierdudocument est le nom de fichier de votre document. commutateur sert indiquer diffrentes options :
/r Commutateur de rechargement. Le document sera ouvert et le script recharg. Il sera ensuite enregistr et QlikView se fermera. /rp Comme ci-dessus, mais avec un rechargement partiel. /l Chargement de nouvelles donnes. Le document sera ouvert et le script recharg. Il ne sera pas enregistr et QlikView restera ouvert. /lp Comme ci-dessus, mais avec un rechargement partiel. /v Si ce commutateur est immdiatement suivi d'une variable et d'une affectation, la variable recevra la valeur affecte avant que l'excution du script ne dmarre. /nodata Ouvre le document sans les variables ni les donnes de la table et des champs. Cette fonction est galement disponible pour les documents ouverts prcdemment la Page de dmarrage (page 41). /NoSecurity Outrepasse les mesures de scurit de QlikView contre les macros hostiles et les scripts incorpors aux documents QlikView. Aucun avertissement invitant l'utilisateur accepter ou non un code potentiellement dangereux ne s'affichera. Utilisez ce commutateur avec prcaution et uniquement avec des documents connus. Exemple:

qv.exe /r/vMyvar=123 abc.qvw Remarque: Afin d'viter que des messages d'erreur n'apparaissent l'excution de scripts en mode de traitement par lots, fixez toujours le mode d'erreur de la variable de script 0 dans le script (voir Variables d'erreur (page 301)).

40

Partie 3 Navigation et bases

7.2 Page de dmarrage

Onglet Mise en route de la page de dmarrage de QlikView

La page de dmarrage contient plusieurs onglets. Le nombre d'onglets et le contenu de certains d'entre eux peuvent varier, car ils incluent du contenu web. Les onglets suivants seront toujours prsents au dmarrage de QlikView. Mise en route Contient les informations et les liens utiles qui permettront d'explorer les possibilits de QlikView. Contient des liens directs pour tlcharger ce tutoriel, ouvrir l'Assistant Mise en route et accder aux ressources slectionnes sur www.qliktech.com.

41

Derniers documents ouverts

Contient la liste des derniers documents et dernires pages Web ouverts. Vous avez seulement besoin de cliquer sur le lien correspondant pour le r-ouvrir. Effectuez un clic droit sur le document pour accder un menu contextuel contenant les commandes suivantes: Ouvrir "nom du document" sans donnes Ouvre le document mais ignore la table et les donnes des champs. Une disposition comprenant toutes les feuilles et tous les objets de feuille en place mais vide s'ouvre. Cette fonction peut s'avrer utile pour, par exemple, ouvrir des documents endommags ou pour viter d'attendre trop longtemps lorsque le document est volumineux alors que vous souhaitez lui apporter une modification mineure. (Il faudra bien sr rexcuter le script afin de rimporter les donnes dans le document aprs modification.) Pour ce faire, vous pouvez galement utiliser le commutateur de ligne de commande nodata( Syntaxe de ligne de commande (page 40)). Ouvrir "nom du document" et recharger les donnes Ouvre le document et procde un rechargement immdiat des donnes. Rechercher des documents dans le dossier Ouvre le dossier dans lequel est stock le document. Ajouter "nom du document" aux Favoris Ajoute le document ou la page Web la liste de favoris. Retirer "nom du document" de cette liste Supprime le document de la liste des derniers documents ouverts. Ceci n'affecte pas le fichier du document. Contient une liste de documents et de pages Web dj ajouts la liste des favoris. Contrairement la liste des derniers documents utiliss, la liste des favoris reste inchange tant que vous n'ajoutez pas ou ne supprimez pas explicitement d'entres dans cette liste. Cliquez simplement sur une page ou un document favori pour le rouvrir. Effectuez un clic droit sur le document pour accder un menu contextuel contenant les commandes suivantes: Ouvrir "nom du document" sans donnes Ouvre le document mais ignore les variables, la table et les donnes des champs. Une disposition comprenant toutes les feuilles et tous les objets de feuille en place mais vide s'ouvre. Cette fonction peut s'avrer utile pour, par exemple, ouvrir des documents endommags ou pour viter d'attendre trop longtemps lorsque le document est volumineux alors que vous souhaitez lui apporter une modification mineure. (Il faudra bien sr rexcuter le script afin de rimporter les donnes dans le document aprs modification.) Il est galement possible de l'excuter l'aide du commutateur de ligne de commande nodata. Ouvrir "nom du document" et recharger les donnes Ouvre le document et procde un rechargement immdiat des donnes. Rechercher des documents dans le dossier Ouvre le dossier dans lequel est stock le document. Retirer "nom du document" des Favoris Supprime le document de la liste des favoris. Ceci n'affecte pas le fichier du document.

Raccourcis

42

Partie 3 Navigation et bases

Ouvrir sur un serveur

Contient la liste de serveurs QlikView rcemment ouverts ainsi qu'une interface conviviale permettant de se connecter tout autre serveur QlikView. Ds lors que vous avez slectionn un serveur QlikView, QlikView tablit la connexion et affiche la liste des documents disponibles, qui s'ouvrent par un simple clic. Cliquez sur >> Afficher les options pour afficher les options d'authentification avances. Pour plus d'informations sur ces commandes, voir Connexion au serveur (page 43). Serveurs rcemment utiliss affiche la liste des serveurs auxquels vous vous tes connect rcemment. Serveurs proximit affiche la liste de tous les serveurs connects au rseau.

QlikView mmorisera l'onglet utilis en dernier lieu et l'ouvrira lors du prochain lancement de QlikView. Dsactivez la case cocher Afficher la page de dmarrage au lancement de QlikView si vous prfrez que la page de dmarrage ne s'affiche plus au lancement de l'application. La page de dmarrage peut rester ouverte et est accessible via l'option Page de dmarrage du menu Fentre. Si vous fermez la page de dmarrage, vous pourrez la rouvrir tout moment en cliquant sur Afficher la page de dmarrage dans le menu Aide.

7.3 Connexion au serveur

Bote de dialogue Connexion au serveur

On utilise cette bote de dialogue pour ouvrir des documents QlikView distance sur un serveur QlikView. N'oubliez pas que lorsque vous ouvrez des documents en tant que client d'un serveur QlikView, les possibilits sont limites par rapport celles offertes par les documents locaux. En tant que client, vous ne pourrez sans doute pas ajouter ou supprimer d'objets de feuille, selon la prise en charge ou non de la collaboration par le document. Vous ne pouvez pas ajouter ou supprimer de feuilles. En outre, la plupart des botes de dialogue de proprits et le script ne sont pas accessibles, les macros ne peuvent pas tre modifies et le document ne peut pas tre enregistr.

43

Sous Serveur, saisissez le nom ou l'URL d'un ordinateur sur lequel le serveur QlikView est en cours d'utilisation. Cliquez ensuite sur Connexion. On peut rcuprer les serveurs visits rcemment dans la liste droulante. Une URL peut contenir des donnes de connexion supplmentaires selon les Connexion pseudoURL: (page 44) dcrites au bas de cette page d'aide. Une fois que vous tes connect, le volet central de la bote de dialogue affiche les dossiers de documents disponibles sur le serveur QlikView. Cliquez sur un dossier et les documents disponibles s'afficheront sous Nom au bas de la bote de dialogue. Double-cliquez sur un document ou slectionnez-le puis cliquez sur Ouvrir pour ouvrir le document. Effacer la liste Ce bouton efface la liste des serveurs utiliss rcemment sur la page de dmarrage. Slectionnez votre mthode d'identification au serveur QlikView. Les trois mthodes d'authentification suivantes sont disponibles: Utiliser l'identit NT Utilise l'identit NT authentifie. Cela ne fonctionne que si l'ordinateur est connect au mme domaine Windows NT que le serveur QlikView. Anonyme Utilise un identifiant anonyme. Vous ne pouvez vous connecter que si le serveur QlikView autorise les utilisateurs anonymes et vous n'avez accs qu'aux documents dont l'accs est autoris pour le compte anonyme du serveur QlikView. La connexion pseudo-URL sous Serveur sera complte par une @ avant le nom du serveur. Identit alternative Utilise un nom d'utilisateur NT spcifique connu sur le domaine du serveur QlikView. On saisit le nom d'utilisateur dans la zone d'dition ID utilisateur. Vous serez invit saisir le mot de passe correspondant lorsque vous cliquerez sur le bouton Connexion. La connexion pseudo-URL sous Serveur sera complte par nomutilisateur@ avant le nom du serveur. Si ce paramtre est activ, le volet au bas de la bote de dialogue affiche le contenu de tous les sous-dossiers simultanment plutt que sous forme d'arbre.

Authentification

Lister par ordre alphabtique

Connexion pseudo-URL:
Lorsqu'on se connecte un serveur QlikView partir de clients Windows, soit par une bote de dialogue Ouvrir sur un serveur, soit par des fichiers de connexion, une pseudo-URL est utilise comme adresse du document. La syntaxe est la suivante:

qvp://[[nomutilisateur][@]]nomhte[:port|;protocole]/nomdocument o: nomutilisateur est un ID utilisateur Windows. Ce paramtre est facultatif. nomhte est le nom de l'hte. Ce paramtre est obligatoire. nomdocument est le nom du document QlikView (sans l'extension qvw). Ce paramtre est facultatif. port (par exemple 4749) peut tre utilis pour indiquer au serveur un port spcifique protocole (par exemple http) peut tre utilis pour prciser un protocole de tunnel. Ce paramtre est facultatif.
@ sansnomutilisateur correspond une identit anonyme. Si l'identit d'utilisateur est omise, le serveur utilise l'identit d'ouverture de session Windows.

44

Partie 3 Navigation et bases

7.4 Traitement par lots


Si vous devez mettre jour rgulirement le document QlikView, par exemple tous les soirs, le mieux est d'utiliser le serveur QlikView ou QlikView Publisher.

Serveur QlikView
Le serveur QlikView offre une plate-forme qui permet d'hberger et de partager les informations QlikView sur Internet/l'intranet. Il est troitement intgr QlikView pour proposer une suite intgre de technologies d'analyse des donnes aux utilisateurs finaux. Le composant serveur du serveur QlikView est la pice centrale de cette technologie ; il offre une solide communaut documentaire QlikView, gre de faon centralise, reliant plusieurs utilisateurs, types de clients, documents et objets dans un environnement sr et scuris.

QlikView Publisher
QlikView Publisher est un produit de la gamme QlikView qui gre le contenu et les accs. En offrant aux utilisateurs finaux des informations mises jour et en vous permettant de grer les documents QlikView de faon efficace, QlikView Publisher est un ajout prcieux la suite QlikView. QlikView Publisher diffuse les donnes enregistres dans les documents QlikView aux utilisateurs de l'organisation et aux utilisateurs extrieurs. En rduisant les donnes, chaque utilisateur peut recevoir les informations le concernant. Le service et l'interface utilisateur de QlikView Publisher sont dsormais totalement intgrs au serveur QlikView et la console de gestion QlikView (QMC). En l'absence d'accs au serveur QlikView ou QlikView Publisher, les documents QlikView peuvent tre rechargs sur l'application autonome. Utilisez ensuite les boutons des lignes de commande dcrits dans Syntaxe de ligne de commande (page 40).

Programmes de planification
Windows possde un service de planification des tches. Les services sont contrls depuis l'applet de gestion de l'ordinateur du panneau de configuration (Windows Vista), ou directement depuis le panneau de configuration (Windows XP). Assurez-vous que l'tat du service pertinent est Dmarr (et que le paramtre Dmarrage est dfini sur Automatique si le service doit dmarrer automatiquement aprs un redmarrage). Le plus facile pour soumettre un traitement par lots est gnralement de crer un fichier de commandes contenant les commandes voulues. Le fichier, appel par exemple MyBatch.cmd, pourrait contenir les commandes suivantes :

C:\qlikview\qv.exe /r C:\qlikview\exemple\fichier.qvw

Le service Planification
Le service de planification s'excute normalement sur le compte systme et comprend donc certaines restrictions. Si vous devez accder des ressources en rseau, reconfigurez le service pour qu'il s'excute sur un compte diffrent. Comme la licence QlikView est stocke dans un dossier propre au compte, assurez-vous qu'elle est correctement enregistre pour le compte utiliser. Pour ce faire, soumettez une tche interactive :

C:\>AT 11:00 /interactive "C:\Program Files\QlikView\qv.exe"


Cela provoquera l'affichage de la bote de dialogue Enregistrement de la licence. Il est galement possible d'y enregistrer la licence pour le compte voulu. Le fichier de commandes (voir la page prcdente) peut tre soumis, par exemple de la faon suivante :

C:\>AT 11:00 /every:m,t,w,th,f,sa,su C:\MonBatch.cmd


Le fichier de commandes sera ainsi excut tous les jours 11:00.

45

Accs de section

Pour rexcuter un fichier QlikView contenant un accs la section, assurez-vous que le numro de srie de la licence qui est installe sur l'ordinateur procdant au traitement par lots est autoris excuter le script sans saisir de nom d'utilisateur ni de mot de passe. Voir l'exemple ci-dessus. Pour plus d'informations sur l'accs de section, voir Scurit (page 433).

ODBC
Si ODBC est utilis, veuillez vous assurer que la dfinition des sources de donnes est disponible pour le compte procdant la rexscution. Le plus simple pour cela est probablement de dfinir les sources de donnes comme Sources de donnes systme dans le Panneau de configuration ODBC.

46

8 Assistant Mise en route


L'Assistant Mise en route facilite la cration de documents QlikView en chargeant les donnes et en concevant un graphique selon les tapes suivantes:

tape 1 - Slectionner l'origine des donnes tape 2 - Vrifier la prsentation des donnes tape 3 - Enregistrer le fichier tape 4 - Slectionner un type de graphique tape5 - Dfinir les dimensions et les listes de slection tape 6 - Ajouter une expression

page 48 page 49 page 50 page 51 page 52 page 53

Lancement de l'Assistant Mise en route


L'Assistant Mise en route est lanc l'ouverture d'un nouveau document QlikView. Dans la premire page de l'assistant, il est possible de contrler l'affichage de l'assistant lors de la cration d'un document QlikView. Ce paramtre est galement configurable dans la bote de dialogue Prfrences utilisateur, accessible via le menu Paramtres.

47

tape 1 - Slectionner l'origine des donnes

tape1 de l'Assistant Mise en route

L'assistant permet uniquement de grer des fichiers Excel. Cliquez sur Parcourir pour accder au fichier contenant les donnes. Vous noterez que seule la premire feuille de calcul d'un fichier Excel est charge. Si les donnes sont enregistres dans un autre format de fichier qu'Excel, slectionnez-les l'aide de l'diteur de script. Cliquez sur Suivant pour continuer.

48

tape 2 - Vrifier la prsentation des donnes

tape2 de l'Assistant Mise en route

Vrifiez la prsentation des donnes et indiquez si la premire ligne de la feuille Excel doit tre utilise pour les en-ttes ou si une nouvelle ligne doit tre insre. Les en-ttes de colonne sont galement appels noms de champs. Pour utiliser des en-ttes prdfinis provenant de la source de donnes, slectionnez Utiliser les en-ttes de colonnes du fichier de donnes. Pour crer de nouveaux en-ttes de colonne, slectionnez Ajouter des enttes de colonne. Chaque colonne est dote d'un titre au format A, B, etc. Pour saisir de nouveaux en-ttes, cliquez sur un en-tte existant (par exemple, A) et tapez par-dessus le nouveau texte de l'en-tte. Cliquez sur ENTRE pour quitter l'en-tte. Cliquez sur Suivant pour continuer.

49

tape 3 - Enregistrer le fichier

Bote de dialogue Enregistrer sous de l'Assistant Mise en route

Dans la bote de dialogue Enregistrer sous, recherchez le dossier dans lequel vous souhaitez enregistrer le fichier QlikView et donnez-lui un nom. Cliquez sur Enregistrer pour fermer la bote de dialogue. Pour dfinir ou modifier le chemin d'accs au fichier, cliquez sur le bouton Enregistrer sous afin de rouvrir la bote de dialogue Enregistrer sous. Cliquez sur Suivant pour continuer et crer un graphique ou choisissez Terminer pour enregistrer le document et fermer l'assistant.

50

tape 4 - Slectionner un type de graphique

tape4 de l'Assistant Mise en route

Slectionnez le type de graphique crer en cliquant sur l'icne correspondante. Les types de graphiques possibles sont ceux qui sont les plus utiliss dans QlikView. Une fois l'assistant ferm, il est possible de revenir au graphique QlikView et d'en modifier le type via la bote de dialogue Proprits du graphique. Cliquez sur Suivant pour continuer.

Remarque: Dans cette tape, le bouton Prcdent est dsactiv.

51

tape5 - Dfinir les dimensions et les listes de slection

tape5 de l'Assistant Mise en route

Slectionnez une ou plusieurs dimensions dans le menu droulant. Les dimensions dfinissent les valeurs pour lesquelles les expressions du graphique seront calcules. Elles sont gnralement places sur la gauche dans les graphes de table et sur l'axe des x des histogrammes, par exemple. Cette tape est automatiquement ignore pour les graphiques de type Jauge, car ceux-ci ne comportent gnralement pas de dimensions. Une fois l'assistant ferm, vous pourrez ajouter des dimensions supplmentaires via la bote de dialogue Proprits du graphique. Pour afficher les valeurs des dimensions dfinies dans les listes de slection de mme que le graphique, laissez la case Afficher les listes de slection coche. Cliquez sur Suivant pour continuer.

52

tape 6 - Ajouter une expression

tape6 de l'Assistant Mise en route

Les expressions de graphique dfinissent les valeurs calcules dans le graphique. Les expressions sont gnralement situes dans la partie droite des tableaux et sur l'axe des ordonnes pour les histogrammes par exemple. Dans QlikView, les expressions peuvent tre courtes et simples ou plus complexes. Cette tape permet de choisir entre trois expressions trs courantes.

Calculer la somme de: Choisissez cette option pour afficher la somme numrique d'un champ, par exemple sum(Ventes). Choisissez alors le champ sur lequel portera la somme dans la liste droulante. Calculer la moyenne pour: Choisissez cette option pour afficher la moyenne numrique d'un champ, par exemple avg(Score). Choisissez alors le champ sur lequel portera la moyenne dans la liste droulante. Compter le nombre de: Choisissez cette option pour afficher le nombre de valeurs d'un champ, par exemple count(NCommande). Choisissez ensuite le champ sur lequel portera le calcul des valeurs dans la liste droulante.

53

Une fois l'assistant ferm, vous pourrez ajouter d'autres expressions via la bote de dialogue Proprits du graphique. Pour afficher la bote de dialogue Proprits du graphique, effectuez un clic droit sur le graphique et choisissez Proprits Pour obtenir des informations sur la suite, laissez la case Lancer l'aide pour apprendre comment dvelopper votre document QlikView coche. Cliquez sur Terminer pour fermer l'assistant et afficher le graphique.

54

9 Fichier QlikView
Un document QlikView est un fichier contenant tout ce dont vous avez besoin pour analyser les donnes : l les donnes elles-mmes l le script ncessaire pour intgrer les nouvelles donnes de la source de donnes au fichier QlikView l des informations de conception, qui comprennent toutes les feuilles, listes de slection, graphiques, etc. l les alertes, favoris ou rapports de document l des informations de droits d'accs l un module de macro Il est ainsi trs facile de distribuer des informations l'aide de fichiers QlikView. L'analyse peut tre effectue indpendamment de l'emplacement des donnes d'origine ou de l'tat du rseau. Les documents QlikView constituent un moyen de partager des informations avec des utilisateurs qui n'ont pas accs la source de donnes d'origine.

9.1 Fichiers de projet QlikView


Il est possible d'enregistrer un document QlikView sur plusieurs fichiers utilisables pour la gestion des versions. Chaque fichier dfinit une proprit du document, une feuille, un objet, un script, etc. Chaque fois que le document est ouvert, les modifications apportes aux objets et aux paramtres sont enregistres sur les fichiers diffrents, ce qui en facilite le suivi. Ainsi, il est galement possible de savoir qui a effectu telle ou telle modification et dans quelle partie du document. Pour crer ces fichiers de projet, vous devez crer un dossier associ au document QlikView, avec le mme nom et le suffixe -prj. Par exemple, le dossier de projet d'un document appel Finance.qvw doit tre Financeprj.

Remarque: Aucune donne du document n'est enregistre dans les fichiers de projet.

Fichiers du dossier de projet


Le fichier QlikView.txt contient une liste de tous les objets faisant partie du document QlikView. Les feuilles et objets de la liste sont nomms d'aprs leurs ID d'objet. Les fichiers du projet sont les suivants :
l l l l l l l l

QlikView.txt - contient une liste de tous les fichiers inclus dans le projet AllProperties.xml DocProperties.xml DocInternals.xml TopLayout.xml LoadScript.txt - contient le script load du document. Module.txt - contient le code de macro du document le cas chant. Module.txt - un fichier unique est cr pour chaque feuille. En outre, les fichiers contiennent des rfrences tous les objets de feuille sur la feuille. Des fichiers spars sont galement crs pour chaque objet de feuille : l LB<id>.xml l SB<id>.xml l MB<id>.xml l TB<id>.xml l CH<id>.xml l IB<id>.xml l CS<id>.xml

55

l l l l l l l l

BU<id>.xml TX<id>.xml LA<id>.xml SL<id>.xml SO<id>.xml BM<id>.xml CT<id>.xml RP<id>.xml

Les fichiers DocProperties.xml, AllProperties.xml, DocInternals.xml et TopLayout.xml contiennent tous des paramtres de proprits pour les diffrentes parties du document. DocBinary.dat contient des donnes sensibles propres aux utilisateurs, comme les mots de passe.

9.2 Contrle de la source


Il est possible de connecter QlikView Desktop un systme de contrle de la source ; l'API Microsoft Source Control Plug-in (MSSCCI) est le fournisseur utilis pour cette fonction. Bon nombre de DLL du fournisseur MSSCCI permettent l'intgration avec d'autres systmes de contrle de la source et sont tlchargeables. L'implmentation QlikView est base sur la version 1.2 de l'API MSSCCI. Une fois connects un systme de contrle de la source, les dveloppeurs peuvent ajouter des projets au contrle de la source. Lors du processus Ajouter :
l l l l l

Le document QlikView est enregistr. Le dossier du projet est cr. Les fichiers du projet sont exports dans le dossier du projet. Les fichiers du projet sont ajouts au contrle de la source. Le fichier de paramtres du projet est cr.

Le fichier de paramtres du projet est stock dans le dossier de projet local. Le fichier est nomm [NomDocumentQlikView]-prj.scc et contient les paramtres ncessaires l'accs aux informations de contrle de la source pour le projet. Le fichier de paramtres du projet n'est pas inclus dans les fichiers grs par le systme de contrle de la source. L'existence du fichier de paramtres du projet permet QlikView de savoir qu'un document donn est gr par un systme de contrle de la source. De plus, QlikView a pu identifier et charger la DLL du fournisseur MSSCCI afin de traiter le document comme s'il tait attach au contrle de la source. Cette vrification est effectue chaque fois qu'un document est ouvert dans QlikView. Si le document est joint au contrle de la source, la barre d'tat contient une indication de l'tat du document. L'intgration de QlikView avec le contrle de la source affecte uniquement la disposition du document. Aucune donne relle charge dans QlikView n'est place dans le systme de contrle de la source et n'en est extraite. L'opration Rcuprer le projet partir du contrle de la source charge un document qui contient tout sauf des donnes. Un rechargement doit tre excut pour remplir le document de donnes. Une fois qu'un document QlikView est connect au contrle de la source, l'enregistrement de ce document entrane le retrait automatique des fichiers modifis. QlikView ne fournit aucun autre moyen de retirer les fichiers du projet. Si le systme de contrle de la source n'est pas disponible lors de l'enregistrement du document, alors QlikView tente de travailler hors ligne, c.--d., de supprimer les indicateurs de lecture seule des fichiers modifis et d'enregistrer la dernire version. Lors de l'enregistrement suivant du document, quand le contrle de la source sera disponible, QlikView retirera tous les fichiers modifis localement. Lors de l'enregistrement du document, les fichiers du projet ne sont pas archivs. Pour archiver les mises jour du document dans le systme de contrle de la source, vous devez utiliser l'lment de menu Archiver les modifications en attente. Une seule opration d'archivage de QlikView peut gnrer plusieurs ensembles de modifications. Par consquent, l'aller-retour entre les ensembles de modifications slectionns au hasard ne garantit pas un tat stable pour le document.

56

10 Commandes de menu
Les menus dcrits dans ce chapitre se trouvent dans la barre de menus en haut de l'cran. La plupart des commandes peuvent galement tre configures sous la forme de boutons dans les barres d'outils (voir Personnaliser (les barres d'outils) (page 76).

10.1 Menu Fichier


Le menu Fichier est un menu droulant en haut de l'cran, qui contient les commandes suivantes: Nouveau Ouvre une nouvelle fentre QlikView et vous permet de crer un nouveau Fichier QlikView (page 55). Ouvre une nouvelle fentre QlikView et vous permet d'ouvrir un fichier QlikView ou un fichier de tables. L'ouverture d'un fichier de tables lance automatiquement l' Assistant Fichier: Type (page 212). Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+O. Ouvre la Connexion au serveur (page 43). Dans cette bote de dialogue, vous pouvez vous connecter un serveur QlikView et rechercher un document ouvrir en mode client. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+MAJ+O.
Remarque: Lorsque vous ouvrez des documents en tant que client d'un serveur QlikView, vous ne pouvez pas effectuer les mmes oprations que sur des documents locaux. En tant que client, vous ne pouvez pas ajouter ou supprimer d'objets de feuille, selon la licence client utilise et la prise en charge ou non de la collaboration par le document. Vous ne pouvez pas ajouter ou supprimer de feuilles. De plus, il n'est pas possible d'accder toutes les botes de dialogue de proprits, de modifier les macros, d'ouvrir le script, de recharger les donnes ou d'enregistrer le document.

Ouvrir...

Ouvrir sur un serveur...

Actualiser le Document

Ouvrir une URL...

Ouvrir via FTP...

Fermer Raccourcis

Cette commande est seulement disponible sur les documents ouverts avec QlikView Serveur et lorsqu'il existe une nouvelle version du document sur le serveur. En excutant une actualisation, vous aurez accs aux dernires donnes tout en conservant l'tat de la disposition et les slections faites dans votre session. Ouvre la bote de dialogue Ouvrir une URL. Dans cette bote de dialogue, saisissez l'URL valide de n'importe quelle page web. La page web sera ouverte dans une fentre spare dans QlikView. Cette fonctionnalit peut tre utilise, par exemple, pour QlikView Publisher Accesspoint ou pour des pages affichant des documents QlikView Server par le biais de clients AJAX. Les pages web ouvertes sont accessibles via le menu Fentre, l'instar des fentres de document QlikView standard. Ouvre une nouvelle fentre QlikView, qui vous permet d'ouvrir un fichier QlikView ou un fichier de tables partir d'un serveur FTP (voir Ouvrir des fichiers Internet ou Ouvrir un document QlikView (page 205)). L'ouverture d'un fichier de tables lance automatiquement l'Assistant Fichier. Ferme le fichier QlikView actif. Ce menu en cascade contrle la liste des documents favoris dfinis par l'utilisateur, grs indpendamment de la liste des documents rcemment utiliss (voir ci-dessous).

57

Enregistre la configuration actuelle dans un fichier QlikView. Les donnes, le script et la disposition sont enregistrs. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+S. Enregistrer sous... Enregistre la configuration actuelle dans un nouveau fichier QlikView sous un nouveau nom. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: F12. Enregistrer le lien... Enregistre un lien vers un document ouvert sur un serveur QlikView sous forme de fichier texte sur l'ordinateur local. Le fichier portera l'extension .qvw mais ne contiendra aucune donne ni information de disposition. Quand on ouvre un tel lien, QlikView essaie de se reconnecter au serveur QlikView et d'y ouvrir le document. Cette commande n'est pas disponible pour les documents locaux. Envoyer en Pice Disponible uniquement lorsque vous travaillez avec un document local. Cre un Jointe... courrier lectronique avec une copie du document qvw actif en pice jointe. Le destinataire pourra ouvrir le document qvw s'il dispose de QlikView et s'il a des droits d'accs au document (en cas d'utilisation de la scurit d'accs de la section). Cette commande fonctionne uniquement si un client de messagerie est configur sur l'ordinateur. Envoyer par Disponible uniquement lorsque vous travaillez avec un document QlikView courriel avec le Server. Cre un courrier lectronique avec un lien (URL) vers le document actif favori en lien... du serveur. Un favori temporaire de serveur sera cr (comprenant l'tat de la disposition) et cod dans l'URL. Le destinataire du courrier peut utiliser le lien (URL) pour ouvrir le document du serveur et afficher ce que vous voyez l'cran condition qu'il dispose des droits d'accs au document et aux donnes. Cette commande fonctionne uniquement si un client de messagerie est configur sur l'ordinateur. Le serveur QlikView doit tre configur pour autoriser les favoris. Imprimer... Ouvre la bote de dialogue Imprimer standard (voir Exportation et impression (page 105)), qui vous permet d'imprimer l'objet de feuille actif. Cette commande n'est pas disponible pour les listes de slection. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+P. Imprimer au format Ouvre la bote de dialogue Imprimer et prslectionne l'imprimante PDF... QlikViewPDF. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+MAJ+P. Imprimer les Ouvre la bote de dialogue Imprimer standard (voir Exportation et impression valeurs possibles... (page 105), qui vous permet d'imprimer les valeurs possibles (slectionnes et facultatives) de la liste de slection active. Cette commande n'est disponible que pour les listes de slection. Imprimer les Cette commande doit tre utilise pour imprimer des listes de slection et des valeurs possibles au listes multiples en PDF. format PDF... Enregistrer Imprimer la feuille... Ouvre la bote de dialogue Imprimer, qui vous permet d'imprimer une image de la feuille active (voir Imprimer la feuille (page 110)). Aperu avant Affiche un aperu des objets de feuille imprimables (voir Aperu avant impression... impression (page 110)).

58

Contrle de la source

Paramtres Dfinissez le systme DLL du fournisseur MSSCCI (Microsoft Source Code Control Interface) utiliser lors de l'ajout ou de l'obtention d'un projet partir du contrle de la source. Pour plus d'informations, voir Contrle de la source (page 56). Ajouter un projet au contrle de la source Permet d'enregistrer le document QlikView ouvert et de crer automatiquement un dossier de projet et des fichiers de projet. Appelle le systme de contrle de la source pour ajouter le projet au contrle de la source. Rcuprer le projet partir du contrle de la source Permet de rcuprer un projet depuis le contrle de la source et de rgnrer le document QlikView partir des fichiers de projet. Les donnes QlikView ne sont pas stockes dans le contrle de la source. Pour remplir le document avec les donnes, la commande Recharger doit tre excute sur le document rgnr. Rcuprer la dernire version Permet de rcuprer la dernire version du document depuis le contrle de la source et de rgnrer le document QlikView. Archiver les modifications en attente Permet d'enregistrer le document QlikView et d'appliquer une opration d'archivage au systme de contrle de la source. Cette opration peut inclure quatre oprations diffrentes de contrle de la source, chacune avec sa propre bote de dialogue :
l l l

Ajout de fichiers rcemment crs. Annulation des fichiers retirs devant tre supprims du contrle de la source. Suppression des fichiers correspondant aux feuilles supprimes ou aux objets de feuille faisant partie du contrle de la source. Archivage des fichiers modifis.

Si le document n'tait pas jour avant l'opration Archiver les modifications en attente, rouvrez-le pour charger les modifications du projet ventuellement introduites lors de la rsolution des conflits.

Annuler les modifications en attente Permet d'annuler les modifications effectues. Si des fichiers modifis localement ne sont pas retirs du systme de contrle de la source, ils le sont avant l'excution de l'opration d'annulation du retrait. Cette opration rgnre le document QlikView en supprimant des fichiers ajouts et non archivs, et en restaurant les rfrences aux fichiers dont la suppression est en attente.

59

Exportation

Exporter le contenu... Cette option est uniquement disponible lorsqu'un objet de feuille exportable est actif. Elle effectue alors l'opration d'exportation que l'on trouve dans le menu Objet de l'objet. Exporter l'image de la feuille... Ouvre une bote de dialogue destine enregistrer une image de la feuille active dans un fichier. Exporter la disposition du document Ouvre une bote de dialogue permettant d'enregistrer la disposition au format de fichier XML. Les donnes du document ne sont pas enregistres dans le fichier XML. Exporter la disposition de la feuille... Ouvre une bote de dialogue permettant d'enregistrer la disposition de la feuille active au format de fichier XML. Les donnes du document ne sont pas enregistres dans le fichier XML. Importer la disposition du document Ouvre une bote de dialogue permettant d'importer la disposition d'un autre document enregistr au format de fichier XML. Les donnes du fichier source ne sont pas importes.

Importer

Importer la disposition de la feuille Ouvre une bote de dialogue permettant d'importer la disposition d'une autre feuille enregistre au format de fichier XML. Les donnes du fichier source ne sont pas importes. diter le script... Ouvre la Bote de dialogue diter le script (page 185). Dans cette bote de dialogue, on peut crire et excuter des scripts qui ouvrent des bases de donnes et s'y connectent. Recharger Excute le script de chargement actif et recharge les donnes dans le document QlikView ouvert. Il faut le faire si le contenu de la base de donnes a chang depuis le dernier rechargement. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+R. Recharger Excute le script de chargement actif (y compris les commandes de script telles partiellement que Drop Table (page 253)) et recharge les donnes dans le document QlikView ouvert. Cependant, seules les tables dont les instructions load et select sont prcdes du prfixe Replace (page 283) ou Ajouter (page 242) sont recharges. Les tables de donnes qui ne sont pas concernes par ce type d'instructions load ou select ne sont pas concernes par le rechargement partiel.Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+MAJ+R. Rduire les donnes Ouvre un menu comprenant les deux commandes suivantes: Conserver les valeurs slectionnes Rduit la base de donnes QlikView en supprimant toutes les valeurs exclues. Supprimer toutes les valeurs Cre un modle en supprimant toutes les valeurs de la base de donnes QlikView, mais en conservant sa structure et sa disposition.

60

Ouvre la bote de dialogue Visionneur de tables (page 194) dans laquelle vous pouvez examiner la structure des donnes charges dans une vue graphique des tables, champs et associations. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+T. Liste des documents Liste des derniers documents QlikView utiliss. Le nombre de documents rcemment utiliss affichs peut tre dfini dans la bote de dialogue Paramtres: Prfrences utilisateur. La valeur par dfaut est 8. La slection de l'un de ces documents quivaut utiliser la commande Ouvrir. Quitter Ferme les documents ouverts et quitte QlikView. Visionneur de tables...

10.2 Menu dition


Le menu dition est un menu droulant en haut de l'cran, qui contient les commandes suivantes: Annuler la modification Annule la dernire modification, qu'il s'agisse du dplacement, du dimensionnement et de la suppression d'objets, ou encore de modifications apportes aux proprits des objets. Supprimer des feuilles, modifier les proprits de la feuille ou les proprits du document sont des oprations qui peuvent aussi tre annules. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+Z. Rtablir le changement Rtablit la dernire action annule. Cette commande peut galement tre de position appele l'aide du raccourci clavier suivant: CTRL+Y. Couper Dplace les objets slectionns dans le Presse-papiers pour que vous puissiez les coller ailleurs dans le document QlikView. Si un seul objet est actif, une image bitmap de l'objet, qui peut tre colle dans d'autres programmes, sera aussi ajoute au Presse-papiers. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+X. Copie les objets slectionns dans le Presse-papiers pour que vous puissiez les coller ailleurs dans le document QlikView. Si un seul objet est actif, une image bitmap de l'objet, qui peut tre colle dans d'autres programmes, sera aussi ajoute au Presse-papiers. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+C. Colle un ou plusieurs objets du Presse-papiers dans le document QlikView. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+V. L'outil Reproduire la mise en forme (page 75) permet de copier le format d'un objet vers un autre. Si la commande de confirmation Supprimer l'objet de la feuille de la bote de dialogue Prfrences utilisateur: Objets (page 91) est active (par dfaut), l'utilisateur est invit confirmer cette commande avant de supprimer les objets. Rend tous les objets de feuille actifs. Vous pouvez obtenir le mme rsultat en tirant l'aide de la souris un rectangle autour des objets de feuille qui doivent tre activs ou en cliquant dessus avec la touche Maj enfonce. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+A.

Copier

Coller

Reproduire la mise en forme Supprimer

Activer tout

61

Rechercher

Recherche partielle Recherche avance

Ouvre la bote de dialogue de recherche textuelle condition qu'un objet de feuille chercher (liste de slection ou liste multiple ouverte) soit actif. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+F. Ouvre la bote de dialogue de recherche de texte en Recherche partielle (page 121), condition qu'un objet de feuille chercher soit actif.

Ouvre la Bote de dialogue de recherche avance (page 123), condition qu'une liste de slection ou une liste multiple ouverte soit active. Cette bote de dialogue permet de saisir des expressions avances. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: MAJ+CTRL+F. Options du Presse-papiers Passe du mode logique au mode copie. Les valeurs sur lesquelles on clique en mode copie sont copies dans le Presse-papiers sans modifier l'tat logique de l'excution de QlikView. Lorsque vous choisissez le mode copie, la bote de dialogue Contenu du Presse-papiers (page 111) s'ouvre. Cette bote de dialogue affiche les champs copis. Le format de la liste des copies peut galement y tre dfini.

10.3 Menu Affichage


Le menu Affichage est un menu droulant en haut de l'cran, qui contient les commandes suivantes: Feuilles Lorsque cette option est slectionne, un menu en cascade affiche une liste de toutes les feuilles utilises dans le document, tries telles qu'elles apparaissent de gauche droite. Lorsque cette option est slectionne, un menu en cascade vous permet d'activer toutes les barres d'outils afficher avec le document.Les barres d'outils suivantes peuvent toutes tre utilises indpendamment les unes des autres: Standard, Navigation, Conception, Feuilles et Favoris. La dernire entre de la liste est l'option Personnaliser (les barres d'outils) (page 76) qui vous permet de configurer la barre d'outils selon vos propres prfrences. Les barres d'outils Standard, Navigation et Conception ont chacune t prdfinies avec une slection de commandes, comme le suggre leurs noms. Les barres d'outils Feuilles et Favoris sont en fait des listes droulantes, qui donnent un autre moyen de passer d'une feuille l'autre, d'un favori l'autre. Vous pouvez configurer le contenu et la fonctionnalit de toutes les barres d'outils l'aide de l'option Personnaliser.... Astuce: tout gauche des barres d'outils, de mme que dans la barre de menus, apparaissent des points verticaux. Vous pouvez cliquer dessus et tirer pour ancrer ou dplacer la barre, comme sous Windows. Active ou dsactive la barre d'tat. Permet de zoomer par incrments de 25% sur la zone d'affichage pour mieux l'adapter aux rsolutions de l'cran. Vous pouvez spcifier d'autres facteurs de Zoom dans la page Proprits de la feuille: Gnral (page 487). Active ou dsactive le volet Volet des Objets Serveur (page 635).

Barres d'outils

Barre d'tat Zoom

Objets stocks sur le serveur

62

Redimensionner la fentre Ajuster le zoom la fentre Appliquer le zoom toutes les feuilles Grille de conception

Avec cette option, la taille de fentre du document QlikView peut tre dfinie sur une des rsolutions d'cran frquentes. Modifie la taille de la feuille affiche et de tout ce qui s'y trouve pour l'adapter la taille de la fentre. Les paramtres du Zoom de la feuille affiche seront appliqus toutes les feuilles du document. Dsactive la grille de conception, les marques de rserve pour les objets actifs et la fonction d'alignement sur la grille pour dimensionner et dplacer des objets dans la disposition. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+G. Active et dsactive le mode WebView, qui utilise le navigateur Web interne de QlikView pour afficher le document en mode AJAX. Ouvre la bote de dialogue Slections actives (page 117) o les slections sont rpertories par nom et par valeur de champ. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+O.

Activer/Dsactiver WebView Slections actives...

10.4 Menu Slection


Le menu Slection est un menu droulant en haut de l'cran, qui contient les commandes suivantes: Prcdent Revient l'tat logique prcdent. S'applique aux slections de valeurs et toutes les commandes du menu Slection. QlikView garde une liste des 100derniers tats. Chaque utilisation de l'option Prcdent vous ramne en arrire d'un niveau dans la liste. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: MAJ+FLCHE GAUCHE Revient l'tat logique qui tait en vigueur avant l'utilisation de la commande Prcdent. Passez d'un tat l'autre en alternant les commandes Prcdent et Suivant. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: MAJ+FLCHE DROITE Verrouille toutes les slections de valeurs actives. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+MAJ+L. Dverrouille toutes les slections de valeurs actuellement verrouilles. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+MAJ+U. Permet d'appliquer la slection de dbut d'un document QlikView qui peut tre configur (voir Dfinir l'tat initial ci-dessous). Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+MAJ+D. Efface toutes les slections actives except celles qui sont verrouilles. Efface toutes les slections de valeurs actives.

Suivant

Verrouiller

Dverrouiller

Effacer

Effacer tout Dverrouiller et effacer tout Dfinir tat initial

Dfinit la slection active comme tat initial.

Rinitialiser l'tat initial Rtablit l'tat initial.

63

10.5 Menu Disposition


Le menu Disposition est un menu droulant en haut de l'cran, qui contient les commandes suivantes: Ajouter une feuille... Ajoute une feuille onglets o un nouvel ensemble d'objets peut s'afficher. Si le client et le serveur disposent de la version9 de QlikView ou d'une version ultrieure, il est possible d'ajouter une nouvelle feuille la disposition mme si vous utilisez un document sur le serveur QlikView. Dplace (l'onglet de) la feuille actuelle d'un cran vers la gauche (en avant). Dplace (l'onglet de) la feuille actuelle d'un cran vers la droite (en arrire). Supprime la feuille active et tout ce qu'elle contient.

Promouvoir la feuille Abaisser la feuille Supprimer la feuille

Slectionner des champs... Ouvre l'onglet Champs de la bote de dialogue Proprits de la feuille. Il est possible de slectionner un ou plusieurs noms de champs dans une liste. Les champs slectionns s'afficheront dans des listes de slection configures par dfaut sur la feuille active. Pour dfinir les proprits spcifiques d'une liste de slection, effectuez un clic droit dessus, puis slectionnez Proprits dans le menu contextuel (ou dans le menu Objet du menu Principal). Cette commande n'est pas disponible quand on utilise des documents sur le serveur QlikView. Objets stocks sur le Ouvre la bote de dialogue Objets stocks sur le serveur (voir Volet des serveur... Objets Serveur (page 635)). Les objets personnels peuvent tre grs et les objets du serveur partags cet endroit. Cette option n'est disponible que lorsque vous utilisez un document sur QlikView Server et que le serveur et le document du serveur ont t configurs pour autoriser les objets sur le serveur. Nouvel objet de feuille Ouvre un menu en cascade dans lequel vous pouvez choisir de crer un des objets de feuille proposs. Lorsque l'objet est cr, la bote de dialogue Proprits correspondante apparat pour permettre de configurer le nouvel objet. Si le client et le serveur disposent de la version8 de QlikView ou d'une version ultrieure, il est possible d'ajouter de nouveaux objets de feuille la disposition mme avec un document sur QlikView Server. a) Vous devez disposer d'une licence valide. b) Le document du serveur doit tre configur pour autoriser les objets sur le serveur. c) Le serveur QlikView doit tre configur pour autoriser les objets sur le serveur. Ouvre un menu comportant les commandes suivantes applicables aux objets lis. Objets lis
Ajuster la position des objets lis Tous les objets lis de toutes les feuilles sont ajusts selon la mme position et la mme taille que ceux mis en surbrillance. Dtacher l'objet/Dtacher les objets Rompt le lien tabli entre les objets, les individualisant l'aide d'identificateurs uniques.

Rorganiser les objets de Organise automatiquement les objets de la feuille active. la feuille

64

Adapter la taille Certains types d'objets, tels que les listes de slection, les listes multiples et maximale de l'objet la les tables, peuvent avoir une taille maximum suprieure leur taille taille actuelle actuelle. Cela permet d'agrandir une table sur la feuille lorsque des donnes supplmentaires sont ajoutes. Cette opration restaure la taille maximum de l'objet par rapport sa taille actuelle pour tous les objets slectionns sur la feuille active. Vous pouvez utiliser CTRL+A pour slectionner tous les objets prsents sur une feuille. Ajuster les objets hors Tout objet sortant de la zone d'affichage de la fentre QlikView est ramen cran l'intrieur. Aligner/Rpartir On peut choisir ici l'alignement des objets de la feuille parmi un certain nombre d'options proposes, comme par exemple Aligner gauche, Centrer horizontalement.

10.6 Menu Paramtres


Le menu Paramtres est un menu droulant en haut de l'cran, qui contient les commandes suivantes: Ouvre la bote de dialogue Prfrences utilisateur (page 81) qui contient les paramtres que l'utilisateur ne change normalement pas en passant d'un document l'autre. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+ALT+U. Proprits du document... Ouvre la bote de dialogue Proprits du document: Gnral (page 440) qui contient les paramtres concernant le document dans son ensemble. On peut aussi y dfinir certaines proprits courantes pour les objets du document.Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+ALT+D. Proprits de la feuille... Ouvre la bote de dialogue Proprits de la feuille: Gnral (page 487) qui contient les paramtres concernant la feuille active. On peut aussi y dfinir certaines proprits courantes pour les objets de la feuille. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+ALT+S. Reportez-vous aux liens en bas de cette page. Vue d'ensemble des Ouvre la bote de dialogue Vue d'ensemble des variables (page 171) o variables... toutes les variables non masques et leurs valeurs sont prsentes en une seule liste. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+ALT+V. Vue d'ensemble des Ouvre la bote de dialogue Vue d'ensemble des expressions (page 173) o expressions... toutes les expressions du document, des feuilles et des objets peuvent tre affiches et gres de faon centralise dans une seule liste. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+ALT+E. Prfrences utilisateur...

10.7 Menu Favoris


Le menu Favoris est un menu droulant en haut de l'cran, qui contient les commandes suivantes: Favoris du document Favoris de l'utilisateur Cette liste permet de rcuprer les dix premiers favoris du document actif. Dans cette liste, on peut rcuprer les dix premiers favoris personnels lis au document actif.

65

Ajouter un favori

Remplacer le favori

Supprimer le favori

Plus... Importer...

Ouvre la bote de dialogue Bote de dialogue Ajouter un favori (page 131), o le nom du favori peut tre modifi. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+B. Les dix premiers favoris du document actif apparaissent dans la liste audessus des dix premiers favoris personnels. La commande remplace la slection correspondant au favori slectionn par la slection actuelle. Les dix premiers favoris du document actif apparaissent dans la liste audessus des dix premiers favoris personnels. La commande supprime le favori slectionn. Ouvre la bote de dialogue Favoris, o tous les favoris dj crs pour le document peuvent tre rcuprs. Une fois que vous avez localis et slectionn un fichier de favori prcdemment enregistr (dot de l'extension .qbm), la bote de dialogue Importer des favoris (page 136) s'ouvre pour vous permettre d'importer des favoris. Ouvre la bote de dialogue Exporter des favoris (page 136) dans laquelle vous pouvez exporter les favoris slectionns vers un fichier de favoris QlikView (dot de l'extension .qbm).

Exporter...

10.8 Menu Rapports


Le menu Rapports situ en haut de l'cran QlikView contient la commande diter des rapports... qui ouvre la bote de dialogue diteur de rapports (page 140) dans laquelle vous pouvez crer de nouveaux rapports ou modifier des rapports existants. Cette bote de dialogue vous permet galement de supprimer et slectionner des rapports, de concevoir leur disposition, d'ajouter des pages et des images, etc. L'diteur de rapports rpertorie tous les rapports disponibles pour une slection immdiate. Les rapports peuvent tre des rapports de document, stocks avec le document ou des rapports utilisateur, stocks sparment sur l'ordinateur de l'utilisateur. Voir diteur de rapports (page 140).

10.9 Menu Outils


Le menu Outils est un menu droulant affich en haut de l'cran, qui contient les commandes suivantes: diter le module... Ouvrir QlikView AccessPoint Ouvre la boite de dialogue diter le module (page 963) utilise pour crer les macros. Ouvre QlikView AccessPoint dans une fentre HTML au sein de QlikView. Cette commande est uniquement disponible si vous avez configur uneURL pour QlikView AccessPoint la page Prfrences utilisateur: Emplacements. Ouvre QlikView Management Console/QlikView Enterprise dans Management Console dans une fentre HTML au sein de QlikView. Cette commande est uniquement disponible si vous avez configur uneURL pour QlikView Management Console/QlikView Enterprise Management Console la page Prfrences utilisateur: Emplacements. Ouvre l' Assistant Graphique instantan (page 823) qui vous permet de crer rapidement et facilement un graphique simple, sans vous proccup grand nombre de paramtres et d'options disponibles.

Ouvrir QlikView Management Console

Assistant Graphique instantan...

66

Assistant Graphique temporel...

Assistant Graphique de statistiques... Assistant de cration de bote moustaches Alertes... Assistant Alerte... Assistant Crateur de thmes

L' Assistant de cration de graphique temporel (page 833) vous aide effectuer une tche frquente, savoir laborer des graphiques dont une mesure donne (expression) doit tre qualifie par des priodes diffrentes et souvent compare d'autres priodes, comme l'anne en cours, l'anne prcdente, l'anne jusqu' une date donne, etc. L' Assistant Graphique de statistiques (page 841) donne des conseils ceux qui veulent effectuer des tests statistiques lmentaires sur les donnes dans QlikView. L' Assistant Bote moustaches (page 821) cre un combin souvent utilis pour l'affichage des donnes statistiques. Ouvre la bote de dialogue Alertes (page 160) o vous pouvez dfinir et modifier des alertes. L' Assistant Alerte (page 164) facilite la tche de dfinition d'une alerte. Appelle l' Assistant Crateur de thmes (page 643) qui permet de crer ou de modifier des thmes. Pour plus d'informations sur les thmes, voir Thmes de disposition (page 641).

10.10 Menu Objet


Le menu Objet est un menu propre l'objet actif. On peut l'ouvrir en choisissant Objet dans la barre de menus ou d'un clic droit sur l'objet. Dans certaines circonstances, par exemple quand une feuille ne contient pas encore d'objets, le menu Objet de la feuille correspond au menu Objet de la barre de menus. Si plusieurs objets sont actifs, le menu Objet contient les commandes communes tous ces objets. Pour une description des diffrents menus objet, voir la section concernant chaque objet.

10.11 Menu Fentre


Le menu Fentre est un menu droulant en haut de l'cran, qui contient les commandes suivantes: Cascade Mosaque Organiser les icnes Documents disponibles Dispose les fentres de faon ce qu'elles se superposent. Dispose les fentres pour qu'elles ne se superposent pas. Organise les icnes dans le bas de la fentre. Ouvre la bote de dialogue Documents disponibles (page 68) qui affiche une liste tendue (plus de 10) des documents QlikView ouverts et fournit des informations supplmentaires sur les documents. Slectionner un document en fait la fentre active.

67

Documents disponibles

Cette bote de dialogue peut tre utilise pour changer de document actif lorsque plus de dix documents sont ouverts en mme temps. Slectionnez un document dans la liste et cliquez sur Slectionner pour en faire la fentre active. Cette bote de dialogue contient galement des informations techniques que vous devez fournir lorsque vous rencontrez des problmes dans un document QlikView donn. Les colonnes sont: Document Nom du document .qvw. Si la case Afficher les chemins d'accs complets en bas de la bote de dialogue est coche, le nom du document est fourni avec le chemin complet du fichier.

Connexion

Locale (document ouvert sur l'ordinateur local) ou Distante (document ouvert sur le serveur QlikView).
N de compilation du client QlikView.

N de compilation du client N de compilation du serveur Nom NT du client

N de compilation du serveur QlikView pour les documents distants.

Identit de l'utilisateur client authentifie par Windows NT lorsque la connexion est tablie avec une authentification NT.

Enregistr sous la version Informations compltes sur la version de QlikView utilise la dernire fois que le document a t enregistr (disponible uniquement pour les documents locaux).

10.12 Menu Aide


Le menu ? est un menu droulant en haut de l'cran, qui contient les commandes suivantes: Sommaire Utilisation de l'aide Ouvre l'aide de QlikView. Fournit des conseils sur l'utilisation de l'aide de QlikView.

68

Afficher la page de dmarrage

Affiche la page de dmarrage chaque fois dmarrage de QlikView. Si la page de dmarrage ne doit pas apparatre au lancement du programme, dsactivez la case Afficher la page de dmarrage au lancement de QlikView. Ouvre d'autres options qui renvoient au site Internet de QlikTech. Ouvre la bote de dialogue QlikView Update dans laquelle vous pouvez configurer QlikView pour qu'il contacte le serveur de mise jour QlikView afin de vrifier la disponibilit de nouvelles mises jour du programme. Ouvre la bote de dialogue License Enabler File Editor qui permet l'utilisateur de consulter ou de modifier le fichier d'activation de licences.

QlikTech sur Internet Mise jour de QlikView...

Mise jour de la licence...

Informations d'aide sur le Ouvre la bote de dialogue Informations d'aide sur le document (page 69) qui document... affiche une liste des donnes de support appartenant au document actif. propos de QlikView... Ouvre la bote de dialogue propos qui affiche la version de QlikView, le numro de srie et le nom du propritaire.

Informations d'aide sur le document

Cette bote de dialogue affiche une liste des donnes systme appartenant au document actif. Vous devez fournir la rfrence de ces informations chaque fois que vous signalez des bogues ou des problmes qui peuvent tre lis certains documents QlikView. Certaines lignes ne sont pertinentes que pour les documents locaux, tandis que d'autres concernent uniquement les documents distants.

69

Grce au bouton Copier dans le Presse-papiers, vous pouvez copier et coller le contenu de cette bote de dialogue, par exemple dans un document texte en pice jointe ou directement dans le courriel envoy au support technique.

70

11 Barres d'outils et barre d'tat


11.1 Barres d'outils
QlikView possde cinq barres d'outils standard et une barre de menu. La barre d'outils standard comprend normalement des boutons destins aux tches effectues lors de l'utilisation de documents QlikView, tandis que la barre d'outils de conception contient normalement des boutons destins aux tches de cration ou de modification de la disposition d'un document. La barre d'outils de navigation contient les commandes des oprations logiques les plus frquentes dans un document. La barre d'outils des feuilles est une autre mthode pour se dplacer entre diffrentes feuilles, et la barre d'outils des favoris un autre moyen d'accder aux favoris. Chacune de ces barres d'outils peut tre active et dsactive individuellement. Toutes les barres d'outils sont totalement personnalisables et peuvent contenir n'importe quel bouton de commande disponible. Toutes les barres d'outils peuvent tre dplaces ; il suffit pour cela de cliquer sur la ligne en pointill tout gauche. Maintenez le bouton gauche de la souris enfonc et faites glisser le curseur jusqu' l'endroit de votre choix. Les barres d'outils peuvent tre ancres n'importe o dans la fentre de l'application QlikView.

11.2 Barre d'outils Standard


Barre d'outils standard

La barre d'outils standard de QlikView comprend des boutons pour les fonctions les plus courantes. Pour activer ou dsactiver la barre d'outils standard, choisissez Standard sous Barres d'outils dans le menu Affichage. La figure ci-dessus et le texte ci-dessous dcrivent le contenu par dfaut de la barre d'outils standard. Nouveau fichier Ouvre une nouvelle fentre QlikView et vous permet de crer un nouveau Fichier QlikView (page 55). Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+N. Permet d'ouvrir un Fichier QlikView (page 55) ou un Table file dans une nouvelle fentre QlikView. L'ouverture d'un fichier de tables lance automatiquement l' Assistant Fichier: Type (page 212). Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+O. Cette commande est seulement disponible sur les documents ouverts avec QlikView Serveur et lorsqu'il existe une nouvelle version du document sur le serveur. En excutant une actualisation, vous aurez accs aux dernires donnes tout en conservant l'tat de la disposition et les slections faites dans votre session. Enregistre le document actif comme fichier. Le format de fichier par dfaut est dfini sous Prfrences utilisateur: Enregistrer (page 85). Cliquer sur l'outil d'impression imprime immdiatement l'objet slectionn avec les paramtres par dfaut de l'imprimante, en ignorant la configuration des paramtres dfinis sous l'onglet Imprimer: Gnral (page 105). L'outil sera gris si aucun objet imprimable n'est slectionn. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+P.

Ouvrir un fichier

Actualiser

Enregistrer Imprimer...

71

Ouvre la bote de dialogue Imprimer: Gnral (page 105) avec l'imprimante QlikViewPDF prslectionne. Aprs avoir cliqu sur le bouton Imprimer, vous serez invit donner un nom au fichier de sortie PDF. Ce bouton est uniquement disponible si une imprimante PDF est installe sur le systme. Vous devez tlcharger l'imprimante QlikViewPDF partir de la page d'accueil de QlikView, puis l'installer sparment. diter le script... Ouvre la bote de dialogue Bote de dialogue diter le script (page 185) qui permet d'crire et d'excuter un Script permettant d'ouvrir des bases de donnes et de rcuprer des donnes dans QlikView. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+E. Recharger Rexcute le Script, actif en mettant jour la base de donnes QlikView associative de manire inclure les modifications apportes aux donnes source depuis l'excution prcdente. L'heure du dernier rechargement est indique sous forme d'horodateur dans la barre d'tat. Annuler la modification Annule la dernire modification, qu'il s'agisse du dplacement, du dimensionnement et de la suppression d'objets, ou encore de modifications apportes aux proprits des objets. Supprimer des feuilles, modifier les proprits de la feuille ou les proprits du document sont des oprations qui peuvent aussi tre annules. QlikView conserve une liste des dernires modifications du modle de disposition. Chaque utilisation de la commande Annuler la modification vous ramne en arrire d'un lment dans la liste. Certaines oprations, comme par exemple Recharger et Rduire les donnes, videront le tampon Annuler/Rtablir. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+Z. Rtablir le changement Rtablit la dernire action annule. Chaque utilisation de la commande de disposition Rtablir le changement de disposition vous fera avancer d'un cran dans la liste, tant qu'il y aura des actions annules rtablir. Certaines oprations, comme par exemple Recharger et Rduire les donnes, videront le tampon Annuler/Rtablir. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+Y. Rechercher Ouvre la zone Rechercher (page 120) associe l'objet actif. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+F. Slections actives Ouvre la bote de dialogue Slections actives dans laquelle sont affiches les slections actives. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+O. Assistant Graphique Ouvre l' Assistant Graphique instantan (page 823) qui vous permet de instantan crer rapidement et simplement un objet graphique, sans vous soucier du grand nombre de proprits qu'il est possible de dfinir. Ajouter un favori Ouvre la bote de dialogue Bote de dialogue Ajouter un favori (page 131), o le nom du favori peut tre modifi. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+MAJ+B. Rubriques de l'aide Ouvre l'aide de QlikView. Imprimer en PDF Aide contextuelle Affiche une aide spcifique l'objet choisi, par exemple une commande de menu. Aprs avoir cliqu sur ce bouton, dplacez simplement le point d'interrogation sur l'objet pour lequel vous avez besoin d'aide.

72

11.3 Barre d'outils Navigation


La barre d'outils de navigation de QlikView comprend les boutons des fonctions les plus frquemment utilises pour analyser des donnes dans QlikView. Pour activer ou dsactiver la barre d'outils de navigation, choisissez Navigation dans Barres d'outils du menu Affichage. Le texte ci-dessous dcrit le contenu par dfaut de la barre d'outils Navigation. Effacer Ce bouton permet d'appliquer la slection de dbut d'un document QlikView qui est configurable (voir Dfinir l'tat initial ci-dessous). Le menu droulant propose les options suivantes. Effacer Slection de dbut d'un document QlikView. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+MAJ+D. Effacer tout Efface toutes les slections, sauf les slections verrouilles. Dverrouiller et effacer tout Dverrouille et efface toutes les slections. Effacer un tat spcifique Efface les slections d'un tat spcifique. Dfinir l'tat initial Dfinit la slection active comme tat initial. Rinitialiser l'tat initial Rtablit l'tat initial sur l'absence de slections. Revient l'tat logique (slection) prcdent. S'applique aux slections de valeurs et toutes les commandes du menu dition, sauf Copier et Options du Presse-papiers. QlikView garde une liste des 100derniers tats. Chaque utilisation de la commande Prcdent vous ramne en arrire d'un niveau dans la liste. Revient l'tat logique qui tait en vigueur avant l'utilisation de la commande Prcdent. Vous pouvez passer d'un tat l'autre en alternant entre les commandes Prcdent et Suivant. Verrouille toutes les slections de valeurs actives dans le document entier.

Prcdent

Suivant

Verrouiller (les slections) Dverrouiller (les slections)

Dverrouille toutes les slections de valeurs actuellement verrouilles dans le document entier.

11.4 Barre d'outils Conception

La barre d'outils de conception de QlikView (voir ci-dessus) contient des boutons destins aux tches de cration et de modification de la disposition d'un document. Par dfaut, cette barre d'outils n'est pas affiche. Pour activer ou dsactiver la barre d'outils de conception, choisissez Conception sous Barres d'outils dans le menu Affichage. La figure ci-dessus et le texte ci-dessous dcrivent le contenu par dfaut de la barre d'outils de conception.

73

Ajouter une feuille

Ajoute une nouvelle feuille au document.

Promouvoir la feuille Reculer la feuille Proprits de la feuille Crer une liste de slection Crer une zone de statistiques Crer une Zone table

Dcale la feuille active d'un cran vers la gauche. Dcale la feuille active d'un cran vers la droite. Ouvre la bote de dialogue Proprits de la feuille, partir de laquelle vous pouvez modifier la feuille active. Cre une liste de slection pour afficher le champ voulu de la table de base de donnes. Cre une zone de statistiques, qui calcule des statistiques partir des valeurs possibles d'un champ. Cre une zone Table, qui permet d'afficher des informations orientes enregistrements. Cre une liste multiple, qui permet d'afficher diffrents attributs.

Crer une liste multiple

Crer un graphique

Cre un graphique qui peut afficher des champs et des dimensions calcules.

Crer une zone de saisie Cre une zone de saisie qui permet d'afficher et de saisir des donnes dans des variables QlikView. Crer une zone des slections actives Crer un bouton Crer un objet Texte Crer un objet ligne/flche Crer un objet curseur/calendrier Crer un objet favori Crer un objet de recherche Crer un conteneur Cre une zone des slections actives qui permet d'afficher les slections actives directement dans la disposition. Cre un objet bouton qui excute des actions dans QlikView, telles que les raccourcis clavier, l'exportation, etc. Cre un objet destin afficher des informations textuelles ou des images. Cre un objet ligne/flche, qui permet de dessiner une ligne ou une flche dans la disposition. Cre un nouvel objet curseur/calendrier.

Cre un nouvel objet favori. Cre un nouvel objet de recherche.

Cre un nouveau conteneur.

Crer un objet personnalis

Cre un nouvel objet personnalis.

74

Crer un graphique temporel

Reproduire la mise en forme

Aligner gauche

L'Assistant Graphique temporel vous aide laborer des graphiques dont une mesure (expression) donne doit tre qualifie par des priodes diffrentes et souvent compare d'autres priodes, comme l'anne en cours, l'anne prcdente, l'anne jusqu' une date donne, etc. Ce bouton permet de copier le formatage d'un objet de feuille vers un ou plusieurs autres objets. Pour copier les proprits un seul objet, cliquez d'abord sur l'objet source, puis cliquez une fois sur le bouton Reproduire la mise en forme et, pour terminer, cliquez sur l'objet cible. Pour appliquer le formatage plusieurs objets, cliquez d'abord sur l'objet source, puis doublecliquez sur le bouton Reproduire la mise en forme et cliquez ensuite sur chaque objet cible. Arrtez l'opration de copie en cliquant nouveau sur le bouton ou en appuyant sur la touche chap. Lorsque vous copiez le formatage sur des objets de feuille de types diffrents ou lorsque vous cliquez sur la lgende de l'objet cible, seules les proprits de bordure/lgende sont copies. Lorsque vous appliquez le formatage des objets de feuille de mme type, les autres proprits de l'objet source sont galement copies. Aligne les objets de feuille actifs sur leur bordure gauche.

Centrer horizontalement Aligne les objets de feuille actifs en leur centre sur l'axe horizontal. Aligner droite Aligner en bas Centrer verticalement Aligner en haut Aligne les objets de feuille actifs sur leur bordure droite. Aligne les objets de feuille actifs sur leur bordure infrieure. Aligne les objets de feuille actifs en leur centre sur l'axe vertical. Aligne les objets de feuille actifs sur leur bordure suprieure.

Espacer horizontalement Rpartit les objets de feuille actifs sur l'axe horizontal pour laisser des espaces quivalents entre eux. Espacer verticalement Ajuster gauche Ajuster en haut Proprits du document Prfrences utilisateur Rpartit les objets de feuille actifs sur l'axe vertical pour laisser des espaces quivalents entre chacun d'eux. Dispose les objets de feuille actifs partir du bord vertical de l'objet le plus gauche avec un minimum d'espace entre chacun d'eux. Dispose les objets de feuille actifs partir du bord suprieur de l'objet le plus en haut avec un minimum d'espace entre chacun d'eux. Ouvre la bote de dialogue Proprits du document, partir de laquelle vous pouvez modifier les paramtres du document ouvert. Ouvre la bote de dialogue Prfrences utilisateur, partir de laquelle vous pouvez modifier des paramtres relatifs au mode d'utilisation de l'application. Ouvre la bote de dialogue diter le module qui permet de rdiger des macros et des fonctions personnalises en VBScript ou en JScript.

diter le module

75

Visionneur de tables Mode WebView

Ouvre la bote de dialogue Visionneur de tables, laquelle affiche la structure de la table de donnes. Permet d'afficher ou de masquer le mode WebView, lequel utilise le navigateur Web interne de QlikView pour prsenter la disposition du document sous forme de page AJAX.

11.5 Barre d'outils Feuilles


La barre d'outils Feuilles contient une liste droulante de toutes les feuilles du document et offre un autre moyen de modifier les feuilles. Le nom de la feuille active est toujours affich dans la zone droulante. Pour activer ou dsactiver la barre d'outils Feuilles, choisissez Feuilles sous Barres d'outils dans le menu Affichage.

11.6 Barre d'outils Favoris


La barre d'outils Favoris contient une liste droulante de tous les favoris du document et offre un autre moyen de modifier les favoris. Lorsque vous aurez slectionn un favori, son nom s'affichera dans la zone droulante jusqu' ce que les slections ou les valeurs des variables soient modifies. Ajouter un favori Enregistre la slection active comme favori.

Supprimer le favori Supprime le favori slectionn dans le menu droulant.

11.7 Personnaliser (les barres d'outils)


La bote de dialogue Personnaliser permet aux utilisateurs de configurer les barres d'outils comme ils le souhaitent. (C'est en gnral une fonction trs pratique, mais dans certaines situations, le concepteur du document peut souhaiter imposer un rglage standard appliquer tous les utilisateurs du document. Voir Personnaliser les barres d'outils QlikView lors de grands dploiements (page 79).) Il existe en fait deux types de barres d'outils personnalisables: celles qui sont dj dfinies (c'est--dire nommes) dans QlikView, et celles qui peuvent tre cres de toutes pices en fonction des besoins. La bote de dialogue Personnaliser se compose des trois onglets, Barres d'outils, Commandes et Options dcrits ci-dessous:

76

Barres d'outils

Bote de dialogue Personnaliser, Barres d'outils

Cet onglet contient une liste de toutes les barres d'outils disponibles en plus de la barre de menus. Activez/dsactivez les barres d'outils en cochant ou en dslectionnant la case correspondante dans la liste. Nouveau Renommer Cre une nouvelle barre d'outils. Renomme la barre d'outils en surbrillance. Cette commande n'est pas disponible pour les cinq barres d'outils par dfaut. Supprime la barre d'outils en surbrillance. Cette commande n'est pas disponible pour les cinq barres d'outils par dfaut. Rinitialise la configuration de la barre d'outils en surbrillance sur les paramtres par dfaut.

Supprimer

Rinitialiser

77

Commandes

Bote de dialogue Personnaliser, Commandes

Comme l'instruction de l'onglet Commandes l'explique, il suffit, pour ajouter une commande une barre d'outils ou en supprimer une, de la glisser du volet Commandes la barre d'outils voulue ou vice versa. La barre d'outils modifie doit videmment tre dfinie sur le mode d'affichage dans l'onglet Barres d'outils. l'aide du volet Catgories, il est possible de limiter les commandes rpertories au contenu d'un seul menu QlikView la fois.

Options

78

Bote de dialogue Personnaliser, Options

L'onglet Options contient des paramtres supplmentaires pour la personnalisation: dans la section Menus et barres d'outils personnaliss, il est possible de dfinir si des menus plus courts avec seulement les commandes les plus courantes doivent tre utiliss. Toujours afficher les menus dans leur intgralit Dsactivez cette option pour utiliser des menus plus courts avec uniquement les commandes les plus courantes. Afficher les menus entiers aprs un court dlai Si vous utilisez les menus courts, activez ce paramtre pour afficher les menus dans leur intgralit aprs avoir plac le curseur de la souris dessus.

Rinitialiser les donnes Cette commande efface les enregistrements des commandes utilises dans une d'utilisation des menus et application et restaure l'ensemble de commandes visibles par dfaut des menus et des barres d'outils des barres d'outils. Elle n'annule pas les personnalisations explicites. Les options d'affichage suivantes ont t regroupes sous Autre: Grandes icnes Ce rglage rend les icnes de barres d'outils deux fois plus grandes, amliorant au besoin leur visibilit. Cette option active ou dsactive les info-bulles.

Afficher les info-bulles sur les barres d'outils Afficher les touches de raccourci dans les infobulles Animations de menus :

Cette option ajoute les raccourcis aux informations affiches dans les fentres contextuelles.

Ce paramtre concerne la faon dont les menus (et les menus en cascade) s'ouvrent. En plus du rglage Valeurs systme par dfaut, un certain nombre d'animations personnalises sont disponibles dans la liste droulante.

Personnaliser les barres d'outils QlikView lors de grands dploiements


Activation et dsactivation de la personnalisation interactive des barres d'outils
QlikView 7 a introduit les barres d'outils et menus entirement personnalisables. Cette personnalisation interactive peut tre active ou dsactive au moyen de deux paramtres dans Settings.ini. Le fichier ini se trouve dans le rpertoire C:\Users\username\AppData\Roaming\QlikTech\productname sous Windows Vista et Windows 7. Sur les systmes plus anciens, il se trouve dans C:\Documents and Settings\username\Application Data\QlikTech\productname.

AllowCustomizeToolbars et AllowCustomizeMenubar La valeur 1 active la personnalisation interactive tandis que la valeur 0 l'empche. Remarque: Avant de modifier ces paramtres, assurez-vous que l'application est ferme.

Mise en uvre de paramtres de barres d'outils sur un grand nombre d'ordinateurs


Pour copier les paramtres de barres d'outils d'un ordinateur sur l'autre:

79

1. Personnalisez les barres d'outils sur un ordinateur. 2. Copiez le fichier Settings.ini. Remarque: Les versions QlikView des ordinateurs source et cible doivent tre les mmes pour garantir un fonctionnement optimal.

11.8 Barre d'tat


La barre d'tat se trouve sous la feuille. Choisissez Affichage et Barre d'tat pour activer ou dsactiver cette option. Des informations intressantes y sont affiches : Plusieurs dtails peuvent apparatre gauche de la barre d'tat : le texte Prt s'affiche parfois lorsque QlikView est prt pour des slections ; si le curseur est dplac sur un graphique, les coordonnes s'affichent. On peut aussi obtenir de l'aide gauche de cette barre d'tat. Lorsqu'on clique sur une commande ou sur un bouton sans relcher le bouton de la souris, l'aide s'affiche. Si on dplace le curseur de la souris avant de relcher le bouton de la souris, la commande ne sera pas excute. Le milieu de la barre d'tat donne une marque horaire. Elle indique quel moment a t excut le dernier rechargement de donnes. Un indicateur AND apparat si l'objet actif est en mode and. droite de la barre d'tat est prsent, prcd d'un D, le nombre de valeurs facultatives (ou slectionnes) distinctes sur le nombre total de valeurs distinctes de la liste de slection active. Encore plus droite, la frquence du champ actif apparat prcde d'un F. Elle indique le nombre d'enregistrements de la table o le champ se produit pour la premire fois sur le nombre total d'enregistrements. Enfin, la barre d'tat possde galement un indicateur de slections. Il sera vert si des slections effectues ne sont pas visibles sur la feuille active.

80

12 Prfrences utilisateur
Les prfrences utilisateur sont les paramtres qui grent la faon de travailler de l'utilisateur. Elles sont stockes sur l'ordinateur et non dans le fichier du document.

12.1 Prfrences utilisateur: Gnral

Prfrences utilisateur, Gnral

Afficher les champs systme Afficher les variables systme Utiliser les sons Supprimer les bitmaps inutiliss

Si cette case est slectionne, les Champs systme (page 395) seront inclus par dfaut dans toutes les listes de noms de champs. Si cette case est slectionne, les variables systme seront incluses par dfaut dans toutes les listes de variables. Active les effets sonores incorpors QlikView. Les bitmaps utiliss dans les feuilles et les objets sont normalement conservs dans le document, mme si leur utilisation est dsactive. Cochez cette option pour qu'ils soient automatiquement supprims.

Brouiller les informations Cochez cette option afin que l'assistant d'instruction connect masque les d'identification utilisateur instructions connect en cryptant l'ID utilisateur et le mot de passe.

81

Mmoriser les informations d'identification de connexion jusqu' la fermeture de QlikView Bloquer l'excution des macros l'aide de la touche Maj

QlikView peut mettre en cache l'ID utilisateur et le mot de passe pour tous les documents QlikView ncessitant une connexion qui ont t ouverts pendant une session QlikView. Si cette option est dslectionne, l'utilisateur est invit se connecter chaque rouverture d'un document.

Ce paramtre permet l'utilisateur d'empcher l'excution de toute macro l'ouverture en maintenant la touche MAJ enfonce pendant l'ouverture d'un document QlikView.

Conserver la fentre de Cocher cette case permet de laisser ouverte la bote de dialogue Excution du progression ouverte aprs script en cours une fois le rechargement du script termin. le rechargement Barre de dfilement horizontale Si ce paramtre est activ, une barre de dfilement horizontale apparatra en bas de la feuille chaque fois que des objets ne pourront pas tenir entirement dans la fentre de l'application. Comme le paramtre prcdent, mais verticalement.

Barre de dfilement verticale

Redimensionner la Si cette option est coche, la taille de la fentre QlikView est dtermine par la fentre selon le document taille du document, c'est--dire la taille de la fentre QlikView au moment o le document a t enregistr. Conserver les tampons QVD orphelins Ce paramtre ignore la procdure normale de nettoyage automatique des Fichiers QVD (page 425) crs aprs l'excution du script, condition que le document qui les a crs ne soit plus disponible. Normalement, cette case ne doit pas tre coche.

Vider le journal de script Normalement, le journal de script n'est pas crit sur le disque aprs chaque aprs chaque criture instruction pour des raisons de performances. Si cette case est coche, il le sera. Cela peut s'avrer utile si vous utilisez d'autres programmes pour surveiller l'excution du script l'aide du journal. Cependant, ce paramtre permet d'optimiser la dure d'excution du script lorsque celui-ci contient de nombreuses instructions. Rouvrir la bote de dialogue de script aprs l'excution du script Si le script est excut partir de la bote de dialogue dition du script et que cette case est coche, la bote de dialogue sera rouverte aprs l'excution du script.

Montrer l'assistant "Mise Ouvre l'Assistant Mise en route, lequel vous guide tout au long des tapes de en route" la cration de cration d'un document bas sur une seule feuille Excel. nouveaux documents Purger les tampons QVD Cliquez sur ce bouton pour effectuer un nettoyage manuel des tampons QVD orphelins orphelins qui ont t conservs l'aide du paramtre Conserver les tampons QVD orphelins ci-dessus.

82

Fichiers rcemment utiliss

Ce groupe sert contrler la liste des fichiers QlikView ouverts rcemment, qui se trouve dans le menu Fichier et dans la Page de dmarrage. L'option Dans le Menu permet d'indiquer le nombre de fichiers rcents afficher dans le menu Fichier. Par dfaut, ce nombre est de 8. Sous l'option Sur la Page de dmarrage, il est possible de modifier le nombre de fichiers rcemment utiliss dans la Page de dmarrage. Par dfaut, ce nombre est de 64. Les modifications ne prendront effet qu'aprs le redmarrage. Si l'option Afficher le chemin complet dans le menu est coche, le menu Fichier sera largi autant que ncessaire pour afficher les chemins complets dans la liste des fichiers rcemment utiliss. Cliquer sur le bouton Supprimer les URL supprimera toutes les URL de la liste des fichiers rcemment utiliss. Dans ce groupe, il est possible de dfinir le jeu de caractres du fichier journal. Le paramtre par dfaut est ANSI, mais vous pouvez aussi cocher l'option Unicode.

Encodage du journal

Aspect de la slection

Style de slection prfr Dfinit le style de slection par dfaut. QlikView prend en charge un grand nombre de prsentations diffrentes des donnes et de possibilits de slections dans les listes de slection et les listes multiples. Les styles QlikView classique, Balise d'angle, Voyant et Cases cocher de voyant utilisent tous le codage couleur pour signaler les valeurs slectionnes, possibles et exclues. Les styles Cases cocher Windows et Cases cocher de voyant imitent l'interface Windows standard en associant une case cocher chaque valeur. Ce comportement par dfaut peut tre ignor pour un document particulier au moyen d'un paramtre correspondant configur sous Proprits du document: Gnral (page 440)). Il existe des restrictions relatives au comportement de certains dclencheurs de macro dans les documents sur le serveur QlikView. Vous trouverez des informations complmentaires sur les styles de slection la section Styles de slection du manuel de rfrence de QlikView.Vous trouverez des informations complmentaires sur les styles de slection la section Styles de slection (page 114). Jeu de couleurs de slection prfr Dfinit le jeu de couleurs de slection par dfaut. Lorsqu'on utilise les styles de slection base de couleurs, un certain nombre de jeux de couleurs diffrents sont disponibles. Il est impossible de modifier le Jeu de couleurs (page 113) (vert pour les valeurs slectionnes, bleu pour les valeurs verrouilles, etc.), mais des variations de ton et d'intensit sont possibles. Ce comportement par dfaut peut tre ignor pour un document particulier au moyen d'un paramtre correspondant configur sous Proprits du document: Gnral (page 440)).
Appuyez sur ce bouton pour ouvrir la bote de dialogue Slectionner la langue de l'interface. Dans cette bote de dialogue, vous trouverez toutes les versions linguistiques de QlikView disponibles sur l'ordinateur. (Les diffrentes versions linguistiques sont incluses sous forme de fichiers .dll au moment de l'installation.) Si vous changez de langue, vous devez redmarrer QlikView pour que la modification soit prise en compte. Cette modification concerne la fois la langue de l'interface utilisateur et la langue de l'aide en ligne, condition que les fichiers d'aide appropris soient galement disponibles sur votre ordinateur.

Changer de langue d'interface

83

Dure d'affichage des info-bulles de favoris (sec.)

Cochez cette option et saisissez une dure pour que les fentres contextuelles des favoris se ferment automatiquement aprs un certain nombre de secondes.

Utiliser WebView dans la Permet d'afficher ou de masquer le mode WebView, lequel utilise le navigateur disposition Web interne de QlikView pour prsenter la disposition du document sous forme de page AJAX. Paramtres de recherche Ce groupe permet de configurer les paramtres du mode de recherche par dfaut. Inclure les valeurs exclues dans la recherche La recherche textuelle peut tre interprte de deux manires: soit vous cherchez uniquement parmi les valeurs facultatives, soit vous cherchez parmi toutes les valeurs, c'est--dire que vous incluez les valeurs exclues dans la recherche. Activez cette option pour la deuxime possibilit. Cette valeur par dfaut peut tre outrepasse au niveau de l'objet. Mode de recherche prfr Le mode de recherche par dfaut pour les listes de slection, les listes multiples, etc. peut tre dfini dans cette zone droulante. Le rglage par dfaut ne s'applique que lorsque l'utilisateur commence taper directement et qu'il n'utilise pas les menus ou les raccourcis clavier pour commencer la recherche. Il est possible d'ignorer ce paramtre en en slectionnant un autre au niveau de l'objet de la feuille.

Dernier mode utilis Mode utilis pour la dernire recherche effectue. Utiliser la recherche par caractres gnriques La chane de recherche initiale se compose de deux caractres gnriques spar par le curseur pour faciliter ce type de recherche. Recherche partielle La chane de recherche initiale se compose d'un tilde (~) pour signaler une recherche partielle. Recherche classique Aucun caractre supplmentaire ne sera ajout la chane de recherche. Une recherche classique est effectue sans caractres gnriques.
Nombre max. de valeurs Indiquez ici le nombre maximum de valeurs slectionnes distinctes afficher dans les slections actives dans la bote de dialogue des slections actives et dans les slections actives imprimes. Lorsque davantage de valeurs sont slectionnes, elles sont seulement signales par x valeurs sur y pour chaque champ.

84

Limites d'utilisation Mmoire (%)

Cette commande dfinit les quantits physiques minimale et maximale de mmoire vive pouvant tre utilises par une application. Il est ainsi possible de contrler si une application peut effectuer des changes mmoire-disque ou non. Il n'existe cependant aucune garantie que le systme d'exploitation puisse fournir au processus la quantit de mmoire dfinie ici. L'utilisation de paramtres trop levs dgradera les performances des autres processus de l'ordinateur, ce qui peut, cependant, s'avrer souhaitable si l'ordinateur est ddi QlikView. Ne modifiez pas ces paramtres moins d'tre familiers du gestionnaire de mmoire virtuelle de Windows! Pour en savoir plus sur les paramtres d'excution, consultez la documentation Microsoft Windows. Les paramtres sont les suivants: Min dfinit la quantit minimale de mmoire, en pourcentage, attribuer l'application/au processus. Max dfinit la quantit maximale de mmoire, en pourcentage, attribuer l'application/au processus. Cache dfinit la quantit de mmoire, en pourcentage, utiliser comme cache pour l'application/le processus.

12.2 Prfrences utilisateur: Enregistrer


Cet onglet contient des paramtres pour l'enregistrement de documents QlikView.

Prfrences utilisateur, Enregistrer

Format d'enregistrement Vous pouvez dfinir ici un format d'enregistrement par dfaut pour tous les prfr nouveaux fichiers. Pour appliquer les modifications au document actif uniquement, slectionnez un Format d'enregistrement sous Proprits du document: Gnral (page 440) la place.

85

Compression Cette liste droulante prcise le mode de compression d'enregistrement des nouveaux documents. Grce la compression, la taille du fichier est en thorie rduite d'environ 60-80% (les rsultats rels peuvent varier d'un document l'autre). Par contre, les dures d'enregistrement du document augmentent lgrement. Avec la compression Moyenne, toutes les parties du document, l'exception des donnes de la table (qui sont dj considrablement compresses dans QlikView), subiront une compression. Avec la compression Haute (par dfaut), les donnes de la table sont aussi compresses, ce qui conomise de l'espace mais augmente encore les dures d'enregistrement et de chargement. Si vous choisissez Aucune, toutes les donnes sont enregistres sans compression.
Enregistrer avant de recharger Cochez cette option pour que le document soit automatiquement enregistr avant que le script ne soit excut.

Enregistrer les Vous pouvez spcifier ici les rgles de cration d'une copie de sauvegarde du informations de fichier QlikView actif. Cette fonction d'enregistrement automatique est trs utile rcupration automatique en cas de panne du systme. Vous pouvez demander indpendamment au programme d'effectuer un enregistrement automatique intervalles rguliers (Toutes les _ minutes) et chaque fois que le script est excut (Aprs le rechargement).
Remarque: Aucun fichier de rcupration automatique ne sera enregistr pour un nouveau document avant que l'utilisateur ne l'enregistre et lui donne un nom de document.

Utiliser une copie de sauvegarde

Vous pouvez spcifier ici les rgles de conservation des copies plus anciennes cres par la fonction d'enregistrement automatique. Si la case Utiliser une copie de sauvegarde est coche, vous pouvez indiquer le nombre de versions de sauvegarde conserver (Conserver les _ dernires instances) et le programme peut aussi conserver une slection des anciennes versions prfres (Conserver les anciennes instances slectionnes).

12.3 Prfrences utilisateur: diteur

86

Prfrences utilisateur, diteur

Dans cette bote de dialogue, il est possible de dterminer des prfrences personnelles pour le texte dans les diteurs QlikView. Il s'agit des diteurs de la bote de dialogue Bote de dialogue diter le script (page 185) (Script), de la bote de dialogue Bote de dialogue diter l'expression (page 813) (Expression dans le graphique) ainsi que de l'diteur de macro de la bote de dialogue diter le module (page 963) (Module). On peut ici dfinir ses prfrences concernant la police, la taille de police, le style et la couleur pour un certain nombre de Types de texte diffrents qui peuvent tre mis en surbrillance dans la zone de texte.

Script et expressions
Texte standard Mots-cls Texte qui n'appartient aucune des catgories dcrites ci-dessous. Mots-cls utiliss dans le script (dcrits la section Instructions de script et mots-cls (page 239)), par ex. load, select, directory, semantic, etc. Commentaires taps dans le script ou le graphique. Erreurs que QlikView dtecte dans le script ou l'expression de graphique. Lorsqu'on approche le curseur d'une parenthse dans le script, la parenthse ainsi que les virgules qu'elle contient sont mises en surbrillance. Des parenthses ou des virgules manquantes sont ainsi facilement dtectables. Noms des champs charger et utiliser dans les graphiques. Texte charger littralement, c'est--dire comme chane textuelle (habituellement encadre de guillemets simples). Pour en savoir plus sur la diffrence entre noms de champs et littraux, voir Guillemets (page 305). Fonctions utilises dans le script (dcrites la section Fonctions d'agrgation (page 310)), par ex. div, left, if, num, etc. et dans les graphiques. Nom du fichier o les champs ont t rcuprs. Variables utilises dans le script. Pour plus d'informations sur les variables, voir Variables de script (page 296). Fonctions d'agrgation utilises dans l'expression (dcrites la section Fonctions d'agrgation (page 310)), par ex. sum, min, max, etc. Oprateurs utiliss dans le script (dcrits sous Oprateurs (page 849)), par ex. +, like, etc. et dans les expressions. tiquettes attribues des tables donnes. Pour plus d'informations, voir Noms des tables (page 295). Identificateurs, modificateurs et oprateurs d'analyse d'ensembles utiliss dans l'expression (dcrits la section Analyse d'ensembles (page 883)).

Commentaires Erreur Texte en surbrillance

Noms des champs Littraux

Fonctions

Noms des fichiers Macro script

Fonctions d'agrgation

Oprateurs

tiquettes de table

Analyse d'ensembles

87

Module
Texte standard Mots-cls Texte en surbrillance Texte qui n'appartient aucune des catgories dcrites ci-dessous. Mots-cls rservs au script Visual Basic. Lorsqu'on approche le curseur d'une parenthse dans le script, la parenthse ainsi que les virgules qu'elle contient sont mises en surbrillance. Des parenthses ou des virgules manquantes sont ainsi facilement dtectables.

Expression dans le graphique


Texte standard Commentaires Erreur Texte qui n'appartient aucune des catgories dcrites ci-dessous. Commentaires saisis dans l'expression de graphique. Erreurs que QlikView dtecte dans l'expression, par exemple une parenthse manquante. Lorsqu'on approche le curseur d'une parenthse dans l'expression, la parenthse ainsi que les virgules qu'elle contient sont mises en surbrillance. Il est ainsi trs facile d'identifier des parenthses ou des virgules manquantes. Noms des champs utiliss. Noms de fonctions standard de QlikView pour les expressions de graphiques. Nom du fichier o les champs ont t rcuprs. Fonctions d'agrgation utilises dans l'expression (dcrites la section Fonctions d'agrgation, pages 310 et suivantes), par ex. sum, min, max, etc. Oprateurs utiliss dans l'expression (dcrits sous Oprateurs, pages 307 et suivantes), par ex. +, like, etc. Identificateurs, modificateurs et oprateurs d'analyse d'ensembles utiliss dans l'expression (dcrits la section Analyse d'ensembles, pages365 et suivantes).

Texte en surbrillance

Noms des champs Fonctions Nom du fichier Fonctions d'agrgation

Oprateurs

Analyse d'ensembles

Police par dfaut applicable tous les types La police et la taille de police slectionnes dans ce groupe s'appliqueront tous les types de texte. Les proprits telles que le gras, l'italique et le soulignement peuvent tre dfinies sparment l'aide des cases cocher.
Cliquez sur le bouton Couleur de premier plan pour afficher une palette de couleurs dans laquelle vous pouvez slectionner une couleur prdfinie ou dfinir une couleur de premier plan personnalise. Pour rinitialiser les valeurs par dfaut, cliquez sur le bouton Valeurs par dfaut. Les caractristiques suivantes peuvent aussi tre utilises dans les diteurs:

88

Info-bulle d'aide sur la fonction

Cochez cette option pour qu'une petite fentre contextuelle apparaisse lors de la saisie d'une fonction.

Mmoriser la position du Cochez cette option pour que les diteurs du script et de macro mmorisent la curseur position du curseur lorsque vous quittez l'diteur. Si cette option n'est pas utilise, le curseur sera positionn au dbut du module de macro et la fin du script. Copier au format RTF Cochez cette option pour copier du texte d'une fentre d'diteur dans le Pressepapiers, non seulement sous forme de texte seul mais aussi au formatRTF. Cela permet de coller le texte avec tout son formatage dans des applications prenant en charge le format RTF.

12.4 Prfrences utilisateur: Conception

Prfrences utilisateur, Conception

Dans le groupe Raccourcis de script et de macro, vous pouvez personnaliser les raccourcis clavier lis certaines actions dans la bote de dialogue de dbogage du script. Gnrez une liste de tous les raccourcis clavier dans le script en tapant CTRL+QS dans ce dernier. diter Slectionnez une commande dans la liste et cliquez sur le bouton Modifier... pour personnaliser le raccourci clavier de cette commande.

Il existe deux Mappage des touches facultatifs: Visual Basic Les raccourcis clavier correspondront aux valeurs par dfaut habituelles de l'environnement de dbogage Visual Basic.

89

Visual C++

Les raccourcis clavier correspondront aux valeurs par dfaut habituelles de l'environnement de dbogage Visual C++.

Toujours utiliser des journaux pour les nouveaux documents

Un fichier journal (.log) sera gnr quand le script sera excut. Ce fichier contiendra un horodateur indiquant le dbut et la fin de l'excution, les lignes de script excutes, le nombre de lignes gnres par les lignes de script et, si l'excution n'a pas fonctionn, un message d'erreur.

Taille de l'chantillon de Indique le nombre d'enregistrements lus dans l'assistant Fichier de tables afin l'assistant Fichier (lignes) d'analyser la table en cours de lecture. Moteur de script par dfaut Paramtres de la grille de conception Choisissez entre VBScript et JScript.

Intervalle d'alignement (mm) Fixe la distance entre les points d'accrochage quand la grille de conception est affiche. Distance entre les lignes (mm) Fixe la distance entre les lignes de la grille de conception quand celle-ci est affiche.
Vous pouvez slectionner ici l'unit par dfaut des marges dans la page Imprimer: Disposition; elles peuvent tre en cm ou en pouces. Slectionnez l'un des modes disponibles pour le style de tous les objets de feuille. Le mode slectionn sera utilis par dfaut pour tous les nouveaux documents. Choisissez dans cette liste droulante un des styles disponibles pour les objets de la feuille. Le style slectionn est appliqu tous les objets de la feuille dans le document. Vous pouvez slectionner ici le thme QlikView dfini par dfaut pour tous les nouveaux documents. Le thme slectionn doit tre accessible partir du disque tout moment pour pouvoir l'utiliser. Il est galement important que le thme utilis soit dfini pour tous les types d'objet prsents dans le document QlikView. Au bas de la liste droulante, vous pouvez slectionner l'option Parcourir... si le fichier du thme se trouve un autre emplacement que le catalogue de thmes QlikView par dfaut. Si aucun thme par dfaut n'est spcifi, les nouveaux documents seront crs sans thme par dfaut. Si cette case est coche, toutes les options du menu de conception seront toujours disponibles dans le menu contextuel. Si cette case n'est pas coche, certaines options du menu sont disponibles uniquement lorsque la commande Grille de conception du Menu Affichage (page 62) est active.

Unit par dfaut des marges Style des objets par dfaut

Style par dfaut des objets de feuille

Thme par dfaut

Toujours afficher les lments de menu Conception

90

12.5 Prfrences utilisateur: Objets

Prfrences utilisateur, Objets

L'utilisateur peut configurer ici un certain nombre de paramtres par dfaut pour les objets. Activer tous les messages Lorsque QlikView est install pour la premire fois sur un ordinateur, un certain de confirmation nombre de botes de dialogue d'avertissement sont actives. Elles invitent l'utilisateur confirmer l'excution de certaines actions, telles que la suppression de feuilles et d'objets ou l'envoi d'e-mails. Chaque bote de dialogue d'avertissement comprend la case cocher: Ne plus afficher ce message. Si vous cochez cette case, la bote de dialogue concerne sera suspendue dfinitivement. Pour ractiver tous les avertissements dsactivs, cliquez sur le bouton Activer de ce groupe. Valeurs par dfaut de la Afficher les indicateurs de slection table Slectionnez cette option si vous souhaitez activer l'indicateur (le signal) de slection par dfaut dans les nouvelles zones table, les tableaux croiss dynamiques et les tableaux simples.

Afficher l'indicateur de tri Slectionnez cette option pour afficher une icne indiquant par dfaut la colonne de tri principale des nouvelles zones table et des tableaux simples. Slections via menu droulant Slectionnez cette option pour afficher une icne de liste droulante dans les nouvelles zones table, les tableaux croiss dynamiques et les tableaux simples.

91

tiquette par dfaut du secteur "Autres"

Dans certains types de graphiques, il est possible de limiter le nombre de points de donnes tracs en fixant une valeur Max. Toutes les points de donnes qui dpassent cette limite sont alors regroups dans un secteur Autres. Vous pouvez modifier ici l'tiquette par dfaut Autres. Les totaux qui peuvent tre affichs dans les histogrammes, les tableaux croiss dynamiques et les tableaux simples portent par dfaut l'tiquette Total. Vous pouvez modifier ici l'tiquette par dfaut Total. Dans ce groupe, il est possible de dfinir les valeurs par dfaut des icnes de lgende slectionnes. Inclure l'icne de recherche dans les lgendes des nouvelles listes de slection Lorsque cette case est coche, l'icne Rechercher est active dans la lgende lors de la cration de toutes les listes de slection. Il est recommand de cocher cette case pour faciliter l'utilisation des listes, en particulier si le document doit tre publi pour le client AJAX QlikView. Inclure les icnes d'impression et XL des nouveaux graphiques et tables Lorsque cette case est coche, les icnes Imprimer et Envoyer vers Excel sont actives dans la lgende lors de la cration des tableaux et des graphiques. Il est recommand de cocher cette case pour faciliter l'utilisation des listes, en particulier si le document doit tre publi pour le client AJAX QlikView.

tiquette par dfaut du secteur "Total"

Icnes de lgende par dfaut

Conserver la position de Lorsque ce paramtre est activ, QlikView tente de conserver la position de dfilement l'ascenseur dans les tables et les graphiques dots d'une barre de dfilement sur l'axe x quand une slection est effectue dans un autre objet. Ce paramtre doit galement tre activ sur la page Disposition des objets. Nombre max. de symboles dans les graphiques Il est possible de spcifier une limite suprieure au nombre de points de donnes afficher avec des symboles. La valeur par dfaut est de 100. Cette fonction n'est utile que dans les courbes et les combins et concerne les expressions pour lesquelles les cases Ligne et Symbole sont toutes deux coches.

Un clic sur l'arrire plan Si cette option est coche, toutes les slections dans les champs de dimensions du graphique efface la du graphique sont effaces lorsqu'on clique sur l'arrire-plan de la zone de trac slection du graphique. Informations sur la progression du calcul Dans ce groupe, il est possible de dterminer le niveau des informations afficher lorsque le calcul d'objets requiert plus d'une seconde.

Dsactiv Aucune information sur la progression du calcul n'est affiche. Standard Une barre de progression s'affiche. Infos dtailles Une barre de progression s'affiche accompagne d'informations sous forme de texte.

92

12.6 Police

Bote de dialogue Police

On peut dfinir ici la Police, le Style de police et la Taille de police utiliser. On peut dfinir la police pour un seul objet (Proprits de l'objet: Police) ou tous les objets d'un document (Appliquer aux objets sur Proprits du document: Police). Les polices par dfaut du document des nouveaux objets peuvent galement tre dfinies dans Proprits du document: Police. Il existe deux polices par dfaut: 1. La premire police par dfaut (Listes de slection, Graphiques, etc.) est utilise pour la plupart des objets, notamment les listes de slection et les graphiques. 2. La deuxime police par dfaut (Objets Texte et Boutons) est utilise pour les boutons et les zones de texte, objets qui ncessitent gnralement une police plus grande. Enfin, les polices par dfaut des nouveaux documents peuvent tre dfinies dans l'onglet Prfrences utilisateur: Police. Pour les graphiques, les boutons et les objets texte (sauf les objets de recherche), vous pouvez aussi spcifier une Couleur de police. La couleur peut tre Fixe (cliquez sur le bouton color pour indiquer une autre couleur) ou Calcule de faon dynamique par une expression. L'expression doit tre une reprsentation de couleur valide, cre l'aide des Fonctions de la catgorie Couleur (page 389). Si le rsultat de l'expression n'est pas une reprsentation de couleur valide, le police est noire par dfaut. Les paramtres supplmentaires sont: Ombre porte Souligner Si cette option est coche, une ombre sera ajoute au texte. Si cette option est coche, le texte sera soulign.

Un chantillon de la police slectionne est prsent dans le volet d'aperu.

93

12.7 Prfrences utilisateur: Exporter

Prfrences utilisateur, Exporter

Le groupe Copie dans le Presse-papiers contient les prfrences concernant la copie d'objets dans le Pressepapiers. Dans le groupe Inclure la lgende et la bordure, vous pouvez indiquer sparment les prfrences de chacun des types d'objets suivants: Liste de slection, Zone de statistiques, Liste multiple, Zone table, Zone de saisie, Zone de slections actives et Graphique, si ces fonctions de disposition doivent tre incluses ou non dans la copie. Il est possible de dfinir une prfrence de copie des tables sous Format de copie de table. partir de la commande Copier dans le Presse-papiers du menu Objet de toute table QlikView, il est possible d'effectuer d'autres choix concernant les informations inclure lors de l'exportation. Table complte Si vous choisissez cette option, c'est la table formate complte avec l'tat de ses slections qui est copie. Ce paramtre est prfrable lorsque la copie est destine des fins de prsentation. Si vous slectionnez cette option, la copie ne contiendra que les donnes brutes. C'est le paramtre recommand pour dplacer rapidement des donnes d'un document l'autre, etc.

Zone de donnes uniquement

Afficher les options dans Si vous choisissez cette option, les deux possibilits seront toujours disponibles le menu sous forme de liste droulante partir de la commande Copier dans le Pressepapiers.

Dans le groupe Remplacer l'image par dfaut, vous pouvez indiquer les lments placer dans le Pressepapiers lorsqu'on utilise les commandes Couper et Copier (menu dition). Normalement, seule l'image bitmap d'un objet est copie, mais d'autres options sont disponibles pour certains objets:

94

Tables copies dans une table

Cochez cette option pour que les tables (zones Table, tableaux simples et tableaux croiss dynamiques) soient copies sous forme de table plutt que sous forme d'image. Cochez cette option pour que ce soit les valeurs des tables sous-jacentes qui soient copies plutt qu'une image des graphiques.

Valeurs des graphiques

Valeurs possibles pour les Cochez cette option pour que ce soit les valeurs possibles qui soient copies listes de slection plutt qu'une image des listes de slection. Texte des boutons Cochez cette option pour que les boutons soient copis sous forme de texte plutt que sous forme d'image. Cochez cette option pour que les objets Texte soient copis sous forme de texte plutt que sous forme d'image.

Texte des objets texte

Slections pour la zone de Cochez cette option pour que les zones de slections actives soient copies sous slections actives forme de texte plutt que sous forme d'image. Le paramtre Zoom du Presse-papiers, qui est indpendant du rglage actuel du zoom de la feuille, dtermine la taille de l'image copie. Les images plus grandes ont une meilleure qualit d'image au dtriment de la taille du fichier. Dans le groupe Exportation des slections actives, vous pouvez dterminer si les slections actives doivent tre incluses lors de l'exportation vers les types de fichiers indiqus. Exportations HTML Cochez cette case pour inclure les slections actives lors de l'exportation vers des fichiers HTML. Cochez cette case pour inclure les slections actives lors de l'exportation vers des fichiers BIFF (Excel).

Exportations BIFF

Dans le groupe Options d'exportation par dfaut, vous pouvez dfinir des valeurs de formatage par dfaut pour l'exportation.

95

Formatage des nombres Le formatage des donnes numriques de QlikView n'est pas toujours compatible avec d'autres programmes en raison de paramtres dfinis par l'utilisateur, etc. Le menu droulant propose trois choix sous Formatage des nombres, applicables aux donnes numriques exporter.

Formatage complet Exporte les donnes numriques avec leur format de nombre complet, exactement tel qu'il apparat dans les objets de feuille du document. Pas de sparateur des milliers Supprime le sparateur des milliers des donnes numriques. Cette option est recommande si les donnes doivent tre importes dans MS Excel. Aucun formatage Supprime tout le formatage des nombres des donnes exportes. Le sparateur dcimal sera celui dfini dans les paramtres systme (via le Panneau de configuration).
Encodage Vous pouvez dfinir le jeu de caractres par dfaut exporter dans de nouveaux documents. Choisissez l'une des options suivantes: ANSI, Unicode ou UTF-8.

Dans le groupe Options d'envoi vers Excel, vous pouvez dfinir les valeurs par dfaut qu'utilisera la commande de menu Envoyer vers Excel pour le formatage. Utiliser les paramtres rgionaux pour l'envoi vers Excel Grce cette option, les paramtres rgionaux du systme d'exploitation sont utiliss pour dfinir le sparateur dcimal lorsque la commande Envoyer vers Excel est utilise pour exporter des donnes. Lorsque cette case est coche, MicrosoftExcel risque de ne pas interprter les donnes numriques correctement. Si l'on dcoche cette option, un point sera utilis comme sparateur dcimal, quels que soient les paramtres rgionaux. Si cette case n'est pas coche, les couleurs standard de la palette Excel remplacent les couleurs slectionnes dans QlikView. Les couleurs d'origine sont remplaces par les couleurs les plus proches de la palette standard.

Adapter la palette d'Excel aux couleurs de l'exportation

96

12.8 Prfrences utilisateur: Impression

Prfrences utilisateur, Impression

Dans le groupe Couleurs du graphique, vous pouvez dcider d'outrepasser un rglage pour toutes les impressions de graphiques. Vous pouvez slectionner un des trois autres paramtres suivants : Utiliser les paramtres du Les paramtres intrinsques du graphique concernant la couleur ou le noir et graphique blanc seront toujours utiliss. Forcer la couleur Tous les graphiques bitmap seront imprims en couleur, quels que soient les paramtres de Couleurs du document.

Forcer le remplacement Tous les graphiques bitmap seront imprims en noir et blanc, quels que soient les des couleurs par des paramtres de Couleurs du document. motifs

Lorsque vous imprimez des tables dont le contenu s'tend sur plusieurs pages, vous pouvez choisir ou non d'imprimer les lignes ou colonnes d'en-tte sur chaque page. Pour cela, utilisez le groupe Mode d'affichage des en-ttes dans les tables. Rpter les lignes d'entte Si cette option est coche, les lignes d'en-tte apparatront sur chaque page.

Rpter les colonnes d'en- Si cette option est coche, les colonnes d'en-tte (des tableaux croiss tte dynamiques) apparatront sur chaque page.

97

Dfinir les valeurs d'impression par dfaut des nouveaux objets

Ce bouton ouvre la bote de dialogue Mise en page o vous pouvez dterminer les marges et l'orientation de la page.

Ignorer le mode Postscript lors de l'impression (lent)

En raison de l'interaction entre les bibliothques de graphiques de Microsoft et certains pilotes d'imprimante Postscript, la nettet des impressions produites partir de la commande Imprimer la feuille peut parfois ne pas tre la hauteur de vos attentes. Pour viter cela, cochez cette option. Les temps d'impression pourront toutefois tre beaucoup plus longs (jusqu' plusieurs minutes).

12.9 Prfrences utilisateur: Messagerie

Prfrences utilisateur, Messagerie

L'utilisateur peut configurer dans cette zone les paramtres d'envoi des courriels partir de QlikView. Cette fonctionnalit requiert l'accs un serveur SMTP. Dans le groupe Expditeur, vous pouvez spcifier le nom et l'adresse lectronique qui apparatront comme expditeur sur le courriel envoy par QlikView. Sous Encodage, vous pouvez modifier la page de codes de caractres utilise pour envoyer le courriel, si vous avez des problmes avec le paramtre en vigueur. Cocher Envoyer encod en MIME pour encoder le courriel peut aussi permettre de rsoudre certains problmes. Dans le groupe Serveur, vous pouvez indiquer le serveur SMTP utiliser pour le courriel sortant de QlikView.

98

Adresse Port Mthode d'authentification ID utilisateur Mot de passe

Adresse (URL ou IP) du serveur SMTP. Port utilis par le serveur SMTP. Slectionnez une mthode d'authentification dans la liste, si l'authentification est requise par le serveur SMTP. ID utilisateur utilis pour l'authentification. Mot de passe utilis pour l'authentification.

12.10 Prfrences utilisateur: Emplacements

Prfrences utilisateur, Emplacements

L'utilisateur peut ici dterminer les emplacements par dfaut des dossiers pour certains fichiers crs par QlikView. Il peut galement dfinir des raccourcis pour les dossiers de fichiers de document pour QlikView Server et QlikView Publisher, et indiquer des URL vers les panneaux de configuration de QlikView Server, QlikView Publisher et QlikView AccessPoint. L'onglet contient une liste d'emplacements de ressources qui peuvent tre modifis. Le volet en haut de la bote de dialogue contient une liste d'emplacements de dossiers que l'on peut modifier:

99

Ressource

Les emplacements de ressource suivants peuvent tre modifis :

Tampons QVD Emplacement de stockage par dfaut des Fichiers QVD (page 425) gnrs par le prfixe buffered des instructions load et select du script. Thmes Emplacement de stockage par dfaut des thmes de disposition dfinis par l'utilisateur; voir Assistant Crateur de thmes (page 643). Fichiers utilisateur Emplacement par dfaut du dossier racine o se trouvent les dossiers qui stockent les favoris utilisateur, les rapports utilisateur et les alertes utilisateur. Si vous changez cet emplacement sans dplacer le contenu des dossiers, vous perdrez les favoris, les rapports et les alertes utilisateur existants. Documents stocks sur le serveur Vous pouvez indiquer ici l'emplacement du dossier de document du serveur QlikView, le cas chant. Documents Publisher Vous pouvez indiquer ici l'emplacement du dossier de document source QlikView Publisher, le cas chant. QlikView Management Console (URL) Vous pouvez spcifier ici une URL pointant sur la console QlikView Management Console, QMC ou la console QlikView Enterprise Management Console, QEMC, le cas chant. QlikView Server AccessPoint (URL) Vous pouvez spcifier ici une URL pointant sur QlikView AccessPoint, le cas chant. QlikView SDK (URL) Vous pouvez spcifier ici une URL pointant sur QlikView SDK, le cas chant. License Lease Server par dfaut (URL) Vous pouvez spcifier ici une URL pointant sur QlikView License Lease Server, le cas chant. Table d'autorisation Publisher (URL) Vous pouvez spcifier ici une URL pointant sur les tables d'autorisation d'accs la section cres dans QlikView Publisher. Pour plus d'informations sur la gestion des accs de section, consultez le manuel de rfrence du serveur QlikView.
Emplacement Rinitialiser Chemin vers les emplacements respectifs du dossier. Ce bouton rtablit l'emplacement par dfaut de QlikView pour le dossier slectionn. Le chemin affich dans la liste sera prcd du texte <Par dfaut>.

100

Modifier...

Lorsqu'une ressource de dossier est modifie, ce bouton ouvre la bote de dialogue Parcourir la recherche d'un dossier o vous pouvez localiser l'emplacement voulu pour le dossier slectionn. Lorsqu'une URL est modifie, ce bouton ouvre une bote de dialogue dans laquelle vous pouvez saisir une URL.

12.11 Prfrences utilisateur: Scurit

Prfrences utilisateur, Scurit

Dans cet onglet, vous pouvez choisir d'outrepasser une ou plusieurs mesures de scurit de QlikView vis-vis des macros et scripts hostiles imbriqus dans le document QlikView. Aucun avertissement invitant l'utilisateur accepter ou non un code potentiellement dangereux ne s'affichera. Utilisez ces options avec prcaution et uniquement quand vous travaillez avec des documents connus. Module (autoriser la cration d'objets et Cochez cette case pour dsactiver la recherche par QlikView de l'accs aux fichiers) macros contenant des appels de cration d'objet ou accdant des fichiers externes. Script (autoriser l'criture dans la base Cochez cette case pour dsactiver la recherche par QlikView de de donnes et l'excution d'instructions) scripts contenant la commande execute et le qualificatif mode is write dans les instructions select. Lancer (dmarrer des programmes et ouvrir des documents partir d'un bouton, script et module) Cochez cette case pour dsactiver la recherche par QlikView de lancements de programmes externes partir du script QlikView, du module ou de boutons.

101

Fichier (enregistrer le document, exporter les donnes vers des fichiers)

Cochez cette case pour dsactiver la recherche par QlikView d'enregistrements ou d'exportations vers des fichiers aux extensions suspectes.

Confirmer le lancement partir d'une moins que cette option ne soit dslectionne, l'utilisateur devra macro confirmer le lancement d'autres applications partir d'une macro. .

12.12 Prfrences utilisateur: Licence

Prfrences utilisateur, Licence

Licence QlikView
Cette bote de dialogue affiche les informations actuelles d'enregistrement de l'installation de QlikView.

Modifier... Pour saisir un nouveau numro de srie et un nouveau numro de contrle de la licence, cliquez sur ce bouton. Les modifications ne prendront effet qu'aprs le redmarrage de QlikView. Effacer les informations de licence Si vous cliquez sur ce bouton, le numro de licence sera effac lors du prochain dmarrage de l'application. Voir les droits de licence Pour afficher le contrat de licence, cliquez sur ce bouton.

ID des produits OEM


Cette option n'est disponible qu'avec une licence de partenaire OEM. Utiliser les ID de produits Activez cette question si la question de l'utilisation des ID de produits OEM doit OEM pour de nouveaux tre pose pour les nouveaux documents. documents

102

ID du produit OEM diter...

Rpertorie tous les ID des produits OEM disponibles. Cliquez sur ce bouton pour diter l'alias des ID du produit OEM.

103

104

13 Exportation et impression
13.1 Imprimer: Gnral
Sous cet onglet, vous pouvez dfinir les paramtres de l'imprimante et du papier. Vous pouvez dfinir d'autres paramtres d'impression dans les pages de proprits Imprimer: Disposition (page 106) et Imprimer: En-tte/Pied de page (page 108).

Imprimer, Gnral

Dans le groupe Imprimante figurent les imprimantes disponibles dans une liste droulante. Vous pouvez accder aux Proprits de l'imprimante en cliquant sur ce bouton. Dans le groupe Papier, on peut slectionner le Format et la Source (bac). D'autres options de cet onglet vous permettent de modifier l'orientation du papier, de spcifier l'tendue de pages imprimer et le nombre de copies, ainsi que les copies assembles ou non. Le groupe Format propose trois options d'chelle diffrentes: Mettre chelle _ % Cochez cette option et saisissez un pourcentage pour augmenterou diminuer l'chelle de l'impression.

Adapter aux pages 1 x 1 Cochez cette option pour que l'impression soit l'chelle du format du papier. Vous pouvez ventuellement obtenir un meilleur rsultat en modifiant l'Orientation. Adapter _ x _ pages Cochez cette option pour que l'impression soit l'chelle du nombre de pages spcifi.

Remarque si vous avez ouvert la bote de dialogue Imprimer par la commande Fichier: Imprimer la feuille, le groupe Taille n'est pas disponible, mais est remplac par le groupe Options des feuilles o vous pouvez dterminer si vous voulez imprimer uniquement cette feuille ou toutes les feuilles, et si vous voulez dfinir l'impression sur Dessiner l'arrire-plan (papier peint) au cours de l'impression.
Les boutons suivants sont aussi disponibles:

105

Enregistrer les paramtres

Cliquez sur ce bouton pour enregistrer vos rglages concernant l'en-tte et le pied de page et continuer travailler dans cette bote de dialogue.

Aperu avant impression Ce bouton ouvre une fentre qui affiche un Aperu avant impression (page 110) dtaill de l'objet imprimable actif. Imprimer Cliquez sur ce bouton pour lancer la commande d'impression et fermer cette bote de dialogue.

13.2 Imprimer: Disposition

Imprimer, Disposition

Sous cet onglet, les paramtres des options Imprimer la slection active et Marges peuvent tre dfinis. Vous pouvez dfinir d'autres paramtres d'impression dans les pages de proprits Imprimer: Gnral (page 105) et Imprimer: En-tte/Pied de page (page 108). Imprimer la slection active Dans le groupe Imprimer la slection active, vous pouvez inclure les slections actives l'impression. Le texte tat de la slection s'affichera l'impression, suivi d'une liste de champs et de valeurs de champs. Les options suivantes dterminent quelles pages les slections actives seront incluses: Sur la premire page, Sur toutes les pages - En haut des pages, Sur toutes les pages En bas des pages et Sur la dernire page. Dans cette zone d'dition, indiquez un texte imprimer avant l'objet. Ce texte peut tre une Formule calcule (page 939). Le bouton ... ouvre la bote de dialogue diter l'expression qui facilite l'dition des formules longues. Le bouton Police ct de la zone d'dition permet de slectionner une police spare pour le texte.

Texte du titre

106

Texte de fin

Dans cette zone d'dition, indiquez un texte imprimer aprs l'objet de feuille. Ce texte peut tre une Formule calcule (page 939). Le bouton ... ouvre la bote de dialogue diter l'expression qui facilite l'dition des formules longues. Le bouton Police ct de la zone d'dition permet de slectionner une police spare pour le texte. Dans le groupe Marges, vous pouvez dfinir les marges autour de l'objet imprim. Les modifications apparaissent dans le volet d'aperu droite de la bote de dialogue Imprimer. Les mesures sont en mm, cm ou ". L'unit par dfaut est dfinie la page Prfrences utilisateur: Conception. Haut Spcifie la distance entre le haut de la page et la bordure suprieure de l'objet imprim. En-tte La valeur En-tte correspond la distance entre le texte de l'en-tte et le haut de la page. Pour que le texte de l'en-tte apparaisse, cette valeur doit tre infrieure celle de la marge dfinie en Haut. Gauche Spcifie la distance entre le bord gauche du papier et la bordure gauche de l'objet imprim. Droite Spcifie la distance entre le bord droit du papier et la bordure droite de l'objet imprim. Bas Spcifie la distance entre le bas du papier et la bordure infrieure de l'objet imprim. Pied de page La valeur Pied de page correspond la distance entre le texte de pied de page et le bas de la feuille de papier. Pour que le texte de pied de page apparaisse, cette valeur doit tre infrieure celle de la marge dfinie en Bas.

Marges

Les boutons suivants sont aussi disponibles: Enregistrer les paramtres Aperu avant impression Imprimer Cliquez sur ce bouton pour enregistrer vos paramtres de disposition et continuer travailler dans cette bote de dialogue. Ce bouton ouvre une fentre qui affiche un Aperu avant impression (page 110) dtaill de l'objet imprimable actif. Cliquez sur ce bouton pour lancer la commande d'impression et fermer cette bote de dialogue.

107

13.3 Imprimer: En-tte/Pied de page

Imprimer, En-tte/Pied de page

Sous cet onglet, vous pouvez spcifier des paramtres pour l'En-tte et le Pied de page. Vous pouvez dfinir d'autres paramtres d'impression dans les pages de proprits Imprimer: Gnral (page 105) et Imprimer: Disposition (page 106). Les boutons suivants servent insrer des codes de contrles correspondant des informations systme spcifiques dans l'un des volets de texte. On peut aussi saisir les codes de contrle directement: Page Cliquez sur ce bouton ou saisissez le code &[Page] pour insrer le numro de page. Cliquez sur ce bouton ou saisissez le code &[Pages] pour insrer le nombre total de pages. Lors de l'utilisation de cette option pour l'impression groupe d'un rapport, la dure du calcul peut tre longue avant le dbut de l'impression. Dans ce cas, vous serez averti. Cliquez sur ce bouton ou saisissez le code &[Date] pour insrer la date du jour. On peut dfinir le format de date dans la bote de dialogue Date et heure (page 109). Cliquez sur ce bouton ou saisissez le code &[Time] pour insrer l'heure du moment. On peut dfinir le format d'heure dans la bote de dialogue Date et heure. Cliquez sur ce bouton ou saisissez le code &[File] pour insrer le nom du fichier. Cliquez sur ce bouton ou saisissez le code &[Sheet] pour insrer le nom de la feuille. Cette option n'est pas disponible lors de l'impression de rapports. Cliquez sur ce bouton ou saisissez le code &[Title] pour insrer le titre de l'objet imprim. Cette option n'est pas disponible lors de l'impression de rapports.

Pages

Date

Time

Nom du fichier Feuille

Titre

108

Image

Cliquez sur ce bouton pour importer une image partir de la bote de dialogue Slectionner une image. L'image sera imprime comme un graphique dans le volet d'en-tte ou de pied de page. Vous pouvez aussi saisir manuellement le code &[Picture=nomdufichier] o nomdufichier est le nom complet du fichier avec son chemin. Cliquez sur ce bouton ou saisissez le code &[Report] pour insrer le titre de l'objet imprim. Cette option est uniquement disponible lors de l'impression de rapports.

Rapport

Les groupes En-tte et Pied de page permettent les rglages ci-dessus dans les trois volets: Section gauche, Section centrale et Section droite. Cliquez simplement sur le volet voulu pour y placer le curseur, puis cliquez sur un bouton ou saisissez le code. Les boutons suivants sont aussi disponibles: Police Date et heure Par dfaut Ce bouton ouvre la bote de dialogue Police (page 519). Ce bouton ouvre la bote de dialogue Date et heure (page 109). Cliquez sur ce bouton pour revenir aux rglages par dfaut de l'en-tte et du pied de page. Cliquez sur ce bouton pour enregistrer vos rglages concernant l'en-tte et le pied de page et continuer travailler dans cette bote de dialogue.

Enregistrer les paramtres

Aperu avant impression Ce bouton ouvre une fentre qui affiche un Aperu avant impression (page 110) dtaill de l'objet imprimable actif. Imprimer Cliquez sur ce bouton pour lancer la commande d'impression et fermer cette bote de dialogue.

13.4 Date et heure

Bote de dialogue Date et heure

Vous pourrez choisir ici l'affichage de la date et de l'heure que vous prfrez.

109

Utiliser les valeurs systme par dfaut Paramtres actifs Date

Activez cette option pour appliquer les formats de date et d'heure du systme (par exemple Windows). Aperu du format de date et d'heure actuel. Le format de date peut tre configur ici. Slectionnez le format partir de la liste droulante. Choisissez le caractre utiliser comme sparateur de date. Dans le groupe Heure, vous pouvez dfinir le format de l'heure. 24 heures Activez cette option pour afficher l'heure au format 24 heures. 12 heures Activez cette option pour afficher l'heure au format 12 heures. Sparateur horaire Choisissez le caractre utiliser comme sparateur d'heure. Afficher les secondes Activez cette option pour afficher les secondes dans le format de l'heure.

Sparateur de date Time

13.5 Imprimer la feuille


Pour ouvrir cette bote de dialogue, choisissez Imprimer la feuille dans le menu Fichier. Cette bote de dialogue est identique la bote de dialogue Imprimer une exception prs : le groupe Taille de la page Gnral est remplac par un autre groupe appel Options des feuilles.

Options ded feuilles


Le groupe Options des feuilles contient les paramtres suivants : Cette feuille Toutes les feuilles Dessiner l'arrire-plan Si l'on slectionne cette option, seule la feuille active sera imprime. Si l'on slectionne cette option, toutes les feuilles du document seront imprimes. Cochez cette case pour imprimer aussi l'arrire-plan de la feuille (papier peint).

13.6 Aperu avant impression


Utilisez l'aperu quand vous souhaitez un aperu dtaill avant impression pour voir comment un objet imprimable sortira l'impression. La loupe passe de la taille d'aperu, qui permet de voir la page entire, la taille relle (100%). Imprimer Transfre le contrle la bote de dialogue Imprimer: Gnral (page 105) depuis laquelle vous pouvez imprimer l'objet actif.

Menu droulant Ce menu droulant permet de modifier rapidement la page afficher dans l'aperu. #pages Page prc. Si l'aperu contient plusieurs pages, vous pouvez cliquer sur ce bouton pour afficher la page prcdente. Si l'aperu contient plusieurs pages, vous pouvez cliquer sur ce bouton pour afficher la page suivante.

Page suiv.

110

Ajouter une page Supprimer la page Fermer Aide

L'aperu inclut une autre page si l'objet actif ne tient pas sur une page.

Supprime la page d'aperu affiche.

Ferme cette bote de dialogue. Ouvre l'aide de QlikView.

13.7 Options du Presse-papiers


Passe du mode logique au mode copie. En mode copie, les valeurs sur lesquelles on clique sont copies dans le Presse-papiers sans que l'tat logique du document QlikView en cours d'utilisation ne soit modifi. Lorsque vous activez le mode copie, la bote de dialogue Contenu du Presse-papiers (page 111) s'ouvre. Cette bote de dialogue affiche une liste de valeurs copier.

Contenu du Presse-papiers

Bote de dialogue Contenu du Presse-papiers

S'ouvre partir de Options du Presse-papiers (page 111), dans le menu dition. Cette bote de dialogue simplifie la copie vers le Presse-papiers. Lorsqu'elle est ouverte, QlikView est en mode copie et les valeurs sur lesquelles vous cliquez sont automatiquement copies dans le Contenu du Presse-papiers. Quand le document est en mode copie, la logique QlikView est dsactive. Format du Presse-papiers Le format du Presse-papiers se dfinit dans ce groupe. Colonne, Ligne dlimite par des virgules et Ligne dlimite par des tabulations sont les options disponibles.

111

Mise entre guillemets

Dans ce groupe, on peut dterminer les guillemets des lments slectionns. Guillemeter avec ' encadre tous les lments avec des guillemets simples. Ces guillemets sont utiles si les lments copis doivent tre colls dans le script en tant que valeurs de champ. Guillemeter avec '' encadre tous les lments avec des guillemets doubles. Ces guillemets sont utiles si les lments copis doivent tre colls dans le script en tant que noms de champs ou dans un script Visual Basic, par exemple une macro QlikView. Aucune n'ajoute aucun guillemet. Ferme la bote de dialogue Contenu du Presse-papiers et transfre son contenu vers le Presse-papiers de Windows. Ferme la bote de dialogue Contenu du Presse-papiers sans transfrer son contenu vers le Presse-papiers de Windows.

OK

Annuler

13.8 Exporter/Exporter le contenu


Ouvre la bote de dialogue Enregistrer sous. Vous pouvez y spcifier un nom, un chemin et un type de fichier pour les donnes exportes. Le fichier peut tre enregistr dans l'un des formats suivants: Dlimit par des virgules, dlimit par des points virgules, dlimit par des tabulations, Hypertexte (HTML), XML et Excel (xls). Le format par dfaut est *.qvo (QlikViewOutput), fichier spar par des tabulations.

Remarque Lors de l'exportation dans un fichier qvo, les donnes sont exportes telles qu'elles apparaissent dans le document QlikView. Lors de l'exportation dans Excel, les donnes sous-jacentes sont exportes mais apparaissent au format Excel.

112

14 Logique et slections
14.1 Slection d'une seule valeur de champ
Pour slectionner une valeur dans un champ, cliquez simplement dessus. Une fois slectionne, la cellule devient verte pour indiquer son nouvel tat, savoir qu'elle est slectionne. La slection peut se rpercuter sur les tats de nombreuses valeurs dans les autres objets de la feuille. Les cellules blanches reprsentent les valeurs de champs facultatives, tandis que les cellules grises reprsentent les valeurs de champs exclues par les slections. Quand une slection est effectue, des jointures internes naturelles sont cres entre toutes les tables associes. On peut faire des slections non seulement dans les listes de slection, mais aussi dans les zones de statistiques, les listes multiples, les zones table et les graphiques. Consultez les paragraphes ci-aprs pour plus d'informations sur les slections dans les objets. Pour annuler une slection, cliquez dessus ou choisissez Effacer dans le menu Objet, ou encore l'une des commandes Effacer du menu Slections. Lorsqu'on clique sur une valeur exclue, les slections incompatibles avec cette valeur sont annules et la valeur sur laquelle on a cliqu est slectionne.

14.2 Jeu de couleurs


L'tat de slection d'une valeur de champ est indiqu par la couleur de la cellule. Le tableau ci-dessous dresse la liste des couleurs du jeu de couleurs par dfaut (Classique). Vous pouvez modifier ces couleurs si l'un des autres jeux de couleurs est slectionn dans le groupe Aspect de la slection de la page Proprits du document : Gnral. L'tat d'une valeur de champ est indiqu par la couleur de sa cellule. QlikView utilise le jeu de couleurs suivant: tat Slectionner Facultatif Option Verrouill Valeurs exclues Exclue de force Arrire-plan Vert Blanc Blanc/Jaune Bleu Gris Rouge

Quand l'option Afficher les alternatives (page 503) est active, QlikView affiche les cellules non slectionnes dans la liste de slection correspondante comme valeurs de remplacement (blanc), moins qu'elles ne soient exclues par des slections dans d'autres listes de slection. Elles sont toutefois logiquement exclues et ne sont donc pas incluses dans les calculs effectus sur les valeurs possibles (facultatives et slectionnes). Lorsque l'option Afficher les alternatives est dsactive, c'est--dire dcoche, QlikView affiche les cellules non slectionnes comme exclues (gris). Le style de slection Cases cocher Windows n'utilise pas ce jeu de couleurs.

113

14.3 Styles de slection


QlikView prend en charge un grand nombre de prsentations diffrentes des donnes et de possibilits de slections dans les listes de slection et les listes multiples. Les styles QlikView classique, Balise d'angle et Voyant utilisent tous le codage couleur pour signaler les valeurs slectionnes, possibles et exclues. Le style Cases cocher Windows imite l'interface Windows standard avec des cases cocher pour chaque valeur. Le style Cases cocher de voyant utilise le codage couleur en combinaison avec le style Cases cocher Windows. Lorsqu'on utilise les styles de slection base de couleurs, un certain nombre de jeux de couleurs diffrents sont disponibles. Les couleurs de base (vert pour les valeurs slectionnes, bleu pour les valeurs verrouilles, etc.) ne peuvent pas tre modifies, mais des variations de ton et d'intensit sont possibles. Le style appliqu peut tre contrl via les paramtres disponibles sous l'onglet Proprits du document: Gnral ( Proprits du document: Gnral (page 440)), l'onglet Prfrences utilisateur: Gnral ( Prfrences utilisateur (page 81)) et l'onglet Proprits de la liste de slection: Prsentation ( Proprits de la liste de slection: Prsentation (page 514)). Reprsentation de l'tat logique Dans QlikView, l'tat logique des donnes est reprsent dans le style QlikView classique par un codage des couleurs de l'arrire-plan et du texte des cellules de listes de slection et de listes multiples. Dans d'autres objets et sur les onglets de feuille, des signaux de slection peuvent apparatre pour indiquer des slections. Les caractres & et ! peuvent apparatre gauche des donnes dans les listes de slection et les listes multiples, afin d'indiquer respectivement des slections AND et NOT. Avec le style Cases cocher Windows, le seul codage couleur restant est l'arrire-plan blanc et gris des cellules pour indiquer des valeurs possibles et exclues dans les listes de slection et dans les listes multiples. Cependant, toutes les cellules prsentent galement une icne indiquant l'tat logique des donnes. Ces icnes apparaissent aussi la place des signaux de slection dans d'autres parties du document. Les diffrences sont rsumes dans le tableau ci-dessous : Styles codage couleur QlikView tat de QlikView Possible Valeurs exclues Slectionn Slectionner les valeurs exclues Verrouill Exclu verrouill Slectionn AND Blanc/Noir Gris/Gris clair Vert/Noir Gris/Gris clair Style Cases cocher Windows (icnes)

Bleu/Jaune Gris/Gris clair Vert/Noir avec &

114

Slectionn NOT

Rouge/Noir avec !

Comportement logique
Le comportement logique des styles Cases cocher Windows et Case cocher de voyant diffre de celui des styles codage couleur sur deux points. 1. Toutes les slections sont considres dans le style Cases cocher Windows et Cases cocher de voyant comme des slections bascule, c'est--dire qu'elles fonctionnent comme si vous mainteniez la touche ctrl enfonce tout en procdant aux slections dans les styles codage couleur. 2. Toutes les listes de slection sont traites comme si l'option Afficher les alternatives tait slectionne, quel que soit le paramtre rel de cette proprit.

14.4 Indicateur
Les indicateurs (ou signaux) sont des points colors qui apparaissent parfois dans les tables, sur les tabs et dans le coin droit de la Barre d'tat (page 80). Ils servent simplement vous rappeler que vous avez effectu des slections dans des champs qui ne sont pas disponibles sur la feuille affiche. Comme toutes les feuilles d'un document QlikView sont totalement interconnectes tout moment, ces slections modifient trs vraisemblablement ce qui est affich sur la feuille active, mme si elles ne sont pas apparentes! D'o l'utilit des indicateurs. Des indicateurs de slection peuvent aussi apparatre en haut droite des champs de donnes dans les tables QlikView: zones tables, tableaux croiss dynamiques et tableaux simples. C'est une option utile, car les slections dans les tables n'utilisent pas elles-mmes de code couleur. Vous devez la slectionner/dslectionner dans la bote de dialogue Prfrences utilisateur: Objets (page 91). Des indicateurs de slection apparatront dans la zone des slections actives, ainsi que dans la zone de texte libre des slections actives, afin de distinguer les valeurs slectionnes et les valeurs verrouilles. La couleur de l'indicateur correspond au jeu de couleurs gnral: Un point vert pour les valeurs slectionnes. Un point bleu pour les slections verrouilles. Un point rouge pour les valeurs dslectionnes en mode AND.

14.5 Slection multiple dans un champ


Vous pouvez effectuer des slections multiples dans un champ (d'une liste de slection) de plusieurs faons:
l

Placez le curseur dans la liste de slection, puis tirez-le sur plusieurs valeurs de champs en appuyant sur le bouton de la souris. Cliquez sur la premire valeur slectionner, puis utilisez CTRL+ clic pour toute slection supplmentaire. Cliquez sur l'lment slectionner le plus haut, puis cliquez sur l'lment le plus bas en appuyant aussi sur MAJ. De cette faon, tous les lments se trouvant entre les deux seront aussi slectionns. Cependant, si le mcanisme de tri est activ, la premire slection peut faire changer l'ordre, et effectuer une seconde slection correcte est alors difficile. Confirmez une recherche textuelle (voir ci-dessous) en appuyant sur la touche ENTRE. Toutes les valeurs de champs correspondantes seront alors slectionnes. Si vous maintenez la touche CTRL enfonce tout en appuyant sur la touche ENTRE, les rsultats de la recherche textuelle seront ajouts aux slections prcdentes.

Pour dslectionner une slection ajoute une autre, cliquez dessus avec la touche CTRL enfonce.

115

Si vous effectuez une slection multiple dans une liste de slection et que vous faites une nouvelle slection parmi les valeurs facultatives disponibles dans une autre liste de slection, certaines valeurs slectionnes dans la premire liste de slection pourront tre exclues. Toutefois, lorsque la slection dans la deuxime liste est annule, les slections prcdentes sont, par dfaut, rcupres. Une slection multiple peut tre interprte de deux manires, soit comme un ou logique, soit comme un and logique. Par dfaut, c'est le ou logique, c'est--dire que QlikView trouve une solution associe une ou plusieurs valeurs de champs slectionnes.

14.6 Dplacement de slections


La slection active dans une liste de slection active ou dans un champ liste multiple ouvert peut tre dplace l'aide des touches du clavier. On peut utiliser les touches suivantes:

Descend la ou les slection(s) active(s) d'un cran dans la liste de slection. Lorsque la dernire valeur est atteinte, la slection revient la premire valeur. Quand aucune slection n'est effectue, la liste de slection descend simplement d'une cellule la fois. Monte la ou les slection(s) active(s) d'un cran dans la liste de slection. Lorsque la premire valeur est atteinte, la slection revient la dernire valeur. Quand aucune slection n'est effectue, la liste de slection monte simplement d'une cellule la fois. Descend les slections actives d'un intervalle quivalent la distance qui spare les slections affiches les plus loignes. Quand le dernier ensemble de valeurs est atteint, les slections reviennent au premier ensemble. Quand aucune slection n'est effectue, la liste de slection descend simplement d'une page la fois. Monte les slections actives d'un intervalle quivalent la distance qui spare les slections affiches les plus loignes. Lorsque le premier ensemble de valeurs est atteint, la slection revient au dernier ensemble. Quand aucune slection n'est effectue, la liste de slection monte simplement d'une page la fois. Dplace la ou les slection(s) active(s) au dbut de la liste. Dplace la ou les slection(s) active(s) la fin de la liste.

PgSuiv

PgPrc

Origine Fin

Exemple:
Supposons que la liste de slection (E et F slectionns) est comme suit :

F et G seront slectionnes.

116

D et E seront slectionnes. PgSuiv G et H seront slectionnes. PgPrc C et D seront slectionnes. Origine A et B seront slectionnes. Fin I et J seront slectionnes.

14.7 Verrouiller des valeurs de champs slectionnes


Lorsque vous slectionnez une valeur de champ exclue, les slections prcdentes incompatibles avec ce nouveau choix sont annules. Pour empcher l'annulation d'une slection prcdente, vous pouvez verrouiller toutes les slections dans une liste de slection en ouvrant son menu Objet et en choisissant la commande Verrouiller. Pour dverrouiller des slections, ouvrez le menu Objet de la liste de slection, puis slectionnez Dverrouiller. Il est possible de verrouiller et de dverrouiller toutes les slections la fois dans le menu Slections. Si vous tentez de slectionner une valeur qui est incompatible avec une slection verrouille dans un autre champ, la slection chouera. Grce au paramtre Outrepasser le verrouillage du champ des listes de slection, des listes multiples et des curseurs, il est possible d'outrepasser le verrouillage d'une slection dans un champ partir d'un objet donn. Le champ reste verrouill pour les changements logiques provenant des slections effectues dans d'autres champs. Cette option est active par dfaut pour les objets curseur.

14.8 Slections actives

Dans la fentre Slections actives, les slections sont listes par nom et par valeur de champ. Cette fentre reste au-dessus de toutes les feuilles et vous aide suivre l'tat des slections dans le document. Dans la colonne tat, des Indicateur (page 115) permettent de distinguer les valeurs slectionnes et les valeurs verrouilles. Vous pouvez y accder via le menu Affichage ou le menu Slections actives de la barre d'outils. Si vous cliquez avec le bouton droit droit dans la fentre Slections actives sans avoir mis aucun champ en surbrillance, le menu contextuel contient les commandes suivantes : Effacer toutes les slections Verrouiller toutes les slections Dslectionne toutes les valeurs slectionnes du document.

Verrouille toutes les valeurs slectionnes du document.

117

Dverrouiller toutes les slections Donnes

Dverrouille toutes les valeurs verrouilles du document.

Copie le nom de toutes les valeurs slectionnes du document, ainsi que le nom des champs dans lesquels ces slections ont t faites, dans le Presse-papiers.

La fentre Slections actives ressemble un objet de feuille dans la mesure o elle peut tre dimensionne et o elle peut rester ouverte pendant qu'un document est en cours d'utilisation. Elle reste ouverte lorsque vous quittez QlikView et rapparat au prochain dmarrage du programme. Comme les objets de feuille, elle est mise jour de faon dynamique ds que de nouvelles slections sont effectues, ce qui permet d'avoir toujours un aperu des slections actives. Le nombre maximum de valeurs distinctes slectionnes afficher dans la fentre Slections actives est spcifi dans la bote de dialogue Prfrences utilisateur ( Prfrences utilisateur (page 81)). Lorsque des valeurs supplmentaires sont slectionnes, elles sont seulement signales par 'x valeurs sur y' pour le champ concern. Les slections effectues dans les zones and sont prcdes du symbole & ou !, selon qu'il s'agit d'une slection ou d'une exclusion.

14.9 Slection dans les autres objets


On peut slectionner directement des donnes de champs dans la plupart des objets de QlikView en cliquant ou en balayant l'aide de la souris. Cette section dcrit les possibilits de slections dans les diffrents types d'objets.

Zones de statistiques
Dans les zones de statistiques, il est possible de cliquer sur certaines quantits statistiques, par exemple Min, Max et Mdiane, pour slectionner la valeur correspondante. La slection n'est pas indique dans la zone de statistiques, uniquement dans les autres zones.

Listes multiples
Chaque ligne d'une liste multiple reprsente un champ. Un clic sur la petite flche affiche la liste de valeurs appartenant au champ. Il est possible d'effectuer des slections et des recherches dans cette liste, comme pour une liste de slection.

Zones table
On peut effectuer des slections en cliquant sur une cellule ou en balayant une zone couvrant une ou plusieurs lignes et une ou plusieurs colonnes. Si l'option Menu droulant est active, une flche s'affiche dans l'en-tte de la colonne. Un clic sur la flche affiche la liste des valeurs appartenant au champ. Il est possible d'effectuer des slections et des recherches dans cette liste, comme pour une liste de slection.

Objets curseur/calendrier
Dans les curseurs, o un seul champ est la base, il est possible de slectionner une valeur en rglant le petit curseur sur la position souhaite. Si le curseur est convenablement configur, la taille du petit curseur peut tre modifie par un clic de la souris. De cette faon, plusieurs valeurs peuvent tre slectionnes. Un clic sur le petit symbole de calendrier dans un objet calendrier affiche le calendrier. Il est possible de slectionner une date ou une priode complte grce la souris, en fonction de la configuration de l'objet calendrier ; cette slection est transfre au champ sous-jacent. En cliquant en maintenant la touche CTRL enfonce, il est possible de slectionner plusieurs priodes, mme si elles concernent diffrents mois ou annes.

118

Histogrammes, courbes, combins, radars, bulles et nuages de points


On peut faire des slections dans la zone de trac en cliquant sur un seul point de donnes ou en balayant plusieurs points de donnes. Dans ce dernier cas, la zone couverte est indique par une trame verte. La slection concernera les valeurs de dimension utilises pour calculer les points de donnes slectionns. On peut effectuer des slections en cliquant ou en balayant dans la lgende du graphique (sauf quand la lgende indique des expressions de graphique plutt que des valeurs de dimension). On peut effectuer des slections en cliquant ou en balayant les axes de dimensions et leurs tiquettes (sauf les nuages de points). Les valeurs de champs correspondantes seront slectionnes. On peut effectuer des slections en balayant les axes d'expressions et leurs tiquettes. Les valeurs de champs qui gnrent des points de donnes dans la zone indique seront slectionnes. Lorsqu'on balaye des slections dans les courbes et les histogrammes plus d'une dimension, le comportement de la logique de slection de QlikView diffre lgrement de celui des autres graphiques, afin de rpondre aux attentes de l'utilisateur. Les slections dans ces types de graphiques ne concernent pas les deux dimensions en mme temps. Dans les courbes, les slections seront d'abord effectues dans la seconde dimension. Cela signifie que balayer une courbe slectionnera la courbe entire sur toutes les valeurs de dimension de l'axe des abscisses. Dans les histogrammes, c'est l'inverse. Les slections s'appliquent d'abord la premire dimension. Cela veut dire par exemple que cliquer sur un segment de barre slectionnera la valeur de dimension de l'axe des abscisses de ce segment, mais gardera tous les segments en pile ou groups comme valeurs possibles. Quand des slections ont rduit la dimension de slection principale une seule valeur, l'ancienne logique de slection s'applique nouveau, avec pour consquence que les slections prvalent aussi dans la dimension de slection secondaire. Dans les combins, les slections concernent toujours toutes les dimensions.

Secteurs
On peut effectuer des slections dans la zone de trac en cliquant sur un seul secteur ou en balayant plusieurs secteurs. Dans ce dernier cas, la zone couverte est indique par une trame verte. La slection concernera les valeurs de dimension utilises pour calculer les points de donnes slectionns. On peut effectuer des slections en cliquant ou en balayant dans la lgende du graphique.

Blocs
Il est possible de slectionner des blocs individuels dans les blocs. Avec les slections, la fonctionnalit de zoom avant entre en jeu. La slection du premier bloc fait rfrence la premire dimension, la slection d'un deuxime bloc au sein du premier fait rfrence la deuxime dimension, etc. Il est galement possible de slectionner plusieurs blocs en balayant une zone. Cette zone slectionne est indique en vert jusqu' ce que le bouton de la souris soit relch. Une telle slection fait rfrence la valeur ou aux valeurs de la premire dimension. Les blocs correspondants sont calculs sur la base de ces valeurs. Si une slection croise les bordures de bloc de plusieurs valeurs appartenant la premire dimension, toutes les valeurs lies appartenant aux deuxime et troisime dimensions sont galement impactes, et pas uniquement celles de la zone slectionne.

Jauges
On ne peut pas effectuer de slections dans les jauges.

Tableaux simples
On peut effectuer des slections dans les colonnes de dimension en cliquant sur une cellule ou en balayant plusieurs cellules. La zone slectionne est indique en vert jusqu' ce que le bouton de la souris soit relch.

119

Si l'option Menu droulant est active dans une colonne reprsentant une dimension, une petite flche s'affiche dans l'en-tte de la colonne. Un clic sur la flche affiche la liste de toutes les valeurs du champ. Il est possible d'effectuer des slections et des recherches dans cette liste. On peut effectuer des slections dans les colonnes d'expression en cliquant sur une seule cellule. La slection concernera les valeurs de dimension utilises pour calculer la cellule d'expression slectionne.

Tableaux croiss dynamiques


On peut effectuer des slections dans les colonnes/lignes de dimension en cliquant sur une seule cellule. La cellule slectionne est indique en vert jusqu' ce que le bouton de la souris soit relch. Si l'option Menu droulant est active dans une colonne reprsentant une dimension, une petite flche s'affiche dans l'en-tte de la colonne. Un clic sur la flche affiche la liste de toutes les valeurs du champ. Il est possible d'effectuer des slections et des recherches dans cette liste. On peut effectuer des slections dans les colonnes/lignes d'expression en cliquant sur une seule cellule. La slection concernera les valeurs de dimension utilises pour calculer la cellule d'expression slectionne.

14.10 Rechercher
On peut aussi effectuer des slections par la recherche textuelle. Pour saisir une chane de recherche, cliquez sur l'en-tte de la liste de slection, puis tapez simplement votre chane. La chane ne respecte pas la casse des caractres. Elle apparatra dans la zone de recherche textuelle contextuelle. QlikView affichera alors toutes les valeurs du champ slectionn rpondant aux critres de la chane de recherche. Lorsque vous appuyez sur ENTRE ou que vous cliquez sur l'une des cellules ainsi obtenues, les valeurs sont slectionnes. Si vous maintenez la touche CTRL enfonce tout en appuyant sur la touche ENTRE, les rsultats de la recherche textuelle seront ajouts aux slections prcdentes. La zone de recherche se ferme automatiquement lorsque vous appuyez sur la touche ENTRE ou CHAP ou encore lorsque vous cliquez dans la disposition. Vous pouvez galement la fermer en cliquant sur l'icne de la zone de recherche. La zone de recherche est redimensionnable et conserve sa nouvelle taille sa rouverture. Si plusieurs listes de slections sont actives (cliquez sur leur en-tte en maintenant la touche MAJ enfonce pour les slectionner), elles sont toutes incluses dans la recherche textuelle. On ne peut cependant pas appuyer sur ENTRE pour slectionner les valeurs obtenues, moins qu'elles ne soient facultatives dans une seule des listes actives. Si une slection a dj t effectue, la recherche textuelle peut tre interprte de deux manires: soit vous cherchez uniquement parmi les valeurs facultatives, soit vous cherchez parmi toutes les valeurs, c'est--dire que vous incluez les valeurs exclues dans la recherche. Pour dfinir le mode de recherche utiliser, vous pouvez soit slectionner, soit dslectionner l'option Inclure les valeurs exclues dans la recherche dans la bote de dialogue Prfrences utilisateur. Ce mode peut aussi tre dfini sparment pour certains objets. Si l'option and logique est active pour un champ, il ne sera peut-tre pas possible de slectionner les valeurs multiples obtenues.

Recherche textuelle
La recherche textuelle est la faon la plus simple d'effectuer une recherche. QlikView recherche les valeurs du champ correspondant la chane textuelle saisie. Si aucun caractre gnrique n'est utilis (recherche classique), QlikView recherche les mots commenant par la chane de caractres prcise. Si la chane de recherche contient plusieurs mots spars par des espaces, QlikView l'interprte comme plusieurs chanes de recherche et affiche des valeurs de champ contenant l'un ou l'autre de ces termes.

120

La chane de recherche peut cependant contenir des caractres gnriques (recherche avec caractres gnriques). Dans ce cas, seuls les enregistrements correspondant la chane de caractres entire s'afficheront, un espace n'impliquant pas d'oprateur OU logique. Les caractres gnriques peuvent apparatre plusieurs fois dans la chane de recherche, quelle que soit leur position. Les caractres gnriques suivants sont disponibles: * Aucun caractre ou plus. ? N'importe quel caractre. ^ chane entire. Appuyez sur la touche ENTRE pour slectionner les valeurs obtenues et sur la touche CHAP pour annuler l'opration.

Exemples:
a* trouvera toutes les valeurs commenant par la lettre a. *b* trouvera toutes les valeurs contenant la lettre b.

Recherche partielle
Si vous commencez votre recherche textuelle par le symbole ~, la fentre de recherche textuelle sera ouverte en mode de recherche partielle. La fentre de recherche contiendra un tilde ~ avant le curseur. Au fur et mesure de votre saisie, toutes les valeurs seront tries en fonction de leur degr de ressemblance la chane de recherche, les meilleures correspondances tant places en haut de la liste. Si vous appuyez sur ENTRE, la premire valeur de la liste sera slectionne.

Recherche numrique
On peut aussi effectuer des slections par la recherche numrique. Elle se rapproche beaucoup de la recherche textuelle. La seule diffrence est que la chane de recherche doit commencer par l'un des oprateurs relationnels >, >=, < or <=.

Exemples:
>900 <=900 trouvera toutes les valeurs suprieures 900. trouvera toutes les valeurs infrieures ou gales 900. trouvera toutes les valeurs suprieures 900 et infrieures 1000. trouvera toutes les valeurs infrieures 900 et suprieures 1000.

>900<1000

<900>1000

Mode de recherche initial


Lorsque vous commencez taper du texte, le comportement peut varier: dans certains cas, QlikView ajoute des caractres gnriques (afin de faciliter une recherche avec caractres gnriques) ou un tilde (pour les recherches partielles) la chane de recherche. Dans d'autres cas, QlikView ne complte pas du tout la chane que vous tes en train de taper (dans les recherches classiques). Vous pouvez dfinir votre mode de recherche prfr via les proprits de l'objet et les Prfrences utilisateur.

121

valuation de la chane de recherche


Une fois la chane de recherche saisie ou modifie, QlikView value le comportement de recherche slectionner (parmi ceux dcrits ci-dessus). Si la chane de recherche contient des caractres gnriques, une recherche avec caractres gnriques est lance. Si la chane de recherche commence par un tilde, une recherche partielle est effectue. Si la chane de recherche ne contient ni caractre gnrique ni tilde, une recherche classique est lance. Il est toujours possible de modifier le mode de recherche en supprimant ou en ajoutant simplement des caractres gnriques, un tilde (~), un signe suprieur (>) ou infrieur (<) la chane de recherche.

Recherche associe
La zone de recherche contient un chevron droite. Si vous cliquez dessus, la bote de recherche se dveloppe droite et une deuxime srie de rsultats s'affiche en regard de la premire. Cette deuxime liste contient des correspondances dans d'autres champs. Il est dsormais possible de cliquer sur la deuxime srie de rsultats et d'effectuer des slections temporaires. Ces slections permettront de restreindre les rsultats de la premire liste. Une fois la slection effectue dans la deuxime liste, il est possible de saisir une nouvelle chane de recherche avant d'effectuer une slection dans la premire liste. Enfin, lorsque la slection est effectue dans la premire liste, la deuxime liste se ferme.

Recherche avance
Pour les expressions complexes, vous pouvez utiliser la bote de dialogue Recherche avance( voir cidessous), accessible l'aide du raccourci clavier CTRL+MAJ+F. Si vous commencez votre recherche par un signe gal (=), vous pouvez saisir une expression de recherche avance en utilisant des critres de recherche pour les champs associs ainsi que la logique boolenne complte. Aprs le signe gal, vous pouvez maintenant saisir n'importe quelle expression de disposition QlikView valide ( Bote de dialogue diter l'expression (page 813)). L'expression sera value pour chaque valeur classe dans le champ de recherche. Toutes les valeurs pour lesquelles l'expression de recherche renvoie une valeur diffrente de zro seront retournes.

Exemples:
=MonChamp like 'A*' or MonChamp like '*Z' Si, par exemple, la recherche est appele partir d'une liste contenant le champ MonChamp, la recherche retournera toutes les valeurs commenant par la lettre A ou se terminant par la lettre Z. =sum(Ventes)>sum(Budget) Si, par exemple, la recherche est appele partir d'une liste contenant le champ Vendeur, la recherche retournera tous les vendeurs dont la somme des ventes est suprieure leur budget associ.

Voir aussi:

122

14.11 Bote de dialogue de recherche avance

Fentre de recherche avance

Cette fentre permet de formuler des critres d'interrogation complexes sur les champs de QlikView. la diffrence de la fentre de Rechercher (page 120) standard qui apparat au lancement d'une recherche sur une liste de slection active, le rsultat de la recherche ne sera pas visible de manire interactive dans la disposition tant que la recherche ne sera pas valide par un clic sur le bouton Rechercher. La fentre peut rester ouverte pendant que vous continuez travailler dans la disposition QlikView. Il est possible de redimensionner la fentre pour faciliter l'dition des expressions longues ou complexes. Rechercher dans Le champ dans lequel la recherche sera effectue. Quand la fentre s'ouvre, le champ par dfaut qui est slectionn est celui de la liste active. Il est possible de modifier tout moment le champ de la recherche en utilisant la liste droulante. Rechercher l'expression Zone dans laquelle vous tapez l'expression rechercher. Les rgles sont les mmes que celles s'appliquant lorsque vous utilisez la bote de recherche classique. Rechercher Prcdent Applique la recherche au champ de recherche. QlikView mmorise les 100 dernires slections. En cliquant sur ce bouton, vous reculez d'un lment dans la liste des slections. En cliquant sur sur ce bouton, vous avancez d'un lment dans la liste des slections (ce qui revient annuler la dernire utilisation de la commande Prcdent). Cette opration est possible seulement si la commande Prcdent a t utilise juste avant. Efface les slections dans le champ de recherche courant.

Suivant

Effacer le champ

123

Effacer tout Aide Fermer

Efface toutes les slections dans le document. Ouvre la fentre Aide pour effectuer une recherche avance. Ferme cette bote de dialogue.

Dans la partie infrieure de la fentre, 3 onglets sont disponibles pour y saisir des expressions avances.

Champs
La page Champs comprend des commandes destines coller la syntaxe lie aux donnes de champs QlikView. Agrgation Dans cette liste droulante, vous pouvez choisir parmi les fonctions statistiques d'agrgation disponibles dans la disposition QlikView. Dans cette liste droulante, vous pouvez slectionner une table spcifique afin de faciliter la recherche d'un champ dans la liste droulante Champ. Cette liste droulante comprend tous les champs disponibles. On peut en rduire la taille en slectionnant une table spcifique dans la liste droulante Table audessus. Si cette case est coche, la liste contenant les champs du document inclut les champs systme. Les fonctions statistiques sont calcules par dfaut sur le nombre d'occurrences dans la table de dpart. Il peut arriver cependant qu'il soit inutile de calculer les doublons. Si tel est le cas, cochez cette case avant de coller la fonction. Permet de coller la fonction ou le champ slectionn dans le champ d'dition Rechercher l'expression. Un pourcentage peut tre indiqu en utilisant la fonction fractile.

Table

Champ

Afficher les champs systme Calcul distinct

Coller

Fonctions
La page Fonctions comprend des commandes destines coller la syntaxe lie aux fonctions gnrales de QlikView. Catgorie de fonction Dans cette liste droulante, vous pouvez slectionner une catgorie de fonctions afin de faciliter la recherche d'une fonction dans la liste Nom de la fonction. Cette liste droulante permet de choisir une fonction coller dans l'expression parmi les fonctions disponibles dans la disposition QlikView. On peut rduire la liste aux seules fonctions d'une catgorie donne l'aide de la liste droulante Catgorie de fonction ci-dessus. Permet de coller la fonction dans le champ d'dition Rechercher l'expression.

Nom de la fonction

Coller

Au bas de la page, un volet affiche la syntaxe des arguments de la fonction slectionne dans la liste droulante Nom de la fonction.

Variables
La page Variables comprend des commandes destines coller la syntaxe lie aux variables QlikView.

124

Variables

La liste droulante contient toutes les variables actuellement dfinies dans le document. Coller Permet de coller la fonction slectionne dans le champ d'dition Rechercher l'expression. Afficher les variables systme Si cette case est coche, la liste droulante Variables inclura les variables systme.

Au bas de la page, un volet affiche la valeur actuelle de la variable slectionne dans la liste droulante Variables.

14.12 Mode AND dans les listes de slection


Une slection multiple dans un champ est interprte par dfaut comme un OR logique, ce qui signifie que les donnes associes n'importe laquelle des valeurs slectionnes apparatront dans d'autres champs. On peut cependant utiliser certaines listes de slection en mode And. Lorsque vous effectuez des slections multiples dans une liste de slection en mode And, les associations dans d'autres champs doivent concerner toutes les valeurs slectionnes. C'est exactement ainsi que se font normalement les associations aux slections multiples dans plusieurs champs. Le mode du champ est dfini dans Proprits de la liste de slection : Gnral. Lorsque le mode AND est activ, le symbole & s'affiche devant les valeurs slectionnes. Si vous cliquez sur une valeur et maintenez le bouton de la souris enfonc quelques instants, la slection passera de AND (vert) NOT (rouge). Le symbole & sera galement remplac par un point d'exclamation ( !). La slection NOT, qui est une exclusion force des valeurs ainsi slectionnes, ne peut tre utilise que lorsque la liste de slection est en mode AND.

Tables AND
Un champ ne peut pas toujours tre dfini en mode And. La raison en est que l'option and est logiquement significative uniquement si le champ concern est li un seul autre champ. L'option Mode And n'est active qu' des conditions trs strictes, imposes par la thorie que sous-tend la logique QlikView. Pour une utilisation en mode AND, les critres suivants doivent tre respects:
l l l l

le champ doit exister dans une seule table interne, le champ doit tre la seconde colonne d'un ensemble de deux colonnes au maximum, la table ne doit pas contenir d'enregistrements en double et la table doit tre charge l'aide d'un qualificateur distinct. Si la table est charge l'aide d'une instruction Select, une instruction Load distinct * doit la prcder.

Exclusion force/Slection Not


L'exclusion force, ou exclusion pas (NOT), est trs proche de la slection and. On peut ici exclure explicitement une valeur de champ, c'est--dire que les solutions trouves par QlikView ne pourront pas tre associes la valeur exclue. Pour effectuer la slection not, vous devez cliquer sur une cellule et maintenir le bouton de la souris enfonc jusqu' ce que la cellule devienne rouge. Un clic avec la touche CTRL enfonce quivaut ainsi une exclusion qui constitue une exigence supplmentaire par rapport aux slections/exclusions prcdentes. La slection not ne peut tre effectue que sur un champ en mode And.

125

14.13 Tables dconnectes


Une table dconnecte est une table o la logique normale de QlikView a t dsactive en interne. Cela signifie que les slections dans un champ ne sont pas rpercutes tous les autres champs de la table. Ce chapitre donne quelques exemples de la faon dont des tables dconnectes modifient la logique QlikView.

Exemple de base
Regardez les trois zones table suivantes, chacune reprsentant une table lue dans QlikView :

Si la valeur 2 est slectionne dans le champ B, la chose suivante se produit :

La slection se rpercute dans toutes les tables. Gardons maintenant cette slection, mais dconnectons Tab2. Cela signifie que la logique sera coupe entre les champs A et C dans Tab2. Le rsultat ressemblera ceci :

Attention : Tab2 ici est une zone table et non la table elle-mme. La zone table affichera toutes les combinaisons possibles entre les champs de ses colonnes. Comme il n'y a pas de logique entre les champs A et C, toutes les combinaisons de leurs valeurs possibles respectives sont affiches.

viter les rfrences circulaires


L'exemple suivant montre comment des tables dconnectes peuvent tre utiles pour viter des rfrences circulaires dans la structure des donnes :

En fait, cette structure de donnes n'est pas vraiment satisfaisante, puisque le nom de champ Pays est utilis deux fins diffrentes. Dans une table, il indique o le propritaire de la voiture habite, et dans l'autre, il

126

indique o rside le fabricant de la voiture. Avec les donnes des tables, on est confront une situation logique impossible. O que la slection soit faite, on peut suivre des associations passant par toutes les cellules des trois tables. Parmi le pays de rsidence et le pays du fabricant automobile, il faut dcider lequel est le plus important. Si vous dconnectez la table Fabricant automobile, les associations de Cadillac tats-Unis et de Volvo Sude seront rompues. En cliquant sur Sude, vous obtiendrez Bjrn Borg et Cadillac. En cliquant sur Volvo, vous obtiendrez George Bush et tats-Unis. Si l'on prfre se concentrer sur les fabricants automobiles, il est alors plus logique de dconnecter la table Domicile.

Autre exemple
Considrons une autre situation courante o les tables dconnectes peuvent tre utiles. On trouve ci-dessous trois tables dans une structure plutt habituelle : une table de transaction et deux tables de dimension y tant associes chacune par le biais d'un champ.

Maintenant, admettons que vous souhaitiez un tableau crois dynamique affichant les ventes par an et le groupe de produits. Si nous en crons un par rapport deux listes de slection affichant les champs de dimension, cela donnera ceci :

Mme si c'est un tableau crois dynamique correct, les effets de la logique de QlikView pourraient donner ici des rsultats indsirables. Si nous slectionnons l'anne 2000, nous obtiendrons la disposition suivante:

Le groupe de produits Z a disparu . Ceci normal, puisque la valeur Z du champ ProdGrp a t exclue par la slection de la valeur 2000 du champ Anne. Pourtant, le Directeur voudra srement voir Z dans le graphique avec un 0 dans la colonne sum(Quantit), afin qu'il soit clair pour tout le monde que le groupe de produits Z existe et que rien n'a t vendu en 2000.

127

On pourrait rpondre que les deux champs Anne et ProdGrp n'ont vraiment rien voir et qu'ils ne devraient donc pas interagir simplement parce qu'ils se trouvent tre lis par la table Trans. Rsolvons donc le problme en dclarant la table Trans dconnecte. Notre disposition sera tout de suite diffrente:

La table a maintenant l'apparence voulue. Notez que la slection dans la liste Anne n'exclut pas de valeurs de la liste ProdGrp. En rsum, on peut dire que cette situation, avec une ou plusieurs tables de transaction entoures d'un certain nombre de dimensions ne devant pas tre exclues, est tout fait courante. Les tables dconnectes sont alors une faon de traiter de tels cas.

Tables dconnectes et sous-totaux


Lorsqu'on utilise des tables dconnectes avec des donnes de dimension non hirarchiques, les sous-totaux des tableaux croiss dynamiques peuvent devenir incorrects. L'exemple qui suit est trs similaire au prcdent, mais le produit B appartient dsormais deux groupes de produits, X et Y. Le produit D a disparu et cette vente remplace dsormais le produit B.

Cela signifie que la quantit totale vendue est la mme, ce que l'on peut constater dans le tableau crois dynamique maintenant dvelopp avec Prod comme troisime dimension:

128

Comme vous pouvez le dduire de l'absence du groupe de produits Z dans l'anne 2000, aucune table n'a t dconnecte. QlikView traite correctement les sous-totaux, c'est--dire que les deux occurrences de B chaque anne ne sont comptes qu'une fois dans les sous-totaux. C'est l'effet de la logique interne normale de QlikView. Dconnectons maintenant la table Trans, comme nous l'avons fait auparavant. Le tableau crois dynamique aura l'apparence suivante :

Une fois l'association dans la table Trans rompue, QlikView ne peut plus garder trace de ce qui a dj t comptabilis dans les sous-totaux. Les deux occurrences de B sont comptes deux fois et les sous-totaux sont trop levs. Cette situation doit tre vite, et les tables dconnectes doivent donc tre utilises avec prudence avec des dimensions non hirarchiques.

Remarque: Les Totaux (tels qu'ils sont dfinis sous l'onglet Expressions du graphique) sont configurs sur Total de l'expression (option par dfaut) dans tous les cas ci-dessus. Si la somme des lignes est utilise, il n'y a aucune diffrence entre les deux cas.

14.14 tats alternatifs


Description
QlikView permet aux utilisateurs de dtacher un graphique du modle de donnes sous-jacent. Lorsqu'un graphique est dtach, l'objet ne rpond plus aux slections de l'utilisateur. Si ce dernier rattache l'objet, celui-ci est instantanment mis jour pour reflter l'tat actuel des slections. Les tats alternatifs s'apparentent ce comportement. Le dveloppeur QlikView peut crer plusieurs tats au sein d'un document QlikView pour les appliquer des objets prcis contenus dans le document. L'utilisateur final a la possibilit de crer des copies de ces objets (objets serveur) afin de les dfinir dans des tats diffrents. La diffrence la plus significative entre le dtachement et les tats alternatifs est le fait que TOUS les objets dfinis dans un tat donn rpondent aux slections de l'utilisateur effectues dans l'tat en question. Les objets dfinis dans un tat donn ne sont pas affects par les slections que l'utilisateur effectue dans d'autres tats. Les tats alternatifs ne sont pas accessibles dans le script de chargement (load). Ils font partie des fonctions de l'interface utilisateur.

129

Le dveloppeur appelle la bote de dialogue tats alternatifs partir du bouton tats alternatifs... de la bote de dialogue Proprits du document: Gnral. Le dveloppeur QlikView peut crer un nombre indfini d'tats dans le document QlikView et attribue un nom chaque tat cr. Ds lors que la fonctionnalit d'tats alternatifs est active, le dveloppeur QlikView a la possibilit de crer de nouveaux tats partir d'objets l'cran. Les utilisateurs finaux qui ont accs aux documents QlikView partir d'un serveur QlikView peuvent utiliser les tats alternatifs existants, mais pas en crer d'autres.

Note ! La fonctionnalit d'tats alternatifs est active par un dveloppeur QlikView et doit tre utilise avec prudence car elle peut porter confusion auprs des utilisateurs finaux.

Identificateurs d'tat
Les noms des tats crs par le dveloppeur QlikView sont appels identificateurs d'tat. Deux tats sont disponibles en permanence: l'tat par dfaut et l'tat hrit. L'tat par dfaut est celui dans lequel la plupart des actions QlikView se produisent. Il est reprsent par le symbole $. Le document QlikView est toujours dfini dans l'tat par dfaut. Les objets peuvent hriter d'tats provenant d'objets de niveau suprieur, tels que les feuilles et les conteneurs. Autrement dit, les tats sont hrits dans l'ordre suivant: Document - Feuille - Objets de la feuille. Les feuilles et les objets de la feuille sont toujours dfinis dans l'tat hrit, moins que le dveloppeur QlikView ne remplace cet tat par un autre.

Comportement logique lors de l'utilisation des tats alternatifs


Un clic sur le bouton Effacer agit sur tous les tats. Toutefois, un lment de menu a t ajout au menu droulant du bouton Effacer pour permettre l'utilisateur d'effacer les slections d'un tat spcifique. Un clic sur les boutons Prcdent et Suivant agit sur tous les tats. Il n'existe aucun mcanisme permettant de faire dfiler des tats spcifiques vers l'avant ou vers l'arrire. Un clic sur les boutons Verrouiller et Dverrouiller agit sur tous les tats. Ces boutons ne permettent pas de verrouiller ni de dverrouiller des tats spcifiques. Il est possible de verrouiller des champs spcifiques d'tats grce au menu disponible sur clic droit des listes de slection d'un tat spcifique. Les lments du menu Slections s'appliquent tous les tats. Ce menu ne comporte aucun mcanisme permettant d'agir sur des tats spcifiques.

Fonctions des tats alternatifs


Les tats alternatifs se caractrisent par les fonctions suivantes:
l

l l

Aucune indication automatique ne s'affiche l'cran pour signaler les objets ou les expressions comportant (ou renvoyant ) des tats alternatifs. C'est au dveloppeur QlikView de dcider s'il souhaite fournir cette information l'utilisateur final l'aide de la fonction StateName(). Il est possible d'utiliser les tats alternatifs avec des objets lis. L'tat s'applique toutes les instances d'un objet. Le changement d'tat d'un objet li se rpercute sur les autres objets lis dfinis dans le mme tat. Les variables font partie de l'tat par dfaut. Les changements effectus dans les autres tats n'ont pas d'incidence sur les valeurs des variables. Les dclencheurs fonctionnent dans tous les tats. Il est possible de dfinir l'excution de certaines actions dans des tats prcis. L'action Excute une macro est une exception connue. Mme si cette action peut tre dfinie pour s'excuter dans un tat spcifique, les macros, elles, se dclenchent dans n'importe quel tat. Les objets faisant appel un tat manquant (qui a t supprim par un dveloppeur) sont rinitialiss sur l'tat par dfaut bien que la liste droulante tat alternatif affiche des informations de ce type: NomtatAlternatif <non disponible>.

130

15 Favoris
15.1 Types de favoris
L'tat actuel des slections peut tre enregistr sous la forme d'un favori pour tre rutilis ultrieurement. Les favoris capturent les slections dans tous les tats dfinis dans un document QlikView. Lorsque vous rappelez un favori cr dans la version 11 (ou ultrieure), les slections s'appliquent dans tous les tats. Il existe diffrents types de favoris: Favoris du document: stocks dans le document qvw. Ils sont toujours disponibles pour la personne qui ouvre le document localement ou partir de QlikView Server.

Favoris de l'utilisateur: stocks sparment, sur l'ordinateur de l'utilisateur. Ils seront seulement la disposition de l'utilisateur qui les a crs sur l'ordinateur o ils ont t crs. Si le document est dplac ou renomm, tous les favoris personnels qui y sont associs seront perdus. Favoris de serveur personnel: seulement disponibles en cas d'utilisation d'un document sur QlikView Server et uniquement pour les utilisateurs authentifis. Ils sont stocks dans un rfrentiel situ sur le serveur et sont accessibles l'utilisateur partir de n'importe quel ordinateur authentifi. seulement disponibles en cas d'utilisation d'un document sur QlikView Server et uniquement pour les utilisateurs authentifis. N'importe quel utilisateur qui a cr des favoris serveur personnels peut les dfinir comme partags. Ils seront alors accessibles aux autres utilisateurs. Comme les favoris de serveur personnels, les favoris de serveur partags sont stocks dans un rfrentiel sur le serveur.

Favoris partags sur le serveur:

15.2 Bote de dialogue Ajouter un favori


On peut enregistrer l'tat actuel des slections comme favori en choisissant Ajouter un favori dans le menu Favoris ou en appuyant sur CTRL+B. On peut aussi crer des favoris l'aide d'objets Favoris dans la disposition QlikView. Cela provoque l'affichage de la bote de dialogue Ajouter un favori. La bote de dialogue prsente un aspect lgrement diffrent selon que l'utilisateur travaille sur un document local ou sur un document situ sur le serveur QlikView. Commenons par dcrire la bote de dialogue pour les documents locaux, puis nous indiquerons les diffrences avec les documents de serveur.

Bote de dialogue Ajouter un favori pour les documents locaux

131

Nom du favori

Le nom par dfaut du favori cr est la date du jour. En outre, le premier favori cr un jour donn reoit le numro 1, le deuxime le numro 2 et ainsi de suite. On peut cependant remplacer le nom par dfaut par un texte plus explicite en indiquant un nom facultatif. Si l'on coche cette case, le favori sera enregistr avec le document. Cette option n'est disponible que pour les documents locaux. Si la case n'est pas coche, le favori sera cr comme favori de l'utilisateur et stock localement sur l'ordinateur.

Enregistrer ce favori dans le document

Inclure les slections dans Si cette case est coche, le favori inclura les slections faites dans l'application. le favori Appliquer en complment Si cette case est coche, le favori sera appliqu sans effacer au pralable les des slections actives slections existantes dans le document. Inclure l'tat de la disposition Si cette case est coche, le favori enregistrera des informations concernant la feuille partir de laquelle il a t cr et l'tat de tous les objets de cette feuille au moment de la cration du favori. Cela inclut par exemple un tableau crois dynamique sous forme rduite ou sous forme agrandie et un graphique en cycle. Lorsqu'on rappelle un favori comportant des informations de disposition, QlikView tente d'activer la feuille et de restaurer l'tat enregistr des objets. Cocher cette case inclura dans le favori la position actuelle du curseur.

Inclure les positions de dfilement Inclure les valeurs des zones de saisie Texte informatif

Si cette case est coche, les valeurs des champs de saisie seront stockes dans le favori. Dans la zone d'dition, vous pouvez saisir une description du favori ou un message afficher lors du rappel du favori. Si la case est coche, le texte informatif du favori (s'il en existe un) sera affich dans une fentre contextuelle chaque fois que l'on rappellera le favori.

Message info-bulle

Les diffrences pour les documents de serveur sont les suivantes:

132

Crer en tant que favori Si cette case est coche, le favori sera cr en tant que favori serveur personnel et serveur stock dans un catalogue sur le serveur. Cette option n'est disponible que si l'utilisateur est authentifi et condition que le serveur QlikView et le propritaire du document autorisent la cration de favoris serveur. Si la case n'est pas coche, le favori sera cr comme favori de l'utilisateur et stock localement sur l'ordinateur. Partager les favoris avec condition qu'un favori serveur personnel soit cr, le favori sera d'autres utilisateurs immdiatement partag avec d'autres utilisateurs authentifis du mme document de serveur si vous cochez cette case. Vous pouvez tout moment annuler le partage en dslectionnant la case cocher Partager sous l'onglet Mes favoris serveur de la bote de dialogue Favoris.

15.3 Bote de dialogue Favoris

La bote de dialogue Favoris prsente cinq onglets, comme lorsque vous travaillez sur un document du serveur.

Vous pouvez ouvrir la bote de dialogue Favoris l'aide de l'option Plus... du menu Favoris. Cette bote se compose de deux onglets (documents locaux) ou de cinq onglets (documents du serveur): un onglet pour les favoris du document, un pour les favoris de l'utilisateur, un autre pour les favoris serveur personnels (documents du serveur uniquement), un pour les favoris partags des autres utilisateurs (documents du serveur uniquement) et un dernier pour les favoris temporaires (documents du serveur uniquement). Pour plus d'informations sur les diffrents types de favoris, voir Types de favoris (page 131). En haut de la bote de dialogue, vous trouverez une liste de tous les favoris actuellement dfinis dans le document QlikView. Les favoris sont dcrits et peuvent tre classs en plusieurs colonnes: Afficher Activez cette option si vous souhaitez que le favori s'affiche dans les listes d'objets favori et dans le menu Favoris. Si la case n'est pas coche, le favori n'apparatra pas ces endroits, mais demeurera accessible par l'intermdiaire de cette bote de dialogue. Nom des favoris. Pour trier les favoris par ordre alphabtique, cliquez sur l'en-tte de cette colonne. Si vous cliquez deux fois, les favoris seront tris dans l'ordre alphabtique inverse.

Nom

133

Si cette case est coche pour un favori, ce favori sera appliqu sans que les slections existantes figurant dans le document soient effaces au pralable. Un favori peut seulement tre appliqu des slections existantes si celles-ci ne crent pas de conflit avec les slections du document. Si le favori a t cr avec les informations de disposition, cochez cette case pour activer le paramtre de disposition pour le favori ou dsactivez-la dans le cas contraire. Lorsque le paramtre de disposition est activ, le programme tente de recrer la disposition initiale du favori. Ce comportement implique le basculement vers la feuille approprie et la mise jour de la disposition de tous les objets figurant sur cette feuille. Vous ne pouvez pas utiliser ce paramtre pour ajouter des informations de disposition un favori pour lequel ce type d'informations n'a pas t enregistr sa cration.

Disposition

Cr ID

Date et heure auxquelles les favoris ont t crs. Numro d'identification unique du favori. sa cration, tout favori reoit un numro un numro d'identification unique afin de permettre le contrle par Interprteur de macros interne (page 961). Le premier favori de chaque type d'un document se voit attribuer l'ID BM01. Cela signifie qu'il est possible qu'un mme ID soit utilis par un favori de document et un favori de serveur. Un ID de favori peut tre remplac via l' Interprteur de macros interne (page 961) par toute autre chane, condition qu'elle ne soit pas dj utilise comme ID pour un autre favori, une feuille ou un objet du document. Renommer le favori ne change pas son numro d'identification. Exporter puis importer un favori crera un nouvel ID de favori. L'ID du favori peut tre prcd d'un prfixe qui dcrit son type (document, utilisateur, etc.).

Info-bulle

Si un texte informatif a t ajout au favori, cette option permet de l'afficher sous forme d'info-bulle. Si un texte informatif a t ajout au favori, il est affich ici. Cette case cocher est uniquement disponible dans l'onglet Mes favoris serveur. En le marquant comme l'un des favoris serveur personnels, vous rendrez ce favori accessible d'autres utilisateurs authentifis, sur ce document du serveur, via la page Favoris partags sur le serveur. Le favori est conserv sur la page Mes favoris serveur et il n'est pas visible sur la page Favoris partags sur le serveur. Vous pouvez tout moment annuler le partage en dslectionnant la case cocher.

Texte informatif Partager

Au bas de la bote de dialogue, vous trouverez diffrents boutons qui permettent d'effectuer des actions avec le favori slectionn dans la liste situe au-dessus. Slectionner Replace Affiche le favori slectionn l'cran. Remplace le favori slectionn par les slections actives. Seuls les favoris que vous avez crs peuvent tre remplacs.

134

Renommer

Ouvre la bote de dialogue Renommer le favori dans laquelle vous pouvez donner un nouveau nom au favori. Seuls les favoris que vous avez crs peuvent tre renomms. Supprime le favori slectionn. Seuls les favoris que vous avez crs peuvent tre supprims. Supprime tous les favoris de ce volet de la bote de dialogue. Seuls les favoris que vous avez crs peuvent tre supprims. Cliquez sur ce bouton si vous souhaitez utiliser la slection du favori en surbrillance comme tat d'effacement. Option permettant de modifier le texte informatif. Une fois que vous avez localis et slectionn un fichier de favori prcdemment enregistr (dot de l'extension .qbm), la bote de dialogue Importer des favoris (page 136) s'ouvre pour vous permettre d'importer des favoris. Ouvre la bote de dialogue Exporter des favoris (page 136) dans laquelle vous pouvez exporter les favoris slectionns vers un fichier de favoris QlikView (dot de l'extension .qbm). Dplace le favori slectionn d'un rang vers le haut dans la liste. Une autre solution consiste cliquer sur le favori et le faire glisser vers n'importe quel endroit de la liste. Dplace le favori slectionn d'un rang vers le bas dans la liste.

Supprimer

Effacer tout

Dfinir l'tat initial

diter les infos Importer

Exporter

Avancer

Abaisser

Dplacer les favoris de Ce texte apparat uniquement lorsque vous utilisez un document du serveur, sous l'utilisateur local vers le l'onglet Favoris de l'utilisateur. Cliquez dessus pour convertir tous les favoris de serveur l'utilisateur local en favoris serveur stocks dans le rfrentiel du serveur. Cette pratique est recommande, car les favoris serveur personnels demeurent accessibles via le serveur, mme en cas de changement d'ordinateur ou de changement de nom du document serveur. Avant de procder la conversion, vous tes invit confirmer l'opration. La conversion est intgrale (dans le document actif) et irrversible.

135

15.4 Exporter des favoris

Bote de dialogue Exporter des favoris

Dans la bote de dialogue Exporter des favoris, vous trouverez une liste de tous les favoris que vous avez dfinis dans le document actif. Seuls les favoris que vous avez cochs seront inclus au fichier de favoris exports (.qbm). Lorsque vous cliquez sur OK, le programme vous demande un nom et un emplacement pour le fichier de favoris. Une fois enregistr, le fichier de favoris peut tre conserv pour tre utilis ultrieurement ou distribu d'autres utilisateurs du mme document QlikView.

15.5 Importer des favoris


Les favoris sont imports dans un fichier de favoris via l'option Importer... du menu Favoris. Il ouvre une bote de dialogue de recherche o un fichier signet QlikView (extension .qbm) peut tre slectionn. La bote de dialogue Importer des favoris s'ouvre alors. Dans la bote de dialogue Importer des favoris, vous trouverez une liste de tous les favoris inclus dans le fichier signet slectionn.

Remarque: les favoris ne doivent tre imports que dans un document QlikView contenant des champs et des valeurs de champs auxquels ils font rfrence.

136

Bote de dialogue Importer des favoris

Favoris disponibles l'importation Favoris actuels

gauche, la bote de dialogue dresse la liste de tous les favoris qui ont t dfinis dans le fichier sign. droite, la bote de dialogue affiche la liste des favoris de l'utilisateur ou du document existants. Les favoris doivent tre imports en tant que favoris de l'utilisateur ou en tant que favoris du document. Les boutons d'option en haut de la bote de dialogue dfinissent le mode d'importation du signet. Mettez en surbrillance un ou plusieurs favoris dans la liste Favoris disponibles l'importation, puis appuyez sur ce bouton pour les importer. Ouvre la bote de dialogue Renommer le favori dans laquelle vous pouvez spcifier, avant l'importation, un nouveau nom pour le favori en surbrillance.

Importer

Renommer

137

15.6 tats alternatifs et favoris


Les favoris capturent les slections dans tous les tats dfinis dans le document QlikView. Lorsque vous rappelez un favori cr dans la version 11 (ou ultrieure), les slections s'appliquent dans tous les tats. Il est possible d'utiliser des tats spcifiques contenus dans un favori au sein d'une expression. Par exemple, cette expression calcule les ventes de l'ensemble gnr par les slections dfinies dans le favori BM01 pour l'tat du groupe1.

Exemple:
sum({[Groupe 1]::BM01} Ventes) Remarque: Les favoris figurant dans des documents QlikView crs dans des versions antrieures la version11 contiennent un tat par dfaut uniquement lors de leur utilisation dans QlikView11. Les favoris crs ou modifis dans la version11 de l'application comportent tous les tats. Lorsque ces favoris sont utiliss dans une version antrieure la version11, les tats supplmentaires sont tout simplement ignors. Remarque: Les favoris qui font rfrence un tat inexistant (suite sa suppression par un dveloppeur) ne tiendront pas compte de cet tat.

138

16 Rapports
Imprimer un rapport revient souvent imprimer une table ou un graphique. Dans QlikView, il suffit pour cela de slectionner un objet, puis de choisir Imprimer dans un menu ou dans la barre d'outils. Parfois cependant, on a besoin de produire des rapports plus complexes incluant plusieurs graphiques et/ou tables. C'est l que l'diteur de rapports QlikView intervient. L'diteur de rapports QlikView donne la possibilit de grouper un certain nombre d'objets diffrents sur une ou plusieurs pages en matrisant totalement la disposition de la page, y compris les en-ttes/pieds de page, etc. Les rapports QlikView existent en deux versions, les rapports du document et les rapports utilisateur. Rapports de document Ils sont crs avec le document QlikView et stocks dans le fichier QVW. Tout utilisateur accdant au document QlikView, localement ou par un serveur QlikView, peut accder aux rapports du document. Ils sont crs par un utilisateur qui travaille sur un document partir d'un serveur QlikView. Le rapport est stock sur l'ordinateur local du client de la mme manire que les favoris de l'utilisateur. Seul l'utilisateur local a accs ses propres rapports utilisateur. Les rapports utilisateur ne peuvent tre crs qu' partir de clients QlikView fonctionnant sous Windows (pas partir de clients AJAX). seulement disponibles en cas d'utilisation d'un document sur QlikView Server et uniquement pour les utilisateurs authentifis. Ils sont stocks dans un rfrentiel situ sur le serveur et sont accessibles l'utilisateur partir de n'importe quel ordinateur authentifi.

Rapports utilisateur

Mes rapports serveur

Rapports partags sur le seulement disponibles en cas d'utilisation d'un document sur QlikView Server et serveur uniquement pour les utilisateurs authentifis. N'importe quel utilisateur qui a cr un rapport de serveur personnel peut le dfinir comme partag. Il sera alors accessible aux autres utilisateurs. Comme Mes rapports serveur, les rapports partags sur le serveur sont stocks dans un rfrentiel sur le serveur.

Remarque: Lorsqu'on utilise le terme Gnrateur de rapports, on fait habituellement rfrence une catgorie bien dfinie de logiciels. Ils fonctionnent en gnral en combinant des donnes de plusieurs requtes SQL (plus ou moins caches l'utilisateur au moyen d'interfaces graphiques), chacune d'elle tant formate pour l'impression de diffrentes faons. Les rapports QlikView vont chercher leurs donnes dans les objets QlikView et ne peuvent pas les tirer de requtes SQL. S'il est tout fait correct de dire que QlikView peut produire des rapports, il est en revanche incorrect d'assimiler l'diteur de rapports de QlikView un gnrateur de rapports au sens habituel du terme.

16.1 Menu Rapports


Le menu Rapports situ en haut de l'cran QlikView contient la commande diter des rapports... qui ouvre la bote de dialogue diteur de rapports (page 140) dans laquelle vous pouvez crer de nouveaux rapports ou modifier des rapports existants. Cette bote de dialogue vous permet galement de supprimer et slectionner des rapports, de concevoir leur disposition, d'ajouter des pages et des images, etc. L'diteur de rapports rpertorie tous les rapports disponibles pour une slection immdiate. Les rapports peuvent tre des rapports de document, stocks avec le document ou des rapports utilisateur, stocks sparment sur l'ordinateur de l'utilisateur. Voir diteur de rapports (page 140).

139

16.2 diteur de rapports


La bote de dialogue diteur de rapports comprend deux pages, la liste des rapports et l'diteur de pages. Lors de la premire ouverture de l'diteur de rapports, c'est la liste des rapports qui s'affiche.

Liste des rapports

Page Liste des rapports de la bote de dialogue diteur de rapports

La page Liste des rapports sert grer les rapports. Vous pouvez y crer de nouveaux rapports et supprimer des rapports existants. Vous pouvez galement y slectionner un rapport afin d'en modifier les pages dans l'diteur. Une liste droulante et une liste des rapports s'affichent en haut de la page. La liste droulante est utilise pour les fonctions suivantes:

140

Rapports disponibles

Rapports de document Ouvre une liste de tous les rapports de document dans le document actif. Le fait de cliquer sur l'un des noms de rapport ouvre la bote de dialogue Imprimer en vue d'imprimer le rapport. Rapports utilisateur Ouvre une liste de tous les rapports utilisateur, stocks sparment sur l'ordinateur de l'utilisateur. Le fait de cliquer sur l'un des noms de rapport ouvre la bote de dialogue Imprimer en vue d'imprimer le rapport. Mes Rapports Serveur Les rapports de serveur personnels sont seulement disponibles en travaillant avec un document sur QlikView Server et seulement pour les utilisateurs authentifis. Ils sont stocks dans un rfrentiel sur le serveur et sont accessibles l'utilisateur partir de n'importe quel ordinateur authentifi. Rapports partags sur le serveur Ces rapports sont uniquement disponibles dans le cadre d'un document stock sur QlikView Server et seulement pour les utilisateurs authentifis. N'importe quel utilisateur qui a cr un rapport de serveur personnel peut le dfinir comme partag. Il sera alors accessible aux autres utilisateurs. Comme les rapports de serveur personnels, les rapports de serveur partags sont stocks dans un rfrentiel sur le serveur.

Les rapports peuvent tre des rapports de document, stocks avec le document ou des rapports utilisateur, stocks sparment sur l'ordinateur de l'utilisateur. Dans la liste droulante Rapports disponibles situe en haut de l'cran diteur de rapports, vous slectionnez si Rapports de document ou Rapports utilisateur doit apparatre dans la liste. . Pour les documents locaux, vous pouvez choisir entre Mes Rapports Serveur, Rapports partags et Rapports utilisateur. La liste elle-mme comporte plusieurs colonnes: Afficher Activez cette option si vous souhaitez que le rapport figure dans le menu Rapports. Si la case n'est pas coche, le rapport n'apparatra pas, mais demeurera accessible par l'intermdiaire de cette bote de dialogue. Nom du rapport. Numro d'identification unique du rapport (voir ci-dessous). Nombre de pages actuellement dfinies dans le rapport. Cette case cocher est uniquement disponible dans la liste Mes Rapports Serveur. En le marquant comme l'un de vos rapports serveur personnels, ce rapport devient accessible d'autres utilisateurs authentifis du mme document de serveur, dans leur liste Rapports partags sur le serveur. Le rapport reste dans la liste Mes Rapports Serveur et ne figure pas dans la liste Rapports partags sur le serveur. tout moment, vous pouvez dsactiver la case cocher pour rvoquer le partage. Nom authentifi de l'auteur du rapport.

Nom ID Pages Partager

Auteur

141

Ajouter...

Appuyez sur ce bouton pour crer un nouveau rapport. Si l'option Rapports de document est slectionne au-dessus de la Liste des rapports, le nouveau rapport concernera le document. Si, au contraire, l'option Rapports utilisateur est slectionne, le nouveau rapport sera un rapport utilisateur. La bote de dialogue Nouveau rapport s'ouvre pour que vous puissiez donner un nom votre rapport. Cochez l'option Copier des pages d'un autre rapport et choisissez un rapport existant dans le menu droulant afin de copier des pages partir de ce rapport. Cliquez sur ce bouton pour supprimer le rapport slectionn dans la Liste des rapports. Cliquez sur ce bouton pour monter le rapport slectionn d'un cran dans la Liste des rapports. Cliquez sur ce bouton pour abaisser le rapport slectionn d'un cran dans la Liste des rapports.

Supprimer

Promouvoir

Abaisser

Dplacer les rapports de Ce texte n'apparat que lorsque vous travaillez avec un document serveur et que l'utilisateur local vers le vous avez slectionn Rapports utilisateur dans le haut de la liste droulante. serveur Cliquez dessus pour convertir tous les rapports utilisateur locaux en rapports serveur stocks dans le rfrentiel du serveur. Cette pratique est recommande, car les rapports serveur personnels demeurent accessibles via le serveur, mme en cas de changement d'ordinateur ou de changement de nom du document serveur. Avant de procder la conversion, vous tes invit confirmer l'opration. La conversion est intgrale (dans le document actif) et irrversible. diter >> Appelle l'diteur de pages relatif au rapport slectionn. Cliquer sur ce bouton quivaut double-cliquer sur un rapport dans la Liste des rapports.

142

diteur de pages

Page de l'diteur de pages de la bote de dialogue diteur de rapports

La page diteur de pages sert dfinir les pages du rapport slectionn sous l'onglet Rapports. Cet onglet comprend deux volets et une barre d'outils pour vous aider concevoir vos pages de rapport. Dans la partie infrieure, vous trouverez les boutons suivants: Liste des rapports>> Vous ramne la page Liste des rapports.

Menu dition
Copier Copie l'lment slectionn et la page active dans le rapport. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Colle le rapport partir du Presse-papiers. Colle la page partir du Presse-papiers. Colle l'lment partir du Presse-papiers. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Affiche une grille dans le rapport afin de faciliter l'alignement des lments du rapport.

Coller le rapport Coller la page Coller les lments

Aligner sur la grille

143

Menu Rapports
Ajouter Ajoute un rapport. Uniquement disponible lors de l'affichage de la Liste des rapports. Supprime le rapport. Uniquement disponible lors de l'affichage de la Liste des rapports. Dplace le rapport slectionn d'un cran vers le haut dans la liste des rapports. Uniquement disponible lors de l'affichage de la Liste des rapports. Dplace le rapport slectionn d'un cran vers le bas dans la liste des rapports. Uniquement disponible lors de l'affichage de la Liste des rapports. Enregistre le fichier du rapport en tant que document XML. Uniquement disponible lors de l'affichage de la Liste des rapports. Importe un rapport pralablement enregistr au format XML. Uniquement disponible lors de l'affichage de la Liste des rapports. Ouvre la bote de dialogue Aperu avant impression dans laquelle vous pouvez visualiser la manire dont le rapport sera imprim avec les slections actuelles dans le document QlikView. Ouvre la bote de dialogue Imprimer et imprime le rapport actif. Ouvre la bote de dialogue diteur de rapports: Bote de dialogue Paramtres du rapport (page 149) dans laquelle vous pourrez dfinir diffrentes proprits du rapport. Il s'agit des marges, du paramtre en-tte/pied de page, etc.

Supprimer

Promouvoir

Abaisser

Exporter

Importer

Aperu avant impression...

Imprimer... Paramtres du rapport

Menu Page
Promouvoir Dplace la page slectionne un cran vers le haut. Une autre solution consiste faire glisser la page dans le volet de la liste des pages et de la dposer l'endroit voulu. Abaisse la page slectionne. Une autre solution consiste faire glisser la page dans le volet de la liste des pages et de la dposer l'endroit voulu. Ajoute une page extensible aprs la page slectionne.

Abaisser

Ajouter une page multiple Ajouter une seule page Supprimer Paramtres de la page

Ajoute une page simple aprs la page slectionne. Supprime la page slectionne. Ouvre la bote de dialogue diteur de rapports: Bote de dialogue Paramtres de la page (page 153) dans laquelle vous pourrez dfinir diffrentes proprits pour la page slectionne.

144

Menu lment
Aligner gauche Uniquement disponible lorsqu'au moins deux objets d'impression sont slectionns ( l'aide des touches CTRL+clic). Aligne les objets slectionns gauche. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Uniquement disponible lorsqu'au moins deux objet d'impression sont slectionns. Centre les objets slectionns horizontalement. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Uniquement disponible lorsqu'au moins deux objets d'impression sont slectionns ( l'aide des touches CTRL+clic). Aligne les objets slectionns droite. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Uniquement disponible lorsqu'au moins deux objets d'impression sont slectionns ( l'aide des touches CTRL+clic). Aligne les objets slectionns sur le bas. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Uniquement disponible lorsqu'au moins deux objet d'impression sont slectionns. Aligne les objets slectionns en leur centre sur l'axe vertical. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Uniquement disponible lorsqu'au moins deux objets d'impression sont slectionns ( l'aide des touches CTRL+clic). Aligne les objets slectionns sur le haut. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Uniquement disponible lorsqu'au moins deux objet d'impression sont slectionns. Rpartit les objets slectionns sur l'axe horizontal pour laisser des espaces quivalents entre eux. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Uniquement disponible lorsqu'au moins deux objet d'impression sont slectionns. Rpartit les objets slectionns sur l'axe vertical pour laisser des espaces quivalents entre eux. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Uniquement disponible lorsqu'au moins deux objet d'impression sont slectionns. Dispose les objets actifs partir du bord vertical de l'objet le plus gauche avec un minimum d'espace entre chacun d'eux. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet.

Centrer horizontalement

Aligner droite

Aligner en bas

Centrer verticalement

Aligner en haut

Espacer horizontalement

Espacer verticalement

Ajuster gauche

145

Ajuster en haut

Uniquement disponible lorsqu'au moins deux objet d'impression sont slectionns. Dispose les objets actifs partir du bord suprieur de l'objet le plus en haut avec un minimum d'espace entre chacun d'eux. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Uniquement disponible lorsqu'au moins deux objets d'impression sont slectionns ( l'aide des touches CTRL+clic). Applique la mme largeur tous les lments slectionns. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Uniquement disponible lorsqu'au moins deux objets d'impression sont slectionns ( l'aide des touches CTRL+clic). Applique la mme hauteur tous les lments slectionns. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Cre un nouvel objet Texte dans un endroit cach du document), puis ouvre la bote de dialogue Proprits de l'objet Texte pour la slection d'une image. L'image apparatra sous la forme d'un lment d'impression normal dans le volet d'aperu des pages, o il peut tre dplac et dimensionn tout comme n'importe quel autre lment d'impression. Cre un nouvel objet texte (dans un endroit cach du document), puis ouvre la bote de dialogue Proprits de l'objet texte permettant de modifier ses proprits. L'objet texte apparatra sous la forme d'un lment d'impression normal dans le volet d'aperu des pages, o il peut tre dplac et dimensionn tout comme n'importe quel autre lment d'impression. Cre un objet slections actives pour le rapport. Les slections actives apparatront dans le volet d'aperu des pages sous la forme d'un lment d'impression normal, qui peut tre dplac et dimensionn tout comme n'importe quel autre lment d'impression. Supprime les lments slectionns. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Ouvre la bote de dialogue diteur de rapports: Bote de dialogue Paramtres de l'lment (page 156) dans laquelle vous pouvez dfinir les diffrentes proprits de l'lment d'impression slectionn. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet.

Mme Largeur

Mme Hauteur

Nouvelle image...

Nouveau texte...

Nouvelles slections actives

Supprimer

Paramtres de l'lment...

Au bas des deux volets, des icnes associes certaines fonctions des diffrents menus sont disponibles: Paramtres de la page Ouvre la bote de dialogue diteur de rapports: Bote de dialogue Paramtres de la page (page 153) dans laquelle vous pouvez dfinir les diffrentes proprits de l'lment d'impression slectionn. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Supprime la page mise en surbrillance.

Supprimer

146

Ajouter Paramtres de l'lment

Ajoute une page simple ou une page extensible aprs la page slectionne. Ouvre la bote de dialogue diteur de rapports: Bote de dialogue Paramtres de l'lment (page 156) dans laquelle vous pouvez dfinir les diffrentes proprits de l'lment d'impression slectionn. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Supprime l'lment mis en surbrillance. Ajoute une nouvelle image, un nouveau texte ou un nouveau tampon de slections.

Supprimer Ajouter

Volet Liste des pages


gauche, vous trouverez la liste de toutes les pages du rapport. Les rapports QlikView peuvent contenir deux types de pages diffrents: les pages simples et les pages extensibles. On peut ajouter autant de pages que l'on veut un rapport et y mlanger les deux types de pages.

Pages simples
Une page simple peut contenir un certain nombre d'objets. La page sera toujours imprime sur une seule page papier (ou PDF) et les objets devront tre rtrcis ou tronqus pour tenir sur la page. Des objets pourront se superposer sur la page. On peut ajouter du texte supplmentaire.

Pages extensibles
Une page extensible peut contenir un objet susceptible de s'tendre sur plusieurs pages papier (ou PDF), selon la quantit de donnes imprimer. On utilise gnralement une page extensible quand on imprime de grandes tables. En plus des objets taille dynamique, vous pouvez ajouter des objets taille fixe en introduction et/ou en annexe de la page. Ces zones fonctionnent exactement comme les pages simples.

Manipulation de la liste des pages


Pour slectionner une page modifier, cliquez dessus dans la liste. Un certain nombre de commandes de la barre d'outils sont directement associes au volet Liste des pages: Ajouter une page simple Ajoute une page simple aprs la page slectionne. Ajouter une page extensible Supprimer la page Promouvoir la page Abaisser la page Ajoute une page extensible aprs la page slectionne.

Supprime la page slectionne. Monte la page slectionne d'un cran dans la liste. Vous pouvez aussi dplacer la page dans la liste des pages par glisser-dposer. Abaisse la page slectionne d'un cran dans la liste. Vous pouvez aussi dplacer la page dans la liste des pages par glisser-dposer.

Volet Aperu des pages


droite du volet Liste des pages, un aperu de la page slectionne dans la liste s'affiche.

147

Ajout d'objets de feuille au rapport


Il vous suffit de faire glisser ou de double-cliquer sur un objet de feuille dans la disposition pour l'insrer dans l'aperu de la page du rapport. Les objets d'impression apparatront dans l'aperu tels qu'ils se prsentent dans le modle de disposition QlikView. L'apparence exacte de l'objet dans le rapport refltera bien sr l'apparence de l'objet dans le modle de disposition au moment de l'impression, selon les modifications des proprits et des donnes slectionnes. Il est possible de slectionner plusieurs objets dans le modle de disposition et de les faire glisser ensemble dans le rapport. Attention: on ne peut ajouter qu'un seul objet d'impression la zone dynamique centrale d'une page extensible!

Dimensionnement et positionnement des objets d'impression sur la page


Une fois ajout, l'objet apparatra dans le volet d'aperu des pages. Il est entour d'une bordure et d'emplacements chaque coin pour indiquer qu'il est slectionn. Pointez dessus et dplacez-le l'endroit voulu. Utilisez les emplacements de coin pour en ajuster la taille. Une ligne en pointill marque les marges actuelles. Aucun objet d'impression ne peut tre plac en dehors de ces marges.

Navigation et slection des objets d'impression sur la page


Pour slectionner un objet d'impression, cliquez dessus. Une fois que vous avez slectionn un objet d'impression, vous pouvez passer l'objet suivant l'aide de la touche TAB (ou la combinaison MAJ+TAB pour revenir en arrire). Pour slectionner plusieurs objets, cliquez sur chacun d'eux en maintenant la touche MAJ enfonce. Dans les pages extensibles, vous pouvez faire glisser des objets d'impression d'une zone l'autre. Lorsqu'un ou deux lments sont mis en surbrillance dans le volet d'aperu, les commandes de la barre d'outils d'alignement deviennent disponibles. Uniquement disponible lorsqu'au moins deux objets d'impression sont slectionns ( l'aide des touches CTRL+clic). Aligne les objets slectionns sur le haut. Centrer verticalement Uniquement disponible lorsqu'au moins deux objet d'impression sont slectionns. Aligne les objets slectionns en leur centre sur l'axe vertical. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Aligner en bas Uniquement disponible lorsqu'au moins deux objets d'impression sont slectionns ( l'aide des touches CTRL+clic). Aligne les objets slectionns sur le bas. Aligner gauche Uniquement disponible lorsqu'au moins deux objets d'impression sont slectionns ( l'aide des touches CTRL+clic). Aligne les objets slectionns gauche. Centrer horizontalement Uniquement disponible lorsqu'au moins deux objet d'impression sont slectionns. Centre les objets slectionns horizontalement. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Aligner droite Uniquement disponible lorsqu'au moins deux objets d'impression sont slectionns ( l'aide des touches CTRL+clic). Aligne les objets slectionns droite. Espacer horizontalement Uniquement disponible lorsqu'au moins deux objet d'impression sont slectionns. Rpartit les objets slectionns sur l'axe horizontal pour laisser des espaces quivalents entre eux. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Aligner en haut

148

Espacer verticalement

Ajuster gauche

Ajuster en haut

Uniquement disponible lorsqu'au moins deux objet d'impression sont slectionns. Rpartit les objets slectionns sur l'axe vertical pour laisser des espaces quivalents entre eux. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Uniquement disponible lorsqu'au moins deux objet d'impression sont slectionns. Dispose les objets actifs partir du bord vertical de l'objet le plus gauche avec un minimum d'espace entre chacun d'eux. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet. Uniquement disponible lorsqu'au moins deux objet d'impression sont slectionns. Dispose les objets actifs partir du bord suprieur de l'objet le plus en haut avec un minimum d'espace entre chacun d'eux. galement disponible en tant que commande via un clic droit dans le volet d'aperu de l'onglet.

Commandes de barre d'outils


Deux commandes de barre d'outils sont associes directement au volet d'aperu des pages: Active ou dsactive la grille de conception. Active galement la fonction d'alignement sur la grille. Lorsque la grille de conception et l'alignement sur la grille sont activs, il est plus facile d'aligner les objets sur la page, mais le contrle de leur position est moins prcis. Zoom Cette liste droulante permet d'indiquer un niveau de zoom pour l'ensemble de l'aperu. Plus le niveau de zoom est important, plus il est facile de disposer les objets. Certains boutons de la barre d'outils permettent galement d'imprimer le rapport partir de la bote de dialogue diteur de rapports. Grille de conception Aperu avant impression Cliquez sur ce bouton pour ouvrir la bote de dialogue Aperu avant impression et visualiser la manire dont le rapport sera imprim avec les slections actives dans le document QlikView. Ce bouton est aussi disponible partir de l'onglet Pages de la bote de dialogue diteur de rapports. Imprimer Cliquez sur ce bouton pour ouvrir la bote de dialogue Imprimer et imprimer le rapport actif. Ce bouton est aussi disponible partir de l'onglet Pages de la bote de dialogue diteur de rapports. Copier Copie le rapport, la page ou l'lment mis en surbrillance. Coller Colle le rapport, la page ou l'lment mis en surbrillance.

Enfin, un bouton de barre d'outils permet de coller les rapports, pages et lments copis.

diteur de rapports: Bote de dialogue Paramtres du rapport


Dans cette bote de dialogue, vous trouverez les paramtres gnraux du rapport (non lis des pages). La bote de dialogue est compose de quatre onglets.

149

Onglet Paramtres

Paramtres du rapport, onglet Paramtres

Cet onglet contient les proprits de base du rapport: Nom Nom du rapport. Cela peut-tre une chane de caractres. Le nom peut tre attribu par une formule calcule pour une mise jour dynamique. ID unique du rapport. Concernant la cration, pour tous les objets intgrs un rapport un ID unique est allou pour un contrle par automatisation. Par dfaut un ID est une combinaison de lettres dfinissant le type d'objet et un nombre. Le premier rapport d'un document aura l'ID : RP01. Un ID peut-tre chang par une autre chane de caractres s'il elle n'est pas employe pour un autre rapport, objet, feuille, favori ou alerte dans le document. Ce champ de commentaire permet l'auteur du rapport d'indiquer l'objectif du rapport, dtailler son contenu. Ce champ n'est pas utilisable l'extrieur de cette bote de dialogue.

ID de rapport

Commentaire

Format de papier prfr Dans cette liste droulante vous pouvez spcifier la taille du papier prvu pour le rapport. La slection des dimensions du type de papier apparatra sur l'cran de prvisualisation. Si le rapport finalement est imprim sur une autre dimension de papier que celle du rapport original, QlikView essaiera d'adapter les contenus par modification de l'chelle pour correspondre la taille du nouveau support.

150

Affichage conditionnel

Si cette case est coche, le rapport sera affich ou masqu dynamiquement en fonction de la valeur de l'expression conditionnelle saisie dans la zone d'dition droite. L'expression conditionnelle sera value chaque gnration de la liste des rapports disponibles. Le rapport ne sera accessible que si la condition renvoie vrai. Les utilisateurs dots des privilges d'administrateur (ADMIN) pour le document peuvent outrepasser toutes les conditions d'affichage grce l'option Afficher tous les objets et feuilles de la bote de dialogue Proprits du document: Scurit (page 459). Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+MAJ+S.

Onglet Marges

Paramtres du rapport, onglet Marges

Cet onglet contient les paramtres de marge du rapport. Ces options sont les mmes que celles de la page Imprimer: Disposition (page 106) de la bote de dialogue Imprimer.

151

Onglet En-tte/Pied de page

Paramtres du rapport, onglet En-tte/Pied de page

Cet onglet contient les proprits d'en-tte/pied de page du rapport. Ces options sont les mmes que celles de la page Imprimer: En-tte/Pied de page (page 108) de la bote de dialogue Imprimer.

Onglet Slections

152

Paramtres du rapport, onglet Slections

Cet onglet contient les paramtres de slection utiliser l'impression du rapport : Slection initiale Impression du rapport selon le bouton radio slectionn. Quelques soit le paramtre employ, les slections effectues avant l'impression du rapport seront rtablies aprs l'impression. Utilisation des slections actives pour l' impression par dfaut du rapport. Les slections en cours dans le document seront effaces avant l'impression du rapport. la fin de l'impression, les slections d'origines seront rtablies. Un favori peut-tre slectionn dans le liste droulante et appliqu avant l'impression du rapport. la fin de l'impression, les slections d'origines seront rtablies.

Slections actives
Effacer tout

Slections actives

Imprimer le rapport avec Lorsque cette case est coche, le rapport est imprim successivement pour chaque toutes les valeurs valeur spcifie dans le champ de la liste droulante ci-dessous. S'il n'y a aucune possibles du champ valeur possible dans le champ indiqu, rien ne sera imprim. la fin de l'impression, les slections d'origines seront rtablies. S'il y a numrotation des pages, celle-ci sera continue sur toutes les pages imprimes.

diteur de rapports: Bote de dialogue Paramtres de la page


Cette bote de dialogue contient les paramtres de la page actuellement slectionne. Cette bote de dialogue a trois onglets.

Gnral

Paramtres de la page, onglet Gnral

Cet onglet contient les proprits de base de la page:

153

Orientation

Chaque page peut avoir une orientation diffrente. Choisissez l'orientation entre Portrait et Paysage. Ce choix est visible dans le panneau de visualisation cidessus. Dfinissez si le rapport doit tre imprim au format Page unique ou Pages multiples (pour les tableaux longs). Ce paramtre est disponible seulement pour une page extensible. Utiliser le format de papier appropri Aucune mise l'chelle de l'imprim. Le nombre de pages ncessaires sera utilis lors l'impression. Mette l'chelle x % L'imprim utiliseraune chelle reprsentant un pourcentage de sa taille originale. Le nombre de pages ncessaires sera utilis lors l'impression. Adapter aux pages x par y L'objet feuille sera imprim avec une chelle correspondant au nombre de pages fix.

Type de page

Ajuster l'impression au papier

Paramtres

Paramtres de la page, onglet Gnral

Cet onglet contient les paramtres concernant les zones d'introduction et d'annexe des pages extensibles. Cette fonctionnalit n'est pas disponible pour les pages simples. Utiliser introduction et annexe Activez cette option pour ajouter des lments d'impression de taille fixe dans un contenu de taille dynamique sur une page extensible. Ce faisant, vous perdrez malheureusement la compatibilit avec les versions de QlikView antrieures la version 7.5.

154

Positionnement de l'introduction

En cochant une, deux ou trois des cases cocher, vous pouvez dcider d'imprimer la zone d'introduction sur la premire page, sur toutes les pages intermdiaires et/ou sur la dernire page.

Hauteur de l'introduction Dfinir sur chaque pages la hauteur assign pour le placement de l'introduction. Le nombre est donn en % de la zone imprimable disponible (hauteur du papier moins l'en-tte et le pied de page). Ce paramtre peut galement tre modifi en faisant glisser la bordure directement dans le volet d'aperu des pages. Dcalage de l'introduction Dfinit l'espacement entre la zone d'introduction et la zone principale. La valeur est indique en pourcentage de la zone d'impression disponible (hauteur de papier moins zones d'en-tte/pied de page). En cochant une, deux ou trois des cases, vous pouvez dcider d'imprimer la zone d'annexe sur la premire page, sur toutes les pages intermdiaires et/ou sur la dernire page. Dfinir sur chaque pages la hauteur assign pour le placement de l'annexe. Le nombre est donn en % de la zone imprimable disponible (hauteur du papier moins l'en-tte et le pied de page). Ce paramtre peut galement tre modifi en faisant glisser la bordure directement dans le volet d'aperu des pages. Dfinit l'espacement entre la zone d'introduction et la zone principale. La valeur est indique en pourcentage de la zone d'impression disponible (hauteur de papier moins zones d'en-tte/pied de page).

Positionnement de l'annexe

Hauteur de l'annexe

Dcalage de l'annexe

Tranches

Paramtres de la page, onglet Tranches

Cet onglet contient les proprits d'impression groupe de la page. Cela signifie que la page est imprime pour chaque valeur possible d'un champ indiqu. Quand la case Imprimer la page avec toutes les valeurs possibles du champ est coche, la page est imprime plusieurs fois avec toutes les valeurs possibles pour le champ spcifi dans la liste droulante cidessous. S'il n'y a aucune valeur possible dans le champ indiqu, rien ne sera imprim. Remarque : si cette option a galement t spcifie au niveau du rapport (voir Onglet Slections (page 152)) vous risquez d'tre dans une situation o la slection du rapport exclut toutes les valeurs au niveau de la page. La page

155

sera alors saute pour cette valeur du rapport. la fin de l'impression, les slections d'origines seront rtablies. S'il y a numrotation des pages, celle-ci sera continue sur toutes les pages imprimes.

diteur de rapports: Bote de dialogue Paramtres de l'lment


Dans cette boite de dialogue, vous trouverez les paramtres d'impression des lments (objets) actuellement slectionns dans la page d'aperu avant impression. La bote de dialogue est compose de deux onglets.

Gnral

Paramtres de l'lment, onglet Gnral


L'onglet Gnral contient les paramtres de l'lment d'impression slectionn dans le volet d'aperu des pages.
ID de l'objet Proprits... ID de l'objet de la feuille imprimer. Ouvre la boite de dialogue des Proprits de l'objet de la feuille associe avec l'lment de l'impression. Les modifications apportes dans cette bote de dialogue sont appliques l'objet rel et prises en compte dans le rapport imprim. Ce contrle est seulement disponible pour les objets sur une page simple. Ici vous pouvez slectionner comment dimensionner convenablement l'objet imprimer l'intrieur du rectangle qui lui a t assign. Ne redimensionne pas l'objet imprimer. S'il est trop large pour tenir dans le rectangle il sera tronqu. S'il est trop petit il y aura un espace vide autour de lui. Dimensionne l'objet imprimer pour qu'il remplisse le rectangle. Dimensionne l'objet imprimer pour qu'il remplisse le rectangle tout en gardant le ratio original de l'objet de la feuille. Normalement l'objet est imprim sur la feuille sans cadre et sans bordure. En slectionnant cette case cocher, vous pouvez avoir une bordure autour de l'objet. Cliquez ce bouton pour slectionner la couleur du cadre.

tirer

Tronquer

Remplir Proportionnel

Afficher la bordure

Couleur du cadre

156

Largeur du cadre

Ici vous pouvez spcifier l'paisseur de la bordure.

Position

Paramtres de l'lment, onglet Position

L'onglet Position contient des paramtres de positionnement et de dimensionnement des objets dans la zone d'impression disponible. Left Dfinit la position des lments actuellement slectionns par rapport la marge de gauche. 0 est la position la plus gauche de la zone d'impression disponible. Dfinit la position des lments actuellement slectionns par rapport au haut. 0 est le haut de la zone d'impression disponible. Dfinit la taille des lments actuellement slectionns en millimes de la largeur de la zone d'impression disponible. Dfinit la taille des lments actuellement slectionns en millimes de la hauteur de la zone d'impression disponible. Dfinit la couche des lments actuellement slectionns. Si des lments se chevauchent, l'lment situ au niveau infrieur (1) est imprim en premier, puis la couche est imprime et ainsi de suite.

Haut

Largeur

Hauteur

Niveau Zro

157

158

17 Alertes
17.1 Cration d'alertes
Le moyen le plus simple de dfinir une alerte consiste utiliser l'Assistant Alerte, accessible partir du menu Outils. Vous pouvez galement crer et grer des alertes via la bote de dialogue Alertes, disponible partir du menu Outils. Les alertes sont stockes avec le document QlikView. Elles peuvent uniquement tre cres et dclenches partir des versions Windows de QlikView (et donc pas partir des clients AJAX).

17.2 Utilisation des alertes


Les vrifications d'alertes QlikView peuvent tre dclenches de trois manires diffrentes: 1. Automatiquement, dans une disposition QlikView, lorsque les donnes du document ont probablement chang, c'est--dire lorsque le document est ouvert, que le script a t excut ou qu'une opration Rduire les donnes a t effectue. 2. Manuellement partir d'une macro par le biais d'interfaces API d'automatisation spciales. Veuillez vous rfrer au guide API de QlikView pour plus de dtails. 3. Des programmes extrieurs excutant QlikView en mode de traitement par lots ont une interface API d'automatisation spciale pour rcuprer une liste des alertes dclenches dans un contexte donn. La suite d'vnements que provoque le dclenchement d'une alerte peut tre schmatise de la faon suivante:

Une fois dclenches, les alertes peuvent tre suspendues jusqu' ce qu'un changement intervienne. Par exemple, il peut tre agaant de se voir rappeler chaque ouverture d'un document que l'objectif budgtaire a t atteint. Dans ce cas, vous pouvez demander ce que l'alerte ne se dclenche qu'une seule fois et soit suspendue ensuite jusqu'au mois suivant.

159

Comme le montre le diagramme, le dclenchement d'une alerte entrane une suite d'oprations logiques dans le document QlikView. QlikView doit en gnral effectuer les grandes oprations suivantes: 1. Appliquer la slection pertinente pour l'alerte. 2. Calculer la valeur de l'expression de condition. 3. Restaurer les slections d'origine. Le temps ncessaire pour excuter les actions 1 et 3 quivaut bien sr au temps qui aurait normalement t ncessaire si les slections avaient t appliques manuellement. Le temps ncessaire pour l'tape 2 est le mme que si l'expression s'tait trouve, par exemple, dans un objet. En dfinitive, le temps ncessaire la vrification d'une alerte peut tre assez long dans les gros documents. Cela peut avoir moins d'importance pour les alertes dclenches seules l'ouverture ou au rechargement, mais il faut faire attention lorsqu'on utilise une grande quantit d'alertes dclenches par des macros, car le document peut alors devenir trs lent. Ouvre la bote de dialogue Alertes (page 160) qui permet de crer et de grer toutes les alertes QlikView.

17.3 Alertes
Le moyen le plus simple de dfinir une alerte consiste utiliser l' Assistant Alerte (page 164), disponible partir du menu Outils. Pour ouvrir la bote de dialogue Alertes, droulez le menu Outils. Cette bote de dialogue permet de grer les alertes qui sont stockes avec le document QlikView. Il est possible de dclencher des alertes partir de n'importe quelle version Windows de QlikView (donc, pas partir des clients AJAX). Une alerte se compose en gnral de trois lments de base: 1. Une condition, c'est--dire une expression QlikView formant une condition logique, qui peut tre vraie ou fausse. 2. Un tat logique (favori, effacer tout ou slection active) qui doit tre appliqu avant la vrification de l'tat de l'expression de condition. 3. Une ou plusieurs actions effectuer lorsque la condition est vrifie et estime remplie. Des actions courantes sont l'affichage d'un message dans une fentre contextuelle ou l'envoi d'un message par courrier lectronique un ou plusieurs destinataires. D'autres actions peuvent tre programmes l'aide des macros. Lorsqu'une alerte est vrifie, que la condition est remplie et que l'action ou les actions ont t menes bien, on peut dire qu'elle s'est dclenche. Les vrifications d'alertes QlikView peuvent tre dclenches de trois manires diffrentes: a. Automatiquement, dans une disposition QlikView, lorsque les donnes du document ont probablement chang, c'est--dire lorsque le document est ouvert, que le script a t excut ou qu'une opration Rduire les donnes a t effectue. b. Manuellement, partir d'un Interprteur de macros interne (page 961) par le biais d'interfaces API d'automatisation spciales. Pour plus de dtails, reportez-vous au fichier QlikView APIguide.qvw (fichier QlikView trs utile dcrivant l'utilisation de la fonctionnalit macro dans QlikView, normalement installe avec le programme). c. De l'extrieur partir de programmes excutant QlikView en mode de traitement par lots qui ont une interface API d'automatisation spciale pour rcuprer une liste des alertes dclenches partir d'un contexte donn. Soyez prudent lors de la cration d'alertes, car un trop grand nombre d'alertes dclenches par des macros peut rendre le document extrmement lent manipuler.

160

17.4 Bote de dialogue Alertes

La bote de dialogue Alertes

La partie suprieure gauche de la bote de dialogue contient une liste des alertes o toutes les alertes actuellement dfinies dans le document sont affiches. La liste comporte trois colonnes: ID, Activer et Description. ID Le numro d'identification unique de l'alerte est affich dans la zone d'dition ID ainsi que dans la liste des alertes. sa cration, toute entit de disposition QlikView, y compris les alertes, se voit attribuer un numro d'identification unique afin de permettre le contrle par Interprteur de macros interne (page 961). La premire alerte d'un document recevra le numro ID AL01. Vous pouvez modifier ce numro d'identification ultrieurement dans la zone d'dition ID. Cochez ou dcochez cette case pour activer/dsactiver l'alerte. Description d'une alerte telle qu'elle est dfinie dans la zone Description (voir cidessous). Le bouton Ajouter ajoute la liste une nouvelle alerte par dfaut modifier. Slectionner une alerte et cliquer sur le bouton Supprimer la supprime de la liste.

Activer Description

Ajouter Supprimer

161

Condition

Le groupe Condition est utilis pour dfinir l'expression conditionnelle. (Condition) C'est l'expression QlikView qui doit tre vraie (non nulle) pour que l'alerte se dclenche. Effacer tout Si cette option est coche, l'tat effacer tout sera utilis lors de l'valuation de la condition de l'alerte. Favori Si la case Effacer tout n'est pas coche, vous pouvez spcifier un favori appliquer avant que la condition de l'alerte ne soit teste. Le favori doit tre indiqu sous la forme d'un numro d'identification. Il doit exister pour que l'alerte fonctionne correctement. Si aucun favori n'est spcifi et que la case Effacer tout n'est pas coche, les slections actives (c'est--dire l'tat logique du document) seront utilises lors du test de la condition de l'alerte.

162

vnements

Le groupe vnements est utilis pour dfinir les vrifications automatiques d'vnements. l'ouverture L'alerte est automatiquement vrifie l'ouverture du document. Au rechargement L'alerte est automatiquement vrifie aprs l'excution du script (Rechargement) du document. En outre, l'alerte est galement vrifie l'ouverture du document, partir du moment o la dernire marque horaire de rechargement stocke est ultrieure la marque horaire note la dernire vrification de l'alerte. la rduction L'alerte est automatiquement vrifie aprs une rduction des donnes (commande Rduire les donnes) du document. En outre, l'alerte est galement vrifie l'ouverture du document, partir du moment o la dernire marque horaire de rduction stocke est ultrieure la marque horaire note la dernire vrification de l'alerte. Report Le redclenchement d'alertes vrifies automatiquement peut tre suspendu pour un nombre de jours donn aprs le premier dclenchement. On peut utiliser les dcimales pour indiquer des fractions de la journe. La valeur 0 indique bien entendu que le redclenchement n'est pas diffr. Niveau du dclencheur Le redclenchement d'alertes vrifies automatiquement peut aussi tre suspendu en fonction du changement de statut de l'alerte aprs son dclenchement. Dans la liste droulante, vous pouvez choisir parmi trois niveaux:

Toujours signifie que l'alerte se dclenche chaque fois que le ou les vnements de dclenchement se produisent et que la condition de l'alerte est remplie. Modifications du message signifie que le dclenchement de l'alerte est suspendu jusqu' ce que le message d'alerte change. Significatif uniquement avec un message d'alerte dynamique. ( noter que l'tat de la condition de l'alerte ne doit pas ncessairement changer pour que le message valu change. Tout changement dans la ligne Objet du courriel (voir ci-dessous) sera considr comme une modification du message.) Changements d'tat signifie que le dclenchement de l'alerte est suspendu jusqu' ce que l'tat de l'alerte change, c'est--dire que la condition de l'alerte a t remplie au cours d'au moins une vrification et qu'elle est nouveau remplie au cours de la dernire vrification. C'est le cas de suspension d'alerte le plus lev.
Afficher les info-bulles Cochez la case Afficher les info-bulles pour afficher le message d'alerte sous forme d'info-bulle lorsque l'alerte est dclenche. Le groupe Info-bulle personnalise vous permet de dfinir un format d'info-bulle personnalis pour l'alerte slectionne. En cochant cette option, vous pouvez remplacer les paramtres par dfaut tels qu'ils ont t dfinis dans les Proprits du document: Gnral (page 440). Le bouton Paramtres ouvre la bote de dialogue Paramtres de la fentre contextuelle (page 445).

Info-bulle personnalise

163

Mode

Dans le groupe Mode, vous pouvez vrifier les options pertinentes afin de dfinir une alerte comme Interactive (se dclenche automatiquement dans la disposition) et/ou comme une alerte pertinente pour les programmes externes excutant QlikView en mode de Traitement par lots (excution de la ligne de commande), par exemple QlikView Publisher, par le biais d'interfaces API d'automatisation spciales pour les dclenchements par lots. Si aucune des cases de ce groupe n'est coche, l'alerte peut quand mme tre vrifie manuellement l'aide de macros. Champ de commentaires dans lequel le crateur d'une alerte peut y dcrire son objectif. Il n'est utilis que dans la liste des alertes de cette bote de dialogue. La zone de texte Message permet de saisir le message afficher lorsque l'alerte se dclenche. Pour des alertes contextuelles, le texte apparatra sous forme d'infobulle; pour les alertes par courrier lectronique, il est utilis dans le corps du message lectronique. Le texte du message peut tre dfini comme Formule calcule (page 939) pour une mise jour dynamique. Cliquez sur le bouton ... pour ouvrir la bote de dialogue diter l'expression qui facilite l'dition des formules longues. Dans la zone de texte Objet du courriel, saisissez le texte utiliser dans la ligne de l'objet des courriels d'alerte. Le texte peut tre dfini comme expression d'tiquette calcule pour une mise jour dynamique. Cliquez sur le bouton ... pour ouvrir la bote de dialogue diter l'expression qui facilite l'dition des formules longues. Si cette zone de texte est vide, la ligne objet affichera le texte QlikView Alert.

Description

Message

Objet du courriel

Destinataires du courriel Le volet Destinataires du courriel est une liste d'adresses e-mail spares par un point-virgule. Chaque destinataire recevra un message lectronique chaque fois que l'alerte se dclenchera. La liste peut tre dfinie comme expression de chane calcule pour une mise jour dynamique.

17.5 Assistant Alerte


L'assistant Alerte permet de dfinir une alerte. Le processus comporte les tapes suivantes :

tape 1 - Nom/description de l'alerte tape 2 - Dfinition de la condition d'alerte tape 3 - Dfinition des modalits de test de la condition d'alerte tape4 - Dfinition d'un report de dclenchement

page 166 page 167 page 168 page 169

tape5 - Dfinition des actions effectuer suite au dclenchement page 170 de l'alerte
En fonctions des choix effectus, certaines de ces tapes pourront tre sautes.

Lancement de l'assistant Alerte Pour lancer l'assistant Alerte, choisissez Assistant Alerte dans le menu Outils.

164

Premire page de dmarrage de l'assistant Alerte

Deuxime page de dmarrage de l'assistant Alerte

Lors de la premire excution de l'assistant, deux pages s'affichent, la premire expliquant le concept d'alertes et la seconde dcrivant les diffrentes tapes que vous rencontrerez dans l'assistant. Pour ignorer ces deux pages lors des prochains lancements de l'assistant, cochez la case Ne plus afficher cette page dans l'une ou les deux pages. Cliquez sur Suivant pour continuer.

165

tape 1 - Nom/description de l'alerte

Premire page de l'assistant Alerte

Saisissez un nom et/ou un bref descriptif dans le champ Description de l'Alerte que vous projetez de crer. Il s'agit d'un champ de commentaire dans lequel l'auteur de l'alerte peut expliquer le fonctionnement et le dclenchement de l'alerte. Il est seulement affich dans la liste des alertes de la bote de dialogue Alertes. Cliquez sur Suivant pour continuer.

166

tape 2 - Dfinition de la condition d'alerte

Deuxime page de l'assistant Alerte

Dans cette tape, vous dfinissez la condition de l'alerte ainsi que la slection de l'tat qui devra tre utilis lors de la vrification de la condition d'alerte. Condition de l'Alerte Saisissez une expression QlikView qui sera vraie (non nulle) lors du dclenchement de l'alerte.

tat slectionn lors de la C'est l que vous dcidez de l'tat qui devra tre utilis lors de la vrification de vrification de l'alerte la condition d'alerte. Trois choix sont possibles: Slection active La condition de l'alerte est teste sur la base des slections effectues au moment du contrle de l'alerte. Effacer tout Toutes les slections seront temporairement effaces avant de tester la condition de l'alerte. Favori Le favori choisi sera temporairement appliqu avant de tester la condition de l'alerte. Cliquez sur Suivant pour continuer.

167

tape 3 - Dfinition des modalits de test de la condition d'alerte

Troisime page de l'assistant Alerte

Dans cette tape, vous dfinissez quel moment devra tre vrifi l'tat de l'alerte. L'alerte peut tre vrifie manuellement tout moment, et au moyen d'automatisation. Des vrifications automatiques lies des vnements peuvent tre cres et paramtres dans cette page. Vrifier l'alerte de manire interactive Activez cette option si l'alerte doit tre vrifie automatiquement lors des vnements ci-dessous. l'ouverture Activez cette option si l'alerte doit tre vrifie automatiquement l'ouverture du document. Au rechargement Activez cette option si l'alerte doit tre vrifie automatiquement aprs un rechargement du document (excution du script). la rduction Activez cette option si l'alerte doit tre vrifie automatiquement aprs qu'une rduction des donnes ait t effectue dans le document (commande Rduire les donnes).

Alerte traite en lots

Activez cette option si l'alerte est conue pour se dclencher partir de programmes externes au moyen de dclencheurs Automation API for Batch spciaux.

Cliquez sur Suivant pour continuer.

168

tape4 - Dfinition d'un report de dclenchement

Quatrime page de l'assistant Alerte

Dans cette tape, vous pouvez dfinir une priode de suspension aprs que l'alerte ait t dclenche, pendant laquelle l'alerte ne devra pas tre vrifie. Par exemple, vous pouvez crer une alerte qui se dclenche chaque jour la premire ouverture du document. Report La vrification automatique du redclenchement de l'alerte peut tre suspendue en indiquant un dlai aprs son dclenchement initial. Entrez un nombre de jours dans la zone de saisie. Des nombres dcimaux peuvent tre utiliss pour indiquer une fraction de jour. La vrification du dclenchement automatique de l'alerte peut tre suspendue suite une modification des donnes. Dans cette liste droulante, vous avez le choix entre trois possibilits: Toujours L'alerte se dclenche chaque fois que le ou les vnements de dclenchement se produisent et que la condition de l'alerte est remplie. Modification du message Le dclenchement de l'alerte est suspendu jusqu' ce que le message d'alerte change. Significatif uniquement avec un message d'alerte dynamique. noter que l'tat de la condition de l'alerte ne doit pas ncessairement changer pour que le message valu change Changements d'tat Le dclenchement de l'alerte est suspendu jusqu' ce que l'tat de l'alerte change, c'est--dire que la condition de l'alerte a t remplie au cours d'au moins une vrification et qu'elle est nouveau remplie au cours de la dernire vrification. C'est le cas de suspension d'alerte le plus lev.

Niveau du dclencheur

Cliquez sur Suivant pour continuer.

169

tape5 - Dfinition des actions effectuer suite au dclenchement de l'alerte

Cinquime page de l'assistant Alerte

Dans cette tape finale, vous dfinissez quelles actions doivent tre effectues au dclenchement de l'alerte. Si votre alerte est seulement contrle par macros, cette tape peut ne pas tre ncessaire. Message Vous saisirez ici le message afficher avec l'alerte. Il s'agit du message qui apparatra dans les info-bulles d'alerte. Dans le cas des alertes par courrier lectronique, ce sera le corps du message. Le texte peut tre dfini comme une expression QlikView pour une mise jour dynamique. Le bouton ... ouvre la bote de dialogue diter l'expression qui facilite l'dition des formules longues. Activez cette option si le message d'alerte doit s'afficher sous forme d'info-bulle lorsque l'alerte est excute. Activez cette option pour envoyer un courriel suite au dclenchement de l'alerte. Le corps du courriel sera le texte du message d'alerte. Saisissez le texte qui sera utilis comme objet du (des) courriel(s). L'objet pourra tre dfini comme une expression QlikView.

Afficher les info-bulles

Envoyer un courriel

Objet du courriel

Destinataires du courriel Saisissez un point virgule pour sparer les adresses des destinataires du courriel. Chacune de ces adresses recevra un courriel lors du dclenchement de l'alerte. La liste des destinataires pourra tre dfinie comme une expression QlikView. Cliquez sur Terminer pour finaliser la cration de l'alerte.

170

18 Vue d'ensemble des variables

Bote de dialogue Vue d'ensemble des variables

La bote de dialogue Vue d'ensemble des variables affiche toutes les variables non masques et leurs valeurs dans une seule liste. De mme que la fonction Expansions$ (page 303) dans les expressions QlikView, cette vue d'ensemble des variables peut tre utilis comme un rfrentiel d'expressions brutes. Variables Dans cette liste deux colonnes, vous trouverez les noms de toutes les variables non masques et leurs valeurs respectives. Met en surbrillance une variable dans la liste ci-dessus pour afficher sa dfinition. Vous pouvez modifier librement le texte. Les modifications sont prises en compte immdiatement dans la colonne Valeur de la liste ci-dessus. Cliquez sur le bouton ... pour ouvrir la bote de dialogue diter l'expression. Zone de commentaire ou le crateur d'une variable peut dcrire l'objectif et la fonction d'une variable. Ouvre la bote de dialogue Nouvelle variable dans laquelle vous pouvez dfinir une nouvelle variable. Mettez en surbrillance une variable dans la liste et cliquez sur ce bouton pour la supprimer.

Dfinition

Commentaire

Ajouter

Supprimer

171

172

19 Vue d'ensemble des expressions

La bote de dialogue Vue d'ensemble des expressions

Cette bote de dialogue affiche en une seule liste toutes les expressions du document, des feuilles et des objets. partir de cette liste, vous pouvez modifier individuellement des expressions ou Rechercher/Remplacer sur plusieurs expressions. Slectionnez une ou plusieurs expressions de la liste. Une ligne slectionne apparat en noir. Cliquez sous la dernire expression pour la dslectionner. Dans le coin suprieur gauche de la bote de dialogue, vous pouvez choisir parmi les cases cocher suivantes. Cochez plusieurs cases.
l l l l l

Expressions de graphique Attributs de graphique Expressions de couleur Conditions d'affichage Autres expressions

Colonnes...

Ouvre la bote de dialogue Colonnes o vous pouvez personnaliser les colonnes afficher dans la bote de dialogue Vue d'ensemble des expressions. La colonne Expression ne peut pas tre dsactive.

Rechercher/Remplacer... Ouvre la bote de dialogue Rechercher/Remplacer o vous pouvez rechercher et remplacer un texte donn dans la liste d'expressions. Vous pouvez galement appliquer des modifications simultanment plusieurs expressions.

173

Exporter...

Utilisez ce bouton pour exporter la table ci-dessous sous forme de fichier texte. Applique les modifications apportes dans la liste aux proprits du document, des feuilles et des objets, sans quitter la bote de dialogue. Lorsque vous avez utilis cette commande, les modifications effectues jusqu' prsent sont dfinitives, mme si vous utilisez Annuler pour quitter la bote de dialogue. Aprs avoir slectionn une expression dans la liste, vous pouvez utiliser ce bouton pour ouvrir la bote de dialogue diter l'expression pour l'expression en question.

Appliquer

diter...

La liste d'expressions dans la partie infrieure de la bote de dialogue peut contenir les colonnes suivantes, selon les paramtres de la bote de dialogue Colonnes (voir ci-dessous): ID de la feuille Numro d'identification de la feuille o l'on trouve l'expression. Vide pour les expressions du document. Nom (titre de l'onglet) de la feuille o l'on trouve l'expression. Vide pour les expressions du document. Numro d'identification de l'objet o l'on trouve l'expression. Vide pour les expressions du document et des feuilles. Nom de l'objet o se trouve l'expression. Emplacement de l'expression dans les proprits avec un nom convivial, c'est-dire une explication simple du type d'expression. tiquette de l'expression principale de l'objet. Emplacement exact de l'expression dans la structure des proprits. La notation correspond la hirarchie des proprits d'objet de l'interface d'automatisation de QlikView, qui est explique en dtail dans le guide API de QlikView. Dfinition de l'expression.

Nom de la feuille

ID de l'objet

Nom de l'objet Emplacement

tiquette Emplacement (chemin complet)

Expression

Les modifications apportes partir de cette bote de dialogue peuvent tre annules l'aide de la commande Annuler habituelle.

174

20 Fichiers internes
20.1 Rfrences de fichiers dans la disposition QlikView
Il existe un certain nombre d'endroits dans la disposition QlikView o l'on peut faire rfrence des fichiers externes contenant des informations, des images d'arrire-plan, etc. On fait rfrence aux fichiers externes par un chemin local ou une URL. Dans certains cas, il peut tre prfrable d'inclure les fichiers dans le document QlikView. La procdure est dcrite la section Fichiers internes dans les documents QlikView (page 175). Le programme QlikView contient lui-mme quelques fichiers image standard que l'on peut utiliser dans n'importe quel document sans action particulire. Pour plus d'informations, voir Fichiers internes dans le fichier de programme QlikView (page 175).

20.2 Fichiers internes dans les documents QlikView


Le prfixe info ajout aux instructions Load (page 268) et Select (SQL) (page 284) du script peut tre prcd (ou remplac) par le prfixe bundle. Les fichiers externes seront alors lus et incorpors dans le document QlikView. Les fichiers eux-mmes ne seront plus ncessaires pour obtenir leur contenu, ce qui permet de dplacer le document QlikView. Afficher les informations et la fonction info utilisent automatiquement les fichiers incorpors quand ils sont disponibles. La syntaxe d'une rfrence explicite des fichiers incorpors est la suivante :

qmem://nomdechamp/valeurdechamp | qmem://nomdechamp/<index>
o index correspond l'index interne d'une valeur dans un champ.

Exemples:
'qmem://Pays/Autriche' 'qmem://MonChamp/34'

20.3 Fichiers internes dans le fichier de programme QlikView


Un ensemble de fichiers image et son sont dj intgrs au fichier de programme QlikView. On peut y faire rfrence directement dans la disposition, sans prparation particulire. La syntaxe est alors:

qmem://<builtin>/nomdufichier
o nomdufichier est le nom d'un des fichiers lists ci-dessous (avec son extension).

Exemples:
'qmem://<builtin>/Arrow_N_G.png' ='qmem://<builtin>/Smiley'&if(sum(Result)<0,1,3)&'_Y.png'

Images de flches
Le groupe des flches vous permet d'afficher des flches dans huit directions et quatre couleurs. Les noms des fichiers sont cods comme suit: Le mot Arrow (flche) suivi d'un point cardinal ( _N, _NE, _E, _SE, _S, _

175

SW, _W ou _NW ). Ce nom peut tre suivi de _G pour le vert, _R pour le rouge et _Y pour le jaune. Si aucune couleur n'est spcifie dans le nom du fichier, c'est une flche grise qui est renvoye.

Autres images
Un certain nombre d'autres images sont galement incluses. Elles sont normalement disponibles en plusieurs couleurs. Vous trouverez ci-dessous une liste des images disponibles.
Check.png Minus.png Smiley1.png Smiley2_B.png Smiley3_Y.png Question_G.png Exclamation_G.png Check_G.png Minus_R.png Smiley1_G.png Smiley2_Y.png Thumb1.png Question_R.png Exclamation_R.png Cross.png Plus.png Smiley1_Y.png Smiley3.png Thumb2.png Question_Y.png Exclamation_Y.png Cross_R.png Plus_G.png Smiley2.png Smiley3_R.png Question.png Exclamation.png

20.4 Sons
Un certain nombre de fichiers son (.wav) sont aussi inclus comme ressources regroupes dans QlikView, et on y accde par les chemins suivants: qmem://<bundled>/sounds/qv_bttn.wav qmem://<bundled>/sounds/qv_can.wav qmem://<bundled>/sounds/qv_clear.wav qmem://<bundled>/sounds/qv_load.wav qmem://<bundled>/sounds/qv_lock.wav qmem://<bundled>/sounds/qv_menu.wav qmem://<bundled>/sounds/qv_ok.wav qmem://<bundled>/sounds/qv_redo.wav qmem://<bundled>/sounds/qv_reex.wav qmem://<bundled>/sounds/qv_save.wav qmem://<bundled>/sounds/qv_scrpt.wav qmem://<bundled>/sounds/qv_ulock.wav qmem://<bundled>/sounds/qv_undo.wav

Remarque: Cette liste est susceptible de changer dans les futures versions de QlikView.

176

Partie 4 Script

Partie 4 Script

177

21 Introduction au chargement de donnes


Voici une trs brve description des mthodes d'accs aux donnes source et d'utilisation de ces donnes par QlikView. Cette introduction a t insre ici afin de guider les utilisateurs moins expriments vers d'autres rubriques qu'ils pourraient avoir du mal identifier tout de suite. Un des aspects trs intressants de QlikView est sa capacit combiner des donnes de nombreuses sources de donnes dans un seul document QlikView. Le cas chant, il est donc possible de de lire des donnes provenant de plusieurs bases de donnes. Le programme permet galement de combiner des donnes depuis des sources Internet et d'autres serveurs ou fichiers. QlikView excute un script gr dans l'diteur de script ( Bote de dialogue diter le script (page 185)), afin de se connecter plusieurs sources de donnes et d'en rcuprer des donnes. Dans le script, les champs et les tables charger sont spcifis. Il est aussi possible de manipuler la structure de donnes l'aide d'instruction de script et d'expressions spciales. Ce script utilise une Syntaxe de script (page 239) spciale. Le script est excut quand on clique sur le bouton Recharger. Aprs l'excution du script, la bote de dialogue Slectionner des champs s'affiche. Vous pouvez y choisir les Champs (page 181) afficher dans des zones de liste sur une feuille dans QlikView. Lors de l'excution du script, QlikView identifie des champs commun depuis des tables diffrentes (champs cls) afin d'associer les donnes. Vous pouvez contrler la structure des donnes du document QlikView dans le Visionneur de tables (page 194), accessible par le menu Fichier. Vous pouvez modifier la structure de donnes en Renommer des champs (page 399) afin d'obtenir des associations diffrentes entre les tables. Une fois les donnes charges dans QlikView, elles sont stockes en interne dans le document QlikView ( Fichier QlikView (page 55)). Cet lment est le cur du programme et se caractrise par l'association sans restriction des donnes, par son grand nombre de dimensions possibles, par sa vitesse d'analyse et par sa taille compacte. Les donnes sont contenues en mmoire vive quand le document QlikView est ouvert. Enfin, tant donn le rle et la nature de la base de donnes QlikView, l'analyse dans QlikView se fait toujours quand le document est dconnect de ses sources de donnes. Par consquent, il faut recharger le script pour actualiser les donnes.

21.1 Chargement des donnes partir des fichiers


QlikView peut lire les donnes des fichiers reprsentant une table dans laquelle les champs sont spars par un dlimiteur comme une virgule, une tabulation ou un point-virgule. Les autres formats possibles sont les fichiers dif (Data Interchange Format), les fichiers fixes (longueur d'enregistrement fixe), les tables HTML, les fichiers Excel, les fichiers xml, ainsi que les QVD ( Fichiers QVD (page 425)) et QVX natifs. Dans la plupart des cas, la premire ligne du fichier contient les noms des champs. Les fichiers sont chargs dans le script l'aide d'une instruction Load (page 268). Au lieu de saisir manuellement les instructions dans l'diteur de script, vous pouvez utiliser l'assistant Fichier Table pour les gnrer automatiquement. Pour plus d'informations, voir Assistant Fichier: Source (page 211). Dans les instructions load, tout l'ensemble d' Expressions de script (page 307) peut tre utilis. Pour charger les donnes partir d'un autre document QlikView, vous pouvez utiliser une instruction Binary (page 244). Pour savoir comment charger les donnes des bases de donnes, voir Chargement des donnes partir des bases de donnes (page 179).

178

Partie 4 Script

21.2 Chargement des donnes partir des bases de donnes


Les donnes des bases de donnes commerciales sont charges dans QlikView via l'interface Microsoft OLEDB/ ODBC. Pour cela, vous devez installer un Driver destin prendre en charge votre SGBD et configurer la base de donnes comme source de donnes ODBC. Ensuite, vous pouvez configurer une connexion la base de donnes via la Bote de dialogue diter le script (page 185) en cliquant sur le bouton Connexion. Cela gnre une instruction Connexion (page 249) dans le script. Ensuite, vous devez dfinir les champs et tables charger dans une instruction Select (SQL) (page 284). Pour crer cette instruction, cliquez sur Slectionner. Pour plus d'informations, voir Crer une instruction Select (page 201).

179

180

22 Variables et champs
Ce chapitre explique les diffrentes entits porteuses de donnes dans QlikView, en particulier les champs et les variables.

22.1 Champs
Dans QlikView, les champs sont les principales entits porteuses de donnes. Un champ contient en gnral un certain nombre de valeurs, que l'on appelle valeurs de champs. Selon la terminologie des bases de donnes, les donnes traites par QlikView proviennent de fichiers de donnes. Un fichier est compos de plusieurs champs o chaque saisie de donnes constitue un enregistrement. Les termes fichier, champ et enregistrement sont quivalents aux termes table, colonne et ligne, respectivement. La logique AQL de QlikView ne fonctionne que sur les champs et leurs valeurs. Les donnes de champs sont rcuprables via les instructions Load (page 268), Select (SQL) (page 284) ou Binary (page 244). Le seul moyen de modifier des donnes dans un champ ( l'exception des Champs de saisie (page 182)) est de rexcuter le script. Les valeurs de champs elles-mmes ne peuvent pas tre manipules par l'utilisateur partir de la disposition, ni au moyen de l'automatisation. Une fois lues dans QlikView, elles ne peuvent tre que visualises et utilises pour des slections logiques et des calculs. Les valeurs de champs consistent en des donnes numriques ou alphanumriques (texte). Les valeurs numriques sont en fait des valeurs doubles, composes de la valeur numrique elle-mme et de sa reprsentation textuelle formate. Seule cette dernire est affiche dans les objets, etc. Dans la disposition de QlikView, le contenu d'un champ est reprsent dans une Liste de slection (page 497).

Balises de champ
Il existe trois types de balises systme: les balises gnres par le script et non modifiables par l'utilisateur, les balises gnres par le script et modifiables par l'utilisateur, et les balises dfinies de manire interactive par l'utilisateur. Les balises systme sont toujours prcdes d'un signe $. Les balises systme suivantes sont automatiquement gnres la fin de la gnration de script. Elles ne sont pas modifiables par l'utilisateur:
l l l l

$system - signale un champ systme. $key - signale un champ cl. $keypart - signale un champ qui fait partie d'une ou plusieurs cls synthtiques. $synthetic - signale une cl synthtique.

Les balises suivantes sont galement gnres automatiquement la fin de la gnration de script mais peuvent tre modifies ou crases l'aide de la syntaxe de script (voir Tag Field (page 292) et Untag Field (page 294)).
l l l l l l l

$hidden - signale un champ masqu. $numeric - toutes les valeurs (non null) du champ sont numriques. $integer - toutes les valeurs (non null) du champ sont des entiers. $text - aucune valeur du champ n'est numrique. $ascii - les valeurs du champ ne contiennent que des caractres ascii standard. $date - toutes les valeurs (non null) du champ peuvent tre interprtes comme des dates (entiers). $timestamp - toutes les valeurs (non null) du champ peuvent tre interprtes comme des dates et des heures (horodateurs).

181

Les balises suivantes sont disponibles dans la bote de dialogue Proprits du document: Tables (page 466). Elles peuvent tre actives et dsactives par l'utilisateur:
l

$dimension - indique un champ dont l'utilisation est recommande dans les dimensions de graphique, les listes de slection, etc. $measure - indique un champ dont l'utilisation est recommande dans les expressions.

L'utilisateur peut aussi ajouter des balises personnalises. Ces lments sont ajouts dans le script via la Syntaxe de script (page 239) ou dans la bote de dialogue Proprits du document: Tables (page 466). Ces balises personnalises peuvent ne pas utiliser le mme nom que les balises systme.

Remarque: Si les mmes balises sont manipules dans le script et dans Proprits du document: Tables (page 466), les paramtres du script sont prioritaires.

22.2 Champs de saisie


Dans les prcdentes versions, il n'tait pas possible de modifier les donnes dans les Champs (page 181) sans relancer le script. Cependant, depuis la version 8, QlikView inclut un nouveau type de champ, supportant les modifications sans excution du script: le champ de saisie. Un champ de saisie est similaire aux autres champs existants dans QlikView, la diffrence que sa valeur, lue dans le script, peut tre modifie sans pour autant relancer l'excution du script. Les champs de saisie peuvent tre utiliss comme les autres champs dans tous les types de d'objets de feuille.

Remarque: Les champs de saisie ne sont pas destins contenir de grandes quantits de donnes, car ils stockent les donnes d'une manire bien moins efficace que les champs ordinaires.
Lors de l'utilisation de champs de donnes, le script cre des emplacements pour chaque valeur de champ, qui pourront tre dits pour contenir les nouvelles donnes. Vous pouvez convertir n'importe quel champ en champ de saisie en l'indiquant dans une instruction Inputfield (page 262) dans le script avant qu'il ne soit utilis dans une instruction load ou select. Les valeurs d'un champ de saisie peuvent tre modifies dans les cellules des zones de liste, des zones table et des expressions des tableaux graphiques. Seules les colonnes des listes ou des tables qui contiennent des champs de saisie peuvent tre dites. En survolant une cellule ditable avec la souris, vous pouvez afficher une icne de saisie. En cliquant sur cet icne, la cellule bascule en mode modification. Il est possible d'utiliser les touches flches haut/bas pour naviguer dans les cellules en mode dition. Le document QlikView sera recalcul avec les nouvelles valeurs saisies.

Remarque: Les champs calculs ne peuvent pas tre utiliss comme champs de saisie. La fonctionnalit de champ de saisie est automatiquement dsactive.
Une cellule d'expression de graphique de tableau peut contenir des Fonction spciale d'agrgation de champ de saisie (page 881) et rester ouverte pour modification. La modification sera rpercute sur les autres valeurs du champ, par algorithme prdfini, comme par exemple. "Diffusion gale" ou "Diffusion proportionnelle". La version 9 comporte dsormais une extension vers les champs d'entre, savoir la possibilit de spcifier les modifications relatives. La syntaxe suivante s'applique (n est un nombre) :
%+n %-n +=n augmente la valeur actuelle de n % rduit la valeur actuelle de n % augmente la valeur actuelle de n

182

-=n *=n /=n

rduit la valeur actuelle de n multiplie la valeur actuelle par n divise la valeur actuelle par n

Exemples:
%+10 augmente la valeur actuelle de 10 %. 56 augmente la valeur actuelle de 56. *=2 multiplie la valeur actuelle par 2. /=2 divise la valeur actuelle par 2. /=0 n'entrane aucune modification. Il existe aussi des APIs pour extraire ou modifier les valeurs automatiquement par programmation.

22.3 Variable
Dans QlikView, une variable est une entit nomme qui contient une seule valeur de donnes. Une variable acquiert gnralement sa valeur en fonction d'une instruction Let, Set ou autre instruction de contrle, via un appel d'automatisation ou une Zone de saisie (page 571) dans la disposition. La valeur d'une variable peut normalement tre modifie par l'utilisateur tout moment. Les variables peuvent contenir des donnes numriques ou alphanumriques. Si le premier caractre d'une valeur de variable est un signe gal '=', QlikView essaie d'valuer la valeur comme une formule (expression QlikView), puis affiche ou renvoie le rsultat plutt que le texte de la formule.

22.4 Autres entits dans QlikView


Dimensions du graphique
Une dimension de graphique est l'ensemble de valeurs pour lequel le graphique calcule les valeurs de ses expressions. Dans le cas le plus simple, on peut dire que c'est ce qui apparat sur l'axe des abscisses d'un histogramme standard. Un graphique peut avoir une ou plusieurs dimensions. La limite suprieure dpend du type de graphique, de la complexit des donnes et de la quantit de mmoire disponible. Les graphiques de type secteurs, courbe et nuage de points peuvent afficher au maximum deux dimensions ; les graphiques de type histogramme et bulles, trois. Les radars ne peuvent afficher qu'une seule dimension, et les jauges n'en ont aucune. Une dimension de graphique obtient gnralement ses valeurs partir d'un champ indiqu la page Dimensions de la bote de dialogue Proprits du graphique. Une dimension peut consister en un groupe de champs (voir Groupes ci-dessous) plutt qu'en un seul champ. Les dimensions de graphique peuvent aussi tre calcules partir d'une expression.

Groupes
Les groupes, ou plus exactement les groupes de champs, sont des ensembles de champs qui peuvent tre utiliss la place des champs sous la forme de dimensions de graphiques. Il en existe deux types :

Les groupes hirarchiques servent tablir une hirarchie de champs qui permet de descendre progressivement dans les graphiques.
Les groupes cycliques ne sont pas hirarchiques et permettent en gnral l'utilisateur de changer de champ de dimension d'un simple clic de souris. Les groupes sont dfinis partir de la page Proprits du document: Groupes.

183

Expressions (formule calcule)


Une expression consiste en une combinaison de champs, de variables, d'oprateurs et de fonctions assembls suivant une syntaxe spciale. Les fonctions disponibles varient lgrement entre le script, les graphiques et d'autres lments de la disposition. Dans le script, l'expression sera value au moment o l'excution du script y arrivera. Dans les graphiques et d'autres objets de la prsentation, les expressions seront values automatiquement chaque fois que l'un des champs, l'une des variables ou des fonctions que contient l'expression changera de valeur ou d'tat logique. Pour plus d'informations sur les expressions de script, voir Expressions de script (page 307). Pour plus d'informations sur les expressions de graphique, voir Expressions de graphique (page 847). Pour plus d'informations sur l'utilisation des expressions dans d'autres objets de prsentation, voir Formules calcules (page 939).

184

23 Bote de dialogue diter le script

Bote de dialogue diter le script

La bote de dialogue diter le script est accessible partir du Menu Fichier (page 57) ou par un clic sur le symbole diter le script de la barre d'outils. Elle permet de rdiger et d'excuter un script qui connecte votre application une source de donnes ODBC ou des fichiers de donnes de diffrents types, et qui rcupre les informations requises. Les scripts peuvent tre saisis manuellement ou gnrs automatiquement. Les instructions de script complexes doivent tre saisies manuellement, du moins en partie. Les instructions, expressions, fonctions, etc. disponibles pour la cration de scripts sont dcrites aux chapitres Syntaxe de script (page 239) et Expressions de script (page 307). La bote de dialogue diter le script utilise la saisie semi-automatique, si bien que lorsque vous tapez, le programme complte le dbut de votre saisie afin de vous viter de taper le texte dans son intgralit. Les suggestions incluent les mots faisant partie de la syntaxe de script. Le script utilise un codage couleur pour les composants de la syntaxe. Pour personnaliser ce codage, choisissez Outils, puis Prfrences de l'diteur. En haut de cette bote de dialogue, vous trouverez une barre de menus proposant diffrentes commandes de script. Les commandes les plus frquemment utilises figurent galement dans la barre d'outils. Celle-ci comprend aussi une liste droulante listant les onglets du script.

Menus de la bote de dialogue diter le script


Menu Fichier
Recharger Excute le script, ferme la bote de dialogue et ouvre l'onglet Champs dans la bote de dialogue Proprits de la feuille. Cette commande est galement disponible sur la barre d'outils de la bote de dialogue diter le script.

185

Lance l'excution du script dans le dbogueur. Le dbogueur sert chercher les erreurs dans le script. Chaque instruction du script peut tre surveille et les valeurs des variables peuvent tre examines au cours de l'excution du script. Cette commande est galement disponible sur la barre d'outils de la bote de dialogue diter le script. diter le script masqu... Ouvre un onglet de script pour le script masqu. Il est possible ici de dfinir une partie masque du script, qui est excute avant le script gnral chaque rechargement. Les onglets de script masqu sont toujours affichs gauche des onglets de script ouverts. Un mot de passe est requis pour crer le script masqu ou y accder. Changer le mot de passe Ouvre la bote de dialogue Nouveau mot de passe du script masqu dans du script masqu... laquelle vous pouvez dfinir un nouveau mot de passe pour l'accs au script masqu. Crer un script masqu Ouvre la bote de dialogue Nouveau mot de passe du script masqu o l'on peut dfinir un nouveau mot de passe pour l'accs au script masqu, puis ouvre un nouvel onglet appel Script masqu dans la fentre du script. Il est possible ici de dfinir une partie masque du script, qui est excute avant le script gnral chaque rechargement. Les onglets de script masqu sont toujours affichs gauche des onglets de script ouverts. Supprimer le script Supprime le script masqu de la bote de dialogue diter le script. masqu Dboguer... Enregistrer tout le document Enregistre le document actif dans un fichier. Les donnes, le script et la disposition sont enregistrs.Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+S. Cette commande est galement disponible sur la barre d'outils de la bote de dialogue diter le script. Enregistre le document actif dans un nouveau fichier de document sous un nouveau nom.

Enregistrer tout le document sous...

Ouvrir le fichier de script Permet de rechercher un fichier contenant un script et de l'ouvrir sous un externe nouvel onglet dans le volet du script. Vous pouvez alors l'diter en utilisant le codage couleur de QlikView. Enregistrer le fichier de Enregistre le fichier de script externe. script externe Exporter vers un fichier Enregistre tout le script dans un fichier texte dfini partir de la bote de script... dialogue Enregistrer le script qui s'ouvre alors. Le fichier portera l'extension .qvs. Imprimer l'onglet... Permet d'imprimer l'onglet de script actif sur une imprimante facultative. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+P. Cette commande est galement disponible sur la barre d'outils de la bote de dialogue diter le script. Imprimer tous les Permet d'imprimer l'intgralit du script sur une imprimante facultative. Le onglets... script masqu ne sera pas imprim. Visionneur de tables Ouvre la bote de dialogue Visionneur de tables (page 194) dans laquelle vous pouvez examiner la structure des donnes charges dans une vue graphique des tables, champs et associations. Cette commande peut galement tre appele l'aide du raccourci clavier suivant: CTRL+T.

186

Menu dition
Annuler Rtablir Couper Annule la dernire modification (on peut annuler plusieurs tapes). quivaut au raccourci CTRL+Z. Rtablit la dernire opration Annuler. quivaut au raccourci CTRL+Y. Exporte le texte slectionn vers le Presse-papiers. Cette commande est galement disponible sur la barre d'outils de la bote de dialogue diter le script. quivaut au raccourci CTRL+X. Copie le texte slectionn dans le Presse-papiers. Cette commande est galement disponible sur la barre d'outils de la bote de dialogue diter le script. quivaut au raccourci CTRL+C. Colle le contenu du Presse-papiers dans la bote de dialogue l'endroit o se trouve le curseur. Cette commande est galement disponible sur la barre d'outils de la bote de dialogue diter le script. quivaut au raccourci CTRL+V. Supprime le texte du script slectionn. quivaut la touche SUPPR. Efface le script, c'est--dire supprime tout le texte l'exception des instructions set gnres automatiquement au dpart. Slectionne tout le texte du script. quivaut au raccourci CTRL+A.

Copier

Coller

Supprimer Effacer tout le script Slectionner tout

Rechercher/Remplacer... Ouvre une bote de dialogue permettant de rechercher et de remplacer des nombres ou des caractres du script. Cette commande est galement disponible sur la barre d'outils de la bote de dialogue diter le script. quivaut au raccourci CTRL+F. Aller ... Ouvre une bote de dialogue permettant d'atteindre un numro de ligne donn du script. quivaut au raccourci CTRL+G. Majuscules Passe le texte du script slectionn en majuscules. Minuscules Inverser la casse Mettre en majuscules Commentaire Passe le texte du script slectionn en minuscules. Inverse la casse du texte du script slectionn. Met le texte du script slectionn en majuscules.

Transforme une ligne de texte du script en commentaire. Voir aussi: Rem (page 280) Enlever les commentaires Transforme de nouveau la ligne de texte en texte de script d'origine. Retrait Retrait ngatif Met en retrait les lignes en surbrillance dans le script. Met en retrait ngatif les lignes en surbrillance dans le script.

Menu Insrer
Instruction Set Ouvre l' Assistant Instruction Set (page 192) qui permet de saisir une nouvelle instruction set et de choisir une instruction prdfinie.

187

Variables d'environnement Fichier de script

Insre les variables d'interprtation de nombres dans le script d'aprs la configuration par dfaut du systme d'exploitation. Permet de rechercher un fichier contenant un script ou une partie d'un script et insre son contenu l'emplacement du curseur dans le script. Ouvre la bote de dialogue Inclure les fichiers scripts, dans laquelle vous pouvez rechercher un fichier script enregistr dans l'un des formats suivants: qvs (fichier script QlikView existant), txt ou sql. Rcupre l'ID de scurit du domaine NT pour l'utiliser dans le script. Le NTDOMAINSID est utilis dans l'accs de section en tant que champ rserv rgissant la scurit NT. Insre un script de test gnr automatiquement. Insre une instruction load soit via la commande de sous-menu Charger depuis un fichier ou Charger en ligne. La commande Charger en ligne ouvre l' Assistant Donnes intgres (page 207) qui permet de crer des instructions Load inline intgres partir d'une commande de style de feuille de calcul. Insre une instruction d'accs une section soit partir d'une table d'autorisation Publisher soit d'une table intgre. La commande de sous-menu Autorisation Publisher ouvre l' Assistant Fichier: Options (page 226). La commande de sous-menu En ligne ouvre l' Assistant Table de restriction d'accs (page 209). Insre une instruction connect dans le script. Insre une instruction disconnect dans le script.

Instruction Include

SID du domaine

Script de test Instruction Load

Accs de section

Instruction Connect Instruction Disconnect

Menu Onglet
Le menu Onglet facilite l'organisation de la structure du script. Ajouter un onglet... Ajoute un nouvel onglet de script. Le script sera excut onglet par onglet de gauche droite. Si l'onglet de script en cours fait partie du script masqu, le nouvel onglet sera galement cr dans le script masqu. Insre un nouvel onglet aprs l'onglet actif. Tout texte plac aprs le curseur sur l'onglet actif sera dplac vers le nouvel onglet.

Insrer un onglet l'emplacement du curseur... Renommer... Promouvoir

Ouvre une bote de dialogue destine renommer l'onglet actif. Dcale l'onglet actif d'un cran vers la gauche. Les onglets ne peuvent pas tre promus gauche de l'onglet de script masqu. Dcale l'onglet actif d'un cran vers la droite.

Abaisser

188

Fusionner avec l'onglet prcdent... Supprimer...

Tout le texte de l'onglet actif est dplac la fin de l'onglet prcdent et l'onglet actif est supprim. Supprime l'onglet actif. Le dernier onglet de script restant ne peut pas tre supprim.

Menu Outils
Administrateur ODBC 64bits... Administrateur ODBC 32bits... Prfrences de l'diteur Ouvre l'administrateur de source de donnes ODBC pour les pilotes ODBC 64bits. Ouvre l'administrateur de source de donnes ODBC pour les pilotes ODBC 32bits. Ouvre l'onglet Prfrences utilisateur: diteur (page 86), qui permet de dfinir la police et la couleur des diffrents types de texte contenus dans le script.

Vrification de la syntaxe Vrifie la syntaxe du script et s'arrte la premire erreur rencontre.

Menu Aide
Aide ouvre l'aide HTML de QlikView.

Volets de la bote de dialogue diter le script


La bote de dialogue diter le script comprend les deux onglets suivants: le volet script dans la partie suprieure et le volet des outils dans la partie infrieure.

Volet du script
Le volet du script contient le script lui-mme. Chaque ligne du script est numrote. Le script peut tre divis en plusieurs parties places sur des onglets spars. Elles sont alors excutes de gauche droite. Si vous utilisez un script masqu, il est visible sur un onglet distinct, plac gauche ( condition de fournir le mot de passe). Le script utilise un codage couleur pour les composants de la syntaxe. Pour personnaliser le codage couleur, choisissez Prfrences de l'diteur dans le menu Outils.

Volet des outils


Le volet des outils comprend trois onglets qui contiennent les fonctions permettant de gnrer un script.

Onglet Donnes
L'onglet Donnes contient des commandes de base pour obtenir des donnes dans QlikView. Les commandes du groupe Base de donnes servent crer une connexion une source de donnes et en slectionner des champs. Si vous utilisez un SGBD commercial, vous pouvez utiliser ODBC ou OLEDB comme interface entre QlikView et la base de donnes. Un pilote ODBC ou OLEDB prenant en charge votre SGBD doit tre install sur l'ordinateur pour que vous puissiez rcuprer des donnes par l'interface ODBC/OLEDB. Une fois le pilote ODBC/OLEDB appropri install, votre base de donnes doit tre configure comme source de donnes ODBC.

189

OLEDB ODBC

La connexion la source de donnes est tablie l'aide d'OLEDB. La connexion la source de donnes est tablie l'aide d'ODBC.

QVSAdminDataProvider.dll Ce connecteur personnalis permet de vous connecter QlikView Server et de charger les informations partir du service DMS et des objets de collaboration. Personnalis... Toutes les sources de donnes personnalises figurent galement dans la zone droulante de slection. QlikView propose une interface plug-in en code source libre, qui donne la possibilit de programmer des interfaces personnalises pour plusieurs types de sources de donnes non traits par le fichier traditionnel ou les interfaces ODBC ou OLEDB. Le cas typique est une source de donnes disponible par les Services Web. Le plug-in doit alors tre programm selon des spcifications affiches dans un modle de code fourni ( la demande) comme code source libre par QlikTech et compil en dll. La dll est ensuite place ct du fichier QV.EXE, ce qui rend la source personnalise disponible. En gnral, la version 64bits de QlikView utilise des fournisseurs 64bits. Si vous devez utiliser une source de donnes associe un pilote 32bits, cochez cette option afin d'obliger l'instruction connect d'ODBC/OLEDB utiliser un fournisseur 32bits. Ouvre la bote de dialogue Proprits des liaisons de donnes, qui permet de slectionner une source de donnes, ou la bote de dialogue Connexion la source de donnes (page 200), qui permet de slectionner une source de donnes ODBC. Ouvre la bote de dialogue Crer une instruction Select (page 201).

Forcer la version 32 Bit

Connexion...

Slectionner...

C'est dans le groupe Donnes de fichiers que l'on rcupre les donnes d'autres sources. Chemins relatifs Si cette case est coche, QlikView utilisera dans le script des chemins relatifs plutt que des chemins absolus. Les chemins relatifs sont normalement requis lorsqu'un document doit tre dplac d'un ordinateur sur un autre. Ce paramtre est galement disponible dans la bote de dialogue Prfrences utilisateur. S'il est modifi cet emplacement, il le sera galement dans les botes de dialogue diter le script et diter le script masqu. Activez ce paramtre pour slectionner des fichiers partir d'un serveur FTP lorsque vous cliquez sur le bouton Fichiers de tables, Fichiers QlikView ou Inclure. Ouvre la bote de dialogue Ouvrir des fichiers locaux (page 205) listant les fichiers de tables. En slectionner un ou plusieurs et appuyer sur OK gnrera une ou plusieurs instructions load. Lorsqu'il est excut, le script charge les donnes des fichiers correspondants. Si l'option Utiliser le mode FTP est coche (voir ci-dessus), slectionnez un serveur dans la liste (ou saisissez son nom, puis cliquez sur Connexion). Slectionnez ensuite un fichier texte.

Utiliser le mode FTP

Fichiers de tables...

190

Fichier QlikView...

Ouvre la bote de dialogue Ouvrir un document QlikView. Lorsqu'un fichier est slectionn, une instruction binary est gnre sur la premire ligne du script. Cette instruction charge les donnes du fichier partir du document QlikView, mais les paramtres de disposition ne sont pas utiliss. Ouvre la bote de dialogue Assistant Fichier: Source (page 211), qui permet de spcifier une URL comme source pour la table de la base de donnes. Ouvre la bote de dialogue Assistant Fichier: Source partir de laquelle il est possible de charger le contenu d'un champ dj charg.

Fichiers Web...

Champ de donnes

Onglet Variables
L'onglet Variables comprend des commandes destines coller la syntaxe lie aux variables QlikView. Coller Afficher les variables systme Colle la fonction slectionne dans le script. Si cette case est coche, la liste droulante Variables comprend les variables systme.

QlikView propose une interface plug-in code source libre, qui donne la possibilit de programmer des interfaces personnalises pour plusieurs types de sources de donnes non couverts par le fichier traditionnel, ni les interfaces ODBC ou OLEDB. Le cas typique est une source de donnes disponible par les Services Web. Le plug-in doit alors tre programm selon des spcifications affiches dans un modle de code fourni ( la demande) comme code en source libre par QlikTech et compil en dll. La dll est ensuite place ct du fichier QV.EXE, ce qui rend la source personnalise disponible. Elle peut alors tre slectionne dans la zone droulante.

Onglet Fonctions
L'onglet Fonctions contient des outils permettant de choisir des fonctions QlikView standard et de les coller. Catgorie de fonction Slectionnez une catgorie dans la liste droulante pour voir les fonctions correspondantes dans la liste Nom de la fonction en dessous. Cette liste droulante contient les fonctions de script standard de QlikView. Slectionnez une fonction dans la liste Nom de la fonction et collez-la dans le script l'emplacement du curseur.

Nom de la fonction Coller

Onglet Variables
Dans l'onglet Variables, vous trouverez des commandes destines coller la syntaxe lie aux variables de QlikView. Coller Afficher les variables systme Colle la variable slectionne dans le script. Si cette case est coche, la liste droulante Variables comprend les variables systme.

191

Onglet Paramtres
L'onglet Paramtres contient les paramtres de scurit applicables au script QlikView. Privilges de script

Ouvrir les bases de donnes en mode de lecture et d'criture Si cette option est active, le qualificateur mode is write sera utilis dans les instructions select. Permettre l'excution de programmes externes Si cette option est active, il sera possible d'utiliser des instructions execute dans le script. Brouiller les informations d'identification utilisateur Si cette case est coche, le USERID et le PASSWORD des instructions connect seront brouills dans le script.

Paramtres

23.1 Assistant Instruction Set

Assistant Instruction Set

192

Instruction Set active

Nom de la variable Saisissez le nom d'une nouvelle variable ou modifiez la variable prdfinie choisie ci-dessous. La variable prdfinie est insre ici lorsque vous cliquez sur Coller. Valeur de la variable Si le nom d'une nouvelle variable est saisi ci-dessus, dfinissez la valeur ici. Si une valeur de variable prdfinie a t choisie ci-dessous, il est possible de la modifier ici. Groupes de variables Choisissez le type de variable utiliser. Variables Choisissez la variable utiliser. Valeurs prdfinies Choisissez entre les valeurs prdfinies dans la variable. Coller Cliquez sur le bouton pour dplacer les valeurs prdfinies vers Instruction Set active des fins de modification.

Instructions Set prdfinies

23.2 Rechercher/Remplacer (script)

Bote de dialogue Rechercher/Remplacer

Cette bote de dialogue sert rechercher des chanes textuelles donnes dans le script et lui apporter des modifications globales ou multiples. Elle est accessible partir du menu diter de la bote de dialogue diter le script. Chane chercher : Remplacer par Suivant Chane textuelle rechercher. Texte substituer la chane de caractres rechercher. Dplace la slection l'occurrence suivante de la chane de caractres rechercher. Effectue un remplacement dans la section slectionne. Effectue les remplacements de toutes les occurrences de la chane de caractres rechercher. Si cette case est coche, la recherche textuelle respecte la casse.

Replace Remplacer tout

Respecter la casse

193

Recherche textuelle

Si cette case est coche, QlikView ne recherchera que les occurrences de la chane de caractres rechercher formant un mot entier (dlimit par des espaces ou des caractres autres que les lettres).

Rechercher dans tous les Si cette case est coche, l'opration rechercher/remplacer est effectue sur tous les onglets onglets du script. Vers le haut Vers le bas Cochez cette case d'option pour effectuer la recherche vers le haut dans le script. Cochez cette case d'option pour effectuer la recherche vers le bas dans le script.

23.3 Script masqu


Un script masqu est une partie spciale du script excute avant le script normal chaque opration Recharger. Il est protg par un mot de passe. Si vous choisissez diter le script masqu dans le menu Fichier de la bote de dialogue diter le script, le programme vous demandera un mot de passe, qui sera requis pour accder nouveau au script masqu. Si c'est la premire fois que vous accdez au script masqu d'un document (c'est--dire que vous le crez), vous devez confirmer le nouveau mot de passe. L'onglet de script masqu apparatra ensuite gauche de tous les autres onglets de script et y restera jusqu' la fermeture du document.

Remarque: Si un script masqu est utilis, la commande binary ne peut pas tre utilise dans le script normal. Remarque: La bote de dialogue Progression ne sera pas mise jour pendant l'excution d'un script masqu, moins que l'option Afficher la progression du script masqu ne soit coche sous l'onglet Proprits du document: Scurit. Aucune entre ne sera ajoute au fichier journal, s'il est utilis. Remarque: Si le script masqu contient un accs de section (section access), cette section ne sera autorise ni dans le script normal ni dans un script commenant par un chargement binaire (binary load) du fichier QlikView contenant le script cach.

23.4 Visionneur de tables


Pour ouvrir la bote de dialogue Visionneur de tables, choisissez Visionneur de tables dans le menu Fichier ou appuyez sur CTRL+T.

194

Bote de dialogue Visionneur de tables

Cette bote de dialogue sert afficher la structure des tables de donnes du document QlikView actif. Les tables apparaissent sous forme de zones o figure la liste des champs qu'elles contiennent. Des lignes de jointure matrialisent les associations entre les zones. Lorsque plus de deux lignes se rejoignent, le visionneur utilise des points de jointure. On peut dplacer les tables, les points de jointure et aussi tous les points o les connecteurs changent de direction en cliquant dessus et en les tirant (voir ci-dessous). Lors de cette rorganisation de la disposition, les modifications sont enregistres avec le document, moins que vous ne quittiez la bote de dialogue en cliquant sur Annuler. Deux vues sont disponibles et leurs dispositions respectives sont enregistres sparment. Ces deux vues sont les suivantes:
l

La Vue interne est la vue dfinie par dfaut. Elle affiche les tables de donnes telles que QlikView les stocke. Des cls synthtiques composes sont formes dans les tables qui partagent plus d'un champ. Des tables synthtiques sont utilises pour les relier. Cette vue permet la meilleure comprhension de la logique QlikView et prsente une disposition trs claire, puisque chaque paire de tables a au maximum un connecteur.

195

La Vue source affiche les tables de donnes telles que QlikView les lit. Il n'y a pas ici de champs ni de tables synthtiques. Les cls composes sont reprsentes par des connecteurs multiples entre les tables.

Lorsque le curseur survole l'un des champs d'une table, une info-bulle contenant des informations sur le contenu du champ s'affiche:
l

Le paramtre Densit d'information correspond au nombre d'enregistrements dont le champ comporte des valeurs (diffrentes de NULL) par rapport au nombre total d'enregistrements de la table.

l l l

Le paramtre Ratio du sous-ensemble correspond au nombre de valeurs de champs distinctes trouves dans la table par rapport au nombre total de valeurs de champ distinctes (c'est--dire en tenant compte des autres tables). Les commentaires de table s'affichent dans l'info-bulle. Les commentaires de champ s'affichent dans l'info-bulle. Les balises ajoutes au script ou la page Proprits du document: Tables, y compris les balises systme, s'affichent dans l'info-bulle.

Les actions suivantes sont possibles partir des dispositions de table (cliquez ici pour dvelopper une liste):
Cliquer sur la barre de titre d'une table Pointer sur la barre de titre d'une table et tirer Passer le pointeur de la souris sur la barre de titre d'une table Cliquer sur un champ dans une table Passer le pointeur de la souris sur un champ d'une table Met la table en surbrillance, ainsi que toutes les tables qui ont des associations logiques directes avec cette table et les jointures entre elles. Dplace la table.

Affiche des informations contextuelles sur la table.

Met la table en surbrillance, le champ, toutes les tables contenant ce champ et les jointures entre elles. Affiche des informations contextuelles sur le champ.

196

Effectuer un clic droit dans une table

Cliquez sur Aperu pour afficher une bote de dialogue d'exemples d'enregistrements provenant de donnes charges.

Pointer sur un point de jointure ou un coude de connecteur et tirer

Dplace le point de jointure.

Clic droit sur un point de Remet le point de jointure sa position par dfaut. jointure ou un coude de connecteur Cliquer sur l'arrire-plan Annule la surbrillance des tables, champs et connecteurs. de la disposition

Les commandes suivantes sont disponibles sur la barre d'outils de la bote de dialogue et les boutons associs (cliquez ici pour dvelopper une liste):
Exporter une image Ouvre une bote de dialogue de recherche de fichier qui permet d'enregistrer la vue de tables active sur le disque sous la forme d'une image bitmap ou png. En cliquant sur ce bouton, vous pouvez exporter la structure des tables du document vers un ensemble de fichiers texte. Ces fichiers texte, un pour les tables (nomdefichier.Tables.tab), un pour les champs (nomdefichier.Fields.tab) et un pour leur mappage (nomdefichier.Mappings.tab), peuvent facilement tre lus nouveau dans QlikView pour vous permettre de poursuivre l'analyse en bnficiant de toute la puissance de la logique QlikView. Une bote de dialogue vous permet de slectionner le dossier cible de l'exportation. Par dfaut, les fichiers sont placs dans le mme dossier que le document QlikView. Ouvre la bote de dialogue Imprimer partir de laquelle vous pouvez imprimer la vue de tables active. quivaut au raccourci CTRL+P. Copie la vue des tables sous forme d'image dans le Presse-papiers. quivaut au raccourci CTRL+C.

Exporter la structure

Imprimer

Copier l'image

Disposition automatique Rorganise les tables dans la vue active. Zoom Vue On peut dterminer le niveau de zoom de la vue actuelle dans cette zone droulante. Choisissez Vue interne ou Vue source (voir ci-dessus).

197

23.5 Proprits des liaisons de donnes

Botes de dialogue des proprits des liaisons de donnes

198

Cette bote de dialogue sert crer une connexion une source de donnes OLEDB, en gnral via ODBC. Pour ouvrir cette bote de dialogue, cliquez sur le bouton Connexion... sous l'onglet Donnes dans le volet Outils de la bote de dialogue diter le script. Le premier onglet liste les noms des fournisseurs OLEDB. Pour crer une connexion de donnes ODBC, slectionnez OLE DB Provider pour les pilotes ODBC, puis cliquez sur Suivant>> pour vous rendre l'onglet Connexion. Sous l'onglet Connexion, sous 1. Spcifiez la source des donnes, une source de donnes prcdemment configure est slectionne. On peut choisir entre deux types de sources de donnes ODBC.

Sources de donnes prdfinies


On peut accder aux sources de donnes qui ont t prdfinies suivant la procdure dcrite dans Crer des sources de donnes ODBC (page 38), en cochant la case d'option Utiliser le nom de la source de donnes. La liste droulante contient toutes les sources de donnes dfinies. Slectionnez celle utiliser. Le cas chant, renseignez les champs Nom d'utilisateur et Mot de Passe permettant d'accder la source de donnes. Vous pouvez galement tester la connexion en appuyant sur le bouton Tester la connexion. Enfin, cliquez sur le bouton OK. L'instruction connect est prte.

Sources de donnes gnriques

Slectionnez la bote de dialogue Source de donnes, onglet Source de donnes de la machine.

Onglet Source de donnes machine de la bote de dialogue Slectionner la source de donnes Les sources de donnes gnriques sont utilises par exemple pour les fichiers des bases de donnes. Si une source de donnes gnrique doit tre utilise ou si une nouvelle source doit tre cre, slectionnez la case d'option Utiliser la chane de connexion puis cliquez sur Crer. La bote de dialogue Slectionner la source des donnes s'ouvre alors. Deux types de sources de donnes sont disponibles : les sources de donnes fichier et les sources de donnes machine. Ces dernires sont propres l'ordinateur local et l'utilisateur, tandis que les sources de donnes fichier sont propres un fichier. Vous pouvez utiliser l'une ou l'autre. chaque source de donnes est associ un onglet distinct dans la bote de dialogue Slectionner la source de donnes.

199

Les sources de donnes gnriques sont utilises par exemple pour les fichiers des bases de donnes. Si vous voulez utiliser une source de donnes gnrique ou crer une nouvelle source, slectionnez la case d'option Utiliser la chane de connexion, puis cliquez sur Crer. La bote de dialogue Slectionner la source de donnes s'ouvre alors. Deux types de sources de donnes sont disponibles : les sources de donnes fichier et les sources de donnes machine. Ces dernires sont propres l'ordinateur local et l'utilisateur, tandis que les sources de donnes fichier sont propres un fichier. Utilisez l'une ou l'autre. chaque source de donnes est associ un onglet distinct dans la bote de dialogue Slectionner la source de donnes. Double-cliquez sur une source de donnes, puis recherchez le fichier de base de donnes applicable dans la bote de dialogue qui s'ouvre.

Remarque: Pour les sources de donnes MS Access, vous devez cliquer sur le bouton Base de donnes dans une bote de dialogue intermdiaire.
Lorsque vous cliquerez sur RETOUR, vous reviendrez au deuxime onglet de la bote de dialogue Proprits des liaisons de donnes. Le cas chant, renseignez les champs Nom d'utilisateur et Mot de Passe permettant d'accder la source de donnes. Vous pouvez aussi tester la connexion en cliquant sur le bouton Tester la connexion. Enfin, cliquez sur le bouton OK. L'instruction connect est prte.

23.6 Connexion la source de donnes

Bote de dialogue Connexion la base de donnes

Cette bote de dialogue sert crer une connexion une source de donnes ODBC.s Elle est accessible via le bouton Connexion de la page Donnes du volet Outils dans la Bote de dialogue diter le script (page 185) si l'option de base de donnes ODBC a t choisie. Sur cette page, choisissez la source de donnes. Par dfaut, seules les sources de donnes du systme apparaissent. Cochez la case Afficher les DSN utilisateur pour afficher toutes les sources de donnes.

200

Si ncessaire, vous pouvez renseigner les champs Nom d'utilisateur et Mot de passe pour accder la source de donnes. Vous pouvez galement tester la connexion en appuyant sur le bouton Tester la connexion.

Bote de dialogue Tester la connexion

Enfin, cliquez sur le bouton OK. L'instruction connect est prte.

23.7 Crer une instruction Select

Bote de dialogue Crer une instruction Select

Pour ouvrir cette bote de dialogue, cliquez sur le bouton Slectionner sous l'onglet Donnes du volet de l'outil de la Bote de dialogue diter le script (page 185). Elle permet de dfinir les tableaux et les champs charger partir d'une source de donnes prcdemment slectionne. Cette bote de dialogue se compose de trois groupes. Le premier groupe contient des informations sur la source de donnes.

201

Source de donnes Base de donnes

Nom de la source de donnes ODBC/OLEDB active. Vous pouvez choisir parmi les bases de donnes disponibles dans la liste droulante. Indique le nom du propritaire de la base de donnes. Vous pouvez choisir parmi les propritaires disponibles dans la liste droulante. Lorsque vous cliquez sur ce bouton, la bote de dialogue Connexion la source de donnes (page 200) s'ouvre. Cliquez sur ce bouton pour ouvrir la bote de dialogue Informations sur le pilote ODBC ou Informations sur le pilote de base de donnes OLE, qui contient des informations sur les fonctions prises en charge par le pilote en cours d'utilisation. Ouvre une bote de dialogue prsentant des informations de support relatives la base de donnes. Ces informations peuvent tre utilises chaque contact avec le support QlikTech et lorsqu'on signale des bogues ou des problmes lis des documents QlikView.

Propritaire

Connexion

Pilote

Support

Bote de dialogue Support

Le deuxime groupe est utilis pour slectionner tables et champs. Tables de bases de donnes Cette liste affiche toutes les tables de base de donnes disponibles. Cliquez sur le nom d'une table pour la slectionner. Il est possible de contrler les types de tables qui figurent dans cette liste l'aide des cases cocher de gauche (voir leur description ci-dessous).

202

Champs

Cette liste affiche tous les champs disponibles dans la table slectionne. Choisissez dans la liste un ou plusieurs champs inclure l'instruction select. Utilisez un astrisque * pour slectionner tous les noms de champs la fois. La slection de champs apparatra sous l'onglet Script du troisime groupe (voir sa description ci-dessous). Les champs peuvent tre tris dans l'Ordre original de la base de donnes, mais on peut prfrer slectionner le Tri alphabtique dans la liste droulante. Lorsque cette option est coche, tout champ dfini comme champ cl dans la base de donnes source est signal par une icne de cl dans la liste Champs. Cochez cette case pour que les tables normales de la base de donnes figurent dans la liste Tables de base de donnes. Cochez cette case pour que les vues de la base de donnes figurent dans la liste Tables de base de donnes. Cochez cette case pour que les synonymes de tables de la base de donnes figurent dans la liste Tables de base de donnes. Cochez cette case pour que les tables systme de la base de donnes figurent dans la liste Tables de base de donnes. Cochez cette case pour que les alias de tables de la base de donnes figurent dans la liste Tables de base de donnes.

Afficher l'icne des champs cls Tables

Vues

Synonymes

Tables systme

Alias

Le troisime groupe affiche l'instruction select gnre et les informations relatives la table et aux champs slectionns. Le groupe contient les onglets suivants:

Script

L'onglet Script affiche le script qui sera gnr pour l'instruction select. Les trois cases d'option situes droite contrlent le formatage de l'instruction select dans le script. Colonne Slectionnez cette option pour que chaque nom de champ de l'instruction select gnre figure sur une ligne distincte dans le script. Slectionnez cette option pour que la totalit de l'instruction select gnre figure sur une seule ligne dans le script. Slectionnez cette option pour que l'instruction select figure sur des lignes structures dans le script. Si cette option est active, l'instruction select sera gnre en tant prcde par une instruction load qui l'utilisera comme entre. Tous les champs seront lists dans l'instruction load, mme si l'astrisque * est utilis dans l'instruction select.

Ligne

Structur

Avant Load

203

Ajouter

Cliquez sur ce bouton pour enregistrer l'instruction select gnre jusqu' prsent. La gnration d'une nouvelle instruction select dbute sans que la bote de dialogue ne soit ferme. L'ancienne instruction sera visible dans le volet d'aperu au-dessus d'un sparateur clair. Cette procdure peut tre rpte autant de fois que l'on veut.

Table

L'onglet Table affiche des informations dtailles sur la table de base de donnes slectionne.

Plus... ouvre une bote de dialogue redimensionnable distincte, prsentant une vue dveloppe des onglets Table, Colonnes et Aperu.

Colonnes
L'onglet Colonnes affiche des informations dtailles sur les colonnes (champs) slectionnes dans la table active.

Aperu
L'onglet Aperu affiche un aperu des premires lignes qui seront gnres par l'instruction select actuelle.

Blobs
L'onglet Blobs permet d'associer les grands objets binaires (Blobs, Binary Large Objects) dans un document QlikView. Il s'agit souvent d'une image, d'un fichier texte ou autre, stock sous forme d'entit unique dans un systme de gestion de bases de donnes. L'icne i indique que le champ contient un grand objet binaire. Les grands objets binaires contenus dans la base de donnes sont rpertoris avec leur taille (en Ko) et leur type dans le Visionneur de blobs. S'il s'agit d'une image, l'aperu du grand objet binaire s'affiche en regard de la liste. QlikView prend en charge les blobs au format jpg, png, bmp, pdf et rtf. Le bouton Regroupement... permet d'ouvrir la bote de dialogue de regroupement.

Champs cl pour les donnes blob Rduire les images

Dans la liste, slectionnez le blob redimensionner.

Activez cette option pour redimensionner le blob. Appliquez les paramtres Largeur en pixels et Hauteur en pixel pour adapter la taille de l'image.

Ce paramtre ne gre pas les proportions.

Remarque Les blobs ne peuvent tre intgrs qu' l'aide d'ODBC.

204

Ds lors que les slections de table et de champs sont effectues, vous pouvez cliquer sur OK afin d'insrer les instructions select gnres l'emplacement du curseur dans le script QlikView. Si vous cliquez sur Annuler, vous perdrez les modifications. Le pilote ODBC est gnralement en mesure d'interprter des instructions select bien plus complexes que celles gnres partir de cette bote de dialogue. Une autre faon de gnrer une instruction select complexe consiste utiliser un outil de requte, par exemple Microsoft Query, et d'y concevoir l'instruction select graphiquement. Vous pouvez ensuite copier (via CTRL+C) l'instruction select et la coller (via CTRL+V) dans le script QlikView. (Dans MS Query, cliquez sur le bouton SQL.)

23.8 Ouvrir des fichiers locaux


Cette bote de dialogue est accessible via le bouton Fichiers de tables dans la Bote de dialogue diter le script (page 185). Dans la bote de dialogue Ouvrir des fichiers locaux, vous pouvez spcifier les table files charger. Pour slectionner plusieurs fichiers, cliquez dessus en maintenant la touche CTRL ou MAJ enfonce. Lorsque vous cliquez sur le bouton OK, le fichier slectionn est interprt dans l'Assistant Fichier.

23.9 Ouvrir des fichiers Internet ou Ouvrir un document QlikView

Bote de dialogue Ouvrir des fichiers Internet

Cette bote de dialogue s'affiche lorsque vous cliquez sur le bouton Fichier QlikView... ou Fichiers de tables... de la bote de dialogue Donnes du volet Outil de la bote de dialogue diter le script, sous rserve que la case Utiliser le mode FTP soit coche. En fonction du bouton utilis pour l'ouvrir, la bote de dialogue s'appelle Ouvrir un document QlikView ou Ouvrir des fichiers Internet mais les fonctionnalits sont les mmes. Cette bote de dialogue permet galement d'ouvrir des documents QlikView. Pour cela, choisissez Ouvrir via FTP dans le menu Fichier.

205

Slectionnez dans la liste de slection droulante le serveur contenant le(s) fichier(s) ouvrir. Si votre serveur ne figure pas dans cette liste (ou s'il n'y a pas de liste), saisissez le nom d'un serveur, puis cliquez sur Connexion. Adresse du serveur FTP Lors de la premire connexion au serveur FTP, vous devez saisir l'adresse cet endroit. Nom d'utilisateur Sauf si la case Connexion anonyme est coche, le nom d'utilisateur doit tre saisi cet endroit. Sauf si la case Connexion anonyme est coche, le mot de passe doit tre saisi cet endroit. Cliquez sur ce bouton pour vous connecter au serveur slectionn. Si vous slectionnez un serveur directement dans la liste, ignorez cette procdure. Pour vous connecter travers un pare-feu, vous devrez sans doute utiliser un protocole FTP passif. Permet l'utilisateur de se connecter sans nom d'utilisateur ni mot de passe. Le nom des fichiers slectionns apparat dans cette zone une fois la connexion au serveur tablie. Spcifiez ici le type de fichiers voulu. Cliquer sur ce bouton gnre une instruction load qui sera introduite dans le script de chargement dans la Bote de dialogue diter le script (page 185).

Mot de passe

Connexion

Syntaxe passive

Connexion anonyme Nom du fichier

Type de fichiers Ouvrir

206

23.10 Assistant Donnes intgres

Assistant Donnes intgres

La bote de dialogue Assistant Donnes intgres se trouve dans le menu Insrer, Instruction Load, Instruction Load inline. Elle sert crer des instructions load inline dans le script. La bote de dialogue contient une sorte de feuille de calcul et fonctionne de fait comme une feuille de calcul bien des gards. Cependant, les formules de calcul ne seront pas values ici comme elles le seraient dans Microsoft Excel, par exemple. Chaque colonne reprsente un champ charger dans QlikView au moyen d'une table intgre. Chaque ligne est un enregistrement de la table. Pour slectionner une cellule de donnes, cliquez dessus. On peut ensuite y taper ou y coller une valeur partir du Presse-papiers. Appuyez sur ENTRE ou une flche pour accepter la valeur et passer une autre cellule. La ligne (tiquette) du haut est rserve aux tiquettes de champs. Double-cliquez sur une cellule d'tiquette pour la modifier. Si aucune valeur n'est saisie dans la ligne d'tiquette, ce sont les noms de champs F1, F2, etc. qui seront utiliss.

Menu dition
Le menu dition contient les commandes d'dition de base. Insrer une colonne Insre une colonne vide si une ou plusieurs colonnes sont slectionnes.

207

Supprimer la colonne Insrer une ligne Supprimer la ligne

Supprime les colonnes slectionnes. Insre une ligne vide si une ou plusieurs lignes sont slectionnes. Supprime les lignes slectionnes.

Menu Outils
Le menu Outils contient l'option Donnes de document permettant d'ouvrir l'Assistant Importation de donnes de document partir duquel vous pouvez coller des valeurs de champs partir de n'importe quel champ prsent dans le document. Dans la bote de dialogue, vous pouvez dterminer le nombre de valeurs de champs prsentes dans n'importe quel champ slectionn. Vous pouvez galement insrer l'ensemble des valeurs, celles slectionnes ou celles exclues dans l'assistant en ligne. Cliquez sur OK pour fermer la bote de dialogue et gnrer une instruction Load inline refltant le contenu de la grille de table de la bote de dialogue.

Assistant Importation de donnes de documents

208

23.11 Assistant Table de restriction d'accs

Assistant Table de restriction

La bote de dialogue Assistant Table de restriction d'accs est accessible partir du menu Insrer, Accs de section, Instruction Inline. Elle sert gnrer une instruction Instruction Load inline pour contrler l'accs au document QlikView. Voir Scurit (page 433). La bote de dialogue contient les commandes suivantes: Champs utiliser La liste comprend tous les champs de scurit possibles dans un accs de section QlikView. Cochez la case de ceux que vous souhaitez inclure. Cliquez sur ce bouton pour cocher ACCESS, USERID et PASSWORD et dcocher les autres champs. Cliquez sur ce bouton pour cocher ACCESS, PASSWORD, NTNAME et NTDOMAINSID et dcocher les autres champs.

Table d'accs utilisateur de base Scurit NT de base

Lorsque vous fermez la bote de dialogue en cliquant sur OK, la bote de dialogue Assistant Donnes intgres (page 207) s'ouvre et prsente les champs slectionns comme tiquettes de colonnes. Lorsque vous appuyez sur OK dans cette bote de dialogue, une instruction Load Inline prcde d'une instruction Section (page 284) et suivie d'une instruction Section Application est cre.

23.12 Assistant Fichier


L'Assistant Fichier s'affiche automatiquement l'ouverture d'un fichier ou d'une table HTML via le bouton Fichiers de tables... sous l'onglet Donnes du volet Outils de la Bote de dialogue diter le script (page 185). L'assistant apparat aussi lorsqu'on ouvre un fichier autre que qvw partir du menu Fichier. Les types de fichiers que QlikView reconnat sont les fichiers texte dlimits (fichiers csv, par exemple), les fichiers enregistrements fixes, les fichiers dif, les fichiers Excel, les fichiers HTML et XML. Dans ce manuel, ces types de fichiers sont appels fichiers de tables. Les fichiers peuvent tre chargs partir du rseau local ou directement d'Internet. Pour charger un fichier stock sur le rseau local, utilisez le bouton Fichiers de tables de la bote de dialogue diter le script. Si le fichier a l'extension d'un fichier de tables, par exemple .csv, .txt, .tab, .skv, .fix, .dif, .htm, .html, .shtml, .xhtml, .php ou .asp, il apparatra dans la bote de dialogue Ouvrir des fichiers

209

locaux. On peut ouvrir le fichier mme s'il a une autre extension en choisissant Tous les fichiers (*.*) dans la liste droulante Fichiers de type de la bote de dialogue Ouvrir des fichiers locaux. Le contenu doit cependant tre interprtable par QlikView. Cela ne dpend pas de l'extension du fichier.
Pour charger un fichier directement d'Internet, collez l'URL (copie au pralable dans le navigateur) dans la zone de texte intitule Nom du fichiers de la bote de dialogue de recherche FTP, puis cliquez sur Ouvrir. Une fois qu'un fichier a t slectionn, l'assistant s'ouvre. Il comprend cinq onglets : Source, Type, Transformer, Options et Script. Comme il est rarement ncessaire d'apporter des modifications l'onglet Source, l'assistant dmarre avec l'onglet Type activ. Les boutons <<Prcdent et Suivant>> permettent l'utilisateur de passer d'un onglet l'autre. Sous les onglets Type et Options, vous disposez d'un aperu permettant d'observer la faon dont QlikView a interprt le fichier. La page Script permet de dfinir le mode de prsentation du script dans la bote de dialogue diter le script. Le bouton Terminer ferme l'assistant et gnre une instruction load dans le script de chargement. Pour charger un fichier stock sur le rseau local, utilisez le bouton Fichiers de tables de la bote de dialogue diter le script. Si le fichier a l'extension d'un fichier de tables, par exemple .csv, .txt, .tab, .skv, .fix, .dif, .htm, .html, .shtml, .xhtml, .php ou .asp, il apparatra dans la bote de dialogue Ouvrir des fichiers locaux. Il est possible d'ouvrir le fichier mme s'il est dot d'une autre extension en choisissant Tous les fichiers (*.*) dans la liste droulante Fichiers de type de la bote de dialogue Ouvrir des fichiers locaux. Le contenu doit cependant tre interprtable par QlikView. Cela ne dpend pas de l'extension du fichier. Pour charger un fichier directement d'Internet, collez l'URL (copie au pralable dans votre navigateur) dans la zone de texte intitule Nom du fichier de la bote de dialogue de recherche FTP, puis cliquez sur Ouvrir. Une fois qu'un fichier a t slectionn, l'assistant s'ouvre. Il comprend cinq onglets : Source, Type, Transformer, Options et Script. Comme il est rarement ncessaire d'apporter des modifications l'onglet Source, l'assistant dmarre avec l'onglet Type activ. Les boutons <<Prcdent et Suivant>> permettent de passer d'un onglet l'autre. Sous les onglets Type et Options, vous aurez un aperu de la faon dont QlikView a interprt le fichier. La page Script vous permet de dfinir le mode de prsentation du script dans la bote de dialogue diter le script. Le bouton Terminer ferme l'assistant et gnre une instruction load dans le script.

210

Assistant Fichier: Source

Assistant Fichier, Source

Cet onglet contient tous les paramtres relatifs la source de la table. La source est normalement bien dfinie ds qu'un fichier est slectionn dans la bote de dialogue Ouvrir un fichier, mais si vous devez apporter des modifications la dfinition de la source, ce qui arrive souvent par exemple pour les tables rcupres directement de sites web, apportez-les ici. Cliquer sur le bouton < Retour de la page Type ouvre la page Source. Fichier local Saisissez le chemin d'accs un fichier local ou cliquez sur Parcourir pour le rechercher via l'explorateur. Saisissez le chemin d'accs au fichier Internet.

Fichier Internet

partir du champ Ouvre la bote de dialogue Source de donnes pour le document (page 212) o il est possible de choisir la table et le champ.

211

Source de donnes pour le document

Bote de dialogue Source de donnes pour le document

Cette bote de dialogue rpertorie les tables du document actif et permet d'utiliser un champ prcdemment charg comme source de donnes. Valeur de champ Tables Menu droulant affichant les tables charges dans le document actif. Champs Champs de la table slectionne. Valeurs Valeurs des champs slectionns. Chemin d'accs au fichier Type de valeur Nom de la table et du champ slectionns.

Type de la valeur slectionne. Texte Si la valeur est un texte, elle apparat cet endroit. Infos Toute information connecte la valeur de champ apparat cet endroit. Blob Tout blob connect la valeur apparat cet endroit.

Assistant Fichier: Type


Cette page contient les paramtres relatifs au type de fichier et au type de table. Les paramtres varient en fonction du type de fichier.

212

Assistant Fichier, Type

Cette page contient les paramtres relatifs au type de fichier et au type de table. Les paramtres varient en fonction du type de fichier. Lorsqu'on ouvre un fichier de tables, le programme tente d'interprter son contenu. Les valeurs initiales des paramtres sont dfinies de cette manire, mais peuvent bien sr tre modifies manuellement par l'utilisateur. Type de fichier Le type de fichier est dfini ici : Dlimit, Enregistrement fixe, DIF, Fichiers Excel (xls), Excel (xlsx), HTML, QVD, XML ou QVX. Le rsultat des rglages effectus s'affiche dans le volet d'aperu (la partie infrieure de l'onglet). Lorsque les paramtres sont modifis, le contenu de l'aperu est galement modifi. On peut aussi apporter des modifications directement dans l'aperu. On peut tout d'abord omettre des champs en cliquant sur la croix droite du nom du champ. La croix devient alors un point d'exclamation et le champ n'est pas inclus dans l'instruction load. Pour annuler cette modification, cliquez simplement sur le point d'exclamation. Pour renommer un champ, cliquez sur son nom, saisissez le nouveau nom dans cette zone et confirmez en appuyant sur ENTRE. Les clauses as requises dans l'instruction load sont automatiquement cres. Enfin, pour les fichiers enregistrements fixes (et certaines tables HTML), on peut dfinir la largeur des colonnes en cliquant directement dans le volet d'aperu.

Volet Aperu

213

Assistant Fichier: Type - Dlimit

Page Assistant Fichier - Type, fichier dlimit

Dlimiteur

Spcifiez le type de dlimiteur utiliser. Pour utiliser un dlimiteur diffrent des dlimiteurs prdfinis, choisissez Personnalis afin d'identifier celui qui vous intresse. Personnalis ouvre la bote de dialogueDelimiter Selector, qui permet de choisir l'un des dlimiteurs disponibles sur l'ordinateur. La partie en-tte du fichier correspond un nombre dfini de lignes ou d'octets (uniquement pour les fichiers dlimits, enregistrements fixes et Excel). L'en-tte peut tre omis. Le jeu de caractres du fichier de tables est dfini ici. Si le jeu de caractres de votre choix n'est pas disponible dans le menu droulant, il est possible de slectionner Personnalis. Cela permet d'ouvrir la bote de dialogue Slecteur de code page pour choisir parmi les jeux de caractres installs sur l'ordinateur. Dfinissez le schma Guillemets (page 274) utiliser. Choisissez Standard, Aucun ou MSQ. Dans certains fichiers, des commentaires sont utiliss entre les enregistrements. Une ligne de commentaire commence souvent par un caractre spcial ou un jeu de caractres, par exemple //. Vous pouvez spcifier ici les caractres qui marquent le dbut d'un commentaire pour permettre QlikView de reconnatre les commentaires. Si les noms de champs (en-ttes de colonnes) sont stocks dans la premire ligne de la table, cette commande doit tre dfinie sur Imbriqu. Le format permet aussi de spcifier explicitement les noms de champ; dans ce cas, il faut choisir Explicite. Si la table ne contient pas de noms de champs, utilisez l'option Aucun. Il peut arriver qu'un caractre spcial indique la fin du fichier. Si ce caractre se trouve au milieu d'un fichier texte (entour de guillemets, par exemple), vous pouvez activer cette option pour l'ignorer.

Taille de l'en-tte

Jeu de caractres

Mise entre guillemets Commentaire

tiquettes

Ignorer la fin de fichier

Assistant Fichier: Type - Enregistrement fixe

214

Page Assistant Fichier - Type, fichier enregistrements fixes

Taille de l'en-tte

Il est possible d'omettre la partie en-tte du fichier dans cette zone: nombre spcifi de lignes ou d'octets (uniquement pour les fichiers dlimits, enregistrements fixes et Excel). Spcifiez la taille d'un enregistrement en lignes ou en octets (fichiers enregistrements fixes uniquement). Le jeu de caractres du fichier de tables est dfini ici. Si le jeu de caractres de votre choix n'est pas disponible dans le menu droulant, slectionnez Personnalis. Cela permet d'ouvrir la bote de dialogue Slecteur de code page afin de choisir parmi les jeux de caractres installs sur l'ordinateur. Il peut arriver qu'un caractre spcial indique la fin du fichier. Si ce caractre se trouve au milieu d'un fichier texte (entour de guillemets, par exemple), vous pouvez activer cette option pour l'ignorer. Longueur d'un onglet dfinie en espaces. Permet d'imbriquer les tiquettes. Cette option doit tre utilise si les noms des champs sont stocks sur la premire ligne de la table. Analyse et dfinit la largeur des colonnes pour les fichiers enregistrements fixes et pour certaines tables HTML. Aprs l'analyse, des sauts de colonne peuvent tre ajouts ou supprims dans le volet d'aperu.

Taille de l'enregistrement Jeu de caractres

Ignorer la fin de fichier

Taille d'onglet tiquettes imbriques... Analyser les positions fixes

Effacer les positions Efface tous les sauts de colonnes (pour les fichiers enregistrements fixes et certaines fixes tables HTML).

Assistant Fichier: Type - DIF

Page Assistant Fichier - Type, fichier DIF

tiquettes

Si les noms de champs (en-ttes de colonnes) sont stocks dans la premire ligne de la table, cette commande doit tre dfinie sur Imbriqu. Le format DIF permet aussi de spcifier explicitement les noms de champ; dans ce cas, il faut choisir Explicite. Si la table ne contient pas de noms de champs, utilisez l'option Aucun. Le jeu de caractres du fichier de tables est dfini ici. Si le jeu de caractres de votre choix n'est pas disponible dans le menu droulant, slectionnez Personnalis. Cela permet d'ouvrir la bote de dialogue Slecteur de code page afin de choisir parmi les jeux de caractres installs sur l'ordinateur.

Jeu de caractres (page 423)

215

Assistant Fichier: Type - Excel (XLS)

Page Assistant Fichier - Type, fichier XLS

Tables

Dans le groupe Tables, vous pouvez choisir une table donne si le fichier lu en contient plusieurs, ce qui peut tre le cas de fichiers HTML ou Excel. Dans Excel, toutes les feuilles d'un classeur et toutes les zones nommes (par exemple, plusieurs cellules portant des noms) dans les feuilles de calcul sont identifies comme des tables possibles. Il est possible d'omettre la partie en-tte du fichier dans cette zone: nombre spcifi de lignes ou d'octets (uniquement pour les fichiers dlimits, enregistrements fixes et Excel). Si les noms de champs (en-ttes de colonnes) sont stocks dans la premire ligne de la table, cette commande doit tre dfinie sur Imbriqu. Le format DIF permet aussi de spcifier explicitement les noms de champ; dans ce cas, il faut choisir Explicite. Si la table ne contient pas de noms de champs, utilisez l'option Aucun.

Taille de l'en-tte

tiquettes

Assistant Fichier: Type - Excel (XLSX)

Page Assistant Fichier - Type, fichier XLSX

Tables

Dans le groupe Tables, vous pouvez choisir une table donne si le fichier lu en contient plusieurs, ce qui peut tre le cas de fichiers HTML ou Excel. Dans Excel, toutes les feuilles d'un classeur et toutes les zones nommes (par exemple, plusieurs cellules portant des noms) dans les feuilles de calcul sont identifies comme des tables possibles. Il est possible d'omettre la partie en-tte du fichier dans cette zone: nombre spcifi de lignes ou d'octets (uniquement pour les fichiers dlimits, enregistrements fixes et Excel). Si les noms de champs (en-ttes de colonnes) sont stocks dans la premire ligne de la table, cette commande doit tre dfinie sur Imbriqu. Le format DIF permet aussi de spcifier explicitement les noms de champ; dans ce cas, il faut choisir Explicite. Si la table ne contient pas de noms de champs, utilisez l'option Aucun.

Taille de l'en-tte

tiquettes

216

Assistant Fichier: Type - HTML

Page Assistant Fichier - Type, fichier HTML

Tables

Dans le groupe Tables, vous pouvez choisir une table donne si le fichier lu en contient plusieurs, ce qui peut tre le cas de fichiers HTML ou Excel. Dans Excel, toutes les feuilles d'un classeur et toutes les zones nommes (par exemple, plusieurs cellules portant des noms) dans les feuilles de calcul sont identifies comme des tables possibles. Si les noms de champs (en-ttes de colonnes) sont stocks dans la premire ligne de la table, cette commande doit tre dfinie sur Imbriqu. Le format DIF permet aussi de spcifier explicitement les noms de champ; dans ce cas, il faut choisir Explicite. Si la table ne contient pas de noms de champs, utilisez l'option Aucun. Le jeu de caractres du fichier de tables est dfini ici. Si le jeu de caractres de votre choix n'est pas disponible dans le menu droulant, slectionnez Personnalis. Cela permet d'ouvrir la bote de dialogue Slecteur de code page afin de choisir parmi les jeux de caractres installs sur l'ordinateur. Analyse et dfinit la largeur des colonnes pour les fichiers enregistrements fixes et pour certaines tables HTML. Aprs l'analyse, des sauts de colonne peuvent tre ajouts ou supprims dans le volet d'aperu.

tiquettes

Jeu de caractres

Analyser les positions fixes

Effacer les positions fixes Efface tous les sauts de colonnes (pour les fichiers enregistrements fixes et certaines tables HTML).

Assistant Fichier: Type - QVD


Ce type de fichier ne comporte pas de paramtres configurables.

Assistant Fichier: Type - XML

217

Page Assistant Fichier - Type, fichier XML

Tables

Les tables trouves sont visibles dans la liste. Chaque table est indique par un chemin qui correspond son emplacement dans la structure XML. Lorsqu'une table est slectionne, ses champs sont visibles dans le volet Champs de droite. Une instruction Load est gnre pour chaque table de la liste lorsque vous cliquez sur le bouton Terminer. Cette feuille montre la structure interprte de la source XML. Cette feuille montre les champs de la table slectionne et les cls gnres.

XML Champs

Assistant Fichier: Type - QVX


Un fichier au format QVX contient des mtadonnes dcrivant une table de donnes et les donnes relles. Contrairement au format QVD, propritaire et optimis pour des transformations minimales l'intrieur QlikView, le format QVX est public et ncessite quelques transformations lors de l'exportation des donnes depuis les formats ordinaires de base de donnes. Les fichiers QVX sont chargs dans le script avec l'instruction load. Ce type de fichier ne comporte pas de paramtres configurables.

Assistant Fichier: Transformer


Dans la bote de dialogue Transformer, il est possible de filtrer une table et de procder des transformations avances. Pour les fichiers HTML, cette fonction s'avre particulirement importante puisqu'il n'existe pas de norme pour le stockage des donnes dans ce format. Par consquent, il est impossible de rendre QlikView capable de lire des tables HTML aussi facilement que des formats de donnes plus structurs. Pour accder aux botes de dialogue Transformer, activez l'tape de transformation en cliquant sur le bouton Activer l'tape de transformation. Cette tape n'est pas active par dfaut par souci d'conomie de la mmoire.

218

Assistant Fichier, Activer l'tape de transformation

La bote de dialogue Transformer comprend de nombreux filtres permettant d'adapter les tables QlikView. La bote de dialogue comprend six onglets dcrits ci-dessous. Les boutons situs dans le coin infrieur gauche de la bote de dialogue Transformer s'appliquent cependant tous les onglets: Annuler Rtablir Rinitialiser Annule la dernire modification apporte. Rtablit la dernire modification annule. Rtablit l'tat initial de la table.

219

Scories

Assistant Fichier: Transformer, onglet Scories

Cet onglet permet de supprimer de la table les lignes et les colonnes contenant des scories. Dans les fichiers HTML, il n'est pas rare que des lignes et des colonnes supplmentaires soient insres uniquement pour la lisibilit de la table et il est bien entendu ncessaire de les supprimer avant de charger les donnes dans QlikView. Les colonnes et les lignes peuvent tre supprimes explicitement, auquel cas leurs index sont stocks dans le script. Les lignes peuvent aussi tre supprimes sur la base de certains critres. Supprimer Marqu Suppression conditionnelle... Supprime les lignes et colonnes mises en surbrillance. Ouvre la bote de dialogue Dfinition de la condition de la ligne (page 227) qui permet de dfinir les critres conditionnels de suppression des lignes.

220

Remplir

Assistant Fichier: Transformer, onglet Remplir

Cet onglet permet de remplacer des valeurs de la cellule. Dans la plupart des cas, certaines cellules correspondant une description donne sont remplaces par une autre valeur de la mme colonne. Ainsi, on a souvent des cellules vides pour lesquelles la valeur pertinente se trouve dans la premire cellule pleine audessus. Remplir... Ouvre la bote de dialogue Remplir les cellules (page 229) destine configurer des conditions et une stratgie.

221

Colonne

Assistant Fichier: Transformer, onglet Colonne

L'onglet Colonne sert copier le contenu d'une colonne dans une nouvelle colonne. La copie peut contenir toutes les cellules de la colonne source ou seulement certaines d'entre elles. Cette caractristique peut tre utile si une colonne contient diffrents types de valeurs. Elle peut aussi servir dupliquer une colonne qui contient des liens HTML, de sorte qu'une colonne contienne le texte des liens, tandis que l'autre comprend leur URL. Crer... Ouvre la bote de dialogue Dfinition des cellules pour la nouvelle colonne (page 230) dans lequel il est possible de spcifier le mode de cration de la nouvelle colonne. Dfinit l'tiquette de la colonne.

tiquette

222

Contexte

Assistant Fichier: Transformer, onglet Contexte

Dans une table HTML, on peut stocker plus d'informations que l'on en voit, par exemple l'adresse laquelle le navigateur doit aller si l'on peut cliquer sur le contenu d'une cellule. L'onglet Transformer affichera le texte de la cellule, mais il peut aussi prsenter des informations supplmentaires concernant les diffrentes cellules. Naturellement, QlikView peut aussi lire ces informations. Les informations supplmentaires se trouvent toujours encadres de balises. Une balise a un nom et peut avoir des attributs, parfois des valeurs. Le contexte d'une cellule peut ressembler ceci:
Exemple:

<A href=www.myurl.com/mypage.html name=MonNom> Mon texte de lien </A>


Le texte visible de la cellule est Mon texte de lien. Le contexte contient une balise de dbut et une balise de fin. Les balises indiquent un lien hypertexte. La balise de dbut possde deux attributs, href et name. L'onglet Contexte peut servir lire les attributs des balises au lieu de la chane principale. D'autres types d'oprations sont aussi possibles. Effectuez un clic droit sur les cellules dans l'assistant et choisissez Afficher le contexte pour voir le contexte de la cellule. Dvelopper... Ouvre la bote de dialogue Extension de cellule contextuelle (page 230) dans laquelle vous pouvez dfinir un dveloppement du contenu d'une cellule en plusieurs cellules. Notez qu'il est ncessaire de choisir la fois une colonne et une ligne pour que ce bouton devienne disponible. Cependant, toutes les cellules de la colonne seront dveloppes.

223

Interprter...

Ouvre la bote de dialogue Interprtation contextuelle (page 231) dans laquelle vous pouvez dfinir une interprtation du contenu des cellules. Notez qu'il est ncessaire de choisir la fois une colonne et une ligne pour que ce bouton devienne disponible. Cependant, toutes les cellules de la colonne seront interprtes.

Dployer

Assistant Fichier: Transformer, onglet Dployer

Cet onglet vous permet d'tendre une table comprenant des retours la ligne. Condense signifie ici qu'une deuxime partie de la table figure, non pas en dessous comme on s'y attendrait, mais ct de la premire partie de la table. Dans l'exemple ci-dessus, la partie droite sera ainsi dplace sous la partie gauche. Dployer Dploie la table. La bordure entre les deux parties doit d'abord tre fixe l'aide du curseur. On peut aussi diviser la table soit verticalement, soit horizontalement. Dfinit la condition d'une division verticale de la table. Ouvre la bote de dialogue Dfinition de la condition de la ligne (page 227).

Dploiement conditionnel...

224

Rotation

Assistant Fichier: Transformer, onglet Rotation

Les concepteurs de sites web font souvent pivoter les tables pour leur donner un meilleur aspect. Le principal but de la fonction de rotation est de permettre de remettre les tables l'endroit, c'est--dire d'obtenir les champs sous forme de colonnes, les noms de champs sur la premire ligne, etc. Gauche Droite Transposer Fait pivoter la table dans le sens inverse des aiguilles d'une montre. Fait pivoter la table dans le sens des aiguilles d'une montre. Transpose la table, c.--d., cre une copie miroir de la table le long d'un axe en diagonale, de sorte que la cellule situe dans le coin suprieur droit devienne la cellule du coin infrieur gauche et inversement. Les cellules en haut gauche et en bas droite, elles, restent leur place.

225

Assistant Fichier: Options

Assistant Fichier, Options

Paramtres du fichier
tiquettes Si les noms de champs (en-ttes de colonnes) sont stocks dans la premire ligne de la table, cette commande doit tre dfinie sur Imbriqu. Le format DIF permet aussi de spcifier explicitement les noms de champ; dans ce cas, il faut choisir Explicite. Si la table ne contient pas de noms de champs, utilisez l'option Aucun.

Clauses
O... Ouvre l'assistant Clause where (page 232) qui permet de crer une clause where pour l'instruction load. Annule la transformation et/ou la clause where d'un tableau crois.

Effacer

226

Prfixes
Crosstable Ouvre la bote de dialogue Tableau crois (page 250), o vous pouvez dfinir les paramtres de transformation d'un tableau crois sur un tableau trois colonnes (ou plus). Ouvre la bote de dialogue Paramtres de la hirarchie (page 233) permettant de dfinir les paramtres d'une table de hirarchies (tels qu'ils apparaissent dans le script entre parenthses). Annule la transformation d'un tableau crois ou d'une table de hirarchies.

Hirarchie...

Effacer

Si vous utilisez la fois une transformation de tableau crois et une clause where, celle-ci est value en premier. Il n'est donc pas possible de transformer d'abord un tableau crois, puis d'appliquer une clause where. Cependant, s'il faut appliquer une clause where une table dj transforme, l'utilisation d'une table temporaire rsoudra ce problme:

TempTable: Crosstable (...) Load ... from ...; RealTable: Load ... resident TempTable where ...; Drop Table TempTable;

Dfinition de la condition de la ligne

La bote de dialogue Dfinition de la condition de la ligne

Cette bote de dialogue est accessible via la bote de dialogue Assistant Fichier: Transformer, page Scories (bouton Suppression conditionnelle), la page Colonne (bouton Crer...) ou encore la page Dployer

227

ligne (bouton Dploiement conditionnel). Vous pouvez dfinir ici une condition logique pour slectionner une ou plusieurs lignes. En fonction du contexte, les lignes dfinies sont supprimes ou copies sur une nouvelle colonne et fractionnent la table en plusieurs parties.
Dans le groupe Condition, vous pouvez choisir de spcifier une condition o une colonne quivaut une valeur donne ou une autre colonne, une plage d'enregistrements ou tous les enregistrements. On peut appliquer plusieurs conditions la fois. Aprs avoir dfini une condition, appuyez sur le bouton Ajouter pour l'inclure dans la transformation. Comparer la valeur Comparer la colonne Plage Compare la cellule une condition de cellule qui peut donner vrai ou faux.

Compare la cellule la cellule correspondante d'une autre colonne.

Slectionne x lignes, puis ignore y lignes. Les positions de dbut et de fin peuvent tre indiques par des index. Utilisez cette condition si toutes les lignes doivent tre slectionnes. Dfinit le numro de la colonne laquelle la condition doit s'appliquer. Visible uniquement en mode Plage. Dfinit le numro de la ligne partir de laquelle les lignes doivent tre supprimes ou partir de laquelle une deuxime condition doit s'appliquer. Visible uniquement en mode Plage. Dfinit le numro de la ligne jusqu' laquelle les lignes doivent tre supprimes ou jusqu' laquelle une deuxime condition doit s'appliquer. Visible uniquement en mode Plage. Vous pouvez dcider ici d'une stratgie de slection, par exemple slectionner deux lignes, puis en ignorer une. Si toutes les lignes doivent tre utilises, l'option Slectionner doit tre dfinie sur 1 et l'option Ignorer sur 0.
Dans ce sous-groupe, vous pouvez spcifier des modificateurs pour la slection. Respecter la casse Activez cette option si les comparaisons doivent respecter la case. Not Cochez cette case si le critre de slection doit tre invers. Dans ce groupe, les conditions spcifies et incluses dans la transformation apparaissent. Un ET (AND) logique est appliqu entre les conditions. Ajouter Ajoute la condition dfinie la liste. Supprimer Supprime la condition slectionne de la liste.

Toutes les lignes Colonne De

Slectionner

Options

Conditions (AND)

228

Remplir les cellules

Bote de dialogue Remplir les cellules

Spcification

Dans le groupe Spcification, on peut indiquer dans quels cas la cellule doit tre remplie. Dfinit le numro de la colonne laquelle la condition doit s'appliquer. Ouvre la bote de dialogue Condition de la cellule (page 229) qui permet de dfinir cette condition. Dfinit la stratgie de remplissage des cellules. Choisissez l'une des valeurs Audessus, Gauche, Droite ou En dessous.

Colonne cible Condition de la cellule

Type de remplissage

Condition de la cellule

Bote de dialogue Condition de la cellule

Cette bote de dialogue s'ouvre partir de la bote de dialogue Remplir les cellules (page 229) et permet de spcifier une condition logique concernant le contenu d'une cellule. Valeur de la cellule Plusieurs options logiques sont disponibles dans le menu droulant. Pour comparer les chanes, saisissez une chane comparer dans le champ suivant. Pour comparer la longueur des contenus des cellules, prcisez la longueur de comparaison (valeur numrique) l'extrmit droite. NOT Respecter la casse Activez cette option si la condition doit tre inverse l'aide d'un NOT logique. Activez cette option si vous devez respecter la casse pour la comparaison des valeurs.

229

Dfinition des cellules pour la nouvelle colonne

Bote de dialogue Dfinition des cellules pour la nouvelle colonne

Cette bote de dialogue sert dfinir les conditions de la gnration automatique d'une nouvelle colonne partir d'une colonne existante. Elle est accessible via la page Colonne de la bote de dialogue Assistant Fichier: Transformer. Cellules et colonnes Colonne source Dtermine le numro de la colonne dont les valeurs de cellule doivent tre copies. Cellules de ces lignes... Ouvre la bote de dialogue Dfinition de la condition de la ligne (page 227) permettant de dfinir la condition de la ligne. Colonne cible Spcifie le numro des colonnes cible. Options avances

Remplacer la valeur nulle par la valeur prcdente Attribue aux cellules vides la valeur de la cellule au-dessus. Supprimer la ligne source Permet de supprimer la ligne source aprs en avoir copi le contenu.

Extension de cellule contextuelle

230

Bote de dialogue Extension de cellule contextuelle

Cette bote de dialogue permet de dvelopper le contenu d'une cellule en plusieurs cellules. Vous trouverez parfois plusieurs lignes d'une colonne stockes dans une seule cellule de la table HTML, c'est--dire entre les balises <TD> et </TD>. Cette cellule peut alors tre dveloppe en une colonne. Indiquez simplement la balise utilise comme dlimiteur entre les diffrentes lignes de la colonne. Il s'agit gnralement du symbole <BR>. Cellules insrer Nombre de cellules insrer. Normalement, cette valeur doit tre dfinie sur 1 mais si des lignes supplmentaires sont ncessaires, vous pouvez augmenter ce chiffre. Condition dterminant les lignes dvelopper.

Condition de la ligne

Interprtation contextuelle

Bote de dialogue Interprtation contextuelle

Avec cette bote de dialogue, vous pouvez remplacer la valeur d'une cellule par une information cache de la cellule. La cellule peut contenir plusieurs autres balises, chacune possdant un attribut, parfois plusieurs. En slectionnant la balise et l'attribut appropris, puis en cliquant sur OK, on remplace le contenu de la cellule par la valeur de l'attribut. Balise Liste des balises de la cellule. Attribut Valeur Attribut de la balise slectionne. Valeur de l'attribut.

231

Clause where

Bote de dialogue Clause where

Simple

Choisissez les champs qui doivent faire partie de la clause where et l'oprateur/la fonction utiliser. Vous pouvez aussi saisir une constante sur la base de valeurs de champs existantes. La deuxime et la troisime lignes deviennent actives quand vous slectionnez AND ou OR dans la liste droulante gauche de chaque ligne. Cochez Avanc pour saisir la clause partir de zro. L'option insre Where (1=1) dans le script et vous pouvez l'diter cet endroit.

Avanc Modle vide

Tableau crois
Un tableau crois est un type de table courant comprenant une matrice de valeurs entre deux listes orthogonales de donnes d'en-tte. Pour transformer un tableau crois en tableau simple, utilisez le prfixe crosstable. La syntaxe est la suivante:

crosstable (schamp d'attribut , champ de donnes [ , n ] ) ( instructionload | instructionselect )


o:

champ d'attribut est le champ qui contient les attributs. champ de donnes est le champ qui contient les donnes. n est le nombre de champs du qualificateur prcdant la table transformer au format gnrique. La valeur par dfaut est 1.

Exemples:
Crosstable (Mois, Ventes) Load * from ex1.csv; Crosstable (Mois,Ventes,2) Load * from ex2.csv; Crosstable (A,B) Select * from table3;

232

Assistant Tableau crois

Assistant Tableau crois

L'assistant Tableau crois est une mthode de cration de la syntaxe des tableaux croiss, base sur des botes de dialogue. Cette bote de dialogue est accessible par un clic sur le bouton Tableau crois la page Options de l'assistant Fichier. L'assistant Tableau crois contient les options suivantes. Champs du qualificateur Nombre de champs du qualificateur qui prcdent les champs transformer. Champ d'attribut Nom d'un nouveau champ qui contient tous les champs (valeurs d'attribut) transformer. Nom d'un nouveau champ qui contient toutes les donnes des valeurs d'attribut.

Champ de donnes

Paramtres de la hirarchie

233

Bote de dialogue Paramtres de la hirarchie

Paramtres de la source

Champ de l'ID (IDNoeud) Nom du champ contenant l'ID de noeud. Champ de l'ID parent (IDParent) Nom du champ contenant l'ID du noeud parent. Champ du nom (NomNoeud) Nom du champ contenant le nom du noeud. Nom du parent (NomParent) Nom du nouveau champ NomParent. Paramtre facultatif. Nom du chemin d'accs (NomChemin) Nom du nouveau champ Chemin contenant le chemin d'accs de la racine au nud. Paramtre facultatif. Nom de l'imbrication (Profondeur) Chane utilise pour nommer le nouveau champ Profondeur contenant la profondeur du nud dans la hirarchie. Paramtre facultatif. Source du chemin d'accs (SourceChemin) Nom du champ contenant le nom du nud utilis pour crer le chemin du nud. Paramtre facultatif. S'il est omis, NomNud est utilis. Dlimiteur de chemin d'accs (DlimiteurChemin) Chane utilise comme dlimiteur dans le nouveau champ Chemin par exemple \. Paramtre facultatif. S'il est omis, '/' est utilis. ID d'anctre (IDAnctre) Nom du nouveau champ d'id d'anctre contenant l'ID du nud anctre. Nom d'anctre (NomAnctre) Nom du nouveau champ anctre contenant le nom du nud anctre. Nom du champ DepthDiff (DepthDiff) Nom du nouveau champ DepthDiff contenant la profondeur du nud dans la hirarchie relative au nud anctre. Paramtre facultatif.

Paramtres de la hirarchie

Inclus dans les paramtres

234

Assistant Fichier: Script

Assistant Fichier, Script

La page Script permet de dfinir le mode de prsentation du script dans la bote de dialogue diter le script. Vous pouvez galement y dfinir le paramtre Longueur de ligne maximum pour faciliter l'interprtation du script.

Charger tout (*) permet de charger tous les champs de la table.


Le bouton Terminer gnre l'instruction load et ferme l'assistant.

235

Dbogueur

Dbogueur de script

Excuter le script dans le dbogueur peut grandement faciliter l'identification des erreurs de script. Le dbogueur vous permet de surveiller chaque instruction du script et d'examiner les valeurs des variables au fur et mesure de l'excution du script. Le script s'affiche dans la fentre de la moiti suprieure du dbogueur. La progression de l'excution du script est indique par une barre jaune. On peut insrer des points d'interruption en cliquant sur les numros de lignes et les supprimer en cliquant dessus une seconde fois. Cliquez sur le bouton Effacer pour supprimer tous les points d'interruption. Lorsque le programme rencontre un point d'interruption, il interrompt l'excution du script jusqu' ce qu'on lui donne l'instruction de poursuivre. L'instruction en cours d'excution s'affiche dans la fentre du milieu. Les codes d'tat et les erreurs de script sont affichs en bas gauche de la fentre. Ce sont peu prs les mmes informations qui s'affichent dans la fentre Excution du script en cours lorsque le script est excut en dehors du dbogueur. En bas droite de la fentre s'affichent toutes les Variable (page 183) et leurs valeurs respectives. Les variables qui ont chang sont de couleur rouge. Points d'arrt Les points d'arrt qui ont t dfinis dans la fentre de script de droite peuvent tre effacs. Un point d'arrt est reprsent par un disque rouge. Effacer Efface tous les points d'arrt.

236

Dboguer...

Ce groupe contient les paramtres qui permettent de dterminer comment le script doit tre excut dans le dbogueur. Excuter Il s'agit de l'excution normale du script. Le script ira jusqu' la fin ou jusqu' rencontrer un point d'interruption. Animation Le script s'excute comme prcdemment mais avec une courte pause aprs chaque instruction. De cette faon, vous pouvez surveiller l'excution du script de plus prs. tape Cette option excute une instruction du script la fois. Saisissez un nombre dans la bote flche en dessous. Le nombre saisi est le nombre maximum d'enregistrements accepts chaque instruction load et select. Cette mthode est trs utile pour limiter le temps d'excution quand le script est test avec des donnes actives. Ouvre l'aide de QlikView. Ferme le dbogueur mais conserve les donnes charges jusque-l. Abandonne l'excution du script sans garder toutes les donnes charges. Ouvre des onglets affichant des fichiers script externes rfrencs via $(include). Ouvrir Affiche une bote de dialogue partir de laquelle un fichier de script peut tre ouvert. Le contenu du fichier sera affich sous un onglet spar et peut tre utilis pour le dbogage. Fermer Ferme l'onglet script actif du dbogueur. L'onglet principal ne peut pas tre ferm.

Chargement limit

Aide Arrter ici Annuler Tampons

237

238

24 Syntaxe de script
Dans le script sont dfinis le nom de la source de donnes, les noms des tables et les noms des champs inclus dans la logique. Les champs de dfinition des droits d'accs y sont aussi dfinis. Le script consiste en un certain nombre d'instructions qui sont excutes successivement. Pour une description formelle de la notation de la syntaxe BNF utilise dans ce chapitre et dans les suivants, voir Backus-Naur Form (page 995).

24.1 Instructions de script et mots-cls


Le script QlikView consiste en un certain nombre d'instructions. Une instruction peut tre soit une instruction de script normale, soit une Instructions de contrle du script (page 242). Certaines instructions peuvent tre prcdes de prfixes. Les instructions normales sont en gnral utilises pour manipuler des donnes d'une manire ou d'une autre. Ces instructions peuvent tre crites sur autant de lignes de script que l'on veut et doivent toujours se terminer par un point-virgule, ;. Les instructions de contrle sont en gnral utilises pour contrler le flux de l'excution du script. Chaque clause d'une instruction de contrle doit tenir sur une ligne de script et peut se terminer par un point-virgule ou une fin de ligne. On peut appliquer des prfixes aux instructions normales mais jamais aux instructions de contrle. Les prfixes when et unless peuvent toutefois tre utiliss comme suffixes pour quelques clauses d'instructions de contrle. Dans le sous-chapitre suivant, vous trouverez une liste alphabtique de toutes les instructions de script, de toutes les instructions de contrle et de tous les prfixes. Tous les mots-cls du script peuvent tre taps en majuscules et/ou en minuscules. La casse a cependant une importance pour les noms de champs et de variables utiliss dans les instructions. Les instructions de script disponibles sont:

Ajouter Alias Binary Buffer Bundle Call Champ Commentaire Table de commentaires Concatenate Connexion Tableau crois

page 242 page 243 page 244 page 244 page 245 page 245 page 246 page 247 page 248 page 249 page 250

239

Directory Disconnect Do..loop Drop Field Drop Table Execute Exit script First For..next For each..next Force Generic Hierarchy HierarchyBelongsTo If..then..elseif..else..end if Image_size Info Inner Inputfield IntervalMatch IntervalMatch (syntaxe tendue) Join Keep Left Let Load

page 251 page 252 page 252 page 252 page 253 page 253 page 254 page 254 page 254 page 255 page 257 page 257 page 258 page 259 page 260 page 260 page 261 page 261 page 262 page 263 page 264 page 265 page 266 page 266 page 268 page 268

240

Loosen Table Mapping Map ... using NoConcatenate NullAsNull NullAsValue Outer Qualify Rem Rename Field Rename Table Replace Right Sample Section Select (SQL) Smantiques Set Sleep SQL SQLColumns SQLTables SQLTypes Star Store Sub..end sub

page 275 page 276 page 276 page 277 page 278 page 277 page 278 page 279 page 280 page 280 page 281 page 283 page 281 page 284 page 284 page 284 page 286 page 286 page 287 page 287 page 287 page 288 page 288 page 289 page 290 page 290

241

Switch..case..default..end switch Tag Field Trace Unless Unmap Unqualify Untag Field Quand

page 291 page 292 page 293 page 293 page 294 page 294 page 294 page 295

Instructions de contrle du script


Le script QlikView consiste en un certain nombre d'instructions. Une instruction peut tre soit une Instructions de script et mots-cls (page 239) normale, soit une instruction de contrle de script. Les instructions de contrle sont en gnral utilises pour contrler le flux de l'excution du script. Chaque clause d'une instruction de contrle doit tenir sur une ligne de script et peut se terminer par un point-virgule ou une fin de ligne. Les prfixes ne s'appliquent jamais aux instructions de contrle, l'exception des prfixes when et unless que l'on peut utiliser avec certaines instructions. Tous les mots-cls du script peuvent tre taps en majuscules et/ou en minuscules. Les instructions de contrle disponibles sont:

If..then..elseif..else..end if For..next For each..next Do..loop Switch..case..default..end switch Exit script Sub..end sub Call

page 260 page 254 page 255 page 252 page 291 page 254 page 290 page 245

Ajouter
Le prfixe add peut tre ajout n'importe quelle instruction Load (page 268), Select (SQL) (page 284) ou Map ... using (page 276) dans le script. Cette opration n'est utile que pendant les partial reloads. Pendant un rechargement partiel, le rsultat de l'instruction add load/add select est ajout la table QlikView pour laquelle un nom a t gnr par l'instruction add load/add select ( condition que cette table existe). La prsence de doublons n'est pas vrifie. L'instruction utilisant le prfixe add inclura donc normalement soit un qualificatif distinct, soit une clause where conservant les doublons. L'instruction add map...using permet d'effectuer aussi le mappage pendant une excution de script partielle. La syntaxe est la suivante:

242

add [only] (loadstatement |selectstatement |map...usingstatement)


o:

only est un qualificatif facultatif indiquant que l'instruction doit tre ignore pendant les rechargements (non partiels) normaux.

Exemples:
Onglet1: load Nom, Nombre from Personnes.csv; add load Nom, Nombre from NouvellesPersonnes.csv;
En cas de rechargement normal, les donnes sont charges partir du fichier Personnes.csv et stockes dans la table Onglet1 de QlikView. Les donnes du fichier NouvellesPersonnes.csv sont ensuite concatnes dans la mme table QlikView. Voir concatenated. En cas de rechargement partiel, les donnes sont charges partir du fichier NouvellesPersonnes.csv et ajoutes la table QlikView Onglet1. La prsence de doublons n'est pas vrifie.

Onglet1: select Nom, Nombre from Personnes.csv; add load Nom, Nombre from NouvellesPersonnes.csv where not exists(Nom);
Le programme vrifie qu'il n'y a pas de doublons en regardant si Nom existe dans les donnes dj charges dans la table (voir la fonction exists, paragraphe exists(champ [ , expression ]) (page 352)). En cas de rechargement normal, les donnes sont charges partir du fichier Personnes.csv et stockes dans la table Onglet1 de QlikView. Les donnes du fichier NouvellesPersonnes.csv sont ensuite concatnes dans la mme table QlikView. En cas de rechargement partiel, les donnes sont charges partir du fichier NouvellesPersonnes.csv, qui est ajout la table QlikView Onglet1. Le programme vrifie qu'il n'y a pas de doublons en regardant si Nom existe dans les donnes charges auparavant dans la table.

Onglet1: load Nom, Nombre from Personnes.csv; add only load Nom, Nombre from NouvellesPersonnes.csv where not exists(Nom);
En cas de rechargement normal, les donnes sont charges partir du fichier Personnes.csv et stockes dans la table Onglet1 de QlikView. L'instruction de chargement du fichier NouvellesPersonnes.csv est ignore. En cas de rechargement partiel, les donnes sont charges partir du fichier NouvellesPersonnes.csv, qui est ajout la table QlikView Onglet1. Le programme vrifie qu'il n'y a pas de doublons en regardant si Nom existe dans les donnes charges auparavant dans la table. Retour Instructions de script et mots-cls.

Alias
L'instruction alias est utilise pour dfinir un alias qui servira renommer un champ chaque fois qu'il apparatra dans le script qui suit. La syntaxe est la suivante:

alias nomdechamp as alias{ , nomdechamp as alias }


o:

nomdechamp et alias sont les chanes reprsentant ce que ces noms dsignent.

Exemples:
Alias ID_N as IDNom; Alias A as Nom, B as Nombre, C as Date;

243

Les modifications de noms dfinies par cette instruction sont utilises dans toutes les instructions Select (SQL) (page 284) et Load (page 268) excutes par la suite. Un nouvel alias peut ensuite tre dfini pour un nom de champ par une nouvelle instruction alias n'importe quel endroit du script. Retour Instructions de script et mots-cls (page 239).

Binary
L'instruction binary est utilise pour charger les parties accs et donnes d'un document QlikView. Elle ne charge pas les informations de disposition. Une seule instruction binary est autorise dans le script et il ne peut s'agir que de la premire instruction d'un script. La syntaxe est la suivante:

binaryfichier
o: fichier ::= [ chemin ] nomdefichier

Exemples:
Binary client.qvw; Binary c:\qv\client.qvw;
Le chemin est soit le chemin absolu, soit le chemin relatif par rapport au fichier .qvw contenant cette ligne de script. Retour Instructions de script et mots-cls (page 239).

Buffer
On peut crer et grer des fichiers QVD automatiquement l'aide du prfixe buffer. Ce prfixe peut tre utilis dans la plupart des instructions Load (page 268) et Select (SQL) (page 284) du script. Il indique que des Fichiers QVD (page 425) sont utiliss pour mettre en cache/mmoire tampon le rsultat de l'instruction. Il existe de nombreuses limites, la plus importante tant qu'il doit y avoir soit une instruction load de chargement de fichier, soit une instruction select au cur de toute instruction complexe. Le nom du fichier QVD est un nom calcul (hachage hexadcimal de 160bits de toute l'instruction load ou select qui suit et d'autres informations discriminantes) et est en gnral stock dans le dossier Application Data ou dans un autre dossier spcifi sous l'onglet Prfrences utilisateur: Emplacements (page 99). Autrement dit, le buffer QVD ne sera plus valide si l'instruction load ou select qui suit est modifie. Les buffers QVD sont normalement supprims lorsqu'ils ne sont plus rfrencs nulle part lors d'une excution complte du script dans le document qui les a crs, ou lorsque le document qui les a crs n'existe plus. Bien que cette procdure ne soit pas recommande de manire gnrale, on peut dsactiver ce nettoyage en cochant les options Conserver les buffers QVD non rfrencs dans Proprits du document: Gnral (page 440) (premire condition) et Conserver les buffers QVD orphelins dans Prfrences utilisateur (page 81) (deuxime condition). La syntaxe est la suivante:

buffer[ (option [ , option] ) ] ( loadstatement | selectstatement )


o:

option ::= incremental | expiration


expiry::= stale [after]amount[ (days | hours)]

intervalle est un nombre spcifiant la priode. On peut utiliser des dcimales. Sauf indication contraire, l'unit est days (jours).

244

L'option incremental permet de ne lire qu'une partie d'un fichier sous-jacent. La taille prcdente du fichier est stocke dans l'en-tte XML du fichier QVD. C'est particulirement utile dans le cas des journaux. Tous les enregistrements chargs prcdemment sont lus partir du fichier QVD, tandis que les nouveaux enregistrements sont lus partir de la source, avant qu'un fichier QVD jour ne soit cr. Toutefois, l'option incremental ne peut tre utilise qu'avec des instructions load et des fichiers texte et incremental load ne peut pas tre utilise lorsque d'anciennes donnes ont t modifies ou supprimes. L'option stale after est en gnral utilise avec des sources de base de donnes qui ne comportent pas d'horodatage simple des donnes d'origine. la place, on indique de quand peut dater l'instantan QVD pour tre utilis. Une clause stale after spcifie simplement un intervalle de temps partir de la cration du buffer QVD, aprs lequel il ne sera plus considr comme valide. Avant l'expiration de ce dlai, le buffer QVD sera utilis comme source de donnes et aprs, le programme utilisera la source de donnes d'origine. Le fichier de buffer QVD sera alors automatiquement mis jour et le programme calcule un nouvel intervalle de temps. Si aucune option n'est utilise, le buffer QVD cr par la premire excution du script sera utilis indfiniment.

Exemples:
buffer select * from MaTable; buffer (stale after 7 days) select * from MaTable; buffer (incremental) load * from MonJournal.log;

Retour Instructions de script et mots-cls (page 239).

Bundle
Si une information externe, telle qu'une image ou un fichier son, doit tre connecte (voir Lier des informations des valeurs de champs (page 417)) une valeur de champ, cela se fait dans une table charge l'aide du prfixe Info (page 261). Pour conserver la portabilit, vous pouvez inclure les fichiers externes dans le fichier .qvw lui-mme. Pour cela, utilisez le prfixe bundle. Les fichiers d'information regroups sont alors compresss, mais prendront tout de mme de l'espace supplmentaire dans le fichier et dans la mmoire vive. Regardez donc la taille et le nombre de fichiers regroups avant de choisir cette solution. Les informations peuvent tre rfrences partir de l'apparence comme des informations normales, par la fonction informations du graphique, ou sous la forme d'un fichier interne par la syntaxe spciale qmem:// nomdechamp / valeurdechamp qmem:// nomdechamp / < index > o index est l'index interne d'une valeur de champ. On peut omettre le prfixe info lorsqu'on utilise bundle.

bundle[info] ( instructionload| instructionselect)

Exemples:
Bundle info Load * from flagoecd.csv; Bundle Select * from infotable;
Retour Instructions de script et mots-cls (page 239).

Call
L'instruction de commande call appelle une sous-routine qui doit tre dfinie par une instruction sub. La syntaxe est la suivante:

callnom ( [ listeparam ])

245

o:

nom listeparam

est le nom de la sous-routine. est une liste des paramtres envoyer la sous-routine, spars par des virgules. Chaque lment de la liste peut tre un nom de champ, une variable ou une expression arbitraire.

La sous-routine appele par une instruction call doit tre dfinie auparavant dans l'excution du script par une instruction sub. Les paramtres sont copis dans la sous-routine et, si le paramtre de l'instruction call est un nom de champ, il est recopi et supprim la fermeture de la sous-routine. Comme l'instruction call est une instruction de commande, et qu'elle se termine donc soit par un pointvirgule, soit par une fin de ligne, elle ne doit pas s'tendre sur plusieurs lignes.

Exemples:
// Exemple 1 sub INCR (I,J) I = I + 1 exit sub when I < 10 J = J + 1 end sub call INCR (X,Y) // Exemple 2 - Liste de tous les fichiers lis QV sur le disque sub DoDir (Root) for each Ext in 'qvw', 'qvo', 'qvs', 'qvt', 'qvd' for each File in filelist (Root&'\*.' &Ext) Load '$(Fichier)' as Nom, FileSize( '$(Fichier)' ) as Taille, FileTime( '$(Fichier)' ) as DateFichier autogenerate 1; next File next Ext for each Dir in dirlist (Root&' \*' ) call DoDir (Dir) next Dir end sub call DoDir ('C:')
Retour Instructions de script et mots-cls (page 239).

Champ Commentaire
Permet d'afficher les commentaires de champ (mtadonnes) partir des bases de donnes et des tableurs. Les noms de champs absents du document seront ignors. Si plusieurs occurrences d'un nom de champ sont dtectes, la dernire valeur est utilise. Le mot-cl permet de lire les commentaires partir d'une source de donnes l'aide de la syntaxe suivante :

246

commentaire*listedechampsutilisantnomdemappage

*listedechamps est une liste des champs inclure dans le commentaire spars par des virgules. Utiliser * comme liste de champs signifie tous les champs. Les caractres gnriques * et ? sont autoriss dans les noms des champs. Il peut tre ncessaire de mettre les noms des champs entre guillemets quand on utilise des caractres gnriques. nomdemappage est le nom d'une table de mappage dj lue dans une instruction mapping load ou mapping select (voir Mapping (page 276)).
La table de mappage utilise doit comporter deux colonnes, la premire avec les noms de champs et la deuxime avec les commentaires. Pour dfinir les commentaires spars, la syntaxe suivante est utilise :

commentairenomdechampwithcommentaire

nomdechamp dsigne le champ commenter. commentaire est le commentaire ajouter au champ.

Exemple 1:
commentmap: mapping load * inline [ a,b Alpha,Ce champ contient des valeurs de texte Num,Ce champ contient des valeurs numriques ]; champs de commentaire utilisant commentmap ;

Exemple 2:
champ de commentaire Alpha avec un champ contenant des caractres ; champ de commentaire Num avec *un champ contenant des chiffres'; commentaire Gamma avec 'champ Mickey';
Retour Instructions de script et mots-cls (page 239).

Table de commentaires
Permet d'afficher les commentaires de table (mtadonnes) partir des bases de donnes et des tableurs. Les noms de tables absents du document sont ignors. Si plusieurs occurrences d'un nom de table sont dtectes, la dernire valesur est utilise. Le mot-cl permet de lire les commentaires partir d'une source de donnes l'aide de la syntaxe suivante:

tables de commentaireslistedetablesutilisantnomdemappage
o

listedetables := (table{,table })

247

nomdemappage est le nom d'une table de mappage dj lue dans une instruction mapping load ou mapping select (voir Mapping (page 276)).
Pour dfinir les commentaires spars, la syntaxe suivante est utilise :

tables de commentairesnom de tablewithcommentaire


o

nomdetable dsigne la table commenter. commentaire est le commentaire ajouter la table.

Exemple 1:
Commentmap: mapping Load * inline [ a,b Principale, Table rpertoriant les faits Devises, Table rpertoriant les devises ]; tables de commentaires utilisant commentmap ;

Exemple 2:
table de commentaires Principale avec la table rpertoriant les faits principaux ;
Retour Instructions de script et mots-cls (page 239).

Concatenate
Si deux tables qui doivent tre concatnes ont des ensembles de Champs (page 181), la concatenation peut quand mme tre force l'aide du prfixe conscatenate. Cette instruction force la concatnation avec une table existante et nomme ou avec la dernire logical table cre. La syntaxe est la suivante:

concatenate[ (nomdetable ) ] ( instructionload | instructionselect )

Exemples:
Concatenate load * from fichier2.csv; Concatenate select * from table3;

tab1: Load * from fichier1.csv; tab2 : Load * from fichier2.csv; .. .. .. Concatenate (tab1) load * from fichier3.csv;
Retour Instructions de script et mots-cls (page 239).

248

Connexion
Une base de donnes gnrale est accessible par l'interface OLEDB/ODBC, mais la source de donnes doit d'abord tre spcifie. On le fait l'aide de l'instruction CONNECT. La syntaxe est la suivante:

ODBC CONNECT TOconnect-string [ ( access_info ) ] OLEDB CONNECT TOconnect-string [ ( access_info ) ] CUSTOM CONNECT TOconnect-string [ ( access_info ) ]
o:

connect-string ::= nomsourcedonnes { ;lm-spc-conn} La chane de connexion se compose du nom de la source de donnes et d'une liste facultative d'un ou plusieurs lments de spcification de la connexion. Si le nom de la source de donnes contient des blancs, ou si des lments de spcification de la connexion sont prciss, la chane de connexion doit tre place entre Guillemets (page 305). nomsourcedonnes doit correspondre une source de donnesODBC dfinie. lm-spc-conn ::=DBQ=spcificateur_basededonnes | DriverID=spcificateur_pilote | UID=IDutilisateur | PWD=motdepasse Les lments de spcification de la connexion peuvent diffrer d'une base de donnes l'autre. Pour certaines bases de donnes, d'autres lments que les lments ci-dessus sont possibles. Normalement, seul le spcificateur de base de donnes est utilis. access_info ::= lm_accs { , lm_accs } access_item ::= ( userid is IDutilisateur | xuserid isnomdutilisateurcrypt ) | (password is motdepasse |xpassword ismodepassecrypt) | codepage is IDpagedecodes |mode iswrite codepageID ::= ansi|oem|unicode| numropagedecode Si l'instruction connect est gnre par l'assistant fourni, les ID d'utilisateur (user ID) et mot de passe seront gnrs avec la syntaxe crypte xuserid is/xpassword is condition que la case Brouiller les informations d'identification utilisateur soit coche dans les Prfrences utilisateur (page 81). Si vous saisissez l'instruction connect, vous devez utiliser la syntaxe userid is / password is non crypte pour pouvoir fournir l'ID utilisateur et le mot de passe. Le cryptage total n'est pas disponible actuellement pour les instructions ODBC connect, car certaines parties de la chane OLEDB connect ne peuvent pas tre cryptes.
Vous pouvez utiliser la commande codepage is si vous rencontrez des problmes avec les caractres nationaux dans des pilotes ODBC/OLEDB spcifiques. Si mode is write est spcifi dans les access_info, la connexion sera ouverte en mode lecture-criture. Dans tous les autres cas, la connexion sera ouverte en lecture seule. Si ODBC est plac avant CONNECT, l'interface ODBC sera utilise; sinon, ce sera OLEDB.

Exemple:
ODBC CONNECT TO 'Nwind; DBQ=C:\Program Files\Access\Samples\Northwind.mdb' (UserID is sa, Password is admin);
La source de donnes dfinie par cette instruction est utilise par les instructions Select (SQL) (page 284) qui suivent, jusqu' ce qu'une nouvelle instruction CONNECT soit introduite. La mthode connexion la base de donne utilise par l'instruction connect (au moyen d'un fournisseur version 32bits ou 64bits) est dtermine par les versions de QlikView et de Windows en cours d'excution:

249

Windows 64 bits 64 bits 64 bits 64 bits 64 bits 64 bits 32 bits 32 bits 32 bits

QlikView 64 bits 64 bits 64 bits 32 bits 32 bits 32 bits 32 bits 32 bits 32 bits

Instruction connect connect connect32 connect64 connect connect32 connect64 connect connect32 connect64

Rsultat utilise un ODBC 64 bits utilise un ODBC 32 bits utilise un ODBC 64 bits utilise un ODBC 32 bits utilise un ODBC 32 bits utilise un ODBC 64 bits utilise un ODBC 32 bits utilise un ODBC 32 bits entrane une erreur de script

Connect32
Cette instruction a la mme utilit que l'instruction connect, mais elle oblige un systme 64 bits utiliser un fournisseur ODBC/OLEDB 32bits. Ne s'applique pas custom connect.

Connect64
Cette instruction a la mme utilit que l'instruction connect, mais elle oblige l'utilisation d'un fournisseur 64bits. Ne s'applique pas custom connect. Retour Instructions de script et mots-cls (page 239).

Tableau crois
Un tableau crois est un type de table courant comprenant une matrice de valeurs entre deux listes orthogonales de donnes d'en-tte. Pour transformer un tableau crois en tableau simple, utilisez le prfixe crosstable. La syntaxe est la suivante:

crosstable (schamp d'attribut , champ de donnes [ , n ] ) ( instructionload | instructionselect )


o:

champ d'attribut est le champ qui contient les attributs. champ de donnes est le champ qui contient les donnes. n est le nombre de champs du qualificateur prcdant la table transformer au format gnrique. La valeur par dfaut est 1.

Exemples:
Crosstable (Mois, Ventes) Load * from ex1.csv; Crosstable (Mois,Ventes,2) Load * from ex2.csv; Crosstable (A,B) Select * from table3;

250

Assistant Tableau crois

Assistant Tableau crois

L'assistant Tableau crois est une mthode de cration de la syntaxe des tableaux croiss, base sur des botes de dialogue. Cette bote de dialogue est accessible par un clic sur le bouton Tableau crois la page Options de l'assistant Fichier. L'assistant Tableau crois contient les options suivantes. Champs du qualificateur Nombre de champs du qualificateur qui prcdent les champs transformer. Champ d'attribut Nom d'un nouveau champ qui contient tous les champs (valeurs d'attribut) transformer. Nom d'un nouveau champ qui contient toutes les donnes des valeurs d'attribut.

Champ de donnes

Directory
L'instruction Load (page 268) peut tre prcde d'une instruction directory, qui dfinit le rpertoire dans lequel le programme doit chercher les fichiers.

directorychemin
o:

chemin est un texte qui peut tre interprt comme le chemin d'un fichier, soit absolu, soit relatif par rapport au fichier .qvw.

Exemple:
Directory c:\userfiles\donnes;
Le rpertoire dfini par cette instruction est utilis par les instructions Load (page 268) qui suivent, jusqu' ce qu'une nouvelle instruction directory soit introduite. Une instruction directory est gnre si l'option Chemins relatifs est active dans la bote de dialogue diter le script. Retour Instructions de script et mots-cls (page 239).

251

Disconnect
Met fin la connexion ODBC/OLEDB en cours. Cette instruction est facultative. Il sera automatiquement mis fin la connexion lorsqu'une nouvelle instruction connect sera excute ou lorsque l'excution du script sera termine. La syntaxe est la suivante: disconnect

Exemple:
disconnect;
Retour Instructions de script et mots-cls (page 239).

Do..loop
L'instruction de contrle do..loop cre une boucle qui sera excute jusqu' ce qu'une condition logique soit remplie. La syntaxe est la suivante:

do[ ( while | until ) condition ] [instructions] [exit do [ ( when | unless ) condition ] [instructions] loop[ ( while | until ) condition ]
o:
condition instructions est une expression logique dont l'valuation donne vrai ou faux. correspond tout groupe d'une ou plusieurs instructions de script QlikView.

Les clauses conditionnelles while ou until ne doivent apparatre qu'une fois dans une instruction do..loop, soit aprs do, soit aprs loop. Chaque condition n'est interprte que la premire fois, mais elle est value chaque fois que le script la rencontre dans la boucle. Si une clause exit do se trouve dans la boucle, l'excution du script sera transfre la premire instruction aprs la clause loop, ce qui implique la fin de la boucle. Une clause exit do peut tre rendue conditionnelle par l'utilisation facultative d'un suffixe when ou unless. Comme l'instruction do..loop est une instruction de contrle et, en tant que telle, se termine par un pointvirgule ou une fin de ligne, aucune de ses trois clauses possibles (do, exit do et loop) ne peut s'tendre sur plusieurs lignes.

Exemples:
// charger les fichiers fichier1.csv..fichier9.csv for a=1 do while a<10 load * from file$(a).csv; let a=a+1; loop
Retour Instructions de script et mots-cls (page 239).

Drop Field
On peut retirer un ou plusieurs champs QlikView de la mmoire n'importe quel moment de l'excution du script, au moyen d'une instruction drop field. La syntaxe est la suivante:

252

drop field[ s ] nomdechamp [ , nomdechamp2 ...] [from nomdelatable1 [ , nomdelatable2 ...]]


Les formes drop field et drop fields sont toutes deux autorises et leur effet est le mme. Si aucune table n'est spcifie, les champs sont retirs de toutes les tables qui en contiennent.

Exemples:
drop field A; drop fields A,B; drop field A from X; drop fields A,B from X,Y;
Retour Instructions de script et mots-cls (page 239).

Drop Table
Vous pouvez retirer une ou plusieurs tables internes QlikView de la mmoire n'importe quel moment de l'excution du script, au moyen d'une instruction drop table. Les lments suivants seront alors perdus:
l l l

La ou les tables slectionnes. Tous les champs qui ne font pas partie des tables restantes. Les valeurs des champs restants qui provenaient exclusivement de la ou des tables retires.

La syntaxe est la suivante:

drop table[ s ]nomdelatable [, nomdelatable2 ...]


Les formes drop table et drop tables sont toutes deux acceptes.

Exemples:
drop table Commandes, Vendeurs, T456a;
Cette ligne a pour rsultat le retrait de trois tables de la mmoire. Tab1:

select * from Trans; load Client, Sum( ventes ) resident Tab1 group by Mois; drop table Tab1;
En consquence, seuls les agrgats restent en mmoire. Trans data est ignor. Retour Instructions de script et mots-cls (page 239).

Execute
Avec l'instruction execute, il est possible d'excuter d'autres programmes pendant la rexcution du script QlikView, par exemple quand des conversions sont ncessaires. La syntaxe est la suivante:

executelignecommande
o:

lignecommande est un texte qui peut tre interprt par le systme d'exploitation comme une ligne de commande.

Exemples:

253

Execute C:\Program Files\Office12\Excel.exe; Execute winword macro.doc; Execute cmd.exe /C C:\BatFiles\Log.bat Remarque: Le /C doit tre inclus car il correspond un paramtre de cmd.exe.
Retour Instructions de script et mots-cls (page 239).

Exit script
L'instruction de contrle exit script arrte l'excution du script. Elle peut tre insre n'importe o dans le script. Une instruction exit script peut tre rendue conditionnelle par l'utilisation facultative d'une clause when ou unless. La syntaxe est la suivante:

exit script[ (when | unless) condition ]


o

condition est une expression logique dont l'valuation donne vrai ou faux.
Comme l'instruction exit script est une instruction de commande, et qu'elle se termine donc soit par un point-virgule, soit par une fin de ligne, elle ne doit pas s'tendre sur plusieurs lignes.

Exemples:
exit script exit script; exit script when a=1
Retour Instructions de script et mots-cls (page 239).

First
Le prfixe first d'une instruction Load (page 268) ou Select (SQL) (page 284) est utilis pour charger uniquement un nombre maximum dfini d'enregistrements de la source de donnes, quelle que soit sa longueur. La syntaxe est la suivante:

first n( instructionload | instructionselect )


o:

n est une expression arbitraire qui donne un entier indiquant le nombre maximum d'enregistrements lire.

Exemples:
First 10 Load * from abc.csv; First (1) Select * from Commandes; (Remarque: la parenthse est autorise mais non requise.)
Retour Instructions de script et mots-cls (page 239).

For..next
L'instruction de contrle for..next cre une boucle avec compteur. Les instructions comprises entre for et next l'intrieur de la boucle seront excutes pour chaque valeur de la variable du compteur entre les limites infrieure et suprieure spcifies. La syntaxe est la suivante:

forcounter = expr1 to expr2 [ step expr3 ]

254

[ instructions ] [exit for [ ( when | unless ) condition ] [ instructions ] next[counter]


o:

counter dsigne une variable de script. Si counter est spcifi aprs next, il doit s'agir du mme nom de variable que celui qui se trouve aprs le for correspondant. expr1 dsigne une expression expression qui donne la premire valeur de la variable counter pour laquelle la boucle doit tre excute. expr2 dsigne une expression qui donne la dernire valeur de la variable counter pour laquelle la boucle doit tre excute. expr3 dsigne une expression qui donne la valeur de l'incrment de la variable counter chaque fois que la boucle a t excute. condition est une expression logique dont l'valuation donne vrai ou faux. instructions correspond tout groupe d'une ou plusieurs instructions de script QlikView.
Les expressions expr1, expr2 et expr3 ne sont values que la premire fois que le script entre dans la boucle. La valeur de la variable counter peut tre modifie par des instructions l'intrieur de la boucle, mais ce n'est pas une bonne mthode de programmation. Si une clause exit for se trouve dans la boucle, l'excution du script sera transfre la premire instruction aprs la clause next, ce qui implique la fin de la boucle. Une clause exit for peut tre rendue conditionnelle par l'utilisation facultative d'un suffixe when ou unless. Comme l'instruction for..next est une instruction de contrle et, en tant que telle, se termine par un pointvirgule ou une fin de ligne, aucune de ses trois clauses possibles (for..to..step, exit for et next) ne peut s'tendre sur plusieurs lignes.

Exemples:
// charger les fichiers fichier1.csv..fichier9.csv for a=1 to 9 load * from file$(a).csv; next for counter=1 to 9 step 2 set filename=x$(counter).csv; if rand( )<0.5 then exit for unless counter=1 end if load a,b from $(filename); next
Retour Instructions de script et mots-cls (page 239).

For each..next
L'instruction de contrle for each..next cre une boucle qui s'excute pour chaque valeur d'une liste de valeurs spares par des virgules. Les instructions comprises entre for et next l'intrieur de la boucle seront

255

excutes pour chaque valeur de la liste. Une syntaxe spciale permet de gnrer une liste des noms de fichiers et de rpertoires dans le rpertoire actif. La syntaxe est la suivante:

for eachvar in list [ instructions ] [exit for [ ( when | unless ) condition ] [ instructions ] next[var]
o:

var dsigne une variable de script qui prendra une nouvelle valeur de la liste pour chaque excution de la boucle. Si var est spcifie aprs next, il doit s'agir du mme nom de variable que celui qui se trouve aprs l'instruction for each correspondante.

liste := lment { , lment } lment := constante | (expression) | filelistmasque | dirlistmasque


constante dsigne un nombre ou une chane. expression dsigne une expression arbitraire. masque dsigne le masque d'un nom de fichier ou de rpertoire qui peut inclure tous les caractres des noms de fichier valides, ainsi que les caractres gnriques standard, * et ?. condition est une expression logique dont l'valuation donne vrai ou faux. instructions correspond tout groupe d'une ou plusieurs instructions de script QlikView.
La syntaxe filelistmasque gnre une liste de tous les fichiers, spars par des virgules, qui se trouvent dans le rpertoire actuel et qui correspondent au masque du nom de fichier. La syntaxe dirlistmasque gnre une liste de tous les rpertoires, spars par des virgules, qui se trouvent dans le rpertoire actuel et qui correspondent au masque du nom de fichier. La valeur de la variable var peut tre modifie par des instructions l'intrieur de la boucle mais ce n'est pas une bonne mthode de programmation. Si une clause exit for se trouve dans la boucle, l'excution du script sera transfre la premire instruction aprs la clause next, ce qui implique la fin de la boucle. Une clause exit for peut tre rendue conditionnelle par l'utilisation facultative d'un suffixe when ou unless. Comme l'instruction for each..next est une instruction de contrle et, en tant que telle, se termine par un point-virgule ou une fin de ligne, aucune de ses trois clauses possibles (for each, exit for et next) ne peut s'tendre sur plusieurs lignes.

Exemples:
for each a in 1,3,7,'xyz' load * from file$(a).csv; next // liste de tous les fichiers lis QV sur le disque sub DoDir (Root) for each Ext in 'qvw', 'qva', 'qvo', 'qvs' for each File in filelist (Root&' \*.' &Ext) Load '$(Fichier)' as Nom, FileSize( '$(Fichier)' ) as

256

Taille, FileTime( '$(Fichier)' ) as DateFichier autogenerate 1; next File next Ext for each Dir in dirlist (Root&' \*' ) call DoDir (Dir) next Dir end sub call DoDir ('C:')
Retour Instructions de script et mots-cls (page 239).

Force
L'instruction force oblige QlikView interprter les valeurs de champs des instructions Load (page 268) et Select (SQL) (page 284) qui suivent comme du texte crit uniquement en majuscules, uniquement en minuscules, toujours mises en majuscules ou telles qu'elles apparaissent (mixte). Cette instruction permet d'associer des valeurs de champs de tables labores selon diffrentes conventions. La syntaxe est la suivante:

force ( capitalization | case upper | case lower | case mixed )

Exemples:
Force Capitalization; Force Case Upper; Force Case Lower; Force Case Mixed;
dfaut d'indication, c'est la casse mixte qui est utilise. L'instruction force est valide jusqu' ce qu'une nouvelle instruction force soit cre. L'instruction force n'a pas d'effet sur la section d'accs : aucune des valeurs de champ n'est sensible la casse. Retour Instructions de script et mots-cls (page 239).

Generic
On peut effectuer la dcompression et le chargement d'une base de donnes gnrique l'aide du prfixe generic. Pour une description des bases de donnes gnriques, reportez-vous au manuel de rfrence de QlikView. Pour une description des bases de donnes gnriques, reportez-vous au chapitre Base de donnes gnrique de la section valuation des donnes charges (page 407). La syntaxe est la suivante:

genericgeneric( instructionload | instructionselect )

Exemples:
Generic Load * from abc.csv; Generic Select * from table1;
Retour Instructions de script et mots-cls (page 239).

257

Hierarchy
Le mot-cl hierarchy est un prfixe ajout pour les instructions Load (page 268) et Select (SQL) (page 284). On l'utilise pour transformer une table de nuds adjacente en table de nuds tendue. Par consquent, la table interne doit tre une table de nuds adjacente. Le prfixe hierarchy gnre une table de nuds tendue comprenant tous les champs supplmentaires requis. Les tables de nuds adjacentes sont des tables dans lesquelles chaque enregistrement correspond un nud et possde un champ contenant une rfrence vers le nud parent. Dans une table de ce type, le nud est stock dans un seul enregistrement, mais peut avoir plusieurs enfants. La table peut bien sr avoir des champs supplmentaires dcrivant les attributs des nuds. Dans les tables de nuds tendues, chaque niveau hirarchique est enregistr dans un champ distinct. Dans une table de nuds tendue, les niveaux peuvent tre utiliss facilement, dans un tableau crois dynamique ou une structure d'arbres, par exemple. Pour plus d'informations sur les tables de nuds adjacentes et tendues, reportez-vous la section Hirarchies du manuel de rfrence de QlikView.Pour plus d'informations sur les tables de nuds adjacentes et tendues, reportez-vous au chapitre Hirarchies de la section valuation des donnes charges (page 407). Habituellement, la table interne prsente un enregistrement par nud, tout comme la table de sortie. Cependant, certains nuds prsentent plusieurs parents, c'est--dire qu'un nud est reprsent par plusieurs enregistrements. Dans ce cas, la table de sortie peut contenir plus d'enregistrements que la table interne. Tous les nuds sans ID parent ou dont l'ID parent n'a pas t trouv dans la colonne IDNud sont considrs comme des nuds racine. En outre, seuls les nuds en connexion directe ou indirecte avec un nud racine sont chargs. Cela vite ainsi les rfrences circulaires. Des champs supplmentaires contenant le nom du nud parent, le chemin d'accs et la profondeur du nud peuvent tre crs. La syntaxe est la suivante:

Hierarchy (IDNud, IDParent, NomNud, [NomParent], [SourceChemin], [NomChemin], [DlimiteurChemin], [Profondeur])(instructionload | instructionselect)
o

IDNud est le nom du champ contenant l'ID du nud. IDParent est le nom du champ contenant l'ID du nud parent. NomNud est le nom du champ contenant le nom du nud. NomParent est une chane utilise pour nommer le nouveau champ NomParent. Si cette chane est omise, le champ n'est pas cr. SourceChemin est le nom du champ contenant le nom du nud utilis pour crer le chemin du nud. Paramtre facultatif. S'il est omis, NomNud est utilis. NomChemin est une chane utilise pour nommer le nouveau champ Chemin contenant le chemin de la racine au nud. Paramtre facultatif. Si cette chane est omise, le champ n'est pas cr. DlimiteurChemin est une chane utilise comme dlimiteur dans le nouveau champ Chemin. Paramtre facultatif. S'il est omis, '/' est utilis. Profondeur est une chane utilise pour nommer le nouveau champ Profondeur contenant la profondeur du nud dans la hirarchie. Paramtre facultatif. Si cette chane est omise, le champ n'est pas cr.

Exemple:
Hierarchy(IDNud, IDParent, NomNud) Load IDNud, IDParent, NomNud,

258

Attribut From data.xls (biff, embedded labels, table is [Sheet1$];


Retour Instructions de script et mots-cls (page 239).

HierarchyBelongsTo
Le mot-cl hierarchybelongsto est un prfixe ajout aux instructions Load (page 268) et Select (SQL) (page 284). La table interne doit tre une table de nuds adjacente. Les tables de nuds adjacentes sont des tables dans lesquelles chaque enregistrement correspond un nud et possde un champ contenant une rfrence vers le nud parent. Dans une table de ce type, le nud est stock dans un seul enregistrement, mais peut avoir plusieurs enfants. La table peut bien sr avoir des champs supplmentaires dcrivant les attributs des nuds. Pour plus d'informations sur les tables de nuds adjacentes et tendues, reportez-vous la section Hirarchies du manuel de rfrence de QlikView.Pour plus d'informations sur les tables de nuds adjacentes et tendues, reportez-vous au chapitre Hirarchies de la section valuation des donnes charges (page 407). Le prfixe cre une table contenant toutes les relations anctre-enfant de la hirarchie. Les champs anctre peuvent alors tre utiliss pour slectionner des arbres entiers dans la hirarchie. La table de sortie contient gnralement plusieurs enregistrements par nud. Un champ supplmentaire contenant la diffrence de profondeur des nuds peut tre cr. La syntaxe est la suivante:

HierarchyBelongsTo (IDNud, IDParent, NomNud, IDAnctre, NomAnctre, [DiffrenceProfondeur])(instructionload | instructionselect)


o

IDNud est le nom du champ contenant l'ID du nud. IDParent est le nom du champ contenant l'ID du nud parent. NomNud est le nom du champ contenant le nom du nud. IDAnctre est une chane utilise pour nommer un nouveau champ de l'ID de l'anctre contenant l'ID du nud anctre. NomAnctre est une chane utilise pour nommer un nouveau champ ID de l'anctre contenant le nom du nud anctre. DiffrenceProfondeur est une chane utilise pour nommer le nouveau champ DiffrenceProfondeur contenant la profondeur du nud dans la hirarchie relative au nud anctre. Paramtre facultatif. Si cette chane est omise, le champ n'est pas cr.

Exemple:
HierarchyBelongsTo (IDNud, IDParent, Nud, Arbre, NomParent) Load IDNud, IDParent, NomNud From data.xls (biff, embedded labels, table is [Sheet1$];
Retour Instructions de script et mots-cls (page 239).

259

If..then..elseif..else..end if
L'instruction de contrle if..then cre une clause conditionnelle qui oriente l'excution du script diffremment selon une ou plusieurs conditions logiques. La syntaxe est la suivante:

ifcondition then [ instructions ] { elseif condition then [ instructions ] } [ else [ instructions ] ]


end if o:

condition est une expression logique qui peut tre value comme vraie ou fausse. instructions correspond tout groupe d'une ou plusieurs instructions de script QlikView.
Comme l'instruction if..then est une instruction de contrle et, en tant que telle, se termine par un pointvirgule ou une fin de ligne, aucune de ses quatre clauses possibles (if..then, elseif..then, else et end if) ne peut s'tendre sur plusieurs lignes.

Exemples:
if a=1 then load * from abc.csv; sql select e, f, g from tab1; end if if a=1 then; drop table xyz; end if; if x>0 then load * from pos.csv; elseif x<0 then load * from neg.csv; else load * from zero.txt; end if
Retour Instructions de script et mots-cls (page 239).

Image_size
Cette instruction est utilise avec Info (page 261) pour redimensionner les images partir d'un systme de gestion de bases de donnes de manire les adapter aux champs. La largeur et la hauteur sont donnes en pixels.

Exemple:
Info Image_size(122,122)Select ID, Photo From infotable;

260

Retour Instructions de script et mots-cls (page 239).

Info
Si une information externe, telle qu'un fichier texte, une image ou une prsentation multimdia, doit tre Lier des informations des valeurs de champs (page 417) une valeur de champ, cette opration s'effectue dans une table charge l'aide du prfixe info. (Dans certains cas, il est prfrable de stocker les informations dans le fichier .qvw file, l'aide du prfixe Bundle (page 245) .) La table doit contenir uniquement deux colonnes, la premire avec les valeurs de champs qui donneront les cls vers l'information, la seconde contenant les noms des fichiers d'image ou autre type de contenu. La mme condition s'applique, par exemple, une image d'un systme de gestion de bases de donnes. Dans un champ binaire, un grand objet binaire, l'instruction info select lance implicitement bundle, c'est--dire que les donnes binaires sont recherches directement et stockes dans le fichier qvw. Les donnes binaires doivent tre le deuxime champ d'une instruction select. La syntaxe est la suivante:

info ( instructionload | instructionselect )

Exemples:
Info Load * from flagoecd.csv; Info Select * from infotable; Info Select Key, Picture From infotable;
Retour Instructions de script et mots-cls (page 239).

Inner
Les prfixes Join (page 265) et Keep (page 266) peuvent tre prcds du prfixe inner. Utilis avant join, il commande l'utilisation d'une jointure interne. La table obtenue contiendra ainsi uniquement des combinaisons de valeurs de champs tires des tables de donnes brutes avec un ensemble de donnes complet de chacune. Utilis avant keep, il indique que les tables de donnes brutes doivent tre rduites leur intersection commune avant d'tre stockes dans QlikView.

inner( join | keep) [ (nomdetable ) ](instructionload |instructionselect )

Exemples:
Table1 A 1 2 3 B aa cc ee

Table2 A C

261

1 4

xx yy

TableQV : select * from table1; inner join select * from table2;


TableQV A 1 B aa C xx

QVTab1 : select * from Table1; QVTab2 : inner keep select * from Table2;
QVTab1 A 1 QVTab2 A 1 C xx B aa

Les deux tables de l'exemple avec keep sont bien entendu associes par A. Retour Instructions de script et mots-cls (page 239).

Inputfield
Un champ peut tre dfini en tant que champ de saisie en l'indiquant dans une instruction inputfield avant qu'il ne soit rfrenc dans une instruction load ou select. Les champs de saisie se comportent lgrement diffremment des champs standard. La principale diffrence est qu'ils acceptent les modifications de valeurs de champ, de faon interactive ou par programme, sans avoir relancer le script. Les valeurs des champs doivent tre charges dans ceux-ci l'aide d'instructions load ou select. Chaque valeur charge dans le script cre un espace rserv pour une valeur de remplacement de la valeur du champ. Seules les valeurs de champ existantes peuvent tre modifies de faon interactive ou par programme. Dans les champs de saisie, toutes les valeurs des champs sont considres comme distinctes, mme si certaines valeurs sont gales. La syntaxe est la suivante:

inputfieldlistedechamps

262

listedechamps est une liste des champs marquer comme des champs de saisie spars par des virgules. Les caractres gnriques * et ? sont autoriss dans les noms des champs. Il peut tre ncessaire de mettre les noms des champs entre guillemets quand on utilise des caractres gnriques.

Exemples:
Inputfield B; Inputfield A,B; Inputfield B??x*;
Retour Instructions de script et mots-cls (page 239).

IntervalMatch
Le prfixe IntervalMatch pour une instruction Load (page 268) ou Select (SQL) (page 284) est utilis pour lier des valeurs numriques discrtes un ou plusieurs intervalles numriques. Il existe une application avance du prfixe IntervalMatch qui implique une syntaxe tendue, sur laquelle vous trouverez plus de renseignements IntervalMatch (syntaxe tendue) (page 264). La syntaxe gnrale est la suivante:

intervalmatch (champ)(instructionload | instructionselect )


champcorrespondant est le champ qui contient les valeurs numriques discontinues lier aux intervalles. instructionload ou instructionselect doit produire une table deux colonnes, dont le premier champ contient la limite infrieure et le second contient la limite suprieure de chaque intervalle. Les intervalles sont toujours ferms, c'est--dire que les points de fin sont inclus dans l'intervalle. Des limites non numriques font que l'intervalle est ignor (indfini) tandis que des limites nulles tendent l'intervalle indfiniment (illimit).
Avant l'instruction IntervalMatch, le champ contenant les points de donnes discontinus (Heure dans l'exemple ci-dessous) doit dj avoir t lu dans QlikView. L'instruction IntervalMatchne lit pas elle-mme ce champ dans la table de la base de donnes. Les intervalles peuvent se superposer et les valeurs discontinues seront alors lies tous les intervalles correspondants.

Exemple:
Considrez les deux tables ci-dessous. La premire donne les heures de dbut et de fin pour la production de diffrentes commandes. La deuxime dresse la liste d'un certain nombre d'vnements discontinus. Au moyen de la fonction IntervalMatch, nous lierons les deux tables afin de trouver par exemple quelles commandes ont subi des perturbations et quelles commandes ont t traites par quelles quipes.

JournalCommandes Dbut 01:00 02:30 03:04 07:23 Fin 03:35 07:58 10:27 11:43 Ordre A B C D

263

Journalvnements Time 00:00 01:18 02:23 04:15 08:00 11:43 vnement 0 1 2 3 4 5 Commentaire Dbut de l'quipe 1 Arrt de la ligne Redmarrage de la ligne 50% Vitesse de la ligne 100% Dbut de l'quipe 2 Fin de la production

Chargez tout d'abord les deux tables comme d'habitude, puis liez le champ Heure aux intervalles dfinis par les champs Dbut et Fin:

Select * from JournalCommandes; Select * from Journalvnements; IntervalMatch ( Heure ) select Dbut, Fin from JournalCommandes;
La zone table suivante peut maintenant tre cre dans QlikView:
Zone Table Time 00:00 vnement Commentaire Ordre Dbut Fin

0 1 2 3 3 4 4 5

Dbut de l'quipe 1 Arrt de la ligne Redmarrage de la ligne 50% Vitesse de la ligne 100% Vitesse de la ligne 100% Dbut de l'quipe 2 Dbut de l'quipe 2 Fin de la production

A A B C C D D

01:00 01:00 02:30 03:04 03:04 07:23 07:23

03:35 03:35 07:58 10:27 10:27 11:43 11:43

01:18 02:23 04:15 04:15 08:00 08:00 11:43

Retour Instructions de script et mots-cls (page 239).

IntervalMatch (syntaxe tendue)


Le prfixe IntervalMatch tendu pour une instruction Load (page 268) ou Select (SQL) (page 284) est utilis pour faire correspondre des donnes discrtes une ou plusieurs dimensions qui changent dans le

264

temps. C'est un outil puissant et souple qui peut tre utilis pour rsoudre les problmes rencontrs avec les dimensions changeant progressivement, en liant le(s) champ(s) cl(s) spcifique(s) aux intervalles numriques appropris. La syntaxe est la suivante:

intervalmatch (champcorrespondant,champcl1 [ , champcl2, ... champcl5 ] ) (instructionload | instructionselect )


champcorrespondant est le champ qui contient les valeurs numriques discontinues lier aux intervalles.
Les champcl(s) sont des champs contenant les attributs qui doivent correspondre l'intervalle.

instructionload ou instructionselect doit produire une table dont les deux premiers champs contiennent les limites infrieure et suprieure de chaque intervalle, tandis que le troisime champ et les suivants contiennent les champs cls indiqus dans l'instruction Intervalmatch. Les intervalles sont toujours ferms, c'est--dire que les points de fin sont inclus dans l'intervalle. Des limites non numriques font que l'intervalle est ignor (indfini) tandis que des limites nulles tendent l'intervalle indfiniment (illimit). Les intervalles peuvent se superposer et les valeurs seront alors lies par tous les intervalles correspondants.
Afin d'viter que des limites d'intervalles indfinies ne soit ignores, il faut autoriser les valeurs NULL se connecter d'autres champs qui constituent les limites infrieure et suprieure de l'intervalle. Vous pouvez grer cela avec l'instruction NullAsValue (page 277). Avant l'instruction IntervalMatch, le champ contenant les points de donnes discontinus (Date dans l'exemple ci-dessous) doit dj avoir t lu dans QlikView. L'instruction IntervalMatchne lit pas elle-mme ce champ dans la table de la base de donnes.

Exemple:
Inner Join IntervalMatch (Date,Cl) Load PremireDate, DernireDate, Cl resident Cl;
Retour Instructions de script et mots-cls (page 239).

Join
Le prfixe join joint la table charge une table existante et nomme ou la dernire logical table cre. La jointure est une natural join effectue sur tous les Champs (page 181) communs. L'instruction join peut tre prcde d'un des prfixes Inner (page 261), Outer (page 278), Left (page 266) ou Right (page 281).

join [ (nomdetable ) ]( instructionload | instructionselect)

Exemples:
Join Load * from abc.csv; Join Select * from table1; tab1: Load * from fichier1.csv; tab2 : Load * from fichier2.csv; .. .. .. join (tab1) load * from fichier3.csv;
Retour Instructions de script et mots-cls (page 239).

265

Keep
Le prfixe keep entre deux instructions Load (page 268) ou Select (SQL) (page 284) provoque la rduction d'une ou des deux tables avant qu'elles ne soient stockes dans QlikView, en fonction de l'intersection de leurs donnes. Le mot-cl keep doit toujours tre prcd d'un des prfixes Inner (page 261), Left (page 266) ou Right (page 281). La slection des enregistrements des tables se fait de la mme manire que pour la jointure correspondante. Cependant, les deux tables ne sont pas jointes et seront stockes dans QlikView comme deux tables spares.

Remarque: Le mot-cl explicite Join (page 265) dans le langage de script de QlikView procde une jointure complte des deux tables. Le rsultat en est une seule table. De telles jointures produisent bien souvent de trs grandes tables. L'une des principales caractristiques de QlikView est sa capacit effectuer des associations entre des tables au lieu de les joindre, ce qui rduit considrablement l'utilisation de la mmoire, augmente la vitesse de traitement et offre une grande souplesse. Les jointures explicites doivent donc en gnral tre vites dans les scripts QlikView. La fonction keep a t conue pour rduire le nombre de cas o des jointures explicites.
Retour Instructions de script et mots-cls (page 239).

Left
Les prfixes Join (page 265) et Keep (page 266) peuvent tre prcds du prfixe left. Utilis avant join, il commande l'utilisation d'une jointure gauche. La table obtenue contiendra ainsi uniquement des combinaisons de valeurs de champs tires des tables de donnes brutes avec un ensemble de donnes complet de la premire table. Utilis avant keep, il indique que la deuxime table de donnes brutes doit tre rduite son intersection commune avec la premire table, avant d'tre stocke dans QlikView.

left( join | keep) [ (nomdetable ) ](instructionload |instructionselect )

Exemples:
Table1 A 1 2 3 B aa cc ee

Table2 A 1 4 C xx yy

266

TableQV : select * from table1; left join select * from table2;


TableQV A 1 2 3 B aa cc ee C xx

QVTab1 : select * from Table1; QVTab2 : left keep select * from Table2;
QVTab1 A 1 2 3 B aa cc ee

QVTab2 A 1 C xx

Les deux tables de l'exemple avec keep sont bien entendu associes par A.

tab1: Load * from fichier1.csv; tab2 : Load * from fichier2.csv; .. .. .. left keep (tab1) load * from fichier3.csv;
Retour Instructions de script et mots-cls (page 239).

267

Let
L'instruction let a t cre pour complter l'instruction Set (page 286), utilise pour dfinir des Variables de script (page 296). Contrairement l'instruction set, elle value l'expression droite du signe = avant d'tre affecte la variable. Le mot let peut tre omis, mais l'instruction devient alors une instruction de contrle. Sans le mot-cl let, une telle instruction doit tenir sur une seule ligne de script et peut se terminer soit par un point-virgule, soit par une fin de ligne. La syntaxe est la suivante:

letnomdevariable=expression
Rappelons que le mot let peut tre omis.

Exemples:
Set x=3+4; Let y=3+4 z=$(y)+1; $(x) donnera ' 3+4 ' $(y) donnera ' 7 ' $(z) donnera ' 8 ' Let T=now( ); $(T) prendra la valeur de l'heure du moment.
Retour Instructions de script et mots-cls (page 239).

Load
L'instruction load charge des Champs (page 181) partir d'un fichier tap en ASCII, partir de donnes dfinies dans le script, d'une table d'entre dj charge, du rsultat d'une instruction select qui suit ou en gnrant des donnes automatiquement. La syntaxe gnrale de l'instruction load est la suivante:

load [ distinct] *listedechamps [( from fichier [ spc-format ] |


from_fieldchamp [spc-format] inline donnes [ spc-format ] | residenttiquette-table | autogenerate taille )]

[where critre ] | while critre ] [group_by listedechamps ] [order_by champ [ ordredetri ] { , champ [ ordredetri ] } ]
o:

distinct est un prdicat utilis pour charger uniquement le premier enregistrement en cas de doublons. *listedechamps ::= ( * | champ { , champ } ) Liste des champs charger. Utiliser * comme liste de champs signifie tous les champs de la table. champ ::= ( rfdechamp | expression ) [ as alias ]

268

La dfinition du champ doit toujours contenir une rfrence un champ existant, ou une expression.

rfdechamp ::= ( nomdechamp |@numrodechamp|@dbut:fin [ I | U | R| B ] ) nomdechamp est un texte identique au nom du champ dans la table. N'oubliez pas que le nom du champ doit tre not entre guillemets doubles droits s'il contient des espaces, par exemple. Parfois, les noms des champs ne sont pas explicitement disponibles. On utilise alors une notation diffrente:
@numrodechamp reprsente le numro du champ dans un fichier tables dlimit. Ce doit tre un entier positif prcd de l'arobase (@). La numrotation est toujours effectue de 1 au nombre total de champs. @dbut:fin reprsente les positions du dbut et de la fin d'un champ dans un fichier contenant des enregistrements de longueur fixe. Ces positions doivent tre toutes deux des entiers positifs. Les deux nombres doivent tre prcds d'une arobase (@) et spars par deux-points. La numrotation est toujours effectue de 1 au nombre total de positions. Si @dbut:fin est immdiatement suivi des caractres I ou U, les octets lus seront interprts comme un entier binaire sign (I) ou non sign (U) (ordre des octets d'Intel). Le nombre de positions lues doit tre gal 1, 2 ou 4. Si @dbut:fin est immdiatement suivi du caractre R, les octets lus seront interprts comme un nombre rel binaire (en virgule flottante de 32 bits ou 64 bits IEEE). Le nombre de positions lues doit tre gal 4 ou 8. Si @dbut:fin est immdiatement suivi du caractre B, les octets lus seront interprts comme des nombres BCD (Binary Coded Decimal) selon la norme COMP-3. On peut indiquer n'importe quel nombre d'octets.

expression peut tre une fonction numrique ou une fonction de chane base sur un ou plusieurs autres champs de la mme table. Pour plus d'informations, voir la syntaxe des Expressions de script (page 307). as est utilis pour donner un nouveau nom au champ. from est utilis si les donnes doivent tre charges partir d'un fichier, et non tapes dans le script. fichier ::= [ chemin ] nomdufichier Le chemin est soit le chemin absolu, soit le chemin relatif par rapport au document QlikView (fichier .qvw). S'il est omis, QlikView chercher le fichier dans le rpertoire indiqu par l'instruction directory. S'il n'y a pas d'instruction directory, QlikView cherche dans le rpertoire de travail, qui est gnralement le rpertoire dans lequel se trouve le fichier QlikView. Le chemin peut aussi tre une adresse URL (HTTP ou FTP), renvoyant une page sur Internet ou sur un intranet.
Le nomdufichier peut contenir les caractres gnriques DOS standard (* et ? ). Tous les fichiers correspondants seront alors chargs dans le rpertoire indiqu.

spc-format ::= ( lment-spcf { , lment-spcf } )


La spcification du format consiste en une liste de plusieurs lments de spcification du format (page 272), mis entre parenthses.

from_field est utilis si les donnes doivent tre charges partir d'un champ prcdemment charg. champ::= (nomdetable, nomdechamp)
Le champ correspond au nomdetable et nomdechamp prcdemment chargs.

spc-format ::= ( lment-spcf {, lment-spcf } )


La spcification du format consiste en une liste de plusieurs lments de spcification du format (page 272), mis entre parenthses.

inline est utilis si les donnes doivent tre tapes dans le script, et non charges partir d'un fichier. Utilisez l' Assistant Donnes intgres (page 207) pour vous aider crer les instructions load inline. donnes ::= [ texte ]
Les donnes saisies par une clause inline doivent tre indiques entre Guillemets (page 305) ou entre crcohets. Le texte entre ces guillemets ou crochets est interprt de la mme manire que le contenu d'un fichier. C'est pourquoi vous devez aussi insrer une nouvelle ligne dans la clause inline l o vous en auriez insr une dans un fichier texte; pour ce faire, appuyez sur la touche ENTRE lors de la saisie du script.

spc-format ::= ( lment-spcf {, lment-spcf } )

269

La spcification du format consiste en une liste de plusieurs lments de spcification du format (page 272), mis entre parenthses.

resident est utilis quand des donnes doivent tre charges partir d'une table dj charge.
L'tiquette-table est une tiquette prcdant l'instruction load ou select ayant cr la table de dpart. Elle doit tre saisie sans deux-points la fin.

autogenerate est utilis quand les donnes doivent tre automatiquement gnres par QlikView. taille ::= nombre Nombre est un entier indiquant le nombre d'enregistrements gnrer. La liste des champs ne doit pas contenir d'expressions qui requirent des donnes provenant d'une base de donnes. Ne sont admises dans les expressions que des constantes et des fonctions sans paramtres. where est une clause utilise pour indiquer si un enregistrement doit tre inclus ou non la slection. La slection est incluse si le critre est vrai. while est une clause utilise pour indiquer si un enregistrement doit tre lu plusieurs fois. Le mme enregistrement est lu tant que le critre est vrai. Pour tre utile, une clause while doit en gnral inclure la fonction IterNo( ). critre est une expression logique. nomdechamp, chemin, nomdufichier et alias sont des chanes textuelles reprsentant ce que ces noms dsignent. group by est une clause utilise pour dterminer par quels champs les donnes doivent tre agrges (groupes). Les champs d'agrgation doivent tre inclus d'une manire ou d'une autre dans les expressions charges. Aucun autre champ que les champs d'agrgation ne peut tre utilis en dehors des fonctions d'agrgation dans les expressions charges. listedechamps ::= ( champ { ,champ } ) order by est une clause utilise pour trier les enregistrements d'une table rsidente avant qu'ils ne soient traits par l'instruction load. La table rsidente peut tre trie par un ou plusieurs champs, en ordre ascendant ou descendant. Le tri se fait d'abord par valeur numrique, puis par valeur ASCII nationale. Cette clause ne peut tre utilise que quand la source de donnes est une table rsidente. champ indique par quel champ la table rsidente est trie. Le champ peut tre spcifi par son nom ou par son numro dans la table rsidente (le premier champ est le numro 1). ordredetri est soit asc pour ascendant, soit desc pour descendant. Si aucun ordredetri n'est spcifi, c'est asc qui est utilis. Remarque: Si aucune source de donnes n'est fournie par les clauses from, inline, resident ou autogenerate, les donnes seront charges partir du rsultat de l'instruction Select (SQL) (page 284) ou load qui vient tout de suite aprs. L'instruction qui suit ne doit pas avoir de prfixe.

Exemples:
Diffrents formats de fichiers

Load * from donnes1.csv; Load * from 'c:\userfiles\donnes1.csv' (ansi, txt, delimiter is ',', embedded labels); Load * from 'c:\userfiles\donnes2.csv' (ansi, txt, delimiter is '\t', embedded labels); Load * from fichier2.dif (ansi, dif, embedded labels); Load @1:2 as ID, @3:25 as Nom, @57:80 as Ville from donnes4.fix (ansi, fix, no labels, header is 0, record is 80); Load * from C:\qdssamples\xyz.qvx (qvx); Slectionner certains champs, calculer des champs

270

Load Prnom, Nom, Numro from donnes1.csv; Load @1as A, @2 as B from donnes3.txt' (ansi, txt, delimiter is '\t', no labels); Load Prnom&' '&Nom as Nom from donnes1.csv; Load Quantit, Prix, Quantit*Prix as Montant from donnes1.csv; Slectionner certains enregistrements Load distinct Prnom, Nom, Numro from donnes1.csv; Load * from Consommation.csv where Litres>0; Charger des donnes qui ne sont pas dans un fichier Load * Inline [IDCat, Catgorie 0,Rgulier 1,Occasionnel 2,Permanent]; Load * Inline [UserID, Password, Access A, ABC456, User B, VIP789, Admin]; Load RecNo( ) as A, rand( ) as B autogenerate(10000);(Remarque: La parenthse est autorise aprs autogenerate, mais elle n'est pas obligatoire.) Charger des donnes partir d'une table dj charge tab1: Select A,B,C,D from tabletrans; Load A,B,month(C),A*B+D as E resident tab1; Load A,A+B+C resident tab1 where A>B; Load A,B*C as E resident tab1 order by A; Load A,B*C as E resident tab1 order by 1,2; Load A,B*C as E resident tab1 order by C desc, B asc, 1 desc; Charger des donnes partir de champs dj chargs Load A from_field (caractres, types); Charger des donnes partir de la table suivante Load A, B, if(C>0,'positive','negative') as X, weekday(D) as Y; Select A,B,C,D from Table1; Grouper des donnes Load NoArt, round(Sum(MontantTrans),0.05) as NoArtTotal from table.csv group by NoArt;

271

Load Semaine, NoArt, round(Avg(MontantTrans),0.05) as MoyennesNoArtSemaine from table.csv group by Semaine, NoArt; Lire un enregistrement plusieurs fois Ma table: Load tudiant, mid(Diplmes,IterNo( ),1) as Diplme, pick(IterNo( ), 'Maths', 'Anglais', 'Sciences', 'Histoire') as Matire from Tab1.csv while mid(Diplmes,IterNo( ),1)<>' ';
Retour Instructions de script et mots-cls (page 239).

lments de spcification du format


Chaque lment de spcification du format dfinit une certaine proprit du fichier de tables:

fspec-item ::= [ ansi | oem | mac | UTF-8 | Unicode | txt | fix | dif | biff | html | xml | qvd |delimiter ischar | no eof | embedded labels | explicit labels | no labels | table is [ nomdetable ] | header isn | header isline | header isn lines | comment isstring | record is n | record isline | record isn lines | no quotes |msq | filters (spcificateurs de filtres ) ]
On peut dfinir les proprits suivantes:

Jeu de caractres Format de table Dlimiteur No eof tiquettes Taille de l'en-tte

page 423 page 273 page 273 page 273 page 274 page 274

Longueur de l'enregistrement page 274 Guillemets page 274

Jeu de caractres
Les jeux de caractres disponibles sont:

ansi oem mac UTF-8 Unicode


Le fichier peut tre crit l'aide des jeux de caractres ansi (Windows), oem (DOS, OS/2 et autres), Unicode, UTF-8 ou mac. La conversion du jeu de caractres oem n'est pas implmente pour MacOS. Sauf indication contraire, c'est le jeu de caractres ansi qui est utilis sous Windows.

272

Exemple:
load * from a.txt (CodePage is 10000, txt, delimiter is ',' , no labels)
Retour Instructions de script et mots-cls (page 239).

Format de table
txt Dans un fichier texte dlimit, .txt, les colonnes de la table sont spares par un caractre. Dans un fichier longueur d'enregistrement fixe, .fix, toutes les colonnes ont une largeur d'un certain nombre de caractres. Dans un fichier .dif (Data Interchange Format), un format spcial est utilis pour dfinir la table. QlikView peut aussi interprter des donnes de fichiers Excel standard au moyen du format biff (Binary Interchange File Format).

fix

dif

biff

html qvd Le format qvd est le format du Fichiers QVD (page 425) propritaire, export d'un document QlikView.

qvx

qvx est un format de fichier/flux pour une sortie ultra-performante vers QlikView.

Si rien n'est spcifi, c'est le format .txt qui est utilis. Retour Instructions de script et mots-cls (page 239).

Dlimiteur
Cette commande n'est pertinente que pour des fichiers .txt dlimits.

delimiter ischar
Pour les fichiers de tables dlimits, un dlimiteur arbitraire peut tre indiqu l'aide de la commande delimiter is. caractre spcifie un caractre simple. Il existe des cas particuliers: \t reprsentant un signe de tabulation, avec ou sans guillemets. \\ reprsentant une barre oblique inverse ( \ ). le mot spaces reprsentant toutes les combinaisons d'un ou plusieurs espaces. Les caractres non imprimables avec une valeur ASCII infrieure 32, l'exception de CR et LF, seront interprts comme des espaces. Si rien n'est spcifi, la fonction utilise delimiter is ','. Retour Instructions de script et mots-cls (page 239).

No eof
Cette commande n'est pertinente que pour des fichiers .txt dlimits.

273

no eof
Si cette option est utilise, le caractre ASCII 26, qui indique souvent une fin de fichier, est ignor. Retour Instructions de script et mots-cls (page 239).

tiquettes
tiquettes (nom de champ)

embedded labels explicit labels no labels


Les noms des champs peuvent se trouver diffrents endroits du fichier. Si le premier enregistrement contient les noms des champs, il faut utiliser embedded labels. S'il n'y a pas de noms de champs, on utilise no labels. Dans les fichiers dif, on utilise parfois une section d'en-tte spare avec des noms de champs explicites. Il faut alors utiliser explicit labels. Si rien n'est spcifi, c'est embedded labels qui est utilis, y compris pour les fichiers dif. Retour Instructions de script et mots-cls (page 239).

Taille de l'en-tte
La syntaxe est la suivante:

header isn
header is line

header isnlines
On peut spcifier une longueur d'en-tte arbitraire grce la commande header is. Un en-tte est une section de texte non utilise par QlikView. La longueur de l'en-tte peut tre indique en octets (header is n) ou en lignes (header is line ou header is n lines). n doit tre un nombre entier positif reprsentant la longueur de l'en-tte. Si elle n'est pas spcifie, c'est header is 0 qui est utilis. La commande header is s'applique uniquement un fichier de tables. Retour Instructions de script et mots-cls (page 239).

Longueur de l'enregistrement
Fichiers enregistrements fixes uniquement.

record isn
record is line

record isnlines
Pour les fichiers longueur d'enregistrement fixe, cette longueur doit tre prcise par la commande record is. La longueur des enregistrements peut tre donne en octets (record isn) ou en lignes (record is line ou record isnlines), n tant ici un entier positif reprsentant la longueur de l'enregistrement. La commande record is n'est pertinente que pour les fichiers fix. Retour Instructions de script et mots-cls (page 239).

Guillemets
Fichiers texte uniquement.

274

no quotes
Si les Guillemets (page 305) ne doivent pas tre accepts dans un fichier texte, vous devez utiliser la commande no quotes. Par dfaut, les guillemets " " ou ' ' peuvent tre utiliss, mais uniquement s'ils sont le premier et le dernier caractre non vide d'une valeur de champ. La commande no quotes n'est pertinente que pour les fichiers txt.

msq
msq indique que c'est le style de guillemets moderne qui est utilis.
Retour Instructions de script et mots-cls (page 239).

XML (fichiers xml uniquement)


xmlsax xmlsimple pattern ischemin
Xmlsax et xmlsimple s'excluent mutuellement. Seul un des deux peut tre spcifi lors de l'utilisation de xml. Lors de l'utilisation du motif, le fichier est lu depuis le dbut de la balise spcifie la fin de celle-ci. Si le chemin contient des espaces, il doit tre plac entre guillemets. Remarque: Pour utiliser xmlsax, l'analyseur XML de Microsoft, MSXML 3.0 ou une version ultrieure, doit tre install sur l'ordinateur. MSXML est livr par exemple avec Windows XP et MS Internet Explorer 6. Il peut aussi tre tlcharg partir de la page d'accueil de Microsoft.
Retour Instructions de script et mots-cls (page 239).

Loosen Table
Vous pouvez dclarer explicitement une ou plusieurs tables d'entre QlikView dconnectes (voir chapitre Logique et slections (page 113) pour plus de dtails sur les tables dconnectes) pendant l'excution du script en utilisant une instruction loosen table. Avec l'utilisation d'une ou plusieurs instructions Loosen Table dans le script, QlikView ignorera toute dconnexion de tables effectue avant l'excution du script. La syntaxe est la suivante:

Loosen Table[s] nomdetable [ , nomdetable2 ...]


On peut utiliser soit Loosen Table et Loosen Tables peuvent tre utilises.

Exemple:
Tab1: Select * from Trans; Loosen table Tab1;

Remarque: Si QlikView trouve dans la structure des donnes des rfrences circulaires qui ne peuvent pas tre rsolues par des tables dclares dconnectes de faon interactive ou explicite dans le script, une ou plusieurs tables

275

supplmentaires seront dconnectes de force jusqu' ce qu'il ne reste plus de rfrences circulaires. Lorsque ce cas se produit, la bote de dialogue Avertissement de boucle met un avertissement.

Retour Instructions de script et mots-cls (page 239).

Mapping
Le prfixe mapping ajout une instruction Load (page 268) ou Select (SQL) (page 284) est utilis pour mapper une certaine valeur de champ ou expression aux valeurs de la premire colonne d'une table de mappage. Une table de mappage se compose de deux colonnes, la premire contenant les valeurs de comparaison et la seconde contenant les valeurs de mappage voulues. Les tables de mappage seront stockes temporairement dans la mmoire et supprimes automatiquement aprs l'excution du script. La syntaxe est la suivante:

mapping( instructionload |instructionselect )

Exemples:
mapping load * from x.csv mapping select a, b from map1 map1: mapping load * inline [ x,y US,USA U.S.,USA America,USA ];
Retour Instructions de script et mots-cls (page 239).

Map ... using


L'instruction map ... using est utilise pour mapper une certaine valeur de champ ou expression aux valeurs d'une table de mappage donne. La table de mappage est cre par l'instruction Mapping (page 276). La syntaxe est la suivante:

map *listedechamps usingnomdemappage


*listedechamps est le nom d'un champ qui doit tre mapp partir de cet endroit du script. Utiliser * comme liste de champs signifie tous les champs. Les caractres gnriques * et ? sont autoriss dans les noms des champs. Il peut tre ncessaire de mettre les noms des champs entre guillemets quand on utilise des caractres gnriques. nomdemappage correspond au nom d'une table de mappage dj lue dans une instruction mapping load ou mapping select (voir Mapping (page 276)).

Exemples:
map Pays using Pmap; map A, B, C using X; map * using MapGn; Active le mappage du champ Pays en utilisant la table Pmap. Active le mappage des champs A, B et C en utilisant la table X. Active le mappage de tous les champs en utilisant la table MapGn.

Le mappage automatique est effectu en dernier dans la chane des vnements qui mnent au stockage du champ dans la table interne de QlikView. Cela signifie que le mappage n'est pas effectu chaque fois qu'un

276

nom de champ est rencontr dans une expression, mais plutt quand la valeur est stocke sous ce nom de champ dans la table interne. Si le mappage au niveau de l'expression est requis, la fonction apply map doit tre utilise la place. Retour Instructions de script et mots-cls (page 239).

NoConcatenate
Le prfixe NoConcatenate force le traitement de deux tables comme des tables internes spares, bien qu'elles aient des ensembles de champs identiques (en d'autres termes, elles seraient normalement concatenated automatiquement). La syntaxe est la suivante:

noconcatenate( instructionload | instructionselect )

Exemple:
Load A,B from fichier1.csv; noconcatenate load A,B from fichier2.csv;
Retour Instructions de script et mots-cls (page 239).

NullAsValue
Par dfaut, QlikView considre que les valeurs NULL sont des entits manquantes ou non dfinies. Cependant, certains contextes de bases de donnes impliquent que les valeurs NULL soient considres comme des valeurs spciales plutt que comme des valeurs simplement manquantes. On peut ainsi suspendre l'interdiction faite aux valeursNULL d'tre lies d'autres valeursNULL grce l'instruction NullAsValue. Les valeursNULL des champs spcifis sont considres inconnues plutt que non dfinies quand l'instruction NullAsValue est employe. On pourrait considrer que cette instructionremplace la variable NullDisplay (page 299) au niveau du champ. L'instruction NullAsValue fonctionne comme un commutateur. Vous pouvez la dsactiver nouveau au moyen de l'instruction NullAsNull (page 278). La syntaxe est la suivante:

NullAsValue*listedechamps
*listedechamps est une liste de champs spars par des virgules et pour lesquels NullAsValue doit tre activ. Utiliser * comme liste de champs signifie tous les champs. Les caractres gnriques * et ? sont autoriss dans les noms des champs. Il peut tre ncessaire de mettre les noms des champs entre guillemets quand on utilise des caractres gnriques.

Exemple:
NullAsValue A,B; Load A,B from x.csv;
Veuillez prendre note des points suivants concernant l'utilisation de l'instruction NullAsValue:
l l

La liaison de valeurs NULL est toujours dsactive par dfaut au dbut de l'excution du script. La liaison des valeursNULL d'un champ donn peut tre active tout moment par une instruction NullAsValue.

Retour Instructions de script et mots-cls (page 239).

277

NullAsNull
L'instruction NullAsNull dsactive la liaison des valeurs NULL dj dfinie par une instruction NullAsValue (page 277) (suivez ce lien pour plus d'informations). La syntaxe est la suivante:

NullAsNull*listedechamps
*listedechamps est une liste de champs spars par des virgules et pour lesquels NullAsNull doit tre activ. Utiliser * comme liste de champs signifie tous les champs. Les caractres gnriques * et ? sont autoriss dans les noms des champs. Il peut tre ncessaire de mettre les noms des champs entre guillemets quand on utilise des caractres gnriques.

Exemples:
NullAsNull A,B; Load A,B from x.csv;
Retour Instructions de script et mots-cls (page 239).

Outer
Le prfixe explicite Join (page 265) peut tre prcd du prfixe outer pour spcifier une jointure externe. Dans une jointure externe, toutes les combinaisons entre les deux tables sont gnres. Le mot-cl outer est facultatif.

outer join [ (nomdetable ) ](instructionload |instructionselect )

Exemple:
Table1 A 1 2 3 B aa cc ee

Table2 A 1 4 C xx yy

select * from table1; join select * from table2;


OU

select * from table1; outer join select * from table2;

278

Table jointe A 1 2 3 4 B aa cc ee C xx yy

Retour Instructions de script et mots-cls (page 239).

Qualify
La jointure automatique entre des champs portant le mme nom dans des tables diffrentes peut tre suspendue au moyen de l'instruction qualify qui qualifie le nom du champ par son nom de table. Les champs ainsi qualifis seront renomms lorsque le script les trouvera dans une table. Le nouveau nom suivra le modle nomdetable.nomdechamp. Nomdetable correspond l'tiquette de la table active ou, si aucune tiquette n'existe, au nom apparaissant aprs from dans les instructions load et select. La qualification est toujours dsactive par dfaut au dbut de l'excution du script. La qualification d'un nom de champ peut tre active tout moment l'aide de l'instruction qualify. Elle peut aussi tre dsactive tout moment l'aide de l'instruction Unqualify (page 294). La syntaxe est la suivante:

qualify*listedechamps
*listedechamps est une liste des champs spars par des virgules et pour lesquels la qualification doit tre active. Utiliser * comme liste de champs signifie tous les champs. Les caractres gnriques * et ? sont autoriss dans les noms des champs. Il peut tre ncessaire de mettre les noms des champs entre guillemets quand on utilise des caractres gnriques. Remarque L'instruction qualify ne doit pas tre utilise avec un rechargement partiel.

Exemples:
Qualify B; Load A,B from x.csv; Load A,B from y.csv;
Les deux tables x.csv et y.csv sont jointes uniquement par A. Trois champs en rsulteront: A, x.B, y.B. Dans une base de donnes que vous ne connaissez pas, commencez par vous assurer que seuls un ou quelques champs sont associs, comme l'illustre cet exemple:

qualify *; unqualify TransID; select * from tab1; select * from tab2; select * from tab3;
Seul le champ TransID est utilis pour les associations entre les tables tab1, tab2 et tab3.

279

Retour Instructions de script et mots-cls (page 239).

Rem
L'instruction rem est utilise pour insrer des remarques dans le script, ou pour dsactiver temporairement des instructions du script sans les supprimer. Tout ce qui se trouve entre rem et le point-virgule (;) est considr comme un commentaire. La syntaxe est la suivante:

remchane
o:

chane est un texte arbitraire.

Exemple:
Rem ** Ceci est un commentaire **;

Astuce:
Il existe deux mthodes pour faire des commentaires dans le script: 1. Vous pouvez crer un commentaire n'importe o dans le script (except entre deux guillemets) en plaant la section en
question entre /* et */.

2. Quand vous tapez // dans le script, tout le texte qui se trouve droite sur la mme ligne devient un commentaire. (Vous
remarquerez l'exception //: utilisable comme partie d'une adresse Internet.)

Retour Instructions de script et mots-cls (page 239).

Rename Field
Renomme un ou plusieurs champ(s) QlikView existant(s). La syntaxe est la suivante:

rename field [s] (usingnomdemappage | anciennomtonouveaunom{ , anciennomtonouveaunom })


o:

nomdemappage est le nom d'une table de mappage dj charge qui contient une ou plusieurs paires d'anciens et de nouveaux noms de champs anciennom est l'ancien nom du champ et nouveaunom est son nouveau nom.
On peut utiliser soit rename field, soit rename fields.

Exemples:
Rename field XAZ0007 to Ventes; MappageChamps: Mapping select anciensnoms, nouveauxnoms from dictionnairedonnes; Rename fields using MappageChamps;
Retour Instructions de script et mots-cls (page 239).

280

Rename Table
Renomme une ou plusieurs tables internes QlikView existantes. La syntaxe est la suivante:

rename table[s] (usingnomdemappage | anciennom tonouveaunom{ , anciennomtonouveaunom })


o:

nomdemappage est le nom d'une table de mappage dj charge qui contient une ou plusieurs paires d'anciens et de nouveaux noms de tables. anciennom est l'ancien nom de la table et nouveaunom est son nouveau nom.
On peut utiliser soit On peut utiliser soit rename table, soit rename tables.

Exemples:
Tab1: Select * from Trans; Rename table Tab1 to Xyz; MappageTables: Mapping load anciensnoms, nouveauxnoms from nomstables.csv; Rename tables using MappageTables;
Retour Instructions de script et mots-cls (page 239).

Right
Les prfixes Join (page 265) et Keep (page 266) peuvent tre prcds du prfixe right. Utilis avant join, il commande l'utilisation d'une jointure droite. La table obtenue contiendra ainsi uniquement des combinaisons de valeurs de champs tires des tables de donnes brutes avec un ensemble de donnes complet de la deuxime table. Utilis avant keep, il indique que la premire table de donnes brutes doit tre rduite son intersection commune avec la deuxime table, avant d'tre stocke dans QlikView.

right(join | keep)[(nomdetable )](instructionload |instructionselect )

Exemples:
Table1 A 1 2 3 B aa cc ee

281

Table2 A 1 4 C xx yy

TableQV : select * from table1; right join select * from table2;


TableQV A 1 4 B aa C xx yy

QVTab1 : select * from Table1; QVTab2 : right keep select * from Table2;
QVTab1 A 1 B aa

QVTab2 A 1 4 C xx yy

Les deux tables de l'exemple avec keep sont bien entendu associes par A.

tab1: Load * from fichier1.csv; tab2 : Load * from fichier2.csv; .. .. .. right keep (tab1) load * from fichier3.csv;

282

Retour Instructions de script et mots-cls (page 239).

Replace
Il est possible d'ajouter le prfixe replace n'importe quelle instruction Load (page 268), Select (SQL) (page 284) ou Map ... using (page 276) dans le script. L'instruction replace load/replace select a pour effet de supprimer la table QlikView entire, pour laquelle un nom de table est gnr par l'instruction replace load/replace select, et la remplace par une nouvelle table contenant le rsultat de l'instruction replace load/replace select. L'effet est le mme pendant un partial reload que pendant un rechargement complet. L'instruction replace map...using permet d'effectuer aussi le mappage pendant une excution de script partielle. La syntaxe est la suivante:

replace[only](loadstatement |selectstatement |map...usingstatement)


o:

only est un qualificatif facultatif indiquant que l'instruction doit tre ignore pendant les rechargements (non partiels) normaux.

Exemples:
Tab1: Replace load * from Fichier1.csv;
Pendant les rechargements normaux et partiels, la table QlikView Tab1 est d'abord supprime. De nouvelles donnes sont ensuite charges de Fichier1.csv et stockes dans Tab1.

Tab1: Replace only load * from Fichier1.csv;


Pendant un rechargement normal, cette instruction est ignore. Pendant un rechargement partiel, toute table QlikView nomme Tab1 est d'abord supprime. De nouvelles donnes sont ensuite charges de Fichier1.csv et stockes dans Tab1.

Tab1: Load a,b,c from Fichier1.csv; Replace load a,b,c from Fichier2.csv;
Pendant un rechargement normal, le fichier Fichier1.csv est d'abord lu dans la table QlikView Tab1, mais est ensuite immdiatement supprim et remplac par les nouvelles donnes charges partir de Fichier2.csv. Toutes les donnes de Fichier1.csv sont perdues. Pendant un rechargement partiel, la table QlikView Tab1 est d'abord entirement supprime. Elle est ensuite remplace par les nouvelles donnes charges partir de Fichier2.csv.

Tab1: Load a,b,c from Fichier1.csv; Replace only load a,b,c from Fichier2.csv;
Pendant un rechargement normal, les donnes sont charges partir du fichier Fichier1.csv et stockes dans la table QlikView Tab1. Fichier2.csv est ignor. Pendant un rechargement partiel, la table QlikView Tab1 est d'abord entirement supprime. Elle est ensuite remplace par les nouvelles donnes charges partir de Fichier2.csv. Toutes les donnes de Fichier1.csv sont perdues.

283

Retour Instructions de script et mots-cls (page 239).

Sample
Le prfixe sample associ une instruction Load (page 268) ou Select (SQL) (page 284) sert charger un chantillon d'enregistrements pris au hasard partir de la source de donnes. La syntaxe est la suivante:

samplep ( instructionload | instructionselect )


o:

p est une expression arbitraire dont la valeur est suprieure 0 et infrieure ou gale 1. Ce nombre indique la probabilit qu'un enregistrement donn soit lu.

Exemples:
Sample 0.15 Select * from Longuetable; Sample(0.15) Load * from Longuetab.csv; (Remarque: la parenthse est autorise mais non requise.)
Retour Instructions de script et mots-cls (page 239).

Section
Avec l'instruction section, il est possible de dterminer si les instructions Load (page 268) et Select (SQL) (page 284) qui suivent doivent tre considres comme des donnes ou comme une dfinition des droits d'accs. La syntaxe est la suivante:

section(access | application)

Exemples:
Section access; Section application;
Si rien n'est spcifi, le programme utilise section application. La dfinition de section est valable jusqu' ce qu'une nouvelle instruction section soit crite. Retour Instructions de script et mots-cls (page 239).

Select (SQL)
La slection de Champs (page 181) provant d'une source de donnes ODBC est ralise au moyen d'instructions SQL SELECT standard. Cependant, l'acceptation des instructions SELECT dpend largement du pilote ODBC utilis. Voici une brve description de la syntaxe:

select[all | distinct | *listedechamps from listedetables [o critre ] [group by listedechamps [order by listedechamps [ (inner | left | right rfdechamp ]

distinctrow | top n [percent] ]

[having critre ] ] [asc | desc] ] | full)join nom de table on rfdechamp =

284

distinct est un prdicat utilis si les combinaisons de valeurs en double dans les champs slectionns ne doivent tre comptes qu'une seule fois. distinctrow est un prdicat utilis si les enregistrements en double dans la table source ne doivent tre compts qu'une seule fois. *listedechamps ::= ( *| champ ) { , champ } Liste des champs slectionner. Utiliser * comme liste de champs signifie tous les champs de la table. listedechamps ::= champ { ,champ } Liste d'un ou plusieurs champs, spars par des virgules. champ ::= ( rfdechamp | expression ) [ as alias ] L'expression peut par exemple tre une fonction numrique ou une fonction de chane base sur un ou plusieurs autres champs. Certains des oprateurs et des fonctions gnralement accepts sont: +, -, *, /, & (concatnation de chane), sum(nomdechamp), count(nomdechamp), avg(nomdechamp) (moyenne), month(nomdechamp), etc. Consultez la documentation du pilote ODBC pour plus d'informations. rfdechamp ::= [ nomdetable .] nomdechamp Le nomdetable et le nomdechamp sont des chanes textuelles identiques ce qu'elles reprsentent. Elles doivent tre notes entre guillemets doubles droits si elles contiennent des espaces, par exemple.
La clause as est utilise pour donner un nouveau nom au champ.

listedetables ::= table { ,table } Liste des tables o les champs doivent tre slectionns. table ::= nomdetable [ [ as] alias ]
Le nomdetable peut tre entre guillemets ou non.

where est une clause utilise pour indiquer si un enregistrement doit tre inclus ou non la slection. critre est une expression logique qui peut parfois tre trs complexe. Voici quelques oprateurs accepts: oprateurs et fonctions numriques = , <> or #(not equal), > , >= , < , <= , and, or, not, exists, some, all, in ainsi que les nouvelles instructions SELECT. Consultez la documentation du pilote ODBC pour plus d'informations. group by est une clause utilise pour agrger (grouper) plusieurs enregistrements en un seul. Dans un groupe, pour un champ donn, soit tous les enregistrements ont la mme valeur, soit le champ ne peut tre utilis que dans une expression, comme par exemple une somme ou une moyenne. L'expression base sur un ou plusieurs champs est dfinie dans l'expression du symbole de champ. having est une clause utilise pour qualifier des groupes comme la clause where sert qualifier des enregistrements. order by est une clause utilise pour spcifier l'ordre de tri de la table obtenue par l'instruction SELECT. join est un qualificatif indiquant que plusieurs tables doivent tre jointes en une seule. Les noms de champs et de tables doivent tre mis entre guillemets s'ils contiennent des espaces vides ou des lettres de jeux de caractres nationaux. Quand le script est gnr automatiquement par QlikView, le guillemet utilis est celui que prfre le pilote ODBC spcifi dans la dfinition de la source de donnes de l'instruction Connexion (page 249).
En outre, plusieurs instructions SELECT peuvent parfois tre concatnes en une l'aide d'un oprateur union:

selectstatementunionselectstatement
L'instruction SELECT est interprte par le pilote ODBC; il peut donc se produire des carts par rapport la syntaxe SQL gnrale, selon les possibilits des pilotes ODBC, par exemple:

as n'est pas toujours autoris, c'est--dire que l'alias doit suivre immdiatement le nomdechamp. as est parfois obligatoire si un alias est utilis.

285

distinct, as, where, group by, order by ou union ne sont pas toujours pris en charge. Le pilote ODBC n'accepte pas toujours tous les types de guillemets. Remarque Ceci n'est pas une description complte de l'instruction SQL SELECT! Les instructions SELECT peuvent par exemple tre imbriques, on peut faire plusieurs jointures dans une instruction SELECT, le nombre de fonctions autorises dans les expressions est parfois trs grand, etc.

Exemples:
SELECT * FROM `Catgories`; SELECT `N de catgorie`, `Nom de catgorie` FROM `Catgories`; SELECT `N de commande`, `N de produit`, `Prix unitaire` * Quantit * (1-Remise) as VentesNettes FROM `Dtails des commandes`; SELECT `Dtails des commandes`.`N de commande`, Sum(`Dtails des commandes`.`Prix unitaire` * `Dtails des commandes`.Quantit) as `Rsultat` FROM `Dtails des commandes`, Commandes where Commandes.`N de commande` = `Dtails des commandes`.`N de commande` group by `Dtails des commandes`.`N de commande`;
Retour Instructions de script et mots-cls (page 239).

Smantiques
Des tables contenant des relations entre des objets peuvent tre charges l'aide d'un prfixe semantic. La syntaxe est la suivante:

semantic( instructionload | instructionselect)

Exemples:
Semantic Load * from abc.csv; Semantic Select Objet1, Relation, Objet2, RelationInverse from table1;
Les tables charges par une instruction semantic ne peuvent pas tre concatenated. Retour Instructions de script et mots-cls (page 239).

Set
L'instruction set est utilise pour dfinir des Variables de script (page 296). Ces variables peuvent tre utilises pour remplacer des chanes, des chemins, des lecteurs, etc. La syntaxe est la suivante:

setnomdevariable =chane

Exemples:

286

Set FichierUtiliser=Donnes1.csv; Set Constante="Ma chane"; Set ExerciceComptable=1997;


Retour Instructions de script et mots-cls (page 239).

Sleep
L'instruction sleep interrompt l'excution du script pendant nmillisecondes, n tant un entier positif infrieur 3600000 (c'est--dire 1heure). La valeur peut tre une expression. La syntaxe est la suivante:

sleepn

Exemples:
sleep 10000; sleep t*1000;
Retour Instructions de script et mots-cls (page 239).

SQL
L'instruction SQL vous permet d'envoyer une commande SQL arbitraire via une connexion ODBC. Saisissez simplement :

SQL
suivi de la commande.

Exemple:
SQL leave;
Envoyer des instructions SQL qui mettent jour la base de donnes renverra une erreur, car QlikView accde par dfinition toutes les sources ODBC en lecture seule. La syntaxe:

SQL select * from tab1;


est autorise et sera, par souci de cohrence, la syntaxe privilgie pour Select (SQL) (page 284) dans les manuels venir. Le prfixe SQL restera cependant facultatif pour les instructions select. Retour Instructions de script et mots-cls (page 239).

SQLColumns
L'instruction sqlcolumns renvoie un ensemble de champs qui dcrivent les colonnes d'une source de donnes ODBC laquelle une instruction connect a t adresse. Ces champs peuvent tre combins avec des champs gnrs par les commandes SQLTables (page 288) et SQLTypes (page 288) afin de donner un bon aperu d'une base de donnes particulire. Les douze champs standard sont: TABLE_QUALIFIER TABLE_OWNER TABLE_NAME COLUMN_NAME DATA_TYPE

287

TYPE_NAME PRECISION LENGTH SCALE RADIX NULLABLE REMARKS Pour une description dtaille de ces champs, consultez un manuel ODBC. La syntaxe est la suivante:

sqlcolumns

Exemple:
connect to 'MS Access 7.0 Database; DBQ=C:\Course3\DataSrc\QWT.mbd'; sqlcolumns; Remarque: Certains drivers ODBC risquent de ne pas prendre en charge cette commande. Certains pilotes ODBC produiront sans doute des champs supplmentaires.
Retour Instructions de script et mots-cls (page 239).

SQLTables
L'instruction sqltables renvoie un ensemble de champs qui dcrivent les tables d'une source de donnes ODBC laquelle une instruction connect a t adresse. Ces champs peuvent tre combins avec des champs gnrs par les commandes SQLColumns (page 287) et SQLTypes (page 288) afin de donner un bon aperu d'une base de donnes particulire. Les cinq champs standard sont: TABLE_QUALIFIER TABLE_OWNER TABLE_NAME TABLE_TYPE REMARKS Pour une description dtaille de ces champs, consultez un manuel ODBC. La syntaxe est la suivante:

sqltables

Exemple:
connect to 'MS Access 7.0 Database; DBQ=C:\Course3\DataSrc\QWT.mbd'; sqltables; Remarque: Certains pilotes ODBC risquent de ne pas prendre en charge cette commande. Certains pilotes ODBC produiront sans doute des champs supplmentaires.
Retour Instructions de script et mots-cls (page 239).

SQLTypes
L'instruction sqltypes renvoie un ensemble de champs qui dcrivent les types d'une source de donnes ODBC laquelle une instruction connect a t adresse. Ces champs peuvent tre combins avec des champs

288

gnrs par les commandes SQLColumns (page 287) et SQLTables (page 288) afin de donner un bon aperu d'une base de donnes particulire. Les quinze champs standard sont: TYPE_NAME DATA_TYPE PRECISION LITERAL_PREFIX LITERAL_SUFFIX CREATE_PARAMS NULLABLE CASE_SENSITIVE SEARCHABLE UNSIGNED_ATTRIBUTE MONEY AUTO_INCREMENT LOCAL_TYPE_NAME MINIMUM_SCALE MAXIMUM_SCALE Pour une description dtaille de ces champs, consultez un manuel ODBC. La syntaxe est la suivante:

sqltypes

Exemple:
connect to 'MS Access 7.0 Database; DBQ=C:\Course3\DataSrc\QWT.mbd'; sqltypes; Remarque: Certains drivers ODBC risquent de ne pas prendre en charge cette commande. Certains pilotes ODBC produiront sans doute des champs supplmentaires.
Retour Instructions de script et mots-cls (page 239).

Star
On peut utiliser l'instruction star pour dfinir la chane qui reprsentera l'ensemble des valeurs d'un champ dans la base de donnes. Cela concerne les instructions Load (page 268) et Select (SQL) (page 284) ultrieures. La syntaxe est la suivante:

star is[ chane ]


o:

chane est un texte arbitraire. La chane doit tre crite entre Guillemets (page 305) si elle contient des caractres vierges.

Exemples:
Star is *; Star is %; Star is;

289

dfaut de toute indication, star is; est utilis. En d'autres termes, aucun symbole star n'est disponible moins d'tre explicitement prcis. Cette dfinition est valable jusqu' ce qu'une nouvelle instruction star soit crite. Retour Instructions de script et mots-cls (page 239).

Store
Un fichier QVD ou CSV peut tre cr par une instruction store dans le script. L'instruction cre un fichier QVD ou CSV explicitement nomm. Elle peut seulement exporter des champs d'une table logique. Les valeurs de texte sont exportes dans le fichier CSV au format UTF-8. Vous pouvez spcifier un dlimiteur (voir Load (page 268)). L'instruction store envoye un fichier CSV ne prend pas en charge l'exportation BIFF.

store[ *listedechamps from] table into nomdefichier [ spc-format ];


*listedechamps::= ( * | champ ) { , champ } ) est une liste des champs slectionner. Utiliser * comme liste de champs signifie tous les champs. champ::= nomdechamp [asalias ] nomdechamp est un texte identique au nom du champ dans la table. (N'oubliez pas que le nom du champ doit tre not entre Guillemets (page 305) doubles droits ou crochets s'il contient des espaces, par exemple.) alias est un autre nom utiliser pour le champ dans le fichier QVD ou CSV obtenu. table est une table dj charge et tiquete dans le script, utiliser comme source pour les donnes. nomdefichier est le nom du fichier cible. L'interprtation du nom de fichier est la mme que dans les instructions load, c'est--dire que les instructions directory s'appliquent. spc-format ::= ( ( txt | qvd ) )
La spcification du format comprend un texte txt pour les fichiers texte ou le texte qvd pour les fichiers qvd. Si le format n'est pas spcifi, qvd est utilis par dfaut.

Exemples:
Store matable into xyz.qvd (qvd); Store * from matable into xyz.qvd; Store Nom, NEnr from matable into xyz.qvd; Store Nom as a, NEnr as b from matable into xyz.qvd; store matable into monfichier.txt (txt); store * from matable into monfichier.txt (txt);
(Les deux premiers exemples produisent le mme rsultat.) Retour Instructions de script et mots-cls (page 239).

Sub..end sub
L'instruction de contrle sub..end sub dfinit une sous-routine qui peut tre appele par une instruction call. La syntaxe est la suivante:

subnom [ ( listeparam )] instructionsend sub


o:

290

nom listeparam

est le nom de la sous-routine. est une liste de noms de variables spars par des virgules et dfinissant les paramtres formels de la sous-routine. correspond tout groupe d'une ou plusieurs instructions de script QlikView.

instructions

Les arguments sont copis dans la sous-routine et, si l'argument correspondant de l'instruction call est un nom de variable, il est recopi et supprim la fermeture de la sous-routine. Si une sous-routine a plus de paramtres formels que ceux indiqus par une instruction call, les paramtres supplmentaires recevront la valeur NULL et pourront tre utiliss comme variables locales dans la sousroutine. Comme l'instruction sub est une instruction de contrle et, en tant que telle, se termine par un point-virgule ou une fin de ligne, aucune de ses deux clauses (sub et end sub) ne doit s'tendre sur plusieurs lignes.

Exemples:
// Exemple 1 sub INCR (I,J) I = I + 1 exit sub when I < 10 J = J + 1 end sub call INCR (X,Y) // Exemple 2 - transfert de paramtre sub ParTrans (A,B,C) A=A+1 B=B+1 C=C+1 end sub A=1 X=1 C=1 call ParTrans (A, (X+1)*2) // A=2 (recopi de sub) // X=1 (expression non recopie) // C=1 (C de sub est local) // B=NULL (local dans sub)
Retour Instructions de script et mots-cls (page 239).

Switch..case..default..end switch
L'instruction de contrle switch cre une primitive o un groupe d'instruction parmi plusieurs autres est excut, selon la valeur d'une expression. La syntaxe est la suivante:

291

switchexpression { case listedevaleurs [ instructions ]} [ default instructions ]end switch


o:

expression listedevaleurs

est une expression arbitraire. est une liste de valeurs spares par des virgules laquelle la valeur de l'expression sera compare. L'excution du script se poursuivra par les instructions du premier groupe trouv qui comporte dans listedevaleurs une valeur gale la valeur de l'expression. Chaque valeur de la listedevaleurs peut tre une expression arbitraire. Si aucune valeur correspondante n'est trouve dans aucune clause case, les instructions indiques dans la clause default, le cas chant, sont excutes. correspond tout groupe d'une ou plusieurs instructions de script QlikView.

instructions

Comme l'instruction switch est une instruction de contrle et, en tant que telle, se termine par un pointvirgule ou une fin de ligne, aucune de ses quatre clauses possibles (switch, case, default et end switch) ne peut s'tendre sur plusieurs lignes.

Exemples:
switch I case 1 load '$(I): CASE 1' as case autogenerate 1; case 2 load '$(I): CASE 2' as case autogenerate 1; default load '$(I): DEFAULT' as case autogenerate 1; end switch
Retour Instructions de script et mots-cls (page 239).

Tag Field
Permet d'affecter des balises un champ. Les noms de champs absents du document sont ignors. Si plusieurs occurrences d'un nom de champ ou de balise sont dtectes, la dernire valeur est utilise. Les champs avec la balise dimension apparaissent en haut de toutes les commandes de slection de champ dans QlikView, sauf dans la bote de dialogue diter l'expression. Un champ dot de la balise measure s'affiche avant toutes les commandes de slection de champs dans la bote de dialogue diter l'expression. Le mot-cl permet d'ajouter des balises un champ l'aide de la syntaxe suivante :

tag fieldslistedechampsutilisantnomdemappage

listedechamps est une liste des champs spars par des virgules et qui doivent tre marqus partir de cet endroit du script.

nomdemappage est le nom d'une table de mappage dj lue dans une instruction Mapping (page 276) load ou Mapping (page 276) select. Pour dfinir les balises sparment, la syntaxe suivante est utilise :

tag fieldnomdechampwithnomdebalise

292

nomdechamp est le nom du champ baliser. nomdebalise est le nom de la balise appliquer au champ.

Exemple 1:
tagmap: mapping Load * inline [ a,b Alpha,MyTag Num,MyTag ]; tag fields using tagmap;

Exemple 2:
tag field Alpha with MyTag2;
Retour Instructions de script et mots-cls (page 239).

Trace
L'instruction trace crit la chane dans la fentre Progression de l'excution du script et, le cas chant, dans le journal du script. La syntaxe est la suivante:

trace chane

Exemples:
trace Table principale charge; trace $(MonMessage);
Retour Instructions de script et mots-cls (page 239).

Unless
Utilis comme prfixe ou suffixe, unless sert crer une clause conditionnelle qui dtermine si une instruction ou une clause exit doit tre value ou non. On peut le considrer comme une alternative plus courte l'instruction complte if..end if. La syntaxe est la suivante:

( unless condition instruction | instructionexit unless condition )


o:

condition est une expression logique dont l'valuation donne vrai ou faux. instruction correspond n'importe quelle instruction de script QlikView, except les instructions de contrle. instructionexit est une clause exit for, exit do ou exit sub ou une instruction exit script.
L'instruction ou l'instructionexit ne sera excute que si la condition est value comme fausse. Le prfixe unless peut tre utilis pour des instructions qui ont dj une ou plusieurs autres instructions, y compris des prfixes supplmentaires when ou unless.

Exemples:

293

exit script unless A=1; unless A=1 load * from monfichier.csv; unless A=1 when B=2 drop table Tab1;
Retour Instructions de script et mots-cls (page 239).

Unmap
L'instruction unmap dsactive le Mapping (page 276) des champs indiqus partir de l'endroit du script o elle se trouve. La syntaxe est la suivante:

unmap*listedechamps
*listedechamps une liste des champs spars par des virgules et qui ne doivent plus tre mapps partir de cet endroit du script. Utiliser * comme liste de champs signifie tous les champs. Les caractres gnriques * et ? sont autoriss dans les noms de champs. Il peut tre ncessaire de mettre les noms de champs entre guillemets quand on utilise des caractres gnriques.

Exemples:
unmap Pays; unmap A, B, C; unmap * ; dsactive le mappage du champ Pays. dsactive le mappage des champs A, B et C. dsactive le mappage de tous les champs.

Retour Instructions de script et mots-cls (page 239).

Unqualify
L'instruction unqualify sert dsactiver la qualification des noms de champs qui a t active par l'instruction qualify. Reportez-vous la documentation sur l'instruction Qualify (page 279) pour obtenir la syntaxe et plus d'informations. Retour Instructions de script et mots-cls (page 239).

Untag Field
Permet de supprimer des balises d'un champ. Les noms de champs absents du document sont ignors. Si des occurrences en conflit d'un nom de champ ou de balise sont dtectes, la dernire valeur est utilise. Le mot-cl permet de supprimer des balises d'un champ l'aide de la syntaxe suivante :

untag fieldslistedechampsusingnomdemappage
listedechamps est une liste des champs spars par des virgules et dont les balises doivent tre supprimes. nomdemappage est le nom d'une table de mappage dj lue dans une instruction Mapping (page 276) load ou Mapping (page 276) select. Pour supprimer chaque composant, la syntaxe suivante est utilise :

untag fieldnomdechampwithnomdebalise
o

294

nomdechamp dsigne le champ dont les balises doivent tre supprimes. nomdebalise dsigne la balise supprimer du champ.

Exemple 1:
tagmap: mapping Load * inline [ a,b Alpha,MyTag Num,MyTag ]; untag fields using tagmap;

Exemple 2:
untag field Alpha with MyTag2;];
Retour Instructions de script et mots-cls (page 239).

Quand
Utilis comme prfixe ou suffixe, when sert crer une clause conditionnelle qui dtermine si une instruction ou une clause exit doit tre excute ou non. On peut le considrer comme une alternative plus courte l'instruction complte if..end if. La syntaxe est la suivante:

( when condition instruction | instructionexit when condition )


o:

condition est une expression logique dont l'valuation donne vrai ou faux. instruction correspond n'importe quelle instruction de script QlikView, except les instructions de contrle. instructionexit est une clause exit for, exit do ou exit sub ou une instruction exit script.
L'instruction ou l'instructionexit ne sera excute que si la condition est value comme vraie. Le prfixe when peut tre utilis pour des instructions qui comportent dj un ou plusieurs autres prfixes, y compris des prfixes supplmentaires when et unless.

Exemples:
exit script when A=1; when A=1 load * from monfichier.csv; when A=1 unless B=2 drop table Tab1;
Retour Instructions de script et mots-cls (page 239).

24.2 Noms des tables


Dnomination des tables
Les tables internes QlikView sont nommes lorsqu'elles sont stockes dans la base de donnes interne de QlikView. Les noms de tables peuvent tre utiliss par exemple pour load...resident, peek, etc. et on peut les voir dans le champ systme $Table de la disposition.

295

Les tables sont nommes selon les rgles suivantes : 1. Si une tiquette prcde immdiatement une instruction load ou select, elle sera utilise comme nom de table. L'tiquette doit tre suivie d'un signe deux-points (voir plus loin sous tiquettes de table). 2. Si aucune tiquette n'est fournie, c'est le nom de fichier ou le nom de table suivant immdiatement le mot-cl from dans l'instruction load ou select qui est utilis. Le nom doit comporter au maximum 32 caractres. Pour les noms de fichiers, l'extension est omise. 3. Les tables charges par une instruction load inline seront nommes INLINExx, o xx est un nombre. La premire table intgre s'appellera donc INLINE01. 4. Les tables gnres automatiquement s'appelleront AUTOGENERATExx, o xx est un nombre. La premire table autognre s'appellera donc AUTOGENERATE01. 5. Si un nom de table gnr selon les rgles ci-dessus est incompatible avec un nom de table existant, il sera suivi de -x , o x est un chiffre. Ce chiffre augmente jusqu' ce que l'incompatibilit soit rsolue. On pourrait, par exemple, avoir trois tables nommes Budget, Budget-1 et Budget-2. Il y a trois domaines diffrents pour les noms de tables : section access, section application et tables de mappage. Les noms de tables gnrs dans section access et section application seront traits sparment. Si un nom de table rfrenc est introuvable dans la section, QlikView cherchera aussi dans l'autre section. Les tables de mappage sont traites sparment et n'ont aucun lien avec les deux autres domaines de noms de tables.

tiquettes de table
Vous pouvez tiqueter une table interne pour ensuite y faire rfrence dans une instruction load avec une clause resident ou des expressions contenant la fonction peek. L'tiquette, qui peut tre une chane arbitraire de nombres ou de caractres, doit prcder la premire instruction Load (page 268) ou Select (SQL) (page 284) qui cre la table. L'tiquette doit se terminer par deux-points :.

Exemples:
Table1: Load a,b from c.csv; Load x,y from d.csv where x=peek("a",y,Table1); Transactions: Select * from Tabletrans; Load Mois, sum(Ventes) resident Transactions group by Mois;

24.3 Variables de script


Les variables de script sont des entits auxquelles on peut affecter n'importe quelle valeur textuelle ou numrique. Quand elle est utilise, la variable est remplace par sa valeur. On peut utiliser des variables dans le script pour l'expansion de macros et dans plusieurs instructions de contrle. Cela est trs utile si la mme chane, par exemple un chemin, est rpte souvent dans le script. Certaines variables systme seront dfinies par QlikView au dbut de l'excution du script, quelle que soit leur valeur prcdente. Lorsqu'on dfinit une variable de script, on utilise la syntaxe:

setvariablename = string
or

let variable = expression


est utilis. La commande Set assigne la variable le texte situ droite du signe gal, alors que la commande Let value l'expression.

296

Les variables sont sensibles la casse.

Exemple:
set HidePrefix = $ ; // la valeur de la variable est $. let vToday = Num(Today()); // renvoie le numro de srie d'aujourd'hui.
Les variables de script suivantes sont disponibles:

Variables d'erreur Variables d'interprtation de nombres Variables systme Variables de manipulation de valeurs

page 301 page 382 page 297 page 299

Variables systme
Ces variables ont des significations spciales pour QlikView:

Floppy
Renvoie la lettre du premier lecteur de disquettes trouv, normalement a:. Variable dfinie par le systme.

CD
Renvoie la lettre du premier lecteur de CD-ROM trouv. Si aucun lecteur de CD-ROM n'est trouv, la valeur c: est renvoye. Variable dfinie par le systme.

$(Include =nomdefichier )
La variable include indique un fichier qui contient le texte inclure dans le script. Le script entier peut ainsi tre mis dans un fichier. Variable dfinie par l'utilisateur.

Exemple:
$(Include=abc.txt);
En d'autres termes, la construction set Include =nomdefichier n'est pas applicable.

HidePrefix
Tous les noms de champs commenant par cette chane textuelle seront masqus de la mme manire que les champs systme. Variable dfinie par l'utilisateur.

Exemple:
set HidePrefix='_' ;
Si cette instruction est utilise, les noms de champs commenant par un tiret de soulignement ne s'afficheront pas dans les listes de noms de champs quand les champs systme seront masqus.

HideSuffix
Tous les noms de champs finissant par cette chane textuelle seront masqus de la mme manire que les champs systme. Variable dfinie par l'utilisateur.

Exemple:

297

set HideSuffix='%';
Si cette instruction est utilise, les noms de champs finissant par un symbole de pourcentage ne s'afficheront pas dans les listes de noms de champs quand les champs systme seront masqus.

QvPath
Renvoie le chemin de l'excutable QlikView. Variable dfinie par le systme.

QvRoot
Renvoie le rpertoire racine de l'excutable QlikView. Variable dfinie par le systme.

QvWorkPath
Renvoie le chemin du document QlikView actif. Variable dfinie par le systme.

QvWorkRoot
Renvoie le rpertoire racine du document QlikView actif. Variable dfinie par le systme.

StripComments
Si cette variable est fixe 0, le vidage slectif des commentaires /*..*/ et // du script sera empch. Certains pilotes de base de donnes utilisant les commentaires /*..*/ pour donner des astuces dans les instructions select pourraient autrement causer des erreurs de script. Il est recommand de remettre cette variable sur 1 tout de suite aprs la ou les instruction(s) o on en a besoin. Si cette variable n'est pas dfinie, le vidage slectif des commentaires sera toujours effectu.

Exemple:
set StripComments=0;

Verbatim
Normalement, toutes les valeurs de champs sont automatiquement dbarrasses des caractres vierges qui les prcdent ou les suivent (ASCII 32) avant d'tre charges dans la base de donnes QlikView. Mettre cette variable sur 1 suspend le vidage slectif des caractres vierges.

Exemple:
set Verbatim = 1;

OpenUrlTimeout
Cette variable dfinit le dlai d'attente en secondes que QlikView doit respecter lors de l'extraction de donnes de sources URL (pages HTML, par exemple). Si elle est omise, le dlai d'attente est d'environ 20minutes.

Exemple:
set OpenUrlTimeout=10

WinPath
Renvoie le chemin de Windows. Variable dfinie par le systme.

298

WinRoot
Renvoie le rpertoire racine de Windows. Variable dfinie par le systme.

Variables de manipulation de valeurs


NullDisplay
Le symbole dfini substitue toutes les valeurs NULL d'ODBC au niveau le plus bas de donnes. Variable dfinie par l'utilisateur.

Exemple:
set NullDisplay='<NULL>';

NullInterpret
Le symbole dfini sera interprt comme NULL lorsqu'il sera rencontr dans un fichier texte, un fichier Excel ou une instruction inline. Variable dfinie par l'utilisateur.

Exemple:
set NullInterpret=' '; set NullInterpret =;
ne renvoie PAS de valeurs NULL pour les valeurs vides dans Excel (mais en renvoie pour un fichier texte csv)

set NullInterpret ='';


renvoie des valeurs NULL pour les valeurs vides dans Excel (mais n'en renvoie PAS pour un fichier texte csv)

NullValue
Le symbole dfini remplacera toutes les valeurs NULL qui sont considres comme inconnues plutt qu'indfinies. Les seules valeurs NULL concernes sont celles incluses dans l'instruction NullAsValue.

Exemple:
set NullValue='<NULL>';

OtherSymbol
Dfinit un symbole traiter comme 'toutes les autres valeurs' avant une instruction load/select. Variable dfinie par l'utilisateur.

Exemple:
set OtherSymbol='+';

Variables d'interprtation de nombres


Les variables suivantes sont dfinies par le systme, c'est--dire qu'elles sont automatiquement gnres en fonction des paramtres du systme d'exploitation en vigueur la cration d'un document. Les variables d'interprtation numriques sont incluses au dbut du script du nouveau document QlikView et peuvent

299

remplacer les paramtres par dfaut du systme d'exploitation pour certains rglages de formatage numrique au moment de l'excution du script. Elles peuvent tre supprimes, modifies ou dupliques librement.

ThousandSep
Le sparateur de milliers dfini remplace le symbole de groupement des chiffres du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set ThousandSep=','; (par exemple, sept milliards doit tre spcifi sous la forme: 7.000.000.000)

DecimalSep
Le sparateur dcimal dfini remplace le symbole dcimal du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set DecimalSep='.';

MoneyThousandSep
Le sparateur de milliers dfini remplace le symbole de groupement des chiffres du systme d'exploitation pour les devises (Paramtres rgionaux).

Exemple:
Set MoneyThousandSep=',';

MoneyDecimalSep
Le sparateur dcimal dfini remplace le symbole dcimal du systme d'exploitation pour les devises (Paramtres rgionaux).

Exemple:
Set MoneyDecimalSep='.';

MoneyFormat
Le symbole dfini remplace le symbole montaire du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set MoneyFormat='$ #,##0.00; ($ #,##0.00)';

TimeFormat
Le format dfini remplace le format de l'heure du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set TimeFormat='hh:mm:ss';

DateFormat
Le format dfini remplace le format de date du systme d'exploitation (Paramtres rgionaux).

300

Exemple:
Set DateFormat='j/M/aa';

TimestampFormat
Le format dfini remplace les formats de date et heure du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set TimestampFormat='M/D/YY hh:mm:ss[.fff]';

MonthNames
Le format dfini remplace la convention portant sur les noms de mois du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set MonthNames='jan;fv;mar;avr;mai;jui;juil;ao;sep;oct;nov;dc';

LongMonthNames
Le format dfini remplace la convention portant sur les noms de mois longs du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set LongMonthNames='janvier;fvrier;mars;avril;mai;juin - -

DayNames
Le format dfini remplace la convention portant sur les noms des jours de la semaine du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set DayNames='lun;mar;mer;jeu;ven;sam;dim';

LongDayNames
Le format dfini remplace la convention portant sur les noms complets des jours de la semaine du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set LongDayNames='lundi;mardi;mercredi;jeudi;vendredi;samedi;dimanche';
Retour Other Functions.

Variables d'erreur
Les variables suivantes peuvent tre utilises pour traiter des erreurs dans le script:

ErrorMode ScriptError

page 302 page 302

301

ScriptErrorDetails ScriptErrorCount ScriptErrorList

page 303 page 303 page 303

Les valeurs de ces cinq variables seront conserves aprs l'excution du script. La valeur des quatre dernires variables, pour le traitement des erreurs dans le script, dpend bien sr de l'utilisation de la variable ErrorMode=0.

ErrorMode
Cette variable dtermine quelle action devra tre effectue par QlikView si une erreur est rencontre au cours de l'excution du script. Par dfaut (ErrorMode=1) l'excution du script sera interrompue et l'utilisateur sera invit choisir une action (mode autre que le traitement par lots). Avec ErrorMode =0, QlikView ignorera simplement l'chec et poursuivra l'excution du script avec l'instruction suivante. Avec ErrorMode =2, QlikView dclenche immdiatement un message d'erreur indiquant que l'excution du script a chou, sans inviter l'utilisateur choisir une action au pralable.

Exemple:
set ErrorMode=0;

ScriptError
Renvoie le code d'erreur de la dernire instruction excute. Cette variable sera rinitialise 0 aprs chaque instruction du script excute avec succs. Si une erreur survient, elle recevra un code d'erreur interne QlikView. Les codes d'erreur sont des valeurs doubles avec un composant numrique et un composant textuel. Les codes d'erreur suivants existent: 1 2 3 4 5 6 7 8 9 Pas d'erreur Erreur gnrale Erreur de syntaxe Erreur gnrale ODBC Erreur gnrale OLEDB Erreur gnrale XML Erreur gnrale HTML Fichier non trouv Base de donnes non trouve Table introuvable Champ non trouv Mauvais format de fichier

10 11 12

302

Exemple:
set ErrorMode=0; load * from abc.qvw; if ScriptError=8 then exit script; //no file; end if

ScriptErrorDetails
Renvoie une description plus dtaille de l'erreur pour certains des codes d'erreur ci-dessus. Cette variable contiendra surtout le message d'erreur renvoy par les pilotes ODBC et OLEDB pour les codes d'erreur 3 et 4.

ScriptErrorCount
Renvoie le nombre total d'instructions qui ont caus des erreurs au cours de l'excution du script. Cette variable est toujours rinitialise 0 au dbut de l'excution du script.

ScriptErrorList
Cette variable contiendra une liste concatne de toutes les erreurs survenues au cours de la dernire excution du script. Les erreurs sont spares par un saut de ligne.

24.4 Expansions$
Les expansions$ permettent de dfinir des remplacements de texte utiliss dans le script ou dans des expressions. On appelle ce processus expansion, mme si le nouveau texte est plus court. Le remplacement est effectu juste avant que l'instruction de script ou que l'expression ne soit value. Sur le plan technique, il s'agit d'une expansion de macros. Une expansion de macros commence toujours par $( et se termine par ). Le contenu entre parenthses dfinit la faon dont le remplacement de texte sera effectu. Afin d'viter toute confusion avec les macros de script, nous parlerons d'expansions$ pour dsigner les expansions de macros.

Remarque: Une expansion de macros n'a aucun rapport avec les macros de script (VB ou script Java dfini dans le module du script). Remarque: Une expansion $ est limite au nombre d'expansions de macro qu'elle peut calculer. Aucune expansion de plus de 1000 ne sera calcule.

Expansion $ avec une variable


Lorsque l'on utilise une variable pour remplacer du texte dans le script ou dans une expression, la syntaxe

$( nomdelavariable)
est utilis. $(nomdelavariable) dveloppe l'expression de la valeur de nomdelavariable. Si nomdelavariable n'existe pas, l'expansion sera la chane vide. Pour l'expansion numrique de variables, la syntaxe

$( nomdelavariable)

303

est utilis. $( nomdelavariable ) produit toujours un nombre avec dcimales qui reflte la valeur numrique de nomdelavariable, ventuellement avec une notation exponentielle (pour les nombres trs grands/petits). Si nomdelavariable n'existe pas ou ne contient pas de valeur numrique, la chane sera dveloppe de 0.

Exemple:
Aprs l'excution du script suivant:

SET DecimalSep=','; LET X = 7/2;


$(X ) s'tend 3,5 tandis que $(#X ) s'tend 3.5.

Exemples:
set Monchemin=C:\MesDocuments\Fichiers\ ... load * from $(Monchemin)abc.csv; set AnneActuelle=1992; ... select * from table1 where Anne=$(AnneActuelle);

Expansion$ avec paramtres


On peut utiliser des paramtres dans les expansions de variables. La variable doit avoir des paramtres formels comme $1, $2, $3 etc. Lors de l'expansion de la variable, les paramtres doivent tre spars par des virgules:

Exemples:
set MUL=$1*$2; set X=$(MUL(3,7)); // renvoie '3*7' pour X let X=$(MUL(3,7)); // renvoie 21 pour X
Si le nombre de paramtres formels excde le nombre de paramtres rels, seuls les paramtres formels correspondant des paramtres rels seront dvelopps. Si le nombre de paramtres rels excde le nombre de paramtres formels, les paramtres rels superflus seront ignors.

Exemples:
set MUL=$1*$2; set X=$(MUL); // renvoie '$1*$2' pour X set X=$(MUL(10)); // renvoie '10*$2' pour X let X=$(MUL(5,7,8)); // renvoie 35 pour X Le paramtre $0 renvoie le nombre de paramtres effectivement transmis par un appel.

Exemple:
set MUL='$1*$2 $0 par'; set X=$(MUL(3,7)); // renvoie '3*7 2 par' pour X

Expansion$ avec une expression


On peut utiliser des expressions dans les expansions$. Le contenu entre parenthses doit commencer par un signe gal: $( =expression ) L'expression est value et la valeur est utilise lors de l'expansion.

304

Exemple:
$(=Year(Today())); // renvoie par exemple '2008' $(=Only(Year)-1); // renvoie l'anne prcdant l'anne slectionne

Expansion $ d'un fichier- Instruction Include


Les inclusions de fichiers sont effectues l'aide des expansions$. La syntaxe est la suivante: $( include=nomdefichier) Le texte ci-dessus est remplac par le contenu du fichier spcifi aprs le signe gal. Cette fonctionnalit est trs utile pour stocker des scripts ou des parties de scripts dans des fichiers texte.

Exemple:
$(include=C:\Documents\MyScript.qvs);

24.5 Guillemets
Si les guillemets sont possibles ou ncessaires dans une instruction, cela est mentionn ci-dessous; voir aussi Instructions de script et mots-cls (page 239). Dans une instruction Load (page 268), les symboles suivants doivent tre utiliss comme guillemets:
Noms des champs: Littraux de chane: [ ] , " " , ` ` ou ''

Pour une instruction Select (SQL) (page 284) interprte par le ODBCdriver, ils peuvent toutefois diffrer lgrement. Vous devez en gnral utiliser les guillemets droits doubles (ALT + 0034) pour les noms et les guillemets droits simples (ALT + 0039) pour les littraux, et donc jamais les guillemets obliques: ou ` `. Cependant, certains pilotes ODBC non seulement acceptent, mais prfrent les guillemets obliques. Dans ce cas, les instructions Select (SQL) (page 284) gnres contiennent des guillemets obliques.

Exemple: diffrence entre les noms et les littraux


La diffrence entre les noms et les littraux devient plus claire si vous comparez les expressions suivantes:

'Sude' as Pays
dans la liste de champs d'une instruction load ou select chargera la chane textuelle Sude comme valeur de champ dans le champ QlikView "Pays" , tandis que

"tat" as Pays
dans la liste de champs d'une instruction load ou select entrane le chargement du contenu du champ de base de donnes ou de la colonne de table appele "tat" sous la forme de valeurs dans le champ QlikView "Pays" . C'est--dire que tat sera trait comme une rfrence de champ.

Exemple: diffrence entre les nombres et les littraux de chane


La diffrence entre les noms et les littraux de chane devient plus claire si vous comparez les expressions suivantes:

'12/31/96'
dans une expression sera interprt comme la chane textuelle "12/31/96", tandis que

12/31/96 dans une expression sera interprt numriquement comme la date du 31dcembre1996 et se verra attribuer la valeur numrique correspondante, condition que le format de date du systme soit bienMM/JJ/AA.

305

Exemple: MSAccess
Microsoft Access ODBC Driver 3.4 (inclus dans MS Access 7.0) accepte les guillemets suivants dans l'analyse de l'instruction select:
Noms des champs et des tables: Littraux de chane: Refuss: [ ] , " " ou ` ` ''

306

25 Expressions de script
Vous pouvez utiliser des expressions la fois dans l'instruction Load (page 268) et dans l'instruction Select (SQL) (page 284). La syntaxe et les functions dcrites ici s'appliquent l'instruction load, et non l'instruction select, puisque cette dernire est interprte par le ODBCdriver et non par QlikView. Cependant, la plupart des pilotes ODBC sont souvent capables d'interprter beaucoup des fonctions dcrites ci-dessous. Les expressions comprennent des functions, des Champs (page 181) et des Oprateurs (page 849), combins dans une Syntaxe de script (page 239). Toutes les expressions d'un script QlikView renvoient un nombre et/ou une chane, selon le cas. Les fonctions et les Oprateurs (page 849) logiques renvoient 0 pour faux et -1 pour vrai. Les conversions de nombres en chanes et vice-versa sont implicites. Les oprateurs et les fonctions logiques interprtent 0 comme faux et tout le reste comme vrai. La syntaxe gnrale pour une expression est la suivante:

expression ::= ( constante constante rfdechamp oprateur1 expression

| | |

expression oprateur2 expression | fonction ( expression ))


o:

constante est une chane (un texte, une date ou une heure) place entre guillemets simples, ou un nombre. Les constantes sont crites sans sparateur de milliers et avec un point comme sparateur dcimal. rfdechamp est le nom d'un champ de la table charge. oprateur1 est un oprateur unaire (qui agit sur une expression, celle qui se trouve droite). oprateur2 est un oprateur binaire (qui agit sur deux expressions, une de chaque ct). fonction ::= nomdelafonction (paramtres ) paramtres ::= expression { , expression } Le nombre et les types de paramtres ne sont pas arbitraires. Ils dpendent de la fonction utilise.
Les expressions et les fonctions peuvent ainsi tre imbriques librement, et tant que l'expression renvoie une valeur interprtable, QlikView n'affichera pas de message d'erreur.

25.1 Oprateurs
Il existe deux types d'oprateurs dans QlikView: des oprateurs unaires, qui ne prennent qu'une seule oprande, et des oprateurs binaires qui en prennent deux. La plupart des oprateurs sont binaires. On peut dfinir les oprateurs suivants:

Oprateurs mathmatiques

page 850

307

Oprateurs de chanes Oprateurs logiques Oprateurs relationnels Oprateurs de bits

page 850 page 850 page 851 page 852

Oprateurs mathmatiques
Tous les oprateurs mathmatiques utilisent les valeurs numriques des oprandes et renvoient une valeur numrique. + Signe d'un nombre positif (oprateur unaire) ou d'une addition arithmtique. L'opration binaire renvoie la somme des deux oprandes. Signe d'un nombre ngatif (oprateur unaire) ou d'une soustraction arithmtique. L'opration unaire renvoie l'oprande multiplie par-1, tandis que l'opration binaire renvoie la diffrence entre les deux oprandes. Multiplication arithmtique. L'opration renvoie le produit des deux oprandes. Division arithmtique. L'opration renvoie le rapport des deux oprandes.

* /

Oprateurs de chanes
Il existe deux oprateurs de chane. Il utilise les valeurs de chane des oprandes et renvoie une chane comme rsultat. L'autre compare les oprandes et renvoie une valeur boolenne pour indiquer s'il y a correspondance. & Concatnation de chane. L'opration renvoie une chane textuelle qui consiste en deux chanes d'oprandes, places l'une aprs l'autre.

Exemple:
'abc' & 'xyz' renvoie 'abcxyz'
like Comparaison de chanes contenant des caractres gnriques. L'opration renvoie un boolen vrai (-1) si la chane situe avant l'oprateur correspond la chane situe aprs l'oprateur. La deuxime chane peut contenir les caractres gnriques * (n'importe quel chiffre parmi des caractres arbitraires) ou ? (un caractre arbitraire).

Exemples:
'abc' like 'a*' renvoie vrai (-1) 'abcd' like 'a?c*' renvoie vrai (-1) 'abc' like 'a??bc' renvoie faux (0)

Oprateurs logiques
Tous les oprateurs logiques interprtent les oprandes logiquement et renvoient vrai (-1) ou faux (0).

308

not

Inverse logique. Un des quelques oprateurs unaires. L'opration renvoie l'inverse logique de l'oprande. Et logique. L'opration renvoie le et logique des oprandes. Ou logique. L'opration renvoie le ou logique des oprandes. Ou logique exclusif. L'opration renvoie le ou logique exclusif des oprandes. Cela s'apparente au ou logique cette diffrence prs que le rsultat est faux si les deux oprandes sont vrais.

et or Xor

Oprateurs relationnels
Tous les oprateurs relationnels comparent les valeurs des oprandes et renvoient vrai (-1) ou faux (0). Tous les oprateurs relationnels sont binaires.

<

Infrieur

Effectue une comparaison numrique si les deux oprandes peuvent tre interprtes numriquement. L'opration renvoie le rsultat logique de l'valuation de la comparaison. Effectue une comparaison numrique si les deux oprandes peuvent tre interprtes numriquement. L'opration renvoie le rsultat logique de l'valuation de la comparaison. Effectue une comparaison numrique si les deux oprandes peuvent tre interprtes numriquement. L'opration renvoie le rsultat logique de l'valuation de la comparaison. Effectue une comparaison numrique si les deux oprandes peuvent tre interprtes numriquement. L'opration renvoie le rsultat logique de l'valuation de la comparaison. Effectue une comparaison numrique si les deux oprandes peuvent tre interprtes numriquement. L'opration renvoie le rsultat logique de l'valuation de la comparaison. Effectue une comparaison numrique si les deux oprandes peuvent tre interprtes numriquement. L'opration renvoie le rsultat logique de l'valuation de la comparaison. Contrairement l'oprateur < , cet oprateur ne tente pas de faire une interprtation numrique des arguments avant d'effectuer la comparaison. L'opration renvoie vrai si la valeur gauche de l'oprateur a une reprsentation textuelle qui, en comparaison ASCII, est antrieure la reprsentation textuelle de la valeur de droite.

<=

Infrieur ou gal

>

Suprieur

>=

Suprieur ou gal

gal

<>

Diffrent de

precedes

Infrieur (ASCII)

Exemple:
' 11' precedes ' 2' renvoie vrai
tandis que:

' 11' < ' 2' renvoie faux

309

follows

Suprieur (ASCII)

Contrairement l'oprateur > , cet oprateur ne tente pas de faire une interprtation numrique des arguments avant d'effectuer la comparaison. L'opration renvoie vrai si la valeur gauche de l'oprateur a une reprsentation textuelle qui, en comparaison ASCII, est postrieure la reprsentation textuelle de la valeur de droite.

Exemple:
' 23' follows ' 111' renvoie vrai
tandis que:

' 23' > ' 111' renvoie faux

Oprateurs de bits
Tous les oprateurs de bits convertissent les oprandes en entiers signs (32bits) et renvoient le rsultat de la mme faon. Toutes les oprations sont effectues bit bit.

bitnot

Inverseur de bits.

Oprateur unaire. L'opration renvoie l'inverse logique de l'oprande excute bit bit. L'opration renvoie le ET logique des oprandes excutes bit bit. L'opration renvoie le OU logique des oprandes excutes bit bit. L'opration renvoie le ou logique exclusif des oprandes excutes bit bit. Oprateur unaire. L'opration renvoie l'oprande dcale vers la droite.

bitand bitor bitxor

Et binaire. Ou binaire. Ou exclusif binaire.

>>

Dcalage de bit droite. Dcalage de bit gauche.

<<

Oprateur unaire. L'opration renvoie l'oprande dcale vers la gauche.

25.2 Fonctions d'agrgation


Ces fonctions ne peuvent tre utilises que dans des listes de champs destines aux instructions Load (page 268) contenant une clause group by. Les fonctions d'agrgation sont les suivantes:

Fonctions d'agrgation de base Fonctions d'agrgation de chane Fonctions d'agrgation de dcompte Agrgation avance Fonctions d'agrgation statistique dans le script Fonctions d'agrgation de la catgorie Financier dans le script Fonctions statistiques de test dans les scripts

page 311 page 312 page 313 page 314 page 314 page 319 page 320

310

Remarque ! En l'absence de valeur, la chane NULL est renvoye pour toutes les fonctions d'agrgation, sauf Sum et Count qui renvoient toutes deux la valeur 0.

Fonctions d'agrgation de base


sum([distinct]expression)
Renvoie la somme de l'expression sur un certain nombre d'enregistrements dfinis par une clause group by. Si le terme distinct est employ devant l'expression, tous les doublons seront ignors.

Exemple:
Load Mois, sum(Ventes) as VentesParMois from abc.csv group by Mois;

min( expression[, rank] )


Renvoie la valeur numrique minimale de l'expression rencontre sur un nombre donn d'enregistrements dfinis par une clause group by. Rank prend par dfaut la valeur 1 qui correspond la valeur la plus faible. En dfinissant rank sur 2, on obtient la deuxime valeur la plus faible. Si la valeur de rank est gale 3, on obtient la troisime valeur la plus faible, et ainsi de suite.

Exemples:
Load Mois, min(Ventes) as PlusFaiblesVentesParMois from abc.csv group by Mois; Load Mois, min(Ventes, 2) as Deuximepluspetiteventeparmois from abc.csv group by Mois;

max( expression[, rank] )


Renvoie le nombre maximum de l'expression parmi un certain nombre d'enregistrements dfinis par une clause group by. Rank prend par dfaut la valeur 1 qui correspond la valeur la plus leve. En dfinissant rank sur 2, on obtient la deuxime valeur la plus leve. Si la valeur de rank est dfinie sur 3, on obtient la troisime valeur la plus leve, et ainsi de suite.

Exemples:
Load Mois, max(Ventes) as PlusGrossesVentesParMois from abc.csv group by Mois; Load Mois, max(Ventes, 2) as PlusGrossesVentesParMois from abc.csv group by Mois;

only(expression)
Si l'expression sur un certain nombre d'enregistrements, dfinis par une clause group by, contient une seule valeur numrique, cette valeur est renvoye. Autrement, le programme renvoie NULL.

Exemple:
Load Mois, only(Prix) as UniquementPrixVente from abc.csv group by Mois;

mode(expression)
Renvoie la valeur de mode, c'est--dire la valeur la plus frquente, de l'expression sur un certain nombre d'enregistrements, dfinis par une clause group by. Si deux valeurs prsentent exactement la mme frquence, le programme renvoie NULL. Mode peut renvoyer des valeurs numriques aussi bien que des valeurs

311

textuelles.

Exemples:
Load Mois, mode( NumroErreur ) as NumroErreurPlusCourante from abc.csv group by Mois; Load Mois, mode( Produit ) as ProduitLePlusVendu from abc.csv group by Mois;

firstsortedvalue ([distinct ] expression [, sort-weight [, n ]])


Renvoie la premire valeur de l'expression trie par le coefficient de tri (sort-weight) correspondant quand l'expression est rpte sur un certain nombre d'enregistrements, dfinis par une clause group by. Sort-weight doit renvoyer une valeur numrique o la valeur la plus faible donnera la premire valeur correspondante de l'expression. Si l'on fait prcder l'expression sort-value d'un signe moins, la fonction renverra la dernire valeur. Si plusieurs valeurs de l'expression partagent le mme sort-order le plus faible, la fonction renverra la chane NULL. En spcifiant un n suprieur 1, vous obtiendrez la nime valeur dans l'ordre de tri. Si le terme distinct est employ devant l'expression, tous les doublons seront ignors.

Exemple:
Load Client, firstsortedvalue(Articleachet, Datedecommande) as Premierproduitachet from abc.csv group by Client;

Fonctions d'agrgation de chane


MinString(expression)
Renvoie la premire valeur textuelle de l'expression sur un certain nombre d'enregistrements dfinis par une clause group by. S'il ne trouve aucune valeur textuelle, le programme renvoie NULL.

Exemple:
Load Mois, MinString(Mois) as PremiresVentesMois from abc.csv group by Anne;

MaxString(expression)
Renvoie la dernire valeur textuelle de l'expression sur un certain nombre d'enregistrements dfinis par une clause group by. S'il ne trouve aucune valeur textuelle, le programme renvoie NULL.

Exemple:
Load Mois, MaxString(Mois) as DerniresVentesMois from abc.csv group by Anne;

FirstValue(expression)
Renvoie la premire valeur dans l'ordre de chargement de l'expression sur un certain nombre d'enregistrements dfinis par une clause group by. S'il ne trouve aucune valeur textuelle, le programme renvoie NULL. Cette fonction n'est disponible que comme fonction de script.

Exemple:
Load Ville, FirstValue(Nom) as Premiernom from abc.csv group by Ville;

LastValue(expression)
Renvoie la dernire valeur dans l'ordre de chargement de l'expression sur un certain nombre d'enregistrements dfinis par une clause group by. S'il ne trouve aucune valeur textuelle, le programme renvoie NULL. Cette fonction n'est disponible que comme fonction de script.

312

Exemple:
Load Ville, LastValue(Nom) as Premiernom from abc.csv group by Ville;

concat ([ distinct ] expression [, delimiter [, sort-weight]])


Renvoie la concatnation de chane agrge de toutes les valeurs de l'expression rpte sur un certain nombre d'enregistrements dfinis par une clause group by. Les valeurs peuvent tre spares par la chane indique dans delimiter. L'ordre de concatnation peut tre dtermin par le coefficient de tri sort-weight. Sort-weight doit renvoyer une valeur numrique o la valeur la plus faible donnera le premier lment. Si le terme distinct est employ devant l'expression, tous les doublons seront ignors.

Exemple:
Load Service, concat(Nom,';') as Listedenoms from abc.csv group by Service;

Fonctions d'agrgation de dcompte


count([distinct ] expression | * )
Renvoie le dcompte de l'expression sur un certain nombre d'enregistrements dfinis par une clause group by. Si le terme distinct est employ devant l'expression, tous les doublons seront ignors.

Exemples:
Load Mois, count(Ventes) as NombreDeVentesParMois from abc.csv group by Mois; Load Mois, count(distinct Client) as ClientAcheteurParMois from abc.csv group by Mois; Load Mois, count(*) as NombreEnregistrementsParMois from abc.csv group per Mois;

NumericCount([distinct ] expression )
Renvoie le dcompte numrique de l'expression sur un certain nombre d'enregistrements dfinis par une clause group by. Si le terme distinct est employ devant l'expression, tous les doublons seront ignors.

Exemple:
Load Mois, NumericCount(Elments) as NombreElmentsNumriques from abc.csv group by Mois;

TextCount([distinct ] expression)
Renvoie le dcompte de texte de l'expression sur un certain nombre d'enregistrements dfinis par une clause group by. Si le terme distinct est employ devant l'expression, tous les doublons seront ignors.

Exemple:
Load Mois, TextCount(Elment) as NombreElmentsTextuels from abc.csv group by Mois;

NullCount([distinct ] expression )
Renvoie le dcompte de chanes NULL de l'expression sur un certain nombre d'enregistrements dfinis par une clause group by. Si le terme distinct est employ devant l'expression, tous les doublons seront ignors.

Exemple:
Load Mois, NullCount(Elment) as NombreElmentsNull from abc.csv group by Mois;

MissingCount([distinct ] expression )

313

Renvoie le dcompte manquant de l'expression sur un certain nombre d'enregistrements dfinis par une clause group by. Si le terme distinct est employ devant l'expression, tous les doublons seront ignors.

Exemple:
Load Mois, MissingCount(Elment) as NombreElmentsManquants from abc.csv group by Mois;

Agrgation avance
Il y a une fonction spciale pour des agrgations avances :

aggr ([ distinct | nodistinct ] [{expression_ensemble}]expression {, dimension})


Renvoie un ensemble de valeurs, de l'expression calcule au moyen des dimensions. Le rsultat peut tre compar la colonne d'expression d'un graphique local, value dans le contexte de la fonction aggr. Chaque dimension doit tre un champ simple. Ce ne peut pas tre une expression (une dimension calcule). Si l'argument expression est prcd de loption nodistinct, chaque combinaison des valeurs de dimension, selon la structure des donnes de base, peut renvoyer plus dune valeur. Si l'argument expression est prcd du qualificateur distinct ou si aucun qualificateur n'est utilis, chaque combinaison de valeurs de dimension gnrera une seule valeur de retour. Par dfaut, la fonction d'agrgation agrge sur l'ensemble des enregistrements possibles dfinis par la slection. En ensemble alternatif d'enregistrements peut tre dfini par une expression Analyse d'ensembles (page 883). En employant cette fonction dans des Ajouter une dimension calcule... (page 665), il est possible de raliser des agrgations graphiques imbriques plusieurs niveaux. Voir aussi Agrgations imbriques et autres considrations (page 933). Une fois utilis dans des expressions de graphiques il est possible de raliser la Somme des lignes dans les tableaux croiss dynamiques (page 935).

Exemples:
aggr( sum(Ventes), Pays ) aggr( nodistinct sum(Ventes), Pays ) aggr( sum(Ventes), Pays, Region ) count( aggr( sum(Ventes), Pays ))

Fonctions d'agrgation statistique dans le script


fractile(expression, fractile)
Renvoie le fractile de l'expression sur un certain nombre d'enregistrements dfinis par une clause group by.

Exemple:
Load Class, fractile( Note, 0.75 ) as F from abc.csv group by Classe;

kurtosis([distinct ] expression)
Renvoie le kurtosis de l'expression au-dessus d'un nombre d'enregistrements dfinis par une clause group by. Si le terme distinct est employ devant l'expression, tous les doublons seront ignors.

Exemple:
Load Mois, kurtosis(Ventes) as KurtosisVentes from abc.csv group by Mois;

314

correl(expression-x, expression-y)
Renvoie le coefficient agrg pour une srie de coordonnes reprsentes par des paires nombres dans l'expression-x et l'expression-y itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Les caractres, les valeurs nulles et les valeurs absentes dans n'importe lequel des deux paramtres ne sont pas autoriss.

Exemple:
Load Mois, correl(X,Y) as CC from abc.csv group by Mois;

avg([distinct] expression)
Renvoie la moyenne de l'expression au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Si le terme distinct est employ devant l'expression, tous les doublons seront ignors.

Exemple:
Load Mois, avg(Ventes) as MoyenneDesVentesParMois from abc.csv group by Mois;

stdev([distinct] expression)
Renvoie l'cart type de l'expression au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Si le terme distinct est employ devant l'expression, tous les doublons seront ignors.

Exemple:
Load Mois, stdev(Ventes) as EcartTypeDesVentes from abc.csv group by Mois;

skew([ distinct] expression)


Renvoie l'obliquit de l'expression au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Si le terme distinct est employ devant l'expression, tous les doublons seront ignors.

Exemple:
Load Mois, skew(Ventes) as ObliquiteDesVentes from abc.csv group by Mois;

median (expression)
Renvoie la valeur mdiane agrge de l'expression au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by.

Exemple:
Load Class, Median(Note) as MG from abc.csv group by Classe;

sterr ([distinct] expression)


Renvoie l'erreur type (stdev/sqrt(n)) d'une srie de valeurs reprsentes par l'expression rpte sur un certain nombre d'enregistrements dfinis par une clause group by. Les valeurs texte, les valeurs nulle et les valeurs manquante seront ngliges. Si le terme distinct prcde les arguments de la fonction, les doublons rsultant de l'valuation de la fonction seront ignors.

Exemple:
Load Cl, sterr(X) as Z from abc.csv group by Cl;

steyx (expression-y, expression-x)


Renvoie l'erreur type agrge de la valeur y prvue pour chaque valeur x dans la rgression pour une srie de

315

coordonnes reprsentes par une paire de nombres dans l'expression-x et l'expression-y itres au-dessus d'un certain nombre d'enregistrements dfinis par la clause group by. Les caractres, les valeurs nulles et les valeurs absentes dans n'importe lequel des deux paramtres ne sont pas autoriss.

Exemple:
Load Cl, steyx(Y,X) as Z from abc.csv group by Cl;

linest_m (expression-y, expression-x [, y0 [, x0 ]])


Renvoie la valeur agrge de m (pente) d'une rgression linaire dfinie par l'quation y=mw+b pour une srie de coordonnes reprsents par une paire de nombres dans l'expression-x et l'expression-y itre audessus d'un certain nombre d'enregistrements dfinis par une clause group by. Les caractres, les valeurs nulles et les valeurs absentes dans n'importe lequel des deux paramtres ne sont pas autoriss. On peut spcifier une valeur y 0 facultative qui force la droite de rgression passer par l'axe des ordonnes (y) en un point donn. En spcifiant la fois y 0 et x 0, on peut forcer la droite de rgression passer par un point fixe. moins que les arguments y 0 et x 0 ne soient tous deux prciss, la fonction requiert au moins deux paires de donnes valides pour tre calcule. Si y 0 et x 0 sont dfinies, une seule paire de donnes suffira.

Exemple:
Load Cl, linest_m(Y,X) as Z from abc.csv group by Cl;

linest_b (expression-y, expression-x [, y0 [, x0 ]])


Renvoie la valeur agre de b (ordonne l'origine) d'une rgression linaire dfinie par l'quation y=mx+b pour une srie de coordonnes reprsentes par une paire de nombres dans l'expression-x et dans l'expressiony itres au-dessus d'un certain nombre d'enregistrement dfinis par la clause group by. Les caractres, les valeurs nulles et les valeurs absentes dans n'importe lequel des deux paramtres ne sont pas autoriss. On peut spcifier une valeur y 0 facultative qui force la droite de rgression passer par l'axe des ordonnes (y) en un point donn. En spcifiant la fois y 0 et x 0, on peut forcer la droite de rgression passer par un point fixe. moins que les arguments y 0 et x 0 ne soient tous deux prciss, la fonction requiert au moins deux paires de donnes valides pour tre calcule. Si y 0 et x 0 sont dfinies, une seule paire de donnes suffira.

Exemple:
Load Cl, linest_b(Y,X) as Z from abc.csv group by Cl;

linest_r2 (expression-x, expression-y [, y0 [, x0 ]])


Renvoie la valeur r2 (coefficient de dtermination) agrge d'une rgression linaire dfinie par l'quation y=mx+b pour une srie de coordonnes reprsentes par des nombres apparis dans expression-x et expression-y, rptes sur un certain nombre d'enregistrements dfinis par une clause group by. Les caractres, les valeurs nulles et les valeurs absentes dans n'importe lequel des deux paramtres ne sont pas autoriss. Une valeur facultative y0 peut forcer la droite de rgression passer un point donn sur l'axe des ordonnes. En fixant y0 et x0 il est possible de forcer la ligne de rgression passer travers une coordonne simple. moins que les arguments y 0 et x 0 ne soient tous deux prciss, la fonction requiert au moins deux paires de donnes valides pour tre calcule. Si y 0 et x 0 sont dfinies, une seule paire de donnes suffira.

Exemple:
Load Cl, linest_r2(Y,X) as Z from abc.csv group by Cl;

linest_sem (expression-x, expression-y [, y0 [, x0 ]])

316

Renvoie l'erreur type agrge de la valeur m d'une rgression linaire dfinie par l'quation y=mx+b pour une srie de coordonnes reprsentes par des nombres apparis dans expression-x et expression-y, rptes sur un certain nombre d'enregistrements dfinis par une clause group by. Les caractres, les valeurs nulles et les valeurs absentes dans n'importe lequel des deux paramtres ne sont pas autoriss. On peut spcifier une valeur y 0 facultative qui force la droite de rgression passer par l'axe des ordonnes (y) en un point donn. En spcifiant la fois y 0 et x 0, on peut forcer la droite de rgression passer par un point fixe. moins que les arguments y 0 et x 0 ne soient tous deux prciss, la fonction requiert au moins deux paires de donnes valides pour tre calcule. Si y 0 et x 0 sont dfinies, une seule paire de donnes suffira.

Exemple:
Load Cl, linest_sem(Y,X) as Z from abc.csv group by Cl;

linest_seb (expression-x, expression-y [, y0 [, x0 ]])


Renvoie l'erreur type agrge de la valeur b d'une rgression linaire dfinie par l'quation y=mx+b pour une srie de coordonnes reprsentes par des nombres apparis dans expression-x et expression-y, rptes sur un certain nombre d'enregistrements dfinis par une clause group by. Les caractres, les valeurs nulles et les valeurs absentes dans n'importe lequel des deux paramtres ne sont pas autoriss. On peut spcifier une valeur y 0 facultative qui force la droite de rgression passer par l'axe des ordonnes (y) en un point donn. En spcifiant la fois y 0 et x 0, on peut forcer la droite de rgression passer par un point fixe. moins que les arguments y 0 et x 0 ne soient tous deux prciss, la fonction requiert au moins deux paires de donnes valides pour tre calcule. Si y 0 et x 0 sont dfinies, une seule paire de donnes suffira.

Exemple:
Load Cl, linest_seb(Y,X) as Z from abc.csv group by Cl;

linest_sey (expression-x, expression-y [, y0 [, x0 ]])


Renvoie l'erreur type agrge de l'estimationy d'une rgression linaire dfinie par l'quation y=mx+b pour une srie de coordonnes reprsentes par des nombres apparis dans expression-x et expression-y, rptes sur un certain nombre d'enregistrements dfinis par une clause group by. Les caractres, les valeurs nulles et les valeurs absentes dans n'importe lequel des deux paramtres ne sont pas autoriss. On peut spcifier une valeur y 0 facultative qui force la droite de rgression passer par l'axe des ordonnes (y) en un point donn. En spcifiant la fois y 0 et x 0, on peut forcer la droite de rgression passer par un point fixe. moins que les arguments y 0 et x 0 ne soient tous deux prciss, la fonction requiert au moins deux paires de donnes valides pour tre calcule. Si y 0 et x 0 sont dfinies, une seule paire de donnes suffira.

Exemple:
Load Cl, linest_sey(Y,X) as Z from abc.csv group by Cl;

linest_df (expression-y, expression-x [, y0 [, x0 ]])


Renvoie les degrs de libert agrgs d'une rgression linaire dfinie par l'quation y=mx+b pour une srie de coordonnes reprsentes par des nombres apparis dans expression-x et expression-y, rptes sur un certain nombre d'enregistrements dfinis par une clause group by. Les caractres, les valeurs nulles et les valeurs absentes dans n'importe lequel des deux paramtres ne sont pas autoriss. On peut spcifier une valeur y 0 facultative qui force la droite de rgression passer par l'axe des ordonnes (y) en un point donn. En spcifiant la fois y 0 et x 0, on peut forcer la droite de rgression passer par un point fixe.

317

moins que les arguments y 0 et x 0 ne soient tous deux prciss, la fonction requiert au moins deux paires de donnes valides pour tre calcule. Si y 0 et x 0 sont dfinies, une seule paire de donnes suffira.

Exemple:
Load Cl, linest_df(Y,X) as Z from abc.csv group by Cl;

linest_f (expression-y, expression-x [, y0 [, x0 ]])


Renvoie la statistique F (r2/(1-r2)) agrge d'une rgression linaire dfinie par l'quation y=mx+b pour une srie de coordonnes reprsentes par des nombres apparis dans expression-x et expression-y, rptes sur un certain nombre d'enregistrements dfinis par une clause group by. Les caractres, les valeurs nulles et les valeurs absentes dans n'importe lequel des deux paramtres ne sont pas autoriss. On peut spcifier une valeur y 0 facultative qui force la droite de rgression passer par l'axe des ordonnes (y) en un point donn. En spcifiant la fois y 0 et x 0, on peut forcer la droite de rgression passer par un point fixe. moins que les arguments y 0 et x 0 ne soient tous deux prciss, la fonction requiert au moins deux paires de donnes valides pour tre calcule. Si y 0 et x 0 sont dfinies, une seule paire de donnes suffira.

Exemple:
Load Cl, linest_f(Y,X) as Z from abc.csv group by Cl;

linest_ssreg (expression-y, expression-x [, y0 [, x0 ]])


Renvoie la somme rgressive agrge des carrs d'une rgression linaire dfinie par l'quation y=mx+b pour une srie de coordonnes reprsentes par des nombres apparis dans expression-x et expression-y, rptes sur un certain nombre d'enregistrements dfinis par une clause group by. Les caractres, les valeurs nulles et les valeurs absentes dans n'importe lequel des deux paramtres ne sont pas autoriss. On peut spcifier une valeur y 0 facultative qui force la droite de rgression passer par l'axe des ordonnes (y) en un point donn. En spcifiant la fois y 0 et x 0, on peut forcer la droite de rgression passer par un point fixe. moins que les arguments y 0 et x 0 ne soient tous deux prciss, la fonction requiert au moins deux paires de donnes valides pour tre calcule. Si y 0 et x 0 sont dfinies, une seule paire de donnes suffira.

Exemple:
Load Cl, linest_ssreg(Y,X) as Z from abc.csv group by Cl;

linest_ssresid (expression-y, expression-x [, y0 [, x0 ]])


Renvoie la somme rsiduelle agrge des carrs d'une rgression linaire dfinie par l'quation y=mx+b pour une srie de coordonnes reprsentes par des nombres apparis dans expression-x et expression-y, rptes sur un certain nombre d'enregistrements dfinis par une clause group by. Les caractres, les valeurs nulles et les valeurs absentes dans n'importe lequel des deux paramtres ne sont pas autoriss. On peut spcifier une valeur y 0 facultative qui force la droite de rgression passer par l'axe des ordonnes (y) en un point donn. En spcifiant la fois y 0 et x 0, on peut forcer la droite de rgression passer par un point fixe. moins que les arguments y 0 et x 0 ne soient tous deux prciss, la fonction requiert au moins deux paires de donnes valides pour tre calcule. Si y 0 et x 0 sont dfinies, une seule paire de donnes suffira.

Exemple:
Load Cl, linest_ssresid(Y,X) as Z from abc.csv group by Cl;

318

Fonctions d'agrgation de la catgorie Financier dans le script


irr(expression)
Renvoie le taux interne de rendement agrg pour une srie de marges brutes d'autofinancement reprsentes par les valeurs de l'expression ritre par la clause Group By. Ces flux de liquidits n'ont pas tre gaux, comme ils le seraient pour une annuit. Cependant, les flux de liquidits doivent intervenir intervalles rguliers, mensuellement ou annuellement, par exemple. Le taux interne de rendement est le taux d'intrt peru pour un investissement consistant en des paiements (valeurs ngatives) et un revenu (valeurs positives) qui interviennent intervalles rguliers. La fonction ncessite au moins une valeur positive et une valeur ngative calculer. Les caractres, les valeurs nulles et les valeurs absentes ne sont pas autoriss.

Exemple:
Load Annee, irr(Paiements) as ITaux from abc.csv group by Annee;

xirr (valeur, date )


renvoie le taux interne de rendement agrg pour un calendrier de flux de liquidits (pas ncessairement priodique) reprsent par des paires de nombres, paramtres valeur et date, ritres par une clause Group By. Tous les paiements sont actualiss sur une base de 365jours par an. Les caractres, les valeurs nulles et les valeurs absentes dans n'importe lequel des deux paramtres ne sont pas autoriss.

Exemple:
Load Annee, xirr(Paiements, DatesPaiements) as Itaux from abc.csv group by Annee;

npv (taux, expression)


Renvoie la valeur nette agrge d'un investissement bas sur un taux d'escompte et des sries de futurs paiements (valeurs ngatives) ou de revenus (valeurs positives) reprsents par les nombres dans l'expression par rapport la clause Group By. Le rsultat est au format montaire par dfaut. Le taux est le taux d'intrt par priode. On suppose que les paiements et les revenus se produisent la fin de chaque priode. Les caractres, les valeurs nulles et les valeurs absentes ne sont pas autoriss.

Exemple:
Load Annee, npv(0.05, Paiements) as PValeur from abc.csv group by Annee;

xnpv (taux, valeur, date)


renvoie la valeur actuelle nette agrge pour un calendrier de flux de liquidits (pas ncessairement priodique) reprsent par des paires de nombres, paramtres valeur et date, ritres sur un certain nombre d'enregistrements conformment une clause Group By. Le taux correspond au taux d'intrt par priode. Le rsultat est au format montaire par dfaut. Tous les paiements sont actualiss sur une base de 365jours par an. Les caractres, les valeurs nulles et les valeurs absentes dans n'importe lequel des deux paramtres ne sont pas autoriss.

Exemple:
Load Annee, npv(0.05, Paiements, DatesPaiements) as PValeur from abc.csv group by Annee;

319

Fonctions statistiques de test dans les scripts


Les trois fonctions suivantes s'appliquent aux tests chi2

chi2test_p (col, ligne, valeur_observe [, valeur_attendue])


Renvoie la valeur p agrge (signification) pour une ou deux sries de valeurs itres sur un nombre d'enregistrements dfinis par une clause group by. Le test peut rechercher les variations dans la matrice spcifie par col et row pour les valeurs de valeur_observe ou comparer les valeurs de valeur_observe avec les valeurs correspondantes de valeurs_attendues. Les valeurs textes, les valeurs nulles et les valeurs manquantes dans l'expression renverront comme rsultat de la fonction la valeur nulle.

Exemple:
Load Anne, chi2test_p(Genre,Description,Observes,Attendues) as X from abc.csv group by Anne;

chi2test_df (col, ligne, valeur_observe [, valeur_attendue])


Renvoie la valeur agrge de chi2test_df (degrs de libert) pour une ou deux sries des valeurs itres audessus d'un certain nombre d'enregistrements dfinis par la clause group by. Pour une description des arguments, voir la fonction chi2test_p (col, ligne, valeur_observe [, valeur_attendue]) (page 320).

Exemple:
Load Anne, chi2test_df(Genre,Description,Observes,Attendues) as X from abc.csv group by Anne;

chi2test_chi2 (col, ligne, valeur_observe [, valeur_attendue])


Renvoie la valeur agrge de chi2-test pour une ou deux sries des valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par la clause group by. Pour une description des arguments, voir la fonction chi2test_p (col, ligne, valeur_observe [, valeur_attendue]) (page 320).

Exemple:
Load Anne, chi2test_chi2(Genre,Description,Observes,Attendues) as X from abc.csv group by Anne;
Les huit fonctions suivantes s'appliquent deux chantillons indpendants des test t de student.

TTest_t (groupe, valeur [, variance_gale = true])


Renvoie la valeur agrge de t pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Les valeurs doivent tre renvoyes par valeur et regroupes logiquement par exactement deux valeurs dans groupe. Si variance_gale est spcifie comme false, des variances distinctes pour les deux chantillons seront utilises, sinon deux variances de mme valeur seront utilises. Si valeur contient des valeurs textuelles, des valeurs nulles ou des valeurs manquantes, la fonction renverra NULL.

Exemple:
Load Anne, ttest_t(Groupe, Valeur) as X from abc.csv group by Anne;

TTest_df (groupe, valeur [, variance_gale = true])


Renvoie le nombre de degrs de libert agrgs du test t de Student pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction TTest_t (groupe, valeur [, variance_gale = true]) (page 320).

Exemple:
Load Anne, ttest_df(Groupe, Valeur) as X from abc.csv group by Anne;

TTest_sig (groupe, valeur [, variance_gale = true])

320

Renvoie le niveau de signification bilatral du test t de Student pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction TTest_t (groupe, valeur [, variance_gale = true]) (page 320).

Exemple:
Load Anne, ttest_sig(Groupe, Valeur) as X from abc.csv group by Anne;

TTest_dif (groupe, valeur [, variance_gale = true])


Renvoie la diffrence moyenne agrge du test t de Student pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction TTest_t (groupe, valeur [, variance_gale = true]) (page 320).

Exemple:
Load Anne, ttest_dif(Groupe, Valeur) as X from abc.csv group by Anne;

TTest_sterr (groupe, valeur [, variance_gale = true])


Renvoie l'erreur standard de la diffrence moyenne agrge du test t de Student pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction TTest_t (groupe, valeur [, variance_gale = true]) (page 320).

Exemple:
Load Anne, ttest_sterr(Groupe, Valeur) as X from abc.csv group by Anne;

TTest_conf (groupe, valeur [, sig = 0.025 [, variance_gale = true]])


Renvoie la valeur agrge de t pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Le niveau de signification bilatral peut tre spcifi dans sig. Si sig n'est pas spcifi, il prendra la valeur 0.025, donnant un intervalle de confiance de 95%. Pour une description des autres arguments, voir la fonction TTest_t (groupe, valeur [, variance_gale = true]) (page 320).

Exemple:
Load Anne, ttest_conf(Groupe, Valeur) as X from abc.csv group by Anne;

TTest_lower (groupe, valeur [, sig = 0.025 [, variance_gale = true]])


Renvoie la valeur agrge de la borne infrieure de l'intervalle de confiance pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir les fonctions TTest_t (groupe, valeur [, variance_gale = true]) (page 320) et TTest_conf (groupe, valeur [, sig = 0.025 [, variance_gale = true]]) (page 321).

Exemple:
Load Anne, ttest_lower(Groupe, Valeur) as X from abc.csv group by Anne;

TTest_upper (groupe, valeur [, sig = 0.025 [, variance_gale = true]])


Renvoie la valeur agrge de la borne suprieure de l'intervalle de confiance pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une

321

description des arguments, voir les fonctions TTest_t (groupe, valeur [, variance_gale = true]) (page 320) et TTest_conf (groupe, valeur [, sig = 0.025 [, variance_gale = true]]) (page 321).

Exemple:
Load Anne, ttest_upper(Groupe, Valeur) as X from abc.csv group by Anne;
Les huit fonctions suivantes s'appliquent indpendamment aux chantillons des tests t de student o les sries de donnes en entre sont donnes en format bi-colonnes pondr.

TTestw_t (coefficient, groupe, valeur [, variance_gale = true])


Renvoie la valeur agrge de t pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Les valeurs doivent tre renvoyes par valeur et regroupes logiquement par exactement deux valeurs dans groupe. Chaque valeur de l'argument valeur peut tre compte une ou plusieurs fois selon la valeur de l'argument coefficient correspondant. Si variance_gale est spcifie comme false, des variances distinctes pour les deux chantillons seront utilises, sinon deux variances de mme valeur seront utilises. Si valeur contient des valeurs textuelles, des valeurs nulles ou des valeurs manquantes, la fonction renverra NULL.

Exemple:
Load Anne, ttestw_t(Coefficient, Groupe, Valeur) as X from abc.csv group by Anne;

TTestw_df (coefficient, groupe, valeur [, variance gale = true])


Renvoie le nombre de degrs de libert agrgs du test t de Student pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction TTestw_t (coefficient, groupe, valeur [, variance_gale = true]) (page 322).

Exemple:
Load Anne, ttestw_df(Coefficient, Groupe, Valeur) as X from abc.csv group by Anne;

TTestw_sig (coefficient, groupe, valeur [, variance_gale = true])


Renvoie le niveau de signification bilatral du test t de Student pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction TTestw_t (coefficient, groupe, valeur [, variance_gale = true]) (page 322).

Exemple:
Load Anne, ttestw_sig(Coefficient, Groupe, Valeur) as X from abc.csv group by Anne;

TTestw_dif (coefficient, groupe, valeur [, variance_gale = true])


Renvoie la diffrence moyenne agrge du test t de Student pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction TTestw_t (coefficient, groupe, valeur [, variance_gale = true]) (page 322).

Exemple:
Load Anne, ttestw_dif(Coefficient, Groupe, Valeur) as X from abc.csv group by Anne;

TTestw_sterr (coefficient, groupe, valeur [, variance_gale = true])


Renvoie l'erreur standard de la diffrence moyenne agrge du test t de Student pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause

322

group by. Pour une description des arguments, voir la fonction TTestw_t (coefficient, groupe, valeur [, variance_gale = true]) (page 322).

Exemple:
Load Anne, ttestw_sterr(Coefficient, Groupe, Valeur) as X from abc.csv group by Anne;

TTestw_conf (coefficient, groupe, valeur [, sig = 0.025 [, eq_var = true]])


Renvoie la valeur agrge de t pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Le niveau de signification bilatral peut tre spcifi dans sig. Si sig n'est pas spcifi, il prendra la valeur 0.025, donnant un intervalle de confiance de 95%. Pour une description des autres arguments, voir la fonction TTestw_t (coefficient, groupe, valeur [, variance_gale = true]) (page 322).

Exemple:
Load Anne, ttestw_conf(Coefficient, Groupe, Valeur) as X from abc.csv group by Anne;

TTestw_lower (coefficient, groupe, valeur [, sig = 0.025 [, variance_gale = true]])


Renvoie la valeur agrge de la borne infrieure de l'intervalle de confiance pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir les fonctions TTestw_t (coefficient, groupe, valeur [, variance_gale = true]) (page 322) et TTest1w_conf (coefficient, valeur [, sig = 0.025 ]) (page 325).

Exemple:
Load Anne, ttestw_lower(Coefficient, Groupe, Valeur) as X from abc.csv group by Anne;

TTestw_upper (coefficient, groupe, valeur [, sig = 0.025 [, variance_gale = true]])


Renvoie la valeur agrge de la borne suprieure de l'intervalle de confiance pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir les fonctions TTestw_t (coefficient, groupe, valeur [, variance_gale = true]) (page 322) et TTest1w_conf (coefficient, valeur [, sig = 0.025 ]) (page 325).

Exemple:
Load Anne, ttestw_upper(Coefficient, Groupe, Valeur) as X from abc.csv group by Anne;
Les huit fonctions suivantes s'appliquent un seul chantillon du test t de Student.

TTest1_t (valeur)
renvoie la valeur t agrge pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Les valeurs doivent tre renvoyes par valeur. Si valeur contient des valeurs textuelles, des valeurs nulles ou des valeurs manquantes, la fonction renverra NULL.

Exemple:
Load Anne, ttest1_t(Valeur) as X from abc.csv group by Anne;

TTest1_df (valeur)

323

Renvoie le nombre de degrs de libert agrgs du test t de Student pour une srie de valeurs itre audessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction TTest1_t (valeur) (page 323).

Exemple:
Load Anne, ttest1_dt(Valeur) as X from abc.csv group by Anne;

TTest1_sig (valeur)
Renvoie le niveau de signification bilatral du test t de Student pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction TTest1_t (valeur) (page 323).

Exemple:
Load Anne, ttest1_sig(Valeur) as X from abc.csv group by Anne;

TTest1_dif (valeur)
Renvoie la diffrence moyenne agrge du test t de Student pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction TTest1_t (valeur) (page 323).

Exemple:
Load Anne, ttest1_dif(Valeur) as X from abc.csv group by Anne;

TTest1_sterr (valeur)
Renvoie l'erreur standard de la diffrence moyenne agrge du test t de Student pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction TTest1_t (valeur) (page 323).

Exemple:
Load Anne, ttest1_sterr(Valeur) as X from abc.csv group by Anne;

TTest1_conf (valeur [, sig = 0.025 ])


renvoie la valeur t agrge pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Le niveau de signification bilatral peut tre spcifi dans sig. Si sig n'est pas spcifi, il prendra la valeur 0.025, donnant un intervalle de confiance de 95%. Pour une description des autres arguments, voir la fonction TTest1_t (valeur) (page 323).

Exemple:
Load Anne, ttest1_conf(Valeur) as X from abc.csv group by Anne;

TTest1_lower (valeur [, sig = 0.025 ])


Renvoie la valeur agrge de la borne infrieure de l'intervalle de confiance pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir les fonctions TTest1_t (valeur) (page 323) et TTest1_conf (valeur [, sig = 0.025 ]) (page 324).

Exemple:
Load Anne, ttest1_lower(Valeur) as X from abc.csv group by Anne;

TTest1_upper (valeur [, sig = 0.025 ])


Renvoie la valeur agrge de la borne suprieure de l'intervalle de confiance pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir les fonctions TTest1_t (valeur) (page 323) et TTest1_conf (valeur [, sig = 0.025 ]) (page 324).

324

Exemple:
Load Anne, ttest1_upper(Valeur) as X from abc.csv group by Anne;
Les huit fonctions suivantes s'appliquent un seul chantillon des tests t de Student, o la srie de donnes en entre est donne en format bi-colonne pondr.

TTest1w_t (coefficient, valeur)


renvoie la valeur t agrge pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Les valeurs doivent tre renvoyes par valeur. Chaque valeur de l'argument valeur peut tre compt une ou plusieurs fois selon la valeur de l'argument coefficient correspondant. Si valeur contient des valeurs textuelles, des valeurs nulles ou des valeurs manquantes, la fonction renverra NULL.

Exemple:
Load Anne, ttest1w_t(Coefficient, Valeur) as X from abc.csv group by Anne;

TTest1w_df (coefficient, valeur)


Renvoie le nombre de degrs de libert agrgs du test t de Student pour une srie de valeurs itre audessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction TTest1w_t (coefficient, valeur) (page 325).

Exemple:
Load Anne, ttest1w_df(Coefficient, Valeur) as X from abc.csv group by Anne;

TTest1w_sig (coefficient, valeur)


Renvoie le niveau de signification bilatral du test t de Student pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction TTest1w_t (coefficient, valeur) (page 325).

Exemple:
Load Anne, ttest1w_sig(Coefficient, Valeur) as X from abc.csv group by Anne;

TTest1w_dif (coefficient, valeur)


Renvoie la diffrence moyenne agrge du test t de Student pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction TTest1w_t (coefficient, valeur) (page 325).

Exemple:
Load Anne, ttest1w_dif(Coefficient, Valeur) as X from abc.csv group by Anne;

TTest1w_sterr (coefficient, valeur)


Renvoie l'erreur standard de la diffrence moyenne agrge du test t de Student pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction TTest1w_t (coefficient, valeur) (page 325).

Exemple:
Load Anne, ttest1w_sterr(Coefficient, Valeur) as X from abc.csv group by Anne;

TTest1w_conf (coefficient, valeur [, sig = 0.025 ])

325

renvoie la valeur t agrge pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Le niveau de signification bilatral peut tre spcifi dans sig. Si sig n'est pas spcifi, il prendra la valeur 0.025, donnant un intervalle de confiance de 95%. Pour une description des autres arguments, voir la fonction TTest1w_t (coefficient, valeur) (page 325).

Exemple:
Load Anne, ttest1w_conf(Coefficient, Valeur) as X from abc.csv group by Anne;

TTest1w_lower (coefficient, valeur [, sig = 0.025 ])


Renvoie la valeur agrge de la borne infrieure de l'intervalle de confiance pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir les fonctions TTest1w_t (coefficient, valeur) (page 325) et TTest1w_conf (coefficient, valeur [, sig = 0.025 ]) (page 325).

Exemple:
Load Anne, ttest1w_lower(Coefficient, Valeur) as X from abc.csv group by Anne;

TTest1w_upper (coefficient, valeur [, sig = 0.025 ])


Renvoie la valeur agrge de la borne suprieure de l'intervalle de confiance pour deux sries indpendantes de valeurs itres au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir les fonctions TTest1w_t (coefficient, valeur) (page 325) et TTest1w_conf (coefficient, valeur [, sig = 0.025 ]) (page 325).

Exemple:
Load Anne, ttest1w_upper(Coefficient, Valeur) as X from abc.csv group by Anne;
Les cinq fonctions suivantes s'appliquent aux test Z.

ZTest_z (valeur [, sigma])


renvoie la valeur Z agrge pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Les valeurs doivent tre renvoyes par valeur. Une population moyenne de 0 est possible. Si vous voulez que le test soit effectu sur une autre moyenne, il faut soustraire la valeur de la valeur exemple. S'il est connu, l'cart type standard peut tre dfini dans sigma. Si sigma est omis, l'exemple standard actuel sera utilis. Si valeur contient des valeurs textuelles, des valeurs nulles ou des valeurs manquantes, la fonction renverra NULL.

Exemple:
Load Anne, ztest_z(Valeur-Valeur test) as X from abc.csv group by Anne;

ZTest_sig (valeur [, sigma])


Renvoie le niveau de signification bilatral du test Z pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction ZTest_z (valeur [, sigma]) (page 326). renvoyant NULL.

Exemple:
Load Anne, ztest_sig(Valeur-Valeur test) as X from abc.csv group by Anne;

ZTest_dif (valeur [, sigma])

326

Renvoie la diffrence moyenne agrge du test Z pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction ZTest_z (valeur [, sigma]) (page 326). renvoyant NULL.

Exemple:
Load Anne, ztest_dif(Valeur-Valeur test) as X from abc.csv group by Anne;

ZTest_sterr (valeur [, sigma])


Renvoie l'erreur standard de la diffrence moyenne agrge du test Z pour une srie de valeurs itre audessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction ZTest_z (valeur [, sigma]) (page 326). renvoyant NULL.

Exemple:
Load Anne, ztest_sterr(Valeur-Valeur test) as X from abc.csv group by Anne;

ZTest_conf (valeur [, sigma [, sig = 0.025 ])


renvoie la valeur Z agrge pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Le niveau de signification bilatral peut tre spcifi dans sig. Si sig n'est pas spcifi, il prendra la valeur 0.025, donnant un intervalle de confiance de 95%. Pour une description des autres arguments, voir la fonction ZTest_z (valeur [, sigma]) (page 326). renvoyant NULL.

Exemple:
Load Anne, ztest_conf(Valeur-Valeur test) as X from abc.csv group by Anne;
Les cinq fonctions suivantes s'appliquent aux test Z o la srie de donnes en entre est donne en format bicolonne pondr.

ZTestw_z (coefficient, valeur [, sigma])


renvoie la valeur Z agrge pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Les valeurs doivent tre renvoyes par valeur. La fonction utilise une moyenne d'chantillon de 0. Si le test doit tre effectu sur une autre moyenne, il faut soustraire la valeur de la valeur exemple. Chaque valeur de l'argument valeur peut tre compt une ou plusieurs fois selon la valeur de l'argument coefficient correspondant. S'il est connu, l'cart type standard peut tre dfini dans sigma. Si sigma est omis, l'exemple standard actuel sera utilis. Si valeur contient des valeurs textuelles, des valeurs nulles ou des valeurs manquantes, la fonction renverra NULL.

Exemple:
Load Anne, ztestw_z(Valeur-Valeur test) as X from abc.csv group by Anne;

ZTestw_sig (coefficient, valeur [, sigma])


Renvoie le niveau de signification bilatral du test Z pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction ZTestw_z (coefficient, valeur [, sigma]) (page 327).

Exemple:
Load Anne, ztestw_sig(Valeur-Valeur test) as X from abc.csv group by Anne;

ZTestw_dif (coefficient, valeur [, sigma])

327

Renvoie la diffrence moyenne agrge du test Z pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction ZTestw_z (coefficient, valeur [, sigma]) (page 327).

Exemple:
Load Anne, ztestw_dif(Valeur-Valeur test) as X from abc.csv group by Anne;

ZTestw_sterr (coefficient, valeur [, sigma])


Renvoie l'erreur standard de la diffrence moyenne agrge du test Z pour une srie de valeurs itre audessus d'un certain nombre d'enregistrements dfinis par une clause group by. Pour une description des arguments, voir la fonction ZTestw_z (coefficient, valeur [, sigma]) (page 327).

Exemple:
Load Anne, ztestw_sterr(Valeur-Valeur test) as X from abc.csv group by Anne;

ZTestw_conf (coefficient, valeur [, sigma [, sig = 0.025 ]])


renvoie la valeur Z agrge pour une srie de valeurs itre au-dessus d'un certain nombre d'enregistrements dfinis par une clause group by. Le niveau de signification bilatral peut tre spcifi dans sig. Si sig n'est pas spcifi, il prendra la valeur 0.025, donnant un intervalle de confiance de 95%. Pour une description des autres arguments, voir la fonction ZTestw_z (coefficient, valeur [, sigma]) (page 327).

Exemple:
Load Anne, ztestw_conf(Valeur-Valeur test) as X from abc.csv group by Anne; Fonctions statistiques de test dans les scripts (page 320)

25.3 Autres fonctions


Les expressions de graphique QlikView prennent en charge prs de cent fonctions standard, en plus des fonctions d'agrgation dcrites ci-dessus. Certaines des fonctions ci-dessous sont identiques pour les scripts. Pour plus de dtails, voir section Script. Elles ont t rparties dans les groupes suivants :

Fonctions de la catgorie Numrique gnral du graphique Fonctions de la catgorie Plage du graphique Fonctions de la catgorie Exponentiel et logarithmique Fonctions de la catgorie Trigonomtrique et hyperbolique Fonctions statistiques de distribution Fonctions de la catgorie Financier Constantes mathmatiques et fonctions sans paramtres Fonctions de la catgorie Chane

page 889 page 894 page 338 page 339 page 340 page 342 page 344 page 347

Fonctions de la catgorie Inter-enregistrements du graphique page 900 Fonctions de document page 364

328

Fonctions de la catgorie Classement du graphique Fonctions de la catgorie Conditionnel Fonctions de la catgorie Logique Fonctions de la catgorie NULL Fonctions de la catgorie Systme Fonctions de la catgorie Date et heure Fonctions de la catgorie Interprtation des nombres Fonctions de la catgorie Formatage Fonctions de la catgorie Couleur

page 908 page 354 page 356 page 356 page 356 page 365 page 912 page 384 page 389

Fonctions de la catgorie Numrique gnral


Dans les fonctions ci-dessous, les paramtres sont des expressions o x doit tre interprt comme un nombre rel.

div(x1 , x2)
Division entire. Les deux paramtres sont interprts comme des nombres rels, c'est--dire que ce ne sont pas ncessairement des entiers. Le rsultat est la partie entire du rsultat de la division arithmtique, nombre rel.

Exemples:
div( 7,2 ) renvoie 3 div( 9,3 ) renvoie 3 div( -4,3 ) renvoie -1 div( 4,-3 ) renvoie -1 div( -4,-3 ) renvoie 1

mod(x1 , x2)
Fonction modulo mathmatique. Les deux paramtres doivent comporter des valeurs entires. x2 doit tre suprieur 0. Le rsultat est le reste positif d'une division entire.

Exemples:
mod( 7,2 ) renvoie 1 mod( 7.5,2 ) renvoie NULL mod( 9,3 ) renvoie 0 mod( -4,3 ) renvoie 2 mod( 4,-3 ) renvoie NULL mod( -4,-3 ) renvoie NULL

fmod(x1 , x2)

329

Fonction modulo gnralise. Les deux paramtres sont interprts comme des nombres rels, c'est--dire que ce ne sont pas ncessairement des entiers. Le rsultat est le reste d'une division entire, nombre rel.

Exemples:
fmod( 7,2 ) renvoie 1 fmod( 7.5,2 ) renvoie 1,5 fmod( 9,3 ) renvoie 0 fmod( -4,3 ) renvoie -1 fmod( 4,-3 ) renvoie 1 fmod( -4,-3 ) renvoie -1

ceil(x [ , base [ , offset ]])


Arrondi de x au multiple suprieur de la base le plus proche avec une compensation dfinie par offset. Le rsultat est un nombre.

Exemples:
ceil( 2.4 ) renvoie 3 ceil( 2.6 ) renvoie 3 ceil( 3.88 , 0,1 ) renvoie 3,9 ceil( 3.88 , 5 ) renvoie 5 ceil( 1.1 , 1 , 0.5 ) renvoie 1,5

floor(x [ , base [ , offset ]])


Arrondi de x au multiple infrieur de la base le plus proche avec une compensation dfinie par offset. Le rsultat est un nombre.

Exemples:
floor( 2.4 ) renvoie 2 floor( 2.6 ) renvoie 2 floor( 3.88 , 0,1 ) renvoie 3,8 floor( 3.88 , 5 ) renvoie 0 floor( 1.1 , 1 , 0.5 ) renvoie 0,5

frac(x)
Renvoie la partie fractionnelle de x. La fraction est dfinie de telle faon que frac(x) + floor(x ) = x.

Exemples:
frac( 11.43 ) renvoie 0,43 frac( -1.4 ) renvoie 0,6

round(x [ , step [ , offset ]])


Arrondi de x +/- n crans avec une compensation dfinie par offset. Le rsultat est un nombre. Si x est exactement au milieu de l'intervalle, il est arrondi au multiple suprieur. La fonction est conforme la norme IEEE des nombres virgule flottante en 64bits.

Exemples:
round( 2.4 ) renvoie 2

330

round( 2.6 ) renvoie 3 round( 2.5 ) renvoie 3 round( 3.88 , 0,1 ) renvoie 3,9 round( 3.88 , 5 ) renvoie 5 round( 1.1 , 1 , 0.5 ) renvoie 1,5

fabs(x)
Valeur absolue de x. Le rsultat est un nombre positif.

Exemples:
fabs( 2.4 ) renvoie 2,4 fabs( -3.8 ) renvoie 3,8

numsum(expr1 [ , expr2, ... exprN ])


Renvoie la somme arithmtique de 1 N arguments. Contrairement l'oprateur +, numsum traite toutes les valeurs non numriques comme des 0.

Exemples:
numsum( 1,2,4 ) renvoie 7 numsum( 1,'xyz' ) renvoie 1 numsum( null( ) ) renvoie 0 Remarque: La fonction numsum est maintenant obsolte et est remplace par la fonction rangesum(expr1 [ , expr2, ... exprN ]) (page 334).

numcount(expr1 [ , expr2, ... exprN ])


Renvoie le nombre de valeurs numriques trouves dans 1 N arguments

Exemples:
numcount( 1,2,4, ) renvoie 3 numcount( 2,xyz ) renvoie 1 numcount( null( ) ) renvoie 0 Remarque: La fonction numcount est maintenant obsolte et est remplace par la fonction rangecount(expr1 [ , expr2, ... exprN ]) (page 334).

numavg(expr1 [ , expr2, ... exprN ])


Renvoie la moyenne arithmtique de 1 N arguments. Si aucune valeur numrique n'est trouve, la fonction renvoie NULL.

Exemples:
numavg( 1,2,4 ) renvoie 2,33333333 numavg( 1,'xyz' ) renvoie 1 numavg( null( ) 'abc' ) renvoie NULL

331

Remarque: La fonction numavg est maintenant obsolte et est remplace par la fonction rangeavg(expr1 [ , expr2, ... exprN ]) (page 334).

nummin(expr1 [ , expr2, ... exprN ])


Renvoie la valeur numrique la plus faible de 1 N arguments. Si aucune valeur numrique n'est trouve, la fonction renvoie NULL.

Exemples:
nummin( 1,2,4 ) renvoie 1 nummin( 1,'xyz' ) renvoie 1 nummin( null( ) 'abc' ) renvoie NULL Remarque: La fonction nummin est maintenant obsolte et est remplace par la fonction rangemin(expr1 [ , expr2, ... exprN ]) (page 334).

nummax(expr1 [ , expr2, ... exprN ])


Renvoie la valeur numrique la plus leve de 1 N arguments. Si aucune valeur numrique n'est trouve, la fonction renvoie NULL.

Exemples:
nummax( 1,2,4 ) renvoie 4 nummax( 1,'xyz' ) renvoie 1 nummax( null( ) 'abc' ) renvoie NULL Remarque: La fonction nummax est maintenant obsolte et est remplace par la fonction rangemax(expr1 [ , expr2, ... exprN ]) (page 334).

fact(n)
Renvoie la factorielle d'un entier positif n. Si le nombre n n'est pas un entier, il sera tronqu. Les nombres ngatifs renverront NULL.

Exemples:
fact( 1 ) renvoie 1 fact( 5 ) renvoie 120 ( 1 * 2 * 3 * 4 * 5 = 120 ) fact( -5 ) renvoie NULL

combin(n1, n2)
Renvoie le nombre de combinaisons de n2 lments qui peuvent tre tires d'un groupe d'lments n1. L'ordre dans lequel les lments sont slectionns n'a pas d'importance. Les lments non entiers seront tronqus.

Exemple:
Combien de combinaisons de 7nombres peuvent tre tires d'un total de 35numros de loto?

combin( 35,7 ) renvoie 6 724 520

332

permut(n1, n2)
Renvoie le nombre de permutations de n2 lments qui peuvent tre slectionnes dans un groupe d'lments n1. L'ordre dans lequel les lments sont slectionns a de l'importance. Les arguments non entiers seront tronqus.

Exemple:
De combien de faon les mdailles d'or, d'argent et de bronze pourraient-elles tre distribues aprs une finale du 100m avec 8 participants?

permut( 8,3 ) renvoie 336

even(n)
Renvoie vrai si n est un entier pair, faux si n est un entier impair et NULL si n n'est pas un entier.

Exemples:
even( 3 ) renvoie faux even( 2 * 10 ) renvoie vrai even( 3.14 ) renvoie NULL

odd(n)
Renvoie vrai si n est un entier impair, faux si n est un entier pair et NULL si n n'est pas un entier.

Exemples:
odd( 3 ) renvoie vrai odd( 2 * 10 ) renvoie faux odd( 3.14 ) renvoie NULL

sign(x)
Renvoie1, 0 ou-1 selon que x est un nombre positif, 0 ou un nombre ngatif. Si aucune valeur numrique n'est trouve, la fonction renvoie NULL.

Exemples:
sign( 66 ) renvoie 1 sign( 0 ) renvoie 0 sign( - 234 ) renvoie -1

bitcount(i)
Renvoie le nombre de bits dans i. O i est interprt comme un entier 64bits sign, mme si seuls les 48premiers bits importent. Une valeur suprieure 48bits renverra NULL.

Exemples:
bitcount ( 3 ) renvoie 2 bitcount( 100 ) renvoie 3 bitcount( -1 ) renvoie 32 bitcount( n )+bitcount(bitnot n ) renvoie 64 ( condition que n soit un entier valide).
Retour Other Functions.

333

Fonctions de plage du script


Les fonctions de plage remplacent les Fonctions de la catgorie Numrique gnral (page 329) suivantes: numsum, numavg, numcount, nummin et nummax, qui doivent maintenant tre considres comme obsoltes.

rangesum(expr1 [ , expr2, ... exprN ])


Renvoie la somme d'une plage de 1 N arguments. Contrairement l'oprateur +, rangesum traite toutes les valeurs non numriques comme des 0.

Exemples:
rangesum (1,2,4) renvoie 7 rangesum (1,'xyz') renvoie 1 rangesum (null( )) renvoie 0

rangeavg(expr1 [ , expr2, ... exprN ])


Renvoie la moyenne d'une plage de 1 N arguments. Si aucune valeur numrique n'est trouve, la fonction renvoie NULL.

Exemples:
rangeavg (1,2,4) renvoie 2.33333333 rangeavg (1,'xyz') renvoie 1 rangeavg (null( ), 'abc') renvoie NULL

rangecount(expr1 [ , expr2, ... exprN ])


Renvoie le nombre de valeurs trouves dans une plage de 1 N arguments. Les valeurs NULL ne sont pas comptes.

Exemples:
rangecount (1,2,4) renvoie 3 rangecount (2,'xyz') renvoie 2 rangecount (null( )) renvoie 0

rangemin(expr1 [ , expr2, ... exprN ])


Renvoie la valeur numrique la plus faible dans une plage de 1 N arguments. Si aucune valeur numrique n'est trouve, la fonction renvoie NULL.

Exemples:
rangemin (1,2,4) renvoie 1 rangemin (1,'xyz') renvoie 1 rangemin (null( ), 'abc') renvoie NULL

rangemax(expr1 [ , expr2, ... exprN ])


Renvoie les valeurs numriques les plus leves trouves dans une plage de 1 N arguments. Si aucune valeur numrique n'est trouve, la fonction renvoie NULL.

Exemples:
rangemax (1,2,4) renvoie 4

334

rangemax (1,'xyz') renvoie 1 rangemax (null( ), 'abc') renvoie NULL

rangestdev(expr1 [ , expr2, ... exprN ] )


Renvoie l'cart type d'une plage de 1 N arguments. Si aucune valeur numrique n'est trouve, la fonction renvoie NULL.

Exemples:
rangestdev (1,2,4) renvoie 1.5275252316519 rangestdev (null( )) renvoie NULL

rangeskew(expr1 [ , expr2, ... exprN ])


Renvoie l'asymtrie d'une plage de 1 N arguments. Si aucune valeur numrique n'est trouve, la fonction renvoie NULL.

Exemples:
rangeskew (1,2,4) renvoie 0,93521952958283

rangekurtosis(expr1 [ , expr2, ... exprN ])


Renvoie l'aplatissement d'une plage de 1 N arguments. Si aucune valeur numrique n'est trouve, la fonction renvoie NULL.

Exemples:
rangekurtosis (1,2,4,7) renvoie -0,28571428571429

rangefractile(fractile, expr1 [ , expr2, ... exprN ])


Renvoie le fractile d'une plage de 1 N arguments.

Exemples:
rangefractile (0.24,1,2,4,6) renvoie 1 rangefractile (0.5,1,2,3,4,6) renvoie 3 rangefractile (0.5,1,2,5,6) renvoie 3,5

rangenumericcount(expr1 [ , expr2, ... exprN ])


Renvoie le nombre de valeurs numriques dans une plage de 1 N arguments.

Exemples:
rangenumericcount (1,2,4) renvoie 3 rangenumericcount (2,'xyz') renvoie 1 rangenumericcount (null( )) renvoie 0

rangetextcount(expr1 [ , expr2, ... exprN ])


Renvoie le nombre de valeurs textuelles dans une plage de 1 N arguments.

Exemples:
rangetextcount (1,2,4) renvoie 0

335

rangetextcount (2,'xyz') renvoie 1 rangetextcount (null( )) renvoie 0

rangenullcount(expr1 [ , expr2, ... exprN ])


Renvoie le nombre de valeurs NULL dans une plage de 1 N arguments.

Exemples:
rangenullcount (1,2,4) renvoie 0 rangenullcount (2,'xyz') renvoie 0 rangenullcount (null( ),null( )) renvoie 2

rangemissingcount(expr1 [ , expr2, ... exprN ])


Renvoie le nombre de valeurs non numriques (y compris les valeurs NULL) trouves dans 1 N arguments.

Exemples:
rangemissingcount (1,2,4) renvoie 0 rangemissingcount (2,'xyz') renvoie 1 rangemissingcount (null( )) renvoie 1

rangeminstring(expr1 [ , expr2, ... exprN ])


Renvoie la premire valeur dans l'ordre de tri du texte trouve dans une plage de 1 N arguments.

Exemples:
rangeminstring (1,2,4) renvoie 1 rangeminstring ('xyz','abc') renvoie 'abc' rangeminstring (null( )) renvoie NULL

rangemaxstring(expr1 [ , expr2, ... exprN ])


Renvoie la dernire valeur dans l'ordre de tri du texte trouve dans une plage de 1 N arguments.

Exemples:
rangemaxstring (1,2,4) renvoie 4 rangemaxstring ('xyz','abc') renvoie 'xyz' rangemaxstring (null( )) renvoie NULL

rangemode(expr1 [ , expr2, ... exprN ])


Renvoie la valeur de mode, c'est--dire la valeur la plus frquente, dans une plage de 1 N arguments. Si deux valeurs ou plus prsentent la frquence la plus leve, le programme renvoie NULL.

Exemples:
rangemode (1,2,9,2,4) renvoie 2 rangemode ('a',4,'a',4) renvoie NULL rangemode (null()) renvoie NULL

rangeonly(expr1 [ , expr2, ... exprN ])

336

S'il existe exactement une valeur non NULL dans la plage de N expressions, cette valeur est renvoye. Dans tous les autres cas, la fonction renvoie NULL.

Exemples:
rangeonly (1,2,4) renvoie NULL rangeonly (1,'xyz') renvoie NULL rangeonly (null( ), 'abc') renvoie 'abc'

rangecorrel(valeur x , valeur y { , valeur x , valeur y})


Renvoie le coefficient de corrlation pour une srie de coordonnes. La valeur x et la valeur y sont des valeurs uniques. Chaque valeur y doit correspondre une valeur x. Cette fonction ncessite au moins deux paires de coordonnes pour tre calcule. Les caractres, les valeurs nulles et les valeurs absentes ne sont pas autoriss.

Exemples:
rangecorrel (2,3,6,8,9,4) renvoie 0,269

rangeirr(value { ,value} )
Renvoie le taux interne de retour pour une srie de flux de liquidits reprsents par les nombres des valeurs. Ces flux de liquidits n'ont pas tre gaux, comme ils le seraient pour une annuit. Cependant, les flux de liquidits doivent intervenir intervalles rguliers, mensuellement ou annuellement, par exemple. Le taux interne de retour est le taux d'intrt peru pour un investissement consistant en des paiements (valeurs ngatives) et un revenu (valeurs positives) qui interviennent intervalles rguliers.

Value correspond une seule valeur ou une plage de valeurs renvoyes par une Fonctions de la catgorie Inter-enregistrements du graphique (page 900) avec un troisime paramtre facultatif. La fonction ncessite au moins une valeur positive et une valeur ngative calculer. Les caractres, les valeurs nulles et les valeurs absentes ne sont pas autoriss.

Exemples:
rangeirr(-70000,12000,15000,18000,21000,26000) renvoie 0,0866 rangeirr(above(sum(value), 0, 10)) rangeirr(above(total value, 0, rowno(total)))

rangenpv (rate, value { ,value} )


Renvoie la valeur nette actuelle d'un investissement base sur un taux de remise (rate) et une srie de futurs paiements (valeurs ngatives) et de revenus (valeurs positives). Le rsultat est au format montaire par dfaut.

Rate est le taux d'intrt par priode. Value est un paiement ou revenu intervenant la fin de chaque priode. Chaque valeur peut correspondre une seule valeur ou une plage de valeurs renvoyes par une Fonctions de la catgorie Interenregistrements du graphique (page 900) avec un troisime paramtre facultatif. Les caractres, les valeurs nulles et les valeurs absentes ne sont pas autoriss.

Exemples:
rangenpv(0.1,-10000,3000,4200,6800) renvoie 1188,44 rangenpv(0.05, above(sum(value), 0, 10)) rangenpv(0.05, above(total value, 0, rowno(total)))

337

rangexirr(value, date { ,value, date} )


Renvoie le taux interne de retour pour un calendrier de flux de liquidits qui n'est pas ncessairement priodique. Pour calculer le taux interne de retour pour une srie de flux de liquidits priodiques, utilisez la fonction rangeirr(value { ,value} ) (page 337).

Value est un flux de liquidits ou une srie de flux de liquidits qui correspond un calendrier de paiements dates. Chaque valeur peut correspondre une seule valeur ou une plage de valeurs renvoyes par une Fonctions de la catgorie Inter-enregistrements du graphique (page 900) avec un troisime paramtre facultatif. Les caractres, les valeurs nulles et les valeurs absentes ne sont pas autoriss. Tous les paiements sont actualiss sur une base de 365jours par an. La srie de valeurs doit contenir au moins une valeur positive et une valeur ngative. Date est une date de paiement ou un calendrier de dates de paiements qui correspond aux paiements de flux de liquidits.

Exemples:
rangexirr(-2500,'2008-01-01',2750,'2008-09-01') renvoie 0,1532 rangexirr (above(sum(value), 0, 10), above(date, 0, 10)) rangexirr(above(total value,0,rowno(total)), above(total date,0,rowno(total)))

rangexnpv(rate, value, date { ,value, date} )


Renvoie la valeur nette actuelle pour un calendrier de flux de liquidits qui n'est pas ncessairement priodique. Le rsultat est au format montaire par dfaut. Pour calculer la valeur nette actuelle pour une srie de flux de liquidits priodiques, utilisez la fonction rangenpv (rate, value { ,value} ) (page 337).

Rate est le taux d'intrt par priode. Value est un flux de liquidits ou une srie de flux de liquidits qui correspond un calendrier de paiements dates. Chaque valeur peut correspondre une seule valeur ou une plage de valeurs renvoyes par une Fonctions de la catgorie Inter-enregistrements du graphique (page 900) avec un troisime paramtre facultatif. Les caractres, les valeurs nulles et les valeurs absentes ne sont pas autoriss. Tous les paiements sont actualiss sur une base de 365jours par an. La srie de valeurs doit contenir au moins une valeur positive et une valeur ngative. Date est une date de paiement ou un calendrier de dates de paiements qui correspond aux paiements de flux de liquidits.

Exemples:
rangexnpv(0.1, -2500,'2008-01-01',2750,'2008-09-01') renvoie 80,25 rangexnpv (0.1, above(sum(value), 0, 10), above(date, 0, 10)) rangexnpv(0.1, above(total value,0,rowno(total)), above(total date,0,rowno(total)))
Retour Other Functions.

Fonctions de la catgorie Exponentiel et logarithmique


Dans les fonctions ci-dessous, les paramtres sont des expressions o x doit tre interprt comme un nombre rel.

exp(x)
Fonction exponentielle utilisant le nombre e pour base. Le rsultat est un nombre positif.

338

log(x)
Logarithme nprien de x. La fonction est dfinie uniquement si x > 0. Le rsultat est un nombre.

log10(x)
Logarithme dcimal (base 10) de x. La fonction est dfinie uniquement si x > 0. Le rsultat est un nombre.

sqrt(x)
Racine carre de x. La fonction est dfinie uniquement si x >= 0. Le rsultat est un nombre positif.

sqr (x )
Carr de x. Le rsultat est un nombre.

pow(x,y)
Renvoie x la puissance y. Le rsultat est un nombre. Retour Other Functions.

Fonctions de la catgorie Trigonomtrique et hyperbolique


Dans les fonctions ci-dessous, les paramtres sont des expressions o x doit tre interprt comme un nombre rel. Tous les angles sont mesurs en radians.

cos( x)
Cosinus de x. Le rsultat est un nombre compris entre-1 et1.

acos(x)
Arc cosinus de x. La fonction est uniquement dfinie si -1 x1. Le rsultat est un nombre compris entre0 et p.

sin(x)
Sine de x. Le rsultat est un nombre compris entre-1 et1.

asin(x)
Arc sinus de x. La fonction est uniquement dfinie si -1 x1. Le rsultat est un nombre compris entre - p/2 et p/2.

tan( x)
Tangente de x. Le rsultat est un nombre.

atan(x)
Arc tangente de x. Le rsultat est un nombre compris entre - p/2 et p/2.

atan2( y,x)
Gnralisation bidimensionnelle de la fonction d'arc tangente. Renvoie l'angle entre l'origine et le point reprsent par les coordonnes x et y. Le rsultat est un nombre compris entre - p et + p.

cosh(x)

339

Cosinus hyperbolique de x. Le rsultat est un nombre positif.

sinh(x)
Sinus hyperbolique de x. Le rsultat est un nombre.

tanh(x)
Tangente hyperbolique de x. Le rsultat est un nombre. Retour Other Functions.

Fonctions statistiques de distribution


Les fonctions statistiques de distribution dcrites ci-dessous sont toutes implmentes dans QlikView suivant la bibliothque de Cephes. Pour obtenir des rfrences et des informations dtailles sur les algorithmes utiliss, la prcision, etc., consultez le site Web http://www.netlib.org/cephes/. La bibliothque de fonctions de Cephes est gre par permissions.

chidist (valeur, degrs de libert)


Renvoie la valeur de probabilit de la distribution chi2. La distribution Chi2 est associe au test Chi2. Valeur est la valeur laquelle vous souhaitez valuer la distribution. La valeur ne peut pas tre ngative. Degrs de libert correspond un entier positif indiquant le nombre de degrs de libert. Les deux arguments doivent tre numriques,sinon la fonction renverra la valeur nulle. Cette fonction est lie la fonction chiinv comme suit : If prob = chidist(valeur,df), then chiinv(prob, df) = valeur.

Exemple:
chidist( 8, 15 ) renvoie 0.9237827

chiinv (prob, degrs de libert)


renvoie l'inverse de of la probabilit de la distribution chi2. Prob est la probabilit associe la distribution Chi2. Elle doit correspondre une valeur comprise entre 0 et 1. Degrs de libert correspond un entier indiquant le nombre de degrs de libert. Les deux arguments doivent tre numriques,sinon la fonction renverra la valeur nulle. Cette fonction est lie la fonction chidist (valeur, degrs de libert) (page 340) de la manire suivante: If prob = chidist(valeur,df), then chiinv(prob, df) = valeur.

Exemple:
chiinv(0.9237827, 15 ) renvoie 8.0000001

normdist (valeur, moyenne, cart type)


renvoie la distribution normale cumulative pour la moyenne et l'cart type spcifis. Valeur est la valeur laquelle vous souhaitez valuer la distribution. Moyenne est la valeur moyenne arithmtique de la distribution. cart type est une valeur positive indiquant l'cart type de la distribution. Tous les arguments doivent tre numriques, sinon la fonction renverra la valeur nulle. Si moyenne = 0 et cart type = 1, la fonction renvoie la distribution normale standard. Cette fonction est lie la fonction norminv (prob, moyenne, cart type) (page 340) de la manire suivante: If prob = normdist(valeur, m, sd), then norminv(prob, m, sd) = valeur.

Exemple:
chdist( 0.5, 0, 1 ) renvoie 0.6914625

norminv (prob, moyenne, cart type)

340

renvoie l'inverse de la distribution normale cumulative pour la moyenne et l'cart type spcifis. Prob est la probabilit associe la distribution normale. Elle doit correspondre une valeur comprise entre 0 et 1. Moyenne est la valeur moyenne arithmtique de la distribution. cart type est une valeur positive indiquant l'cart type de la distribution. Tous les arguments doivent tre numriques, sinon la fonction renverra la valeur nulle. Cette fonction est lie la fonction normdist (valeur, moyenne, cart type) (page 340) de la manire suivante: If prob = normdist(valeur, m, sd), then norminv(prob, m, sd) = valeur.

Exemple:
norminv( 0.6914625, 0, 1 ) renvoie 0.4999717

tdist (valeur, degrs de libert, queue)


renvoie la probabilit pour la distribution T de Student o une valeur numrique est une valeur calcule de t pour laquelle la probabilit doit tre calcule. Valeur est la valeur laquelle vous souhaitez valuer la distribution, qui ne peut pas tre ngative. Degrs de libert correspond un entier positif indiquant le nombre de degrs de libert. Queue doit tre soit 1 (distribution unilatrale), soit 2 (distribution bilatrale). Tous les arguments doivent tre numriques, sinon la fonction renverra la valeur nulle. Cette fonction est lie la fonction tinv (prob, degrs de libert) (page 341) de la manire suivante: If prob = tdist(valeur, df ,2), then tinv(prob, df) = value.

Exemple:
chdist( 1, 30, 2 ) renvoie 0.3253086

tinv (prob, degrs de libert)


revoie la valeur t de la distribution t de Student en tant que fonction de probabilit et degrs de libert. Prob est la probabilit bilatrale associe la distribution t de Student. Elle doit correspondre une valeur comprise entre 0 et 1. Degrs de libert correspond un entier indiquant le nombre de degrs de libert. Les deux arguments doivent tre numriques,sinon la fonction renverra la valeur nulle. Cette fonction est lie la fonction tdist (valeur, degrs de libert, queue) (page 341) de la manire suivante: If prob = tdist(valeur, df ,2), then tinv(prob, df) = value.

Exemple:
tinv(0.3253086, 30 ) renvoie 1

fdist (valeur, degrs de libert 1, degrs de libert 2)


Renvoie la distribution de F. Valeur est la valeur laquelle vous souhaitez valuer la distribution. La valeur ne peut pas tre ngative. degrs de libert 1 est un entier positif indiquant le nombre de degrs de libert numrateurs. degrs de libert 2 est un entier positif indiquant le nombre de degrs de libert dnominateurs. Tous les arguments doivent tre numriques, sinon la fonction renverra la valeur nulle. Cette fonction est lie la fonction finv (prob, degrs de libert 1, degrs de libert 2) (page 341) de la manire suivante: If prob = fdist(valeur, df1, df2), then finv(prob, df1, df2) = valeur.

Exemple:
fdist( 15, 8, 6 ) renvoie 0.0019369

finv (prob, degrs de libert 1, degrs de libert 2)


Renvoie le contraire de la distribution de F. Prob est une probabilit associe la distribution F et doit correspondre une valeur comprise entre 0 et 1. Degrs de libert correspond un entier indiquant le nombre de degrs de libert. Tous les arguments doivent tre numriques, sinon la fonction renverra la valeur nulle. Cette fonction est lie la fonction fdist (valeur, degrs de libert 1, degrs de libert 2) (page 341) de la manire suivante: If prob = fdist(valeur, df1, df2), then finv(prob, df1, df2) = valeur.

Exemple:

341

finv( 0.0019369, 8, 5 ) renvoie 15.0000197


Retour Other Functions.

Fonctions de la catgorie Financier


Remarque: Pour toutes les fonctions financires, il est extrmement important d'tre cohrent dans les units utilises pour les arguments rate et nper. Si vous effectuez des paiements mensuels pour un prt contract sur cinq ans un taux d'intrt annuel de 6%, utilisez 0,005 (6%/12) pour le taux (rate) et 60 (5*12) pour le nombre d'chances (nper). Si vous effectuez des paiements annuels pour le mme prt, utilisez 6% pour le taux (rate) et 5 pour le nombre d'chances (nper).
Pour tous les arguments, l'argent que vous payez est reprsent par des nombres ngatifs. L'argent que vous recevez est reprsent par des nombres positifs. Voici une liste des arguments utiliss dans les fonctions financires (except celles qui commencent par range-):

rate est le taux d'intrt par priode. nper est le nombre total d'chances de paiement dans une annuit. pmt est le paiement effectu chaque chance. Il ne peut pas tre modifi pendant la dure d'une annuit. Si pmt est omis, l'argument pv doit tre inclus. pv est la valeur, ou le montant forfaitaire, que vaut au moment prsent une srie de paiements venir. Si pv est omis, la fonction utilise 0 (zro) et vous devez inclure l'argument pmt. fv est la valeur future, ou le solde de caisse, que vous souhaitez obtenir aprs le dernier paiement. Si fv est omis, la fonction utilise 0. type doit tre 0 si les paiements sont dus la fin de la priode et 1 si les paiements sont dus au dbut de la priode. Si type est omis, la fonction utilise 0.

fv(rate, nper, pmt [ ,pv [ , type ] ])


Renvoie la valeur future de l'investissement sur la base de paiements priodiques constants et d'un taux d'intrt constant. Le rsultat suit le format numrique par dfaut de Montaire (page 385).

Exemple:
Vous payez un nouveau magntoscope en 36 mensualits de 20$. Le taux d'intrt annuel est de 6%. La facture arrive la fin de chaque mois. Quelle est le montant total investi une fois la dernire facture rgle?

fv(0.005,36,-20) renvoie $786,72

nper(rate, pmt, pv [ ,fv [ , type ] ])


Renvoie le nombre d'chances d'un investissement sur la base de paiements priodiques constants et d'un taux d'intrt constant.

Exemple:
Vous souhaitez vendre un magntoscope par mensualits de $20. Le taux d'intrt annuel est de 6%. La facture arrive la fin de chaque mois. Combien d'chances sont ncessaires si le montant que vous devrez avoir touch une fois la dernire facture rgle est de 786,72$?

nper(0.005,-20,0,800) renvoie 36

pmt(rate, nper, pv [ ,fv [ , type ] ] )

342

Renvoie le paiement d'un emprunt sur la base de paiements priodiques constants et d'un taux d'intrt constant. Le rsultat suit le format numrique par dfaut de Montaire (page 385). Pour trouver le montant total pay sur la dure de l'emprunt, multipliez la valeur pmt renvoye par nper.

Exemple:
La formule suivante renvoie le paiement mensuel pour un emprunt de $20000 selon un taux annuel de 10%, qui doit tre rembours en 8mois:

pmt(0.1/12,8,20000) renvoie -$2594,66


Pour le mme emprunt, si le paiement est d au dbut de la priode, il correspondra :

pmt(0.1/12,8,20000,0,1) renvoie -$2573,21

pv(rate, nper, pmt [ ,fv [ , type ] ])


Renvoie la valeur d'un investissement au moment prsent. Le rsultat suit le format numrique par dfaut de Montaire (page 385). Cette valeur correspond au montant total que vaut au moment prsent une srie de paiements venir. Par exemple, pour un emprunt d'argent, le montant correspond sa valeur prsente pour le prteur.

Exemple:
Quelle est la valeur prsente de $100 qui vous sont pays la fin de chaque mois sur une priode de 5ans, avec un taux d'intrt de 7%?

pv(0.07/12,12*5,100,0,0) renvoie -$5050,20

rate(nper, pmt , pv [ ,fv [ , type ] ])


Renvoie le taux d'intrt par priode de l'annuit. Le rsultat a le format numrique par dfaut de deux dcimales Fix et en %. Le taux (rate) est calcul par itration et peut avoir zro solution ou plus. Si les rsultats successifs de rate ne concordent pas, la fonction renvoie une valeur NULL.

Exemple:
Quel est le taux d'intrt d'un emprunt de $10000 sur cinq ans avec des chances mensuelles de $300?

rate(60,-300,10000) renvoie 2,18%.


Retour Other Functions.

Black and Schole


La formule Black and Schole calcule la valeur thorique d'une option. Dans QlikView, la fonction BlackAndSchole renvoie la valeur selon la formule Black and Schole originale (options de style europen). Voir La formule Black and Schole (page 344) ci-dessous. La syntaxe est la suivante:

BlackAndSchole(strike , time_left , underlying_price , vol , risk_ free_rate , type)


o:

Prix d'exercice est le futur prix d'achat du titre. Temps restant est le nombre de priodes restant. Prix sous-jacent est la valeur actuelle du titre. Vol est la volatilit en % par priode.

343

Taux hors risque est le taux hors risque en % par priode. Type est 'c', 'call' ou toute valeur numrique autre que zro pour les options d'achat et 'p', 'put' ou 0 pour les options de vente.

Exemple:
BlackAndSchole(130, 4, 68.5, 0.4, 0.04, 'call') renvoie 11,245...
(Il s'agit du prix thorique d'une option d'achat 4ans et un prix de 130 sur un titre qui vaut aujourd'hui 68,5, avec une volatilit de 40% par an et un taux d'intrt hors risque de 4%)
La formule Black and Schole

Retour Other Functions.

Constantes mathmatiques et fonctions sans paramtres


Ces fonctions n'ont aucun paramtre. Les parenthses restent cependant requises.

e( )
Base des logarithmes npriens, e. La fonction renvoie 2,71828...

pi( )
pLa fonction renvoie 3,14159...

rand( )
Renvoie un nombre au hasard entre 0 et 1.

true( )
Renvoie une valeur double avec la valeur textuelle 'true' et la valeur numrique -1, qui peuvent tre utilises comme un vrai logique dans les expressions.

false( )
Renvoie une valeur double avec la valeur textuelle 'false' et la valeur numrique 0, qui peuvent tre utilises comme un faux logique dans les expressions.

344

Retour Other Functions.

Fonctions de dcompte
Ces fonctions n'ont aucun paramtre. Les parenthses restent cependant requises.

RecNo( )
Renvoie un entier correspondant au numro de la ligne de la table interne en cours de lecture. La premire ligne porte le numro1.

RowNo( )
Renvoie un entier correspondant la position de la ligne actuelle dans la table d'entre QlikView. Contrairement RecNo( ), qui compte les enregistrements dans la table de donnes brutes, la fonction RowNo( ) ne compte pas les enregistrements qui sont exclus par des clauses where et elle n'est pas rinitialise quand une table de donnes brutes est Concatenation une autre. La premire ligne porte le numro1.

Exemples:
Tables de donnes brutes:
Tab1.csv A 1 2 3 B aa cc ee

Tab2.csv A 5 4 6 B xx yy zz

QVTab : Load *, RecNo( ), RowNo( ) from Tab1.csv where A<>2; Load *, RecNo( ), RowNo( ) from Tab2.csv where A<>5;
Table interne QlikView qui en rsulte:
QVTab A B RecNo( ) RowNo( )

345

1 3 4 6

aa ee yy zz

1 3 2 3

1 2 3 4

IterNo( )
Cette fonction n'est valable que si elle est utilise avec une clause while (voir Load (page 268)). IterNo( ) renvoie un entier indiquant combien de temps un seul enregistrement est valu dans une instruction load avec une clause while. La premire itration porte le numro1.

autonumber(expression[ , AutoID])
Renvoie une valeur entire unique pour chaque valeur distincte value de l'expression rencontre au cours de l'excution du script. Cette fonction peut tre utilise pour crer, par exemple, une reprsentation mmoire compacte de cl complexe. Pour crer des dcomptes multiples si la fonction autonumber est utilise sur diffrentes cls dans le script, vous pouvez utiliser un paramtre facultatif AutoID afin de nommer chaque dcompte.

Exemples:
autonumber( Rgion&Anne&Mois ) autonumber( Rgion&Anne&Mois, 'Ctr1' )

autonumberhash128(expression {, expression})
Calcule un hachage de 128bits des valeurs de l'expression d'entre combines et renvoie une valeur entire unique pour chaque valeur de hachage distincte rencontre lors de l'excution du script. Cette fonction peut tre utilise pour crer, par exemple, une reprsentation mmoire compacte de cl complexe.

Exemple:
autonumberhash128 ( Rgion, Anne, Mois )

autonumberhash256(expression {, expression})
Calcule un hachage de 256bits des valeurs de l'expression d'entre combines et renvoie une valeur entire unique pour chaque valeur de hachage distincte rencontre lors de l'excution du script. Cette fonction peut tre utilise pour crer, par exemple, une reprsentation mmoire compacte de cl complexe. Cette fonction n'est disponible que comme fonction de script.

Exemple:
autonumberhash128 ( Rgion, Anne, Mois )

fieldvaluecount(nomdechamp)
Renvoie le nombre de valeurs distinctes d'un champ. Le nomdechamp doit tre pass sous forme de chane (par exemple, un littral plac entre guillemets).

Exemple:
let x = fieldvaluecount('Alfa');

346

Retour Other Functions.

Fonctions de la catgorie Chane


Dans les fonctions ci-dessous, les paramtres sont des expressions o s doit tre interprt comme une chane.

ord( s)
Numro ASCII du premier caractre de la chane s. Le rsultat est un entier.

Exemple:
ord('A') renvoie le nombre 65.

chr( n)
Caractre ASCII correspondant au nombre n. Le rsultat est une chane.

Exemple:
chr( 65 ) renvoie la chane 'A'.

len( s)
Longueur de la chane s. Le rsultat est un entier.

Exemple:
len(Nom) o Nom = 'Pierre' renvoie 5.

left( s , n)
Sous-chane de la chane s. Le rsultat est une chane compose des n premiers caractres de s.

Exemple:
left('abcdef',3) renvoie 'abc'. left(Date, 4) where Date = 1997-07-14 renvoie 1997.
Pour consulter un exemple plus complexe, reportez-vous la fonction index ci-dessous.

right( s , n)
Sous-chane de la chane s. Le rsultat est une chane compose des n derniers caractres de s.

Exemple:
right( 'abcdef',3 ) renvoie 'def'. right( Date, 2 ) o Date = 1997-07-14 renvoie 14.

mid(s, n1[, n2 ])
Sous-chane de la chane s. Le rsultat est la chane d'une longueur de n2 caractres qui commence au caractre n1. Si n2 est omis, la fonction renvoie la partie la plus droite de la chane commenant au caractre n1. Les positions dans la chane sont numrotes partir de 1.

Exemple:
mid( 'abcdef', 3 ) renvoie 'cdef'. mid( 'abcdef', 3, 2 ) renvoie 'cd'.

347

mid( Date,3 ) o Date = 970714 renvoie 0714. mid( Date,3,2 ) o Date = 970714 renvoie 07. Pour voir un exemple plus compliqu, reportez-vous la fonction index ci-dessous.

index(s1 , s2[ , n])


Position d'une sous-chane. Cette fonction donne la position du dbut de la nime occurrence de la souschane s2 dans la chane s1. Si n est omis, c'est la premire occurrence qui est renvoye. Si n est ngatif, la recherche se fait partir de la fin de la chane s1. Le rsultat est un entier. Les positions dans la chane sont numrotes partir de 1.

Exemples:
index( 'abcdefg', 'cd' ) renvoie 3 index( 'abcdabcd', 'b', 2 ) renvoie 6 index( 'abcdabcd', 'b', -2 ) renvoie 2 left( Date, index( Date,'-') -1 ) o Date = 1997-07-14 renvoie 1997 mid( Date, index( Date, '-', 2 ) -2, 2 ) o Date = 1997-07-14 renvoie 07

upper(textexpression)
Force les majuscules pour toutes les donnes de l'expression.

Exemple:
upper( 'abcD' ) renvoie 'ABCD'.

lower( textexpression )
Force les minuscules pour toutes les donnes de l'expression.

Exemple:
lower('abcD' ) renvoie 'abcd'.

repeat( s, n)
Forme une chane compose de la chane s rpte n fois.

Exemple:
repeat( ' * ', rating ) o rating = 4 renvoie '****'.

ltrim(s )
Renvoie la chane s dbarrasse de toute espace se trouvant au dbut.

Exemple:
ltrim ( ' abc' ) renvoie 'abc'. ltrim ( 'abc ' ) renvoie 'abc '

rtrim(s )
Renvoie la chane s dbarrasse de tout espace se trouvant la fin.

Exemple:
rtrim (' abc') renvoie 'abc'.

348

rtrim ( 'abc ' ) renvoie 'abc'

trim(s )
Renvoie la chane s dbarrasse de tout espace se trouvant au dbut ou la fin.

Exemple:
trim (' abc') renvoie 'abc'. trim ( 'abc ' ) renvoie 'abc' trim ( ' abc ' ) renvoie 'abc'

subfield(s, 'dlimiteur' [ , index ] )


Dans sa version trois paramtres, cette fonction de script renvoie une sous-chane donne d'une chane plus grande s avec des dlimiteurs 'delimiter'. index est un entier facultatif qui indique laquelle des sous-chanes doit tre renvoye. SI index est omis lorsque la fonction subfield est utilise dans une expression de champ au sein d'une instruction load, la fonction subfield obligera l'instruction load gnrer automatiquement un enregistrement complet des donnes d'entre pour chaque sous-chane se trouvant dans s. Dans sa version deux paramtres, la fonction subfield gnre un enregistrement pour chaque sous-chane pouvant tre obtenue partir d'une chane s plus grande avec le dlimiteur 'delimeter'. Si plusieurs fonctions subfield sont utilises dans la mme instruction load, elles gnreront le produit cartsien de toutes les combinaisons.

Exemples:
(Pour trois paramtres)

subfield(S, ';' ,2) renvoie 'cde' si S correspond 'abc;cde;efg' subfield(S, ';' ,1) renvoie NULL si S est une chane vide subfield(S, ';' ,1) renvoie une chane vide si S correspond ';'

KeepChar(s1 , s2)
Renvoie la chane s1 moins tous les caractres qui ne figurent pas dans la chane s2.

Exemple:
keepchar ( 'a1b2c3','123' ) renvoie '123'

PurgeChar(s1, s2)
Renvoie la chane s1 moins tous les caractres qui figurent dans la chane s2.

Exemple:
purgechar ( 'a1b2c3','123' ) renvoie 'abc'

capitalize(s)
Renvoie la chane s avec la premire lettre de tous les mots en majuscule.

Exemple:
capitalize ('mon petit poney') renvoie 'Mon Petit Poney' capitalize ( 'AA bb cC Dd') renvoie 'Aa Bb Cc Dd'

349

evaluate(s )
Si la chane textuelle s peut tre value comme une expression QlikView valide, la fonction renvoie le rsultat de l'expression. Si s n'est pas une expression valide, elle renvoie NULL.

Remarque: cette fonction de chane ne peut pas tre utilise dans les expressions de graphique.

Exemple:
evaluate ( 5 * 8 ) renvoie 40

TextBetween(s , texte avant, texte aprs [, n ])


Renvoie le texte entre la nime occurrence du texte avant (beforetext) et l'occurrence du texte aprs (aftertext) qui suit immdiatement dans la chane s.

Exemples:
TextBetween('<abc>', '<', '>') renvoie 'abc
>TextBetween('<abc><de>', '<', '>',2) renvoie 'de'

Replace(s, fromstring ,tostring)


Renvoie une chane aprs avoir remplac toutes les occurrences d'une sous-chane donne dans la chane s par une autre sous-chane. La fonction n'est pas rcursive et fonctionne de gauche droite.

s est la chane d'origine. fromstring est une chane qui peut apparatre une ou plusieurs fois dans chane. tostring est la chane qui remplacera toutes les occurrences de fromstring dans la chane.

Exemple:
replace('abccde','cc','xyz') renvoie 'abxyzde'

FindOneOf(text , characterset [ , n])


Renvoie la position de la nime occurrence dans la chane text d'un des caractres se trouvant dans la chane characterset. Si n est omis, c'est la position de la premire occurrence qui est renvoye. Si elle ne trouve aucune chane correspondante, la fonction renvoie 0.

Exemple:
findoneof( 'ma chane textuelle exemple', 'et%s') renvoie '4' findoneof( 'ma chane textuelle exemple', 'et%s', 3) renvoie '12' findoneof( 'ma chane textuelle exemple', '%&') renvoie '0'

hash128(expression {, expression})
Renvoie un hachage de 128bits des valeurs de l'expression d'entre combines. Le rsultat est une chane.

Exemples:
hash128 ('abc', 'xyz', '123') hash128 (Rgion, Anne, Mois)

hash160(expression {, expression})

350

Renvoie un hachage de 160bits des valeurs de l'expression d'entre combines. Le rsultat est une chane.

Exemple:
hash160 ( Rgion, Anne, Mois )

hash256(expression {, expression} )
Renvoie un hachage de 256bits des valeurs de l'expression d'entre combines. Le rsultat est une chane.

Exemple:
hash256 ( Rgion, Anne, Mois )

substringcount(texte , sous-chane)
Renvoie le nombre d'occurrences de la chane sous-chane dans le texte de la chane. Le rsultat est un entier. Si aucun caractre ne correspond, la fonction renvoie0.

Exemple:
substringcount ( 'abcdefgcdxyz', 'cd' ) renvoie 2

applycodepage(text, codepage)
Applique une page de codes diffrente au champ ou au texte spcifi dans l'expression. La page de codes doit tre dans un format numrique. Retour Other Functions.

Fonctions de la catgorie Mappage


La fonction ApplyMap est utilise pour mapper une expression une table de mappage dj charge. La syntaxe est la suivante:

applymap('nomdemappage', expr [ , defaultexpr ] )


o:

nomdemappage correspond au nom d'une table de mappage qui a dj t cre par l'instruction mapping load ou mapping select (voir Mapping (page 276)). Ce nom doit tre donn entre Guillemets (page 305) simples droits. expr est l'expression dont le rsultat doit tre mapp. exprdfaut est une expression facultative qui sera utilise comme valeur de mappage par dfaut si la table de mappage ne contient pas de valeur correspondante pour expr. Si aucune valeur par dfaut n'est indique, la valeur de expr sera renvoye telle quelle.

Exemples:
// Soit la table de mappage suivante: map1: mapping load * inline [ x, y 1, un 2, deux

351

3, trois ] ; ApplyMap ('map1', 2 ) renvoie deux ApplyMap ('map1', 4 ) renvoie 4 ApplyMap ('map1', 5, 'xxx') renvoie xxx ApplyMap ('map1', 1, 'xxx') renvoie un ApplyMap ('map1', 5, null( ) ) renvoie NULL ApplyMap ('map1', 3, null( ) ) renvoie trois
La fonction MapSubstring est utilise pour mapper des parties d'une expression une table de mappage dj charge. Le mappage tient compte de la casse et n'est pas itratif; les sous-chanes sont mappes de gauche droite. La syntaxe est la suivante:

mapsubstring('nomdemappage', expr)
Cette fonction peut tre utilise pour mapper des parties d'une expression une table de mappage dj charge. Le mappage tient compte de la casse et n'est pas rcursif. Les sous-chanes sont mappes de gauche droite. Nomdemappage correspond au nom d'une table de mappage dj lue dans une instruction mapping load ou mapping select (voir Mapping (page 276)). Ce nom doit tre donn entre guillemets simples droits. Expr dsigne l'expression dont le rsultat doit tre mapp par des sous-chanes.

Exemples:
// Soit la table de mappage suivante: map1: mapping load * inline [ x, y 1, <un> aa, XYZ x, b ] ; MapSubstring ('map1', 'A123') renvoie 'A<un>23' MapSubstring ('map1', 'baaar') renvoie 'bXYZar' MapSubstring ('map1', 'xaa1') renvoie 'bXYZ<un>'
Retour Other Functions.

Fonctions de la catgorie Inter-enregistrements


Ces fonctions sont utilises lorsqu'une valeur d'enregistrements de donnes dj chargs est ncessaire l'valuation de l'enregistrement actif.

exists(champ [ , expression ])
Dtermine si une valeur de champ donne existe dans un champ parmi les donnes dj charges. Field est un nom ou une expression de chane qui donne un nom de champ. Le champ doit exister dans les donnes charges jusque-l par le script. Expr est une expression qui fournit la valeur chercher dans le champ spcifi. Si elle est omise, c'est la valeur de l'enregistrement actif dans le champ spcifi qui est utilise.

Exemples:
exists(Mois, 'Jan') renvoie -1 (vrai) si la valeur de champ 'Jan' se trouve dans le contenu actuel du champ Mois.

352

exists(IDnr, IDnr) renvoie -1 (vrai) si la valeur du champ IDnr de l'enregistrement actif existe dj dans un enregistrement lu prcdemment et contenant ce champ. exists (IDnr) est identique l'exemple prcdent. Load Employ, ID, Salaire from Employs.csv; Load Prnom& ' ' &Nom as Employ, Commentaire from Habitants.csv where exists (Employ, Prnom& ' ' &Nom); Ne sont lus que les commentaires concernant les habitants qui sont employs. Load A, B, C, from Employs.csv where not exists (A); Cela revient excuter une instruction distinct load sur le champ A.

previous(expression )
Renvoie la valeur de l'expression utilisant des donnes de l'enregistrement d'entre prcdent qui n'a pas t ignor par une clause where. Dans le premier enregistrement d'une table interne, la fonction renverra NULL. La fonction previous peut tre imbrique afin d'accder des enregistrements encore antrieurs. La fonction va chercher les donnes directement la source d'entre, ce qui permet de faire aussi rfrence des champs qui n'ont pas t chargs dans QlikView, c'est--dire mme s'ils n'ont pas t stocks dans sa base de donnes associative.

Exemples:
Load *, Ventes / previous(Ventes) as Augmentation from ...; Load A, previous(previous( A )) as B from ...;

peek(nomdechamp [ , row [ , nomdetable ] ] )


Renvoie le contenu du champ nomdechamp dans l'enregistrement spcifi par la ligne (ligne) dans la table interne nomdetable. La fonction va chercher les donnes dans la base de donnes associative de QlikView. Le nomdechamp doit tre pass sous forme de chane (par exemple, un littral plac entre guillemets). La valeur ligne doit tre un entier. 0 renvoie au premier enregistrement, 1 au deuxime et ainsi de suite. Les nombres ngatifs prennent les enregistrements partir de la fin de la table. -1 renvoie ainsi au dernier enregistrement lu. Si aucune ligne n'est spcifie, la fonction utilise -1.

Nomdetable est une tiquette de table (voir tiquettes de table (page 296)) sans le signe deux-points final. Si aucun nomdetable n'est spcifi, la fonction utilise la table active. Si tablename est utilis l'extrieur de l'instruction load ou s'il renvoie une autre table, ce paramtre doit tre inclus.

Exemples:
peek( 'Ventes' ) renvoie la valeur de Ventes de l'enregistrement prcdent lu ( quivalant previous(Ventes)). peek( 'Ventes', 2 ) renvoie la valeur de Ventes du troisime enregistrement lu de la table interne active. peek( 'Ventes', -2 ) renvoie la valeur de Ventes de l'avant-dernier enregistrement lu dans la table interne active. peek( 'Ventes', 0, 'Tab1' ) renvoie la valeur de Ventes du premier enregistrement lu dans la table d'entre tiquete Tab1. Load A, B, numsum( B, peek( 'Bsum' ) ) as Bsum...; cre une accumulation de B dans Bsum.

FieldValue(nomdechamp , n )

353

Renvoie la valeur dtecte la position n du champ nomdechamp (par ordre de chargement). Le nomdechamp doit tre pass sous forme de valeur de chane, c'est--dire que le nom du champ doit tre plac entre guillemets simples. La premire valeur de champ est renvoye pour n=1. Si n est suprieur au nombre de valeurs de champ, la chane NULL est renvoye.

Exemple:
FieldValue( 'Texteaide', 5 )

FieldIndex(nomdechamp , valeur )
Renvoie la position de la valeur value trouve dans le champ fieldname (par ordre de chargement). Si valeur est introuvable parmi les valeurs de champ du champ, 0 est renvoy. Le nomdechamp doit tre pass sous forme de valeur de chane, c'est--dire que le nom du champ doit tre plac entre guillemets simples.

Exemple:
FieldIndex( 'Nom', 'Jean Dupont' )

lookup(nomdechamp, nomdechampcorrespondant, valeurdechampcorrespondant [, nomdetable])


Renvoie la valeur de nomdechamp correspondant la premire occurrence de la valeur valeurdechampcorrespondant dans le champ nomdechampcorrespondant.

Nomdechamp, nomdechampcorrespondant et nomdetable doivent contenir une chane (par exemple un littral entre guillemets).
L'ordre de recherche correspond l'ordre de chargement, sauf si la table correspond au rsultat d'oprations complexes telles que des jointures, et dans ce cas, l'ordre n'est pas bien dfini.

Nomdechamp et nomdechampcorrespondant doivent tre des champs de la mme table, tel que spcifi par nomdetable. Si nomdetable est omis, la table active est alors renvoye. Si aucune ne correspond, la fonction renvoie null.

Exemple:
lookup('Prix', 'NProduit', ProduitFactur, 'listedeprix'),
Retour Other Functions.

Fonctions de la catgorie Conditionnel


if(condition , then , else)
Les trois paramtres condition, then et else sont des expressions. La premire, condition, est interprte logiquement. Les deux autres, then et else, peuvent tre de tout type. Elles seront de prfrence du mme type. Si la condition est vraie, la fonction renvoie la valeur de l'expression then. Si la condition est fausse, la fonction renvoie la valeur de l'expression else.

Exemple:
if( Montant>= 0, 'OK', 'Alarme' )

alt(case1[ , case2 , case3 , ...] , else)


La fonction alt renvoie le premier des paramtres qui a une reprsentation numrique valide. Si aucun correspondant n'est trouv, c'est le dernier paramtre qui est renvoy. Vous pouvez utiliser autant de paramtres que vous le voulez.

354

Exemple:
alt( date#( dat , 'AAAA/MM/JJ' ), date#( dat , 'MM/JJ/AAAA' ), date#( dat , 'MM/JJ/AA' ), 'Pas de date valide' )
Cherchera dans le champ date une date correspondant l'un des trois formats de date indiqus. S'il y en a une, la fonction renverra la chane originale et la reprsentation numrique valide d'une date. Si aucune date n'est trouve, elle renverra le texte Pas de date valide (sans reprsentation numrique).

pick(n, expr1 [ , expr2,...exprN ])


Renvoie la nime expression de la liste. n est un entier compris entre 1 et N.

Exemple:
pick( N'A''B'4, , , )
renvoie 'B' si N = 2 renvoie 4 si N = 3

match( str, expr1 [ , expr2,...exprN ] )


La fonction match effectue une comparaison prenant la casse en compte.

Exemple:
match( M, 'Jan', 'Fv', 'Mar')
renvoie 2 si M = Fv renvoie 0 si M = Avr ou Jan

mixmatch( str, expr1 [ , expr2,...exprN ] )


La fonction mixmatch effectue une comparaison sans tenir compte de la casse.

Exemple:
mixmatch( M, 'Jan', 'Fv', 'Mar')
renvoie 1 si M = Jan

wildmatch( str, expr1 [ , expr2,...exprN ] )


La fonction wildmatch effectue une comparaison sans tenir compte de la casse et permet l'utilisation de caractres gnriques (* et ?) dans les chanes de comparaison.

Exemple:
wildmatch( M, 'ja*', 'f?', 'mar')
renvoie 1 si M = Janvier renvoie 2 si M = Fx

class(expression, interval [ , label [ , offset ]] )


Cre un classement d'expressions. La taille de la srie est dtermine par le nombre indiqu comme interval. Le rsultat apparat sous la forme a<=x<b, o a et b sont les limites suprieures de la srie. Le x peut tre

355

remplac par une chane arbitraire spcifie dans l'argument label. 0 est normalement le point de dpart par dfaut du classement. On peut le modifier en ajoutant un dcalage (offset).

Exemples:
class( var,10 ) avec var = 23 renvoie '20<=x<30' class( var,5,'valeur' ) avec var = 23 renvoie '20<= valeur <25' class( var,10,'x',5 ) avec var = 23 renvoie '15<=x<25'
Retour Other Functions.

Fonctions de la catgorie Logique


IsNum( expr)
Renvoie -1 (vrai) si l'expression peut tre interprte comme un nombre; sinon, renvoie 0 (faux).

IsText(expr)
Renvoie -1 (vrai) si l'expression a une reprsentation textuelle; sinon, renvoie 0 (faux).

IsPartialReload( )
Renvoie -1 (vrai) si le rechargement en cours est partiel; sinon, renvoie 0 (faux). Retour Other Functions.

Fonctions de la catgorie NULL


Null( )
Renvoie une valeur NULL relle.

IsNull(expr)
Renvoie -1 (vrai) si l'expr renvoie NULL; sinon, renvoie 0 (faux). Retour Other Functions.

Fonctions de la catgorie Systme


ClientPlatform( )
Renvoie le nom de la plate-forme utilise par le client, par exemple, Mobile.iPhone. Tous les clients mobiles commencent par le mot Mobile, suivi d'un point et du type d'appareil mobile. Les clients utilisant AJAX renvoient Browser.Nomdunavigateur, par exemple Browser.Firefox.

Remarque: La fonction renvoie uniquement le type de client des clients employant le protocole QVPX, c'est--dire les clients mobiles et le client AJAX.

OSuser( )
Renvoie une chane contenant le nom de l'utilisateur actuel renvoy par le systme d'exploitation.

QVuser( )

356

Renvoie une chane contenant le nom de l'utilisateur actuel de QlikView tel qu'il a t saisi dans l'accs la section.

ComputerName( )
Renvoie une chane contenant le nom de l'ordinateur renvoy par le systme d'exploitation.

ReloadTime( )
Renvoie une marque horaire correspondant la fin de la dernire rexcution du script.

GetActiveSheetID()
Renvoie une chane contenant l'ID de la feuille active.

GetCurrentField(nomdegroupe)
Renvoie le nom du champ actuellement actif dans le groupe nomm nomdegroupe.

Exemple:
getcurrentfield( monGroupe )

GetCurrentSelections([ sparateur d'enregistrements [, sparateur de balises [, sparateur de valeurs [, nombre maximum de valeurs=6 ]]]])
Renvoie une marque de slection pour les slections actuellement effectues dans le document. Recordsep est le dlimiteur sparant les lignes (champs) dans la marque de slection et sa valeur par dfaut est chr(13). Tagsep est le dlimiteur sparant le nom de champ des valeurs, il est dfini par dfaut sur: '. Valuesep est le dlimiteur des valeurs slectionnes et sa valeur par dfaut est ', '. Maxvalues est le plus grand nombre de valeurs individuelles pouvant tre affiches dans un champ avant que la notation 'x sur y valeurs' ne soit utilise.

Exemples:
getcurrentselections() getcurrentselections (chr(13), '=', ';' ) getcurrentselections (chr(13), '=', ';', 10 )

GetFieldSelections(nomdechamp [, valuesep [, maxvalues=6 ]])


Renvoie une chane avec les slections actives dans un champ. Valuesep est le dlimiteur des valeurs slectionnes et sa valeur par dfaut est ', '. Maxvalues est le plus grand nombre de valeurs individuelles pouvant tre affiches dans un champ avant que la notation 'x sur y valeurs' ne soit utilise.

Exemples:
getfieldselections(Pays) getfieldselections (Pays, ';' ) getfieldselections (Pays, ',' , 10 )

GetSelectedCount(nomdechamp [, includeexcluded=false])
Renvoie le nombre de valeurs slectionnes dans le champ nomdechamp. Si includeexcluded est dfinie sur true, le compte inclut les valeurs slectionnes exclues par les slections effectues dans un autre champ.

Exemples:
getselectedcount( Clients ) getselectedcount( Clients, true )

GetPossibleCount(nomdechamp)
Renvoie le nombre de valeurs possibles dans le champ nomdechamp.

Exemple:

357

getpossiblecount( Clients )

GetExcludedCount(nomdechamp)
Renvoie le nombre de valeurs exclues dans le champ nomdechamp.

Exemple:
getexcludedcount( Clients )

GetAlternativeCount(nomdechamp)
Renvoie le nombre de valeurs alternatives dans le champ nomdechamp. Pour en savoir plus sur les valeurs alternatives, voir Jeu de couleurs (page 113).

Exemple:
getalternativecount( Clients )

GetNotSelectedCount(nomdechamp [, includeexcluded=false])
Renvoie le nombre de valeurs non slectionnes dans le champ nomdechamp. Le champ doit tre en mode and pour que cette fonction soit pertinente. Si includeexcluded est dfinie sur true, le compte inclut les valeurs slectionnes exclues par les slections effectues dans un autre champ.

Exemples:
getnotselectedcount( Pays ) getnotselectedcount( Pays, true )

GetRegistryString(chemin, cl)
Renvoie la valeur de la cl de registre indique avec un chemin d'accs au registre. Cette fonction peut tre utilise dans les graphiques comme dans les scripts.

Exemple:
getregistrystring('HKEY_LOCAL_ MACHINE\SOFTWARE\QlikTech\QlikViewServer\Settings 7','EnableSessionLog')

qlikviewversion()
Renvoie les numros de version et de build QlikView complets, (par ex., 7.52.3797.0409.3) sous forme de chane. Cette fonction est uniquement disponible dans les build QlikView ultrieures la build 7.52.3795.

MsgBox(str msg [, str caption [, mb_buttons [, mb_icons[, mb_ defbutton]]]] )


Cette fonction peut tre utilise uniquement dans le script et ouvre une zone de message lors de l'excution de celui-ci. Les paramtres msg et caption sont respectivement utiliss comme textes de message et de lgende. Le paramtre mb_buttons dfinit les boutons qui seront affichs dans la zone de message, en fonction des lments suivants: 0 1 2 3 4 5 ou ou ou ou ou ou 'OK' pour un seul bouton OK, 'OKCANCEL' pour deux boutons, OK et Cancel, 'ABORTRETRYIGNORE' pour trois boutons, Abort, Retry et Ignore, 'YESNOCANCEL' pour trois boutons, Yes, No et Cancel, 'YESNO' pour deux boutons, Yes et No, 'RETRYCANCEL' pour deux boutons, Retry et Cancel.

Le paramtre mb_icons dfinit les icnes qui seront affiches dans la zone de message, en fonction de: 0 ou chane vide pour aucune icne, 16 ou 'ICONHAND' pour une icne avec un X, utilise pour les erreurs critiques, 32 ou 'ICONQUESTION' pour une icne avec un point d'interrogation, 48 ou 'ICONEXCLAMATION' pour une icne avec un point d'exclamation, utilise pour les erreurs

358

mineures, les prcautions et les avertissements, 64 ou 'ICONASTERISK' pour une icne avec un i, utilise pour les messages d'information. Le paramtre mb_defbutton dfinit les boutons qui seront affichs dans la zone de message, en fonction de: 0 ou 'DEFBUTTON1' si le 256 ou 'DEFBUTTON2' si 512 ou 'DEFBUTTON3' si 768 ou 'DEFBUTTON4' si 1 2 3 4 5 6 7 pour OK, pour Cancel, pour Abort, pour Retry, pour Ignore, pour Yes, pour No premier bouton doit tre mis en vidence, le second bouton doit tre mis en vidence, le troisime bouton doit tre mis en vidence, le quatrime bouton doit tre mis en vidence.

Cette fonction renvoie un entier correspondant au bouton actionn par l'utilisateur, en fonction de:

Les paramtres 3, 4 et 5 seront ajouts en interne, par consquent, si vous utilisez des valeurs numriques autres que celles mentionnes ci-dessus, il se peut qu'une combinaison inattendue d'icnes et de boutons soit gnre. La fonction de zone de message renvoie NULL si la bote de dialogue ne peut pas tre affiche.

Exemple:
Load MsgBox('Message 2', 'msgbox', 'OKCANCEL', 'ICONASTERISK') as x, 2 as r autogenerate 1;

Input(str cue [, str caption])


Cette fonction peut tre utilise dans un script uniquement et ouvre une zone de saisie invitant l'utilisateur entrer une valeur lors de l'excution du script. Les paramtres cue et caption sont respectivement utiliss comme textes de message et de lgende. La fonction renvoie la valeur saisie. La fonction de zone de saisie renvoie NULL si la bote de dialogue est annule, ferme ou si elle ne peut pas tre affiche.

Exemple:
Load Input('Saisir une valeur', 'Zone de saisie') as v, Recno () as r autogenerate 3;

DocumentName( )
Renvoie une chane contenant le nom du document QlikView actif, sans chemin mais avec l'extension.

DocumentPath( )
Renvoie une chane contenant le chemin d'accs complet au document QlikView actif.

DocumentTitle( )
Renvoie une chane contenant le titre du document QlikView actif.

GetObjectField ([index])
renvoie le nom de la dimension. index est un entier facultatif qui indique la sous-chane qui doit tre renvoye.

Exemple:
getobjectfield(2)

359

StateName ()
renvoie le nom de l'tat de l'objet dans lequel elle est utilise. Le dveloppeur QlikView peut se servir de cette fonction pour obtenir du texte et des couleurs dynamiques suite au changement d'tat d'un objet. Il est important de noter que cette fonction s'applique uniquement aux objets. Elle ne peut pas s'utiliser dans une expression de graphique pour identifier l'tat auquel l'expression fait rfrence. Voici quelques exemples d'utilisation de cette fonction.

Exemple:
Texte dynamique

='Rgion - ' & if(StateName() = '$', 'Default', StateName())

Exemple:
Couleurs dynamiques

if(StateName() = 'Groupe 1', rgb(152, 171, 206), if(StateName() = 'Groupe 2', rgb(187, 200, 179), rgb(210, 210, 210) ) )

GetExtendedProperty (nom[, idobjet])


renvoie la valeur d'une proprit tendue nomme dans l'objet de la feuille l'aide de l'ID d'objet. Si l'ID de l'objet n'est pas fourni, l'objet contenant l'expression sera utilis. La proprit tendue est spcifie pour l'objet d'extension dans le fichier de dfinition qui lui est associ.

Exemple:
GetExtendedProperty ('Bonjour')
Retour Other Functions.

Fonctions de la catgorie Fichier dans le script


Les fonctions de fichier (disponibles uniquement dans les expressions de script) renvoient des informations sur le fichier de tables en cours de lecture. Elles renverront NULL pour toutes les sources de donnes except les fichiers de tables (exception: ConnectString( )). Cliquez sur les fonctions pour plus d'informations leur sujet :

Attribut(nomdufichier, nomdelattribut)
Renvoie la valeur des balises mta correspondant diffrents formats, par exemple les fichiers MP3, WMA, WMV et JPG, sous la forme de texte.

nomdufichier est le nom d'un fichier de support avec, le cas chant, son chemin. nomdattribut est le nom d'une balise mta.
Si le fichier nomdufichier n'existe pas, si son format n'est pas pris en charge ou s'il ne contient pas de balise mta nomme nomdatribut, le programme renvoie une valeur nulle. Vous pouvez utiliser un grand nombre de balises mta, par exemple Artist or Date Picture Taken. Les balises prises en charge peuvent tre automatiquement gnres dans le script. Le raccourci de cette gnration est CTRL + Q,J,P,G pour les fichier jpg (maintenez la touche CTRL enfonce en

360

saisissant la combinaison QJPG), CTRL + Q,M,P,3 pour les fichiers mp3 et CTRL + Q,W,M,A pour les fichiers wma.

Exemple:
Attribute('File', 'Title') as X,
renvoie le titre de balise mp3 dans le champ X dans chaque enregistrement.

ConnectString()
Renvoie la chane connect active pour la connexion ODBC ou OLEDB. Renvoie une chane vide si aucune instruction connect n'a t excute ou aprs une instruction disconnect.

filebasename()
Renvoie une chane contenant le nom du fichier de tables en cours de lecture, sans chemin ni extension.

Exemple:
Load *, filebasename( ) as X from C:\UserFiles\abc.txt
Renverra 'abc' dans le champ X chaque enregistrement lu.

filedir()
Renvoie une chane contenant le chemin du rpertoire o se trouve le fichier de tables en cours de lecture.

Exemple:
Load *, filedir( ) as X from C:\UserFiles\abc.txt
Renverra 'C:\UserFiles' dans le champ X chaque enregistrement lu.

fileextension()
Renvoie une chane contenant l'extension du fichier de tables en cours de lecture.

Exemple:
Load *, fileextension( ) as X from C:\UserFiles\abc.txt
Renverra 'txt' dans le champ X chaque enregistrement lu.

filename()
Renvoie une chane contenant le nom du fichier de tables en cours de lecture, sans chemin mais avec l'extension.

Exemple:
Load *, filename( ) as X from C:\UserFiles\abc.txt
Renverra 'abc.txt' dans le champ X chaque enregistrement lu.

filepath()
Renvoie une chane contenant le chemin complet du fichier de tables en cours de lecture.

Exemple:
Load *, filepath( ) as X from C:\UserFiles\abc.txt
Renverra 'C:\UserFiles\abc.txt' dans le champ X chaque enregistrement lu.

filesize()

361

Renvoie un entier contenant la taille en octets du fichier filename ou, si aucun nom de fichier (filename) n'est spcifi, du fichier de tables en cours de lecture.

Exemples:
filesize( 'xyz.xls' )
Renverra la taille du fichier xyz.xls.

Load *, filesize( ) as X from abc.txt ;


Renverra la taille du fichier spcifi (abc.txt) sous forme d'entier dans le champ X chaque enregistrement lu.

filetime([ filename ])
Renvoie un horodateur donnant la date et l'heure de la dernire modification du fichier filename. Si aucun nom de fichier (filename) n'est spcifi, la fonction se rfrera au fichier de tables en cours de lecture.

Exemples:
filetime( 'xyz.xls' )
Renverra l'horodateur de la dernire modification du fichier xyz.xls.

Load *, filetime() as X from abc.txt ;


Renverra la date et l'heure de la dernire modification du fichier (abc.txt) sous forme d'horodateur dans le champ X chaque enregistrement lu.

GetFolderPath()
Renvoie la valeur de la fonction Microsoft Windows SHGetFolderPath et renvoie par exemple le chemin de Ma musique. Vous remarquerez que la fonction n'utilise pas les espaces de l'Explorateur Windows.

Exemples:
GetFolderPath('MyMusic') GetFolderPath('MyPictures') GetFolderPath('MyVideos') GetFolderPath('MyReceivedFiles') GetFolderPath('MyShapes') GetFolderPath('ProgramFiles') GetFolderPath('Windows')

QvdCreateTime(filename)
Renvoie la marque horaire de l'en-tte XML d'un fichier QVD s'il en existe un (sinon, renvoie NULL). Le nom de fichier (filename) est le nom d'un fichier QVD, incluant le chemin si ncessaire.

Exemples:
QvdCreateTime('MonFichier.qvd') QvdCreateTime('C:\MonRp\MonFichier.qvd')

QvdNoOfRecords(filename)
Renvoie le nombre d'enregistrements d'un fichier QVD. Le nom de fichier (filename) est le nom d'un fichier QVD, incluant le chemin si ncessaire.

Exemples:
QvdNoOfRecords ('MonFichier.qvd') QvdNoOfRecords ('C:\MonRp\MonFichier.qvd')

QvdNoOfFields(filename)

362

Renvoie le nombre de champs d'un fichier QVD. Le nom de fichier (filename) est le nom d'un fichier QVD, incluant le chemin si ncessaire.

Exemples:
QvdNoOfFields ('MonFichier.qvd') QvdNoOfFields ('C:\MonRp\MonFichier.qvd')

QvdFieldName(filename , fieldno)
Renvoie le numro du champ fieldno, s'il existe dans un fichier QVD (sinon, renvoie NULL). Le nom de fichier (filename) est le nom d'un fichier QVD, incluant le chemin si ncessaire. Le fieldno est le numro du champ ( partir de 0) dans la table que contient le fichier QVD.

Exemples:
QvdFieldName ('MonFichier.qvd', 3) QvdFieldName ('C:\MonRp\MonFichier.qvd', 5)

QvdTableName(filename)
Renvoie le nom de la table que contient un fichier QVD. Le nom de fichier (filename) est le nom d'un fichier QVD, incluant le chemin si ncessaire.

Exemples:
QvdTableName ('MonFichier.qvd') QvdTableName ('C:\MonRp\MonFichier.qvd')
Retour Other Functions.

Fonctions de la catgorie Table


Les fonctions de table renvoient des informations sur la table de donnes en cours de lecture. Si aucun nom de table n'est indiqu et que la fonction est utilise dans une instruction load, c'est la table active qui est prise en compte.

FieldName(nr ,'TableName')
Renvoie le nom du champ portant le numro indiqu dans une table dj charge. Si la fonction est utilise dans une instruction load, elle ne doit pas faire rfrence la table en cours de chargement.

Exemples:
LET a = FieldName(4,'tab1'); T1: Loada, b, c, d from abc.csv T2: Load FieldName (2, 'T1') Autogenerate 1;

FieldNumber('field ' ,'TableName')


Renvoie le numro d'un champ donn dans une table dj charge. Si la fonction est utilise dans une instruction load, elle ne doit pas faire rfrence la table en cours de chargement.

Exemples:
LET a = FieldNumber('Client','tab1'); T1: Loada, b, c, d from abc.csv

363

T2: Load FieldNumber ('b', 'T1') Autogenerate 1;

NoOfFields([ 'TableName ' ])


Renvoie le nombre de champs d'une table dj charge. Si la fonction est utilise dans une instruction load, elle ne doit pas faire rfrence la table en cours de chargement.

Exemples:
LET a = NoOfFields('tab1'); Load *, NoOfFields( ) from abc.csv;

NoOfRows(['TableName ' ])
Renvoie le nombre de lignes (enregistrements) d'une table dj charge. Si la fonction est utilise dans une instruction load, elle ne doit pas faire rfrence la table en cours de chargement.

Exemples:
LET a = NoOfRows('tab1'); Load * from abc.csv where NoOfRows( )<30;

NoOfTables()
Renvoie le nombre de tables prcdemment charges.

TableName([ 'TableNumber' ])
Renvoie le nom de la table portant le numro indiqu.

TableNumber([ 'TableName' ])
Renvoie le numro de la table spcifie. Retour Other Functions.

Fonctions de document
Ces fonctions peuvent tre utilises dans les graphiques et les scripts.

ReportComment(numro de rapport)
Renvoie le commentaire du rapport avec le numro indiqu dans le document actif.

ReportName(numro de rapport)
Renvoie le nom du rapport avec le numro indiqu dans le document actif.

ReportID(numro de rapport)
Renvoie l'identifiant du rapport avec le numro indiqu dans le document actif.

ReportNumber(id ou nom de rapport)


Renvoie le numro du rapport avec l'identifiant ou le nom indiqu dans le document actif.

NoOfReports()
Renvoie le nombre de rapports dans le document actif. Retour Other Functions.

364

Fonctions de la catgorie Date et heure


Dans les exemples suivants, les formats par dfaut de l'heure et de la date sont hh:mm:ss et AAAA-MM-JJ (normeISO) sont utiliss.

second(expr)
Secondes. Renvoie un entier reprsentant les secondes quand la fraction de expr est interprte comme une heure selon l'interprtation numrique standard.

Exemples:
second( '09:14:36' ) renvoie 36 second( '0.5555' ) renvoie 55 ( parce que 0.5555 = 13:19:55 )
Si le format de l'heure utilis ne correspond pas celui dfini dans le systme d'exploitation, QlikView ne pourra pas fournir d'interprtation correcte. Pour rsoudre ce problme, modifiez les paramtres ou utilisez la fonction d'interprtation Time# (page 914).

minute(expr)
Minutes. Renvoie un entier reprsentant les minutes quand la fraction de expr est interprte comme une heure selon l'interprtation numrique standard.

Exemples:
minute('09:14:36') renvoie 14 minute('0.5555') renvoie 19 (parce que 0.5555 = 13:19:55)
Si le format de l'heure utilis ne correspond pas celui dfini dans le systme d'exploitation, QlikView ne pourra pas fournir d'interprtation correcte. Voir ci-dessus sous second(expr) (page 365).

hour(expr)
Heures. Renvoie un entier reprsentant les heures quand la fraction de expr est interprte comme une heure selon l'interprtation numrique standard.

Exemples:
hour('09:14:36') renvoie 9 hour('0.5555') renvoie 13 (parce que 0.5555 = 13:19:55)
Si le format de l'heure utilis ne correspond pas celui dfini dans le systme d'exploitation, QlikView ne pourra pas fournir d'interprtation correcte. Voir ci-dessus sous second(expr) (page 365).

day(date)
Jour. Renvoie un entier reprsentant le jour quand la fraction de expr est interprte comme une date selon l'interprtation numrique standard.

Exemple:
day('1971-10-30' ) renvoie 30. Si le format de date utilis ne correspond pas celui dfini dans le systme d'exploitation, QlikView ne pourra pas fournir d'interprtation correcte. Pour rsoudre ce problme, modifiez les paramtres ou utilisez la fonction d'interprtation Date# (page 914).

week(date)
Numro de la semaine. Renvoie un entier reprsentant la semaine quand la fraction de expr est interprte comme une date selon l'interprtation numrique standard.

Exemple:
week('1971-10-30' ) renvoie 43.

365

Si le format de date utilis ne correspond pas celui dfini dans le systme d'exploitation, QlikView ne pourra pas fournir d'interprtation correcte. Voir ci-dessus sous day(date) (page 365).

month(date)
Mois. Renvoie une chane textuelle reprsentant le mois quand la fraction de expr est interprte comme une date, mais on peut donner un format numrique au rsultat.

Exemple:
month('1971-10-30' ) renvoie oct. Si le format de date utilis ne correspond pas celui dfini dans le systme d'exploitation, QlikView ne pourra pas fournir d'interprtation correcte. Voir ci-dessus sous day(date) (page 365).

year(date)
Anne. Renvoie un entier reprsentant l'anne quand la fraction de expr est interprte comme une date selon l'interprtation numrique standard.

Exemple:
year('1971-10-30' ) renvoie 1971.
Si le format de date utilis ne correspond pas celui dfini dans le systme d'exploitation, QlikView ne pourra pas fournir d'interprtation correcte. Voir ci-dessus sous day(date) (page 365).

weekyear(date)
Anne laquelle appartient le numro de la semaine. Le numro de la semaine est compris entre 1 et environ 52. Certaines annes, la semaine 1 commence en dcembre, par exemple dcembre 1997. D'autres annes commencent par la semaine 53 de l'anne prcdente, par exemple janvier 1999. Pour les quelques jours o le numro de la semaine appartient une autre anne, les fonctions year et weekyear renvoient des valeurs diffrentes.

Exemples:
weekyear('1996-12-30' ) renvoie 1997. weekyear('02/01/1997' ) renvoie 1997. weekyear('30/12/1997' ) renvoie 1997. weekyear('02/01/1999' ) renvoie 1998.
Si le format de date utilis ne correspond pas celui dfini dans votre systme d'exploitation, QlikView ne pourra pas fournir une interprtation correcte. Voir ci-dessus sous day(date) (page 365).

weekday(date)
Jour de la semaine. Renvoie un entier entre 0 et 6.

Exemple:
weekday('1971-10-30' ) renvoie 5. Si le format de date utilis ne correspond pas celui dfini dans votre systme d'exploitation, QlikView ne pourra pas fournir une interprtation correcte. Voir ci-dessus sous day(date) (page 365).

now([ mode_temporisateur])
Renvoie l'heure actuelle de l'horodateur. Les valeurs du mode_temporisateur peuvent tre les suivantes: 0 Heure d'excution du script 1 Heure d'appel de la fonction 2 Heure d'ouverture du document La valeur par dfaut du mode_temporisateur est gale 1. La valeur mode_temporisateur=1 doit tre utilise avec prcaution car elle interroge le systme d'exploitation toutes les secondes, ce qui est susceptible de ralentir le systme.

366

today([mode_temporisateur] )
Renvoie la date actuelle de l'horloge systme. Les valeurs du mode_temporisateur peuvent tre les suivantes: 0 Date d'excution du script 1 Date d'appel de la fonction 2 Date d'ouverture du document La valeur par dfaut du mode_temporisateur est gale 2. La valeur mode_temporisateur=1 doit tre utilise avec prcaution car elle interroge le systme d'exploitation toutes les secondes, ce qui est susceptible de ralentir le systme.

LocalTime([timezone [, ignoreDST ]])


Renvoie les date et heure (timestamp) actuelles de l'horodateur pour un fuseau horaire donn. L'argument timezone est indiqu sous la forme d'une chane contenant l'un des lieux gographiques lists sous Fuseau horaire dans le Panneau de configuration de Windows pour les Date et heure ou d'une chane au format 'GMT+hh:mm'. Si aucun fuseau horaire n'est spcifi, la fonction renverra l'heure locale. Si ignoreDST est gal -1 (vrai), l'heure d't sera ignore.

Exemples:
localtime ('Paris') localtime ('GMT+01:00') localtime ('Paris',-1) localtime()

MakeDate(AAAA [ , MM [ , JJ ] ] )
Renvoie une date calcule partir de l'anne AAAA, du mois MM et du jour JJ. Si aucun mois n'est spcifi, la fonction utilise 1 (janvier). Si aucun jour n'est spcifi, la fonction utilise 1 (le premier).

Exemples:
makedate(1999) renvoie 1999-01-01 makedate(99) renvoie 01/01/0099 makedate(1992,12) renvoie 01/12/1992 makedate(1999,2,14) renvoie 1999-02-14

MakeWeekDate(AAAA [ , SS [ , J ] ] )
Renvoie une date calcule partir de l'anne AAAA, de la semaine SS et du jour de la semaine J.

Si aucun jour de la semaine n'est spcifi, la fonction utilise 0 (lundi).

Exemples:
makeweekdate(1999,6,6) renvoie 1999-02-14 makeweekdate(1999,6) renvoie 1999-02-08

MakeTime(hh [ , mm [ , ss [ .fff ] ] ] )
Renvoie une heure calcule partir des heures hh, des minutes mm, des secondes ss avec une fraction fff pouvant aller jusqu'aux millisecondes. Si aucune minute n'est spcifie, la fonction utilise 00. Si aucune seconde n'est spcifie, la fonction utilise 00. Si aucune fraction de seconde n'est spcifie, la fonction utilise 000.

Exemples:
maketime( 22 ) renvoie 22-00-00

367

maketime( 22, 17 ) renvoie 22-17-00 maketime( 22, 17, 52 ) renvoie 22-17-52

AddMonths(startdate, n , [ , mode] )
Renvoie la date n mois aprs la date de dbut (startdate) ou, si n est un nombre ngatif, la date n mois avant la startdate. Si vous spcifiez un mode (0 si l'argument est omis), la date est dfinie soit comme le jour inchang du mois indiqu (mode=0), soit comme le jour calcul partir de la fin du mois (mode=1).

Exemples:
addmonths ('2003-01-29',3) renvoie '2003-04-29' addmonths ('2003-01-29',3,0) renvoie '2003-04-29' addmonths ('2003-01-29',3,1) renvoie '2003-04-28' addmonths ('2003-01-29',1,0) renvoie '2003-02-28' addmonths ('2003-01-29',1,1) renvoie '2003-02-26' addmonths ('2003-02-28',1,0) renvoie '2003-03-28' addmonths ('2003-02-28',1,1) renvoie '2003-03-31'

YearToDate(date [ , yearoffset [ , firstmonth [ , todaydate] ] ])


Renvoie vrai si une date tombe dans l'anne en cours; sinon, la fonction renvoie faux. Si aucun des paramtres facultatifs n'est utilis, l'anne en cours correspond toute date comprise dans une anne calendaire, du 1er janvier la date de la dernire excution du script comprise. Vous pouvez transposer la fonction en spcifiant un dcalage, yearoffset (0 si l'argument est omis), pour qu'elle renvoie vrai pour la mme priode d'une autre anne. Un dcalage (yearoffset) ngatif indique des annes passes, tandis qu'un dcalage positif indique des annes venir. La dernire anne par rapport l'anne en cours est obtenue par un dcalage yearoffset de -1. On peut avancer le dbut de l'anne au premier jour de n'importe quel mois en spcifiant un argument firstmonth entre 1 et 12 (1 si l'argument est omis). Si par exemple vous voulez travailler sur un exercice financier dbutant le premier mai, spcifiez firstmonth = 5. Vous pouvez dplacer le jour utilis comme limite suprieure de la priode en indiquant une date todaydate (date et heure de la dernire excution du script si l'argument est omis).

Exemples:
Soit la date du dernier rechargement = 1999-11-18

yeartodate( '1998-11-18') renvoie faux yeartodate( '01/02/1999' ) renvoie vrai yeartodate( '1999-11-18' ) renvoie vrai yeartodate( '19/11/1999') renvoie faux yeartodate( '1998-11-18', -1 ) renvoie vrai yeartodate( '1999-11-18', -1 ) renvoie faux yeartodate( '1999-04-30', 0, 5 ) renvoie faux yeartodate( '1999-05-01', 0, 5 ) renvoie vrai

TimeZone( )
Renvoie le nom du fuseau horaire actuel, tel qu'il est dfini dans Windows.

Exemple:
timezone( )

GMT( )

368

Renvoie l'heure du mridien de Greenwich, calcule partir de l'horloge systme et du rglage de l'heure Windows.

Exemple:
gmt( )

UTC( )
Renvoie l'heure actuelle selon le temps universel coordonne actuel.

Exemple:
utc( )

DaylightSaving( )
Renvoie l'ajustement de l'heure d't, tel qu'il est dfini dans Windows.

Exemple:
daylightsaving( )

SetDateYear (timestamp, year)


Renvoie un horodateur bas sur les date et heure (timestamp) mais en remplaant l'anne initiale par la valeur de year. timestamp est un horodateur standard de QlikView (souvent juste une date). year est une anne quatre chiffres.

Exemples:
setdateyear('2005-10-29', 2006) renvoie '2006-10-29' setdateyear ('2005-10-29 04:26', 2006) renvoie '2006-10-29 04:26'

SetDateYearMonth (timestamp, year, month)


Renvoie un horodateur bas sur timestamp mais en remplaant l'anne initiale par la valeur de year et le mois initial par la valeur de month. timestamp est un horodateur standard de QlikView (souvent juste une date). year est une anne quatre chiffres. month est un mois un ou deux chiffres.

Exemples:
setdateyearmonth ('2005-10-29', 2006, 3) renvoie '2006-03-29' setdateyearmonth ('2005-10-29 04:26', 2006, 3) renvoie '2006-03-29 04:26'

InYear (date, basedate , shift [, first_month_of_year = 1])


Renvoie vrai si la date se trouve dans l'anne qui comprend la date de base basedate. On peut dcaler l'anne l'aide de l'argument shift. Shift est un entier, o la valeur 0 indique l'anne qui comprend la date de base basedate. Les valeurs ngatives de shift indiquent les annes passes et les valeurs positives les annes venir. Si vous voulez travailler avec des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans l'argument first_month_ of_year.

Exemples:
inyear ( '2006-01-25', '2006-01-01', 0 ) renvoie vrai inyear ( '2005-01-25', '2006-01-01', 0 ) renvoie faux inyear ( '25/01/2006', '2006-01-01', -1 ) renvoie faux inyear ( '25/01/2005', '2006-01-01', -1 ) renvoie vrai inyear ( '2006-01-25', '2006-07-01', 0, 3 ) renvoie faux inyear ( '2006-03-25', '2006-07-01', 0, 3 ) renvoie vrai

InYearToDate (date, basedate , shift [, first_month_of_year = 1])

369

Renvoie vraie si la date se trouve dans la partie de l'anne qui va jusqu' la dernire milliseconde de la date de base basedate. On peut dcaler l'anne l'aide de l'argument shift. Shift est un entier, o la valeur 0 indique l'anne qui comprend la date de base basedate. Les valeurs ngatives de shift indiquent les annes passes et les valeurs positives les annes venir. Si vous voulez travailler avec des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans l'argument first_month_of_year.

Exemples:
inyeartodate ( '2006-01-25', '2006-02-01', 0 ) renvoie vrai inyeartodate ( '2006-01-25', '2006-01-01', 0 ) renvoie faux inyeartodate ( '25/01/2005', '2006-02-01', -1 ) renvoie vrai

InQuarter (date, basedate , shift [, first_month_of_year = 1])


Renvoie vrai si la date se trouve dans le trimestre qui comprend la basedate. On peut dcaler le trimestre l'aide de l'argument shift. Shift est un entier, o la valeur 0 indique le trimestre qui comprend la date de base basedate. Les valeurs ngatives de shift indiquent les trimestres passs et les valeurs positives les trimestres venir. Si vous voulez travailler avec des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans l'argument first_ month_of_year.

Exemples:
inquarter ( '2006-01-25', '2006-01-01', 0 ) renvoie vrai inquarter ( '2006-01-25', '2006-04-01', 0 ) renvoie faux inquarter ( '2006-01-25', '01/01/2006', -1 ) renvoie faux inquarter ( '25/12/2005', '2006-01-01', -1 ) renvoie vrai inquarter ( '2006-01-25', '2006-03-01', 0, 3 ) renvoie faux inquarter ( '2006-03-25', '2006-03-01', 0, 3 ) renvoie vrai

InQuarterToDate (date, basedate , shift [, first_month_of_year = 1])


Renvoie vrai si la date se trouve dans la partie du trimestre qui va jusqu' la dernire milliseconde de la date de base basedate. On peut dcaler le trimestre l'aide de l'argument shift. Shift est un entier, o la valeur 0 indique le trimestre qui comprend la date de base basedate. Les valeurs ngatives de shift indiquent les trimestres passs et les valeurs positives les trimestres venir. Si vous voulez travailler avec des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans l'argument first_month_of_year.

Exemples:
inquartertodate ( '2006-01-25', '2006-01-25', 0 ) renvoie vrai inquartertodate ( '2006-01-25', '2006-01-24', 0 ) renvoie faux inquartertodate ( '25/12/2005', '01/02/2006', -1 ) renvoie faux

InMonth (date, basedate , shift)


Renvoie vrai si la date se trouve dans le mois qui comprend la date de base basedate. On peut dcaler le mois l'aide de l'argument shift. Shift est un entier, o la valeur 0 indique le mois qui comprend la date de base basedate. Les valeurs ngatives de shift indiquent les mois passs et les valeurs positives les mois venir.

Exemples:
inmonth ( '2006-01-25', '2006-01-01', 0 ) renvoie vrai inmonth ( '2006-01-25', '2006-04-01', 0 ) renvoie faux inmonth ( '2006-01-25', '01/01/2006', -1 ) renvoie faux

370

inmonth ( '25/12/2005', '2006-01-01', -1 ) renvoie vrai

InMonthToDate (date, basedate , shift)


Renvoie vrai si la date se trouve dans la partie du mois qui comprend jusqu' la dernire milliseconde de la date de base basedate. On peut dcaler le mois l'aide de l'argument shift. Shift est un entier, o la valeur 0 indique le mois qui comprend la date de base basedate. Les valeurs ngatives de shift indiquent les mois passs et les valeurs positives les mois venir.

Exemples:
inmonthtodate ( '2006-01-25', '2006-01-25', 0 ) renvoie vrai inmonthtodate ( '2006-01-25', '2006-01-24', 0 ) renvoie faux inmonthtodate ( '2006-01-25', '28/02/2006', -1 ) renvoie vrai

InMonths (n, date, basedate , shift [, first_month_of_year = 1])


Renvoie vrai si la date se trouve dans la priode de dcalage de n mois ( partir du 1erjanvier) qui comprend la date de base basedate. N doit correspondre (1), 2, (3), 4 ou 6. On peut dcaler la priode l'aide de l'argument shift. Shift est un entier, o la valeur 0 indique la priode qui comprend la basedate. Les valeurs ngatives de shift indiquent les priodes passes et les valeurs positives les priodes venir. Si vous voulez vous aligner sur des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans l'argument first_month_of_year.

Exemples:
inmonths ( 4, '2006-01-25', '2006-01-01', 0 ) renvoie vrai inmonths ( 4, '2006-01-25', '2006-05-01', 0 ) renvoie faux inmonths ( 4, '2006-01-25', '01/01/2006', -1 ) renvoie faux inmonths ( 4, '25/12/2005', '2006-01-01', -1 ) renvoie vrai inmonths ( 4, '2006-01-25', '2006-03-01', 0, 3 ) renvoie faux inmonths ( 4, '2006-04-25', '2006-03-01', 0, 3 ) renvoie vrai

InMonthsToDate (n, date, basedate , shift [, first_month_of_year = 1])


renvoie vrai si la date se trouve dans la priode de n mois ( partir du 1erjanvier) qui va jusqu' la dernire milliseconde de la date de base (basedate).N doit correspondre (1), 2, (3), 4 ou 6. On peut dcaler la priode l'aide de l'argument shift. Shift est un entier, o la valeur 0 indique la priode qui comprend la date de base basedate. Les valeurs ngatives de shift indiquent les priodes passes et les valeurs positives les priodes venir. Si vous voulez vous aligner sur des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans l'argument first_ month_of_year.

Exemples:
inmonthstodate ( 4, '2006-01-25', '2006-04-25', 0 ) renvoie vrai inmonthstodate ( 4, '2006-04-25', '2006-04-24', 0 ) renvoie faux inmonthstodate ( 4, '25/11/2005', '01/02/2006', -1 ) renvoie vrai

InWeek (date, basedate , shift [, weekstart])


Renvoie vrai si la date se trouve dans la semaine qui comprend la date de base. On peut dcaler la semaine l'aide de l'argument shift. Shift est un entier, o la valeur 0 indique la semaine qui comprend la date de base. Les valeurs ngatives de shift indiquent les semaines passes et les valeurs positives les semaines venir. Si vous souhaitez travailler avec des semaines qui ne commencent pas minuit entre le dimanche et le lundi, indiquez un dcalage en jours dans l'argument weekstart. Il peut tre fourni sous forme de nombre rel indiquant des jours et/ou des fractions de jour.

Exemples:

371

inweek ( '2006-01-12', '2006-01-14', 0 ) renvoie vrai inweek ( '2006-01-12', '2006-01-20', 0 ) renvoie faux inweek ( '2006-01-12', '14/01/2006', -1 ) renvoie faux inweek ( '07/01/2006', '2006-01-14', -1 ) renvoie vrai inweek ( '2006-01-12', '2006-01-09', 0, 3 ) renvoie faux

InWeekToDate (date, basedate , shift [, weekstart])


renvoie vrai si la date se trouve dans la partie de la semaine qui va jusqu' la dernire milliseconde de la date de base. On peut dcaler la semaine l'aide de l'argument shift. Shift est un entier, o la valeur 0 indique la semaine qui comprend la date de base. Les valeurs ngatives de shift indiquent les semaines passes et les valeurs positives les semaines venir. Si vous souhaitez travailler avec des semaines qui ne commencent pas minuit entre le dimanche et le lundi, indiquez un dcalage en jours dans l'argument weekstart. Il peut tre fourni sous forme de nombre rel indiquant des jours et/ou des fractions de jour.

Exemples:
inweektodate ( '2006-01-12', '2006-01-12', 0 ) renvoie vrai inweektodate ( '2006-01-12', '2006-01-11', 0 ) renvoie faux inweektodate ( '2006-01-12', '05/01/2006', -1 ) renvoie faux

InLunarWeek (date, basedate , shift [, weekstart])


renvoie vrai si la date se trouve dans la semaine lunaire (priodes de 7jours conscutifs compter du 1er janvier de chaque anne) contenant la date de base. On peut dcaler la semaine lunaire l'aide de l'argument shift. Shift est un entier, o la valeur 0 indique la semaine lunaire qui comprend la date de base basedate. Les valeurs ngatives de shift indiquent les semaines lunaires passes et les valeurs positives les semaines lunaires venir. Si vous souhaitez travailler avec un dcalage au dbut des semaines lunaires, indiquez-le en jours dans l'argument weekstart. Il peut tre fourni sous forme de nombre rel indiquant des jours et/ou des fractions de jour.

Exemples:
inlunarweek ( '2006-01-12', '2006-01-14', 0 ) renvoie vrai inlunarweek ( '2006-01-12', '2006-01-20', 0 ) renvoie faux inlunarweek ( '2006-01-12', '14/01/2006', -1 ) renvoie faux inlunarweek ( '07/01/2006', '2006-01-14', -1 ) renvoie vrai inlunarweek ( '2006-01-11', '2006-01-08', 0, 3 ) renvoie faux

InLunarWeekToDate (date, basedate , shift [, weekstart])


renvoie vrai si la date se trouve dans la partie de la semaine lunaire (priodes de 7jours conscutifs compter du 1erjanvier de chaque anne) qui va jusqu' la dernire milliseconde de la date de base (basedate). On peut dcaler la semaine lunaire l'aide de l'argument shift. Shift est un entier, o la valeur 0 indique la semaine lunaire qui comprend la date de base basedate. Les valeurs ngatives de shift indiquent les semaines lunaires passes et les valeurs positives les semaines lunaires venir. Si vous souhaitez travailler avec un dcalage au dbut des semaines lunaires, indiquez-le en jours dans l'argument weekstart. Il peut tre fourni sous forme de nombre rel indiquant des jours et/ou des fractions de jour.

Exemples:
inlunarweektodate ( '2006-01-12', '2006-01-12', 0 ) renvoie vrai inlunarweektodate ( '2006-01-12', '2006-01-11', 0 ) renvoie faux inlunarweektodate ( '2006-01-12', '05/01/2006', 1 ) renvoie vrai

InDay (timestamp, basetimestamp , shift [, daystart])

372

Renvoie vrai si l'horodateur se trouve dans le jour qui comprend la basetimestamp. On peut dcaler le jour l'aide de l'argument shift. Shift est un entier, o la valeur 0 indique le jour qui comprend basetimestamp. Les valeurs ngatives de shift indiquent les jours passs et les valeurs positives les jours venir. Si vous souhaitez travailler avec des jours qui ne commencent pas minuit, indiquez un dcalage en fraction de jour dans l'argument daystart, par exemple 0,125 pour indiquer 3heures du matin.

Exemples:
inday ( '2006-01-12 12:23', '2006-01-12 00:00', 0 ) renvoie vrai inday ( '2006-01-12 12:23', '2006-01-13 00:00', 0 ) renvoie faux inday ( '2006-01-12 12:23', '12/01/2006 00:00', -1 ) renvoie faux inday ( '11/01/2006 12:23', '2006-01-12 00:00', -1 ) renvoie vrai inday ( '2006-01-12 12:23', '2006-01-12 00:00', 0, 0.5 ) renvoie faux inday ( '2006-01-12 11:23', '2006-01-12 00:00', 0, 0.5 ) renvoie vrai

InDayToTime (timestamp, basetimestamp , shift [, daystart])


Renvoie vrai si l'horodateur se trouve dans la partie du jour qui va jusqu' la milliseconde exacte de l'horodateur de base basetimestamp. On peut dcaler le jour l'aide de l'argument shift. Shift est un entier, o la valeur 0 indique le jour qui comprend basetimestamp. Les valeurs ngatives de shift indiquent les jours passs et les valeurs positives les jours venir. Si vous souhaitez travailler avec des jours qui ne commencent pas minuit, indiquez un dcalage en fraction de jour dans l'argument daystart, par exemple 0,125 pour indiquer 3heures du matin.

Exemples:
indaytotime ( '2006-01-12 12:23', '2006-01-12 23:59', 0 ) renvoie vrai indaytotime ( '2006-01-12 12:23', '2006-01-12 00:00', 0 ) renvoie faux indaytotime ( '11/01/2006 12:23', '2006-01-12 23:59', -1 ) renvoie vrai

YearStart( date [, shift = 0 [, first_month_of_year = 1]])


Renvoie une valeur correspondant un horodateur qui comprend la premire milliseconde de la premire date de l'anne contenant la date. Le format de sortie par dfaut sera le DateFormat dfini dans le script. Shift est un entier, o la valeur 0 indique l'anne qui comprend la date. Les valeurs ngatives de shift indiquent les annes passes et les valeurs positives les annes venir. Si vous voulez travailler avec des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans l'argument first_month_of_year.

Exemple:
yearstart ( '2001-10-19' ) renvoie '2001-01-01' avec une valeur numrique sous-jacente correspondant '2001-01-01 00:00:00.000' yearstart ( '2001-10-19', -1 ) renvoie '2000-01-01' avec une valeur numrique sousjacente correspondant '2000-01-01 00:00:00.000' yearstart ( '2001-10-19', 0, 4 ) renvoie '2001-04-01' avec une valeur numrique sousjacente correspondant '2001-04-01 00:00:00.000'

YearEnd( date [, shift = 0 [, first_month_of_year = 1]])


Renvoie une valeur correspondant un horodateur qui comprend la dernire milliseconde de la dernire date de l'anne contenant la date. Le format de sortie par dfaut sera le DateFormat dfini dans le script. Shift est un entier, o la valeur 0 indique l'anne qui comprend la date. Les valeurs ngatives de shift indiquent les annes passes et les valeurs positives les annes venir. Si vous

373

voulez travailler avec des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans l'argument first_month_of_year.

Exemples:
yearend ( '2001-10-19' ) renvoie '2001-12-31' avec une valeur numrique sous-jacente correspondant '2001-12-31 23:59:59.999' yearend ( '2001-10-19', -1 ) renvoie '2000-12-31' avec une valeur numrique sous-jacente correspondant '2000-12-31 23:59:59.999' yearend ( '2001-10-19', 0, 4 ) renvoie '2002-03-31' avec une valeur numrique sousjacente correspondant '2002-03-31 23:59:59.999'

YearName(date [, shift = 0 [, first_month_of_year = 1]] )


Renvoie une anne quatre chiffres comme valeur d'affichage avec une valeur numrique sousjacente correspondant un horodateur qui comprend la premire milliseconde de la premire date de l'anne contenant la date. Shift est un entier, o la valeur 0 indique l'anne qui comprend la date. Les valeurs ngatives de shift indiquent les annes passes et les valeurs positives les annes venir. Si vous voulez travailler avec des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans l'argument first_month_of_year. La valeur d'affichage sera alors une chane affichant deux annes.

Exemples:
yearname ( '2001-10-19') renvoie '2001' avec une valeur numrique sous-jacente correspondant '2001-01-01 00:00:00.000' yearname ( '2001-10-19', -1 ) renvoie '2000' avec une valeur numrique sous-jacente correspondant '2000-01-01 00:00:00.000' yearname ( '2001-10-19', 0, 4 ) renvoie '2001-2002' avec une valeur numrique sousjacente correspondant '2001-04-01 00:00:00.000'

QuarterStart(date [, shift = 0 [, first_month_of_year = 1]])


Renvoie une valeur correspondant un horodateur comprenant la premire milliseconde du trimestre contenant la date. Le format de sortie par dfaut sera le DateFormat dfini dans le script. Shift est un entier, o la valeur 0 indique le trimestre qui comprend la date. Les valeurs ngatives de shift indiquent les trimestres passs et les valeurs positives les trimestres venir. Si vous voulez travailler avec des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans l'argument first_month_of_year.

Exemples:
quarterstart ( '2005-10-29' ) renvoie '2005-10-01' avec une valeur numrique sousjacente correspondant '2005-10-01 00:00:00.000' quarterstart ( '2005-10-29', -1 ) renvoie '2005-07-01' avec une valeur numrique sous-jacente correspondant '2005-07-01 00:00:00.000' quarterstart ( '2005-10-29', 0, 3 ) renvoie '2005-09-01' avec une valeur numrique sous-jacente correspondant '2005-09-01 00:00:00.000'

QuarterEnd(date [, shift = 0 [, first_month_of_year = 1]])


Renvoie une valeur correspondant un horodateur qui comprend la dernire milliseconde du trimestre contenant la date. Le format de sortie par dfaut sera le DateFormat dfini dans le script. Shift est un entier, o la valeur 0 indique le trimestre qui comprend la date. Les valeurs ngatives de shift indiquent les trimestres passs et les valeurs positives les trimestres venir. Si vous voulez travailler avec des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans l'argument first_month_of_year.

Exemples:

374

quarterend ( '2005-10-29' ) renvoie '2005-12-31' avec une valeur numrique sous-jacente correspondant '2005-12-31 23:59:59.999' quarterend ('2005-10-29', -1) renvoie '2005-09-30' avec une valeur numrique sousjacente correspondant '2005-09-30 23:59:59.999' quarterend ( '2005-10-29', 0, 3 ) renvoie '2005-11-30' avec une valeur numrique sous-jacente correspondant '2005-11-30 23:59:59.999'

QuarterName(date [, shift = 0 [, first_month_of_year = 1]])


Renvoie une valeur affichant les mois du trimestre (formats selon la variable de script MonthNames) et l'anne avec une valeur numrique sous-jacente correspondant l'horodateur qui comprend la premire milliseconde de la premire date du trimestre. Shift est un entier, o la valeur 0 indique le trimestre qui comprend la date. Les valeurs ngatives de shift indiquent les trimestres passs et les valeurs positives les trimestres venir. Si vous voulez travailler avec des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans l'argument first_month_ of_year.

Exemples:
quartername ( '2005-10-29') renvoie 'Oct-Dc 2005' avec une valeur numrique sousjacente correspondant '2005-10-01 00:00:00.000' quartername ( '2005-10-29', -1 ) renvoie 'Juil-Sep 2005' avec une valeur numrique sous-jacente correspondant '2005-07-01 00:00:00.000' quartername ( '2005-10-29', 0, 3 ) renvoie 'Sep-Nov 2005' avec une valeur numrique sous-jacente correspondant '2005-09-01 00:00:00.000'

MonthStart(date [, shift = 0])


Renvoie une valeur correspondant un horodateur qui comprend la premire milliseconde de la premire date du mois contenant la date. Le format de sortie par dfaut sera le DateFormat dfini dans le script. Shift est un entier, o la valeur 0 indique le mois qui comprend la date. Les valeurs ngatives de shift indiquent les mois passs et les valeurs positives les mois venir.

Exemples:
monthstart ( '2001-10-19' ) renvoie '2001-10-01' avec une valeur numrique sous-jacente correspondant '2001-10-01 00:00:00.000' monthstart ( '2001-10-19', -1 ) renvoie '2001-09-01' avec une valeur numrique sousjacente correspondant '2001-09-01 00:00:00.000'

MonthEnd(date [, shift = 0])


Renvoie une valeur correspondant un horodateur qui comprend la dernire milliseconde de la dernire date du mois contenant la date. Le format de sortie par dfaut sera le DateFormat dfini dans le script. Shift est un entier, o la valeur 0 indique le mois qui comprend la date. Les valeurs ngatives de shift indiquent les mois passs et les valeurs positives les mois venir.

Exemples:
monthend ( '2001-02-19' ) renvoie '2001-02-28' avec une valeur numrique sous-jacente correspondant '2001-02-28 23:59:59.999' monthend ( '2001-02-19', -1 ) renvoie '2001-01-31' avec une valeur numrique sousjacente correspondant '2001-01-31 23:59:59.999'

MonthName(date [, shift = 0])


Renvoie une valeur affichant le mois (format selon la variable de script MonthNames) et l'anne avec une valeur numrique sous-jacente correspondant l'horodateur qui comprend la premire milliseconde de la premire date du mois. Shift est un entier, o la valeur 0 indique le mois qui

375

comprend la date. Les valeurs ngatives de shift indiquent les mois passs et les valeurs positives les mois venir.

Exemples:
monthname ( '2001-10-19' ) renvoie 'Oct 2001' avec une valeur numrique sous-jacente correspondant '2001-10-01 00:00:00.000' monthname ( '2001-10-19', -1 ) renvoie 'Sep 2001' avec une valeur numrique sousjacente correspondant '2001-09-01 00:00:00.000'

MonthsStart(n, date [, shift = 0 [, first_month_of_year = 1]])


Renvoie une valeur correspondant un horodateur qui comprend la premire milliseconde de la priode de n mois ( compter du 1erjanvier) contenant la date. Le format de sortie par dfaut sera le DateFormat dfini dans le script. N doit correspondre (1), 2, (3), 4 ou 6. Shift est un entier, o la valeur 0 indique la priode qui comprend la date. Les valeurs ngatives de shift indiquent les priodes passes et les valeurs positives les priodes venir. Si vous voulez vous aligner sur des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans l'argument first_month_of_year.

Exemples:
monthsstart ( 4, '2001-10-19' ) renvoie '2001-09-01' avec une valeur numrique sousjacente correspondant '2001-09-01 00:00:00.000' monthsstart ( 4, '2001-10-19', -1 ) renvoie '2001-05-01' avec une valeur numrique sous-jacente correspondant '2001-05-01 00:00:00.000' monthsstart ( 4, '2001-10-19', 0, 2 )renvoie '2001-10-01' avec une valeur numrique sous-jacente correspondant '2001-10-01 00:00:00.000'

MonthsEnd(n, date [, shift = 0 [, first_month_of_year = 1]])


Renvoie une valeur correspondant un horodateur qui comprend la dernire milliseconde de la priode de n mois ( compter du 1erjanvier) contenant la date. Le format de sortie par dfaut sera le DateFormat dfini dans le script. N doit tre (1), 2, (3), 4 ou 6. Shift est un entier, o la valeur 0 indique la priode qui comprend la date. Les valeurs ngatives de shift indiquent les priodes passes et les valeurs positives les priodes venir. Si vous voulez vous aligner sur des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans l'argument first_ month_of_year.

Exemples:
monthsend ( 4, '2001-07-19' ) renvoie '2001-08-31' avec une valeur numrique sousjacente correspondant '2001-08-31 23:59:59.999' monthsend ( 4, '2001-10-19', -1 ) renvoie '2001-08-31' avec une valeur numrique sous-jacente correspondant '2001-08-31 23:59:59.999' monthsend ( 4, '2001-10-19', 0, 2 ) renvoie '2002-01-31' avec une valeur numrique sous-jacente correspondant '2002-01-31 23:59:59.999'

MonthsName(n, date [, shift = 0 [, first_month_of_year = 1]])


Renvoie une valeur affichant les mois de la priode (formats selon la variable de script MonthNames) et l'anne avec une valeur numrique sous-jacente correspondant un horodateur qui comprend la premire milliseconde de la priode de n mois ( compter du 1er janvier) contenant la date. N doit tre (1), 2, (3), 4 ou 6. Shift est un entier, o la valeur 0 indique la priode qui comprend la date. Les valeurs ngatives de shift indiquent les priodes passes et les valeurs positives les priodes venir. Si vous voulez vous aligner sur des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans l'argument first_month_of_year.

Exemples:

376

monthsname ( 4, '2001-10-19' ) renvoie 'Sep-Dc 2001' avec une valeur numrique sousjacente correspondant '2001-09-01 00:00:00.000' monthsname ( 4, '2001-10-19', -1 ) renvoie 'Mai-Aot 2001' avec une valeur numrique sous-jacente correspondant '2001-05-01 00:00:00.000' monthsname ( 4, '2001-10-19', 0, 2 ) renvoie 'Oct-Jan 2002' avec une valeur numrique sous-jacente correspondant '2001-10-01 00:00:00.000'

WeekStart(date [, shift = 0 [,weekoffset = 0]])


Renvoie une valeur correspondant un horodateur qui comprend la premire milliseconde de la premire date (lundi) de la semaine calendaire contenant la date. Le format de sortie par dfaut sera le DateFormat dfini dans le script. Shift est un entier, o la valeur 0 indique la semaine qui contient la date. Les valeurs ngatives de shift indiquent les semaines passes et les valeurs positives les semaines venir. Si vous souhaitez travailler avec des semaines qui ne commencent pas minuit entre le dimanche et le lundi, indiquez un dcalage en jours dans l'argument weekoffset. Il peut tre fourni sous forme de nombre rel indiquant des jours et/ou des fractions de jour.

Exemples:
weekstart ( '2006-01-12' ) renvoie '2006-01-09' avec une valeur numrique sous-jacente correspondant '2006-01-09 00:00:00.000' weekstart ( '2006-01-12', -1 ) renvoie '2006-01-02' avec une valeur numrique sousjacente correspondant '2006-01-02 00:00:00.000' weekstart ( '2006-01-12', 0, 1 ) renvoie '2006-01-10' avec une valeur numrique sousjacente correspondant '2006-01-10 00:00:00.000'

WeekEnd(date [, shift = 0 [,weekoffset = 0]])


Renvoie une valeur correspondant un horodateur qui comprend la dernire milliseconde de la dernire date (dimanche) de la semaine calendaire contenant la date. Le format de sortie par dfaut sera le DateFormat dfini dans le script. Shift est un entier, o la valeur 0 indique la semaine qui contient la date. Les valeurs ngatives de shift indiquent les semaines passes et les valeurs positives les semaines venir. Si vous souhaitez travailler avec des semaines qui ne commencent pas minuit entre le dimanche et le lundi, indiquez un dcalage en jours dans l'argument weekoffset. Il peut tre fourni sous forme de nombre rel indiquant des jours et/ou des fractions de jour.

Exemples:
weekend ( '2006-01-12' ) renvoie 2006-01-15 avec une valeur numrique sous-jacente correspondant 2006-01-15 23:59:59.999 weekend ( '2006-01-12', -1 ) renvoie 2006-01-08 avec une valeur numrique sousjacente correspondant 2006-01-08 23:59:59.999 weekend ( '2006-01-12', 0, 1 ) renvoie 2006-01-16 avec une valeur numrique sousjacente correspondant 2006-01-16 23:59:59.999

WeekName(date [, shift = 0 [,weekoffset = 0]])


Renvoie une valeur affichant l'anne et le numro de la semaine avec une valeur numrique sousjacente correspondant un horodateur qui comprend la premire milliseconde de la premire date de la semaine contenant la date. Shift est un entier, o la valeur 0 indique la semaine qui contient la date. Les valeurs ngatives de shift indiquent les semaines passes et les valeurs positives les semaines venir. Si vous souhaitez travailler avec des semaines qui ne commencent pas minuit entre le dimanche et le lundi, indiquez un dcalage en jours dans l'argument weekoffset. Il peut tre fourni sous forme de nombre rel indiquant des jours et/ou des fractions de jour.

Exemples:

377

weekname ( '2006-01-12' ) renvoie '2006/02' avec une valeur numrique sous-jacente correspondant '2006-01-09 00:00:00.000' weekname ( '2006-01-12', -1 ) renvoie '2006/01' avec une valeur numrique sous-jacente correspondant '2006-01-02 00:00:00.000' weekname ( '2006-01-12', 0, 1 ) renvoie '2006/02' avec une valeur numrique sousjacente correspondant '2006-01-10 00:00:00.000'

LunarweekStart( date [, shift = 0 [,weekoffset = 0]])


Renvoie une valeur correspondant un horodateur qui comprend la premire milliseconde de la semaine lunaire (priodes de 7 jours conscutifs compter du 1er janvier de chaque anne) contenant la date. Le format de sortie par dfaut sera le DateFormat dfini dans le script. Shift est un entier, o la valeur 0 indique la semaine lunaire qui comprend la date. Les valeurs ngatives de shift indiquent les semaines lunaires passes et les valeurs positives les semaines lunaires venir. Si vous souhaitez travailler avec un dcalage au dbut des semaines lunaires, indiquez-le en jours dans l'argument weekoffset. Il peut tre fourni sous forme de nombre rel indiquant des jours et/ou des fractions de jour.

Exemples:
lunarweekstart ( '2006-01-12' ) renvoie '2006-01-08' avec une valeur numrique sousjacente correspondant '2006-01-08 00:00:00.000' lunarweekstart ( '2006-01-12', -1 ) renvoie '2006-01-01' avec une valeur numrique sous-jacente correspondant '2006-01-01 00:00:00.000' lunarweekstart ( '2006-01-12', 0, 1 ) renvoie '2006-01-09' avec une valeur numrique sous-jacente correspondant '2006-01-09 00:00:00.000'

LunarweekEnd(date [, shift = 0 [,weekoffset = 0]])


Renvoie une valeur correspondant un horodateur qui comprend la dernire milliseconde de la semaine lunaire (priodes de 7jours conscutifs compter du 1erjanvier de chaque anne) contenant la date. Le format de sortie par dfaut sera le DateFormat dfini dans le script. Shift est un entier, o la valeur 0 indique la semaine lunaire qui comprend la date. Les valeurs ngatives de shift indiquent les semaines lunaires passes et les valeurs positives les semaines lunaires venir. Si vous souhaitez travailler avec un dcalage au dbut des semaines lunaires, indiquez-le en jours dans l'argument weekoffset. Il peut tre fourni sous forme de nombre rel indiquant des jours et/ou des fractions de jour.

Exemples:
lunarweekend ( '2006-01-12' ) renvoie '2006-01-14' avec une valeur numrique sousjacente correspondant '2006-01-14 23:59:59.999' lunarweekend ( '2006-01-12', -1 ) renvoie '2006-01-07' avec une valeur numrique sous-jacente correspondant '2006-01-07 23:59:59.999' lunarweekend ( '2006-01-12', 0, 1 ) renvoie '2006-01-15' avec une valeur numrique sous-jacente correspondant '2006-01-15 23:59:59.999'

LunarWeekName(date [, shift = 0 [,weekoffset = 0]])


Renvoie une valeur affichant l'anne et le numro de la semaine avec une valeur numrique sousjacente correspondant un horodateur qui comprend la premire milliseconde de la premire date de la semaine lunaire (priodes de 7 jours conscutifs compter du 1erjanvier de chaque anne) contenant la date. Shift est un entier, o la valeur 0 indique la semaine lunaire qui comprend la date. Les valeurs ngatives de shift indiquent les semaines lunaires passes et les valeurs positives les semaines lunaires venir. Si vous souhaitez travailler avec un dcalage au dbut des semaines lunaires, indiquez-le en jours dans l'argument weekoffset. Il peut tre fourni sous forme de nombre rel indiquant des jours et/ou des fractions de jour.

378

Exemples:
lunarweekname ( '2006-01-12' ) renvoie 2006/02 avec une valeur numrique sousjacente correspondant 2006-01-08 00:00:00.000 lunarweekname ( '2006-01-12', -1 ) renvoie 2006/01 avec une valeur numrique sous-jacente correspondant 2006-01-01 00:00:00.000 lunarweekname ( '2006-01-12', 0, 1 ) renvoie 2006/02 avec une valeur numrique sous-jacente correspondant 2006-01-09 00:00:00.000

DayStart(timestamp [, shift = 0 [, dayoffset = 0]])


Renvoie une valeur correspondant un horodateur qui comprend la premire milliseconde du jour contenu dans timestamp. Le format de sortie par dfaut sera le TimestampFormat dfini dans le script. Shift est un entier, o la valeur 0 indique le jour qui comprend la date. Les valeurs ngatives de shift indiquent les jours passs et les valeurs positives les jours venir. Si vous souhaitez travailler avec des jours qui ne commencent pas minuit, indiquez un dcalage en fraction de jour dans l'argument dayoffset, par exemple 0,125 pour indiquer 3heures du matin.

Exemples:
daystart ( '2006-01-25 16:45' ) renvoie '2006-01-25 00:00:00' avec une valeur numrique sous-jacente correspondant '2006-01-25 00:00:000.000' daystart ( '2006-01-25 16:45', -1 ) renvoie '2006-01-24 00:00:00' avec une valeur numrique sous-jacente correspondant '2006-01-24 00:00:000.000' daystart ( '2006-01-25 16:45', 0, 0.5 ) renvoie '2006-01-25 12:00:00' avec une valeur numrique sous-jacente correspondant '2006-01-25 12:00:00:000.000'

DayEnd(timestamp [, shift = 0 [, dayoffset = 0]])


Renvoie une valeur correspondant un horodateur qui comprend la dernire milliseconde du jour contenu dans timestamp. Le format de sortie par dfaut sera le TimestampFormat dfini dans le script. Shift est un entier, o la valeur 0 indique le jour qui comprend la date. Les valeurs ngatives de shift indiquent les jours passs et les valeurs positives les jours venir. Si vous souhaitez travailler avec des jours qui ne commencent pas minuit, indiquez un dcalage en fraction de jour dans l'argument dayoffset, par exemple 0,125 pour indiquer 3heures du matin.

Exemples:
dayend ( '2006-01-25 16:45' ) renvoie '2006-01-25 23:59:59' avec une valeur numrique sous-jacente correspondant '2006-01-25 23:59:59.999' dayend ( '2006-01-25 16:45', -1 ) renvoie '2006-01-24 23:59:59' avec une valeur numrique sous-jacente correspondant '2006-01-24 23:59:59.999' dayend ( '2006-01-25 16:45', 0, 0.5 ) renvoie '2006-01-26 11:59:59' avec une valeur numrique sous-jacente correspondant '2006-01-26 11:59:59.999'

DayName(timestamp [, shift = 0 [, dayoffset = 0]])


Renvoie une valeur affichant la date avec une valeur numrique sous-jacente correspondant l'horodateur qui comprend la premire milliseconde du jour contenant l'horodateur timestamp. Shift est un entier, o la valeur 0 indique le jour qui comprend la date. Les valeurs ngatives de shift indiquent les jours passs et les valeurs positives les jours venir. Si vous souhaitez travailler avec des jours qui ne commencent pas minuit, indiquez un dcalage en fraction de jour dans l'argument dayoffset, par exemple 0,125 pour indiquer 3heures du matin.

Exemples:
dayname ( '2006-01-25 16:45' ) renvoie '2006-01-25' avec une valeur numrique sous-jacente correspondant '2006-01-25 00:00:00.000'

379

dayname ( '2006-01-25 16:45', -1 ) renvoie '2006-01-24' avec une valeur numrique sous-jacente correspondant '2006-01-24 00:00:00.000' dayname ('2006-01-25 16:45', 0, 0.5) renvoie '2006-01-25' avec une valeur numrique sous-jacente correspondant '2006-01-25 12:00:00.000'

age(timestamp, date_of_birth)
Renvoie l'ge correspondant la valeur timestamp (en annes) d'une personne ne le jour dfini par la valeur date_of_birth.

Exemples:
age('2007-01-25', '2005-10-29') renvoie 1 age('29/10/2007', '2005-10-29') renvoie 2

networkdays (start:date, end_date {, holiday})


Renvoie le nombre de jours ouvrables (du lundi au vendredi) entre les valeurs date de dbut et date de fin (incluses) en prenant en compte tout jour fri indiqu (facultatif). Tous les paramtres doivent correspondre des dates ou horodateurs valides.

Exemples:
networkdays ('2007-02-19', '2007-03-01') renvoie 9 networkdays ('2006-12-18', '2006-12-31', '2006-12-25', '2006-12-26') renvoie 8

firstworkdate(end_date, no_of_workdays {, holiday} )


Renvoie la dernire date de dbut pour raliser la valeur number_of_workdays (du lundi au vendredi) se terminant au plus tard la date dfinie par la valeur end_date en prenant en compte tout jour de cong indiqu. Les valeurs end_date et holiday doivent correspondre des dates ou des horodateurs valides.

Exemples:
firstworkdate ('2007-03-01', 9) renvoie '2007-02-19' firstworkdate ('2006-12-31', 8, '2006-12-25', '2006-12-26') renvoie '200612-18'

lastworkdate(start_date, no_of_workdays {, holiday})


Renvoie la premire date de fin permettant de raliser la valeur number_of_workdays (du lundi au vendredi) si celle-ci commence la date dfinie par start_date en prenant en compte tout jour de cong dfini facultatif (holiday). Les valeurs Start_date et holiday doivent correspondre des dates ou des horodateurs valides.

Exemples:
lastworkdate ('2007-02-19', 9) renvoie '2007-03-01' lastworkdate ('2006-12-18', 8, '2006-12-25', '2006-12-26') renvoie '2006-1229'

ConvertToLocalTime(timestamp [, place [, ignore_dst=false]])


Convertit un horodateur UTC ou GMT en heure locale sous la forme d'une valeur double. Il peut s'agir de n'importe quels villes, rgions ou fuseaux horaires dans le monde.

Rgions et fuseaux horaires valides: Abou Dabi, Adlade, Alaska, Almaty, Amsterdam, Arizona, Astana, Athnes, heure atlantique (Canada), Auckland, Aores, Bagdad, Bakou, Bangkok, Pkin, Belgrade, Berlin, Berne, Bogot, Brasilia, Bratislava, Brisbane, Bruxelles, Bucarest, Budapest, Buenos Aires, Le Caire, Canberra, Cap-

380

Vert, Caracas, Casablanca, Amrique centrale, heure centrale (tats-Unis et Canada), Chennai, Chihuahua, Chongqing, Copenhague, Darwin, Dhk, heure de l'Est (tats-Unis et Canada), dimbourg, Iekaterinbourg, Fiji, Georgetown, Groenland, temps moyen de Greenwich: Dublin, Guadalajara, Guam, Hano, Harare, Hawaii, Helsinki, Hobart, Hong Kong, Indiana (Est), ct Ouest de la ligne de changement de date, Irkutsk, Islamabad, Istanbul, Jakarta, Jrusalem, Kaboul, Kamchatka, Karachi, Katmandou, Calcutta, Krasnoarsk, Kuala Lumpur, Kowet, Kiev, La Paz, Lima, Lisbonne, Ljubljana, Londres, Madrid, Magadan, les Marshall, Mazatln, Melbourne, Mexico, rgion mdio-atlantique, Atoll de Midway, Minsk, Monrovia, Monterrey, Moscou, heure des rocheuses (tats-Unis et Canada), Bombay, Mascate, Nairobi, Nouvelle-Caldonie, New Delhi, Terre-Neuve, Novossibirsk, Nuku'alofa, Nukualofa, Osaka, heure du pacifique (tats-Unis et Canada), Paris, Perth, Port Moresby, Prague, Pretoria, Quito, Rangoon, Riga, Riyad, Rome, Samoa, Santiago, Sapporo, Sarajevo, Saskatchewan, Soul, Singapour, Skopje, Sofia, les Salomon, Sri Jayawardenepura, SaintPtersbourg, Stockholm, Sydney, Taipei, Tallinn, Tachkent, Tbilissi, Thran, Tijuana, Tokyo, Ulaan Bataar, Urumchi, Varsovie, Wellington, Afrique centrale occidentale, Vienne, Vilnius, Vladivostok, Volgograd, Iakoutsk, Erevan ou Zagreb. Mais galement GMT, GMT-01:00, GMT+04:00, etc. L'heure rsultante est ajuste en fonction de l'heure d't, sauf si le troisime paramtre est dfini sur 1 ou true().

Exemples:
ConvertToLocalTime('2007-11-10 23:59:00','Paris') renvoie '2007-11-11 00:59:00', ainsi que l'horodateur interne correspondant. ConvertToLocalTime(UTC(), 'GMT-05:00') renvoie l'heure de la cte Est des tats-Unis (NewYork).

DayNumberOfYear(date[,firstmonth])
Renvoie le numro du jour de l'anne en fonction d'un horodateur avec la premire milliseconde du premier jour de l'anne contenant date. La fonction utilise toujours des annes bases sur 366jours. On peut avancer le dbut de l'anne au premier jour de n'importe quel mois en spcifiant un argument premier mois entre 1 et 12 (1 si l'argument est omis). Si par exemple vous voulez travailler sur un exercice fiscal dbutant le premier mars, spcifiez firstmonth = 3.

Exemples:
DayNumberOfYear(date) renvoie le numro de jour compter du premier jour de l'anne. DayNumberOfYear(date,3) renvoie le numro de jour compter du premier mars.

DayNumberOfQuarter(date[,firstmonth])
Renvoie le numro du jour du trimestre en fonction d'un horodateur avec la premire milliseconde du premier jour du trimestre contenant date. La fonction utilise toujours des annes bases sur 366jours. On peut avancer le dbut de l'anne au premier jour de n'importe quel mois en spcifiant un argument premier mois entre 1 et 12 (1 si l'argument est omis). Si par exemple vous voulez travailler sur un exercice fiscal dbutant le premier mars, spcifiez firstmonth = 3.

Exemples:
DayNumberOfQuarter(Date) renvoie le numro de jour du trimestre compter du premier jour du premier trimestre. DayNumberOfQuarter(Date,3) renvoie le numro de jour du trimestre compter du premier mars.
Retour Other Functions.

381

Variables d'interprtation de nombres


Les variables suivantes sont dfinies par le systme, c'est--dire qu'elles sont automatiquement gnres en fonction des paramtres du systme d'exploitation en vigueur la cration d'un document. Les variables d'interprtation numriques sont incluses au dbut du script du nouveau document QlikView et peuvent remplacer les paramtres par dfaut du systme d'exploitation pour certains rglages de formatage numrique au moment de l'excution du script. Elles peuvent tre supprimes, modifies ou dupliques librement.

ThousandSep
Le sparateur de milliers dfini remplace le symbole de groupement des chiffres du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set ThousandSep=','; (par exemple, sept milliards doit tre spcifi sous la forme: 7.000.000.000)

DecimalSep
Le sparateur dcimal dfini remplace le symbole dcimal du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set DecimalSep='.';

MoneyThousandSep
Le sparateur de milliers dfini remplace le symbole de groupement des chiffres du systme d'exploitation pour les devises (Paramtres rgionaux).

Exemple:
Set MoneyThousandSep=',';

MoneyDecimalSep
Le sparateur dcimal dfini remplace le symbole dcimal du systme d'exploitation pour les devises (Paramtres rgionaux).

Exemple:
Set MoneyDecimalSep='.';

MoneyFormat
Le symbole dfini remplace le symbole montaire du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set MoneyFormat='$ #,##0.00; ($ #,##0.00)';

TimeFormat
Le format dfini remplace le format de l'heure du systme d'exploitation (Paramtres rgionaux).

Exemple:

382

Set TimeFormat='hh:mm:ss';

DateFormat
Le format dfini remplace le format de date du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set DateFormat='j/M/aa';

TimestampFormat
Le format dfini remplace les formats de date et heure du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set TimestampFormat='M/D/YY hh:mm:ss[.fff]';

MonthNames
Le format dfini remplace la convention portant sur les noms de mois du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set MonthNames='jan;fv;mar;avr;mai;jui;juil;ao;sep;oct;nov;dc';

LongMonthNames
Le format dfini remplace la convention portant sur les noms de mois longs du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set LongMonthNames='janvier;fvrier;mars;avril;mai;juin - -

DayNames
Le format dfini remplace la convention portant sur les noms des jours de la semaine du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set DayNames='lun;mar;mer;jeu;ven;sam;dim';

LongDayNames
Le format dfini remplace la convention portant sur les noms complets des jours de la semaine du systme d'exploitation (Paramtres rgionaux).

Exemple:
Set LongDayNames='lundi;mardi;mercredi;jeudi;vendredi;samedi;dimanche';
Retour Other Functions.

383

Fonctions de la catgorie Formatage


Les fonctions de formatage dterminent le format d'affichage des champs ou des expressions. Avec ces fonctions, on peut dfinir le sparateur dcimal, le sparateur de milliers, etc. Le plus facile pour formater les nombres, les heures et les dates est cependant d'utiliser la bote de dialogue Proprits du document: Nombre (page 472).

Remarque Pour des raisons de clart, toutes les reprsentations numriques sont donnes avec le point comme sparateur dcimal.
Retour Other Functions.

Num
num(expression [ , format-code [ , decimal-sep [ , thousands-sep ] ] ] )
La fonction num formate l'expression numriquement selon la chane fournie comme format-code. Les troisime et quatrime paramtres peuvent dterminer le sparateur dcimal et le sparateur de milliers. Si les paramtres 2-4 sont omis, c'est le format de nombres dfini dans le systme d'exploitation qui est utilis.

Exemple:
Les exemples ci-dessous supposent les deux rglages suivants dans le systme d'exploitation:
Rglage par dfaut 1 Rglage par dfaut 2 Format des nombres # ##0,# #,##0.#

num(A, '0.0' ) o A=35648.375 renvoie:


Rglage1 Chane Nombre 35 648 375 35648375 Rglage2 35648,375 35648,375

num(A, '#,##0.##', '.' , ',' ) o A=35648 renvoie:


Rglage1 Chane Nombre 35648,00 35648 Rglage2 35648,00 35648

num( pi( ), '0,00' ) renvoie :


Rglage1 Chane Nombre 3,14 3,141592653 Rglage2 003 3,141592653

384

Retour Other Functions.

Montaire
money(expression [ , format-code [ , decimal-sep [ , thousands-sep ] ] ])
La fonction money formate l'expression numriquement selon la chane fournie comme code-format. Les troisime et quatrime paramtres peuvent dterminer le sparateur dcimal et le sparateur de milliers. Si les paramtres 2-4 sont omis, c'est le format de nombres dfini dans le systme d'exploitation qui est utilis.

Exemples:
Les exemples ci-dessous supposent les deux rglages suivants dans le systme d'exploitation:
Rglage par dfaut 1 Rglage par dfaut 2 Format montaire kr # ##0,00 $ #,##0.00

money(A ) o A=35648 renvoie:


Rglage1 Chane Nombre kr 35 648,00 35648,00 Rglage2 $ 35 648,00 35648,00

money(A, '#,##0 ', '.' , ',' ) o A=3564800 renvoie:


Rglage1 Chane Nombre 3,564,800 3564800 Rglage2 3,564,800 3564800

Retour Other Functions.

Date
date(expression [ , code-format ])
La fonction date formate l'expression sous la forme d'une date selon la chane fournise comme code-format. Si le code de format est omis, c'est le format de date dfini dans le systme d'exploitation qui est utilis.

Exemples:
Les exemples ci-dessous supposent les deux rglages suivants dans le systme d'exploitation:
Rglage par dfaut 1 Rglage par dfaut 2 Format de date AA-MM-JJ M/J/AA

date(A ) o A=35648 renvoie:


Rglage1 Rglage2

385

Chane Nombre

97-08-06 35648

8/6/97 35648

date(A, 'YY.MM.DD' ) o A=35648 renvoie:


Rglage1 Chane Nombre 97-08-06 35648 Rglage2 97-08-06 35648

date( A, 'JJ.MM.AA' ) o A=35648.375 renvoie:


Rglage1 Chane Nombre 06.08.1997 35648,375 Rglage2 06.08.1997 35648,375

date(A, 'YY.MM.DD' ) o A=8/6/97 renvoie:


Rglage1 Chane Nombre NULL(rien) NULL Rglage2 97.08.06 35648

Retour Other Functions.

Time
time(expression [ , code-format ])
La fonction time formate l'expression sous la forme d'une heure selon la chane fournie comme code de format. Si le code de format est omis, c'est le format de temps dfini dans le systme d'exploitation qui est utilis.

Exemples:
Les exemples ci-dessous supposent les deux rglages suivants dans le systme d'exploitation:
Rglage par dfaut 1 Rglage par dfaut 2 Format d'heure hh:mm:ss hh.mm.ss

time( A ) o A=0.375 renvoie:


Rglage1 Chane Nombre 09:00:00 0,375 Rglage2 09.00.00 0,375

386

time( A ) o A=35648.375 renvoie:


Rglage1 Chane Nombre 09:00:00 35648,375 Rglage2 09.00.00 35648,375

time( A, 'hh-mm' ) o A=0.99999 renvoie:


Rglage1 Chane Nombre 23-59 0,99999 Rglage2 23-59 0,99999

Retour Other Functions.

Dual
dual( s , x )
Association force d'une reprsentation de chane arbitraire s une reprsentation numrique donne x. Dans QlikView, lorsque plusieurs lments de donnes lus dans un champ ont diffrentes reprsentations de chane mais la mme reprsentation numrique valide, ils partagent tous la premire reprsentation de chane rencontre. La fonction dual est gnralement utilise au dbut du script, avant que d'autres donnes ne soient lues dans le champ concern, afin de crer cette premire reprsentation de chane qui sera affiche dans les listes de slection, etc.

Exemple:
load dual ( string,numrep ) as JourSemaine inline [ string,numrep Lundi,0 Mardi,1 Mercredi,2 Jeudi,3 Vendredi,4 Samedi,5 Dimanche,6 ]; load Date, weekday(Date) as JourSemaine from unfichier.csv;
Cet exemple de script gnre un champ JourSemaine avec les jours de la semaine crits en toutes lettres. QlikView considrera toujours ce champ comme un champ numrique. Retour Other Functions.

Intervalle
interval(expression [ , code-format ])
La fonction interval formate l'expression comme un intervalle de temps selon la chane fournie comme codeformat. Si le code de format est omis, c'est le format de temps dfini dans le systme d'exploitation qui est

387

utilis. Les intervalles peuvent prendre la forme d'une heure, de jours ou d'une combinaison de jours, d'heures, de minutes, de secondes et de fractions de secondes.

Exemples:
Les exemples ci-dessous supposent les rglages suivants dans le systme d'exploitation:
Format de date abrg: Format de l'heure: AA-MM-JJ hh:mm:ss

Sparateur dcimal des nombres: .

interval(A ) o A=0.375 renvoie:

Chane Nombre

09:00:00 0,375

interval(A ) o A=1.375 renvoie:

Chane Nombre

33:00:00 1,375

interval(A, 'D hh:mm' ) o A=1.375 renvoie:

Chane Nombre

1 09:00 1,375

interval( A-B, 'D hh:mm' ) o A=97-08-06 09:00:00 et B=96-08-06 00:00:00 renvoie :

Chane Nombre

365 09:00 365,375

Retour Other Functions.

Timestamp
timestamp(expression [ , format-code ])
La fonction timestamp formate l'expression comme une date et une heure selon la chane fournie comme code-format. Si le code de format est omis, ce sont les formats de date et d'heure dfinis dans le systme d'exploitation qui sont utiliss.

388

Exemples:
Les exemples ci-dessous supposent les deux rglages suivants dans le systme d'exploitation: Rglage par dfaut 1 Format de date Format d'heure
AA-MM-JJ hh:mm:ss

Rglage par dfaut 2


M/J/AA hh:mm:ss

timestamp( A ) o A=35648.375 renvoie:


Rglage1 Chane Nombre
97-08-06 09:00:00 35648,375

Rglage2
8/6/97 09:00:00 35648,375

timestamp( A, 'AAAA-MM-JJ hh.mm') o A=35648 renvoie:


Rglage1 Chane Nombre
1997-08-06 00.00 35648

Rglage2
1997-08-06 00.00 35648

Retour Other Functions.

Fonctions de la catgorie Couleur


Ces fonctions peuvent tre utilises dans des expressions de couleur pour les proprits des objets prenant en charge les couleurs calcules dans les graphiques. Les fonctions RBG, HSL et syscolor renvoient toujours une couleur avec la valeur alpha 255 (opaque). Toutes les couleurs peuvent possder un paramtre pour le facteur alpha. Un alpha de 0 correspond la transparence totale. Un alpha de 255 correspond l'opacit totale.

color (n)
Cette fonction renvoie la couleur reprsente par le nombre n dans la palette graphique pertinente. Cette reprsentation de la couleur est une valeur double dont la reprsentation textuelle apparat sous la forme 'RGB(r, g, b)' o r, g et b sont des nombres compris entre 0 et 255 reprsentant respectivement les couleurs rouge, verte et bleue. La reprsentation numrique est un entier reprsentant les composants rouge, vert et bleu, tels qu'ils sont dfinis dans Visual Basic. En dehors de l'expression de couleur calcule dans la bote de dialogue Proprits du graphique: Couleurs (page 697), la valeur de l'expression de couleur sera toujours le noir.

RGB (e1, e2, e3 )


Cette fonction renvoie la reprsentation d'une couleur dfinie par le composant rouge e1, le composant vert e2 et le composant bleu e3. Les trois paramtres doivent tre des expressions values sur des entiers compris entre 0 et 255. Cette reprsentation de la couleur est une valeur double dont la reprsentation textuelle apparat sous la forme 'RGB(r, g, b)' o r, g et b sont des nombres compris entre 0 et 255 reprsentant

389

respectivement les couleurs rouge, verte et bleue. La reprsentation numrique est un entier reprsentant les composants rouge, vert et bleu, tels qu'ils sont dfinis dans Visual Basic.

ARGB(alpha, e1, e2, e3)


Cette fonction renvoie la reprsentation d'une couleur dfinie par le composant rouge e1, le composant vert e2 et le composant bleu e3, avec un facteur alpha (opacit). Les quatre paramtres doivent tre des expressions values sur des entiers compris entre 0 et 255. Cette reprsentation de la couleur est une valeur double dont la reprsentation textuelle apparat sous la forme 'RGB(a, r, g, b)' o a, r, g et b sont des nombres compris entre 0 et 255 reprsentant respectivement les couleurs alpha, rouge, verte et bleue. La reprsentation numrique est un entier reprsentant les composants alpha, rouge, vert et bleu, tels qu'ils sont dfinis dans Visual Basic.

HSL (teinte, saturation, luminosit)


Cette fonction renvoie la reprsentation d'une couleur dfinie par une teinte entre 0 et 1, une valeur de saturation entre 0 et 1 et une valeur de luminosit galement entre 0 et 1. Cette reprsentation de la couleur est une valeur double dont la reprsentation textuelle apparat sous la forme 'RGB(r, g, b)' o r, g et b sont des nombres compris entre 0 et 255 reprsentant respectivement les couleurs rouge, verte et bleue. La reprsentation numrique est un entier reprsentant les composants rouge, vert et bleu, tels qu'ils sont dfinis dans Visual Basic.

black( )
Renvoie la reprsentation RVB pour le noir (RGB 0,0,0). Il est possible d'attribuer un paramtre au facteur alpha. Un facteur alpha gal 0 correspond la transparence totale. Un facteur alpha gal 255 correspond l'opacit totale.

darkgray( )
Renvoie la reprsentation RVB pour le gris fonc (RGB 128,128,128). Il est possible d'attribuer un paramtre au facteur alpha. Un facteur alpha gal 0 correspond la transparence totale. Un facteur alpha gal 255 correspond l'opacit totale.

lightgray( )
Renvoie la reprsentation RVB pour le gris clair (RGB 192,192,192). Il est possible d'attribuer un paramtre au facteur alpha. Un facteur alpha gal 0 correspond la transparence totale. Un facteur alpha gal 255 correspond l'opacit totale.

white( )
Renvoie la reprsentation RVB pour le blanc (RGB 255,255,255). Il est possible d'attribuer un paramtre au facteur alpha. Un facteur alpha gal 0 correspond la transparence totale. Un facteur alpha gal 255 correspond l'opacit totale.

blue( )
Renvoie la reprsentation RVB pour le bleu (RGB 0,0,128). Il est possible d'attribuer un paramtre au facteur alpha. Un facteur alpha gal 0 correspond la transparence totale. Un facteur alpha gal 255 correspond l'opacit totale.

lightblue( )
Renvoie la reprsentation RVB pour le bleu clair (RGB 0,0,255). Il est possible d'attribuer un paramtre au facteur alpha. Un facteur alpha gal 0 correspond la transparence totale. Un facteur alpha gal 255 correspond l'opacit totale.

green( )

390

Renvoie la reprsentation RVB pour le vert (RGB 0,128,0). Il est possible d'attribuer un paramtre au facteur alpha. Un facteur alpha gal 0 correspond la transparence totale. Un facteur alpha gal 255 correspond l'opacit totale.

lightgreen( )
Renvoie la reprsentation RVB pour le vert clair (RGB 0,255,0). Il est possible d'attribuer un paramtre au facteur alpha. Un facteur alpha gal 0 correspond la transparence totale. Un facteur alpha gal 255 correspond l'opacit totale.

cyan( )
Renvoie la reprsentation RVB pour le cyan (RGB 0,128,128). Il est possible d'attribuer un paramtre au facteur alpha. Un facteur alpha gal 0 correspond la transparence totale. Un facteur alpha gal 255 correspond l'opacit totale.

lightcyan( )
Renvoie la reprsentation RVB pour le cyan clair (RGB 0,255,255). Il est possible d'attribuer un paramtre au facteur alpha. Un facteur alpha gal 0 correspond la transparence totale. Un facteur alpha gal 255 correspond l'opacit totale.

red( )
Renvoie la reprsentation RVB pour le rouge (RGB 128,0,0). Il est possible d'attribuer un paramtre au facteur alpha. Un facteur alpha gal 0 correspond la transparence totale. Un facteur alpha gal 255 correspond l'opacit totale.

lightred( )
Renvoie la reprsentation RVB pour le rouge clair (RGB 255,0,0). Il est possible d'attribuer un paramtre au facteur alpha. Un facteur alpha gal 0 correspond la transparence totale. Un facteur alpha gal 255 correspond l'opacit totale.

magenta( )
Renvoie la reprsentation RVB pour le magenta (RGB 128,0,128). Il est possible d'attribuer un paramtre au facteur alpha. Un facteur alpha gal 0 correspond la transparence totale. Un facteur alpha gal 255 correspond l'opacit totale.

lightmagenta( )
Renvoie la reprsentation RVB pour le magenta clair (RGB 255,0,255). Il est possible d'attribuer un paramtre au facteur alpha. Un facteur alpha gal 0 correspond la transparence totale. Un facteur alpha gal 255 correspond l'opacit totale.

brown( )
Renvoie la reprsentation RVB pour le brun (RGB 128,128,0). Il est possible d'attribuer un paramtre au facteur alpha. Un facteur alpha gal 0 correspond la transparence totale. Un facteur alpha gal 255 correspond l'opacit totale.

yellow( )
Renvoie la reprsentation RVB pour le jaune (RGB 255,255,0). Il est possible d'attribuer un paramtre au facteur alpha. Un facteur alpha gal 0 correspond la transparence totale. Un facteur alpha gal 255 correspond l'opacit totale.

qliktechblue( )
Renvoie la reprsentation RVB pour le bleu QlikTech (RGB 8,18,90). Il est possible d'attribuer un paramtre au facteur alpha. Un facteur alpha gal 0 correspond la transparence totale. Un facteur alpha gal 255 correspond l'opacit totale.

qliktechgray( )

391

Renvoie la reprsentation RVB pour le gris QlikTech (RGB 158,148,137).

colormix1(Valeur, CouleurZro, CouleurUne)


Cette fonction renvoie une reprsentation RVB partir d'un dgrad de deux couleurs, bas sur une valeur (value) comprise entre 0 et 1. Si value = 0, la premire couleur est renvoye. Si value = 1, la deuxime couleur est renvoye. Si 0 < value < 1, l'ombre intermdiaire approprie est renvoye.

Valeur est un nombre rel compris entre 0 et 1. CouleurZro est une reprsentation RVB valide correspondant l'extrmit infrieure de l'intervalle. CouleurUne est une reprsentation RVB valide correspondant l'extrmit suprieure de l'intervalle.

Exemple:
colormix1(x, black( ) , red( ) )

Colormix2(Value , CouleurMoinsUne , CouleurUne[ , CouleurZro])


Cette fonction renvoie une reprsentation RVB partir d'un dgrad de deux couleurs, avec la possibilit de spcifier une couleur intermdiaire centrale, base sur une valeur (value) comprise entre -1 et 1. Si value = -1, la premire couleur est renvoye. Si value = 1, la deuxime couleur est renvoye. Si -1 < value < 1, l'ombre intermdiaire approprie est renvoye.

Valeur est un nombre rel compris entre -1 et 1. CoulorMoinsUne est une reprsentation RVB valide correspondant l'extrmit infrieure de l'intervalle. CouleurUne est une reprsentation RVB valide correspondant l'extrmit suprieure de l'intervalle. CouleurZro est une reprsentation RVB valide facultative correspondant au centre de l'intervalle.

Exemples:
colormix2(x, red( ) , green( ) ) colormix2(x, red( ) , green( ), black( ) )
Le premier exemple renvoie les couleurs d'un dgrad du rouge au vert, en passant par le brun. Le second exemple renvoie un dgrad du rouge au vert, en passant par le noir.

syscolor(nr)
Renvoie la reprsentation RVB de la couleur systme Windows nr, o nr correspond au paramtre de la fonction API de Windows GetSysColor(nr). Des valeurs possibles pour nr sont:

0 correspond COLOR_SCROLLBAR 1 correspond COLOR_BACKGROUND 2 correspond COLOR_ACTIVECAPTION 3 correspond COLOR_INACTIVECAPTION 4 correspond COLOR_MENU 5 correspond COLOR_WINDOW 6 correspond COLOR_WINDOWFRAME 7 correspond COLOR_MENUTEXT 8 correspond COLOR_WINDOWTEXT 9 correspond COLOR_CAPTIONTEXT 10 correspond COLOR_ACTIVEBORDER

392

11 correspond COLOR_INACTIVEBORDER 12 correspond COLOR_APPWORKSPACE 13 correspond COLOR_HIGHLIGHT 14 correspond COLOR_HIGHLIGHTTEXT 15 correspond COLOR_BTNFACE 16 correspond COLOR_BTNSHADOW 17 correspond COLOR_GRAYTEXT 18 correspond COLOR_BTNTEXT 19 correspond COLOR_INACTIVECAPTIONTEXT 20 correspond COLOR_BTNHIGHLIGHT 21 correspond COLOR_3DDKSHADOW 22 correspond COLOR_3DLIGHT 23 correspond COLOR_INFOTEXT 24 correspond COLOR_INFOBK 26 correspond COLOR_HOTLIGHT (Win2000) 27 correspond COLOR_GRADIENTACTIVECAPTION (Win2000) 28 correspond COLOR_GRADIENTINACTIVECAPTION (Win2000)
Retour Other Functions.

393

394

26 Structures de donnes
26.1 Instructions de chargement de donnes
Les donnes sont charges par des instructions load ou select. Chacune de ces instructions gnre une table interne. Une table peut toujours tre visualise sous forme de liste, chaque enregistrement (ligne) tant alors un nouvel exemplaire du type d'objet et chaque champ (colonne) tant un attribut ou une proprit propre l'objet.

Rgles :
QlikView ne fait aucune diffrence entre des tables gnres par une instruction load et des tables gnres par une instruction select. Par consquent, si on charge plusieurs tables, peu importe qu'on le fasse par des instructions load ou select, ou mme par un mlange des deux. L'ordre des champs dans l'instruction ou dans la table d'origine de la base de donnes est, pour la logique QlikView, arbitraire. Les noms de champs servent identifier les champs lors des traitements ultrieurs et effectuer des associations. Ils tiennent compte de la casse. Il est donc souvent ncessaire de renommer des champs dans le script. Voir Renommer des champs (page 399).

26.2 Excution du script


Pour une instruction load ou select habituelle, l'ordre des vnements est peu prs le suivant : 1. valuation des expressions 2. Changement de nom des champs par l'utilisation de as 3. Changement de nom des champs par l'utilisation de alias 4. Qualification des noms de champ 5. Mappage des donnes si les noms des champs correspondent 6. Stockage des donnes dans une table interne

26.3 Champs systme


En plus des champs extraits de la source de donnes, QlikView produit galement des champs systme. Ils commencent tous par $ et peuvent tre affichs dans des listes de slection, comme des champs ordinaires. Les champs systme qui sont en gnral crs pendant l'excution du script sont essentiellement utiliss comme une aide la conception du document. Vous pouvez afficher les champs systme suivants:

$Table

Affiche toutes les tables internes charges par le script. Quand une seule table est slectionne, un symbole d'information devient actif dans la barre de titre de la liste de slection. En cliquant ici, il est possible d'afficher la table si elle provient d'un fichier. Affiche les champs lus partir des tables. Si vous dfinissez cette liste de slection sur Afficher la frquence la page Proprits de la liste de slection: Gnral, il est facile de dtecter les champs cls qui apparaissent dans plusieurs tables internes.

$Field

395

$Fields

Les nombres que l'on trouve dans cette liste de slection reprsentent le nombre de champs dans diffrentes tables. Cette liste de slection affiche la position des champs dans les tables. Cette liste de slection affiche le nombre de lignes dans les tables. Si des tables d'informations ont t incluses au document, leurs noms s'affichent ici.

$FieldNo $Rows $Info

Astuce: Un outil trs pratique considrer est la table systme, tableau crois dynamique qui comprend les deux dimensions $Field et $Table, ainsi que l'expression only($Field). Demandez au logiciel de crer automatiquement cette table l'aide de la commande: Disposition: Nouvel objet de feuille, Table systme.

26.4 Tables logiques


Toute instruction load ou select gnre une table. Normalement, QlikView traite leur rsultat comme une table logique. Cependant, il existe quelques exceptions cette rgle :
l

Si deux instructions ou plus produisent des noms de champs identiques, les tables sont concatnes et traites comme une seule table logique. Si une instruction load ou select est prcde de l'un des qualificateurs suivants, les donnes sont modifies ou traites diffremment:

concatenate
cette table est ajoute (concatne) la dernire table logique cre.

crosstable
cette table est convertie du format de tableau crois au format en colonnes.

generic
cette table est divise en plusieurs autres tables logiques.

info
cette table est charge non comme table logique mais comme table d'informations contenant des liens vers des informations externes, telles que des fichiers, des sons, des URL, etc.

intervalmatch
la table (qui doit contenir exactement deux colonnes) reprsente des intervalles numriques, qui sont associs des nombres discontinus dans un champ donn.

join
cette table est jointe par QlikView la table logique cre auparavant, par les champs qu'elles ont en commun.

mapping
cette table (qui doit contenir exactement deux colonnes) est lue comme une table de mappage, qui n'est jamais associe d'autres tables.

396

semantic
cette table est charge non comme une table logique mais comme une table smantique contenant des relations qui ne doivent pas tre jointes, par exemple prdcesseur, successeur et autres rfrences d'autres objets du mme type. Quand les donnes ont t charges, les tables logiques sont associes. Les tables logiques et les associations sont visibles dans la bote de dialogue Visionneur de tables, voir Visionneur de tables (page 194).

26.5 Associations entre tables logiques


Associations de donnes
Une base de donnes peut avoir de nombreuses tables. Chaque table peut tre considre comme une liste d'lments, c'est--dire que chaque enregistrement de la liste reprsente un exemplaire d'un type d'objet. Si deux tables sont des listes d'lments diffrents, l'une tant par exemple une liste de clients et l'autre une liste de factures, et que les deux tables ont un champ en commun, par exemple le numro de client, c'est gnralement le signe qu'il y a une relation entre les deux tables. Dans les outils de requte SQL standard, les deux tables doivent presque toujours tre jointes. Les tables dfinies dans le script QlikView sont appeles des tables logiques. QlikView fait des associations entre les tables en fonction des noms de champs et effectue les jointures quand l'utilisateur procde des slections, c'est--dire clique sur un lment de liste de slection. Une association QlikView est donc presque la mme chose qu'une jointure QlikView (voir ci-dessous). La seule diffrence est que la jointure est effectue l'excution du script, la table logique tant gnralement le rsultat de la jointure. L'association, elle, est effectue aprs la cration de la table, puisqu'elle se fait toujours entre des tables logiques.

Quatre tables: une liste de pays, une liste de clients, une liste de transactions et une liste de membres, qui sont associes l'une l'autre par les champs Pays et NClient.

Une association QlikView a peu prs le mme effet qu'une jointure SQL externe naturelle. L'association QlikView est toutefois plus gnrale : une jointure externe en SQL est gnralement une projection sens unique d'une table sur une autre. Une association QlikView tablit toujours une jointure externe naturelle complte (bidirectionnelle).

Informations de frquence dans les champs d'association


L'utilisation de la plupart des champs d'association, c'est--dire les champs communs deux tables ou plus, est limite. Quand un champ existe dans plus d'une table, QlikView a du mal savoir quelle table utiliser pour calculer les frquences de donnes.

397

QlikView analyse les donnes pour voir s'il existe une manire non ambigu d'identifier la table principale (c'est parfois le cas), mais la plupart du temps, le programme ne peut tre sr de son choix. Comme un mauvais choix pourrait avoir des consquences graves (QlikView semblerait faire une erreur de calcul), le programme a t conu pour ne pas permettre certaines oprations quand l'interprtation des donnes est ambigu pour les champs d'association. Les limites suivantes s'appliquent normalement aux champs d'association : 1. Les informations de frquence ne peuvent pas tre affiches dans une liste de slection contenant le champ. L'option Afficher la frquence disponible sous l'onglet Proprits de la liste de slection: Gnral est grise. 2. Les zones de statistiques correspondantes affichent n/a pour la plupart des entits statistiques. 3. Dans les graphiques, il n'est pas possible de crer des expressions contenant des fonctions bases sur des informations de frquence du champ (somme, fonctions de dcompte, moyenne, etc.), moins que le modificateur d'instruction Calcul distinct ne soit activ. Si vous essayez, un message d'erreur s'affichera. Aprs chaque rechargement, QlikView recherchera dans toutes les expressions de graphiques les ambiguts qui auront pu apparatre suite aux modifications apportes aux structures de donnes. Si des expressions ambigus sont dtectes, une bote de dialogue d'avertissement s'affichera et l'expression sera dsactive. Il ne sera pas possible d'activer l'expression avant que le problme ne soit corrig. Si un journal est activ, toutes les expressions ambigus y seront listes. Il existe un moyen simple de contourner ces limites. Rechargez le champ sous un nouveau nom partir de la table o les dcomptes de frquence doivent tre effectus. Vous pouvez alors utiliser ce nouveau champ pour crer une liste de slection avec frquence, une zone de statistiques ou des calculs dans les graphiques.

Cls synthtiques
Quand deux tables internes ou plus ont deux champs ou plus en commun, il s'agit d'une relation de cl compose. QlikView traite ce problme par des cls synthtiques. Ces cls sont des champs anonymes qui reprsentent toutes les combinaisons existantes de la cl compose. Lorsque le nombre de cls composes augmente, selon les quantits de donnes, la structure des tables et d'autres facteurs, QlikView peut ou non les traiter convenablement. QlikView peut finir par utiliser trop de temps et/ou de mmoire. Malheureusement, les limites effectives sont presque impossibles prdire ; on ne peut que les prouver. Nous recommandons donc une analyse globale de la structure de tables voulue par le concepteur de l'application. Les astuces habituelles comprennent :
l

La cration de propres cls non composes, en utilisant gnralement la concatnation de chane dans une fonction de script AutoNumber. La connexion des seuls champs ncessaires. Si, par exemple, une date est utilise comme cl, assurezvous de ne pas charger, par exemple, anne, mois ou jour_du_mois depuis plus d'une table interne.

Rfrences circulaires ( boucles )


S'il y a des rfrences circulaires ( boucles ) dans une structure de donnes, les tables sont associes de telle sorte qu'il existe plus d'un chemin d'associations entre deux champs. Ce type de structure de donnes doit normalement tre vit autant que possible, car cela peut provoquer des ambiguts dans l'interprtation des donnes. Malheureusement, les structures circulaires sont tout fait courantes dans le monde rel. Dans certains cas, elles rsultent d'une mauvaise conception de la base de donnes, mais elles sont parfois invitables.

398

Trois tables avec une rfrence circulaire

QlikView rsout le problme des rfrences circulaires en rompant la boucle l'aide d'une table dconnecte. Lorsque QlikView dtecte des structures de donnes circulaires l'excution du script de chargement, une bote de dialogue d'avertissement s'affiche et une ou plusieurs tables sont dclares dconnectes. QlikView essaiera en gnral de dconnecter la table la plus longue de la boucle, car il s'agit souvent d'une table de transactions, qui est normalement celle dconnecter. Si vous n'aimez pas le choix de table dconnecter que QlikView a fait par dfaut, vous pouvez dclarer une autre table dconnecte au moyen d'une instruction loosen table dans le script. Il est galement possible de modifier les paramtres des tables dconnectes de manire interactive via l'onglet Proprits du document: Tables une fois le script excut. Voir le chapitre Logique et slections (page 113) pour plus d'informations sur les tables dconnectes.

26.6 Renommer des champs


Il est parfois ncessaire de renommer des champs afin d'obtenir les associations voulues. Il peut ainsi arriver que deux champs soient nomms diffremment bien qu'ils renvoient la mme chose, par exemple ID dans une table Clients et NClient dans une table Commandes. Les deux champs renvoient l'vidence un code d'identification client et doivent donc tous deux tre appels NClient ou un nom similaire. Il peut aussi arriver que deux champs portent le mme nom, mais renvoient en fait des choses diffrentes, par exemple Date dans la table Factures et Date dans la table Commandes. Ils seront alors renomms de prfrence DateFacture et DateCommande ou des noms similaires. Il peut aussi y avoir de simples erreurs d'orthographes dans la base de donnes ou des conventions diffrentes sur les majuscules et les minuscules. (Comme QlikView fait la diffrence entre les majuscules et les minuscules, il est important d'apporter les corrections ncessaires.) Les champs peuvent tre renomms dans le script, ce qui vite d'avoir modifier les donnes d'origine. Il existe deux faons de le faire: L'instruction Load (page 268) ou Select (SQL) (page 284) peut tre prcde d'une instruction Alias (page 243).

Exemple:
Alias ID as NClient; Load * from Client.csv;
L'instruction load ou select peut contenir le spcificateur as.

Exemple:
Load ID as NClient, Nom, Adresse, CP, Ville, tat from Client.csv;

399

Enfin, on peut aussi renommer des listes de slections et d'autres objets, ce qui change les tiquettes sans toucher aux associations logiques dfinies par les noms de champs. Slectionnez Proprits dans le menu objet de l'objet.

26.7 Concatnation de plusieurs tables en une


Concatnation automatique
Si les noms et le nombre de champs de plusieurs tables charges sont exactement identiques, QlikView concatnera automatiquement le contenu des diffrentes instructions en une seule table.

Exemple:
load a, b, c from table1.csv; load a, c, b from table2,csv;
La table interne qui en rsulte possde les champs a, b et c. Le nombre d'enregistrements correspond la somme des nombres d'enregistrements des tables 1 et 2.

Rgles :
l l

Le nombre et les noms des champs doivent tre exactement identiques. L'ordre des deux instructions est arbitraire.

Concatnation force
Si plusieurs tables n'ont pas exactement le mme ensemble de champs, il est tout de mme possible de forcer QlikView les concatner. On le fait l'aide du prfixe concatenate dans le script, qui concatne une table une autre table nomme ou la dernire table logique cre.

Exemple:
load a, b, c from table1.csv; concatenate load a, c from table2,csv;
La table interne qui en rsulte possde les champs a, b et c. Le nombre d'enregistrements dans la table rsultante correspond la somme des nombres d'enregistrements des tables 1 et 2. La valeur du champ b dans les enregistrements provenant de la table 2 est NULL.

Rgles :
l l

Les noms des champs doivent tre exactement identiques. moins que le nom d'une table dj charge soit spcifi dans l'instruction concatenate, le prfixe concatenate utilise la dernire table cre. L'ordre des deux instructions n'est donc pas arbitraire.

Empcher la concatnation
Si les noms et le nombre de champs de plusieurs tables charges sont exactement identiques, QlikView concatnera automatiquement le contenu des diffrentes instructions en une seule table. Il est possible d'viter cela grce une instruction nonconcatenate. La table charge avec l'instruction load ou select ne sera donc pas concatne avec la table existante.

Exemple:
load a, b, c from table1.csv; nonconcatenate load a, b, c from table2.csv

400

26.8 Join et keep


On peut joindre des tables figurant dj dans le script. La logique QlikView ne considrera pas alors les tables spares, mais plutt le rsultat de la jointure qui consiste en une seule table interne. C'est parfois prfrable, quelquefois mme ncessaire, mais la plupart du temps ce n'est pas conseill, car :
l l

Les tables charges deviennent souvent plus grandes et QlikView fonctionne plus lentement. Certaines informations peuvent tre perdues : la frquence (nombre d'enregistrements) dans la table de dpart peut ne plus tre disponible.

La fonction keep, qui rduit une des deux tables ou les deux l'intersection de leurs donnes avant que les tables ne soient stockes dans QlikView, a t conue pour rduire le nombre de cas o l'utilisation de jointures explicites est ncessaire. .

Remarque: Dans ce manuel, le terme jointure dsigne habituellement les jointures effectues avant la cration de tables internes. L'association, effectue aprs la cration des tables internes, peut cependant tre considre aussi comme une jointure.

Les jointures dans une instruction SQL select


Avec certains pilotes ODBC, on peut procder une jointure dans l'instruction select. Cela revient pratiquement utiliser le prfixe join. Toutefois, la plupart des pilotes ODBC ne sont pas capables de crer une jointure externe complte (bidirectionnelle). Ils ne peuvent faire qu'une jointure externe gauche ou droite. Une jointure externe gauche (droite) n'inclut que les combinaisons o la cl de jointure existe dans la table de gauche (droite). Une jointure externe complte inclut toutes les combinaisons. QlikView cre automatiquement une jointure externe complte. En outre, la cration de jointures dans les instructions select s'avre bien plus complique que dans QlikView.

Exemple:
SELECT DISTINCTROW [Dtails Commandes].NProduit, [Dtails Commandes]. PrixUnitaire, Commandes.NCommande, Commandes.DateCommande, Commandes.NClient FROM Commandes RIGHT JOIN [Dtails Commandes] ON Commandes.NCommande = [Dtails Commandes].NCommande;
Cette instruction select joint une table contenant des commandes une entreprise fictive une table contenant les dtails des commandes. C'est une jointure externe droite, ce qui signifie que tous les enregistrements de Dtails Commandes sont inclus, ainsi que ceux qui comprennent un NCommande inexistant dans la table Commandes. Les commandes qui existent dans Commandes mais pas dans Dtails Commandes ne sont cependant pas incluses.

Join
La faon la plus simple de crer une jointure est d'utiliser le prfixe join dans le script, qui joint la table interne la dernire table cre. La jointure sera une jointure externe, crant toutes les combinaisons possibles des valeurs des deux tables.

Exemple:
load a, b, c from table1.csv;

401

join load a, d from table2.csv;


La table interne qui en rsulte possde les champs a, b, c et d. Le nombre d'enregistrements diffre selon les valeurs de champs des deux tables.

Rgles :
l l

Les noms des champs de jointure doivent tre exactement identiques. Le nombre de champs de jointure est arbitraire. Les tables doivent gnralement avoir un ou plusieurs champs en commun. Avec aucun champ en commun, la fonction donnera le produit cartsien des tables. Que les tables aient tous leurs champs en commun est aussi possible, mais cela n'a habituellement aucun sens. moins que le nom d'une table dj charge soit spcifi dans l'instruction join, le prfixe join utilise la dernire table logique cre. L'ordre des deux instructions n'est donc pas arbitraire.

Keep
Le prfixe explicite join dans le langage de script de QlikView procde une jointure complte des deux tables. Le rsultat en est une seule table. De telles jointures produisent bien souvent de trs grandes tables. L'une des principales caractristiques de QlikView est sa capacit effectuer des associations entre des tables au lieu de les joindre, ce qui rduit l'espace mmoire utilis, augmente la vitesse et offre une grande souplesse. La fonction keep a t conue pour rduire le nombre de cas o des jointures explicites doivent tre utilises. Le prfixe keep plac entre deux instructions load ou select provoque la rduction d'une ou des deux tables l'intersection de leurs donnes, avant qu'elles ne soient stockes dans QlikView. Le prfixe keep doit toujours tre prcd d'un des mots-cls inner, left ou right. La slection des enregistrements des tables se fait de la mme manire que pour la jointure correspondante. Cependant, les deux tables ne sont pas jointes et seront stockes dans QlikView comme deux tables spares.

Inner
Les prfixes join et keep du langage de script QlikView peuvent tre prcds du prfixe inner. Utilis avant join, il indique que la jointure des deux tables doit tre une jointure interne. La table obtenue contient ainsi uniquement des combinaisons des deux tables avec un ensemble de donnes complet des deux cts. Utilis avant keep, il indique que les deux tables doivent tre rduites leur intersection commune avant d'tre stockes dans QlikView.

Exemple:

TableQV : Select * from Table1; inner join select * from Table2;

402

QVTab1 : Select * from Table1; QVTab2 : inner keep select * from Table2;

Les deux tables de l'exemple avec keep sont bien entendu associes par le champ A.

Left
Les prfixes join et keep du langage de script QlikView peuvent tre prcds du prfixe left. Utilis avant join, il indique que la jointure des deux tables doit tre une jointure gauche. La table obtenue contient ainsi uniquement des combinaisons des deux tables avec un ensemble de donnes complet de la premire table. Utilis avant keep, il indique que la deuxime table doit tre rduite son intersection commune avec la premire table, avant d'tre stocke dans QlikView.

Exemple:

TableQV : Select * from Table1; left join select * from Table2;

QVTab1 :

403

Select * from Table1; QVTab2 : left keep select * from Table2;

Les deux tables de l'exemple avec keep sont bien entendu associes par le champ A.

Right
Les prfixes join et keep du langage de script QlikView peuvent tre prcds du prfixe right. Utilis avant join, il indique que la jointure des deux tables doit tre une jointure droite. La table obtenue contient ainsi uniquement des combinaisons des deux tables avec un ensemble de donnes complet de la seconde table. Utilis avant keep, il indique que la premire table doit tre rduite son intersection commune avec la seconde table, avant d'tre stocke dans QlikView.

Exemple:

TableQV : Select * from Table1; right join select * from Table2;

QVTab1 : Select * from Table1; QVTab2 : right keep select * from Table2;

404

Les deux tables de l'exemple avec keep sont bien entendu associes par le champ A.

405

406

27 valuation des donnes charges


27.1 Bases de donnes gnriques
Une base de donnes gnrique est une table dans laquelle les noms de champs sont stocks comme valeurs de champs dans une colonne, tandis que les valeurs de champs sont stockes dans une deuxime colonne. Les base de donnes gnriques sont habituellement utilises pour les attributs de diffrents objets. Examinons l'exemple ci-dessous. Il s'agit d'une base de donnes gnrique contenant deux objets, une balle et une bote. l'vidence, certains des attributs, comme la couleur et le poids, sont communs aux deux objets, tandis que d'autres, tels que le diamtre, la hauteur, la longueur et la largeur, ne le sont pas.

C'est une base de donnes gnrique type. D'une part, il serait compliqu de stocker les donnes de manire donner chaque attribut une colonne propre, puisque beaucoup des attributs ne sont pas pertinents pour l'un ou l'autre des objets. D'autre part, afficher les longueurs, les couleurs et les poids tous ensemble rendrait les donnes difficilement lisibles.

QlikView rsout ce problme de manire astucieuse. Si les donnes sont stockes de faon compacte comme ci-dessus, choisissez entre deux modes d'affichage des donnes. QlikView cre automatiquement plusieurs tables internes partir de la base de donnes gnrique. Si cette table est charge de manire standard, on peut obtenir trois listes de slection diffrentes l'cran. Cependant, si la table est charge comme base de donnes gnrique, QlikView sparera les colonnes deux et trois en diffrentes listes de slection. QlikView gnrera alors un champ pour chaque valeur unique de la deuxime colonne.

La syntaxe pour le faire est simple:

Exemple:
Generic Select * from TableGnrique;
Peu importe que soit utilise une instruction load ou select pour charger la base de donnes gnrique.

407

27.2 Tableaux croiss


Un tableau crois est un type de table courant comprenant une matrice de valeurs entre deux listes orthogonales de donnes d'en-tte. Cela peut ressembler au tableau ci-dessous.

Exemple 1:
ex1.csv Anne 1991 1992 1993 1994 1995 Jan. 45 11 65 45 45 Fv. 65 23 56 24 56 Mar. 78 22 22 32 35 Avr. 12 22 79 78 78 Mai 78 45 12 55 68 Jun 22 85 56 15 82

Si ce tableau est simplement charg dans QlikView, le rsultat sera un champ pour Anne et un champ pour chacun des mois. Ce n'est pas ce que l'on souhaite en gnral. On prfrera probablement avoir trois champs, un pour chaque catgorie d'en-tte (Anne et Mois) et un pour les valeurs figurant dans la matrice. On peut l'obtenir en ajoutant le prfixe crosstable l'instruction load ou select. L'instruction de chargement de ce tableau crois pourrait tre :

crosstable (Mois, Ventes) load * from ex1.csv;


Le rsultat dans QlikView serait le suivant :

Le tableau crois est souvent prcd d'un certain nombre de colonnes qualifiantes, qui doivent tre lues directement. C'est le cas dans l'exemple 2 :

Exemple 2:
ex2.csv Vendeur A A Anne 1991 1992 Jan. 45 11 Fv. 65 23 Mar. 78 22 Avr. 12 22 Mai 78 45 Jun 22 85

408

A A A B B B B B

1993 1994 1995 1991 1992 1993 1994 1995

65 45 45 57 23 77 57 57

56 24 56 77 35 68 36 68

22 32 35 90 34 34 44 47

79 78 78 24 34 91 90 90

12 55 68 90 57 24 67 80

56 15 82 34 97 68 27 94

Dans ce cas, il y a deux colonnes qualifiantes gauche, suivies des colonnes de la matrice. Le nombre de colonnes qualifiantes peut tre indiqu comme troisime paramtre du prfixe crosstable comme suit:

crosstable (Mois, Ventes, 2) load * from ex2.csv;


Le rsultat dans QlikView serait :

Pour une description de la syntaxe, voir Tableau crois (page 250).

27.3 Faire correspondre des intervalles des donnes discrtes


Le prfixe intervalmatch pour une instruction load ou select est utilis pour lier des valeurs numriques discrtes un ou plusieurs intervalles numriques. C'est une caractristique trs puissante qui peut tre utilise par exemple dans les environnements de production, comme l'illustre l'exemple ci-dessous.

Exemple:
Considrez les deux tables ci-dessous. La premire table affiche le dbut et la fin de la production de diffrentes commandes. La seconde affiche des vnements discontinus. Comment peut-on associer les vnements discrets aux commandes, de sorte que l'on sache par exemple quelles commandes ont subi des perturbations et quelles commandes ont t traites par quelles quipes ?

409

Chargez tout d'abord les deux tables comme d'habitude, puis liez le champ Heure aux intervalles dfinis par les champs Dbut et Fin:

Select * from JournalCommandes; Select * from Journalvnements; Intervalmatch (Heure) select Dbut, Fin from JournalCommandes;
Une zone table dans QlikView peut maintenant tre cre comme ci-dessous :

Dsormais, il est vident que, principalement, la commande A a t affecte par la ligne stop mais que la vitesse de ligne rduite galement affect les commandes B et C. Seules les commandes C et D ont t en partie gres par l'quipe 2. Veuillez prendre note des points suivants concernant l'utilisation de intervalmatch :
l

Avant l'instruction intervalmatch, le champ contenant les points de donnes discrets (Heure dans l'exemple ci-dessus) doit dj avoir t lu dans QlikView. L'instruction intervalmatch ne lit pas ce champ partir de la table de la base de donnes. La table lue dans l'instruction intervalmatch load ou select doit toujours contenir exactement deux champs (Dbut et Fin dans l'exemple ci-dessus). Afin d'tablir un lien d'autres champs, vous devez lire les champs d'intervalle en mme temps que des champs supplmentaires dans une instruction load ou select spare (la premire instruction select dans l'exemple ci-dessus).

410

Les intervalles sont toujours ferms, c'est--dire que les points de fin sont inclus dans l'intervalle. Des limites non numriques font que l'intervalle est ignor (indfini) tandis que des limites nulles tendent l'intervalle indfiniment (illimit). Les intervalles peuvent se superposer et les valeurs discontinues seront alors lies tous les intervalles correspondants.

27.4 Utiliser la syntaxe IntervalMatch tendue pour rsoudre des problmes de dimensions changeant progressivement
La syntaxe intervalmatch tendue peut servir traiter le problme bien connu des dimensions changeant progressivement dans les donnes source.

chantillon de script :
SET NullInterpret=''; TableIntervalles : Load Cl, ValideDe, quipe from TableIntervalles.xls; NullAsValue PremireDate,DernireDate; Cl : Load Cl, ValideDe as PremireDate, date(if(Cl=previous(Cl), previous(ValideDe) - 1)) as DernireDate, quipe resident TableIntervalles order by Cl, ValideDe desc; drop table TableIntervalles; Transact : Load Cl, Nom, Date, Ventes from Transact.xls; inner join intervalmatch (Date,Cl) load PremireDate, DernireDate, Cl resident Cl;

Commentaires sur l'exemple ci-dessus :


L'instruction

SET NullInterpret='';
n'est requise que lorsque le programme lit des donnes partir d'un fichier de tables, puisque les valeurs manquantes sont dfinies comme des chanes vides plutt que comme des valeurs nulles. Charger les donnes partir de TableIntervalles donnerait la table suivante :

411

L'instruction nullasvalue autorise les valeurs nulles se connecter aux champs lists. Crez Cl, PremireDate, DernireDate (les champs d'attributs) l'aide de previous et order by. La table TableIntervalles est ensuite supprime aprs avoir t remplace par cette table cl. Charger les donnes partir de Transact donnerait la table suivante :

L'instruction intervalmatch prcde de inner join remplace la cl ci-dessus par une cl synthtique qui tablit une connexion la table Transact, donnant ainsi la table suivante:

27.5 Hirarchies
Les hirarchies dsquilibres de niveau n sont souvent utilises pour reprsenter des dimensions organisationnelles ou gographiques sous forme de donnes. Les hirarchies de ce type sont souvent stockes dans des tables de nuds adjacentes, c'est--dire dans des tables o chaque enregistrement correspond un nud et comporte un champ contenant une rfrence au nud parent.

Dans une table de ce type, le nud est stock dans un seul enregistrement, mais peut avoir plusieurs enfants. La table peut bien sr avoir des champs supplmentaires dcrivant les attributs des nuds. Les tables de nuds adjacentes sont idales en matire de maintenance mais sont difficiles utiliser au quotidien. Pour les requtes et les analyses, d'autres reprsentations sont donc utilises. La table de nuds tendue est une reprsentation classique dans laquelle chaque niveau de la hirarchie est stock dans un

412

champ spar. Dans une table de nuds tendue, les niveaux peuvent tre utiliss facilement, dans un tableau crois dynamique ou une structure d'arbres, par exemple. Le mot-cl hierarchy peut tre utilis dans un script QlikView pour transformer une table de nuds adjacente en table de nuds tendue. Pour plus d'informations, voir Hierarchy (page 258).

Dans une table de nuds tendus, il est cependant difficile d'utiliser les champs de niveaux pour les recherches ou les slections, puisque vous devez connatre le niveau chercher ou slectionner. La table des anctres est une reprsentation diffrente qui peut rsoudre ce problme. Cette reprsentation est galement appele table de correspondance.

La table des anctres contient un enregistrement pour chaque relation enfant-anctre trouve dans les donnes. Elle contient des cls et les noms des enfants, ainsi que des anctres. En d'autres termes, chaque enregistrement dcrit le noeud auquel appartient un noeud spcifique. Le mot-cl hierarchybelongsto peut tre utilis dans un script QlikView pour transformer une table de nuds adjacente en table des anctres. Pour plus d'informations, voir Paramtres de la hirarchie (page 233). Pour une hirarchie, une bonne solution QlikView comprend une table de nuds tendue et une table des anctres. La premire sert crer des tableaux croiss dynamiques et, en gnral, dcrire les nuds. La seconde permet de slectionner des arbres entiers. Les deux sont lies par la cl de nud, par exemple IDNud, qui effectue galement une liaison vers une ventuelle table de transaction.

413

27.6 Liens smantiques


Normalement, on effectue les slections explicitement en cliquant sur les valeurs de champs qui nous intressent. Pourtant, on peut aussi faire des slections indirectement par des liens smantiques. Ils sont similaires aux valeurs de champs, la diffrence qu'ils dcrivent les relations entre les objets plutt que les objets eux-mmes. Ils apparaissent sous la forme d'une liste de boutons. Quand on clique sur un lien smantique, une slection est effectue dans un autre champ.

Rgles pour les tables smantiques


On cre des liens smantiques en chargeant des tables contenant les relations entre les objets.
l l

La table doit contenir exactement trois ou quatre colonnes. Une table smantique doit contenir des relations soit entre les valeurs de diffrents champs, soit entre les valeurs d'un mme champ. On ne peut mlanger les deux. L'instruction load ou select qui charge une table smantique doit tre prcde d'un qualificatif semantic pour montrer qu'il ne s'agit pas d'une table logique.

Normalement, on utilise quatre colonnes, la premire contenant les valeurs qui ont une relation une autre valeur de champ et la troisime contenant cette dernire valeur. La deuxime colonne doit contenir les noms des relations, et enfin, la quatrime doit contenir les noms des relations rciproques. Si on utilise trois colonnes, aucun nom explicite n'est donn aux relations rciproques. Les noms de la deuxime colonne sont utiliss la fois pour la relation et pour la relation rciproque. Ils sont alors prcds ou suivis de flches.

Si les relations concernent des valeurs du mme champ, la premire et la troisime colonne doivent avoir le mme nom. De mme, les noms des deuxime et quatrime colonnes, c'est--dire le type de relations, doivent

414

tre les mmes. Toutefois, si les relations concernent des valeurs de diffrents champs, toutes les colonnes doivent porter des noms diffrents.

Exemple: extraire une table smantique partir de donnes


La table smantique n'a pas forcment exister comme table en dehors de QlikView. Il est plus facile d'extraire cette table de la table d'objets existante par une instruction load spare.

Dans l'exemple des prsidents du rpertoire d'exemples de QlikView, le script servant gnrer les liens Prdcesseur et Successeur pourrait correspondre celui-ci:

Directory prsidents; Load * from presdnts.csv (ansi, txt, delimiter is ',', embedded labels); Semantic Load No -1 as No, 'Successeur' as Relation, No, 'Prdcesseur' as Relation from presdnts.csv (ansi, txt, delimiter is ',', embedded labels) where No > 1;
La deuxime instruction load donne une table qui ressemble celle de droite, et cette table est charge comme table smantique. La clause where sert omettre le premier enregistrement, car le premier prsident serait autrement li au prsident 0, qui n'existe pas.

Notez aussi que cette instruction load contient deux champs nomms N et deux champs Relation. Une telle instruction load provoquerait une erreur d'excution du script si elle tait utilise pour charger une table interne, puisque la procdure de chargement pour une seule table interne exige qu'aucun champ n'ait le mme nom qu'un autre. L'instruction select correspondante n'est pas possible non plus, car la plupart des pilotes ODBC ont cette mme exigence. On doit utiliser la place la structure suivante si la table des prsidents se trouve dans une base de donnes :

Connect to Basededonnes; Select * from presdnts; Alias N2 as N, Relation2 as Relation; Semantic Select No -1 as No, 'Successeur' as Relation, N as N2,

415

'Prdcesseur' as Relation2 from presdnts where N > 1;


L'exemple des prsidents n'est qu'un exemple simple de l'utilisation des liens smantiques. On peut aussi les utiliser en gnalogie, o les liens smantiques peuvent tre, par exemple, cousin, frre ou sur, grand-mre, etc., ou pour le personnel d'entreprises o les liens peuvent alors suprieur, rend compte , secrtaire, etc.

Exemple: utiliser les valeurs lies comme noms de relations


Parfois, il est plus parlant d'utiliser la valeur de champ lie comme nom de la relation. Dans le cas des prsidents, vous pouvez rassembler tous les prdcesseurs dans une colonne et tous les successeurs dans une autre :

Pour crer ces liens, le script suivant est ncessaire :

Load N as CopiedeN, Prnom & ' ' & Nom as Nom, * from presdnts.csv; Semantic Load No -1 as No, Prnom & ' ' & Nom as Successeur, N as CopiedeN, 'Test1' from presdnts.csv where N > 1; Semantic Load No +1 as No, Prnom & ' ' & Nom as Prdcesseur, N as CopiedeN, 'Test2' from presdnts.csv;
Quand on clique sur un lien smantique, une slection est effectue dans le champ de la troisime colonne, CopiedeN, qui correspond toujours dans la table smantique au numro du prsident affich sur le lien smantique. Cela peut ne pas apparatre vident au premier abord, mais les relations rciproques dans la construction cidessus sont presque inutiles. Elles montreraient le nom d'un prsident et, quand on cliquerait dessus, slectionneraient le prdcesseur/successeur du prsident affich. C'est pourquoi on les appelle Test1 et Test2 et seule la premire relation (deuxime colonne) est utilise.

416

Comme on ne veut pas que les relations de test apparaissent dans les listes de slection, on doit traiter la deuxime et la quatrime colonne comme des types de relations diffrents. Cela signifie que la premire et la troisime colonne doivent avoir des noms de champs distincts. Cela explique que l'on ait deux colonnes contenant le numro du prsident, N et CopiedeN. Deux instructions semantic diffrentes sont ncessaires puisque l'on veut obtenir deux listes de slection diffrentes avec relations. Cet exemple peut galement tre reproduit avec des tables smantiques trois colonnes mais les listes de slection contenant les relations rciproques troubleront alors trs vraisemblablement l'utilisateur.

27.7 Lier des informations des valeurs de champs


Dans un document QlikView, on peut associer des donnes des informations sous forme de fichiers texte, d'images ou d'applications externes. Pour utiliser cette fonction, vous devez crer des tables indiquant le fichier d'informations lier telle ou telle valeur de champ, et configurer QlikView pour qu'il traite ces tables comme des tables d'informations. La procdure est explique ci-aprs. Les tables d'informations doivent comprendre deux colonnes : la premire possde un nom de champ en entte et contient une liste de valeurs appartenant au champ ; la seconde possde un nom arbitraire en en-tte et contient les informations (s'il s'agit de texte) ou les rfrences aux fichiers contenant les informations (images, applications). Voir figure ci-dessous.

Table d'informations dfinissant les fichiers lis des valeurs de champ donnes

L'instruction de chargement de cette table comme table d'informations serait la suivante :

Info Load Pays, I from Drapeauxoecd.csv (ansi, txt, delimiter is ',', embedded labels);
Lorsqu'on slectionne un lment de liste de slection ou de liste multiple auquel des informations sont lies, une icne d'information, , apparat ct du nom du champ pour indiquer que des informations sont disponibles. Cliquez sur cette icne pour afficher les informations ou charger le fichier d'application. Il est possible de dsactiver l'icne d'information sous l'onglet Disposition de la bote de dialogue Proprits de la liste de slection. Si un texte est saisi dans la deuxime colonne, le texte est affich dans un diteur de texte interne. Pour insrer une nouvelle ligne dans ce texte, on ne peut pas utiliser le retour de chariot. Il faut donc utiliser le symbole \n dans le fichier d'informations.
l

l l l

Si un nom de fichier image (extension bmp, par exemple) est saisi dans la deuxime colonne, l'image est affiche dans un visionneur d'images interne. Si un nom de fichier audio (extension wav) est saisi dans la deuxime colonne, le son est reproduit. Si un nom de fichier excutable est saisi dans la deuxime colonne, le fichier est excut. Si le nom de tout autre fichier est saisi dans la deuxime colonne, le programme associ est utilis pour ouvrir le fichier.

417

Si une URL est saisie dans la deuxime colonne, par exemple une adresse Internet, le navigateur Internet enregistr est utilis pour accder cette adresse.

Un fichier info ne peut pas contenir d'astrisque. Un symbole dfini comme OtherSymbol (voir OtherSymbol (page 420)) est cependant autoris. Avec bundle info load, il est possible de regrouper les donnes externes dans un document QlikView. Pour en savoir plus, voir Bundle (page 245).

27.8 Nettoyage de donnes


En chargeant des donnes de diffrentes tables, vous remarquerez que des valeurs de champ renvoyant la mme chose ne sont pas toujours nommes de faon cohrente. Ces incohrences ne sont pas seulement agaantes, mais elles empchent aussi les associations et il faut donc rsoudre le problme. On peut le faire facilement en crant une table de mappage pour comparer des valeurs de champs.

Tables de mappage
Les tables charges par mapping load ou mapping select sont traites diffremment des autres tables. Elles seront stockes dans une zone spare de la mmoire et utilises uniquement comme tables de mappage au cours de l'excution du script. Aprs l'excution du script, elles seront automatiquement supprimes.

Exemple de table de mappage

Rgles :
l

Une table de mappage doit avoir deux colonnes, la premire contenant les valeurs de comparaison et la seconde les valeurs de mappage voulues. Les deux colonnes doivent tre nommes, mais les noms eux-mmes ne sont pas pertinents. Ils n'ont pas de lien avec les noms de champs dans les tables internes normales.

Utiliser une table de mappage


En chargeant plusieurs listes de pays, vous constaterez ventuellement qu'un mme pays peut avoir diffrents noms. Dans cet exemple, les U.S.A. figurent dans la liste sous les formes US, U.S. et tats-Unis.

418

Pour viter la prsence de trois enregistrements diffrents renvoyant aux tats-Unis dans la table concatne, crez une table similaire la table affiche et chargez-la comme table de mappage. Tout le script devrait ressembler :

MapPays : Mapping Load x,y from Tabledemappage.txt (ansi, txt, delimiter is ',', embedded labels); Map Pays using MapPays; Load Pays,Ville from PaysA.txt (ansi, txt, delimiter is ',', embedded labels); Load Country, City from CountryB.txt (ansi, txt, delimiter is ',', embedded labels);
L'instruction mapping (pour une description dtaille de la syntaxe, voir Mapping (page 276)) charge le fichier Tabledemappage.txt en tant que table de mappage avec l'tiquette MapPays. L'instruction map (pour une description dtaille de la syntaxe, voir Map ... using (page 276)) active le mappage du champ Pays en utilisant la table de mappage dj charge MapPays. Les instructions load chargent les tables PaysA et PaysB. Ces tables, qui seront concatnes parce qu'elles possdent le mme ensemble de champs (voir Concatnation de plusieurs tables en une (page 400)), incluent le champ Pays, dont les valeurs seront compares celles de la premire colonne de la table de mappage. Les valeurs de champ U.S., tats-Unis et US seront dtectes et remplaces par les valeurs de la deuxime colonne de la table de mappage, c'est--dire USA. Le mappage automatique est effectu en dernier dans la chane des vnements qui mnent au stockage du champ dans la table QlikView. Pour une instruction load ou select habituelle, l'ordre des vnements est peu prs le suivant : 1. valuation des expressions 2. Rednomination des champs par l'utilisation de as 3. Rednomination des champs par l'utilisation de l'alias 4. Qualification du nom de la table, le cas chant 5. Mappage des donnes si les noms des champs correspondent Cela signifie que le mappage n'est pas effectu chaque fois qu'un nom de champ est rencontr dans une expression, mais plutt quand la valeur est stocke sous ce nom de champ dans la table QlikView. Pour dsactiver le mappage, utilisez l'instruction unmap (voir Unmap (page 294)). Pour effectuer un mappage au niveau de l'expression, utilisez la fonction applymap (voir Fonctions de la catgorie Mappage (page 351)). Pour effectuer un mappage au niveau de la sous-chane, utilisez la fonction mapsubstring (voir Fonctions de la catgorie Mappage (page 351)).

419

27.9 Caractres gnriques dans les donnes


Il est aussi possible d'utiliser des caractres gnriques dans les donnes. Il existe deux caractres gnriques : l'astrisque, interprte comme toutes les valeurs de ce champ, et un symbole facultatif, interprt comme toutes les valeurs restantes de ce champ.

L'astrisque
L'astrisque est interprt comme toutes les valeurs (listes) de ce champ, c'est--dire une valeur liste ailleurs dans cette table. S'il est utilis dans l'un des champs systme (USERID, PASSWORD, NTNAME ou SERIAL) d'une table charge dans la section d'accs du script, il est interprt comme toutes les valeurs possibles du champ (y compris celles qui ne figurent pas dans la liste). L'astrisque n'est pas autoris dans les fichiers d'informations. Il ne peut pas non plus tre utilis dans les champs cls, c'est--dire les champs servant joindre des tables. L'astrisque n'est pas disponible moins d'tre explicitement prcis dans l'instruction voulue. Pour plus d'informations sur l'instruction star figurant dans le script, voir Star (page 289).

OtherSymbol
On a souvent besoin d'une faon de reprsenter toutes les autres valeurs d'une table, c'est--dire toutes les valeurs qui n'ont pas t trouves explicitement parmi les donnes charges. On le fait l'aide d'une variable de macro spciale appele OtherSymbol. Pour dfinir le symbole OtherSymbol traiter comme toutes les autres valeurs, utilisez la syntaxe suivante:

SET OTHERSYMBOL=sym;
avant une instruction load/select. <sym> peut reprsenter n'importe quelle chane. Quand QlikView trouvera le symbole dfini dans une table interne, il l'interprtera comme toutes les valeurs qui n'ont pas dj t charges dans le champ o il se trouve. Les valeurs trouves dans le champ aprs l'apparition du symbole OtherSymbol seront ainsi ignores. Pour rinitialiser cette fonctionnalit, utilisez :

SET OTHERSYMBOL=;

Exemple:

Insrez l'instruction suivante dans le script avant le point o la premire table au-dessus a t charge :

SET OTHERSYMBOL=+;
Toutes les rfrences aux NClients autres que 1, 2 ou 3 (par exemple si l'on clique sur NCommande 1299) donneront Indfini dans Nom.

Remarque: OtherSymbol n'est pas conu pour servir la cration de jointures externes entre des tables.

420

27.10 Manipulation des valeurs NULL dans QlikView


Quand aucune donne ne peut tre produite pour un champ donn la suite d'une requte de base de donnes et/ou d'une jointure de tables, le rsultat est normalement une valeur NULL. La logique QlikView traite les valeurs suivantes comme des valeurs NULL relles:
l l l l

valeurs NULL renvoyes par une connexion ODBC valeurs NULL cres la suite d'une concatnation de tables force dans le script QlikView valeurs NULL cres la suite d'une instruction join cre dans le script QlikView valeurs NULL cres la suite de la cration de combinaisons de valeurs de champs afficher dans une zone table ou exporter l'aide d'un bouton d'exportation.

Il est normalement impossible d'utiliser ces valeurs NULL pour des associations et des slections. En revanche, il est possible de manipuler les valeurs NULL au niveau du champ l'aide de l'instruction nullasvalue. Voir NullAsValue (page 277). En outre, les valeurs NULL d'ODBC peuvent tre manipules l'aide de nulldisplay (voir ci-dessous). Les fichiers texte, par dfinition, ne peuvent pas contenir de valeurs NULL.

Associer/slectionner des valeurs NULL d'ODBC


On peut associer et/ou slectionner des valeurs NULL d'une source de donnes ODBC. Une variable de script a t dfinie cette fin. On utilise alors la syntaxe: SET NULLDISPLAY=<sym>; Le symbole <sym> remplacera toutes les valeurs NULL de la source de donnes ODBC au plus bas niveau d'entre de donnes. <sym> peut reprsenter n'importe quelle chane. Pour rtablir l'interprtation par dfaut de cette fonction, utilisez:

SET NULLDISPLAY=; Remarque: L'utilisation de NULLDISPLAY ne concerne que les donnes d'une source ODBC.
Si vous souhaitez que la logique QlikView fonctionne de cette manire en ce qui concerne les valeurs NULL d'ODBC pour les interprter comme une chane vide, attribuez une chane vide la variable NULLDISPLAY de la faon suivante (deux guillemets simples sans rien entre eux):

SET NULLDISPLAY=";
Cela doit tre fait avant toute instruction select dans le script. La chane vide est alors traite comme n'importe quelle autre valeur, ce qui permet l'association et la slection de valeurs NULL.

Crer des valeurs NULL de fichiers texte


On peut dfinir un symbole qui, lorsqu'il survient dans un fichier texte ou dans une clause inline, sera interprt comme une valeur NULL relle. Utilisez l'instruction suivante:

SET NULLDISPLAY=<sym>;
o le symbole <sym> doit tre interprt comme NULL. <sym> peut reprsenter n'importe quelle chane. Pour rtablir l'interprtation par dfaut de cette fonction, utilisez:

SET NULLINTERPRET=; Remarque: L'utilisation de NULLINTERPRET ne concerne que les donnes de fichiers texte et de clauses inline.

Propagation de valeurs NULL dans les expressions


Les valeurs NULL se propageront dans une expression selon certaines rgles logiques et de bon sens.

421

Fonctions
La rgle gnrale est que les fonctions renvoient NULL quand les paramtres sortent de la plage pour laquelle la fonction est dfinie.

Exemples:
asin(2) log(-5) round(A,0) renvoie renvoie renvoie NULL NULL NULL

Il s'ensuit que les fonctions renvoient gnralement NULL quand l'un des paramtres ncessaires l'valuation est NULL.

Exemples:
sin(NULL) chr(NULL) if(NULL, A, B) if(TRUE, NULL, A) if(TRUE, A, NULL) renvoie renvoie renvoie renvoie renvoie NULL NULL B NULL A

Les fonctions logiques qui testent le type de donnes sont l'exception la deuxime rgle.

Exemples:
isnull(NULL) isnum(NULL) renvoie renvoie VRAI (-1) FAUX (0)

Oprateurs arithmtiques et oprateurs de chane


Si NULL est rencontr de l'un ou l'autre ct de ces oprateurs, la fonction renvoie NULL, sauf dans le cas d'une concatnation de chane.

Exemples:
A + NULL A - NULL A / NULL A * NULL NULL / A renvoie renvoie renvoie renvoie renvoie NULL NULL NULL NULL NULL

422

0 /NULL 0 * NULL A&NULL

renvoie renvoie renvoie

NULL NULL A

Oprateurs relationnels
Si NULL est rencontr de l'un ou l'autre ct des oprateurs relationnels, des rgles spcifiques s'appliquent.

Exemples:
op. rel. NULL NULL A <>NULL A< NULL A <= NULL A = NULL A >= NULL A > NULL renvoie renvoie renvoie renvoie renvoie renvoie renvoie NULL VRAI (-1) FAUX (0) FAUX (0) FAUX (0) FAUX (0) FAUX (0)

27.11 Jeu de caractres


Les jeux de caractres disponibles sont:

ansi oem mac UTF-8 Unicode


Le fichier peut tre crit l'aide des jeux de caractres ansi (Windows), oem (DOS, OS/2 et autres), Unicode, UTF-8 ou mac. La conversion du jeu de caractres oem n'est pas implmente pour MacOS. Sauf indication contraire, c'est le jeu de caractres ansi qui est utilis sous Windows.

Exemple:
load * from a.txt (CodePage is 10000, txt, delimiter is ',' , no labels)
Retour Instructions de script et mots-cls (page 239).

423

424

28 Fichiers QVD
Les fichiers QVD (QlikView Data) comprennent une table de donnes exportes de QlikView. QVD est un format natif de QlikView et ne peut tre crit et lu que par QlikView. Le format de fichier est optimis pour la vitesse de lecture des donnes partir d'un script QlikView, mais il reste trs compact. Lire des donnes d'un fichier QVD se fait en gnral 10 100fois plus vite que d'une autre source de donnes. Les fichiers QVD peuvent tre lus dans deux modes: standard (rapide) et super-rapide. Le mode slectionn est dtermin automatiquement par le moteur de script de QlikView. Le mode super-rapide ne peut tre utilis que quand tous les champs ou un sous-ensemble de ces champs sont lus sans aucune transformation (formules agissant sur les champs); il permet toutefois de renommer les champs. Un fichier QVD contient exactement une table de donnes et se compose de trois parties: 1. Un en-tte XML bien constitu (dans le jeu de caractres UTF-8) qui dcrit les champs de la table, la disposition des informations qui suivent et quelques autres mtadonnes. 2. Des tables de symboles dans un format remplissage de bits. 3. Les donnes de la table dans un format remplissage de bits.

28.1 Objectif des fichiers QVD


Les fichiers QVD peuvent tre utiliss de nombreuses fins. On peut identifier facilement au moins quatre usages principaux. Plusieurs pourront s'appliquer dans n'importe quelle situation:

Augmenter la vitesse de chargement


Grce la mise en mmoire tampon de blocs de donnes d'entre qui ne changent pas ou qui changent lentement dans les fichiers QVD, l'excution du script devient beaucoup plus rapide pour les grands ensembles de donnes.

Diminuer la charge sur les serveurs de bases de donnes


La quantit de donnes rcupres de sources de donnes externes peut aussi tre considrablement rduite. Cela diminue la charge de travail pour les bases de donnes externe, ainsi que le trafic du rseau. En outre, quand plusieurs scripts QlikView partagent les mmes donnes, il n'est ncessaire de les charger qu'une fois partir de la base de donnes source. Les autres applications peuvent utiliser les mmes donnes via un fichier QVD.

Consolider des donnes provenant de plusieurs applications QlikView


Avec l'instruction de script Binary (page 244), vous tes contraint de charger des donnes d'une seule application QlikView dans une autre, mais avec des fichiers QVD, un script QlikView peut combiner des donnes de plusieurs applications QlikView. Cela ouvre des possibilits, par exemple pour des applications qui consolident des donnes similaires de diffrentes units commerciales, etc.

Chargement incrmentiel
Dans de nombreux cas courants, la fonctionnalit QVD peut tre utilise pour faciliter le chargement incrmentiel, c'est--dire charger exclusivement les nouveaux enregistrements d'une base de donnes en cours de dveloppement.

425

Pour en savoir plus sur l'utilisation des fichiers QVD et le chargement incrmentiel, suivez le lien cidessous:

Utilisation de fichiers QVD pour le chargement incrmentiel (page 427)

28.2 Cration de fichiers QVD


Un fichier QVD peut tre cr de trois faons diffrentes:

1. Cration et dnomination explicites depuis le script au moyen de la commande Store (page 290). Spcifiez simplement dans le script qu'une table dj lue doit tre exporte en totalit ou en partie vers un fichier explicitement nomm l'emplacement de votre choix. 2. Cration et maintenance automatiques depuis le script. En faisant prcder une instruction load ou select du prfixe Buffer (page 244), QlikView cre automatiquement un fichier QVD qui peut tre utilis sous certaines conditions la place de la source de donnes d'origine lors du rechargement des donnes. 3. Cration et dnomination manuelles explicites partir de la disposition ou par Interprteur de macros interne (page 961). Les donnes peuvent tre exportes du modle de disposition QlikView par des commandes de l'interface graphique ou des macros d'automatisation. Dans l'interface graphique, vous trouverez QVD parmi les formats d'exportation possibles pour la commande Exporter..., qui figure dans le menu objet de la plupart des objets.
Il n'y a pas de diffrence entre les fichiers QVD obtenus, par exemple en ce qui concerne la vitesse de lecture, etc.

28.3 Lecture des donnes de fichiers QVD


On peut faire lire un fichier QVD ou y accder par QlikView de l'une des faons suivantes:

1. Chargement d'un fichier QVD comme source de donnes explicite. Dans une instruction load du script QlikView, vous pouvez faire rfrence aux fichiers QVD exactement comme tout autre type de fichier texte (csv, fix, dif, biff, etc.). L' Assistant Fichier: Type (page 212) manipule les fichiers QVD selon les mmes principes.

Exemples:
load * from xyz.qvd (qvd); load Nom, NEnr from xyz.qvd (qvd); load Nom as a, NEnr as b from xyz.qvd (qvd);

2. Chargement automatique de fichiers QVD en mmoire tampon. Quand vous utilisez le prfixe Buffer (page 244) sur des instructions load ou select, aucune instruction explicite n'est ncessaire pour la lecture. QlikView dterminera dans quelle mesure il utilisera les donnes du fichier QVD et dans quelle mesure il prfrera acqurir les donnes par l'instruction load ou select d'origine. 3. Accs aux fichiers QVD par le script. Un certain nombres de fonctions de script (toutes celles commenant par qvd) peuvent tre utilises pour rcuprer dans l'en-tte XML d'un fichier QVD plusieurs informations sur les donnes. Ces fonctions font partie des fonctions de la catgorie Fonctions de la catgorie Fichier dans le script (page 360).

426

28.4 Utilisation de fichiers QVD pour le chargement incrmentiel


Le chargement incrmentiel est une tche couramment utilise avec les bases de donnes. Il consiste ne charger de la base de donnes que les nouveaux enregistrements ou ceux qui ont t modifis. Toutes les autres donnes doivent dj tre disponibles, d'une manire ou d'une autre. Les Fichiers QVD (page 425) permettent d'excuter un chargement incrmentiel dans la plupart des cas. La procdure de base est dcrite ci-aprs: 1. Chargez les nouvelles donnes de la table de base de donnes (un processus lent, mais qui charge un nombre limit d'enregistrements). 2. Chargez les anciennes donnes du fichier QVD (charge beaucoup d'enregistrements, mais beaucoup plus rapidement). 3. Crez un nouveau fichier QVD. 4. Rptez la procdure pour chaque table charge.

La complexit de la solution utilise dpend de la nature de la base de donnes source, mais on peut identifier les principaux cas ci-dessous: 1) Cas 1: Ajout seul (page 428) (fichiers journaux). 2) Cas 2: Insertion seule (sans mise jour ou suppression) (page 428) (pas de mise jour ni de suppression). 3) Cas 3: Insertion et mise jour (sans suppression) (page 429) (pas de suppression). 4) Cas 4: Insertion, mise jour et suppression (page 430). Vous trouverez ci-dessous les solutions pour chacun de ces cas. La lecture des fichiers QVD peut tre effectue soit en mode super-rapide, soit en mode standard. (La mthode employe est automatiquement slectionne par le moteur de script de QlikView selon la complexit de l'opration.) Le mode super-rapide est (trs approximativement) 10fois plus rapide que le mode standard ou environ 100fois plus rapide que le chargement de la base de donnes de faon ordinaire.

427

Cas 1: Ajout seul


Le cas le plus simple est celui des journaux, qui sont uniquement ajouts. Les conditions suivantes s'appliquent:
l l

La base de donnes doit tre un journal enregistr dans un fichier texte (et non ODBC/OLEDB). QlikView garde trace du nombre d'enregistrements qui ont dj t lus et charge uniquement les enregistrements ajouts la fin du fichier.

Exemple de script:
Buffer (Incremental) Load * From Journal.txt (ansi, txt, delimiter is '\t', embedded labels);

Cas 2: Insertion seule (sans mise jour ou suppression)


Si les donnes se trouvent dans une base de donnes autre qu'un simple journal, l'approche dcrite prcdemment ne fonctionnera pas. Cependant, le problme peut encore tre rsolu avec un minimum de travail supplmentaire. Les conditions suivantes s'appliquent:
l l l

La source de donnes peut tre n'importe quelle base de donnes. QlikView charge les enregistrements insrs dans la base de donnes aprs la dernire excution du script. Un champ de ModificationDate (ou un champ similaire) est requis pour que QlikView reconnaisse les nouveaux enregistrements.

428

Exemple de script:
Table_QV: SQL SELECT ClPrimaire, X, Y FROM TABLE_BD WHERE MomentModification >= #$(MomentDernExc)# AND MomentModification < #$(DbutCetteExc)#; Concatenate LOAD ClPrimaire, X, Y FROM Fichier.QVD; STORE Table_QV INTO Fichier.QVD;

Cas 3: Insertion et mise jour (sans suppression)


Le cas suivant est applicable quand des donnes peuvent avoir chang entre des excutions du script dans les enregistrements dj lus. Les conditions suivantes s'appliquent:
l l

La source de donnes peut tre n'importe quelle base de donnes. QlikView charge les enregistrements insrs ou mis jour dans la base de donnes aprs la dernire excution du script. Un champ de ModificationDate (ou un champ similaire) est requis pour que QlikView reconnaisse les nouveaux enregistrements. Un champ de cl primaire est requis pour que QlikView extraie les enregistrements mis jour du fichier QVD. Cette solution forcera la lecture du fichier QVD en mode standard (plutt qu'en mode super-rapide), qui reste beaucoup plus rapide que le chargement de la base de donnes entire.

l l

429

Exemple de script:
Table_QV: SQL SELECT ClPrimaire, X, Y FROM TABLE_BD WHERE MomentModification >= #$(MomentDernExc)#; Concatenate LOAD ClPrimaire, X, Y FROM Fichier.QVD WHERE NOT Exists(ClPrimaire); STORE Table_QV INTO Fichier.QVD;

Cas 4: Insertion, mise jour et suppression


Le cas le plus difficile traiter est celui d'enregistrements supprims de la base de donnes source entre des excutions du script. Les conditions suivantes s'appliquent:
l l

La source de donnes peut tre n'importe quelle base de donnes. QlikView charge les enregistrements insrs ou mis jour dans la base de donnes aprs la dernire excution du script. QlikView retire les enregistrements supprims de la base de donnes aprs la dernire excution du script. Un champ de ModificationDate (ou un champ similaire) est requis pour que QlikView reconnaisse les nouveaux enregistrements. Un champ de cl primaire est requis pour que QlikView extraie les enregistrements mis jour du fichier QVD. Cette solution forcera la lecture du fichier QVD en mode standard (plutt qu'en mode super-rapide), qui reste beaucoup plus rapide que le chargement de la base de donnes entire.

l l

l l

430

Exemple de script:
Let MomentCetteExc = Now( ); Table_QV: SQL SELECT ClPrimaire, X, Y FROM TABLE_BD WHERE MomentModification >= #$(MomentDernExc)# AND MomentModification < #$(MomentCetteExc)#; Concatenate LOAD ClPrimaire, X, Y FROM Fichier.QVD WHERE NOT EXISTS(ClPrimaire); Inner Join SQL SELECT ClPrimaire FROM TABLE_BD; If ScriptErrorCount = 0 then STORE Table_QV INTO Fichier.QVD; Let MomentDernExc = MomentCetteExc; End If

431

432

29 Scurit
Un mcanisme de scurit peut tre dfini de deux manires dans QlikView: Il peut tre intgr au script du document QlikView ou dfini l'aide de QlikView Publisher.

29.1 Authentification et autorisation


L'authentification est une procdure permettant de vrifier l'identit d'un utilisateur. QlikView peut laisser le systme d'exploitation Windows effectuer l'authentification, demander l'ID utilisateur et le mot de passe (diffrents de l'ID utilisateur et du mot de passe Windows) ou utiliser le numro de srie de la licence QlikView comme mthode d'authentification simple. Les autorisations permettent de vrifier, aprs identification de l'utilisateur, que ce dernier est autoris accder la ressource. QlikView peut laisser le systme d'exploitation Windows effectuer les autorisations ou bien les effectuer lui-mme. Pour cela, QlikView doit crer une table de scurit dans le script.

29.2 Scurit dans QlikView Publisher


Si QlikView Publisher est paramtr pour grer la scurit, chaque fichier QlikView est spar en plusieurs fichiers contenant chacun les donnes de l'utilisateur ou du groupe d'utilisateurs concern. Ces fichiers sont stocks dans des dossiers avec les paramtres de scurit appropris du systme d'exploitation. QlikView permet en fait au systme d'exploitation de grer l'authentification et les autorisations. Cependant, aucune scurit n'est intgre au fichier lui-mme et il n'existe donc aucune protection pour les fichiers tlchargs. tant donn qu'un fichier est spar en plusieurs fichiers et qu'un utilisateur n'ouvre que le fichier contenant ses propres donnes, les fichiers sont gnralement plus petits. Cependant, cela implique que QlikView Server puisse ventuellement utiliser plus de mmoire que si toutes les donnes taient contenues dans un seul fichier. En effet, plusieurs fichiers contenant les mmes donnes peuvent tre chargs. Pour plus d'informations, voir la documentation de QlikView Publisher.

29.3 Scurit utilisant une section d'accs dans le script QlikView


Si une section d'accs est dfinie dans le script QlikView pour grer la scurit, un seul fichier est cr pour contenir les donnes d'un certain nombre d'utilisateurs ou de groupes d'utilisateurs. QlikView se sert des informations de la section d'accs pour l'authentification et les autorisations et rduit les donnes de faon dynamique afin que chaque utilisateur ne puisse consulter que ses propres donnes. Le systme de scurit est intgr au fichier. Ainsi, un fichier tlcharg est galement protg. Cependant, si les demandes de scurit sont importantes, il faut empcher le tlchargement et l'utilisation hors ligne des fichiers. Les fichiers ne doivent tre publis que par QlikView Server. Les donnes tant rassembles dans un seul fichier, ce fichier peut potentiellement tre trs volumineux. Les informations ci-dessous concernent la mthode de scurit utilisant la section d'accs dans le script QlikView.

29.4 Sections dans le script


QlikView gre le contrle des accs grce une ou plusieurs tables de scurit charges de la mme manire que les donnes normales. On peut ainsi stocker les donnes d'accs dans une base de donnes normale. Les

433

instructions de script grant les tables de scurit figurent dans la section d'accs qui dmarre dans le script par l'instruction section access. Si une section d'accs est dfinie dans le script, la partie du script chargeant les donnes normales doit se trouver dans une autre section, qui commence par l'instruction section application.

Exemple:
Section Access; Load * inline [ACCESS,USERID,PASSWORD ADMIN, A,X USER,U,Y ]; Section Application; Load... ... from... ...

29.5 Niveaux d'accs dans Section Access


L'accs aux documents QlikView peut tre restreint certains utilisateurs ou groupes d'utilisateurs. Dans la table de scurit, les utilisateurs peuvent se voir attribuer les niveaux d'accs ADMIN ou USER. Si aucun niveau d'accs ne lui est attribu, l'utilisateur ne peut pas ouvrir le document QlikView. Une personne disposant d'un accs ADMIN peut tout modifier dans le document. Grce l'onglet Scurit des botes de dialogue Proprits du document et Proprits de la feuille, elle peut limiter les possibilits de modification du document dont disposent les utilisateurs. Une personne disposant de privilges USER ne peut pas accder aux onglets Scurit.

Remarque: Les droits d'accs ADMIN s'appliquent uniquement aux documents locaux. Les documents ouverts sur un serveur sont toujours accessibles l'aide de droits USER.

29.6 Champs systme d'accs de section


Les niveaux d'accs sont attribus aux utilisateurs dans une ou plusieurs tables charges dans l'accs de session. Ces tables peuvent contenir plusieurs champs systme propres l'utilisateur, en gnral USERID et PASSWORD, ainsi que le champ dfinissant le niveau d'accs, ACCESS. Tous les champs systme Section Access seront utiliss pour les authentifications ou les autorisations. L'ensemble de ces champs systme d'accs section sont dcrits ci-dessous. Dans la section d'accs, on peut charger tous les champs de scurit, seulement certains d'entre eux ou aucun. Il n'est pas forcment ncessaire d'utiliser USERID. L'autorisation peut se faire l'aide des autres champs, partir du numro de srie, par exemple. ACCESS Champ qui dfinit le type d'accs de l'utilisateur correspondant. USERID Champ qui doit contenir un ID utilisateur accept. QlikView invite l'utilisateur saisir un ID utilisateur qu'il compare la valeur de ce champ. Cet ID utilisateur est diffrent de l'ID utilisateur de Windows. Champ qui doit contenir un mot de passe accept. QlikView invite l'utilisateur saisir un mot de passe qu'il compare la valeur de ce champ. Ce mot de passe est diffrent du mot de passe de Windows.

PASSWORD

434

SERIAL

Champ qui doit contenir un nombre correspondant au numro de srie de QlikView. Exemple: 4900 2394 7113 7304 QlikView vrifiera le numro de srie de l'utilisateur et le compare la valeur de ce champ. Champ qui doit contenir une chane correspondant un nom d'utilisateur ou nom de groupe du domaine Windows NT. QlikView rcuprera les informations de connexion auprs du systme d'exploitation et les comparera la valeur de ce champ.

NTNAME

NTDOMAINSID Champ qui doit contenir une chane correspondant un SID du domaine Windows NT. Exemple: S-1-5-21-125976590-4672381061092489882 QlikView rcuprera les informations de connexion auprs du systme d'exploitation et les comparera la valeur de ce champ. NTSID Champ devant contenir un SID Windows NT. Exemple: S-15-21-125976590-467238106-1092489882-1378 QlikView rcuprera les informations de connexion auprs du systme d'exploitation et les comparera la valeur de ce champ. Champ devant contenir le champ omettre pour cet utilisateur spcifique. On peut utiliser des caractres gnriques et le champ peut tre vide. La mthode la plus facile est d'utiliser une fonction subfield.

OMIT

QlikView comparera le numro de srie QlikView au champ SERIAL, le nom d'utilisateur et les groupes Windows NT NTNAME, le SID du domaine Windows NT NTDOMAINSID et le SID Windows NT NTSID. Il demandera ensuite un ID utilisateur et un mot de passe et les comparera aux champs USERID et PASSWORD. Si l'ID utilisateur, le mot de passe et les proprits d'environnement sont associs de la mme manire que dans la table Section Access, le document s'ouvre avec le niveau d'accs correspondant. Sinon, QlikView refusera l'accs au document. Si l'ID utilisateur et/ou le Mot de passe ne sont pas saisis correctement au bout de trois tentatives, la procdure de connexion doit tre reprise au dbut. Comme la logique interne qui distingue QlikView est aussi utilise dans la section d'accs, les champs de scurit peuvent tre indiqus dans diffrentes tables. (Ainsi, un gestionnaire de systme peut crer un document QlikView en dehors des tables de scurit. Dans ce cas, on simule un bon numro de srie, un mot de passe, etc. en cliquant sur la valeur de champ correspondante.) Au cours de la procdure de connexion, QlikView vrifiera d'abord les champs SERIAL, NTNAME, NTDOMAINSID et NTSID afin de voir si ces informations sont suffisantes pour autoriser l'accs au document. Si c'est le cas, QlikView ouvrira le document sans demander d'ID utilisateur ni de Mot de passe. Si seulement certains champs d'accs sont chargs, le programme utilise les informations requises appropries parmi celles numres ci-dessus. Tous les champs lists dans les instructions Load ou Select de la section d'accs doivent tre crits en MAJUSCULES. Tout nom de champ contenant des lettres minuscules dans la base de donnes doit tre converti en lettres majuscules l'aide de la fonction upper (voir upper(textexpression) (page 348)) avant d'tre lu par l'instruction Load ou Select. En revanche, l'ID utilisateur et le mot de passe saisis par l'utilisateur final ouvrant les documents QlikView ne tiennent pas compte de la casse. Une astrisque (*) est interprte comme toutes les valeurs (listes) de ce champ, c'est--dire une valeur liste ailleurs dans cette table. S'il est utilis dans l'un des champs systme (USERID, PASSWORD, NTNAME ou SERIAL) d'une table charge dans la section d'accs du script, il est interprt comme toutes les valeurs possibles du champ (y compris celles qui ne figurent pas dans la liste).

435

Remarque: Lors du chargement de donnes partir d'un fichier QVD, l'utilisation de la fonction upper ralentit la vitesse de chargement. Remarque: Pour gnrer des tables d'accs dans des instructions inline, utilisez l' Assistant Table de restriction d'accs (page 209).

Exemple 1:
Seul le numro de srie est vrifi. Le niveau d'accs ADMIN est accord un seul ordinateur. Tous les autres ordinateurs obtiennent le niveau d'accs USER. Notez que l'astrisque peut servir indiquer n'importe quel numro de srie. Pour cela, l'instruction Star is *; doit prcder le chargement de cette table.

ACCESS
ADMIN USER

SERIAL
4900 2394 7113 7304 *

Exemple 2:
L'administrateur et le serveur sur lequel QlikView est excut en traitement par lots obtiennent un accs ADMIN. Tous les autres utilisateurs du domaine obtiennent un accs USER en saisissant l'ID utilisateur et le mot de passe USER.

ACCESS SERIAL
ADMIN ADMIN USER *

NTDOMAINSID

USERID
ADMIN * USER

PASSWORD
ADMIN * USER

S-1-5-21-125976590-4672381061092489882 4900 2394 7113 7304 * * S-1-5-21-125976590-4672381061092489882

29.7 Restrictions concernant les fonctionnalits QlikView


Les commandes disponibles sous les onglets Proprits du document: Scurit (page 459) et Proprits de la feuille: Scurit (page 492) permettent d'interdire l'accs certains lments de menu et d'interdire les modifications du modle de disposition. Pour que ces paramtres constituent une vritable mesure de protection, il est important que les utilisateurs du document soient connects en tant que USER. Toute personne connecte en tant qu'ADMIN peut modifier les paramtres de scurit tout moment. Un utilisateur qui a ouvert le document en disposant des droits USER ne dispose pas des onglets Scurit dans les botes de dialogue Proprits.

29.8 Rduction de donnes dynamique


QlikView et le serveur QlikView prennent en charge une fonction qui permet de cacher une partie des donnes d'un document l'utilisateur, en fonction de ses droits d'accs. On peut d'abord cacher les champs (colonnes) l'aide du champ systme OMIT. On peut ensuite cacher les enregistrements (lignes) en liant les donnes Section Access aux donnes relles: La slection des valeurs afficher/exclure se fait en indiquant un ou plusieurs champs portant le mme nom dans section access et dans section application. Aprs la connexion de l'utilisateur, QlikView tentera de

436

copier les slections des champs figurant dans section access aux champs section application portant exactement les mmes noms (qui doivent tre crits en MAJUSCULES). Ces slections effectues, QlikView cachera en permanence l'utilisateur toutes les donnes ainsi exclues. Pour pouvoir excuter cette procdure, activez l'option Rduction initiale des donnes base sur l'accs aux sections sous l'onglet Proprits du document: Ouverture. Si cette fonction est utilise dans des documents censs tre distribus par d'autres moyens que le serveur QlikView, cochez l'option Interdire le chargement de fichiers binaires disponible sous le mme onglet afin de maintenir la protection des donnes.

Remarque: Tous les noms de champs utiliss dans le transfert dcrit ci-dessus et toutes les valeurs de ces champs doivent tre en majuscules, car les noms et les valeurs de champs sont par dfaut convertis en majuscules dans section access.

Exemple:
section access; load * inline [ ACCESS, USERID,REDUCTION, OMIT ADMIN, ADMIN,*, USER, A,1 USER, B, 2,NUM USER, C, 3, ALPHA ]; section application; T1: load *, NUM AS REDUCTION; load Chr( RecNo()+ord(A)-1) AS ALPHA, RechNo() AS NUM AUTOGENERATE 3;
Le champ REDUCTION (en lettres majuscules) existe dsormais la fois dans section access et dans section application (toutes les valeurs de champ sont galement en majuscules). Les deux champs seraient normalement compltement distincts, mais si l'option Rduction initiale des donnes base sur l'accs aux sections est slectionne, ils seront lis et rduiront le nombre d'enregistrements affichs pour l'utilisateur. Le champ OMIT figurant dans section access dfinit les champs devant tre cachs l'utilisateur. Le rsultat sera le suivant : L'utilisateur A peut voir tous les champs, mais seulement les enregistrements connects REDUCTION=1. L'utilisateur B peut voir tous les champs l'exception de NUM et seulement les enregistrements connects REDUCTION=2. L'utilisateur C peut voir tous les champs l'exception d'ALPHA et seulement les enregistrements connects REDUCTION=3.

29.9 Droits d'accs hrits


Avec un chargement binaire, les droits d'accs sont hrits par le nouveau document QlikView. Toute personne possdant des droits ADMIN pour ce nouveau document peut en modifier les droits d'accs en ajoutant une nouvelle section access. Une personne possdant des droits USER peut excuter et modifier le script, ajoutant ainsi ses propres donnes au fichier binaire charg. Il ne peut pas modifier les droits d'accs.

437

Cela permet un administrateur de base de donnes de contrler l'accs des utilisateurs, y compris aux documents QlikView binaires chargs.

29.10 Chiffrement
La communication entre QlikView Server et un client QlikView Windows est code. Cependant, en cas d'utilisation du client AJAX, la communication n'est pas code. En outre, tous les documents QlikView sont brouills, ce qui rend les informations illisibles pour des visionneurs, dbogueurs, etc.

438

Partie 5 Feuille et objets de feuille

Partie 5 Feuille et objets de feuille

439

30 Proprits du document
Ouvre la page Proprits du document: Gnral (page 440). Elle permet de spcifier certains paramtres, tels que l'image et le son d'ouverture, la police par dfaut, l'ordre de tri, etc. pour un document en particulier.

30.1 Proprits du document: Gnral

Proprits du document, Gnral

Titre

Indique le titre affich dans la barre de titre de la fentre. Par dfaut, c'est le nom de fichier du document qui est utilis. Pour le modifier, saisissez le nouveau titre dans la zone de texte Titre. Dans la zone de texte Auteur, spcifiez l'auteur du fichier QlikView.

Auteur

440

Partie 5 Feuille et objets de feuille

Format d'enregistrement Ce groupe permet de dfinir le niveau de compression des fichiers QlikView. Compression Les options Moyenne et Haute diminuent considrablement la taille du fichier QlikView, au dtriment de la vitesse de chargement et d'enregistrement. Les options de compression dfinies dans les Proprits du document sont appliques au document ouvert. Les options de compression dfinies dans les Prfrences utilisateur sont appliques tous les nouveaux documents. Pour plus de dtails sur la compression et sur la faon de dfinir la compression par dfaut pour tous les nouveaux fichiers, voir Prfrences utilisateur: Enregistrer (page 85) dans la bote de dialogue Prfrences utilisateur. Info-bulles d'alerte Ce bouton ouvre la bote de dialogue Paramtres de la fentre contextuelle qui permet de dfinir l'apparence par dfaut des info-bulles d'alerte. Ce bouton ouvre la bote de dialogue Paramtres de la fentre contextuelle (page 445) qui permet de dfinir l'apparence par dfaut des messages info-bulle. Fonctionnalit dont l'activation est effectue par un dveloppeur QlikView. Le dveloppeur appelle la bote de dialogue tat alternatif en cliquant sur ce bouton. Pour plus d'informations, voir tats alternatifs (page 129).

Info-bulles d'aide

tats alternatifs...

Remarque: Activez uniquement cette fonctionnalit si son utilisation se justifie dans le document QlikView.
Stat. de la mmoire Cliquez sur ce bouton afin d'enregistrer un fichier de tables contenant des statistiques sur l'utilisation de la mmoire concernant le document QlikView actif. Ce fichier peut tre lu par exemple par QlikView pour analyser les besoins en mmoire de diffrentes parties du document.

441

Arrire-plan par dfaut de la feuille

Cochez cette case pour personnaliser l'attribut Couleur d'arrire-plan de l'option Arrire-plan par dfaut de la feuille applicable la ou aux fentres du document. La couleur peut tre une couleur unie ou un dgrad dfini l'aide de la bote de dialogue Couleur de la zone (page 446) qui s'ouvre lorsqu'on clique sur le bouton. Vous pouvez galement spcifier une image d'arrire-plan en cochant la case Image du papier peint et en cliquant sur le bouton Modifier. Vous ouvrirez ainsi la bote de dialogue Changer le papier peint o vous pourrez slectionner un fichier image. L'image d'arrire-plan peut tre modifie l'aide des options suivantes.

Formatage d'image: Sans tirement: L'image s'affiche telle quelle et peut donc tre en partie masque. Remplir: L'image est tire pour remplir la feuille, mais ses proportions ne sont pas respectes. Conserver les proportions L'image est tire autant que possible tout en conservant les bonnes proportions. Proportionnel: L'image est tire autant que possible tout en conservant les bonnes proportions. Les zones non couvertes sont ensuite remplies l'aide de morceaux de l'image. Mosaque: Si cette option est slectionne, l'image est affiche en mosaque en autant d'exemplaires que l'espace le permet. Options d'orientation Horizontal et Vertical: Horizontal: L'image peut tre aligne horizontalement: Gauche, au Centre ou Droite. Vertical: L'image peut tre aligne verticalement: en Haut, au Centre ou en Bas.
Utiliser une syntaxe FTP Si l'option Utiliser une syntaxe FTP passive est coche, la syntaxe FTP passive passive est active. Le protocole FTP intervient dans la bote de dialogue Ouvrir des fichiers Internet ou Ouvrir un document QlikView (page 205). L'option de syntaxe passive est utilise pour communiquer avec un serveur travers un parefeu. Gnrer un fichier journal Pour suivre l'excution du script de chargement, slectionnez Gnrer un fichier journal.Les informations prsentes dans la fentre Progression pendant l'excution du script seront stockes dans le fichier qv.log. Insre l'horodateur dans le nom du fichier, par exemple ventes.qvw.2009_02_26_ 12_09_50.log. Ce paramtre est uniquement disponible lorsque la case Gnrer un fichier journal est coche. L'option Masquer les options de menu non disponibles est utilise conjointement avec les paramtres de scurit. Toutes les options de menu qui devraient normalement tre grises seront compltement caches.

Date et heure dans le nom du fichier journal

Masquer les options de menu non disponibles

442

Partie 5 Feuille et objets de feuille

Masquer la range d'onglets

On peut supprimer la range d'onglets de la feuille QlikView en cochant Masquer la range d'onglets. Pour passer d'une feuille une autre, utilisez les Actions (page 585) (Fonction: Feuille suivante/Feuille prcdente) ou la barre d'outils Feuilles accessible partir du Menu Affichage (page 62). Vous pouvez aussi utiliser le contrle d'automatisation, qui vous permettra par exemple de forcer l'utilisateur se dplacer d'une feuille l'autre et mme effectuer des slections dans un certain ordre. L'option Conserver les tampons QVD non rfrencs ignore la procdure normale, qui purge tout de suite aprs l'excution du script tous les Fichiers QVD (page 425) crs automatiquement, condition qu'ils ne soient plus utiliss par le document qui les a crs. Normalement, cette case ne doit pas tre coche. Si la case Calcul des fractiles patrimoniaux est coche, QlikView utilise des valeurs discontinues comme rsultats de la fonction d'agrgation de fractile. Dsactivez cette case afin que QlikView utilise une valeur interpole, conformment la fonction Centile de Microsoft Excel. Avant la version7.5, QlikView ne prenait en charge que l'algorithme de valeurs discontinues. Si la case Dsactiver l'annulation de disposition est coche, le fonctionnement de la mmoire tampon des oprations d'annulation des modifications de la disposition est interrompu. Cela permet de limiter la consommation inutile de la mmoire lors du dploiement de certains documents QlikView. chaque fois qu'un utilisateur ou qu'une macro modifie la disposition, un ensemble de donnes est gnralement ajout la la mmoire tampon des oprations d'annulation des modifications de la disposition. Dans certains cas extrmes, le stockage des donnes dans la mmoire tampon peut entraner des problmes lors du dploiement des documents sur un serveur QlikView.

Conserver les tampons QVD non rfrencs

Calcul des fractiles patrimoniaux

Dsactiver l'annulation de disposition

Utiliser WebView dans la Permet d'afficher ou de masquer le mode WebView, lequel utilise le navigateur disposition Web interne de QlikView pour prsenter la disposition du document sous forme de page AJAX. Encodage d'exportation par dfaut Utilisez Encodage d'exportation par dfaut pour dfinir le jeu de caractres par dfaut exporter dans de nouveaux documents. Choisissez l'une des options suivantes: ANSI, Unicode ou UTF-8. Le menu droulant Style des objets permet de choisir le style d'objet de tous les objets de feuille. Le mode Avanc permet de configurer diffrents paramtres, tels que Style des objets de feuille et le type de bordure utiliser, sous l'onglet Disposition de chacun de ces objets. Le mode Simplifi permet galement de configurer le Style des objets de feuille, mais il configure automatiquement la plupart des paramtres. Il dfinit des lments tels que le style des barres de dfilement et les bordures. Certains paramtres sont galement modifiables via l'onglet Disposition (page 520) de ces objets.

Style des objets

443

Style des objets de feuille Dans le menu droulant Style des objets de feuille, slectionnez un style pour les lgendes des objets de feuille. Le style slectionn est appliqu tous les objets de feuille avec une barre de titre dans le document. Style de range d'onglets Dans la liste droulante Style de range d'onglets, slectionnez l'un des styles disponibles pour l'apparence des lignes d'onglets. Le style slectionn s'appliquera tous les onglets du document. Aspect de la slection QlikView prend en charge diffrentes prsentations des donnes et plusieurs possibilits pour effectuer des slections dans les listes de slection et les listes multiples. Les styles QlikView classique, Balise d'angle, Voyant et Cases cocher de voyant utilisent tous le codage couleur pour signaler les valeurs slectionnes, possibles et exclues. Les styles Cases cocher Windows et Cases cocher de voyant imitent l'interface Windows standard en associant une case cocher chaque valeur. En choisissant un style spcifique dans cette commande, vous pouvez forcer le document apparatre dans un style ou dans un autre chaque ouverture. Vous trouverez plus d'informations sur les styles de slection sous Prfrences utilisateur (page 81) et Proprits de la liste de slection: Prsentation (page 514). Lorsqu'on utilise les styles de slection base de couleurs, un certain nombre de jeux de couleurs diffrents sont disponibles. Les jeux de couleurs de base (vert pour les valeurs slectionnes, bleu pour les valeurs verrouilles, etc.) ne sont pas modifiables, mais des variations de ton et d'intensit sont possibles.

Style Dfinit le style de slection du document. Slectionnez l'une des alternatives proposes dans la liste droulante. Si vous choisissez <Valeurs utilisateur par dfaut> , le document s'ouvrira toujours conformment au style de slection indiqu dans les Prfrences utilisateur de l'ordinateur utilis. Jeu de couleurs Dfinit le jeu de couleurs des slections pour le document. Slectionnez l'une des alternatives proposes dans la liste droulante. Si vous choisissez <Valeurs utilisateur par dfaut> , le document s'ouvrira toujours conformment au jeu de couleurs indiqu dans les Prfrences utilisateur de l'ordinateur utilis. Transparence Dfinit la transparence de la couleur de slection dans les listes de slection et les listes multiples.
Arr.-plan range d'onglets Spcifiez une couleur personnalise pour l'arr.-plan range d'onglets en cliquant sur le bouton Arrire-plan ligne d'onglets correspondant.

444

Partie 5 Feuille et objets de feuille

Paramtres de la fentre contextuelle

Bote de dialogue Paramtres de la fentre contextuelle

Vous pouvez accder cette bote de dialogue soit partir de l'onglet Proprits du document: Gnral, soit partir de la bote de dialogue Alertes, qui se trouvent dans le menu Outils. Elle sert dfinir les proprits des Info-bulles d'aide ou des Info-bulles d'alerte. Les contrles de la bote de dialogue permettent de personnaliser les proprits suivantes: Le bouton Police ouvre la bote de dialogue Police (page 519) standard, qui permet de modifier les paramtres de police du texte de la fentre contextuelle modifier. La couleur d'arrire-plan de la fentre contextuelle peut tre dfinie comme une couleur unie ou un dgrad partir de la bote de dialogue Couleur de la zone (page 446) qui s'ouvre lorsque vous cliquez sur le bouton de couleur. L'icne par dfaut de la fentre contextuelle est une icne de question pour les info-bulles d'aide et une icne d'avertissement pour les info-bulles d'alertes. Choisissez parmi plusieurs autres options ou dfinissez l'affichage sur Aucune icne dans la liste droulante. Saisissez une dure dans la zone d'dition Dure d'affichage pour que les fentres contextuelles se ferment automatiquement aprs un certain temps (mesur en millisecondes). Si vous indiquez 0, la fentre restera affiche l'cran jusqu' ce que l'utilisateur clique pour la supprimer. Cochez Son pour lier un son la fentre contextuelle; voir Lier des informations des valeurs de champs (page 417). La zone d'dition en dessous doit alors contenir un chemin valide menant vers un fichier audio .wav. Il peut s'agir d'un chemin externe (par exemple, c:\monson.wav) ou du chemin d'un son QlikView ( Fichiers internes (page 175)) dj associ au programme (par exemple, qmem://<bundled>/sounds/qv_ ok.wav).

445

Couleur de la zone

Bote de dialogue Couleur de la zone

La plupart des zones colores d'un document QlikView peuvent tre modifies partir de la bote de dialogue Couleur de la zone. Indiquez soit une couleur unie couvrant toute la zone, soit un effet de dgrad. Les options de dgrad dcrites ci-dessous ne sont pas toujours disponibles et seront alors sgrises, par exemple pour les couleurs de texte. Couleur unie Dgrad uni Option de base, qui utilise une seule Couleur de base uniforme. Cette option introduit l'utilisation d'une Luminosit variable pour crer un effet de dgrad. Cre un effet de dgrad entre la Couleur de base et la Deuxime couleur spcifie.

Dgrad bicolore

Dans les groupes Couleur de base et Deuxime couleur, on peut choisir des couleurs fixes ou calcules. Tous les paramtres de couleur peuvent tre affichs dans la bote de dialogue. Dans le groupe Couleur de base, vous dterminez la couleur de base pour les zones unies et les dgrads. Fixe Cette option indique une seule couleur fondamentale. Cliquez sur le bouton color pour changer de couleur.

446

Partie 5 Feuille et objets de feuille

Calcul

La couleur peut tre calcule de faon dynamique par une expression. L'expression doit tre une reprsentation de couleur valide, qui s'obtient l'aide des Fonctions de la catgorie Couleur (page 389). Cliquez sur le bouton ... pour ouvrir la bote de dialogue diter l'expression qui facilite l'dition des formules longues. Si le rsultat de l'expression n'est pas une reprsentation de couleur valide, le programme utilisera par dfaut le noir. Lorsque vous utilisez un dgrad uni, ce curseur dtermine l'ombrage/la luminosit relatifs de la couleur l'autre extrmit du dgrad. Le curseur va du plus sombre ( gauche) au plus lumineux ( droite). Au milieu, ce rglage rend une couleur uniforme.

Luminosit

Dans le groupe Deuxime couleur, vous dterminez la deuxime couleur pour les dgrads bicolores. Fixe Cette option indique une seule couleur fondamentale. Cliquez sur le bouton color pour changer de couleur. La couleur peut tre calcule de faon dynamique par une expression, l'aide des Fonctions de la catgorie Couleur (page 389).

Calcul

Dans le groupe Style d'ombrage, vous dterminez la direction de l'effet de dgrad. Vous pouvez obtenir diffrents rsultats en combinant les options disponibles (Horizontal, Vertical, etc.) avec l'une des quatre variantes. Le groupe Variantes prsente quatre options diffrentes pour chaque Style d'ombrage slectionn. Cliquez sur celle que vous prfrez.

447

30.2 Proprits du document: Ouverture

Proprits du document, Ouverture

Dans cet onglet, on peut personnaliser l'ouverture d'un document. Image Slectionner... Cochez cette case afin de spcifier une image d'ouverture pour le document. Cliquez sur ce bouton pour ouvrir la bote de dialogue Slectionne l'image o vous pouvez slectionner une image (bmp, jpg, jpeg ou png). Permet l'utilisateur de fermer l'image d'ouverture en cliquant dessus. On doit cocher soit cette case, soit la case en dessous.

Fermer sur un clic

Fermer aprs n secondes Ferme l'image d'ouverture automatiquement. On doit cocher soit cette case, soit la case au-dessus. Fermer aprs chargement Ferme l'image d'ouverture lorsque le fichier a t charg. Son Cochez cette case pour ajouter un son l'ouverture du document. Le bouton Slectionner est alors disponible. Ce bouton permet d'ouvrir la bote de dialogue Slectionner un fichier son o vous pouvez chercher un fichier son.

Slectionner...

448

Partie 5 Feuille et objets de feuille

Lire

Cliquez sur ce bouton pour lire le son slectionn.

Rduction initiale des Si l'option Scurit (page 433) est slectionne, QlikView excutera une donnes base sur l'accs procdure l'ouverture du document (ou l'ouverture d'une nouvelle session sur aux sections le serveur QlikView) qui cache de faon permanente certaines donnes l'utilisateur, en fonction des informations de connexion que celui-ci a fournies. Lorsque cette caractristique est utilise sur un document qui n'est pas excut exclusivement sur un serveur QlikView, elle doit toujours tre combine avec l'option Interdire le chargement de fichiers binaires (voir ci-dessous) afin de prserver la scurit d'accs aux donnes. Ce paramtre est mutuellement exclusif avec Slection initiale base sur l'accs aux sections. Exclusion stricte Si cette case est coche en plus de Rduction initiale des donnes base sur l'accs aux sections, l'exclusion stricte sera utilise lors de la rduction des donnes. Cela signifie que l'accs au document sera refus chaque fois que les valeurs des champs de rduction de la section d'accs n'auront pas leurs quivalents dans les champs correspondants de la section d'application. Cela ne s'appliquera toutefois pas pour les utilisateurs possdant le statut d'administrateur, qui, la place, verront les donnes non rduites mme si les valeurs ne correspondent pas. Par dfaut, ce paramtre est activ dans les documents crs avec QlikView 7.02 et les versions ultrieures et il est recommand pour un maximum de scurit d'accs. Si cette option est coche, QlikView excutera une procdure l'ouverture du document (ou l'ouverture d'une nouvelle session sur le serveur QlikView) qui affichera la slection en fonction des informations de connexion que l'utilisateur aura fournies. Lorsque cette caractristique est utilise sur un document qui n'est pas excut exclusivement sur un serveur QlikView, elle doit toujours tre combine avec l'option Interdire le chargement de fichiers binaires (voir cidessous) afin de prserver la scurit d'accs aux donnes. Ce paramtre est mutuellement exclusif avec Rduction initiale des donnes base sur l'accs aux sections. Si cette option est slectionne, il est impossible de charger des donnes partir du fichier .qvw du document dans un autre document QlikView par une instruction Binary (page 244). Permet de dfinir le mode d'affichage du document sur AccessPoint lorsque l'option d'aperu est slectionne. Aucune Un aperu avec un message indiquant une image manquante apparat sur AccessPoint. Ouverture de la feuille La premire feuille du document apparat sur AccessPoint. Image Cliquez sur Parcourir pour rechercher l'image afficher sur AccessPoint.

Slection initiale base sur l'accs aux sections

Interdire le chargement de fichiers binaires

Miniature du document

449

30.3 Proprits du document: Feuilles

Proprits du document, Feuilles

Pour afficher l'onglet Proprits du document: Feuilles permet de garder une trace de chaque feuille et de chaque objet du document QlikView. Cet onglet de la bote de dialogue consiste en deux listes: la liste des Feuilles et la liste des Objets de feuille. Vous pouvez trier les deux tableaux sur n'importe quelle colonne, en cliquant sur l'en-tte de la colonne voulue. La liste des Feuilles contient les informations suivantes: # ID de la feuille Titre tat Numro de la feuille (position), partir de 0.

ID unique de la feuille.
Texte qui apparat sur l'onglet de la feuille. Indique si l'tat de la feuille est normal, masqu ou si elle possde une condition d'affichage. Nombre d'objets actuellement sur la feuille.

Nbre d'objets

450

Partie 5 Feuille et objets de feuille

Aprs avoir cliqu sur une feuille de la liste, utilisez les boutons au-dessous pour la supprimer ou pour ouvrir directement la bote de dialogue Proprits partir de ce menu. Vous pouvez aussi promouvoir/abaisser la feuille. La liste des Objets de feuille contient les informations suivantes: ID de la feuille ID d'objet

ID unique de la feuille.
Liste les ID d'objet uniques de chaque objet de feuille. Les objets lis ont le mme ID. Prcise le type d'objet. Texte figurant dans la lgende de l'objet de feuille. Indique si l'objet est normal, rduit, agrandi, masqu ou s'il possde une condition d'affichage. Temps en millisecondes ncessaire pour le dernier recalcul du contenu de l'objet. Cette information n'est pertinente que pour les objets qui sont effectivement calculs (graphiques, zones Table et tout objet contenant des formules). Couche dfinie sous l'onglet Disposition de la bote de dialogue des proprits de l'objet comme BasStandard ou Haut; ces proprits correspondent aux nombre -1, 0 ou 1 dans la liste. (La couche d'un objet peut toutefois tre dfinie par n'importe quel nombre compris entre -128 et +127 via l'interface API d'automatisation.) Quantit de mmoire vive (en Ko) ncessaire pour le dernier recalcul du contenu de l'objet. Cette information n'est pertinente que pour les objets qui sont effectivement calculs (graphiques, zones Table et tout objet contenant des formules). Position actuelle du bord indiqu de l'objet de feuille par rapport au bord de la fentre du document, exprime en pixels. Dimensions de l'objet, exprimes en pixels. Position actuelle de l'objet sous forme d'icne (= rduit) et exprime en pixels.

Type Lgende Mode d'affichage

Temps de calcul

Couche

Mmoire

Gauche, Haut, Droite, Bas Largeur, Hauteur Gauche (min.), Haut (min.), Droite (min.), Bas (min.) Largeur Hauteur

Largeur actuelle de l'icne rduite de l'objet, exprime en pixels. Hauteur actuelle de l'icne rduite de l'objet, exprime en pixels.

451

Exporter la structure

En cliquant sur ce bouton, vous pouvez exporter la structure des feuilles et objets du document vers un ensemble de fichiers texte. Ces fichiers texte, l'un pour les feuilles (nomdufichier.Feuilles.tab), l'autre pour les objets (nomdufichier.Objets.tab), peuvent facilement tre lus nouveau dans QlikView pour vous permettre de poursuivre l'analyse en bnficiant de toute la puissance de la logique QlikView. Une bote de dialogue vous permet de slectionner le dossier cible de l'exportation. Par dfaut, les fichiers sont placs dans le mme dossier que le document QlikView.

Aprs avoir cliqu sur un objet de la liste, utilisez les boutons au-dessous pour le supprimer ou pour ouvrir directement la bote de dialogue Proprits partir de ce menu. Vous pouvez slectionner plusieurs objets en cliquant dessus avec la touche CTRL enfonce.

30.4 Proprits du document: Serveur

Proprits du document, Serveur

Sur cet onglet, vous dfinissez certaines des proprits du document s'excutant sur un serveur QlikView.

Mode d'actualisation du document lors de sa mise jour sur le serveur Ce paramtre dfinit comment sera manipul un document modifi sur le serveur QlikView.

452

Partie 5 Feuille et objets de feuille

Le client provoque Choisissez cette option si le serveur ne doit pas lancer automatiquement l'actualisation. Si les d'opration d'actualisation de donnes sur le client. Quand une nouvelle version anciennes donnes ne sont du document devient disponible sur le serveur, le client est invit rgnrer les pas stockes sur le donnes selon les prfrences dfinies sous l'option Mode de lancement de serveur ou si le client est l'actualisation du client dcrit ci-dessous. Si ce n'est pas possible, parce que le trop ancien, la session client est trop ancien (version antrieure la version8) ou que le serveur est sera dconnecte. configur avec l'option Autoriser une seule copie du document dans la mmoire dans le panneau de configuration de QlikView Server, la session sera simplement dconnecte. Le client provoque Choisissez cette option si vous prfrez laisser le client lancer une actualisation l'actualisation. Si les des donnes, mais permettre au serveur de lancer une actualisation automatique si anciennes donnes ne sont ncessaire. Quand une nouvelle version du document devient disponible sur le pas stockes sur le serveur, le client est invit rgnrer les donnes selon les prfrences dfinies serveur ou si le client est sous l'option Mode de lancement de l'actualisation du client dcrit ci-dessous. trop ancien, Si ce n'est pas possible, parce que le client est trop ancien (version antrieure la l'actualisation sera version8) ou si le serveur est configur avec l'option Autoriser une seule copie effectue du document dans la mmoire dans le panneau de configuration de QlikView automatiquement Server, l'actualisation sera effectue automatiquement par le serveur. Le serveur effectue l'actuatlisation automatiquement, sans action du client C'est l'option choisir si vous prfrez toujours laisser le serveur lancer automatiquement une actualisation des donnes sur le client. Quand une nouvelle version du document devient disponible sur le serveur, les donnes dans le client seront rgnres.

Mode