Solavel Documenti
Italiano

Aggiungi un dispositivo

Ultimo aggiornamento

Questa pagina ti accompagna da «ho un terminale al muro» a «SolaHR lo legge»: trovare il dispositivo, sceglierlo nel catalogo dei modelli, raccogliere indirizzo IP, porta e chiave di comunicazione dal menu del dispositivo, provare la connessione e capire lo stato che ottieni. Il riferimento clic per clic delle schermate è in Dispositivi di presenza; questa pagina aggiunge le conoscenze utili attorno.

Prima di iniziare, il connettore deve essere installato e mostrare Online, a meno che tu non intenda usare l'invio o l'importazione di file.

#La versione breve

  1. Tempo e presenze → Dispositivi di presenza → Aggiungi dispositivo.
  2. Dagli un nome, scegli la sua sede di presenza e il fuso orario dell'orologio del dispositivo (per esempio Asia/Amman).
  3. Scegli il tipo di collegamento, il connettore e inserisci l'indirizzo IP del dispositivo, la porta e la chiave di comunicazione (vuota significa 0).
  4. Prova collegamento. Una buona risposta mostra modello, firmware, utenti e registrazioni sul dispositivo e il suo orologio.
  5. Associa gli utenti, poi Salva e avvia sincronizzazione.

Puoi uscire a metà: un dispositivo non terminato mostra Configurazione incompleta con Riprendi configurazione.

#Rilevamento: lasciare che il connettore trovi il dispositivo

