Il file PXF: l'equivalente software del sistema "plug and play" – un caso d'uso per la modifica di database

Qualche settimana fa, vi abbiamo presentato il formato Portable XML Form (PXF), un formato di file in cui tutti gli elementi di progettazione che supportano un progetto StyleVision, inclusi gli schemi XML e i documenti di istanza, i file di progettazione SPS, XSLT, immagini e altri file esterni, sono integrati. Gli utenti finali possono semplicemente aprire il file PXF in Authentic e possono iniziare immediatamente a modificare i dati XML e del database.

In questo articolo, creeremo un modulo elettronico che gli utenti aziendali potranno utilizzare per registrare le donazioni e inserire nuovi donatori per un'organizzazione di beneficenza fittizia chiamata Green Planet Fund. Il nuovo formato di file PXF di Altova è un grande vantaggio sia per gli sviluppatori che per gli utenti finali: il file PXF può essere trasportato, scaricato, copiato e salvato come qualsiasi altro documento d'ufficio, aumentando sia l'efficienza che la precisione delle implementazioni. Gli sviluppatori non devono più inviare o installare più file, né creare un'applicazione server per supportare un progetto, e gli utenti aziendali possono distribuire rapidamente e in modo affidabile informazioni aziendali importanti. Questo è particolarmente vero nelle organizzazioni distribuite, dove i dati aziendali devono essere inviati via e-mail tra diverse sedi o tra i dipendenti sul campo e i loro colleghi nella sede centrale. Un file PXF che supporta moduli elettronici progettati con StyleVision e modificati dagli utenti aziendali con Authentic rende la modifica dei dati aziendali estremamente semplice. Nella maggior parte dei casi, i dati aziendali saranno contenuti direttamente all'interno del file PXF come un documento XML incorporato, ma è anche possibile collegare un file PXF a un server di database e memorizzare i dati direttamente nel database, come dimostra il seguente esempio.

Per questo esempio, utilizzeremo StyleVision per creare un modulo elettronico in cui gli utenti aziendali potranno registrare le donazioni e inserire nuovi donatori per il fittizio fondo Green Planet. Gli utenti finali interagiscono con questi moduli all'interno dell'editor Authentic WYSIWYG, un'interfaccia sofisticata simile a un elaboratore di testi che consente agli utenti di acquisire, visualizzare e aggiornare contenuti XML e di database. Una volta che si fa clic su "File", "Nuovo da DB" in StyleVision, viene avviato il "Wizard di connessione". Basta selezionare il tipo di database e si verrà guidati nella ricerca della sorgente dati.

Qui, abbiamo identificato il database "DonorsDatabase" presente sul server "MARKETING006SQLEXPRESS". La stringa di connessione viene salvata automaticamente con il file di progettazione e viene ristabilita ogni volta che un utente aziendale accede al modulo in Authentic. Il database viene aggiornato con le informazioni che l'utente aziendale inserisce nel modulo di Authentic.

Una volta stabilita la connessione, è possibile selezionare tabelle, viste dati e persino istruzioni SQL SELECT nella finestra di dialogo "Inserisci oggetti del database".

Per questo esempio, abbiamo aggiunto un'istruzione SQL SELECT (di seguito) che concatena il titolo del donatore, il nome e il cognome, e calcola l'importo totale donato da ciascun donatore. Una volta che si fa clic su "Aggiungi istruzione SELECT", l'istruzione SQL SELECT diventa disponibile all'interno del progetto StyleVision, come si può vedere nell'immagine sopra.

Si prega di notare che abbiamo utilizzato Altova DatabaseSpy, uno strumento multibase di interrogazione, progettazione e confronto di database, per creare la nostra istruzione SQL. Sebbene sia possibile esportare i dati dall'editor SQL di DatabaseSpy in diversi formati, per questo esempio abbiamo semplicemente copiato l'istruzione SELECT da DatabaseSpy nella finestra della finestra di dialogo "SQL SELECT" in StyleVision. StyleVision genera uno schema XML temporaneo basato sulla struttura del database e lo visualizza nella finestra dello schema. Si noti che sia le tabelle "Contributions" e "Donors" che la nostra istruzione SQL SELECT appaiono nell'albero dello schema.

