Parti da qui quando qualcosa non funziona. Trova il tuo sintomo, leggi che cosa significa e segui la soluzione. La maggior parte dei problemi deriva dalla rete, da una Comm Key errata, dal fuso orario sbagliato o da un codice non abbinato, non dal terminale.
#Controlli rapidi (da fare per primi)
- Il PC del connettore è acceso e mostra Online nella scheda Connettori?
- La scheda del dispositivo indica che cosa non va? (Dice ad esempio "Il connettore ... è offline", "Configurazione necessaria" o "Nessun connettore assegnato".)
- Premi Test connessione sul dispositivo. Leggi la risposta con la tabella degli stati.
- Apri Attività sul dispositivo: le timbrature stanno arrivando e che cosa ne è stato?
#Dispositivo non raggiungibile
"Dispositivo non raggiungibile" o "non ha risposto in tempo".
| Verifica | Come |
|---|---|
| Alimentazione e cavo | Il terminale è acceso e la spia di rete è accesa? |
| Indirizzo e porta | Confronta con il menu del dispositivo (ZKTeco: Menu → Comm. → Ethernet; porta 4370). L'indirizzo può essere cambiato se il dispositivo usa il DHCP: assegnagli un indirizzo fisso. |
| Stessa rete | Il PC del connettore e il terminale devono trovarsi nello stesso segmento di rete, oppure essere instradati l'uno verso l'altro. Un Wi-Fi ospiti o un'altra VLAN lo impedisce. |
| Firewall | Consenti la porta del dispositivo dal PC: 4370 TCP/UDP per ZKTeco, 5010 TCP per Anviz, la porta web (80) per Hikvision. |
| Una connessione alla volta | Alcuni terminali ammettono una sola connessione da PC. Chiudi gli altri software di presenza collegati allo stesso dispositivo. |
| Ping dal PC | In un prompt dei comandi: ping <device address>. Se fallisce, è la rete, non SolaHR. |
#Il connettore
| Sintomo | Soluzione |
|---|---|
| Connettore Offline | Accendi il PC; controlla il servizio con sc query SolaHRDeviceConnect (deve indicare RUNNING); controlla il suo accesso a internet. Le timbrature in attesa vengono inviate quando torna online. |
| "Il connettore non ha preso in carico la richiesta" | Lo stesso: il PC è spento, in sospensione o offline. Disattiva la sospensione per quel PC. |
| «Il connettore deve essere abbinato di nuovo» / «Il connettore è stato revocato» | Genera un nuovo codice di abbinamento e ripeti l'abbinamento (Installazione). |
| "Codice scaduto - creane uno nuovo" | Un codice di abbinamento dura 15 minuti e funziona una sola volta. |
| Windows avvisa a proposito del programma di installazione | Previsto: l'anteprima non è firmata digitalmente. Controlla il valore SHA-256, poi Ulteriori informazioni → Esegui comunque. |
127.0.0.1:8790 non si apre |
Un altro programma potrebbe usare quella porta. Il servizio funziona comunque anche senza la pagina. |
#Autenticazione e chiavi
| Sintomo | Soluzione |
|---|---|
| Raggiungibile · Comm Key rifiutata | Inserisci la Comm Key del dispositivo (Menu → Comm. → PC Connection). Nessuna chiave significa 0. Le chiavi hanno da 1 a 6 cifre. Sul firmware ZKTeco Ver 6.60 il dispositivo chiede l'accesso anche con chiave 0; il connettore 0.1.5 e successivi lo gestiscono, quindi aggiorna il connettore se lo vedi ancora. |
| Raggiungibile · dispositivo occupato | Attendi un minuto e ripeti il test. |
| Hikvision: accesso rifiutato | Usa un utente del dispositivo separato creato per SolaHR (non admin) e verifica che il dispositivo sia attivato. |
| Suprema: accesso rifiutato | Usa un operatore BioStar 2 di sola lettura e l'indirizzo esatto del server (con https://). |
| "Numero di serie non corrispondente" | Il dispositivo a quell'indirizzo non è quello registrato. Controlla l'IP. |
#Configurazione necessaria
Configurazione necessaria è uno stato, non un guasto del terminale. Il tipo di connessione richiede il software del produttore sul PC del connettore e non è pronto. Segui Configurazione dell'SDK del produttore, oppure premi Usa invece la connessione integrata. Per la maggior parte dei terminali ZKTeco, ZKTeco (diretto) non richiede software aggiuntivo.
#Le timbrature arrivano ma non compare alcuna presenza
| Causa | Soluzione |
|---|---|
| Il codice non è abbinato | Utenti del dispositivo → collega il codice. Le timbrature in attesa vengono scritte non appena lo colleghi. Vedi Abbinamento e presenze. |
| Mancano le impostazioni paga per la data | Aggiungile, poi usa Rielabora in sospeso. |
| Prima della data Importa cronologia da o prima della data di inizio del dipendente | Modifica la data del dispositivo, oppure correggi la data di inizio. |
| Il giorno era già stato inserito dalle Risorse Umane o dal portale | Una timbratura del dispositivo non lo sovrascrive. Vedi Timbrature rifiutate nella scheda Verifica. |
| Il dipendente è sospeso senza retribuzione | Non viene creata alcuna presenza. |
| Un'uscita senza entrata | Aggiungi il check‑in mancante in Attendance. |
#Orari errati
| Sintomo | Soluzione |
|---|---|
| Sfasati di ore intere | Modifica il dispositivo e imposta il Fuso orario dell'orologio del dispositivo corretto (ad esempio Asia/Amman, Asia/Dubai). |
| Sfasati di minuti | Sincronizza l'ora ora (titolare). Controlla anche l'orologio del dispositivo e le impostazioni dell'ora legale. |
| Un turno notturno sembra diviso | Controlla l'impostazione di turno notturno dell'orario di lavoro in Orari di lavoro. |
#Nomi e testo
| Sintomo | Soluzione |
|---|---|
I nomi arabi compaiono come ??? o simboli strani |
Nella scheda del dispositivo imposta la codifica del testo: prima UTF-8, poi Windows-1256 (arabo), poi GBK. Rileggi gli utenti. |
| I nomi vengono troncati | Molti terminali ammettono solo un nome breve (spesso 24 caratteri o meno). |
#Le modifiche non funzionano
| Sintomo | Soluzione |
|---|---|
| "Le modifiche a questo dispositivo sono disattivate sul PC del connettore" | Attiva Consenti modifiche ai dispositivi nella pagina del connettore. |
| Modifica, attivazione, eliminazione o invio disattivati / "non supportato qui" | Il tipo di connessione o il modello non lo supporta. ZKTeco diretto non può attivare/disattivare gli utenti né copiare i volti; il tipo SDK ZKTeco può (testato via software). |
| Copia, riavvio o sincronizzazione dell'ora mancanti | Solo proprietario. |
| "Il dispositivo non ha spazio libero per questo" | Il terminale è pieno di utenti, volti o impronte. Elimina gli utenti non utilizzati. |
| "Il dispositivo ha rifiutato la modifica" | Controlla la Comm Key e che il dispositivo consenta le modifiche da remoto. |
#Dispositivi in push
| Sintomo | Soluzione |
|---|---|
| "Ultimo contatto" è vecchio o vuoto | Controlla l'impostazione del server del terminale (ZKTeco: Menu → Comm. → Cloud Server Setting): indirizzo, porta e che il terminale abbia accesso alla rete. |
| Timbrature rifiutate | Il numero di serie del dispositivo deve corrispondere a quello registrato in SolaHR. Vedi Quarantena. |
| HTTP semplice rifiutato | Molti dispositivi in push usano solo HTTP. Chiedi al tuo amministratore di leggere il pannello Idoneità dell'installazione; verifica le regole del server web. |
#Domande frequenti
SolaHR memorizza impronte o volti? No. Mai. Sa soltanto se una persona ha un volto o un'impronta su un dispositivo. Vedi che cosa viene memorizzato.
Devo aprire una porta nel router? No. Il connettore effettua solo connessioni in uscita verso SolaHR. Solo i dispositivi in push richiedono che SolaHR sia raggiungibile da loro, e lo è.
Funziona senza internet? Il connettore continua a funzionare nell'ufficio ma non può raggiungere SolaHR; le timbrature restano in attesa e vengono inviate più tardi.
Posso usare più di un connettore? Sì, di solito uno per sede. Ogni dispositivo è assegnato a un connettore.
Il mio terminale è supportato? Vedi Dispositivi supportati. Finora solo lo ZKTeco iFace702 è stato collegato per davvero; gli altri modelli sono previsti o non testati. Prova prima con uno.
Posso combinare connettore e importazione di file? Sì. Le timbrature ripetute vengono riconosciute e non contate due volte.
Ogni quanto vengono lette le timbrature? Come scegli tu: ogni 1, 2, 5, 10, 15 o 30 minuti. Vedi Abbinamento e presenze.
Il connettore è sicuro da eseguire? Ascolta solo sul PC stesso e tiene i segreti cifrati, ma è un'anteprima non firmata e il suo servizio Windows non è stato testato in ogni configurazione di Windows. Tratta il PC come un server.
Dove trovo aiuto? Usa solahr-dc diagnostics sul PC del connettore per creare un pacchetto di supporto senza segreti, e invialo con il nome del dispositivo e lo stato che vedi.