'&variable.(FIND return_fieldname [,display_fieldname] IN datasource[|SORT=sortoption]).[description.]'

dove:

&variabile

La variabile, inclusa la "e" commerciale (&), per cui si fornisce un elenco di valori.

return_fieldname

Nome del campo contenente i possibili valori restituiti da FOCEXEC per le variabili.

display_fieldname

Nome del campo contenente i possibili valori delle variabili visualizzati nel modulo di richiesta automatica.

datasource

L'origine dati che contiene i campi specificati in return_fieldname e display_fieldname Se i campi si trovano in un file di riferimento incrociato di una origine dati usata in una unione, usare il nome dell'origine dati che contiene i campi.

sortoption

Fornisce l'abilità di specificare come ordinare i valori restituiti per un elenco dinamico. I valori validi sono:

• ASCENDING, che ordina in ordine da basso a alto. Si tratta del valore predefinito quando non si specifica l'elaborazione di ordine.
• DESCENDING, che ordina l'ordine da alto a basso.

description

Una descrizione opzionale della variabile.

La seguente procedura fornisce un elenco di valori validi per il campo del nome prodotto. Questo elenco viene popolato con valori dall'origine dati CENTORD. L'utente è in grado di selezione solo un valore dall'elenco.

-<description>This procedure reports on Inventory </description>
-<description>by state, storename and product number. </description>
-<heading> Please specify a state, storename and product name: </heading>
-DEFAULT &STATE=NY
TABLE FILE CENTORD
SUM QTY_IN_STOCK BY STATE BY STORENAME BY PROD_NUM
ON TABLE SUBHEAD
"Inventory Report"
WHERE STATE EQ '&STATE.2 letters for US State.'
WHERE STORENAME EQ '&STORENAME.(eMart,TV City,Web Sales).Store Name.'
WHERE PROD_NUM EQ '&PROD_NUM.(FIND PROD_NUM,PRODNAME IN CENTORD|SORT=DESCENDING).Product Name.'
END

&variable.({AND|OR}(FIND return_fieldname [,display_fieldname] IN datasource[|SORT=sortoption])).[description.]

dove:

&variabile

La variabile, inclusa la "e" commerciale (&), per cui si fornisce un elenco di valori.

return_fieldname

Nome del campo contenente i possibili valori restituiti da FOCEXEC per le variabili.

display_fieldname

Nome del campo contenente i possibili valori delle variabili visualizzati nel modulo di richiesta automatica.

datasource

L'origine dati che contiene i campi specificati in return_fieldname e display_fieldname Se i campi si trovano in un file di riferimento incrociato di una origine dati usata in una unione, usare il nome dell'origine dati che contiene i campi.

sortoption

Fornisce l'abilità di specificare come ordinare i valori restituiti per un elenco dinamico. I valori validi sono:

• ASCENDING, che ordina in ordine da basso a alto. Si tratta del valore predefinito quando non si specifica l'elaborazione di ordine.
• DESCENDING, che ordina l'ordine da alto a basso.

descrizione

Una descrizione opzionale della variabile.

La seguente procedura fornisce un elenco di valori validi per il campo stato. Questo elenco viene popolato con valori dall'origine dati CENTORD. L'utente è in grado di selezionare più di un valore dall'elenco.

-<description>This procedure reports on Inventory </description>
-<description>by store code, state and product name. </description>
-<heading> Please specify a storename, state and product name: </heading>
TABLE FILE CENTORD
SUM QTY_IN_STOCK BY STORE_CODE BY STATE BY PRODNAME
ON TABLE SUBHEAD
"Inventory Report"
WHERE STORE_CODE EQ &STORE_CODE.(OR(FIND STORE_CODE,STORENAME 
IN CENTORD|SORT=DESCENDING)).Store Name.
WHERE STATE EQ &STATE.(OR(CA,IL,MA,NY,NJ,FL,TX)).2 letters for US State.
WHERE PRODNAME EQ '&PRODNAME.(FIND PRODNAME IN CENTORD).Product Name.'
END

TYPE={REPORT|TITLE}, TITLELINE =  (ON|OFF|SKIP)

dove:

ON

Sottolinea i titoli di colonna. ON - È il valore predefinito.

OFF

Sostituisce la parte sottolineata con una riga vuota.

SKIP

Omette sia la sottolineatura che la riga in cui si sarebbe visualizza la sottolineatura.

La seguente richiesta presenta un campo BY e ACROSS.

TABLE FILE GGSALES
SUM UNITS BY PRODUCT
ACROSS REGION
ON TABLE SET PAGE-NUM OFF
ON TABLE SET STYLE *
TYPE=REPORT, TITLELINE=ON, GRID=OFF, FONT=ARIAL,$
INCLUDE=endeflt.sty,$
END

