AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios”...

17
AgilityContest-3.5.X Importación/Exportación desde/hacia ficheros Excel Este documento indica los procedimientos para importar y/o exportar datos en formato Excel (.xlsx) desde/hacia la aplicación AgilityContest Se recuerda que la importación desde ficheros Excel es una característica opcional que requiere de permisos especiales en la licencia, no estando disponible en la distribución gratuíta Introducción AgilityContest utiliza internamente una base de datos MySQL. Si bien dicha base de datos proporciona gran flexibilidad al sistema, en ocasiones las funciones de backup/restore de la base de datos no son suficientes, pues afectan al total de los datos almacenados; siendo incompatible con la importación total o parcial de perros, inscripciones, etc Por ello AgilityContest ofrece la posibilidad de importar y exportar datos en formato Excel (.xlsx), pudiendo realizarse las siguientes operaciones: - Exportar e importar datos de perros, guías y clubs. En el caso de exportación se pueden especificar criterios de selección (p.e: exportar los perros de un club) - Exportar e importar datos de inscripciones, tanto en jornadas individuales como de equipos, indicando en qué jornada está cada equipo inscrito - Exportar e importar resultados por manga, incluyendo datos de TRS y TRM - Exportar clasificaciones finales - Exportar e importar horarios de entrenamiento y órdenes de salida Adicionalmente, AgilityContest es capaz de generar plantillas de importación, bien genéricas, bien personalizadas para un club, que una vez modificadas y completadas pueden ser a su vez re- importadas en la aplicación. Esto permite crear una prueba, generar la plantilla de importación de dicha prueba, y enviar la plantilla a los diversos clubes, para que una vez rellena se puedan importar directamente las inscripciones en la aplicación.

Transcript of AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios”...

Page 1: AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel” Exportar rondas

AgilityContest-3.5.X

Importación/Exportación desde/hacia ficheros Excel

Este documento indica los procedimientos para importar y/o exportar datos en formato Excel (.xlsx)desde/hacia la aplicación AgilityContest

Se recuerda que la importación desde ficheros Excel es una característica opcional que requiere de permisos especiales en la licencia, no estando disponible en la distribución gratuíta

Introducción

AgilityContest utiliza internamente una base de datos MySQL. Si bien dicha base de datos proporciona gran flexibilidad al sistema, en ocasiones las funciones de backup/restore de la base de datos no son suficientes, pues afectan al total de los datos almacenados; siendo incompatible con la importación total o parcial de perros, inscripciones, etc

Por ello AgilityContest ofrece la posibilidad de importar y exportar datos en formato Excel (.xlsx), pudiendo realizarse las siguientes operaciones:

- Exportar e importar datos de perros, guías y clubs. En el caso de exportación se pueden especificarcriterios de selección (p.e: exportar los perros de un club)- Exportar e importar datos de inscripciones, tanto en jornadas individuales como de equipos, indicando en qué jornada está cada equipo inscrito- Exportar e importar resultados por manga, incluyendo datos de TRS y TRM- Exportar clasificaciones finales- Exportar e importar horarios de entrenamiento y órdenes de salida

Adicionalmente, AgilityContest es capaz de generar plantillas de importación, bien genéricas, bien personalizadas para un club, que una vez modificadas y completadas pueden ser a su vez re-importadas en la aplicación. Esto permite crear una prueba, generar la plantilla de importación de dicha prueba, y enviar la plantilla a los diversos clubes, para que una vez rellena se puedan importardirectamente las inscripciones en la aplicación.

Page 2: AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel” Exportar rondas

Exportar de datos de Perros

1- Desde el menú de gestión de perros, mediante la casilla de búsqueda, realizar la selección de perros. Pulsando en las cabeceras de la tabla podemos ajustar el orden en que los perros aparecen2- Pulsando en “Importar/Exportar” seleccionamos la opción exportar.3- Automáticamente se genera y muestra para descarga el fichero Excel correspondiente, en el que aparecen los datos con la misma selección y orden que en la consola

Del mismo modo que en la consola, en el Excel solo aparecen los perros registrados de la federación activa ( RSCE / RFEC / UCA , etc )

Exportar Inscripciones

