Tutorial on Genropy

Genropy e Docker: come creare le immagini degli applicativi

Wed, 16 Apr 2025 16:27:00 +0000

Con il rilascio della versione 25.04.10 di Genropy è stato introdotto uno strumento di utilità per la generazione di immagini Docker. Grazie a questo nuovo strumento, è possibile creare un'immagine dell'applicativo e di tutto il necessario per poterla eseguire (package, librerie, e Genropy stesso), senza bisogno di installazioni manuali o configurazioni complesse.

Significa che da oggi abbiamo a disposizione un modo semplice e ripetibile per creare container pronti al deploy , anche automatizzabili in pipeline CI/CD.

Novità: nuova modalità di installazione

Thu, 07 Mar 2024 15:46:17 +0000

Siamo lieti di annunciare una grande novità che semplificherà notevolmente l’installazione di Genropy.

Con il rilascio della versione 24.3 è ora disponibile il nuovo installer , che sostituendosi alla procedura precedente permette di eseguire l’installazione tramite pip , semplificando notevolmente la corretta gestione delle dipendenze sia su Mac che su Windows.

È quindi possibile installare Genropy in due modalità, una “rapida” consigliata per utenti alle prime armi, che vogliono solo testare rapidamente Genropy, e una più “completa”, consigliata per gli sviluppatori abituali che necessitano del codice sorgente a portata di mano.

Come personalizzare le procedure di importazione

Fri, 08 Apr 2022 11:14:44 +0000

Il tema dell'importazione da file Excel è ampiamente diffuso in Genropy, si pensi alla possibilità di importare record di una tabella da file xls o addirittura alla possibilità di creare completamente da zero un intero applicativo proprio da una serie di fogli.

La procedura di importazione consente quindi di popolare le tabelle associando le colonne a quelle di un foglio di calcolo, anche se queste hanno nomi diversi. Supponiamo però di avere bisogno di personalizzare questa procedura di importazione. Potrebbe essere il caso di un’importazione in cui abbiamo dei campi in relazione, per esempio, ed è quindi necessario effettuare delle query preventive, oppure i valori devono essere scritti su più tabelle, devono essere effettuate delle operazioni di controllo o modifica, ecc.

Come integrare un modulo di contatto Wordpress CF7 in Genropy con le API REST

Tue, 22 Feb 2022 11:21:10 +0000

Molto spesso può capitare di voler integrare un applicativo Genropy con delle fonti di dati esterni (siti web, altri applicativi, fogli di calcolo). Una delle possibili necessità potrebbe essere quella di raccogliere i dati da un sito Wordpress: può essere il caso di una generica richiesta di informazioni da un modulo di contatto (CRM), dell’iscrizione a una newsletter, o ancora dell’iscrizione al sito, dell’invio dei dati di un ordine al software di fatturazione.

Come gestire file in Genropy: le attachmentTable

Mon, 22 Nov 2021 14:42:26 +0000

In un software si ha molto spesso a che fare con la gestione di file su disco , di tipologie anche molto diverse a seconda del tipo di applicativo: cataloghi, brochure, curriculum, schede tecniche, bolle di trasporto, contratti, ecc.

Ciò che li accomuna è il collegamento con una tabella principale , quella dei prodotti, dei candidati, degli ordini, anche questa ovviamente molto diversa a seconda delle funzioni dell’applicativo. Come quindi gestire facilmente file così diversi in ambiti totalmente differenti?

formulaColumn parametriche

Fri, 05 Nov 2021 14:21:58 +0000

Le formulaColumn sono colonne virtuali calcolate in tempo reale al caricamento della pagina dell'applicativo. Queste sono molto utili per effettuare calcoli sempre aggiornati da visualizzare in una griglia, come per esempio il totale fatturato di uno specifico cliente che visualizziamo in Sandbox.

Tuttavia, prendendo a titolo di esempio proprio questo totale fatturato, questo è un valore “assoluto”, indipendente cioè da una data, sia questa la data di lavoro, sia questa invece un’ipotetica data specificata manualmente via codice o tramite interfaccia.

