Manuale - Ita - Abap - Query - Sap r3 4 6 B

Abap - Query Sap R3 4.6.b

1/21

B C A B A P / 4 Q u e r y

R e l e a s e 4 . 6 B

I N D I C E 1 Introduzione ................................................................................................................................................... 2 2 DataBase Logico ............................................................................................................................................ 2

2.1 Come si crea un DataBase logico............................................................................................................ 2 2.1.1 Struttura............................................................................................................................................ 2 2.1.2 Programma di DataBase ................................................................................................................... 5 2.1.3 Testi di selezione .............................................................................................................................. 6

3 Gruppo Utenti ................................................................................................................................................. 6 3.1 Come si crea un Gruppo Utenti: .............................................................................................................. 6

4 Settori Specifici .............................................................................................................................................. 8 4.1 Come si crea un Settore Specifico .......................................................................................................... 8 4.1.1 Creazione di un Settore Specifico usando un DataBase logico.......................................................... 8 4.1.2 Creazione di un Settore Specifico senza DataBase logico................................................................. 9 4.2 Creazione dei Gruppi Specifici .............................................................................................................. 11 4.3 Campi e Tabelle Supplementari ............................................................................................................ 11

5 Assegnazione Settore Specifico ↔ Gruppo Utenti ........................................................................................ 14 6 Query ........................................................................................................................................................... 14

6.1 Come si crea una Query ....................................................................................................................... 14 6.2 Lista Standard....................................................................................................................................... 18 6.3 Statistica ............................................................................................................................................... 19 6.4 Classifica .............................................................................................................................................. 20

7 Area di Lavoro.............................................................................................................................................. 20 8 Trasporti ....................................................................................................................................................... 20


2/21

1 Introduzione Abap/4 Query è un’utility di SAP R/3 che permette di estrarre ed elaborare dati di DataBase e di visualizzarli in forma testuale e/o grafica senza ricorrere alla programmazione in ABAP/4. Abap/4 Query consiste di 3 componenti: • Query (Interrogazione ad un DataBase) • Settori Specifici (Insieme preselezionato di dati) • Gruppi Utenti (Insiemi di utenti con le stesse autorizzazioni di accesso ai Settori Specifici ed alle Query) I passi da seguire per la creazione di una Query sono i seguenti: 1. Eventuale creazione di un Database logico 2. Creazione di un Gruppo Utenti 3. Creazione di un Settore Specifico

3.1. Creazione di Gruppi Specifici 4. Assegnazione Settore Specifico ↔ Gruppo Utenti 5. Creazione Query A seconda del tipo di elaborazione di dati da effettuare nella Query, sono disponibili 3 tools distinti: • Lista Standard (Elenco di dati con totali e subtotali) • Statistica (Conteggio, media, percentuali) • Classifica

2 DataBase Logico Un DataBase logico è un insieme di tabelle i cui i dati sono tra loro collegati mediante relazioni definite tra le tabelle stesse. Un DataBase logico di SAP R/3 prevede solo relazioni di tipo gerarchico tra le tabelle: • Esiste un solo nodo radice • Ogni tabella può avere più tabelle-figlio • Ogni tabella-figlio deve avere solo una tabella-padre La struttura gerarchica definita tra le tabelle determina l’ordine di accesso ai dati, partendo dalla tabella del nodo radice e proseguendo lungo l’albero in tutte le tabelle-figlio. SAP R/3 realizza questo tipo di accesso ai dati mediante la creazione di un programma di DataBase. Il codice del programma è generato completamente dal sistema; il programmatore dovrà solo esplicitare i campi “chiavi-esterne” che realizzano le relazioni tra le tabelle.

2.1 Come si crea un DataBase logico Per creare un DataBase logico è necessario seguire da Abap/4 workbench il percorso

Sviluppo → Ambiente programmazione → DataBase logici ( o lanciare la transazione SE36 ) e seguire i seguenti passi: • Creazione della Struttura • Creazione delle Selezioni

• Creazione del Programma DataBase

