crosstab — u_pbt_crosstab #

← Riferimento dei componenti · Sommario della guida

Tabella crosstab completa: aree righe / colonne / valori alimentate da un DataStore, aggregazioni, filtri, formattazione condizionale, raggruppamento di date, misure calcolate ed esportazioni CSV / Excel.

▶ Vederlo dal vivo — Applicazione dimostrativa, riquadro Crosstab: l'anteprima, il codice che lo produce e questa pagina, affiancati.

In breve #

Il principio #

Lei fornisce al componente un insieme di dati piatto — un DataStore, quindi qualsiasi query già scritta nella sua applicazione. Al resto pensa il crosstab: ne deduce l'elenco dei campi e Lei li distribuisce in quattro aree.

Tutto il calcolo avviene nel componente: una volta trasmessi i dati, riorganizzare la tabella non provoca alcun viaggio di andata e ritorno verso il database né verso PowerBuilder.

Avvio rapido #

// event open della finestra
datastore lds
lds = create datastore
lds.dataobject = "d_ventes"
lds.SetTransObject(SQLCA)
lds.Retrieve()

// 1. Trasmettere i dati: i campi sono dedotti dalle colonne
uo_croise.of_set_data(lds)

// 2. Distribuire i campi nelle aree
uo_croise.of_add_row_field(/*campo*/ "region")
uo_croise.of_add_col_field(/*campo*/ "annee")
uo_croise.of_add_value_field(/*campo*/ "montant", /*aggregazione*/ uo_croise.AGG_SUM)

// 3. Presentare: formato degli importi e totali generali
uo_croise.of_set_value_format(/*campo*/ "montant", /*decimali*/ 0, /*migliaia*/ "locale", /*simbolo*/ "$", /*simbolo_prima*/ true)
uo_croise.ib_row_grand_total = true
uo_croise.ib_col_grand_total = true

// event ue_cell_double_clicked di uo_croise: (string as_row_tuple_json, string as_col_tuple_json, double ad_value)
// L'utente vuole il dettaglio dietro una cifra: aprire l'elenco corrispondente.
of_ouvrir_detail(as_row_tuple_json, as_col_tuple_json)

Costanti #

Le costanti di aggregazione si leggono sul componente: uo_croise.AGG_SUM. Quelle di un campo (SHOW_*, CF_*) si leggono sull'handle del campo.

Proprietà #

Proprietà di un campo #

of_field (string as_field) restituisce l'handle di un campo: lo recupera una volta, poi pilota il campo attraverso le sue proprietà. L'handle viene creato alla prima chiamata e riutilizzato in seguito.

I valori di is_show e is_conditional_formatting sono disponibili anche come costanti sull'handle (SHOW_PCT_COL, CF_SCALE…).

n_pbt_crosstab_field lnv_champ

lnv_champ = uo_croise.of_field(/*campo*/ "montant")
lnv_champ.is_label = "Fatturato"
lnv_champ.is_conditional_formatting = lnv_champ.CF_SCALE

⚠️ Modifica non retrocompatibile. Questa proprietà si chiamava is_cf: l'abbreviazione non diceva nulla nel punto di chiamata. Il vecchio nome non esiste più: un codice che lo utilizza non compila. La sostituzione è meccanica: is_cf → is_conditional_formatting, senza alcun cambiamento di valori né di comportamento.

Metodi #

Alimentare e denominare #

Costruire la tabella #

Le aggregazioni accettate da of_add_value_field sono esposte dal componente come costanti: AGG_SUM (predefinito), AGG_COUNT, AGG_DISTINCT_COUNT (conteggio di valori distinti), AGG_AVG, AGG_MIN, AGG_MAX.

Totali e subtotali #

Filtrare #

Formattare #

Date e campi calcolati #

Una formula accetta gli operatori + - * / ( ), numeri e campi tra parentesi quadre. Una formula non valida attiva ue_calc_field_error — nulla va in crash.

Espandere, memorizzare, esportare #

Comuni #

Event #

Che cosa può fare l'utente senza una riga di codice #

La tabella è viva: è tutto l'interesse del componente. Con il pannello dei campi visualizzato (ib_field_list = true), l'utente può:

• trascinare un campo da un'area all'altra e riorganizzare l'incrocio a piacimento;
• cambiare l'aggregazione di una misura (somma, media, conteggio…);
• filtrare i valori di un campo tramite un elenco con caselle di spunta;
• comprimere o espandere un gruppo di righe o di colonne;
• ordinare da un'intestazione;
• selezionare e poi copiare un blocco di celle.

Ognuna di queste manipolazioni viene segnalata in ue_layout_changed: unita a of_get_layout / of_set_layout, permette di offrire ai suoi utenti delle « viste salvate ».

Da tastiera. Ognuno di questi gesti è raggiungibile senza mouse: Tab porta su un campo, su un triangolo di chiusura o su un'intestazione ordinabile, Invio o Spazio lo attiva. Su un campo si apre il suo menu — quello che porta Aggiungi alle righe / alle colonne / ai valori / ai filtri e Rimuovi: tutta la costruzione della tabella passa di lì.

Esempi #

Un rapporto vendite completo #

// Righe: regione, poi citta all'interno di ogni regione
uo_croise.of_clear_layout()
uo_croise.of_add_row_field(/*campo*/ "region")
uo_croise.of_add_row_field(/*campo*/ "ville")

// Colonne: una per anno
uo_croise.of_add_col_field(/*campo*/ "annee")

// Celle: l'importo totale
uo_croise.of_add_value_field(/*campo*/ "montant", /*aggregazione*/ uo_croise.AGG_SUM)

// Presentazione: importi leggibili, subtotali e totali generali
uo_croise.of_set_value_format(/*campo*/ "montant", /*decimali*/ 0, /*migliaia*/ "locale", /*simbolo*/ "$", /*simbolo_prima*/ true)
uo_croise.ib_row_subtotals = true
uo_croise.ib_row_grand_total = true
uo_croise.ib_col_grand_total = true

// Colorare le celle per individuare i grandi importi a colpo d'occhio
uo_croise.of_field(/*campo*/ "montant").is_conditional_formatting = n_pbt_crosstab_field.CF_SCALE

Etichette leggibili #

Le sue colonne si chiamano spesso mt_ht o cd_reg. Le rinomini una volta per tutte, subito dopo of_set_data.

uo_croise.of_set_data(lds)

uo_croise.of_field("region").is_label    = "Regione"
uo_croise.of_field("ville").is_label     = "Città"
uo_croise.of_field("categorie").is_label = "Categoria"
uo_croise.of_field("annee").is_label     = "Anno"
uo_croise.of_field("montant").is_label   = "Fatturato"
uo_croise.of_field("quantite").is_label  = "Quantità"

Analizzare quote anziché importi #

n_pbt_crosstab_field lnv_montant

uo_croise.of_clear_layout()
uo_croise.of_add_row_field(/*campo*/ "categorie")
uo_croise.of_add_col_field(/*campo*/ "annee")
uo_croise.of_add_value_field(/*campo*/ "montant", /*aggregazione*/ uo_croise.AGG_SUM)

// Tenere solo due categorie sullo schermo (valori separati da una tabulazione)
uo_croise.of_set_member_filter(/*campo*/ "categorie", /*valori*/ "Informatique~tMobilier")

lnv_montant = uo_croise.of_field(/*campo*/ "montant")

// Mostrare la quota di ogni cella nel totale della sua colonna
lnv_montant.is_show = lnv_montant.SHOW_PCT_COL

// Una piccola barra in ogni cella per confrontare le quote a colpo d'occhio
lnv_montant.is_conditional_formatting = lnv_montant.CF_BARS

Una misura tutta sua: il prezzo medio #

Una misura calcolata si valuta sui totali di ogni cella, non riga per riga: è ciò che rende corretto un rapporto.

uo_croise.of_clear_layout()
uo_croise.of_add_row_field(/*campo*/ "region")

// I due totali che serviranno da base al calcolo
uo_croise.of_add_value_field(/*campo*/ "montant",  /*aggregazione*/ uo_croise.AGG_SUM)
uo_croise.of_add_value_field(/*campo*/ "quantite", /*aggregazione*/ uo_croise.AGG_SUM)

// Prezzo medio = importo totale diviso per la quantita totale
uo_croise.of_add_calc_measure(/*nome*/ "prix_moyen", /*etichetta*/ "Prezzo medio", &
                              /*formula*/ "[montant] / [quantite]")
uo_croise.of_set_value_format(/*campo*/ "prix_moyen", /*decimali*/ 2, /*migliaia*/ "locale", /*simbolo*/ "$", /*simbolo_prima*/ true)

// Poi metterla tra i valori come qualsiasi campo (l'aggregato non conta: una misura si calcola)
uo_croise.of_add_value_field(/*campo*/ "prix_moyen", /*aggregato*/ uo_croise.AGG_SUM)

