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.12 Copyright © 2002-2021 World Programming Limited www.worldprogramming.com

Guide utilisateur du Workbench WPS Workbench guide utilisateur · 2020. 8. 24. · Guide utilisateur du Workbench Version 3.3 7 Introduction À propos de ce guide Ce guide utilisateur

  • Upload
    others

  • View
    31

  • Download
    0

Embed Size (px)

Citation preview

  • 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.12Copyright © 2002-2021 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.

    http://www.eclipse.org

  • 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

  • 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