La gestión de inscripciones ofrece diversas posibilidades en cuanto a la exportación de datos en formato Excel:- Generar una plantilla vacía para la prueba seleccionada- Generar una plantilla con los datos de Perros y Guías existentes para un club determinado, de manera que éstos puedan ser corregidos y posteriormente re-importados- Exportar la lista de inscripciones completa

Los datos exportados incluyen información sobre el Dorsal, jornadas en que se inscribe, nombre delequipo (en el caso de pruebas por equipos), así como si el perro está en celo y el importe abonado en la inscripción

El procedimiento es el siguiente:- En el menú principal, seleccionar “Inscripciones”- Indicar prueba- Para generar plantillas, pulsando en “Importar/Exportar”, seleccionar la opción correspondiente- Para exportar las inscripciones, una vez realizadas éstas, seleccionar la opción en el menú

Page 3: AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel” Exportar rondas

Se pueden observar diversos detalles:- En las jornadas individuales, la inscripción en dicha jornada se marca con “X”- En las jornadas por equipos, se indica el nombre del equipo- Si no hay datos marcados, se asume que el participante no está inscrito en dicha jornada

La opción “Generar plantilla para el club”, permite especificar un club concreto. La aplicación generará una plantilla con todos los perros que figuran en la base de datos como pertenecientes a dicho club, con los campos “Dorsal”, “Pagado”,”Celo” y columnas de cada jornada vacíos, para quesea el usuario el que posteriormente los rellene, y opcionalmente añada/corrija las diversas entradas en el fichero Excel

Page 4: AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel” Exportar rondas

Exportar órdenes de salida

En ocasiones puede ser útil proporcionar a terceros información sobre el orden de salida de una manga en un formato que pueda ser re-utilizado; por ejemplo para generar subtítulos en una retransmisión, etc

El procedimiento es el siguiente:

- Desde el menú “Desarrollo de la prueba” seleccionar una manga- Abrir la ventana de “Orden de salida”- Seleccionar la categoría deseada- Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel”

Exportar rondas de entrenamiento

NOTA: La gestión de rondas de entrenamiento es un complemento opcional de AgilityContest. Consultar los términos de la licencia para ver si en su caso está disponible

- En el menu principal, seleccionar prueba y una jornada cualquiera (la sesión de entrenamientos es comun a todas las jornadas)- Pulsar en “Entrenamientos”- Seleccionar “Exportar en formato excel”- Se genera y ofrece para descarga el fichero correspondiente

Page 5: AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel” Exportar rondas

Exportar resultados parciales de una manga

Mediante este procedimiento podemos extraer los resultados parciales de una manga, y posteriormente importarlos en otra, con lo que el fichero puede ser utilizado para clonar mangas, resultados, etc

- Desde el menú principal, seleccionar “Desarrollo de la prueba”, e indicar prueba y jornadas- Seleccionar la manga y pulsar “Resultados de la manga”- Seleccionar la categoría- Pulsando en Importar/Exportar seleccionar “Exportar resultados a fichero Excel”

Page 6: AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel” Exportar rondas

Exportar clasificaciones

- Desde el menú principal, en “Clasificaciones” seleccionar prueba y jornadas- Seleccionar manga y categorías deseadas- Pulsando en “Imprimir”, seleccionar “Generar fichero para RSCE (Excel)”

NOTA: el formato de este fichero es provisional; se está pendiente de que las diversas federaciones propongan su correspondiente formato de intercambio de datos para elaborar el documento definitivo

Page 7: AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel” Exportar rondas

Generalidades sobre la importación de ficheros Excel

La importación de ficheros Excel en la aplicación no es un proceso sencillo: los ficheros Excel a manejar deben incluir una serie de campos obligatorios, otros opcionales, así como otros que si bienpueden ser de utilidad para el usuario serán ignorados por la aplicación.

AgilityContest está preparado para que todos los ficheros Excel que genera sean compatibles consigo mismo, esto es: los ficheros Excel que genera pueden ser usados como plantilla de importación. No obstante, el usuario puede utilizar sus propios ficheros, siempre y cuando dichos ficheros contengan los campos obligatorios

Los ficheros Excel pueden contener una o varias hojas; la aplicación buscará las hojas con un nombre clave “Perros” “Inscripciones” “Entrenamientos”, “Resultados” “Orden de Salida” o bien, si solo hay una hoja, la utilizará como plantilla de importación de datos