2.1.1 Struttura La Struttura definisce il legame gerarchico logico tra le tabelle, determinando, quindi, il modo con cui il sistema accede ai dati. Dalla videata iniziale inserire il nome del DataBase logico, selezionare la voce Struttura e premere il tasto CREARE. Nella popup proposta inserire una breve definizione del DataBase nella casella Testo Breve, salvare ed inserire nella popup seguente la tabella che sarà il nodo al più alto livello (root node).

Figura 1


3/21

Figura 2

Ogni nodo può avere differenti rami. Per creare i nodi inferiori, selezionare dapprima il nodo radice, premere il tasto ‘ Inserire nodo ‘ ed inserire i nomi delle tabelle figlie.

Figura 3

Dopo aver inserito tutte le tabelle nell’albero, salvare e tornare alla videata iniziale (Back).


4/21

Selezioni La Selezione determina l’interfaccia utente dei report basati sul DataBase logico. Una Selezione non è altro che un Include in cui è possibile definire i parametri di selezione per tutte le tabelle dell’albero. Queste Selezioni verranno visualizzate tutte le volte che verrà eseguito un programma basato sul DataBase logico in questione. La creazione di parametri di selezione associati al DataBase logico non è obbligatoria per l’attivazione di quest’ultimo. Per creare le Selezioni, selezionare il radiobutton Selezioni e premere il tasto MODIFICARE.

Figura 4 Si apre in questo modo il programma DBxxxSEL ( dove xxx rappresenta il nome del DataBase ) nel quale vanno disasteriscate le righe di codice in cui inserire i nomi dei parametri di selezione ( Parameters o Select Options ).

Figura 5 Salvare, generare e uscire (tasto Back).


5/21

2.1.2 Programma di DataBase Il Programma di DataBase è costituito da una collezione di subroutines che leggono e selezionano i dati in base alla Struttura ed alle Selezioni e li correlano, rendendoli disponibili per i report basati sul DataBase logico stesso. Per creare un Programma di DataBase, selezionare il radiobutton Programma DB dalla videata principale e premere il tasto MODIFICARE.

Figura 6 Viene così creato il report SAPDBxxx, che realizza la scansione del DataBase logico associando i dati delle diverse tabelle secondo le relazioni definite nella struttura.

Figura 7

L’include DBxxxTOP racchiude le dichiarazioni delle tabelle di databese e di eventuali variabili o tabelle interne, mentre l’include DBxxxXXX raggruppa tante Include quante sono le tabelle di database definite nella Struttura : entrando in ciascuna di queste è necessario disasteriscare le righe di codice relative alle istruzioni SELECT, controllando che le condizioni di legame tra le tabelle siano effettivamente realizzate mediante le chiavi esterne.

Figura 8 Salvare, generare ed uscire (tasto Back).


6/21

2.1.3 Testi di selezione Se sono stati creati dei parametri di selezione, è possibile attribuire a questi una descrizione estesa per facilitare l’utente nella comprensione del significato della variabile. Per fare questo selezionare il radiobutton ‘Testi di selezione’ dalla videata principale e premere il tasto MODIFICARE.

Figura 9

Figura 10 Salvare, generare ed uscire (tasto Back).

3 Gruppo Utenti Un Gruppo Utenti riunisce un certo numero di utenze alle quali sono concesse determinate autorizzazioni per lavorare alle Queries ed ai Settori Specifici associati al gruppo in questione. Ogni membro di un Gruppo Utenti può eseguire qualsiasi query associata al gruppo utenti, però soltanto quei membri del Gruppo Utenti che possiedono l’abilitazione allo sviluppo di oggetti workbench ( a livello di profilo utente ) possono aggiornare, modificare o cancellare una Query o un Settore Specifico del gruppo utenti.

3.1 Come si crea un Gruppo Utenti: Da Abap/4 Workbench: • Scegli Utilities → SAP Query → Gruppi di

Utenti ( transazione SQ03 ) • Inserire nel campo Gruppo Utenti il nome

del gruppo • Cliccare sul pulsante CREARE • Inserire una descrizione del Gruppo Utenti

nel campo corrispondente e SALVARE . Per assegnare gli utenti al gruppo premere il tasto ‘Attribuire utenti e settori spec.’ sulla schermata iniziale ed inserire nella tabella Utenti gli User ID (è possibile scegliere da elenco gli utenti attraverso il percorso Parametrizzazione → con marcatura).

Figura 11


