Questa funzione permette di definire delle tabelle di dimensioni contenenti dei dati di riferimento. Queste tabelle di dimensioni possono essere collegate a tabelle dei fatti nel folder di descrizione dei legami.

Una tabella di dimensione è caratterizzata da un elenco di campi.

Contrariamente alle tabelle dei fatti, che possono essere alimentate da più regole di sincronizzazione (generalmente perché è possibile, in una stessa tabella dei fatti, avere più tipi di fatti caratterizzati da un tipo), una dimensione viene alimentata a partire da una sola logica di sincronizzazione. Ecco perché direttamente nella descrizione della tabella di dimensione è presente un folder che precisa la maniera in cui viene alimentata la tabella.

Entry point ABITUNNEL

Questo entry point ABITUNNEL permette di modificare il valore della variabile locale OKK.

Se [L]OKK vale 0 non è possibile definire tunnel sulla dimensione.

Viceversa è possibile definire un tunnel sulla dimensione.

Prerequisiti

SEEREFERTTO Riferirsi alla documentazione di Implementazione

Gestione videata

Testata

Presentazione

Permette di definire, oltre al codice e la descrizione della tabella, un'abbreviazione che sarà utilizzata per l'accesso alla tabella di dimensione dai programmi di aggiornamento.

Chiudi

 

Campi

I seguenti campi sono presenti in questo folder :

Questo codice identifica in maniera univoca la scheda in corso.

Corrisponde al nome della tabella che verrà creata nel database del datamart.

  • Abbreviazione (campo ABRDIM)

L'abbreviazione della tabella deve essere composta da 1 a 4 caratteri (lettere o cifre ma iniziando obbligatoriamente da una lettera). E' un identificativo unico per l'insieme delle abbreviazioni delle tabelle del dizionario dati. Le parole riservate DiapasonX sono vietate.

  • Descrizione (campo ZINTIT)

 

  • campo W

 

  • Descr. valutata (campo INTEVAL)

 

Chiudi

 

Folder Descrizione

Presentazione

Questo folder permette di definire le caratteristiche generali della tabella di dimensione, ed in particolare le regole di alimentazione. Tali regole si caratterizzano da una tabella di origine alla quale è possibile collegare un insieme di tabelle annesse, così come una condizione logica di estrazione ed un tipo di estrazione. Un codice di programma specifico permette, se necessario, di gestire delle eccezioni.

Chiudi

 

Campi

I seguenti campi sono presenti in questo folder :

Caratteristiche

Un codice attività permette:

  • di rendere opzionale un elemento del dizionario se il valore associato al codice attività è nullo.
  • di approvare gli elementi specifici da quando sono evidenziati da un codice che inizia per X, Y o Z.
  • di dimensionare un numero di righe massimo quando il codice attività evidenzia degli elementi di un riquadro.

Così, se il codice attività non è attivo, l'elemento evidenziato non sarà utilizzabile, e il codice associato (se ne ha) non verrà generato né sarà attivabile.

  • Modulo (campo MODULE)

 

Definisce la tabella di origine che verrà letta (con i record delle tabelle collegate) ogni volta che verrà attivato un aggiornamento della tabella di dimensione. Tale percorso sarà completo, se il tipo di aggiornamento è Annulla e sostituisci; viceversa sarà incrementale, basato sui record modificati nella tabella principale.

  • Chiave (campo INDLEC)

 

  • Filtro estrazione (campo FILTRE)

Questa condizione viene applicata ai record della tabella di origine durante il processo di aggiornamento della tabella di dimensioni. Se questa non viene soddisfatta, il record non viene considerato per permettere l'aggiornamento.

E' importante notare che è possibile applicare qui delle espressioni complesse, comprese quelle facenti intervenire delle funzioni definite dal programmatore (sintassi func PRG.FUNZIONE...)

  • Tipo aggiornamento (campo TYPMAJ)

Questo campo permette di definire se la logica di alimentazione della tabella di dimensioni deve essere:

  • di tipo Incrementale (ad ogni attivazione, si riportano le modifiche della tabella di origine). Contrariamente alla tabella dei fatti, dove si utilizza un trigger di database, nel caso delle dimensioni ci si basa sulla data di ultima modifica o di creazione, che deve quindi esistere per le tabelle di dimensione.
  • o di tipo Annulla e sostituisci (si cancellano tutte le righe della tabella per ricrearle completamente).
  • campo WA

 

  • Cancellazione record nullo (campo SUPVID)

Questa opzione permette di aggiungere o meno una riga vuota nella tabella della dimensione in fase di sincronizzazione.

  • Multi-dossier (campo MULDOS)

Questo parametro permette di definire se questa dimensione è o meno multi-dossier.

  • Script standard (campo TRTSTD)

Permette di definire il codice di un programma opzionale.

Se indicato, questo programma viene richiamato durante l'aggiornamento, per permettere di realizzare elaborazioni particolari.

In questo programma, vi saranno un'etichetta $ACTION, e due variabili che permettono di definire il contesto di chiamata:

  • La variabile chiamata ACTION permette di definire il contesto di chiamata. I valori possibili sono:
    • "DEB_DIM" ad inizio aggiornamento.
    • "FIN_DIM" a fine aggiornamento.
  • La variabile chiamata TABLE permette di conoscere il nome della tabella di dimensione in corso di aggiornamento.

Si può così assumere il controllo quando l'aggiornamento della dimensione non si limita ad una semplice copia di tabella.

  • Script verticale (campo TRTSPV)

 

  • Script specifico (campo TRTSPE)

 

Riquadro Collegam.

  • Tabelle collegate (campo TABLNK)

Permette di definire delle tabelle collegate alla tabella di origine, o a una delle tabelle che la precedono nel riquadro dei legami.

  • Abbreviazione (campo ABRLNK)

Corrisponde all'abbreviazione sotto la quale è aperta la tabella collegata.

Se non si inserisce questo campo, si utilizza l'abbreviazione di default della tabella. Può essere utile inserire un'abbreviazione per non entrare in conflitto con il contesto chiamante.

  • Chiave di legame (campo CLELNK)

Definisce il codice della chiave della tabella utilizzata per la lettura delle righe collegate. Di default viene utilizzata la prima chiave della tabella.

  • Tipo (campo TYPLNK)

 

  • Espress. legame (campo EXPLNK)

Questo campo è definito con una o più espressioni calcolate separate da un punto e virgola. Ogni espressione viene interpretata, ed il risultato permette di conoscere il valore della chiave utilizzata per realizzare la joint. Quando sono autorizzate le joint multiple, si possono fornire solo i primi elementi della chiave.

Nelle espressioni, si possono utilizzare delle costanti e dei campi delle tabelle precedentemente definite nell'elenco dei collegamenti.

  • Campo data (campo FLDDAT)

Questo campo permette di parametrizzare la tabella che contiene i campi CREDAT e UPDDAT per realizzare la sincronizzazione delle dimensioni.

Riquadro Dossier

  • Dossier (campo ADXDOS)

 

Chiudi

 

Folder Campi

Presentazione