El orden y formato de las columnas puede ser cambiado a voluntad; solo se exige que existan los campos obligatorios.

La primera fila de la hoja es siempre usada como cabecera, y contiene los nombres de los campos a utilizar. No obstante, si el número de celdas de la cabecera es menor que 3, la aplicación considerarádichas filas como campos de asignación de variables a tener en cuenta en la importación. Esto permite, por ejemplo, especificar los datos de la manga en la hoja de resultados parciales

El usuario puede definir reglas de importación: convertir textos a Mayúsculas iniciales, decidir qué se hace cuando el excel o la base de datos tienen campos en blanco; qué datos tienen precedencia (BBDD o Excel) a la hora de guardar la importación, etc.

El procedimiento de importación consiste en analizar el fichero Excel y buscar en la base de datos las entradas coincidentes, de manera que se puedan mezclar los datos de ambas fuentes. Previamente se realiza un chequeo de consistencia y validez del fichero a importar, analizando campos, comprobando validez del contenido, etc

Existen dos procedimientos de importación:

Importación ciega (no interactiva)

Los datos son aceptados “tal cual”. La aplicación buscará coincidencias en la base de datos. Si las encuentra las usará. Si por el contrario no encuentra una coincidencia, asumirá que dicha entrada noexiste y la creará en base a los datos existentes en el fichero Excel

En el caso de que la no-coincidencia se dé a la hora de importar un club, la importación se cancelará: las plantillas Excel no proporcionan suficiente información como para poder crear un club en la base de datos de manera automática

Importación interactiva

En este caso la aplicación no busca coincidencias exactas, sino similitudes. Cuando encuentra una entrada coincidente, se utiliza dicha entrada aplicando las reglas de importación pre-definidas.

Cuando no se encuentran coincidencias, o se encuentran coincidencias múltiples, se le informa al usuario y se le indica que tome una acción:- Solicitar al importador que cree una entrada nueva con los datos procedentes del fichero Excel- Indicarle al importador que ignore dicha entrada, de manera que ninguna aparición de dicho dato en el Excel será reflejado en la base de datos tras la importación- Seleccionar una entrada concreta de la base de datos y decirle al importador que dicha entrada es la que se busca. Adicionalmente el usuario podrá escoger el nombre del perro/guia que debe ser almacenado: el que figura en la hoja Excel o el indicado en la selección desde la base de datos

Page 8: AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel” Exportar rondas

Consideraciones sobre el formato de las hojas Excel

Como se ha indicado antes, se recomienda el uso de plantillas generadas a partir de la aplicación. En caso de usar plantillas propias hay que tener en cuenta diversos aspectos:

- El documento debe constar de una única hoja. En caso de constar de varias hojas, la hoja a importar deberá tener el nombre adecuado a cada tipo de importación.

- El nombre de la hoja puede estar bien en inglés o bien en el idioma seleccionado en el menú de configuración de la aplicación

- Nombres admitidos para las hojas:Dogs / Perros (o el equivalente en el idioma activo) – Para importar datos de perrosInscriptions / Inscripciones – Para importar bien perros, bien datos de inscripcionesTrainings / Entrenamientos – Para importar tablas y horarios de la sesión de entrenamientosResults / Resultados – Para importar tablas y datos de TRS de resultados parciales de una mangaStarting Order / Orden de Salida – Para importar el orden de salida de una manga

El mismo criterio se aplica a las cabeceras de cada columna: el nombre puede estar en inglés o en elidioma activo en el menú de configuración.

Las cabeceras de cada columna no deben incluir espacios, ni caracteres acentuados, ni signos de puntuación o aritméticos (punto, coma, +, - , * , / ,etc). En el caso de importar inscripciones, donde el nombre de una jornada suele ser un texto con espacios, se sugiere ajustar el nombre definitivo de la jornada una vez realizada la importación

Algunos campos permiten un conjunto restringido de posibles valores (mayúsculas/minúsculas se ignoran):

Género:'h','f','hembra','perra','female','bitch','chienne','gossa','cadela','cagna','hundin''m','macho','male','dog','chien','gos','cao','cane','hund'

Categoría:'l','large','standard','std','60','6''m','medium','midi','mid','med','50','5''s','small','mini','min','40','4''t','enano','tiny','toy','30','3','20','2'

Grado:‘pre-agility’, ‘preagility’, ‘pre’, ‘pa’, ‘p.a’. ‘0’, ‘g0’, ‘a0’‘grado1’, ‘g1’, ‘gi’, ‘a1’, ‘ai’‘grado2’, ‘g2’, ‘gii’, ‘a2’, ‘aii’‘grado3’, ‘g3’, ‘giii’, ‘a3’, ‘aiii’

Eliminado/NoPresentadocualquier valor que pueda ser interpretado como booleano. En caso de dejarse en blanco se interpreta como “false / 0”

Licencia:Verificar que en el caso de importar datos de RSCE la licencia esté formada por 4 o 5 números, o una letra seguida de 3 números. El formato es utilizado a la hora de evaluar puntos en pruebas selectivas

Page 9: AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel” Exportar rondas

Formato para importación de datos de perros.

La hoja Excel “Perros” ( “Dogs” ) contendrá al menos los siguientes campos:

Name/Nombre Obligatorio Nombre del perroLongName/NombreLargo Opcional Nombre largo (pedigree)Gender/Genero OpcionalBreed/Raza OpcionalLicense/Licencia Opcional Licencia federativaKC_ID/LOE_RRC Opcional Numero de registro en la sociedad caninaCategory/Categoria ObligatorioGrade/Grado ObligatorioHandler/Guia ObligatorioClub Obligatorio (Opcional en pruebas internacionales)Country/Pais Opcional (Obligatorio en pruebas internacionales)

Formato para importación de inscripciones.

La hoja “Inscripciones” (“Inscriptions”) contendrá, además de los campos indicados para la hoja “Perros” los siguientes campos adicionales:

Dorsal OpcionalHeat/Celo OpcionalPay/Pagado Opcional para indicar las cantidades abonadas en la inscripciónComments/Comentarios Opcional

Adicionalmente contendrá un campo por cada jornada, cuyo nombre coincide con el nombre asignado a la jornada a la hora de crear la prueba

El campo “Dorsal” puede ser cero, en cuyo caso el dorsal se calcula automáticamente, o un valor determinado, que se le asigna al perro inscrito. En caso de repetirse el número del dorsal, solo se conserva la última asignación

El campo “Celo” puede estar vacío o contener un valor no nulo. Se recomienda “X” para indicar que la perra está en celo

En el campo “Comentarios” se pueden incluír observaciones adicionales, p.e: “Test de carácter”

En las jornadas individuales, la inscripción se señala con una “X”

En las jornadas por equipos, la inscripción se señala indicando el nombre del equipo, o bien una “X” si no tiene equipo pre-asignado

Las jornadas en que el perro no esté inscrito, se dejarán sin marcar

El orden de salida viene dado por el orden en que las entradas han sido declaradas en el fichero Excel, con la salvedad de los perros en celo que serán situados al final de cada manga

Si un perro no figura inscrito en ninguna jornada, será procesado e incluído en la base de datos de perros/guías/clubes, pero no aparecerá en el listado de inscritos

Page 10: AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel” Exportar rondas

Formato para importación de resultados parciales

La tabla Excel contendrá (al menos) los siguientes campos:Name/Nombre Obligatorio Nombre del perroLongName/NombreLargo Opcional Nombre largo (pedigree)Gender/Genero OpcionalBreed/Raza OpcionalLicense/Licencia Obligatorio Licencia federativaKC_ID/LOE_RRC Opcional Numero de registro en la sociedad caninaCategory/Categoria ObligatorioGrade/Grado ObligatorioHandler/Guia Obligatorio Nombre del guíaClub Obligatorio (Opcional en pruebas internacionales)Country/Pais Opcional (Obligatorio en pruebas internacionales)Faults/Faltas Obligatorio Numero de faltas cometidasTouchs/Tocados Opcional Numero de tocados. Puede ser omitidoRefusals/Rehuses Obligatorio Numero de rehúsesTiempo Obligatorio tiempo en segundos. ( float)Eliminado Obligatorio Valor booleano. Si se deja en blanco se interpreta “0”NoPresentado Obligatorio Valor booleano. Si se deja en blanco se interpreta “0”

Adicionalmente se puede definir una cabecera usando las dos primeras columnas al principio de la hoja, que contendrá los datos de la manga

Dist Distancia (metros)Obst ObstaculosSCT/TRS Tiempo de recorrido standard (segundos)MCT/TRM Tiempo de recorrido máximo (segundos)

Otros datos que pueden ser incuídos en la cabecera son:Contest/Prueba Nombre de la pruebaJourney/Jornad Nombre de la jornadaRound/Manga Denominación de la mangaJudges/Jueces nombre de cada uno de los jueces ( uno en cada celda )

Se puede observar que la aplicación no va a importar los datos de penalización o puntuación: estos son recalculados dinámicamente en función de los datos de la manga

Page 11: AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel” Exportar rondas

Importación de órdenes de salida

NOTA: la gestión importación de órdenes de salida solo está disponible a partir de la versión 3.6.X de AgilityContest

Para importar el orden de salida de una manga, partiremos del fichero Excel resultado de exportar dicho orden, reordenando las filas de dicho fichero y/o ajustando el campo “Orden”. Una vez hecho basta con reímportar dicho fichero desde la opción “Importar desde Excel” en el menú de selección del ajuste del orden de salida

La tabla Excel contendrá (al menos) los siguientes campos:Order/Orden Opcional Orden de salidaName/Nombre Obligatorio Nombre del perroLongName/NombreLargo Opcional Nombre largo (pedigree)License/Licencia Obligatorio Licencia federativa

El campo “Orden” indica el orden en que sale el perro dentro de su categoría en la manga.Si el campo está vacío, o no existe dicha columna, el programa asignará el orden de salida en función de la posición dentro del Excel. Esto es: los primeros que aparecen son los primeros en salir

El programa utiliza el número de licencia para localizar al perro. Si el numero de licencia no existe o está duplicado, intentará localizar al perro en base al nombre o (si existe) el nombre de pedigree. Si aun así no lo identifica, preguntará al usuario qué hacer (en modo interactivo) o ignorará la entrada ( modo “ciego” )

En las opciones de importación del orden de salida se puede solicitar que el programa haga caso o ignore el campo “Orden” si está definido. En caso de ignorar dicho campo el orden asignado es elde aparición de las columnas en el fichero Excel

Si el fichero excel contiene perros no incluídos en la manga, según el modo de importación bien se preguntará al usuario qué hacer, o se ignorarán

Si algún perro participante en la manga no aparece en el fichero Excel, dicho perro saldrá a continuación de los especificados en el fichero

Page 12: AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel” Exportar rondas

Importación de sesiones de entrenamiento

NOTA: la gestión de sesiones de entrenamiento está todavía incompleta. Es posible que posteriores desarrollos puedan alterar el formato de importación/exportación de datos

La tabla Excel contendrá (al menos) los siguientes campos:

Club Obligatorio (Opcional en pruebas internacionales)Country/Pais Opcional (Obligatorio en pruebas internacionales)Date/Fecha Obligatorio Fecha de la sesión de entrenamiento ( yyyy-mm-dd )Check-in/Firma Obligatorio Hora de presentación del equipo ( hh:mm )Veterinary/Veterinario Obligatorio Hora de presentación al equipo veterinario (hh:mm)Start/Comienzo Obligatorio Hora de comienzo de la sesión de entrenamiento (hh:mm)Duration/Duracion Obligatorio Duración en segundos del entrenamientoKey1 Obligatorio Categoría que entrena en el ring 1Value1 Opcional Numero de perros que entrenan en el ring 1Key2 Obligatorio Categoría que entrena en el ring 2Value2 Opcional Número de perros que entrenan en el ring 2Key3 Obligatorio Categoría que entrena en el ring 3Value3 Opcional Número de perros que entrenan en el ring 3Key4 OpcionalValue4 Opcional

El país será indicado mediante la denominación ISO, bien completa, bien mediante el formato de 3 letras. Por ejemplo “Spain” o “ESP”

Procedimientos comunes de importación.

Al seleccionar la opción “Importar datos desde fichero Excel” en cualquiera de las ventanas en que está disponible aparecerá la siguiente ventana:

Page 13: AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel” Exportar rondas

En la ventana se indica como recordatorio la federación activa. Los cambios en los perros/guías/clubs afectarán a los datos de dicha federación

En todo proceso de importación es recomendable la realización previa de una copia de seguridad de la base de datos. Por ello la ventana ofrece la posibilidad de acceso directo a dicha función

Se indica el fichero a importar y se ofrece un botón para abrir el navegador de archivos para seleccionar dicho ficheros

El selector “Importación no interactiva” indica el modo en que se van a importar los datos, según lo explicado anteriormente: de manera automática, o guiada por el usuario

En las opciones de configuración podemos indicar qué operaciones se van a realizar con los datos importados:

- En el campo “prioridad” indicamos si a la hora de guardar los datos definitivos, se deben usar preferentemente los datos encontrados en la Base de Datos o del fichero Excel. Por ejemplo, si un perro en la base de datos tiente Grado 1 y el excel indica Grado 2, este campo indica qué valor se escogerá en el resultado final. Por defecto la prioridad la tiene el origen de datos Excel

No obstante, en el modo interactivo, cuando la aplicación requiere que el usuario seleccione un perro o un guia existente en la base de datos, es posible preservar el nombre bien de la base de datos, bien del fichero excel, de manera independiente a lo indicado en “prioridad”.

- La opción de “Conversión de texto” resulta útil para uniformizar el formato de los datos que se almacenarán: bien “tal cual” o bien poniendo en mayúsculas la inicial. Por defecto todos los textos son convertidos a formato Mayúscula incial

- La tercera opción indica qué operación se debe realizar cuando el un campo procedente del origen de datos marcado como “prioritario” (Base de datos o fichero Excel ) contiene un valor nulo o en blanco: dejar el campo en blanco (sobreescribir), o usar el valor del origen de datos secundario (ignorar). La opción por defecto persigue poner en blanco los menores campos posibles (ignorar)

Importación no interactiva

La regla de oro de este método de importación es:- Si no se encuentra una coincidencia EXACTA de una entrada del fichero Excel en la base de datos, se asume que dicha entrada no existe, y por tanto se intenta crear.- Si se encuentra dicha coincidencia se aplican las reglas de conversión escogidas por el usuario para calcular el resultado final

En el caso de no encontrar coincidencia en la búsqueda del club/país, y dado que no es posible crearautomáticamente un club a partir de los datos Excel, se indica un mensaje de error y se aborta la operación.

Page 14: AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel” Exportar rondas

Dado que la importación no interactiva busca coincidencias exactas, salvo una revisión muy cuidadosa del fichero Excel se suele producir la aparición de datos duplicados en la base de datos, en los que el mismo perro o guía aparece dos veces cambiando simplemente una letra.

Para resolver duplicados una vez realizada la importación se procederá de la siguiente manera:

En el caso de guías duplicados:- Abrir el menú de gestión de guías- Seleccionar el guía correcto- Reasignar los perros del guía duplicado al guía correcto- Una vez que el guía duplicado no tenga perros, borrar éste de la base de datos

La operación anterior posiblemente (casi seguro) resulte en que el guía correcto tiene registrado el mismo perro dos o más veces. Para resolverlo procederemos tal que sigue:

En el caso de perros duplicados:

- Abrir el menú de gestión de perros- Seleccionar el perro duplicado mediante doble click- Pulsar el botón “Unir perros”. Aparecerá un dialogo en el que seleccionaremos la entrada correspondiente al perro correcto. Con el botón “Aceptar”, haremos que todas las referencias al perro duplicado sean convertidas a referencias al perro correcto

Este procedimiento es laborioso: hay que revisar el fichero Excel, y una vez realizada la importación, revisar la base de datos en busca de posibles duplicados. Por ello la importación no interactiva, si bien es muy sencilla, se recomienda que solo sea usada en pruebas “de usar y tirar”, esto es: cuando no sea necesario conservar la prueba y sus resultados en la base de datos, pudiendo restaurar la copia de seguridad una vez realizada la prueba

La importación no interactiva está indicada pues en pruebas especiales, eventos, open, etc, en que no necesitamos guardar resultados de forma permanente. No está indicada en ligas o pruebas clasificatorias donde interesa guardar en la base de datos los datos de cada perro de una prueba a otra

Page 15: AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel” Exportar rondas

Importación de perros o inscripciones en modo interactivo

Este procedimiento, requiere del operador para resolver los conflictos encontrados a la hora de realizar la importación de datos. Las reglas:

- En lugar de buscar coincidencias exactas se buscan similitudes en los datos. Por ejemplo, si en el Excel aparece como nombre del guía “Juan”, se marcarán como coincidentes todas las entradas de la base de datos que contengan dicha palabra en el nombre del guía

- La búsqueda de similitudes solo se aplica al nombre del club, guía o perro: en los guías no se busca la coincidencia del club ( el guía puede haber cambiado de club) y en los perros no se busca la coincidencia de guía/grado ( el perro puede haber cambiado de guía o de grado )

- Si se encuentra una única coincidencia entre la base de datos y el fichero Excel se utiliza dicha entrada de la base de datos y se importa directamente aplicando los filtros pre-determinados

- Si no se encuentra ninguna coincidencia, o bien se encuentran más de una entrada en la base de datos que puedan ser aplicadas a la búsqueda, se pregunta al operador qué hacer

El cuadro de diálogo que aparece le indica al operador:- La entrada Excel que se está procesando- El elemento cuya coincidencia se está buscando ( Club,Guía,Perro)- Si ha encontrado varias coincidencias o ninguna

El operador tiene tres opciones:

1- Decirle al importador que cree una entrada nueva con los datos del fichero Excel. En el caso de clubes, y como no es posible crear un club con los datos proporcionados, se le muestra al usuario el diálogo de creación de nuevo club

Page 16: AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel” Exportar rondas

2- Seleccionar una entrada existente de la base de datos y decirle al importador que aplique a dicha entrada los filtros adecuados para mezclar dichos datos con los del fichero Excel

En esta opción aparece un botón de selección adicional, que permite decidir qué nombre se va a guardar en la base de datos: si el existente en dicha DB o el nuevo que figura en el fichero Excel. Los demás datos ( sexo, categoria, grado, licencia, club, etc ) se importan conforme a las reglas de prioridad establecidas al principio. Esto permite escoger el nombre del perro o del guía que va a aparecer al final en la base de datos, para evitar problemas derivados de que se proporcionen nombres incompletos en el Excel

3- Indicar que la entrada buscada se debe ignorar. El importador ignorará ésta y todas las demás apariciones del club/guía/perro en los datos del Excel, y por consiguiente no serán importados

Consideraciones adicionales para la importación de inscripciones

Se pueden aplicar varias importaciones sucesivas de inscripciones a una prueba, cada una desde un fichero Excel distinto. Las inscripciones ya realizadas y que no se ven afectadas por la importación de datos se mantienen. Esto permite, por ejemplo, ir procesando las plantillas de inscripción recibidas desde cada club a medida que llegan

Si una importación modifica los datos de una inscripción previa (por ejemplo, perro en celo o cambio de grado), los resultados, órdenes de salida y demás elementos asociados cambian conformea los nuevos datos. Una re-importación con los mismos datos no afecta la inscripción original

Page 17: AgilityContest-3.5.X Importación/Exportación desde/hacia … · - Pulsando en “Formularios” Seleccionar la opción de “Orden de salida de la manga - Excel” Exportar rondas

Importación de resultados parciales

El menú de importación incluye las siguientes opciones:- Selección de importación en modo interactivo o modo “ciego”- Posibilidad de importar datos de la pista si están disponibles- Posibilidad de omitir las entradas marcadas como “No Presentado” (para poder realizar importaciones parciales )

- En modo “no interactivo” la aplicación IGNORA todas las entradas Excel que:

* NO figuren como inscritos en la manga. Debe coincidir tanto el nombre del perro como la licencia* NO incluyan licencia y/o nombre del perro* NO coincidan en categoría/grado con la manga a importar

- En el modo “interactivo”, cuando el programa no es capaz de decidir el perro al que asignar los resultados, preguntará al usuario, abriéndose una ventana de dialogo.

El usuario podrá:* Ignorar la entrada: no será procesada* Seleccionar un perro de entre los inscritos en la manga y de categoria compatible con la actual

Importación de tablas de sesiones de entrenamiento

En las sesiones de entrenamiento, el único campo sobre el que se pueden buscar coincidencias en la base de datos es el correspondiente al club (o país, en el caso de competiciones internacionales)

En el momento de escribir este manual, para la importación de datos de sesiones de entrenamiento, solo está disponible la importación no interactiva.Actualmente el importador de sesiones de entrenamiento no verifica si el club/país indicado en la hoja Excel tiene miembros inscritos en la prueba. Esto será corregido en el futuro