7/21

Verificare la correttezza dei passi eseguiti premendo Enter , poi Salvare e Uscire .

Figura 12 Un utente può essere contemporaneamente associato a più Gruppi Utente : per risalire a questa informazione inserire nell’omonimo campo il nome utente che si vuole controllare e premere il tasto Modificare .

Figura 13 Per inserire l’utente in ulteriori gruppi si deve flaggare la casella di spunta relativa ai gruppi interessati : togliendo il flag , l’utente viene invece rimosso dai gruppi utente in cui è presente.

Figura 14


8/21

4 Settori Specifici Lo scopo delle Queries è di presentare dati da una o più tabelle di DataBase sotto forma di elenchi. A seconda della complessità delle tabelle di DataBase, potrebbe non essere facile per l’utente selezionare correttamente i dati necessari. I Settori Specifici definiscono la base dati , cioè l’insieme delle tabelle di database da cui estrarre le informazioni. I Settori Specifici permettono non solo di restringere il numero di campi raggruppandoli in unità logiche opportune, ma consentono anche di definire campi ausiliari e di utilizzarli come campi di tabelle. Entro i Settori Specifici vengono creati i Gruppi Specifici, che permettono, a loro volta, un ulteriore raggruppamento dei campi.

4.1 Come si crea un Settore Specifico Da Abap/4 Workbench: • Scegli Utilities → SAP Query → Settori Specifici • Inserire nel campo Settori Specifici il nome del settore specifico • Scegliere CREARE

Figura 15 Inserire un titolo descrittivo per il Settore Specifico nel campo Definizione ed eventualmente il gruppo di autorizzazione.

Figura 16

A questo punto è necessario scegliere se creare il settore specifico : • associato ad un particolare DataBase Logico ; • estraendo i dati da una sola tabella di database ( Lettura Diretta ) ; • analizzando una serie di tabelle legate tra di loro ( Join Tabelle ) ; • utilizzando un file esterno come base dati ( Dataset Sequenziale ) .

4.1.1 Creazione di un Settore Specifico usando un DataBase logico Per selezionare il DataBase logico, è sufficiente cliccare sul matchcode e sceglierlo nell’elenco a disposizione.

Nel campo Versione videata di selezione è possibile indicare la versione della videata che si desidera utilizzare per le query tramite questo settore specifico. Se non viene effettuato alcun input, viene utilizzata la videata di selezione standard. La versione deve essere costituita da una sigla a tre caratteri e deve essere supportata dal data base logico (la selezione può essere fatta tramite matchcode).


9/21

Il tasto Visualizza mostra l’albero del DataBase logico selezionato.

Figura 17

Premere il pulsante Enter e nella videata successiva selezionare i campi desiderati ed associarli ad un Gruppo Specifico.

4.1.2 Creazione di un Settore Specifico senza DataBase logico Inserire il nome della tabella di radice alla quale verranno successivamente legate, mediante joins, altre tabelle di DataBase.

Spuntare la casella ‘Join Tabelle’ e premere il pulsante Enter.

Figura18

Nella schermata successiva viene presentata la lista dei campi della tabella di radice con la segnalazione di quelli chiave , importanti per la definizione dei collegamenti con le altre tabelle.

Figura19

Per inserire nuove tabelle premere sul tasto Inserire Tabella , nella pop-up successiva indicare la tabella da accodare e premere Enter. Il sistema propone automaticamente una condizione di aggancio basata sui campi chiavi delle tabelle allo scopo di garantire un rapporto 1: 1 tra le tabelle. Due campi possono essere tra loro collegati solo se sono compatibili , cioè sono definiti sul medesimo tipo dati ed hanno la medesima lunghezza in byte.


10/21

Figura 20

Se uno dei collegamenti proposti non è corretto e deve essere cancellato, selezionarecon il mouse la linea che definisce il collegamento, premere il tasto destro e scegliere la voce Eliminare condizione join.

Figura 21

Per creare un nuovo collegamento tra i campi di due tabelle, posizionare il cursore su uno dei due campi e, tenendo premuto il tasto sinistro del mouse, trascinarlo sul campo da collegare.

Figura 22

