Rceasy › Planmeca Romexis
Prima di tutto: cerca le righe [PlanmecaRomexis] nel file di log più recente in %LOCALAPPDATA%\Rceasy\Logs per vedere l'esito esatto di ogni controllo.

1. Prerequisiti

Prima di avviare la configurazione Romexis tramite Rceasy, verifica questi punti minimi:

Romexis installato

Rceasy legge il valore Pmbridge dalla chiave HKLM\SOFTWARE\Planmeca\Romexis (deve puntare a una cartella chiamata letteralmente pmbridge; la cartella superiore diventa la radice di installazione), con fallback sul registro Uninstall per nome contenente "Romexis".

Versione minima

La versione minima richiesta è configurabile (RomexisSetupConfiguration.MinimumSupportedVersion); verificala con il supporto se non la conosci a memoria.

romexis_server.properties leggibile

Rceasy legge SERVER_DB, SERVER_DB_URL (regex ^jdbc:sqlserver://([^;]+); per il server, databaseName=([^;]+) per il nome database), SERVER_DB_UID/DATAGATE_DB_UID, SERVER_DB_PWD/DATAGATE_DB_PWD. Se il file manca, usa credenziali SQL Server legacy di fallback.

Database SQL Server

L'automazione supporta il database Romexis solo quando SERVER_DB corrisponde al provider SQL Server configurato.

2. Flusso di configurazione

Quando selezioni Planmeca Romexis dal menu, Rceasy esegue tre passaggi automatici.

1

Verifica installazione e versione Romexis

Rceasy controlla che la cartella di installazione esista, legge la versione del client e verifica che sia compatibile con il requisito minimo richiesto.

2

Preparazione utente pmbridge

Viene eseguito lo script ufficiale RX_Pmbridge_User.sql fornito con Romexis per predisporre l'utente tecnico usato dal collegamento.

3

Configurazione permessi Romexis

Rceasy abilita le impostazioni richieste per il collegamento, attiva la modalità multi-instance e sistema i permessi necessari per l'utente pmbridge.

Nota: Se la configurazione richiesta è già presente, Rceasy conclude il controllo senza applicare modifiche aggiuntive.

3. Cosa cambia sul sistema

Quando il setup viene applicato, Rceasy aggiorna solo i parametri necessari al collegamento con Romexis:

Abilitazione multi-instance

Rceasy forza l'impostazione globale necessaria per l'uso concorrente del componente di collegamento.

Permessi del gruppo pmbridge

L'utente pmbridge viene verificato e, se serve, inserito nei gruppi richiesti per il collegamento.

Pulizia dei blocchi non compatibili

La configurazione disattiva i permessi di blocco che impedirebbero al bridge di lavorare correttamente.

4. Comportamenti da conoscere

Perché a volte Rceasy "riconfigura comunque": a differenza di Sidexis, Romexis non si fida ciecamente di un marker già registrato. Anche quando il marker (HKCU\Software\Henry Schein One Italia\Rceasy\Setups\PlanmecaRomexis) è affidabile, Rceasy fa comunque una verifica live dello stato attuale: multi-instance abilitato, pmbridge amministratore, tutti i permessi pmbridge presenti, nessun blocco attivo. Se anche una sola condizione non è più vera, o se la verifica stessa fallisce per un problema di connessione al database, riparte la configurazione completa — questo è normale, non un errore dell'app.

5. Errori comuni e soluzioni

Cartella di installazione non trovata

Messaggio: "Romexis installation folder not found: '{cartella}'."

Soluzione: verificare che Romexis sia installato e che la chiave HKLM\SOFTWARE\Planmeca\Romexis\Pmbridge punti a una cartella pmbridge realmente esistente.

Versione Romexis non compatibile

Messaggio: "Unsupported Romexis version: detected {versione}. Minimum required version: {etichetta}."

Soluzione: aggiornare Romexis alla versione minima richiesta prima di ripetere il setup.

Script ufficiale pmbridge non trovato

Messaggio: "Official Romexis pmbridge script not found: '{percorso}'."

Soluzione: verificare che l'installazione Romexis sia completa e integra, poi rilanciare Rceasy.

SERVER_DB assente

Messaggio: "SERVER_DB not present in romexis_server.properties." Il file di configurazione esiste ma manca la chiave attesa.

Soluzione: verificare l'integrità di romexis_server.properties; se corrotto, farlo rigenerare da Romexis.

Provider database non supportato

Messaggio: "Unsupported Romexis database provider: '{provider}'. This automation requires SQL Server (SERVER_DB={atteso})."

Soluzione: la configurazione automatica di questa release richiede SQL Server. Se il database è diverso, serve una verifica tecnica dedicata, non il setup automatico.

SERVER_DB_URL assente o non interpretabile

Messaggi possibili: "SERVER_DB_URL not present in romexis_server.properties.", "Unable to extract the Romexis server from SERVER_DB_URL: '{url}'.", "Unable to extract databaseName from SERVER_DB_URL: '{url}'."

Soluzione: controllare manualmente il valore di SERVER_DB_URL in romexis_server.properties: deve essere nella forma jdbc:sqlserver://SERVER;databaseName=NOME;....

Errore imprevisto durante la configurazione

Uno dei passaggi su database o permessi non si è completato correttamente. Cerca [PlanmecaRomexis] ... exception nel log per il messaggio completo; se vedi "Quick state check failed, proceeding with the full configuration" significa solo che il controllo rapido non è riuscito e Rceasy ha rilanciato tutta la configurazione, non è un errore bloccante.

Soluzione: riprovare la procedura e, se il problema persiste, fornire al supporto il dettaglio tecnico mostrato da Rceasy e il file di log.