Howto:Integrazione software AE

Introduzione

Questa guida descrive i passaggi necessari per installare il software Java richiesto per l’esecuzione dei programmi dell’Agenzia delle Entrate relativi ai servizi F24, CU e 770. Lo scopo è garantire la corretta integrazione e il funzionamento dei software Sogei sul computer dell’utente.

Requisiti software

I software Sogei sono distribuiti tramite una tecnologia chiamata WebStart che in passato era integrata nell’ambiente Java ma che oggi è stata abbandonata, per cui non è più presente nelle distribuzioni Java recenti. E' necessario quindi creare un ambiente specifico per eseguire i software Sogei dell'AdE.

Java Zulu

La guida seguente descrive come installare un ambiente Java dedicato esclusivamente a queste applicazioni per poterle utilizzare comodamente come in passato. La soluzione proposta garantisce piena compatibilità con le altre versioni di Java presenti sul computer, poichè viene eseguita in un ambiente isolato.

Scarica il file necessario

• Vai al sito per scaricare la JVM Zulu 8: https://cdn.azul.com/zulu/bin/zulu8.88.0.19-ca-fx-jre8.0.462-win_x64.zip
• Scarica il file ZIP in una cartella facilmente accessibile (ad esempio il Desktop o la cartella Download).

Installa la JVM Zulu 8

• Estrai tutto il contenuto del file ZIP della JVM in una cartella di tua scelta, ad esempio "C:\Program Files\"

Nota: È consigliabile estrarre in una cartella senza spazi nel nome, ma se usi Program Files va bene.

• Estrazione di tutto il contenuto del file ZIP della JVM nella cartella "C:\Program Files\"

• Dopo l’estrazione, verifica che nella cartella siano presenti le sottocartelle bin, lib, ecc....

• Prendi nota del percorso completo della cartella dove hai estratto la JVM, ad esempio C:\Program Files\Zulu8FX\zulu8.86.0.25-ca-fx-jre8.0.452-win_x64

OpenWebStart

OpenWebStart è un software gratuito che consente di avviare applicazioni Java distribuite tramite tecnologia Java Web Start (JWS), sostituendo il vecchio strumento non più supportato da Oracle.

Installazione

Questa guida descrive passo passo il processo di installazione di OpenWebStart su sistemi Windows (le istruzioni sono simili per macOS e Linux). OpenWebStart consente di eseguire applicazioni Java Web Start (JWS) sul tuo computer.

Scaricare il file di installazione di OpenWebStart dal sito ufficiale

• Accedere al sito ufficiale di OpenWebStart alla sezione Downloads: https://openwebstart.com/download/;
• Selezionare il sistema operativo del computer (Windows, macOS o Linux);
• Cliccare sul file corrispondente alla versione consigliata più recente (ad esempio OpenWebStart_windows-x64_1_12_0.exe per Windows);
• Salvare il file sul computer e procedere con l’installazione.

Avvio della procedura guidata di installazione

• Eseguire il file scaricato.
• Verrà visualizzata la finestra: “Procedura guidata install4j - OpenWebStart sta preparando la procedura guidata install4j”.
  • Questa finestra indica che l’installer sta caricando tutti i file necessari per l’installazione.

Selezione della lingua

• Scegliere la lingua desiderata dall’elenco a discesa.
• Fare clic su Avanti per procedere.

Benvenuto nell’installazione

• Verrà visualizzata la schermata di benvenuto: “Benvenuto in OpenWebStart sul tuo computer”.
• La procedura guidata ti guiderà passo dopo passo nell’installazione.
• Fare clic su Avanti per continuare o su Annulla per uscire dall’installazione.

Accettazione del contratto di licenza

• Accettare i termini del contratto di licenza, selezionare "Accetto i termini del contratto di licenza".
• Fare clic su Avanti per continuare.
  • L’installazione non può procedere senza l’accettazione del contratto.

Selezione della modalità di installazione

• Scegliere la modalità di installazione: "Per tutti gli utenti del computer" (consigliato).
• Fare clic su Avanti per continuare.

Selezione della directory di destinazione

• Selezionare la cartella in cui si desidera installare OpenWebStart; di default, il programma propone una directory standard (ad esempio: C:\Program Files\OpenWebStart).
• Fare clic su Avanti per confermare.

Selezione delle associazioni file

• Selezionare quali tipi di file aprire automaticamente con OpenWebStart. È consigliabile selezionare tutte le opzioni disponibili.
• Fare clic su Avanti per continuare.

Installazione in corso

• L’installer inizierà a copiare i file e configurare OpenWebStart sul computer.
• Attendere il completamento dell’installazione: questo passaggio potrebbe richiedere alcuni minuti.

Completamento dell’installazione

• Una volta completata l’installazione, verrà visualizzata la schermata finale: “Completamento della procedura guidata di installazione di OpenWebStart”.
• Fare clic su Fine per uscire dall’installazione.
• OpenWebStart è ora pronto all’uso.
• È possibile avviare l’applicazione dalle icone create sul desktop o dal menu Start.

Configurazione

Questa sezione spiega come configurare OpenWebStart per utilizzare la JVM Zulu, garantendo la compatibilità con i software Sogei.

Configura OpenWebStart per usare la JVM Zulu

• Apri “OpenWebStart Settings” (icona ingranaggio).

• Schermata iniziale di avvio di OpenWebStart.

• Vai nella sezione JVM Manager o Gestione JVM.

• Fai clic su "Add local..." o Aggiungi.

• Nel campo "Nome Cartella:", inserisci il percorso completo della cartella dove hai estratto la JVM (quello annotato prima) e fare clic sul pulsante Apri.

• Conferma l’aggiunta e assicurati che questa JVM sia presente.

• Se sono presenti altre JVM oltre a quella appena installata "1.8.0_452 Azul Systems, Inc.", è necessario rimuoverle.

• Fai clic sul pulsante Settings… per accedere alle impostazioni.

• Nella sezione "Update Strategy:", apri il menu a tendina.

• Seleziona l’opzione "Do not download any version" per evitare aggiornamenti automatici della JVM.
• Fai clic su OK per salvare le modifiche.

• Seleziona la sezione Desktop Integration
• Clicca sul menù a tendina posizionato a fianco di Shortcuts Overwrite Strategy
• Seleziona la voce Preserve existing shortcuts
• Infine clicca sul pulsante Apply in basso

Verifica

Questa sezione mostra come controllare che OpenWebStart e la JVM siano correttamente configurati.

Verifica la configurazione

• Sempre in “OpenWebStart Settings”, assicurati che nella lista delle JVM sia presente quella appena aggiunta.
• Puoi provare ad avviare una qualsiasi applicazione Java Web Start (JNLP) per verificare il corretto funzionamento.
  • Software di compilazione: https://jws.agenziaentrate.it/jws/dichiarazioni/2025/77025.jnlp (per anno 2025)
  • Procedura di controllo: https://jws.agenziaentrate.it/jws/dichiarazioni/StartControlli_3.jnlp

Riferimento

Link alle istruzioni ufficiali AdE: https://jws.agenziaentrate.it/jws/script/InstallazioneOWSeZuluFX.pdf