Una volta definite tutte le tabelle e le condizioni di collegamento necessarie, verificare la correttezza dei join premendo sul tasto Controllare e se non si verificano incosistenze passare, premendo Back , nella schermata di riepilogo della struttura gerarchica del settore specifico.

Figura 23


11/21

4.2 Creazione dei Gruppi Specifici Un Gruppo Specifico riunisce i campi delle tabelle selezionate in unità logiche. Operando una preselezione sui campi, permette, quindi, all’utente di accedere più rapidamente e semplicemente alle informazioni da elaborare. E’ possibile assegnare campi di differenti tabelle allo stesso Gruppo Specifico, e introdurre nuove tabelle e nuovi campi all’interno di tabelle preesistenti.

Per creare un Gruppo Specifico premere sul tasto dare un identificativo (due cifre) ed una descrizione al Gruppo Specifico e premere Invio.

Figura 24

In un Settore Specifico possono essere definiti più Gruppi Specifici. Per assegnare un campo ad un Gruppo Specifico, procedere come segue: • Selezionare il Gruppo Specifico (doppio click sul nome del gruppo) ; • Visualizzare i campi delle tabelle ( posizionare cursore sulla tabella e premere tasto F2 ) ; • Selezionare dalla tabella i campi desiderati .

Figura 25

4.3 Campi e Tabelle Supplementari E’ possibile ampliare la base dati inserendo all’interno del Settore Specifico delle Tabelle Supplementari : questa operazione risulta particolarmente utile quando il settore specifico è creato sulla base di un Database Logico perché consente di aumentare il numero di informazioni a disposizione senza dover modificare il Database Logico e tutti i Settori Specifici creati su di esso.


12/21

Per creare una tabella supplementare premere sul tasto Tabelle Alias : nella shermata successiva premere il tasto Creare (F5) ed inserire nel campo ‘Nome Tabella’ il nome della tabella di database e nel campo ‘Nome Alias’ una descrizione.

Figura 26

Per richiamare la tabella all’interno del settore specifico premer sul tasto Opzioni, nella finestra successiva selezionare l’icona Creare (F5). Indicare poi il nome della tabella di database, selezionare la voce ‘Tabella suppl.’ e confermare con Enter.

Figura 27

Indicare poi i campi da utilizzare per effettuare un accesso univoco sulla tabella supplementare : è necessario indicare come valorizzare ogni campo chiave della tabella alias al fine di poter abbinare ogni suo record con uno ed un solo record della tabella a cui è collegata.


13/21

Figura 28 I campi della tabella supplementare vengo visualizzati come estensione della tabella a cui sono agganciati.

Per inserire invece un Campo Supplementare all’interno di una tabella, premere sul tasto Opzioni e nella finestra successiva selezionare l’icona Creare (F5). Indicare poi il nome del campo da creare, selezionare la voce ‘Campo supplementare’ e confermare con Enter.

Figura 29

Figura 30


14/21

Inserire una descrizione per il significato e l’intestazione del campo, e definire poi il formato dei dati (tipo dati e lunghezza in byte). Per inserire la codifica in linguaggio ABAP, necessaria per definire come deve essere valorizzato il campo, premere sul tasto Editor (F6) e scrivere la parte di codice. Poi salvare e tornare nella schermata di visualizzazione della struttura del settore specifico.

Figura 31

Una volta completata la creazione, e dopo ogni eventuale modifica, è necessario controllare il Settore Specifico ( Settore Specifico à Controllare ) e se non ci sono errori o incosistenze si deve generare l’oggetto ( Settore Specifico à Generare ).

5 Assegnazione Settore Specifico ↔ Gruppo Utenti Si possono definire Queries soltanto per quei settori specifici assegnati a un determinato gruppo utenti. Per fare ciò, dalla schermata iniziale dei Settori Specifici (Figura 15) premendo il tasto ATTRIBUZIONE A GRUPPI DI UTENTI, è possibile selezionare i Gruppo Utenti ai quali associare il Settore Specifico selezionato.

Figura 32

6 Query Abap/4 Query è un tool che permette di creare “liste” muovendosi attraverso menu, non richiedendo, quindi, la scrittura di righe di codice. Tale codice viene generato automaticamente dal sistema durante la costruzione della query stessa.