Qui è presente la definizione dettagliata dei campi che possono essere di tipo:

  • Dimensione (vale a dire dei criteri di analisi).
  • Dimensione padre(criteri di analisi loro stessi definiti da un'altra dimensione).
  • Informazione (campi informativi supplementari).
  • Tecnico (campi presenti nel datamart, ma non visibili all'utente finale. Possono generalmente servire alla gestione delle abilitazioni, o a precisare dei contesti di legami).

Chiudi

 

Campi

I seguenti campi sono presenti in questo folder :

Riquadro Campi

  • Numero riga (campo NUMDIM)

 

  • Codice campo (campo FLDDIM)

Definisce il codice del campo nella tabella dei fatti o la tabella che descrive le dimensioni. Questo codice è quello per il quale il campo viene riconosciuto dal database (è automaticamente post-fissato con i caratteri "_0"). Non è visibile quando si costituiscono dei report di pilotaggio (è il titolo che viene presentato), ma può essere visualizzato se si guardano le sintassi SQL che estraggono i dati del datamart.

  • Descrizione (campo ZINTDIM)

 

Viene qui definito il tipo del campo che caratterizza il relativo formato di inserimento (numerico, carattere qualsiasi, data...) e dei controlli di coerenza (riferimento ad una tabella ad esempio).

I principali tipi generici esistenti sono:

A: Alfanumerico
C: Intero breve
L: Intero lungo
DCB: Decimale
D: Data
M: Menù locale
MM: Menù locale con filtro
ACB: clob
ABB: blob

Esistono molti altri tipi predefiniti. Si riferiscono spesso ad una tabella allegata (valuta, paese,...). Un dizionario dedicato permette di descriverli ed è possibile selezionarli tramite il tasto che permette di ottenerne l'elenco.

  • Lng (campo LNG)

Permette di definire la lunghezza di un campo quando quest'ultimo utilizza un tipo di dati generico la cui lunghezza non è fissata. E' il caso soprattutto dei tipi A e DCB.

Per i blob, come per i clob, occorre indicare la lunghezza che sarà quella massima di memorizzazione. La codifica è la seguente:

Lunghezza

Dimensione memoria

Caratteri massimi

 0

 1020

 510

 1

 2044

 1022

 2

 4092

 2046

 3

 8188

 4094

n

 1024*(2^n) - 4

 512*(2^n) - 2

  • Data (campo TYPDAT)

Quando un campo della tabella dei fatti o di dimensioni è di tipo data, e questa è definita come dimensione, viene automaticamente associata ad una tabella di dimensioni chiamata AX3DAT, che è gestita automaticamente.

E' possibile indicare qui quali sono le caratteristiche temporali legate alla data alla quale si desidera avere accesso per le analisi. Si fornisce un elenco di caratteri per definirli, sapendo che si hanno le seguenti corrispondenze:

  • Y=anno
  • S=semestre
  • Q=trimestre
  • M=mese
  • F=quindicina
  • T=decade
  • W=settimana
  • D=giorno

Così, per esempio, YMW significa che si vuole poter avere direttamente accesso all'anno, al mese e la settimana definita dalla data.

  • Menù (campo MENLOC)

Definisce il numero di menu locale associato al campo definito sulla riga.

Quando un campo è di tipo menu locale, viene memorizzato sotto forma di un valore numerico (da 1 a 255) corrispondente ad un range di un'intestazione nella tabella chiamataMenù locali, salvata nella tabella dei messaggiAPLSTD.

In inserimento o in visualizzazione, si vede, secondo le scelte fatte sull'interfaccia utente:

  • sia una intestazione che può essere scelta nella lista scorrevole comunemente chiamatacombo box
  • sia una lista di bottoni di scelta.

L'interesse di questo tipo di inserimento è che la lista delle scelte è presentata nella lingua di connessione dell'utente.

Ogni numero di menu locale caratterizza la lista delle intestazioni possibili. Per esempio, il menu locale 1 corrisponde alla sceltaNo / Sì  in questo ordine. In questo caso particolare, l'interfaccia utente può anche essere la casella da contrassegnare.

Se il campo viene associato ad una tabella diversa, si fonisce qui il numero che l'identifica.

  • Tipo oggetto (campo TYPFLD)

Permette di caratterizzare il dato della tabella di dimensioni. I valori possibili sono:

  • Dimensione significa che si considera il campo come un criterio di analisi presente nella tabella di dimensioni.
  • Dimensione padre significa che si considera il campo come un criterio di analisi legato ad un'altra tabella di dimensioni. In alcuni casi (i campi di tipo data, menù locale, tabelle diverse), la tabella di dimensione è gestita implicitamente dall'applicativo.
  • Informazione corrisponde ad un campo che potrà essere presentato sulle stampe, ma che non viene considerato come discriminante dal punto di vista dell'analisi e dell'aggregazione dei dati.
  • Tecnico corrisponde a dei campi che sono utili alla struttura di dati (ad esempio per definire dei legami), ma che non necessitano di essere visibili quando si svilupperanno le stampe.
  • Auto-joint (campo ZAUTO)

 

  • Tunnel verso oggetto (campo TUNNEL)

 

  • Dimensione legata (campo FLDLIE)

Quando un campo è di tipo Informazione in una tabella di dimensioni, deve essere collegato ad un campo di tipo Dimensione. Si inserisce dunque uno dei campi di tipo Dimensione presenti nella tabella di dimensioni.

Quando il campo è di tipo Dimensione padre, si inserisce qui il codice della dimensione alla quale è collegato.

  • Descr. dimensione (campo ZDIMINT)

 

  • Nome campo (campo DIMFLD)

 

  • Opzione join (campo OPTJNT)

 

  • Formula alimentazione (campo FLDORG)

Questa formula di calcolo adonix permette di definire la maniera in cui viene alimentato il campo della tabella di dimensioni quando il datamart è aggiornato a partire da un dossier dell'applicativo.

Una tale formula può integrare delle costanti, dei campi delle tabelle dichiarate in linea, delle funzioni standard, ma anche delle funzioni definite da uno sviluppatore (con la sintassi func PRG.FUNZIONE).

Un codice attività permette:

  • di rendere opzionale un elemento del dizionario se il valore associato al codice attività è nullo.
  • di approvare gli elementi specifici da quando sono evidenziati da un codice che inizia per X, Y o Z.
  • di dimensionare un numero di righe massimo quando il codice attività evidenzia degli elementi di un riquadro.

Così, se il codice attività non è attivo, l'elemento evidenziato non sarà utilizzabile, e il codice associato (se ne ha) non verrà generato né sarà attivabile.

Complemento

  • Chiave (campo CLE)

Una tabella di dimensione deve disporre di un indice i cui valori di chiavi permetteranno di stabilire la join tra le tabelle dei fatti o le altre dimensioni collegate. Questo campo permette di definire le sue caratteristiche.

Si indica qui l'elenco dei campi che compongono l'indice, separato da un '+' se esistono più campi (ad esempio, nella tabella dei siti FACILITY si trova una chiave la cui definizione è LEGCPY+FCY).

Un campo ordinato in modo decrescente è preceduto dal segno ''-'' (attenzione, se utilizzato con la lista sinistra).

il primo campo che compone un indice è senza segno ed è forzatamente crescente.

  • campo NAMCLE

 

  • Rowid (campo NOMBRE)

Quando questa casella è contrassegnata, un oggetto Numero viene aggiunto nell'universo creato, il che permette di accedere direttamente al numero di righe della tabella di dimensioni (globalmente o su criteri determinati).

Chiudi

 

Funzioni accessibili tramite click destro sul riquadro

Selezione campi

Campi

I seguenti campi sono presenti su questa finestra :

Blocco numero 1

Il codice della tabella deve essere composta da 1 a 10 caratteri (lettere o cifre ma iniziano obbligatoriamente con una lettera). E' un identificatore unica per l'insieme delle tabelle del dizionario dei dati. Le parole riservate di diapason X sono vietate.

Riquadro

  • Campo (campo CODZONE)

Corrisponde al nome del campo nella tabella del database (questo nome è automaticamente completato da "_0").

  • Descrizione (campo INTITCOURT)

Descrizione associata al codice precedente.

  • S/N (campo SELECT)

Se si rispondeSì sulla riga, si trasferisce il campo selezionato con le sue caratteristiche (tipo, lunghezza....) verso la videata a partire dalla quale la funzione di selezione è stata richiamata.

Da notare che, tramita clic destro sulla riga (senza essere inserimento sul campo), è possibile valorizzare aSì  oNo le righe a partire dalla riga corrente.

Chiudi

Questa funzione permette di aggiungere nel riquadro dei campi, a partire dalla riga corrente, dei campi provenienti da una tabella inserita prima nella testata della finestra che si apre (la tabella di origine viene proposta di default).

Vengono applicati dei valori di default sul riquadro delle righe così ripresi:

  • Le caratteristiche principali del campo sono riprese in stampa (titolo, tipo, lunghezza, descrizione, menù locale, tabella diversa...).
  • Dal momento in cui il campo viene caratterizzato da un tipo legato ad un oggetto (o se è di tipo Datao Tabella diversa, questo viene definito come Dimensione padre.
  • Se è ti tipo DCB, viene definito come una Misura.
  • Altrimenti viene definito come una Informazione legata alla dimensione più vicina.

Se dei campi hanno lo stesso titolo di un campo da inserire già esistente, non li si inserisce.

 

Chiudi

 

Bottoni specifici

Questa funzione genera un programma, il cui nome è "WMD" seguito dal codice della tabella, e lo compila. Tale programma viene richiamato automaticamente dai programmi di aggiornamento del datamart.

I seguenti campi sono presenti sulla finestra aperta da questo bottone :

Blocco numero 1

  • campo OBJET

 

  • campo CLES

 

Blocco numero 2

  • Dal dossier (campo DOSORG)

Questo campo permette di definire il dossier a partire dal quale sarà copiata la scheda. Le sintassi possibili sono descritte nell'allegato dedicato.

  • Tutti i dossiers (campo TOUDOS)

Questa opzione permette di copiare la scheda verso tutti i dossier definiti nel dizionario (tabella ADOSSIER della soluzione corrente).

  • Al dossier (campo DOSDES)

Questo campo permette di definire il dossier nel quale sarà copiata la scheda. Le sintassi possibili sono descritte nell'allegato dedicato.

Chiudi

Questo bottone permette di copiare la definizione della scheda da o verso un altro dossier.

Barra di menù

Documentazione / Paragrafi

Questa funzione permette di accedere alla gestione della documentazione, sul primo paragrafo della documentazione (se esiste) associato alla scheda corrente.

Documentazione / Legami

Questa funzione permette di accedere alla gestione dei legami. Questa permette di definire dei collegamenti tra la scheda corrente ed altre schede (ad esempio dei collegamenti tra funzioni e parametri). Questi collegamenti, puramente informativi, permettono di alimentare il meccanismo di generazione degli scheletri di documentazione.

Documentazione / Generazione

Questo menù permette di lanciare una generazione di documentazione. La generazione può essere lanciata anche partendo dal bottone [Generazione] nella parte inferiore della finestra.

Possono essere lanciati tre tipi di generazione, separatamente o simultaneamente:

  • la generazione dello scheletro di documentazione partendo dal dizionario (tabelle ADOCUMENT, ADOCBLB, ADOCCLB).
  • la generazione della documentazione partendo dalle tabelle precedenti.
  • la generazione della documentazione su campo.

Gli intervalli proposti di default tengono conto della scheda in corso, ma possono essere modificati in fase di lancio.

Messaggi di errore

Non esistono messaggi di errore ad eccezione di quelli generici.

Tabelle utilizzate

SEEREFERTTO Riferirsi alla documentazione di Implementazione