Durante questa trasformazione, StyleVision crea file XML interni: uno non modificabile, utilizzato per le anteprime e come fonte dei dati XML generati, e un file XML modificabile che scriverà le modifiche nel database. Ora che abbiamo stabilito e salvato la stringa di connessione al database, siamo pronti a progettare il modulo elettronico che Green Planet Fund utilizzerà per aggiungere nuovi donatori e registrare le donazioni. Per questo esempio, abbiamo creato due tabelle semplici in StyleVision: una per registrare le donazioni e un'altra per cercare e aggiungere donatori. (Si prega di notare che il nostro esempio è solo a scopo illustrativo e abbiamo mostrato solo un piccolo campione dei campi che includeremmo tipicamente in un'applicazione reale. Anche la funzionalità è molto meno sofisticata di quanto sarebbe in un progetto reale.) Abbiamo effettuato le seguenti modifiche al nostro progetto:

  • Abbiamo creato un frammento di progetto con una tabella per inserire nuovi donatori e una tabella dei donatori registrati, popolata dinamicamente.
  • Abbiamo aggiunto una casella di controllo che, quando selezionata, mostrerà la tabella dei donatori registrati e la tabella di inserimento dati dal frammento di progetto.
  • Abbiamo modificato le proprietà "Authentic" della tabella dei donatori registrati per recuperare tutti i record.
  • Abbiamo modificato le proprietà "Authentic" della tabella di inserimento dati per recuperare solo un record, per facilitare l'inserimento dei dati.
  • Abbiamo utilizzato XPath per concatenare il titolo, il nome e il cognome di ciascun donatore nella tabella dei donatori registrati, utilizzando la funzione "normalize-space" per rimuovere tutti gli spazi bianchi.
  • Abbiamo utilizzato la formattazione dei valori (vedi sotto) per formattare la data della donazione; questo consente anche all'utente finale di modificare la data tramite un'interfaccia calendario in Authentic.

Si noti che il frammento di progettazione "DonorList" è racchiuso all'interno dei tag DB ed è rappresentato come un singolo elemento. Il frammento di progettazione stesso si trova nella parte inferiore del progetto.

Cliccando sulle schede situate accanto alla scheda "Progettazione", è possibile visualizzare il report in diversi formati. Qui abbiamo presentato la visualizzazione "Autentica".

Si noti che il progetto è ancora nel formato standard SPS (greenplanetdonorsII.sps). Ora siamo pronti a salvarlo in formato PXF, in modo che possa essere inviato via e-mail al cliente e implementato immediatamente una volta ricevuto. Dopo aver selezionato "File" e poi "Salva come" dal menu in alto, è possibile scegliere se salvare il progetto in formato SPS o PXF.

Quando si salva un file in formato PXF, viene richiesto di selezionare i file da includere nel file PXF. Tutti i file compatibili con il design StyleVision sono automaticamente disponibili nella finestra di dialogo.

Qui, abbiamo verificato tutti gli elementi di progettazione, così come i file XSLT. Questo permetterà agli utenti finali di generare output dal modulo progettato con StyleVision in ciascuno di questi formati, direttamente da Authentic. Si prega di notare che è anche possibile includere file aggiuntivi. Sebbene questo progetto non richieda altri file, questa funzionalità semplifica notevolmente la gestione e la distribuzione di progetti che ne richiedono diversi. Ora potete inviare il file PXF che avete appena creato al cliente. Tutti i file del progetto, così come la stringa di connessione al database, sono inclusi nel file PXF, in modo che, una volta che l'utente finale lo apre in Authentic, possa immediatamente iniziare a visualizzare, modificare e inserire dati. Per creare una nuova voce in Authentic, posizionate il cursore in uno dei campi della tabella "contributi" nel modulo e cliccate sul pulsante "Aggiungi riga" nella barra degli strumenti. (In alternativa, potete selezionare "Authentic" nel menu in alto e poi "Aggiungi riga".)

Ora, l'utente aziendale può inserire contributi (i nuovi dati sono evidenziati in grassetto)

...e nuovi donatori.

Si prega di notare che nel database SQL Server, l'ID del donatore è un campo generato automaticamente. Una volta che l'utente finale fa clic su "File" -> "Salva" nel menu in alto, le nuove informazioni vengono inviate al database, il database genera un numero di ID e le nuove informazioni vengono inserite nelle altre tabelle del modulo. (Come indicato sopra, i dati vengono inseriti in tempo reale). Le modifiche e le aggiunte vengono immediatamente scritte nel database. La vista del database SQL Server mostrata di seguito indica che Edward e Julie Jay, che abbiamo appena aggiunto al modulo "Authentic", sono stati assegnati all'ID del donatore 18.

Sebbene non l'abbiamo incluso qui, il modulo può essere progettato per generare un messaggio di errore quando l'utente tenta di salvare un nuovo donatore senza almeno un nome e un cognome. Questo può essere realizzato utilizzando XPath nella proprietà di validazione aggiuntiva delle proprietà di autenticazione, oppure creando un vincolo nel database SQL Server. Questo caso d'uso è stato progettato per dimostrare quanto sia facile creare e implementare moduli interattivi. I moduli elettronici progettati con StyleVision sono sempre stati un ottimo modo per aggiornare sia i contenuti XML che quelli del database; il file PXF semplifica semplicemente il processo di trasporto e implementazione.