crosstab — u_pbt_crosstab #

← Komponentenreferenz · Inhalt des Handbuchs

Vollständige Crosstab-Tabelle: Bereiche für Zeilen / Spalten / Werte, gespeist aus einem DataStore, Aggregate, Filter, bedingte Formatierung, Datumsgruppierung, berechnete Kennzahlen und Exporte nach CSV / Excel.

▶ Live ansehen — Demoanwendung, Kachel Crosstab: die Vorschau, der zugehörige Code und diese Seite, nebeneinander.

Auf einen Blick #

Das Prinzip #

Sie übergeben der Komponente einen flachen Datenbestand — einen DataStore, also jede beliebige Abfrage, die in Ihrer Anwendung bereits geschrieben ist. Um den Rest kümmert sich das Crosstab: Es leitet daraus die Feldliste ab, und Sie verteilen die Felder auf vier Bereiche.

Die gesamte Berechnung findet in der Komponente statt: Sind die Daten einmal übergeben, löst das Umstellen der Tabelle keinen einzigen Rückweg zur Datenbank oder zu PowerBuilder aus.

Schnellstart #

// Event open des Fensters
datastore lds
lds = create datastore
lds.dataobject = "d_ventes"
lds.SetTransObject(SQLCA)
lds.Retrieve()

// 1. Daten uebergeben: die Felder werden aus den Spalten abgeleitet
uo_croise.of_set_data(lds)

// 2. Die Felder auf die Bereiche verteilen
uo_croise.of_add_row_field(/*Feld*/ "region")
uo_croise.of_add_col_field(/*Feld*/ "annee")
uo_croise.of_add_value_field(/*Feld*/ "montant", /*Aggregat*/ uo_croise.AGG_SUM)

// 3. Darstellen: Format der Betraege und Gesamtsummen
uo_croise.of_set_value_format(/*Feld*/ "montant", /*Dezimalstellen*/ 0, /*Tausender*/ "locale", /*Symbol*/ "$", /*Symbol_davor*/ true)
uo_croise.ib_row_grand_total = true
uo_croise.ib_col_grand_total = true

// Event ue_cell_double_clicked von uo_croise: (string as_row_tuple_json, string as_col_tuple_json, double ad_value)
// Der Benutzer moechte das Detail hinter einer Zahl: die passende Liste oeffnen.
of_ouvrir_detail(as_row_tuple_json, as_col_tuple_json)

Konstanten #

Die Aggregat-Konstanten werden auf der Komponente gelesen: uo_croise.AGG_SUM. Die eines Feldes (SHOW_*, CF_*) werden auf dem Handle des Feldes gelesen.

Eigenschaften #

Eigenschaften eines Feldes #

of_field (string as_field) liefert das Handle eines Feldes: Sie holen es einmal und steuern das Feld anschließend über seine Eigenschaften. Das Handle wird beim ersten Aufruf erzeugt und danach wiederverwendet.

Die Werte von is_show und is_conditional_formatting stehen auch als Konstanten auf dem Handle zur Verfügung (SHOW_PCT_COL, CF_SCALE…).

n_pbt_crosstab_field lnv_champ

lnv_champ = uo_croise.of_field(/*Feld*/ "montant")
lnv_champ.is_label = "Umsatz"
lnv_champ.is_conditional_formatting = lnv_champ.CF_SCALE

⚠️ Inkompatible Änderung. Diese Eigenschaft hieß is_cf: Die Abkürzung sagte an der Aufrufstelle nichts aus. Der alte Name existiert nicht mehr — Code, der ihn verwendet, lässt sich nicht kompilieren. Die Ersetzung ist mechanisch: is_cf → is_conditional_formatting, ohne Änderung der Werte oder des Verhaltens.

Methoden #

Speisen und benennen #

Die Tabelle aufbauen #

Die von of_add_value_field akzeptierten Aggregate werden von der Komponente als Konstanten bereitgestellt: AGG_SUM (Standard), AGG_COUNT, AGG_DISTINCT_COUNT (Zählung eindeutiger Werte), AGG_AVG, AGG_MIN, AGG_MAX.

Summen und Zwischensummen #

Filtern #

Formatieren #

Datumsangaben und berechnete Felder #

Eine Formel akzeptiert die Operatoren + - * / ( ), Zahlen und Felder in eckigen Klammern. Eine ungültige Formel löst ue_calc_field_error aus — nichts stürzt ab.

Aufklappen, speichern, exportieren #

Gemeinsame #

Events #

Was der Benutzer ohne eine einzige Zeile Code tun kann #

Die Tabelle ist lebendig: Genau darin liegt der Sinn der Komponente. Bei eingeblendetem Feldpanel (ib_field_list = true) kann der Benutzer:

• ein Feld von einem Bereich in einen anderen ziehen und die Kreuzauswertung beliebig umstellen;
• das Aggregat einer Kennzahl ändern (Summe, Mittelwert, Anzahl…);
• die Werte eines Feldes über eine Ankreuzliste filtern;
• eine Zeilen- oder Spaltengruppe ein- oder ausklappen;
• über eine Kopfzeile sortieren;
• einen Zellblock auswählen und kopieren.

Jede dieser Aktionen wird in ue_layout_changed gemeldet: Zusammen mit of_get_layout / of_set_layout können Sie Ihren Benutzern damit „gespeicherte Ansichten“ anbieten.

Über die Tastatur. Jede dieser Gesten ist ohne Maus erreichbar: Tab führt auf ein Feld, ein Zuklapp-Dreieck oder eine sortierbare Kopfzeile, Eingabe oder Leertaste löst sie aus. Auf einem Feld öffnet das dessen Menü — jenes mit Zu Zeilen / Spalten / Werten / Filtern hinzufügen und Entfernen: der gesamte Aufbau der Tabelle läuft darüber.

Beispiele #

Ein vollständiger Vertriebsbericht #

// Zeilen: Region, dann Stadt innerhalb jeder Region
uo_croise.of_clear_layout()
uo_croise.of_add_row_field(/*Feld*/ "region")
uo_croise.of_add_row_field(/*Feld*/ "ville")

// Spalten: eine je Jahr
uo_croise.of_add_col_field(/*Feld*/ "annee")

// Zellen: der Gesamtbetrag
uo_croise.of_add_value_field(/*Feld*/ "montant", /*Aggregat*/ uo_croise.AGG_SUM)

// Darstellung: lesbare Betraege, Zwischen- und Gesamtsummen
uo_croise.of_set_value_format(/*Feld*/ "montant", /*Dezimalstellen*/ 0, /*Tausender*/ "locale", /*Symbol*/ "$", /*Symbol_davor*/ true)
uo_croise.ib_row_subtotals = true
uo_croise.ib_row_grand_total = true
uo_croise.ib_col_grand_total = true

// Die Zellen einfaerben, um grosse Betraege auf einen Blick zu erkennen
uo_croise.of_field(/*Feld*/ "montant").is_conditional_formatting = n_pbt_crosstab_field.CF_SCALE

Lesbare Bezeichnungen #

Ihre Spalten heißen oft mt_ht oder cd_reg. Benennen Sie sie ein für alle Mal um, direkt nach of_set_data.

uo_croise.of_set_data(lds)

uo_croise.of_field("region").is_label    = "Region"
uo_croise.of_field("ville").is_label     = "Stadt"
uo_croise.of_field("categorie").is_label = "Kategorie"
uo_croise.of_field("annee").is_label     = "Jahr"
uo_croise.of_field("montant").is_label   = "Umsatz"
uo_croise.of_field("quantite").is_label  = "Menge"

Anteile statt Beträge auswerten #

n_pbt_crosstab_field lnv_montant

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

// Nur zwei Kategorien auf dem Bildschirm behalten (Werte durch einen Tabulator getrennt)
uo_croise.of_set_member_filter(/*Feld*/ "categorie", /*Werte*/ "Informatique~tMobilier")

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

// Den Anteil jeder Zelle an der Summe ihrer Spalte anzeigen
lnv_montant.is_show = lnv_montant.SHOW_PCT_COL

// Ein kleiner Balken in jeder Zelle, um die Anteile auf einen Blick zu vergleichen
lnv_montant.is_conditional_formatting = lnv_montant.CF_BARS

Eine eigene Kennzahl: der Durchschnittspreis #

Eine berechnete Kennzahl wird auf den Summen jeder Zelle ausgewertet, nicht Zeile für Zeile: Genau das macht ein Verhältnis korrekt.

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

// Die beiden Summen, die als Grundlage der Berechnung dienen
uo_croise.of_add_value_field(/*Feld*/ "montant",  /*Aggregat*/ uo_croise.AGG_SUM)
uo_croise.of_add_value_field(/*Feld*/ "quantite", /*Aggregat*/ uo_croise.AGG_SUM)

// Durchschnittspreis = Gesamtbetrag geteilt durch Gesamtmenge
uo_croise.of_add_calc_measure(/*Name*/ "prix_moyen", /*Bezeichnung*/ "Durchschnittspreis", &
                              /*Formel*/ "[montant] / [quantite]")
uo_croise.of_set_value_format(/*Feld*/ "prix_moyen", /*Dezimalstellen*/ 2, /*Tausender*/ "locale", /*Symbol*/ "$", /*Symbol_davor*/ true)

// Dann wie jedes Feld unter die Werte stellen (das Aggregat zaehlt nicht: eine Kennzahl wird berechnet)
uo_croise.of_add_value_field(/*Feld*/ "prix_moyen", /*Aggregat*/ uo_croise.AGG_SUM)

// Event ue_calc_field_error von uo_croise: (string as_field, string as_message)
// Ungueltige Formel: warnen, ohne etwas zu zerstoeren, die Tabelle bleibt sichtbar.
uo_statut.of_item("main").is_text = "Formel " + as_field + ": " + as_message

Nach Monat, Quartal oder Jahr auswerten #

Eine Datumsspalte lässt sich nicht unverändert kreuzen — jeder einzelne Tag ergäbe eine eigene Zeile. Leiten Sie zuerst die gewünschte Ebene ab.

// Drei aus der Spalte date_vente abgeleitete Felder erzeugen
uo_croise.of_group_date_field(/*Feld*/ "date_vente", /*Ebene*/ "year")
uo_croise.of_group_date_field(/*Feld*/ "date_vente", /*Ebene*/ "quarter")
uo_croise.of_group_date_field(/*Feld*/ "date_vente", /*Ebene*/ "month")

// Dann wie jedes andere Feld kreuzen: Jahr in den Spalten, Quartal darunter
uo_croise.of_add_col_field("date_vente__year")
uo_croise.of_add_col_field("date_vente__quarter")

Die Rangliste der zehn besten Regionen #

// Nur die 10 Regionen mit der hoechsten Summe der ersten Kennzahl behalten
uo_croise.of_set_value_filter(/*Feld*/ "region", /*Typ*/ "top", &
                              /*a*/ 10, /*b*/ 0, /*Kennzahl*/ 1)

Exportieren #

Der Export übernimmt exakt die aktuelle Ansicht: dieselben Filter, dieselben Summen, dieselbe Formatierung.

// Nach Excel: die Datei wird direkt unter dem angegebenen Pfad geschrieben
uo_croise.of_export_xlsx("C:\temp\ventes.xlsx")

// Event ue_xlsx_saved von uo_croise: (string as_path, boolean ab_ok, string as_error)
// inv_notif = ein n_pbt_toaster, als Instanzvariable des Fensters deklariert
if ab_ok then
    inv_notif.is_title = "Export abgeschlossen"
    inv_notif.is_text  = as_path
    inv_notif.is_kind  = inv_notif.KIND_SUCCESS
else
    inv_notif.is_title = "Export nicht möglich"
    inv_notif.is_text  = as_error
    inv_notif.is_kind  = inv_notif.KIND_ERROR
end if
inv_notif.of_show()

// Nach CSV: eine Datei, wie bei Excel; ue_csv_saved bestaetigt
uo_croise.of_export_csv(/*Pfad*/ "C:\exports\ventes.csv")

Gespeicherte Ansichten anbieten #

string ls_vue

// Aktuelle Ansicht sichern : of_get_layout antwortet sofort
ls_vue = uo_croise.of_get_layout()

// Den Inhalt UNVERAENDERT aufbewahren: er wird ohne Umwandlung wieder abgespielt.
of_enregistrer_vue(is_vue_courante, ls_vue)

// Spaeter: eine gespeicherte Ansicht wieder abspielen
uo_croise.of_set_layout(of_lire_vue("Ventes par region"))

Hinter einer Zahl ins Detail gehen #

// Event ue_cell_double_clicked von uo_croise: (string as_row_tuple_json, string as_col_tuple_json, double ad_value)
// Die ersten beiden Argumente beschreiben die Kreuzung (welche Zeilenwerte,
// welche Spaltenwerte): genug, um eine Detailabfrage neu aufzubauen.
w_detail_ventes lw_detail

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

Best Practices #

• Rufen Sie of_set_data nur ein einziges Mal je Datenbestand auf: Die Tabelle danach umzustellen kostet nichts, die Daten erneut zu übergeben ist teuer.
• Setzen Sie die Bezeichnungen (of_field("...").is_label) direkt nach of_set_data: Sie folgen dem Feld überallhin, auch in das Feldpanel und in die Exporte.
• Filtern Sie auf SQL-Seite weg, was nicht ausgewertet werden soll: Das Crosstab ist schnell, aber ein halb so großer DataStore öffnet sich doppelt so schnell.
• of_clear_layout() leert die Bereiche, ohne die Daten erneut zu übergeben: Das ist der richtige Aufruf, um mehrere Auswertungen auf derselben Quelle anzubieten.
• Ein Datumsfeld wird immer über of_group_date_field gekreuzt, niemals direkt.
• Lassen Sie das Feldpanel auf Auswertungsbildschirmen sichtbar und blenden Sie es auf festen Dashboards aus.

Vom gemeinsamen Sockel geerbt #

Diese Mitglieder gibt es bei jeder visuellen Komponente — sie sind nicht dieser eigen. Sie werden einmal in den übergreifenden Kapiteln beschrieben; diese Tabelle sagt nur, wo man sie liest.

Zwei Helfer werden nicht geerbt: of_icon und of_escape_markup liegen auf n_pbt_utils. Deklarieren Sie eines — n_pbt_utils lnv_utils, nichts zu erzeugen — und rufen Sie sie darauf auf.

← Komponentenreferenz · Inhalt des Handbuchs