Dentsply Sirona Sidexis 4
Guida tecnica per installatori: classi coinvolte, condizioni di skip e ogni errore possibile con la relativa soluzione. Classi di riferimento: SidexisSetupService, SidexisInstallationResolver.
[DentsplySironaSidexis4] nel file di log più recente in %LOCALAPPDATA%\Rceasy\Logs per vedere se Rceasy ha rilevato "AlreadyConfigured" oppure ha davvero rilanciato la configurazione, e con quale eccezione eventuale.
1. Prerequisiti
La configurazione Sidexis 4 è la più complessa tra quelle supportate. Richiede:
Sidexis 4 installato (versione ≥ 4)
Rceasy cerca Sidexis nel registro di disinstallazione di Windows (HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall) cercando voci con "Sidexis" nel nome. Verifica che Sidexis4.exe esista nella cartella di installazione.
Cartella di scambio configurabile
Rceasy deve poter creare il file AcquisitionAgent.sdx nella cartella ProgramData\Acquisition Agent per abilitare la comunicazione.
Configurazione automatica disponibile
Il componente OptionsManager3G.exe deve essere disponibile nel sistema per permettere a Rceasy di completare automaticamente la configurazione di Sidexis.
Sidexis 4 deve essere chiuso
Rceasy chiuderà automaticamente Sidexis 4 se è aperto durante la configurazione. Se non riesce a chiuderlo, la procedura si interrompe.
2. Flusso di configurazione
Selezionando "Dentsply Sirona Sidexis 4", Rceasy esegue questi passaggi:
Verifica versione Sidexis installata
Rceasy cerca nel registro di sistema le voci di disinstallazione contenenti "Sidexis", verifica che Sidexis4.exe esista nella cartella di installazione e che la versione sia ≥ 4.
Preparazione cartella di scambio
Crea la cartella ProgramData\Acquisition Agent (se non esiste) e il file AcquisitionAgent.sdx necessario per la comunicazione tra Sidexis e il componente di acquisizione.
Configurazione automatica di Sidexis
In questa fase Rceasy completa il collegamento e:
- Chiude Sidexis 4 se è aperto
- Configura i file
sifiledb.iniesidexis.initramite l'interfaccia COM OptionsManager3G - Imposta il componente di acquisizione come partner di OfficeManagement
- Configura il percorso mailbox di scambio dati:
C:\PDATA\siomin.sdx - Esegue la sincronizzazione SLIDA verso Sidexis 4
3. Dettagli tecnici
| Parametro | Valore |
|---|---|
| Registro di ricerca | HKLM\SOFTWARE\...\Uninstall\* (incluso WOW6432Node) |
| Eseguibile verificato | Sidexis4.exe |
| Versione minima | 4.0 |
| File mailbox | %ProgramData%\Acquisition Agent\AcquisitionAgent.sdx |
| Mailbox SLIDA | C:\PDATA\siomin.sdx |
| COM Class ID | {A18DA11D-3CBC-4614-8D64-955818822CAF} |
| Partner OfficeManagement | AcquisitionAgent |
| Azione speciale | SyncSLIDASettingsToSidexis4 |
4. Comportamenti da conoscere
HKCU\Software\Henry Schein One Italia\Rceasy\Setups\DentsplySironaSidexis4), e (2) i file della mailbox sono già presenti su disco. Se manca una delle due, riparte la configurazione completa. Per forzare una riconfigurazione completa, elimina quella chiave di registro.
5. Errori comuni e soluzioni
Sidexis non rilevato nel registro
Messaggio: "Sidexis was not detected in the system registry. Verify that Sidexis is installed."
Soluzione: verificare che Sidexis 4 sia installato correttamente. Se è stato installato per un utente specifico, potrebbe non apparire nel registro HKLM.
Versione non interpretabile
Messaggio: "Sidexis version could not be parsed: '{versione}'." Il valore letto dal registro non è un numero di versione valido.
Soluzione: controllare manualmente il valore di versione nella voce Sidexis sotto Uninstall; se corrotto, reinstallare Sidexis.
Versione Sidexis non supportata
Messaggio: "Unsupported Sidexis version: {versione}. Minimum required version: {minimo}.0."
Soluzione: aggiornare Sidexis alla versione minima richiesta (configurabile, verificare il valore corrente con il supporto).
Cartella di installazione non valida
Messaggio: "Invalid Sidexis installation folder: '{percorso}'." Il percorso letto dal registro non esiste più su disco.
Soluzione: verificare che Sidexis non sia stato spostato/disinstallato parzialmente; reinstallare se necessario.
OptionsManager non trovato
Messaggio: "Sidexis OptionsManager not found: {percorso}". OptionsManager3G.exe non è presente nella cartella di installazione.
Soluzione: riparare/reinstallare Sidexis 4 in modo che includa OptionsManager3G.
Mailbox Acquisition Agent non valida
Messaggio: "Invalid Acquisition Agent mailbox path." oppure "Acquisition Agent mailbox not found: '{percorso}'." (cartella attesa: %ProgramData%\Acquisition Agent).
Soluzione: verificare i permessi di scrittura su ProgramData\Acquisition Agent e riprovare con privilegi di amministratore.
Mailbox SLIDA non valida
Messaggio: "Invalid Mailbox (SLIDA) path." oppure "Invalid Mailbox (SLIDA) folder: '{percorso}'." (percorso atteso: C:\PDATA\siomin.sdx).
Soluzione: verificare che la cartella C:\PDATA esista e sia scrivibile.
Sidexis 4 non si chiude automaticamente
Sidexis 4 risulta aperto e non è stato possibile chiuderlo automaticamente.
Soluzione: Chiudere manualmente Sidexis 4 e ripetere la procedura.
Errore di configurazione COM (OptionsManager3G)
La classe COM OptionsManager3G non è registrata o non è accessibile. Rceasy tenterà un fallback tramite PowerShell a 32 bit.
Soluzione: Se anche il fallback fallisce, reinstallare Sidexis 4 o contattare il supporto tecnico. Il dettaglio tecnico mostrato da Rceasy indica il punto esatto del fallimento.
Nessuno slot libero per il partner AcquisitionAgent
Tutti gli slot disponibili in OfficeManagement sono già occupati da altri partner.
Soluzione: Contattare il supporto tecnico per liberare uno slot o configurare manualmente il partner AcquisitionAgent nelle impostazioni di Sidexis.
Configurazione backend non riuscita
Non è stato possibile completare la configurazione backend Sidexis (ProgramData, Mailbox SLIDA, Communication partner).
Soluzione: Verificare i permessi di scrittura sulle cartelle ProgramData\Acquisition Agent e C:\PDATA. Riprovare la procedura con privilegi di amministratore.