Con il valore predefinito (ON) per TITLELINE, i titoli di colonna sono sottolineati.

Con TITLELINE=OFF, i titoli di colonna non sono sottolineati, ma la linea vuota, dove ci sarebbe dovuta essere la sottolineatura, è ancora presente.

Con TITLELINE=SKIP, sia la sottolineatura che la tiga vuota sono rimosse.

SET EXTENDNUM = {ON|OFF|AUTO}

dove:

ON

Visualizza tutti i numeri completi, indipendentemente dal formato USAGE definito.

INATTIVO

Visualizza asterisci quando il valore non aderisce allo spazio dedicato dal formato USAGE. Questo è il comportamento legacy.

AUTO

Applica una impostazione ON o OFF, a seconda del formato di emissione e delle impostazioni SQUEEZE, come illustrato nella seguente tabella.

Formato	Impostazione SQUEEZE	EXTENDNUM
PDF, PS, DHTML, PPT, PPTX	ON INATTIVO	ON INATTIVO
HTML, EXL2K, XLSX	N/D	ON
BINARY, ALPHA	N/D	INATTIVO
WP, altri formati delimitati	N/D	INATTIVO

AUTO è il valore predefinito.

Il richiamo di SET EXTENDNUM=ON potrebbe cambiare il layout di prospetto nei seguenti modi.

Modifiche nel layout di prospetto:

• Con formati stilizzati (PDF, PS, DHTML, HTML, EXL2K, XLSX, PPT, PPTX), la larghezza del prospetto si estende per accomodare la larghezza delle colonne dati. Questa situazione potrebbe cambiare la posizione del prospetto complessivo sulla pagina definita e, in alcune istanze, porta le colonne ad eccedere in una nuova pagina.
  • Per PDF, DHTML, PPT e PPTX, l'impostazione SQUEEZE ON assicurerà il mantenimento dell'allineamento con ogni colonna.
  • Per HTML, EXL2K e XLSX, l'allineamento verrà atomaticamente mantenuto, indipendentemente dalle impostazioni SQUEEZE.
• Con formati non stilizzati (WP), le colonne non si adattano per aderire ai nuovi valori, che potrebbe causare il disallineamento delle colonne dati.

Modifica di comportamento in sistemi operativi, dove il formato di numero definito non è supportato:

• I valori interi superiori a 2GB non possono essere visualizzati su computer di 32-bit. Quindi, questi valori interi su questi computer visualizzeranno valori scorretti.
• I numeri punto mobile (tipo F e D) che richiedono più di 31 cifre per la stamoa corretta continueranno a visualizzare asterischi. Per esempio, un campo con uso D33.30 e un valore di 10.0 si stamperà con asterisci, poiché necessita 30 zeri a destra del punto decimale e due cifre a sinistra.

È possibile posizionare l'emissione di prospetto su una slide specifica in una maschera PowerPoint. Questa azione consente di popolare presentazioni esistenti con Slide Master, stili e altro contenuto aziendale presente. Le maschere design PowerPoint (POTX) e le maschere con attivazione macro PowerPoint (POTM) sono memorizzate sul server ed è possibile distribuirle automaticamente con ReportCaster.

ON TABLE {PCHOLD|HOLD|SAVE} [AS name] FORMAT PPTX 
[TEMPLATE {'template.potx'|'template.potm'} SLIDENUMBER n]

TABLE FILE GGSALES
HEADING
" "
" "
" "
" "
" "
SUM DOLLARS UNITS CATEGORY 
BY  REGION
ON TABLE SET PAGE-NUM NOLEAD
ON TABLE NOTOTAL
ON TABLE PCHOLD FORMAT PPTX TEMPLATE 'mytemplate.potx' SLIDENUMBER 3
ON TABLE SET HTMLCSS ON
ON TABLE SET STYLE *
TYPE=REPORT, FONT=ARIAL, SIZE=10,$
TYPE=HEADING, image=gglogo.gif, POSITION=(0.000000 0.000000),$
ENDSTYLE
END

TYPE=REPORT,HFREEZE={OFF|ON|TOP|BOTTOM},[SCROLLHEIGHT={AUTO|nn[.n]}], $

dove:

SCROLLHEIGHT=AUTO

Ridimensiona il prospetto HFREEZE nella pagina del browser o nella cornice della pagina.

nn[.n]

L'altezza, in pollici, dell'area scorrevole. Il valore predefinito è 4 pollici.

BY field {SUMMARIZE|SUBTOTAL|SUB-TOTAL|RECOMPUTE} [ROLL.][prefix1.]
[field1              field2 ...|*] [ROLL.][prefix2.] [fieldn ...]