Come realizzare un component Python in Genropy

Thu, 09 Sep 2021 11:32:42 +0000

In alcuni casi può capitare di voler personalizzare il comportamento di alcuni widget o component “core” di Genropy, oppure creare veri e propri blocchi o interfacce personalizzate da zero. Prendiamo ad esempio il caso di una form particolarmente complessa, che vogliamo ripetere uguale (o quasi) su più pagine.

È sempre buona norma rendere il nostro codice il più possibile riutilizzabile, flessibile e generico: piuttosto che scrivere quindi righe e righe di codice ogni volta, ci converrà utilizzare i component di Genropy, che ci permettono di scrivere un blocco di codice in un punto dell'applicativo e richiamarlo comodamente al bisogno. Un component può essere molto semplice o anche estremamente complesso: si pensi ad esempio al component core per eccellenza di Genropy, il TableHandler, grazie al quale con una sola riga di codice è possibile mostrare la particolare visualizzazione dei record di una tabella.

Le Preferenze in Genropy

Thu, 06 May 2021 16:21:13 +0000

Ipotizziamo di voler inserire all’interno del nostro applicativo una procedura di controllo che impedisca il salvataggio di un record “fattura” se l’importo totale è al di sotto di un importo minimo, oppure di voler aggiungere un limite massimo allo sconto inseribile, o ancora impostare un costo della spedizione sulla base di valori reperibili da una tabella di riferimento.

La soluzione potrebbe essere estremamente semplice. Prendendo il primo caso, sarebbe sufficiente posizionarsi all'interno di un trigger e al momento del calcolo del totale in vista del salvataggio andare a sollevare un'eccezione se il totale è inferiore all'importo che specifichiamo, ad esempio "1":

Come arricchire le viste con le Sections

Mon, 03 May 2021 13:30:47 +0000

Quando si ha a che fare con molti dati all'interno di una stessa vista potremmo aver bisogno di sistemi per filtrare rapidamente questi dati sulla base di criteri predefiniti. In un precedente tutorial avevamo già visto come usare a tale scopo le queryBySample, che sono particolarmente utili quando si vuole offrire dei criteri di ricerca predefiniti (es: ricerca per artista, per titolo della canzone, per album, per genere musicale).

Ipotizziamo però un caso in cui si voglia individuare tutte le tracce audio di un certo formato (“mp4”, “wav” e così via), o appartenenti allo stesso genere musicale, o raggruppando i risultati per durata: tutti casi, quindi, in cui si ha a che fare con pochi criteri di scelta, sempre uguali.

Come usare i semafori con i valori booleani

Fri, 12 Feb 2021 09:51:09 +0000

Supponiamo di dover visualizzare in una Form un valore booleano che può assumere tre stati: Vero, Falso e nullo. Può essere per esempio il caso di un campo "Iscritto alla newsletter", dove se presente una data di iscrizione viene restituito Vero, se presente una data di disiscrizione viene restituito Falso, o se non presente nessuna data viene restituito null. Si noti quindi che il campo in sé non prevede la possibilità di inserire alcun valore direttamente, ma dipende da altri campi, la data di iscrizione e la data di disiscrizione, che vengono peraltro compilati su una pagina esterna alla Form, e il nostro obiettivo è di mostrare nella Form questo valore di sola lettura in modo chiaro e rapido per l'utilizzatore finale.

Come partizionare i dati e creare un applicativo multi-tenant

Thu, 23 Jul 2020 09:54:00 +0000

Il partizionamento dei dati può rivelarsi molto utile quando l'applicativo è utilizzato da utenti che hanno necessità di accedere all'applicazione in modo limitato, visualizzando e modificando solo i record loro riservati o da loro stessi inseriti, quando cioè ci troviamo di fronte a un applicativo multi-tenant.

Il partizionamento di per sé è un meccanismo che si può attivare in due semplici step:

