Panoramica
Prima che Herdy possa caricare animali dalla BDTA o inviare notifiche, configurate il collegamento una volta sola. Consta di due passi: collegare l'account Agate e associare l'azienda BDTA.
Tutto si trova sotto BDTA > Impostazioni. La pagina mostra tre schede: collegamento Agate, azienda collegata e stato della sincronizzazione.
Passo 1: collegare l'account Agate
L'accesso avviene su agate.ch. Herdy non vede mai la vostra password.
- Andate su BDTA > Impostazioni.
- Cliccate su Collega con Agate.
- Arrivate alla pagina di accesso di agate.ch. Accedete lì.
- Al termine tornate automaticamente in Herdy.
- La scheda indica ora Account Agate collegato, con il vostro ID di accesso Agate e la data del collegamento.
Rinnovare la sessione
La sessione Agate ha una durata limitata. Tre giorni prima della scadenza Herdy mostra un avviso in cima al modulo BDTA: «La sessione Agate scade fra x giorni». Cliccate su Rinnova ora e accedete di nuovo a agate.ch.
Se la sessione è già scaduta, l'avviso indica Collegamento Agate scaduto con il pulsante Ricollega. Fino ad allora importazione, sincronizzazione e invio di notifiche sono bloccati. Le bozze restano possibili.
Interrompere il collegamento
Sotto BDTA > Impostazioni cliccate su Interrompi collegamento e confermate. I vostri dati sugli animali restano in Herdy, le funzioni BDTA restano in pausa fino a un nuovo collegamento.
Passo 2: associare l'azienda BDTA
Un account Agate può essere autorizzato per più aziende. Herdy deve sapere quale corrisponde a questa azienda Herdy, perché ogni notifica porta il suo numero BDTA.
Alla prima configurazione, la procedura guidata vi accompagna alla scelta dell'azienda subito dopo l'accesso ad Agate. Potete però farlo in qualsiasi momento anche nelle impostazioni:
- Andate su BDTA > Impostazioni.
- Nella scheda Associa azienda cliccate su Associa azienda.
- Herdy carica le aziende per cui il vostro account Agate è autorizzato e mostra numero BDTA, nome e località.
- Scegliete la vostra azienda e cliccate su Associa azienda.
- Herdy chiede conferma: «È questa la vostra azienda?» e ricorda che dopo la prima sincronizzazione non sarà più modificabile. Confermate con Sì, associa l'azienda.
Finché nessuna azienda è associata, la panoramica BDTA mostra un avviso ambrato e il riquadro Importa dalla BDTA nella pagina di importazione resta disattivato e indica il passo mancante.
Cambiare azienda finché nulla è sincronizzato
Finché non avete caricato animali dalla BDTA potete correggere:
- Aprite BDTA > Impostazioni.
- Sotto Azienda collegata cliccate su Cambia azienda.
- Confermate l'avviso, scegliete la nuova azienda e cliccate su Applica azienda.
Dopo la prima sincronizzazione l'azienda è bloccata
Non appena animali dalla BDTA sono arrivati in Herdy, la scheda mostra un lucchetto e la dicitura Bloccato. Così i vostri dati non possono più essere attribuiti in seguito all'azienda sbagliata.
Consiglio: se gestite più aziende, createne una in Herdy per ciascuna. Ognuna avrà così il proprio collegamento BDTA.
Sincronizzare l'effettivo con la BDTA
La sincronizzazione recupera l'effettivo attuale e la scorta di marche auricolari dalla BDTA e riporta le differenze in Herdy.
Avviare una sincronizzazione
- BDTA > Impostazioni, scheda Stato della sincronizzazione, pulsante Aggiorna dalla BDTA.
- Oppure dal registro delle notifiche tramite Sincronizza ora, quando lì compare l'avviso «Ultima sincronizzazione …».
La scheda indica sempre quando è avvenuta l'ultima sincronizzazione, oppure «Mai sincronizzato».
Che cosa fa la sincronizzazione
- I nuovi animali della BDTA vengono creati.
- Gli animali esistenti vengono aggiornati dove i campi divergono.
- Gli animali che la BDTA segnala come usciti ricevono la loro data di uscita e lo stato corrispondente.
- La scorta di marche auricolari viene aggiornata.
- Le notifiche nel frattempo inserite direttamente in Agate vengono riconosciute e chiuse.
- Un animale giovane registrato in Herdy senza marca auricolare viene unito all'animale corrispondente della BDTA invece di essere creato una seconda volta. L'unione avviene solo se specie, sesso e data di nascita indicano senza ambiguità un solo animale.
Leggere la cronologia della sincronizzazione
Nella panoramica BDTA Herdy registra ogni sincronizzazione. Per ogni voce vedete:
- Innesco: Manuale, automatica o primo collegamento.
- Stato: Conclusa, parzialmente conclusa o fallita.
- Riepilogo: Quanti animali sono stati aggiunti o aggiornati e quante marche auricolari.
Mostra dettagli apre le singole modifiche, per esempio quali animali sono stati importati e quali campi aggiornati.
Quando la BDTA non risponde per tutte le specie
Il vostro account Agate è autorizzato per genere animale. Se manca l'autorizzazione per un genere, la BDTA rifiuta la richiesta proprio per quegli animali. Herdy lo dice esplicitamente, invece di mostrare in silenzio meno animali:
- «La BDTA ha rifiutato la richiesta per x specie con animali presenti.»
- «La BDTA non ha risposto per nessuna specie.» In tal caso verificate il vostro numero BDTA e le vostre autorizzazioni in Agate.
A cosa serve il collegamento
| Funzione | Serve la sessione Agate | Serve l'azienda collegata |
|---|---|---|
| Importare la mandria dalla BDTA | sì | sì |
| Sincronizzare l'effettivo | sì | sì |
| Inviare notifiche alla BDTA | sì | sì |
| Aggiornare la scorta di marche | sì | sì |
| Creare notifiche come bozza | no | no |
| Importazione CSV | no | no |
Senza collegamento Agate potete continuare a usare Herdy per la gestione della mandria, solo il collegamento diretto con la BDTA resta in pausa.
Sicurezza
- L'accesso avviene tramite OAuth presso agate.ch. Herdy non memorizza la vostra password.
- I token di accesso sono conservati cifrati e usati esclusivamente per l'interfaccia BDTA.
- Potete interrompere il collegamento in qualsiasi momento.
Problemi frequenti
«Collegamento Agate scaduto» La sessione è terminata. Cliccate su Ricollega e accedete di nuovo a agate.ch.
«Nessuna azienda trovata» Il vostro account Agate non è autorizzato per alcuna azienda. Chiaritelo con il servizio veterinario cantonale o con identitas.ch.
L'azienda non si lascia più cambiare Una volta sincronizzati gli animali, il collegamento è definitivo. Se avete davvero scelto l'azienda sbagliata, scrivete a info@herdy.ch.