wiki

Il ReaderId è l'indice che identifica in modo univoco una riga in una Grid.
Se nella querry che viene passata alla Grid non è presente un Indice, il ReaderId viene automaticamente assegnato e assume valori in ordine Crescente.

Esempi:

1)

         SELECT * FROM DIPENDENTI

In questo caso abbiamo preso tutto, compreso l'indice, e l'indice della griglia che verrà creata sarà lo stesso della tabella DIPENDENTI

2) Se invece prendiamo solo determinati campi dalla tabella DIPENDENTI:

         SELECT CODICEDIPENDENTE,COGNOME,NOME FROM DIPENDENTI

L'indice della griglia che verrà creata sarà assegnato automaticamente in ordine crescente.

Ma se per qualche motivo nella griglia si vuole utilizzare un Indice differente dall'indice definito nella tabella sarà necessario definire un ReaderId :

• 1) Nel model della grid inserire l'attributo: readerId:'Key'

Dove 'Key' rappresenta il nome della nostra chiave/indice.

Esempio:

• 2) Nel programma, al momento della creazione della griglia, dovremo aggiungere all'array della griglia il 'rowIndex'⇒'Key',(Sempre utilizzando la stessa Key definita nel Model) per specificare quale sarà l'indice che dovrà utilizzare:

                       $sql=$this->CreaSql();
                        $ita_grid01 = new TableView($this->gridDitta,
                                array(
                                        'sqlDB' =>  $this->DITTA_DB,
                                        'sqlQuery' => $sql,
                                        'rowIndex' => 'KEY'));
                        $ita_grid01->setPageNum(1);
                        $ita_grid01->setPageRows(20000);
                        $ita_grid01->setSortIndex('COGNOME');
                        $ita_grid01->setSortOrder('asc');
                        ....

Se nella select quindi specificheremo ad esempio:

               SELECT *,CODICEDIPENDENTE AS KEY FROM DIPENDENTI

Avremo come indice il Codice del Dipendente.

Nel Caso in cui vogliamo Elaborare il risultato della nostra tabella per un qualsiasi motivo, come ad esempio l'evidenziare in rosso il numero di telefono di un dipendente e in verde quello di cellulare, o una qualsiasi altro tipo di rielaborazione del risultato nella griglia, possiamo ricorrere alla Funzione “Elabora Record”.
Questo tipo di funzione ci permette di Rielaborare l'Output che otterremo nelle celle della griglia, come questo:

Per ottenere un'elaborazione di record dovremo:

• 1) Creare la Funzione di rielaborazione:

function elaboraRecords($Result_tab) {
        foreach ($Result_tab as $key => $Result_rec) {
            $Result_tab[$key]['TELEFONO'] ="<p style = 'background-color:#FF00FF;'>".$Result_tab[$key]['TELEFONO']."</p>";
            $Result_tab[$key]['CELLULARE'] = "<p style = 'background-color:#008800;'>".$Result_tab[$key]['CELLULARE']."</p>";
        }
        return $Result_tab;
    }

In questa funzioene viene passato l'array con il risultato della Querry: “SELECT * FROM DIPENDENT” e per ogni record al campo Telefono e Cellulare assegna uno sfondo Rosso o Verde.
Infine ci facciamo ritornare la Tabella rielaborata: $Result_tab.

• 2) Al momento della creazione della tabella, richiamiamo la funzione appena creata:

                       $sql="SELECT * FROM DIPENDENTI";
                        $ita_grid01 = new TableView($this->gridDitte,
                                array(
                                        'sqlDB' =>  $this->DITTA_DB,
                                        'sqlQuery' => $sql,
                                        'rowIndex' => 'Key'));
                        $ita_grid01->setPageNum(1);
                        $ita_grid01->setPageRows(20000);
                        $ita_grid01->setSortIndex('COGNOME');
                        $ita_grid01->setSortOrder('asc');
                        // Elabora il risultato
                        $Result_tab = $ita_grid01->getDataArray();
                        $Result_tab = $this->elaboraRecords($Result_tab);
                        $ita_grid01->getDataPageFromArray('json', $Result_tab)

Come possiamo notare la griglia viene creata utilizzando l'Array Rielaborato: $ita_grid01→getDataPageFromArray('json', $Result_tab).