Sul PC del connettore apri la pagina del connettore (http://127.0.0.1:8790) e premi Trova dispositivi. Esegue una ricerca in sola lettura nella rete locale e non modifica nulla. In SolaHR i risultati compaiono sotto Trovati dal tuo connettore con indirizzo e porta; un clic compila l'indirizzo. I dispositivi che chiedono una chiave di comunicazione sono contrassegnati «chiede l'accesso (Comm Key, spesso 0)».

Il rilevamento vede solo i dispositivi dello stesso segmento di rete del PC e solo i protocolli che il connettore conosce. Se il terminale non viene trovato, potrebbe essere su un'altra VLAN o di un tipo non letto direttamente. Digita tu l'indirizzo.

#Il catalogo dei modelli

Sotto Il tuo dispositivo puoi cercare nel catalogo per marca o modello. In questa versione contiene 147 modelli di ZKTeco, Hikvision, Suprema, Anviz ed EBKN. La scelta di uno mostra:

Mostrato Significato
Provato su un dispositivo reale Collegato davvero, con il firmware indicato. Oggi solo lo ZKTeco iFace702.
Dovrebbe funzionare · stessa famiglia di protocollo Documentato come dello stesso protocollo di un modello che funziona; non provato da noi.
Sconosciuto: non provato Nel catalogo, ma senza prove in un senso o nell'altro.
Impostazioni consigliate Un pulsante, Applica impostazioni consigliate, compila porta, trasporto e codifica.
Dove trovare le impostazioni su questo dispositivo Il percorso nel menu (riassunto sotto).
Problemi noti e Passi successivi Per esempio, il firmware ZKTeco Ver 6.60 chiede l'accesso anche con chiave 0; il connettore 0.1.5 e successivi lo gestiscono.

Il modello è facoltativo. Se il miglior tipo di collegamento per il modello differisce da quello scelto, SolaHR propone Passa a .... L'elenco completo, con manuale ufficiale e link di assistenza, è in Dispositivi supportati. Un dispositivo non presente nel catalogo può comunque funzionare se usa uno degli stessi protocolli; prova Prova collegamento.

#Trovare indirizzo IP, porta e chiave di comunicazione sul dispositivo

Ogni produttore formula i menu in modo un po' diverso, e i menu cambiano con modello e firmware. Usa questi percorsi come guida e conferma nel manuale del tuo dispositivo (link in Dispositivi supportati).

#ZKTeco (diretto, porta 4370)

Sulla maggior parte dei terminali ZKTeco, premi Menu e poi:

Ti serve Dove sul dispositivo
Indirizzo IP, subnet mask, gateway, DHCP Menu → Comm. → Ethernet
Porta TCP COMM. Port nella stessa schermata. Il valore di fabbrica è 4370; lascialo salvo modifiche.
Chiave di comunicazione Menu → Comm. → PC Connection → Comm Key. Un numero da 1 a 6 cifre; 0 significa nessuna chiave (valore di fabbrica).
ID dispositivo / numero macchina Stessa schermata PC Connection. Lascia il Numero macchina di SolaHR a 1 a meno che il dispositivo ne usi un altro.
Server ADMS (per l'invio, al posto del connettore) Menu → Comm. → Cloud Server Setting: l'indirizzo del server (o un nome di dominio, se l'opzione dominio è attiva) e la porta del server.

Un terminale ZKTeco appena uscito di fabbrica è documentato come avviato all'IP 192.168.1.201 con maschera 255.255.255.0, quindi PC e terminale devono essere sullo stesso segmento, oppure cambi prima l'indirizzo del dispositivo. I nomi dei menu sopra provengono dai manuali attuali di ZKTeco (per esempio il manuale utente del SpeedFace-V3L); i terminali più vecchi, come la serie iClock, hanno menu simili. Trasporto: lascia Auto (prima TCP, UDP solo se TCP fallisce). I nomi arabi sembrano illeggibili: mantieni UTF-8, poi prova Windows-1256 (cp1256), poi GBK.

#Hikvision (ISAPI, porta web 80)

I terminali Hikvision si configurano soprattutto dalla loro pagina web integrata.

Ti serve Dove
Trovare il dispositivo in rete Lo strumento SADP di Hikvision (in HiTools) elenca i dispositivi Hikvision della rete locale, attiva quelli nuovi e può cambiarne l'IP. Hikvision dichiara che SADP non riceverà più aggiornamenti da aprile 2026 e rimanda al nuovo HiTools Delivery.
Indirizzo IP Pagina web del dispositivo → Configuration → Network → Basic Settings → TCP/IP
Un accesso per SolaHR Pagina web → Configuration → System → User Management. Crea un utente separato per SolaHR; non usare admin.
Porta 80 (HTTP), salvo modifica nelle impostazioni di rete del dispositivo

Un nuovo dispositivo Hikvision deve essere attivato (imposti la sua password di amministratore) prima di poterlo usare. Hikvision documenta gli indirizzi di fabbrica nei suoi manuali; conferma il tuo lì invece di tirare a indovinare.

#Suprema (tramite un server BioStar 2)

SolaHR non dialoga direttamente con i terminali Suprema. Legge gli eventi dal tuo server BioStar 2.

Ti serve Dove
Indirizzo del server L'indirizzo della pagina web di BioStar 2, di solito https://<server>:443
Un accesso In BioStar 2 crea un operatore in sola lettura; non usare l'amministratore principale
Tipi di evento BioStar 2 etichetta ogni evento con un codice; se importi troppo, imposta i codici evento consentiti nelle impostazioni del dispositivo in SolaHR

Gli indirizzi IP dei terminali e le impostazioni del server si impostano in BioStar 2 stesso; vedi la BioStar 2 Administrator Guide.

#Anviz (diretto, TCP 5010, o CrossChex Cloud)

Ti serve Dove
Indirizzo IP e porta Menu del dispositivo → Communication / Network (su alcuni modelli: la pagina web del dispositivo). La porta predefinita è 5010.
Modalità TCP Impostala su Server, così il PC del connettore può collegarsi al dispositivo. (La modalità Client fa collegare il dispositivo verso un PC, per dispositivi su un'altra rete.)
ID dispositivo Nello stesso menu di comunicazione, se ne usi uno
Porta e ID devono coincidere La porta in SolaHR deve essere uguale a quella impostata sul dispositivo

Per CrossChex Cloud serve un account cloud Anviz con accesso sviluppatore (chiave API e segreto); non c'è nulla da impostare sul PC del connettore. SolaHR chiede anche come leggere il checktime del cloud (UTC o locale), perché Anviz non lo dichiara chiaramente: scegli in base a ciò che vedi in CrossChex Cloud.

#EBKN / Secureeye (solo invio)

Non c'è collegamento diretto. Nelle impostazioni server/cloud del dispositivo inserisci l'indirizzo di invio mostrato nella pagina del dispositivo in SolaHR.

#Qualsiasi altro terminale

Usa l'importazione file (esportazione dal dispositivo) oppure, se il terminale o il suo software può inviare le timbrature a un indirizzo web, la via di invio generica (SolaHR mostra un indirizzo e un token monouso).

#Prova collegamento

Premi Prova collegamento. SolaHR chiede al connettore di contattare il dispositivo; di solito servono pochi secondi. Una buona risposta mostra Modello, Firmware, Utenti sul dispositivo, Registrazioni sul dispositivo e l'Orologio del dispositivo. Se l'orologio sfasa di oltre due minuti ricevi un avviso, perché gli orari delle timbrature seguono l'orologio del dispositivo. Puoi Salta per ora.

#Che cosa significa lo stato

Visualizzi Cosa significa Cosa fare
Raggiungibile (verde), con modello e conteggi Il dispositivo ha risposto e la chiave è stata accettata. Continua con l'associazione.
Raggiungibile · Comm Key rifiutata Il dispositivo c'è, ma la chiave è sbagliata. Inserisci la chiave di comunicazione da Menu → Comm. → PC Connection. Un dispositivo senza chiave ha la chiave 0.
Raggiungibile · dispositivo occupato Il dispositivo è occupato (spesso qualcuno si sta registrando o il dispositivo si sta sincronizzando). Attendi un minuto e ripeti il test.
Dispositivo non raggiungibile / "non ha risposto in tempo" Nessuna risposta a quell'indirizzo e porta. Alimentazione, cavo, indirizzo, porta, stessa rete, firewall. Vedi Risoluzione dei problemi.
"Il connettore non ha preso in carico la richiesta" Il PC del connettore è spento, in sospensione o offline. Accendilo. Le timbrature in attesa vengono inviate dopo.
Configurazione necessaria Questo tipo di collegamento richiede il software del produttore sul PC e non è pronto. È uno stato, non un guasto del terminale. Segui Configurare l'SDK del produttore oppure passa al collegamento diretto integrato.
"Numero di serie non corrispondente" Il dispositivo a quell'indirizzo non è quello registrato. Controlla l'indirizzo IP; due dispositivi potrebbero aver scambiato gli indirizzi.
"Il connettore è stato revocato" / "richiede un nuovo abbinamento" Il connettore ha perso l'abbinamento. Abbina di nuovo nella scheda Connettori.
Configurazione incompleta Hai lasciato i passaggi guidati prima della fine. Riprendi configurazione.
Offline / «Il connettore ... è offline» (sulla scheda) Il PC del connettore è spento o senza rete. Accendilo; le timbrature in attesa vengono inviate più tardi.
«Il dispositivo invia a SolaHR - ultimo contatto ...» (dispositivi a invio) Quando SolaHR ha avuto notizie dal dispositivo per l'ultima volta. Se è passato molto tempo, controlla l'impostazione server e la rete del dispositivo.

#Dispositivi in modalità push (ADMS e simili)

Al posto di un connettore, un terminale può inviare le timbrature a SolaHR. Prima registri il dispositivo in SolaHR (SolaHR ha bisogno del suo numero di serie), poi inserisci l'indirizzo di SolaHR nell'impostazione cloud/ADMS del terminale (Menu → Comm. → Cloud Server Setting su ZKTeco). Il push è semplice ma si fida del numero di serie del dispositivo, quindi tieni la rete consentita la più ristretta possibile e controlla le timbrature. Molti terminali ADMS usano solo HTTP semplice; il tuo amministratore potrebbe doverlo consentire sul server web, cosa che il pannello Idoneità dell'installazione nella pagina dei dispositivi verifica.

#Avanti