// event ue_calc_field_error di uo_croise: (string as_field, string as_message)
// Formula non valida: avvisare senza rompere nulla, la tabella resta visualizzata.
uo_statut.of_item("main").is_text = "Formula " + as_field + " : " + as_message

Analizzare per mese, trimestre o anno #

Una colonna data non si incrocia così com'è — ogni giorno formerebbe una riga a sé. Derivi prima il livello desiderato.

// Creare tre campi derivati dalla colonna date_vente
uo_croise.of_group_date_field(/*campo*/ "date_vente", /*livello*/ "year")
uo_croise.of_group_date_field(/*campo*/ "date_vente", /*livello*/ "quarter")
uo_croise.of_group_date_field(/*campo*/ "date_vente", /*livello*/ "month")

// Poi incrociarli come qualsiasi altro campo: anno in colonne, trimestre sotto
uo_croise.of_add_col_field("date_vente__year")
uo_croise.of_add_col_field("date_vente__quarter")

La classifica delle dieci migliori regioni #

// Tenere solo le 10 regioni con il totale piu alto sulla prima misura
uo_croise.of_set_value_filter(/*campo*/ "region", /*tipo*/ "top", &
                              /*a*/ 10, /*b*/ 0, /*misura*/ 1)

Esportare #

L'esportazione riprende esattamente la vista corrente: stessi filtri, stessi totali, stessa formattazione.

// Verso Excel: il file viene scritto direttamente nel percorso indicato
uo_croise.of_export_xlsx("C:\temp\ventes.xlsx")

// event ue_xlsx_saved di uo_croise: (string as_path, boolean ab_ok, string as_error)
// inv_notif = un n_pbt_toaster dichiarato come variabile d'istanza della finestra
if ab_ok then
    inv_notif.is_title = "Esportazione completata"
    inv_notif.is_text  = as_path
    inv_notif.is_kind  = inv_notif.KIND_SUCCESS
else
    inv_notif.is_title = "Esportazione impossibile"
    inv_notif.is_text  = as_error
    inv_notif.is_kind  = inv_notif.KIND_ERROR
end if
inv_notif.of_show()

// Verso CSV: un file, come per Excel; ue_csv_saved conferma
uo_croise.of_export_csv(/*percorso*/ "C:\exports\ventes.csv")

Offrire viste salvate #

string ls_vue

// Salvare la vista corrente : of_get_layout risponde subito
ls_vue = uo_croise.of_get_layout()

// Conservare il contenuto COSI COM E : si riproduce senza trasformazioni.
of_enregistrer_vue(is_vue_courante, ls_vue)

// Piu tardi: riprodurre una vista salvata
uo_croise.of_set_layout(of_lire_vue("Ventes par region"))

Scendere al dettaglio dietro una cifra #

// event ue_cell_double_clicked di uo_croise: (string as_row_tuple_json, string as_col_tuple_json, double ad_value)
// I primi due argomenti descrivono l'incrocio (quali valori di righe,
// quali valori di colonne): quanto basta per ricostruire una query di dettaglio.
w_detail_ventes lw_detail

OpenWithParm(lw_detail, as_row_tuple_json + "|" + as_col_tuple_json)

Buone pratiche #

• Chiami of_set_data una sola volta per insieme di dati: riorganizzare la tabella in seguito non costa nulla, ritrasmettere i dati costa caro.
• Imposti le etichette (of_field("...").is_label) subito dopo of_set_data: seguono il campo dappertutto, anche nel pannello dei campi e nelle esportazioni.
• Filtri lato SQL ciò che non è destinato a essere analizzato: il crosstab è rapido, ma un DataStore due volte più piccolo si apre due volte più in fretta.
• of_clear_layout() svuota le aree senza ritrasmettere i dati: è la chiamata giusta per proporre più analisi sulla stessa origine.
• Un campo data si incrocia sempre tramite of_group_date_field, mai direttamente.
• Lasci il pannello dei campi visibile sulle schermate di analisi, lo nasconda sui cruscotti fissi.

Ereditato dalla base comune #

Questi membri esistono su tutti i componenti visivi — non sono propri di questo. Sono descritti una sola volta, nei capitoli trasversali; questa tabella dice solo dove leggerli.

Due aiuti non sono ereditati: of_icon e of_escape_markup vivono su n_pbt_utils. Ne dichiari uno — n_pbt_utils lnv_utils, niente da creare — e li chiami su di esso.

← Riferimento dei componenti · Sommario della guida