6.1 Come si crea una Query Per creare una query è necessario specificare le seguenti informazioni, affinché il sistema possa generare il report: • Settore Specifico • Titolo e formato della lista • Selezione dei campi • Struttura del layout Per creare una query procedere come segue:

Da Abap/4 Workbench scegliere Utilities → SAP Query → Queries Scegliere il gruppo utenti al quale assegnare la nuova query attraverso il menu

Elaborare → Cambiare gruppo utenti. Inserire il nome della query e premere CREARE.


15/21

Figura 32 Selezionare il settore specifico che sarà utilizzato dalla query, e nella videata successiva assegnare il titolo e una breve descrizione alla query.

Figura 33

Nel box Formato Lista, il sistema propone il formato standard in cui viene visualizzata la lista generata. A meno che non si specifichi altrimenti, SAP adatta automaticamente l’output al video utilizzato. Il default è una lunghezza di pagina dinamica e 83 colonne. Una volta effettuate tutte le scelte all’interno della finestra, per passare alla videata successiva premere il pulsante VIDEATA SUCCESSIVA

Sulla videata Selezione Gruppi Specifici è possibile specificare da quali gruppi specifici selezionare i campi, su cui basare la

query, spuntando i relativi checkbox.


16/21

Figura 34 Nella videata successiva selezionare i campi che si utilizzeranno nella Query. E’ possibile assegnare uno short name ai campi selezionati, per utilizzare il valore contenuto in un’intestazione o per definire campi locali. Per fare questo è necessario attivare la colonna DEFINIZIONE BREVE dal menu Elaborare → Definizioni brevi → attivare/disattivare.

Figura 35 La definizione di un Campo Locale permette di generare, eslusivamente all’interno della query, nuove informazioni dai campi appartenenti ad un settore specifico. Per definire un campo locale selezionare

Elaborare → Campo locale → Creare. Nella finestra di definizione del campo introdurre una definizione breve, una definizione per il campo, l’intestazione ed inmdicare le caratteristiche tecniche del campo. ed indicare la norma del calcolo.


17/21

Figura 36

I campi locali risultano particolarmente utili come campi di calcolo per le statistiche. In questo caso bisogna indicare la norma di calcolo per valorizzare il campo e una eventuale condizione : solo se la condizione è soddisfatta il campo viene valorizzato secondo la formula definita. Cliccando sul tasto Calcolo Complesso compare una schermata nella quale è possibile definere una serie di condizioni e formule di calcolo secondo cui valorizzare il campo locale (Fig. 37 ) . Se invece si desidera utilizzare il campo locale come parametro di selezione dati, è necessario scegliere il radiobutton Input nella videata di selezione ed eventualmente flaggare l’omonima casella per renderne obbligatoria la valorizzazione.

Nella videata successiva è possibile scegliere i criteri di selezione richiesti durante l’esecuzione della query. Questi criteri vanno ad aggiungersi a quelli già associati al DataBase logico oppure a quelli aggiunti nel settore specifico.

Figura 37


18/21

Figura 38 Salvare la Query. A questo punto sono stati definiti i campi e le selezioni che verranno utilizzati dalla query. A seconda delle esigenze di elaborazione, sono disponibili tre strumenti: • Lista Standard • Statistica • Classifica

6.2 Lista Standard La Lista Standard visualizza i risultati della query sotto forma di elenco. Premendo il pulsante LISTA STANDARD si passa nella videata in cui viene definito il layout grafico della lista.

Figura 39

La videata è suddivisa in quattro parti : nel riquadro in alto a sinistra vengono evidenziati quali campi sono stati scelti come parametri di selezione e quali devono essere inseriti nella lista , il cui output viene rappresentato nel riquadro in alto a destra. La sequenza dei campi all’interno della lista dipende dalla sequenza di selezione fatta dall’utente. Nel riquadro in basso a sinistra vengono evidenziate le caratteristiche tecniche dell’elemento di volta in volta selezionato, mentre nel riquadro in basso a destra è possibile richiamare la funzione Help per avere chiarimenti su uno degli argomenti evidenziati.Per spostare e ridimensionare i campi della lista, cliccare sul campo e trascinarlo nella posizione desiderata , mentre per cancellare un campo dalla lista trascinarlo nel riquadro Cestino. Per inserire dei tratti di separazione tra i campi, utilizzare l'icona ‘Tratti di separazione’ trascinandola sulla riga della lista. Per inserire una nuova riga, trascinare la relativa icona su di una riga. Per modificare il colore di una riga lista o di un campo lista, trascinare l’icona del relativo colore sull’oggetto da modificare.