1. modificare il model della table come segue:

Come definire le queryBySample

Wed, 06 May 2020 18:34:51 +0000

In questo tutorial proseguiremo con il miglioramento dell'applicativo che abbiamo generato automaticamente nella Genropill 4: "Dal database alla web app in meno di 2 minuti" e che abbiamo cominciato a modificare nel Tutorial: "Definire classi view e form diverse in base alle necessità".

Nel caso precedente avevamo creato classi View e Form differenti in base a differenti scenari d'uso. Tra le personalizzazioni effettuate avevamo visto velocemente l'uso del metodo th_queryBySample, per definire nella pagina uno strumento di ricerca più immediato e semplice per l'utente finale.

Definire classi view e form diverse in base alle necessità

Wed, 22 Apr 2020 10:49:54 +0000

Un tipo di pagina molto usata in Genropy è la thpage, ovvero una pagina che è quasi interamente costituita da un tableHandler con l'aggiunta di qualche strumento avanzato in più. Nella sua configurazione di default si tratta di uno stackTableHandler.

Lo stackTableHandler è un component Genropy che si basa sull'idea di due fogli sovrapposti (stack). Il primo foglio permette di visualizzare i dati di una table di database in una griglia, mentre il secondo contiene la form relativa ad un singolo record.

Come effettuare Dump e Restore del database di applicazione

Thu, 02 Apr 2020 12:17:58 +0000

Quando si lavora alla realizzazione e manutenzione di una web application è spesso necessario migrare velocemente il database da un'installazione ad un'altra, tipicamente dalla versione in produzione all'ambiente di sviluppo/test.

Ci troviamo quindi di fronte ad operazioni di dump e restore di un database per le quali in Genropy mette a disposizione degli strumenti che rendendono la procedura più pratica e immediata. Questi strumenti sono ottimizzati per applicazioni con database PostgreSQL.

Trucchi utili per lavorare con Genropy

Mon, 10 Feb 2020 15:09:44 +0000

Genropy “fresco” di installazione è già di per sé uno strumento estremamente potente, ma con alcuni accorgimenti possiamo renderci la vita ancora più facile e, perché no, anche più accattivante dal punto di vista grafico…

Il video ci mostra l’utilizzo di alcune risorse utili per lavorare con Genropy:

tema grafico “mimi”
configurare il sistema per postgreSQL
risorse per la stampa in pdf
plugin VSCode

Per attivare i sottotitoli premere il bottone CC

Genropy: video tutorial per l'installazione

Thu, 23 Jan 2020 18:38:36 +0000

L’installazione è ovviamente il primo passo per poter entrare nel mondo di Genropy e cominciare a costruire le proprie applicazioni web.

L'installazione, per un utente che ha già installati i prerequisiti del framework è di norma molto semplice e richiede solo pochi minuti. D'altra parte ci rendiamo conto che per chi non è ancora abituato a lavorare con strumenti open source può richiedere alcuni passaggi tecnici non banali. Per questo motivo, al fine di rendere Genropy il più possibile fruibile a tutti, abbiamo deciso di affiancare alla nostra Guida all'installazione anche due video tutorial: uno per l'installazione in ambiente Mac, l'altro in ambiente Windows. Nelle descrizioni dei video troverete un elenco dei passaggi richiesti.

Assaggi di Genropy

Thu, 01 Aug 2019 14:28:59 +0000

Questo è il primo di una serie di post che avranno lo scopo di illustrare attraverso dei semplici esempi pratici alcuni concetti fondamentali dello sviluppo con Genropy. Tutti questi articoli includeranno codice sorgente e la parte di pagina viva corrispondente: puoi passare dalla visualizzazione del codice e della pagina usando gli appositi bottoni SOURCE e DEMO.

In questo primo assaggio realizzerò la schermata iniziale di un ipotetico gioco in cui i giocatori dovranno inserire il proprio nome e scegliere il loro colore preferito. Con questo esempio voglio spiegare i seguenti concetti: