manual de l'aplicació del registre general d'animals de companyia
TRANSCRIPT
1 de 22
Projecte: ANICOM
Manual d’Usuari
(ANICOM)
2 de 22
1. INTRODUCCIÓ ........................................................................................................................................... 3
1.1. OBJECTE .................................................................................................................................................. 3
1.2. ABAST...................................................................................................................................................... 3
1.3. DOCUMENTACIÓ RELACIONADA .............................................................................................................. 3
2. DESCRIPCIÓ GENERAL DEL SISTEMA ............................................................................................... 4
2.1. ENTORN DE TREBALL ............................................................................................................................... 4
2.2. PERFILS D’USUARI ................................................................................................................................... 5
2.3. FUNCIONAMENT DEL SISTEMA ................................................................................................................. 6
2.4. AJUDES .................................................................................................................................................... 6
3. USUARIS “ENS LOCALS” ......................................................................................................................... 7
3.1. CERCA I CONSULTA DE PROPIETARIS ....................................................................................................... 7
3.1.1. Operativa de la Funcionalitat ......................................................................................................... 7
3.2. ALTA I MODIFICACIÓ DE PROPIETARIS....................................................................................................... 9
3.2.1. Operativa de la Funcionalitat ......................................................................................................... 9
3.3. CERCA I CONSULTA D’ANIMALS.............................................................................................................. 11
3.3.1. Operativa de la Funcionalitat ....................................................................................................... 11
3.4. ALTA I MODIFICACIÓ D’ANIMALS............................................................................................................ 13
3.4.1. Operativa de la Funcionalitat ....................................................................................................... 13
3.5. CERCA I CONSULTA D’AGRESSIONS ........................................................................................................ 17
3.5.1. Operativa de la Funcionalitat ....................................................................................................... 17
3.6. HISTÒRIC. CERCA D’AGRESSIONS ........................................................................................................... 18
3.6.1. Operativa de la Funcionalitat ....................................................................................................... 19
3.7. HISTÒRIC. CERCA D’ASSENTAMENTS. .................................................................................................... 19
3.7.1. Operativa de la Funcionalitat ....................................................................................................... 19
3.8. EXPORTACIÓ DE DADES DEL REGISTRE DE ANIMALS .............................................................................. 20
3.8.1. Operativa de la Funcionalitat ....................................................................................................... 20
3.9. CANVI DE CONTRASENYA ...................................................................................................................... 21
3.9.1. Operativa de la Funcionalitat ....................................................................................................... 21
4. ANNEXES.................................................................................................................................................... 21
4.1. ANNEX 1: GLOSSARI .............................................................................................................................. 21
4.2. ANNEX 2: INCIDÈNCIES MÉS FREQÜENTS ............................................................................................... 21
4.3. ANNEX 3: MISSATGES D’ERROR............................................................................................................. 21
4.4. ANNEX 4: DESCRIPCIÓ DE LES PANTALLES............................................................................................. 22
4.5. ANNEX 5: DESCRIPCIÓ D’INFORMES....................................................................................................... 22
3 de 22
1. Introducció
1.1. Objecte
Proporcionar una guia per a l’ús de l’aplicació WEB desenvolupada per al projecte de Registre
d’Animals de Companyia, en endavant ANICOM. Fer un repàs breu de les funcionalitats
implementades i mostrar com executar-les des de les pantalles desenvolupades per a ANICOM.
1.2. Abast
Usuaris directes d’ANICOM. Usuaris que pertanyen a la Direcció General de Medi Natural i
Biodiversitat, en endavant DGMNB, usuaris que pertanyen als cossos de seguretat, i usuaris d’ens
locals.
1.3. Documentació Relacionada
• Anàlisis Funcional d’ANICOM.
4 de 22
2. Descripció General del Sistema
ANICOM és una aplicació WEB per a la gestió dels animals de companyia i integra les dades dels
diferents cens d’animals de companyia dels Ajuntaments de Catalunya, a més de registrar les
agressions dels gossos que gestiona la DGMNB a partir de les denúncies comunicades . L’usuari
podrà registrar els animals amb les seves dades d’identificació (espècie, raça, tipus de marcatge, etc),
el seu veterinari, els seus propietaris i els assentaments on es troben censats, a més d’un registre
d’agressions..
Un altre tipus d’usuari més avançat (Administrador) podrà gestionar dades i paràmetres de
configuració de l’aplicació, i també donar accés a ANICOM als usuaris que sigui necessari.
2.1. Entorn de treball
Com ja s’ha esmentat abans, ANICOM és una aplicació WEB, per tant només és necessari un
navegador estàndard per utilitzar-la.
A l’inici, es demanarà a l’ usuari que introdueixi un nickname i una clau per validar si té permisos per
accedir-hi:
Una vegada s’hagi introduït el codi d’usuari i la clau correctes, l’aplicació ens mostrarà la pantalla
principal, que té 3 zones clarament diferenciades: Capçalera (dades generals i de navegació), Menú a
l’esquerra (enllaços amb les funcionalitats), i zona de treball al centre i que mostrarà la pantalla
corresponent a la funcionalitat seleccionada al menú:
5 de 22
Sota del menú també hi ha un bloc amb dades de contacte que es mostrarà sense canvis en totes
les pantalles.
Les opcions disponibles al menú no seran les mateixes per a tots els usuaris, si no que depenen del
perfil de l’usuari connectat. Aquest tema es descriu al següent punt.
2.2. Perfils d’Usuari
ANICOM té 4 perfils d’usuari, encara que en aquest manual només es detallarà el corresponent als
ens locals:
• Usuari Administrador: Usuari de nivell superior que pot accedir a totes les funcions i dades de
l’aplicació, amb l’excepció de que no registraran animals en el cens municipal d’animals de
companyia. Configura els paràmetres del sistema, defineix els usuaris i assigna els rols.
• Usuari ens local:
o Ajuntaments: Registraran i modificaran dades del seu cens però tindran accés en
mode consulta a totes les dades enregistrades en el sistema. Els Ajuntaments podran
consultar les agressions dels gossos censats en el seu municipi, encara que aquestes
agressions s’hagin efectuat en d’altres municipis. Podran fer una cerca per xip que, en
els casos de que l’animal no estigui censat en el municipi, aportarà la següent
informació:
� Últim municipi en el que estava censat
� Indicador de si és vigent
� Indicador de si és perillós
� Indicador de si té registrades agressions
o Supramunicipal: Equivalent a l’usuari de l’Ajuntament, però aplicat al conjunt de
municipis que té en delegació la gestió del cens municipal d’animals de companyia.
• Cossos de seguretat: Consultaran dades del propietari a partir de la identificació de l’animal.
• DGMNB: Consultaran les dades de tots els censos municipals d’animals de companyia, però no
registraran en aquests. D’altra banda registraran les agressions dels gossos i tindran accés a
6 de 22
les extraccions i importacions de dades. En aquest col·lectiu s’inclouen els usuaris de Serveis
Territorials. També gestionaran l’històric del registre.
2.3. Funcionament del Sistema
Els Ens Locals s’encarregaran de mantenir les dades actualitzades del cens d’animals de la seva
zona, i també podran consultar les dades d’altres zones amb restriccions. Podran obtenir dades
dels animals tals com:
� Últim municipi en el que estava censat
� Indicador de si és vigent
� Indicador de si és perillós
� Indicador de si té registrades agressions
Els usuaris del DGMNB podran consultar dades del cens dels animals i registraran les agressions.
Els usuaris dels cossos de seguretat podran fer consultes dels propietaris dels animals filtrant per
dades de l’animal.
L’usuari Administrador s’encarregarà d’habilitar l’accés a l’aplicació i configurar algunes de les
opcions permeses per a descriure un assentament en el cens, per exemple: tipus d’identificació
d’animal, tipus de d’identificació del propietari, tipus d’atac, raça, sexe, etc., mitjançant la secció del
menú “Taules mestres”.
2.4. Ajudes
No hi ha ajudes contextuals a l’aplicació, encara que donada la baixa complexitat funcional i d’ús de
l’aplicació, normalment es pot deduir el funcionament d’una pantalla de la distribució dels camps, els
botons i el text de les etiquetes als formularis.
7 de 22
3. Usuaris “Ens Locals”
Es tracta dels usuaris que ompliran l’aplicació amb la informació corresponent.
3.1. Cerca i Consulta de Propietaris
L’ens local podrà accedir a les dades del propietari en mode edició i consulta.
3.1.1. Operativa de la Funcionalitat
Si seleccionem l’opció del menú “Cerca de propietari”, el navegador ens mostra una pantalla amb una
zona central que és un formulari de cerca per dades del propietari:
Cada criteri se suma a l’anterior, és a dir, la cerca torna una llista de propietaris que compleixen TOTS
els criteris introduïts, NO ALGUN d’ells.
Quan es realitza una cerca per identificació, s'ha d'informar el tipus d'identificació i l'identificador.
El resultat de la cerca tornarà els propietaris que no es trobin de baixa al registre.
Si seleccionem un criteri i fem clic al botó “Cercar”, el resultat de la cerca es mostra a la mateixa
pantalla, junt amb els criteris de cerca:
8 de 22
Les zones ressaltades en roig mostren respectivament, el criteri seleccionat, la botonera per exportar
el resultat de la cerca a PDF o MS Excel, i els botons que, des de la fila del registre de cada propietari,
ens permeten accedir a la consulta o edició del propietari.
Si fem clic en la imatge accedim a les dades del propietari en mode consulta:
En l’exemple podem veure les dades d'identificació i direcció del propietari i disposem d'un botó per
tornar a la pantalla de cerca anterior, a més d’informació sobre els usuaris que han donat d’alta i
modificat les dades del propietari.
9 de 22
3.2. Alta i modificació de propietaris
Funcionalitat per afegir un propietari al registre de propietaris o modificar-lo.
3.2.1. Operativa de la Funcionalitat
Alta de propietari
Si seleccionem l’opció de menú “Afegir Propietari”, el navegador ens mostra una pàgina amb un
formulari amb tots els camps buits:
Els camps marcats en taronja i amb asterisc son obligatoris. Per exemple:
Si no els introduïm i cliquem “Desar” per tal de realitzar l’alta, el sistema no ens permetrà donar d’alta
el propietari:
A més dels camps obligatoris, es comprovarà també que el numero de document del propietari no
existeixi ja al registre i si existeix es mostrarà el següent error:
10 de 22
Si introduïm els camps obligatoris i cliquem el botó “Desar”, el propietari queda emmagatzemat al
registre, el sistema ens mostra un missatge de que tot ha anat correctament i ens mostra les dades
que hem introduït:
Edició de propietari .
A l’edició de propietari s’accedeix des del resultat de la cerca de propietaris, clicant en la imatge :
Si cliquem, accedim a la pantalla d’edició en la qual podrem modificar les dades de propietari i també
donar-lo de baixa.
11 de 22
Aquí disposen d’un check-button per donar de baixa al propietari. Una vegada fets el canvis farem clic
al botó desar per tal d’actualitzar el registre de propietaris.
3.3. Cerca i consulta d’animals
Cerca i consulta d’animals i el seus assentaments. L’ens local podrà fer cerques sobre el total del cens
d’animals i podrà accedir en mode consulta mentre que l’edició de la fitxa de l’animal només estarà
accessible per aquells que estiguin registrats en el seu cens .
3.3.1. Operativa de la Funcionalitat
L’operativa serà molt similar a la cerca i consulta de propietaris. Accedirem a un formulari on es podrà
cercar les dades de l’animal filtrant per dos tipus de criteri de cerca, propietari i animal.
El navegador ens mostra una pantalla amb una zona central que és un formulari de cerca, per dos
criteris, dades de l’animal i dades del propietari, que seran seleccionats mitjançant un radio-button,
que bloqueja el criteri no seleccionat.
Cada criteri se suma a l’anterior, és a dir la cerca torna una llista de propietaris que compleixen TOTS
els criteris introduïts, NO ALGUN d’ells.
12 de 22
Les zones ressaltades en roig ens mostren respectivament, el criteri seleccionat, la botonera per
exportar el resultat de la cerca a PDF o MS Excel, i els botons que, des de la fila del registre de cada
animal, ens permeten accedir a la consulta o edició de l’animal (si l’usuari té privilegis per a editar).
Per a la consulta, clicant en la imatge accedim a les dades de l’animal / assentament en mode
consulta:
13 de 22
:
3.4. Alta i modificació d’animals
Funcionalitat per afegir un animal al registre d’animals o modificar-lo. L’ens local serà l’encarregat
d’afegir animals/assentaments al registre, dins el seu àmbit territorial.
3.4.1. Operativa de la Funcionalitat
Alta d’animal / assentament .
Accedirem a la pantalla fent clic al menú de l’esquerra, Animals�Afegir. Com hem esmentat a
l'apartat d’alta de propietari els camps en taronja i amb asterisc són obligatoris.
14 de 22
A la pantalla veiem set apartats diferents:
Registre: apareix el numero de registre de l'assentament, que és un número seqüencial assignat
automàticament per a cada assentament en el Registre d’animals. L’estat conté els diferents estats en
els quals pot trobar-se un assentament (quan donem d'alta un nou aquest estat serà vigent) i la data
d’inici de l’assentament, que és la data a partir de la qual té efecte l’assentament.
Dades de l'animal: on podem donar d'alta un animal nou, omplint almenys les dades obligatòries, o
realitzar una cerca per identificació de l’animal per tal de donar d'alta un nou assentament per al
mateix animal. Per realitzar la cerca de l’animal omplirem tipus d’identificació i identificador, i farem clic
al botó de cerca per tal de que es carreguin la resta de dades.
Consideracions especials: Aquest apartat estarà actiu únicament per als gossos, i assenyalarem si
es tracta d'un gos d'assistència o si és un gos perillós. Segons quin cas assenyalem, apareixerà un
missatge que ens avisarà:
15 de 22
* Si es classifica un animal com a “perillós” no pot ser marcat com “d’assistència”.
Dades del propietari: En aquest apartat se seleccionarà un propietari del registre, prèviament donat
d'alta. S’ompliran les dades d’identificació (tipus i numero) i fent clic al botó cercar s'ompliran la resta
de camps recuperats de la base de dades.
Dades del veterinari: Es realitzarà la cerca pel numero de col·legiat del veterinari i s'ompliran
automàticament nom i cognoms. Si no existeix el veterinari, es podrà donar d'alta en aquest apartat.
Domicili de l’animal si es diferent al del propieta ri: S'ompliran les dades de domicili de l'animal en
cas que es vulgui realitzar l'assentament de l'animal en un domicili diferent del propietari.
Observacions: Comentaris per part de l’ens local (si fos necessari).
Una vegada omplertes totes les dades de l’animal / assentament, farem clic al botó desar per
emmagatzemar els canvis.
Si falta algun camp obligatori l'aplicació ens advertirà amb el següent missatge:
Si un ens local tracta de donar d'alta un animal en un assentament que no pertany al seu àmbit
territorial apareixerà el següent missatge d'error:
16 de 22
Una vegada introduïts els camps obligatoris, farem clic al botó “Desar”, i l’assentament / animal
quedarà emmagatzemat al registre. El sistema ens mostrarà un missatge de que tot ha anat
correctament i veurem el número de registre assignat per a l’assentament.
Altres consideracions sobre l’alta i modificació d’ assentaments / animals
Canvi de municipi de residència de l’animal. En aquest cas, el sistema farà la baixa del registre en
el municipi d’origen (si existia en situació de vigent) amb la data del dia anterior a l’alta informada en el
municipi de destinació.
Canvi de propietari. En aquest cas el sistema procedirà a realitzar la baixa del registre vigent anterior
de forma anàloga al canvi de municipi.
Modificació d’animal / assentament.
A l’edició d’animal / assentament s’accedeix des del resultat de la cerca d’animals, fent clic en la
imatge , si es tenen permisos:
17 de 22
En la modificació es podran realitzar canvis de la informació i també com veiem ressaltat en la captura,
informar d’una data de fi de l'assentament per donar-lo de baixa. Aquest camp només es troba editable
si l’estat es diferent a “vigent”.
3.5. Cerca i consulta d’agressions
Cerca i consulta d’agressions. L’ens local podrà fer cerques sobre agressions comeses per animals
censats dins del seu àmbit territorial i podrà accedir en mode consulta a la fitxa de l’agressió.
3.5.1. Operativa de la Funcionalitat
Accediren a través del menú de l’esquerra (Agressions�Cercar) a un formulari on es podran cercar
les dades de l’agressió filtrant per diferents criteris: dades de l’animal, dades del propietari i dades de
l’agressió.
Cada criteri se suma a l’anterior, és a dir la cerca torna una llista d’agressions que compleixen TOTS
els criteris introduïts, NO ALGUN d’ells.
Quan es realitza una cerca per identificació, tant de l'animal com del propietari, s'han d'informar tant el
tipus d'identificació com l'identificador per a l'animal i el numero d'identificació per al propietari.
Els ens locals tindran limitades aquestes consultes a les agressions dels gossos censats en el seu
municipi, encara que aquestes agressions s’hagin efectuat en d’altres municipis.
18 de 22
Les zones ressaltades en roig ens mostren respectivament, el criteri seleccionat, la botonera per
exportar el resultat de la cerca a PDF o MS Excel, i els botons que, des de la fila del registre de cada
agressió, ens permeten accedir a la consulta de l’agressió.
Per a l'interval de dates on es produeix l'agressió es validarà que la data mínima sigui igual o inferior a
la data màxima. Si s'introdueix de manera incorrecta apareixerà el següent error:
Fent clic en la imatge accedim a les dades de l’agressió en mode consulta:
3.6. Històric. Cerca d’agressions
Aquesta funcionalitat permet la cerca de l’històric d'agressions filtrant per identificació de l’animal. Des
d'aquesta cerca es podrà accedir a la fitxa de l'agressió en mode consulta.
L’usuari ens local podrà cercar l’històric d’agressions dels gossos censats dins el seu àmbit territorial.
19 de 22
3.6.1. Operativa de la Funcionalitat
Accediren a un formulari on es podran cercar les dades de l’agressió filtrant per identificació de
l’animal. Si no s'informen les dades de cap animal, la cerca tornarà totes les agressions registrades
que hagi comès un gos censat dins del seu àmbit territorial. Es mostra una captura de la pantalla:
Les dades de la agressió seran accessibles mitjançant el botó de consulta:
3.7. Històric. Cerca d’assentaments.
Aquesta funcionalitat permet cercar l’històric d'assentaments del registre, filtrant per identificació de
l’animal. Des d'aquesta cerca es podrà accedir a la fitxa d’animal i propietari en mode consulta.
L’usuari ens local podrà cercar l’històric d’assentaments dels gossos censats dins el seu àmbit
territorial.
3.7.1. Operativa de la Funcionalitat
Accediren a un formulari on es podran cercar les dades de l’assentament filtrant per identificació de
l’animal. Si no s'informen les dades de cap animal, la cerca tornarà tots els assentaments registrats.
En el cas de l'ens local sol tornarà els que siguin al seu àmbit territorial. Es mostra un captura de la
pantalla:
20 de 22
Les dades de l’animal i del propietari seran accessibles mitjançant el botó de consulta:
3.8. Exportació de Dades del Registre de animals
Aquesta funcionalitat permet exportar totes les dades de l'animal, propietari i assentament a un fitxer
en format Excel a partir de dos criteris de cerca, per animal i per assentament.
En l’usuari ens local , el filtre estarà limitat a l’àmbit territorial de l’usuari.
3.8.1. Operativa de la Funcionalitat
Accediren a un formulari on es podrà cercar les dades de l’assentament, l’animal i el propietari. En el
cas de l'ens local sol tornarà els que siguin al seu àmbit territorial. Es mostra un captura de la pantalla:
La cerca mostrarà un resum de les dades contingudes al full Excel. Per generar l’informe, es farà clic
al botó d'exportació a Excel que es veu ressaltat en roig. Apareixerà una finestra, on podrem obrir
directament el fitxer o conservar-lo en disc.
21 de 22
3.9. Canvi de Contrasenya
Utilitat que permet a un usuari canviar la seva contrasenya d’accés a ANICOM, i ATENCIÓ: a
QUALSEVOL ALTRA APLICACIÓ del DAAM que utilitzi les dades d’usuari emmagatzemades a les
taules comunes. Qualsevol usuari amb accés a ANICOM pot utilitzar aquesta utilitat.
3.9.1. Operativa de la Funcionalitat
L’operativa és molt simple com es pot veure en la captura de Pantalla:
4. Annexes
4.1. Annex 1: Glossari
• DAAM: : Departament d’Agricultura, Ramaderia, Pesca, Alimentació i Medi Natural.
• DGMNB: Direcció General del Medi Natural i Biodiversitat.
• ANICOM: Aplicació pel Registre d’animals de companyia de Catalunya. L’aplicació
que es descriu en aquest manual d’usuari.
4.2. Annex 2: Incidències més Freqüents
No Aplica.
4.3. Annex 3: Missatges d’Error
Hi ha dos tipus d’error, el que correspon a un error funcional controlat i el incontrolat.
Els errors de tipus funcional normalment seran validacions de dades que el sistema fa i en les
quals, en el propi missatge d’error, s’indica a l’usuari com pot solucionar el problema.
22 de 22
En canvi els errors incontrolats, com el seu nom indica, són errors que es produeixen de forma
inesperada, i als quals l’usuari no pot fer res per a solucionar-los. L’únic que pot fer és avisar a un
Administrador per informar del problema.
Exemple:
4.4. Annex 4: Descripció de les Pantalles
No Aplica.
La descripció de les pantalles s’ha anat fent al llarg del document.
4.5. Annex 5: Descripció d’Informes
No Aplica.