19/21

Figura 40 E’ possibile ordinare i dati secondo i valori di uno o più campi della lista. Per classificare un campo è necessario selezionarlo e trascinarlo all’interno del box ‘Campi di classificazione’ : nel riquadro in basso a sinistra compaiono le possibili opzioni (totali parziali sui campi numerici, intestazione di inizio gruppo, ordinamento crescente o descrescente,…) che possono essere richiamate ogni qual volta si verifichi un cambio del valore nel campo classificato.

Figura 41 Una volta impostate tutte le opzioni relative alla lista standard, salvare la query.

6.3 Statistica La Statistica permette di operare calcoli statistici. Si possono definire fino a 9 statistiche per ogni Query. Premendo il pulsante STATISTICA si accede ad una videata in cui si deve inserire il titolo della Statistica e le opzioni relative ai campi che si vogliono visualizzare.

Figura 42 Nella prima colonna da sinistra deve essere indicata la successione dei campi nella riga, mentre nella seconda la sequenza di classificazione dei dati. Per i campi numeri ( importi e quantità ) è necessario indicare l’unità di misura rispetto la quale effettuare la totalizzazione. Nell’eventualità che siano presenti campi con diverse unità di misura, verrà effettuata una conversione automatica dei record nell’unità di misura prescelta. Alla fine della Statistica viene riportata una tabella con le conversioni eseguite.


20/21

6.4 Classifica La Classifica è un particolare tipo di Statistica nella quale l’ordinamento dei dati può essere fatto rispetto ad un unico campo, e questo deve essere necessariamente numerico. I passaggi per la creazione di una Classifica ripercorrono quelli della Statistica.

Figura 43

7 Area di Lavoro Prima di creare gli elementi del workbench ( Settore Specifico, Gruppo Utenti, Query ) è necessario scegliere l’area di lavoro nella quale operare. Per fare questo, nella schermata di creazione dei tre oggetti seguire il percorso

Ambiente à Aree di lavoro e selezionare l’area desiderata. • Area Globale: è un ambiente di lavoro sovramandante. Un oggetto creato in questa area deve essere allocato in una

classe di sviluppo. • Area Standard: è un ambiente di lavoro legato al mandante in cui si sta lavorando. Un oggetto creato in questa area non

può essere allocato in una classe di sviluppo.

8 Trasporti

Se un oggetto è stato creato nell’ Area Globale di lavoro, per trasportarlo su un altro mandante è necessario rilasciare la richiesta di trasporto a cui è collegato. Se l’oggetto si trova nella classe di sviluppo $TMP (oggetto locale), per inserirlo in una richiesta di trasporto lo si deve riallocare in una nuova classe di sviluppo scegliendo la voce

Cambiare classe di sviluppo nella prima voce di menù nella schermata di creazione degli oggetti. Se un oggetto è stato creato nell’ Area Standard di lavoro, per trasportarlo su un altro mandante seguire il percorso

Ambiente à Trasporti e nella schermata seguente indicare il tipo di operazione da effettuare ed il nome degli oggetti .

Figura 44


21/21

Se viene scelta l’opzione Download , il sistema chiede di indicare un percorso ed un nome di un file in cui scaricare le informazioni relative agli oggetti indicati.

Con l’opzione Upload , il file in precedenza creato può essere letto all’interno di un altro mandante e quindi creare ( o aggiornare) gli oggetti in esso contenuti.

Con l’opzione Esportare viene creata, al posto di un file locale, una richiesta di trasporto che può essere richiamata e caricata in un altro mandante selezionando l’opzione Importare.

E’ anche possibile copiare un oggetto da una area di lavoro all’altra scegliendo una delle due opzioni Copiare area standard à area globale o Copiare area globale à area standard , in modo tale da avere il medesimo oggetto in entrambe le aree.

Documents

Manuale - Ita - Abap - Query - Sap r3 4 6 B