Solavel Documenti
Italiano

Configurazione dell'SDK del produttore (ZKTeco)

Ultimo aggiornamento

La maggior parte dei terminali viene letta direttamente in rete e non richiede altro. Alcuni tipi di connessione usano invece il software Windows del produttore (un "SDK") sul PC del connettore. Oggi si tratta solo dell'SDK ZKTeco. Questa pagina spiega quando serve, come installarlo passo dopo passo, che cosa significano i controlli e quali sono le regole di licenza.

Anteprima e nota di trasparenza. Il percorso SDK è stato realizzato e verificato solo con simulazioni software. Non è stato provato con un'installazione SDK reale su un PC Windows, né su terminali reali di ogni modello. Dettagli che su un PC reale potrebbero differire: la struttura del registro di sistema, il comportamento di regsvr32, le risposte esatte dell'SDK ad alcune chiamate. Prova prima con un solo dispositivo. Se non funziona, la connessione diretta integrata è sempre disponibile.

#Ti serve davvero?

Probabilmente no. Per la maggior parte dei terminali ZKTeco scegli ZKTeco (diretto): legge timbrature e utenti, imposta l'orologio, riavvia il dispositivo e modifica gli utenti, ed è stato verificato su un iFace702 reale. Usa il tipo SDK solo se ti serve ciò che la connessione diretta non può fare:

Funzionalità ZKTeco diretto SDK ZKTeco
Lettura di timbrature, utenti e orologio del dispositivo Sì Sì
Modifica, aggiunta, eliminazione di utenti; impostazione dell'orologio; riavvio Sì Sì
Attivare / disattivare un utente sul dispositivo No ("non supportato qui") Sì
Copiare volti e impronte tra due dispositivi No Sì
Foto degli utenti, foto istantanee alle timbrature No Sì
Eventi di timbratura in tempo reale No (polling) Sì, solo testato via software (meglio con l'SDK a 64 bit)
Richiede software sul PC No Sì: l'SDK ZKTeco, registrato
Verificato su un dispositivo reale Sì (iFace702, funzioni di sola lettura) No (solo simulato)

Le modifiche ai dispositivi devono essere consentite anche nella pagina del connettore (vedi Installazione) e quelle avanzate richiedono il titolare.

Il PC del connettore deve essere Windows (64 bit) e servono i diritti di amministratore.

  1. Scarica tu stesso lo ZKTeco Standalone SDK da ZKTeco. SolaHR non lo include né lo ridistribuisce mai. Accetti i termini di licenza di ZKTeco quando lo scarichi. Usa la versione 6.3.1.37 o successiva: contiene una cartella chiamata 64bit con un vero zkemkeeper.dll a 64 bit, compatibile con il connettore a 64 bit. Vedi la nota qui sotto su dove ottenerlo.
  2. Decomprimi il pacchetto in una cartella del PC (ad esempio nella cartella Download).
  3. Apri la cartella 64bit, fai clic con il pulsante destro su Register_SDK_x64.bat e scegli Esegui come amministratore. Copia i file dell'SDK nella cartella di sistema di Windows e registra zkemkeeper.dll al posto tuo.
  4. In SolaHR (pagina del dispositivo, Configura il software necessario) o nella pagina del connettore, premi Verifica installazione.
  5. Leggi i controlli. Quando tutti sono Pronto, la scheda del dispositivo esce da Configurazione necessaria e Test connessione funziona.

Dove trovare l'SDK. ZKTeco pubblica materiale SDK nel proprio Download Center (categoria SDK) e mantiene un repository Standalone-SDK sul proprio account GitHub. Al momento della stesura abbiamo potuto verificare che il repository contiene un pacchetto più vecchio a 32 bit (Communication Protocol SDK 6.2.4.11) e che l'elenco SDK del Download Center mostra altri SDK (moduli per impronte e luce visibile); non abbiamo potuto confermare un link pubblico alla 6.3.1.37. Alcuni download di ZKTeco richiedono un accesso gratuito come membro. Se non lo trovi, chiedi a ZKTeco o al tuo distributore ZKTeco lo "Standalone SDK 6.3.1.37 o successivo, a 64 bit". Anche il link mostrato in SolaHR non è verificato in modo indipendente.

#Cosa significano i controlli di idoneità

Verifica Significato Se indica Mancante
Windows Il PC esegue Windows. Un tipo SDK non può funzionare su un altro sistema ("Questo tipo di connessione non può funzionare su quel PC").
Componente Python COM Il connettore può comunicare con i componenti di Windows (pywin32). Fa parte del connettore. Reinstalla o aggiorna il connettore.
SDK registrato Windows conosce l'SDK (zkemkeeper). Esegui Register_SDK_x64.bat come amministratore.
File DLL Il zkemkeeper.dll registrato esiste sul disco. Registra di nuovo; poi non spostare né eliminare i file.
Architettura L'SDK è a 32 o a 64 bit e il connettore è a 64 bit. Un SDK solo a 32 bit non è compatibile direttamente: usa l'SDK a 64 bit oppure l'alternativa qui sotto.

La verifica di idoneità viene eseguita prima di ogni test di connessione e di ogni lettura. Un SDK mancante è uno stato, "Configurazione necessaria": SolaHR non ritenta in ciclo e non dichiara il dispositivo irraggiungibile.

#Alternativa: un SDK più vecchio, solo a 32 bit

I pacchetti più vecchi hanno solo un componente a 32 bit, che il connettore a 64 bit non può caricare direttamente. In tal caso la pagina del connettore offre Scegli DLL / Registra (diritti di amministratore; Windows ti chiederà conferma). Fa esattamente questo e nient'altro:

  • verifica che il file scelto sia un file locale con il nome esatto zkemkeeper.dll e una vera DLL di Windows;
  • registra quel solo file in Windows (regsvr32);
  • se il file è a 32 bit, fa in modo che Windows lo esegua in un processo ausiliario separato a 32 bit.

Non scarica mai nulla, non esegue mai altri file e non modifica mai un dispositivo. Per sicurezza, quando il connettore gira come servizio registra una DLL solo sotto Program Files o Windows; per una DLL in altre posizioni un amministratore esegue solahr-dc sdk-setup --dll <path> da un prompt dei comandi con privilegi elevati. solahr-dc readiness stampa il rapporto attuale e solahr-dc sdk-setup --candidates elenca le copie della DLL che riesce a trovare. Gli eventi in tempo reale possono essere inaffidabili con questo percorso; per quelli usa l'SDK a 64 bit. Per annullare: regsvr32 /u <path to dll>. La disinstallazione di Device Connect non tocca la registrazione del tuo SDK.

#Se l'SDK non funziona: usa la connessione integrata

Nel pannello Configura il software necessario premi Usa invece la connessione integrata. Dopo la tua conferma, SolaHR cambia il tipo di connessione in quello diretto, mantiene indirizzo IP e porta, elimina le impostazioni dell'SDK e prova di nuovo il dispositivo. Timbrature e abbinamenti dei dipendenti vengono conservati. Nulla viene modificato senza la tua conferma.

#Restrizioni di licenza dei produttori e altri produttori

SDK del produttore Stato in Device Connect Restrizioni da conoscere
ZKTeco Standalone SDK (zkemkeeper) Implementato, solo testato via software Concesso in licenza da ZKTeco. Non incluso e non ridistribuibile da noi: lo scarichi da ZKTeco e ne accetti i termini (il repository GitHub che abbiamo controllato non riporta alcun testo di licenza, quindi leggi i termini allegati al tuo download). Solo Windows. La registrazione vale per l'intero computer e richiede i diritti di amministratore.
Suprema G-SDK Pianificato, non implementato Il repository G-SDK di Suprema indica che i download passano al Suprema Download Center (dal 2 marzo 2026) e non vi è indicata alcuna licenza; i download potrebbero richiedere un accesso come partner. Oggi i dispositivi Suprema vengono letti tramite un server BioStar 2.
Device Network SDK di Hikvision Non pianificato Non necessario: i terminali Hikvision vengono letti tramite ISAPI (protocollo web). Le pagine SDK di Hikvision esistono per i tuoi progetti; le sue guide per sviluppatori ISAPI sul portale TPP richiedono un accordo firmato e i dati del partner.
Anviz CrossChex SDK Non pianificato Non necessario: Anviz viene letto tramite il suo protocollo di rete o CrossChex Cloud. Anviz ha una pagina di download dell'SDK per i tuoi progetti.

Nulla di quanto qui scritto è una consulenza legale: leggi sempre la licenza allegata al download del produttore.