O:

BY field            

ON field {SUMMARIZE|SUBTOTAL|SUB-TOTAL|RECOMPUTE} ROLL.[prefix.]
[field1              field2 ...|*]

dove:

ROLL.

Indica che i valori di riepilogo dovrebbero essere calcolati usando i valori di riepilogo dal successivo comando di riepilogo di livello inferiore.

campo

Un campo BY nella richiesta.

prefix1, prefix2

Operatori prefissi da usare per valori di riepilogo. Può essere uno dei seguenti operatori: SUM. (l'operatore predefinito se nessuno specificato), AVE., MAX., MIN., FST., LST., CNT., ASQ.

field1 field2 fieldn

Campi da dover riepilogare.

*

Indica che tutti i campi, numerici e alfanumerici, dovrebbero essere inclusi sulle righe di riepilogo. È possibile o usare l'asterisco per visualizzare tutte le colonne o fare riferimento a colonne specifiche che si desidera visualizzare.

La seguente richiesta rispetto all'origine dati GGSALES contiene due campi di ordinamento, REGION e ST. Il comando di riepilogo per REGION applica AVE. operatoe della somma dei valori di unità per ogni stato.

TABLE FILE GGSALES                           
   SUM UNITS AS 'Inventory '                 
     BY REGION                               
   BY ST                                     
   ON REGION SUBTOTAL      AVE.  AS 'Average'
   WHERE DATE GE 19971001                    
   WHERE REGION EQ 'West' OR 'Northeast'     
   ON TABLE SET PAGE NOPAGE                  
   END                                       

Sull'emissione, si esegue la media dei valori UNITS per ogni stato, per calcolare il subtotale per ogni regione. I valori UNITS per ogni stato, inoltre, si usano per calcolare la media della riga del totale complessivo.

Region       State  Inventory 
------       -----  ----------
Northeast    CT          37234
             MA          35720
             NY          36248
                              
Average Northeast             
                         36400
                              
West         CA          75553
             WA          40969
                              
Average West                  
                         58261
                              
                              
TOTAL                    45144

La seguente versione della richiesta aggiunge un comando di riepilogo per la riga del totale complessivo che include ROLL. operatore:

TABLE FILE GGSALES                           
   SUM UNITS AS 'Inventory '                 
     BY REGION                               
   BY ST                                     
   ON REGION SUBTOTAL  AVE.  AS 'Average'
   WHERE DATE GE 19971001                    
   WHERE REGION EQ 'West' OR 'Northeast'     
   ON TABLE SUBTOTAL ROLL.AVE. AS ROLL.AVE
   ON TABLE SET PAGE NOPAGE                  
   END                                       

Sull'emissione, si esegue la media dei valori UNITS per ogni stato, per calcolare il subtotale di ogni regione e i valori del subtotale delle regioni si usa per calcolare la media della riga del totale complessivo:

Region       State  Inventory   
  ------       -----  ---------- 
  Northeast    CT          37234
               MA          35720
               NY          36248
  
  Average Northeast  
                           36400     
  
  West         CA          75553
               WA          40969
  
  Average West       
                           58261   
  
  
  ROLL.AVE                 47330

La seguente richiesta rispetto all'origine dati GGSALES ha tre campi BY. Il comando SUBTOTAL per il campo di ordine PRODUCT specifica AVE. e il comando SUMMARIZE per il campo di ordine di livello superiore, REGION, specifica ROLL.AVE.

TABLE FILE GGSALES                        
SUM UNITS                                 
BY REGION                                 
BY PRODUCT                                
BY HIGHEST DATE                           
WHERE DATE GE 19971001                    
  WHERE REGION EQ 'Midwest' OR 'Northeast'
  WHERE PRODUCT LIKE 'C%'                 
  ON PRODUCT SUBTOTAL AVE.                
  ON REGION SUMMARIZE ROLL.AVE. AS ROLL.AVE           
ON TABLE SET PAGE NOPAGE                  
END                                       

Sull'emissione, le righe dettagli per ogni stato si usano per calcolare la media per ogni prodotto. A causa di ROLL.AVE. al livello di regione, le medie per ogni prodotto sono usate per calcolare le medie per ogni regione e queste medie si usano per calcolare la media della riga del totale complessivo:

Region       Product                 Date  Unit Sales   
  ------       -------                 ----  ----------  
  Midwest      Coffee Grinder    1997/12/01        4648
                                 1997/11/01        3144
                                 1997/10/01        1597
  
  *TOTAL PRODUCT Coffee Grinder                    3129   
  
               Coffee Pot        1997/12/01        1769
                                 1997/11/01        1462
                                 1997/10/01        2346
  
  *TOTAL PRODUCT Coffee Pot                        1859    
  
               Croissant         1997/12/01        7436
                                 1997/11/01        5528
                                 1997/10/01        6060
  
  *TOTAL PRODUCT Croissant                         6341     
  ROLL.AVE Midwest                                 3776  
  
  Northeast    Capuccino         1997/12/01        1188
                                 1997/11/01        2282
                                 1997/10/01        3675
  
  *TOTAL PRODUCT Capuccino                         2381   
  
               Coffee Grinder    1997/12/01        1536
                                 1997/11/01        1399
                                 1997/10/01        1315
  
  *TOTAL PRODUCT Coffee Grinder                    1416  
  
               Coffee Pot        1997/12/01        1442
                                 1997/11/01        2129
                                 1997/10/01        2082
  
  *TOTAL PRODUCT Coffee Pot                        1884  
  
               Croissant         1997/12/01        4291
                                 1997/11/01        6978
                                 1997/10/01        4741
  
  *TOTAL PRODUCT Croissant                         5336 
  ROLL.AVE Northeast                               2754   
  
  
  TOTAL                                            3265

• ROLL.prefisso su una riga di riepilogo indica che si eseguirà l'operazione prefisso sui valori di riepilogo dal comando di riepilogo del successivo livello inferiore.
• Se non si emette nessun comando di riepilogo al livello sotto a ROLL. e non si usa nessun'altro operatore in congiunzione con ROLL., si calcolerà un SUM. Se il livello inferiore aveva il comando di riepilogo ed è stato usato ROLL. con un altro operatore prefisso (per esempio, ROLL.AVE), si userà l'opratore prefisso specificato. Per esempio, ROLL.AVE. diventerà AVE.
• CNT. prefisso mostra il numero di righe dati visualizzate, non influenzato da MULTILINES.
• ROLL.CNT. prefisso mostra il numero di righe riepilogo visualizzate, non influenzato da MULTILINES.

La funzione CHAR_LENGTH restituisce la lunghezza, in caratteri, di una stringa. In ambienti Unicode, questa funzione usa la semantica dei caratteri, per far sì che la lunghezza in caratteri non sia la stessa della lunghezza in byte. Se la stringa include spazi finali, questi sono contanti nella lunghezza restituita. Quindi, se la stringa di origine del formato è di tipo An, il valore restituito sarà sempre n.

CHAR_LENGTH(source_string)

DEFINE FILE EMPLOYEE
LASTNAME/A15V = RTRIM(LAST_NAME);
END
TABLE FILE EMPLOYEE
SUM LAST_NAME NOPRINT AND COMPUTE
NAME_LEN/I3 = CHAR_LENGTH(LASTNAME);
BY LAST_NAME
ON TABLE SET PAGE NOPAGE
END

   LAST_NAME        NAME_LEN    
  ---------        --------      
  BANNING                 7
  BLACKWOOD               9
  CROSS                   5
  GREENSPAN               9
  IRVING                  6
  JONES                   5
  MCCOY                   5
  MCKNIGHT                8
  ROMANS                  6
  SMITH                   5
  STEVENS                 7

Dato un numero, DIGITS lo converte in una stringa di caratteri di lunghezza specifica Il formato del campo che contiene il numero deve essere intero.

DIGITS(number,length)

DEFINE FILE WF_RETAIL_LITE
MEAS1/I8=-123.45;
DIG1/A6=DIGITS(MEAS1,6) ;
DIG2/A6=DIGITS(ID_PRODUCT,6) ;
END
TABLE FILE WF_RETAIL_LITE
PRINT MEAS1 DIG1 
ID_PRODUCT DIG2  
BY PRODUCT_SUBCATEG
WHERE PRODUCT_SUBCATEG EQ 'Flat Panel TV'
ON TABLE SET PAGE NOPAGE
END

LPAD usa un carattere e lunghezza di emissione specifici per restituire una stringa di caratteri riempita a sinistra con quel carattere.

LPAD(string, out_length, pad_character) 

DEFINE FILE WF_RETAIL
LPAD1/A25 = LPAD(PRODUCT_CATEGORY,25,'@');
DIG1/A4 = DIGITS(ID_PRODUCT,4);
END
TABLE FILE WF_RETAIL
SUM DIG1 LPAD1
BY PRODUCT_CATEGORY
ON TABLE SET PAGE NOPAGE
ON TABLE SET STYLE *
TYPE=DATA,FONT=COURIER,SIZE=11,COLOR=BLUE,$
END

La funzione LOWER prende una stringa di origine e restituisce una stringa dello stesso tipo di dati con tutte le lettere tradotte in caratteri minuscoli.

LOWER(source_string)

TABLE FILE EMPLOYEE
PRINT LAST_NAME AND COMPUTE
LOWER_NAME/A15 = LOWER(LAST_NAME);
ON TABLE SET PAGE NOPAGE
END

  LAST_NAME        LOWER_NAME           
  ---------        ----------                   
  STEVENS          stevens        
  SMITH            smith          
  JONES            jones          
  SMITH            smith          
  BANNING          banning        
  IRVING           irving         
  ROMANS           romans         
  MCCOY            mccoy          
  BLACKWOOD        blackwood      
  MCKNIGHT         mcknight       
  GREENSPAN        greenspan      
  CROSS            cross    

La funzione TRIM rimuove tutti gli spazi dall'estremità sinistra di una stringa.

LTRIM(source_string)

DEFINE FILE MOVIES
RDIRECTOR/A17 = RJUST(17, DIRECTOR, 'A17');
 END
TABLE FILE MOVIES
PRINT RDIRECTOR AND
COMPUTE
TRIMDIR/A17 = LTRIM(RDIRECTOR);
WHERE DIRECTOR CONTAINS 'BR'
ON TABLE SET PAGE NOPAGE
END

  RDIRECTOR          TRIMDIR     
  ---------          -------                   
        ABRAHAMS J.  ABRAHAMS J.      
          BROOKS R.  BROOKS R.        
        BROOKS J.L.  BROOKS J.L. 

La funzione POSITION restiutisce la prima posizione (in caratteri) di una stringa secondaria in una stringa di origine.

POSITION(pattern, source_string)

TABLE FILE EMPLOYEE
PRINT LAST_NAME AND COMPUTE
I_IN_NAME/I2 = POSITION('I', LAST_NAME);
ON TABLE SET PAGE NOPAGE
END

  LAST_NAME        I_IN_NAME                     
  ---------        ---------                           
  STEVENS                  0
  SMITH                    3
  JONES                    0
  SMITH                    3
  BANNING                  5
  IRVING                   1
  ROMANS                   0
  MCCOY                    0
  BLACKWOOD                0
  MCKNIGHT                 5
  GREENSPAN                0
  CROSS                    0

La funzione RTRIM rimuove tutti gli spazi dall'estremità destra di una stringa.

RTRIM(source_string)

TABLE FILE MOVIES
PRINT DIRECTOR NOPRINT AND
COMPUTE
DIRSLASH/A18 = DIRECTOR|'/';
TRIMDIR/A17V = RTRIM(DIRECTOR)|'/';
WHERE DIRECTOR CONTAINS 'BR'
ON TABLE SET PAGE NOPAGE
END

  DIRSLASH            TRIMDIR                           
  --------            -------                                         
  ABRAHAMS J.      /  ABRAHAMS J./     
  BROOKS R.        /  BROOKS R./       
  BROOKS J.L.      /  BROOKS J.L./     

La funzione SUBSTRING estrae una stringa secondaria da una stringa di origine. Se la posizione finale specificata per la stringa secondaria supera la fine della stringa di origine, la posizione dell'ultimo carattere della stringa di origine diventa la posizone finale della stringa secondaria.

SUBSTRING(source_string, start_position, length_limit)

TABLE FILE EMPLOYEE
PRINT
COMPUTE
I_IN_NAME/I2 = POSITION('I', LAST_NAME); AND
COMPUTE
I_SUBSTR/A3 =
SUBSTRING(LAST_NAME, I_IN_NAME, I_IN_NAME+2);
BY LAST_NAME
ON TABLE SET PAGE NOPAGE
END

  LAST_NAME        I_IN_NAME  I_SUBSTR                  
  ---------        ---------  --------                             
  BANNING                  5  ING     
  BLACKWOOD                0  BL      
  CROSS                    0  CR      
  GREENSPAN                0  GR      
  IRVING                   1  IRV     
  JONES                    0  JO      
  MCCOY                    0  MC      
  MCKNIGHT                 5  IGH     
  ROMANS                   0  RO      
  SMITH                    3  ITH     
                           3  ITH     
  STEVENS                  0  ST    

RPAD usa un carattere e lunghezza di emissione specifiche per restituire una stringa di caratteri riempita sulla destra con quel carattere.

RPAD(string, out_length, pad_character) 

DEFINE FILE WF_RETAIL
RPAD1/A25 = RPAD(PRODUCT_CATEGORY,25,'@');
DIG1/A4 = DIGITS(ID_PRODUCT,4);
END
TABLE FILE WF_RETAIL
SUM DIG1 RPAD1
BY PRODUCT_CATEGORY
ON TABLE SET PAGE NOPAGE
ON TABLE SET STYLE *
TYPE=DATA,FONT=COURIER,SIZE=11,COLOR=BLUE,$
END

La funzione TOKEN estrae un token (stringa secondaria) basata su un numero token con un carattere delimitatore.

TOKEN(string, delimiter, number)

DEFINE FILE WF_RETAIL_LITE
TOK1/A20 =TOKEN(PRODUCT_SUBCATEG,'P',2);
END
TABLE FILE WF_RETAIL_LITE
SUM TOK1 AS Token
BY PRODUCT_SUBCATEG
ON TABLE SET PAGE NOPAGE
END

TRIM_function rimuove tutte le ricorrenze di una singolo carattere da o l'inizio di una stringa, la fine di una stringa o da entrambi.

TRIM_(trim_where, trim_character, source_string) 

TABLE FILE MOVIES
PRINT DIRECTOR AND
COMPUTE
TRIMDIR/A17 = TRIM_(LEADING, 'B', DIRECTOR);
WHERE DIRECTOR CONTAINS 'BR'
ON TABLE SET PAGE NOPAGE
END

  DIRECTOR           TRIMDIR                              
  --------           -------                                      
  ABRAHAMS J.        ABRAHAMS J.      
  BROOKS R.          ROOKS R.         
  BROOKS J.L.        ROOKS J.L.       

La funzione UPPER prende una stringa di origine e restituisce una stringa dello stesso tipo di dati con tutte le lettere tradotte in caratteri minuscoli.

UPPER(source_string)

DEFINE FILE EMPLOYEE
LAST_NAME_MIXED/A15=LCWORD(15, LAST_NAME, 'A15');
LAST_NAME_UPPER/A15=UPPER(LAST_NAME_MIXED) ;
END
TABLE FILE EMPLOYEE
PRINT LAST_NAME_UPPER AND FIRST_NAME 
BY LAST_NAME_MIXED
WHERE CURR_JOBCODE EQ 'B02' OR 'A17' OR 'B04';
ON TABLE SET PAGE NOPAGE
END

  LAST_NAME_MIXED  LAST_NAME_UPPER  FIRST_NAME              
  ---------------  ---------------  ----------                         
  Banning          BANNING          JOHN      
  Blackwood        BLACKWOOD        ROSEMARIE 
  Cross            CROSS            BARBARA   
  Mccoy            MCCOY            JOHN      
  Mcknight         MCKNIGHT         ROGER     
  Romans           ROMANS           ANTHONY  

Data una data in formato data standard o data-ora, DTADD restituisce una nuova data dopo aver aggiunto il numero specificato o un componente supportato. Il formato data restituito è l stesso del formato data d'immissione.

DTADD(date, component, increment)

DEFINE FILE WF_RETAIL
NEWDATE/YYMD = DTADD(DATE_OF_BIRTH, DAY, 3);
MGR/A3 = DIGITS(ID_MANAGER, 3);
END
TABLE FILE WF_RETAIL
SUM MGR NOPRINT DATE_OF_BIRTH NEWDATE
BY MGR
ON TABLE SET PAGE NOPAGE
END

Fornite due date in formati data standard e data-ora, DTDIFF restiutisce il numero dei confini del componente dato tra due date. Il valore restituito presenta formato intero per i componenti del calendario o formato punto mobile di precisione doppia per i componenti ora.

DTDIFF(end_date, start_date, component)

DEFINE FILE WF_RETAIL
YEARS/I9 = DTDIFF(START_DATE, DATE_OF_BIRTH, YEAR); 
END
TABLE FILE WF_RETAIL
PRINT START_DATE DATE_OF_BIRTH YEARS AS 'Hire,Age'
BY  EMPLOYEE_NUMBER 
WHERE EMPLOYEE_NUMBER CONTAINS 'AA'
ON TABLE SET PAGE NOPAGE
END 

Data una data in formato data standard o data-ora ed un componente, DTPART restituisce il valore componente in formato intero.

DTPART(date, component)

DEFINE FILE WF_RETAIL
QTR/I2 =DTPART(START_DATE, QUARTER); 
END
TABLE FILE WF_RETAIL
PRINT START_DATE QTR AS Quarter
BY  EMPLOYEE_NUMBER 
WHERE EMPLOYEE_NUMBER CONTAINS 'AH'
ON TABLE SET PAGE NOPAGE
END 

Data una data o timestamp e un componente, DTRUNC restituisce la prima data all'interno del periodo specificato da quel componente.

DTRUNC(date_or_timestamp, date_period)

DEFINE FILE WF_RETAIL
QTRSTART/YYMD = DTRUNC(START_DATE, QUARTER); 
END
TABLE FILE WF_RETAIL
PRINT START_DATE QTRSTART AS 'Start,of Quarter'
BY EMPLOYEE_NUMBER 
WHERE EMPLOYEE_NUMBER CONTAINS 'AH'
ON TABLE SET PAGE NOPAGE
END 

CHECKPRIVS(privcode, output)

dove:

privcode

Il codice di privilegio per cui recuperare lo stato.

emissione

Alfanumerico

Nome del campo che contiene il risultato o formato del valore di emissione racchiuso tra virgolette singole.

La seguente richiesta recupera lo stato di privilegio ADPTP (Configurazione Adattatore Dati):

-SET &PRIVSTATE = CHECKPRIVS(ADPTP,'A1');
-TYPE Privilege State is: &PRIVSTATE

L'emissione è:

Privilege State is: Y

ACCEPT=SYNONYM(lookup_field AS display_field IN lookup_synonym)

dove:

lookup_field

Il campo in lookup_synonym, il quale valore sarà usato nel filtro (dialogo WHERE) o dalla funzione di richiesta automatica "e" commerciale, che sarà paragonata al campo con l'attributo ACCEPT.

display_field

Il campo in lookup_synonym, il quale valore si visualizzerà per la selezione nel dialogo filtro o nell'elenco a discesa di richiesta automatica "e" commerciale.

lookup_synonym

Il nome del sinonimo che descrive i dati di ricerca.

SET DBAJOIN = {OFF|ON}

dove:

INATTIVO

Tratta limiti DBA come filtri WHERE nella richiesta di prospetto. Il valore predefinito è OFF.

ATTIVO

Tratta limiti DBA come condizioni unione.

La seguente richiesta crea due tabelle: EMPINFOSQL e EDINFOSQL:

TABLE FILE EMPLOYEE
SUM LAST_NAME FIRST_NAME CURR_JOBCODE
BY EMP_ID
ON TABLE HOLD AS EMPINFOSQL FORMAT SQLMSS
END
-RUN
TABLE FILE EDUCFILE
SUM COURSE_CODE COURSE_NAME
BY EMP_ID
ON TABLE HOLD AS EDINFOSQL FORMAT SQLMSS
END

Aggiungere i seguenti attributi DBA alla fine del file principale EMPINFOSQL generato. Con le restrizioni elencate, USER2 non è in grado di recuperare codici corso di 300 o oltre:

END
DBA=USER1,$
USER=USER2, ACCESS = R, $
FILENAME=EDINFOSQL,$
USER=USER2, ACCESS = R, RESTRICT = VALUE, NAME=SYSTEM, VALUE=COURSE_CODE LT 300;,$

Aggiungere i seguenti attributi DBA alla fine del file principale EMPINFOSQL generato:

END
DBA=USER1,DBAFILE=EMPINFOSQL,$

Emettere la seguente richiesta:

SET USER=USER2
SET DBAJOIN=OFF
JOIN LEFT_OUTER EMP_ID IN EMPINFOSQL TO MULTIPLE EMP_ID IN EDINFOSQL AS J1
TABLE FILE EMPINFOSQL
PRINT LAST_NAME FIRST_NAME COURSE_CODE COURSE_NAME
ON TABLE SET PAGE NOPAGE
ON TABLE SET STYLE *
GRID=OFF,$
END

Sull'emissione di prospetto, tutte le righe host e secondarie con codici del corso 300 o superiore sono state omesse, come illustrato nella seguente immagine.

Nell'SQL generato, la restrizione DBA è stata aggiunta al predicato WHERE nella dichiarazione SELECT:

SELECT 
  T1."EID",
  T1."LN",
  T1."FN",
  T2."CC",
  T2."CD"
   FROM 
  EMPINFOSQL T1,
  EDINFOSQL T2
   WHERE 
  (T2."EID" = T1."EID") AND 
  (T2."CC" < '300;');

Rieseguire la richiesta con SET DBAJOIN=ON. L'emissione ora visualizza tutte le righe host, con i valori mancanti sostituiti per istanze di segmento di livello inferiore che non soddisfano la restrizione DBA, come illustrato nella seguente immagine.

Nell'SQL generato, la restrizione DBA è stata aggiunta all'unione e non è presente il predicato WHERE:

SELECT 
  T1."EID",
  T1."LN",
  T1."FN",
  T2."EID",
  T2."CC",
  T2."CD"
   FROM 
  ( EMPINFOSQL T1
   LEFT OUTER JOIN EDINFOSQL T2
   ON T2."EID" = T1."EID" AND 
      (T2."CC" < '300;') );

Convenzioni Denominazione File di Traduzione

I file di traduzione hanno nomi nella seguente forma:

              prefix              lng.lng

dove:

prefisso

Un gruppo di caratteri anteposti ad ogni relativo file di traduzione.

lng

Un codice di linguaggio.

Per esempio, se il prefisso comune è dt, il file di traduzione francese si chiamerebbe dtfre.lng e il file di traduzione inglese si chiamerebbe dteng.lng.

Contenuti File di Traduzione

Il file prefixeng.lng deve contenere qualsiasi valore titolo, descrizione e richiesta che si desidera tradurre quando si visualizza nel file master, sia in inglese che in un'altra lingua:

1. Copiare ogni valore attributo dal file master che si desidera tradurre nel file di traduzione (eng) predefinito e assegnare un numero indice. I numeri di indice non devono essere consecutivi o in ordine. Per esempio:

   39 = Product,Category

2. Aggiungere traduzioni di questi valori attributo ai file di traduzione per altre lingue in cui si desidera visualizzare i metadati. Assegnare lo stesso numero di indice alle traduzioni. Per esempio, nel file di traduzione francese:

   39 = Produit,Catégorie

Identificazione dei file di traduzione da usare per un file master

Per specificare che il file master dovrebbe usare un set specifico di file di traduzione, identificare il prefisso comune nella dichiarazione FILE del file master:

FILENAME=filename,  TRANS_FILE=[path]/prefix, ...

Dove:

filename

Il nome specificato nell'attributo FILE=.

percorso

Le informazioni necessarie per localizzare il set dei file di traduzione. È in grado di essere un percorso completo o un app riferimento. Se è presente un set di file di traduzione con il prefisso in uso e si trova nel percorso app, è possibile ometterlo.

prefisso

Il prefisso comune per il set dei file di traduzione.

Richiamo dei file di traduzione per una richiesta

1. Assicurarsi che il server stia usando un code page che supporta le lingue da usare.
2. Impostare il parametro LANGUAGE al linguaggio in cui si dovrebbero visualizzare i metadati.
3. Eseguire la richiesta.

La seguente richiesta usa l'origine dati WF_RETAIL_LITE:

TABLE FILE WF_RETAIL
SUM REVENUE_US 
BY PRODUCT_CATEGORY
BY PRODUCT_SUBCATEG
ON TABLE SET PAGE NOPAGE
ON TABLE SET STYLE *
TYPE = TITLE, FONT='Trebuchet MS', $
ENDSTYLE
END

L'emissione è:

Il file master contiene il seguente attributo TRANS_FILE:

FILENAME=WF_RETAIL_LITE,  TRANS_FILE=_EDAHOME/NLS/dt, ...

L'attributo TRANS_FILE punta ai file che iniziano con i caratteri dt, nella cartella NLS, nella directory EDAHOME. Il seguente campione mostra alcuni dei contenuti del file di traduzione predefinito, dteng.lng:

1 = Age
2 = Age Range
3 = Age Group
6 = Gender
9 = Discount,Rate
10 = Discount,Price,Multiplier
15 = Country
17 = State
19 = City
31 = Customer,Income Range
32 = Customer,Income Subrange
33 = Households
34 = Number of,Earners
35 = Household,Size
36 = Industry
38 = Occupation
39 = Product,Category
40 = Product,Subcategory
41 = Brand Type

Il testo assegnato ad ogni numero si trova in uno dei file master associati con il file master WF_RETAIL_LITE. WF_RETAIL_LITE è un file master cluster che fa riferimento a file principale fact e dimensione, per creare uno schema a stella.

Il seguente campione mostra i contenuti corrispondenti del file di traduzione francese, dtfre.lng:

1 = Age
2 = Tranche d'âge
3 = Groupe d'âge
6 = Sexe
9 = Remise,Taux
10 = Remise,Prix,Multiplicateur
15 = Pays
17 = Département
19 = Ville
31 = Client,Tranche de revenus
32 = Client,Sous-tranche de revenus
33 = Ménages
34 = Nombre de,Salariés
35 = Ménage,Taille
36 = Secteur d'activité
38 = Profession
39 = Produit,Catégorie
40 = Produit,Sous-catégorie
41 = Type de marque

Quando la lingua è impostata su Francese, qualsiasi testo da visualizzare che rappresenta una corrispondenza esatta a qualsiasi numero indice nel file dteng.lng verrà sostituita con il testo per lo stesso numero indice nel file dtfre.lng.

La seguente versione della richiesta aggiunge il comando SET LANG=FRE. Il code page server supporta inglese e francese:

SET LANG = FRE
TABLE FILE WF_RETAIL
SUM REVENUE_US 
BY PRODUCT_CATEGORY
BY PRODUCT_SUBCATEG
ON TABLE SET PAGE NOPAGE
ON TABLE SET STYLE *
TYPE = TITLE, FONT='Trebuchet MS', $
ENDSTYLE
END

L'emissione ha tradotto i titoli di colonna: