Guida dell’utente di Workbench WPS Workbench guida dell'utente wps... · Connessione ad un...

132
Guida dell’utente di Workbench Versione 4.1 WPS Workbench guida dell'utente Versione: 4.1.2 Copyright © 2002-2019 World Programming Limited www.worldprogramming.com

Transcript of Guida dell’utente di Workbench WPS Workbench guida dell'utente wps... · Connessione ad un...

Guida dell’utente di WorkbenchVersione 4.1

WPS Workbenchguida dell'utente

Versione: 4.1.2Copyright © 2002-2019 World Programming Limited

www.worldprogramming.com

Guida dell’utente di WorkbenchVersione 4.1

2

Indice

Introduzione..............................................................................................6Informazioni su WPS..................................................................................................................... 6WPS e il software SAS®............................................................................................................... 7Componenti di WPS.......................................................................................................................8

Inizio........................................................................................................ 10Avvio area di lavoro..................................................................................................................... 10

Pagine di benvenuto..........................................................................................................11Migrazione di programmi o progetti preesistenti..........................................................................11

Migrazione da versioni precedenti di WPS....................................................................... 11Migrazione dal software SAS®......................................................................................... 11Analizzatore di codice....................................................................................................... 12

Importare un progetto.................................................................................................................. 17Layout di Workbench................................................................................................................... 18

Prospettiva di WPS predefinita......................................................................................... 18Guida in linea............................................................................................................................... 19Schede di riferimento rapido........................................................................................................19

Server WPS.............................................................................................23Configurare un'installazione a WPS locale..................................................................................23Server WPS predefinito................................................................................................................25Impostazioni di LOCALE e ENCODING del server WPS............................................................... 26

Codifica generale dei file di testo......................................................................................27Codice di licenza..........................................................................................................................28

Applicare un codice di licenza.......................................................................................... 28Introduzione.................................................................................................................................. 28Connessione ad un database Oracle.......................................................................................... 29Connessione ad un database DB2..............................................................................................30Connessione ad un database SQL Server..................................................................................32Connessione ad un database MySQL.........................................................................................33Connessione a un database tramite ODBC................................................................................ 34Riavviare il server........................................................................................................................ 36

Viste e prospettive.................................................................................37Esplora progetti............................................................................................................................ 37

Progetti...............................................................................................................................38Cronologia locale...............................................................................................................43Passaggio ad una diversa area di lavoro......................................................................... 46

Esplora file....................................................................................................................................47

Guida dell’utente di WorkbenchVersione 4.1

3

Gestione dei file in Esplora file......................................................................................... 48Esplora collegamenti.................................................................................................................... 50

Proprietà della connessione con un host locale............................................................... 51Connettersi ad un server WPS remoto.............................................................................52

Esplora server WPS.....................................................................................................................57Proprietà del server WPS................................................................................................. 58

Proprietà....................................................................................................................................... 59Editor............................................................................................................................................ 60Segnalibri......................................................................................................................................60

Ancoraggi segnalibri.......................................................................................................... 61Attività........................................................................................................................................... 62

Indicatori di attività............................................................................................................ 62Struttura........................................................................................................................................ 63Esplora output.............................................................................................................................. 64Esplora risultati.............................................................................................................................64Console.........................................................................................................................................65Ricerca..........................................................................................................................................65Uso di viste.................................................................................................................................. 65

Pile di viste........................................................................................................................ 66Aprire una vista................................................................................................................. 67Scollegare e ricollegare una vista.....................................................................................68

Prospettive....................................................................................................................................68Aprire una prospettiva....................................................................................................... 68Chiudere una prospettiva.................................................................................................. 69Reimpostazione di una prospettiva................................................................................... 69Salvataggio di una prospettiva..........................................................................................69Eliminazione di una prospettiva........................................................................................ 70

Creare un nuovo programma............................................................... 71Creazione di un nuovo file di programma in un progetto............................................................ 73Immissione del codice in WPS tramite modelli............................................................................73Iniezione di codice WPS..............................................................................................................74Uso dell'Assistente ai contenuti del programma..........................................................................74Colorazione della sintassi di WPS...............................................................................................75

Eseguire una programma..................................................................... 76Eseguire un programma in Workbench....................................................................................... 76

Eseguire parte di un programma...................................................................................... 76Interrompere l'esecuzione del programma........................................................................77Preferenze di WPS per l'esecuzione di programmi.......................................................... 77

Modalità della riga di comando....................................................................................................79

Raccolte e set di dati............................................................................ 81Impostare il percorso WORK....................................................................................................... 81Cataloghi.......................................................................................................................................82

Guida dell’utente di WorkbenchVersione 4.1

4

Set di dati..................................................................................................................................... 83Importare set di dati.......................................................................................................... 84Esportare i set di dati........................................................................................................87Rimuovere il riferimento al set di dati............................................................................... 87Vista Profiler di dati.........................................................................................................87Visualizzatore set di dati................................................................................................... 97

Uso dell'output dei programmi...........................................................105Generazione dei set di dati........................................................................................................105Registri........................................................................................................................................106

Visualizzare il registro..................................................................................................... 106Salvare il registro in un file............................................................................................. 106Stampare il registro......................................................................................................... 107Preferenze per la colorazione del registro...................................................................... 107

Gestione dell'output ODS...........................................................................................................107Gestisci automaticamente destinazioni ODS.................................................................. 107Elenco.............................................................................................................................. 108Output HTML................................................................................................................... 110Output PDF......................................................................................................................111Cancellazione dell'output dei risultati.............................................................................. 112

Funzioni di modifica basate su testo................................................ 114Uso di editor...............................................................................................................................115

Editor SAS....................................................................................................................... 115Editor di testo.................................................................................................................. 116Editor di sistema..............................................................................................................116Editor interno................................................................................................................... 116Preferenze dell'Editor di testo......................................................................................... 117Chiusura dei file.............................................................................................................. 117

Spostarsi al percorso specifico di un progetto...........................................................................118Esplorazione tra più file di progetto...........................................................................................118Ricerca e sostituzione................................................................................................................119Annullamento e ripetizione delle modifiche............................................................................... 119

Preferenze............................................................................................. 121Preferenze generali.................................................................................................................... 122Cambiare le preferenze per i tasti di scelta rapida....................................................................122Eseguire un backup delle preferenze di Workbench................................................................. 123Importare le preferenze di Workbench...................................................................................... 123

File di configurazione..........................................................................124

File AutoExec....................................................................................... 127

Guida dell’utente di WorkbenchVersione 4.1

5

Consigli e suggerimenti di WPS........................................................ 128

Risoluzione dei problemi.................................................................... 130

Creazione di richieste di supporto tecnico....................................... 131

Avvisi legali.......................................................................................... 132

Guida dell’utente di WorkbenchVersión 4.1

6

IntroduzioneQuesta guida è concepita per assistere l'utente a familiarizzarsi con l'ambiente di programmazionedel linguaggio SAS tramite WPS Workbench, l'interfaccia utente grafica di WPS (World ProgrammingSystem). L'ambiente del linguaggio SAS di Workbench consente di creare, modificare ed eseguireprogrammi in linguaggio SAS, e visualizzare il set di dati, i registri e altri output risultanti.

WPS Workbench contiene anche l'Ambiente flusso di lavoro – un editor del flusso di lavoro con iltrascinamento della selezione e lo strumento di profiling dei dati, ideale per le attività di data miningo di costruzione di modelli predittivi. Per maggiori informazioni, consultare la Guida dell'utente allaprospettiva Ambiente flusso di lavoro di WPS.

La guida dell'utente non ha lo scopo di

• formare all'uso del linguaggio SAS. Se non ha già familiarità con questo linguaggio, vi è un'ampiagamma di materiali didattici e materiali di riferimento disponibili da molte origini.

• Insegnare ogni opzione in WPS. Una volta esplorata la guida, tuttavia, si dovrebbe avereabbastanza familiarità con il sistema fino a poter eseguire alcuni programmi di base e cominciare adelaborare e analizzare i dati.

Per una panoramica di alcune funzionalità comunemente utilizzate, consultare Suggerimenti etrucchi (pág. 128), e per informazioni che aiutano a risolvere alcuni problemi segnalati inprecedenza, consultare risoluzione dei problemi (pág. 130).

Informazioni su WPSWorld Programming System (WPS) comprende i seguenti componenti:

• Un ambiente di sviluppo integrato (IDE): WPS Workbench. Tale ambiente utilizza la Eclipse IDEcome framework di base per fornire l'interfaccia utente grafica. L'IDE fornisce funzionalità pergestire, creare e modificare programmi scritti in linguaggio SAS, e poi eseguire detti programmitramite il server WPS.

• Un compilatore/interprete: server WPS. Quando si usa WPS Workbench, il compilatore vieneeseguito come processo server e viene utilizzato per elaborare ed eseguire i programmi. Ilcompilatore viene anche utilizzato quando si esegue WPS dalla riga di comando (CLI), talvoltaconosciuta come esecuzione di WPS in modalità batch.

Guida dell’utente di WorkbenchVersión 4.1

7

Processo del server WPSPer eseguire i programmi in linguaggio SAS, WPS Workbench richiede una connessione ad unprocesso server di WPS concesso in licenza (per maggiori informazioni, consultare Server WPS(pag. 23)). Il processo può essere in esecuzione nella workstation locale (un server locale) oppure inun'installazione di WPS situata in un computer remoto (un server remoto).

Eclipse IDEEclipse è uno strumento open source che offre un ambiente per la modifica e la gestione di file eattività. È concepito per alloggiare i plug-in in modo da eseguire le specifiche attività, per esempioi plug-in concepiti per assistere lo sviluppo dei programmi in linguaggio SAS forniti come WPSWorkbench.

WPS lascia intenzionalmente l'ambiente Eclipse aperto, affinché gli utenti avanzati possano aggiungerealtri strumenti e funzionalità di terzi. Di conseguenza, WPS Workbench include alcune funzionalitàinutilizzate che consentono altri plug-in ed estensioni basati su Eclipse.

Alcune delle funzionalità menzionate in questa guida sono in realtà funzioni incorporate in Eclipse, masono indicate come funzioni di WPS per semplicità.

WPS e il software SAS®Se si è abituati ad usare altri prodotti connessi al linguaggio SAS, ci si accorgerà che il supporto dellinguaggio in WPS è familiare. Ci si può aspettare di trovare gran parte della stessa sintassi in termini diprocedure, formati, macro, DATA step e così via.

WPS fornisce inoltre altre funzioni e oggetti riconoscibili, quali registri, set di dati o la raccolta Work.Si potrebbero riscontrare nuove funzionalità, come ad esempio lo stesso ambiente di Workbench e ilmodo in cui gestisce e visualizza gli oggetti. Infine, si scoprirà che Workbench ha guide e materiale diriferimento per assistere l'utente durante la migrazione a WPS.

Compatibilità con il software SAS®Oltre a poter eseguire, modificare, condividere e salvare programmi, scritti in linguaggio SAS, WPS puòanche leggere da e scrivere nei file di dati utilizzati dal software SAS. WPS include anche un'ampiagamma di motori di raccolta per consentire l'accesso a molti database, data warehouse e ambienti diBig Data per Hadoop, di terzi leader nel settore.

Inoltre, WPS utilizza un formato di file di set di dati di proprietario noto come WPD. In qualità di motoredi raccolta del set di dati predefinito, i set di dati WPD vengono utilizzati per la raccolta Work. Poiché è ilmotore di raccolta del set di dati che è nativo di WPS, ha il supporto più completo di funzionalità, tra cui,ad esempio, gli indici.

Guida dell’utente di WorkbenchVersión 4.1

8

Elementi del linguaggio supportatiWPS non supporta ancora ogni elemento del linguaggio SAS. Workbench offre uno strumento dianalisi codice (consultare analizzatore di codice (pag. 12)) per determinare se uno qualsiasidei programmi SAS preesistenti contiene elementi del linguaggio sconosciuti. È possibile trovareinformazioni dettagliate sugli elementi del linguaggio SAS attualmente supportati nel Riferimento per glielementi del linguaggio di WPS.

Programmi SAS preesistentiWPS utilizza l'espressione programma in linguaggio SAS o programma per descrivere script,programmi e applicazioni scritti in linguaggio SAS.

Componenti di WPSQuesta sezione offre breve descrizioni degli oggetti gestiti da Workbench.

ProgettiL'unità fondamentale dell'organizzazione per i programmi in linguaggio SAS e gli oggetti correlati.Ad esempio, si potrebbe disporre di un progetto per applicazioni in fase di sviluppo o un altro peri processi di creazione di rapporti mensili. Per maggiori informazioni, consultare Progetti (pag.38).

Programmi in linguaggio SASCreare o modificare i programmi in linguaggio SAS tramite l'editor del linguaggio SAS. I filecontenenti programmi in linguaggio SAS utilizzano le estensioni .wps o .sas. Per maggioriinformazioni, consultare Editor del linguaggio SAS (pag. 115).

Output del registroQuando si esegue un programma in linguaggio SAS, le informazioni generate vengono archiviatenel file di registro. È possibile visualizzare, stampare e salvare il file dall'interno di Workbench. Ilregistro generato è cumulativo e contiene i risultati di ciascun programma eseguito dall'aperturadi WPS Workbench, riavviando il server WPS o cancellando il registro. Per maggiori informazioni,consultare Registri (pag. 106).

ElencoContiene l'output di stampa di eventuali programmi eseguiti. Per esempio, potrebbe essereuna tabella di dati generata da un'istruzione PROC PRINT. È possibile visualizzare, stamparee salvare l'elenco all'interno di Workbench. L'elenco generato è cumulativo e contiene l'outputdi ciascun programma eseguito dall'apertura di WPS Workbench, riavviando il server WPS ocancellando l'elenco. Per maggiori informazioni, consultare Elenco (pag. 108).

Guida dell’utente di WorkbenchVersión 4.1

9

Output ODSCome descritto, è possibile utilizzare l'ODS (Output Delivery System) per produrre l'elenco ditesto e l'output HTML. Ogni programma può specificare quando e dove archiviare il suo output,ma è anche possibile lasciare che Workbench gestisca automaticamente il processo. L'opzionepredefinita è che Workbench generi l'output HTML. Per maggiori informazioni, consultareGestione dell'output ODS (pag. 107).

Set di datiI dati generati dall'esecuzione di un programma sono archiviati in set di dati. È possibile sfogliareo modificare un set di dati con il visualizzatore dei set di dati. Per maggiori informazioni,consultare Set di dati (pag. 83).

Connessione hostUn computer, locale o remoto a cui Workbench può accedere. La connessione con l'host localeconsente di eseguire i programmi in linguaggio SAS nel server WPS installato nel computerlocale. È possibile anche realizzare le connessioni per rimuovere i server WPS, consultareConnettersi ad un server WPS remoto (pag. 52) per maggiori informazioni.

Server WPSEsegue i programmi in linguaggio SAS e genera l'output risultante, quale il registro, l'elenco, i filedi risultati e i set di dati. Il server WPS mantiene un ambiente di raccolte, macro e variabili dellamacro assegnate, e così via, con cui interagiscono tutti i programmi in esecuzione. Per maggioriinformazioni, consultare Server WPS (pag. 23).

Guida dell’utente di WorkbenchVersione 4.1

10

Inizio

Avvio area di lavoroQuando si apre WPS Workbench, viene visualizzata la finestra di dialogo Avvio di Eclipse.

Un'area di lavoro è la cartella padre utilizzata per contenere uno o più progetti (pag. 38). Èpossibile utilizzare qualsiasi cartella in qualsiasi unità a cui il computer può accedere, come un'area dilavoro, e l'area di lavoro che si usa è il percorso predefinito per i progetti appena creati.

Non è necessario utilizzare i progetti per gestire le risorse di Workbench; è possibile accedere inWorkbench a qualsiasi file a cui si può accedere nel sistema locale o in un computer remoto, tramiteEsplora file (pag. 47),

In Windows, il percorso predefinito delle aree di lavoro è la cartella Documenti e in piattaforme UNIX eLinux, è la home directory. In tutti i casi, la sottodirectory è denominata WPS Workspaces e le aree dilavoro vengono denominate in modo incrementale, cominciando da Workspace1.

Per utilizzare un'area di lavoro diversa, selezionare il nome nell'elenco Workspace, selezionareun'area di lavoro dall'elenco Aree di lavoro recenti oppure fare clic su Sfoglia e passare alla cartelladell'area di lavoro nella finestra di dialogo Seleziona directory area di lavoro.

Viene visualizzata la finestra di dialogo Avvio di Eclipse ad ogni avvio di WPS Workbench. Pernascondere la finestra di dialogo all'avvio e utilizzare l'area di lavoro selezionata ad ogni avvio diWorkbench, selezionare la finestra di dialogo Usa questo spazio di lavoro come predefinito e nonrichiedere più.

Guida dell’utente di WorkbenchVersione 4.1

11

Pagine di benvenutoLe pagine di Benvenuto visualizzano le informazioni introduttive su WPS Workbench. La paginapredefinita Introduzione è concepita per promuovere l'uso di WPS Workbench nel modo più rapidopossibile. Questa pagina visualizza inoltre numerosi collegamenti ad altre pagine di benvenuto, inclusoil sito Web.

Chiusura e riapertura delle pagine di benvenutoPer chiudere le pagine di benvenuto e iniziare ad utilizzare Workbench senza un ulteriore materialesussidiario, fare clic sul pulsante Chiudi nella scheda Benvenuto.

Per riaprire le pagine di benvenuto, fare clic sul menu Guida, quindi fare clic su Benvenuti.

Migrazione di programmi o progettipreesistentiQuesta sezione descrive come utilizzare i progetti preesistenti o programmi in linguaggio SAS conl'ultima versione di WPS.

Migrazione da versioni precedenti di WPSLe aree di lavoro aperte con le versioni precedenti di WPS si possono aprire con la versione corrente,cosicché non è necessario eseguire la procedura della migrazione per poter usare un'area di lavoro dauna versione precedente di WPS con l'ultima versione. La prima volta in cui si apre un'area di lavoroche è stata creata con una versione precedente di WPS, tuttavia una finestra di dialogo di Eclipse vienevisualizzata richiedendo una conferma che è OK eseguire l'aggiornamento automatico alla versionesuperiore dell'area di lavoro. Tali aggiornamenti automatici alle versioni superiori non dovrebberocausare problemi.

Non è necessario modificare programmi preesistenti per utilizzare l'ultima versione di WPS. Inoltre,i progetti creati con versioni precedenti di WPS si possono aprire e utilizzare con le versioni successivedi WPS, senza dover eseguire ulteriori azioni.

Migrazione dal software SAS®Se si dispone già di programmi scritti in linguaggio SAS, non è necessario intraprendere nessunprocesso di conversione per usare tali programmi con WPS. Qualsiasi file con l'estensione .wps o .sassi considera un programma che Workbench può aprire, modificare ed eseguire.

Guida dell’utente di WorkbenchVersione 4.1

12

Accesso ai programmi preesistentiÈ possibile accedere ai programmi preesistenti dalla vista Esplora file.

In alternativa, è possibile utilizzare progetti di Workbench per gestire ai file che consentono l'utilizzo dialtre funzionalità come la cronologia locale.

Controllo della compatibilità dei programmiL'apertura dei programmi in Workbench causa la visualizzazione in rosso degli elementi del linguaggiosconosciuti o non supportati. Prima di provare ad eseguire i programmi preesistenti in WPS, tuttaviasi consiglia anche di utilizzare l'Analizzatore di codice (pag. 12) di Workbench per un'ulterioreverifica.

Il completamento dell'analisi di programmi, persino di centinaia di programmi alla volta, può richiederepochi minuti e può pertanto essere più rapido rispetto al tentativo di eseguire programmi di lungaesecuzione. L'analisi dei programmi è disponibile nella vista Esplora file o nella vista Esplora progetti.

Analizzatore di codiceUtilizzare l'Analizzatore di codice di Workbench per analizzare il codice di programmi preesistenti scrittiin linguaggio SAS.

L'Analizzatore di codice è una funzionalità di Workbench e si può usare pertanto solo su piattaformein cui Workbench è supportato. L'Analizzatore di codice genera rapporti che indicano quali deiprogrammi preesistenti verranno eseguiti in WPS senza modifiche, quali programmi potrebberonecessitare modifiche per l'esecuzione e quali programmi contengono elementi del linguaggio nonancora supportati da WPS.

L'Analizzatore di codice consente di:

• Analizzare la compatibilità dei programmi – se i programmi o progetti preesistenti contengonoelementi del linguaggio non supportati.

• Analizzare l'uso del linguaggio – elenca gli elementi del linguaggio utilizzati nei programmi oprogetti selezionati. L'analisi indica quali elementi sono supportati e quali no.

Esecuzione di analisiL'Analizzatore di codice può analizzare rapidamente i singoli programmi o tutti i programmi in uno o piùprogetti, o tutti i programmi in una o più cartelle.

I programmi che normalmente si potrebbero eseguire su più piattaforme diverse si possono analizzareinsieme. È sufficiente raccogliere i programmi dagli altri ambienti, copiarli nella workstation e poieseguire gli strumenti di analisi in Workbench.

Guida dell’utente di WorkbenchVersione 4.1

13

Analisi della compatibilità dei programmiÈ possibile analizzare uno o più programmi per individuare quali contenevano gli elementi dellinguaggio che sono supportati in WPS.

Per analizzare i programmi in linguaggio SAS:

1. Selezionare i file da analizzare:

• Selezionare il/i file richiesto/i da analizzare in Esplora progetti o Esplora file. È possibileevidenziare programmi in diversi progetti o diverse cartelle nella vista specifica.

• Selezionare uno o più progetti in Esplora progetti per analizzare tutti i programmi contenuti.• Selezionare uno o più cartelle in Esplora file per analizzare tutti i programmi contenuti.

2. Nella vista corrispondente alla selezione, fare clic sugli elementi selezionati e dal menu di sceltarapida, fare clic su Analizza, quindi fare clic su Compatibilità dei programmi.

Al termine dell'analisi, si apre automaticamente in Workbench un Rapporto sulla compatibilità deiprogrammi.

Guida dell’utente di WorkbenchVersione 4.1

14

Tale rapporto contiene i dettagli sugli elementi del linguaggio non supportati, utilizzati nei programmi.Non segnala eventuali elementi del linguaggio supportati, utilizzati nel/i programma/i.

Analisi dell'uso del linguaggioÈ possibile analizzare uno o più programmi per individuare gli elementi del linguaggio supportati,utilizzati in uno o più programmi.

Per analizzare i programmi in linguaggio SAS:

1. Selezionare i file da analizzare:

• Selezionare il/i file richiesto/i da analizzare in Esplora progetti o Esplora file. È possibileevidenziare programmi in diversi progetti o diverse cartelle nella vista specifica.

• Selezionare uno o più progetti in Esplora progetti per analizzare tutti i programmi contenuti.• Selezionare uno o più cartelle in Esplora file per analizzare tutti i programmi contenuti.

2. Nella vista corrispondente alla selezione, fare clic sugli elementi selezionati e dal menu di sceltarapida, fare clic su Analizza, quindi fare clic su Uso del linguaggio.

Al termine dell'analisi, si apre automaticamente in Workbench un Rapporto sull'uso del linguaggio.

Guida dell’utente di WorkbenchVersione 4.1

15

Tale rapporto descrive in dettaglio gli elementi del linguaggio SAS utilizzati nei programmi selezionatied è possibile esplorare in dettaglio questo rapporto in Workbench, oppure esportarne il contenuto inMicrosoft Excel.

Analisi dei programmi per mainframeL'Analizzatore di codice è una funzionalità di Workbench e si può usare pertanto solo su piattaformein cui Workbench è supportato. Per analizzare programmi concepiti per l'esecuzione in un mainframe,copiare i programmi richiesti dal mainframe in una workstation che utilizza Workbench. Quando iprogrammi vengono analizzati, l'Analizzatore di codice individuerà gli elementi del linguaggio SASspecifici per la piattaforma z/OS.

Prima di analizzare i programmi copiati da un mainframe ad una workstation:

• Si consiglia di rimuovere i numeri di sequenza dai processi.• Assicurarsi che ogni file di programma abbia un'estensione del file .sas.• Creare pacchetti per i processi nel mainframe con XMIT.

Guida dell’utente di WorkbenchVersione 4.1

16

• Una volta trasferiti alla workstation, utilizzare XMIT Manager per decomprimere i processi perl'analisi.

Nota:XMIT Manager può solo gestire PDS (Partitioned Datasets, ovvero Set di dati partizionati) e nonPDSE (Extended Partitioned Datasets, ovvero Set di dati partizionati estesi).

Quando si scaricano i file XMIT dal mainframe alla workstation, è necessario specificare FB (FixedBlock, Blocco fisso) con un LRECL (Logical Record Length, Lunghezza del record logico) di 80 e senzaconversione ASCII/EBCIDIC, troncamento o traduzione CRL.

Visualizzazione o esportazione di un rapportosull'analisiÈ possibile visualizzare i dettagli di un rapporto sull'Analizzatore di codice in Workbench oppureesportare i dettagli del rapporto in Microsoft Excel.

Quando si visualizza un rapporto in Workbench, è possibile visualizzare maggiori dettagli efondamentalmente il programma di origine dove si trova un problema.

• Il riepilogo del rapporto sulla compatibilità dei programmi si collega ad un elenco dei programmianalizzati. Da questo elenco, si può accedere ad un elenco di elementi del problema, visualizzaredove si utilizzano tali elementi in un programma e passare al percorso degli elementi nel file.

• Il riepilogo del rapporto sull'uso del linguaggio visualizza gli elementi del linguaggio SAS utilizzatinei programmi analizzati. Da questo elenco, si può trovare la frequenza dell'uso degli elementi dellinguaggio SAS, quali programmi contengono gli elementi e passare al percorso degli elementi nelfile.

Esportazione dei risultati dell'analisi in Microsoft ExcelÈ possibile esportare i risultati di un rapporto sulla compatibilità dei programmi o sull'uso del linguaggioin un foglio di calcolo Microsoft Excel per un'ulteriore analisi o per archiviare le informazioni delrapporto. Per esportare un rapporto:

1. Nella pagina del riepilogo del rapporto, fare clic su Esporta risultati in Excel.2. Nella finestra Salva con nome, immettere il nome richiesto per il foglio di calcolo e selezionare il

percorso richiesto prima di salvarlo.

Restrizioni dell'analisiData la natura del linguaggio SAS, non si può garantire il risultato dell'analisi e bisogna considerare irapporti come una guida per un'ulteriore analisi.

L'Analizzatore di codice ha alcune limitazioni:

Guida dell’utente di WorkbenchVersione 4.1

17

• L'analizzatore di codice non creerà rapporti sulla sintassi incorretta.• Gli elementi del linguaggio SAS che non sono supportati attualmente in WPS, ora vengono mostrati

nel Rapporto sulla compatibilità come sconosciuti.• I rapporti sull'analisi non contengono attualmente informazioni sull'uso degli elementi del linguaggio

per le macro ed elementi (per l'accesso ai dati) del motore di raccolta. Il loro uso è tuttaviasupportato in WPS.

Importare un progettoPer importare un progetto preesistente in Workbench:

1. Fare clic sul menu File, selezionare Importa per aprire la procedura guidata Importa.2. Nella pagina Seleziona, espandere l'albero nel nodo Generale, selezionare Progetti preesistenti

nell'area di lavoro e fare clic su Avanti.3. Selezionare il metodo di importazione:

• Per importare un progetto preesistente, fare clic su Seleziona directory radice e selezionare ilprogetto dall'elenco o fare clic su Sfoglia per esplorare la cartella in cui si trova il progetto.

• Per importare un progetto archiviato, per esempio archiviato come file .zip o .tar, fare clicsu Seleziona file di archivio. Selezionare il file di archivio dall'elenco o fare clic su Sfoglia peresplorare la cartella in cui si trova il file di archivio.

Se il file di archivio o la cartella contiene un progetto valido, il nome del progetto viene aggiuntoall'elenco Progetti.

4. Fare clic su Fine per importare il progetto selezionato.

Utilizzare questo metodo per importare il progetto di esempio fornito con Workbench. I progetti diesempio sono disponibili in ogni lingua supportata e il file di archivio del progetto samples.zip si trovanella cartella doc/<language> nell'installazione di Workbench.

Guida dell’utente di WorkbenchVersione 4.1

18

Layout di WorkbenchI layout di Workbench o Prospettive vengono concepite per supportare la creazione, gestione, modificae l'esecuzione di programmi in un linguaggio specifico.

Prospettiva di WPS predefinitaLa prospettiva di WPS predefinita mostra le viste di Workbench necessarie per creare ed eseguire iprogrammi in linguaggio SAS.

Segue un esempio di prospettiva di WPS predefinita: Per dettagli sulla personalizzazione di questolayout, consultare prospettive (pag. 68).

Se si cambia il layout, è possibile reimpostare la prospettiva sul layout predefinito. Per reimpostare laprospettiva, fare clic sul menu Finestra, fare clic su Apri prospettiva, quindi fare clic su WPS.

Guida dell’utente di WorkbenchVersione 4.1

19

Guida in lineaLa vista Guida sensibile al contesto consente di visualizzare automaticamente le voci della guidapertinenti, quando si selezionano diverse viste di Workbench.

Questa vista non è aperta per impostazione predefinita. Per aggiungere questa vista alla prospettivaattuale, fare clic sul menu Guida, quindi fare clic su Guida dinamica o premere F1 .

Vista GuidaLa vista Guida visualizza il sommario della documentazione di WPS. Per visualizzare il sommario delladocumentazione di WPS, fare clic sul menu Guida, quindi fare clic su Sommario della guida. La vistaGuida offre funzionalità che contribuiscono ad esplorare la documentazione:

• Mostra nel Sommario – sincronizza il sommario con l'argomento della Guida che si sta leggendo.• Contrassegna documento – aggiunge un collegamento ad una pagina specifica nella

documentazione.• Cerca – ricerca nella guida per le parole chiave e frasi specifiche.

Schede di riferimento rapidoWorkbench contiene esercitaziono note come schede di riferimento rapido, concepite per assisterel'utente ad iniziare ad utilizzare WPS introducendo attività e funzionalità specifiche.

Le schede di riferimento rapido possono essere di due tipi diversi: semplici o composte.

Una scheda di riferimento rapido semplice, concepita per assistere l'utente durante una singola attività,ha un'introduzione per impostare la scena, seguita da un elenco di attività concepito per eseguirne unadopo l'altra:

Una scheda di riferimento rapido composta è concepita per assistere l'utente durante un problema piùcomplesso. Il problema viene suddiviso in gruppi gestibili più piccoli, ciascun gruppo comprendenteun'introduzione e una conclusione:

Guida dell’utente di WorkbenchVersione 4.1

20

Le schede di riferimento rapido composte presentano due riquadri nell'interfaccia utente. Uno mostra igruppi di attività, mentre l'altro mostra le attività in ciascun gruppo.

Guida dell’utente di WorkbenchVersione 4.1

21

Aprire una scheda di riferimento rapidoLe schede di riferimento rapido vengono aperte dal menu della guida in Workbench.

1. Fare clic sul menu Guida, quindi selezionare Schede di riferimento rapido.2. Selezionare la scheda di riferimento rapido dall'elenco e fare clic su OK per aprirla.

Guida dell’utente di WorkbenchVersione 4.1

22

Chiudere una scheda di riferimento rapidoÈ possibile chiudere la scheda di riferimento rapido attiva selezionando Chiudi nella scheda diriferimento rapido. La scheda di riferimento rapido attiva salva il proprio stato di completamento quandoviene chiusa, in modo da poter continuare nella posizione in cui è stata lasciata, quando si riapresuccessivamente.

Esplorazione di una scheda di riferimento rapidoQuando si apre una nuova scheda di riferimento rapido, l'introduzione si espande in modo che si possaleggere una breve descrizione sulla scheda di riferimento rapido selezionata.

In una scheda di riferimento rapido semplice, fare clic su Fai clic per iniziare nella parte inferioredel passaggio introduttivo. Il passaggio successivo viene quindi ampliato ed evidenziato. Sarannovisualizzati inoltre dei pulsanti di azione nella parte inferiore del passaggio successivo, per esempio Faiclic per completare.

In una scheda di riferimento rapido composta, leggere l'introduzione, quindi fare clic sul collegamentoVai a... nella parte inferiore della prima scheda. Viene visualizzata l'introduzione per il primo gruppo,fare clic sul collegamento Inizia a lavorare... per cominciare. L'utente avanza in un gruppo allo stessomodo di una semplice scheda di riferimento rapido.

Nelle schede di riferimento rapido semplici o un gruppo composto, quando si è completato unpassaggio specifico, selezionare Fai clic per completare per procedere al passaggio successivo. Unsegno di spunta viene visualizzato nel margine sinistro di ogni passaggio completato.

Le schede di riferimento rapido composte hanno una conclusione e anche l'opzione di rivedere l'attività,o di avanzare al prossimo gruppo di attività. L'avvio dell'attività successiva porterà all'introduzione per ilgruppo successivo.

È possibile aprire un qualsiasi passaggio in una scheda di riferimento rapido facendo clic sul titolo dellasezione. Se si stanno attraversando tutti i passaggi nella scheda, fare clic su Comprimi tutte levoci, tranne quella attuale per comprimere tutti i passaggi aperti tranne il passaggio attivo corrente inattesa di completamento.

Nelle schede di riferimento rapido composte, è possibile tornare a qualsiasi gruppo di attività perrivederlo facendo solo clic sul gruppo nel riquadro del gruppo di attività. Il punto visualizzato nel grupposi trova dove è stato lasciato quel gruppo, per esempio se sono state completate le attività del gruppo,viene visualizzata la conclusione.

Una semplice scheda di riferimento rapido viene completata al termine dell'ultimo passaggio. Leschede di riferimento rapido composte si considerano complete quando tutti i gruppi di attività sono staticompletati.

Per riavviare dal primo passaggio, aprire il primo passaggio e fare clic su Fai clic per riavviare. Unascheda di riferimento rapido composta consente di reimpostare i gruppi di attività. Fare clic con ilpulsante destro del mouse sul gruppo di attività nel riquadro dei gruppi e selezionare Reimposta.

Guida dell’utente di WorkbenchVersione 4.1

23

Server WPSPer eseguire i programmi in linguaggio SAS, Workbench richiede una connessione ad un server WPSconcesso in licenza.

Il server WPS può essere in esecuzione nella workstation locale oppure in un'installazione di WPS inun computer remoto.

• Un server WPS in un computer locale, è possibile accedere ad un server locale tramite unaconnessione con host locale.

• Un server WPS in un computer remoto, è possibile accedere ad un server remoto tramite unaconnessione con un host remoto.

Quando si installa WPS Workbench per la prima volta, vengono create una singola connessione con unhost locale denominata Locale e un server denominato Server locale. Detto server viene avviato perimpostazione predefinita all'avvio di Workbench e terminerà alla chiusura di Workbench.

Se necessario, è possibile creare ulteriori server locali o è possibile eliminare o disinstallare il serverlocale. La creazione di più server locali non richiede altri prodotti WPS concesso in licenza e l'unicarestrizione al numero di server locali che è possibile creare, è costituito dalle risorse del computerlocale.

La configurazione di server remoti offre l'accesso alla potenza di elaborazione di server remoti daWorkbench alla workstation. È possibile eseguire più server in una singola connessione con un hostremoto. Per maggiori informazioni, consultare Connettersi ad un server WPS remoto (pag. 52).

L'elenco di connessioni e server definiti viene archiviato in un'area di lavoro ed è visibile in Esploracollegamenti. Se si cambia area di lavoro, si avranno diverse connessioni e server. Per condividerele definizioni del server in un gruppo di lavoro, oppure tra aree di lavoro, esportare (consultare Esportauna definizione del server WPS (pag. 56)) e importare (consultare Importare una definizione delserver WPS (pag. 57)) le definizioni dei server in o da un file.

Configurare un'installazione a WPSlocaleCome configurare WPS Workbench per rimuovere il server WPS dalla workstation.

Se si eseguono solo programmi in linguaggio SAS in un server WPS remoto, è possibile modificarel'installazione di Workbench in modo da rimuovere il server locale. Questa opzione è solo disponibileper le installazioni di Workbench in Microsoft Windows.

Per rimuovere il server WPS:

Guida dell’utente di WorkbenchVersione 4.1

24

1. Aprire l'elemento del Pannello di controllo Programmi e funzionalità e selezionare WPS nell'elencodi programmi installati.

2. Fare clic su Cambia nella parte superiore della finestra Programmi e funzionalità. In Cambia,Ripara o Rimuovi, fare clic su Cambia:

3. Nella finestra Installazione personalizzata, cancellare Server WPS locale e completarel'installazione modificata.

Guida dell’utente di WorkbenchVersione 4.1

25

In una piattaforma diversa da Windows, non è possibile rimuovere il server WPS dall'installazione diWorkbench. Per rimuovere l'accesso al server locale da Workbench, nella vista Esplora collegamenti,selezionare il Server Locale e fare clic su Elimina.

Server WPS predefinitoImpostare o cambiare il server WPS utilizzato per impostazione predefinita quando si eseguonoprogrammi in linguaggio SAS in Workbench.

È necessario individuare una delle connessioni ai server disponibili definite in Workbench come ilserver WPS predefinito da utilizzare quando un programma in linguaggio SAS viene eseguito tramite ilcomando Esegui.

Alla prima installazione di Workbench, il Server locale è il server WPS predefinito; è possibileselezionare un server disponibile come server di Workbench predefinito.

Per impostare il server predefinito.

1. Aprire la vista Esplora collegamenti ed espandere la connessione contenente il server WPSrichiesto.

2. Fare clic con il pulsante destro del mouse sul server richiesto e selezionare Imposta come serverpredefinito nel menu di scelta rapida.

Guida dell’utente di WorkbenchVersione 4.1

26

Impostazioni di LOCALE e ENCODING delserver WPSLa configurazione delle opzioni di impostazioni locali e codifica per un server WPS.

Qualsiasi opzione di LOCALE definita in un file di configurazione viene ignorata quando si eseguono iprogrammi in linguaggio SAS da Workbench; è necessario impostare LOCALE come opzione di avvio diWorkbench per essere efficace.

Per visualizzare e salvare i programmi e altri file che contengono i caratteri per LOCALEselezionato,potrebbe essere necessario impostare un valore per la Codifica generale dei file di testo (pag. 27)per Workbench.

Impostare LOCALE per un server WPSLe impostazioni locali utilizzate da WPS vengono impostate singolarmente dal server specifico. Perimpostare l'opzione di sistema della lingua per le impostazioni locali di un server:

1. Nella vista Esplora collegamenti, assicurarsi che il server richiesto sia in esecuzione.2. Fare clic con il pulsante destro del mouse sul server e fare clic su Proprietà nel menu di scelta

rapida per visualizzare la finestra di dialogo Proprietà.3. Nell'elenco delle proprietà, fare clic su Avvio, quindi fare clic su Opzioni di sistema.4. Nel pannello Opzioni di sistema, fare clic su Aggiungi per visualizzare la finestra di dialogo

Opzione di avvio.5. Nel campo Nome, digitare LOCALE, e nel campo Valore, immettere il valore delle impostazioni locali

richieste.

È possibile trovare un elenco di valori validi di LOCALE nel Riferimento per gli elementi dellinguaggio di WPS.

6. Fare clic su OK per salvare le modifiche; riavviare il server per applicare le modifiche.

Impostare ENCODING per un server WPS.Inoltre, potrebbe essere necessario impostare un valore di ENCODING appropriato nel server (peresempio, per eseguire un'installazione di WPS contenente caratteri non ASCII). Per esempio,procedere nel modo seguente per impostare UTF-8 nel server:

1. Nella vista Esplora collegamenti, assicurarsi che il server richiesto sia in esecuzione.2. Fare clic con il pulsante destro del mouse sul server e fare clic su Proprietà nel menu di scelta

rapida per visualizzare la finestra di dialogo Proprietà.3. Nell'elenco delle proprietà, fare clic su Avvio, quindi fare clic su Opzioni di sistema.4. Nel pannello Opzioni di sistema, fare clic su Aggiungi per visualizzare la finestra di dialogo

Opzione di avvio.5. Nel campo Nome, digitare ENCODING, e nel campo Valore, digitare UTF-8 e fare clic su OK.

Guida dell’utente di WorkbenchVersione 4.1

27

È possibile trovare un elenco di valori validi di ENCODING nel Riferimento per gli elementi dellinguaggio di WPS.

6. Riavviare il server se richiesto.

Codifica generale dei file di testoPer visualizzare e salvare programmi e file che contengono caratteri internazionali, potrebbe esserenecessario impostare una codifica del file di testo appropriata.

È possibile realizzare la codifica dei file di testo a livello globale (per tutti i progetti di Workbench e ifile ad essi associati) o a livello di progetto (per programmi contenuti nel progetto specifico), laddove ènecessaria una codifica diversa all'opzione di codifica globale ereditata.

Impostare la codifica ad un livello globalePer impostare un valore di codifica globale:

1. Fare clic sul menu Finestra, quindi fare clic su Preferenze per visualizzare la finestra di dialogoPreferenze.

2. Nell'elenco di preferenze, espandere Generale, quindi fare clic su Area di lavoro.3. Nel pannello Area di lavoro, in Codifica file di testo, fare clic su Altro e selezionare il valore

richiesto dall'elenco.

Se l'opzione di codifica richiesta non si trova nell'elenco a discesa, immettere il nome della codifica,per esempio Shift_Jis nel campo Altro.

4. Fare clic su OK per applicare la modifica.

Controllare che le impostazioni locali siano impostate sul proprio paese, affinché i dati vengano gestiticorrettamente dal server WPS. Il server viene visualizzato nell'angolo inferiore destro di Workbench(per esempio, su IT_IT se si è sul territorio italiano). Se non è impostato, configurare le impostazioniLOCALE e ENCODING. Per maggiori informazioni, consultare Impostazioni LOCALE ed ENCODING delserver WPS (pag. 26).

Impostazione della codifica a livello di progettoPer impostare un valore di codifica per il progetto:

1. Nella vista Esplora progetti, selezionare il progetto richiesto, fare clic con il pulsante destro delmouse sul menu di scelta rapida, fare clic su Proprietà.

2. Nella finestra di dialogo Proprietà per …, nell'elenco delle proprietà, fare clic su Risorsa.3. A sinistra della finestra Proprietà, assicurarsi che l'opzione Risorsa sia selezionata.4. Nel pannello Risorsa, in Codifica file di testo, fare clic su Altro e selezionare il valore richiesto

dall'elenco.

Guida dell’utente di WorkbenchVersione 4.1

28

Se l'opzione di codifica richiesta non si trova nell'elenco a discesa, immettere il nome della codifica,per esempio UTF-8 nel campo Altro.

5. Fare clic su OK per applicare la modifica.

Codice di licenzaÈ necessario un codice di licenza valido per eseguire i programmi in un server WPS, e ogni server, chesia locale o remoto, richiede un codice di licenza separato.

Un codice di licenza è fornito in un file che termina in .wpskey, che è separato dal file di installazione diWPS.

Applicare un codice di licenzaCome applicare un nuovo codice di licenza al server WPS locale.

Se si utilizza un sistema operativo Microsoft Windows, assicurarsi di disporre di privilegi diamministratore prima di applicare un codice di licenza.

1. Fare clic sul menu Guida, quindi fare clic su Applica licenza.2. Nella finestra di dialogo Importa licenza per server Server locale:

• Copiare e incollare l'intero contenuto del file della licenza nella finestra.• Fare clic Importa dal file. Trovare il file del codice di licenza e fare clic su Apri.

3. Fare clic Fine per applicare la licenza.

In seguito all'installazione, è possibile visualizzare le informazioni dettagliate della licenza. Per farlo,fare clic sul menu Guida e fare clic su Visualizza licenza.

IntroduzioneWPS Workbench si può utilizzare insieme ai seguenti sistemi di gestione dei database, tramite ODBC(Open Database Connectivity) o i client nativi associati:

• Oracle, tramite Oracle Instant Client - consultare Connessione ad un database Oracle (pag.29).

• DB2, tramite IBM Data Server Runtime Client - consultare Connessione ad un database DB2(pag. 30).

Guida dell’utente di WorkbenchVersione 4.1

29

• SQL Server, tramite SQL Server Native Client - consultare Connessione ad un database SQLServer (pag. 32).

• MySQL tramite MySQL Connector/C - consultare Connessione ad un database MySQL (pag.33).

Nota:Laddove è possibile, bisogna utilizzare il client nativo RDBMS, piuttosto del client ODBC, per ottenereil miglior supporto per le opzioni dei database e il linguaggio SAS. Se non è possibile, consultareConnessione a un database tramite ODBC (pag. 34).

Driver client supportatiSono supportate le seguenti versioni dei connettori di client:

Motore 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

Connessione ad un database OracleRicevere i dati da un database Oracle quando ci si connette da WPS in esecuzione in una piattaformaWindows.

Prima di installare il software del client Oracle, assicurarsi che:

• WPS sia installato e si disponga della licenza.• Si disponga dei privilegi di amministratore necessari per installare WPS e il client Oracle.

Nota:Prima di installare il client Oracle:

• È necessario farlo corrispondere al tipo di installazione di WPS Workbench, vale a dire che sirichiede il client per Windows (a 32 bit) per la versione a 32 bit di WPS Workbench e si richiede ilclient per Windows (x64) per la versione a 64 bit di WPS Workbench.

• È necessario scaricare la versione del client che corrisponde alla versione del database di Oracle acui si sta eseguendo la connessione.

È necessario inoltre installare il connettere sul PC o server in cui saranno eseguiti i programmi inlinguaggio SAS. Procedere nel modo seguente:

Guida dell’utente di WorkbenchVersione 4.1

30

1. Scaricare Oracle Instant Client di base dalla pagina Instant Client download del sito Web diOracle.

2. Una volta scaricato il file di installazione (.zip) appropriato, creare una cartella per Instant client sulPC, per esempio C:\oracle e decomprimere il contenuto del file in quella cartella:

3. Aggiungere la directory di installazione Oracle Instant Client alla variabile di sistema Percorso, comeriportato di seguito:

a. Nel Pannello di controllo, selezionare Sistema ➤ Impostazioni di sistema avanzate.

b. Selezionare Variabili di ambiente, seguito daModifica... e aggiungere il percorso alla variabiledi ambiente Percorso preesistente.

4. Avviare WPS Workbench per verificare che le modifiche all'ambiente Percorso del percorso sianodisponibili.

È possibile visualizzare la variabile PATH in WPS Workbench tramite il seguente programma inlinguaggio SAS:

DATA _null_;

LENGTH pathname $ 32760;pathname = SYSGET('PATH');PUT pathname= ;RUN;

L'output del registro dovrebbe contenere la directory di installazione di Oracle Instant Client aggiuntaal punto precedente.

Una volta installato il client, provare la connettività al database tramite la seguente istruzione in WPSWorkbench:

LIBNAME DATASRC ORACLE user=<user_name> password=<password> path='<remote-id>/TNS';PROC DATASETS library=DATASRC;run;

Sostituire <user_name> e <password> con il nome e la password dell'utente per il server.L'opzione percorso contiene il nome del server (specificato in precedenza come <remoto-id>)e, facoltativamente, un nome TNS. Il comando PROC DATASETS riporta i nomi di tutte le tabelle neldatabase selezionato; per i database con un gran numero di tabelle, l'esecuzione di questo programmapotrebbe richiedere del tempo.

Nota:Per i dettagli completi di PROC DATASETS, consultare la guida Riferimento per gli elementi dellinguaggio di WPS.

Connessione ad un database DB2Prima di installare IBM Data Server Runtime Client, assicurarsi che:

• WPS sia installato e si disponga della licenza.

Guida dell’utente di WorkbenchVersione 4.1

31

• Si disponga dei privilegi di amministratore necessari per installare WPS e IBM Data Server RuntimeClient.

Nota:Quando si seleziona il client runtime, è necessario farlo coincidere con il tipo di installazione di WPSWorkbench, vale a dire che si richiede il client AMD e Intel x86 per Windows a 32 bit per la versionea 32 bit di WPS Workbench e si richiede il client AMD64 e Intel EM64T per Windows a 64 bit per laversione a 64 bit di WPS Workbench.

Procedere nel modo seguente:

1. Scaricare IBM Data Server Runtime Client dalla pagina Download Clients and Drivers del sitoWeb di IBM.

2. Una volta scaricato, individuare ed eseguire il file di installazione eseguibile. Seguire le istruzioninella procedura guidata per il tipo di installazione Tipica.

Nota:Per una futura facilità d'uso, si consiglia di verificare che la cartella di installazione sia nel percorsodel sistema.

3. Impostare la variabile di ambiente DB2CMDEXE in modo che punti al file db2cmd.exe (in genereC:\Programmi\IBM\SQLLIB\BIN\db2cmd.exe), come riportato di seguito:

a. Nel Pannello di controllo, selezionare Sistema ➤ Impostazioni di sistema avanzate.

b. Selezionare Variabili di ambiente, seguito da Nuova....c. Creare una variabile di sistema con un Nome variabile di DB2CMDEXE e un Valore variabile

della directory di installazione del client DB2, per esempio C:\Programmi\IBM\SQLLIB\BIN\db2cmd.exe

4. Dopo l'installazione, è necessario configurare la connessione dal client al server a cui si eseguiràl'accesso:

a. Aprire un prompt dei comandi ed eseguire DB2CMD. Nella nuova finestra, digitare DB2 peraccedere al processore della riga di comando per il client DB2.

b. Creare un nodo che faccia riferimento al database remoto, tramite il seguente comando:

catalog TCPIP node <node_name> REMOTE <server> SERVER <port_service>

<node_name> è il nome della connessione locale, <server> è l'indirizzo IP o il nome del serverche ospita il database e <port_service> è il numero di porta del server o il nome dell'istanza didatabase nel server.

c. Creare un riferimento per l'istanza di database (che si connetterà tramite il <node_name> creatoal punto precedente), con il seguente comando:

catalog database <database_name> AS <alias_name> AT NODE <node_name>

<database_name> è l'istanza del database nel server DB2, <alias_name> è il nome che siutilizzerà nel client DB2 per connettersi all'istanza di database e <node_name> è il nome dellaconnessione creata in precedenza.

Guida dell’utente di WorkbenchVersione 4.1

32

d. Connettersi al nome della connessione locale creata in precedenza (<node_name>) tramite ilseguente comando:

connect to <node_name> user <user_name> using <password>

<node_name> è il nome della connessione creata in precedenza e <user_name> e <password>sono l'ID e la password dell'utente per il server DB2.

Se la connessione si stabilisce correttamente, verranno visualizzate le informazioni dellaconnessione al database ed è possibile chiudere il processore della riga di comando per il clientDB2:

db2=> connect to testdb2 user Test using password

Database Connection Information Database server = DB2/LINUX SQL authorization ID = TEST Local database alias = TESTDB2

Una volta installato il client, avviare WPS Workbench e testare la connettività al database tramite laseguente istruzione in WPS Workbench:

LIBNAME DATASRC DB2 user=<user_name> password=<password> DSN=TESTDB2;PROC DATASETS library=DATASRC;run;

Sostituire <user_name> e <password> con il nome e la password dell'utente per il server.

Connessione ad un database SQLServerPrima di installare Microsoft SQL Server 2008 Native Client, assicurarsi che:

• WPS sia installato e si disponga della licenza.• Si disponga dei privilegi di amministratore necessari per installare WPS e il client SQL Server.

Nota:Quando si installa il client SQL Server, è necessario farlo corrispondere al tipo di installazione di WPSWorkbench, vale a dire che si richiede il client x86 per la versione a 32 bit di WPS Workbench e sirichiede il client x64 per la versione a 64 bit di WPS Workbench.

Procedere nel modo seguente:

1. Scaricare il programma di installazione di Microsoft SQL Server 2008 Native Client (sqlncli.msi)dalla pagina Microsoft SQL Server 2008 R2 Service Pack 3 Feature Pack del sito Web diMicrosoft (fare clic su Scarica, quindi selezionare sqlncli.msi).

2. Una volta scaricato il file, eseguirlo e seguire le istruzioni visualizzate per installare il client.

Guida dell’utente di WorkbenchVersione 4.1

33

Avviare WPS Workbench e provare la connettività al database tramite la seguente istruzione in WPSWorkbench:

LIBNAME DATASRC SQLServr user=<user_name> password=<password> server=<remote-id>;PROC DATASETS library=DATASRC;run;

Sostituire <user_name> e <password> con il nome e la password dell'utente per il server <remote-id>.

Connessione ad un database MySQLPrima di installare il software del client MySQL, assicurarsi che:

• WPS sia installato e si disponga della licenza.• Si disponga dei privilegi di amministratore necessari per installare WPS e il client MySQL.

Nota:Quando si seleziona il client MySQL, è necessario farlo corrispondere al tipo di installazione di WPSWorkbench, vale a dire che si richiede il client per Windows (a 32 bit) per la versione a 32 bit di WPSWorkbench e si richiede il client per Windows (x64) per la versione a 64 bit di WPS Workbench. I nomidelle raccolte per le diverse versioni del client sono identici, in modo da poter avere solo una versionedel client (a 32 o 64 bit) registrata nella variabile di sistema Percorso.

Procedere nel modo seguente:

1. Scaricare il programma di installazione di MySQL Connector/C (.msi) dalla paginaDownloadConnector/C del sito Web di MySQL.

2. Una volta scaricato il file di installazione (.msi):

a. Fare doppio clic per il file scaricato per cominciare l'installazione (sarà necessario leggere eaccettare il contratto di licenza di MySQL).

b. Selezionare un'installazione Tipica e fare clic su Installa.3. Aggiungere la directory di installazione MySQL Connector/C contenente libmysql.dll alla

variabile di sistema Percorso, come riportato di seguito:

a. Nel Pannello di controllo, selezionare Sistema ➤ Impostazioni di sistema avanzate.

b. Selezionare Variabili di ambiente, seguito daModifica... e aggiungere il percorso della directoryalla variabile di ambiente Percorso preesistente.

4. Avviare WPS Workbench per verificare che le modifiche all'ambiente Percorso siano disponibili.

Guida dell’utente di WorkbenchVersione 4.1

34

È possibile visualizzare la variabile PATH in WPS Workbench tramite il seguente programma inlinguaggio SAS:

DATA _null_; LENGTH pathname $ 32760; pathname = SYSGET('PATH'); PUT pathname= ;RUN;

L'output del registro dovrebbe contenere la directory di installazione di MySQL Connector/Caggiunta al punto precedente.

Una volta installato il connettore, testare la connettività al database tramite la seguente istruzione inWPS Workbench:

LIBNAME DATASRC MYSQL user=<user-name> password=<password> server=<remote-id> database=<dbase>;PROC DATASETS library=DATASRC;run;

Sostituire <user_name> e <password> con il nome e la password dell'utente per il server <remote-id>.

Promemoria:È necessario fornire un nome del database <dbase> per l'istruzione LIBNAME in modo da connettersicorrettamente.

Connessione a un database tramiteODBCODBC (Open Database Connectivity) è una opzione per la connessione indipendente al databaseper WPS. È necessario utilizzare ODBC come opzione di connessione laddove non esiste un client diconnessione nativo.

ODBC fornisce la funzionalità per creare un programma in linguaggio SAS che archivia dati in unRDBMS, quindi per modificare il database che archivia i dati, senza che sia necessario modificare inmodo significativo il programma.

Cautela:L'uso di ODBC potrebbe limitare la funzionalità che altrimenti sarebbe disponibile attraverso un clientnativo, ad esempio quando si usano i comandi Passthrough esplicito in PROC SQL (Passthroughesplicito utilizza SQL cosí come lo comprende il server a cui si sta effettuando la connessione e passale istruzioni letteralmente al RDBMS).

Guida dell’utente di WorkbenchVersione 4.1

35

Ogni driver ODBC richiede la creazione di un DSN (Data Source Name) e le informazioni necessarieper la sua creazione variano in base ai database. La seguente procedura creerà un DSN utilizzando ildriver ODBC per SQLite per l'uso.

Nota:La versione del driver ODBC selezionata deve corrispondere al tipo di installazione di WPS, vale a dire,se è installata la versione a 32 bit di WPS, selezionare un driver ODBC a 32 bit, e se è installata laversione a 64 bit di WPS, selezionare un driver ODBC a 64 bit.

1. Scaricare il driver ODBC per SQLite dal sito Web SQLite ODBC Driver .2. Una volta scaricato, fare doppio clic sul file eseguibile e seguire le istruzioni visualizzate per

installare il driver.3. Creare un file vuoto nel PC per contenere il database, per esempio E:\data\mydata.sqlite.4. Creare un DSN per il driver ODBC come riportato di seguito.

a. Nel Pannello di controllo, selezionare Strumenti di amministrazione, quindi scegliere Originidati ODBC (32 bit) oppure Origini dati ODBC (64 bit) ove opportuno.

b. Nella scheda DSN utente, fare clic su Aggiungi... e selezionare SQLite3 ODBC Driver nellafinestra di dialogo Crea nuova origine dati.

c. Nella finestra di dialogo SQLite3 ODBC DSN Configuration, immettere le seguenti informazioni:

• Nome origine dati - Il nome a cui fanno riferimento i programmi in linguaggio SAS eseguiti inWPS, per esempio SQLITE.

• Nome database - Il file del nome per il database, per esempio E:\data\mydata.sqlite.

Le altre informazioni sono facoltative, ma possono offrire una migliore gestione dati all'interno deldatabase. Per esempio, per imporre vincoli alla chiave esterna, selezionare Chiavi esterne nellafinestra di configurazione. È possibile trovare ulteriori dettagli sulle opzioni nella documentazionedi SQLiteODBC.

d. Una volta selezionate tutte le opzioni necessarie, fare clic su OK per creare il DSN e chiudere lafinestra di dialogo Origini dati ODBC.

Una volta creato il DSN, provare la connettività al database tramite la seguente istruzione in WPSWorkbench:

PROC SQL; CONNECT TO ODBC (DATASRC=<dsn-name>); EXECUTE (CREATE TABLE test (ID INTEGER, name TEXT)) BY ODBC; DISCONNECT FROM ODBC;QUIT;

Sostituire <dsn-name> con il Nome origine dati immesso nella finestra di dialogo ConfigurazioneDSN.

Guida dell’utente di WorkbenchVersione 4.1

36

Se la creazione è riuscita correttamente, il registro di Workbench dovrebbe contenere le seguentiinformazioni:

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.

Riavviare il serverAd ogni chiusura di Workbench, i risultati temporanei associati alla sessione (il registro, tutti i risultatidell'output, i riferimenti ai file, i riferimenti alle raccolte, i set di dati e così via) vengono cancellati. Sesi desidera cancellare gli stessi risultati temporanei prima della fine della sessione di Workbench, èpossibile riavviare il server WPS. Il riavvio del server indica che i programmi non potranno più interagirecon gli oggetti temporanei creati nella precedente sessione del server.

In alternativa, è possibile cancellare il registro o i risultati, e mantenere tutto l'altro output temporaneo.

Per riavviare il server:

1. Fare clic sul menu File, fare clic su Riavvia server e fare clic su Locale (o il nome del server WPSremoto). Se si riavvia il server locale, è possibile utilizzare la combinazione di tasti CTRL + Alt + S.

2. Potrebbe essere visualizzata una finestra di conferma. Fare clic su OK per riavviare il server. Nonverrà visualizzata la finestra di dialogo di conferma se è stata selezionata in precedenza l'opzioneNon visualizzare più questa conferma in questa finestra di dialogo.

Riavvio con le azioni del server avanzateSe si è selezionato Mostra azioni del server avanzate nella pagina Preferenze di WPS della finestraPreferenze, il menu di scelta rapida per il server WPS nelle viste Esplora server WPS, Esploraoutput ed Esplora risultati visualizza le opzioni di riavvio alternative:

• Riavvia, nuova WORK - riavviare e cancellare il contenuto della raccolta WORK.• Riavvia, mantieni WORK – riavviare e mantenere il contenuto della raccolta WORK.

Guida dell’utente di WorkbenchVersione 4.1

37

Viste e prospettiveIl layout degli elementi in WPS Workbench è noto come prospettiva e comprende le singole finestre checontengono una o più viste. Queste viste mostrano tipi specifici di informazioni e forniscono funzionispecifiche. Alcune viste dispongono inoltre di barre degli strumenti specifiche per il contesto, situatenella parte superiore destra di ciascuna vista.

Questa sezione offre una panoramica delle perspettive e di ognuna delle viste disponibili, descrivendole principali azioni che vengono realizzate all'interno di ogni vista.

Esplora progettiLa vista Esplora progetti viene utilizzata per modificare e gestire programmi in linguaggio SAS e file,programmi o set di dati correlati, organizzati in progetti.

I progetti possono archiviare qualsiasi tipo di file locale, e operazioni del file system di supporto, qualel'esecuzione di programmi. È possibile gestire gli oggetti nei progetti con la Cronologia locale (pag.43) ed è anche possibile esportarli in archivi compressi o in altre cartelle nel file system locale. Nonè possibile utilizzare la vista Progetto per gestire i file archiviati in un file system remoto o i file in un filesystem locale che non fanno parte del progetto.

La vista Esplora progetti mostra solo i progetti che si trovano nell'area di lavoro attuale. È possibilecreare diversi Progetti (pag. 38) in un'area di lavoro e utilizzare ogni progetto per un'attivitàspecifica.

La selezione di un elemento in Esplora progetti visualizza le informazioni su quell'elemento nella vistaProprietà.

Visualizzazione della vistaPer mostrare la vista Esplora progetti:

Dal menu Finestra, fare clic su Mostra vista, quindi fare clic su Esplora progetti.

Strumenti del sistema operativoOltre agli strumenti di Workbench, è possibile utilizzare quelli forniti dal sistema operativo per eliminare,tagliare, copiare e incollare gli oggetti in un progetto. Se si utilizzano gli strumenti del sistema operativoinvece di quelli presenti in Workbench, le modifiche non vengono preservate nella cronologia locale.

Potrebbe essere necessario aggiornare la vista Esplora progetti per garantire che gli oggettimanipolati in questo modo siano visualizzati correttamente. Per realizzarlo, fare clic con il pulsantedestro del mouse sul progetto e selezionare Aggiorna nel menu di scelta rapida.

Guida dell’utente di WorkbenchVersione 4.1

38

ProgettiUn progetto è una rappresentazione di Workbench di una cartella contenente oggetti, quali programmi,set di dati, file e cartelle.

WPS utilizza un progetto per contenere i file e le cartelle che sono in relazione tra loro. Ad esempio, sipotrebbe disporre di un progetto contenente programmi che sono ancora in fase di sviluppo e un altroprogetto per le applicazioni di creazione di rapporti mensili. Non esiste alcun limite al numero di progettiche è possibile aprire in WPS Workbench.

Ogni progetto viene definito da un file di definizione del progetto denominato .project archiviato nelladirectory radice di un progetto. È solo possibile visualizzare questo file nel browser del file di sistema enon bisogna eliminarlo, modificarlo, spostarlo dalla cartella del progetto o copiarlo in un altro progetto.

È possibile solo aprire un'area di lavoro alla volta in Workbench, ma si può alternare tra aree di lavorose necessario. La vista Esplora progetti viene utilizzata per visualizzare e gestire l'attuale area dilavoro e progetti nell'area di lavoro attiva.

Creare un nuovo progettoPer creare un nuovo progetto:

1. Fare clic sul menu File, fare clic su Nuovo, quindi fare clic su Progetto per avviare la proceduraguidata Nuovo progetto.

2. Espandere la cartella Generale, fare clic su Progetto e poi su Avanti.3. Immettere il nuovo Nome progetto.4. Per creare il nuovo progetto in un percorso diverso dalla cartella dell'area di lavoro corrente,

cancellare Utilizza percorso predefinito e specificare una nuova directory nel campo Percorso.5. Fare clic su Fine per creare il nuovo progetto.

Il nuovo progetto viene visualizzato nella vista Esplora progetti. Se il percorso del nuovo progettonon è nella cartella dell'area di lavoro, il percorso alla cartella del progetto viene visualizzata nella vistaProprietà.

È possibile utilizzare anche la funzione di Copia e Incolla di Workbench, per creare un nuovo progettobasato su un progetto preesistente.

Creare una nuova cartella in un progetto

Per creare una nuova cartella:

1. Nel menu File, fare clic su Nuovo, quindi fare clic su Cartella per avviare la procedura guidataNuova cartella.

Guida dell’utente di WorkbenchVersione 4.1

39

2. L'entità principale per i valori predefiniti della cartella al progetto o alla cartella corrente selezionatanella vista Esplora progetti.

3. Immettere un Nome cartella per la nuova cartella.4. Per cambiare il percorso della cartella nel file system, fare clic su Avanzate e selezionare una delle

seguenti opzioni:

• Utilizza percorso predefinito. La cartella viene creata come cartella del file system, nello stessopercorso come cartella padre o area di lavoro.

• La cartella non si trova nel file system (cartella virtuale). La cartella solo esiste comeelemento dell'area di lavoro, ma non è stata creata nessuna cartella nel file system. Èpossibile trascinare la selezione delle altre risorse del progetto nella cartella virtuale per crearecollegamenti ad altri file e cartelle in questa nuova cartella, e anche per aggiungere cartellevirtuali. Non è possibile creare file fisici e cartelle all'interno di cartelle virtuali.

• Collegamento al percorso alternativo (cartella collegata). Crea la cartella padre nel filesystem in un percorso diverso della cartella padre o area di lavoro. Fare clic su Sfoglia perselezionare la cartella nel file system a cui collegarsi.

5. Fare clic su Fine per creare la nuova cartella.

Spostare o copiare un file di progetto

Per spostare qualsiasi cartella, file, programma o qualsiasi altro oggetto, tra progetti o tra cartelleall'interno dello stesso progetto:

1. Nella vista Esplora progetti, selezionare l'oggetto che è necessario spostare.2. Fare clic sul menu File, quindi fare clic su Sposta. Nella finestra di dialogo Sposta risorse,

selezionare il nuovo progetto o la nuova cartella di destinazione, e fare clic su OK per spostare larisorsa.

Se si desidera duplicare l'oggetto invece di spostarlo, fare clic sul menu Modifica, quindi fare clicsu Copia; selezionare la cartella o il progetto di destinazione, fare clic sul menu Modifica, quindifare clic su Incolla. Se si duplica l'oggetto nello stesso progetto o nella stessa cartella in cui si troval'originale, è necessario fornire un nome diverso per l'oggetto copiato.

Per riportare l'oggetto nel suo percorso originale, fare clic sul menu Modifica, quindi fare clic suAnnulla spostamento di risorse se l'oggetto è stato spostato o Annulla copia di risorse se l'oggettoè stato duplicato.

Collegamento del file attivo a Esplora progetti

Se si hanno diversi file da diversi progetti aperti nella vista Editor, è possibile configurare la vistaEsplora progetti per evidenziare il programma nel progetto o nella cartella ogni volta che quelprogramma diventa attivo nella vista Editor.

Guida dell’utente di WorkbenchVersione 4.1

40

Per collegare la vista Esplora progetti e la vista Editor, nella vista Esplora progetti, fare clic suCollega con editor.

Eliminare un file da un progetto

Per eliminare un oggetto da un progetto:

1. Nella vista Esplora progetti, selezionare l'oggetto richiesto da eliminare.2. Fare clic sul menu Modifica, quindi fare clic su Elimina. Nella finestra di dialogo Elimina risorse,

fare clic su OK.

Per riportare l'oggetto al suo percorso originale, fare clic sul menu Modifica e fare clic su Annullaeliminazione risorsa.

Rinominare un progetto o file di progettoPer rinominare un progetto o un oggetto in un progetto:

1. Nella vista Esplora progetti, selezionare l'oggetto o progetto richiesto.2. Fare clic sul menu File, quindi fare clic su Rinomina.3. Immettere il Nuovo nome nella finestra di dialogo Rinomina risorsa e fare clic su OK.

Copiare un progettoÈ possibile utilizzare la funzione di Copia e Incolla di Workbench, per creare un nuovoprogetto basato su un progetto preesistente.

1. Nella vista Esplora progetti, selezionare il progetto richiesto.2. Fare clic sul menu Modifica, quindi fare clic su Copia.3. Fare clic sul menu Modifica, fare clic su Incolla e nella finestra di dialogo Copia progetto,

immettere un nuovo Nome progetto .

Se si desidera copiare il progetto ad un percorso diverso dall'area di lavoro corrente, cancellareUtilizza percorso predefinito e immettere un Percorso alternativo per il nuovo progetto.

4. Fare clic su OK per creare il progetto.

Guida dell’utente di WorkbenchVersione 4.1

41

Importare file or archiviÈ possibile importare i file da un file di archivio (come un file zip) o dal file system in un progettopreesistente.

Per importare i file:

1. Fare clic sul menu File, quindi selezionare Importa per aprire la procedura guidata Importa.2. Espandere l'albero nel nodo Generale e selezionare una delle seguenti opzioni:

• File System – per importare file e cartelle non archiviati in un unico file.• File di archivio – per importare file e cartelle che vengono archiviati in un file (per esempio, uno

zip o tar.gz).3. Fare clic su Avanti e fare clic su Sfoglia per selezionare il file di archivio o la directory.4. Verrà visualizzato un elenco di file e cartelle disponibili per l'importazione. Verificare che siano

selezionati tutti gli oggetti che si desidera importare.

Non selezionare la cartella padre dei file da importare; in quel caso, i file importati vengono aggiuntiad una sottocartella nel progetto.

Nota:Non importare un file di definizione del progetto (.project ); in quel caso, il file importatosovrascriverà il file di definizione del progetto nel progetto preesistente.

5. Fare clic su Sfoglia e specificare la cartella In: cartella di destinazione dei file di importazione.6. Fare clic su Fine per importare i file selezionati.

Chiudere e riaprire un progettoÈ possibile chiudere o aprire un progetto per controllare il numero di progetti disponibili in un'area dilavoro.

Per chiudere un progetto:

1. In Esplora progetti, fare clic con il pulsante destro del mouse su un progetto aperto e fare clic suChiudi progetto nel menu di scelta rapida.

La chiusura di un progetto comprime l'albero nel progetto nella vista Esplora progetti e chiude iprogrammi o altri file che sono stati aperti nella vista Editor di Workbench.

Se si desidera aprire o riaprire un progetto chiuso, in Esplora progetti, fare clic con il pulsantedestro del mouse su un progetto chiuso ( ) e selezionare Apri progetto nel menu di scelta rapida.

Guida dell’utente di WorkbenchVersione 4.1

42

Esportare un progettoPer eseguire una copia o backup di un progetto e di tutti i file e le cartelle contenute al suo interno:

1. Nella vista Esplora progetti, selezionare il progetto da esportare.2. Fare clic sul menu File, quindi fare clic su Esporta per visualizzare la procedura guidata Esporta.3. Nella pagina Seleziona, espandere il nodo Generale e selezionare

• File di archivio per creare il file zip nel percorso dell'esportazione.• File system realizza una copia della cartella del progetto e del suo contenuto.

4. Fare clic su Avanti e selezionare le cartelle e i file da esportare dal progetto selezionato.5. Se si esporta in un archivio, immettere il percorso del file, incluso il nome file in Nel file di archivio.

Se si esegue l'esportazione nel file system, immettere il percorso della cartella in Nella directory.6. Fare clic su Fine per esportare le cartelle e i file selezionati.

Eliminare un progettoPer eliminare un progetto:

1. Nella vista Esplora progetti, selezionare il progetto richiesto da eliminare.2. Fare clic sul menu Modifica e selezionare Elimina.3. Nella finestra di dialogo Elimina risorse, scegliere se eliminare il riferimento al progetto nell'area di

lavoro corrente oppure eliminare il riferimento e il contenuto della cartella sul disco:

a. per rimuovere il riferimento all'area di lavoro al progetto senza eliminare la cartella o il contenutodel progetto, cancellare Elimina contenuto del progetto su disco (non si può annullare).

b. Per rimuovere il riferimento all'area di lavoro e il contenuto della cartella dal disco, selezionareElimina contenuto del progetto su disco (non si può annullare).

4. Fare clic su OK.

Confronto e unione di più fileÈ possibile svolgere confronti bilaterali o trilaterali tra le diverse versioni di un file.

I confronti trilaterali mostrano le differenze tra le tre diverse versioni di un file, per esempio le differenzetra la risorsa in Workbench, la versione della risorsa che è impegnata in un ramo, e il predecessorecomune su cui si basano le due versioni in conflitto. Se non è possibile determinare un predecessorecomune, per esempio perché una risorsa con lo stesso nome e percorso è stata creata e impegnata dadue sviluppatori diversi, il confronto diventa un confronto bilaterale.

1. In Esplora progetti, evidenziare i file che si desidera confrontare. È possibile selezionare fino a trefile diversi.

Guida dell’utente di WorkbenchVersione 4.1

43

2. Fare clic con il pulsante destro del mouse, e nel menu di scelta rapida, fare clic su Confronta con,quindi fare clic su A vicenda.

• In un confronto bilaterale, la finestra Confronto del testo visualizza le differenze(contrassegnate in grigio) tra i due file.

• In un confronto trilaterale, selezionare il predecessore comune, il file contro cui si realizzano iconfronti. La finestra Confronto del testo visualizza le due versioni del file. Per visualizzare ilpredecessore comune contemporaneamente, fare clic su Mostra riquadro predecessore.

3. Realizzare le modifiche richieste ai file

È possibile esplorare i file tramite la barra degli strumenti di confronto del testo:

• Fare clic su Differenza successiva per mostrare la prima differenza tra i file dopodell'ubicazione del cursore o del testo evidenziato.

• Fare clic su Differenza precedente per mostrare la prima differenza tra i file primadell'ubicazione del cursore o del testo evidenziato.

• Fare clic su Modifica successiva per mostrare la prima modifica tra le versioni del file dopodell'ubicazione del cursore o del testo evidenziato.

• Fare clic su Modifica precedente per mostrare la prima differenza tra le versioni del file primadell'ubicazione del cursore o del testo evidenziato.

È possibile unire le modifiche da un file all'altro tramite la barra degli strumenti del confronto deltesto:

• Fare clic su Copia modifica corrente da destra a sinistra per sovrascrivere il testo evidenziatonel file a sinistra con il testo evidenziato nel file a destra.

• Fare clic su Copia tutto da destra a sinistra per sostituire il contenuto del file a sinistra con ilcontenuto del file a destra.

• Fare clic su Copia modifica corrente da sinistra a destra per sovrascrivere il testo evidenziatonel file a destra con il testo evidenziato nel file a sinistra.

• Fare clic su Copia tutto da sinistra a destra per sostituire il contenuto del file a destra con ilcontenuto del file a sinistra.

4. Una volta apportate le modifiche, fare clic sul menu File, quindi fare clic su Salva .5. Fare clic sul menu File, quindi fare clic su Chiudi per chiudere la finestra Confronto del testo.

Cronologia localeWorkbench mantiene una cronologia locale di modifiche a programmi o altri file di progetto cambiatinella vista Esplora progetti.

Ogni volta che si salva un file di progetto in Workbench, una istantanea del contenuto attuale del fileviene aggiunta alla cronologia locale di Workbench. Tale cronologia offre l'opportunità di confrontare osostituire i programmi con la cronologia locale.

Guida dell’utente di WorkbenchVersione 4.1

44

Cronologia delle eliminazioniOgni volta che si elimina un programma o file, la cronologia delle modifiche dell'elemento che si eliminaviene aggiunta alla cronologia locale del progetto o della cartella che lo contiene. Ciò consente diripristinare lo stato dalla cronologia locale oppure di selezionare lo stato specifico dalla cronologia deglielementi da ripristinare. Per maggiori informazioni, visitare Ripristinare dalla cronologia locale (pag.45) e Sostituire dalla cronologia locale (pag. 45).

Preferenze della Cronologia localeLe preferenze della Cronologia locale consentono di controllare la durata in cui si mantiene lacronologia locale, quante voci mantenere nella cronologia e le massime dimensioni del file che èpossibile registrare. Consultare Preferenze della Cronologia locale (pag. 46) per maggioriinformazioni.

Confrontare con la cronologia localePer confrontare un file di progetto corrente salvato con una versione precedente:

1. Nella vista Esplora progetti, selezionare il file richiesto, fare clic con il pulsante destro del mouse eselezionare Confronta con, quindi fare clic su Cronologia locale nel menu di scelta rapida.

Si apre una finestra Cronologia che mostra l'elenco delle versioni del programma con le ore delleversioni.

2. Fare doppio clic sulla versione con cui si desidera confrontare la versione corrente del file.

La finestra Confronto del testo si apre visualizzando le differenze (contrassegnate in grigio) trale due versioni. La versione corrente viene visualizzata a sinistra, con la versione della cronologialocale a destra.

3. Realizzare le modifiche richieste ai file

È possibile esplorare i file tramite la barra degli strumenti di confronto del testo:

• Fare clic su Differenza successiva per mostrare la prima differenza tra i file dopodell'ubicazione del cursore o del testo evidenziato.

• Fare clic su Differenza precedente per mostrare la prima differenza tra i file primadell'ubicazione del cursore o del testo evidenziato.

• Fare clic su Modifica successiva per mostrare la prima modifica tra le versioni del file dopodell'ubicazione del cursore o del testo evidenziato.

• Fare clic su Modifica precedente per mostrare la prima differenza tra le versioni del file primadell'ubicazione del cursore o del testo evidenziato.

È possibile unire le modifiche da un file all'altro tramite la barra degli strumenti del confronto deltesto:

Guida dell’utente di WorkbenchVersione 4.1

45

• Fare clic su Copia modifica corrente da destra a sinistra per sovrascrivere il testo evidenziatonel file a sinistra con il testo evidenziato nel file a destra.

• Fare clic su Copia tutto da destra a sinistra per sostituire il contenuto del file a sinistra con ilcontenuto del file a destra.

4. Una volta apportate le modifiche, fare clic sul menu File, quindi fare clic su Salva .5. Fare clic sul menu File, quindi fare clic su Chiudi per chiudere la finestra Confronto del testo.

Sostituire dalla cronologia localeCome ripristinare un programma in un progetto ad una versione precedente salvata

È possibile sostituire la versione corrente con la versione precedente o selezionare una versione dallacronologia locale.

1. Per sostituire la versione corrente con la versione precedente, in Esplora progetti, fare clic con ilpulsante destro del mouse sul file richiesto, nel menu di scelta rapida, fare clic su Sostituisci con,quindi fare clic su Precedente dalla Cronologia locale.

2. Per sostituire la versione corrente con una versione dalla cronologia locale:

a. In Esplora progetti, fare clic con il pulsante destro del mouse sul file richiesto e, nel menu discelta rapida, fare clic su Sostituisci con, quindi fare clic su Cronologia locale.

b. Nella finestra di dialogo Confronta, fare doppio clic su una revisione per rivedere e selezionarela versione richiesta. Fare clic su Sostituisci per utilizzare la versione selezionata.

Ripristinare dalla cronologia localeIl recupero di un file di progetto che è stato eliminato nella vista Esplora progetti.

Per ripristinare un file di progetto:

1. Nella vista Esplora progetti, fare clic con il pulsante destro del mouse sul progetto o una cartellacontenuta e nel menu di scelta rapida, fare clic su Ripristina da cronologia locale.

2. In Ripristina da cronologia locale, selezionare i file da ripristinare:

1. Fare clic sulla casella di controllo accanto al nome del file di progetto per ripristinare l'ultimaversione di quel file.

2. Se un file selezionato dispone di una cronologia locale salvata, selezionare il nome del file escegliere la versione richiesta del file nel pannello Seleziona un'edizione di un file.

3. Fare clic su Ripristina per recuperare i file selezionati e chiudere la finestra di dialogo Ripristina dacronologia locale.

Guida dell’utente di WorkbenchVersione 4.1

46

Preferenze della Cronologia localePer impostazione predefinita, Workbench mantiene la cronologia locale per sette giorni, per ognisingolo file di progetto, con un massimo di cinquanta versioni per ciascun file. Vi è anche una memoriapredefinita di 1 MB, allocata per la cronologia locale di ciascun programma.

È possibile cambiare le suddette impostazioni come riportato di seguito:

1. Selezionare Finestra ➤ Preferenze… ➤ Generale ➤ Area di lavoro ➤ Cronologia locale.

Viene visualizzata la finestra di dialogo Cronologia locale.2. Impostare una delle seguenti opzioni se necessario:

• Giorni di mantenimento dei file - Il numero di giorni in cui si desidera mantenere i record perogni file di progetto. Per esempio, se si digita 20, viene mantenuta una cronologia di versionisalvate dagli ultimi venti giorni. Il valore predefinito è di 7 giorni.

• Numero massimo di voci per file - Il numero di versioni che si desidera mantenere per ogni filedi progetto. Se si supera questo numero, le modifiche meno recenti vengono ignorate in modo dalasciare lo spazio per le nuove modifiche. L'impostazione predefinita è di 50 versioni per file.

• Dimensione massima file (MB) - La dimensioni massima del file (in MB) per la cronologia localedi un file di progetto. Se si supera, non viene mantenuta più nessuna cronologia locale per il file.La dimensione predefinita è di 1 MB.

Nota:I Giorni di mantenimento dei file e il Numero massimo di voci per file si applicano solo se lacronologia locale si compatta all'arresto del server.

Passaggio ad una diversa area di lavoroCome passare ad una diversa area di lavoro, in modo da poter utilizzare un diverso gruppo di progetti:

1. Fare clic sul menu File, fare clic su Cambia area di lavoro e fare clic su Altro.2. In Avvio area di lavoro, selezionare l'Area di lavoro richiesta o espandere l'elenco Recenti aree

di lavoro e selezionare l'area di lavoro richiesta se viene visualizzata nell'elenco.3. Fare clic su OK per riavviare Workbench visualizzando l'area di lavoro selezionata.

Guida dell’utente di WorkbenchVersione 4.1

47

Esplora fileLa vista Esplora file viene utilizzata per modificare e gestire programmi in linguaggio SAS e file,programmi o set di dati correlati nel file system.

È possibile utilizzare la vista Esplora file per gestire programmi in linguaggio SAS e file associati neifile system remoti e locali. Poiché la vista Esplora file non gestisce il contenuto tramite i progetti, nonè possibile utilizzare la cronologia locale, non utilizzare la funzionalità di Workbench di importare oesportare progetti o archivi.

La vista Esplora file consente l'accesso a tutti i file che sono disponibili nel file system locale e suglihost remoti connessi. La vista visualizza anche i seguenti tipi di oggetto:

• Connessioni: il nodo radice che rappresenta una connessione ad un computer host. Può esserelocale o remoto.

• Collegamenti: una directory su un file system selezionato per la gestione tramite la vista Esplorafile.

• File di collegamento simbolico: un file che punta ad un altro file nel file system host tramite uncollegamento simbolico.

• Directory di collegamento simbolico: una directory che punta ad un'altra directory nel file systemhost tramite un collegamento simbolico.

La selezione di un elemento (diverso da una connessione) in Esplora file visualizza le informazioni suquell'elemento nella vista Proprietà.

Visualizzazione della vistaPer visualizzare la vista Esplora file:

Dal menu Finestra, fare clic su Mostra vista, quindi fare clic su Esplora file.

Connessioni e collegamentiÈ possibile solo visualizzare i file su sistemi remoti quando si dispone di una connessione host aperta.La connessione host viene aperta dalla vista Esplora collegamenti oppure quando si avviano i serverWPS nella vista Esplora server WPS.

Ogni connessione host può presentare diversi collegamenti a directory, ciascuno che fornisce l'accessoa file e cartelle nel file system associato.

Per creare un nuovo collegamento alla directory in Esplora file, fare clic con il pulsante destro delmouse sulla cartella richiesta, selezionare Nuovo e fare clic su Collegamento directory nel menu discelta rapida, quindi immettere un Nome directory nella finestra di dialogo Collegamento directory.

Uso di file e cartelleÈ possibile eseguire le seguenti operazioni su file e cartelle in Esplora file:

Guida dell’utente di WorkbenchVersione 4.1

48

• creare un nuovo collegamento a directory, directory o file.• I file e le directory selezionate da spostare, copiare o eliminare.• Eseguire un programma su un server WPS selezionato.• Rinominare un file o directory selezionata.• Analizzare il contenuto di programmi e cartelle contenenti i programmi (consultare Analizzatore di

codice (pag. 12) per maggiori informazioni).

Preferenze di Esplora filePer visualizzare i file e le cartelle nascoste nella vista Esplora file, nella finestra di dialogo Preferenze,espandere il gruppo di WPS, selezionare Esplora file e nel pannello Esplora file, selezionare Mostrafile e cartelle nascosti.

Gestione dei file in Esplora fileÈ possibile utilizzare la vista Esplora file per manipolare i vari oggetti nei file system locali e remotidisponibili.

Quando si aprono i file dalla vista Esplora file, il file viene visualizzato nella vista Editor piùappropriato:

• I file di programma (quelli con le estensioni di file .wps e .sas) si aprono nell'editor SAS.• I file di testo (.txt) si aprono nell'Editor di testo.• I file XML (.xml) si aprono nell'Editor di testo.• I file HTML (.html) si aprono in Workbench laddove è possibile (questa dipende dalla piattaforma).

In alcuni sistemi operativi, Workbench tenta di aprire l'applicazione associata al file, per esempio i filePDF, anche se il file non si può aprire nello stesso Workbench.

Creare una nuova cartella in un file systemÈ possibile creare le cartelle ogni volta che si dispone di adeguati privilegi nel sistema operativo per lospecifico host locale o remoto.

1. Fare clic su sul menu Finestra, fare clic su Mostra vista, quindi fare clic su Esplora file pervisualizzare la vista Esplora file.

2. Nella vista Esplora file, fare clic con il pulsante destro del mouse su Collegamento directory oCartella, fare clic su Nuovo e fare clic su Cartella nel menu di scelta rapida.

3. Immettere un nuovo Nome cartella e fare clic su Fine.

Guida dell’utente di WorkbenchVersione 4.1

49

Creare un nuovo file o programma in un file systemPer creare un nuovo file in un file system preesistente, procedere nel modo seguente:

1. Nella vista Esplora file, fare clic con il pulsante destro del mouse su Collegamento directory oCartella, fare clic su Nuovo, quindi fare clic su File nel menu di scelta rapida.

Se si sta creando un nuovo programma in linguaggio SAS, fare clic su Nuovo, quindi fare clic suProgramma nel menu di scelta rapida.

2. Nella finestra di dialogo, immettere un Nome file, inclusa l'estensione del file, e fare clic su Fine.

Se si sta creando un nuovo programma in linguaggio SAS, Filename ha un'estensione predefinita di.sas che è possibile cambiare con .wps se si preferisce.

Spostamento di un file in un file systemÈ possibile spostare i file ad altre cartelle nelle connessioni locali e remote. Per spostare gli oggettinella vista Esplora file:

1. Fare clic su sul menu Finestra, fare clic su Mostra vista, quindi fare clic su Esplora file pervisualizzare la vista.

2. Nella vista Esplora file, fare clic con il pulsante destro del mouse sull'oggetto richiesto da spostaree fare clic su Taglia nel menu di scelta rapida.

3. Fare clic con il pulsante destro del mouse su Directory collegamento o Cartella di destinazione, allaquale si desidera spostare l'oggetto e Fare clic su Incolla nel menu di scelta rapida.

In alternativa, è possibile selezionare l'oggetto che si desidera spostare e trascinare l'oggetto nellaDirectory collegamento o Cartella di destinazione.

Ridenominazione di un oggetto in un file systemPer rinominare un oggetto di file system:

1. Nella vista Esplora file, fare clic con il pulsante destro del mouse sull'oggetto richiesto darinominare e fare clic su Rinomina nel menu di scelta rapida.

2. In Rinomina file, immettere un nuovo nome per il file e fare clic su OK.

Potrebbe essere necessario aggiornare la connessione nella vista Esplora collegamenti pervisualizzare la modifica.

Guida dell’utente di WorkbenchVersione 4.1

50

Eliminazione di un oggetto da un file systemPer eliminare un oggetto da un file system, procedere nel modo seguente:

1. Nella vista Esplora file, fare clic con il pulsante destro del mouse sull'oggetto richiesto da eliminaree fare clic su Elimina nel menu di scelta rapida.

2. Nella finestra di dialogo Conferma eliminazione, fare clic su OK per confermare l'eliminazione.

Una volta confermata l'eliminazione dell'oggetto dal file system, non è possibile annullarel'operazione.

Esplora collegamentiLa vista Esplora collegamenti consente di gestire le connessioni host e i server WPS in taliconnessioni.

La vista Esplora collegamenti è la vista principale se si utilizza WPS Link, il termine collettivo per latecnologia utilizzata per fornire un'architettura client/server.

Utilizzando Workbench nel PC locale, è possibile connettersi ad un computer remoto su cui il serverWPS viene installato per eseguire i programmi in linguaggio SAS. È possibile visualizzare e manipolarel'output dal server remoto in Workbench, allo stesso modo di un programma eseguito localmente.

Visualizzazione della vistaPer visualizzare la vista Esplora collegamenti

Dal menu Finestra, fare clic su Mostra vista, quindi fare clic su Esplora file.

Oggetti visualizzatiEsistono due tipi di nodi visibili in questa vista:

1. Un Nodo della connessione – rappresenta una connessione ad un computer host. La connessionepuò essere una connessione locale o una connessione ad un computer remoto, e contenere uno opiù nodi server WPS.

2. Un Nodo server – rappresenta l'installazione del server WPS in cui è possibile eseguire programmiin linguaggio SAS.

Gestione di connessioni e serverDa questa vista, è possibile:

• Aprire o chiudere una connessione con un host locale o remoto.• Interrompere, avviare o riavviare un server WPS nella connessione

Guida dell’utente di WorkbenchVersione 4.1

51

• Esportare una connessione host (consultare Esportare una definizione della connessione host(pag. 55)).

• Definire un nuovo server WPS (consultare Definire un nuovo server WPS (pag. 56)).• Importare o esportare una definizione del server WPS (consultare Importare una definizione del

server WPS (pag. 57) o Esporta una definizione del server WPS (pag. 56)).

È possibile spostare o copiare un server WPS ad una diversa connessione host. Una operazionedi trascinare la selezione sposta il server dall'attuale connessione host alla connessione host didestinazione. Mantenere premuto il tasto CTRL allo stesso tempo in cui si copia il server WPS allanuova connessione host.

Comandi (nell'angolo superiore destro della vista)La vista contiene i seguenti comandi

• Comprimi tutto – comprime la vista per mostra solo i nodi radice.• Crea una nuova connessione host remoto – aggiunge una nuova connessione remota.• Importa una definizione connessione host – importa un file di definizione della connessione.

Proprietà della connessione con un host localeL'host locale viene creato durante l'installazione di Workbench e le uniche proprietà disponibili per unaconnessione con host locale sono i collegamenti a directory.

Per accedere alle proprietà della connessione con host locale, nella vista Esplora collegamenti, fareclic con il pulsante destro del mouse sulla connessione host Locale e selezionare Proprietà nel menudi scelta rapida.

Un collegamento alla directory è un collegamento ad una directory nel file system locale. I collegamentilocali che vengono creati per impostazione predefinita sono diversi in base al sistema operativo in cui siesegue Workbench:

• Nei sistemi operativi Microsoft Windows, vi saranno i collegamenti Pagina iniziale e Area di lavoro, eanche un collegamento per ogni unità locale disponibile. Per esempio, se si dispone di unità C:\ eD:\ nel computer, per impostazione predefinita, saranno presenti quattro collegamenti.

• In tutti gli altri sistemi operativi, vengono creati per impostazione predefinita solo i collegamentiHome (~/) e Root (/).

Creare un nuovo collegamentoPer creare un nuovo collegamento a directory:

1. Nella vista Esplora collegamenti, fare clic con il pulsante destro del mouse sulla connessione hostLocale e selezionare Proprietà nel menu di scelta rapida.

2. Fare clic su Aggiungi per visualizzare la finestra di dialogo Collegamento directory.

Guida dell’utente di WorkbenchVersione 4.1

52

3. In Nome directory, immettere il nome del collegamento visualizzato e in Percorso directory, ilpercorso completo della directory di destinazione. Fare clic su OK per salvare le modifiche.

Connettersi ad un server WPS remotoCome creare un collegamento da Workbench ad un server WPS in un computer remoto.

Il server WPS deve esistere prima che si possa realizzare una connessione da Workbench. Il serverremoto richiede un server SSH e una copia concessa in licenza del server WPS. Per informazioni sullaconfigurazione di un server remoto per WPS, consultare la Guida dell'utente e riferimento a WPS Link.

Riepilogo delle installazioni per client/serverPrima di connettersi ad un server remoto, si richiede il nome host per il server remoto, le credenziali diaccesso mediante nome utente e password, e il percorso completo di installazione del server WPS nelserver remoto.

Per creare una connessione ad un server remoto:

1. Creare una connessione all'host remoto. Consultare Creare una nuova connessione host remoto(pag. 52).

2. Aggiungere un server WPS a questo host remoto. Consultare Definire un nuovo server WPS(pag. 56).

Creare una nuova connessione host remotoPrima di creare una nuova connessione, sarà necessario

• l'accesso SSH al server che ha un'installazione del server WPS concessa in licenza.• Il percorso della directory di installazione per l'installazione del server WPS.

Potrebbe essere necessario rivolgersi all'amministratore per ottenere tali informazioni e per assicurarsidi avere l'accesso. Per maggiori dettagli sull'autenticazione SSH, consultare la Guida dell'utente eriferimento a WPS Link.

Per creare una nuova connessione host remoto:

1. Fare clic sul menu WPS, fare clic su Collegamento, quindi fare clic su Nuova connessione hostremoto.

2. Nella finestra di dialogo Nuova connessione server, scegliere una delle seguenti opzioni:

• Nuova connessione SSH (compatibilità con 3.1) se si richiede la compatibilità con le versioniprecedenti ad una versione 3.1 del server WPS.

• Nuova connessione SSH (3.2 e versioni successive -- UNIX, MacOS, Windows) per tutte lealtre connessioni.

Guida dell’utente di WorkbenchVersione 4.1

53

Nota:Se si seleziona Nuova connessione SSH (3.2 e versioni successive -- UNIX, MacOS, Windows)e successivamente si ripristina la versione 3.1 di WPS, si perderanno le connessioni con host remotiche sono state configurate nella versione 3.2 di WPS.

3. Fare clic su Avanti e completare la finestra di dialogo Nuova connessione host remoto (3.2 eversioni successive):

a. Per Nome host, immettere il nome o l'indirizzo IP del server remoto.b. Salvo modifiche da parte dell'amministratore di sistema, è necessario lasciare il valore predefinito

Port invariato (22).c. In Nome connessione, immettere un nome univoco da visualizzare in Workbench per questa

connessione.d. Per Nome utente, immettere l'ID utente nell'host remoto.

Fare clic sulla casella di controllo richiesta:

Opzione DescrizioneAbilita compressione Controlla se o meno i dati vengono inviati tra

Workbench e la connessione remota vienecompressa.

Verifica nome host Conferma se esiste l'host specificato nella voceNome host.

Apri la connessione ora Se la connessione viene apertaautomaticamente immediatamente

Apri la connessione automaticamenteall'avvio di Workbench

Controlla se la connessione viene apertaautomaticamente all'avvio di Workbench.

4. Fare clic su Avanti per definire i collegamenti alle directory della connessione:

1. Fare clic su Aggiungi per visualizzare la finestra di dialogo Collegamento directory.2. In Nome directory, immettere il nome del collegamento visualizzato e in Percorso directory, il

percorso completo della directory di destinazione. Fare clic su OK per salvare le modifiche.

Immettere il nome del collegamento visualizzato in Nome directory e il percorso completo inPercorso directory, quindi fare clic su OK.

5. Fare clic su Fine per salvare le modifiche.

Se l'autenticità dell'host remoto non è stata convalidata in precedenza, viene visualizzata unafinestra di dialogo Messaggio SSH2:

Guida dell’utente di WorkbenchVersione 4.1

54

Se si è sicuri che l'identità dell'host sia corretta, fare clic su Sì.6. Nella finestra di dialogo Password richiesta, immettere la password per il computer remoto e fare

clic su OK.

La vista Esplora collegamenti contiene una voce per la nuova connessione, con un server in cui èpossibile eseguire programmi in linguaggio SAS.

Opzioni di connessione avanzate

Controllo delle variabili di ambiente disponibili in un server WPS remoto.

Per impostazione predefinita, il processo server di WPS eredita l'ambiente shell interattivo per l'utentecon il cui ID è stato avviato il server. L'ambiente predefinito potrebbe non includere tutto ciò cherichiede il server WPS, per esempio le raccolte condivise del client del database potrebbero non esseredefinite per il server.

In sistemi Unix/Linux, ciò potrebbe richiedere che qualsiasi variabile di ambiente per il server WPSviene aggiunta a LD_LIBRARY_PATH; o /etc/profile o ~/.profile modificato in modo tale chele raccolte condivise dal client del database possano essere caricate dal server WPS.

Un'alternativa in UNIX/Linux è quella di collocare un file wpsenv.sh nella directory di installazione diWPS o nella propria home directory. Questo file viene eseguito automaticamente prima dell'avvio delserver.

In Windows, qualsiasi variabile di ambiente specifica per il server WPS deve essere configurata tramiteil Pannello di controllo, come variabile di ambiente di sistema o utente.

Guida dell’utente di WorkbenchVersione 4.1

55

Nota:Tutti i processi che vengono eseguiti in qualità di utente rileveranno le variabili create e non esiste alcunmodo di impostarli come solo visibili per il processo WPS.

Esportare una definizione della connessione host

È possibile esportare la definizione di una connessione host da Workbench per abilitare la condivisionein un gruppo di lavoro o per copiare le definizioni delle connessioni tra aree di lavoro.

Per esportare le definizioni delle connessioni host:

1. Nella vista Esplora collegamenti, selezionare la connessione per cui saranno esportate ledefinizioni.

2. Fare clic con il pulsante destro del mouse sulla connessione e fare clic su Esporta connessionehost nel menu di scelta rapida.

3. Nella finestra di dialogo Esporta in un file, passare al percorso di salvataggio, immettere un Nomefile e fare clic su Salva. Il file esportato .cdx contiene la definizione della connessione in formatoXML.

La definizione della connessione host viene salvata nel file selezionato che è possibile condividere nelgruppo di lavoro.

È possibile selezionare più connessioni nella vista Esplora collegamenti ed esportarli tutti nello stessofile di definizione per condividere più di una definizione della connessione.

Consultare Importare una definizione della connessione host (pag. 55) per come importare ledefinizioni delle connessioni in un'area di lavoro.

Importare una definizione della connessione host

È possibile importare la definizione della connessione host in Workbench per utilizzare le definizionihost coerenti in un gruppo di lavoro o tra le aree di lavoro.

Questa attività presuppone che siano state già esportate alcune definizioni della connessione in un fileo che sia stato fornito un file di esportazione creato da qualcun altro nel gruppo di lavoro.

1. Fare clic sul menu WPS, selezionare Collegamento, quindi fare clic su Importa definizioneconnessione host.

2. Nella finestra di dialogo Importa connessione con host remoto, selezionare il file di definizionedella connessione richiesta (.cdx) e fare clic su Apri.

La definizione della connessione host viene importata dal file selezionato.

Se si verificano conflitti nei nomi, la definizione della connessione importata viene automaticamenterinominata in modo da avere un nome univoco nell'elenco delle connessioni.

Guida dell’utente di WorkbenchVersione 4.1

56

Definire un nuovo server WPSWorkbench consente di avere più server WPS definiti in una connessione host locale o remota.

Per definire un nuovo server:

1. Nel menu WPS, fare clic su Collegamento, fare clic su Nuovo server WPS, quindi fare clic suLocale o il nome della connessione del server remoto.

2. Nella finestra di dialogo Nuovo server WPS, immettere un nome visualizzato univoco nel Nome delserver.

Se si definisce un nuovo server WPS remoto, immettere il percorso al file eseguibile WPS nel serverremoto nella Directory di installazione WPS base.

3. Fare clic su Avvia il server ora e Avvia il server automaticamente all'avvio della connessioneper assicurarsi che il server WPS si possa utilizzare ad ogni avvio di Workbench.

4. Fare clic su Fine per salvare le modifiche.

La vista Esplora collegamenti contiene una voce per il nuovo server WPS. Se necessario, è possibileconfigurare le opzioni di avvio per il nuovo server, consultare Proprietà del server WPS (pag. 58).

Esporta una definizione del server WPS

È possibile esportare la definizione di un server WPS da Workbench per abilitare la condivisione in ungruppo di lavoro o per copiare le definizioni delle connessioni tra aree di lavoro.

Per esportare una definizione del server WPS:

1. Nella vista Esplora collegamenti, selezionare la server per cui sarà esportata la definizione.2. Fare clic con il pulsante destro del mouse e selezionare Esporta definizione del server WPS nel

menu di scelta rapida.3. Nella finestra di dialogo Esporta in un file, passare al percorso di salvataggio, immettere un Nome

file e fare clic su Salva. Il file esportato .sdx contiene la definizione della connessione in formatoXML.

Le definizioni del server WPS verranno salvate nel file selezionato che è possibile condividere nelgruppo di lavoro.

È possibile selezionare più server nella vista Esplora collegamenti ed esportarli tutti nello stesso file didefinizione per condividere più di una definizione della connessione.

Consultare Importare una definizione del server WPS (pag. 57) per come importare le definizionidel server in un'area di lavoro.

Guida dell’utente di WorkbenchVersione 4.1

57

Importare una definizione del server WPS

È possibile importare una definizione del server WPS in Workbench per utilizzare le definizioni coerentiin un gruppo di lavoro o tra aree di lavoro.

È possibile solo importare una definizione del server WPS in una connessione host. Se è necessariocreare una definizione dell'host, consultare Creare una nuova connessione host remoto (pag. 52).

Per importare una definizione del server WPS

1. Fare clic sul menu WPS, selezionare Collegamento, quindi fare clic su Importa definizione serverWPS. Avviare la finestra di dialogo Importa dal file scegliendo una delle opzioni seguenti:

2. Nella finestra di dialogo Importa dal file, selezionare il file di definizione del server richiesto (.sdx)e fare clic su Apri.

Le definizioni del server WPS vengono importate dal file selezionato.

Se si verificano conflitti nei nomi, la definizione del server importato viene automaticamente rinominatain modo da avere un nome univoco nell'elenco dei server WPS.

Esplora server WPSLa vista Esplora server WPS viene utilizzata per visualizzare tutti i Fileref, raccolte, cataloghi e set didati generati dall'esecuzione di un programma in linguaggio SAS in un server WPS.

Mentre il server WPS è in esecuzione, si archiviano i Fileref e il contenuto delle raccolte generate daprecedenti programmi in linguaggio SAS. Per rimuovere tali elementi, è necessario riavviare il server.

Visualizzazione della vistaPer mostrare la vista Esplora server WPS

Dal menu Finestra, fare clic su Mostra vista, quindi fare clic su Esplora server WPS.

Oggetti visualizzatiLa vista contiene un nodo server WPS che rappresenta il server WPS in cui è stato eseguito ilprogramma in linguaggio SAS. Sotto questo nodo:

• Raccolte – un nodo padre per i singoli elementi delle raccolte.

Il nodo delle raccolte contiene un nodo raccolta denominato Work. Rappresenta la raccoltatemporanea predefinita, utilizzata se non è stata specificata una in un programma.

• Raccolta – una raccolta di cataloghi e set di dati.

Guida dell’utente di WorkbenchVersione 4.1

58

Se si utilizza un'istruzione LIBNAME in un programma in linguaggio SAS per specificare il nomedella propria raccolta, verrà visualizzato un nodo della raccolta con il nome specificato ancheelencato nella vista.

• Catalogo – una raccolta di elementi definiti dall'utente, quali formati e informati.• Set di dati – un file di dati contenente campi numerici e/o di caratteri.• Vista Set di dati – un set di dati creato richiamando una vista nei dati di origine.• Campo numerico Set di dati – un campo di set di dati che contiene valori numerici.• Campo di caratteri Set di dati – un campo di set di dati che contiene valori di caratteri.• Fileref – Il nodo padre per gli elementi del fileref.• Fileref – un singolo riferimento ad un file.

I Fileref vengono normalmente generati automaticamente, ma è possibile creare un Fileref tramitel'istruzione FILENAME, ad esempio

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

Il collegamento tra un Fileref e il relativo file esterno associato dura per la durata della sessioneWPS attuale oppure finché lo si cambia o sospende. Per mantenere un Fileref da una sessioneall'altra, salvare l'istruzione FILENAME nel/i programma/i pertinente/i.

Se si seleziona un elemento nella vista Esplora server WPS, le informazioni su quell'elementovengono visualizzate nella vista Proprietà .

Proprietà del server WPSLe seguenti proprietà e informazioni sono disponibili per un server WPS:

Invio del codiceImposta la directory di lavoro del server sulla directory da cui si apre il programma.

AmbienteUn elenco di sola lettura che descrive l'ambiente del server (directory di lavoro, ID processo evariabili di ambiente). Tali informazioni sono solo disponibili quando il server è in esecuzione.

Variabili della macroUn elenco delle variabili della macro automatiche e globali utilizzate dal server e i valori ad esseassociati. Tali informazioni sono solo disponibili quando il server è in esecuzione. Non è possibilemodificare variabili preesistenti, ma è possibile creare nuove variabili.

Guida dell’utente di WorkbenchVersione 4.1

59

AvvioLa pagina principale ha un'opzione denominata Avvia il server automaticamente all'avviodella connessione. Assicurarsi che sia selezionata in modo da avviare automaticamenteil server ad ogni avvio della connessione associata. L'opzione Directory corrente inizialeper processo server specifica la directory di lavoro per il server, determinando dove vienegenerato l'output. Se sono presenti nel programma istruzioni %INCLUDE, con i percorsi relativi,è importante avviare il server nella directory corretta in modo da consentire alle istruzioni%INCLUDE di trovare i file.

La pagina Avvio contiene:

Opzioni di sistemaConsente di specificare le opzioni di WPS che il server elaborarerà all'avvio. Fareclic su Aggiungi... per specificare il nome e il valore dell'opzione. È possibile quindiutilizzare Modifica... e Rimuovi per modificare ed eliminare le opzioni e i valori creati inprecedenza.

Variabili di ambiente

Solo per un server WPS locale

Utilizzato per specificare le variabili di ambiente da impostare prima dell'avvio del server.Fare clic su Nuovo... per specificare il nome e il valore della variabile. È possibile utilizzareModifica... e Rimuovi per modificare ed eliminare le variabili di ambiente create inprecedenza.

Opzioni di sistemaQuando il server WPS è in esecuzione, fornisce un elenco di sola lettura di opzioni di sistemae i relativi valori attualmente impostati nel server. Sono le stesse informazioni di quelle fornitetramite la procedura OPTIONS.

Informazioni sulla licenza di WPSVisualizza le informazioni della licenza per il server. Le informazioni non si possono modificare esono solo disponibili quando il server è in esecuzione.

Informazioni sul software WPSVisualizza le informazioni dettagliate sul software WPS. Le informazioni non si possonomodificare e sono solo disponibili quando il server è in esecuzione.

ProprietàLa vista Proprietà mostra le proprietà di un oggetto selezionato.

Selezionare un oggetto in una delle seguenti viste per mostrare i dettagli sull'oggetto nella vistaProprietà:

• Vista Esplora file• Vista Esplora collegamenti

Guida dell’utente di WorkbenchVersione 4.1

60

• Vista Esplora progetti• Vista Cerca• Vista Esplora server WPS

Visualizzazione della vistaPer mostrare la vista Proprietà

Dal menu Finestra, fare clic su Mostra vista, quindi fare clic su Proprietà.

EditorQuando si apre un qualsiasi tipo di file in Workbench, viene aperto come una scheda nella vista Editor.

La vista Editor è la vista interattiva principale quando si creano o modificano i programmi in linguaggioSAS. La vista viene anche utilizzata per visualizzare l'output come i set di dati dei risultati o leinformazioni di registro.

È possibile modificare i set di dati aperti dalla vista Esplora server WPS e file aperti dalla vista Esploraprogetti o la vista Esplora file. È possibile visualizzare, ma non editare, i registri e i file di output.

È possibile suddividere la vista Editor per visualizzare o modificare due o più file insieme. Persuddividere la vista, dal menu Finestra, fare clic su Editor, quindi fare clic su Attiva/disattiva editorsuddiviso (Verticale). È possibile anche suddividere l'editor in orizzontale tramite Attiva/disattivaeditor suddiviso (Orizzontale) ed è possibile aprire un'altra copia del file corrente tramite l'opzioneClone (Clona).

SegnalibriLa vista Segnalibri elenca i segnalibri aggiunti a qualsiasi programma o file in un progetto.

È possibile aggiungere segnalibri su qualsiasi riga in qualsiasi programma o file che si può aprire dallavista Esplora progetti e modificare con la vista Editor.

La vista Segnalibri elenca i segnalibri per tutti i programmi in tutti i progetti aperti. Non è possibilecreare segnalibri per programmi non gestiti tramite la vista Progetto.

Per aprire un file in corrispondenza del segnalibro, fare doppio clic sul segnalibro nella vista Segnalibri.Il file viene aperto nella vista Editor, con la riga con segnalibro evidenziata oppure la prima riga del filese l'intero file è stato contrassegnato con segnalibri.

Visualizzazione della vistaPer visualizzare la vista Segnalibri:

Guida dell’utente di WorkbenchVersione 4.1

61

Dal menu Finestra, fare clic su Mostra vista, quindi fare clic su Segnalibri.

Ancoraggi segnalibriUn segnalibro è un ancoraggio che è possibile specificare per navigare di nuovo rapidamente a quelpunto, in qualsiasi momento.

Non vi è alcun limite al numero di segnalibri che è possibile creare contro una riga specifica nelprogramma o un file di programma nella sua totalità.

È possibile elencare ed esplorare tutti i segnalibri tramite la vista Segnalibri. Se si esporta un progettocontenente i segnalibri, non vengono esportati insieme anche i singoli segnalibri.

Aggiungere un segnalibroPer aggiungere un nuovo segnalibro ad una riga specifica in un programma:

1. Aprire il programma o file nella vista Editor.2. Fare clic con il pulsante destro del mouse nel bordo grigio a sinistra della riga richiesta e fare clic su

Aggiungi segnalibro nel menu di scelta rapida:3. Immettere un nome del segnalibro nella finestra di dialogo Aggiungi segnalibro e fare clic su OK.

Nel bordo viene visualizzato un contrassegno del segnalibro ( ) e viene aggiunta una vocecorrispondente nella vista Segnalibri.

È possibile anche aggiungere un segnalibro ad un file intero: selezionare il file nella vista Esploraprogetti, fare clic su Modifica, quindi fare clic su Aggiungi segnalibro.

Eliminare un segnalibroPer eliminare un segnalibro:

1. Fare clic sul menu Finestra, fare clic su Mostra vista, quindi fare clic su Segnalibri.2. Nella vista Segnalibri, fare clic con il pulsante destro del mouse sulla descrizione del segnalibro e

fare clic su Elimina nel menu di scelta rapida.

Guida dell’utente di WorkbenchVersione 4.1

62

AttivitàLa vista Attività elenca le attività aggiunte a qualsiasi programma o file in un progetto.

È possibile aggiungere attività su qualsiasi riga in qualsiasi programma o file che si può aprire dallavista Esplora progetti e modificare con la vista Editor.

La vista Attività elenca le attività associate a tutti i programmi in tutti i progetti aperti. Non è possibilecreare le attività per programmi non gestiti tramite la vista Progetto.

È possibile utilizzare la vista Attività per cambiare i livelli di priorità, modificare le descrizioni econtrassegnarle come completate o lasciarle incomplete.

È possibile aggiungere Indicatori di attività (pag. 62) (promemoria) ad ogni riga in un programmache è stato aperto da Esplora progetti (pag. 37) e associare ciascuno di essi con note e un livellodi priorità. Per elencare, aggiornare ed esplorare le attività aggiunte, è necessario utilizzare la vista Attività.

Per aprire un file associato ad un'attività, fare doppio clic sull'attività nella vista Attività. Il file vieneaperto nella vista Editor, evidenziando la riga pertinente.

Visualizzazione della vistaPer mostrare la vista Proprietà:

Dal menu Finestra, fare clic su Mostra vista, quindi fare clic su Attività.

Indicatori di attivitàUn indicatore di attività rappresenta un promemoria su un elemento di lavoro.

È possibile solo aggiungere gli indicatori di attività ai programmi in un progetto. È possibile aggiungereun'attività e associare una breve descrizione e un livello di priorità (fra Alta, Normale o Bassa) controqualsiasi riga in un programma. È possibile elencare ed esplorare tutte le attività nella vista Attività.

Non vi è alcun limite al numero di indicatori di attività che è possibile aggiungere ad un programma.Tuttavia, se si esporta un progetto, insieme ad esso, non vengono esportate le singole attività.

Aggiungere un'attivitàPer aggiungere un nuovo indicatore di attività su una riga specifica in un programma:

1. Aprire il programma o file nella vista Editor.2. Fare clic con il pulsante destro del mouse nel bordo grigio a sinistra della riga richiesta e fare clic su

Aggiungi attività nel menu di scelta rapida.

Guida dell’utente di WorkbenchVersione 4.1

63

3. Nella finestra di dialogo Proprietà, immettere una Descrizione e selezionare la Priorità perl'attività.

4. Fare clic su OK per salvare l'attività.

Nel bordo viene visualizzato un indicatore di attività ( ) e una voce corrispondente nella vista Attività.

Eliminare un'attivitàPer eliminare un'attività:

1. Fare clic sul menu Finestra, selezionare Mostra vista, quindi fare clic su Segnalibri.2. Fare clic con il pulsante destro del mouse sulla descrizione dell'attività e selezionare Elimina nel

menu di scelta rapida.

StrutturaLa vista Struttura visualizza gli elementi strutturali per un file che è possibile utilizzare per individuarela riga associata all'elemento.

L'apertura o lo spostamento dello stato attivo ad un programma, registro, elenco o file HTML deirisultati, aggiorna automaticamente la vista Struttura in modo da mostrare gli elementi strutturalipertinenti all'elemento attivo.

Visualizzazione della vistaPer mostrare la vista Struttura:

Dal menu Finestra, fare clic su Mostra vista, quindi fare clic su Struttura.

Elementi strutturali visualizzatiLa visualizzazione dei programmi mostra i seguenti elementi strutturali nella vista Struttura:

• Istruzione globale

• DATA step

• Procedura

• Macro

La visualizzazione del file di registro mostra i seguenti elementi strutturali nella vista Struttura:

• Una singola voce di registro.

• Errore

• Avvertenza

Guida dell’utente di WorkbenchVersione 4.1

64

La visualizzazione dei risultati di output dall'esecuzione del programma mostra i seguenti elementistrutturali nella vista Struttura:

• Nodo padre Risultati

• Output tabellare HTML

• Elenco tabellare

Si può controllare quali elementi strutturali vengono visualizzati nella vista Struttura utilizzando la barradegli strumenti nella parte superiore del pannello di visualizzazione.

Esplora outputLa vista Esplora output mostra i file di output generati dall'esecuzione di un programma in linguaggioSAS.

Gli elementi di output sono associati al server su cui sono stati generati e può essere uno dei seguentitipi:

• Elenco• Output HTML• Output PDF

L'output del registro viene sempre visualizzato per ciascun server.

Visualizzazione della vistaPer mostrare la vista Esplora collegamenti:

Dal menu Finestra, fare clic su Mostra vista, quindi fare clic su Esplora output.

Visualizzare l'outputFare doppio clic su uno dei nodi di output per aprire il tipo di output nell'editor associato. Per i tipi dioutput diversi dall'output del registro, vengono elencati i singoli elementi dei risultati nella vista Esplorarisultati all'apertura dell'output.

Esplora risultatiLa vista Esplora risultati mostra i risultati da ogni programma in linguaggio SAS che è stato eseguito.

La vista contiene collegamenti gerarchici ai risultati, raggruppati per server, dall'ultima volta in cui èstato avviato il server.

Guida dell’utente di WorkbenchVersione 4.1

65

Visualizzazione della vistaPer mostrare la vista Esplora risultati:

Dal menu Finestra, fare clic su Mostra vista, quindi fare clic su Esplora risultati.

OutputUna volta eseguito un programma, viene visualizzata una voce sotto il server pertinente, per ogniprocedura che ha creato l'output. Per esempio PROC PRINT produrrà una voce denominata Laprocedura PRINT. Espandere questo collegamento per trovare ogni tipo di output che è stato generato.

ConsoleLa vista Console visualizza tutto l'output standard del sistema e i messaggi di errore standard delsistema prodotti da un server WPS.

La vista Console viene aperta automaticamente quando viene segnalato un errore di sistema.

Visualizzazione della vistaPer visualizzare la vista Console:

Dal menu Finestra, fare clic su Mostra vista, quindi fare clic su Console.

RicercaLa vista Cerca visualizza i risultati di ricerche realizzate utilizzando la finestra di dialogo Cerca.

Quando si seleziona un elemento nella vista Risultati, il file viene aperto nella vista Editor,evidenziando la riga pertinente.

Per aprire la finestra di dialogo Cerca, fare clic sul menu Cerca, quindi fare clic su Cerca. La vistaCerca si apre automaticamente per visualizzare i risultati.

Uso di visteQuesta sezione descrive come manipolare le viste di Workbench sia individualmente che come parte dipile di viste (pag. 66) complessive.

Guida dell’utente di WorkbenchVersione 4.1

66

Pile di visteUna pila di viste è una finestra formata da una raccolta di viste tutte allocate nella stessa area di unaprospettiva.

È possibile spostare, ridurre a icona e ingrandire le viste utilizzando una pila di viste. Quando una vistaviene riaperta, si apre nella pila di viste a cui era collegata.

Per esempio, la pila di viste di seguito contiene due viste:

Ridimensionamento di una vistaPer ridimensionare una vista, è necessario ridimensionare la pila di viste associata ad essa, che a suavolta ridimensionerà tutte le viste al suo interno.

1. Spostare il mouse sul bordo tra la pila di viste o finestra specifica, e la pila di viste o finestraadiacente (se si trova sul lato, sopra o sotto), finché il cursore cambia l'icona di ridimensionamento

o .

2. Premere il pulsante sinistro del mouse e mantenerlo premuto mentre si trascina il bordo da un latoall'altro oppure verso l'alto e il basso.

3. Rilasciare il pulsante del mouse per completare l'operazione di ridimensionamento.

Riduzione a icona di una vistaPer ridurre a icona una vista, è necessario ridurre a icona la pila di viste associata ad essa. Le visteridotte a icona vengono rappresentate da icone a sinistra o destra di Workbench, in modo che siapossibile ripristinarle:

Guida dell’utente di WorkbenchVersione 4.1

67

Per ridurre a icona una pila di viste o finestra, fare clic sul pulsante Riduci a icona sulla pila di viste ofinestra.

Ingrandimento di una vistaPer ingrandire una vista, è necessario ingrandire la pila di viste associata ad essa, che a sua voltariempie l'interfaccia Workbench.

L'ingrandimento di una vista causa l'occupazione di tutto lo spazio disponibile nella finestra diWorkbench. Tutte le altre pile di viste vengono ridotte ai bordi della finestra di Workbench, dovevengono rappresentate come icone.

Per ingrandire a icona una pila di viste o finestra, fare clic sul pulsante Ingrandisci sulla pila di viste ofinestra.

Ripristino di una vistaPer ripristinare una vista al suo stato 'normale' dopo averla ridotta a icona o ingrandita, è necessarioripristinare la pila di viste associate.

Per ripristinare una pila di viste o finestra che è stata ingrandita, fare clic sul pulsante Ripristina nellapila di viste o finestra.

Per ripristinare una pila di viste o finestra ridotta ad icona, fare clic sul pulsante Ripristina sopra la piladi viste ridotta a icona per ripristinare tutte le viste in quella pila.

Aprire una vistaPer aprire una vista:

1. Fare clic sul menu Finestra, selezionare Mostra vista, quindi fare clic su Altro.

Guida dell’utente di WorkbenchVersione 4.1

68

2. Nella finestra di dialogo Mostra vista, immettere il nome della vista o selezionare la vista richiestadall'elenco di viste. Fare clic su OK per visualizzare la vista.

La vista viene aperta nella pila di viste a cui è stata collegata l'ultima volta. Se la vista richiesta è giàaperta, diventerà attiva in Workbench.

Scollegare e ricollegare una vistaÈ possibile spostare una vista tra le pile di viste in Workbench o in una nuova finestra scollegata.

Per scollegare una vista:

Fare clic sulla scheda della vista o della barra del titolo, e trascinare la vista ad una pila di viste diversa.In alternativa, trascinare la vista lontano dalla finestra Workbench per creare una nuova pila di viste. Sesi chiude una pila di viste scollegata, resterà ancora scollegata alla prossima apertura.

Per collegare una vista ad una pila di viste:

Fare clic sulla scheda della vista o della barra del titolo, e trascinare la vista su una pila di visterichiesta. Utilizzare le guide per posizionare la vista nella pila di viste.

ProspettiveLe posizioni di viste, finestre, pile di viste, elementi del menu e le barre degli strumenti disponibili,unitamente ad ogni altro elemento che compone il layout generale di Workbench, costituiscono insiemeuna prospettiva.

È possibile personalizzare la prospettiva di WPS predefinita (pag. 18) spostando, ridimensionando,aggiungendo o rimuovendo le diverse viste. È possibile salvare le prospettive personalizzate e alternarele diverse prospettive di Workbench.

Quando si apre Workbench, le viste delle finestre, le barre degli strumenti e così via, vengonovisualizzate nella stessa disposizione di quando sono chiuse. Questo garantisce che la prospettivapreferita è visibile quando si apre Workbench.

Aprire una prospettivaPer aprire una diversa prospettiva:

1. Fare clic sul menu Finestra, fare clic su Apri prospettiva, quindi fare clic su Altro.2. Nella finestra di dialogo Apri prospettiva, selezionare la prospettiva richiesta dall'elenco e fare clic

su OK.

Guida dell’utente di WorkbenchVersione 4.1

69

La prospettiva selezionata viene visualizzata in Workbench. Se sono disponibili altre prospettive,vengono elencate nella parte superiore destra di Workbench, in modo a poterle scambiarerapidamente.

Chiudere una prospettivaIl modo più rapido per chiudere una perspettiva è quella di andare all'area a destra dell'icona Apriprospettiva , fare clic con il pulsante destro del mouse sulla prospettiva richiesta, quindi selezionareChiudi. In alternativa:

1. Se è aperta più di una prospettiva, assicurarsi che Workbench visualizzi quello che si desiderachiudere.

Nota:Per cambiare prospettiva, andare all'area a destra dell'icona Apri prospettiva , quindi fare clicsulla prospettiva richiesta.

2. Selezionare Finestra ➤ Chiudi prospettiva.

Nota:Per chiudere tutte le prospettive, in modo che solo la Prospettiva di WPS predefinita(pag. 18) rimanga disponibile per la selezione, selezionare Finestra ➤ Chiudi tutte leprospettive. L'interfaccia si svuoterà. Per ripristinare la prospettiva predefinita, selezionareFinestra ➤ Prospettiva ➤ Apri prospettiva ➤ Altro ➤  ➤ WPS (impostazione predefinita).

Reimpostazione di una prospettivaÈ possibile ripristinare la prospettiva corrente al suo layout predefinito in qualunque momento,procedendo come riportato di seguito:

1. Selezionare Finestra ➤ Prospettiva ➤ Reimposta prospettiva.

2. Viene richiesta una conferma che si desidera reimpostare la prospettiva. Fare clic su Sì perconfermare che si desidera procedere.

Salvataggio di una prospettivaSe è stato cambiato il layout di una prospettiva, è possibile salvarlo sotto un nome definito dall'utenteper utilizzarlo in futuro, come riportato di seguito:

1. Selezionare Finestra ➤ Salva prospettiva con nome….

Guida dell’utente di WorkbenchVersione 4.1

70

2. Immettere un nome per la prospettiva nella parte superiore della finestra di dialogo Salvaprospettiva con nome....

3. Fare clic su OK per continuare.

La nuova prospettiva viene visualizzata nella parte superiore destra di Workbench, a destra dell'iconaApri prospettiva .

Nota:Una prospettiva ricava la sua icona da quella aperta quando è stata salvata.

Eliminazione di una prospettivaPer eliminare una prospettiva:

1. Selezionare Finestra ➤ Preferenze.

2. Dalla visualizzazione struttura ad albero sinistra della finestra Preferenze, selezionareGenerale ➤ Prospettive.

3. Dall'elenco di Prospettive disponibili, fare clic sulla prospettiva che si desidera eliminare.4. Fare clic su Elimina per rimuovere la prospettiva in modo permanente. Non c'è un prompt di

conferma.

Nota:È possibile solo eliminare le prospettive definite dall'utente. In altre parole, non è possibile eliminareuna prospettiva fornita con WPS, inclusa la prospettiva di WPS predefinita.

5. Fare clic su OK per chiudere la finestra Preferenze.

Guida dell’utente di WorkbenchVersione 4.1

71

Creare un nuovo programmaÈ possibile creare un nuovo programma in Esplora progetti o Esplora file.

Per creare un file di programma vuoto in Workbench:

1. Fare clic sul menu File, fare clic su Nuovo, quindi fare clic su Programma senza titolo.2. Immettere l'esempio seguente per creare un set di dati semplice:

/* 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 ;

Workbench visualizza gli elementi del linguaggio nel programma tramite la codifica con colori pervisualizzare la struttura del codice, per esempio:

Guida dell’utente di WorkbenchVersione 4.1

72

3. Fare clic sul menu File, quindi fare clic su Salva con nome per salvare il programma. Utilizzare lafinestra di dialogo Salva con nome per selezionare la cartella padre e immettere un Nome file per ilprogramma.

4. Fare clic sul menu File, fare clic su Esegui programma, quindi fare clic su Server locale pereseguire il programma.

Il set di dati generato viene creato nella raccolta WORK del server locale, visualizzato nella vistaEsplora server WPS:

È possibile visualizzare le proprietà del set di dati oppure aprire e modificare il set di dati nella vistaEditor (consultare Modifica di un set di dati (pag. 99) per maggiori informazioni).

Guida dell’utente di WorkbenchVersione 4.1

73

Creazione di un nuovo file diprogramma in un progettoPer creare un nuovo file di programma:

1. Nel menu File, fare clic su Nuovo, quindi fare clic su Nuovo programma per avviare la proceduraguidata Nuovo programma.

2. Selezionare la cartella padre richiesta nella parte superiore della finestra di dialogo e immettereNome file.

3. Se si crea un nuovo programma in un progetto, è possibile creare un collegamento in un programmapreesistente nel file system:

a. Fare clic su Avanzate e selezionare Collega al file nel file system.b. Fare clic su Sfoglia e utilizzare la finestra Seleziona tipo di collegamento per trovare il file e

fare clic su Apri.4. Fare clic su Fine per completare l'attività.

Il nuovo programma viene aperto automaticamente nella vista Editor.

In alternativa, è possibile creare un programma senza titolo e salvarlo se necessario. Per creare unprogramma senza titolo, fare clic sul menu File, fare clic su Nuovo, quindi fare clic su Programmasenza titolo.

Immissione del codice in WPS tramitemodelliÈ possibile definire i modelli che si possono immettere come collegamenti di codici in programmi. Èpossibile accedere a tali modelli tramite la normale sequenza di tasti per il completamento del codice(in genere, CTRL + Spazio). Per esempio, se si definisce un modello di codice con il nome modello1,è possibile digitare temp seguito da CTRL + Spazio e la funzionalità di completamento del codiceeseguirà le seguenti azioni:

1. Farà corrispondere temp all'elenco dei modelli di codice.2. Troverà il modello denominato modello1.3. Immetterà il Criterio associato al modello nel programma.

Guida dell’utente di WorkbenchVersione 4.1

74

Il Criterio contenente il codice da immettere nel programma può essere il più semplice o complessoche si desidera. Può essere addirittura un'unica parola. Ad esempio, è possibile definire un modellodi codice per espandersi fino al nome di un set di dati utilizzato di frequente il cui nome è difficile dadigitare. Un modello di codice potrebbe anche definire una grande quantità di testo, per esempio,una invocazione boilerplate di una particolare procedura. Se si immette una variabile in un Criterio, ènecessario delimitarla tra coppie di caratteri '$$'.

È possibile esportare i modelli di codice in un file esterno o importarli da un file esportato inprecedenza. Ciò consente di condividere i modelli di codice oppure copiare i modelli di codice tra areedi lavoro.

Iniezione di codice WPSÈ possibile creare il codice in linguaggio SAS da eseguire prima o dopo il programma che usa lafunzionalità di iniezione di codice di Workbench. Il codice da eseguire viene immesso nel pannelloIniezione di codice della finestra Preferenze.

Abilita pre-iniezione di codice personalizzataQuando questa opzione è selezionata, il codice nella casella di testo viene eseguitoimmediatamente prima dell'esecuzione di un programma. Questa opzione è simile all'opzione disistema INITSTMT, tranne per il fatto che questo codice viene eseguito automaticamente primadi ciascun programma inviato (l'opzione di sistema INITSTMT viene solo elaborata all'avvio delserver).

Abilita post-iniezione di codice personalizzataQuando questa opzione è abilitata, il codice nella casella di testo viene eseguito immediatamentedopo dell'esecuzione di un programma. Questa opzione è simile all'opzione di sistemaTERMSTMT, tranne per il fatto che questo codice viene eseguito automaticamente dopo diciascun programma inviato (l'opzione di sistema TERMSTMT viene solo elaborata all'arresto delsistema).

Uso dell'Assistente ai contenuti delprogrammaL'editor in Linguaggio SAS fornisce una funzionalità di assistente ai contenuti che suggerisce glielementi del linguaggio. Quando si selezionano tali elementi, vengono automaticamente aggiunti alprogramma:

1. Digitare una parola chiave in un programma che può essere associata agli elementi del linguaggio.

Per esempio, digitare la parola PROC.2. Dopo la parola, digitare un carattere a spazio singolo e premere CTRL+BARRA SPAZIATRICE.

Guida dell’utente di WorkbenchVersione 4.1

75

Se esistono elementi del linguaggio previsti dopo la parola digitata, viene visualizzato un elencopopup di tali elementi.

3. È possibile filtrare l'elenco digitando la/e prima/e lettera/e dell'elemento del linguaggio che sidesidera utilizzare.

4. Fare doppio clic sull'elemento del linguaggio richiesto e verrà aggiunto al programma.

Colorazione della sintassi di WPSÈ possibile modificare la sintassi del linguaggio SAS delle preferenze di Workbench in modo da fornirela combinazione di colori preferita nell'editor del linguaggio SAS. Per modificare la colorazione dellasintassi:

1. Fare clic sul menu Finestra, quindi fare clic su Preferenze.2. Nella finestra Preferenze, espandere il gruppo WPS e selezionare Colorazione sintassi.3. Per ogni tipo diverso di elemento del linguaggio, specificare gli attributi relativi a Colore, Colore di

sfondo e se l'elemento deve essere visualizzato in Grassetto o Corsivo.4. Fare clic su OK per salvare le modifiche e chiudere la finestra Preferenze.

Guida dell’utente di WorkbenchVersione 4.1

76

Eseguire una programmaÈ possibile eseguire un programma dall'interno di Workbench o una riga di comando all'esterno diWorkbench.

Tutte le raccolte, i set di dati e le variabili delle macro sono persistenti. Ciò significa che, una voltaassegnate durante l'esecuzione di un programma, sono disponibili ad altri programmi che vengonoeseguiti durante la stessa sessione di Workbench.

Se richiesto, è possibile cancellare tutte le raccolte, i set di dati, le variabili e l'output precedenti in unserver WPS per la versione attuale, riavviando il server (Riavviare il server (pag. 36)). In alternativa,è possibile utilizzare le opzioni Cancella registro, Cancella risultati nel menu di WPS per reimpostarerispettivamente l'output del registro e dei programmi.

Per maggiori informazioni sul controllo dell'output (set di dati, registri, risultati e così via) generatodall'esecuzione di un programma, consultare Uso dell'output dei programmi (pag. 105).

Eseguire un programma in WorkbenchQuando si esegue un programma, si mantiene lo stato delle precedenti esecuzioni del programmaeseguite nello stesso server WPS, nella stessa sessione del server, quindi il programma può interagirecon i set di dati, fileref e così via, che sono stati creati in precedenza.

Per eseguire un programma in Workbench:

1. Assicurarsi che il programma da eseguire sia aperto e attivo nella vista Editor.2. Fare clic su WPS, fare clic su Esegui codice selezionato da <nomepercorso>, quindi fare clic su

Server locale (sostituire il nome del server WPS remoto al posto di Server locale). In alternativa,utilizzare la combinazione di tasti CTRL + R.

In alternativa, è possibile selezionare ed eseguire un programma in linguaggio SAS non aperto inEsplora progetti o Esplora file, e fare clic su Esegui su nel menu di scelta rapida.

Eseguire parte di un programmaÈ possibile eseguire parte di un programma in linguaggio SAS come riportato di seguito:

1. Assicurarsi che il programma pertinente sia aperto e attivo nella vista Editor.2. Evidenziare la sezione di codice nel programma che si desidera eseguire.

Guida dell’utente di WorkbenchVersione 4.1

77

3. Fare clic su WPS, fare clic su Esegui codice selezionato da <nomepercorso>, quindi fare clic suServer locale (sostituire il nome del server WPS remoto al posto di Server locale). In alternativa,utilizzare la combinazione di tasti CTRL + R.

Interrompere l'esecuzione del programmaPer interrompere il programma in linguaggio SAS prima del termine:

1. Fare clic sul menu di WPS, selezionare Annulla, quindi fare clic su Server locale (sostituire il nomedel server WPS remoto al posto di Server locale) per interrompere l'esecuzione del programma.

2. La scomparsa dell'indicatore di stato nell'angolo inferiore destro di Workbench indica che ilprogramma ha completato l'esecuzione.

A seconda del passaggio specifico in esecuzione nel programma, il programma potrebbe non arrestarsiimmediatamente.

Quando si arresta il programma, viene visualizzato un messaggio simile a ERRORE: Esecuzioneannullata nel registro.

Preferenze di WPS per l'esecuzione di programmiLe preferenze utilizzate per controllare il comportamento di Workbench durante l'esecuzione delprogramma.

La pagina WPS di Preferenze contiene le opzioni che influiscono sulla modalità di esecuzione diprogrammi in linguaggio SAS. Prima di eseguire i programmi, selezionare le impostazioni preferite dallapagina:

Salva tutti i file modificati prima di eseguire un programma

Specifica se i programmi modificati aperti nella vista Editor vengono salvati primadell'esecuzione di un programma. Il comportamento può essere uno dei seguenti: Sempre, Maio Chiedi conferma. Il valore predefinito, Chiedi conferma, visualizza la finestra di dialogo Salvaed esegui che visualizza i file modificati.

• Se si seleziona Salva sempre le risorse prima dell'esecuzione, tutti i file modificati siaprono nella vista Editor prima dell'esecuzione del programma.

• Se si seleziona Non salvare mai le risorse prima dell'esecuzione, nessuna modifica aifile aperti nella vista Editor viene salvata prima dell'esecuzione del programma. Si possonoverificare errori se il programma si affida ad altri file aperti in Workbench che sono statimodificati, ma non sono stati salvati.

Guida dell’utente di WorkbenchVersione 4.1

78

Chiudi tutti i set di dati aperti prima di eseguire un programma

Specifica se o meno aprire i set di dati aperti prima di eseguire un programma Il comportamentopuò essere uno dei seguenti: Sempre, Mai o Chiedi conferma. Il valore predefinito, Chiediconferma, visualizza la finestra di dialogo I set di dati sono aperti che visualizza tutti i filemodificati.

• Se si seleziona Chiudi sempre i set di dati prima dell'esecuzione, tutti i set di dati apertivengono chiusi prima dell'esecuzione del programma.

• Se si seleziona Non chiudere mai i set di dati prima dell'esecuzione, tutti i set di dativengono lasciati aperti all'esecuzione del programma. Ciò potrebbe causare errori se ilprogramma tenta di modificare un set di dati aperto

Mostra registro quando si verifica un errore durante l'esecuzione di un programma

Specifica se il file di registro viene visualizzato quando un errore viene riscontrato in unprogramma. Il comportamento può essere uno dei seguenti: Sempre, Mai o Chiedi conferma. Ilvalore predefinito, Chiedi conferma, visualizza la finestra di dialogo Conferma visualizzazioneregistro.

• Se si seleziona Memorizza impostazione, il file di registro viene sempre mostrato ogni voltache si riscontra un errore.

• Se si seleziona Memorizza impostazione, il file di registro viene sempre mostrato ogni voltache si riscontra un errore.

Chiudi tutti i set di dati aperti quando si annulla l'assegnazione di una raccoltaSpecifica se o meno i set di dati aperti vengono chiusi quando si annulla l'assegnazione dellaraccolta che li contiene. Il comportamento può essere Sempre o Chiedi conferma. Il valorepredefinito, Chiedi conferma, visualizza una finestra di dialogo che elenca i set di dati aperti cheè necessario chiudere per annullare l'assegnazione della raccolta.

Conferma eliminazioniSpecifica se è necessaria la conferma quando si elimina un elemento nella vista Esplora serverWPS.

Conferma riavvio serverSpecifica se è necessaria la conferma quando si riavvia un server nella vista Esplora serverWPS.

Scorrimento automatico del registroSpecifica se l'output del registro scorre automaticamente (consultare Visualizzare il registro(pag. 106)).

Scorrimento automatico dell'elencoSpecifica se l'elenco scorre automaticamente (consultare Visualizzare l'elenco (pag. 108)).

Mostra azioni del server avanzateControlla le opzioni del menu di scelta rapida disponibili al riavvio dei server WPS (consultareRiavvio con le azioni del server avanzate (pag. 36)).

Guida dell’utente di WorkbenchVersione 4.1

79

Percorso del file temporaneoQuesto campo punta alla directory in cui Workbench archivia i file temporanei. I file di registrocreati durante l'esecuzione di un programma sono archiviati in questa directory, come lo sono irisultati ODS HTML generati dai programmi.

Tenere presente che i file di output, in particolare i registri, possono essere regolabili e quindi sipotrebbe riscontrare che è necessario modificare questa impostazione se il campo punta, perimpostazione predefinita, ad un percorso con restrizioni di spazio.

Modalità della riga di comandoEsecuzione di programmi in linguaggio SAS in un server WPS dalla riga di comando.

Per utilizzare il server WPS da una riga di comando, è necessario eseguire il programma wps. Questofile eseguibile si trova nella directory bin dell'installazione di WPS.

Quando si esegue il server WPS da una riga di comando, non è possibile compilare programmi inprocessi di run-time.

OpzioniL'esecuzione di wps da sola, non produrrà nessun risultato e quindi è necessario fornire ulterioriistruzioni con la seguente forma:

wps <options> <programFileName>

Gli argomenti <options> possono essere un elenco di una delle seguenti opzioni:

• -optionname [optionalValue] – specifica un'opzione di sistema di WPS.• -config <configFileName> – specifica un file di configurazione contenente le opzioni di

sistema di WPS• -set <envVarName> <envVarValue> – specifica una variabile di ambiente che ha effetto

all'esecuzione del server WPS.

È possibile definire un numero di argomenti <options>, ma il <programFileName> deve sempreessere l'ultimo argomento nella riga di comando.

Opzioni di sistemaPer impostare un'opzione di sistema, specificare:

wps -optionname [optionalValue] <programFileName>

È possibile fornire tante opzioni di sistema -optionname al server WPS quante ne sono necessarie.Tuttavia, è possibile solo fornire opzioni dal valore singolo, quindi è necessario specificare -optionname [optionalValue] per ciascuna opzione di sistema.

Guida dell’utente di WorkbenchVersione 4.1

80

File di configurazioneÈ possibile definire le opzioni di sistema in un file di configurazione e si fa riferimento a questo filequando si esegue il server WPS:

wps -config <configFileName> <programFileName>

Per maggiori informazioni sui file di configurazione e l'ordine in cui vengono elaborati, consultareFile diconfigurazione (pag. 124).

Variabili di ambientePer impostare una variabile di ambiente da utilizzare con il server WPS:

wps.exe -set <envVarName> <envVarValue> <programFileName>

È possibile impostare tante variabili di ambiente quante ne sono necessarie. Tuttavia, è possibilesolo fornire opzioni dal valore singolo, quindi è necessario specificare -set <envVarName><envVarValue> per ciascuna variabile di ambiente.

Output del registroQuando si esegue il server WPS dalla riga di comando, le informazioni del registro vengono inviateall'output standard (stdout) per il sistema operativo. Una volta che il programma ha terminatol'esecuzione, si perdono queste informazioni di registro. Per mantenere l'output del registro,reindirizzare stdout in un file, per esempio:

wps program1.sas > program1.log

Output dei risultatiQuando si esegue il server WPS dalla riga di comando, qualsiasi risultato generato dal programmaviene acquisito automaticamente in un file denominato <programFileName>.lst creato nella stessadirectory del programma. Per esempio, viene generato un file denominato Program1.lst se si esegue unprogramma denominato Program1.sas.

Guida dell’utente di WorkbenchVersione 4.1

81

Raccolte e set di datiUna raccolta viene utilizzata per archiviare i file di dati di WPS (inclusi i set di dati), i percorsi dellecartelle e le connessioni ai database tramite l'istruzione LIBNAME.

Nella maggior parte dei sistemi operativi, una raccolta è associata direttamente ad una cartella delsistema operativo. La cartella del sistema operativo può contenere file diversi da WPS, ma solo quei filecon estensioni che WPS riconosce saranno visibili in Workbench.

Le Raccolte predefinite che sono visibili sotto ogni server nella vista Esplora server WPS sono:

• SASHELP – una raccolta di sola lettura contenente una varietà di metadati di sistema.• SASUSER – utilizzata per archiviare i set di dati e altre informazioni che si desidera mantenere dopo

la chiusura della sessione di WPS. Per utilizzare questo percorso, aggiungere SASUSER. prima delnome del set di dati pertinente nel programma.

• WORK – laddove i set di dati, cataloghi e fileref vengono archiviati per impostazione predefinita. WORKè un'"area di lavoro temporanea" che viene automaticamente svuotata da tutti i dati quando terminala sessione del server WPS.

Per preservare l'output creato dal programma, è possibile ridefinire il percorso di lavoro in unpercorso non temporaneo (consultare Impostare il percorso WORK (pag. 81)) o utilizzarel'istruzione LIBNAME per scrivere l'output che si desidera mantenere, nel proprio percorsopermanente (quale una connessione a database o directory), per esempio:

LIBNAME mylib '/directories/mydirectory/';

Ogni connessione a database o directory che si associa all'alias deve esistere già prima diassegnarla. Una volta creato e archiviato un set di dati in questo percorso, è necessario utilizzarel'alias associato per recuperare il set di dati (mylib).

Impostare il percorso WORKCambiare il percorso di WORK quando i programmi in linguaggio SAS vengono eseguiti in Workbench.

Per impostare il nome del percorso per il percorso di WORK utilizzato ogni volta che si avvia un serverspecifico:

1. Nella vista Esplora server WPS, fare clic con il pulsante destro del mouse sul nome del serverrichiesto e fare clic su Proprietà nel menu di scelta rapida.

2. Nell'elenco di proprietà, espandere il gruppo Avvio e selezionare Opzioni di sistema.3. Nel pannello Opzioni di sistema, fare clic su Aggiungi per visualizzare la finestra di dialogo

Opzione di avvio.

Guida dell’utente di WorkbenchVersione 4.1

82

4. In Nome, immettere WORK e in Valore, immettere il nome del percorso completo per il nuovopercorso di WORK.

5. Fare clic su OK per salvare l'opzione di sistema e fare clic su OK nella finestra di dialogo Proprietàper riavviare il server e applicare le modifiche.

Il percorso di WORK viene ridefinito quando si usa Workbench per eseguire programmi in linguaggioSAS, ma non se si esegue WPS dalla riga di comando. Quando si eseguono i programmi in modalitàbatch, è necessario impostare l'opzione di sistema WORK in un file di configurazione.

CataloghiPer catalogo s'intende un file in cui è possibile archiviare diversi tipi di informazioni (denominate voci dicatalogo), come ad esempio formati, informati, macro e output grafico.

Per esempio, è possibile scrivere un programma che possa generare un catalogo (FORMATS) in cuiarchiviare formati PICTURE:

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;

L'istruzione PICTURE permette di creare modelli per la stampa di numeri attraverso la definizione di unformato che consente caratteri speciali, come zeri iniziali, punteggiatura decimale e virgola, caratteri diriempimento, prefissi e rappresentanza di numeri negativi.

Quando si esegue il programma, i cataloghi vengono creati nella cartella WORK:

Guida dell’utente di WorkbenchVersione 4.1

83

Per visualizzare le voci associate ai cataloghi, fare clic con il pulsante destro del mouse su di esse eselezionare Proprietà.

Set di datiUn set di dati è un file creato o importato da un server WPS e archiviato in una raccolta (consultareRaccolte e set di dati (pág. 81)). Contiene righe e colonne note rispettivamente comeosservazioni e variabili.

Le osservazioni (righe) di solito si riferiscono ad un'entità specifica (ad esempio, un ordine o unapersona).

Le variabili (colonne) descrivono gli attributi di un'entità (ad esempio, un ID articolo in un ordine).

Esempio di set di datiNell'esempio di set di dati, ogni osservazione è un articolo nell'ordine. Le variabili sono ID ordine,ID articolo, Quantità e Prezzo unitario.

ID ordine ID articolo Quantità Prezzo unitario

10001 47853 3 30,75

10001 23104 10 4,90

10002 62091 1 89,99

Guida dell’utente di WorkbenchVersione 4.1

84

Aprire un set di datiÈ possibile aprire un set di dati nella vista Esplora server WPS: Espandere il nodo server richiesto,espandere Raccolte e fare doppio clic sul set di dati richiesto.

Eliminare un set di datiÈ possibile eliminare un set di dati archiviato su disco nella vista Esplora server WPS. Espandere ilnodo server richiesto, espandere il nodo Raccolte ed espandere la raccolta richiesta. Selezionare il setdi dati, fare clic con il pulsante destro del mouse e selezionare Elimina nel menu di scelta rapida.

Importare set di datiOltre ai set di dati creati eseguendo i programmi in linguaggio SAS, è possibile creare set di datiimportando i dati dai file esterni. I formati supportati sono:

• Delimitato• Larghezza fissa• File di fogli di calcolo Microsoft Excel

L'Importazione guidata del set di dati consente di configurare il set di dati durante l'importazione. Nonè sempre necessario portare a termine tutti i passaggi della procedura guidata; è possibile importare unset di dati da un file e fare clic su Fine nella prima pagina per accettare tutte le opzioni predefinite. Se siimporta un set di dati con lo stesso nome di quello preesistente, verrà sovrascritto.

Quando s'importano i file delimitati, Workbench determina il carattere delimitatore dai dati. Se taledelimitatore non è corretto, è possibile cambiarlo prima di importare il set di dati.

Quando si importano i file a larghezza fissa, Workbench determina l'inizio e la fine delle colonne daidati. Se le larghezze non sono corrette, è possibile cambiare le larghezze prima di importare il set didati.

I file del foglio di calcolo possono contenere diversi fogli di lavoro. Per impostazione predefinita,Workbench selezionerà il primo foglio con dati per l'importazione. Un foglio può anche avere nomi chesi riferiscono agli intervalli di celle ed è possibile importare i dati da questi nomi e anche dagli appunti.

È possibile trascinare un file del set di dati da Esplora progetti o Esplora file nella raccolta richiestapresente nel server WPS.

• È possibile solo trascinare file da Esplora progetti nel server locale.• È possibile trascinare i set di dati da qualsiasi cartella a cui si accede tramite lo stesso nodo di

connessione del server WPS richiesto. Non è possibile, per esempio, trascinare una cartella dilavoro dalla propria connessione locale a una connessione remota. Per realizzarlo, utilizzare primaEsplora file per copiare il set di dati nel server richiesto, quindi trascinare il set di dati dal nuovopercorso.

È possibile anche importare un set di dati con uno dei metodi seguenti:

Guida dell’utente di WorkbenchVersione 4.1

85

• In modo programmatico, per esempio utilizzando il motore per XLSX:

LIBNAME xlsxlib XLSX ‘myfile.xlsx’ HEADER=YES; DATA WORK.IMPORTED;SET xlsxlib.Sheet1;RUN;

• L'Importazione guidata del set di dati. Quando si importano le cartelle di lavoro Excel in formatoXLS o XLSX, questo metodo usa il motore per EXCEL e sarà quindi necessario installare il motoreper Microsoft ACE OLEDB.

Se non si installa Microsoft Excel, sarà necessario installare Microsoft Access Database EngineRedistributable per importare i set di dati.

Importare i set di dati dai filePer importare i file:

1. Nella vista Esplora server WPS, fare clic con il pulsante destro del mouse sul server locale e fareclic su Importa set di dati nel menu di scelta rapida.

In alternativa, è possibile selezionare un file dal file system e trascinare il file al server locale ocopiare e incollare il file al server locale.

2. Nel finestra di dialogo Importazione di set di dati, immettere un nome file o fare clic su Cambia eaprire il file richiesto.

3. Selezionare un Nome raccolta per il set di dati e, se necessario, cambiare Nome membro in mododa rinominare il set di dati.

4. Il tipo di formato viene reinserito dal tipo di file importato. Se richiesto, cambiare il tipo di Formatodati che meglio descrive il contenuto del set di dati.

5. Fare clic su Avanti e configurare il set di dati importato in base al tipo:

• Se si seleziona Larghezza fissa, per ogni Colonna, modificare il valore Inizio e Larghezza peralterare la larghezza della variabile esportata.

• Se si seleziona Delimitato:

• Selezionare il delimitatore richiesto. Per definire il proprio delimitatore, selezionare Altro eimmettere il carattere del delimitatore.

• Selezionare Includi nomi campi nella prima riga per includere i nomi delle colonne.• Se si seleziona Excel:

• Se necessario, selezionare un diverso foglio di lavoro in Foglio di lavoro intero. È possibileanche selezionare un Intervallo denominato preesistente dal foglio di lavoro preesistente onuovo.

• Selezionare Includi nomi prima riga come intestazioni colonne in modo da utilizzare laprima riga come nomi di variabili.

6. Fare clic su Avanti e, se necessario, modificare le proprietà delle colonne del set di dati.

Guida dell’utente di WorkbenchVersione 4.1

86

• Per cambiare un nome di colonna, selezionare un'intestazione di colonna nell'anteprima emodificare il Nome colonna.

• Per cambiare un'etichetta di colonna, selezionare un'intestazione di colonna nell'anteprima emodificare l'Etichetta colonna.

• Per cambiare il tipo di dati della colonna, selezionare un'intestazione di colonna nell'anteprima,quindi modificare il Formato dati colonne.

7. Fare clic su Fine per importare il set di dati.

Importare i dati del foglio di calcoloÈ possibile utilizzare l'Importazione guidata del set di dati per importare l'intervallo di celledirettamente da un foglio di calcolo Microsoft Excel.

I dati importati avranno il valore salvato per ultimo. Le formule delle celle non vengono rivalutateall'apertura del foglio di calcolo e il valore salvato per ultimo viene utilizzato per queste celle.

1. Selezionare l'intervallo contiguo nel foglio di calcolo Excel che si desidera importare, e copiare eincollare il contenuto nel server richiesto nella vista Esplora server WPS.

In alternativa, è possibile trascinare l'intervallo selezionato nella raccolta richiesta nel serverrichiesto.

2. Nel finestra di dialogo Importazione di set di dati, immettere un nome file o fare clic su Cambia eaprire il file richiesto.

3. Selezionare un Nome raccolta per il set di dati e, se necessario, cambiare Nome membro in mododa rinominare il set di dati.

4. Il tipo di formato viene reinserito dal tipo di file importato. Se richiesto, cambiare il tipo di Formatodati che meglio descrive il contenuto del set di dati.

5. Fare clic su Avanti e configurare il set di dati importato in base al tipo:

• Se si seleziona Larghezza fissa, per ogni Colonna, modificare il valore Inizio e Larghezza peralterare la larghezza della variabile esportata.

• Se si seleziona Delimitato:

• Selezionare il delimitatore richiesto. Per definire il proprio delimitatore, selezionare Altro eimmettere il carattere del delimitatore.

• Selezionare Includi nomi campi nella prima riga per includere i nomi delle colonne.6. Fare clic su Avanti e, se necessario, modificare le proprietà delle colonne del set di dati.

• Per cambiare un nome di colonna, selezionare un'intestazione di colonna nell'anteprima emodificare il Nome colonna.

• Per cambiare un'etichetta di colonna, selezionare un'intestazione di colonna nell'anteprima emodificare l'Etichetta colonna.

Guida dell’utente di WorkbenchVersione 4.1

87

• Per cambiare il tipo di dati della colonna, selezionare un'intestazione di colonna nell'anteprima,quindi modificare il Formato dati colonne.

7. Fare clic su Fine per importare il set di dati.

Esportare i set di datiÈ possibile esportare set di dati di WPS come file di testo a larghezza fissa o delimitati, e anche comecartelle di lavoro Microsoft Excel. L'Esportazione guidata del set di dati consente di configurare ilcontenuto del file di esportazione se necessario.

Per esportare un set di dati:

1. Nella vista Esplora server WPS, espandere il server richiesto, fare clic con il pulsante destro delmouse sul set di dati richiesto e fare clic su Esporta set di dati nel menu di scelta rapida.

2. Nella Esportazione guidata del set di dati, selezionare il tipo di esportazione tra: Delimitato,Larghezza fissa o Excel. Per Excel, selezionare il formato del file richiesto e fare clic su Avanti.

3. Configurare il set di dati esportato in base al tipo di esportazione:

Se si seleziona il tipo a larghezza fissa, per ogni Colonna, modificare il valore Inizio e Larghezzaper alterare la larghezza della variabile esportata.

Se si seleziona Delimitato:

• Selezionare il delimitatore richiesto. Per definire il proprio delimitatore, selezionare Altro eimmettere il carattere del delimitatore.

• Selezionare Includi nomi campi nella prima riga per includere i nomi delle colonne.4. Nel pannello Seleziona file di destinazione, immettere un nome file per il set di dati esportato e

fare clic su Fine.

Rimuovere il riferimento al set di datiNon è possibile rimuovere il riferimento a un set di dati da solo. Per rimuovere il riferimento a un set didati, è necessario riavviare il server richiesto, che rimuove anche l'output ODS, le voci del registro, altrebiblioteche e i riferimenti al file. Per maggiori informazioni, consultare Riavviare il server (pág. 36).

Vista Profiler di datiLa vista Profiler di dati consente di visualizzare il contenuto e i dettagli su un set di dati.

Per aprire la vista Profiler di dati, selezionare il set di dati di lavoro necessario, fare clic con il pulsantedestro del mouse su Apri con, quindi fare clic su Profiler di dati nel menu di scelta rapida.

Guida dell’utente di WorkbenchVersione 4.1

88

Vista RiepilogoLa Vista Riepilogo elenca le informazioni sul set di dati, tra cui il numero di osservazioni e variabilinelle caratteristiche del set di dati e delle variabili.

La Vista Riepilogo contiene due pannelli: Riepilogo e Variabili.

RiepilogoIl pannello Riepilogo visualizza le informazioni riepilogative sul set di dati: il nome del set di dati, ilnumero totale di osservazioni e il numero totale di variabili nel set di dati.

VariabiliIl pannello Variabili visualizza le informazioni sulle variabili nel set di dati, come ad esempio il nomedelle variabili, il tipo di etichetta, la lunghezza e così via. Vengono visualizzate le seguenti informazioni:

VariabileIl nome della variabile nel set di dati.

EtichettaIl nome visualizzato alternativo per la variabile.

TipoIl tipo di variabile. Il tipo può essere Numerico per numeri e valori di data e ora, o Carattere per idati di tipo carattere e stringa.

ClassificazioneLa categoria della variabile che può essere:

• Categorica. Una variabile che può contenere un numero limitato di valori possibili e il limite èinferiore alla soglia di classificazione specificata.

• Continua. Una variabile che può contenere un numero illimitato di valori possibili. Questaclassificazione viene utilizzata per le variabili numeriche in cui il numero di valori distinti nellavariabile è maggiore della soglia di classificazione specificata

• Discreta. Una variabile che può contenere un numero limitato di valori possibili. Questaclassificazione viene utilizzata per le variabili di tipo carattere in cui il numero di valori distintinella variabile è maggiore della soglia di classificazione specificata

La soglia di classificazione viene specificata nel pannello Dati della finestra di dialogoPreferenze.

LunghezzaLa dimensione richiesta per archiviare i valori della variabile. Per i tipi di carattere, il numerorappresenta il numero massimo di caratteri che si trovano in un valore di variabile. Per i tipinumerici, il numero rappresenta il numero massimo di byte necessari per archiviare il valore.

Guida dell’utente di WorkbenchVersione 4.1

89

FormatoCome viene visualizzata la variabile all'output. Per maggiori informazioni sui formati, consultarela sezione Formati nel Riferimento per gli elementi del linguaggio di WPS.

InformatoLa formattazione applicata alla variabile all'importazione in WPS. Per maggiori informazioni suiformati, consultare la sezione Informati nel Riferimento per gli elementi del linguaggio di WPS.

Valori distintiIl numero di valori univoci nella variabile. Se la classificazione delle variabili è Continua, lavisualizzazione indica che ci sono più valori univoci della soglia di classificazione specificata.

Valori mancantiIl numero di valori mancanti nella variabile.

Distribuzione frequenzePer ciascun valore in una variabile non continua, visualizza un grafico che mostra il numero dioccorrenze per ciascun valore nella variabile.

DatiIl pannello Dati elenca tutte le osservazioni in un set di dati e consente di visualizzare, filtrare oppureordinare le osservazioni.

Il pannello Dati nella vista Profiler di dati è una versione di sola lettura del Visualizzatore set di dati.È possibile modificare la vista, ordinare e filtrare i dati nel pannello Dati. Se si desidera modificare ivalori nel set di dati, è necessario utilizzare il Visualizzatore set di dati.

Vista di una variabileLa scheda Vista di una variabile visualizza le statistiche riepilogative per tutte le variabili numerico ditipo ad una variabile.

Le colonne visualizzate nella scheda Vista di una variabile sono determinate con la finestra di dialogoCalcola statistiche. Fare clic su Configura Statistica ( ) per aprire Preferenze e selezionare lastatistica che si desidera visualizzare:

QuantiliElenca i punti quantili.

Struttura variabileElenca ciascuna delle principali statistiche selezionate che descrivono la variabile, ad esempio ilnumero di valori mancanti, e i valori minimi e massimi.

Guida dell’utente di WorkbenchVersione 4.1

90

Indici di posizioneElenca ciascuno degli indici utilizzati per individuare il punto centrale nei valori della variabile

Indici di dispersioneElenca ciascuna delle misure selezionate utilizzate per mostrare la variazione dal valore centralenella variabile.

AltriElenca altre statistiche che è possibile visualizzare nella tabella delle statistiche.

Diagrammi di una variabileLa scheda Diagrammi di una variabile consente di visualizzare la tabella e i grafici di distribuzionedella frequenza per una variabile del set di dati selezionato.

Le informazioni visualizzate sono determinate dalla variabile selezionata nell'elenco Selezionevariabili. Ciascuna sezione nella scheda visualizza la frequenza di valori che si verifica nella variabileselezionata.

Tabella frequenzeVisualizza la frequenza dei valori nella variabile specificata, la percentuale del numero totale diosservazioni per ciascun valore e le frequenze e percentuali cumulative.

Se il tipo di variabile è categorico o discreto, la tabella visualizza una riga per ogni valore potenziale. Seil tipo di variabile è continuo, la variabile viene discretizzata e le informazioni sulla frequenza vengonovisualizzate per ciascun bin.

Diagramma frequenzeÈ possibile visualizzare la distribuzione della frequenza della variabile specificata come un istogramma,grafico a linee o grafico a torta. In tutti i casi, i grafici visualizzano la frequenza di valori come lapercentuale del numero totale di osservazioni per la variabile.

È possibile modificare e salvare il diagramma. Fare clic su Modifica diagramma per aprire l'Editordi diagramma, da cui è possibile salvare il diagramma negli Appunti.

Guida dell’utente di WorkbenchVersione 4.1

91

Analisi correlazioneLa scheda Analisi correlazione consente di visualizzare la forza della relazione tra le variabilinumeriche nel set di dati.

OpzioniSpecifica il tipo di coefficiente da utilizzare quando si confrontano le variabili e quali variabili numerichenel set di dati è necessario confrontare.

CoefficienteSpecifica il tipo di coefficiente utilizzato per confrontare i valori.

PearsonSpecifica il coefficiente di correlazione Pearson, definito come:

dove

è la media della variabile x

è la media della variabile y.

Rho di SpearmanSpecifica il coefficiente di correlazione per ranghi di Spearman, definito come:

dove

• è il rango di

• è la media della variabile ordinale .

• è il rango di

• è la media della variabile ordinale .

I valori delle variabili vengono prima classificati e i ranghi confrontati. L'uso di questocoefficiente può quindi essere meno efficace per alcuni valori anomali nei dati.

Guida dell’utente di WorkbenchVersione 4.1

92

Tau di KendallSpecifica il coefficiente di correlazione per ranghi di Kendall, definito come:

Dove

• è il numero di coppie concordanti.

• è il numero di coppie discordanti.

• è il numero di valori ex-aequo nel iesimo gruppo di valori ex-aequo per la primavariabile.

• è il numero di valori ex-aequo nel jesimo gruppo di valori ex-aequo per la secondavariabile.

• È possibile esprimere la differenza nel numero di coppie concordanti e discordanticome:

I valori delle variabili vengono prima classificati e i ranghi confrontati. L'uso di questocoefficiente può quindi essere meno efficace per alcuni valori anomali nei dati.

Seleziona variabiliVisualizza un elenco di variabili numeriche nel set di dati da cui è possibile selezionare le variabilida confrontare.

Matrice coefficiente correlazioneLa matrice è illustrata in blocchi di colore, le dimensioni e il colore dei blocchi indica la relazione tra levariabili confrontate. La scala per gli elementi visualizzati varia da 1 (una forte correlazione positiva) a-1 (dove c'è una forte correlazione negativa).

Utilizzando le variabili che mostrano una forte correlazione positiva può portare al modello che diventainstabile dato che una piccola modifica nelle variabili può portare ad una grande modifica nel modello.

Se si utilizza il modello per la previsione, le variabili che mostrano una forte correlazione positivapossono essere buoni predittori.

Guida dell’utente di WorkbenchVersione 4.1

93

Statistiche correlazioneVisualizza la statistica di correlazione e il grafico a dispersione per l'elemento selezionato nella Matricecoefficiente correlazione. La tabella visualizza le variabili sottoposte al confronto, il valore per il tipo dicoefficiente specificato e il valore p per il confronto. Il grafico a dispersione visualizza tutti i valori nelset di dati, con la stessa scala di colori della matrice, come diagramma o mappa termica se il numero diosservazioni è molto elevato.

Capacità di previsioneLa scheda Capacità di previsione consente di visualizzare la capacità di previsione di variabiliindipendenti nel set di dati in rapporto alla variabile dipendente selezionata.

Le informazioni visualizzate sono determinate dalla variabile selezionata come Variabile dipendente.Ogni sezione visualizza la relazione tra le variabili indipendenti nel set di dati e la Variabile dipendentespecificata.

Tabella statisticheLa Tabella statistiche visualizza tutte le variabili nel set di dati e una serie di statistiche di capacità diprevisione per consentire di individuare le variabili indipendenti più efficaci per la variabile dipendentespecificata. Le statistiche visualizzate sono:

• Variazione di entropia Visualizza il valore della Variazione di entropia per ogni variabile in rapportoalla Variabile dipendente specificata.

• Chi quadrato. Visualizza il valore Chi quadrato per ciascuna variabile in rapporto alla Variabiledipendente specificata.

• Gini. Visualizza il valore della Varianza Gini per ogni variabile in rapporto alla Variabile dipendentespecificata.

Per maggiori informazioni su come calcolare questi valori, consultare Criteri della capacità diprevisione (pag. 94)

Diagramma di variazione di entropiaVisualizza il grafico a barre della variazione di entropia di variabili indipendenti in rapporto alla Variabiledipendente specificata. Le variabili sono visualizzate nell'ordine dalla variazione di entropia più elevataalla più bassa. Il numero di variabili visualizzato nel diagramma viene determinato dalle preferenzeimpostate nel pannello Profiler di dati della finestra di dialogo Preferenze.

È possibile modificare e salvare il diagramma. Fare clic su Modifica diagramma per aprire l'Editordi diagramma, da cui è possibile salvare il diagramma negli Appunti.

Guida dell’utente di WorkbenchVersione 4.1

94

Diagramma frequenzeVisualizza la frequenza di ciascun valore di una variabile indipendente selezionata nella Tabellastatistiche. Il diagramma ha due modalità di visualizzazione:

• Fare clic su Visualizza tutti i dati per visualizzare la relazione predittiva complessiva tra i valoridi una variabile indipendente selezionata nella Tabella statistiche della Variabile dipendentespecificata.

• Fare clic su Visualizza analisi dati per visualizzare la frequenza di ciascun valore di unavariabile indipendente e la sua relazione con i risultati per la Variabile dipendente specificata.

È possibile modificare e salvare il diagramma. Fare clic su Modifica diagramma per aprire l'Editordi diagramma dal percorso in cui è possibile salvarlo negli Appunti.

Criteri della capacità di previsione

La capacità di previsione è un modo per misurare quanto bene una determinata variabile di input puòpredire la variabile di destinazione.

Statistica del Chi quadrato di PearsonLa statistica del Chi quadrato di Pearson è una misura della verosimiglianza che il valore della variabiledi destinazione sia correlato al valore della variabile predittiva.

Ogni osservazione nel set di dati viene allocata a una cella in una tabella di contingenza, in baseai valori delle variabili predittive e di destinazione. La statistica del Chi-quadrato di Pearson vienecalcolata come la somma normalizzata delle deviazioni al quadrato tra il numero reale di osservazioniin ogni cella e il numero previsto di osservazioni in ogni cella se non ci fosse alcuna relazione tra levariabili predittive e di destinazione.

Se una variabile predittiva ha una elevata statistica del Chi quadrato di Pearson, significa che lavariabile è un buon predittore della variabile di destinazione ed è probabile che sia un buon candidatoda utilizzare per dividere i dati in un algoritmo di discretizzazione o generazione di alberi.

La statistica del Chi-quadrato di Pearson per una variabile di destinazione discreta viene calcolatacome

dove:

• è il numero totale di osservazioni nel set di dati• è il numero di valori distinti della variabile predittiva (queste sono le file nella tabella di

contingenza)

Guida dell’utente di WorkbenchVersione 4.1

95

• è il numero di valori distinti e discreti della variabile di destinazione (queste sono le colonnenella tabella di contingenza)

• è il numero di osservazioni per cui la variabile predittiva ha il ° valore, e la variabile didestinazione ha il ° valore, (questi sono i valori nelle celle della tabella di contingenza)

• è il numero totale di osservazioni per cui la variabile predittiva ha il ° valore,

• è il numero totale di osservazioni per cui la variabile di destinazione ha il ° valore,

• è il valore previsto di , calcolato come

Variazione di entropiaLa variazione di entropia è una misura di quanto bene il valore di una variabile predittiva può predire ilvalore della variabile di destinazione.

Se una variabile in un set di dati ha una variazione di entropia elevata, significa che la variabile è unbuon predittore della variabile di destinazione ed è probabile che sia un buon candidato da utilizzareper dividere i dati in un algoritmo di discretizzazione o generazione di alberi.

La variazione di entropia per una variabile di destinazione discreta viene calcolata come

dove:

• è il numero totale di osservazioni nel set di dati• è il numero di valori distinti della variabile predittiva, • è il numero di valori distinti e discreti della variabile di destinazione, • è il numero di osservazioni per cui la variabile predittiva ha il ° valore, e la variabile di

destinazione ha il ° valore,

• è il numero totale di osservazioni per cui la variabile predittiva ha il ° valore,

• è il numero totale di osservazioni per cui la variabile di destinazione ha il ° valore,

• è l'entropia calcolata per le sole osservazioni in cui si trova la variabile predittiva , calcolatocome

• è l'entropia calcolata per tutte le osservazioni, calcolate come

Guida dell’utente di WorkbenchVersione 4.1

96

Varianza GiniLa varianza Gini è una misura di quanto bene il valore di una variabile predittiva può prevedere il valoredella variabile di destinazione.

Se una variabile in un set di dati ha una varianza Gini elevata, significa che la variabile è un buonpredittore della variabile di destinazione ed è probabile che sia un buon candidato da utilizzare perdividere i dati in un algoritmo di discretizzazione o generazione di alberi.

La varianza Gini per una variabile di destinazione discreta viene calcolata come

dove

• è il numero totale di osservazioni nel set di dati• è il numero di valori distinti della variabile predittiva, • è il numero di valori distinti e discreti della variabile di destinazione, • è il numero di osservazioni per cui la variabile predittiva ha il ° valore, e la variabile di

destinazione ha il ° valore,

• è il numero totale di osservazioni per cui la variabile predittiva ha il ° valore,

• è il numero totale di osservazioni per cui la variabile di destinazione ha il ° valore,

• è l'impurità Gini calcolata per le sole osservazioni in cui si trova la variabile predittiva ,calcolato come

• è l'impurità di Gini calcolata per tutte le osservazioni, calcolate come

Valore informativoIl valore informativo è una misura della verosimiglianza che il valore della variabile di destinazionesia correlato al valore della variabile predittiva. La misura del valore informativo è applicabile solo perle variabili di destinazione binarie (ovvero, le variabili di destinazione che possono assumere uno diesattamente due valori).

Se una variabile predittiva ha un elevato valore informativo, significa che la variabile è un buonpredittore della variabile di destinazione ed è probabile che sia un buon candidato da utilizzare perdividere i dati in un algoritmo di discretizzazione o generazione di alberi.

Guida dell’utente di WorkbenchVersione 4.1

97

La statistica del valore informativo è calcolata come

dove:

• è il numero di valori distinti e discreti della variabile predittiva, (queste sono le file nella tabelladi contingenza)

• e sono i due valori possibili della variabile di destinazione binaria

• è il numero di osservazioni per cui la variabile predittiva ha il ° valore, e la variabile didestinazione ha il valore, (questi sono i valori nelle celle della colonna nella tabella dicontingenza)

• è il numero di osservazioni per cui la variabile predittiva ha il ° valore, e la variabile didestinazione ha il valore, (questi sono i valori nelle celle della colonna nella tabella dicontingenza)

• è il numero totale di osservazioni per cui la variabile di destinazione ha il valore,

• è il numero totale di osservazioni per cui la variabile di destinazione ha il valore,

• è il peso dell'evidenza (WOE), un piccolo numero positivo per evitare valori infiniti quando o

• è il valore WOE per le osservazioni in cui si trova la variabile predittiva , calcolato come

Visualizzatore set di datiÈ possibile visualizzare, filtrare oppure ordinare un set di dati all'interno del visualizzatore. Inoltre, èpossibile modificare le variabili delle osservazioni, rimuovere le osservazioni e aggiungere anche nuoveosservazioni.

Il contenuto di un set di dati viene mostrato in una griglia. Le righe della griglia rappresentano leosservazioni del set di dati e le colonne rappresentano le variabili del set di dati.

È possibile visualizzare le etichette nelle intestazioni delle colonne di un set di dati, riorganizzarela vista spostando le colonne e se alcune colonne della griglia dati sono irrilevanti per un'attività, èpossibile nasconderle.

ModalitàUn set di dati viene aperto nella modalità Sfoglia, ma si può convertire nella modalità Modifica se sidesidera apportare le modifiche ai dati. Per modificare il contenuto di set di dati, fare clic sul menu Dati,quindi fare clic su Attiva/Disattiva modalità di modifica.

Guida dell’utente di WorkbenchVersione 4.1

98

Organizzazione dei set di datiÈ possibile manipolare la vista del set di dati in modo che nasconda le variabili non necessarie esposti le colonne in modo che siano visualizzate in un ordine diverso. Le modifiche in questa vista noncambiano i dati sottostanti.

Mostrare le etichetteÈ possibile specificare se visualizzare le etichette per le colonne piuttosto che i nomi delle colonne.Nella finestra Preferenze, fare clic su WPS, fare clic su Visualizzatore set di dati, quindi fare clic suMostra etichette per nomi di colonne.

Nascondere le variabiliPer nascondere una colonna della griglia dati:

1. Fare clic con il pulsante destro del mouse sull'intestazione della colonna per la variabile che sidesidera nascondere.

2. Fare clic su Nascondi colonne.

La colonna della griglia dati scompare dalla vista. Se si prova a nascondere una colonna per cui il filtroè attualmente attivo, verrà richiesto di confermare se si desidera rimuoverlo e nascondere la colonna.

Mostrare le variabili nascostePer mostrare le variabili del set di dati nascoste in precedenza:

1. Fare clic con il pulsante destro del mouse sulla riga di intestazione del set di dati.2. Fare clic su Mostra/Nascondi colonne.3. Nella finestra di dialogo Mostra/Nascondi colonne, selezionare le colonne da mostrare e fare clic

su OK.

Spostare le colonneÈ possibile spostare le colonne nella vista del set di dati:

1. Tenere premuto il pulsante sinistro del mouse sull'intestazione delle colonne.2. Trascinare la colonna in cui si desidera essere.

Verrà visualizzata una linea grigia spessa tra le colonne che indica dove apparirà la colonna.3. Rilasciare il pulsante del mouse e viene visualizzata la colonna nel percorso indicato.

Guida dell’utente di WorkbenchVersione 4.1

99

Modifica di un set di datiÈ possibile modificare le osservazioni e anche aggiungerle ed eliminarle, se il set di dati si trova inmodalità Modifica.

I controlli per la modifica di un set di dati sono disponibili dal menu Dati, dalla barra degli strumenti eanche dal menu di scelta rapida del set di dati.

Se il set di dati viene aperto in modalità Sfoglia, è possibile passare alla modalità Modifica facendo clicsu Modifica:

È possibile apportare tante modifiche quante ne sono necessarie; le modifiche non vengono scritteautomaticamente nel set di dati, è necessario scegliere di salvare le modifiche. Se il salvataggio dellemodifiche non riesce, resteranno visibili eventuali modifiche che non sono state scritte e descrive indettaglio l'errore scritto nel registro di Workbench.

Modificare le osservazioni

È possibile modificare le variabili delle osservazioni (celle) come valori non elaborati. Se le variabilihanno una formattazione applicata, non verrà visualizzata durante la modifica; una volta completata lamodifica verrà visualizzata l'osservazione formattata.

1. Fare doppio clic sulla cella che si desidera modificare:Tipo di variabile DescrizioneNumerica Il valore non formattato e non elaborato viene visualizzato

nella cella in cui è possibile immettere un nuovo valore. Se sidesidera visualizzare come appare la cella attiva quando èformattata, premere MAIUSC + F8 e verrà visualizzata come unadescrizione comando.

Guida dell’utente di WorkbenchVersione 4.1

100

Tipo di variabile DescrizioneDATE, DATETIME o TIME I valori di DATE, DATETIME e TIME vengono modificati come i

rispettivi tipi. È possibile fare clic su un singolo elemento di unadata oppure ora (come un anno oppure un'ora) appropriata, eutilizzare i tasti di direzione della tastiera o la rotellina del mouse,per aumentarli o diminuirli gradualmente. Si possono inoltresovrascrivere gli elementi numerici con valori di ricambio.

È possibile utilizzare il controllo di modifica alternativo associatoa ciascun tipo. I valori di DATE hanno un calendario, le orehanno un selettore di ora e i valori di DATETIME hanno una

combinazione di selettori di DATETIME. Fare clic sul pulsantea destra del valore interno e verrà visualizzato l'editor appropriato.

Stringa Il valore non formattato e non elaborato viene visualizzatonella cella in cui è possibile immettere un nuovo valore. Se sidesidera visualizzare come appare la cella attiva quando èformattata, premere MAIUSC + F8 e verrà visualizzata come unadescrizione comando.

2. Quando sono state completate le modifiche, premere INVIO.

Se il valore immesso è diverso dal valore originale salvato, il valore dell'osservazione vienevisualizzato in grassetto con un asterisco (*) accanto al numero di osservazione nel margine sinistrodella griglia.

3. Le modifiche non vengono salvate immediatamente nel set di dati. Per salvare le modifiche nel setdi dati originale, fare clic sul menu File, quindi fare clic su Salva. Se sono state apportate modificheerronee, è possibile annullare tutte le modifiche (consultare Annullare le modifiche (pag. 101)).

Aggiungi osservazioni

È possibile aggiungere nuove osservazioni ad un set di dati. Sono sempre aggiunte alla fine delset di dati, indipendentemente dalla propria posizione attuale in esso. Per aggiungere una nuovaosservazione:

1. Fare clic sul menu Dati, quindi fare clic su Aggiungi osservazione.2. La nuova riga verrà visualizzata in grassetto e un carattere più (+) verrà visualizzato accanto

al numero dell'osservazione nel margine sinistro della griglia. Fare doppio clic in ciascuna cellanell'osservazione e modificare il contenuto se necessario.

3. Le modifiche non vengono salvate immediatamente nel set di dati. Per salvare le modifiche nel setdi dati originale, fare clic sul menu File, quindi fare clic su Salva. Se sono state apportate modificheerronee, è possibile annullare tutte le modifiche (consultare Annullare le modifiche (pag. 101)).

Guida dell’utente di WorkbenchVersione 4.1

101

Eliminare le osservazioni

Per eliminare un'osservazione da un set di dati:

1. Selezionare l'osservazione che si desidera eliminare facendo clic sul suo numero di osservazionenella colonna sinistra. Per eliminare più osservazioni, tenere premuto il tasto CTRL, selezionando alcontempo le osservazioni che desidera eliminare.

2. Fare clic sul menu Dati, quindi fare clic su Elimina osservazione.3. Le modifiche non vengono salvate immediatamente nel set di dati. Per salvare le modifiche nel set

di dati originale, fare clic sul menu File, quindi fare clic su Salva. Se sono state apportate modificheerronee, è possibile annullare tutte le modifiche (consultare Annullare le modifiche (pag. 101)).

Annullare le modifiche

È possibile annullare eventuali modifiche che sono state apportate, ma non ancora salvate. Perannullare le modifiche non salvate:

1. Fare clic sul menu Dati, quindi fare clic su Annulla modifiche.2. In Conferma annullamento modifiche, fare clic su Sì per annullare le modifiche.

Valori mancanti

È possibile impostare una variabile di osservazione come "valore mancante" tramite l'opzione Impostavalore mancante.

Nota:Quando le variabili numeriche vengono formattate come DATE, DATETIME o TIME, questo è l'unicomodo per impostare tali variabili come mancanti.

1. Selezionare la variabile dell'osservazione (cella) che si desidera impostare come mancante.

È possibile impostare su "mancante" solo una variabile alla volta in un'unica operazione.2. Fare clic con il pulsante destro del mouse sulla cella selezionata e fare clic su Imposta valore

mancante nel menu di scelta rapida.

1. Se la cella è un tipo di variabile di carattere, la cella viene impostata su un carattere di spaziosingolo (' ').

Guida dell’utente di WorkbenchVersione 4.1

102

2. Se la cella è un tipo di variabile numerica, la finestra di dialogo Imposta valore mancanteviene utilizzata per impostare il valore mancante. Se la variabile di osservazione viene giàimpostata su un valore mancante, viene mostrato il valore non elaborato corrente. Se la variabiledi osservazione non viene impostata su "valore mancante", viene utilizzato il valore predefinito. (punto). Se necessario, è possibile modificare il valore mancante su uno dei seguenti valori: .(punto), ._ (punto seguito da un carattere di sottolineatura) o da .A a .Z.

3. Le modifiche non vengono salvate immediatamente nel set di dati. Per salvare le modifiche nel setdi dati originale, fare clic sul menu File, quindi fare clic su Salva. Se sono state apportate modificheerronee, è possibile annullare tutte le modifiche (consultare Annullare le modifiche (pag. 101)).

Filtrare un set di datiÈ possibile filtrare il contenuto del set di dati per variabile per mostrare solo i dati necessari. I filtri sonocumulativi, se si filtra su più di una variabile, tutti i filtri si applicano. Si può annullare qualsiasi filtro inqualunque momento.

È possibile impostare i criteri di filtro su più colonne e, man mano che si applicano i filtri, il contenuto delset di dati viene aggiornato automaticamente.

Per filtrare la vista del set di dati:

1. Fare clic sul pulsante del filtro di seguito sotto l'intestazione della variabile per la colonna che sidesidera filtrare.

2. Selezionare i criteri per cui si desidera filtrare la vista e completare i criteri per il filtro, immettendo idettagli appropriati.Tipo di dati CriteriDATE,DATETIME oTIME

La maggior parte delle espressioni che si basano su una variabile di data oppureora vengono impostate in un'altra finestra di dialogo. Usare i controlli di calendarioe orologio per impostare i criteri della data. Per valori di DATETIME, fare clic sulpulsante dell'orologio per impostare il componente dell'ora del valore del filtro.

Altro valorenumerico ostringa

L'espressione per il filtro viene visualizzata sotto l'intestazione della variabile.Immettere il valore o i valori necessari per completare l'espressione nella casella dimodifica.

Per un elenco di espressioni del filtro supportate, consultare Espressioni per il filtro dei set di dati(pag. 103).

Per cancellare il filtro per una variabile, fare clic sul pulsante del filtro, quindi selezionare Cancellafiltro.

Guida dell’utente di WorkbenchVersione 4.1

103

Espressioni per il filtro dei set di dati

Per i tipi di variabile diversi dai formati DATE, DATETIME o TIME, è possibile modificare l'espressionedel filtro generata. Non è possibile modificare le espressioni per le variabili del filtro DATE, DATETIMEo TIME, che si possono solo cancellare e immettere nuovamente.

Sintassi delle espressioni per il filtroLa tabella mostra la sintassi delle espressioni supportate.

Criteri Espressione Esempi

Uguale a EQ x o EQ s È uguale a 100 (numerico)

EQ 100

È uguale a "Blanco" (stringa)

EQ "Blanco"

Diverso da NE x o NE s È diverso da 100 (numerico)

NE 100

È diverso da "Blanco" (stringa)

NE "Blanco"

Minore di LT x È minore di 100

LT 100

Maggiore di GT x È maggiore di 100

GT 100

Minore di ouguale a

LE x È minore o uguale a 100

LE 100

Maggiore dio uguale a

GE x È maggiore di o uguale a 100

GE 100

Tra (inclusi) BETWEEN x AND y È compreso tra 100 e 200

BETWEEN 100 AND 200

Noncompreso tra(inclusi)

NOT BETWEEN x AND y Non è compreso tra 100 e 200

BETWEEN 100 AND 200

Mancante IS MISSING IS MISSING

Nonmancante

IS NOT MISSING IS NOT MISSING

Guida dell’utente di WorkbenchVersione 4.1

104

Criteri Espressione Esempi

In IN ( x , y ) o IN ( s1 ,

s2 )

È uno dei valori 100, 200 o 300

IN (100,200,300)

È uno dei valori "Blanco", "Jones" o "Smith"

IN ("Blanco","Jones","Smith")

Inizia con LIKE " s% " Inizia con la stringa "Bla"

LIKE "Bla%"

Terminacon

LIKE "%s " Termina con la stringa "nco"

LIKE "%nco"

Contiene LIKE "%s% " Contiene la stringa "an"

LIKE "%an%"

Ordinare un set di datiÈ possibile ordinare il contenuto di un set di dati in diverse variabili. Le variabili che fanno parte di unordinamento attivo hanno un'icona che rappresenta la direzione dell'ordinamento nell'intestazione: per l'ordinamento crescente e per l'ordinamento decrescente. Le dimensioni dell'icona indicanol'importanza della variabile nell'ordinamento.

L'ordinamento non è disponibile se il set di dati è aperto in modalità Modifica. Se si tenta di passarealla modalità Modifica mentre un ordinamento è attualmente attivo, l'intero set di dati da riscrivere percorrispondere l'attuale ordinamento per consentire la corretta modifica.

Per ordinare un set di dati:

1. Fare clic con il pulsante destro del mouse sull'intestazione della colonna per la variabile che sidesidera utilizzare come tasto primario.

2. Fare clic su Ordinamento crescente oppure Ordinamento decrescente nel menu di scelta rapidaper eseguire l'ordinamento.

3. È possibile aggiungere ulteriori tasti all'ordinamento selezionando la colonna richiesta e facendo clicsu Ordinamento crescente oppure Ordinamento decrescente.

4. Opzionale:

Gli ordinamenti si possono cancellare tramite l'opzione Cancella ordinamento nel menu di sceltarapida.

Guida dell’utente di WorkbenchVersione 4.1

105

Uso dell'output deiprogrammiL'output dei programmi è accessibile dalle seguenti viste:

• Esplora server WPS (pag. 57) – Fornisce l'accesso ai set di dati, cataloghi, riferimenti allaraccolta (per esempio, la raccolta Work predefinita), riferimenti al file e così via, generati per il serverspecifico.

• Esplora output (pag. 64) – Fornisce l'accesso ai registri e l'output generati dall'Output DeliverySystem (ODS), in formati di output quali elenchi, HTML o PDF.

• Esplora risultati (pag. 64) – Fornisce l'accesso ai risultati di output delle procedure eseguite comeparte del programma in linguaggio SAS.

• Struttura (pag. 63) – Fornisce l'accesso agli elementi strutturali del programma, registro, elenco oHTML attualmente selezionato.

L'output del registro per un server è cumulativo e mostra le informazioni e gli errori derivanti da ciascunprogramma che è stato eseguito durante la sessione corrente.

L'elenco è cumulativo per un server e mostra i risultati di ogni programma che è stato eseguito durantela sessione corrente.

L'output HTML e PDF mostrano risultati dei programmi, ma nessuno dei due è cumulativo.

È possibile riavviare il server WPS senza riavviare Workbench (consultare Riavviare il server (pag.36) per maggiori informazioni). Cancella l'output del registro, elenco ed HTML, ed elimina i riferimentidella raccolta di file temporanei, set di dati e variabili della macro configurate nel server.

Generazione dei set di datiSe il programma produce o modifica un set di dati, è possibile visualizzarlo dalla raccolta pertinente inEsplora server WPS.

Ad esempio, ogni volta che si esegue il seguente programma di esempio, il set di dati associato vieneaggiornato nella raccolta Work:

DATA longrun; DO I = 1 TO 5000000000; OUTPUT; END;RUN;

Guida dell’utente di WorkbenchVersione 4.1

106

Per visualizzare i dettagli associati al set di dati, nella vista Esplora server WPS, espandere la raccoltaWork nel server Locale, fare clic con il pulsante destro del mouse nel nome del set di dati e fare clic suProprietà nel menu di scelta rapida.

Per maggiori informazioni sull'uso di raccolte in un server, consultare Raccolte e set di dati (pag. 81).Per dettagli sulla visualizzazione e modifica dei set di dati, consultare Visualizzatore set di dati (pag.97).

RegistriL'output del registro contiene un record degli eventi che si verificano durante l'esecuzione di unprogramma in linguaggio SAS.

Il file di registro contiene un registro di attività per la sessione del server WPS corrente. Se piùprogrammi vengono eseguiti nello stesso server durante un'unica sessione del server, l'output per tutti iprogrammi viene accodato allo stesso registro.

Per ripristinare il registro, fare clic sul menu WPS, selezionare Cancella registro, quindi fare clic suServer Locale (o il nome del server in cui sono stati eseguiti i programmi).

Se si dispone di più di un server WPS registrato in Workbench, ciascun server WPS crea il proprio filedi registro.

Visualizzare il registroPer visualizzare le informazioni contenute nel registro:

1. Nella vista Esplora output, fare clic sulla freccia accanto al server richiesto in modo da visualizzarei file di output per quel server.

2. Fare doppio clic su Registro per aprire il file di registro nella vista Editor.

Se si eseguono diversi programmi, le informazioni del registro per tutti i programmi vengonoconcatenati in un unico file di registro. Per trovare le informazioni, è possibile utilizzare lavisualizzazione Struttura per spostare il registro, consultare la visualizzazione Struttura (pag. 63) permaggiori informazioni.

Salvare il registro in un filePer salvare il registro in un file:

1. Nella vista Esplora output, fare clic sulla freccia accanto al server richiesto in modo da visualizzarei file di output per quel server.

Guida dell’utente di WorkbenchVersione 4.1

107

2. Fare doppio clic su Registro per aprire il file di registro nella vista Editor.3. Fare clic sul menu File, quindi fare clic su Salva con nome. Utilizzare la finestra di dialogo Salva

con nome per salvare il file nel percorso richiesto.

Stampare il registroPer stampare il registro per un server specifico:

1. Nella vista Esplora output, fare clic sulla freccia accanto al server richiesto in modo da visualizzarei file di output per quel server.

2. Fare doppio clic su Registro per aprire il file di registro nella vista Editor.3. Fare clic sul menu File, quindi fare clic su Stampa. Utilizzare la finestra di dialogo Stampa per

inviare il registro alla stampante richiesta.

Preferenze per la colorazione del registroÈ possibile controllare le preferenze visive per le voci (errori, note, avvisi e così via) visualizzate in unfile di registro tramite la pagina Colorazione sintassi registro della finestra Preferenze.

Per ogni tipo di voce, è possibile specificare gli attributi per Colore, Colore di sfondo e se la vocedeve essere visualizzata in Grassetto.

Gestione dell'output ODSUna volta eseguito un programma che produce output utilizzando l'ODS (Output Delivery System) diWorkbench, è possibile visualizzarlo nella vista Esplora risultati.

È possibile gestire automaticamente le destinazioni ODS e il percorso dell'output generato tramiteWorkbench oppure controllarli attraverso istruzioni nel programma in linguaggio SAS.

Gestisci automaticamente destinazioni ODSLe preferenze per controllare le destinazioni ODS create automaticamente quando si esegue unprogramma in linguaggio SAS in Workbench. Per generare le destinazioni ODS in un programma chenon è in esecuzione in Workbench, sarà necessario aggiungere al programma le necessarie istruzioniper la creazione di ODS.

Guida dell’utente di WorkbenchVersione 4.1

108

Gestisci automaticamente i tipi di risultatoFare clic su Sì per creare destinazioni ODS per ciascuno dei tipi di risultati selezionati. Fare clicsu No per gestire l'output all'interno del programma in linguaggio SAS.

Tipi di risultatoSelezionare la destinazione ODS da creare automaticamente. Workbench crea un filetemporaneo per ogni tipo di destinazione per ciascuna esecuzione del programma in linguaggioSAS. Quando viene eseguito un diverso programma o lo stesso programma viene eseguitonuovamente, vengono creati nuovi file temporanei.

Mostra codice inserito generato nel registroSelezionare per mostrare il codice creato automaticamente per ogni destinazione ODSnell'output del registro.

ElencoQuesta sezione della guida contempla l'elenco dei risultati.

Preferenze per la colorazione dell'elencoLe preferenze che è possibile impostare, riguardanti le diverse voci contenute nei risultati dell'elenco, sitrovano in Finestra ➤ Preferenze ➤ WPS ➤ Colorazione sintassi elenco:

Per ogni tipo diverso di voce contenuta in un elenco, è possibile specificare gli attributi per Colore,Colore di sfondo e se o meno la voce deve essere visualizzata in Grassetto.

Visualizzare l'elencoPer visualizzare l'elenco:

1. Assicurarsi di avere Esplora output aperto (Finestra ➤ Mostra vista  ➤  Esplora output).

2. Se è presente più di un server, aprire il nodo server richiesto per visualizzare l'output associato.3. Fare doppio clic sul nodo Elenco oppure fare clic con il pulsante destro del mouse su di esso e

selezionare Apri dal menu di scelta rapida.

Si apre l'elenco e diventa attivo.

Se sono state realizzate diverse esecuzioni, l'elenco precedente verrà concatenato ai risultatipreesistenti. Se si desidera cancellare l'output, per garantire che alla prossima esecuzione di unprogramma, l'elenco solo contiene i risultati per quell'esecuzione, si può procedere secondo una delleseguenti opzioni:

Guida dell’utente di WorkbenchVersione 4.1

109

• Cancellazione dell'output dei risultati (pag. 112) (che cancellerà anche eventuali OutputHTML (pag. 110)).

• Riavviare il server (pag. 36) (che cancellerà il registro e tutti i risultati, i set di dati, la raccolta ei Fileref).

Esplorazione dell'elencoSe, tuttavia, sono stati eseguiti diversi programmi o diverse istanze dello stesso programma, e i risultatinon sono stati cancellati dal server specifico tramite Cancellazione dell'output dei risultati (pag.112) o Riavviare il server (pag. 36), allora l'elenco precedente sarà aggiunto al file di elencopreesistente in ordine di esecuzione.

Per esplorare l'output contenuto nel file di elenco:

1. Aprire i risultati secondo Visualizzare l'elenco (pag. 108).2. Assicurarsi di avere la vista Struttura (pag. 63) aperta (Finestra ➤ Mostra vista  ➤ 

Struttura).3. In questa vista, verrà visualizzato l'output nidificato per i vari programmi, con i nodi per i diversi

elementi dell'output. Fare clic su un qualsiasi nodo per visualizzare la sezione corrispondente nel filedi elenco.

Salvataggio dell'elenco in un filePer salvare l'elenco in un file:

1. Assicurarsi di avere Esplora output aperto (Finestra ➤ Mostra vista  ➤  Esplora output).

2. Scegliere una delle opzioni seguenti:

• Fare clic con il pulsante destro del mouse sul nodo Elenco e, dal menu di scelta rapida,selezionare Salva con nome....

• Aprire l'elenco nell'editor (consultare Visualizzare l'elenco (pag. 108)), quindi fare clic con ilpulsante destro del mouse nella finestra dell'editor e selezionare Salva con nome….

• Aprire l'elenco nell'editor, quindi selezionare File ➤  Salva con nome... dal menu principale.

3. Utilizzare la finestra di dialogo Salva con nome per salvare il file nel percorso richiesto.

Stampa dell'elencoPer stampare l'elenco per un server specifico:

1. Assicurarsi di avere Esplora output aperto (Finestra ➤ Mostra vista  ➤  Esplora output).

Guida dell’utente di WorkbenchVersione 4.1

110

2. Se è presente più di un server, aprire il nodo server richiesto per visualizzare l'output associato.3. Scegliere una delle opzioni seguenti:

• Fare clic con il pulsante destro del mouse sul nodo Elenco e, dal menu di scelta rapida,selezionare Stampa risultati....

• Aprire l'elenco nell'editor (consultare Visualizzare l'elenco (pag. 108)), quindi fare clic conil pulsante destro del mouse nella finestra dell'editor per selezionare Stampa… o premereCTRL+P in Windows (Cmd-P in macOS).

• Aprire l'elenco nell'editor, quindi selezionare File ➤  Stampa... dal menu principale.

4. Utilizzare la finestra di dialogo Stampa per inviare i risultati alla stampante richiesta.

Output HTMLQuesta sezione della guida contempla l'output HTML dei risultati.

Visualizzazione dell'output HTMLPer visualizzare l'output HTML:

1. Assicurarsi di avere Esplora output aperto (Finestra ➤ Mostra vista  ➤  Esplora output).

2. Se è presente più di un server, aprire il nodo server richiesto per visualizzare l'output associato.3. Fare doppio clic sul nodo HTML oppure fare clic con il pulsante destro del mouse su di esso e

selezionare Apri dal menu di scelta rapida.

Si apre il file di output HTML e diventa attivo.

Esplorazione dell'output HTMLSe si è scelto far gestire automaticamente a Workbench l'output HTML (consultare Gestisciautomaticamente destinazioni ODS (pag. 107)), ogni esecuzione creerà un nuovo file HTML. Se,tuttavia, sono stati eseguiti diversi programmi o diverse istanze dello stesso programma, e i risultati nonsono stati cancellati dal server specifico tramite Cancellazione dell'output dei risultati (pag. 112)o Riavviare il server (pag. 36), allora l'output HTML precedente sarà ancora disponibile nella vista

Struttura (pag. 63).

Per esplorare l'output contenuto nel file HTML:

1. Aprire i risultati secondo Visualizzazione dell'output HTML (pag. 110).2. Assicurarsi di avere la vista Struttura (pag. 63) aperta (Finestra ➤ Mostra vista  ➤ 

Struttura).

Guida dell’utente di WorkbenchVersione 4.1

111

3. In questa vista, verrà visualizzato l'output nidificato per i vari programmi, con i nodi per i diversielementi dell'output. Fare clic su un qualsiasi nodo per visualizzare la sezione corrispondentenell'output HTML.

Stampa dell'output HTMLPer stampare l'output HTML:

1. Assicurarsi di avere Esplora output aperto (Finestra ➤ Mostra vista  ➤  Esplora output).

2. Se è presente più di un server, aprire il nodo server richiesto per visualizzare l'output associato.3. Scegliere una delle opzioni seguenti:

• Fare clic con il pulsante destro del mouse sul nodo HTML e, dal menu di scelta rapida,selezionare Stampa risultati....

• Aprire il file HTML nell'editor (consultare Visualizzazione dell'output HTML (pag. 110)), quindifare clic con il pulsante destro del mouse nella finestra dell'editor per selezionare Stampa…o premere CTRL+P in Windows (Cmd-P in macOS).

• Aprire il file HTML nell'editor, quindi selezionare File ➤  Stampa... dal menu principale.

4. Utilizzare la finestra di dialogo Stampa per inviare i risultati alla stampante richiesta.

Nota:Si crea un singolo file di output HTML per ciascuna esecuzione in Workbench. È possibile, tuttavia, solostampare l'output HTML di una esecuzione alla volta.

Output PDFQuesta sezione della guida contempla l'output PDF dei risultati.

Per configurare la gestione automatica dell'output PDF, consultare Gestisci automaticamentedestinazioni ODS (pag. 107).

Le impostazioni predefinite per l'output PDF sono specificate nel file wps.cfg (consultare File diconfigurazione (pag. 124)) e sono come riportate di seguito:

• -BOTTOMMARGIN 1cm

• -LEFTMARGIN 1cm

• -RIGHTMARGIN 1cm

• -TOPMARGIN 1cm

• -ORIENTATION portrait

Guida dell’utente di WorkbenchVersione 4.1

112

La PAPERSIZE viene determinata automaticamente mediante le impostazioni locali di WPS Workbench(consultare Impostazioni di LOCALE e ENCODING del server WPS (pag. 26)). Si può ripristinareutilizzando l'output non gestito (vedere in basso).

L'opzione startpage che determina se o meno l'output da ogni PROC comincia in una nuova pagina,non è configurabile all'interno di WPS Workbench. Viene inizialmente impostato su STARTPAGE=yesnel software ODS, indicando che ogni PROC inizia in una nuova pagina. È possibile anche reimpostarequesta opzione utilizzando l'output non gestito (vedere in basso).

L'output non gestito si crea immettendo il codice direttamente nei programmi, secondo l'esempioriportato di seguito:

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;

Nota:Le parti pertinenti del codice si possono anche usare come iniezioni di codice WPS (pag. 74).

Cancellazione dell'output dei risultati1. Per salvare l'output prima di cancellarlo, salvare il PDF in un altro percorso, se è stata utilizzata la

destinazione PDF, o procedere come in Salvataggio dell'elenco in un file (pag. 109).2. Cancellare i risultati dell'output per il server richiesto, scegliendo una delle opzioni seguenti:

• Dal menu principale, selezionare WPS ➤   ➤  Cancella risultati ➤  Server locale (o utilizzare ilnome del server WPS remoto al posto di Server locale).

• Utilizzare la scelta rapida da tastiera CTRL + ALT + O per rimuovere i risultati dal serverpredefinito.

Nota:Se si dispone di più di un server WPS registrato, l'azione precedente cancellerà i risultati per ilServer WPS predefinito (pag. 25). In caso di dubbi su quale sia il server predefinito, utilizzarela descrizione comando per il pulsante della barra degli strumenti in modo da mostrare qualirisultati del server verrà cancellato.

• Dalla barra degli strumenti, fare clic su per cancellare i risultati dal server predefinito oppurefare clic sul menu a discesa accanto a questo pulsante per selezionare un server nonpredefinito.

Guida dell’utente di WorkbenchVersione 4.1

113

• Assicurarsi di avere Esplora output aperto (Finestra ➤ Mostra vista  ➤  Esploraoutput), fare clic con il pulsante destro del mouse sull'elenco, sull'output HTML o sull'output PDF per il server richiesto e, dal menu di scelta rapida, selezionare Cancella tutti irisultati.

Tutti gli output ora saranno vuoti.

Nota:Gli effetti di questa opzione sono diversi dal Riavviare il server (pag. 36) in quanto si salva il contestodell'operazione in corso e non si perde il lavoro temporaneo.

Guida dell’utente di WorkbenchVersione 4.1

114

Funzioni di modifica basatesu testoÈ possibile utilizzare le funzioni con l'Editor SAS (pag. 115) per assistere l'utente durante lascrittura e la modifica di programmi e altri file di progetto. Le stesse funzioni sono disponibili nell'Editordi testo (pag. 116), a eccezione della Codifica con colori degli elementi del linguaggio. Questefunzioni non sono disponibili quando si gestiscono i file tramite la vista Esplora file.

Bordi sinistriI bordi sinistri vengono utilizzati per visualizzare diverse funzionalità:

• Nel bordo grigio sinistro più esterno, verranno visualizzate le annotazioni.• Nel bordo bianco sinistro più interno, verranno visualizzati i controlli Espandi e Comprimi per i

blocchi dei relativi elementi del linguaggio. Il bordo bianco viene anche utilizzato per visualizzare gliindicatori di differenza rapida.

AnnotazioniComprendono tutto ciò che viene visualizzato nel bordo grigio sinistro più esterno di un file:

• Ancoraggi segnalibri (pag. 61)

• Indicatori di attività (pag. 62)

• Risultati della ricerca

Indicatori di differenza rapidaUn indicatore di differenza rapida nel bordo bianco sinistro più interno di un programma mostra chequalcosa è cambiato in quella riga di codice dall'ultimo salvataggio:

• Indica che una modifica è stata apportata alla riga di codice.

Se si passa il puntatore del mouse sopra questo blocco colorato, una finestra popup mostrerà ilcodice così com'era prima della modifica.

• Indica che c'è una nuova riga di codice aggiuntiva.• Indica la posizione in cui è stata eliminata una o più righe di codice.

Quando si salva un programma, gli indicatori di differenza rapida saranno cancellati dal margine.

Guida dell’utente di WorkbenchVersione 4.1

115

Esplorazione di annotazioni e indicatori di differenza rapidaÈ possibile esplorare le annotazioni in un singolo programma utilizzando le opzioni del menu Esplora.L'opzione Successiva passa all'annotazione successiva, l'opzione Precedente passa all'annotazioneprecedente.

Inoltre, è possibile utilizzare Annotazione successiva e Annotazione precedente nella barraprincipale dei pulsanti di Workbench per passare alle annotazioni e agli indicatori di differenza rapida.

Preferenze del layoutSono definiti dall'utente i controlli dello schermo per un programma, inclusa la riga corrente, i colori diprimo e secondo piano, e se visualizzare i numeri di riga. Consultare Preferenze dell'Editor di testo(pag. 117) per maggiori dettagli.

Codifica con colori degli elementi del linguaggioÈ possibile controllare i colori utilizzati per visualizzare gli elementi del linguaggio in un programmatramite le Preferenze. Consultare Colorazione della sintassi di WPS (pag. 75) per maggioriinformazioni.

Uso di editorIn qualsiasi prospettiva di Workbench che si utilizza, la finestra Editor viene sempre visualizzata inmodo da poter continuare a scrivere e modificare i file. Questa sezione descrive i vari modi di aprire ifile nella finestra Editor con i diversi editor.

Solo un file può essere attivo in qualunque momento. Questo è il file che è attivo attualmente nellafinestra Editor.

È possibile aprire programmi tramite la vista Esplora progetti o Esplora file. La vista Esplora progettioffre più controllo della vista Esplora file, che determina automaticamente l'editor più idoneo in baseall'estensione del nome del file che viene aperto.

La modifica dei file nei progetti consente di utilizzare la cronologia locale per aiutare a gestire lemodifiche. Consultare Cronologia locale (pag. 43) per maggiori informazioni

Editor SASLa vista Editor SAS fornisce funzionalità idonee per la modifica di programmi in linguaggio SAS, comela colorazione della sintassi.

I programmi si possono aprire tramite un progetto o direttamente da uno dei file system disponibili. Inquesto editor, è possibile aprire solo i file con un'estensione .wps o .sas.

Guida dell’utente di WorkbenchVersione 4.1

116

Per aprire un programma nella vista Editor SAS:

1. Fare clic sul menu Finestra, fare clic su Mostra vista, quindi fare clic su Esplora progetti.

Se si usa la vista Esplora file, fare clic sul menu Finestra, fare clic su Mostra vista, quindi fare clicsu Esplora file.

2. Passare al programma che si desidera aprire e fare doppio clic sul nome del programma.

Editor di testoWorkbench dispone di una vista Editor di testo di base. È possibile aprire un programma con questoeditor, ma il contenuto verrà trattato come un file di testo normale.

Per aprire un file nella vista Editor di testo:

1. Fare clic sul menu Finestra, fare clic su Mostra vista, quindi fare clic su Esplora progetti.

Se si usa la vista Esplora file, fare clic sul menu Finestra, fare clic su Mostra vista, quindi fare clicsu Esplora file.

2. Passare al file che si desidera aprire. Se il file è un file di testo, fare solo doppio clic su di esso.Altrimenti, fare clic con il pulsante destro del mouse sul file e, dal menu di scelta rapida, selezionareApri con ➤  Editor di testo.

Editor di sistemaSe un file ha un'estensione associata ad un'applicazione installata nel computer (per esempio, .docpotrebbe essere associato a Microsoft Word), l'Editor di sistema avvierà quell'applicazione con il file inuna nuova finestra all'esterno di Workbench.

Per aprire un file con l'Editor di sistema:

1. Fare clic sul menu Finestra, fare clic su Mostra vista, quindi fare clic su Esplora progetti.

Se si usa la vista Esplora file, fare clic sul menu Finestra, fare clic su Mostra vista, quindi fare clicsu Esplora file.

2. Passare al programma che si desidera aprire e fare doppio clic sul nome del programma.

Editor internoWorkbench supporta la modifica dei documenti OLE (Object Linking and Embedding). Per esempio, sesi dispone di un documento Microsoft Word nel progetto e si utilizza Editor interno, il documento Wordsi aprirà nell'Editor (pag. 60) di Workbench, con le opzioni del menu a discesa di Microsoft Wordintegrate nella barra dei menu della vista.

Guida dell’utente di WorkbenchVersione 4.1

117

Per aprire un file con l'Editor interno:

1. Fare clic sul menu Finestra, fare clic su Mostra vista, quindi fare clic su Esplora progetti.2. Fare clic con il pulsante destro del mouse sul file richiesto, selezionare Apri con, quindi fare clic su

Editor interno nel menu di scelta rapida.

Se il file dispone di un editor OLE associato, il file viene aperto in Editor interno nella vista Editor esono disponibili i menu e le opzioni associati all'applicazione collegata.

Preferenze dell'Editor di testoÈ possibile controllare le preferenze dell'editor di testo tramite la pagina Editor di testo della finestraPreferenze:

1. Fare clic sul menu Finestra, quindi fare clic su Preferenze.2. Nella finestra Preferenze, espandere il gruppo Generale, espandere il gruppo Editor e selezionare

il gruppo Editor di testo.

È possibile utilizzare le preferenze per determinare come i programmi vengano visualizzati nell'editordel linguaggio SAS e l'editor di testo. Per esempio, per impostare il colore di sfondo, in Opzioni coloredell'aspetto, selezionare Colore di sfondo, cancellare Valore predefinito del sistema, quindiselezionare il Colore richiesto.

Tali preferenze si applicano solo ai file aperti nella vista Esplora progetti.

Alcune delle Preferenze che è possibile configurare comprendono:

• Dimensione cronologia annullamenti – Il numero di operazioni che è possibile annullare.• Larghezza tabulazione visualizzata – la larghezza della tabulazion utilizzata nei file• Mostra numeri di riga – se o meno i numeri di riga vengono visualizzati nel margine• Colori – riga corrente, primo piano, sfondo e così via.

Chiusura dei fileQualsiasi file aperto nella vista Editor ha una scheda etichettata con il nome del file. Per interromperela visualizzazione del file nella vista Editor, fare clic sul menu File, quindi fare clic su Chiudi. Inalternativa, fare clic su Chiudi nella scheda.

Guida dell’utente di WorkbenchVersione 4.1

118

Spostarsi al percorso specifico di unprogettoÈ possibile passare ad un percorso specifico in un file di progetto:

Per passare ad un percorso con segnalibro:

1. Aprire la vista Segnalibri (Finestra ➤ Mostra vista  ➤  Segnalibri).

2. Fare doppio clic sulla descrizione del segnalibro richiesto, oppure fare clic con il pulsante destro delmouse su di essa, e dal menu di scelta rapida, selezionare Vai a.

3. Il file pertinente verrà quindi aperto (se era chiuso) e la riga con il segnalibro verrà evidenziata(oppure la prima riga del file se l'intero file è stato contrassegnato con il segnalibro).

Per passare ad un'attività:

1. Aprire la vista Attività (Finestra ➤ Mostra vista  ➤  Attività).

2. Fare doppio clic sulla descrizione dell'attività richiesta, oppure fare clic con il pulsante destro delmouse su di essa, e dal menu di scelta rapida, selezionare Vai a.

3. Il file pertinente verrà quindi aperto (se era chiuso) e verrà evidenziata la riga contenente l'attività.

Per passare ad un numero di riga specifico:

1. Selezionare Esplora ➤  Vai alla riga....

2. Immettere il numero richiesto nella finestra di dialogo Vai alla riga.3. Premere INVIO sulla tastiera o fare clic su OK, per completare l'operazione e chiudere la finestra di

dialogo.

Per passare all'ultima modifica:

1. Selezionare Percorso ultima modifica dalla barra degli strumenti o dal menu Esplora.

Verrà aperto il file attinente (se era chiuso), verrà evidenziata l'ultima riga modificata e il cursoreverrà collocato alla fine dell'ultima parte del testo modificata.

Esplorazione tra più file di progettoSi può avere il maggior numero desiderato di progetti aperti in Workbench e ognuno di questi progettipuò contenere qualsiasi numero di programmi.

È possibile aprire qualsiasi numero di programmi e altri file da diversi progetti in Editor (pag. 60). Perogni programma aperto, viene visualizzata una scheda corrispondente. Un programma aperto puòessere attivo nella finestra dell'Editor, facendo clic sulla relativa scheda.

Guida dell’utente di WorkbenchVersione 4.1

119

Spostamento tra programmiLe opzioni del menu principale Esplora ➤  Indietro e Esplora ➤  Avanti (o e nella barradegli strumenti) sono simili ai pulsanti Indietro e Avanti di un browser Web. Diversamente da unbrowser Web, tuttavia, quando si chiude e si riapre WPS Workbench, rimangono ancora le informazionidi esplorazione.

• Indietro si sposta alla risorsa precedente visualizzata nella finestra dell'Editor.

• Avanti visualizza il programma che era attivo prima della selezione del comando Indietroprecedente.

Ricerca e sostituzioneÈ possibile trovare qualsiasi stringa di testo in un programma aperto, come riportato di seguito:

1. Assicurarsi che il programma da ricercare sia aperto in Esplora file (Finestra ➤ Mostra vista ➤  Esplora file).

2. Visualizzare la finestra di dialogo Trova/Sostituisci, selezionando Modifica ➤ Trova/Sostituisci...dal menu oppure premendo CTRL + F sulla tastiera.

Viene visualizzata la finestra di dialogo Trova/Sostituisci che consente di specificare il termine daricercare e, se necessario, il termine con cui si deve sostituire.

Nota:L'impostazione predefinita Ambito è Tutto, stando a indicare che si ricerca l'intero file (senecessario, si può modificare su Righe selezionate). Le altre opzioni sono quelle che ci siaspetterebbe di trovare in qualsiasi finestra di dialogo di ricerca e non hanno bisogno di spiegazioni.

3. Fare clic su Trova per trovare la prima istanza della parola e poi procedere, se necessario, facendoclic su Trova per spostarsi su ogni nuova istanza della stringa di testo.

Nota:Se si seleziona Chiudi per chiudere la finestra di dialogo, la stringa viene memorizzata, eselezionando Modifica ➤ Trova successivo e Modifica ➤ Trova precedente condurrà la stessaricerca, in avanti e indietro, senza riaprire la finestra di dialogo.

Annullamento e ripetizione dellemodificheEsiste una funzione di più annullamenti per le modifiche ai file di progetto, come riportato di seguito:

Guida dell’utente di WorkbenchVersione 4.1

120

1. Selezionare Modifica ➤  Annulla dal menu o premere CTRL + Z sulla tastiera.

L'ultima modifica apportata viene annullata.2. Ripetere il punto in alto per ogni modifica precedente che si desidera annullare.

Nota:Il numero di annullamenti che è possibile eseguire, è determinato da Dimensione cronologiaannullamenti nelle Preferenze dell'Editor di testo (pag. 117).

Nota:È possibile anche ripetere eventuali modifiche annullate in modo incrementale, selezionandoModifica ➤  Ripeti dal menu o premendo CTRL + Y sulla tastiera, il numero di volte richiesto.

Guida dell’utente di WorkbenchVersione 4.1

121

PreferenzeVi sono molte impostazioni utente, controlli e valori predefiniti che è possibile controllare tramite lafinestra Preferenze . Per aprire la finestra, fare clic sul menu Finestra, quindi fare clic su Preferenze.

Le preferenze che non sono descritte nella presente guida, si possono cercare nella Guida dell'utentedi Workbench specifica di Eclipse.

La finestra Preferenze dispone di una funzione di filtro che può assistere l'utente per quanto riguardala ricerca rapida delle pagine. Una volta aperta la finestra, è possibile visualizzare il filtro nella partesuperiore dell'elenco di preferenze.

Guida dell’utente di WorkbenchVersione 4.1

122

Preferenze generaliLa pagina Generale della finestra Preferenze contiene i controlli che influiscono sugli aspetti generali diWPS Workbench.

Esegui sempre in backgroundSpecifica che le attività a lunga esecuzione da eseguire senza visualizzare la finestraEsecuzione in corso. Ciò consente di continuare ad utilizzare Workbench per altre attività.

Mostra stato heapSe è selezionato, viene visualizzato un indicatore che mostra le informazioni sull'uso dellamemoria Java heap corrente, utilizzato dall'interfaccia Workbench. Questo indicatore vienevisualizzato nella parte inferiore della finestra a sinistra dello stato del server.Per aumentare lo spazio di archiviazione Java heap, modificare workbench.ini nella cartellaeclipse dell'installazione con, ad esempio, -vmargs -Xmx1024m. Imposta il valore massimodi Java heap di 1024 megabyte.

Intervallo di salvataggio di Workbench (in minuti)Specifica la frequenza del salvataggio automatico su disco dello stato di Workbench, inclusi ilayout delle prospettive. Impostare su 0 (zero) per disabilitare il salvataggio automatico.

Modalità di aperturaSpecifica il metodo utilizzato per aprire gli oggetti in Workbench.

• Doppio clic – per aprire un oggetto con un doppio clic e selezionare con un clic singolo.• Singolo clic (Seleziona sul testo a comparsa) – per aprire un oggetto con un solo clic e

selezionare passando il puntatore del mouse sulla risorsa.• Singolo clic (Apri quando si utilizzano i tasti di direzione) – per aprire un oggetto con un

solo clic e selezionare passando il puntatore del mouse sulla risorsa. Quando si utilizzano itasti di direzione per aprire un oggetto con un solo clic, la selezione di una risorsa con i tasti didirezione la aprirà automaticamente in un editor.

Cambiare le preferenze per i tasti discelta rapidaWorkbench offre mapping dei tasti di scelta rapida per i comandi più comunemente utilizzati. È possibilemodificare questi mapping o creare nuovi mapping.

Per cambiare il mapping di un tasto di scelta rapida:

1. Fare clic sul menu Finestra, quindi fare clic su Preferenze.2. Nella finestra Preferenze, espandere il gruppo Generale e selezionare Tasti.

Guida dell’utente di WorkbenchVersione 4.1

123

3. Digitare il nome del comando, per esempio Annulla modifiche nel filtro o selezionare il comandorichiesto nell'elenco.

4. Selezionare Associazione e digitare il tasto di scelta rapida, per esempio CTRL= 5.5. Se non vengono segnalati conflitti, fare clic su OK per salvare il nuovo mapping.

Per eliminare un'associazione, selezionare il comando richiesto e fare clic su Annulla bindingcomando.

Eseguire un backup delle preferenze diWorkbenchSalvare le preferenze correnti per mantenere le preferenze o per importarle in un'installazione diversadi Workbench.

Per salvare le preferenze in un file:

1. Fare clic sul menu File, quindi fare clic su Esporta.2. Nella finestra di dialogo Esporta, espandere il gruppo Generale e fare clic su Preferenze.3. Fare clic su Avanti e nella pagina Esporta preferenze, selezionare le preferenze richieste e

immettere un nome per il file delle preferenze.

Se si aggiorna un file preesistente, è possibile selezionare Sovrascrivi file preesistenti senzaavviso per evitare le finestre di dialogo di avviso durante l'esportazione.

4. Fare clic su Fine per creare il file di backup.

Importare le preferenze di WorkbenchImportare le preferenze salvate dal file ad un'installazione di Workbench.

Per importare le preferenze dal file:

1. Fare clic sul menu File, quindi fare clic su Importa.2. Nella finestra di dialogo Importa, espandere il gruppo Generale e fare clic su Preferenze.3. Fare clic su Avanti e nella pagina Importa preferenze, selezionare il file delle preferenze richieste e

scegliere il gruppo di preferenze da importare, quindi immettere un nome file per le preferenze.4. Fare clic su Fine per importare le preferenze.

Guida dell’utente di WorkbenchVersione 4.1

124

File di configurazioneI file di configurazione sono file che incorporano le opzioni di sistema che controllano l'ambiente di WPSiniziale. I file di configurazione vengono utilizzati durante l'inizializzazione di WPS, quando si esegueWPS dalla riga di comando e anche quando si utilizza Workbench.

È possibile aprire un file di configurazione come un file di testo di base per aggiungere, rimuovere ocambiare le opzioni di sistema in modo da adattarsi alle proprie esigenze.

Esiste un file di configurazione di base che è incluso con l'installazione di WPS, denominato wps.cfge si trova nella directory dove è installato WPS. Si consiglia di non alterare questo file e di utilizzare unodei meccanismi di sostituzione di seguito, se diventa necessario apportare delle modifiche.

Nota:Durante l'inizializzazione di WPS, è possibile elaborare diversi file di configurazione, ognuno dei qualipotrebbe impostare alcune delle stesse opzioni. Se un'opzione viene impostata in più di un file, l'ultimoelaborato avrà la precedenza. Le opzioni impostate nella riga di comando, o le opzioni impostate nelpannello di configurazione Opzioni di avvio per un server, sostituiranno le impostazioni impostate neifile di configurazione.

Procedura di inizializzazione di WPS per WindowsQuando si richiama WPS, si verifica la seguente procedura di inizializzazione:

1. La variabile di ambiente del sistema operativo WPS_SYS_CONFIG viene valutata e, se esiste,viene elaborato il file di configurazione specificato. L'elaborazione di questo file non influisce sulcaricamento dei file di configurazione predefiniti.

2. Vengono elaborati i file specificati tramite l'opzione -config nella riga di comando o nelle opzioni diavvio per un server.

Se i file di configurazione vengono specificati tramite l'opzione -config, i file di configurazionepredefiniti non vengono caricati e al suo posto viene elaborato WPS_USER_CONFIG.

Prestare attenzione quando si sostituisce l'elaborazione del file di configurazione predefinito,soprattutto il caricamento del file wps.cfg. Vi sono molte opzioni necessarie nel file wps.cfgdi base. Se si utilizza l'opzione -config, si consiglia di realizzare una copia del file wps.cfg dibase e modificarlo per adattarlo, oppure di assicurarsi di includere il wps.cfg di base nel file diconfigurazione personalizzato e poi sostituire eventuali impostazioni necessarie, per esempio:

-set wpshome 'somewhere'-config !wpshome/wps.cfg/* And now set any options you want */

3. I file di configurazione predefiniti vengono elaborati nell'ordine seguente:

a. wps.cfg nella directory di installazione di WPSb. Documenti/My WPS Files/.wps.cfg

Guida dell’utente di WorkbenchVersione 4.1

125

c. Documenti/My WPS Files/wps.cfg

d. Documenti/My WPS Files/.wpsv3.cfge. Documenti/My WPS Files/wpsv3.cfg

f. wps.cfg nella directory correnteg. wpsv3.cfg nella directory corrente

4. La variabile di ambiente WPS_SYS_CONFIG viene valutata e, se esiste, viene elaborato il file diconfigurazione specificato.

5. La variabile di ambiente WPS_OPTIONS viene valutata e, se esiste, vengono elaborate eventualiopzioni specificate. La sintassi di questa variabile di ambiente è identica a quella delle opzionispecificate nella riga di comando.

6. Vengono elaborate le opzioni specificate nella riga di comando.

Procedura di inizializzazione di WPS per piattaforme UNIXQuando si richiama WPS, si verifica la seguente procedura di inizializzazione:

1. Vengono elaborati i file specificati tramite l'opzione -config nella riga di comando o nelle opzioni diavvio per il server.

Se i file di configurazione vengono caricati in questo modo, i file di configurazione predefiniti nonvengono caricati.

2. Vengono elaborate le variabili di ambiente WPS_OPTIONS e WPS_V3OPTIONS vengono valutate edeventuali opzioni -config contenute.

Se i file di configurazione vengono caricati in questo modo, i file di configurazione predefiniti nonvengono caricati.

Nota:Si ignora questo punto se l'opzione -NOCONFIG viene specificata nella riga di comando.

3. Le variabili di ambiente WPS_CONFIG e WPS_V3CONFIG vengono valutate e, se esistono, vengonoelaborati i file di configurazione specificati.

Se i file di configurazione vengono caricati in questo modo, i file di configurazione predefiniti nonvengono caricati.

Nota:Si ignora questo punto se l'opzione -NOCONFIG viene specificata nella riga di comando.

4. Se non è stato ancora caricato nessun file di configurazione, vengono caricati i file di configurazionepredefiniti nell'ordine seguente:

a. wps.cfg nella directory di installazione di WPSb. wps_local.cfg nella directory di installazione di WPS. È possibile modificare questo file in

modo che possa fornire sostituzioni di varie opzioni per siti specifici.c. .wps.cfg nella home directory

Guida dell’utente di WorkbenchVersione 4.1

126

d. wps.cfg nella home directorye. .wpsv3.cfg nella home directoryf. wpsv3.cfg nella home directoryg. wps.cfg nella directory correnteh. wpsv3.cfg nella directory corrente

5. La variabile di ambiente WPS_OPTIONS viene valutata e, se esiste, vengono elaborate eventualiopzioni specificate. La sintassi di questa variabile di ambiente è identica a quella delle opzionispecificate nella riga di comando.

6. La variabile di ambiente WPS_OPTIONS viene valutata e, se esiste, vengono elaborate eventualiopzioni specificate. La sintassi di questa variabile di ambiente è identica a quella delle opzionispecificate nella riga di comando.

7. Vengono elaborate le opzioni specificate nella riga di comando.

Esistono inoltre i file di configurazione "limitati" che verranno sempre elaborati. Non è possibilecambiare le opzioni in questi file tramite qualsiasi altro metodo. I file si basano sullo userid egroupid dell'utente. Per esempio, se l'utente è <utente> e il gruppo è <gruppo>, verranno elaboratii seguenti file di configurazione:

1. misc/rstropts/rwps.cfg nella directory di installazione di WPS2. misc/rstropts/groups/<gruppo>_rwps.cfg nella directory di installazione di WPS3. misc/rstropts/users/<utente>_rwps.cfg nella directory di installazione di WPS

Informazioni sulla procedura di avvioÈ possibile controllare quali file di configurazione sono stati elaborati, verificando l'opzione di sistemaCONFIG. Si può fare richiamando una istruzione PROC OPTIONS come riportato di seguito:

PROC OPTIONS OPTION=CONFIG;RUN;

Inoltre, è possibile impostare l'opzione di sistema VERBOSE nella riga di comando o nelle opzioni disistema per il server, e WPS poi genererà le informazioni nel normale output del registro, indicandoquali file di configurazione sono stati elaborati e quali opzioni di sistema sono state impostate.

Guida dell’utente di WorkbenchVersione 4.1

127

File AutoExecUn file AutoExec contenente istruzioni in linguaggio SAS o un programma che viene eseguitoautomaticamente all'avvio del server WPS o al riavvio di Workbench. È possibile utilizzare il file pernumerosi scopi, come l'impostazione di LIBNAMES comuni in modo che non sia necessario aggiungerlia ogni programma eseguito.

WindowsIl server WPS esegue automaticamente un file denominato autoexec.sas. Il server WPS ricerca il fileautoexec.sas nelle seguenti directory, nell'ordine mostrato:

1. La directory corrente2. Documenti nel profilo utente3. Percorsi specificati nella variabile di ambiente PATH4. La directory radice dell'unità, ad es. C:\5. La directory di installazione di WPS.

Altri sistemi operativiIl server WPS esegue automaticamente un file denominato autoexec.sas. Il server WPS ricerca il fileautoexec.sas nelle seguenti directory, nell'ordine mostrato:

1. La directory corrente2. La home directory ($HOME) dell'utente3. La directory di installazione di WPS.

Specificazione di un file diversoPer eseguire automaticamente un file diverso o un file non nella gerarchia della directory ricercata,impostare l'opzione del sistema AUTOEXEC in modo che punti al file (consultare File di configurazione(pag. 124)).

È possibile anche impostare l'opzione di sistema AUTOEXEC tramite Workbench:

1. Nella vista Esplora server WPS, fare clic con il pulsante destro del mouse sul nome del server efare clic su Proprietà dal menu di scelta rapida.

2. Nell'elenco Proprietà, fare doppio clic suAvvio, fare clic su Opzioni di sistema.3. Nel pannello Opzioni di sistema, fare clic su Aggiungi.4. Nel campo Nome, immettere AUTOEXEC e nel campo Valore, immettere il percorso nel file di

configurazione richiesto e fare clic su OK.5. Fare clic su OK nella finestra di dialogo Proprietà e verrà richiesto di riavviare il server.

Guida dell’utente di WorkbenchVersione 4.1

128

Consigli e suggerimenti diWPS

Configurazione di WPS• Utilizzare WPS Link per connettersi ad una soluzione di server remoto ed eseguire programmi in

linguaggio SAS (consultare Connettersi ad un server WPS remoto (pag. 52)).• È possibile modificare i caratteri di Workbench, l'aspetto dello sfondo o le associazioni di tasti

(consultare Preferenze (pag. 121)).• È possibile esportare e importare le preferenze (inclusi i modelli) tra le aree di lavoro.• È possibile utilizzare i file di configurazione per controllare le opzioni di sistema utilizzate

nell'ambiente di WPS (consultare File di configurazione (pag. 124)).• È possibile utilizzare un file AutoExec per configurare le istruzioni comuni LIBNAME e utilizzarle con

qualsiasi programma in esecuzione nel server WPS (consultare File AutoExec (pag. 127)).• È possibile definire più server nello stesso computer e distribuire programmi tra quei server

(consultare Definire un nuovo server WPS (pag. 56)).

Gestione dei file• Per visualizzare o creare un diverso gruppo di progetti, è possibile passare ad una diversa area di

lavoro (consultare Passaggio ad una diversa area di lavoro (pag. 46)).• È possibile ripristinare un file eliminato in Esplora progetti dalla cronologia locale del progetto

(consultare Ripristinare dalla cronologia locale (pag. 45)).• È possibile utilizzare Esplora progetti per confrontare e unire i file (consultare Confronto e unione

di più file (pag. 42)).• È possibile creare i collegamenti a directory in Esplora file per accedere ai file nel file system

dell'host (consultare Creare una nuova connessione host remoto (pag. 52)).

Esecuzione dei programmi in linguaggio SAS• È possibile specificare il codice da eseguire automaticamente prima e dopo ogni programma

(consultare Iniezione di codice WPS (pag. 74)).• È possibile creare modelli contenenti frammenti di codice che si possono riutilizzare (consultare

Immissione del codice in WPS tramite modelli (pag. 73)).• È possibile eseguire parte di un programma da Workbench (consultare Eseguire parte di un

programma (pag. 76)).

Guida dell’utente di WorkbenchVersione 4.1

129

• È possibile controllare se o meno le destinazioni ODS devono essere controllate automaticamentee, se è così, è necessario utilizzare i tipi specifici di output (consultare Gestisci automaticamentedestinazioni ODS (pag. 107)).

• È possibile impostare un percorso permanente per la raccolta WORK in modo da mantenere i set didati alla chiusura di Workbench (consultare Impostare il percorso WORK (pag. 81)).

Set di dati• È possibile modificare i set di dati dall'interno di Workbench, utilizzando la corretta modifica sensibile

al contesto e il riordinamento delle colonne.• È possibile esportare i set di dati come testo delimitato e a larghezza fissa, e anche come fogli di

calcolo Microsoft Excel.

Guida dell’utente di WorkbenchVersione 4.1

130

Risoluzione dei problemiSegue un elenco di possibili problemi e le modalità per risolverli:

Perché le icone sono disattivate in modo da non poter eseguire i programmi?

Le icone saranno disattivate se:

• Il server in cui i programmi sono in esecuzione non è stato concesso in licenza o è statodisinstallato. Consultare Server WPS (pag. 23) per maggiori informazioni.

• Il nome del file di programma aperto nella vista Editor non usa l'estensione del nome file.sas o .wps.

• Lo stato attivo del mouse si trova in una vista diversa dalla vista Editor.

Perché non vedo una finestra di dialogo che indica che non esiste alcun server predefinito a cuiinviare il programma?

Avviene di solito perché è stato rimosso il server WPS predefinito. Se si dispone di altri serverWPS definiti, selezionare uno di quelli come nuovo valore predefinito (consultare Server WPSpredefinito (pag. 25)). In alternativa, è possibile ripristinare il server WPS rimosso (consultareDefinire un nuovo server WPS (pag. 56)) e reimpostarlo come valore predefinito.

Perché i caratteri nei file non vengono visualizzati correttamente?

È probabile che sia un problema relativo alla codifica. È necessario seguire tutti i punti riportatiin Impostazioni di LOCALE e ENCODING del server WPS (pag. 26) e Codifica generale deifile di testo (pag. 27), quindi riavviare Workbench. Se sono stati importati dei file che vengonovisualizzati incorrettamente, potrebbe essere necessario reimportarli.

Perché non posso avviare Workbench?

Se Workbench di solito si avvia, ma poi produce errori, potrebbe essere che lo spazio su discosia insufficiente, danneggiando uno o più file nella directory .metadata dell'area di lavoro.Rinominare la cartella .metadati nella directory dell'area di lavoro danneggiata a qualcos'altro,riavviare WPS e selezionare di nuovo l'area di lavoro. Esplora progetti non contiene voci,ma il contenuto dei progetti e le ubicazioni rimangono inalterate. È possibile reimportareprogetti preesistenti se necessario. Consultare Importare un progetto (pag. 17) per maggioriinformazioni.

Come aumento la memoria di Java heap in caso di errori di Java Runtime?

È possibile impostare le opzioni Java -Xmx e -Xms per cambiare la quantità di memoriaheap disponibile per Java Runtime. Consultare Mostra stato heap (pag. 122) per maggioriinformazioni.

Guida dell’utente di WorkbenchVersione 4.1

131

Creazione di richieste disupporto tecnicoIl modo in cui si accede al supporto tecnico del software WPS dipende dal modo con cui si èacquistato il software. Se si è effettuato un acquisto standard del software WPS, si dispone di unalicenza con sottoscrizione annuale che darà diritto ad aggiornamenti gratuiti illimitati alle versionisuperiori, per tutti i dodici mesi, e al supporto gratuito per posta elettronica tramite l'[email protected] .

I maggiori clienti potrebbero disporre di ulteriori soluzioni di supporto. In questo caso, la gestione dellerichieste di supporto tecnico potrebbe essere svolta tramite uno o più superutenti nell'organizzazionedel cliente ed è necessario conoscere chi sono i superutenti che seguono i problemi di supporto.

A causa della natura complessa del linguaggio SAS, potrebbe essere necessaria l'interazioneprolungata tra World Programming e il cliente per individuare e risolvere il problema. Le risoluzioniai problemi potrebbero includere soluzioni consigliate o potrebbero richiedere l'aggiornamentodell'installazione del software WPS.

File di registro del server WPSPer alcuni tipi di problema, potrebbe essere necessario fornire i file di registro. Se il registro è apertoin Workbench, fare clic con il pulsante destro del mouse sulla vista e fare clic su Salva con nomedal menu di scelta rapida. Se il registro non è aperto, il file .log viene archiviato nella directory.metadata nell'area di lavoro attiva.

Poiché .metadata e .log cominciano con un punto, saranno normalmente nascoste e bisogneràassicurarsi di poter visualizzare questi tipi di file.

Guida dell’utente di WorkbenchVersione 4.1

132

Avvisi legaliCopyright © 2002–2019 World Programming Limited.

Tutti i diritti riservati. Le presenti informazioni sono riservate e soggette a diritto d'autore. Non èpossibile riprodurre o trasmettere nessuna parte di questa pubblicazione, in qualsiasi forma o conqualsiasi mezzo, elettronico o meccanico, inclusa la fotocopiatura, la registrazione o eventuali sistemi diarchiviazione e recupero dati.

Marchi commercialiWPS e World Programming sono marchi registrati o marchi commerciali di World Programming Limitednell'Unione europea e altri paesi. (r) o ® indica un marchio comunitario.

SAS e tutti gli altri nomi di prodotti o servizi di SAS Institute Inc. sono marchi registrati o marchicommerciali di SAS Institute Inc. negli Stati Uniti e in altri paesi. ® indica la registrazione negli USA.

Tutti gli altri marchi commerciali sono proprietà dei rispettivi titolari.

Avvisi generaliWorld Programming Limited non è associata in alcun modo a SAS Institute.

WPS non è SAS System.

Le frasi "SAS", "linguaggio SAS" e "linguaggio di SAS” utilizzate in questo documento si usano inriferimento al linguaggio di programmazione spesso denominato in uno dei suddetti modi.

Le frasi "programma", "programma SAS" e "programma in linguaggio SAS" utilizzate in questo sitoWeb si riferiscono a programmi scritti in linguaggio SAS, definiti anche "script", "script SAS" o "script inlinguaggio SAS".

Le frasi "IML", "linguaggio IML", "sintassi IML”, "Interactive Matrix Language" e "linguaggio di IML"utilizzate in questo documento si usano in riferimento al linguaggio di programmazione spessodenominato in uno dei suddetti modi.

WPS include software sviluppato da terzi. È possibile trovare maggiori informazioni nel file THANKS oacknowledgments.txt inclusi nell'installazione di WPS.