Nel caso in cui la SELECT preveda una JOIN con più tabelle e non si ha la possibilità di selezionare un determinato indice da una TABELLA sarà necessario ricorre ad un ElaboraRecords e la creazione di un ReaderId composto da più Campi. Questa funzione è necessaria sopratutto con la JOIN di più tabelle, perchè non sempre è possibile selezionare un solo campo: Immaginiamo di avere 2 tabelle una ANAGRAFICA_SOGGETTO e ANAGRAFICA_IMMOBILE e che entrambe racchiudono tanti campi anagrafici importanti,troppi per essere selezionati uno ad uno. La soluzione più semplice sarebbe:

             SELECT * FROM ANAGRAFICA_SOGGETTO JOIN ANAGRAFICA_IMMOBILE ON ANAGRAFICA_SOGGETTO.CODICE = ANAGRAFICA_IMMOBILE.CODICESOGGETTO

Il risultato della tabella avrebbe quindi in comune anche gli indici delle 2 tabelle.Come detto prima la griglia prende automaticamente l'indice della tabella, se si prendono tutti i campi presenti o comunque si seleziona anch'esso, ma nel caso di una JOIN come questa verrebbe

Se invece si vuole creare un ROWID che racchiuda più campi, o semplicemente non riusciamo a farci tornare un determinato rowid, è necessario:

• Nell'applicazione, al momento della creazione della grid, dovremo rielaborare il risultato della querry e passare alla tabella un Array.

Esempio:
In una tabella abbiamo: TABELLA: OPERAI JOIN PRODUZIONI

Le tabelle senza JOIN :

TABELLA: PRODUZIONI

TABELLA: OPERAI

Vogliamo che all'evento dbClickRow su una riga vengano elencati tutti i prodotti creati di quel operaio a quella data, portandoci dietro la data e codice del dipendente.

Dopo aver aggiunto nella gird del model il ReaderId e nell'applicazione il 'rowIndex' ⇒ 'Key' (come sopra descritto), nel programma dovremo anche provvedere alla Rielaborazione del risultato della Querry.
Questa rielaborazione la possiamo fare tramite una funzione:

                       $sql=$this->CreaSql();
                        $ita_grid01 = new TableView($this->gridDitte,
                                array(
                                        'sqlDB' =>  $this->DITTA_DB,
                                        'sqlQuery' => $sql,
                                        'rowIndex' => 'Key'));
                        $ita_grid01->setPageNum(1);
                        $ita_grid01->setPageRows(20000);
                        $ita_grid01->setSortIndex('COGNOME');
                        $ita_grid01->setSortOrder('asc');
                        // Elabora il risultato
                        $Result_tab = $ita_grid01->getDataArray();
                        $Result_tab = $this->elaboraRecords($Result_tab);
                        $ita_grid01->getDataPageFromArray('json', $Result_tab)

La funzione elaboraRecords. In questa funzione provvederemo a rielaborare il nostro nuovo Rowid: 'Key' componendolo di “CODICEDIPENDENTE” - “DATA”, in che quando faremo doppio click sulla riga selezionata il nostro rowid torni ad esempio: “001-20130122”.

  function elaboraRecords($Result_tab) {
        foreach ($Result_tab as $key => $Result_rec) {
            $Result_tab[$key]['Key'] = $Result_tab[$key]['CODICE'] . "-" . $Result_tab[$key]['DATA'];
          
        }
        return $Result_tab;
    }

Al doppio click per ottenere i dati che ci servono dal rowid potremo utilizzare la funzione: explode: L'explode ci restituirà quindi un array con le 2 chiavi che ci servono:

 switch ($_POST['id']) {
                case  $this->nameForm . '_gridOperai':
                       $chiavi=explode("-", $_POST['rowid']);
                       $Codice=$chiavi['0'];
                       $Data=$chiavi['1'];
                       $sql=" SELECT * FROM PRODOTTI WHERE CODICEDIPENDENTE = $Codice AND DATA = '$Data'";
                       $ita_grid01 = new TableView($this->gridPresenzeFiere,
                                    array(
                                        'sqlDB' => $this->DITTA_DB,
                                        'sqlQuery' => $sql));
                        $ita_grid01->setPageNum(1);
                        $ita_grid01->setPageRows(20000);
                        $ita_grid01->setSortIndex($_POST['sidx']);
                        $ita_grid01->setSortOrder($_POST['sord']);
                        $ita_grid01->getDataPage('json');
                    break;
                }
                break;