Datos Standard 3.0
Introducción a la IOF Interface Standard 3.0
¿Qué es la interfaz estándar IOF?
La Federación Internacional de Orientación (IOF) Estándar de interfaz es una especificación de un formato de datos XML para el intercambio de información relacionada con la orientación (eventos, entradas de inicio, listas, listas de resultados, etc) entre aplicaciones, servicios web y bases de datos. Una vez aprobado por los paquetes de software de orientación, permitirá que los paquetes para intercambiar información entre sí. Esto beneficiará a los organizadores del evento y contribuir a la simplificación de la organización de eventos de orientación.
Tema de Fondo
Entre orientadores tenemos un deseo común para beneficiarse del uso de la última tecnología.
Una clara indicación de ello es el número de sistemas informáticos que utilizamos cuando nos organizamos eventos de orientación. Cada uno de los sistemas lleva a cabo su tarea propia especialidad: las entradas de control de eventos, planificación de los cursos, los competidores de tiempo, la producción de resultados, proporcionando información para comentarios de eventos y control de golpes electrónicos.
Puede ser toda una empresa para hacer todos estos sistemas de cooperar y trabajar duro a menudo se pone mucho en en eventos para asegurar la transferencia segura y fiable de información de un sistema informático a otro.
Esto lleva a la conclusión de que existe una necesidad de un medio sencillo para que todos estos sistemas diferentes para comunicar información de una manera fiable.
Historia
Los esfuerzos para definir un estándar de interfaz para la orientación iniciada en octubre de 1998 en una reunión del Comité Técnico de Desarrollo de la IOF en Oslo, Noruega. La primera versión pública se publicó en enero de 2001, pero pronto demostró ser insuficiente. La versión 2.0.3 fue publicada en abril de 2002 y ha sido el estándar de la interfaz actual por más de diez años.
Información acerca de las versiones anteriores del estándar de interfaz IOF se puede encontrar aquí.
IOF Interface Standard 3.0
El negocio de tecnología de la información evoluciona rápidamente y diez años es mucho tiempo en esta perspectiva. Nuevas normas, herramientas y plataformas disponibles, y cambiar los patrones de uso.
Además, el deporte de orientación se desarrolla. Los nuevos formatos de eventos e invenciones, como el seguimiento geográfico de los competidores no son compatibles con la versión 2.0.3. La necesidad de una nueva versión de la interfaz estándar fue identificado en 2010. Dos años más tarde, al final de 2012, la nueva versión fue declarado oficial.
La especificación formal del nuevo estándar de interfaz se puede encontrar aquí.
XML Schema
La especificación de la nueva versión se expresa como un esquema XML, en contraste con la DTD (Document Type Definition) utilizado anteriormente. Definición de la estructura de la información utilizando un esquema XML es más poderoso que el uso de una DTD. Los beneficios incluyen:
Soporte para tipos de datos
Soporte para espacios de nombres, lo que permite ampliaciones
Apoyo para la validación
Generación de código y herramientas de validación disponible para todos los principales lenguajes de programación y plataformas
Mejoras
Hay una serie de mejoras en la versión 3,0 en comparación con la versión 2.0.3. Algunos de ellos, pero no todos, se enumeran aquí.
Uso de tipos de datos estandarizados en XML Schema
ISO 8601 fechas y horarios
total de segundos en lugar de hh: mm para los tiempos transcurridos
Mejora de la estructura de datos para la información de contacto para las personas y organizaciones
dirección de correo electrónico
La dirección física
sitios web
Soporte para listas de tarjetas de control (para realizar un seguimiento de las tarjetas de alquiler)
Apoyo a la ubicación geográfica (latitud y longitud, es decir) para eventos y clubes
Más detalles del evento
calendarios de eventos (por ejemplo, primera salida, el banquete, la ceremonia de entrega de premios)
información
noticias
Apoyo a la jerarquía de la organización (IOF> internacional regional federaciones> Federaciones nacionales> national federaciones regionales> clubes)
Soporte para logotipos del club
Mejorado el soporte cuota de entrada
honorarios dependiendo de la hora de entrada y / o la edad competidor
honorarios para los competidores supletorias en equipo
El apoyo a los eventos de estilo rogaining-(puntajes de control)
Mejorado el soporte para pruebas por equipos / relé
número variable de miembros en un equipo
variable número de competidores por la pierna relé
un equipo puede pertenecer a varios clubes
los resultados individuales por curso relé y relé pierna
los resultados del equipo después de cada pierna relé
Apoyo a la raza y los resultados generales en el mismo archivo para el multi-raciales eventos
Mejorado el soporte y la documentación para los parciales
cómo manejar su defecto las unidades de control
golpes adicionales
Apoyo a Trail-O resultados
Soporte para almacenamiento de rutas adquiridas de seguimiento geográfico de los competidores
Ejemplo de archivo XML
He aquí un ejemplo de un archivo XML que se ajusta a la interfaz de la versión Standard 3.0 IOF. Contiene el nombre y la hora de inicio para un evento de orientación.
Algunas cosas a tener en cuenta:
Para evitar la confusión y el multilingüismo de apoyo, el UTF-8 codificación de caracteres debe ser utilizado. Los archivos XML se debe guardar en codificación UTF-8 y también lo expresan de manera explícita en la declaración XML.
El http://www.orienteering.org/datastandard/3.0 namespace se utiliza. El espacio de nombres es preferible declarado como espacio de nombres predeterminado en el elemento raíz. Espacios de nombres adicionales se pueden definir aquí también, lo que permite extensiones.
El 'iofVersion' atributo define la versión utilizada, y se debe establecer a 3,0.
El 'createTime' atributo define el momento en que se creó el archivo.
El 'creador' atributo define el nombre del software que creó el archivo.
Más ejemplos de archivos XML se pueden encontrar aquí.
Definiciones Mensaje
Hay diez tipos de elementos de mensaje definidos. Cada archivo XML debe contener exactamente un elemento de mensaje, que siempre es el elemento raíz. Cada elemento de mensaje es extensible a través de la extensión de sub-elemento.
CompetitorList Se utiliza para intercambiar una lista de posibles competidores, por ejemplo, a partir de una base de datos competidor nacional a un sistema de administración de eventos.
OrganisationList usado para intercambiar una lista de organizaciones (clubes, asociaciones regionales, etc), por ejemplo, a partir de una base de datos de la organización nacional a un sistema de administración de eventos.
EventList utiliza para intercambiar los accesorios de eventos / calendarios de eventos, por ejemplo, a partir de una base de datos de evento nacional a un sitio web.
ClassList usado para intercambiar una lista de clases, por ejemplo, a partir de una base de datos nacional de clase a un sistema de administración de eventos.
EntryList usado para intercambiar entró competidores para un evento, por ejemplo, de un sitio web de inscripción en línea a un sistema de administración de eventos.
CourseData usado para intercambiar información sobre los cursos y los controles para un evento, por ejemplo, desde una aplicación de configuración del curso a un sistema de administración de eventos.
Se utiliza para intercambiar listada horas de inicio de los competidores en un evento, por ejemplo, de un sistema de administración de eventos a un sitio web.
ResultList usado para intercambiar horas de inicio de los competidores en un evento, por ejemplo, de un sistema de administración de eventos a un sitio web.
ServiceRequestList utiliza para servicios de cambio (por ejemplo, alojamiento, comidas) requeridos por los competidores en un evento, por ejemplo, de un sistema de inscripción en línea a un sistema de administración de eventos.
ControlCardList Se utiliza para intercambiar información acerca de las tarjetas de alquiler, por ejemplo, de un proveedor de troquelado sistema electrónico para un sistema de administración de eventos.
Consulte las especificaciones de la documentación detallada de los elementos del mensaje.
Definiciones de datos
Hay más de 50 elementos de datos definidos. Elementos de uso frecuente incluyen Id, persona, organización, evento, Clase, Curso, Servicio, ServiceRequest y Fee. Un elemento de datos tiene un número de atributos y elementos. Atributos tienden a definir los metadatos del elemento mientras que los elementos tienden a definir los datos concretos, aunque no existe una distinción clara.
La mayoría de los atributos y elementos no son obligatorias. Se trata de una opción de diseño intencional para mantener la interfaz flexible. En algunos eventos organizadores no puede ser que necesite para llevar un registro de los identificadores de la competencia, mientras que son esenciales para otros eventos. La desventaja de este enfoque es que las partes que participan en el intercambio deben ponerse de acuerdo sobre qué elementos y atributos que son obligatorias. La regla de oro es que el software de la creación del archivo de intercambio debe incluir información tanto como sea posible, incluso información no obligatoria si se conoce.
Consulte las especificaciones de la documentación detallada de los elementos de datos.
Elementos de identificación
El elemento Id es ampliamente utilizado para representar una identidad única de la entidad, por ejemplo, una persona, organización, evento o entrada, lo que hace posible la sincronización. La identificación debe ser conocida y común para ambas partes. Se recomienda encarecidamente que los identificadores son identidades oficiales emitidos por una federación nacional. Identificadores de bases de datos internas no deben ser expuestos por el elemento de Identificación.
Fechas y horas
Las fechas y horas están expresadas en la norma ISO 8601 formato aaaa-mm-ddThh: mm: ssZ. Este formato permite la inclusión de un identificador de zona horaria. Se recomienda que esta característica se utiliza, para facilitar a los sistemas informáticos que se ejecutan en diferentes zonas horarias para intercambiar datos de manera fiable. La mayoría de los lenguajes de programación tienen un medio para determinar la zona horaria utilizada en el equipo, y la compensación de tiempo a UTC (Tiempo Universal Coordinado).
2012-12-26T14: 36:07 Z 26 de diciembre 2012, 14:36:07 UTC ('Z' denota UTC)
2012-12-26T15: 36:07 +01:00 26 de diciembre 2012, 15:36:07 hora local, una hora por delante de UTC. Este es el mismo tiempo como 2012-12-26T14: 36:07 Z, pero expresado en otra zona horaria.
2012-12-26T08 :36:07.9-06: 00 26 de diciembre 2012, 08:36:07.9 hora local, 6 horas detrás del UTC. Este es el mismo tiempo como 2012-12-26T14: 36:07.9 Z, pero expresado en otra zona horaria. Las fracciones de segundo se puede utilizar para, por ejemplo terminar veces cuando la resolución de tiempo es de una décima de segundo.
Incorporación de información ampliada
Información no cubierta por la interfaz estándar IOF puede ser embebido utilizando las extensiones de sub-elemento que está presente en muchos elementos. Esto permite que dos partes el uso de la interfaz estándar para IOF por ejemplo, intercambio información de resultados personalizado junto con las listas de resultados ordinarios. La información personalizada tiene que ser envuelto en elementos definidos en un espacio de nombres XML. Estos elementos son a su vez colocado en el interior del elemento de extensiones. Para ver un ejemplo, consulte ResultList4.
Generación automática de código
Una de las ventajas del esquema XML es que existe un amplio apoyo para la generación automática de código. Uso de un archivo de esquema XML como entrada, las herramientas de generación de código puede construir código orientado a objetos que refleja la estructura del esquema XML. Esto reduce considerablemente el tiempo necesario para crear el código estándar para las aplicaciones.
Búsqueda de "validación de esquemas XML" usando su motor de búsqueda favorito para encontrar más información sobre las herramientas de generación de código para el lenguaje de programación.
Validación
No hay comentarios:
Publicar un comentario