Guide utilisateur du Workbench WPS ... - World … w… · Guide utilisateur du Workbench Version...

198
Guide utilisateur du Workbench Version 3.3 WPS Workbench guide utilisateur “Pour vous guider dans l'utilisation de WPS Workbench pour créer, modifier et exécuter les programmes” Version: 3.3.5 Copyright © 2002-2018 World Programming Limited www.worldprogramming.com

Transcript of Guide utilisateur du Workbench WPS ... - World … w… · Guide utilisateur du Workbench Version...

Guide utilisateur du WorkbenchVersion 3.3

WPS Workbenchguide utilisateur

“Pour vous guider dans l'utilisation deWPS Workbench pour créer, modifier et

exécuter les programmes”

Version: 3.3.5Copyright © 2002-2018 World Programming Limited

www.worldprogramming.com

Guide utilisateur du WorkbenchVersion 3.3

2

Sommaire

Introduction...............................................................................................7À propos de ce guide.................................................................................................................... 7À propos de WPS.......................................................................................................................... 7

Eclipse..................................................................................................................................8Utilisateurs du logiciel SAS®......................................................................................................... 9

Premiers pas.......................................................................................... 11Fenêtre de lancement des espaces de travail.............................................................................11

Pages Bienvenue.............................................................................................................. 12Migration des programmes et projets existants...........................................................................13

Migration depuis les versions antérieures de WPS.......................................................... 13Migration depuis les logiciels SAS®................................................................................. 13

Importer les exemples et d'autres projets....................................................................................14Disposition du Workbench........................................................................................................... 15

Perspective WPS par défaut.............................................................................................15Aide en ligne................................................................................................................................ 16Aide-mémoires..............................................................................................................................17

Composants de WPS.............................................................................23

Clé de licence.........................................................................................25Appliquer une licence...................................................................................................................25Afficher les détails de la licence appliquée................................................................................. 26

Serveur WPS.......................................................................................... 27Configurer l'installation locale de WPS........................................................................................28Serveur WPS par défaut..............................................................................................................29Paramètres LOCALE et ENCODING du serveur WPS............................................................... 30

Encodage général du fichier texte.................................................................................... 31

Vues du Workbench.............................................................................. 33Vues Explorateur de projets et Explorateur de fichiers............................................................... 33

Explorateur de projets....................................................................................................... 35Explorateur de fichiers.......................................................................................................36

Explorateur de liens..................................................................................................................... 39Explorateur de serveurs WPS..................................................................................................... 42

Propriétés du serveur WPS local......................................................................................45Propriétés du serveur WPS distant...................................................................................47

Propriétés......................................................................................................................................48

Guide utilisateur du WorkbenchVersion 3.3

3

Éditeur.......................................................................................................................................... 49Signets..........................................................................................................................................50Tâches.......................................................................................................................................... 50Structure....................................................................................................................................... 51Explorateur de sorties.................................................................................................................. 52Explorateur de résultats............................................................................................................... 53Progression...................................................................................................................................54Console (pour la sortie standard des serveurs distants)............................................................. 55Rechercher................................................................................................................................... 55

Travailler avec les vues........................................................................ 57Empilements de vues...................................................................................................................57Ouvrir une vue............................................................................................................................. 57Fermer une vue............................................................................................................................58Déplacer une vue.........................................................................................................................58Vues flottantes ou ancrées.......................................................................................................... 59Redimensionner une vue............................................................................................................. 59Minimiser une vue........................................................................................................................60Maximiser une vue.......................................................................................................................60Restaurer une vue....................................................................................................................... 60Perspectives................................................................................................................................. 61

Ouvrir une perspective...................................................................................................... 61Fermer une perspective.................................................................................................... 62Réinitialiser une perspective............................................................................................. 62Enregistrer une perspective.............................................................................................. 63Supprimer une perspective............................................................................................... 63

Projets..................................................................................................... 64Fichier de définition de projet...................................................................................................... 64Gérer les projets.......................................................................................................................... 65

Créer un projet.................................................................................................................. 65Copier un projet.................................................................................................................71Supprimer un projet...........................................................................................................71Fermer et ouvrir un projet................................................................................................. 72Importer des fichiers..........................................................................................................73Exporter un projet..............................................................................................................73Travailler dans plusieurs projets....................................................................................... 74

Basculer vers un autre espace de travail.................................................................................... 75Historique local.............................................................................................................................75

Comparer un programme à son historique local...............................................................76Remplacer un programme par son historique local.......................................................... 77Restaurer un programme à partir de son historique local.................................................78Préférences de l'historique local....................................................................................... 79

Comparer et fusionner des fichiers..............................................................................................79

Guide utilisateur du WorkbenchVersion 3.3

4

Gérer les fichiers dans la vue Explorateur de fichiers.......................82Créer un dossier dans un système de fichiers............................................................................82Créer un fichier dans un système de fichiers..............................................................................82

Créer un programme dans un système de fichiers...........................................................83Ouvrir un fichier dans un système de fichiers............................................................................. 84Déplacer un fichier dans un système de fichiers.........................................................................85

Déplacer des fichiers par couper-coller............................................................................ 85Déplacer des objets par glisser-déposer.......................................................................... 85

Copier un fichier dans un système de fichiers............................................................................ 86Copier des objets à l'aide des commandes Copier et Coller............................................ 86Copier des objets par glisser-déposer.............................................................................. 87

Renommer un objet dans un système de fichiers....................................................................... 87Supprimer un objet d'un système de fichiers.............................................................................. 88Préférences concernant l'explorateur de fichiers WPS (fichiers masqués)..................................88

Préférences.............................................................................................89Filtre de préférences.................................................................................................................... 89Préférences générales................................................................................................................. 90Préférences concernant les raccourcis clavier............................................................................ 92Enregistrer les préférences.......................................................................................................... 93

Créer un programme............................................................................. 95Coloration syntaxique dans WPS................................................................................................ 97Saisir du code WPS à l'aide de modèles.................................................................................... 98Aide dynamique sur les éléments de langage.............................................................................99Utiliser l'assistant de contenu de programme..............................................................................99Injection de code WPS.............................................................................................................. 100Analyseur de code..................................................................................................................... 101

Analyser la compatibilité des programmes..................................................................... 101Analyser l'utilisation du langage......................................................................................102Analyser les programmes provenant d'un mainframe.....................................................103Parcourir ou exporter un rapport d'analyse.....................................................................104Limites de l'analyse......................................................................................................... 104

Travailler avec les éditeurs.................................................................106Éditeur SAS................................................................................................................................106Éditeur de texte..........................................................................................................................107Éditeur système..........................................................................................................................107Éditeur intégré............................................................................................................................ 108Éditeur par défaut...................................................................................................................... 108Préférences concernant l'éditeur de texte................................................................................. 109Fermer un fichier........................................................................................................................109

Guide utilisateur du WorkbenchVersion 3.3

5

Fonctionnalités d'édition en mode texte........................................... 110Signets........................................................................................................................................111

Ajouter un signet............................................................................................................. 112Supprimer un signet........................................................................................................ 113

Marqueurs de tâche................................................................................................................... 113Ajouter une tâche............................................................................................................ 114Supprimer une tâche.......................................................................................................115

Accéder à un emplacement précis du projet.............................................................................115Naviguer entre les fichiers d'un projet....................................................................................... 116Rechercher et remplacer............................................................................................................116Annuler et rétablir les modifications...........................................................................................117

Bibliothèques........................................................................................118Emplacement de la bibliothèque WORK................................................................................... 119Catalogues..................................................................................................................................120Ensembles de données..............................................................................................................121

Importer des ensembles de données..............................................................................121Ouvrir un ensemble de données.....................................................................................128Exporter des ensembles de données............................................................................. 140Effacer des ensembles de données................................................................................141

Exécuter des programmes..................................................................142Préférences WPS concernant l'exécution des programmes......................................................142Exécuter un programme à l'intérieur du Workbench................................................................. 144

Exécuter une partie d'un programme..............................................................................145Arrêter une exécution......................................................................................................146

WPS en mode ligne de commande...........................................................................................146Exécuter un programme en ligne de commande sur une plate-forme Windows............. 148Exécuter un programme en ligne de commande sur une plate-forme autre que

Windows..................................................................................................................... 150

Utiliser les sorties de programme......................................................152Générer un ensemble de données............................................................................................ 152Gérer les sorties ODS................................................................................................................154

Préférences concernant les options de résultats............................................................ 154Fichiers journaux............................................................................................................. 155Sortie PDF....................................................................................................................... 159Sortie sous forme de liste............................................................................................... 159Sortie HTML.................................................................................................................... 162Effacer les résultats d'un programme............................................................................. 164

Redémarrer le serveur............................................................................................................... 164

Configuration client/serveur de WPS Link........................................ 166

Guide utilisateur du WorkbenchVersion 3.3

6

Gérer les connexions aux hôtes locaux et distants...................................................................167Propriétés de la connexion à l'hôte local (raccourcis de répertoire)............................... 168Créer une connexion à un hôte distant.......................................................................... 168Créer un serveur WPS....................................................................................................174Exporter les définitions de connexions hôte vers un fichier............................................175Importer les définitions de connexion hôte depuis un fichier.......................................... 176Exporter les définitions des serveurs WPS vers un fichier............................................. 176Importer les définitions de serveur WPS à partir d'un fichier..........................................177

Connectivité avec les bases de données..........................................178Introduction................................................................................................................................. 178Connexion à une base de données Oracle...............................................................................179Connexion à une base de données DB2.................................................................................. 180Connexion à une base de données SQL Server.......................................................................182Connexion à une base de données MySQL............................................................................. 183Connexion à une base de données à l'aide d'ODBC................................................................ 184

Fichiers de configuration....................................................................186

Fichier AutoExec..................................................................................190

Conseils et astuces WPS....................................................................192

Dépannage............................................................................................ 195

Envoyer une requête au support technique......................................197

Notices légales.....................................................................................198

Guide utilisateur du WorkbenchVersion 3.3

7

Introduction

À propos de ce guideCe guide utilisateur est destiné à vous aider à vous familiariser avec l'interface utilisateur de WPS, quivous permet de créer, modifier et exécuter les programmes rédigés en langage SAS. Cette interfaceest appelée WPS Workbench ou, plus simplement, le Workbench.

Remarque :Ce guide utilisateur couvre également l'exécution de programmes en langage SAS à l'aide de WPS enmode ligne de commande ainsi que plusieurs fonctionnalités d'administration système.

La section Conseils et astuces WPS du guide utilisateur contient des liens vers des fonctionnalitésutiles, et la section Dépannage vous aide à résoudre des problèmes signalés auparavant par lesutilisateurs.

Ce manuel ne couvre pas les points suivants :

• Formation à l'utilisation du langage SAS : si celui-ci ne vous est pas familier, il existe une vastegamme de supports éducatifs et de documents de référence provenant de nombreuses sources.

• Présentation de toutes les options de WPS : une fois que vous aurez parcouru attentivement cemanuel, vous devriez être suffisamment familiarisé avec le système pour exécuter des programmessimples et commencer le traitement et l'analyse des données.

NotationLorsque vous devez saisir un segment de code, le guide l'affiche comme suit :

PROC OPTIONS;RUN;

Ce guide utilise en général les options de menu principal lorsqu'il est nécessaire d'interagir avec WPS.Cependant, il existe également des boutons de barre d'outils et des options de menu contextuel pourde nombreuses options WPS. Les options de menu et les boutons sont écrits en caractères gras, parexemple : Fichier ➤ Nouveau ➤ Projet.

À propos de WPSWorld Programming System (WPS) comporte deux éléments fondamentaux :

Guide utilisateur du WorkbenchVersion 3.3

8

• Une interface utilisateur graphique (GUI), ou environnement de développement intégré (IDE),appelé WPS Workbench. Cet environnement utilise la plate-forme Eclipse comme base del'interface utilisateur. L'interface graphique offre des fonctionnalités permettant de gérer, créer etmodifier des programmes écrits en langage SAS, ainsi que de les exécuter à l'aide du serveur WPS.

• Un compilateur/interpréteur. Il peut être utilisé en ligne de commande, et permet d'exécuter lesprogrammes existants (on parle parfois d'exécution de WPS en mode batch, ou « par lots »).Lorsque vous utilisez WPS Workbench, le compilateur s'exécute comme un processus de serveur(voir la section Processus de serveur WPS), et est utilisé pour traiter et exécuter les programmes.

WPS et le logiciel SAS®WPS prend en charge des éléments de programmation du langage SAS. Cela signifie que lesprogrammes développés dans ce langage peuvent être exécutés, modifiés, partagés et enregistrésdans WPS.

Processus de serveur WPSPour exécuter un programme écrit en langage SAS, WPS Workbench doit être connecté à unprocessus serveur WPS (pour plus d'informations, voir la section Serveur WPS). Le processus peuts'exécuter sur le poste de travail local (connexion à l'hôte local) ou sur une instance de WPS installéesur une machine distante (connexion à un hôte distant). Les serveurs qui s'exécutent sur la connexionlocale sont appelés serveurs locaux, et ceux qui s'exécutent sur une connexion distante sont appelésserveurs distants.

Clés de licence WPSPour qu'une instance de WPS puisse exécuter un programme écrit en langage SAS, le composantWPS Server doit avoir été activé par l'application d'une clé de licence WPS (fournie séparément dulogiciel). Voir la section Clé de licence.

Important :La personne qui installe WPS et applique les clés de licence doit disposer des privilègesd'administrateur système sur la machine concernée.

EclipseEclipse est un logiciel libre initialement mis au point par IBM. Il fournit un environnement pour lamodification et la gestion des fichiers et des tâches. Il est conçu pour accueillir des plug-ins permettantd'effectuer des tâches spécifiques, telles que l'édition de fichiers XML, le développement Java, lecontrôle du code source, etc. WPS Workbench est un environnement Eclipse fourni avec une gammede plug-ins permettant de modifier des programmes rédigés en langage SAS.

WPS laisse intentionnellement l'environnement Eclipse ouvert pour que les utilisateurs expérimentéspuissent ajouter des outils tiers pour le contrôle du code source, le développement Java et C++,

Guide utilisateur du WorkbenchVersion 3.3

9

l'édition XML, etc. Comme la plate-forme Eclipse peut accueillir d'autres plug-ins, WPS Workbenchcomporte certaines fonctionnalités qui ne sont pas utilisées actuellement, mais qui sont incluses afin depermettre l'ajout de plug-ins et extensions basés sur la plate-forme Eclipse.

Remarque :Certaines des fonctionnalités mentionnées dans ce manuel appartiennent à Eclipse, mais sontdésignées comme des fonctionnalités WPS par souci de simplicité. WPS bénéficie non seulement desfonctionnalités d'Eclipse, mais contient aussi des caractéristiques et des commandes spécialementconçues pour aider au développement et à l'utilisation de programmes en langage SAS.

Pour plus d'informations sur Eclipse et les plug-ins disponibles, visitez www.eclipse.org.

Fonctionnalités d'Eclipse non utilisées par WPS• Dans le menu Projet, aucune des options Générer le projet ou Nettoyer n'est utilisée par WPS.• L'option Aide ➤ Rechercher des mises à jour ne permet pas de récupérer les mises à jour du

logiciel WPS. Elle ne permet de récupérer que les mises à jour de la plate-forme Eclipse elle-même,ainsi que de plug-ins tiers.

Utilisateurs du logiciel SAS®Si vous avez l'habitude d'utiliser d'autres produits liés au langage SAS, les éléments de langage prisen charge par WPS vous seront familiers. Vous trouverez la syntaxe à peu près identique en ce quiconcerne les procédures, formats, macros, étapes DATA, etc.

WPS fournit également d'autres fonctionnalités et objets reconnaissables, tels que les journaux, lesensembles de données, la bibliothèque Work, etc. Cependant, il existe d'autres fonctionnalités quevous ne connaissez peut-être pas, telles que l'environnement Workbench et la façon dont il gère etaffiche les objets. Le Workbench inclut un menu d'aide et des documents de référence pour vous aiderà migrer vers WPS.

Compatibilité avec les logiciels SAS®En plus de lire les programmes écrits en langage SAS, WPS peut également lire et écrire les fichiersde données utilisés par les logiciels SAS. WPS offre également une large gamme de moteurs debibliothèque permettant d'accéder à de nombreuses bases de données tierces, à des entrepôts dedonnées et à des environnements Big Data Hadoop.

WPS utilise également un format propriétaire de fichier d'ensemble de données, appelé WPD. Commeil s'agit du moteur de bibliothèque d'ensemble de données par défaut, les ensembles de donnés WPDsont utilisés pour la bibliothèque Work. En outre, puisque WPD est le moteur de bibliothèque natif deWPS, il offre les fonctionnalités les plus complètes, par exemple la prise en charge des index.

Guide utilisateur du WorkbenchVersion 3.3

10

Éléments de langage pris en chargeWPS ne prend pas en charge tous les éléments du langage SAS. Le Workbench contient l'outilAnalyseur de code, qui permet de déterminer si des programmes existants en langage SAScontiennent des éléments de langage inconnus ou non pris en charge.

Pour plus de détails sur la syntaxe des éléments de langage pris en charge par cette version de WPS,veuillez vous référer au guide intitulé WPS Reference for Language Elements.

Programmes existants en langage SASL'expression programme SAS, voire parfois programme, utilisée dans ce site Web fait référence auxprogrammes et applications écrits en langage SAS. Pour utiliser des programmes existants dans WPSWorkbench, voir la section Migration depuis les logiciels SAS® de ce guide.

Guide utilisateur du WorkbenchVersion 3.3

11

Premiers pas

Fenêtre de lancement des espaces detravailWPS Workbench est lancé depuis \eclipse\workbench.exe dans votre installation de WPS, ou viale raccourci associé.

Lorsque vous lancez WPS Workbench pour la première fois, la fenêtre de Lanceur d'espace de travails'affiche, par exemple :

Un espace de travail est le dossier parent utilisé pour contenir un ou des projets. Il est possibled'utiliser tout dossier se trouvant un lecteur auquel votre ordinateur a accès en tant qu'espace detravail. Un espace de travail doit disposer d'un emplacement physique, qui est aussi l'emplacementpar défaut des projets créés dans cet espace. Il est cependant possible de créer des projets à un autreemplacement que l'emplacement par défaut.

Remarque :À partir de la version 3.1 de WPS, il n'est plus nécessaire d'utiliser les projets pour gérer vosressources Workbench. En effet, une grande partie des fichiers accessibles via le systèmed'exploitation sont maintenant disponibles dans le Workbench, à l'aide de la vue Explorateur de fichiers.Vous pouvez également établir des connexions avec des ordinateurs distants pour accéder aux fichiersqui y sont stockés (voir la section Explorateur de liens).

Sur Windows, l'emplacement physique par défaut des espaces de travail à l'installation de WPS est ledossier Mes documents et, sur UNIX et Linux, il s'agit du répertoire vers lequel pointe votre variabled'environnement $HOME. Dans tous les cas, le sous-répertoire est appelé WPS Workspaces, et le nomdes espaces de travail est défini de manière incrémentielle, en commençant par Workspace1.

Guide utilisateur du WorkbenchVersion 3.3

12

Si vous ne souhaitez pas utiliser le dossier d'espace de travail suggéré dans le champ Espace detravail, vous pouvez soit cliquer sur le bouton de liste déroulante à droite du champ pour sélectionnerun autre espace de travail, soit cliquer sur Parcourir pour afficher la boîte de dialogue Sélection del'espace de travail (cette dernière vous permet de sélectionner un dossier existant comme espace detravail, ou de créer un autre dossier).

Chaque fois que vous modifiez la valeur du champ Espace de travail de la fenêtre Lanceur d'espacede travail pour indiquer un autre dossier, les pages de bienvenue sont affichées à nouveau.

Remarque :Si vous n'avez pas sélectionné Utiliser par défaut et ne plus poser la question, la fenêtre Lanceurd'espace de travail s'affiche à nouveau lorsque vous lancez une autre session WPS Workbench. Sivous sélectionnez cette option, vous pouvez toujours afficher à nouveau la fenêtre Lanceur d'espacede travail en sélectionnant Fenêtre ➤ Préférences ➤ Généralités ➤ Démarrage et arrêt ➤ Espaces detravail  ➤ Demander la sélection de l'espace de travail au démarrage.

Pages BienvenueLes pages Bienvenue affichent des informations de présentation de WPS Workbench. La pagepar défaut Premiers pas a pour but de vous aider à utiliser WPS Workbench aussi rapidement quepossible. Elle affiche un certain nombre de liens vers d'autres pages de bienvenue, y compris notre siteWeb.

Fermeture et ouverture des pages de bienvenuePour fermer les pages de bienvenue et commencer à utiliser le Workbench sans plus attendre, cliquezsimplement sur le bouton Fermer de l'onglet Bienvenue.

Vous pouvez rouvrir les pages de bienvenue à tout moment en sélectionnant Aide ➤  Bienvenue.

Autres commandesLes boutons de contrôle de taille et de navigation sont situés dans la partie supérieure droite de la paged'accueil :

Boutons de navigation : Ces boutons fonctionnent comme ceux d'un navigateur Web standard.

• Accueil : Revenir à la page d'accueil.

• Accéder à la rubrique précédente : Revenir à la rubrique visualisée auparavant.

• Accéder à la rubrique suivante : Passer à la rubrique suivante visualisée auparavant.

Boutons de contrôle de taille : Changer la taille des pages d'accueil dans WPS Workbench.

• Minimiser : Réduire les pages de bienvenue à leur taille minimale. Cette fonction affiche lesautres fenêtres ouvertes.

Guide utilisateur du WorkbenchVersion 3.3

13

• Rétablir : Rétablir les pages d'accueil en mode d'affichage normal, à côté des autres fenêtresouvertes.

• Maximiser : Élargir les pages de bienvenue afin qu'elles occupent l'ensemble du Workbench etmasquent les autres fenêtres ouvertes.

Migration des programmes et projetsexistantsCette section du guide vise spécifiquement les utilisateurs qui veulent utiliser dans la dernière versionen date de WPS des projets ou programmes créés soit à l'aide d'un logiciel de SAS Institute Inc.,soit dans une version antérieure de WPS.

Migration depuis les versions antérieures de WPSLes espaces de travail ouverts avec les versions précédentes de WPS peuvent être ouverts avec laversion actuelle. Aucune étape de migration n'est nécessaire. Cependant, la première fois que vousouvrez un espace de travail créé à l'aide d'une version antérieure de WPS, une boîte de dialogued'Eclipse s'affiche, vous demandant de confirmer la mise à jour automatique de l'espace de travail encliquant sur OK. Ces mises à jour automatiques ne devraient pas poser de problème.

Les programmes existants n'ont pas besoin d'être modifiés pour fonctionner avec la dernièreversion de WPS. En outre, les projets créés avec les versions antérieures de WPS peuvent être ouvertset utilisés par les versions ultérieures de WPS sans modifications supplémentaires.

Migration depuis les logiciels SAS®Si vous avez déjà des programmes rédigés en langage SAS, aucun processus de conversion n'estnécessaire pour utiliser ces programmes avec WPS. Tous les fichiers avec l'extension .sas sontconsidérés être des programmes que le Workbench peut ouvrir, modifier et exécuter.

Accéder à vos programmes existantsVous pouvez accéder à vos programmes existants depuis la vue Explorateur de fichiers.

Vous pouvez également travailler avec des projets à l'aide de la vue Explorateur de projets, qui vouspermet de bénéficier, par exemple, de la fonction Restaurer un programme à partir de son historiquelocal, et d'autres fonctions qui ne sont pas disponibles dans la vue Explorateur de fichiers.

Pour plus d'informations sur la gestion des fichiers de programmes existants, voir la section VuesExplorateur de projets et Explorateur de fichiers.

Guide utilisateur du WorkbenchVersion 3.3

14

Vérifier la compatibilité des programmesLors de l'ouverture de programmes dans le Workbench, les éléments de langage inconnus ou non prisen charge sont affichés en rouge. Cependant, avant d'essayer d'exécuter des programmes existantsdans WPS, il est recommandé d'utiliser d'abord les outils d'analyse de code.

L'analyse de quelques, voire de centaines de programmes, peut prendre moins de quelques minutes,et peut donc être plus rapide que d'essayer d'exécuter des programmes longs pour découvrir quecertaines modifications sont nécessaires. L'analyse des programmes est disponible dans les vuesExplorateur de fichiers et Explorateur de projets.

Avertissement :Les outils d'analyse de code sont généralement très précis, mais il n'est pas garanti qu'ils soient précisà 100 %, en raison de la nature de la syntaxe du langage SAS.

Importer les exemples et d'autresprojetsPour importer un projet existant dans le Workbench :

1. Lancez l'assistant Importer en sélectionnant Fichier ➤  Importer.

La première page de l'assistant Importer s'affiche.2. Développez l'arborescence sous le nœud Généralités.

3. Mettez en surbrillance Projets existants dans l'espace de travail.

4. Cliquez sur Suivant.5. Sélectionnez l'une des options suivantes :

• Sélection du répertoire racine : Utilisez cette option si le projet n'est pas archivé dans un fichierunique. Cliquez sur Parcourir pour sélectionner le dossier où se situe le projet.

• Sélection d'un fichier archive : Utilisez cette option si le projet est archivé dans un fichierunique (par exemple zip, tar ou tar.gz). Cliquez sur Parcourir pour sélectionner le fichierd'archive contenant le projet.

Remarque :Si vous souhaitez sélectionner les exemples de projet qui ont été fournis avec votre versiondu Workbench, parcourez le dossier doc où est installé le Workbench, sélectionnez ledossier correspondant à votre langue (par exemple, en, es ou fr), et sélectionnez le dossiersamples.zip.

Si le fichier ou le dossier que vous avez parcouru contient un projet valide, il apparaît dans la sectionProjets de ce volet. Par défaut, tous les projets affichés dans la liste sont sélectionnés dans unpremier temps. Désélectionnez ceux que vous ne voulez pas importer.

Guide utilisateur du WorkbenchVersion 3.3

15

6. Cliquez sur Terminer pour démarrer le processus d'exportation.

Disposition du WorkbenchLa disposition de l'interface du Workbench peut être modifiée pour s'adapter à vos préférences. Lesdiverses dispositions sont appelées perspectives, chacune étant conçue spécifiquement pour créer,gérer, modifier et exécuter les programmes.

Perspective WPS par défautVous trouverez ci-dessous un exemple de la perspective WPS par défaut utilisée immédiatement aprèsla première installation de WPS Workbench sur un ordinateur :

La perspective WPS par défaut affiche toutes les vues du Workbench, sauf Aide en ligne, Signets,Tâches et Rechercher.

Guide utilisateur du WorkbenchVersion 3.3

16

Remarque :Vous pouvez rétablir cette perspective à tout moment en sélectionnant Fenêtre ➤ Perspective ➤ WPS. Il est impossible de supprimer ou de renommer la perspective WPS, mais vous pouvezenregistrer une perspective personnalisée sous le même nom.

Pour plus d'informations sur la personnalisation de la disposition, voir la section Perspectives.

Aide en ligneLa vue Aide est dynamique. Elle affiche automatiquement des rubriques d'aide pertinentes lorsquevous sélectionnez les diverses vues du Workbench. Cette vue n'est pas ouverte par défaut. Pourajouter cette vue à la perspective en cours, appuyez sur la touche F1 de votre clavier ou sélectionnezAide ➤ Aide dynamique ou Fenêtre ➤ Afficher la vue ➤ Autre ➤ Aide ➤  Aide.

Cette aide s'actualise automatiquement lorsque vous passez d'une vue à une autre dans l'interface.Toutefois, une fois que vous avez quitté une page d'aide dynamique (en cliquant sur le lien Rubriques connexes en haut de la vue Aide, par exemple), l'aide ne s'actualise plus de manièredynamique lorsque vous vous déplacez dans l'interface utilisateur. Pour rétablir l'aide contextuelle, vouspouvez appuyer à nouveau sur la touche F1 ou cliquer sur le lien Rubriques connexes.

Si vous souhaitez afficher le contenu de l'intégralité de la documentation de WPS dans unearborescence Eclipse hors du Workbench, sélectionnez Aide ➤ Table des matières de l'aide. Vouspouvez également accéder à cette fenêtre en sélectionnant Affiche une fenêtre externe dans labarre d'outils de la vue Aide (mais cette option ouvre l'aide Eclipse sur la rubrique Workbench encours). Cette vue externe n'est pas dynamique.

Commandes de la vue AideLorsque vous cliquez sur les différents liens et boutons du menu Aide, de nombreuses commandess'affichent, par exemple :

• Rubriques connexes : Si ce lien est en gras, cela indique que l'aide est actuellementdynamique. Si vous cliquez sur les liens connexes ci-dessous, le lien Rubriques connexes n'estplus en gras, ce qui indique que vous devez soit appuyer sur la touche F1, soit cliquer à nouveausur le lien Rubriques connexes pour restaurer le fonctionnement dynamique.

• Afficher dans la table des matières : Permet de synchroniser la rubrique d'aide que vousconsultez avec son emplacement dans l'arborescence.

• Crée un signet pour le document : Vous pouvez ajouter un signet à une page d'aide pourpouvoir y accéder directement par la suite. Tous vos signets sont répertoriés sous le lien Signets de la vue Aide.

• Rechercher : Utilisez cette fonction pour rechercher de l'aide sur des mots-clés et desexpressions spécifiques.

Guide utilisateur du WorkbenchVersion 3.3

17

Liste des raccourcis clavierSi vous souhaitez afficher la liste des raccourcis clavier en cours, sélectionnez Aide ➤ Assistant detouches ou appuyez sur Ctrl + Shift + L.

Pour afficher la page Préférences et y modifier les raccourcis clavier, ou en créerd'autres, vous pouvez soit appuyer à nouveau sur Ctrl + Shift + L, soit sélectionnerFenêtre ➤ Préférences ➤ Généralités ➤ Touches. Voir la section Préférences concernant lesraccourcis clavier.

Aide-mémoiresLe Workbench est fourni avec des tutoriels sous forme d'aide-mémoires (« cheat sheets »). Ils sontconçus pour vous aider dans vos premiers pas avec WPS, en vous présentant certaines tâches etfonctionnalités. Un aide-mémoire présente une suite d'opérations à effectuer. Chaque fois que vouspassez à l'étape suivante d'un aide-mémoire, un bouton Aide permet d'afficher la rubrique d'aideconnexe pour vous guider dans cette étape.

Catégories d'aide-mémoiresLes aide-mémoires se divisent en deux catégories : simples et composites.

Un aide-mémoire simple est une liste de tâches à exécuter successivement. Il comporte uneintroduction pour définir le contexte, et un certain nombre de tâches, comme ci-dessous :

Ces aide-mémoires apparaissent comme des listes simples dans le Workbench.

Un aide-mémoire composite est simplement un ensemble d'aide-mémoires simples. Un sujetcomplexe y est divisé en plusieurs blocs d'informations courts et faciles. Chacun de ces blocs a sapropre introduction et conclusion, comme indiqué ci-dessous :

Guide utilisateur du WorkbenchVersion 3.3

18

Les aide-mémoires composites présentent deux volets dans l'interface utilisateur. L'un représenteles groupes de tâches, tandis que l'autre montre comment effectuer les différentes tâches de chaquegroupe.

Guide utilisateur du WorkbenchVersion 3.3

19

Remarque :Par défaut, le volet contenant les groupes est situé au-dessus de celui des tâches, mais lamaximisation de la fenêtre peut le déplacer vers la gauche.

Guide utilisateur du WorkbenchVersion 3.3

20

Lancer un aide-mémoireLes aide-mémoires peuvent être lancés soit depuis les pages de bienvenue, soit depuis le menuprincipal du Workbench.

Pour lancer un aide-mémoire depuis les pages de bienvenue :

1. Ouvrez les pages de bienvenue en sélectionnant Aide ➤  Bienvenue.

2. Sélectionnez la page Aide-mémoires.3. Dans la liste des aide-mémoires disponibles, cliquez sur celui que vous souhaitez ouvrir.

Pour lancer un aide-mémoire depuis le menu du Workbench :

1. Dans le menu principal, sélectionnez Aide ➤ Aide-mémoires.

2. Dans la liste des aide-mémoires disponibles, double-cliquez sur celui que vous souhaitez ouvrir.

Barre d'outils d'accès rapide aux aide-mémoiresSi vous lancez un aide-mémoire depuis le menu du Workbench (et non depuis les pages debienvenue), une barre d'outils consacrée aux aide-mémoires s'affiche.

• Ce bouton réduit toutes les étapes ouvertes sauf l'étape en cours, ou bien développe les étapesjusqu'au dernier état développé. Cliquez sur ce bouton pour basculer entre ces deux états.

• Ce bouton permet de sélectionner et d'ouvrir un autre aide-mémoire. Si un aide-mémoireest déjà actif, son état d'achèvement est enregistré automatiquement et le nouvel aide-mémoiresélectionné s'ouvre. Un seul aide-mémoire peut être ouvert à la fois.

• Ce bouton minimise la vue Aide-mémoire.

• Ce bouton maximise la vue Aide-mémoire.

• Ce bouton se trouve dans l'onglet de la vue Aide-mémoire. Il permet de fermer la vue, mais aussid'enregistrer l'état de l'aide-mémoire actif afin de ne pas perdre votre position.

Utiliser un aide-mémoireChaque aide-mémoire est constitué d'une suite d'étapes, qui commence toujours par une introduction.Lorsque vous lancez un nouvel aide-mémoire, l'étape Introduction présente une brève description del'aide-mémoire sélectionné.

Pour commencer à travailler avec un aide-mémoire simple, sélectionnez Cliquez ici pourcommencer en bas de l'étape Introduction. L'étape suivante est développée et mise en évidence.Vous devriez également voir les boutons d'action sous l'étape suivante, tels que Cliquer lorsquel'opération est terminée. Vous pouvez ensuite parcourir chacune des étapes de l'aide-mémoire.

Pour commencer à travailler avec un aide-mémoire composite, lisez l'introduction, puis sélectionnez lelien Passer à en bas de la première page. L'introduction du premier groupe de tâches s'affiche, cequi permet de cliquer sur le lien Commencer à travailler. Le groupe de tâches fonctionne alors plusou moins comme un aide-mémoire simple.

Guide utilisateur du WorkbenchVersion 3.3

21

Terminer un aide-mémoireEn ce qui concerne les aide-mémoires simples, une fois que vous avez fini de travailler sur une étape,sélectionnez Cliquer lorsque l'opération est terminée pour passer à l'étape suivante. Celle-ci estautomatiquement mise en évidence, et devient l'étape active. Une marque apparaît dans la marge àgauche de chaque étape terminée.

Les aide-mémoires composites se comportent à peu près de la même façon, jusqu'à ce que vousayez achevé tous les aide-mémoires du groupe en cours. Les aide-mémoires composites comportentune conclusion, ainsi qu'une option de révision. Pour passer au groupe de tâches suivant, cliquez sur lelien Passer à. La tâche suivante démarre et affiche l'introduction du groupe suivant.

Accéder à l'aide connexePour obtenir des instructions détaillées sur une étape donnée ou des informations connexes,sélectionnez l'icône Ouvrir l'aide connexe située en haut à droite de l'étape. L'aide connexes'ouvre dans une fenêtre d'aide distincte.

Ouvrir l'étape de votre choixVous pouvez ouvrir n'importe quelle étape hors séquence, qu'elle soit marquée comme achevée ounon, en sélectionnant simplement l'icône Développer.

Remarque :Toute étape ouverte de cette manière ne change pas d'état d'achèvement. Notez également que lesétapes qui suivent l'étape active n'ont pas d'icône Cliquer lorsque l'opération est terminée.

Pour ne voir que l'étape en attente d'achèvement, cliquez sur l'icône Réduire tous les élémentssauf celui en cours, située en haut de la vue Aide-mémoire.

Dans les aide-mémoires composites, vous pouvez revenir à n'importe quel groupe de tâches pourles examiner, en cliquant simplement sur le groupe dans le volet associé. Vous êtes ramené àl'emplacement où vous avez quitté ce dernier groupe, et, si vous l'avez achevé, la conclusion s'affiche.Vous ne pouvez cependant pas commencer un nouveau groupe tant que vous n'avez pas terminé lestâches des groupes précédents.

Redémarrer un aide-mémoireÀ tout moment, vous pouvez redémarrer un aide-mémoire depuis la première étape. Pour ce faire,ouvrez la première étape (Introduction) en cliquant sur l'icône pour la développer, puis sélectionnez

Cliquez ici pour relancer. Tous les objets (programmes, projets, etc.) déjà créés ne sont passupprimés lorsque vous redémarrez l'aide-mémoire.

Les aide-mémoires composites permettent de réinitialiser les groupes de tâches. Cliquez avec lebouton droit sur le groupe de tâches dans le volet de groupes, puis sélectionnez Réinitialiser dansle menu. Une boîte de dialogue de confirmation apparaît. Cliquez sur OK pour que l'introduction dugroupe s'affiche dans le volet des tâches.

Guide utilisateur du WorkbenchVersion 3.3

22

Terminer un aide-mémoireLorsque vous terminez la dernière étape d'un aide-mémoire simple, il revient automatiquement à lapremière étape (Introduction). Vous pouvez ensuite sélectionner l'icône Cliquez ici pour relancerdans la première étape, ou bien simplement fermer l'aide-mémoire.

Les aide-mémoires composites sont considérés comme achevés lorsque tous les groupes de tâchessont terminés. Si tel est le cas, une marque apparaît en regard de chaque groupe du volet desgroupes. Vous pouvez alors redémarrer tous les groupes de tâches si vous le souhaitez : cliquez avecle bouton droit sur l'élément de premier niveau dans le volet de groupes, puis sélectionnez Relancertoutes les tâches.

Fermer un aide-mémoireVous pouvez fermer l'aide-mémoire en cours en sélectionnant l'icône Fermer située dans l'ongletde l'aide-mémoire. Son état d'achèvement est enregistré à sa fermeture, pour que vous puissiezreprendre là où vous en étiez à la réouverture.

Guide utilisateur du WorkbenchVersion 3.3

23

Composants de WPSCette section décrit brièvement les objets gérés par le Workbench.

ProjetsLe projet est l'unité organisationnelle de base. Un projet regroupe généralement desprogrammes connexes. Par exemple, un projet peut rassembler les programmes en cours dedéveloppement, un autre les rapports mensuels, et ainsi de suite.

ProgrammesVous pouvez créer et modifier les programmes, c'est-à-dire les fichiers ayant pour extension .sasou .wps, à l'aide de la vue Éditeur SAS (voir la section Créer un programme). L'éditeur utilise uncodage couleur pour signaler les différents éléments de langage ainsi que les erreurs de syntaxe.

Fichiers journauxLorsque vous exécutez un programme dans le Workbench, les informations générées sontstockées dans le fichier journal. Ce fichier peut être affiché, imprimé et enregistré depuisle Workbench. Le journal généré par WPS est cumulatif et contient les résultats de chaqueprogramme exécuté depuis le lancement de WPS Workbench, le dernier démarrage du serveurWPS, ou la dernière fois que le journal a été effacé.

Sortie sous forme de listeLes listes (par référence aux « listings » imprimés autrefois) contiennent les sorties de chaqueprogramme que vous avez exécuté. Il peut, par exemple, s'agir d'une table de données généréepar une instruction PROC PRINT dans un programme. Les sorties sous forme de liste peuventêtre affichées, imprimées et enregistrées depuis le Workbench. Les sorties sous forme de listegénérées par le serveur WPS sont cumulatives, et contiennent les sorties de chaque programmeexécuté depuis le lancement du Workbench, depuis le dernier redémarrage du serveur, oudepuis la dernière suppression des listes.

Sortie HTMLIl s'agit des fichiers HTML générés par les programmes. Par exemple, il peut s'agir d'une sériede fichiers HTML affichant les résultats de l'analyse de certaines données, générés par uneinstruction ODS HTML dans un programme. Les sorties HTML peuvent être ouvertes et affichéesdans le Workbench.

Sortie ODS (voir la section Gérer les sorties ODS)Comme indiqué, ODS (Output Delivery System) peut être utilisé pour produire la sortie HTML etla sortie de liste. Chaque programme peut spécifier quand et où sa sortie est stockée, mais il estégalement possible d'ordonner au Workbench de gérer le processus automatiquement. L'optionpar défaut est la sortie HTML, visible dans la vue Explorateur de sorties.

BibliothèquesLes bibliothèques contiennent les fichiers temporaires, les ensembles de données, lescatalogues, etc., créés à la suite de l'exécution d'un programme.

Guide utilisateur du WorkbenchVersion 3.3

24

Références de fichiers (voir la section Explorateur de serveurs WPS)Les références de fichier, ou filerefs, contiennent des références individuelles à des fichiersgénérées automatiquement ou définies à l'aide de l'instruction FILENAME.

Ensembles de donnéesLes données générées par l'exécution d'un programme sont stockées dans des ensembles dedonnées. Vous pouvez parcourir ou modifier un ensemble de données à l'aide de la visionneused'ensemble de données.

Connexion à un hôteUne connexion à un hôte définit le type de l'ordinateur, local ou distant, auquel le Workbencha accès. Ceci est la première des deux étapes permettant de créer un lien à distance dansWPS : vous commencez par créer une connexion à un hôte distant, puis vous ajoutez un serveurWPS sur cet hôte distant afin d'exécuter vos programmes à distance (voir la section Gérer lesconnexions aux hôtes locaux et distants).

Serveur WPSLe serveur WPS est le moteur responsable de l'exécution des programmes et de la générationdes résultats produits, tels que les journaux, les sorties sous forme de liste, les fichiers HTML,et les ensembles de données. Un serveur WPS est associé à une connexion hôte spécifique. Leserveur WPS maintient également un environnement de bibliothèques attribuées, les référencesde fichier (filerefs), de macros définies, de variables de macro, etc., avec lesquelles tous lesprogrammes en cours d'exécution interagissent.

Raccourci de répertoireUn raccourci de répertoire est un raccourci vers un chemin d'accès sur le système de fichiersde l'hôte. Vous pouvez y accéder via la vue Explorateur de fichiers (voir la section Propriétésde la connexion à l'hôte local (raccourcis de répertoire) ou Raccourcis de répertoire, selon lescas). Vous pouvez créer des raccourcis de répertoire à l'aide de la boîte de dialogue Propriétésde la connexion hôte concernée dans la vue Explorateur de liens, ou en cliquant avec le boutondroit sur le ou les dossiers requis dans la vue Explorateur de fichiers et en sélectionnantNouveau ➤ Raccourci de répertoire.

Guide utilisateur du WorkbenchVersion 3.3

25

Clé de licenceWPS exige une clé de licence valide pour exécuter des programmes sur un serveur WPS. La cléde licence est fournie dans un fichier avec l'extension .wpskey, qui est distinct du fichier d'installationWPS.

Remarque :Si vous utilisez WPS Link (voir la section Explorateur de liens) et que vous souhaitez restreindrel'exécution des programmes au serveur lié, vous n'avez besoin d'une clé de licence que pour l'instancede WPS présente sur le serveur. En revanche, si vous voulez exécuter des programmes sur lesmachines client comme sur le serveur lié, vous avez besoin de clés de licence distinctes pour lesinstallations serveur et client de WPS.

Appliquer une licencePour appliquer une nouvelle clé de licence à votre installation de WPS :

Attention :Si vous utilisez un système d'exploitation Microsoft Windows, vous devez disposer des droits d'accèsadministrateur sur votre ordinateur pour activer la clé de licence.

1. Sélectionnez Aide ➤  Appliquer la licence dans le menu du Workbench.

2. La boîte de dialogue Importer la licence pour le serveur Serveur local (ou remplacez Serveurlocal par le nom du serveur WPS distant) s'affiche. Effectuez l'une des opérations suivantes.

• Copiez et collez le texte complet de votre fichier de licence dans la fenêtre.• Cliquez sur Importer depuis le fichier. Trouvez le fichier contenant votre clé de licence, puis

cliquez sur Ouvrir. Le contenu du fichier de la clé de licence s'affiche.3. Cliquez sur Terminer pour appliquer la licence.

Si vous souhaitez appliquer la clé de licence sur une plate-forme de type UNIX, saisissez lacommande suivante :

wps_install_root/bin/wps -stdio -setinit <license.wpskey

wps_install_root est le répertoire d'installation de WPS.

Guide utilisateur du WorkbenchVersion 3.3

26

Afficher les détails de la licenceappliquéePour visualiser les détails de la licence qui a été appliquée à votre installation WPS :

1. Ouvrez la fenêtre Informations de clé de licence WPS en sélectionnant Aide ➤  Visualiser lalicence dans le menu du Workbench.

2. Cliquez sur OK pour fermer la fenêtre.

Guide utilisateur du WorkbenchVersion 3.3

27

Serveur WPSPour exécuter un programme, le Workbench nécessite une connexion à un serveur WPS sous licence.Le terme de serveur est utilisé ici pour désigner un processus serveur. Le processus peut s'exécutersur le poste de travail local (une connexion à l'hôte local – voir la section Propriétés de la connexion àl'hôte local (raccourcis de répertoire)), ou sur une installation de WPS sur une machine distante (uneconnexion à un hôte distant – voir la section Propriétés de la connexion à un hôte distant).

Les serveurs s'exécutant sous la connexion locale sont appelés serveurs locaux. Les serveurss'exécutant sous une connexion distante sont appelés serveurs distants.

Avec une installation typique de WPS sur un poste de travail, il n'y a qu'une seule connexion hôte,appelée Local, et un serveur appelé Serveur local. Ce serveur est lancé par défaut au démarrage duWorkbench, et arrêté à sa fermeture. Il est possible de créer d'autres serveurs locaux si nécessaire, oubien de supprimer ou de désinstaller le serveur local (voir la section Configurer l'installation locale deWPS).

Remarque :Si vous utilisez une plate-forme non Windows et que vous souhaitez exécuter des programmesuniquement sur un serveur distant, vous pouvez accéder à la vue Explorateur de liens de WPSWorkbench, et choisir Arrêter ou Supprimer dans le menu contextuel de l'option Serveur localsans affecter la licence. Toutefois, la suppression de tous les serveurs locaux peut empêcherl'exécution de programmes si aucun serveur distant n'est disponible.

La création de plusieurs serveurs locaux ne nécessite aucune licence WPS supplémentaire, et laseule restriction sur le nombre de serveurs locaux dépend des ressources de la machine locale. Ilpeut être utile de créer plusieurs connexions de serveurs locaux afin de configurer ces dernières avecdes options de démarrage différentes (par exemple, avec des valeurs différentes pour LOCALE ouENCODING).

La configuration de serveurs distants permet d'utiliser le Workbench sur votre poste de travail localtout en ayant facilement accès à la puissance de traitement d'un serveur distant. Plusieurs serveurspeuvent s'exécuter sur une même connexion à un hôte distant. La création d'un lien avec un hôtedistant pour l'exécution de programmes à distance se fait en deux étapes :

1. Pour créer une connexion hôte, procédez comme indiqué à la section Créer une connexion à unhôte distant.

2. Définissez un serveur sur cet hôte en procédant comme indiqué à la section Créer un serveur WPS.

Une fois la connexion à une machine distante authentifiée, il est possible de démarrer un ou plusieursserveurs WPS sans qu'il soit nécessaire d'authentifier à nouveau l'utilisateur. Plusieurs utilisateurspeuvent avoir des connexions distantes configurées vers la même machine, la seule restriction étantcelle des ressources sur cette machine.

Guide utilisateur du WorkbenchVersion 3.3

28

La liste des connexions et des serveurs définis est stockée dans l'espace de travail, et entretenue àl'aide de la vue Explorateur de liens. Par conséquent, lorsque vous changez d'espace de travail, ilest possible qu'une liste de connexions et de serveurs différente soit chargée. Lorsque vous créez unespace de travail, par défaut, il ne comporte qu'une seule connexion hôte, appelée Local, et un serveurappelé Serveur local.

Pour des raisons pratiques, lors du passage d'un espace de travail à un autre, ou du partage desdéfinitions de serveur dans un groupe de travail, les définitions de serveur peuvent être exportéesdans un fichier externe (voir la section Exporter les définitions des serveurs WPS vers un fichier) etimportées depuis un fichier ainsi créé (voir la section Importer les définitions de serveur WPS à partird'un fichier).

Configurer l'installation locale de WPSComme il n'est pas obligatoire d'utiliser le composant Serveur WPS sur l'hôte local si aucun programmen'y est exécuté (c'est-à-dire, si tous les programmes sont intégralement exécutés sur le serveur distantlié), vous pouvez utiliser le composant Serveur local WPS depuis l'installation décrite ci-dessous.

Remarque :Ceci n'est possible que pour un poste de travail Windows.

• Si vous n'avez pas encore installé WPS, exécutez le fichier msi wps approprié, puis, lorsquel'écran Installation personnalisée s'affiche, désélectionnez Serveur local WPS, comme indiqué ci-dessous, avant de cliquer sur Suivant :

Guide utilisateur du WorkbenchVersion 3.3

29

• Si vous avez déjà installé WPS, sélectionnez WPS dans le groupe Programmes et fonctionnalitésdu Panneau de configuration de Windows, cliquez sur Modifier en haut de la fenêtre, puis ànouveau sur Modifier dans la fenêtre suivante :

La fenêtre Installation personnalisée présentée plus haut s'affiche, et vous pouvez désélectionnerServeur local WPS comme indiqué, avant de terminer la modification de l'installation.

Avertissement :Vous devez être conscient que, si vous désinstallez Serveur local WPS d'une machine, votreinstallation de WPS ne disposera plus d'une licence sur cette machine.

Remarque :Si vous utilisez une plate-forme non Windows et que vous souhaitez exécuter des programmesuniquement sur un serveur distant, vous pouvez accéder à la vue Explorateur de liens, et choisirArrêter ou Supprimer dans le menu contextuel de l'option Serveur local sans affecter la licence.

Serveur WPS par défautL'un des serveurs définis est toujours configuré comme serveur par défaut. Il s'agit du serveur qui estsélectionné par défaut lorsque vous cliquez sur l'une des icônes suivantes de la barre d'outils, ou quevous utilisez l'un des raccourcis clavier correspondants : Exécuter, Annuler, Effacer lejournal, Effacer les résultats et Redémarrer le serveur.

Procédez comme suit pour définir le serveur par défaut :

Guide utilisateur du WorkbenchVersion 3.3

30

1. Ouvrez la vue Explorateur de serveurs WPS, Explorateur de liens, Explorateur de sorties ouExplorateur de résultats, et cliquez avec le bouton droit sur le serveur que vous souhaitez établircomme serveur par défaut.

2. Dans le menu contextuel, sélectionnez Définir comme serveur par défaut.

Remarque :Si cette option n'est pas activée, soit le serveur sélectionné est déjà le serveur par défaut, soit vousavez sélectionné plus d'un serveur.

Le serveur sélectionné est maintenant le serveur WPS par défaut. Pour l'indiquer, il est affiché enpremier et en gras dans la liste des serveurs.

Paramètres LOCALE et ENCODING duserveur WPSLes paramètres régionaux utilisés par WPS sont définis de manière individuelle pour chaque serveur.Pour définir l'option système de langue correspondant aux paramètres régionaux que vous souhaitezutiliser pour un serveur, procédez comme suit :

1. Dans la vue Explorateur de serveurs WPS, Explorateur de liens, Explorateur de sorties ou Explorateur de résultats, vérifiez que le serveur est en cours d'exécution.

2. Cliquez avec le bouton droit sur le serveur et sélectionnez Propriétés dans le menu contextuel.3. Dans le menu situé dans la partie gauche de la boîte de dialogue Propriétés, sélectionnez

Démarrage ➤ Options du système.

4. Dans la partie droite de la fenêtre, cliquez sur Ajouter pour afficher la boîte de dialogue Option dedémarrage.

5. Cliquez sur le bouton Sélectionner pour afficher la liste des options disponibles dans une fenêtreSélectionner l'option de démarrage.

6. Dans la liste, trouvez l'option LOCALE et double-cliquez dessus. La boîte de dialogue Option dedémarrage affiche votre sélection.

7. Dans le champ Valeur, saisissez le chemin d'accès du fichier de configuration à utiliser, puis cliquezsur OK.

Remarque :Une liste des valeurs valides pour LOCALE se trouve dans le document WPS Reference forLanguage Elements sous la section LOCALE Values.

8. Cliquez sur OK dans la boîte de dialogue Propriétés. Un message vous invite à redémarrer leserveur pour appliquer les modifications.

Guide utilisateur du WorkbenchVersion 3.3

31

Remarque :Toute option LOCALE définie dans des fichiers de configuration externes sera ignorée. Vous devezdéfinir le paramètre LOCALE comme une option de démarrage du Workbench, comme indiqué ci-dessus, pour qu'il puisse être utilisé dans l'interface graphique. En revanche, lorsque vous utilisez lemode WPS en mode ligne de commande pour exécuter des programmes en mode batch, l'option dedémarrage n'est pas prise en compte, et l'option LOCALE définie dans le fichier de configuration externeest utilisée à sa place.

Pour afficher et enregistrer des programmes et autres fichiers contenant des caractères correspondantaux paramètre régionaux (LOCALE) sélectionnés, il peut être nécessaire de définir une valeurappropriée pour le paramètre Encodage général du texte.

Il faut également définir une valeur appropriée pour le paramètre ENCODING sur le serveur (parexemple, pour exécuter une installation de WPS contenant des caractères non ASCII). Par exemple,procédez comme suit pour définir la valeur UTF-8 sur le serveur :

1. Effectuez les étapes 1 à 5 ci-dessus.2. Faites défiler la liste et double-cliquez sur l'option ENCODING. La boîte de dialogue Option de

démarrage s'affiche.3. Saisissez UTF8 ou UTF-8 dans le champ Valeur, puis cliquez sur OK.4. Redémarrez le serveur lorsqu'un message vous y invite.

Remarque :Une liste des valeurs valides pour ENCODING se trouve dans le document WPS Reference forLanguage Elements sous la section ENCODING Values.

Encodage général du fichier textePour afficher et enregistrer les programmes et les fichiers qui contiennent des caractères utilisés dansd'autres langues, il se peut que vous deviez définir la valeur d'encodage du texte. Cela peut se faire soitau niveau global, soit au niveau des projets.

Définition de l'encodage au niveau globalPour définir une valeur d'encodage au niveau global, qui sera utilisée par tous les projets et fichiersassociés :

1. Sélectionnez Fenêtre ➤ Préférences.

2. Dans le volet de gauche de la boîte de dialogue Préférences, développez le nœudGénéralités ➤ Espace de travail.

3. En bas à gauche du volet Espace de travail figurent les contrôles définissant la valeur Codage dufichier texte.

4. Activez l'option Autre dans la section Codage du fichier texte et sélectionnez la valeur souhaitéedans la liste déroulante.

Guide utilisateur du WorkbenchVersion 3.3

32

5. Cliquez sur OK pour appliquer la modification.

Remarque :Si la valeur requise ne figure pas dans la liste déroulante Autre, vous pouvez la saisir manuellement. Sivotre sélection est valide, cliquez sur OK pour l'enregistrer.

Dans tous les cas, il est recommandé de vérifier que les paramètres régionaux définis correspondentà votre pays, afin que le serveur WPS traite correctement les données. Pour ce faire, vérifiez que leserveur est en marche et que les paramètres régionaux affichés en bas à droite du Workbench sontcorrects (par exemple, french_FRANCE ou fr_FR). Sinon, procédez comme indiqué à la sectionParamètres LOCALE et ENCODING du serveur WPS.

Définition de l'encodage au niveau des projetsPour définir une valeur d'encodage qui ne s'applique qu'aux programmes d'un projet donné :

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets).

2. Cliquez sur le projet souhaité.

3. Sélectionnez Fichier ➤ Propriétés.

4. Dans le volet de gauche de la fenêtre Propriétés, sélectionnez l'option Ressource.5. Dans le volet Ressource figurent les contrôles définissant la valeur Codage du fichier texte.

L'option sélectionnée par défaut est Hérité du conteneur (x), où (x) est la valeur définie au niveauglobal, comme décrit ci-dessus. Activez l'option Autre dans la section Codage du fichier texte etsélectionnez la valeur souhaitée dans la liste déroulante.

6. Cliquez sur OK pour appliquer la modification.

Guide utilisateur du WorkbenchVersion 3.3

33

Vues du WorkbenchLa disposition des éléments dans le Workbench est connue sous le nom de perspective (voir la sectionPerspectives) et est composée de fenêtres qui contiennent une ou plusieurs vues. Ces vuesaffichent des types d'informations spécifiques et offrent des fonctionnalités précises. Certaines vuescomportent des barres d'outils appropriées, situées en haut à droite de chaque vue.

Cette section présente chacune des vues qu'il est possible de sélectionner (à l'exception de la vue Aideen ligne, qui a déjà été expliquée) et décrit les principales actions exécutées dans chaque vue.

Remarque :Les vues sont principalement sélectionnées à l'aide de l'option Fenêtre ➤ Afficher la vue.Toutefois, si une vue n'a pas été sélectionnée auparavant, il peut être nécessaire de sélectionnerFenêtre ➤ Afficher la vue ➤ Autre pour la trouver.

Vues Explorateur de projets etExplorateur de fichiersLes vues Explorateur de projets et Explorateur de fichiers vous permettent de modifier et degérer les fichiers et dossiers d'une arborescence depuis le Workbench :

Guide utilisateur du WorkbenchVersion 3.3

34

La vue Explorateur de projets est l'outil idéal pour gérer un ensemble de fichiers dans un espace detravail local organisé. Vous pouvez créer des projets dans un espace de travail pour effectuer destâches spécifiques. Un espace de travail peut contenir tout type de fichier local, et toutes les opérationsà réaliser sur les fichiers y sont disponibles (y compris l'exécution des programmes). Les objets desprojets peuvent être gérés à l'aide de l'outil Historique local, et ils peuvent également être exportésvers des archives ou d'autres dossiers du système de fichiers local. Il est également possible d'importerde telles archives dans cette vue.

La vue Explorateur de fichiers diffère de la vue Explorateur de projets car elle permetd'accéder à tous les fichiers disponibles sur votre système de fichiers local, ainsi que sur les systèmesde fichiers accessibles sur les hôtes distants. Elle utilise aussi les raccourcis de répertoire, quipeuvent pointer vers des dossiers situés à n'importe quel niveau du système de fichiers sur lequelils sont créés (voir la section Propriétés de la connexion à l'hôte local (raccourcis de répertoire), ouRaccourcis de répertoire pour un hôte distant).

Remarque :La fonction Historique local n'est pas disponible lorsque vous utilisez la vue Explorateur defichiers, de même que les options Importer et Exporter. En revanche, les fichiers et lesdossiers peuvent être déplacés entre les systèmes de fichiers à l'aide des opérations copier/couper/coller.

Les différences sont résumées dans le tableau suivant, qui montre la disponibilité des diversesopérations dans les deux vues :

Guide utilisateur du WorkbenchVersion 3.3

35

Option Explorateur de projets Explorateur defichiers

Ouvrir et Modifier Oui OuiGérer les fichiers Oui OuiExécuter les programmes Oui OuiHistorique local Oui NonImporter/Exporter les projets et les archives Oui NonGérer les systèmes de fichiers distants Non OuiGérer un système de fichiers local complet Non Oui

Il est possible d'exécuter un programme depuis les vues Explorateur de projets et Explorateur defichiers en le sélectionnant, en cliquant avec le bouton droit et en choisissant Exécuter sur leserveur dans le menu contextuel. Le sous-menu affiche la liste des serveurs pouvant exécuter leprogramme. Choisissez un serveur pour y exécuter le programme. Pour plus d'informations, et d'autresméthodes pour l'exécution des programmes, voir la section Exécuter un programme à l'intérieur duWorkbench.

Explorateur de projets

Pour afficher cette vuePour ajouter cette vue à la perspective en cours, sélectionnez Fenêtre ➤ Afficher la vue ➤  Explorateur de projets.

Fichiers et dossiers affichésLes principaux objets fichier et dossier affichés par la vue sont les suivants :

• Projets ouverts

• Projets fermés

• Dossiers

• Programmes (tout fichier avec l'extension .sas ou .wps)

• Autres fichiers (fichier texte ou fichier à extension inconnue)

Dans la vue Explorateur de projets, il est possible d'ajouter à un projet n'importe quel fichier d'un destypes ci-dessus. Si votre système reconnaît le type de fichier, l'icône correspondante est affichée.

Remarque :La vue Explorateur de projets n'affiche que les projets qui sont dans votre espace de travail en cours.

Guide utilisateur du WorkbenchVersion 3.3

36

Outils du système d'exploitationEn plus des outils du Workbench, vous pouvez utiliser les fonctions de votre système d'exploitationpour supprimer, couper ou copier et coller des objets dans un projet.

Il peut être nécessaire de rafraîchir la vue Explorateur de projets afin de bien afficher les objetsmanipulés (cliquez avec le bouton droit sur le projet et sélectionnez Rafraîchir dans le menucontextuel).

Remarque :Si vous utilisez les outils du système d'exploitation au lieu de ceux du Workbench, vous n'aurez pas lesavantages supplémentaires fournis par la fonctionnalité Historique local.

PropriétésSélectionnez un élément dans la vue Explorateur de projets pour afficher des informations sur cetélément dans la vue Propriétés.

Les propriétés suivantes sont affichées pour les raccourcis, fichiers et dossiers :

• les date et heure de modification ;• le champ Liée, dont la valeur est Vrai si le fichier sélectionné est lié à un fichier dans le système de

fichiers associé ;• le nom de l'élément ;• la taille du fichier (la taille des répertoires n'est pas affichée) ;• les informations sur le chemin d'accès.

Explorateur de fichiers

Pour afficher cette vuePour ajouter cette vue à la perspective en cours, sélectionnez Fenêtre ➤ Afficher la vue ➤ 

 Explorateur de fichiers.

Objets de l'Explorateur de fichiersLes principaux objets fichier et dossier affichés par la vue Explorateur de fichiers sont lessuivants :

• Connexions : Nœud racine qui représente une connexion à une machine hôte. Cette machinepeut être locale ou distante.

• Raccourcis : Répertoires d'un système de fichiers, sélectionnés pour être gérés dans la vue Explorateur de fichiers.

Guide utilisateur du WorkbenchVersion 3.3

37

• Dossier : Sous-répertoire.

• Programmes : Tout fichier avec l'extension .sas ou .wps.

• Autres fichiers : Fichier texte ou fichier à extension inconnue.

• Fichier à liaison symbolique : Fichier qui pointe vers un autre fichier du système de fichiershôte par l'intermédiaire d'une liaison symbolique.

• Répertoire à liaison symbolique : Fichier qui pointe vers un autre répertoire du système defichiers hôte par l'intermédiaire d'une liaison symbolique.

• Lien défectueux : Lien qui pointe vers un fichier ou répertoire qui n'existe pas.

Lorsque c'est possible, les fichiers sont représentés par une icône correspondant à leur type dans lecadre du système d'exploitation.

Remarque :La vue Explorateur de fichiers n'affiche que les connexions ouvertes.

Connexions et raccourcisIl n'est possible de visualiser des fichiers sur des systèmes distants que si vous avez ouvert uneconnexion hôte. Celles-ci peuvent être ouvertes depuis la vue Explorateur de liens, ainsi qu'audémarrage des serveurs WPS dans la vue Explorateur de serveurs WPS. Lorsqu'une connexion hôteest établie, la connexion apparaît dans la vue Explorateur de fichiers. Lorsque vous fermez laconnexion, son nœud disparaît de la vue.

Chaque connexion hôte est configurée de manière que plusieurs raccourcis de répertoire figurentsous la connexion dans la vue Explorateur de fichiers. Ils permettent d'accéder aux fichiers etdossiers sur le système de fichiers associé (voir la section Propriétés de la connexion à l'hôte local(raccourcis de répertoire) ou, pour un hôte distant, Raccourcis de répertoire).

Astuce :Pour créer un raccourci de répertoire dans la vue Explorateur de fichiers, cliquez avec le boutondroit sur le dossier souhaité, sélectionnez Nouveau ➤ Raccourci de répertoire, puis saisissez un nompour le raccourci dans le champ Nom du répertoire de la boîte de dialogue Raccourci de répertoire.

Les connexions hôte s'étendent aux raccourcis de répertoire dans la vue Explorateur defichiers. Les raccourcis de répertoire qui ne sont pas valides sont signalés par l'icône Raccourcinon valide. Elle signifie que le chemin d'accès configuré pour ce raccourci n'est pas disponible sur lesystème de fichiers de cette connexion.

PropriétésSélectionnez un élément (autre qu'une connexion) dans la vue Explorateur de fichiers pourafficher des informations sur cet élément dans la vue Propriétés.

Guide utilisateur du WorkbenchVersion 3.3

38

Remarque :Les propriétés affichées varient selon que la connexion est locale ou distante.

Les propriétés suivantes sont affichées pour les raccourcis, fichiers et dossiers :

• Date et heure de modification• Nom de l'élément• Taille du fichier (la taille des répertoires n'est pas affichée)• Informations sur le chemin d'accès• Le champ Est un lien a la valeur Oui si l'élément sélectionné est une liaison symbolique.• Détails du lien (si l'élément est une liaison symbolique, comme un chemin d'accès).

Sur un hôte distant, les propriétés suivantes sont aussi disponibles :

• Date et heure d'accès• Identifiant de groupe et d'utilisateur• Autorisations.

Fichiers et dossiersDans la vue Explorateur de fichiers, il est possible d'effectuer les opérations suivantes sur les fichierset les dossiers :

• Nouveau : Permet de créer un raccourci de répertoire, un répertoire ou un fichier.• Couper : Associé à la fonction Coller, permet d'enlever les fichiers et répertoires sélectionnés

d'un emplacement et de les déposer ailleurs.• Copier : Associé à la fonction Coller, permet d'ajouter une instance supplémentaire des fichiers

et répertoires sélectionnés.• Coller : Achève l'opération Couper ou Copier.

• Supprimer : Supprime tous les fichiers et répertoires sélectionnés.

• Exécuter sur le serveur : Exécute les programmes sélectionnés sur un serveur (voir la sectionServeur WPS).

• Actualiser : Rafraîchit le nœud sélectionné.

• Renommer : Renomme le fichier ou répertoire sélectionné.• Analyser : Analyse le contenu des programmes et des dossiers contenant des programmes (voir la

section Analyseur de code).

Ces options sont disponibles dans le menu contextuel de la vue Explorateur de fichiers. À l'exceptiond'Analyser, elles sont également disponibles dans le menu principal.

ProgressionL'avancement de l'opération en cours dans la vue Explorateur de fichiers s'affiche dans la vueProgression.

Guide utilisateur du WorkbenchVersion 3.3

39

Explorateur de liensLa vue Explorateur de liens permet de gérer les connexions hôte que vous avez configurées, ainsique tous les serveurs WPS sur ces connexions.

Il s'agit de la vue principale de WPS Link (nom collectif désignant la technologie utilisée pour fournirdes fonctionnalités client/serveur – voir la section Configuration client/serveur de WPS Link). Enutilisant WPS Workbench sur votre poste de travail local (le client), vous pouvez accéder à un serveurdistant sur lequel WPS est installé afin d'y exécuter des programmes rédigés en langage SAS. Leprocessus comporte deux étapes :

1. Créer une connexion à un hôte distant.2. Créer un serveur WPS.

Il est possible de visualiser et de manipuler la sortie d'un programme exécuté sur un serveur distantdans WPS Workbench, comme si le travail avait été exécuté en local. Par exemple, les ensembles dedonnées et les filerefs (références de fichier) sont visibles dans la vue Explorateur de serveursWPS, le journal et les autres résultats dans la vue Explorateur de sorties, et les liens vers lesrésultats dans la vue Explorateur de résultats.

Pour afficher cette vuePour ajouter cette vue à la perspective en cours, sélectionnez Fenêtre ➤ Afficher la vue ➤ 

 Explorateur de liens.

Objets affichésCette vue ne présente que deux types de nœuds :

• Nœud de connexion : Nœud racine qui représente une connexion à une machine hôte. Unou plusieurs serveurs peuvent être exécutés sur la connexion. La connexion peut être soit uneconnexion locale, soit une connexion à une machine distante. Il peut y avoir un grand nombre deconnexions distantes, mais une seule connexion locale.

• Nœud de serveur : Ce nœud représente l'installation de WPS sur laquelle vous exécutez vosprogrammes.

Gérer les connexions et les serveursSi vous cliquez avec le bouton droit sur une connexion ouverte, les options suivantes apparaissent :

Guide utilisateur du WorkbenchVersion 3.3

40

En ce qui concerne les options ci-dessus :

• Si vous sélectionnez Fermer la connexion, vous arrêtez aussi le ou les serveurs qui s'exécutentsur la connexion. Vous pouvez alors soit sélectionner Ouvrir la connexion, soit simplementredémarrer le ou les serveurs.

• Pour plus d'informations sur l'option Exporter la connexion hôte, voir la section Exporter lesdéfinitions de connexions hôte vers un fichier.

• Cliquez sur Nouveau serveur WPS pour créer un serveur, puis procédez comme indiqué à lasection Créer un serveur WPS.

• Pour Importer la définition de serveur WPS, voir la section Importer les définitions de serveurWPS à partir d'un fichier.

Astuce :Vous pouvez également importer des serveurs en faisant glisser des fichiers de définition de serveur(extension *.sdx) sur un nœud de connexion hôte dans la vue Explorateur de liens.

Si vous cliquez avec le bouton droit sur un serveur en cours d'exécution, les options suivantesapparaissent :

Guide utilisateur du WorkbenchVersion 3.3

41

En ce qui concerne les options ci-dessus :

• Si vous sélectionnez Arrêter, le serveur cesse d'exécuter tout programme, mais la connexion resteouverte. Vous devez sélectionner Démarrer pour relancer le serveur (ce qui redémarre égalementla connexion automatiquement).

• Pour plus d'informations sur l'option Redémarrer, voir les sections Redémarrer le serveur etRedémarrer avec les actions de serveur avancées.

• Pour Définir comme serveur par défaut, voir la section Serveur WPS par défaut.• Pour Exporter la définition du serveur WPS, voir la section Exporter les définitions des serveurs

WPS vers un fichier.

PropriétésCliquez avec le bouton droit sur une connexion ou un serveur dans la vue Explorateur de lienset sélectionnez l'option Propriétés (si elle est disponible) dans le menu contextuel pour accéder auxinformations suivantes :

Les propriétés de connexion hôte sont les suivantes :

• Raccourcis de répertoire : voir la section Propriétés de la connexion à l'hôte local (raccourcis derépertoire) ou, pour un hôte distant, Raccourcis de répertoire.

• Options de connexion à distance.

Propriétés du serveur WPS : voir la section Propriétés du serveur WPS local ou Propriétés duserveur WPS distant.

Astuce :Vous pouvez également afficher les propriétés d'un serveur dans la vue Propriétés.

Guide utilisateur du WorkbenchVersion 3.3

42

Les propriétés d'un serveur incluent la version du serveur et les informations suivantes sur la licence :Date d'expiration, Période d'avertissement, Système d'exploitation sous licence et Numéro delicence.

Commandes (en haut à droite de la fenêtre)• Réduire tout : Réduit la vue pour n'afficher que les nœuds racine.

• Créer une connexion hôte à distance : Ajoute une nouvelle connexion à un hôte distant. Voirla section Créer une connexion à un hôte distant.

• Importer une définition de connexion à l'hôte : Importe un fichier de définition de laconnexion. Pour plus d'informations sur l'importation de connexions, voir la section Importer lesdéfinitions de connexion hôte depuis un fichier.

Astuce :Les connexions hôte peuvent également être importées en faisant glisser des fichiers de définitionde connexion (extension *.cdx) vers la vue Explorateur de liens.

Déplacer un serveur WPS par glisser/déposerIl est possible de faire glisser et de déposer un serveur WPS sur une autre connexion hôte. Cettesimple opération déplace le serveur WPS d'une connexion hôte à une autre. Si vous maintenez latouche Ctrl enfoncée lorsque vous faites glisser le serveur WPS, vous le copiez au lieu de le déplacer.Pour que les noms restent uniques, les serveurs copiés sont automatiquement renommés. Pourrenommer manuellement un serveur, cliquez dessus avec le bouton droit et sélectionnez Renommerdans le menu contextuel.

Explorateur de serveurs WPSPour chaque serveur actif, la vue Explorateur de serveurs WPS affiche les éléments suivants,et permet de les ouvrir : références de fichier (filerefs), bibliothèques, catalogues et ensembles dedonnées générés lors de l'exécution de programmes sur ce serveur, par exemple :

Guide utilisateur du WorkbenchVersion 3.3

43

Remarque :Tant que le Workbench est ouvert, les Filerefs et les contenus de bibliothèque des exécutionsprécédentes sont conservés. Pour effacer l'état d'un serveur, redémarrez ce dernier (voir la section

 Redémarrer le serveur.

Pour afficher cette vuePour ajouter cette vue à la perspective en cours, sélectionnez Fenêtre ➤ Afficher la vue ➤ 

 Explorateur de serveurs WPS.

Objets affichésSi vous avez exécuté un ou des programmes, l'arborescence suivante est affichée pour chaqueserveur :

• Nœud de serveur WPS : racine du nœud représentant l'installation WPS où vous exécutez vosprogrammes, qu'il s'agisse d'un hôte local ou distant. Ensuite, sous ce nœud :

‣ Bibliothèques : nœud parent des éléments de bibliothèque.

‣ Bibliothèque : ensemble de catalogues et/ou d'ensembles de données. Voir la sectionBibliothèques.

Guide utilisateur du WorkbenchVersion 3.3

44

Remarque :Vous pouvez également voir un nœud de bibliothèque appelé Work. Il représente labibliothèque temporaire par défaut utilisée si aucune bibliothèque n'est spécifiée dans unprogramme. Si vous utilisez l'instruction LIBNAME dans un programme pour spécifier le nom devotre propre bibliothèque, un nœud de bibliothèque portant le nom spécifié apparaît égalementdans la vue.

‣ Catalogue : ensemble d'éléments définis par l'utilisateur tels que les formats et les informats.

‣ Ensemble de données : fichier de données contenant des champs numériques et/ou decaractères.

‣ Ensemble de données de vue : ensemble de données créé en invoquant une vue dansles données source. Pour plus de détails sur l'énumération et l'ouverture des ensembles dedonnées, voir la section Utiliser la visionneuse d'ensemble de données.

‣ Champ numérique d'ensemble de données : champ d'ensemble de données contenantdes valeurs numériques.

‣ Champ de caractères d'ensemble de données : champ d'ensemble de données contenantdes chaînes de caractères.

‣ Filerefs : nœud parent des éléments référence de fichier (fileref).

‣ Référence de fichier : référence de fichier individuelle.

Bien que les références de fichier soient générées automatiquement, vous pouvezégalement les créer vous-même à l'aide de l'instruction FILENAME, par exemple :

filename shops 'c:\Users\fred\Desktop\4.1-Shops.xls';

Cette ligne vous permet de faire référence au chemin de fichier ci-dessus sans le répéterintégralement. Ainsi, vous pourriez utiliser la référence dans une instruction DATA pour lire desdonnées depuis c:\Users\fred\Desktop\4.1-Shops.xls, comme dans :

DATA shops; INFILE shops DLM = ',' DSD MISSOVER; LENGTH ShopName $20.; INFORMAT Opened DDMMYY10.; INPUT ShopName Opened FirstYear SecondYear ThirdYear FourthYear FifthYear;

Remarque :Le lien entre une fileref et le fichier externe associé ne subsiste que pendant la durée de lasession WPS en cours, ou jusqu'à ce que vous modifiez ou mettiez fin au lien en utilisant uneautre instruction FILENAME. Si vous souhaitez conserver une référence de fichier (fileref) d'unesession à l'autre, il suffit d'inclure l'instruction FILENAME dans les programmes concernés. Pourafficher les détails d'une référence de fichier, cliquez dessus avec le bouton droit et sélectionnezPropriétés.

PropriétésSi vous sélectionnez un élément dans la vue Explorateur de serveurs WPS (autre que les nœuds

 Libraries et Filerefs, des informations les concernant sont affichées dans la vue Propriétés.

Guide utilisateur du WorkbenchVersion 3.3

45

Vous pouvez également afficher des propriétés détaillées concernant certains élément en cliquantdessus avec le bouton droit, puis en sélectionnant Propriétés dans le menu contextuel, si cetteoption est activée (c'est-à-dire s'il existe des propriétés pour l'élément sélectionné). Voici quelquesexemples :

Propriétés du serveur WPS

Voir la section Propriétés du serveur WPS local ou Propriétés du serveur WPS distant, selon les cas.

Propriétés de la bibliothèque

• Général : informations sur l'accès (par exemple, Lecture seule ou Temporaire), ainsi que lenom, le moteur et l'emplacement.

• Membres : table d'information sur les membres du catalogue, avec le nom et le type de chaquemembre.

Propriétés du catalogue

• Entrées : table d'information sur les entrées d'un catalogue, avec le nom de chaque entrée, sontype et sa description.

• Général : nom du catalogue.

Propriétés d'entrée du catalogue

• Général : nom, type, description, heure de création et de modification de l'entrée.

Propriétés d'ensemble de données et Propriétés d'ensemble de données de vue

• Général : nombre de variables et d'observations.• Colonnes : table d'information sur les champs de l'ensemble de données, y compris nom, type,

longueur, libellé, format et informat.

Propriétés du serveur WPS localLes propriétés et les informations suivantes sont disponibles sur le serveur local.

Remarque :Certains éléments ne sont disponibles que lorsque le serveur est en marche. Dans ce cas, cela estsignalé.

Soumission de codeAvant l'exécution de programmes, si vous avez besoin de définir le répertoire de travail surle serveur pour qu'il soit le même que celui où se trouve le programme ouvert, sélectionnezl'option Définir le répertoire de travail du serveur comme répertoire de programme à lasoumission). La définition du répertoire de travail est alors effectuée automatiquement, àcondition que les répertoires se trouvent sur le même hôte. Si les répertoires ne sont pas sur lemême hôte, le répertoire de travail du serveur doit être défini avec l'option Répertoire en coursinitial du processus de serveur, spécifiée dans la section Démarrage (voir ci-dessous).

Guide utilisateur du WorkbenchVersion 3.3

46

Si l'option Définir le répertoire de travail du serveur comme répertoire de programme à lasoumission n'est pas activée, aucune modification n'est apportée au répertoire de travail lors dela soumission du programme au serveur.

EnvironnementCette section donne des détails sur l'environnement du serveur (répertoire de travail, ID deprocessus et variables d'environnement). Ces informations ne peuvent pas être modifiées, et nesont disponibles que lorsque le serveur est en fonctionnement.

Variables de macroCette section dresse la liste complète des variables de macro automatiques et globales utiliséespar le serveur, ainsi que des valeurs associées. Ces informations ne peuvent pas être modifiées,et ne sont disponibles que lorsque le serveur est en fonctionnement. Toutefois, vous pouvezcliquer sur Ajouter pour créer des variables.

Options systèmeCette propriété énumère les noms de toutes les options système qui sont actuellement définiessur le serveur, ainsi que leurs valeurs respectives. Ces informations sont les mêmes que cellesaffichées par l'instruction PROC OPTIONS. Ces informations ne peuvent pas être modifiées, et nesont disponibles que lorsque le serveur est en fonctionnement.

Informations de licence WPSCette page affiche les informations setinit pour le serveur, telles que les produits dotés d'unelicence, la durée de la période de grâce ou d'avertissement de la licence, et la date de l'expirationde celle-ci. Ces informations ne peuvent pas être modifiées, et ne sont disponibles que lorsque leserveur est en fonctionnement.

Informations de logiciel WPSCette page affiche des détails sur le logiciel WPS, y compris le numéro de version et le systèmed'exploitation sur lequel il s'exécute. Ces informations ne peuvent pas être modifiées, et ne sontdisponibles que lorsque le serveur est en fonctionnement.

DémarrageLa page principale comporte un indicateur nommé Démarrer le serveur automatiquement audémarrage de la connexion. Vérifiez que cette option est sélectionnée si vous souhaitez quele serveur démarre automatiquement lors du lancement de la connexion associée. Le champRépertoire de base actuel du processus de serveur permet de spécifier le répertoire de travaildu serveur distant, c'est-à-dire l'emplacement où les sorties sont générées. Si votre code inclutdes instructions %INCLUDE avec des chemins relatifs, il est important de démarrer le serveurdans le bon répertoire pour permettre à ces instructions %INCLUDE de trouver les fichiers qu'ellesincluent.

La page Démarrage comporte deux autres sous-pages, Variables d'environnement et Optionsdu système :

• Options système. Lorsque le serveur est en cours d'exécution, cette page permet despécifier les options WPS à transmettre au serveur pour être traitées au démarrage. Parexemple, les paramètres LOCALE et ENCODING du serveur WPS et autres options que vouspouvez transmettre à WPS en ligne de commande. Cliquez sur Ajouter pour afficher la boîte

Guide utilisateur du WorkbenchVersion 3.3

47

de dialogue Option de démarrage. Cliquez sur Sélectionner pour sélectionner une option àdéfinir. Une fois l'option choisie, vous pouvez définir le champ Valeur associé, puis cliquezsur OK pour activer l'option et sa valeur. Vous pouvez ensuite utiliser les boutons Modifier etSupprimer afin d'éditer ou de supprimer les options et valeurs créées auparavant.

• Variables d'environnement : Cette page permet de spécifier les variables d'environnementà définir avant le démarrage du serveur. Cliquez sur Nouveau pour spécifier le nom de lavariable et la valeur à définir. L'élément apparaît alors dans la liste. Vous pouvez ensuiteutiliser les boutons Modifier et Supprimer afin d'éditer ou de supprimer les variablesd'environnement créées auparavant.

Propriétés du serveur WPS distantLes propriétés et les informations suivantes sur le serveur distant sont disponibles :

Remarque :Certains éléments ne sont disponibles que lorsque le serveur est en marche. Dans ce cas, cela estsignalé.

Soumission de codeAvant l'exécution de programmes, si vous avez besoin de définir le répertoire de travail surle serveur pour qu'il soit le même que celui où se trouve le programme ouvert, sélectionnezl'option Définir le répertoire de travail du serveur comme répertoire de programme à lasoumission). La définition du répertoire de travail est alors effectuée automatiquement, àcondition que les répertoires se trouvent sur le même hôte. Si les répertoires ne sont pas sur lemême hôte, le répertoire de travail du serveur doit être défini avec l'option Répertoire en coursinitial du processus de serveur, spécifiée dans la section Démarrage (voir ci-dessous).Si l'option Définir le répertoire de travail du serveur comme répertoire de programme à lasoumission n'est pas activée, aucune modification n'est apportée au répertoire de travail lors dela soumission du programme au serveur.

EnvironnementCette section donne des détails sur l'environnement du serveur (répertoire de travail, ID deprocessus et variables d'environnement). Ces informations ne peuvent pas être modifiées, et nesont disponibles que lorsque le serveur est en fonctionnement.

Variables de macroCette section dresse la liste complète des variables de macro automatiques et globales utiliséespar le serveur, ainsi que des valeurs associées. Ces informations ne peuvent pas être modifiées,et ne sont disponibles que lorsque le serveur est en fonctionnement. Toutefois, vous pouvezcliquer sur Ajouter pour créer des variables.

Guide utilisateur du WorkbenchVersion 3.3

48

Options systèmeCette propriété énumère les noms de toutes les options système qui sont actuellement définiessur le serveur, ainsi que leurs valeurs respectives. Ces informations sont les mêmes que cellesaffichées par l'instruction PROC OPTIONS. Ces informations ne peuvent pas être modifiées, et nesont disponibles que lorsque le serveur est en fonctionnement.

Informations de licence WPSCette page affiche les informations setinit pour le serveur, telles que les produits dotés d'unelicence, la durée de la période de grâce ou d'avertissement de la licence, et la date de l'expirationde celle-ci. Ces informations ne peuvent pas être modifiées, et ne sont disponibles que lorsque leserveur est en fonctionnement.

Informations de logiciel WPSCette page affiche des détails sur le logiciel WPS, y compris le numéro de version et le systèmed'exploitation sur lequel il s'exécute. Ces informations ne peuvent pas être modifiées, et ne sontdisponibles que lorsque le serveur est en fonctionnement.

Emplacement d'installation du logiciel WPSCette page affiche l'emplacement de l'installation distante de WPS spécifiée lors de laconfiguration du serveur (voir la section Créer un serveur WPS).

DémarrageLa page principale comporte un indicateur nommé Démarrer le serveur automatiquement audémarrage de la connexion. Vérifiez que cette option est sélectionnée si vous souhaitez quele serveur démarre automatiquement lors du lancement de la connexion associée. Le champRépertoire de base actuel du processus de serveur permet de spécifier le répertoire de travaildu serveur distant, c'est-à-dire l'emplacement où les sorties sont générées. Si votre code inclutdes instructions %INCLUDE avec des chemins relatifs, il est important de démarrer le serveurdans le bon répertoire pour permettre à ces instructions %INCLUDE de trouver les fichiers qu'ellesincluent.

La page Démarrage comporte une autre sous-page :

• Options système. Lorsque le serveur est en cours d'exécution, cette page permet despécifier les options WPS à transmettre au serveur pour être traitées au démarrage. Parexemple, les paramètres LOCALE et ENCODING du serveur WPS et autres options que vouspouvez transmettre à WPS en ligne de commande. Cliquez sur Ajouter pour afficher la boîtede dialogue Option de démarrage. Cliquez sur Sélectionner pour sélectionner une option àdéfinir. Une fois l'option choisie, vous pouvez définir le champ Valeur associé, puis cliquezsur OK pour activer l'option et sa valeur. Vous pouvez ensuite utiliser les boutons Modifier etSupprimer afin d'éditer ou de supprimer les options et valeurs créées auparavant.

PropriétésVous pouvez afficher les propriétés des objets à l'aide de la vue Propriétés. Les informationsaffichées dans cette vue changent de manière dynamique en fonction de l'élément sélectionné.

Guide utilisateur du WorkbenchVersion 3.3

49

Pour afficher cette vuePour ajouter cette vue à la perspective en cours, sélectionnez Fenêtre ➤ Afficher la vue ➤ Propriétés.

Vues qui interagissent avec la vue PropriétésSi vous cliquez sur un objet dans une des vues citées ci-dessous, les propriétés correspondant à cetobjet s'affichent dans la vue Propriétés :

• Explorateur de projets

• Explorateur de serveurs WPS

• Rechercher

• Explorateur de fichiers

• Explorateur de liens

Remarque :Tous les objets des vues ci-dessus ne possèdent pas nécessairement des propriétés affichables – parexemple, vous ne pouvez pas afficher les propriétés d'une connexion hôte dans la vue Propriétés.

ÉditeurLorsque vous ouvrez un fichier dans le Workbench (programme, journal, sortie, ensemble de données,fichier texte, etc.), il s'affiche sous forme d'onglet dans la vue Éditeur. Cette vue ne peut pas êtrefermée et doit toujours être disponible. C'est pourquoi la vue Éditeur ne figure pas dans le menuFenêtre ➤ Afficher la vue. Cependant, vous pouvez fermer les fichiers qui y sont ouverts.

Il est possible de diviser la vue Éditeur afin de consulter et/ou de modifier plusieurs fichiers àla fois. Pour ce faire, sélectionnez Fenêtre ➤ Éditeur ➤ Toggle Split Editor (Horizontale) ouFenêtre ➤ Éditeur ➤ Toggle Split Editor (Verticale). Vous pouvez également ouvrir une autre copiedu fichier en cours en sélectionnant Fenêtre ➤ Éditeur ➤ Clone.

Pour créer un programme dans la vue Éditeur, voir la section Créer un programme. Voir aussi lasection Fonctionnalités d'édition en mode texte pour savoir lesquelles de ces fonctionnalités peuventêtre utilisées dans la vue Éditeur.

Selon le type du fichier, il est possible ou non de le modifier une fois ouvert. Par exemple :

• Vous ne pouvez pas modifier les journaux et les fichiers de sortie ouverts depuis la vue Explorateurde sorties.

• Vous pouvez modifier un ensemble de données ouvert depuis la vue Explorateur de serveurs WPS,une fois que vous avez activé le mode Modifier (voir la section Modifier un ensemble de données).

Guide utilisateur du WorkbenchVersion 3.3

50

• Il est généralement possible de modifier les fichiers ouverts depuis la vue Explorateur de projets.Vous pouvez même choisir quel éditeur utiliser lors de l'ouverture du fichier, comme indiqué à lasection Travailler avec les éditeurs.

• Vous pouvez aussi ouvrir les fichiers pour les modifier depuis la vue Explorateur de fichiers.

SignetsVous pouvez ajouter des signets à n'importe quelle ligne d'un programme, et même à tout fichierque vous pouvez ouvrir et modifier depuis la vue Explorateur de projets du Workbench. Pour afficher etparcourir vos signets, utilisez la vue Signets. Voir aussi la section Signets.

Remarque :Cette vue affiche tous les signets, que les programmes correspondants soient ouverts ou non.Cependant, elle n'affiche pas les signets des programmes d'un projet fermé. Il n'est pas possiblede créer des signets dans les fichiers ouverts depuis la vue Explorateur de fichiers, sauf s'ils sontmembres d'un projet. En effet, les fichiers ouverts hors d'un projet peuvent se situer n'importe oùdans le système de fichiers d'un hôte local ou distant, alors qu'il n'est possible de définir des signetsque dans les fichiers membres d'un projet de l'espace de travail.

Pour afficher cette vuePour ajouter cette vue à la perspective en cours, sélectionnez Fenêtre ➤ Afficher la vue ➤  Signets.

Pour afficher un signet figurant dans la vue

Vous pouvez soit double-cliquer sur la tâche requise, soit cliquer dessus avec le bouton droit etsélectionner Aller à dans le menu contextuel. Le fichier correspondant s'ouvre (s'il était fermé), et laligne du signet est affichée en surbrillance. Si le signet a été appliqué au fichier entier, la première ligneest mise en surbrillance.

TâchesVous pouvez ajouter des marqueurs de tâche (rappels) à n'importe quelle ligne d'un programme quia été ouvert depuis la vue Explorateur de projets, et les associer à des notes et à un niveau de priorité.Pour répertorier, actualiser et parcourir les tâches que vous avez ajoutées, vous devez utiliser la vue

Tâches.

Guide utilisateur du WorkbenchVersion 3.3

51

Remarque :Cette vue répertorie les tâches, que les programmes soient ouverts ou non. Elle ne répertorie pas lestâches d'un programme se trouvant dans un projet fermé. Il n'est pas possible de créer les tâchesdans les programmes ouverts depuis la vue Explorateur de fichiers, sauf s'ils sont membres d'un

 projet. En effet, les programmes ouverts de cette façon peuvent se situer n'importe où dans lesystème de fichiers, alors qu'il n'est possible de définir des tâches que dans les fichiers membres d'unprojet de l'espace de travail.

Pour afficher cette vuePour ajouter cette vue à la perspective en cours, sélectionnez Fenêtre ➤ Afficher la vue ➤ Autre ➤ Généralités ➤  Tâches.

Cette vue vous permet de modifier les niveaux de priorité des tâches ainsi que les descriptions, et soitles marquer comme terminées, soit les laisser inachevées.

Pour afficher une tâche figurant dans la vue

Vous pouvez soit double-cliquer sur la tâche requise, soit cliquer dessus avec le bouton droit etsélectionner Aller à dans le menu contextuel. Le fichier correspondant s'ouvre (s'il était fermé), et laligne contenant la tâche est affichée en surbrillance.

StructurePour vous aider à parcourir les programmes, journaux, listes ou sorties HTML, le Workbench afficheles éléments structuraux de ces fichiers dans la vue Structure. Si vous cliquez sur un élémentstructural dans cette vue, la ligne correspondante dans le fichier est surlignée.

La vue Structure s'actualise automatiquement pour afficher les éléments structuraux concernant lefichier de résultat HTML actif lorsque vous ouvrez ou activez un programme, un journal, une liste ou unfichier de sortie HTML pertinent.

Pour afficher cette vuePour ajouter cette vue à la perspective en cours, sélectionnez Fenêtre ➤ Afficher lavue ➤   Structure.

Éléments structuraux des programmesLorsque vous ouvrez un programme, la vue Structure affiche les éléments structuraux suivants :

• Instruction globale

• Étape DATA

• Procédure

Guide utilisateur du WorkbenchVersion 3.3

52

• Macro

Vous pouvez contrôler quels éléments structuraux sont affichés dans la vue Structure d'unprogramme. La barre d'outils en haut de cette vue contient des icônes représentant ces élémentsstructuraux et barrées d'une diagonale :

Ces icônes permettent d'activer ou de désactiver l'affichage des éléments structuraux pertinents.

Éléments structuraux du journalPour le journal, la vue Structure affiche les éléments structuraux suivants :

• Une entrée dans le journal, et le nœud parent pour chaque erreur et avertissement.

• Erreur

• Avertissement

Éléments structuraux des listes et fichiers HTMLLorsque vous consultez les résultats de l'exécution d'un programme (voir les sections Afficher la sortiesous forme de liste et Afficher la sortie HTML), la vue Structure affiche les éléments structurauxsuivants :

• le nœud parent des résultats ;

• la sortie HTML sous forme de table ;

• la sortie Liste sous forme de table.

Explorateur de sortiesLes fichiers de sortie générés par l'exécution d'un programme sont listés dans la vue Explorateurde sorties, qui permet aussi de les ouvrir.

Remarque :Pour voir les arborescences des résultats, regroupées par serveur, utilisez la vue Explorateur derésultats.

Tant que le Workbench reste ouvert, les sorties des exécutions précédentes ne sont pas suppriméesautomatiquement. Pour effacer les sorties précédentes, sélectionnez WPS ➤  Effacer le journal,WPS ➤  Effacer les résultats, les boutons de la barre d'outils ou les menus contextuels pertinents.

Vous pouvez aussi redémarrer le serveur (comme décrit dans la section Redémarrer le serveur).

Guide utilisateur du WorkbenchVersion 3.3

53

Pour afficher cette vuePour ajouter cette vue à la perspective en cours, sélectionnez Fenêtre ➤ Afficher la vue ➤ 

 Explorateur de sorties.

SortiesLes éléments de sortie sont associés au serveur sur lequel ils ont été générés, et répertoriés sous cedernier.

Les éléments de sortie suivants sont affichés sous un serveur si ce dernier a exécuté les programmesqui ont généré des sorties des types suivants :

• Sortie sous forme de liste

• Sortie HTML

• Sortie PDF

Remarque : La sortie sous forme de journal est toujours affichée sous chaque serveur, qu'un programme ait été

exécuté ou non.

Lorsque vous exécutez un programme qui génère des sorties des types indiqués ci-dessus, les nœudsdes sorties liées apparaissent sous le serveur WPS qui les a générées. Un seul nœud est affiché pourchaque type de sortie sous chaque serveur WPS enregistré.

Double-cliquez sur l'un des nœuds de sortie pour ouvrir, dans l'éditeur pertinent, les sorties de ce type(ou dans Adobe Acrobat pour les sorties PDF). Pour tout autre type de sortie que le journal, leséléments des résultats individuels s'affichent dans la vue Explorateur de résultats lorsque vousouvrez la sortie dans l'éditeur.

Pour plus d'informations sur les types de sortie, voir la section Utiliser les sorties de programme.

Explorateur de résultatsCette vue contient une arborescence des résultats de chaque programme exécuté depuis le dernierdémarrage ou redémarrage du serveur, groupés par serveur.

Remarque :Pour visualiser toutes les sorties, y compris le journal, utilisez la vue Explorateur de sorties.

Pour afficher cette vuePour ajouter cette vue à la perspective en cours, sélectionnez Fenêtre ➤ Afficher lavue ➤   Explorateur de résultats.

Guide utilisateur du WorkbenchVersion 3.3

54

SortiesUne fois qu'un programme est exécuté, une entrée s'affiche sous le serveur pertinent pour chaquePROC qui produit des sorties. Par exemple, PROC PRINT produit une entrée nommée The PRINTprocedure. Développez ce lien pour trouver les liens vers chaque type de sortie généré.

Pour plus d'informations sur les types de sortie, voir la section Gérer les sorties ODS.

ProgressionLorsque vous exécutez des programmes, leur exécution est confirmée dans la vue

 Progression. Les opérations effectuées dans la vue Explorateur de fichiers sont également visiblesici (les opérations en cours et les opérations terminées).

Remarque :Lors de l'exécution d'un programme, et durant les opérations dans les vues Explorateur de fichierset Explorateur de serveurs WPS, l'indicateur de progression ( ) est affiché dans l'angle inférieurdroit du Workbench. Cet indicateur est affiché que la vue Progression soit ouverte ou non. Si unprogramme est soumis pour exécution alors qu'un autre est encore en cours, il est signalé comme étanten attente d'exécution.

Si vous souhaitez arrêter l'exécution d'un programme, cliquez sur dans la vue Progression (voir lasection Arrêter une exécution).

Pour afficher cette vuePour ajouter cette vue à la perspective en cours, sélectionnez Fenêtre ➤ Afficher la vue ➤ 

 Progression.

Opérations de l'Explorateur de fichiersUne opération effectuée depuis la vue Explorateur de fichiers reste dans la vue Progression jusqu'àce qu'une autre opération soit effectuée. Cela permet de consulter les résultats de l'opération encliquant sur le lien correspondant. Le message d'information résultant indique :

• Statut : réussite ou échec• Opération : copier, renommer, supprimer, etc.• Source : emplacement d'origine du fichier ou du dossier• Destination : dossier cible ou racine• Exception : toutes les erreurs survenues pendant l'exécution de l'opération

Guide utilisateur du WorkbenchVersion 3.3

55

Remarque :Lorsqu'une partie de l'opération échoue, le Workbench essaye cependant d'achever les autres parties.Par exemple, si vous essayez de supprimer cinq fichiers et la suppression du premier échoue, leWorkbench continue de supprimer les quatre fichiers restants.

Console (pour la sortie standard desserveurs distants)La vue Console n'est pas utilisée si vous n'exécutez des programmes que sur un serveur local.Elle peut toutefois être utile si vous exécutez vos programmes sur un serveur WPS distant. Dans cecas, toutes les sorties standard, ainsi que les sorties d'erreurs standard produites par le serveur, sontreflétées dans la vue Console. Un exemple typique de l'utilisation de la console consiste à exécuterune instruction quelconque de votre programme sur un serveur distant pour demander la liste descontenus d'un répertoire donné. La sortie de l'exécution de l'instruction est alors affichée dans la vueConsole.

Cette dernière est aussi extrêmement utile lorsque le démarrage d'un serveur distant échoue ou que leserveur cesse de fonctionner de manière anormale. Un message d'erreur est alors aussi affiché dans lavue Console.

Remarque :Si vous utilisez WPS Link, comme expliqué à la section Explorateur de liens, il est possible devisualiser et de manipuler la sortie d'un programme exécuté sur un serveur distant dans WPSWorkbench, comme si le travail avait été exécuté en local.

Pour afficher cette vuePour ajouter cette vue à la perspective en cours, sélectionnez Fenêtre ➤ Afficher lavue ➤ Autre ➤ Généralités ➤  Console.

RechercherCette vue affiche les résultats des recherches exécutées à l'aide de la boîte de dialogue Rechercher.Lorsque vous cliquez sur un élément dans les résultats, le fichier s'ouvre automatiquement dans la vueÉditeur à l'emplacement exact où figure l'élément.

Procédez comme suit :

1. Pour ouvrir la boîte de dialogue Rechercher et ajouter la vue Rechercher à la perspective en cours,effectuez l'une des opérations suivantes :

Guide utilisateur du WorkbenchVersion 3.3

56

• Sélectionnez Rechercher ➤  Rechercher.

• Sélectionnez Fenêtre ➤ Afficher la vue ➤ Autre ➤ Généralités ➤  Rechercher et affichez laboîte de dialogue Rechercher.

2. Recherchez en utilisant les champs suivants :

• Contenant le texte : vous pouvez utiliser les différents caractères génériques indiqués dans la boîtede dialogue.

• Masques de noms de fichiers (séparés par des virgules) : après avoir saisi l'un des caractèresgénériques en préfixe, vous pouvez cliquer sur Sélectionner pour choisir les préfixes ou types defichiers à rechercher.

• Portée : vous pouvez, par exemple, sélectionner Espace de travail pour effectuer une recherchesur tous les projets ouverts dans le Workbench, ou Ressources sélectionnées pour n'effectuer larecherche que sur le fichier actif.

Astuce :Vous pouvez également cliquer sur Remplacer pour spécifier la chaîne qui doit remplacer le contenudu champ Contenant le texte.

Guide utilisateur du WorkbenchVersion 3.3

57

Travailler avec les vuesCette section décrit comment manipuler les vues du Workbench individuellement ou au sein d'unempilement de vues.

Empilements de vuesUn empilement de vues est une fenêtre formée d'un ensemble de vues associées à la même zonedans une perspective. Par exemple, l'empilement ci-dessous contient deux vues :

Une vue s'ouvre dans l'empilement dont elle était membre à la dernière utilisation. Par exemple, si lavue Progression était membre de l'empilement utilisé comme exemple à sa fermeture, elle est rétabliedans cet empilement lors de son ouverture :

L'empilement de vues est un concept important, surtout lorsqu'il s'agit de déplacer, réduire, minimiser,maximiser et restaurer les vues.

Ouvrir une vuePour ouvrir une vue dans le Workbench :

Guide utilisateur du WorkbenchVersion 3.3

58

1. Sélectionnez Fenêtre ➤ Afficher la vue.

2. Si la vue requise n'est pas affichée dans la liste, sélectionnez Autre dans le menu déroulant pourvisionner la liste complète des vues disponibles.

La liste des vues disponibles, regroupées par dossiers de catégorie, s'affiche.

3. Sélectionnez la vue que vous souhaitez ouvrir.4. Cliquez sur OK pour achever la tâche.

La vue que vous avez sélectionnée s'ouvre (si elle n'était pas déjà ouverte) et elle est automatiquementactive. La vue s'ouvre dans l'empilement dont elle était membre à la dernière utilisation.

Fermer une vuePour fermer une vue ouverte dans le Workbench :

1. Vérifiez que la vue est active en cliquant sur son onglet.2. Cliquez sur l'icône dans l'onglet de cette vue.

Si vous fermez toutes les vues d'un empilement, l'empilement de vues adjacent s'étend pour occuperl'espace disponible.

Remarque :Seule exception à cette règle : la vue Éditeur, qui reste toujours ouverte, même après que vous avezfermé les programmes qu'elle contient.

Déplacer une vuePour déplacer une vue vers une nouvelle fenêtre de Workbench :

1. Cliquez sur l'onglet ou la barre de titre de la vue et faites glisser la vue vers la fenêtre voulue duWorkbench en maintenant le bouton gauche de la souris enfoncé.

2. Sans déposer la vue, déplacez-la de haut en bas et de droite à gauche. La nouvelle fenêtrecommence à se diviser en fonction des dimensions de la vue. Des lignes horizontales et verticaless'affichent pour indiquer l'endroit où va se trouver la vue si vous la déposez à son emplacementactuel.

3. Déposez la vue où vous souhaitez qu'elle apparaisse.4. La vue apparaît dans son nouvel empilement. Si vous la déposez sur un empilement de vues

existant, la taille des vues de l'empilement d'origine diminue pour accueillir la nouvelle vue.

Guide utilisateur du WorkbenchVersion 3.3

59

Remarque :Vous pouvez également afficher une vue dans une fenêtre flottante hors du Workbench. Voir la sectionVues flottantes ou ancrées.

Vues flottantes ou ancréesToutes les vues de la fenêtre du Workbench peuvent être affichées comme fenêtres flottantes ou bienancrées.

Pour transformer une vue en fenêtre flottante :

Cliquez sur l'onglet ou la barre de titre de la vue et faites glisser la vue hors de la fenêtre principalede l'interface. Lorsque vous déposez la vue, une fenêtre est créée sur le bureau à l'extérieur duWorkbench.

Pour ancrer une vue flottante :

1. Faites glisser l'onglet de la vue flottante (pas la barre de titre de la fenêtre) vers la fenêtre principaledu Workbench. Des rectangles apparaissent pour indiquer où il est possible de déposer la vue.

2. Déposez la vue à l'endroit souhaité. La vue qui était flottante est à nouveau ancrée dans leWorkbench.

Remarque :Si vous fermez la vue détachée, elle reste détachée à l'ouverture suivante.

Redimensionner une vuePour redimensionner une vue, vous devez minimiser l'empilement de vues et toutes les vues qu'ilcontient.

1. Placez le pointeur de la souris sur la bordure située entre l'empilement ou fenêtre à redimensionneret l'empilement adjacent (sur un des côtés, en haut ou en bas) jusqu'à ce que le curseur setransforme en une icône de redimensionnement ( ou ).

2. Appuyez sur le bouton gauche de la souris et maintenez-le enfoncé pendant que vous faites glisserla bordure pour agrandir ou réduire l'empilement.

3. Relâchez le bouton de la souris pour terminer l'opération de redimensionnement.

Guide utilisateur du WorkbenchVersion 3.3

60

Minimiser une vuePour minimiser une vue, vous devez minimiser l'empilement de vues où elle se trouve. Toutes les vuesde la pile sont alors réduites. Les vues minimisées sont ensuite représentées par des icônes sur lagauche ou la droite du Workbench, où vous pouvez les restaurer.

Cliquez sur le bouton Minimiser de l'empilement de vues ou de la fenêtre pour la minimiser.

Maximiser une vuePour maximiser une vue, vous devez maximiser l'empilement de vues où elle se trouve. L'empilementremplit alors toute l'interface du Workbench.

Pour maximiser un empilement de vues ou une fenêtre, suivez l'une des procédures suivantes :

• Cliquez sur le bouton Maximiser de l'empilement de vues ou de la fenêtre.

• Double-cliquez soit sur la barre d'outils de l'empilement de vues, soit sur l'onglet d'une des vues del'empilement.

Une vue maximisée occupe le plus d'espace possible. Lorsque cela se produit, les autres vues dumême empilement sont également maximisées, mais la vue originale reste placée au-dessus et active.Tous les autres empilements de vues sont minimisés sur les bords de la fenêtre du Workbench, où ilssont affichés sous forme d'icônes.

Restaurer une vuePour restaurer l'état « normal » d'une vue après avoir modifié sa dimension, il faut rétablir l'empilementde vues associé.

Guide utilisateur du WorkbenchVersion 3.3

61

Pour restaurer un empilement de vues ou une fenêtre qui a été maximisé, suivez l'une des procéduressuivantes :

• Cliquez sur le bouton Restaurer de l'empilement de vues ou de la fenêtre.

• Double-cliquez soit sur la barre d'outils de l'empilement de vues, soit sur l'onglet d'une des vues del'empilement.

Pour restaurer un empilement de vues ou une fenêtre qui a été réduit, suivez l'une des procéduressuivantes :

• Cliquez sur l'icône Restaurer située au-dessus de l'empilement de vues minimisé pour restaurerles vues de cet empilement.

• Cliquez avec le bouton droit sur l'icône appropriée à gauche ou à droite de la fenêtre du Workbenchpour afficher le menu contextuel, puis sélectionnez Restaurer :

PerspectivesLe terme Perspective désigne le positionnement des vues, fenêtres, empilements de vues,éléments de menu et boutons de barre d'outils disponibles, et la disposition générale de WPSWorkbench.

Nous avons déjà présenté la perspective par défaut de WPS. Toutefois, vous pouvez personnalisercette perspective en déplaçant, redimensionnant, ajoutant ou supprimant les différentes vues (voirla section Travailler avec les vues). Le Workbench vous permet d'enregistrer les perspectivespersonnalisées et de basculer de l'une à l'autre.

Le Workbench garde en mémoire la disposition des fenêtres et vues au moment de sa fermeture, et àchaque ouverture du Workbench, il affiche la disposition des fenêtres et vues et autres au moment dela fermeture. Il n'est pas nécessaire d'enregistrer les perspectives. Ainsi, votre perspective préféréeest immédiatement disponible à l'ouverture du Workbench.

Ouvrir une perspectivePour ouvrir une autre perspective :

Guide utilisateur du WorkbenchVersion 3.3

62

1. Pour voir la liste de toutes les perspectives disponibles dans la boîte de dialogue Ouvrir laperspective, sélectionnez Fenêtre ➤ Perspective ➤ Autre ou cliquez sur l'icône  Ouvrir laperspective en haut à droite de l'écran :

2. Sélectionnez la perspective que vous souhaitez ouvrir.3. Cliquez sur OK pour achever la tâche.

Lorsque vous ouvrez une perspective, par défaut, son nom est mis en surbrillance en haut à droite duWorkbench. Si d'autres perspectives sont disponibles, leur nom figure aussi dans cette zone, à droitede l'icône Ouvrir la perspective, pour que vous puissiez cliquer dessus et basculer rapidemententre elles.

Fermer une perspectiveLa méthode la plus rapide pour fermer une perspective consiste à placer le pointeur de la souris àdroite de l'icône Ouvrir la perspective, cliquer avec le bouton droit sur la perspective souhaitée, etsélectionner Fermer. Autre possibilité :

1. Si plusieurs perspectives sont ouvertes, vérifiez que le Workbench affiche celle que vous souhaitezfermer.

Remarque :Pour changer de perspective, placez le pointeur de la souris à droite de l'icône Ouvrir laperspective et cliquez sur la perspective souhaitée.

2. Sélectionnez Fenêtre ➤ Fermer la perspective.

Remarque :Si vous souhaitez fermer toutes les perspectives, afin que seule l'option PerspectiveWPS par défaut reste disponible pour sélection, choisissez Fenêtre ➤ Fermer toutes lesperspectives. Votre interface est alors vide. Pour rétablir la perspective par défaut, sélectionnezFenêtre ➤ Perspective ➤ Autre ➤  WPS (défaut).

Réinitialiser une perspectiveÀ tout moment, vous pouvez rétablir la disposition par défait de la perspective en cours en procédantcomme suit :

1. Sélectionnez Fenêtre ➤ Réinitialiser la perspective.

Guide utilisateur du WorkbenchVersion 3.3

63

2. Un message demande confirmation avant de réinitialiser la perspective. Cliquez sur Oui pourconfirmer.

Enregistrer une perspectiveSi vous avez modifié la disposition d'une perspective, vous pouvez l'enregistrer sous un nomd'utilisateur prédéfini afin de l'utiliser ultérieurement :

1. Sélectionnez Fenêtre ➤ Enregistrer la perspective sous.

2. Saisissez un nom pour la perspective en haut de la boîte de dialogue Enregistrer la perspectivesous.

3. Cliquez sur OK pour continuer.

Si une perspective est déjà enregistrée sous le nom vous venez de saisir, un message vousdemande si vous voulez la remplacer par la nouvelle mise en page de la perspective.

La nouvelle perspective s'affiche en haut à droite du Workbench, à droite de l'icône Ouvrir laperspective.

Remarque :L'icône de la nouvelle perspective est dérivée de la perspective ouverte au moment de sonenregistrement.

Supprimer une perspectivePour supprimer une perspective :

1. Sélectionnez Fenêtre ➤ Préférences.

2. Dans le volet de gauche de la fenêtre Préférences, sélectionnez Généralités ➤ Perspectives.

3. Dans la liste Perspectives disponibles cliquez sur la perspective à supprimer.4. Cliquez sur Supprimer pour l'enlever définitivement. Il n'y a pas de message de confirmation.

Remarque :Vous ne pouvez supprimer que les perspectives créées par l'utilisateur. En d'autres termes, vousne pouvez pas supprimer une perspective qui a été fournie avec WPS, comme par exemple laperspective WPS.

5. Cliquez sur OK pour fermer la fenêtre Préférences.

Guide utilisateur du WorkbenchVersion 3.3

64

ProjetsUn projet est une représentation dans le Workbench d'un dossier parent contenant des objets telsque des programmes, des fichiers et des dossiers. Ce dossier de projet, ou parent, est défini par unfichier de définition du projet (voir la section Fichier de définition de projet).

WPS utilise les projets pour y stocker des fichiers et des dossiers ayant des points communs. Parexemple, vous pouvez avoir un projet contenant les programmes en cours de développement, un autrepour les applications de rapports mensuels, et ainsi de suite.

Chaque projet figure, à son tour, dans un dossier parent, appelé espace de travail. Vous nepouvez travailler que dans un espace de travail à la fois dans le Workbench, mais vous pouvezbasculer d'un espace à l'autre selon vos besoins (voir la section Basculer vers un autre espace detravail). La vue Explorateur de projets est utilisée pour afficher et gérer l'espace de travail en cours etles projets qu'il contient.

Il n'existe aucune limite quant au nombre de projets que vous pouvez ouvrir dans WPS Workbench ouau nombre de dossiers et de fichiers qu'un projet peut contenir. Les fichiers peuvent également être detout type, et toutes les opérations typique que vous pourriez réaliser sur des fichiers sont disponibles,y compris la possibilité d'exécuter des fichiers identifiés comme programmes en langage SAS (avecl'extension .sas ou .wps).

Les objets de l'espace de travail peuvent être gérés avec l'historique local, et ils peuvent égalementêtre exportés vers des archives ou d'autres dossiers du système de fichiers sur un hôte local ou distant.Il est également possible d'importer de telles archives dans cette vue.

Remarque :Si vous préférez accéder au système de fichiers directement pour gérer les programmes (au lieud'utiliser les projets), cela est possible en utilisant la vue Explorateur de fichiers (mais vous ne pourrezalors pas accéder à l'historique local).

Fichier de définition de projetLe répertoire racine du projet contient un fichier de définition de projet appelé .project. Ce fichiercontient des informations sur le projet qui sont utilisées dans le Workbench. Ce fichier n'estgénéralement pas affiché par la vue Explorateur de projets. Toutefois, si vous consultez le dossier duprojet à l'extérieur du WPS Workbench, vous pouvez voir ce fichier.

Avertissement :

• Vous ne devez pas supprimer ou modifier ce fichier.

Guide utilisateur du WorkbenchVersion 3.3

65

• Vous ne devez pas déplacer le fichier du répertoire racine du dossier de projet, même pour le placerdans un autre projet.

• Vous ne devez pas copier, déplacer ou importer ce fichier dans un autre dossier de projet.

Gérer les projetsCette section du guide couvre la création et la manipulation des projets et des fichiers qu'ilscontiennent.

Créer un projetPour créer un projet :

1. Ouvrez l'assistant Nouveau projet soit en cliquant sur le menu déroulant de l'icône Nouveau en haut à gauche de la fenêtre et en sélectionnant Projet, soit en choisissant

Fichier ➤ Nouveau ➤  Projet dans le menu principal.

La première page de l'assistant Nouveau projet s'affiche.2. Développez le dossier Généralités et sélectionnez le nœud Projet.

3. Cliquez sur Suivant.4. Remplissez le champ Nom du projet.

Si le nom du nouveau projet n'est pas identique à celui d'un dossier existant, un dossier est créé.5. (Facultatif) Si vous souhaitez modifier l'emplacement par défaut du nouveau projet, désélectionnez

la case à cocher Utiliser l'emplacement par défaut et spécifiez le nouveau répertoire où vous lesouhaitez à l'aide du bouton Parcourir.

Avertissement :Si vous choisissez un répertoire général en dehors de l'espace de travail actif, notez qu'en l'ajoutantau projet, vous n'allez pas déplacer le dossier. Le projet y fait simplement référence.

6. Ne vous préoccupez pas de la page Références de projet de l'assistant Nouveau projet, car elleconcerne principalement Eclipse. Enfin, cliquez sur Terminer pour créer le projet.

Créer un dossier dans un projetVous pouvez avoir un nombre illimité de dossiers et de sous-dossiers dans un projet. Pour créer undossier :

Guide utilisateur du WorkbenchVersion 3.3

66

1. Ouvrez l'assistant Nouveau dossier en effectuant l'une des opérations suivantes après avoir ouvertl'élément parent :

• Cliquez avec le bouton droit sur le projet ou dossier dans lequel vous voulez créer ledossier, puis sélectionnez Nouveau ➤  Dossier.

• Dans le menu principal, sélectionnez Fichier ➤ Nouveau ➤  Dossier.

• Ouvrez la liste déroulante de l'icône Nouveau en haut à gauche de la fenêtre etsélectionnez Dossier.

La première page de l'assistant Nouveau dossier s'affiche.2. Par défaut, le parent est le projet ou dossier en cours.

3. En bas de la fenêtre, remplissez le champ Nom du dossier.4. (Facultatif) Cliquez sur le bouton Avancé pour accéder aux options de configuration du dossier.

• Utiliser l'emplacement par défaut. C'est l'option par défaut. Le dossier est créé comme undossier du système de fichiers à l'emplacement d'origine.

• Le dossier ne doit pas être situé dans le système de fichiers (dossier virtuel). Le dossierne peut exister que dans l'espace de travail et aucun dossier ne sera créé dans le système defichiers associé. Vous pouvez créer des liens vers d'autres fichiers et dossiers contenus dans cenouveau dossier et aussi ajouter d'autres dossiers virtuels. Pour ce faire, il suffit de déplacer lesautres ressources de votre projet par glisser-déposer vers le dossier virtuel. Il n'est pas possiblede créer des fichiers et dossiers physiques dans des dossiers virtuels. Vous pouvez utiliser cetteoption pour organiser un affichage différent des fichiers et dossiers, indépendamment de leuremplacement physique.

• Lien vers autre emplacement (dossier lié). Lorsque vous liez un dossier à un autreemplacement, le contenu de ce dossier est affiché dans ce nouvel emplacement. Toutes lesmodifications apportées au contenu sont répercutées sur le dossier associé du système defichiers. Le Workbench enregistre toutes les modifications apportées aux fichiers effectuéesdepuis le Workbench, ce qui permet d'utiliser la fonction Historique local avec ces fichiers.Utilisez Parcourir pour sélectionner avec quel dossier du système de fichiers établir le lien.

5. Cliquez sur Terminer pour achever la tâche.

Créer un fichier dans un projetProcédez comme suit pour créer un fichier dans un projet existant, ou dans un dossier figurantdans un projet :

1. Ouvrez l'assistant Nouveau fichier en effectuant l'une des opérations suivantes :

• Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets), cliquez avec le bouton droit sur l'objet sous lequel vous voulez créer un fichier, puissélectionnez Nouveau ➤  Fichier

• Dans le menu principal, sélectionnez Fichier ➤ Nouveau ➤  Fichier.

Guide utilisateur du WorkbenchVersion 3.3

67

• Ouvrez la liste déroulante de l'icône Nouveau en haut à gauche de la fenêtre duWorkbench et sélectionnez Fichier.

La boîte de dialogue Fichier s'ouvre.2. Vérifiez que le dossier parent voulu est sélectionné en haut de la boîte de dialogue.3. Au bas de la boîte de dialogue, saisissez le nom du nouveau fichier.

Si vous spécifiez une extension de fichier reconnue par le système (par exemple, .sas ou .wps, quiindiquent un programme, ou .doc, qui indique un document Microsoft Word), le nouveau fichier estassocié à l'éditeur approprié. Si aucune extension de fichier n'est spécifiée, ou si l'extension n'estpas reconnue par le système, l'action par défaut consiste à associer le nouvel objet à la vue Éditeurde texte de WPS Workbench.

4. (Facultatif) Sélectionnez Options avancées et, si nécessaire, Lier au fichier dans le système defichiers. Utilisez ensuite Parcourir pour sélectionner un fichier existant dans un projet quelconquepour y lier le nouveau fichier.

Remarque :Cette étape crée un raccourci vers le fichier existant, et le contenu de ce dernier est immédiatementinscrit dans le nouveau fichier. Toutes les modifications apportées au contenu sont répercutées surle dossier associé du système de fichiers. L'icône du nouveau fichier comporte une petite flèche surla droite, par exemple , pour indiquer que le fichier est lié. Pour examiner à tout moment la naturedu lien et la modifier si nécessaire, cliquez avec le bouton droit sur le fichier de projet à l'aide del'icône et sélectionnez Propriétés, puis Ressource.

5. Cliquez sur Terminer pour achever la tâche.

Le nouveau fichier s'affiche dans la vue Explorateur de projets sous le projet ou dossiersélectionné.

Remarque :Pour créer un fichier de programme dans lequel créer un programme à exécuter dans WPS, voir lasection Créer un fichier de programme dans un projet.

Créer un fichier de programme dans un projet

Procédez comme suit pour créer un fichier de programme dans un projet existant, ou dans un dossier figurant dans un projet :

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets).

2. Ouvrez l'assistant Nouveau programme en effectuant l'une des opérations suivantes :

• Cliquez avec le bouton droit sur l'objet dans lequel vous voulez créer le programme, puissélectionnez Nouveau ➤  Programme.

Guide utilisateur du WorkbenchVersion 3.3

68

• Dans le menu principal, sélectionnez Fichier ➤ Nouveau ➤  Programme ouFichier ➤ Nouveau ➤  Programme sans titre.

• Ouvrez la liste déroulante de l'icône Nouveau en haut à gauche de la fenêtre duWorkbench et sélectionnez Programme ou Programme sans titre.

La boîte de dialogue Programme WPS s'ouvre.

Remarque :Si vous avez sélectionné Programme sans titre, le nouveau programme s'ouvreautomatiquement dans la vue Éditeur SAS pour que vous puissiez commencer à y saisir du code.Son nom par défaut est Sans titre n.sas, où n est le numéro suivant de la séquence. Vouspouvez désormais saisir du code comme indiqué à la section Créer un programme, et enregistrer lefichier à l'emplacement spécifié.

3. Vérifiez que le dossier parent voulu est sélectionné en haut de la boîte de dialogue.4. Au bas de la boîte de dialogue, saisissez le nom du nouveau fichier.

Remarque :Le Workbench peut suggérer un nom par défaut du type Programme1.sas ou, si un programmede ce nom a déjà été créé, il propose ensuite Programme2.sas, et ainsi de suite. Toutefois, vouspouvez remplacer l'extension par .wps si vous le souhaitez : les deux extensions indiquent desprogrammes en langage SAS.

5. (Facultatif) Sélectionnez Options avancées et, si nécessaire, Lier au fichier dans le système defichiers. Utilisez ensuite Parcourir pour sélectionner un fichier existant dans un projet quelconquepour y lier le nouveau fichier.

Remarque :Cette étape crée un raccourci vers le fichier existant, et le contenu de ce dernier est immédiatementinscrit dans le nouveau fichier. Toutes les modifications apportées au contenu sont répercutées surle dossier associé du système de fichiers. L'icône du nouveau fichier comporte une petite flèche surla droite, par exemple , pour indiquer que le fichier est lié. Pour examiner à tout moment la naturedu lien et la modifier si nécessaire, cliquez avec le bouton droit sur le fichier de projet à l'aide del'icône et sélectionnez Propriétés, puis Ressource.

6. Cliquez sur Terminer pour achever la tâche.

Le nouveau programme s'affiche dans la vue Explorateur de projets, dans le projet oule dossier sélectionné, et il s'ouvre automatiquement dans la vue Éditeur SAS, pour que vouspuissiez commencer à saisir le code, comme indiqué à la section Créer un programme.

Ouvrir un fichier de projetLa vue Explorateur de projets permet de contrôler comment le Workbench ouvre les fichiers ensélectionnant des éditeurs spécifiques. Voir la section Travailler avec les éditeurs.

Guide utilisateur du WorkbenchVersion 3.3

69

Déplacer un fichier de projetPour déplacer un dossier, fichier, programme ou tout autre objet, entre des projets, ou entre desdossiers d'un même projet, procédez comme suit :

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets).

2. Sélectionnez l'objet à déplacer.3. Déplacez-le à l'aide des opérations suivantes :

• Faites-le glisser jusqu'au projet ou dossier voulu, en maintenant le bouton gauche de lasouris jusqu'à ce que le système indique que vous pouvez le déposer.

• Sélectionnez l'option Fichier ➤ Déplacer pour afficher la boîte de dialogue Déplacer lesressources. Vous pouvez ensuite sélectionner le nouveau projet ou dossier de destination dansla boîte de dialogue Aperçu, le déplacer comme requis, puis cliquez sur OK pour terminer ledéplacement.

Remarque :Si le déplacement effectué ne vous convient pas, vous pouvez l'inverser en sélectionnantÉditer ➤ Annuler Déplacer les ressources.

Astuce :Vous pouvez également effectuer un glisser-déposer entre l'Explorateur Microsoft Windows et la vue

Explorateur de projets du Workbench.

Copier un fichier de projetPour copier un dossier, fichier, programme ou tout autre objet, entre des projets, ou entre des dossiersd'un même projet, procédez comme suit :

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets).

2. Sélectionnez l'objet à copier.3. Effectuez l'une des opérations suivantes :

• Maintenez la touche Ctrl enfoncée et faites glisser l'objet vers le projet ou le dossier. Uneboîte de dialogue vous demande si vous voulez copier l'objet ou le lier à un autre emplacement.

• Copiez l'objet (soit en cliquant avec le bouton droit et en sélectionnant Copier, soit en utilisantl'option Éditer ➤  Copier du menu principal), puis collez-le (soit en cliquant avec le boutondroit sur le projet ou dossier de destination et en sélectionnant Coller, soit en sélectionnantÉditer ➤  Coller dans le menu principal).

Guide utilisateur du WorkbenchVersion 3.3

70

Remarque :Si la copie effectuée ne vous convient pas, vous pouvez l'inverser en sélectionnantÉditer ➤ Annuler Copier les ressources.

Si vous essayez de coller l'objet à l'emplacement où vous l'avez copié, un message vous inviteà saisir un nouveau nom pour la copie (par défaut, le nouveau nom est Copie de <nom del'objet>).

Astuce :Vous pouvez également copier des objets entre l'explorateur de fichiers de Microsoft Windowset la vue Explorateur de projets du Workbench par copier-coller ou glisser-déposer. Enoutre, vous pouvez copier et coller des fichiers entre la vue Explorateur de projets et la vue

 Explorateur de fichiers, et vice versa.

Renommer un projet ou un fichier de projetPour renommer un objet, ou le projet lui-même :

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets).

2. Sélectionnez l'objet ou le projet que vous souhaitez renommer.3. Affichez la boîte de dialogue Renommer les ressources soit en cliquant avec le bouton droit

sur l'objet et en sélectionnant Renommer dans le menu contextuel, soit en sélectionnantFichier ➤ Renommer dans le menu principal.

4. Remplissez le champ Nouveau nom de la boîte de dialogue Renommer la ressource.5. Vous pouvez soit appuyer sur la touche Entrée du clavier, soit cliquer sur OK pour terminer

l'opération et fermer la boîte de dialogue.

Lier le programme actif à la vue Explorateur de projetsSi vous avez plusieurs programmes issus de différents projets qui sont ouverts dans la vue Éditeur,vous pouvez configurer la vue Explorateur de projets afin qu'elle développe automatiquementle contenu d'un projet pour que chaque fichier ouvert soit lié à la vue Explorateur de projets. Celasignifie, par exemple, que le nom d'un programme est affiché et surligné dans son dossier chaque foisqu'il devient le fichier actif dans la vue Éditeur.

Restriction :Cette fonctionnalité de liaison ne fonctionne pas pour les programmes ouverts avec la vue Explorateurde fichiers.

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤  Afficher la vue ➤  Explorateur de projets).

Guide utilisateur du WorkbenchVersion 3.3

71

2. Dans la barre de boutons de la vue, cliquez sur le bouton Lier à l'éditeur.

Cela active ou désactive la fonctionnalité.

Supprimer un fichier d'un projetLa suppression d'un projet entier est expliquée à la section Supprimer un projet.

Pour supprimer un objet d'un projet, procédez comme suit :

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets).

2. Sélectionnez l'objet à supprimer.3. Affichez la boîte de dialogue Supprimer les ressources soit en cliquant avec le bouton droit sur

l'objet et en sélectionnant Supprimer dans le menu contextuel, soit en sélectionnant Éditer ➤  Supprimer dans le menu principal.

4. Cliquez sur OK pour confirmer la suppression.5. La boîte de dialogue se ferme et l'objet est supprimé du projet parent.

Remarque :Si plusieurs copies du même objet figurent dans différents dossiers et projets, seule l'instance miseen surbrillance est supprimée.

Si vous supprimez des objets comme indiqué ci-dessus depuis la vue Explorateur de projets aulieu d'utiliser les outils du système d'exploitation, vous pouvez utiliser la fonctionnalité Restaurer unprogramme à partir de son historique local du Workbench présentée.

Copier un projetVous pouvez utiliser les fonctions Copier et Coller du Workbench pour créer un projet basé surun projet existant.

Pour plus d'informations générales sur cette fonction, voir la section Copier un fichier de projet.

Supprimer un projetPour supprimer un projet :

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets).

Guide utilisateur du WorkbenchVersion 3.3

72

2. Cliquez avec le bouton droit sur le projet et sélectionnez Supprimer dans le menucontextuel.

3. Un message s'affiche pour vous permettre de confirmer ou d'annuler la suppression.

Avertissement :Il comporte la case à cocher Supprimer le contenu du projet sur le disque (l'opération ne peutpas être annulée). Cette option supprime définitivement le dossier du projet et son contenu dusystème de fichiers.

L'option Aperçu permet également de visualiser les informations associées à la ressource que vousallez supprimer. Vous pourrez ainsi remarquer d'éventuels problèmes.

Si vous décidez de ne pas supprimer le contenu du système de fichiers, vous pouvez utiliserultérieurement la fonction Fichier ➤  Importer ➤  Généralités ➤  Projets existants dansl'espace de travail pour réafficher le projet dans le Workbench.

4. Cliquez sur OK pour confirmer la suppression.

Fermer et ouvrir un projetLorsque plusieurs projets sont ouverts dans le Workbench, il est préférable de fermer certainsprojets pour éviter de manipuler par accident les mauvais programmes.

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets).

2. Mettez en surbrillance le projet que vous souhaitez fermer.

3. Cliquez avec le bouton droit sur le projet et sélectionnez Fermer le projet dans le menu contextuel,ou sélectionnez Projet ➤ Fermer le projet dans le menu principal.

L'arborescence du projet fermé est réduite dans la vue Explorateur de projets, et tous lesprogrammes et fichiers ouverts dans la vue Éditeur du Workbench sont fermés en même temps.

Remarque :Si vous avez besoin de rouvrir le projet :

1. Ouvrez la vue Explorateur de projets ( Fenêtre ➤  Afficher la vue ➤  Explorateur deprojets).

2. Sélectionnez le projet fermé.

3. Cliquez avec le bouton droit sur le projet et sélectionnez Ouvrir le projet dans le menucontextuel, ou sélectionnez Projet ➤ Ouvrir le projet dans le menu principal.

Guide utilisateur du WorkbenchVersion 3.3

73

Importer des fichiersPour importer des fichiers à partir d'un fichier d'archive (tel qu'un fichier zip) ou d'un système defichiers :

1. Vous devez effectuer l'importation vers un projet existant. Si vous n'avez encore aucun projet,consultez la section Créer un projet.

2. Lancez l'assistant Importer, soit en cliquant avec le bouton droit sur le projet et en sélectionnantImporter dans le menu contextuel, soit en sélectionnant Fichier ➤  Exporter dans le menuprincipal.

La première page de l'assistant Importer s'affiche.3. Développez l'arborescence sous le nœud Généralités.

4. Sélectionnez l'une des options suivantes :

• Système de fichiers – Utilisez cette option si les fichiers et dossiers à importer ne sont pasarchivés dans un fichier unique.

• Fichier archive – Utilisez cette option si les fichiers et les dossiers à importer sont archivésdans un seul fichier (zip, tar ou tar.gz, par exemple).

5. Cliquez sur Suivant.6. Dans le champ vide À partir du répertoire en haut de l'écran, spécifiez l'emplacement du ou des

fichiers à importer, à l'aide du bouton Parcourir si nécessaire.7. Une liste des fichiers et des dossiers accessibles à l'importation s'affiche. Sélectionnez les objets à

importer.

Astuce :Il est déconseillé de sélectionner le dossier parent des fichiers à importer ; les fichiers importésseraient alors importés dans un sous-répertoire du nouveau projet.

Restriction :N'importez pas de fichier de définition de projet ( .project). Sinon, il remplacerait celui ouvert dansle projet que vous allez sélectionner à l'étape suivante dans le champ Dans le dossier.

8. Utilisez le bouton Parcourir pour définir la valeur du champ Dans le dossier (c'est-à-dire le dossierdans lequel le ou les fichiers sélectionnés dans le champ À partir du répertoire vont être importés).

9. Cliquez sur Terminer.

Les fichiers sont importés dans le projet sélectionné.

Exporter un projetPour effectuer une copie ou une sauvegarde d'un projet et tous les fichiers et dossiers qu'il contient :

Guide utilisateur du WorkbenchVersion 3.3

74

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets).

2. Mettez en surbrillance le projet que vous souhaitez exporter.

3. Lancez l'assistant Exporter, soit en cliquant avec le bouton droit sur le projet et en sélectionnantExporter, soit en sélectionnant Fichier ➤  Exporter dans le menu principal.

La première page de l'assistant Exporter s'affiche.4. Développez l'arborescence sous le nœud Généralités.

5. Dans Destination d'exportation, sélectionnez l'un des types suivants :

• Système de fichiers – Crée une copie du dossier de projet, des fichiers et des sous-dossiersqu'il contient.

• Fichier archive – Crée un fichier zip compressé dans l'emplacement d'exportation.

Remarque :Le Workbench peut lire et écrire les fichiers zip sans nécessiter un logiciel propriétairesupplémentaire.

6. Cliquez sur Suivant.7. (Facultatif) Vous pouvez maintenant sélectionner ou désélectionner tous les fichiers et dossiers

que vous souhaitez exporter. Comme vous avez sélectionné un projet avant de commencerle processus d'exportation, la liste par défaut est constituée des composants de ce projet. Pourmodifier votre sélection, cliquez sur le bouton Désélectionner tous pour vous assurer qu'aucunélément n'est plus sélectionné, puis dans la fenêtre de gauche, sélectionnez le projet à exporter,afin que tous les objets qu'il contient soient sélectionnés. Essayez les autres options pour apprendreà sélectionner des dossiers et fichiers spécifiques.

8. Dans le champ Vers vide au centre de la boîte de dialogue Exporter, spécifiez l'emplacement cible.Vous pouvez utiliser l'option Parcourir si nécessaire.

9. Cliquez sur Terminer pour démarrer le processus d'exportation.

Vous disposez maintenant d'une sauvegarde du projet. Selon la valeur sélectionnée dans Destinationd'exportation, si vous regardez dans l'emplacement cible choisi, vous trouverez soit un fichier zip, soittous les fichiers et dossiers copiés.

Travailler dans plusieurs projetsIl est possible d'avoir plusieurs projets d'ouverts en même temps dans le Workbench. Vous pouvezy parvenir de différentes manières :

• Créer un projet

• Importer les exemples et d'autres projets

• Copier un projet

Guide utilisateur du WorkbenchVersion 3.3

75

Remarque :Vous pouvez déplacer, copier, couper et coller des éléments entre les projets.

Basculer vers un autre espace de travailPour basculer vers un autre espace de travail, pour afficher ou créer un autre groupe de projets :

1. Afin de voir le résultat du passage à un autre espace de travail, ouvrez la vue Explorateur deprojets (Fenêtre ➤ Afficher la vue ➤  Explorateur de projets).

2. Sélectionnez Fichier ➤ Changer d'espace de travail. Si l'espace de travail vers lequel vousvoulez passer n'est pas affiché immédiatement, sélectionnez Autre pour le faire apparaître (voirles instructions de la section Fenêtre de lancement des espaces de travail pour voir commentsélectionner un autre espace de travail).

3. Si vous avez sélectionné un autre espace de travail sans afficher le Lanceur d'espace de travail,le Workbench redémarre automatiquement pour afficher le nouvel espace de travail. Sinon,déclenchez le redémarrage en cliquant sur OK dans le Lanceur d'espace de travail.

Historique localLe Workbench maintient un historique local des modifications apportées aux programmes ou auxautres fichiers de projet modifiés dans le Workbench en utilisant la vue Explorateur de projets.

Remarque :Même lorsque vous fermez le Workbench, puis le rouvrez, un historique local est conservé. Lorsquevous copiez un programme, vous copiez également son historique, mais seulement si vous utilisez lesoutils de copie fournis par la vue Explorateur de projets (voir la section Copier un fichier de projet).

Avertissement :L'historique local n'est pas disponible lorsque vous gérez les fichiers depuis la vue Explorateur defichiers.

Historique des modificationsChaque fois que vous enregistrez un fichier de projet dans le Workbench, un instantané du contenude ce fichier est ajouté à l'historique local du Workbench. Cet historique permet de comparer vosprogrammes actuels à leur historique local, et éventuellement de les remplacer par ce dernier (voirles sections Comparer un programme à son historique local et Remplacer un programme par sonhistorique local). Chaque modification dans l'historique local est représentée de manière unique parl'horodatage de chaque enregistrement du fichier.

Guide utilisateur du WorkbenchVersion 3.3

76

Remarque :Si vous modifiez un fichier en dehors du Workbench, ou si vous modifiez un fichier qui a été ouvertdepuis la vue Explorateur de fichiers, aucun enregistrement n'est ajouté à l'historique.

Historique des suppressionsChaque fois que vous supprimez un programme ou un fichier en utilisant la vue Explorateur deprojets (voir la section Supprimer un fichier d'un projet), l'historique de modification de l'élément quia été supprimé est transféré à l'historique local contenant le projet ou le dossier. Cela vous permetnon seulement de restaurer l'élément depuis l'historique local, mais aussi de sélectionner quel étatspécifique de l'historique restaurer.

Préférences de l'historique localLes valeurs définies dans Préférences de l'historique local contrôlent la durée de conservation del'historique local, le nombre d'entrées à garder dans l'historique, et la taille de fichier maximale qu'il estpossible d'enregistrer.

Comparer un programme à son historique localPour comparer la version actuelle d'un programme enregistré à une version antérieure :

1. Sélectionnez le fichier dont vous voulez comparer les versions à l'aide d'une des opérationssuivantes :

• Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets) et sélectionnez le projet.

• Ouvrez le fichier dans la vue Éditeur et vérifiez qu'il s'agit de la vue active.2. Cliquez dessus avec le bouton droit et sélectionnez Comparer ➤ Historique local dans le menu

contextuel.

La fenêtre Historique s'affiche, dressant la liste des révisions apportées au programme avec leurhorodatage.

3. Dans la liste des révisions, double-cliquez sur la révision à laquelle vous désirez comparer laversion actuelle du fichier.

La fenêtre Comparaison de texte s'ouvre immédiatement pour afficher les différences entre lesdeux versions (surlignées en gris). La version actuelle est sur la gauche, la version de référence àdroite.

4. Les boutons de barre d'outils suivants dans la fenêtre Comparaison de texte permettent deparcourir les fichiers :

• Différence suivante – lorsque ce bouton est disponible, il met en surbrillance la différencesuivante.

Guide utilisateur du WorkbenchVersion 3.3

77

• Différence précédente – lorsque ce bouton est disponible, il met en surbrillance la différenceprécédente.

• Modification suivante – lorsque ce bouton est disponible, il met en surbrillance lamodification suivante.

• Modification précédente – lorsque ce bouton est disponible, il met en surbrillance lamodification précédente.

5. Si vous souhaitez remplacer entièrement la version actuelle par la version antérieure, procédezcomme indiqué à la section Remplacer un programme par son historique local. Si vous souhaitezsimplement effectuer des modifications plus sélectives dans la fenêtre de gauche en fonction de ceque vous voyez dans la fenêtre Comparaison de texte, les boutons de barre d'outils suivants dansla fenêtre Comparaison de texte permettent de fusionner des modifications d'un fichier à l'autre :

• Copie la modification en cours vers la gauche – cette option copie la modification/différence actuellement surlignée du volet droit au volet gauche.

• Copier tout de la droite vers la gauche – cette option copie le contenu du volet droit auvolet gauche.

6. Une fois que vous avez effectué les modifications, sélectionnez Fichier ➤ Enregistrer.

7. Fermez la fenêtre Comparaison du texte à l'aide d'une des opérations suivantes :

• Placez le pointeur de la souris sur l'onglet et sélectionnez Fermer (à droite du nom).

• Cliquez avec le bouton droit sur l'onglet et sélectionnez l'option Fermer.• Sélectionnez Fichier ➤ Fermer.

Remarque :Si vous tentez de fermer une fenêtre contenant des modifications non enregistrées, un messagevous demande si vous souhaitez les enregistrer.

Remplacer un programme par son historique localPour rétablir une version antérieure d'un programme enregistrée auparavant dans un projet :

1. Effectuez l'une des opérations suivantes :

• Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets) et sélectionnez le fichier à remplacer par une version antérieure.

• Ouvrez le fichier dans la vue Éditeur et vérifiez qu'il s'agit de la vue active.2. Si vous souhaitez simplement remplacer la version actuelle par la version précédente, cliquez avec

le bouton droit et sélectionnez Remplacer par ➤ Précédente de l'historique local. Toutefois, sivous souhaitez explorer les versions antérieures avant d'en choisir une, procédez comme suit :

3. Cliquez avec le bouton droit et sélectionnez Remplacer par ➤ Historique local dans le menucontextuel.

Guide utilisateur du WorkbenchVersion 3.3

78

La fenêtre Comparer qui s'affiche liste les mises à jour du programme.4. Double-cliquez sur la mise à jour à laquelle vous désirez comparer la version actuelle.

La version actuelle et la version antérieure sélectionnée sont affichées, et les différences entre ellessont mises en surbrillance. La version actuelle est intitulée Fichier de l'espace de travail, et larévision sélectionnée est intitulée Historique local.

Astuce :Vous pouvez simplement sélectionner et copier une partie du texte que vous souhaitez utiliser dansla version antérieure. Cliquez sur Fermer dans l'angle supérieur droit de la boîte de dialogue, ousur Annuler en bas à droite, et collez le fragment de texte dans un autre programme ou fichier.

5. Une fois que vous êtes certain que la version Historique local affichée est celle que vous voulezutiliser à la place de la version actuelle, cliquez sur Remplacer pour écraser la version Fichier del'espace de travail par la version Historique local, et fermez la boîte de dialogue Comparer.

Restaurer un programme à partir de sonhistorique localVous pouvez restaurer un programme ou tout autre fichier d'un projet après sa suppression depuisla vue Explorateur de projets en procédant comme suit :

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets).

2. Pour afficher tous les fichiers qui ont été supprimés d'un projet, cliquez sur ce dernier avec lebouton droit. Pour n'afficher que les fichiers qui ont été supprimés d'un dossier, cliquez sur cedernier avec le bouton droit. Sélectionnez Restaurer à partir de l'historique local dans le menucontextuel.

La boîte de dialogue Restaurer à partir de l'historique local s'ouvre. elle présente les fichierspouvant être restaurés.

3. Cochez la case en regard de chaque fichier à restaurer.

Remarque :Si un fichier sélectionné a un historique local, les versions précédentes du fichier sont affichéesdans le côté droit de la boîte de dialogue, regroupées par date. Lorsque vous sélectionnez uneversion, ses détails sont affichés dans le volet du bas de la boîte de dialogue. Vérifiez que vousavez sélectionné la bonne version avant de continuer.

4. Cliquez sur Restaurer pour rétablir le fichier ou la version du fichier dans le projet ou dossier etfermer la boîte de dialogue Restaurer à partir de l'historique local.

Guide utilisateur du WorkbenchVersion 3.3

79

Préférences de l'historique localPar défaut, le Workbench conserve un historique local pendant sept jours pour chaque fichier de projetet un maximum de cinquante versions par fichier. Il existe également une valeur par défaut d'unecapacité de stockage de 1 Mo allouée pour l'historique local de chaque programme.

Pour modifier ces paramètres, procédez comme suit :

1. Sélectionnez Fenêtre ➤ Préférences ➤ Généralités ➤ Espace de travail ➤ Historique local.

La boîte de dialogue Historique local s'affiche.2. Définissez les paramètres suivants selon vos besoins :

• Conservation des fichiers (jours) – Nombre de jours pendant lesquels vous souhaitezconserver les fichiers de projet. Par exemple, si vous saisissez 20, l'historique contient lesversions enregistrées au cours des 20 derniers jours. La valeur par défaut est de 7 jours.

• Nombre maximal d'entrées par fichier – Nombre d'étapes à sauvegarder pour chaqueprogramme. Lorsque vous dépassez ce nombre, les anciennes modifications seront suppriméespour faire place aux changements récents. La valeur par défaut est de 50 versions par fichier.

• Taille maximale du fichier (Mo) – Taille maximale (en Mo) de l'historique local d'un fichier deprojet. Une fois cette taille atteinte, plus aucune information n'est enregistrée dans l'historiquelocal pour ce fichier. La valeur par défaut est de 1 Mo.

Remarque :Les options Conservation des fichiers (jours) et Nombre maximal d'entrées par fichier ne sontappliquées que lorsque l'historique local est compacté à la fermeture du serveur.

Comparer et fusionner des fichiersVous pouvez effectuer des comparaisons entre deux ou trois fichiers.

Remarque :Les comparaisons entre trois fichiers permettent de détecter les différences entre différentesversions d'un même fichier – par exemple, la version locale de la ressource sur le Workbench, laversion enregistrée sur une branche et l'ancêtre commun sur lequel les deux versions en conflitsont basées. Ceci est particulièrement utile pour fusionner des ressources en cas de conflit lors dela synchronisation. Les conflits sont affichés en rouge, les modifications entrantes en bleu et lesmodifications sortantes en gris. S'il n'est pas possible de déterminer l'ancêtre commun – par exemple,si une ressource portant le même nom et figurant dans le même répertoire a été créée par deuxdéveloppeurs – la comparaison se limite à ces deux fichiers.

Pour ce faire :

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur de projets)et sélectionnez les fichiers à comparer (jusqu'à trois fichiers).

Guide utilisateur du WorkbenchVersion 3.3

80

2. Cliquez avec le bouton droit et sélectionnez Comparer ➤ Réciproquement dans le menucontextuel.

Si vous comparez deux fichiers, une fenêtre Comparaison de texte s'ouvre immédiatementpour afficher les différences entre les deux versions (surlignées en gris). Si vous comparez troisfichiers, vous êtes d'abord invité à sélectionner l'ancêtre commun – c'est-à-dire le fichier auquelsont comparés les deux autres. Dans la fenêtre Comparaison de texte, les deux versions autresque l'ancêtre commun sont affichées dans des volets adjacents, mais vous avez aussi la possibilitéd'afficher ce dernier volet à l'aide de la barre d'outils :

• Affiche la sous-fenêtre Ancêtre – lors de la comparaison de trois fichiers, cette optionaffiche l'ancêtre commun. Cliquez à nouveau sur cette option pour masquer le volet.

Remarque :Pour passer d'une comparaison à une autre, utilisez l'option suivante : Basculer entrecomparaison bidirectionnelle et tridirectionnelle – pour passer de la comparaison entre deuxfichiers (qui ne fait pas intervenir l'ancêtre commun) et la comparaison entre trois fichiers.

3. Les boutons de barre d'outils suivants dans la fenêtre Comparaison de texte permettent deparcourir les fichiers :

• Différence suivante – lorsque ce bouton est disponible, il met en surbrillance la différencesuivante.

• Différence précédente – lorsque ce bouton est disponible, il met en surbrillance la différenceprécédente.

• Modification suivante – lorsque ce bouton est disponible, il met en surbrillance lamodification suivante.

• Modification précédente – lorsque ce bouton est disponible, il met en surbrillance lamodification précédente.

4. Les boutons de barre d'outils suivants dans la fenêtre Comparaison de texte permettent defusionner des modifications d'un fichier à l'autre :

• Copie la modification en cours vers la gauche – cette option copie la modification/différence actuellement surlignée du volet droit au volet gauche.

• Copier tout de la droite vers la gauche – cette option copie le contenu du volet droit auvolet gauche.

• Copie la modification en cours vers la droite – cette option copie la modification/différenceactuellement surlignée du volet gauche au volet droit.

• Copier tout de la gauche vers la droite – cette option copie le contenu du volet gauche auvolet droit.

5. Une fois que vous avez effectué les modifications, sélectionnez Fichier ➤ Enregistrer.

6. Fermez la fenêtre Comparaison du texte à l'aide d'une des opérations suivantes :

• Placez le pointeur de la souris sur l'onglet et sélectionnez Fermer (à droite du nom).

• Cliquez avec le bouton droit sur l'onglet et sélectionnez l'option Fermer.

Guide utilisateur du WorkbenchVersion 3.3

81

• Sélectionnez Fichier ➤ Fermer.

Remarque :Si vous tentez de fermer une fenêtre contenant des modifications non enregistrées, un messagevous demande si vous souhaitez les enregistrer.

Guide utilisateur du WorkbenchVersion 3.3

82

Gérer les fichiers dans la vueExplorateur de fichiersCette section du guide explique comment manipuler divers objets du système de fichiers via la vue

 Explorateur de fichiers.

Comme expliqué à la section Vues Explorateur de projets et Explorateur de fichiers, cette vue permetd'accéder aux fichiers et aux dossiers sur les systèmes distants et locaux.

Créer un dossier dans un système defichiersVous pouvez créer des dossiers à tout emplacement pour lequel disposez des autorisationsnécessaires, qu'il s'agisse d'un hôte local ou distant.

1. Ouvrez la vue Explorateur de fichiers (Fenêtre ➤  Afficher la vue ➤  Explorateur defichiers).

2. Ouvrez la boîte de dialogue Nouveau dossier en cliquant avec le bouton droit sur le raccourcide répertoire ou sur le dossier dans lequel vous voulez créer le dossier, puis sélectionnezNouveau ➤  Dossier.

La boîte de dialogue Nouveau dossier s'ouvre.3. Vérifiez que le raccourci de répertoire ou le dossier parent voulu est sélectionné. Par

défaut, le conteneur depuis lequel vous avez accédé au menu contextuel est sélectionné. Vouspouvez créer le dossier sur un autre hôte.

4. En bas de la fenêtre, remplissez le champ Nom du dossier.5. Cliquez sur Terminer pour achever la tâche.

Créer un fichier dans un système defichiersProcédez comme suit pour créer un fichier dans un système de fichiers existant :

Guide utilisateur du WorkbenchVersion 3.3

83

1. Ouvrez la vue Explorateur de fichiers (Fenêtre ➤ Afficher la vue ➤  Explorateur defichiers).

2. Ouvrez la boîte de dialogue Nouveau fichier en cliquant avec le bouton droit sur le raccourcide répertoire ou sur le dossier dans lequel vous voulez créer le fichier, puis sélectionnezNouveau ➤  Fichier.

La boîte de dialogue Nouveau fichier s'affiche.3. Vérifiez que le raccourci de répertoire ou le dossier parent voulu est sélectionné.

4. Au bas de la boîte de dialogue, saisissez le nom du nouveau fichier.

Si vous spécifiez une extension de fichier reconnue par le système (par exemple, .sas ou .wps, quiindiquent un programme, ou .doc, qui indique un document Microsoft Word), le nouveau fichier estassocié à l'éditeur approprié.

5. Cliquez sur Terminer pour achever la tâche.

Le fichier vide est créé à l'emplacement spécifié.

Remarque :Pour créer un fichier de programme dans lequel créer un programme à exécuter dans WPS, voir lasection suivante.

Créer un programme dans un système de fichiersPour créer un fichier de programme dans un raccourci de répertoire ou un dossier existantd'un système de fichiers, procédez comme suit :

1. Ouvrez la vue Explorateur de fichiers (Fenêtre ➤  Afficher la vue ➤  Explorateur defichiers).

2. Ouvrez l'assistant Nouveau programme en effectuant l'une des opérations suivantes :

• Cliquez avec le bouton droit sur l'objet dans lequel vous voulez créer le programme, puissélectionnez Nouveau ➤  Programme.

• Dans le menu principal, sélectionnez Fichier ➤ Nouveau ➤  Programme ouFichier ➤ Nouveau ➤  Programme sans titre.

• Ouvrez la liste déroulante de l'icône Nouveau en haut à gauche de la fenêtre duWorkbench et sélectionnez Programme ou Programme sans titre.

La boîte de dialogue Programme WPS s'ouvre.

Guide utilisateur du WorkbenchVersion 3.3

84

Remarque :Si vous avez sélectionné Programme sans titre, le nouveau programme s'ouvreautomatiquement dans la vue Éditeur SAS pour que vous puissiez commencer à y saisir du code.Son nom par défaut est Sans titre n.sas, où n est le numéro suivant de la séquence. Vouspouvez désormais saisir du code comme indiqué à la section Créer un programme, et enregistrer lefichier à l'emplacement spécifié.

3. Vérifiez que le raccourci de répertoire ou le dossier parent voulu est sélectionné.

4. Au bas de la boîte de dialogue, saisissez le nom du nouveau fichier.

Remarque :Le Workbench peut suggérer un nom par défaut du type Programme1.sas ou, si un programmede ce nom a déjà été créé, il propose ensuite Programme2.sas, et ainsi de suite. Toutefois, vouspouvez remplacer l'extension par .wps si vous le souhaitez : les deux extensions indiquent desprogrammes en langage SAS.

5. Cliquez sur Terminer pour achever la tâche.

Le nouveau programme s'affiche dans la vue Explorateur de fichiers, dans le raccourci derépertoire ou le dossier sélectionné, et il s'ouvre automatiquement dans la vue Éditeur SAS, pourque vous puissiez commencer à saisir le code, comme indiqué à la section Créer un programme.

Ouvrir un fichier dans un système defichiersL'ouverture des fichiers depuis la vue Explorateur de fichiers permet au Workbench de déterminerautomatiquement l'éditeur le plus approprié pour les ouvrir.

1. Ouvrez la vue Explorateur de fichiers.

2. Accédez au fichier à ouvrir et double-cliquez dessus.

Le fichier s'ouvre selon son extension :

• Les fichiers de programme (extensions de fichier .wps et .sas) s'ouvrent dans la vue ÉditeurSAS.

• Les fichiers texte (.txt) s'ouvrent dans la vue Éditeur de texte.• Les fichiers XML (.xml) s'ouvrent dans la vue Éditeur de texte.• Les fichiers HTML (.html) s'ouvrent dans le Workbench lorsque ceci est possible (ceci dépend de

la plate-forme).

Il est aussi possible d'ouvrir d'autres types de fichiers dans le Workbench, mais cela dépend dusystème d'exploitation.

Guide utilisateur du WorkbenchVersion 3.3

85

Remarque :Dans certains systèmes d'exploitation, si le Workbench ne parvient pas à ouvrir le fichier, il tente del'ouvrir dans l'application qui lui est associée.

Déplacer un fichier dans un système defichiersVous pouvez déplacer des fichiers vers d'autres dossiers sur vos connexions locales ou distantes. Parexemple :

• Déplacer des fichiers par couper-coller.• Déplacer des objets par glisser-déposer.

Déplacer des fichiers par couper-collerVous pouvez déplacer des objets de la vue Explorateur de fichiers en utilisant les options dumenu principal Éditer, le menu contextuel, ou bien en utilisant les raccourcis clavier du systèmed'exploitation.

1. Ouvrez la vue Explorateur de fichiers (Fenêtre ➤  Afficher la vue ➤  Explorateur defichiers).

2. Cliquez avec le bouton droit sur l'objet à déplacer et sélectionnez Couper dans le menu contextuel,ou sélectionnez l'objet et utilisez le raccourci clavier correspondant à Couper dans le systèmed'exploitation (par exemple Ctrl + X).

3. Sélectionnez le raccourci de répertoire ou dossier cible où placer l'objet et cliquez surColler, ou utilisez le raccourci clavier correspondant du système d'exploitation (par exemple,Ctrl + V).

Le déroulement de l'opération s'affiche dans la vue Progression.

Astuce :Vous pouvez également sélectionner plusieurs objets à déplacer plusieurs objets à la fois.

Déplacer des objets par glisser-déposerVous pouvez faire glisser et déposer fichiers et dossiers pour les déplacer.

Guide utilisateur du WorkbenchVersion 3.3

86

1. Ouvrez la vue Explorateur de fichiers (Fenêtre ➤  Afficher la vue ➤  Explorateur defichiers).

2. Cliquez sur l'objet à déplacer.3. Maintenez le bouton gauche enfoncé et faites glisser l'objet jusqu'au raccourci de répertoire ou

dossier.

4. Relâchez le bouton de la souris pour déposer l'objet.

Le déroulement de l'opération s'affiche dans la vue Progression.

Astuce :Vous pouvez également sélectionner plusieurs objets si vous souhaitez déplacer plusieurs objets à lafois.

Copier un fichier dans un système defichiersVous pouvez copier des fichiers vers d'autres dossiers sur votre connexion locale comme sur vosconnexions distantes. Par exemple :

• Copier des objets à l'aide des commandes Copier et Coller.• Copier des objets par glisser-déposer.

Copier des objets à l'aide des commandes Copieret CollerVous pouvez copier des objets de la vue Explorateur de fichiers en utilisant le menu principal Éditerou le menu contextuel, ou bien en utilisant les raccourcis clavier du système d'exploitation.

1. Ouvrez la vue Explorateur de fichiers (Fenêtre ➤  Afficher la vue ➤  Explorateur defichiers).

2. Sélectionnez l'objet à copier et sélectionnez Copier ou utilisez le raccourci clavier correspondant devotre système d'exploitation (par exemple, Ctrl + C).

3. Sélectionnez le raccourci de répertoire ou dossier cible où placer l'objet et cliquez surColler, ou utilisez le raccourci clavier correspondant du système d'exploitation (par exemple,Ctrl + V).

Le déroulement de l'opération s'affiche dans la vue Progression.

Guide utilisateur du WorkbenchVersion 3.3

87

Astuce :Vous pouvez également sélectionner plusieurs objets si vous souhaitez copier plusieurs objets à la fois.En outre, vous pouvez copier et coller des fichiers entre la vue Explorateur de projets et la vue

 Explorateur de fichiers, et vice versa.

Copier des objets par glisser-déposerVous pouvez faire glisser et déposer fichiers et dossiers pour les déplacer :

1. Ouvrez la vue Explorateur de fichiers (Fenêtre ➤  Afficher la vue ➤  Explorateur defichiers).

2. Cliquez sur l'objet à copier.3. Cliquez en maintenant la touche Ctrl enfoncée, et faites glisser l'objet vers le raccourci de

répertoire ou le dossier souhaité (lorsque vous appuyez sur la touche Ctrl, un symbole plus (+)s'affiche à côté du pointeur de la souris).

4. Relâchez le bouton de la souris et la touche Ctrl pour déposer une copie de l'objet à l'emplacementsélectionné.

Le déroulement de l'opération s'affiche dans la vue Progression.

Astuce :Vous pouvez également sélectionner plusieurs objets si vous souhaitez copier plusieurs objets à la fois.

Renommer un objet dans un systèmede fichiersPour renommer un objet du système de fichiers :

1. Ouvrez la vue Explorateur de fichiers (Fenêtre ➤  Afficher la vue ➤  Explorateur defichiers).

2. Cliquez avec le bouton droit sur l'objet et sélectionnez Renommer dans le menu contextuel.3. La boîte de dialogue Renommer le fichier s'affiche. Elle vous permet de remplacer le nom actuel

de l'objet.4. Appuyez sur Entrée ou cliquez sur OK pour terminer l'opération et fermer la boîte de dialogue.

Guide utilisateur du WorkbenchVersion 3.3

88

Remarque :Il peut être nécessaire d'actualiser la connexion dans la vue Explorateur de liens pour que lamodification s'affiche. (Pour ce faire, sélectionnez la connexion, puis cliquez dessus avec le boutondroit et sélectionnez Actualiser dans le menu contextuel, ou encore appuyez sur la touche F5.)

Supprimer un objet d'un système defichiersPour supprimer un objet d'un système de fichiers, procédez comme suit :

1. Ouvrez la vue Explorateur de fichiers (Fenêtre ➤ Afficher la vue ➤  Explorateur defichiers).

2. Cliquez avec le bouton droit sur l'objet et sélectionnez Supprimer dans le menu contextuel.

3. Dans le menu, sélectionnez l'option Supprimer.

4. Cliquez sur OK pour confirmer la suppression.

Avertissement :Une fois la suppression de l'objet confirmée depuis la vue Explorateur de fichiers, l'opération ne peutpas être annulée.

Remarque :Si vous supprimez un fichier à l'aide de la vue Explorateur de projets (voir la section Supprimerun fichier d'un projet), plutôt que la vue Explorateur de fichiers, vous pouvez rétablir les fichiers sinécessaire (voir la section Restaurer un programme à partir de son historique local).

Préférences concernant l'explorateur defichiers WPS (fichiers masqués)Sélectionnez Fenêtre ➤ Préférences ➤ WPS  ➤ Explorateur de fichiers pour accéder à l'optionAfficher les fichiers et dossiers masqués, qui permet d'afficher les fichiers et dossiers masqués surune plate-forme Windows, ou encore les fichiers et dossiers commençant par « . » sur les systèmes detype UNIX.

Guide utilisateur du WorkbenchVersion 3.3

89

PréférencesIl existe de nombreux paramètres utilisateur, commandes et valeurs par défaut que vous pouvezcontrôler en sélectionnant Fenêtre ➤ Préférences.

La plupart des préférences pertinentes sont incluses dans les sections appropriées de ce guide. Laprésente section ne couvre que les points généraux suivants :

• Filtre de préférences• Préférences générales• Préférences concernant les raccourcis clavier• Enregistrer les préférences

Toute préférence qui n'est pas décrite dans ce guide se trouve dans le guide utilisateur de WorkbenchEclipse.

Filtre de préférencesLa fenêtre Préférences est dotée d'une fonction de filtre permettant de trouver les pages depréférences rapidement :

Sélectionnez Fenêtre ➤ Préférences. La fonction de filtre figure en haut à gauche. Elle s'affichecomme une zone de texte avec les mots entrer le texte du filtre :

Guide utilisateur du WorkbenchVersion 3.3

90

À titre d'exemple, saisissez dans cette zone de texte le mot journal une lettre à la fois et regardezcomment la fenêtre Préférences filtre les pages accessibles dont le titre contient le texte que vous avezsaisi dans le filtre.

Pour arrêter le filtre, cliquez sur le bouton Effacer. Toutes les pages Préférences disponibles sontréaffichées dans l'arborescence.

Préférences généralesSous Fenêtre ➤ Préférences ➤ Généralités se situent les commandes qui affectent non seulementles programmes, mais aussi d'autres types de fichiers et d'autres aspects généraux de WPSWorkbench. Voici quelques éléments notables qu'il peut être utile de spécifier :

Toujours exécuter en arrière-planL'exécution de certaines opérations, telles que l'exécution d'un programme ou lerafraîchissement d'un projet contenant un grand nombre de fichiers, peut prendre beaucoup detemps. Lorsque l'option Toujours exécuter en arrière-plan est activée, elle permet aux tâchesde s'exécuter sans afficher la fenêtre de dialogue Exécution.

Guide utilisateur du WorkbenchVersion 3.3

91

Si cette option n'est pas cochée (valeur par défaut), la fenêtre Exécution comporte un boutonExécuter en tâche de fond, qui a le même effet.

Afficher l'état du tasLorsque cette option est sélectionnée, un indicateur s'affiche et donne des informationsconcernant l'utilisation de l'espace mémoire Java, ou tas, c'est-à-dire le segment de la mémoiredu système d'exploitation utilisé par le Workbench pour gérer son interface graphique. Cetindicateur s'affiche en bas de la fenêtre, à gauche de l'état du serveur. Par exemple :

Pour augmenter l'espace mémoire Java, modifiez les deux dernières lignes du fichier<racine_installation_wps>\eclipse\workbench.ini pour qu'elles aient une valeurdu type -vmargs -Xmx1024m, puis redémarrez le Workbench. L'argument -Xmx est celui quidétermine la limite de stockage de l'espace mémoire Java, et dans cet exemple, elle est de1 024 mégaoctets.

Intervalle de sauvegarde du plan de travail (en minutes)

Ce champ indique la fréquence d'enregistrement automatique de l'état du Workbench, ycompris la disposition des perspectives (par défaut, toutes les 5 minutes). Pour désactiver cetenregistrement automatique, définissez la valeur sur 0.

Mode d'ouvertureCette préférence contrôle la façon dont vous ouvrez les objets dans le Workbench. Sélectionnezl'une des options suivantes :

• Double clic – Un clic simple sur une ressource la met en surbrillance, un double clic l'ouvredans un éditeur. C'est le mode par défaut.

• Simple clic (Sélection lors du survol) – La ressource est mise en surbrillance lorsque lepointeur la survole, et s'ouvre dans un éditeur lorsque vous cliquez dessus.

• Simple clic (Ouvrir lors de l'utilisation des touches de direction) – La ressource s'ouvreautomatiquement dans un éditeur lorsque vous la sélectionnez à l'aide des touches fléchées.

Selon la vue active, le résultat de la sélection et de l'ouverture d'une ressource peut varier parrapport aux détails donnés ci-dessus.

Changement de policeSélectionnez Fenêtre ➤ Préférences ➤ Généralités ➤ Apparence ➤ Couleurs et polices ➤ ,faites défiler les options de l'entrée Basique jusqu'à Aa Police de texte. Sélectionnez cetteentrée, puis cliquez sur Modifier pour appliquer une autre police.

Guide utilisateur du WorkbenchVersion 3.3

92

Préférences concernant les raccourcisclavierPour modifier les raccourcis clavier existants, sélectionnezFenêtre ➤ Préférences ➤ Généralités ➤ Clefs et, dans le schéma Par défaut, recherchez la catégorieWPS. Filtrez ensuite les colonnes Catégorie et Liaison pour afficher l'écran suivant :

Si vous souhaitez modifier l'une des liaisons, procédez comme dans l'exemple suivant, où nous allonslier le raccourci clavier Ctrl + 5 à la commande Annuler les modifications :

1. Vérifiez que la commande Annuler les modifications est sélectionnée.2. Dans la zone de texte Liaison, appuyez sur Ctrl + 5.3. La colonne la plus à droite du tableau (Utilisateur) indique qu'il s'agit d'une liaison effectuée par

l'utilisateur, en affichant un U. En cas de conflit avec un autre raccourci clavier, la colonne afficheun C. Par défaut, la liaison a le contexte Dans Windows. Si vous souhaitez modifier cela, vousdevez modifier le champ Quand pour indiquer le contexte approprié (par exemple, Éditer letexte).

Guide utilisateur du WorkbenchVersion 3.3

93

4. Pour enregistrer vos modifications et laisser la boîte de dialogue Préférences ouverte, cliquez surAppliquer. Pour enregistrer vos modifications et fermer la boîte de dialogue Préférences, cliquezsur OK.

Remarque :Si vous souhaitez supprimer une liaison, sélectionnez la commande, puis cliquez sur le bouton Délierla commande, ou sélectionnez l'entrée dans la colonne Liaison et supprimez-la à l'aide de la toucheRetour arrière.

Enregistrer les préférencesVous pouvez enregistrer vos préférences dans un fichier de sauvegarde, et les réimporter quand voussouhaitez réutiliser cet ensemble de paramètres.

Pour enregistrer vos préférences dans un fichier de sauvegarde, procédez comme suit :

1. Sélectionnez Fichier ➤  Exporter ➤  Généralités ➤  Préférences.

2. Cliquez sur Suivant.3. La boîte de dialogue Exportation des préférences s'affiche :

4. Vérifiez que l'option Préférences WPS et/ou Préférences liées aux clés (voir la sectionPréférences concernant les raccourcis clavier) est cochée.

Guide utilisateur du WorkbenchVersion 3.3

94

5. Cliquez sur le bouton Parcourir en regard du champ Vers le fichier de préférences et indiquezsoit le nom d'un nouveau fichier de sauvegarde des préférences (le fichier est automatiquementcréé avec l'extension .epf), soit le nom d'un fichier .epf existant.

Remarque :Si vous spécifiez le nom d'un fichier existant, et que vous ne souhaitez pas être prévenu lorsquevous le remplacez, sélectionnez Remplacer les fichiers existants sans avertissement.

6. Cliquez sur Terminer pour compléter la création du fichier de sauvegarde.

Pour réimporter les préférences depuis un fichier de sauvegarde, procédez comme suit :

1. Sélectionnez Fichier ➤  Importer ➤  Généralités ➤  Préférences.

2. Cliquez sur Suivant.3. La boîte de dialogue Importation des préférences s'affiche :

4. Vérifiez que l'option Préférences WPS et/ou Préférences liées aux clés (voir la sectionPréférences concernant les raccourcis clavier) est cochée.

5. Cliquez sur le bouton Parcourir en regard du champ Vers le fichier de préférences et indiquezle nom du fichier de sauvegarde (extension .epf) existant.

6. Cliquez sur Terminer.

Guide utilisateur du WorkbenchVersion 3.3

95

Créer un programmeVous pouvez créer un programme depuis la vue Explorateur de projets ou Explorateur de fichiers.Voir la section Créer un fichier de programme dans un projet ou Créer un programme dans un systèmede fichiers, selon les cas.

Vous pouvez créer et modifier les programmes dans le Workbench à l'aide des vues Éditeur SAS etFonctionnalités d'édition en mode texte.

Remarque :Pour faciliter la navigation, le Workbench affiche les éléments de structure d'un programme dans la vue

Structure.

Astuce :Si vous découvrez la programmation en SAS, il peut être utile d'étudier les programmes du projetexemple, si vous ne les avez pas encore importés (voir la section Importer les exemples et d'autresprojets). Ils vous donneront une idée de la syntaxe et de l'utilisation des ensembles de données.

Une fois le fichier de programme vide ouvert dans la vue Éditeur SAS, procédez comme suit :

1. Saisissez le code. L'exemple suivant montre comment créer un ensemble de données contenant lessalariés d'une entreprise :

/* Create a dataset */ DATA employees; LENGTH Name $10 Age 3 Job $15; INPUT Name $ Age Job $; /* Here is the data */ CARDS; Beth 41 Sales-Manager Steve 32 Sales William 35 Accounts Anne 28 Marketing Dawn 26 Sales Andrew 36 Support ;

2. Enregistrez le programme en appuyant sur les touches Ctrl + S ou en sélectionnantFichier ➤ Enregistrer.

3. Effectuez toutes les modifications requises, en consultant si nécessaire la section Fonctionnalitésd'édition en mode texte. Le Workbench signale les éléments de langage présents dans leprogramme à l'aide de couleurs qui vous aident à visualiser la structure du code. Certaines couleurspar défaut sont utilisées, comme le vert pour les commentaires, le bleu pour les mots-clés, et unarrière-plan jaune pour les lignes de données. Par exemple :

Guide utilisateur du WorkbenchVersion 3.3

96

La coloration syntaxique vous aide également à voir si vous avez fait une faute de frappe dans leséléments de langage. Ainsi, dans l'exemple de programme, si vous remplacez le mot DATA de ladeuxième ligne par DAT, il est affiché en rouge.

Remarque :Veillez à annuler cette faute de frappe (soit en appuyant sur Ctrl + Z, soit en choisissant Éditer  ➤ Annuler Saisie) avant de continuer.

Important :Si aucune couleur n'apparaît sur votre programme, c'est sans doute parce qu'il n'a pas uneextension .wps ou .sas. Sans cette extension, il ne peut pas être exécuté.

4. Exécutez le programme comme décrit à la section Exécuter un programme à l'intérieur duWorkbench.

Tous les ensembles de données générés, comme dans l'exemple ci-dessus, sont créés dansl'emplacement Work, décrit à la section Bibliothèques, et peuvent être édités comme décrit à lasection Modifier un ensemble de données.

Guide utilisateur du WorkbenchVersion 3.3

97

Remarque :Pour le reste des sorties du programme, voir la section Utiliser les sorties de programme.

Coloration syntaxique dans WPSLa boîte de dialogue Coloration syntaxique accessible depuis Fenêtre ➤ Préférences ➤ WPS ➤ Coloration syntaxique dans WPS permet de spécifier commentafficher les éléments de langage contenus dans un programme (lignes de données, commentaires,formats, etc) :

Guide utilisateur du WorkbenchVersion 3.3

98

Pour chaque type d'élément de langage, vous pouvez spécifier les attributs Couleur, Couleurd'arrière-plan, Gras et Italique.

Saisir du code WPS à l'aide de modèlesVous pouvez sélectionner Fenêtre ➤ Préférences ➤ WPS ➤ Modèles de code pour définir les modèlesqu'il est possible de saisir en tant que raccourcis de code dans les programmes. Ces modèles sontaccessibles à l'aide du raccourci clavier qui permet d'achever le code (par défaut, Ctrl + Espace). Parexemple, si vous définissez un modèle de code nommé mod1, vous pouvez saisir mod suivi de Ctrl +Espace, et la fonctionnalité facilitant l'achèvement du code exécute les tâches suivantes :

1. Comparer mod à la liste des modèles de code.2. Trouver le modèle appelé mod1.3. Saisissez le nom du motif associé au modèle dans votre programme.

S'il existe plusieurs modèles de code dont le nom commence par mod, une boîte de dialogue desélection s'affiche pour vous permettre de choisir le modèle requis.

Guide utilisateur du WorkbenchVersion 3.3

99

Le motif contenant le code à ajouter au programme peut être aussi simple ou complexe que vous lesouhaitez. Il peut même s'agir d'un seul mot. Par exemple, vous pouvez définir un modèle de codequi se développe pour insérer le nom d'un ensemble de données fréquemment utilisé et dont le nomest difficile à saisir. Un modèle de code peut également définir une quantité importante de texte, parexemple l'invocation standard d'une procédure donnée.

Remarque :Si vous saisissez une variable dans un motif, elle doit être entourée de caractères « $$ ».

Vous pouvez exporter des modèles de code dans un fichier externe, ou les importer à partir d'un fichierprécédemment exporté. Il est ainsi possible de partager les modèles de code avec vos collègues, ou decopier les modèles de code que vous avez définis d'un espace de travail à l'autre.

Aide dynamique sur les éléments delangageLorsque vous écrivez ou modifiez un programme, le Workbench peut créer un terme à rechercher dansle document WPS Reference for Language Elements.

1. Si la vue aide contextuelle n'est pas déjà ouverte dans le Workbench (voir la section Aide enligne), appuyez sur la touche F1 du clavier pour l'ouvrir.

2. Lorsque vous saisissez un nouveau mot ou que vous placez le curseur sur un mot du programme,dès que le Workbench le reconnaît, la vue Aide crée automatiquement un mot-clé à utiliser dansWPS Reference For Language Elements. La recherche s'affiche dans la section Davantage derésultats de la rubrique d'aide affichée.

3. Cliquez sur le terme pour effectuer la recherche. Les rubriques pertinentes sont affichées dans lavue Aide pour vous aider à rédiger votre programme.

4. Lorsque vous avez fini de lire l'aide, cliquez sur le lien Rubriques connexes (en haut à droitede la vue Aide) pour retourner à la page d'aide contextuelle (sinon, la vue ne s'actualise plus demanière dynamique pendant que vous continuez à utiliser le Workbench).

Utiliser l'assistant de contenu deprogrammeLa vue Éditeur SAS offre une fonctionnalité d'assistant de contenu qui suggère des éléments delangage. Lorsque vous sélectionnez ces éléments, ils sont automatiquement saisis dans le programme.Procédez comme suit pour en sélectionner un :

1. Dans le programme, saisissez un mot qui peut être associé à plusieurs éléments de langage.

Guide utilisateur du WorkbenchVersion 3.3

100

Par exemple, saisissez le mot PROC.2. Après le mot, saisissez un espace.3. Appuyez ensuite sur CTRL + barre d'espace.

S'il existe des éléments de langage prévus après l'expression que vous avez saisie à l'étape 1, uneliste contextuelle de ces éléments s'affiche.

4. (Facultatif) Vous pouvez filtrer la liste en saisissant les premières lettres de l'élément de langageque vous souhaitez utiliser.

5. Double-cliquez sur l'élément de langage souhaité et il s'affiche dans votre programme.

Injection de code WPSVous pouvez sélectionner Fenêtre ➤ Préférences ➤ WPS ➤ Injection de code afin de saisir du codequi doit être exécuté automatiquement avant et/ou après l'exécution d'un programme.

Activer l'injection pré-code personnaliséeLorsque cette option est activée, le code dans la zone de texte associée est exécuté juste avantun programme. Cette option est similaire à l'option INITSTMT décrite dans le document WPSReference for Language Elements, mais ici, le code s'exécute automatiquement avant que leprogramme soit soumis (l'option système INITSTMT n'est traitée qu'au démarrage du serveur).

Le paramètre Gérer automatiquement les types de résultats de la boîte de dialoguePréférences concernant les options de résultats permet de sélectionner la création automatiquede destinations ODS (afin de pouvoir, par exemple, visualiser facilement les résultats de vosprogrammes en HTML et PDF). Cependant, la création automatique de destinations peutne pas vous convenir. Dans ce cas, vous pouvez utiliser la fonctionnalité d'injection de codepersonnalisée pour définir les destinations ODS de manière plus adaptée.

Activer l'injection post-code personnaliséeLorsque cette option est activée, le code dans la zone de texte associée est exécuté juste aprèsle programme. Cette option offre une fonctionnalité similaire à l'option système TERMTSTMTdécrite dans le document WPS Reference for Language Elements, mais ici, le code s'exécuteautomatiquement après le programme. L'option système TERMSTMT n'est traitée qu'à l'arrêt duserveur.

Guide utilisateur du WorkbenchVersion 3.3

101

Analyseur de codeVous pouvez utiliser l'Analyseur de code du Workbench pour analyser le code de programmesexistants rédigés en langage SAS.

L'Analyseur de code est un dispositif du Workbench et ne peut donc être utilisé que sur les plates-formes compatibles. Il génère des rapports indiquant lesquels de vos programmes n'ont pas besoin demodifications pour être exécutés dans WPS, quels programmes nécessitent des modifications, et quelsprogrammes contiennent les éléments de langage pas encore pris en charge par WPS.

L'Analyseur de code vous permet d'effectuer les opérations suivantes :

• Analyser la compatibilité des programmes – détermine si vos programmes ou projets existantscontiennent des éléments de langage non pris en charge.

• Analyser l'utilisation du langage – dresse la liste des éléments de langage contenus dans lesprogrammes ou projets sélectionnés. L'analyse indique quels éléments sont pris en charge, etlesquels ne le sont pas.

Exécution des analysesL'Analyseur de code permet d'analyser rapidement un programme, ou encore tous les programmescontenus dans différents projets (à l'aide de la vue Explorateur de projets) ou dossiers (avec la vueExplorateur de fichiers).

Il peut analyser ensemble des programmes qui sont normalement exécutés sur diverses plates-formes.Rassemblez les programmes depuis ces autres environnements, copiez-les sur votre poste de travail etexécutez les outils d'analyse depuis le Workbench.

Analyser la compatibilité des programmesVous pouvez analyser un ou des programmes pour identifier les éléments de langage pris en chargepar WPS.

Pour analyser les programmes en langage SAS :

1. Sélectionnez les fichiers à analyser :

• Sélectionnez le ou les fichiers à analyser dans la vue Explorateur de projets ou Explorateur defichiers. Vous pouvez sélectionner des programmes dans différents projets ou dossiers au seind'une même vue.

• Sélectionnez un ou des projets dans la vue Explorateur de projets pour analyser tous lesprogrammes qu'ils contiennent.

• Sélectionnez un ou des dossiers dans la vue Explorateur de fichiers pour analyser tous lesprogrammes qu'ils contiennent.

Guide utilisateur du WorkbenchVersion 3.3

102

2. Dans la vue correspondant à votre sélection, cliquez avec le bouton droit sur les éléments,choisissez Analyser dans le menu contextuel, puis cliquez sur Compatibilité.

Une fois l'analyse terminée, la vue Rapport sur la compatibilité des programmes s'ouvreautomatiquement dans le Workbench.

Ce rapport contient des informations détaillées sur les éléments de langage non pris en charge utilisésdans les programmes. Il ne signale pas les éléments de langage pris en charge.

Analyser l'utilisation du langageVous pouvez analyser un ou des programmes pour identifier les éléments de langage pris en chargeutilisés par un ou plusieurs programmes.

Pour analyser les programmes en langage SAS :

1. Sélectionnez les fichiers à analyser :

• Sélectionnez le ou les fichiers à analyser dans la vue Explorateur de projets ou Explorateur defichiers. Vous pouvez sélectionner des programmes dans différents projets ou dossiers au seind'une même vue.

• Sélectionnez un ou des projets dans la vue Explorateur de projets pour analyser tous lesprogrammes qu'ils contiennent.

• Sélectionnez un ou des dossiers dans la vue Explorateur de fichiers pour analyser tous lesprogrammes qu'ils contiennent.

Guide utilisateur du WorkbenchVersion 3.3

103

2. Dans la vue correspondant à votre sélection, cliquez avec le bouton droit sur les éléments,choisissez Analyser dans le menu contextuel, puis cliquez sur Rapport d'utilisation du langage.

Une fois l'analyse terminée, la vue Rapport d'utilisation du langage s'ouvre automatiquement dans leWorkbench.

Ce rapport détaille les éléments du langage SAS utilisés dans les programmes sélectionnés. Vouspouvez l'étudier de manière plus approfondie dans le Workbench, ou exporter son contenu versMicrosoft Excel.

Analyser les programmes provenant d'unmainframeL'Analyseur de code est un dispositif du Workbench et ne peut donc être utilisé que sur lesplates-formes compatibles. Pour analyser des programmes conçus pour un mainframe, copiez-les du mainframe au poste de travail où le Workbench est installé. Lors de l'analyse de cesprogrammesl'Analyseur de code identifie les éléments de langage spécifiques à la plate-forme z/OS.

Avant d'analyser les programmes copiés du mainframe au poste de travail :

• Supprimez les numéros de séquence de vos jobs.• Vérifiez que chaque fichier programme reçoit comporte une extension .sas.• Sur le mainframe, utilisez XMIT pour créer un package contenant les jobs.

Guide utilisateur du WorkbenchVersion 3.3

104

• Une fois l'archive transférée au poste de travail, utilisez XMIT Manager pour décompresser lesfichiers et les analyser.

Remarque :XMIT Manager ne permet de traiter que les PDS (Partitioned Datasets), pas les PDSE (ExtendedPartitioned Datasets).

Pour télécharger les fichiers XMIT du mainframe au poste de travail, utilisez le paramètre FB (FixedBlock) avec une valeur LRECL (Logical Record Length) de 80 et sans conversion ASCII/EBCIDIC,troncation ou conversion CRLF.

Parcourir ou exporter un rapport d'analyseVous pouvez consulter les détails d'un rapport de l'Analyseur de code dans le Workbench, ou exporterle rapport pour l'étudier en détail dans Microsoft Excel.

Lorsque vous consultez un rapport dans le Workbench, il permet d'accéder à des informations plusdétaillées, jusqu'au programme source où se situe le problème.

• Le résumé du rapport de compatibilité propose des liens vers la liste des programmes analysés.Dans cette liste, vous pouvez accéder à la liste des éléments problématiques, voir où ils se situentdans un programme, et accéder à l'emplacement de l'élément dans le fichier.

• Le rapport d'utilisation du langage présente tous les éléments de langage utilisés dans lesprogrammes analysés. Dans cette liste, vous pouvez voir la fréquence d'utilisation des diverséléments de langage, savoir dans quels programmes ils sont utilisés, et accéder à l'emplacementd'un élément dans le fichier.

Exporter les résultats d'une analyse vers Microsoft ExcelLes résultats d'un rapport de compatibilité peuvent être exportés vers une feuille de calcul MicrosoftExcel pour une analyse plus approfondie ou pour conserver les informations. Pour exporter un rapport :

1. Dans la vue de résumé du rapport, cliquez sur Exporter les résultats vers Excel.2. Dans la fenêtre Enregistrer sous, entrez un nom de fichier et utilisez le bouton Parcourir pour

accéder à l'emplacement souhaité avant d'enregistrer.

Limites de l'analyseEn raison de la nature du langage SAS, il est impossible de garantir le résultat de l'analyse. Il convientdonc de traiter les résultats comme un guide pour une analyse plus approfondie.

Les limites de l'Analyseur de code sont les suivantes :

• L'Analyseur de code ne signale pas les erreurs de syntaxe.

Guide utilisateur du WorkbenchVersion 3.3

105

• Tout élément de langage SAS non pris en charge dans WPS est signalé comme inconnu dans lerapport de compatibilité.

• Les rapports d'analyse ne contiennent actuellement pas d'informations sur l'utilisation des élémentsde langage concernant les macros et les moteurs de bibliothèque, bien que vous puissiez les utiliserdans WPS.

Guide utilisateur du WorkbenchVersion 3.3

106

Travailler avec les éditeursDans toutes les perspectives, fournies avec le Workbench ou personnalisées, la fenêtre Éditeur esttoujours affichée, afin de vous permettre de continuer à rédiger et modifier des fichiers. Dans cettesection du guide, nous allons examiner de plus près les diverses façons d'ouvrir les fichiers dans cettevue à l'aide des différents éditeurs disponibles.

Remarque :Un seul fichier peut être actif à la fois. Il s'agit du fichier actif dans la vue Éditeur.

Vous pouvez ouvrir les programmes à l'aide de la vue Explorateur de projets ou Explorateur defichiers. La vue Explorateur de projets offre plus de contrôle que la vue Explorateur de fichiers, quidétermine automatiquement l'éditeur qui convient le mieux en fonction de l'extension du fichier en coursd'ouverture.

Modifier des projets dans la vue Projets vous permet d'utiliser la fonction Historique local pourgérer les modifications, ainsi que les outils de navigation et d'édition décrits à la section Fonctionnalitésd'édition en mode texte.

Éditeur SASLa vue Éditeur SAS offre des fonctionnalités d'édition des programmes écrits en langage SAS, tellesque la coloration syntaxique des éléments de langage. Cet éditeur ne peut ouvrir que les fichiersportant l'extension .wps ou .sas.

Les programmes peuvent être ouverts depuis un projet, ou directement depuis un des systèmesde fichiers accessibles. Les programmes ouverts à partir d'un projet bénéficient de fonctionnalitéssupplémentaires du Workbench, telles que l'historique local.

Pour ouvrir un programme dans la vue Éditeur SAS :

1. Si votre programme appartient à un projet, ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur de projets).

2. Accédez au programme à ouvrir.3. Vous pouvez soit double-cliquer sur le programme à ouvrir, soit cliquer dessus avec le bouton

droit et sélectionner Ouvrir avec ➤  Éditeur SAS dans le menu contextuel.

Remarque :Si votre programme n'appartient pas à un projet, vous pouvez faire glisser un fichier dans leWorkbench depuis l'explorateur du système de fichiers, ou depuis d'autres outils externes. Vouspouvez également utiliser l'option de menu Fichier ➤  Ouvrir un fichier.

Guide utilisateur du WorkbenchVersion 3.3

107

Le programme s'ouvre dans la vue Éditeur SAS. Les fonctionnalités d'assistance à la programmationdécrites à la section Fonctionnalités d'édition en mode texte sont disponibles.

Éditeur de texteLe Workbench comprend un éditeur de texte de base.

Remarque :Vous pouvez ouvrir un programme en utilisant cet éditeur, mais le contenu est traité comme du textenormal – aucune fonctionnalité de coloration syntaxique n'est disponible, par exemple.

Pour ouvrir un fichier dans l'éditeur de texte :

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets).

2. Accédez au fichier à ouvrir.3. Si le fichier est un fichier texte, il suffit de double-cliquer dessus. Sinon, cliquez sur le fichier avec le

bouton droit et sélectionnez Ouvrir avec ➤  Éditeur de texte dans le menu contextuel.

Le fichier s'ouvre dans la vue Éditeur de texte. La plupart des fonctionnalités d'assistance à laprogrammation décrites à la section Fonctionnalités d'édition en mode texte sont disponibles.

Éditeur systèmeSi l'extension du fichier est associée à une application déjà installée sur votre ordinateur (.doc, parexemple, qui peut être associé à Microsoft Word dans la base de registre), l'Éditeur système ouvre lefichier dans cette application, dans une nouvelle fenêtre à l'extérieur du Workbench.

Pour ouvrir un fichier avec l'éditeur système :

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets).

2. Accédez au fichier à ouvrir.3. S'il est associé à une application, double-cliquez sur le fichier ou cliquez dessus avec le bouton droit

et sélectionnez Ouvrir avec ➤  Éditeur système dans le menu contextuel.

Remarque :Si vous souhaitez ouvrir le fichier avec une application autre que celle associée par défaut,sélectionnez Ouvrir avec ➤ Autre et choisissez un éditeur interne ou un programme externe dans laboîte de dialogue qui s'affiche.

Le fichier est ouvert dans une nouvelle fenêtre à l'extérieur du Workbench, dans l'application associée.

Guide utilisateur du WorkbenchVersion 3.3

108

Éditeur intégréLe Workbench prend en charge les éditeurs de documents OLE (Object Linking and Embedding). Parexemple, si vous avez un document Microsoft Word dans votre projet et que vous utilisez l'éditeurintégré, le document Word est ouvert dans la vue Éditeur du Workbench, et les options de menu deMicrosoft Word sont intégrées dans la barre de menu de la vue.

Pour ouvrir un fichier avec l'éditeur intégré :

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets).

2. Utilisez l'Explorateur de projets pour accéder au fichier à ouvrir.3. Cliquez sur le fichier avec le bouton droit et sélectionnez Ouvrir avec ➤  Éditeur en place dans

le menu contextuel.

Si un éditeur OLE est associé au fichier sélectionné, le programme s'ouvre dans l'éditeur intégré dansla vue Éditeur. Les menus et options associés à l'application liée sont disponibles.

Éditeur par défautLorsque vous double-cliquez simplement sur un fichier au lieu de sélectionner une option dans le menucontextuel, le Workbench ouvre le fichier à l'aide du dernier éditeur utilisé pour ouvrir ce type de fichierou, dans le cas d'un nouveau type de fichier, l'application associée.

Remarque :Si vous souhaitez ouvrir un fichier avec une application autre que celle associée par défaut,sélectionnez Ouvrir avec ➤ Autre et choisissez un éditeur interne ou un programme externe dans laboîte de dialogue qui s'affiche.

Pour ouvrir un fichier avec l'éditeur par défaut :

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets).

2. Accédez au fichier à ouvrir.3. Double-cliquez sur le fichier ou cliquez dessus avec le bouton droit et sélectionnez Ouvrir

avec ➤ Éditeur par défaut dans le menu contextuel.

Le fichier est ouvert à l'aide du dernier éditeur utilisé ou, à défaut, à l'aide de l'application associée,dans une nouvelle fenêtre à l'extérieur du Workbench.

Guide utilisateur du WorkbenchVersion 3.3

109

Préférences concernant l'éditeur detexteSous Fenêtre ➤ Préférences ➤ Généralités ➤ Éditeurs ➤ Éditeurs de texte, vous pouvez déterminercomment les programmes sont affichés dans la vue Éditeur SAS et les fichiers dans la vue Éditeur detexte. Par exemple, si vous voulez modifier la couleur d'arrière-plan, allez au panneau Options descouleurs d'affichage de la boîte de dialogue Éditeurs de texte, sélectionnez Couleur de l'arrière-plan, désélectionnez la case à cocher Valeur système par défaut, puis choisissez la couleur voulue àl'aide du champ Couleur.

Remarque :Ces Préférences ne s'appliquent qu'aux fichiers ouverts depuis la vue Explorateur de projets.

Parmi les options qu'il est possible de modifier :

• Nombre d'opérations pouvant être annulées (c'est-à-dire, la taille de la mémoire tampon« annulation » en termes de nombre d'opérations)

• Largeur de la tabulation affichée• Afficher les numéros de ligne• Couleurs (ligne en cours, premier plan, arrière-plan, etc.)

Remarque :Les couleurs utilisées pour afficher les éléments de langage dans la vue Éditeur SAS peuvent êtredéfinies dans la section Coloration de la syntaxe de la boîte de dialogue Préférences (voir la sectionColoration syntaxique dans WPS).

Fermer un fichierTout fichier ouvert dans la vue Éditeur dispose d'un onglet indiquant son nom. Pour cesser d'afficher lefichier dans l'Éditeur, effectuez l'une des opérations suivantes :

• Placez le pointeur de la souris sur l'onglet et sélectionnez Fermer (à droite du nom).

• Cliquez avec le bouton droit sur l'onglet et sélectionnez l'option Fermer.• Sélectionnez Fichier ➤ Fermer.

Remarque :Pour fermer tous les fichiers ouverts à la fois, sélectionnez Fichier ➤  Fermer tout.

Guide utilisateur du WorkbenchVersion 3.3

110

Fonctionnalités d'édition enmode texteVous pouvez utiliser les fonctionnalités décrites ci-dessous dans la vue Éditeur SAS pour vous aider àrédiger et modifier les programmes et autres fichiers de projet dans la vue Éditeur.

Remarque :Les mêmes fonctionnalités sont disponibles dans la vue Éditeur de texte, à l'exception de la colorationsyntaxique des éléments de langage. Les fonctionnalités décrites ne sont pas disponibles lorsquevous gérez les fichiers depuis la vue Explorateur de fichiers.

Bordures à gaucheLes bordures à gauche de la vue Éditeur sont utilisées pour afficher diverses fonctionnalités.

• La bordure grise, à l'extérieur, présente les annotations.• La bordure blanche, à l'intérieur, présente des commandes permettant de  développer et de

 réduire les blocs des éléments de langage connexes. La bordure blanche est aussi utilisée pourafficher les indicateurs de différence rapides.

AnnotationsLes annotations affichées dans la bordure extérieure grise d'un fichier peuvent être les suivantes :

• Signets

• Marqueurs de tâche

• Résultats de recherche

Indicateurs de différence rapidesUn indicateur de différence rapide, situé dans la bordure intérieure blanche du programme, indique quequelque chose a changé dans cette ligne de code depuis le dernier enregistrement :

• Indique qu'une modification a été apportée à la ligne de code.

Remarque :Si vous survolez ce bloc coloré avec la souris, une fenêtre contextuelle affiche le code tel qu'il étaitavant la modification.

• Indique qu'une nouvelle ligne a été ajoutée au code.• Indique qu'une ou des lignes de code ont été supprimées.

Guide utilisateur du WorkbenchVersion 3.3

111

Remarque :Lorsque vous enregistrez un programme, les indicateurs de différence rapides disparaissent de lamarge.

Naviguer entre les annotations et les indicateurs de différencerapidesVous pouvez naviguer entre les annotations dans un programme individuel qui est ouvert en utilisantles options du menu Navigation ➤  Suivant et Navigation ➤  Précédent (ou bien appuyez,respectivement, sur les touches CTRL + . et CTRL + , de votre clavier).

Outre l'utilisation des options de menu et des raccourcis clavier, vous pouvez utiliser les boutons Suivant et  Précédent de la barre d'outils principale du Workbench.

Remarque :Même si les éléments de menu Suivant et Précédent semblent indiquer que cette fonctionnalitéest réservée aux annotations, vous pouvez en fait utiliser ces commandes pour naviguer entre lesannotations et les indicateurs de différence rapides dans n'importe quel programme individuel ouvertdans la vue Éditeur. À droite de chaque bouton d'annotation Suivant et Précédent de la barred'outils principale, une flèche vers le bas donne accès aux menus déroulants. Vous pouvez utiliserces menus pour sélectionner les marqueurs et indicateurs entre lesquels vous souhaitez naviguer.

Préférences de mise en pageLes contrôles d'affichage pour un programme, y compris la ligne en cours, les couleurs de premierplan et d'arrière-plan, et l'affichage ou non des numéros de ligne peuvent être personnalisés. Pour plusd'informations, voir la section Préférences concernant l'éditeur de texte.

Coloration syntaxique des éléments de langageLes couleurs utilisées pour afficher les éléments de langage dans un programme peuvent êtredéfinies dans la boîte de dialogue Préférences à l'aide des options de coloration syntaxique de WPS.

SignetsUn signet est un point d'ancrage que vous pouvez spécifier afin d'accéder rapidement à un point duprogramme par la suite.

Remarque :Il n'est pas possible de créer des signets dans les fichiers ouverts depuis la vue Explorateur de fichiers,sauf s'ils sont membres d'un projet. En effet, les fichiers ouverts de cette façon peuvent se situern'importe où dans le système de fichiers de l'hôte local ou distant, alors qu'il n'est possible de définirdes signets que dans les fichiers membres d'un projet de l'espace de travail.

Guide utilisateur du WorkbenchVersion 3.3

112

Il n'y a aucune limite au nombre de signets que vous pouvez créer. Sélectionnez Éditer ➤ Ajoutersignet dans le menu principal pour ajouter un signet soit à une ligne donnée d'un programme, soit àun fichier de programme figurant dans la vue Explorateur de projets. Pour appliquer un signet à uneligne dans un fichier de programme, vous pouvez également sélectionner Ajouter un signet dans lemenu contextuel affiché en cliquant avec le bouton droit sur la marge en regard de la ligne.

Vous pouvez ensuite répertorier et parcourir tous vos signets à l'aide de la vue Signets(Fenêtre ➤ Afficher la vue ➤  Signets).

Pour plus d'informations sur la navigation entre les signets, voir la section Accéder à un emplacementprécis du projet.

Remarque :Si vous exportez un projet, les signets ne sont pas exportés.

Ajouter un signetPour ajouter un nouveau signet sur une ligne donnée dans un fichier de projet :

1. Ouvrez le programme ou le fichier dans la vue Éditeur.

2. Déplacez votre curseur dans la bordure grise située à gauche de la ligne que vous souhaitezmarquer :

3. Vous pouvez soit sélectionner Éditer ➤ Ajouter signet, soit cliquer avec le bouton droit etsélectionner Ajouter signet dans le menu contextuel.

4. La boîte de dialogue Afficher signet s'affiche, et vous êtes invité à saisir un nom pour référenceultérieure.

Guide utilisateur du WorkbenchVersion 3.3

113

Par défaut, le nom est le contenu de la ligne sélectionnée.5. Vous pouvez soit appuyer sur la touche Entrée du clavier, soit cliquer sur OK pour terminer

l'opération et fermer la boîte de dialogue.

Un marqueur de signet s'affiche dans la bordure, et une entrée correspondante dans lavue Signets (si elle est ouverte). Vous pouvez utiliser cette vue pour accéder directement à unemplacement donné d'un projet.

Remarque :Vous pouvez ajouter un signet à un fichier entier en sélectionnant ce dernier dans la vue

 Explorateur de projets, puis en sélectionnant Éditer ➤ Ajouter signet dans le menu.

Supprimer un signetPour supprimer un signet :

1. Ouvrez la vue Signets ( Fenêtre ➤  Afficher la vue ➤  Signets).

2. Cliquez avec le bouton droit sur la description du signet et sélectionnez Supprimer dans lemenu contextuel.

3. Cliquez sur Oui pour confirmer la suppression.

Marqueurs de tâcheUn marqueur de tâche représente un rappel concernant un élément de travail.

Pour toute ligne de programme, vous pouvez ajouter une tâche et lui associer une courte description etun niveau de priorité : élevé, normal ou faible. Il n'y a aucune limite quant au nombre de marqueurs detâche que vous pouvez ajouter dans un programme.

Remarque :Il n'est pas possible de créer les tâches dans les programmes ouverts depuis la vue Explorateur defichiers, sauf s'ils sont membres d'un projet. En effet, les programmes ouverts de cette façonpeuvent se situer n'importe où dans le système de fichiers d'un hôte local ou distant, alors qu'il n'estpossible de définir des tâches que dans les fichiers membres d'un projet de l'espace de travail.

Vous pouvez ensuite répertorier et parcourir toutes vos tâches à l'aide de la vue Tâches(Fenêtre ➤ Afficher la vue ➤  Tâches).

Pour plus d'informations sur la navigation entre les tâches, voir la section Accéder à un emplacementprécis du projet.

Guide utilisateur du WorkbenchVersion 3.3

114

Remarque :Si vous exportez un projet, les tâches ne sont pas exportées.

Ajouter une tâchePour ajouter un marqueur de tâche à une ligne donnée d'un programme :

1. Ouvrez le programme ou le fichier dans la vue Éditeur.

2. Déplacez votre curseur dans la bordure grise située à gauche de la ligne que vous souhaitezmarquer :

3. Cliquez avec le bouton droit sur la marge grise en regard la ligne et sélectionnez Ajouter tâche.4. La boîte de dialogue Propriétés s'affiche, et vous êtes invité à saisir un nom pour référence

ultérieure.

Par défaut, la description est le contenu de la ligne sélectionnée.5. Sélectionnez le niveau de priorité (Haute, Normale ou Basse).6. Cliquez sur OK pour terminer l'opération et fermer la boîte de dialogue.

Un marqueur de tâche s'affiche dans la bordure, et une entrée correspondante dans la vueTâches (si elle est ouverte).

Guide utilisateur du WorkbenchVersion 3.3

115

Supprimer une tâchePour supprimer une tâche :

1. Ouvrez la vue Tâches (Fenêtre ➤  Afficher la vue ➤  Tâches).

2. Cliquez avec le bouton droit sur la description de la tâche et sélectionnez Supprimer dans lemenu contextuel.

3. Cliquez sur Oui pour confirmer la suppression.

Accéder à un emplacement précis duprojetVous pouvez accéder directement à un emplacement précis dans un fichier du projet :

Pour accéder directement à un emplacement marqué par un signet :

1. Ouvrez la vue Signets ( Fenêtre ➤  Afficher la vue ➤  Signets).

2. Vous pouvez soit double-cliquer sur la description de signet requise, soit cliquer dessus avec lebouton droit et sélectionner Aller à dans le menu contextuel.

3. Le fichier correspondant s'ouvre (s'il était fermé), et la ligne du signet est affichée en surbrillance. Sile signet a été appliqué au fichier entier, la première ligne est mise en surbrillance.

Pour accéder directement à une tâche :

1. Ouvrez la vue Tâches (Fenêtre ➤  Afficher la vue ➤  Tâches).

2. Vous pouvez soit double-cliquer sur la description de tâche requise, soit cliquer dessus avec lebouton droit et sélectionner Aller à dans le menu contextuel.

3. Le fichier correspondant s'ouvre (s'il était fermé), et la ligne contenant la tâche est affichée ensurbrillance.

Pour accéder directement à un numéro de liste précis :

1. Sélectionnez Naviguer ➤  Aller à la ligne.

2. Saisissez le numéro requis dans la boîte de dialogue Aller à la ligne.3. Vous pouvez soit appuyer sur la touche Entrée du clavier, soit cliquer sur OK pour terminer

l'opération et fermer la boîte de dialogue.

Pour accéder directement à la dernière modification :

1. Sélectionnez Emplacement de la dernière édition soit sur la barre d'outils, soit dans le menuNavigation.

Le fichier pertinent s'ouvre (s'il était fermé) ; la dernière ligne modifiée est affichée en surbrillance, etle curseur est placé à la fin du dernier segment modifié.

Guide utilisateur du WorkbenchVersion 3.3

116

Naviguer entre les fichiers d'un projetVous pouvez avoir autant de projets ouverts que vous souhaitez dans le Workbench, et chacun de cesprojets peut contenir un nombre infini de programmes.

Vous pouvez ouvrir autant de programmes et autres fichiers que vous le souhaitez depuis les différentsprojets dans la vue Éditeur. Pour chaque programme ouvert, un onglet correspondant est affiché.Pour mettre en évidence un programme ouvert dans la fenêtre Éditeur, cliquez sur son onglet.

Passer au programme précédent ou suivantLes options principales Navigation ➤  Précédent et Navigation ➤  Suivant (ou les boutons et de la barre d'outils) sont semblables aux boutons « Précédent » et « Suivant » d'un navigateurWeb. Cependant, contrairement à un navigateur Web, WPS Workbench conserve les informations denavigation même après la fermeture.

• Précédent accède à la ressource précédente qui a été vue dans la fenêtre Éditeur.

• Suivant affiche le programme qui était actif avant la sélection de la commande Précédent.

Rechercher et remplacerVous pouvez rechercher une chaîne de caractères dans un programme ouvert comme suit :

1. Ouvrez le programme dans la vue Explorateur de fichiers ( Fenêtre ➤  Afficher la vue ➤  Explorateur de fichiers).

2. Affichez la boîte de dialogue Rechercher/Remplacer soit en sélectionnant Éditer ➤ Rechercher/Remplacer dans le menu, soit en appuyant sur les touches CTRL + F de votre clavier.

La boîte de dialogue Rechercher/Remplacer s'affiche. Elle vous permet de spécifier le terme àrechercher et, le cas échéant, le terme par lequel le remplacer.

Remarque :La valeur par défaut de Portée est Tous, ce qui signifie que la recherche s'effectue sur l'ensembledu fichier (vous pouvez choisir Lignes sélectionnées pour restreindre la recherche, le caséchéant). Les autres options sont celles qui se trouvent dans toute boîte de dialogue de recherche,et ne nécessitent pas d'explication.

3. Cliquez sur Rechercher pour rechercher la première instance du mot, puis continuez si besoin est,en cliquant sur Rechercher pour passer à l'instance suivante de la chaîne de caractères.

Guide utilisateur du WorkbenchVersion 3.3

117

Remarque :Si vous sélectionnez Fermer et fermez la boîte de dialogue, la chaîne de caractères est conservéeen mémoire. Si vous sélectionnez Éditer ➤ Rechercher l'élément suivant et Éditer ➤ Rechercherl'élément précédent effectuent la même recherche, respectivement vers la fin ou le début duprogramme, sans rouvrir la boîte de dialogue.

Annuler et rétablir les modificationsIl est possible d'annuler plusieurs modifications apportées aux fichiers de projet :

1. Vous pouvez soit sélectionner Éditer ➤  Annuler dans le menu, soit appuyer sur les touchesCTRL + Z sur votre clavier.

La dernière modification effectuée est annulée.2. Répétez l'opération pour chaque modification antérieure que vous souhaitez annuler.

Remarque :Le nombre d'annulations qu'il est possible d'effectuer est déterminé dans le cadre des préférencesconcernant les éditeurs de texte (voir Taille de l'historique d'annulation dans la sectionPréférences concernant l'éditeur de texte).

Remarque :Vous pouvez également rétablir les modifications annulées, soit en sélectionnant Éditer ➤ 

 Rétablir dans le menu, soit en appuyant sur les touches CTRL + Y du clavier autant de fois quenécessaire.

Guide utilisateur du WorkbenchVersion 3.3

118

BibliothèquesUne bibliothèque est utilisée pour stocker les fichiers de données WPS, y compris les ensembles dedonnées. Elle représente également l'emplacement du dossier d'une connexion de base de donnéesdéfinie par l'instruction LIBNAME.

Sur la plupart des systèmes d'exploitation, la bibliothèque correspond directement à un dossier dusystème d'exploitation. Ce dossier peut contenir des fichiers non WPS, mais seuls les fichiers dontl'extension est reconnue par WPS sont visibles dans le Workbench.

Les bibliothèques par défaut définies sous chaque serveur dans la vue Explorateur de serveursWPS sont les suivantes :

• SASHELP, une bibliothèque en lecture seule contenant diverses métadonnées système.• SASUSER, qui vous permet de stocker des ensembles de données et autres informations que

vous pouvez conserver après votre session WPS. Il suffit d'ajouter sasuser. devant le nom del'ensemble de données dans votre programme.

• Work, où vos ensembles de données, vos catalogues et vos filerefs, ou références de fichiers,sont stockés par défaut. Work est un espace de travail temporaire, automatiquement vidé detoutes les données qui y sont stockées à la fin de chaque session WPS. Il est généralementspécifié par la définition Work dans le fichier wps.cfg dans la racine de votre installation de WPS.Habituellement, sa valeur est -WORK '!TEMP\WPS Temporary Data', où TEMP est une variabled'environnement Windows représentant un chemin d'accès sur le lecteur C:.

Au lieu de modifier le fichier wps.cfg, vous pouvez soit configurer Work pour qu'il s'agisse d'unemplacement non temporaire, comme décrit à la section Emplacement de la bibliothèque WORK,soit utiliser l'instruction LIBNAME pour écrire toutes les données que vous souhaitez conserverdans un emplacement permanent de votre choix (répertoire ou connexion de base de données).L'instruction LIBNAME attribue un alias à l'emplacement spécifique, qui est ensuite utilisé dans lesprogrammes au lieu du nom du répertoire ou de la connexion de base de données.

Remarque :La longueur maximale d'un alias LIBNAME est de 8 caractères.

Une fois qu'un ensemble de données a été stocké à l'emplacement choisi, l'alias associé doit êtreutilisé pour extraire l'ensemble de données. Sans l'alias, WPS rechercherait l'ensemble de donnéesdans le répertoire par défaut Work. L'instruction LIBNAME attribue l'alias mylib au répertoirepartagé /mydirectory/ :

LIBNAME mylib '/directories/mydirectory/';

Guide utilisateur du WorkbenchVersion 3.3

119

Remarque :Vous ne pouvez associer un répertoire ou une connexion de base de données à l'alias que s'ilsexistent déjà. Pour des informations détaillées sur l'élément de langage libname, voir le guideWPS Reference For Language Elements. La configuration des noms de bibliothèque (LIBNAME)communs peut être réalisée à l'aide d'un fichier Fichier AutoExec. Il n'est alors plus nécessaire deles ajouter à chaque programme exécuté.

Au lieu d'utiliser l'instruction LIBNAME, vous pouvez également créer une bibliothèque, soit ensélectionnant Nouvelle bibliothèque de données WPS dans le sous-menu de l'icône  Nouveauen haut à gauche de la fenêtre du Workbench, ou en cliquant avec le bouton droit sur Bibliothèquesdans la vue Explorateur de serveurs WPS, puis en sélectionnant Nouveau ➤   Bibliothèque.

Emplacement de la bibliothèque WORKProcédez comme suit pour définir le nom du chemin d'accès de l'emplacement Work, qui est utiliséchaque fois que vous démarrez un serveur donné :

1. Dans la vue Explorateur de serveurs WPS, Explorateur de liens, Explorateur de sorties ouExplorateur de résultats, vérifiez que le serveur est en cours d'exécution.

2. Cliquez avec le bouton droit sur le serveur et sélectionnez Propriétés dans le menu contextuel.3. Dans le menu situé dans la partie gauche de la boîte de dialogue Propriétés, sélectionnez

Démarrage ➤ Options du système.

4. Dans la partie droite de la fenêtre, cliquez sur Ajouter pour afficher la boîte de dialogue Option dedémarrage.

5. Cliquez sur le bouton Sélectionner pour afficher la liste des options disponibles dans une fenêtreSélectionner l'option de démarrage.

6. Dans la liste, trouvez l'option Work et double-cliquez dessus. La boîte de dialogue Option dedémarrage affiche votre sélection.

7. Dans le champ Valeur, saisissez le chemin d'accès complet du dossier Work, puis cliquez sur OK.L'option Work et la valeur associée figurent maintenant dans le volet Options de démarrage dusystème de la boîte de dialogue Propriétés.

8. Cliquez sur OK dans la boîte de dialogue Propriétés. Un message vous invite à redémarrer leserveur pour appliquer les modifications.

Remarque :Toute option Work définie dans des fichiers de configuration externes sera ignorée. Vous devez définirWork comme une option de démarrage du Workbench, comme indiqué ci-dessus, pour qu'il soitpossible de l'utiliser depuis l'interface graphique. Lorsque vous utilisez le mode WPS en mode ligne decommande pour exécuter des programmes en mode batch, l'option de démarrage n'est pas prise encompte, et l'option Work définie dans le fichier de configuration externe est utilisée à sa place.

Guide utilisateur du WorkbenchVersion 3.3

120

CataloguesUn catalogue est un fichier dans lequel vous pouvez stocker divers types d'informations (entrées decatalogue), tels que des formats, des informats, des macros et des sorties graphiques.

Par exemple, vous pouvez écrire un programme qui génère un catalogue (FORMATS) où stocker lesformats PICTURE, et un autre (SASMCR) où stocker les macros en langage SAS :

proc format;

PICTURE beau 0-HIGH = '00 000 000.09' ; PICTURE beaul 0-HIGH = '00 000 000.09' ; run; proc catalog catalog = work.FORMATS; contents; run;

%macro setscalingfactor; %let SCALE=%sysget(SCALE); %if %length(&SCALE.)=0 %then %let SCALE=2;%mend setscalingfactor;

%macro test;%mend;

proc catalog catalog = work.SASMACR;contents;run;

Remarque :FORMATS et SASMCR sont intégrés dans le produit pour le stockage des formats et des macroscompilées. Bien que ces catalogues soient générés par défaut dans la bibliothèque Work, vous pouvezutiliser l'instruction LIBNAME pour écrire tous les catalogues que vous souhaitez conserver dansun répertoire permanent de votre choix. L'instruction PICTURE vous permet de créer des modèlespour l'impression de nombres en définissant un format qui permet la représentation de caractèresspéciaux tels que les zéros non significatifs, les séparateurs décimaux et de milliers, les caractèresde remplissage, les préfixes et la représentation des nombres négatifs. Pour plus de détails sur lesPROC FORMAT et CATALOG et l'instruction PICTURE, consultez le guide WPS Reference For LanguageElements.

Une fois le programme exécuté, les catalogues sont présents dans le dossier Work :

Guide utilisateur du WorkbenchVersion 3.3

121

Pour consulter les entrées associées aux catalogues, cliquez avec le bouton droit sur ces derniers etsélectionnez Propriétés.

Ensembles de donnéesUn ensemble de données est un fichier créé ou importé par un serveur WPS, et stocké dans unebibliothèque (voir la section Bibliothèques). Il contient des lignes et des colonnes, tout comme unetable de base de données. Dans le contexte langage SAS, ces lignes et colonnes sont respectivementappelées observations et variables.

Les observations (lignes) correspondent en général à une entité spécifique (par exemple, unecommande ou une personne).

Les variables (colonnes) décrivent les attributs d'une entité (par exemple, la référence d'un article dansune commande).

Table 1. Exemple d'ensemble de données

ID de la commande Référence de l'article Quantité Prix unitaire

10001 47853 3 30,75

10001 23104 10 4,90

10002 62091 1 89,99

Dans l'exemple ci-dessus, chaque observation correspond à un article d'une commande. Les variablessont ID de la commande, Référence de l'article, Quantité et Prix unitaire.

Importer des ensembles de donnéesLes ensembles de données peuvent être créés en exécutant des programmes, mais aussi enimportant des données de fichiers externes via un serveur WPS. Les formats actuellement pris encharge sont :

Guide utilisateur du WorkbenchVersion 3.3

122

• Valeurs délimitées• Largeur fixe• Feuilles de calcul Microsoft Excel

Important :Vous ne pouvez créer les ensembles de données de cette façon que sur un serveur WPS local.

L'assistant Importation d'ensemble de données permet de configurer l'ensemble de données au filde l'importation. Il n'est pas toujours nécessaire de passer par toutes les étapes de l'assistant. Vouspouvez démarrer l'assistant et, après avoir choisi le fichier à importer, cliquer simplement sur le boutonTerminer pour accepter toutes les valeurs par défaut.

Avertissement :Si vous importez un ensemble de données portant le même nom que celui d'un ensemble existant,vous risquez d'écraser ce dernier. Un message d'avertissement apparaît dans l'assistant pour vouspermettre de modifier le nom de l'ensemble de données que vous êtes en train de créer.

Lors de l'importation d'un fichier à valeurs délimitées, le Workbench essaie de définir automatiquementle délimiteur qui a été utilisé dans ce fichier. Si ce n'est pas le bon délimiteur, vous aurez le choix de lemodifier, permettant l'aperçu de s'actualiser pour afficher l'effet de vos modifications.

Lors de l'importation d'un fichier à largeur fixe, le Workbench essaie de déterminer les points où lescolonnes commencent et s'achèvent dans les données. Vous pouvez modifier ceux-ci comme vous lesouhaitez.

Les fichiers de tableur peuvent regrouper plusieurs feuilles de calcul (contenues dans un classeur). Pardéfaut, le Workbench choisit la première feuille de données pour l'importation. Une feuille peut contenirles noms qui se référent aux plages de cellules. Il est possible d'importer les données à partir de cesnoms, ainsi qu'à partir du presse-papiers.

Il est également possible d'importer les fichiers de feuille de calcul Excel à l'aide d'une des méthodessuivantes.

• Utilisation programmatique des moteurs XLSX ou Excel. Par exemple :

libname xlsxlib XLSX ‘myfile.xlsx’ HEADER=YES; DATA WORK.IMPORTED;Set xlsxlib.Sheet1;Run;

/* The above can be generated by the code below */PROC IMPORT FILE=’myfile.xlsx’ OUT=WORK.IMPORTED DBMS=XLSX;SHEET=Sheet1;Run;

Guide utilisateur du WorkbenchVersion 3.3

123

Ou

libname xlsxlib Excel ‘myfile.xls’ HEADER=YES msengine=ACE; DATA WORK.IMPORTED;Set xlslib.'Sheet1$'n;Run;

/* The above can be generated by the code below */PROC IMPORT FILE=’myfile.xls’ OUT=WORK.IMPORTED DBMS=Excel;SHEET=Sheet1;Run;

Remarque :Vous pouvez également utiliser les suffixes xlsx avec DBMS=Excel.

• Utilisation de l'assistant Importation d'ensemble de données sur les serveurs Windows locaux(voir la section Importer des données à partir de feuilles de calcul). Dans ce cas, votre PC utilise lemoteur Excel (en répliquant le code utilisé dans le second exemple ci-dessus), et il faut alors quele moteur Microsoft ACE OLEDB soit installé sur votre ordinateur pour que ce dernier puisse lireet écrire les fichiers Excel XLSX et XLS.

Remarque :Ce moteur est présent par défaut sur les ordinateurs où est installé Excel. Sinon, vous pouveztélécharger et installer le Microsoft Access Database Engine. Les versions anciennes d'Excel (XLS)sont également prises en charge, et les options Importer/Exporter sont disponibles si le pilote JETest installé. Cependant, si le pilote JET a été installé isolément, vous ne pourrez lire et écrire que lesfichiers au format XLS.

Importer des ensembles de données depuis des fichiersOuvrez la vue Explorateur de serveurs WPS pour réaliser cette tâche.

Pour importer les fichiers :

1. Cliquez avec le bouton droit sur le serveur local et sélectionnez Importer l'ensemble de données.

L'assistant Importation d'ensemble de données démarre.2. Cliquez sur le bouton Modifier à côté du champ de texte Depuis le ficher.3. Accédez au fichier que vous souhaitez importer. Sélectionnez-le et cliquez sur Ouvrir.

Un aperçu de l'ensemble de données résultant est affiché, par exemple :

Guide utilisateur du WorkbenchVersion 3.3

124

4. Assurez-vous que l'option appropriée soit sélectionnée dans le groupe Format des données pour letype de fichier que vous allez importer.

5. Facultatif: Vous pouvez modifier le nom et l'emplacement du nouveau ensemble de données enutilisant les commandes affichées.

• Vous pouvez modifier la bibliothèque dans laquelle vous souhaitez stocker votre nouveauensemble de données en utilisant la liste déroulante Nom de la bibliothèque.

• Vous pouvez modifier le nom par défaut de l'ensemble de données en éditant le contenu duchamp de texte Nom de membre. Si vous utilisez le nom d'un ensemble existant, celui-ci estécrasé par le nouvel ensemble de données.

6. Cliquez sur Suivant pour passer à la page suivante de l'assistant.7. Facultatif: Cette page vous permet de configurer les options spécifiques au type d'importation que

vous effectuez.Format dufichier

Configuration des options

Valeursdélimitées

L'assistant tente de déterminer le délimiteur employé dans le fichier. Vous pouvezremplacer cette information si nécessaire.

Guide utilisateur du WorkbenchVersion 3.3

125

Format dufichier

Configuration des options

Largeur fixe L'assistant tente de déterminer la largeur des colonnes, mais vous pouvez modifierces paramètres si nécessaire. Vous pouvez définir plusieurs colonnes en cliquantdans une zone vide pour diviser cette zone en deux colonnes, ou redéfinir lescolonnes en faisant glisser les séparations existantes entre elles. Si vous faitesglisser les séparations hors de l'aperçu, elles sont supprimées.

Excel Par défaut, l'assistant importe la première page du classeur contenant des données.Le cas échéant, sélectionnez une autre page dans la liste déroulante Feuille decalcul entière. Par ailleurs, vous pouvez sélectionner une Plage nommée dans laliste déroulante et l'utiliser en tant que source de données.

L'aperçu est actualisé afin de refléter les modifications apportées.8. Cliquez sur Utiliser la première ligne comme en-têtes de colonne si vous voyez que la première

ligne du fichier contient des en-têtes de colonne. Examinez l'aperçu pour déterminer cela.9. Cliquez sur Suivant pour passer à la dernière page de l'assistant.

La page Modifier les propriétés de la colonne est affichée.10.Facultatif: Vous pouvez modifier les propriétés des colonnes de l'ensemble de données si vous le

souhaitez.

• Vous pouvez modifier le nom de la colonne en cliquant sur l'en-tête de la colonne dans l'aperçuet éditer le contenu du champ de texte Nom de la colonne.

• Vous pouvez modifier les types de données de la colonne en cliquant sur l'en-tête de la colonnedans l'aperçu et éditer le champ Formats de données de la colonne.

• Vous pouvez modifier le libellé de la colonne en cliquant sur l'en-tête dans l'aperçu et éditer lecontenu du champ de texte Libellé de la colonne.

11.Facultatif: Cliquez sur Suivant pour voir le programme généré qui sera utilisé pour créer l'ensemblede données.

12.Cliquez sur Terminer pour achever la tâche.

Le nouvel ensemble de données est importé dans la bibliothèque spécifiée dans le champ Nom de labibliothèque de la vue Explorateur de serveurs WPS.

Importer des ensembles de données depuis des fichiers parcopier-coller

Ouvrez la vue Explorateur de serveurs WPS pour réaliser cette tâche.

Vous pouvez importer les ensembles de données depuis des fichiers en utilisant la fonction copier-coller, dans la vue Explorateur de projets, Explorateur de fichiers, ou depuis l'extérieur du Workbenchen utilisant votre système d'exploitation.

Pour lancer l'assistant Importation d'ensemble de données en utilisant la fonction copier-coller :

Guide utilisateur du WorkbenchVersion 3.3

126

1. Sélectionnez le fichier que vous désirez importer comme un ensemble de données.2. Cliquez avec le bouton droit de la souris sur le fichier et sélectionnez Copier dans le menu

contextuel, ou utilisez le raccourci clavier (par exemple, Ctrl + C).3. Trouvez la bibliothèque dans laquelle vous souhaitez importer vos données, en utilisant la vue

Explorateur de serveurs WPS.4. Cliquez avec le bouton droit sur la bibliothèque et sélectionnez Coller dans le menu contextuel, ou

utilisez le raccourci clavier (par exemple, Ctrl + V).

La première page de l'assistant Importation d'ensemble de données s'affiche, avec le fichier et labibliothèque choisis au préalable. Vous pouvez ensuite cliquer sur Terminer, ou poursuivre avec lereste de l'assistant pour affiner l'importation.

Voir la section Importer des ensembles de données depuis des fichiers pour en savoir plus l'utilisationde l'assistant.

Importer des ensembles de données à partir de fichiers parglisser-déposer

Ouvrez la vue Explorateur de serveurs WPS pour réaliser cette tâche.

Vous pouvez importer des ensembles de données à partir de fichiers par glisser-déposer, depuis lavue Explorateur de projets ou Explorateur de fichiers, ou depuis l'extérieur du Workbench à l'aide dusystème d'exploitation.

Pour lancer l'assistant Importation d'ensemble de données avec glisser-déposer :

1. Sélectionnez le fichier que vous désirez importer comme ensemble de données.2. Trouvez la bibliothèque dans laquelle vous souhaitez importer vos données dans la vue Explorateur

de serveurs WPS.3. Faites glisser le fichier depuis la source et déposez-le sur la bibliothèque.

La première page de l'assistant Importation d'ensemble de données s'affiche, avec le fichier et labibliothèque choisis au préalable. Vous pouvez ensuite cliquer sur Terminer, ou poursuivre avec lereste de l'assistant pour affiner l'importation.

Voir la section Importer des ensembles de données depuis des fichiers pour en savoir plus l'utilisationde l'assistant.

Importer des données à partir de feuilles de calculSi le moteur Microsoft ACE OLEDB est installé sur votre ordinateur, vous pouvez utiliser l'assistantImportation d'ensemble de données pour importer des plages de cellules directement depuis desfichiers Excel au format XLS ou XLSX.

Guide utilisateur du WorkbenchVersion 3.3

127

Important :Les données importées auront les mêmes valeurs que lors du dernier enregistrement de la feuillede calcul. Si les cellules sont basées sur des formules, ces formules ne seront pas traitées par leWorkbench lorsque la feuille de calcul est ouverte. Les dernières valeurs enregistrées sont utilisées.

Importer des ensembles de données depuis des plages decellules par copier-coller

Ouvrez la vue Explorateur de serveurs WPS pour réaliser cette tâche.

Vous pouvez importer une plage de cellules directement depuis Microsoft Excel dans une bibliothèquedu Workbench en procédant comme suit :

1. Sélectionnez la plage contiguë de cellules à importer dans la feuille de calcul Excel.2. Appuyez sur le raccourci clavier pour Copier (par exemple Ctrl + C).3. Trouvez la bibliothèque dans laquelle vous souhaitez importer les données et sélectionnez-la dans

la vue Explorateur de serveurs WPS.4. Appuyez sur le raccourci clavier pour Coller (par exemple Ctrl + V).

Vous êtes maintenant sur la première page de l'assistant Importation d'ensemble de données,avec le fichier et la bibliothèque choisis au préalable. Vous pouvez ensuite cliquer sur Terminer, oupoursuivre avec le reste de l'assistant pour affiner l'importation.

Si vous cliquez sur Suivant au lieu de Terminer, lorsque vous atteindrez la page Options des feuillesde calcul, vous remarquerez que l'option Contenu du presse-papiers est déjà sélectionnée, et que lenom et la plage de la feuille sont affichés.

Voir la section Importer des ensembles de données depuis des fichiers pour en savoir plus l'utilisationde l'assistant.

Importer des ensembles de données depuis des plages decellules par glisser-déposer

Ouvrez la vue Explorateur de serveurs WPS pour réaliser cette tâche.

Vous pouvez importer une plage de cellules directement depuis Microsoft Excel. Vous pouvez faireglisser cette plage et la déposer sur une bibliothèque pour n'importer que cette plage de données.

1. Sélectionnez une plage contiguë dans la feuille de calcul Excel que vous voulez importer.2. Vérifiez que la bibliothèque dans laquelle vous voulez importer ces cellules est affichée dans la vue

Explorateur de serveurs WPS.3. Faites glisser les cellules et déposez-les sur la bibliothèque.

Guide utilisateur du WorkbenchVersion 3.3

128

Vous êtes maintenant sur la première page de l'assistant Importation d'ensemble de données,avec le fichier et la bibliothèque choisis au préalable. Vous pouvez ensuite cliquer sur Terminer, oupoursuivre avec le reste de l'assistant pour affiner l'importation.

Si vous cliquez sur Suivant au lieu de Terminer, lorsque vous atteindrez la page Options des feuillesde calcul, vous remarquerez que l'option Contenu du presse-papiers est déjà sélectionnée, et que lenom et la plage de la feuille sont affichés.

Voir la section Importer des ensembles de données depuis des fichiers pour en savoir plus l'utilisationde l'assistant.

Ouvrir un ensemble de donnéesVous pouvez ouvrir un ensemble de données comme suit :

1. Ouvrez la vue Explorateur de serveurs WPS ( Fenêtre ➤  Afficher la vue ➤  Explorateur deserveurs WPS).

2. Développez l'arborescence sous le nœud Libraries jusqu'à ce que vous voyez le nœud de l'ensemble de données que vous souhaitez ouvrir.

3. Ouvrez l'ensemble en utilisant l'une des méthodes suivantes :

• Double-cliquez sur l'ensemble de données. Il s'ouvre en mode Navigation.• Cliquez avec le bouton droit sur l'ensemble de données et choisissez Ouvrir (mode

Navigation) ou Modifier.

Procédez comme décrit à la section Utiliser la visionneuse d'ensemble de données.

Utiliser la visionneuse d'ensemble de donnéesLe contenu d'un ensemble de données est présenté sous forme de grille. Les lignes de la grillereprésentent les observations de l'ensemble de données, tandis que les colonnes représentent lesvariables.

Astuce :Vous pouvez afficher des libellés dans les en-têtes de colonne d'un ensemble de données que vousvisionnez dans le Workbench. Pour plus d'informations, voir la section Préférences concernant lavisionneuse d'ensemble de données.

Vous pouvez parcourir, filtrer et trier un ensemble de données dans la visionneuse. Avec certainsensembles de données, vous pouvez aussi modifier les variables de chaque observation (c'est-à-dire,les cellules), et supprimer ou ajouter des observations.

Vous pouvez masquer les colonnes de la grille de données qui ne s'appliquent pas à la tâche, etréorganiser la vue en déplaçant les colonnes. Voir la section Organiser l'ensemble de données.

Guide utilisateur du WorkbenchVersion 3.3

129

ModeUn ensemble de données peut être ouvert soit en mode Navigation (lecture seule) soit en mode Édition.Par défaut, l'ensemble de données est affiché en mode Navigation, sauf spécification contraire. Vouspouvez basculer entre les modes Navigation et Édition en sélectionnant Données ➤  Basculer lemode d'édition – voir la section Modifier un ensemble de données.

Vous ne pouvez ouvrir les ensembles de données WPS (fichier WPD) en mode Modifier que si cetensemble de données n'est ouvert en édition par personne d'autre.

Préférences concernant la visionneuse d'ensemble de données

Sous Fenêtre ➤ Préférences ➤ WPS ➤ Visionneuse d'ensemble de données, vous pouvez activerou désactiver l'option Afficher les libellés pour les noms de colonnes, qui détermine si les libellésdoivent remplacer le nom des colonnes dans un ensemble de données affiché dans le Workbench.

Remarque :Avant d'activer cette option, vous devez avoir défini les libellés des noms de colonne dans vos

 programmes (certains éléments tels que N, MEAN et STD génèrent des libellés par défaut).

Modifier un ensemble de données

Vous pouvez modifier les observations, en ajouter et en supprimer lorsque la grille de données est enmode Édition.

Les commandes de modification de données sont disponibles dans le menu Données du menuprincipal, sur la barre d'outils ainsi que dans le menu contextuel de la grille.

Si l'ensemble de données est ouvert en mode Navigation, vous pouvez basculer en mode Édition encliquant sur le bouton  :

La même option Basculer le mode d'édition est aussi disponible dans la barre d'outils et dans lemenu contextuel de la grille de données :

Guide utilisateur du WorkbenchVersion 3.3

130

Vous pouvez faire autant de changements que vous voulez, sans nécessairement les appliquer : lesmodifications que vous apportez ne sont pas écrites dans les données originales tant qu'elles n'ont pasété enregistrées (en sélectionnant Fichier ➤ Enregistrer dans le menu principal ou Enregistrer menucontextuel de l'ensemble de données. C'est alors seulement que les modifications sont appliquées etles observations supprimées ou ajoutées.

Remarque :Si l'enregistrement des modifications échoue, toutes les modifications qui n'ont pas été écrites restentaffichées dans la grille. Une boîte de dialogue signale l'erreur, expliquant ce qui s'est passé, et lesdétails de la défaillance seront affichés dans le journal du Workbench. Ce journal peut ensuite êtreutilisé pour diagnostiquer le problème.

Modifier les observations

Ouvrez un ensemble de données en mode Modifier pour effectuer cette tâche.

Vous pouvez modifier les variables des observations (c'est-à-dire les cellules) en tant que valeursbrutes. Si un formatage autre que le format par défaut a été appliqué aux variables, ce n'est pas visiblelors du processus de modification. Une fois la modification terminée, la version formatée est affichée.

1. Double-cliquez sur la cellule que vous désirez modifier :

Guide utilisateur du WorkbenchVersion 3.3

131

2. Modifiez la valeur conformément au type de variable :Type de variable DescriptionNumérique La valeur brute s'affiche dans une zone d'édition. Vous pouvez

simplement la remplacer par une nouvelle valeur. Si vous voulezvoir comment la valeur figurant actuellement dans la zoned'édition va s'afficher après le formatage, appuyez sur les touchesMaj + F8 ; elle apparaît alors sous forme d'infobulle.

Remarque :Les valeurs manquantes peuvent être saisies sous forme de texte– voir la section Valeurs manquantes – pour que l'éditeur lespréserve.

Numérique (Date, DateHeureou Heure)

Les valeurs Date, DateHeure et Heure sont modifiées enfonction de leur type. Vous pouvez cliquer sur n'importe quelélément d'une date ou d'une heure (par exemple, l'année ou lesminutes) sur place, et utiliser les touches fléchées du clavier oula molette de la souris pour les augmenter ou réduire incrémentpar incrément. Les éléments numériques peuvent aussi êtreremplacés par de nouvelles valeurs.

Pour un contrôle plus intuitif de la modification, vous pouvezutiliser le contrôle d'édition alternatif associé à chaque type.Les valeurs de date ont un  calendrier, les heures ont un

sélecteur de temps et les valeurs DateHeure ont une combinaison de sélecteurs. Cliquez sur le bouton à droite de

la valeur et l'éditeur approprié s'affiche.

Chaîne de caractères Les valeurs brutes d'une chaîne peuvent être éditées sur place dela même manière que les nombres. Si vous voulez voir commentla valeur figurant actuellement dans la zone d'édition va s'afficheraprès formatage, appuyez sur Maj + F8 ; elle apparaît alors sousforme d'infobulle.

Guide utilisateur du WorkbenchVersion 3.3

132

3. Une fois que vous avez effectué les modifications, vous pouvez soit appuyer sur la touche Entrée,soit cliquer hors de la cellule pour terminer l'édition. Si la valeur saisie est différente de celle quia été enregistrée à l'origine, l'observation est considérée comme modifiée, et s'affiche en tantque telle. Elle est affichée en caractères gras, et un astérisque (*) s'affiche à côté du numéro del'observation dans la marge gauche de la grille.

4. Les modifications apportées n'ont pas encore été enregistrées dans l'ensemble de données. Pourenregistrer les modifications et les renvoyer au serveur, sélectionnez Fichier ➤ Enregistrer dans lemenu principal, ou Enregistrer dans le menu contextuel de l'ensemble de données.

Supprimer des observations

Ouvrez un ensemble de données en mode Modifier pour effectuer cette tâche.

Pour supprimer des observations d'un ensemble de données :

1. Sélectionnez l'observation que vous souhaitez supprimer en cliquant sur son numéro situé dans lacolonne de gauche de la grille. Si vous souhaitez supprimer plusieurs observations, maintenez latouche CTRL enfoncée et cliquez sur le numéro des observations que vous voulez supprimer.

Les observations sélectionnées sont mises en surbrillance.2. Sélectionnez Supprimer les observations dans le menu Données, dans la barre d'outils ou

dans le menu contextuel de la grille de données.

Un message d'avertissement s'affiche, vous permettant de confirmer la suppression ou de l'annuler.3. Cliquez sur Oui pour confirmer la suppression. Les données dans les cellules seront légèrement

barrées, et un caractère moins (-) apparaîtra à côté des numéros de la ligne dans la marge degauche, pour indiquer que les observations sont marquées pour la suppression :

4. Les modifications apportées n'ont pas encore été enregistrées dans l'ensemble de données. Pourenregistrer les modifications et les renvoyer au serveur, sélectionnez Fichier ➤ Enregistrer dans lemenu principal, ou Enregistrer dans le menu contextuel de l'ensemble de données.

Guide utilisateur du WorkbenchVersion 3.3

133

Ajouter des observations

Ouvrez un ensemble de données en mode Modifier pour effectuer cette tâche.

Il est possible d'ajouter de nouvelles observations à un ensemble de données. Elles sont toujoursajoutées à la fin de l'ensemble de données, quelle que soit votre position actuelle. Pour ajouter unenouvelle observation :

1. Sélectionnez Ajouter l'observation, dans le menu Données, dans la barre d'outils, ou dans lemenu contextuel de la grille de données.

2. La nouvelle ligne apparaît en caractères gras, et un caractère plus (+) apparaît en regard du numérode l'observation dans la marge de gauche de la grille, pour indiquer que la ligne vient d'être créée.Vous pouvez maintenant modifier la nouvelle observation et informer les variables si vous souhaitez.

3. Les modifications apportées n'ont pas encore été enregistrées dans l'ensemble de données. Pourenregistrer les modifications et les renvoyer au serveur, sélectionnez Fichier ➤ Enregistrer dans lemenu principal, ou Enregistrer dans le menu contextuel de l'ensemble de données.

Annuler les modifications

Vous pouvez annuler les modifications que vous avez apportées au contenu, mais pas encoreenregistrées.

1. Sélectionnez Annuler les modifications dans le menu Données, dans la barre d'outils, ou dansle menu contextuel de la grille de données.

La boîte de dialogue Confirmer l'annulation des modifications s'affiche.2. Cliquez sur Oui pour confirmer.3. Toutes les modifications non enregistrées sont annulées, et la grille de données retourne à son état

original.

Valeurs manquantes

Ouvrez un ensemble de données en mode Modifier pour effectuer cette tâche.

Vous pouvez marquer les variables d'observations comme manquantes en utilisant l'option Définircomme manquant du menu contextuel de la grille de données.

Remarque :Quand les variables numériques sont formatées en tant que DATE, DATETIME ou TIME, cette optionest le seul moyen de marquer ces valeurs comme manquantes.

1. Sélectionnez la variable d'observation (c'est-à-dire la cellule) que vous voulez marquer commemanquante dans la grille de données.

Guide utilisateur du WorkbenchVersion 3.3

134

Assurez-vous qu'une seule variable est sélectionnée. Il n'est pas possible de définir plusieursvariables d'observation à la fois.

2. Cliquez avec le bouton droit sur la grille pour afficher le menu contextuel.3. Sélectionnez Définir comme manquant.

4. La réaction du Workbench dépend du type de la variable :Type de variable DescriptionNumérique La boîte de dialogue Définir comme manquant s'affiche.

Si la variable d'observation est déjà marquée comme valeurmanquante, la valeur brute actuelle est affichée. Sinon, la valeurmanquante est remplacée par le caractère par défaut « . » (point).Il est possible de modifier celui-ci en appuyant sur la touchequi correspond à la valeur désirée. Cette valeur peut être l'unedes suivantes : . (point), ._ (point puis soulignement), et .Aà .Z. Appuyez sur Entrée ou cliquez sur OK pour compléter lacommande. Appuyez sur la touche Échap ou cliquez sur Annulerpour revenir à la grille, où la valeur reste inchangée.

Chaîne de caractères Les variables texte sont représentées simplement par un seulespace «   » lorsque cette option est sélectionnée, et aucune boîtede dialogue ne s'affiche.

5. Les modifications apportées n'ont pas encore été enregistrées dans l'ensemble de données. Pourenregistrer les modifications et les renvoyer au serveur, sélectionnez Fichier ➤ Enregistrer dans lemenu principal, ou Enregistrer dans le menu contextuel de l'ensemble de données.

Filtrer un ensemble de données

Cette fonction n'est disponible que pour les ensembles de données qui se trouvent sur un serveur WPSde la version 3.2 ou ultérieure. (Vous pouvez déterminer la version de votre serveur à l'aide de la vuePropriétés lorsque vous sélectionnez le serveur dans la vue Explorateur de serveurs WPS).

Les filtres peuvent être appliqués à un ensemble de données quel que soit le mode utilisé pour l'ouvrir.

Vous pouvez filtrer le contenu de l'ensemble de données en fonction d'une variable, afin de ne voir queles données dont vous avez besoin.

Les filtres sont cumulatifs. Par conséquent, si vous filtrez les données sur plus d'une variable, tous lesfiltres sont appliqués. Vous pouvez annuler n'importe quel filtre à tout moment.

Remarque :Il est toujours possible d'ajouter une observation à un ensemble de données dans une vue filtrée. Lanouvelle observation s'affiche pendant l'édition, peu importe le contenu des variables filtrées. Dès queles modifications apportées à ensemble de données sont enregistrées, tous les filtres s'appliquent, et lanouvelle ligne disparait si elle ne répond pas aux critères actifs.

Guide utilisateur du WorkbenchVersion 3.3

135

Pour filtrer la vue de l'ensemble de données :

1. Cliquez sur le bouton en-dessous de l'en-tête de la variable pour la colonne à filtrer.

Le menu de critères de filtre s'affiche :

2. Sélectionnez les critères selon lesquels vous souhaitez filtrer la vue.

Selon la variable et les critères choisis, soit le bouton de filtre est remplacé par un champ demodification sous l'en-tête de la variable (valeurs numériques et chaînes de caractères), soit uneboîte de dialogue permettant de définir la date et l'heure.

3. Remplissez les critères du filtre en saisissant les détails appropriés :Type dedonnées

Critères

Date,dateheure ouheure

La plupart des expressions qui sont fondées sur la variable date et heure sontdéfinies dans une autre boîte de dialogue. L'utilisation des commandes calendrieret horloge permet de définir les critères de date. En ce qui concerne les valeurs,cliquez sur le bouton pour définir les composants temporels de la valeur dufiltre.

Autreschaînes decaractèresou valeursnumériques

L'expression du filtre apparaît en-dessous de l'intitulé de la variable. Saisissez lesvaleurs nécessaires dans la zone d'édition pour compléter cette expression. Parexemple, pour filtrer une variable numérique pour n'afficher que les observationsqui sont inférieures à 100 :

LT 100

Pour une liste plus complète des expressions qui peuvent être saisies, voir lasection Expressions de filtre d'ensembles de données.

Guide utilisateur du WorkbenchVersion 3.3

136

Une fois le filtre appliqué, l'icône de bouton de filtre passe de à , indiquant que la variable estutilisée dans un filtre.

4. Facultatif: Vous pouvez maintenant définir d'autres critères du filtre sur les autres colonnes ensuivant les étapes mentionnées ci-dessus.

5. Facultatif: Vous pouvez effacer n'importe lequel des filtres que vous avez définis, en cliquant sur lebouton de filtre, puis en sélectionnant l'option de menu Effacer le filtre.

Quand vous appliquez et annulez des filtres, le contenu de l'ensemble de données est mis à jourconformément au dernier jeu de critères.

Expressions de filtre d'ensembles de données

Vous pouvez filtrer les données affichées dans un ensemble de données. Les options du menu de filtresont des raccourcis vers la préparation d'une expression de filtre à utiliser lorsqu'une requête sur lesdonnées de l'ensemble de données est transmise au serveur.

Si l'observation sur laquelle repose le filtre n'est pas une variable formatée de type date, heure ouhorodatage, vous pouvez modifier l'expression de filtre générée. Si vous choisissez de filtrer sur cesvariables depuis le menu, l'expression est affichée, avec un curseur prêt pour la saisie de la valeur dufiltre, s'il en faut une. Vous pouvez ensuite éditer ce filtre en cliquant sur l'expression.

Remarque :Vous ne pouvez pas modifier les expressions de filtre sur les variables de type date, heure ouhorodatage. Celles-ci doivent être supprimés, puis saisies de nouveau.

La table suivante affiche la syntaxe d'expression modifiable qui est disponible dans le menu de filtre.

Syntaxe de l'expression de filtreCritères Expression Exemples

Égal à EQ x ou EQ s Est égal à 100 (numérique)

EQ 100

Est égal à "Blanco" (chaîne de caractères)

EQ "Blanco"

Différentde

NE x ou NE s Différent de 100 (numérique)

NE 100

Différent de "Blanco" (chaîne de caractères)

NE "Blanco"

Guide utilisateur du WorkbenchVersion 3.3

137

Critères Expression Exemples

Inférieurà

LT x Est inférieur à 100

LT 100

Supérieurà

GT x Est supérieur à 100

GT 100

Inférieurou égal à

LE x Est inférieur ou égal à 100

LE 100

Estsupérieur ouégal à

GE x Est supérieur ou égal à 100

GE 100

Comprisentre (inclus)

BETWEEN x AND y Est compris entre 100 et 200

BETWEEN 100 AND 200

Pascomprisentre (inclus)

NOT BETWEEN x AND y N'est pas compris entre 100 et 200

BETWEEN 100 AND 200

Estmanquant

IS MISSING IS MISSING

N'est pasmanquant

IS NOT MISSING IS NOT MISSING

Dans IN ( x , y ) ou IN ( s1 ,

s2 )

Est l'une des valeurs 100, 200 ou 300

IN (100,200,300)

Est l'une des valeurs « Blanco », « Jones » ou « Smith »

IN ("Blanco","Jones","Smith")

Commencepar

LIKE " s% " Commence par la chaîne de caractères "Bla"

LIKE "Bla%"

Finit par LIKE "%s " Finit par la chaîne de caractères "nco"

LIKE "%nco"

Contient LIKE "%s% " Contient la chaîne de caractères "an"

LIKE "%an%"

Guide utilisateur du WorkbenchVersion 3.3

138

Trier un ensemble de données

Cette fonction n'est disponible que pour les ensembles de données qui se trouvent sur un serveur WPSde la version 3.2 ou ultérieure. (Vous pouvez déterminer la version de votre serveur à l'aide de la vuePropriétés lorsque vous sélectionnez le serveur dans la vue Explorateur de serveurs WPS).

Le tri n'est pas disponible si la grille de données est ouverte en mode Modifier.

Vous pouvez trier le contenu d'un ensemble de données en fonction de plusieurs variables. Lesvariables qui font partie d'un tri actif ont une icône qui représente la direction du tri dans l'en-tête. Lataille de l'icône indique l'importance de la variable dans le tri. Les icônes et représentent la cléprincipale du tri, les icônes et représentent la clé secondaire, et les icônes et représententles clés tertiaires et ultérieures.

Remarque :Si vous tentez de passer en mode Modifier alors qu'un tri a été appliqué, un avertissement s'affiche. Eneffet, passer en mode Modifier nécessiterait la réécriture complète de l'ensemble de données selon letri en cours, pour lui permettre d'être modifié sur place. Si vous désirez ce résultat, cliquez sur Oui dansla boîte de dialogue, mais cela va réécrire l'ensemble de données entier sur le serveur selon l'ordre quevous avez déterminé dans la grille, et mettre la grille en mode Modifier. Si vous ne souhaitez pas cela,cliquez sur Non.

Vous pouvez trier un ensemble de données comme suit :

1. Cliquez avec le bouton droit sur l'en-tête de la colonne de la variable que vous souhaitez utiliser entant que clé primaire.

Le menu de l'en-tête de la colonne s'affiche.2. Cliquez sur l'icône Tri croissant ou Tri décroissant pour effectuer le tri.

Les données de la grille sont triées dans l'ordre demandé.3. Facultatif: Vous pouvez maintenant ajouter des clés secondaires et ultérieures au tri en suivant les

étapes ci-dessus.4. Facultatif: Vous pouvez supprimer n'importe quel tri en sélectionnant Effacer le tri dans le menu

contextuel de la variable associée.

Organiser l'ensemble de données

Vous pouvez manipuler la vue de l'ensemble de données de sorte à masquer les variables dont vousn'avez pas besoin, et changer l'ordre des colonnes.

Remarque :Ces modifications affectent uniquement votre vue des données et non pas les données elles-mêmes.

Guide utilisateur du WorkbenchVersion 3.3

139

Masquer les variables

Pour masquer une colonne dans une grille de données :

1. Cliquez avec le bouton droit sur l'intitulé de la colonne de la variable que vous voulez masquer.

Le menu contextuel s'affiche.2. Cliquez sur Masquer la colonne.

La colonne de la grille de données disparaît. Si vous tentez de masquer une colonne pour laquelle unfiltre est actif, une boîte de dialogue s'affiche pour que vous confirmiez que vous désirez supprimer lefiltrage et masquer la colonne. Cliquez sur Oui ou Non, selon les cas.

Afficher les variables masquées

Pour afficher les variables d'ensemble de données précédemment masquées :

1. Cliquez avec le bouton droit sur la rangée d'en-tête de l'ensemble de données.

Le menu contextuel s'affiche.2. Cliquez sur Afficher / Masquer les colonnes.

La boîte de dialogue Afficher / Masquer les colonnes s'affiche. Elle comporte des cases àcocher indiquant si les colonnes sont affichées (les cases sont cochées) ou non (elles sontdésélectionnées).

3. Pour afficher une colonne précédemment masquée, cochez la case correspondante.4. Cliquez sur OK.

Les colonnes affichées reflètent les changements apportés à la fenêtre Afficher / Masquer lescolonnes.

Déplacer des colonnes

Vous pouvez déplacer les colonnes n'importe où dans la vue de l'ensemble de données, quel que soitleur ordre dans l'ensemble de données. Ce déplacement n'affecte pas l'ordre physique des colonnessur le serveur, seulement leur affichage actuel.

Pour déplacer une colonne :

1. Cliquez sur l'en-tête de colonne et maintenez le bouton de la souris enfoncé.2. Sans relâcher le bouton, faites glisser la colonne vers l'emplacement voulu.

Guide utilisateur du WorkbenchVersion 3.3

140

Lorsque vous faites glisser la colonne vers la gauche ou vers la droite, l'en-tête devient translucide.Une ligne grise épaisse apparaît entre les colonnes, vous indiquant l'endroit où la colonne sepositionnera si vous relâchez le bouton de la souris à cet instant :

3. Relâchez le bouton lorsque la ligne grise est à l'emplacement voulu.

La colonne s'affiche dans la nouvelle position.

Exporter des ensembles de donnéesSous Windows, les ensembles de données WPS peuvent être exportés sous forme fichiers texte àlargeur fixe ou délimité ou encore de fichiers Excel. L'assistant Exportation d'ensemble de donnéespermet de définir avec précision le contenu du fichier d'exportation.

Pour exporter un ensemble de données :

1. Localisez l'ensemble de données à exporter dans la vue Explorateur de serveurs WPS.2. Cliquez avec le bouton droit sur l'ensemble de données et sélectionnez Exporter l'ensemble de

données dans le menu contextuel.

L'assistant Exportation d'ensemble de données est lancé.3. Sélectionnez Valeurs délimitées, Largeur fixe ou Excel. Pour Excel, choisissez le format souhaité

dans la liste déroulante.

Pour Valeurs délimitées ou Largeur fixe, le volet Aperçu de l'exportation montre l'aspect despremières lignes du fichier d'exportation.

4. Cliquez sur Suivant.5. Facultatif: Vous pouvez configurer plus précisément les exports si vous avez choisi Valeurs

délimitées ou Largeur fixe. Si vous voulez inclure les noms de colonnes, cochez la case Inclure lenom des champs dans la première ligne. Les autres options de configuration dépendent du typed'exportation :Typed'exportation

Options

Valeursdélimitées

Sélectionnez le délimiteur de votre choix, ou cliquez sur Autre et saisissez votrechoix dans la case prévue à cette fin si aucun des délimiteurs standards ne convient.

Guide utilisateur du WorkbenchVersion 3.3

141

Typed'exportation

Options

Largeur fixe Modifiez la largeur des colonnes en sélectionnant une colonne dans la listedéroulante, et en modifiant les valeurs Départ et Largeur.

Toutes les modifications effectuées sont reflétées dans le volet Aperçu de l'exportation.

Cliquez sur Suivant lorsque vous êtes prêt à passer à l'étape suivante.6. Facultatif: Le nom de fichier par défaut s'affiche, ainsi que le chemin. Vous pouvez modifier cela

si vous souhaitez, et le bouton Parcourir vous permet trouver un emplacement approprié pour lefichier exporté.

7. Pour ouvrir automatiquement le fichier une fois l'exportation terminée, cochez la case Ouvrirune fois terminé. Si le Workbench ne réussit pas à ouvrir le fichier, ce dernier est ouvert dansl'application appropriée enregistrée sur votre système d'exploitation.

8. Si le fichier existe déjà, l'option Confirmer le remplacement est disponible. Vous ne pouvez pascontinuer si cette option n'est pas cochée. Vous pouvez également sélectionner l'option Toujoursremplacer, afin que le Workbench remplace automatiquement les fichiers existants avec un simpleavertissement. Ceci est utile si vous souhaitez exporter plusieurs fois vers le même fichier au coursde la même session du Workbench.

9. Facultatif: Cliquez sur Suivant pour voir le programme WPS que le Workbench va exécuter aumoyen du serveur pour effectuer l'exportation.

10.Cliquez sur Terminer.

Si vous avez configuré votre fichier pour qu'il s'ouvre une fois l'exportation terminée, il peut s'ouvrirdans le Workbench (selon l'extension attribuée au fichier d'exportation).

Effacer des ensembles de donnéesIl n'est pas possible de n'effacer que les ensembles de données. Le processus d'effacement desensembles de données implique également la suppression de toutes les sorties associées (HTML, liste,entrées du journal, bibliothèques, références de fichier, etc.).

Afin d'effacer toutes les sorties, suivez la procédure décrite à la section Redémarrer le serveur.

Guide utilisateur du WorkbenchVersion 3.3

142

Exécuter des programmesVous pouvez exécuter un programme soit à l'intérieur du Workbench, soit depuis la ligne decommande.

Pour voir comment contrôler les sorties (ensembles de données, journaux, résultats, etc.) générées parl'exécution d'un programme sur le serveur sélectionné, voir la section Utiliser les sorties de programme.Pour plus d'informations sur certains des paramètres associés à l'exécution de programmes, voir lasection Préférences WPS concernant l'exécution des programmes.

Remarque :Les bibliothèques, les ensembles de données et les variables de macro sont tous persistants. Celasignifie qu'une fois spécifiés lors de l'exécution d'un programme, ils restent disponibles pour les autresprogrammes exécutés par la suite au cours de la session du Workbench.

Préférences WPS concernantl'exécution des programmesPour contrôler le comportement général de WPS Workbench lors de l'exécution des programmes,sélectionnez les options appropriées sous Fenêtre ➤ Préférences ➤ WPS, avant d'exécuter desprogrammes :

Enregistrer tous les fichiers modifiés avant d'exécuter un programmeCette préférence détermine si WPS doit enregistrer les fichiers des programmes modifiés avantl'exécution d'un programme. Les comportements possibles sont les suivants : Toujours, Jamaisou Demander. La valeur par défaut est Demander, qui entraîne l'affichage d'une boîte dedialogue Enregistrer et exécuter chaque fois qu'un programme est exécuté.

Lorsque vous modifiez et exécuter un programme à l'aide du bouton Exécuter, c'est lecontenu actuel de la fenêtre de l'éditeur qui est transmis, et non pas le contenu du fichier. Ainsi,par exemple, si l'option Jamais est sélectionnée, ces modifications non enregistrées dans lafenêtre de l'éditeur sont toujours exécutées. La boîte de dialogue Enregistrer et exécuterpermet de modifier ce paramètre en choisissant Toujours (ou Jamais) si cela vous semble plusapproprié. Par exemple, il peut être utile de choisir l'option Toujours si votre programme estconçu à partir de plusieurs fichiers source. Imaginons que l'un de vos fichiers source utilise uneinstruction %INCLUDE afin d'inclure le contenu d'un autre fichier, l'instruction %INCLUDE lisant lecontenu de l'autre fichier exactement tel qu'il figure sur le disque (et non tel qu'il apparaît dansl'éditeur). Dans ce cas, il est probable que vous vouliez toujours que vos modifications soientenregistrées afin d'être exécutées.

Guide utilisateur du WorkbenchVersion 3.3

143

Fermer tous les ensembles de données ouverts avant d'exécuter un programmeCe paramètre définit comment WPS traite la fermeture des ensembles de données ouverts lorsde l'exécution d'un programme. Les comportements possibles sont les suivants : Toujours,Jamais ou Demander. La valeur par défaut est Demander, qui entraîne l'affichage d'une boîtede dialogue Enregistrer et exécuter chaque fois que vous tentez d'exécuter un programmelorsqu'un ensemble de données est ouvert.

La présence d'ensembles de données ouverts dans la visionneuse (voir la section Utiliser lavisionneuse d'ensemble de données) peut causer des problèmes si vous tentez d'exécuterun programme qui vise à remplacer lesdites données par une nouvelle version. Il est doncrecommandé de définir cette option sur Toujours afin d'éviter de tels problèmes.

Afficher le journal lorsqu'une erreur est détectée pendant l'exécution d'un programmeCeci détermine si WPS affiche le journal lorsqu'une erreur est détectée dans un programme.Les comportements possibles sont les suivants : Toujours, Jamais ou Demander. La valeurpar défaut de cette option est Demander, ce qui entraîne l'affichage de la boîte de dialogueConfirmer l'affichage du journal la première fois qu'une erreur est détectée lors de l'exécutiond'un programme.

Si la case Se souvenir de ma décision reste cochée :

• Sélectionnez Oui dans la boîte de dialogue Confirmer l'affichage du journal pour définir leparamètre sur Toujours, afin que le journal soit affiché automatiquement chaque fois qu'uneerreur se produit.

• Sélectionnez Non dans la boîte de dialogue Confirmer l'affichage du journal pour définirle paramètre sur Jamais, afin que le journal ne soit pas affiché automatiquement losqu'uneerreur se produit.

Fermer tous les ensembles de données ouverts lors de la désaffectation de la bibliothèqueCette option spécifie si WPS ferme automatiquement les ensembles de données ouverts dansune bibliothèque lorsque vous désaffectez une bibliothèque en sélectionnant Supprimerdans le menu contextuel de la vue Explorateur de serveurs WPS. Les comportementspossibles sont les suivants : Toujours ou Demander. La valeur par défaut pour cette option estDemander, qui entraîne l'affichage d'une boîte de dialogue lorsque vous tentez à désaffecter unebibliothèque contenant des ensembles de données ouverts.

Confirmer les suppressionsCette option définit si WPS vous demande une confirmation lorsque vous sélectionnez

 Supprimer dans le menu contextuel de la vue Explorateur de serveurs WPS poureffectuer l'une des actions suivantes :

• supprimer une définition de serveur ;• supprimer un ensemble de données, un catalogue ou une vue dans une bibliothèque ;• désaffecter une bibliothèque ;• désaffecter une référence de fichier (Fileref) ;• supprimer uen entrée de catalogue au sein du catalogue.

Guide utilisateur du WorkbenchVersion 3.3

144

Confirmer le redémarrage du serveurCette option détermine si WPS vous demande une confirmation lorsque vous sélectionnez unserveur dans la vue Explorateur de serveurs WPS, puis sélectionnez Redémarrer dansle menu contextuel.

Défilement automatique du journalCe paramètre spécifie si WPS fait automatiquement défiler la sortie journal (voir la sectionAfficher le journal).

Défilement automatique de la listeCe paramètre spécifie si WPS fait automatiquement défiler la sortie sous forme de liste (voir lasection Afficher la sortie sous forme de liste).

Afficher les actions du serveur avancéCette option définit les options du menu contextuel disponibles lorsque vous redémarrez lesserveurs WPS (voir la section Redémarrer avec les actions de serveur avancées).

Emplacement du fichier temporaireCe champ définit l'emplacement du répertoire où le Workbench stocke les fichiers temporaires.Les fichiers journaux créés pendant l'exécution d'un programme sont stockés dans ce répertoire,tout comme les résultats ODS HTML générés par le programme.

Il est important de savoir que les fichiers de sortie, et en particulier les journaux, peuvent avoirune taille importante. Il peut donc être nécessaire de modifier ces paramètres si la valeur pardéfaut pointe vers un emplacement avec un espace limité.

Remarque :Vous pouvez également activer l'option Toujours exécuter en arrière-plan (voir la sectionPréférences générales) si vous souhaitez lancer des programmes dont l'exécution est longue.

Exécuter un programme à l'intérieur duWorkbenchLe Workbench ne peut exécuter qu'un seul programme à la fois sur chaque serveur WPS. Cela signifieque, si un programme est en cours d'exécution et que vous tentez d'exécuter un autre programme surle même serveur, il est mis en attente et ne s'exécute pas tant que le premier programme n'est pasterminé. Vous pouvez cependant définir plus d'un serveur WPS, ce qui permet d'exécuter plusieursprogrammes en même temps.

Pour exécuter un programme à l'intérieur du Workbench :

1. Vérifiez que l'option Soumission de code est définie correctement sur le serveur (voir la sectionPropriétés du serveur WPS local ou Propriétés du serveur WPS distant, selon le cas).

2. Sélectionnez le programme à exécuter en utilisant l'une des méthodes suivantes :

Guide utilisateur du WorkbenchVersion 3.3

145

• Sélectionnez le programme à exécuter dans la vue Explorateur de projets ou Explorateur defichiers.

• Ouvrez le programme dans la vue Éditeur.

Remarque :Si le programme est déjà ouvert, et qu'une partie du programme est mise en surbrillance, seulecette partie est exécutée, et pas l'ensemble du programme.

3. Exécutez le programme à l'aide d'une des opérations suivantes :

• Utilisez le raccourci clavier Ctrl +R pour exécuter le programme sur le serveur WPS par défaut.• Dans la barre d'outils, cliquez sur le bouton pour exécuter le programme sur le serveur par

défaut, ou cliquez sur la flèche de liste déroulante à côté de ce bouton pour sélectionner unautre serveur.

• Dans le menu principal, sélectionnez WPS ➤  Exécuter le fichier <chemin dufichier> ➤ Serveur local (ou remplacez Serveur local par le nom du serveur WPS distant).

• Dans le menu contextuel, sélectionnez Exécuter sur le serveur ➤  Serveur local (ouremplacez Serveur local par le nom du serveur WPS distant).

Pendant l'exécution du programme, la fenêtre Exécution s'ouvre (sauf si l'option Toujours exécuteren arrière-plan est sélectionnée), et sa progression est affichée en bas à droite du Workbench.

Lorsque vous exécutez un programme, l'état de l'exécution précédente est conservée. Parconséquent, des exécutions successives peuvent interagir avec les ensembles de données, lesréférences de fichier et autres éléments créés auparavant.

Pour effacer les sorties antérieures sur un serveur donné, sélectionnez dans le menu WPS ou labarre d'outils Effacer le journal  ➤ Serveur local (ou remplacez Serveur local par le nom duserveur WPS distant), ou Effacer les résultats  ➤ Serveur local (ou remplacez Serveur localpar le nom du serveur WPS distant).

Vous pouvez également effacer complètement l'état d'un serveur WPS, en effaçant la bibliothèqueWork et en supprimant l'association de toutes les définitions de macro et de bibliothèque.Sélectionnez ensuite WPS ➤  Redémarrer le serveur  ➤ Serveur local (ou remplacez Serveurlocal par le nom du serveur WPS distant), ou cliquez avec le bouton droit sur le serveur dansExplorateur de serveurs WPS et sélectionnez Redémarrer. Voir la section Redémarrer leserveur.

Exécuter une partie d'un programmeVous pouvez exécuter une partie d'un programme en procédant comme suit :

1. Ouvrez le programme dans la fenêtre active.

2. Mettez en surbrillance la section du code du programme que vous souhaitez exécuter.

3. Exécutez cette portion de code à l'aide d'une des opérations suivantes :

Guide utilisateur du WorkbenchVersion 3.3

146

• Utilisez le raccourci clavier Ctrl + R pour exécuter le code sur le serveur par défaut.• Dans la barre d'outils, cliquez sur le bouton pour exécuter le code sur le serveur par défaut,

ou cliquez sur la flèche de liste déroulante à côté de ce bouton pour sélectionner un autreserveur.

• Dans le menu principal, sélectionnez WPS ➤  Exécuter le code sélectionné depuis<chemin du fichier> ➤  Serveur local (ou remplacez Serveur local par le nom du serveur WPSdistant).

• Dans le menu contextuel, sélectionnez Exécuter sur le serveur ➤  Serveur local (ouremplacez Serveur local par le nom du serveur WPS distant).

• Cliquez avec le bouton droit sur la vue Éditeur et sélectionnez Exécuter sur leserveur ➤ Serveur local (ou remplacez Serveur local par le nom du serveur WPS distant).

Pendant l'exécution du programme, sa progression est affichée en bas à droite du Workbench.

Arrêter une exécutionSi un programme est en cours et vous voulez arrêter l'exécution avant qu'elle ne soit terminée,procédez comme suit :

1. Dans le menu principal, sélectionnez WPS ➤  Effacer les résultats ➤  Serveur local (ousélectionnez le nom du serveur souhaité au lieu de Serveur local), ou cliquez sur dans la vueProgression.

2. Lorsque l'indicateur de progression situé en bas à droite du Workbench disparaît, cela signifieque le programme a cessé de s'exécuter.

Remarque :Selon l'étape que le programme est en train d'exécuter, il se peut qu'il ne s'arrête pas immédiatement.

Le journal comporte un message du type ERROR: Execution was cancelled.

WPS en mode ligne de commandeEn plus de pouvoir utiliser WPS dans le mode Workbench (c'est-à-dire à partir de l'interface utilisateurgraphique), vous pouvez également utiliser le système en mode ligne de commande, où il est appeléwps. Ceci permet d'exécuter les programmes à l'extérieur d'un Workbench, ce qui est aussi appelémode « batch » ou traitement par lot.

Remarque :Dans ce mode, vous ne pouvez pas compiler les programmes pour qu'ils deviennent les tâchesd'exécution.

Guide utilisateur du WorkbenchVersion 3.3

147

Pour utiliser WPS en ligne de commande, vous devez exécuter wps.exe (ou juste wps) sur Windows,ou wps sur une plate-forme de type UNIX. Ce fichier exécutable est situé dans le répertoire /bin del'installation de WPS. Il faut donc d'abord accéder à ce fichier. Voir les sections Exécuter un programmeen ligne de commande sur une plate-forme Windows et Exécuter un programme en ligne de commandesur une plate-forme autre que Windows pour plus d'exemples.

OptionsEn soi, l'exécution du fichier wps.exe ou wps ne fait rien, et vous devez entrer des informationssupplémentaires sous la forme suivante :

wps.exe <options> <programFileName>

Les <options> de la ligne de commande peuvent être une ou plusieurs des options suivantes :

• -optionname [valeur facultative]

• -config <nom de fichier de configuration>

• -set <nom de variable d'environnement> <valeur de variable

d'environnement>

Remarque :Lorsque vous exécutez un programme en utilisant wps.exe ou wps, le paramètre <nom de fichierde programme> doit toujours être le dernier paramètre que vous définissez. En effet, lorsque wpss'exécute, le premier paramètre rencontré qui ne commence pas par un tiret (-) est considéré commeétant le nom du programme à exécuter.

Le compilateur/interpréteur WPS est invoqué directement. Les fichiers de sortie générés parl'exécution d'un programme ne s'affichent pas automatiquement dans le Workbench ; il faut les ouvrirmanuellement.

Options systèmePour définir une option système de manière explicite, spécifiez :

wps.exe -optionname [optionalValue] <programFileName>

Remarque :Vous pouvez entrer autant d'options système optionname sur la ligne de commande de wps quevous le souhaitez. Vous ne pouvez entrer que des options de wps à valeur unique. L'utilisation desparenthèses sur la ligne de commande n'est pas autorisée. Vous pouvez indiquer des valeurs entreguillemets avec des espaces, mais les guillemets seront supprimés.

Fichiers de configurationLes options système peuvent être définies dans un fichier de configuration (config), et ce fichier peutêtre référencé explicitement dès l'exécution de wps :

wps.exe -config <configFileName> <programFileName>

Guide utilisateur du WorkbenchVersion 3.3

148

Voir la section Fichiers de configuration pour une présentation des fichiers de configuration et l'ordredans lequel ils sont traités.

Important :Lorsque vous exécutez des programmes avec wps en ligne de commande, toutes les propriétés duserveur WPS qui ont été configurées en tant que préférences dans l'interface utilisateur sont ignorées.

Variables d'environnementPour configurer une variable d'environnement à utiliser avec wps :

wps.exe -set <envVarName> <envVarValue> <programFileName>

Vous pouvez configurer autant de variables d'environnement que vous le souhaitez. Cependant, wpsen ligne de commande n'accepte que les variables à valeur unique, et n'autorise pas l'utilisation deparenthèses.

JournalLorsque vous exécutez un programme avec wps, les informations du journal d'exécution sont envoyéesautomatiquement vers la fenêtre de commande dans laquelle wps s'exécute. Une fois le programmeexécuté et la fenêtre de commande fermée, le contenu du journal disparait. Pour capturer cesinformations dans les environnements Windows et non-Windows (en utilisant éventuellement desfichiers de traitement par lot ou des programmes shell, respectivement), voir les sections Exécuter unprogramme en ligne de commande sur une plate-forme Windows et Exécuter un programme en lignede commande sur une plate-forme autre que Windows.

Sortie des résultatsLorsqu'un programme est exécuté dans wps, tous les résultats générés par le programme sontautomatiquement saisis dans un fichier appelé <nom du fichier de programme>.lst, crée dans le mêmerépertoire que le programme. Par exemple, si un programme appelé Programme1.sas est exécuté, unfichier appelé Programme1.lst est créé. Vous pouvez ouvrir ce fichier avec l'éditeur de texte de votrechoix.

Exécuter un programme en ligne de commandesur une plate-forme WindowsConsultez la section WPS en mode ligne de commande pour plus d'informations sur les <options>qu'il est possible de spécifier.

Guide utilisateur du WorkbenchVersion 3.3

149

ExempleSupposons que vous souhaitiez exécuter un programme appelé Program1.sas qui se trouve dans lerépertoire D:\Work\WPS Programs. Ouvrez une fenêtre de commande et accédez au répertoire /bin de l'installation de WPS, puis saisissez la commande suivante après l'invite :

wps.exe "D:\Work\WPS Programs\Program1.sas"

Créer un fichier batch pour appeler WPSSi vous désirez exécuter un ou des programmes en utilisant les mêmes options à chaque fois, il estconseillé de créer un fichier batch pour le faire.

Par exemple, si WPS est installé dans C:\Program Files\World Programming WPS 3 et quevotre programme se trouve dans d:\Work\WPS Programs, comme indiqué ci-dessus, vous pouvezcréer un fichier batch appelé RunPrograms.bat qui comporte les lignes suivantes :

set WPSLOC=C:\Program Files\World Programming WPS 3set PRJLOC="D:\Work\WPS Programs""%WPSLOC%\bin\wps" "%PRJLOC%\Program1.sas"

Remarque :Utilisez des chemins d'accès complets, cela permet d'exécuter les commandes à partir de n'importequel endroit sur votre ordinateur sans problème.

Inclure les sorties de fichier journal dans le fichier batchLorsque vous exécutez wps, il est utile de conserver les informations du journal pour vérifier si deserreurs ou des problèmes sont survenus. Vous pouvez le faire en redirigeant les sorties du programmevers un fichier. Par exemple, pour modifier l'exemple ci-dessus et rediriger les sorties vers un fichierappelé Program1.log, changez l'exemple du code comme suit :

set WPSLOC=C:\Program Files\World Programming WPS 3set PRJLOC="D:\Work\WPS Programs""%WPSLOC%\bin\wps" "%PRJLOC%\Program1.sas" > "d:\Work\WPS Logs\Program1.log"

Une fois que le fichier batch est exécuté, le fichier Program1.log est affiché dans le répertoirespécifié et peut être lu avec l'éditeur de texte de votre choix.

Chaque fois que vous saisissez les informations du journal dans un fichier qui porte le même nom, lefichier est recréé. Autrement dit, les informations du journal ne sont pas ajoutées au même fichier :elles n'affichent que les détails de la dernière exécution. Si vous souhaitez que le nouveau journal soitajouté, il faut changer le symbole de redirection de > en >>.

"%WPSLOC%\bin\wps" "%PRJLOC%\Program1.sas" >> "d:\Work\WPS Logs\Program1.log"

Astuce :Les fichiers journaux sont trop volumineux pour rechercher les erreurs visuellement. Il est donc plussimple de rechercher le mot error pour savoir si le programme a été exécuté correctement.

Guide utilisateur du WorkbenchVersion 3.3

150

Exécuter un programme en ligne de commandesur une plate-forme autre que WindowsConsultez la section WPS en mode ligne de commande pour plus d'informations sur les <options>qu'il est possible de spécifier.

ExempleSupposons que vous souhaitiez exécuter un programme appelé Program1.sas qui se trouve dans lerépertoire /home/user/programs. Ouvrez une fenêtre de commande et accédez au répertoire /binde l'installation de WPS, puis saisissez la commande suivante :

wps "/home/user/programs/Program1.sas"

Créer un programme shell pour appeler WPSSi vous désirez exécuter un ou des programmes en utilisant les mêmes options à chaque fois, il estconseillé de créer un fichier shell pour le faire.

Par exemple, si WPS est installé dans le répertoire /tools/wps et que votre programme se trouvedans /home/user/programs, vous pouvez créer un fichier texte nommé RunPrograms.sh quicomporte les lignes suivantes :

export WPSLOC=/tools/wpsexport PRJLOC=/home/user/programs"$WPSLOC/bin/wps" "$PRJLOC/Program1.sas"

Remarque :Le programme nécessite les autorisations appropriées pour son exécution.

Inclure les sorties de fichier journal dans le programme shellLorsque vous exécutez wps, il est utile de conserver les informations du journal pour vérifier si deserreurs ou des problèmes sont survenus. Vous pouvez le faire en redirigeant les sorties du programmevers un fichier. Par exemple, pour modifier l'exemple ci-dessus et rediriger les sorties vers un fichierappelé Program1.log, changez l'exemple du code comme suit :

export WPSLOC=/tools/wpsexport PRJLOC=/home/user/programs"$WPSLOC/bin/wps" "$PRJLOC/Program1.sas" > "/home/user/logs/Program1.log"

Une fois le fichier batch exécuté, le fichier Program1.log est affiché dans le répertoire spécifié et peutêtre ouvert avec l'éditeur de texte de votre choix.

Chaque fois que vous saisissez les informations du journal dans un fichier qui porte le même nom, lefichier est recréé. Autrement dit, les informations du journal ne sont pas ajoutées au même fichier :

Guide utilisateur du WorkbenchVersion 3.3

151

elles n'affichent que les détails de la dernière exécution. Si vous souhaitez que le nouveau journal soitajouté, il faut changer le symbole de redirection de > en >>.

"$WPSLOC/bin/wps" "$PRJLOC/Program1.sas" >> "/home/user/logs/Program1.log"

Astuce :Les fichiers journaux sont trop volumineux pour rechercher les erreurs visuellement. Il est donc plussimple de rechercher le mot error pour savoir si le programme a été exécuté correctement.

Guide utilisateur du WorkbenchVersion 3.3

152

Utiliser les sorties deprogrammeLes sorties de programme sont générées dans les vues suivantes :

• Explorateur de serveurs WPS – Permet d'accéder aux ensembles de données, catalogues, références de fichier (filerefs), etc., générés dans les bibliothèques pertinentes (la

bibliothèque par défaut Work, par exemple) du serveur en question. Voir aussi la section Générerun ensemble de données.

• Explorateur de sorties – Permet d'accéder aux sorties sous forme de liste, sortiesHTML, sorties PDF et journaux générés par les systèmes ODS (Output Delivery System) duWorkbench.

• Explorateur de résultats – Permet d'accéder aux arborescences ou à la sortie sous forme deliste, la sortie HTML et la sortie PDF.

• Structure – Permet d'accéder aux éléments structuraux des programmes, journaux, listeset HTML générés en sortie. Si vous cliquez sur un élément structural dans cette vue, la lignecorrespondante est surlignée dans le fichier de sortie concerné.

La sortie journal d'un serveur est cumulative : elle affiche les informations et les éventuelles erreurstrouvées dans chaque programme exécuté durant la session en cours. Pour l'effacer, suivez lesinstructions de la section Effacer le journal. La sortie sous forme de liste, comme la sortie journal,est cumulative ; elle et affiche les résultats de chaque programme exécuté dans la session en cours. Lasortie HTML affiche elle aussi les résultats des programmes, mais n'est pas cumulative. Vous pouvezeffacer les sorties sous forme de liste et HTML en suivant les instructions de la section Effacer lesrésultats d'un programme.

Vous pouvez également redémarrer le serveur lui-même en suivant les instructions de la section Redémarrer le serveur. Cette option efface le journal, ainsi que les sorties sous forme de liste

et HTML. Elle supprime aussi tous les fichiers temporaires et désaffecte toutes les bibliothèques,ensembles de données et variables de macro, etc., qui ont été spécifiés sur le serveur.

Générer un ensemble de donnéesSi votre programme produit ou modifie un ensemble de données, ce dernier peut être affiché depuisla bibliothèque correspondante dans la vue Explorateur de serveurs WPS. Par exemple, chaque foisque vous exécutez l'exemple de programme suivant, et que vous modifiez la ligne du signet commedemandé, l'ensemble de données est mis à jour dans la bibliothèque Work :

Guide utilisateur du WorkbenchVersion 3.3

153

Remarque :Pour plus d'informations sur l'utilisation des bibliothèques sur un serveur, voir la section Bibliothèques.Pour plus d'informations sur l'affichage des ensembles de données et sur leur modification manuelle,voir la section Utiliser la visionneuse d'ensemble de données.

Pour afficher les détails associés à un ensemble de données précis, cliquez avec le bouton droit surl'ensemble de données dans la vue ci-dessus et sélectionnez Propriétés.

Guide utilisateur du WorkbenchVersion 3.3

154

Gérer les sorties ODSUne fois que vous avez exécuté un programme qui utilise la fonction ODS (Output Delivery System,système de livraison de sortie) du Workbench pour produire des résultats, ces derniers sont affichésdans la vue Explorateur de résultats. Les destinations ODS utilisées par WPS Workbench (vous pouvezles considérer comme des formats de sortie) et l'emplacement des sorties peuvent être gérés soit parvous-même (en utilisant des instructions ODS explicites dans votre code), soit automatiquement (enlaissant le Workbench gérer les résultats).

Préférences concernant les options de résultatsPar défaut, WPS contrôle automatiquement les résultats conformément aux paramètres définis dansFenêtre ➤ Préférences ➤ WPS ➤ Options de résultats :

La valeur par défaut Oui du paramètre Gérer automatiquement les types de résultats permet lacréation automatique des destinations ODS, conformément aux cases à cocher sélectionnées dansle volet Types de résultats (initialement, les sorties HTML et Texte (LISTE), accessibles via la vueExplorateur de sorties, sont définies). WPS crée les destinations en injectant automatiquement les

Guide utilisateur du WorkbenchVersion 3.3

155

instructions ODS pertinentes avant et après la soumission de chaque programme (ces instructions sontindiquées automatiquement dans le journal si l'option Afficher le code injecté généré dans le journalest sélectionnée). Si vous sélectionnez PDF, la première fois que vous exécutez un programme, ladestination PDF apparaît dans les vues Explorateur de sorties et Explorateur de résultats.

Remarque :Même si la gestion automatique est choisie, il est toujours possible de définir les destinations ODS àl'aide d'instructions ODS explicites dans votre code. Vous pouvez définir vos propres sorties HTMLet PDF dans le code du programme et/ou à l'aide de la fonctionnalité Injection de code WPS. Pour unexemple de programme PDF, voir la section Sortie PDF.

Si la valeur de Gérer automatiquement les types de résultats est Non, aucune destination ODSn'est définie par défaut, et toutes les sorties créées par l'exécution de programmes sont envoyéespar défaut à la destination Texte (LISTE). Ce comportement reflète ce qui se produit lorsquevous exécutez WPS en mode ligne de commande, où les programmes doivent définir leurs propresdestinations ODS.

Fichiers journauxCette section du guide porte sur la gestion de la sortie journal affichée dans la vue Explorateurde sorties.

Remarque :Si plusieurs serveurs WPS sont enregistrés dans le Workbench, un journal distinct est fourni pourchaque serveur dans la vue Explorateur de sorties.

Préférences concernant les couleurs du journalLes options permettant de définir les préférences concernant les éléments présents dansle fichier journal (erreurs, notes, avertissements, etc.) sont accessibles en sélectionnantFenêtre ➤ Préférences ➤ WPS ➤ Coloration syntaxique du journal :

Guide utilisateur du WorkbenchVersion 3.3

156

Pour chaque type d'élément de langage contenu dans le journal, vous pouvez spécifier les attributsCouleur, Couleur d'arrière-plan et Gras.

Afficher le journalPour afficher les informations contenues dans le journal :

1. Ouvrez la vue Explorateur de sorties (Fenêtre ➤  Afficher la vue ➤  Explorateur desorties).

2. Si elle comporte plus d'un serveur, ouvrez le nœud du serveur requis pour afficher le journalassocié.

3. Double-cliquez sur le nœud Log ou cliquez dessus avec le bouton droit et sélectionnez  Ouvrir dans le menu contextuel.

Le journal s'ouvre et sa fenêtre est la fenêtre active.

Si vous avez effectué plusieurs exécutions, les informations précédentes du journal sont ajoutées autexte du journal existant. Si vous souhaitez effacer la sortie pour que le journal à la prochaine exécutiond'un programme ne contienne que les informations sur cette exécution, procédez de l'une des manièressuivantes :

Guide utilisateur du WorkbenchVersion 3.3

157

• Effacer le journal.

• Redémarrer le serveur (ce qui efface le journal et tous les résultats, ensembles de données,bibliothèques et références de fichier).

Si le journal contient beaucoup d'informations, voir la section Parcourir le journal.

Astuce :Vous pouvez contrôler comment les différents éléments (erreurs, avertissements et remarques, parexemple) sont représentés dans un journal. Voir la section Préférences concernant les couleurs dujournal.

Parcourir le journalSi vous avez exécuté plusieurs programmes, ou plusieurs instances du même programme, et que vousn'avez pas effacé le journal du serveur en question dans la vue Effacer le journal ou Redémarrerle serveur, chaque instance de la sortie a été ajoutée au journal dans l'ordre d'exécution.

Pour parcourir les informations contenues dans le fichier journal :

1. Ouvrez le journal comme décrit à la section Afficher le journal.2. Ouvrez la vue Structure (Fenêtre ➤  Afficher la vue ➤  Structure).

3. Cette vue affiche des nœuds pour toutes les entrées précédentes du journal et l'heure de leurcréation. Vous pouvez également voir les nœuds erreur ou avertissement. Lorsque vouscliquez sur un de ces nœuds, la section correspondante du fichier journal s'affiche.

Enregistrer le journal dans un fichierPour enregistrer le journal dans un fichier :

1. Ouvrez la vue Explorateur de sorties (Fenêtre ➤  Afficher la vue ➤  Explorateur desorties).

2. Effectuez l'une des opérations suivantes :

• Cliquez avec le bouton droit sur le nœud Journal et sélectionnez Enregistrer sous dansle menu contextuel.

• Ouvrez le journal dans la vue Éditeur (voir la section Afficher le journal), cliquez avec le boutondroit dans la fenêtre de l'éditeur et sélectionnez Enregistrer sous.

• Ouvrez le journal dans l'éditeur et sélectionnez Fichier ➤  Enregistrer sous dans le menuprincipal.

3. Utilisez la boîte de dialogue Enregistrer sous pour enregistrer le fichier à l'emplacement souhaité.

Guide utilisateur du WorkbenchVersion 3.3

158

Imprimer le journalPour imprimer le journal d'un serveur donné :

1. Ouvrez la vue Explorateur de sorties ( Fenêtre ➤  Afficher la vue ➤  Explorateur desorties).

2. Si elle comporte plus d'un serveur, ouvrez le nœud du serveur requis pour afficher la sortieassociée.

3. Effectuez l'une des opérations suivantes :

• Cliquez avec le bouton droit sur le nœud Journal et sélectionnez Imprimer le journaldans le menu contextuel.

• Ouvrez le journal dans la vue Éditeur (voir la section Afficher le journal), cliquez avec le boutondroit dans la fenêtre de l'éditeur et sélectionnez Imprimer, ou encore appuyez sur Ctrl + Psous Windows (Cmd - P sous MacOS).

• Ouvrez le journal dans l'éditeur et sélectionnez Fichier ➤  Imprimer dans le menu principal.

4. Utilisez la boîte de dialogue Imprimer pour envoyer le journal à l'imprimante souhaitée.

Effacer le journal1. Si vous souhaitez enregistrer un journal avant de l'effacer, procédez comme indiqué à la section

Enregistrer le journal dans un fichier.2. Pour effacer le contenu du journal d'un serveur donné, effectuez l'une des opérations suivantes :

• Dans le menu principal, sélectionnez WPS ➤  Effacer le journal ➤  Serveur local (ousélectionnez le nom du serveur souhaité au lieu de Serveur local).

• Vous pouvez utiliser le raccourci clavier Ctrl + Alt + L pour effacer le journal du serveur pardéfaut.

Remarque :Si vous avez enregistré plusieurs serveurs WPS, l'action ci-dessus efface le journal du serveurpar défaut. Si vous ne savez pas lequel des serveurs est le serveur par défaut, utilisez l'info-bulledu bouton de la barre d'outils pour savoir quel journal sera effacé.

• Dans la barre d'outils, cliquez sur pour effacer le journal du serveur par défaut, ou cliquez surla flèche de liste déroulante à côté de ce bouton pour sélectionner un autre serveur.

• Ouvrez la vue Explorateur de sorties (Fenêtre ➤ Afficher la vue ➤  Explorateurde sorties), cliquez avec le bouton droit sur le nœud Journal du serveur souhaité etsélectionnez Effacer le journal dans le menu contextuel.

Le fichier journal du serveur sélectionné est vide.

Guide utilisateur du WorkbenchVersion 3.3

159

Sortie PDFCette section du guide porte sur la sortie des résultats au format PDF.

Pour configurer la gestion automatique de la sortie PDF, voir la section Préférences concernant lesoptions de résultats.

Les paramètres par défaut de la sortie PDF sont spécifiés dans le fichier wps.cfg (voir la sectionFichiers de configuration), et sont les suivants :

• -BOTTOMMARGIN 1cm

• -LEFTMARGIN 1cm

• -RIGHTMARGIN 1cm

• -TOPMARGIN 1cm

• -ORIENTATION portrait

Le paramètre PAPERSIZE est déterminé automatiquement par les paramètres régionaux de WPSWorkbench (voir la section Paramètres LOCALE et ENCODING du serveur WPS). Il est possible de leréinitialiser à l'aide d'une sortie non gérée (voir ci-dessous).

L'option startpage, qui détermine si la sortie de chaque PROC commence sur une nouvelle page, nepeut pas être configurée dans WPS Workbench. Par défaut, elle est définie sur STARTPAGE=yes dansle logiciel ODS, ce qui signifie que chaque PROC commence sur une nouvelle page. Il est égalementpossible de réinitialiser l'option à l'aide d'une sortie non gérée (voir ci-dessous).

Pour créer une sortie non gérée, saisissez du code directement dans vos programmes, comme dansl'exemple ci-dessous :

options orientation=landscape;options papersize=A4;options topmargin=0.75in;options bottommargin=0.5in;options leftmargin=0.5in;options rightmargin=0.5in; ods pdf file="body.pdf" startpage=no; /* Startpage=no means that new pages are not generated between PROCs */ /* Insert PROCs to generate output */ ods_all_ close;

Remarque :Les parties pertinentes du code peuvent également être utilisées en tant qu'injections de code WPS.

Sortie sous forme de listeCette section du guide porte sur la sortie sous forme de liste des résultats.

Guide utilisateur du WorkbenchVersion 3.3

160

Préférences concernant les couleurs des listesLes options permettant de définir les préférences concernant les éléments présents dans les résultatssous forme de liste sont accessibles en sélectionnant Fenêtre ➤ Préférences ➤ WPS ➤ Colorationsyntaxique de la liste :

Pour chaque type d'élément de langage contenu dans une liste, vous pouvez spécifier les attributsCouleur, Couleur d'arrière-plan et Gras.

Afficher la sortie sous forme de listePour afficher la sortie sous forme de liste :

1. Ouvrez la vue Explorateur de sorties ( Fenêtre ➤  Afficher la vue ➤  Explorateur desorties).

2. Si elle comporte plus d'un serveur, ouvrez le nœud du serveur requis pour afficher la sortieassociée.

3. Double-cliquez sur le nœud Liste ou cliquez dessus avec le bouton droit et sélectionnez  Ouvrir dans le menu contextuel.

Guide utilisateur du WorkbenchVersion 3.3

161

La sortie sous forme de liste s'ouvre et sa fenêtre est la fenêtre active.

Si vous avez effectué plusieurs essais, les sorties précédentes seront concaténées aux résultatsexistants. Si vous souhaitez effacer la sortie pour que la liste à la prochaine exécution d'un programmene contienne que les résultats de cette exécution, procédez de l'une des manières suivantes :

• Effacer les résultats d'un programme (ce qui efface également la sortie Sortie HTML).

• Redémarrer le serveur (ce qui efface le journal et tous les résultats, ensembles de données,bibliothèques et références de fichier).

Parcourir la sortie sous forme de listeSi vous avez exécuté plusieurs programmes, ou plusieurs instances du même programme, et quevous n'avez pas effacé les résultats du serveur en question dans la vue Effacer les résultats d'unprogramme ou Redémarrer le serveur, alors chaque instance de la sortie sous forme de liste a étéajoutée au fichier de liste dans l'ordre d'exécution.

Pour parcourir la sortie sous forme de liste :

1. Ouvrez les résultats comme décrit à la section Afficher la sortie sous forme de liste.2. Ouvrez la vue Structure (Fenêtre ➤  Afficher la vue ➤  Structure).

3. Dans cette vue, la sortie des différents programmes est affichée sous forme d'arborescence, avecdes nœuds pour les divers éléments de sortie. Lorsque vous cliquez sur un de ces nœuds, lasection correspondante du fichier de liste s'affiche.

Enregistrer la sortie sous forme de liste dans un fichierPour enregistrer la sortie sous forme de liste dans un fichier :

1. Ouvrez la vue Explorateur de sorties ( Fenêtre ➤  Afficher la vue ➤  Explorateur desorties).

2. Effectuez l'une des opérations suivantes :

• Cliquez avec le bouton droit sur le nœud Liste et sélectionnez Enregistrer sous dans lemenu contextuel.

• Ouvrez la liste dans la vue Éditeur (voir la section Afficher la sortie sous forme de liste), cliquezavec le bouton droit dans la fenêtre de l'éditeur et sélectionnez Enregistrer sous.

• Ouvrez la liste dans l'éditeur et sélectionnez Fichier ➤  Enregistrer sous dans le menuprincipal.

3. Utilisez la boîte de dialogue Enregistrer sous pour enregistrer le fichier à l'emplacement souhaité.

Guide utilisateur du WorkbenchVersion 3.3

162

Imprimer la sortie sous forme de listePour imprimer la sortie sous forme de liste d'un serveur donné :

1. Ouvrez la vue Explorateur de sorties ( Fenêtre ➤  Afficher la vue ➤  Explorateur desorties).

2. Si elle comporte plus d'un serveur, ouvrez le nœud du serveur requis pour afficher la sortieassociée.

3. Effectuez l'une des opérations suivantes :

• Cliquez avec le bouton droit sur le nœud Liste et sélectionnez Imprimer les résultatsdans le menu contextuel.

• Ouvrez la liste dans la vue Éditeur (voir la section Afficher la sortie sous forme de liste), cliquezavec le bouton droit dans la fenêtre de l'éditeur et sélectionnez Imprimer, ou encoreappuyez sur Ctrl + P sous Windows (Cmd - P sous MacOS).

• Ouvrez la liste dans l'éditeur et sélectionnez Fichier ➤  Imprimer dans le menu principal.

4. Utilisez la boîte de dialogue Imprimer pour envoyer les résultats à l'imprimante souhaitée.

Sortie HTMLCette section du guide porte sur la sortie HTML des résultats.

Afficher la sortie HTMLPour afficher la sortie HTML :

1. Ouvrez la vue Explorateur de sorties ( Fenêtre ➤  Afficher la vue ➤  Explorateur desorties).

2. Si elle comporte plus d'un serveur, ouvrez le nœud du serveur requis pour afficher la sortieassociée.

3. Double-cliquez sur le nœud HTML ou cliquez dessus avec le bouton droit et sélectionnez  Ouvrir dans le menu contextuel.

Le fichier de sortie HTML s'ouvre et sa fenêtre est la fenêtre active.

Guide utilisateur du WorkbenchVersion 3.3

163

Parcourir la sortie HTMLSi vous avez opté pour que la sortie HTML soit gérée automatiquement par le Workbench (voir lasection Préférences concernant les options de résultats), chaque exécution crée un nouveau fichierHTML. Toutefois, si vous avez exécuté plusieurs programmes, ou plusieurs instances du mêmeprogramme, et que vous n'avez pas effacé les résultats du serveur en question dans la vue Effacerles résultats d'un programme ou Redémarrer le serveur, alors la sortie HTML précédente restedisponible dans la vue Structure.

Pour parcourir les sorties contenues dans le fichier HTML :

1. Ouvrez les résultats comme décrit à la section Afficher la sortie HTML.2. Ouvrez la vue Structure (Fenêtre ➤  Afficher la vue ➤  Structure).

3. Dans cette vue, la sortie des différents programmes est affichée sous forme d'arborescence, avecdes nœuds pour les divers éléments de sortie. Lorsque vous cliquez sur un de ces nœuds, lasection correspondante de la sortie HTML s'affiche.

Imprimer la sortie HTMLPour imprimer la sortie HTML :

1. Ouvrez la vue Explorateur de sorties (Fenêtre ➤  Afficher la vue ➤  Explorateur desorties).

2. Si elle comporte plus d'un serveur, ouvrez le nœud du serveur requis pour afficher la sortieassociée.

3. Effectuez l'une des opérations suivantes :

• Cliquez avec le bouton droit sur le nœud HTML et sélectionnez Imprimer les résultatsdans le menu contextuel.

• Ouvrez le fichier HTML dans la vue Éditeur (voir la section Afficher la sortie HTML), cliquez avecle bouton droit dans la fenêtre de l'éditeur et sélectionnez Imprimer, ou encore appuyez surCtrl + P sous Windows (Cmd - P sous MacOS).

• Ouvrez le fichier HTML dans l'éditeur et sélectionnez Fichier ➤  Imprimer dans le menuprincipal.

4. Utilisez la boîte de dialogue Imprimer pour envoyer les résultats à l'imprimante souhaitée.

Remarque :Un seul fichier de sortie HTML est créé pour chaque exécution au sein du Workbench. Cependant,vous ne pouvez imprimer que la sortie HTML d'une seule exécution à la fois.

Guide utilisateur du WorkbenchVersion 3.3

164

Effacer les résultats d'un programme1. Si vous souhaitez enregistrer la sortie avant de l'effacer, enregistrez le fichier PDF à un autre

emplacement si vous avez utilisé la destination PDF, ou procédez comme indiqué à la sectionEnregistrer la sortie sous forme de liste dans un fichier.

2. Pour effacer les résultats d'un programme sur un serveur donné, effectuez l'une des opérationssuivantes :

• Dans le menu principal, sélectionnez WPS ➤   ➤ Effacer les résultats ➤  Serveur local (ousélectionnez le nom du serveur souhaité au lieu de Serveur local).

• Vous pouvez utiliser le raccourci clavier Ctrl + Alt + O pour effacer les résultats du serveur pardéfaut.

Remarque :Si vous avez enregistré plusieurs serveurs WPS, l'action ci-dessus efface les résultats duserveur par défaut. Si vous ne savez pas lequel des serveurs est le serveur par défaut, utilisezl'info-bulle du bouton de la barre d'outils pour savoir quels résultats seront effacés.

• Dans la barre d'outils, cliquez sur pour effacer les résultats du serveur par défaut, ou cliquezsur la flèche de liste déroulante à côté de ce bouton pour sélectionner un autre serveur.

• Ouvrez la vue Explorateur de sorties (Fenêtre ➤ Afficher la vue ➤  Explorateur desorties), cliquez avec le bouton droit sur la sortie liste, HTML ou PDF du serveurconcerné, et sélectionnez Effacer tous les résultats dans le menu contextuel.

Toutes les sorties sont effacées.

Remarque :L'effet de cette option diffère de celui de la commande Redémarrer le serveur car vous conservez lecontexte de votre travail et ne perdez pas votre travail temporaire.

Redémarrer le serveurÀ chaque fermeture du Workbench, les résultats associés à la session (le journal et les sorties derésultats, les références de fichiers, les bibliothèques, les ensembles de données et autres) sonteffacés. Toutefois, si vous souhaitez effacer ces informations avant la fin de la session du Workbench,il suffit de redémarrer le serveur WPS, comme indiqué ci-dessous.

Avertissement :Les programmes ne pourront plus interagir avec les objets créés avant le redémarrage.

Si vous souhaitez seulement effacer le journal ou les résultats en conservant le reste des sorties,procédez comme indiqué aux sections Effacer le journal et Effacer les résultats d'un programme,respectivement.

Guide utilisateur du WorkbenchVersion 3.3

165

Procédez comme suit pour redémarrer le serveur :

1. Effectuez l'une des opérations suivantes :

• Si vous souhaitez redémarrer le serveur WPS par défaut, vous pouvez utiliser le raccourci clavier(par défaut, Ctrl+Alt+S).

• Dans le menu principal, sélectionnez WPS ➤  Redémarrer le serveur ➤ Serveur local (ouremplacez Serveur local par le nom du serveur WPS distant utilisé).

• Cliquez avec le bouton droit sur le serveur requis dans la vue Explorateur de liens, Explorateur de serveurs WPS, Explorateur de résultats ou Explorateur de sorties, et

sélectionnez Redémarrer dans le menu contextuel.

Remarque :Si l'option Afficher les actions du serveur avancé est activée dans la boîte de dialoguePréférences WPS concernant l'exécution des programmes, l'option de menu Redémarrer n'estpas disponible. Voir la section Redémarrer avec les actions de serveur avancées.

2. Une fenêtre de confirmation peut s'afficher, vous permettant d'annuler le redémarrage si vous lesouhaitez. Cliquez sur OK pour tout effacer – le journal, tous les résultats de sortie, les référencesde fichier, les bibliothèques, les ensembles de données, etc. – pour ce serveur. Si vous avezcoché l'option Ne plus afficher cette confirmation, la boîte de dialogue de confirmation n'est pasaffichée.

3. Les ensembles de données et les références de fichiers sont supprimés de la vue Explorateurde serveurs WPS, la liste et les résultats HTML sont retirés de la vue Explorateur de sorties,le journal associé est effacé, et les liens vers les résultats sont retirés de la vue Explorateur derésultats.

Redémarrer avec les actions de serveur avancéesCette section ne concerne que les utilisateurs chez qui l'option Afficher les actions du serveur avancéest activée dans la boîte de dialogue Préférences. Si cette option est activée, le menu contextueld'un serveur WPS dans la vue Explorateur de serveurs WPS, Explorateur de sorties ou Explorateur de résultats présente les options suivantes pour le redémarrage du serveur, au lieu de lasimple option Redémarrer :

• Redémarrer, nouveau WORK – Redémarrer et effacer tout le contenu de la bibliothèque WORK(comme un redémarrage normal).

• Redémarrer, garder WORK – Redémarrer et conserver tout le contenu de la bibliothèque WORK.

Guide utilisateur du WorkbenchVersion 3.3

166

Configuration client/serveurde WPS LinkSi vous avez configuré une ou des connexions et serveurs distants, trois éléments sont nécessairespour une configuration client/serveur WPS Link : un serveur SSH (Secure Shell), le logiciel WPS et lesclés de licence WPS requises pour les différents composants.

Serveur SSHWPS Link nécessite l'utilisation d'une connexion SSH entre les machines client et serveur. Ceci n'estpas fourni avec le logiciel WPS. Toutefois :

• Pour un serveur UNIX (Linux, Solaris ou AIX), le démon SSH intégré peut être utilisé.• Pour un serveur Windows, un outil SSH tiers est disponible auprès de Bitvise.

Remarque :Bitvise SSH est actuellement le seul outil SSH officiellement pris en charge par World Programmingpour un serveur Windows.

WPSWPS est fourni sous la forme d'un fichier d'installation unique qui inclut toutes les fonctions WPSrequises pour l'utilisation de WPS Link, y compris WPS Workbench, Java Runtime Environment et lecomposant serveur WPS, qui est la partie du logiciel à laquelle s'applique la licence.

Vous aurez besoin des fichiers d'installation de WPS correspondant respectivement au systèmed'exploitation des machines serveur et client. Par exemple, si vous utilisez un serveur Linux et desmachines client Windows, vous aurez besoin du fichier d'installation Linux pour le serveur et desfichiers d'installation Windows appropriés (32 ou 64 bits) pour les clients. Veuillez consulter le guided'installation pour la plate-forme concernée pour plus d'informations sur le processus d'installation deWPS.

Clés de licence WPSPour qu'une instance de WPS puisse exécuter un programme écrit en langage SAS, le composantWPS Server doit avoir été activé en appliquant une clé de licence WPS (fournie séparément du logiciel– voir la section Appliquer une licence).

• Si vous souhaitez restreindre l'exécution des programmes au serveur lié, vous n'avez besoin d'uneclé de licence que pour l'instance de WPS présente sur le serveur.

• Si vous voulez exécuter des programmes sur les machines client comme sur le serveur lié, vousavez besoin de clés de licence distinctes pour les installations serveur et client de WPS.

Guide utilisateur du WorkbenchVersion 3.3

167

Résumé de l'installation client/serveurVous trouverez ci-dessous une brève présentation des étapes requises pour installer une solutionclient/serveur WPS Link.

Important :La personne qui installe WPS et applique les clés de licence doit disposer des privilègesd'administrateur système sur les machines concernées.

1. Hors de WPS, configurez et testez la connexion SSH entre serveur et clients conformément auxplates-formes et aux méthodes d'authentification utilisées sur votre site (consultez le document WPSLink – Guide utilisateur et référence pour plus d'informations).

2. Effectuez une installation complète de WPS sur le serveur si vous allez exécuter des programmessur cette machine. Lorsque vous lancez WPS sur le serveur, un message vous inviteimmédiatement à appliquer la licence.

3. Si ce n'est pas encore fait, installez WPS sur la ou les machines client. (Lorsque vous lancez WPSsur un client, un message vous invite immédiatement à appliquer la licence de poste de travail.)

Remarque :Toutefois, si vous ne souhaitez exécuter les programmes que sur le serveur lié, et que vous n'avezdonc pas besoin d'une installation sous licence de WPS sur ce client, vous pouvez alors isolerle Serveur local WPS de l'installation, à condition que ce client soit sur Windows (voir la sectionConfigurer l'installation locale de WPS).

4. Dans WPS, créez une liaison avec l'ordinateur distant. Il suffit de deux étapes :

a. Créez une connexion avec l'hôte distant (voir la section Créer une connexion à un hôte distant).b. Ajoutez un serveur WPS à l'hôte distant. Ce serveur exécute vos programmes à distance (voir la

section Créer un serveur WPS).

Gérer les connexions aux hôtes locauxet distantsCette section couvre les propriétés des connexions aux hôtes distants comme locaux, y compris lacréation de raccourcis de répertoire, ainsi que l'importation et l'exportation de définitions de connexion.

Astuce :Vous pouvez également créer un raccourci de répertoire dans la vue Explorateur de fichiers encliquant avec le bouton droit sur le dossier souhaité, puis en sélectionnant Nouveau ➤ Raccourci derépertoire et en entrant un nom pour le raccourci dans le champ Nom du répertoire de la boîte dedialogue Raccourci de répertoire.

Guide utilisateur du WorkbenchVersion 3.3

168

Propriétés de la connexion à l'hôte local(raccourcis de répertoire)Pour visualiser ces propriétés, sélectionnez la connexion hôte Local dans la vue Explorateur de liens,cliquez dessus avec le bouton droit et sélectionnez Propriétés dans le menu contextuel. La seulepropriété disponible pour une connexion hôte Local est Raccourcis de répertoire.

Un raccourci de répertoire est un raccourci vers un répertoire du système de fichiers local. Lesraccourcis locaux créés par défaut diffèrent en fonction du système d'exploitation sous lequel vousexécutez le Workbench :

• Utilisateurs de Windows : raccourcis Home (Accueil) et Workspace (Espace de travail), ainsiqu'un raccourci pour chaque disque local disponible. Par exemple, si vous avez des lecteurs C: et D:sur votre ordinateur, il y a quatre raccourcis de répertoire par défaut.

• Autres systèmes d'exploitation : seuls les raccourcis ~/ (Home, ou Accueil) et / (Root, ou Racine)sont créés par défaut.

Pour définir un nouveau raccourci, cliquez sur Ajouter pour afficher la boîte de dialogue suivante :

Dans Nom du répertoire, saisissez le nom de raccourci à utiliser et, en regard de Chemin durépertoire, cliquez sur Parcourir, sélectionnez le répertoire, puis cliquez sur OK. Le nom du raccourciapparaît alors dans la vue Explorateur de fichiers du système de fichiers hôte lorsque la connexionhôte est ouverte. Vous pouvez double-cliquer sur un raccourci pour modifier sa définition.

D'autres raccourcis peuvent être ajoutés, modifiés et supprimés depuis cette page de propriétés.

Créer une connexion à un hôte distantIl est nécessaire d'avoir un accès à une machine où un serveur WPS est installé sur une plate-forme compatible. De plus, il est nécessaire d'avoir un accès SSH à cette machine, et de connaîtrel'emplacement de l'installation WPS. Il vous faudra peut-être contacter l'administrateur de la machinepour obtenir ces informations et le droit d'accès. Pour plus d'informations sur l'authentification SSH,consultez le document WPS Link – Guide utilisateur et référence.

Procédez comme suit pour créer une connexion à un hôte distant :

1. Ouvrez l'assistant Nouvelle connexion à l'hôte distant de l'une des manières suivantes :

Guide utilisateur du WorkbenchVersion 3.3

169

• Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets) et cliquez sur Créer une connexion hôte à distance.

• Dans le menu principal, sélectionnez WPS ➤ Lien ➤ Nouvelle connexion à l'hôte distant.

2. Dans la boîte de dialogue Nouvelle connexion serveur, choisissez l'une des options suivantes :

• Nouvelle connexion SSH (compatibilité avec 3.1)• Nouvelle connexion SSH (3.2 et plus récente – UNIX, MacOSX, Windows)

La première option permet une compatibilité descendante, avec un comportement identique àcelui de WPS version 3.1. La deuxième option permet d'établir des connexions avec des serveursdistants utilisant Bitvise SSH Server. Que vous ayez besoin de Bitvise ou non, il est préférable dechoisir cette option, sauf raison spécifique.

Remarque :Vous devez savoir que, si vous sélectionnez 3.2 et plus récente, puis que vous revenez à WPSversion 3.1, vous perdrez les connexions hôte distant définies dans WPS version 3.2.

3. Cliquez sur Suivant et renseignez la boîte de dialogue suivante :

Guide utilisateur du WorkbenchVersion 3.3

170

• Pour Nom d'hôte, entrez le nom ou l'adresse IP de la machine distante à laquelle vous voulezvous connecter.

• Dans Port, indiquez si nécessaire un port autre que le port par défaut 22, mais seulement aprèsavoir consulté votre administrateur système.

• Le champ Nom de la connexion prend par défaut la même valeur que Nom d'hôte, mais vouspouvez remplacer cette valeur par un nom décrivant la connexion.

À retenir :Les noms de connexion doivent être uniques. Par conséquent, si vous créez plusieursconnexions au même hôte, vous devrez modifier le champ Nom de la connexion à chaque fois.

• Dans Nom d'utilisateur, saisissez votre ID d'utilisateur sur l'hôte distant.• Pour les deux dernières cases à cocher, vérifiez que Ouvrir la connexion maintenant est

sélectionné si vous souhaitez ouvrir immédiatement la connexion, et que Ouvrir la connexionautomatiquement au démarrage du Workbench est sélectionné si vous souhaitez établir laconnexion automatiquement au démarrage de WPS Workbench.

Astuce :Si vous avez l'intention d'utiliser régulièrement cette connexion, sélectionnez Ouvrir laconnexion automatiquement au démarrage du Workbench afin que la connexion soit déjàouverte au démarrage du serveur associé.

4. Cliquez sur Suivant pour définir les raccourcis de répertoire de la connexion.

Guide utilisateur du WorkbenchVersion 3.3

171

Un raccourci de répertoire est un raccourci vers un chemin d'accès sur le système de fichiersde l'hôte. Par défaut, il existe des raccourcis de répertoire définis pour Accueil (ou Home, ~/) etRacine (ou Root, /). Pour définir un nouveau raccourci, cliquez sur Ajouter pour afficher la boîte dedialogue suivante :

Dans Nom du répertoire, saisissez le nom de raccourci à utiliser et dans Chemin du répertoire,entrez le chemin d'accès complet (tel qu'il figure lorsque vous survolez l'emplacement dans lavue Explorateur de fichiers), puis cliquez sur OK. Le nom du raccourci apparaît alors dans lavue Explorateur de fichiers du système hôte. Vous pouvez double-cliquer sur un raccourci pourmodifier sa définition.

5. Cliquez sur Terminer. Si vous n'avez pas encore validé l'authenticité de l'hôte distant, une boîte dedialogue Message SSH2 de ce type s'affiche :

Guide utilisateur du WorkbenchVersion 3.3

172

Si vous êtes certain que l'identité de l'hôte est correcte, cliquez sur Oui. Si vous configurez cetteconnexion dans un environnement de production, vous devez confirmer clairement auprès d'unadministrateur système que l'empreinte de clé RSA affichée pour l'hôte distant correspond à cellede l'hôte auquel vous voulez vous connecter. Une fois la clé de l'hôte confirmée, elle est stockéedans WPS Workbench, et il n'est plus nécessaire de la confirmer lors des tentatives de connexionsuivantes sur la même machine hôte.

6. Si vous avez choisi d'ouvrir immédiatement la connexion, vous êtes invité à fournir un mot de passepour vous authentifier auprès de la machine hôte. Une fois que votre administrateur système vousa fourni le mot de passe, saisissez ce dernier dans la boîte de dialogue Mot de passe requis etcliquez sur OK.

Une entrée figure maintenant dans la vue Explorateur de liens pour votre nouvelle connexion. Il vousfaut ensuite ajouter des définitions de serveur WPS à cette connexion pour utiliser WPS (voir la sectionCréer un serveur WPS).

Propriétés de la connexion à un hôte distantPour visualiser ces propriétés, sélectionnez la connexion la vue Explorateur de liens, cliquez dessusavec le bouton droit et sélectionnez Propriétés dans le menu contextuel. Les éléments figurant àgauche de la boîte de dialogue Propriétés sont les suivantes :

Options de connexion à distanceVous pouvez y définir les paramètres de la connexion à l'hôte distant.

• Les entrées Nom de l'hôte, Port et Nom de l'utilisateur permettent de spécifier le nom de lamachine ou l'adresse IP du serveur distant, le port SSH (défini par défaut sur 22 s'il n'est passpécifié), et le nom de l'utilisateur sous lequel vous souhaitez vous connecter à l'hôte.

• La case à cocher Ouvrir automatiquement la connexion détermine si la connexion s'ouvreautomatiquement lorsque le Workbench démarre.

• La case à cocher Activer la compression détermine si la connexion SSH, et, parconséquent, le trafic de protocole entre le Workbench et la connexion à distance, doivent êtrecompressés.

Guide utilisateur du WorkbenchVersion 3.3

173

• La case à cocher Utiliser la redirection de port SSH détermine si la connexion SSH doitutiliser la redirection de port SSH pour envoyer les informations d'E/S standard entre laconnexion distante et le Workbench. Cette opération exige que votre démon SSH soit enfonctionnement avec la mention « AllowTcpForwarding yes » spécifiée dans le fichier deconfiguration. Si celle-ci n'est pas activée dans la configuration de votre démon SSH, vousdevez laisser cette option non sélectionnée, ou contacter votre administrateur de systèmespour obtenir l'activation.

• La case à cocher Vérifier le nom de l'hôte vérifie simplement que l'hôte que vous avezspécifié dans le champ Nom de l'hôte existe. Si vous êtes en train de configurer l'hôtedistant, ou si vous savez qu'il va être configuré à un moment donné, désélectionnez la casepour que le Workbench vous permette d'enregistrer les paramètres. Sinon, un messaged'erreur s'affiche, et vous êtes invité à spécifier le nom d'un hôte existant.

Raccourcis de répertoireUn raccourci de répertoire est un raccourci vers un répertoire du système de fichiers distant. Pardéfaut, les raccourcis sont définis pour Home, ou Accueil (~/) et Root, ou Racine (/) (c'est-à-dire le répertoire racine du système de fichiers).Pour définir un nouveau raccourci, cliquez sur Ajouter pour afficher la boîte de dialoguesuivante :

Dans Nom du répertoire, saisissez le nom de raccourci à utiliser et dans Chemindu répertoire, entrez le chemin d'accès complet (tel qu'il figure lorsque vous survolezl'emplacement dans la vue Explorateur de fichiers), puis cliquez sur OK. Le nom du raccourciapparaît alors dans la vue Explorateur de fichiers du système hôte lorsque la connexion hôteest ouverte. Vous pouvez double-cliquer sur un raccourci pour modifier sa définition. D'autresraccourcis peuvent être ajoutés, modifiés et supprimés depuis cette page de propriétés.

Options de connexion avancéesDans certaines circonstances, il est nécessaire de contrôler la liste des variables d'environnementque le serveur distant hérite lors de son démarrage. Par défaut, le processus du serveur n'hériteque de l'environnement shell interactif par défaut associé à l'utilisateur dont l'identifiant a été utiliséau démarrage du serveur. Par exemple, il peut s'agir des variables d'environnement requises pourutiliser un moteur de bibliothèque de base de données. Sous Linux, par exemple, cela peut exigerl'addition des bibliothèques partagées du client de base de données au chemin LD_LIBRARY_PATH,afin qu'elles puissent être chargées par le logiciel WPS. Pour y parvenir, vous pouvez modifier le fichier/etc/profile ou ~/.profile afin d'ajouter les répertoires exigés au chemin LD_LIBRARY_PATH.

Guide utilisateur du WorkbenchVersion 3.3

174

Toutefois, ceci n'est pas toujours souhaitable. L'autre possibilité, dans UNIX/Linux, consiste à insérerun fichier ~/wpsenv.sh dans le répertoire d'installation de WPS ou dans votre répertoire d'accueil.Son contenu est automatiquement exécuté avant le démarrage du serveur. Les sorties de toutes lescommandes que vous exécutez de cette manière peuvent être visualisées dans la vue Console(voir la section Console (pour la sortie standard des serveurs distants)).

Si vous souhaitez que le serveur WPS utilise des variables d'environnement spécifiques sousWindows, vous devez configurer ces variables d'environnement selon la procédure normale – enutilisant le Panneau de configuration pour les définir en tant que variables d'environnement dusystème ou en tant que variables propres à l'utilisateur pertinent.

Avertissement :Tous les processus exécutés par cet utilisateur voient ces variables, et il n'est pas possible de spécifierqu'elles s'appliquent uniquement au processus WPS.

Créer un serveur WPSWPS Workbench vous permet d'avoir plusieurs définitions de serveur WPS sur une même connexionhôte.

Procédez comme suit pour définir un nouveau serveur :

1. Une fois que vous avez vérifié que la connexion est ouverte, lancez l'assistant Nouveau serveurWPS de l'une des manières suivantes :

• Ouvrez la vue Explorateur de liens (Fenêtre ➤ Afficher la vue ➤  Explorateur deliens), cliquez avec le bouton droit sur la connexion hôte à laquelle ajouter un serveur, puischoisissez Nouveau serveur WPS dans le menu contextuel.

• Dans le menu principal, sélectionnez WPS ➤ Lien ➤ Nouveau serveur WPS ➤ Local (ouremplacez Local par le nom de votre serveur WPS distant).

2. Dans la boîte de dialogue Nouveau serveur WPS, renseignez le champ Nom du serveur (ce nomdoit être unique sur l'ensemble des connexions).

Remarque :Si vous définissez un serveur WPS distant, un champ nommé Répertoire d'installation de basede WPS figure dans la boîte de dialogue, et vous devez y spécifier l'emplacement d'installation deWPS sur l'hôte distant, par exemple :

Guide utilisateur du WorkbenchVersion 3.3

175

3. Pour les deux dernières cases à cocher, vérifiez que Démarrer le serveur maintenant estsélectionné si vous souhaitez démarrer immédiatement le serveur, et que Lancer le serveurautomatiquement dès la connexion au démarrage est sélectionné si vous souhaitez que leserveur soit lancé chaque fois que la connexion est ouverte.

4. Cliquez sur Terminer pour fermer l'assistant et créer la définition de serveur.

Il y a maintenant des entrées dans les vues Explorateur de liens, Explorateur de serveurs WPS,Explorateur de sorties et Explorateur de résultats correspondant au nouveau serveur WPS. Procédezcomme décrit à la section Propriétés du serveur WPS local ou Propriétés du serveur WPS distant,selon le cas, pour configurer les options de démarrage du serveur.

Exporter les définitions de connexions hôte versun fichierPour simplifier le partage des définitions de connexion aux hôtes au sein d'un groupe de travail, oupour vous permettre de copier les définitions de connexion entre les espaces de travail, vous pouvezexporter les définitions de connexion vers un fichier en procédant comme suit :

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur de liens).

2. Sélectionnez les connexions que vous souhaitez exporter dans la liste de la vue Explorateur deliens.

3. Cliquez avec le bouton droit et sélectionnez Exporter la connexion hôte dans le menucontextuel.

Guide utilisateur du WorkbenchVersion 3.3

176

4. Dans la boîte de dialogue Exporter vers un fichier qui s'affiche, saisissez le nom du fichier à créer.Ce fichier contient les définitions de connexion exportées au format XML, et porte l'extension .cdx.

Les définitions de connexion hôte seront enregistrées dans le fichier sélectionné. Ce fichier peutensuite être distribué dans votre groupe de travail, ou importé directement dans un autre espace detravail sur votre machine. Pour importer les définitions de connexion dans un espace de travail, voir lasection Importer les définitions de connexion hôte depuis un fichier.

Importer les définitions de connexion hôte depuisun fichierPour effectuer cette tâche, vous devez avoir auparavant exporté des définitions de connexion dans unfichier, ou avoir reçu un fichier d'exportation créé par un autre membre de votre groupe de travail.

1. Ouvrez la boîte de dialogue Importer la connexion à l'hôte en effectuant l'une des opérationssuivantes :

• Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deprojets) et cliquez sur Importer une définition de connexion à l'hôte.

• Dans le menu principal, sélectionnez WPS ➤ Lien ➤ Importer la connexion à l'hôte distant.

2. À l'aide de la boîte de dialogue Importer la connexion à l'hôte, sélectionnez le fichier de définitionde connexion (signalé par le suffixe .cdx) contient les définitions de connexion exportées plus tôt.

Astuce :Les connexions peuvent également être importées en faisant glisser un fichier .cdx sur la vueExplorateur de liens.

Les définitions de connexion hôte sont importées depuis le fichier sélectionné. S'il existe un conflitde noms, la définition de la connexion importée est automatiquement renommée afin d'avoir un nomunique au sein de votre liste de connexions.

Exporter les définitions des serveurs WPS vers unfichierPour simplifier le partage des définitions de serveur au sein d'un groupe de travail, ou pour vouspermettre de copier les définitions de serveur entre les espaces de travail, vous pouvez exporter lesdéfinitions de serveur WPS vers un fichier qui peut être importé dans un autre espace de travail.

1. Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur de liens).

2. Sélectionnez les serveurs à exporter dans la liste de la vue Explorateur de liens.

Guide utilisateur du WorkbenchVersion 3.3

177

3. Cliquez avec le bouton droit et sélectionnez Exporter la définition de serveur WPS dans le menucontextuel.

4. Dans la boîte de dialogue Exporter vers un fichier qui s'affiche, saisissez le nom du fichier à créer.Ce fichier contient les définitions de serveur exportées au format XML et porte l'extension .sdx.

Les définitions de serveur WPS sont enregistrées dans le fichier sélectionné. Ce fichier peut ensuiteêtre distribué dans votre groupe de travail, ou importé directement dans un autre espace de travailsur votre machine. Pour importer les définitions de serveur dans un espace de travail, voir la sectionImporter les définitions de serveur WPS à partir d'un fichier.

Importer les définitions de serveur WPS à partird'un fichierCette tâche ne peut être effectuée qu'aux conditions suivantes :

• Vous avez auparavant exporté des définitions de serveur WPS, ou un fichier d'exportation créé parune autre personne de votre organisation vous a été transmis.

• Au moins une connexion hôte doit déjà être configurée, car le serveur WPS est associé à uneconnexion hôte. (C'est déjà le cas si vous créez un serveur local, car une connexion locale estfournie, mais pas forcément si vous créez un serveur distant, pour lequel une connexion existanteest requise, comme décrit à la section Créer une connexion à un hôte distant).

1. Ouvrez la boîte de dialogue Importer depuis le fichier en effectuant l'une des opérationssuivantes :

• Ouvrez la vue Explorateur de projets (Fenêtre ➤ Afficher la vue ➤  Explorateur deliens), sélectionnez une Connexion hôte et cliquez sur Importer la définition deserveur WPS.

• Dans le menu principal, choisissez WPS ➤  Lien ➤  Importer le serveur WPS ➤  Nom de laconnexion à l'hôte.

2. À l'aide de la boîte de dialogue Importer à partir d'un fichier, sélectionnez le fichier de définition deserveur (signalé par le suffixe .sdx) qui contient les définitions de connexion exportées plus tôt.

Astuce :Vous pouvez également importer des serveurs en faisant glisser un fichier *.sdx sur un nœud deconnexion hôte dans la vue Explorateur de liens.

3. Il est également possible d'importer des serveurs en faisant glisser les fichiers de définition deserveur WPS (*.sdx) sur un nœud de connexion hôte dans la vue Explorateur de liens.

Les définitions de serveur WPS sont importées à partir du fichier sélectionné. S'il existe un conflit denoms, la définition de serveur importée est automatiquement renommée afin d'avoir un nom unique ausein de votre liste de serveurs WPS.

Guide utilisateur du WorkbenchVersion 3.3

178

Connectivité avec les basesde donnéesCette section offre une brève présentation de la configuration de la connectivité sous Windows pourles types de bases de données externes les plus communs, afin de faciliter la gestion de vos donnéesdans Workbench.

Remarque :Pour plus de détails sur les moteurs de bibliothèque WPS, voir le document WPS Reference ForLanguage Elements.

IntroductionWPS Workbench peut être utilisé avec les systèmes de gestion de base de données suivants, soit viaODBC (Open Database Connectivity), soit via les clients natifs associés :

• Oracle, via Oracle Instant Client – voir la section Connexion à une base de données Oracle.• DB2, via IBM Data Server Runtime Client – voir la section Connexion à une base de données DB2.• SQL Server, via SQL Server Native Client – voir la section Connexion à une base de données SQL

Server.• MySQL, via MySQL Connector/C – voir la section Connexion à une base de données MySQL.

Remarque :Lorsque c'est possible, il est toujours préférable d'utiliser le client de SGDBR natif plutôt qu'un clientODBC, afin de bénéficier d'une meilleure prise en charge des options de base de données et dulangage SAS. Sinon, voir la section Connexion à une base de données à l'aide d'ODBC.

Pilotes clients pris en chargeLes connecteurs clients suivants sont pris en charge :

Moteur Client Windows

Oracle Instant Client 11

DB2 IBM Data Server Runtime Client 10.5

SQL Server Microsoft SQL Server 2008 Native Client

MySQL Connector/C 6.0

Guide utilisateur du WorkbenchVersion 3.3

179

Connexion à une base de donnéesOracleIl est possible d'obtenir des données d'une base de données Oracle en se connectant depuis WPS surune plate-forme plate-forme Windows.

Avant d'installer le client Oracle, vérifiez les points suivants :

• WPS est bien installé et dispose d'une licence.• Vous bénéficiez des droits d'administrateur nécessaires pour installer WPS ainsi que le client

Oracle.

Remarque :Lors de l'installation du client Oracle, vérifiez les points suivants :

• Assurez-vous que vous utilisez le même type d'installation que pour WPS Workbench – vous devezutiliser la version Windows 32 bits ou 64 bits pour les deux logiciels.

• Il est conseillé de télécharger la version du client correspondant à la base de données Oracle àlaquelle vous vous connectez.

Le connecteur doit être installé sur l'ordinateur ou le serveur où s'exécutent vos programmes enlangage SAS. Procédez comme suit :

1. Téléchargez l'archive de base d'Oracle Instant Client depuis la page Instant Client du site Webd'Oracle.

2. Une fois le fichier d'installation (.zip) approprié téléchargé, créez un dossier où placer le client survotre ordinateur, par exemple C:\oracle, et décompressez-y le contenu du fichier :

3. Ajoutez le répertoire d'installation d'Oracle Instant Client à la variable système Path en procédantcomme suit :

a. Dans le Panneau de configuration, sélectionnez Système ➤ Paramètres système avancés.

b. Sélectionner Variables d'environnement, puis Modifier, et ajoutez le chemin d'accès à lavariable système Path.

4. Démarrez WPS Workbench pour vous assurer que les modifications apportées à la variabled'environnement Path sont disponibles.

Vous pouvez consulter la valeur de la variable Path dans WPS Workbench à l'aide d'un programmeen langage SAS :

DATA _null_;

LENGTH pathname $ 32760;pathname = SYSGET('PATH');PUT pathname= ;RUN;

Guide utilisateur du WorkbenchVersion 3.3

180

Les résultats affichés dans le journal devraient contenir le chemin du répertoire d'installationd'Oracle Instant Client, ajouté à l'étape précédente.

Une fois le client installé, testez la connectivité à la base de données en utilisant le programme suivantdans WPS Workbench :

LIBNAME DATASRC ORACLE user=<nom-utilisateur> password=<mot-de-passe> path='<id-serveur-distant>/TNS';PROC DATASETS library=DATASRC;run;

Remplacez <nom-utilisateur> et <mot-de-passe> par votre nom d'utilisateur et votre mot depasse pour accéder au serveur. L'option Path contient le nom du serveur, spécifié par <id-serveur-distant>, et éventuellement un nom TNS. La commande PROC DATASETS renvoie le nom de toutesles tables présentes dans la base de données sélectionnée. Pour les bases de données comportantbeaucoup de tables, l'exécution de ce programme peut prendre un certain temps.

Remarque :Pour obtenir tous les détails sur PROC DATASETS, voir le guide WPS Reference For LanguageElements.

Connexion à une base de données DB2Avant d'installer IBM Data Server Runtime Client, vérifiez les points suivants :

• WPS est bien installé et dispose d'une licence.• Vous bénéficiez des droits d'administrateur nécessaires pour installer WPS ainsi qu'IBM Data

Server Runtime Client.

Remarque :Lors de la sélection du client, vérifiez que vous utilisez le même type d'installation que pour WPSWorkbench – vous devez utiliser la version Windows 32 bits de WPS avec le client 32 bits AMD/Intelx86, ou la version 64 bits de WPS Workbench avec le client Windows AMD64/Intel EM64T.

Procédez comme suit :

1. Téléchargez IBM Data Server Runtime Client depuis la page Download Clients and Drivers du siteWeb d'IBM.

2. Une fois le téléchargement effectué, trouvez et exécutez le fichier d'installation. Suivez lesinstructions de l'assistant pour le type d'installation Typical.

Remarque :Pour faciliter une utilisation ultérieure, il est conseillé de placer le dossier d'installation sur le cheminsystème.

Guide utilisateur du WorkbenchVersion 3.3

181

3. Définissez la variable d'environnement DB2CMDEXE pour qu'elle pointe vers le fichier db2cmd.exe(généralement C:\Program Files\IBM\SQLLIB\BIN\db2cmd.exe), en procédant commesuit :

a. Dans le Panneau de configuration, sélectionnez Système ➤ Paramètres système avancés.

b. Sélectionnez Variables d'environnement, puis Nouveau.c. Créez une variable système en donnant à Nom de la variable la valeur DB2CMDEXE, et en

définissant Valeur de la variable sur le répertoire d'installation du client DB2, par exemple C:\Program Files\IBM\SQLLIB\BIN\db2cmd.exe.

4. Après l'installation, vous devez configurer la connexion entre le client et le serveur auquel vous allezaccéder :

a. Ouvrez l'invite de commande et exécutez DB2CMD. Dans la nouvelle fenêtre, entrez DB2 pouraccéder au processeur en ligne de commande du client DB2.

b. Créez un nœud faisant référence à la bases de données distante à l'aide de la commandesuivante :

catalog TCPIP node <nom-nœud> REMOTE <serveur> SERVER <service-port>

<nom-nœud> est le nom de la connexion locale, <serveur> est l'adresse IP ou le nom du serveurhébergeant la base de données, et <service-port> est soit le numéro de port sur le serveur, soitle nom de l'instance de base de données sur le serveur.

c. Créez une référence d'instance de base de données (que vous connecterez à l'aide duparamètre <nom-nœud> créé à l'étape précédente) en utilisant la commande suivante :

catalog database <nom-base-de-données> AS <nom-alias> AT NODE <nom-nœud>

<nom-base-de-données> est l'instance de la base de données sur le serveur DB2, <nom-alias>est le nom que vous utiliserez dans le client DB2 pour établir une connexion avec l'instance debase de données, et <nom-nœud> est le nom de la connexion créée plus haut.

d. Établissez une connexion avec le nom de connexion locale créé plus haut (<nom-nœud>) àl'aide de la commande suivante :

connect to <nom-nœud> user <nom-utilisateur> using <mot-de-passe>

<nom-nœud> est le nom de la connexion créée plus haut, et <nom-utilisateur> et <mot-de-passe> sont respectivement votre nom d'utilisateur et votre mot de passe d'accès au serveurDB2.

Si la connexion est établie, les informations de connexion à la base de données sont affichées, etvous pouvez fermer le processeur en ligne de commande du client DB2 :

db2=> connect to testdb2 user Test using password

Database Connection Information Database server = DB2/LINUX SQL authorization ID = TEST Local database alias = TESTDB2

Guide utilisateur du WorkbenchVersion 3.3

182

Une fois le client installé, démarrez WPS Workbench et testez la connectivité à la base de données enutilisant le programme suivant dans WPS Workbench :

LIBNAME DATASRC DB2 user=<nom-utilisateur> password=<mot-de-passe> DSN=TESTDB2;PROC DATASETS library=DATASRC;run;

Remplacez <nom-utilisateur> et <mot-de-passe> par votre nom d'utilisateur et votre mot depasse pour accéder au serveur.

Connexion à une base de données SQLServerAvant d'installer le client natif Microsoft SQL Server 2008, vérifiez les points suivants :

• WPS est bien installé et dispose d'une licence.• Vous bénéficiez des droits d'administrateur nécessaires pour installer WPS ainsi que le client SQL

Server.

Remarque :Lors de l'installation du client SQL Server, vérifiez que vous utilisez le même type d'installation que pourWPS Workbench – vous devez utiliser la version 32 bits ou 64 bits pour les deux logiciels.

Procédez comme suit :

1. Téléchargez le programme d'installation du client natif Microsoft SQL Server 2008 (sqlncli.msi)depuis la page Microsoft SQL Server 2008 R2 Service Pack 3 Feature Pack du site Web deMicrosoft (cliquez sur Télécharger, puis sélectionnez sqlncli.msi).

2. Une fois le fichier téléchargé, exécutez-le et suivez les instructions à l'écran pour installer le client.

Démarrez WPS Workbench et testez la connectivité à la base de données en utilisant le programmesuivant dans WPS Workbench :

LIBNAME DATASRC SQLServr user=<nom-utilisateur> password=<mot-de-passe> server=<id-serveur-distant>;PROC DATASETS library=DATASRC;run;

Remplacez <nom-utilisateur> et <mot-de-passe> par votre nom d'utilisateur et votre mot depasse pour accéder au serveur <id-serveur-distant>.

Guide utilisateur du WorkbenchVersion 3.3

183

Connexion à une base de donnéesMySQLAvant d'installer le client MySQL, vérifiez les points suivants :

• WPS est bien installé et dispose d'une licence.• Vous bénéficiez des droits d'administrateur nécessaires pour installer WPS ainsi que le client

MySQL.

Remarque :Lors de l'installation du client MySQL, vérifiez que vous utilisez le même type d'installation que pourWPS Workbench – vous devez utiliser la version Windows 32 bits ou 64 bits pour les deux logiciels.Les noms de bibliothèque dans les diverses versions du client sont les mêmes. Vous ne pouvez doncavoir qu'une seule version du client (32 ou 64 bits) enregistrée sur la variable système Path.

Procédez comme suit :

1. Téléchargez le programme d'installation MySQL Connector/C (.msi) depuis la page DownloadConnector/C du site Web de MySQL.

2. Une fois le fichier d'installation (.msi) téléchargé :

a. Double-cliquez sur le fichier téléchargé pour commencer l'installation (vous devez lire et accepterl'accord de licence MySQL).

b. Sélectionnez le type d'installation Typical (Typique) et cliquez sur Install (Installer).3. Ajoutez le répertoire d'installation de MySQL Connector/C contenant libmysql.dll à la variable

système Path en procédant comme suit :

a. Dans le Panneau de configuration, sélectionnez Système ➤ Paramètres système avancés.

b. Sélectionner Variables d'environnement, puis Modifier, et ajoutez le chemin d'accès durépertoire à la variable système Path.

4. Démarrez WPS Workbench pour vous assurer que les modifications apportées à la variabled'environnement Path sont disponibles.

Vous pouvez consulter la valeur de la variable PATH dans WPS Workbench à l'aide d'unprogramme en langage SAS :

DATA _null_; LENGTH pathname $ 32760; pathname = SYSGET('PATH'); PUT pathname= ;RUN;

Les résultats affichés dans le journal devraient contenir le chemin du répertoire d'installation deMySQL Connector/C, ajouté à l'étape précédente.

Guide utilisateur du WorkbenchVersion 3.3

184

Une fois le connecteur installé, testez la connectivité à la base de données en utilisant le programmesuivant dans WPS Workbench :

LIBNAME DATASRC MYSQL user=<user-name> password=<password> server=<remote-id> database=<dbase>;PROC DATASETS library=DATASRC;run;

Remplacez <user-name> et <password> par votre nom d'utilisateur et votre mot de passe pouraccéder au serveur <remote-id>.

À retenir :Vous devez indiquer le nom de la base de données à la place de <dbase> dans l'instruction LIBNAMEpour que la connexion s'établisse.

Connexion à une base de données àl'aide d'ODBCLe protocole ODBC (Open Database Connectivity) offre une option de connexion indépendante desbases de données pour WPS. Il est conseillé d'utiliser ODBC comme option de connexion si aucunclient de connexion natif n'existe.

ODBC permet de créer un programme SAS qui stocke des données dans un SGDBR, puis de modifierla base de données créée sans modifier fortement le programme.

Avertissement :L'utilisation d'ODBC peut limiter les fonctionnalités par rapport à celles d'un client natif, comme parexemple les commandes de transfert direct explicite de PROC SQL. (Le transfert direct explicite utiliseSQL tel que le serveur auquel vous vous connectez le comprend, et transmet ces instructions tellesquelles au SGDBR.)

Chaque pilote ODBC nécessite la création d'un DSN (Data Source Name), et les informations requiseslors de la création de ceci peuvent varier selon les bases de données. La procédure suivante crée unDSN à l'aide du pilote ODBC de SQLite.

Remarque :La version du pilote ODBC doit correspondre au type d'installation de WPS : si vous avez installé laversion 32 bits de WPS, vous devez choisir un pilote ODBC 32 bits, et si vous avez installé la version64 bits de WPS, un pilote ODBC 64 bits est requis.

1. Téléchargez le pilote ODBC pour SQLite depuis le site Web SQLite ODBC Driver.2. Une fois le téléchargement terminé, double-cliquez sur le fichier exécutable et suivez les instructions

qui s'affichent pour installer le pilote.3. Créez un fichier vide sur l'ordinateur pour y placer la base de données, par exemple E:\data

\mydata.sqlite.

Guide utilisateur du WorkbenchVersion 3.3

185

4. Créez un DSN pour le pilote ODBC en procédant comme suit :

a. Dans le Panneau de configuration, sélectionnez Outils d'administration, puis choisissez soitODBC Data Sources (32-bit), soit ODBC Data Sources (64-bit), selon les cas.

b. Sur l'onglet Nom DSN de l'utilisateur, cliquez sur Ajouter et sélectionnez SQLite3 ODBCDriver dans la boîte de dialogue Créer une nouvelle source de données.

c. Dans la boîte de dialogue SQLite3 ODBC DSN Configuration, entrez les informationssuivantes :

• Nom de la source de données – Nom auquel les programmes en langage SAS exécutésdans WPS doivent faire référence, par exemple SQLITE.

• Nom de base de données – Nom du fichier de la base de données, par exemple E:\data\mydata.sqlite.

Les autres informations sont facultatives, mais peuvent permettre une meilleure gestiondes données dans la base de données. Par exemple, pour appliquer les contraintes de clésétrangères, sélectionnez Clés étrangères dans la fenêtre de configuration. Vous trouverez plusd'informations sur les options dans la documentation de SQLite ODBC.

d. Une fois toutes les options requises sélectionnées, cliquez sur OK pour créer le DSN, et fermezla boîte de dialogue Sources de données ODBC.

Une fois le DSN créé, testez la connectivité de la base de données en utilisant le programme suivantdans WPS Workbench :

PROC SQL; CONNECT TO ODBC (DATASRC=<nom-dsn>); EXECUTE (CREATE TABLE test (ID INTEGER, name TEXT)) BY ODBC; DISCONNECT FROM ODBC;QUIT;

Remplacez <nom-dsn> par la valeur saisie dans le champ Source de la base de données de la boîtede dialogue Configuration du DSN.

Si la création a réussi, le journal du Workbench devrait contenir les informations suivantes :

CONNECT TO ODBC (DATASRC=SQLITE);NOTE: Successfully connected to database ODBC as alias ODBC.EXECUTE (CREATE TABLE test (ID INTEGER, name TEXT)) BY ODBC;The statement completed successfully.NOTE: Successfully passed statement to database ODBC.

Guide utilisateur du WorkbenchVersion 3.3

186

Fichiers de configurationLes fichiers de configuration contiennent les options système qui contrôlent l'environnement initialde WPS. Ils sont utilisés au cours de l'initialisation de WPS lorsque WPS est exécuté en ligne decommande, ainsi que lors de l'utilisation du Workbench.

Un fichier de configuration est un fichier texte simple que vous pouvez ouvrir dans un éditeur de texteafin d'ajouter, de supprimer ou de modifier les options système selon vos besoins.

Un fichier de configuration base est inclu dans l'installation de WPS. Il est nommé wps.cfg, et setrouve dans le répertoire d'installation de WPS. Il est recommandé de ne pas modifier ce fichier, etd'utiliser de préférence l'une des méthodes suivantes si une modification est nécessaire.

Remarque :Il se peut que plusieurs fichiers de configuration soient traités au cours de l'initialisation de WPS, etque chacun d'entre eux définisse les mêmes options. Si une option est définie dans plusieurs fichiers,le dernier traité a la priorité. Les options définies en ligne de commande, ou celles définies pour unserveur dans le panneau de configuration Options de démarrage, remplacent tous les paramètresdéfinis dans les fichiers de configuration.

Procédure d'initialisation de WPS pour WindowsLorsque WPS est invoqué, la procédure d'initialisation est la suivante :

1. WPS vérifie la variable d'environnement WPS_SYS_CONFIG du système d'exploitation. Si elle existe,le fichier de configuration spécifié est traité en premier. Le traitement de ce fichier n'a aucun effet surle chargement des fichiers de configuration par défaut.

2. Tous les fichiers spécifiés en ligne de commande avec l'option -config, ou dans le panneaude configuration Options de démarrage pour un serveur, sont traités ensuite. Si des fichiersde configuration sont spécifiés dans l'option -config, les fichiers de configuration par défautmentionnés ci-dessous ne sont pas chargés, et le processus passe directement au traitement deWPS_USER_CONFIG (étape 4).

Avertissement :Toute modification du traitement du fichier de configuration, surtout pour le chargement dufichier wps.cfg dans le répertoire d'installation de WPS, doit être réalisée avec précaution. Denombreuses options obligatoires figurent dans le fichier de base wps.cfg. Si vous décidez d'utiliserl'option -config, il est recommandé soit de prendre une copie du fichier de base wps.cfg et del'adapter à votre convenance, soit d'inclure ce fichier dans votre fichier de configuration client, puisde modifier les paramètres requis, par exemple :

-set wpshome 'somewhere'-config !wpshome/wps.cfg/* And now set any options you want */

Guide utilisateur du WorkbenchVersion 3.3

187

3. WPS vérifie alors l'existence d'un certain nombre de fichiers de configuration par défaut, et les traitedans l'ordre suivant :

a. wps.cfg dans le répertoire d'installation de WPSb. Mes documents/My WPS Files/.wps.cfgc. Mes documents/My WPS Files/wps.cfg

d. Mes documents/My WPS Files/.wpsv3.cfge. Mes documents/My WPS Files/wpsv3.cfg

f. wps.cfg dans le répertoire en coursg. wpsv3.cfg dans le répertoire en cours

4. WPS vérifie l'existence de la variable d'environnement WPS_USER_CONFIG. Si elle existe, le fichierde configuration spécifié est traité.

5. WPS vérifie l'existence de la variable d'environnement WPS_OPTIONS. Si elle existe, toutes lesoptions spécifiées dans WPS_OPTIONS sont traitées. La syntaxe de cette variable d'environnementest la même que si les options avaient été spécifiées en ligne de commande.

6. Toute les options spécifiées en ligne de commande sont alors traitées.

Procédure d'initialisation de WPS sur les plates-formes UNIXLorsque WPS est invoqué, la procédure d'initialisation est la suivante :

1. Tous les fichiers de configuration spécifiés par les options -config en ligne de commande, oudans le panneau de configuration Options de démarrage pour un serveur, sont traités en premier.Si des fichiers de configuration sont chargés de cette manière, la liste des variables de configurationpar défaut de l'étape 4 ci-dessous n'est pas chargée.

2. WPS vérifie l'existence des variables d'environnement WPS_OPTIONS et WPS_V3OPTIONS dans lesoptions -config, puis traite les fichiers nommés. Si des fichiers de configuration sont chargés decette manière, la liste des variables de configuration par défaut de l'étape 4 ci-dessous n'est paschargée.

Remarque :Cette étape n'a pas lieu si l'option -NOCONFIG est spécifiée en ligne de commande.

3. WPS vérifie ensuite les variables d'environnement suivantes, et si elles existent, charge les fichiersde configuration nommés (chaque variable d'environnement devrait nommer un seul fichier deconfiguration) :

a. WPS_CONFIG

b. WPS_V3CONFIG

Si des fichiers de configuration sont chargés de cette manière, la liste des variables deconfiguration par défaut de l'étape 4 ci-dessous n'est pas chargée.

Remarque :Cette étape n'a pas lieu si l'option -NOCONFIG est spécifiée en ligne de commande.

Guide utilisateur du WorkbenchVersion 3.3

188

4. Si aucun fichier de configuration n'a été chargé, la liste des fichiers de configuration par défaut estchargée. Les fichiers suivants sont chargés dans l'ordre indiqué :

• wps.cfg dans le répertoire d'installation de WPS• wps_local.cfg dans le répertoire d'installation de WPS (ce fichier peut être modifié pour

définir des paramètres spécifiques au site pour certaines options)• .wps.cfg dans votre répertoire d'accueil• wps.cfg dans votre répertoire d'accueil• .wpsv3.cfg dans votre répertoire d'accueil• wpsv3.cfg dans votre répertoire d'accueil• wps.cfg dans le répertoire en cours• wpsv3.cfg dans le répertoire en cours

5. WPS vérifie l'existence de la variable d'environnement WPS_OPTIONS. Si elle existe, toutes lesoptions spécifiées dans WPS_OPTIONS sont traitées. La syntaxe de cette variable d'environnementest la même que si les options ont été spécifiées en ligne de commande.

6. WPS vérifie la présence de la variable d'environnement WPS_V3OPTIONS et la traite de la mêmemanière.

7. Toute les options spécifiées en ligne de commande sont alors traitées.

Il existe également des fichiers de configuration « restreints », qui sont toujours traités. Les optionsde ces fichiers ne peuvent pas être modifiées. Les fichiers sont regroupés en fonction des paramètresuserid et groupid de l'utilisateur. Par exemple, si l'utilisateur est <utilisateur> et que le groupeest <groupe>, les fichiers de configuration suivants sont traités :

• misc/rstropts/rwps.cfg dans le répertoire d'installation de WPS ;• misc/rstropts/groups/<groupe>_rwps.cfg dans le répertoire d'installation de WPS ;• misc/rstropts/users/<utilisateur>_rwps.cfg dans le répertoire d'installation de WPS.

Obtenir des informations sur la procédure de démarrageIl est possible de vérifier quels fichiers de configuration ont été traités en consultant l'option systèmeCONFIG. Il suffit d'invoquer une instruction PROC OPTIONS comme suit :

proc options option=CONFIG;run;

Lorsque vous utilisez le Workbench, vous pouvez obtenir les informations de la manière suivante.

1. Ouvrez la vue Explorateur de serveurs WPS.2. Cliquez avec le bouton droit sur l'icône du serveur WPS pertinent et sélectionnez Propriétés

dans le menu contextuel.3. Dans la boîte de dialogue Propriétés, sélectionnez Options du système dans la liste des pages

disponibles sur le côté gauche afin d'afficher les valeurs de toutes les options système du serveur.4. Faites défiler jusqu'à CONFIG et mettez en évidence tous les fichiers de configuration utilisés.

Guide utilisateur du WorkbenchVersion 3.3

189

Vous pouvez aussi définir l'option système VERBOSE en ligne de commande, ou dans le panneaude configuration Options de démarrage du serveur. Cette option commande à WPS de saisir lesinformations de sortie dans le journal normal, informations qui indiquent les fichiers de configurationtraités et les options système définies.

Pour définir l'option VERBOSE dans le Workbench, modifiez les paramètres Options de démarragecomme suit :

1. Ouvrez la vue Explorateur de serveurs WPS.2. Cliquez avec le bouton droit sur l'icône du serveur WPS pertinent et sélectionnez Propriétés

dans le menu contextuel.3. Dans le menu situé dans la partie gauche de la boîte de dialogue Propriétés, sélectionnez

Démarrage ➤ Options du système.

4. Dans la partie droite de la fenêtre, cliquez sur Ajouter pour afficher la boîte de dialogue Option dedémarrage.

5. Cliquez sur le bouton Sélectionner pour afficher la liste des options disponibles dans une fenêtreSélectionner l'option de démarrage.

6. Dans la liste, trouvez l'option VERBOSE et double-cliquez dessus. La boîte de dialogue Option dedémarrage affiche votre sélection.

7. Cliquez sur le menu déroulant Valeur pour sélectionner VERBOSE (ou NOVERBOSE pour désactivercette option).

8. Cliquez sur OK.9. Cliquez sur OK dans la boîte de dialogue Propriétés. Un message vous invite à redémarrer le

serveur pour appliquer les modifications.10.Vérifiez le journal (voir la section Afficher le journal). La modification apportée à l'option VERBOSE

signifie que les fichiers de configuration et les options système y sont affichés lors du démarrage duWorkbench.

Guide utilisateur du WorkbenchVersion 3.3

190

Fichier AutoExecUn fichier AutoExec est un programme qui s'exécute automatiquement au démarrage de WPS. Il peutêtre utilisé à des fins diverses, par exemple la configuration de paramètres LIBNAME communs, pouréviter de les ajouter à chaque programme exécuté.

Remarque :L'instruction LIBNAME permet de stocker et de récupérer des ensembles de données dans un autrerépertoire que la bibliothèque par défaut Work (voir la section Bibliothèques). Pour plus de détails surl'élément de langage LIBNAME, voir le document WPS Reference For Language Elements.

Lorsque vous utilisez WPS Workbench, le fichier AutoExec pertinent est exécuté au démarrage deWPS, puis à chaque fois que vous redémarrez le serveur WPS.

Le Workbench permet aussi d'exécuter du code automatiquement avant et/ou après chaqueprogramme. Voir la section Injection de code WPS pour plus d'informations.

WindowsWPS recherche automatiquement un fichier nommé autoexec.sas dans les répertoires suivants :

1. (répertoire en cours)

2. Mes documents

3. chemins spécifiés dans la variable d'environnement PATH4. répertoire racine du lecteur en cours, par exemple, C:\5. répertoire d'installation de WPS

Autres systèmes d'exploitationWPS recherche automatiquement un fichier nommé autoexec.sas dans les répertoires suivants :

1. (répertoire en cours)

2. $HOME

3. répertoire d'installation de WPS

Spécifier un autre fichierSi vous souhaitez exécuter automatiquement un autre fichier ou un fichier qui se situe dans unrépertoire non-standard, il suffit de définir l'option système AUTOEXEC à l'aide des fichiers deconfiguration.

Vous pouvez également utiliser les propriétés du serveur WPS comme suit :

Guide utilisateur du WorkbenchVersion 3.3

191

1. Dans la vue Explorateur de serveurs WPS, Explorateur de liens, Explorateur de sorties ou Explorateur de résultats, vérifiez que le serveur est en cours d'exécution.

2. Cliquez avec le bouton droit sur le serveur et sélectionnez Propriétés dans le menu contextuel.3. Dans le menu situé dans la partie gauche de la boîte de dialogue Propriétés, sélectionnez

Démarrage ➤ Options du système.

4. Dans la partie droite de la fenêtre, cliquez sur Ajouter pour afficher la boîte de dialogue Option dedémarrage.

5. Cliquez sur le bouton Sélectionner pour afficher la liste des options disponibles dans une fenêtreSélectionner l'option de démarrage.

6. Dans la liste, trouvez l'option AUTOEXEC et double-cliquez dessus. La boîte de dialogue Option dedémarrage affiche votre sélection.

7. Dans le champ Valeur, saisissez le chemin d'accès du fichier de configuration à utiliser, puis cliquezsur OK.

8. Enfin, cliquez sur OK dans la boîte de dialogue Propriétés. Un message vous invite à redémarrer leserveur et exécuter le fichier spécifié.

Guide utilisateur du WorkbenchVersion 3.3

192

Conseils et astuces WPS

Configuration de WPS• Vous pouvez utiliser la fonctionnalité WPS Link pour configurer et gérer une solution client/serveur

à distance. Voir la section Configuration client/serveur de WPS Link. Pour plus d'informations surl'authentification du serveur, consultez le document WPS Link – Guide utilisateur et référence.

• Si vous n'utilisez WPS Link que pour exécuter des programmes sur un hôte distant et que vousn'avez pas besoin du Serveur local WPS, vous pouvez le retirer ou le désactiver, comme décrit à lasection Configurer l'installation locale de WPS.

• Vous pouvez changer la police du Workbench. Voir la section Préférences générales.• Vous pouvez changer l'aspect de l'arrière-plan du Workbench. Voir la section Préférences

concernant l'éditeur de texte.• Vous pouvez créer des raccourcis clavier en modifiant les liaisons définies pour les touches dans

Eclipse (Fenêtre ➤ Préférences ➤ Généralités ➤ Touches. Voir la section Préférences concernantles raccourcis clavier.

Astuce :Pour exporter et importer vos raccourcis clavier d'un espace de travail à l'autre : il suffit d'exportervos préférences dans un fichier .epf (voir la section Enregistrer les préférences), en cochantl'option Préférences liées aux touches. Ensuite, lorsque vous démarrez WPS dans un autreespace de travail, importez les préférences de ce fichier en utilisant Fichier ➤  Importer ➤ 

Généralités ➤  Préférences, en veillant à nouveau à bien cocher Préférences liées auxtouches.

• Vous pouvez contrôler les options système utilisées dans l'environnement WPS via Fichiers deconfiguration. Toute modification doit être effectuée avec précaution, car elle peut affecter d'autresutilisateurs de WPS.

• La configuration des noms de bibliothèque communs peut être réalisée à l'aide d'un fichier FichierAutoExec. Il n'est alors plus nécessaire de les ajouter à chaque programme exécuté. Ce fichier estexécuté au démarrage de WPS, puis à chaque fois que vous redémarrez le serveur WPS.

Gestion des fichiers• Pour afficher ou créer un autre groupe de projets, vous pouvez basculer vers un autre espace de

travail. Voir la section Basculer vers un autre espace de travail.• Si vous supprimez par accident un fichier depuis la vue Explorateur de projets, il est possible de

restaurer la version voulue de ce fichier à l'aide de la fonctionnalité Historique local du Workbench.Voir la section Restaurer un programme à partir de son historique local.

• Vous pouvez utiliser la vue Explorateur de projets pour comparer les différents fichier et lesfusionner entre eux. Voir la section Comparer et fusionner des fichiers.

Guide utilisateur du WorkbenchVersion 3.3

193

• Pour accéder rapidement à vos fichiers sur le système de fichiers des hôtes, vous pouvez créerdes raccourcis de répertoire à utiliser avec la vue Explorateur de fichiers. Si vous créez uneconnexion à un hôte distant (voir la section Créer une connexion à un hôte distant), vous êtesautomatiquement invité à créer des raccourcis de répertoire. Sinon, vous pouvez également lesajouter à l'aide des propriétés de la connexion à l'hôte dans la vue Explorateur de liens – voir lasection Propriétés de la connexion à l'hôte local (raccourcis de répertoire) ou Propriétés de laconnexion à un hôte distant, selon le cas.

Programmes SAS• Pour vous aider à débuter, quelques programmes sont fournis dans un exemple de projet que vous

pouvez importer dans WPS Workbench. Voir la section Importer les exemples et d'autres projets.• Vous pouvez spécifier du code qui doit être exécuté automatiquement avant et/ou après chaque

programme (voir la section Injection de code WPS).• Vous pouvez créer des modèles contenant des fragments de code à réutiliser. Voir la section Saisir

du code WPS à l'aide de modèles.

Astuce :Pour exporter et importer vos préférences (y compris les modèles) d'un espace de travail à un autre,et éviter ainsi d'avoir à recréer la configuration à chaque fois, il suffit d'exporter vos préférencesdans un fichier .epf (voir la section Enregistrer les préférences), en cochant l'option PréférencesWPS. Ensuite, lorsque vous démarrez WPS dans un autre espace de travail, importez lespréférences de ce fichier en utilisant Fichier ➤  Importer ➤   Généralités ➤   Préférences,en veillant à nouveau à bien cocher Préférences WPS.

Exécution de programmes SAS• Pour vous aider à tester vos programmes, vous pouvez n'exécuter qu'une partie d'un programme

dans le Workbench. Voir la section Exécuter une partie d'un programme.• Vous pouvez exécuter plusieurs programmes simultanément sur la même machine en répartissant

les travaux entre plusieurs serveurs. Vous pouvez définir plusieurs serveurs sur un même hôte, qu'ilsoit local ou distant (voir la section Créer un serveur WPS).

Remarque :Vous ne pouvez avoir qu'un seul hôte local, mais la seule restriction sur le nombre de serveurslocaux dépend des ressources de la machine locale. Toutefois, pour installer plusieurs hôtesdistants, vous devez avoir une clé de licence WPS pour chaque serveur. Pour définir un nouvelhôte, voir la section Créer une connexion à un hôte distant.

• Vous pouvez exécuter WPS en mode ligne de commande. Voir la section Exécuter un programmeen ligne de commande sur une plate-forme Windows ou Exécuter un programme en ligne decommande sur une plate-forme autre que Windows, selon les cas.

• Vous pouvez accéder à des bases de données depuis vos programmes en langage SAS. Voir lasection Connectivité avec les bases de données.

Guide utilisateur du WorkbenchVersion 3.3

194

Sorties et résultats des programmes• Vous pouvez spécifier si les destinations ODS (HTML et Texte (LISTE)) doivent ou non être

contrôlées automatiquement et, si oui, les types de sortie spécifiques à utiliser. Voir la sectionPréférences concernant les options de résultats.

• La bibliothèque WORK est temporaire, et elle est automatiquement vidée de toutes les donnéesqui y sont stockées à la fin de chaque session WPS (voir la section Bibliothèques). Vous pouvezcependant définir un emplacement permanent, comme indiqué à la section Emplacement de labibliothèque WORK.

• Vous pouvez retirer les résultats des sorties des programmes de manière sélective (voir la sectionEffacer les résultats d'un programme) ou globale (voir la section Redémarrer le serveur). Si vousredémarrez le serveur, les données temporaires sont perdues, et les programmes ne peuvent plusinteragir avec les objets créés avant le redémarrage.

Ensembles de données• Vous pouvez modifier les ensembles de données dans le Workbench (version 3.2 et ultérieures)

à l'aide d'outils d'édition contextuels intégrés et de réorganisation des colonnes. Voir la sectionModifier un ensemble de données.

• Les ensembles de données WPS et les feuilles de calcul Microsoft Excel peuvent être exportés sousforme de texte à largeur fixe ou délimité. Voir la section Exporter des ensembles de données.

Guide utilisateur du WorkbenchVersion 3.3

195

DépannageCe qui suit est une liste de problèmes potentiels, accompagnés de leur solution :

Les icônes apparaissent en grisé, et je n'arrive à exécuter aucun programme.

Les icônes apparaissent en grisé dans les cas suivants :

• Le serveur sur lequel vous tentez d'exécuter les programmes ne dispose pas d'une licencevalide (voir la section Appliquer une licence), ou a été désinstallé (voir la section Configurerl'installation locale de WPS).

• Le nom du fichier de programme dans ouvert dans la vue Éditeur n'a pas une extension .sasou .wps.

• Le pointeur de la souris se trouve dans une vue autre que Éditeur.

Un message annonce qu'il n'y a pas de serveur par défaut sur lequel soumettre le programme.

Ceci se produit généralement lorsque vous avez cliqué sur le bouton pour exécuter leprogramme alors que le serveur WPS par défaut a été supprimé. Si d'autres serveurs WPS ontété définis, vous pouvez sélectionner l'un d'entre eux comme nouveau serveur par défaut (voir lasection Serveur WPS par défaut). Sinon, vous pouvez rétablir le serveur WPS qui a été supprimé(voir la section Créer un serveur WPS) et le redéfinir comme serveur par défaut.

Les caractères de mes fichiers ne s'affichent pas correctement.

Ceci est probablement dû à un problème de codage. Suivez les étapes décrites dans lessections Paramètres LOCALE et ENCODING du serveur WPS et Encodage général du fichiertexte, puis redémarrez le Workbench. Si vous avez importé les fichiers dont l'affichage estincorrect, il se peut que vous deviez les importer à nouveau.

Je ne parviens pas à démarrer le Workbench.

Si le Workbench démarre habituellement sans problème, mais refuse soudain de démarrer, il estpossible que vous soyez à court d'espace disque. Dans ce cas, un ou des fichiers du répertoire.metadata d'Eclipse pour votre espace de travail en cours peut être endommagé (le répertoire.metadata contient des informations mises en cache, l'historique, les positions enregistréesdes boîtes de dialogue, etc.). Pointez vers un autre espace de travail (voir la section Fenêtrede lancement des espaces de travail) pour déterminer s'il y a un problème avec le répertoire.metadata de l'espace de travail en cours. La solution la plus simple consiste à renommerle dossier .metadata du répertoire d'espace de travail endommagé, redémarrer WPS, puispointer à nouveau vers l'espace de travail. WPS devrait démarrer, mais la liste des projetsde la vue Explorateur de projets sera vide. Pas de panique : vos projets et votre code sourcesont exactement là où ils étaient, et il vous suffit de régénérer les métadonnées en importantles projets existants (voir la section Importer les exemples et d'autres projets). Pour afficherles fichiers masqués du dossier .metadata, voir la section Préférences concernantl'explorateur de fichiers WPS (fichiers masqués).

Guide utilisateur du WorkbenchVersion 3.3

196

Je veux que la fenêtre Lanceur d'espace de travail s'affiche à nouveau.

Si vous n'êtes pas invité à sélectionner un espace de travail lorsque vous démarrez leWorkbench, cela signifie généralement que vous avez par le passé coché la case Utiliser pardéfaut et ne plus poser la question de la boîte de dialogue Lanceur d'espace de travail. Pourrésoudre ce problème, sélectionnez la case Demander la sélection de l'espace de travailau démarrage de la boîte de dialogue Fenêtre ➤ Préférences ➤ Généralités ➤ Démarrage etarrêt ➤ Espaces de travail, puis redémarrez WPS.

Je veux augmenter l'espace mémoire Java pour éviter les erreurs d'exécution Java.

Voir la section Afficher l'état du tas.

Guide utilisateur du WorkbenchVersion 3.3

197

Envoyer une requête ausupport techniqueLa façon dont vous accédez au soutien technique dépend directement de comment vous avez achetévotre logiciel WPS. Si vous avez fait un achat standard du logiciel WPS, vous avez une licenced'abonnement annuel qui vous donne droit à un nombre illimité de mises à jour pendant les douzemois de validité de la licence. Vous bénéficiez aussi du support gratuit en envoyant un courriel à[email protected]. Nous nous efforçons de répondre dans les meilleurs délais auxdemandes d'assistance par courriel, et de résoudre les problèmes dans un délai raisonnable.

Les principaux clients peuvent bénéficier d'un niveau de support supérieur. Dans ce cas, nous leurdonnons souvent un accès à notre système de suivi des problèmes. Le traitement des requêtestechniques peut être réalisé par un ou plusieurs super-utilisateurs sélectionnés par votre organisation –il est nécessaire que vous sachiez de qui il s'agit.

Pour résoudre vos problèmes, nous pouvons vous suggérer des solutions de contournement, ouencore vous demander de mettre à jour votre installation du logiciel WPS.

Remarque :En raison de la complexité du langage SAS, une interaction prolongée avec World Programming estparfois nécessaire pour identifier et corriger les causes du problème.

Fichiers journaux des serveurs WPSPour certains types de problèmes, nous vous demanderons de fournir les fichiers .log. Ils se trouventdans le répertoire .metadata, dans l'espace de travail actuellement utilisé par le Workbench. DansWindows, cet espace de travail est Mes documents\Wps Workspaces\Workspacen et, surune plate-forme non Windows, c'est /home/<nom de l'utilisateur>/WPS Workspaces/Workspacen ; dans les deux cas, n est le numéro de l'espace de travail.

Remarque :Comme les fichiers .metadata et .log commencent par un point, ils sont généralement masqués, etvous devez configurer le système pour qu'ils soient visibles. Si vous utilisez une interface graphique,vous devez modifier vos préférences afin d'afficher les fichiers masqués et/ou les fichiers desauvegarde. L'utilisation de la commande ls -la ou ls -a depuis le répertoire .metadata énumèretous les fichiers du répertoire, qu'ils soient masqués ou non.

Guide utilisateur du WorkbenchVersion 3.3

198

Notices légalesCopyright © 2002-2018 World Programming Limited.

Tous droits réservés. Les présentes informations sont confidentielles et soumises au droit d'auteur. Lareproduction et la transmission de la présente publication, même partielles, par quelque procédé quece soit, tant électronique que mécanique, y compris la photocopie, l'enregistrement ou tout système destockage et récupération des données, sont formellement interdites.

MarquesWPS et World Programming sont des marques commerciales ou des marques déposées de WorldProgramming Limited dans l'Union européenne et dans d'autres pays. Le sigle (r) ou ® indiquel'enregistrement au niveau de l'Union européenne (« marque communautaire »).

SAS et tous les autres noms de produits et de services de SAS Institute Inc. sont des marquesdéposées ou des marques commerciales de SAS Institute Inc. aux Etats-Unis et dans d'autres pays. ®indique que la marque est déposée aux Etats-Unis.

Toutes les autres marques commerciales sont la propriété de leurs détenteurs respectifs.

Notices généralesWorld Programming Limited n'est associé d'aucune manière à SAS Institute Inc.

WPS n'est pas le système SAS.

Les expressions « SAS » et « langage SAS » utilisées dans ce document font référence au langage deprogrammation SAS qui est souvent désigné par ces termes.

Les expressions « programme », « programme SAS » et « programme en langage SAS » utiliséesdans ce document font référence aux programmes écrits en langage SAS. Ils peuvent également êtreappelés « scripts », « scripts SAS » ou « scripts en langage SAS ».

Les expressions « IML » et « langage IML », « syntaxe IML » et « Interactive Matrix Language » utiliséesdans ce document font référence au langage de programmation informatique qui est souvent désignépar ces termes.

WPS inclut du logiciel développé par des tiers. Vous trouverez plus d'informations dans le fichierTHANKS ou acknowledgements-fr.txt inclus dans l'installation de WPS.