Agility Contest 2.3User Manual

V.1.1 March 2016Author: Juan Antonio Martínez

SummaryIntroduction....................................................................................................................................................3Installation......................................................................................................................................................4

Automated install in Windows Systems....................................................................................................4Manual installation in Windows / Linux / MacOSX systems...................................................................7

Overview........................................................................................................................................................8Login and Logout......................................................................................................................................8A words on Users......................................................................................................................................9

Judge database handling...............................................................................................................................10Dogs database handling................................................................................................................................11Handlers dababase management..................................................................................................................12Clubs management.......................................................................................................................................13Creating contests..........................................................................................................................................15Handling inscriptions...................................................................................................................................18

Inscriptions on team journeys.................................................................................................................21Contest deployment......................................................................................................................................22

Journey planning and timetable...............................................................................................................23Round Starting Order Setup....................................................................................................................24

Team Rounds starting order setup......................................................................................................25Entering Round information....................................................................................................................26Entering contests results..........................................................................................................................27Round results handling and printing.......................................................................................................28Round forms and PDF printouts..............................................................................................................29

Classifications. Final Scores........................................................................................................................30Statistics.......................................................................................................................................................31Configuration...............................................................................................................................................32

User Configuration..................................................................................................................................32Session handling......................................................................................................................................33Preferences menu....................................................................................................................................34

Desktop preferences...........................................................................................................................34Tablet & Chronometer........................................................................................................................34Videowall parameters.........................................................................................................................35PDF forms and report generation.......................................................................................................35Internet access options........................................................................................................................36System configuration..........................................................................................................................36Additional configurations...................................................................................................................37

Tools........................................................................................................................................................38Licensing information..................................................................................................................................39

Registering process.................................................................................................................................40Using the Judge assistant tablet/laptop........................................................................................................41

Starting the tablet application..................................................................................................................42Troubleshooting tablet session................................................................................................................43Working with the Assistant Tablet 1: Round Control..............................................................................44Working with Assistant Tablet 2: Dog control Panel..............................................................................46Working with assistant tablet 3: Extensions and tips..............................................................................47

Using a laptop/computer instead of a tablet.......................................................................................47Videowall interactions........................................................................................................................47Using tablet in combination with electronic chronometer..................................................................48

Electronic chronometer................................................................................................................................49

IntroductionA web client-server (xampp) app to organize, register and show results for Dog Agility Contests

Features:

• Platform independent server ( Win/Linux/Mac )

• Written in HTML5 / CSS3 / JS (client) PHP-5.3+ / MySQL-5.5+ (server)

• Suport for multiple simultaneous contests / rings

• Plays Agility / Jumping / K.O.* / Teams rounds

• Definable User/roles (guest,assistant,operator,admin)

• Complete web-based DB management (handlers, dogs, clubs, judges, and so )

• On-line results entering with judge assistant WIFI tablet/notebook support

• Persistent (file/lineprinter) event registering for later judge revision

• RealTime VideoWall info panels (needs Ethernet/WIFI connection)

• Internet Web access with realtime updates for Competition data and results (needs Internet

connection) • Support for electronic chronometers connection (needs AgilityContest Chrono API compliant e-

chronometers) • Guest access from phones/tablet (with proper WIFI support)

• On Screen Display (OSD) support for LiveStream video (needs Video and streaming

infrastructure) • PDF printout of inscriptions, competition order, results, labels, etc

• Export / Import(*) contest results in MS-Excel format to ease later data management

• Support for non-FCI federations (RFEC, UCA) and International (countries instead clubs)

Contests • Internationalization (Actually English/Spanish/German. more languages incoming)

• Auto-update, backup/recovery tools. Fully configurable

(*) Some of these features are still under development :-(

AgilityContest was designed and build for Agilistysts to Agilitysts, emphasizing ease of use, with internet in mind. OnLine Realtime results, Live Streaming, OnScreenDisplay, VideoWall and VideoChronometers,tablet assistance on the rings, Electronic chronometer API, and so many other features. Enjoy!

AgilityContest is Copyright 2013-2015 by Juan Antonio Martinez ( juansgaviota at gmail dot com ) Inscrito en el Registro Territorial de la Propiedad Intelectual de Madrid. Exp: 09-RTPI-09439.4/2014

AgilityContest Logo is based on an original work from Britta Schweikl at http://www.hundestempel.de/ and included in this program with her permission

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

InstallationAutomated install in Windows Systems

Software Requirements:

- Windows 7 or newer- Adobe Acrobat DC or similar PDF Viewer- Updated Firefox or Chrome web browsers set up as default navigator. Due to incomplete HTML5 support usage of Internet explorer is discouraged

Minimum hardware requirements:

- Intel i3 processor- 2 Gb Ram (4 recommended)- 1 GB Free hard disk space ( AgilityContest uses about 800Mb when installed )- Minimum 1024*768 screen resolution

Known incompatibilities:

AgilityContest starts an internal Web Server (Apache) and a DataBase Server (MySQL) so any other program that uses IP ports 80, 443, and 3306 may interfere with itSome known programs that cause trouble:

- Internet Information Server- Microsoft w3svc (*)- Skype- Emule / JDownloader- VMWare host agent server- VNC/Remote desktop server

(*) W3SVC is an internal w8 and w10 service. AgilityContest disable it at startup, but only when running with administrator priviledges

Aditionally some firewall sofware takes control over 80 and 443 connections, or instructs browser to use firewall as proxy. In this case, connections to port 443 will report “SSL Protocol Error” in the browser.

Make sure that browser is not using any proxy to access “localhost”, “127.0.0.1” (ipv4) or “::1” (ipv6) addresses.

Installation procedure:

- Open a windows session with admin priviledges

- Download latest executable fromhttps://dl.dropboxusercontent.com/u/72813204/AgilityContest/index.html

- Launch installation process by double-click on downloaded file

Change install location if desired (altought not recommended) and choose first launch default language. The installation process will start.

Once installed, perform first launch by clicking on AgilityContest icon. This process may take a bit time, due to the need of performing initial configuration and database setup.

You'll see a cmd.exe window deployed at task bar !! DO NOT CLOSE THIS WINDOW !! or the AgilityContest session will close prematurely

When first run installation is done, a web browser opens in full screen. You can reload shown web page tore-init AgilityContest session.

To exit AgilityContest, exit browser and press enter on cmd.exe window to finalize services

Troubleshooting:

1- Instead of Firefox/Chrome an Internet Explorer window opens

Make sure that Firefox/Chrome are installed, properly updated and set up as predetermined browser

2- An error message appears about “Cannot contact localhost”

There is an application that prevents apache web server starts properly. Please see “known incompatibilities” above section

3- An error message warns about MySQL connection

Your system is very slow, and the browser started before Database setup was completed. Please install AgilityContest in a better hardware or proceed with manual database installation (see bellow)

4- A message warns on insecute connection / bad certificate

Instruct browser to ignore this message and allow “insecure” connections to “localhost” as shown below:

5- A message warns about SSL protocol error

a) You have a web proxy installed. Please instruct your browser to don't use proxy to access “localhost”b) Your firewall/antivirus is catching al web connections. Please, disable web proxy in firewall for access to “localhost”, or if not possible, disable firewall

Manual installation in Windows / Linux / MacOSX systems

There is no (yet) automated install for Linux and Mac-OSX systems, so user must perform a manual installation. Also, in some slow environments automated windows install fails, so it's required -at least- manual database setup

The general procedure is:

1- Download AgilityContest code from GitHub repository

The official repository is at GitHub: https://github.com/jonsito/AgilityContestJust press “Download zip” to get latest version. Alternatively you can look at “Releases” to choose desired one

You'll find detailed installations instructions for Fedora, Ubuntu, and Manual Windows Installations inwiki github pages and in README files. Please use those instructions in next installation steps

2- Configure system as apache/php/mysql serverDownload proper xampp server from: https://www.apachefriends.org/es/download.htmlThere is an xampp package for Linux, but to avoid conflicts with existing sofware It's recommended use of native packages

3- Configure web server to handle AgilityContest web pages* Unzip AgilityContest in running directory* Set up file user and access permissions on required directories* Configure AgilityContest.conf file to tell apache how to handle pages

4- Setup database and permissionsThis process involves manual creation and population of AgilityContest mysql database.

5- Start and test application in a browserJust open a browser and type in: https://localhost/agility/console. When everything is ok, login window will appear

Overview

Login and Logout

A words on Users4 roles:- Admin: to manage and configure application- Operator: to create and handle contests from console- Assistant: to enter data from ring control table- Guest: read-only, just for viewing

4 predefined users:- “admin” - “operator”- “assistant”- “guest”

Default password is the same as username. You should change it to a more secure password once logged in

You can add/delete users, change user names, passwords and roles from “Users” tab under configuration Window

Judge database handlingSelect “Judges” from main menu. Following window appears

Use mouse or cursor keys to navigate/select items. When new/edit judge operation is selecteda new window pops up asking for judge data

Notice: beware on legal aspects on personal data handling

Dogs database handlingTo add/edit/modify dogs database chose proper item from main menu

A dog can only be owned by a single handler on each federation

Differents federations can declare different dog-handler teams

Orphaned dogs are assigned to “-- Unassigned --” handler

Any change in dog data, specially category/grade, will be propagated to non-closed contests.This is usefull for last-time changes before starting a contest

Same dog may belong to several federations. As category/grade/license etc changes, you should declare the dog in as many federations as it belongs to

To select handler, enter name on handler field and choose selected. If handler is not found, you must use “new handler” button to create. Handlers MUST exists in database before being assigned to a dog

Additionally, to ease data handling you can change dog information from handlers, clubs and inscription menu windowsYou can search dogs by entering dog/handler/club name in search box

Use “Clear” button to clear search selection and reload dog list

There is two additional buttons to handle dogs matching search criteria

- Export, to dump s selected dogs into Excel table format- Print, to create a PDF file with selected dog list

Handlers dababase managementSame as above: choose “Handlers” from main menu, and proper window will be displayed

As above, you can use cursor keys to navigate, enter/supr to edit/delete, or mouse clicks and provided buttonsAdditionaly, each row has and “expand” button to deploy list of dogs belonging selected handler on current federation. You can edit dog data by direct doubleclick on it

You cann assign/deassign a dog from selected handler. To do it just click “Assign” or “Detach”When you click “Assign” there are two available operations:- Edit/assign dog, by using top search box, filling data and press “Re-assign”- Create new dog belonging this handler, by filling data and pressing “New”

Clubs managementAs previous menus, you can add/delete/edit/search clubs data by selecting “Clubs” in main menu

To edit clubs, just doubleclick or press “Enter” on selected club

To change club icon, just click on it and select new logo. Valid formats are gif/png/jpg. Preferred logo size is 150x150 pixels

You should check federations that club belongs to in order to be shown when creating contests

As above, you can expand Club cells to see handlers belonging the club, and in turn expand handlers to show dogs belonging handler

You can also assign/detach a handler to/from a club. Orphaned handlers belongs to “-- Unassigned --” default club

And finally you can edit/join/detach dogs from handler belonging selected club

Creating contestsConcepts:A contest is composed by one or more journeysA journey has one or more seriesA series has one or more roundsA round has one or more categories

Example:Contest: “Almozara Dog Festival”

Journey1: “Team rounds”Series: Team

Round1: Agility TeamCategories1: LargeCategories2: Small-Medium

Round2: Jumping TeamCategories1: LargeCategories2: Small-Medium

Journey2: “Individual rounds”Series: Open Individual

Round1: Agility IndividualCategories 1: LargeCategories2: SmallCategories3: Medium

Round2: Jumping IndividualCategories 1: LargeCategories2: SmallCategories3: Medium

The first step is to create a contest. So go to menu and check “Create Contest” :-)

To create/edit, just select contest, or click “New/Edit”

Things to take care on:

- Each federation has it's own calification rules, categories, series, and so. Choose the right one according your contest- Selecting “International” federations means that dog-hanlder teams will be grouped by countries, insteadby clubs- Some Federations applies additional rules on special events ( ie: qualification journneys ), if this is the case, choose “Selective” option

Beware of “Delete” button. If accepted, every contest related information will be erased: journeys, inscriptions, results and so

Mark a contest or journey as “Closed” means that no further modification is allowed on it. Additionaly changes on dog name/handler/club/category/grade and so won't be propagated to data related with this contest/journey. This is usefull when, for instance a dog is promoted from a category to another during thecontest

“Export” button can be used to generate an Excel file with every contest related data* Contest and journeys information* Inscriptions* Results

In a future software revision is expected to be added an “Import” button, to easily move contests, inscriptions and so from one agilitycontest installation to another one

Notice thatn selecting a contest changes federation icon according contest declaration, So those federationdata ( clubs, dogs, judges, and so ) becomes active and available

Once the contest is created, you should declare their journeys. Each contest can handle up to 8 journeys, each one with their own series and rounds

To do that, just expand selected contest. A list of available journeys will be displayed

Journeys named “-- Sin asignar --” are ignored. No inscriptions and series should be declared on it. So don't forget to provide a right name for your journey :-)

To create/edit journey, just select and press enter, or double click on it. A new window pops up:

Button “Close Journey” marks selected journey as unmoddifiabled, that is: once a journey is closed no inscription nor dog data changes and results can be done

Special round is intended for single round series: exhibitions, finals and so. You should provide round name

Some warns:

- Due to some internals you must declare Open / Team / K.O Rounds in a separate journey- K.O Rounds, and Games are still under development- Multi-rounds ( more thant 2 rounds by series ) are still under development. So you cannot still declare an special round with 3 agilityies :-(

- If you delete series in a journey, every inscription and results related data will be removed. Yoy still canadd new series, but not delete already declared ones if there is already people inscribed.So make sure to don't modify journey's data once inscription phase is started.

Handling inscriptionsAfter creating a contest and declare journeys, inscriptions comes in place.

So go to main menu and select “Inscriptions”. You'll be prompted to select an existing (and not-closed) contest. A new window displays:

- You can access journey information by selecting it and double click to edit. Remember not to change series if there is already someone inscribed on it

- Use cursor and mouse to navigate across inscriptions. DoubleClick, or Enter to edit individual inscriptions.

- Use search box to look for dogs/clubs/handlers. Use clear button to clean searchbox and reload

- Use Remove button to erase an individual inscription. If you remove a dog, their results and qualifications will be also removed

To add new inscription(s) just click new. A popup window appears showins available dogs not yet inscribed in this contest:

You can inscribe several dogs at once: just select it and press inscribe

Also select proper journeys. You can perform individual changes later

Search dogs by entering dog name, handler or club

If a dog is not yet inscribed, and not found in this window, you can declare and create it by mean of “New dog” quick access button. Once declared, refresh window list and add to list of dogs to be inscribed

Once all inscriptions are inserted, press “Done” and proceed to fine adjust individual ones.

To do this, double click on selected dog. A new window appears:

When all inscriptions are ready, is time to generate orders/dorsals information

As a general rule, any change on a dog, or a new inscription place the dog at the end of the starting order in their categoryHeat bitches are placed at the end of their rounds

Dorsal numbers are assigned as inscriptions comes in place

To ease the listings and report generation, you can reorder dorsal numbers, just by clicking “Reorder” button

To create printouts, just click “Print”. A popup window appears with 4 options:

* Simple listings, to be held in informational panels

* Catalog listing, to elaborate booklets

* Statistics, with information about journeys, dogs by journeys and so grouped by grade/category

* Exports to excel File, to external handling an to allow ( work in progress) to be re-imported in other AgilityContest installation

Inscriptions on team journeysTeam contest handling is a bit special. You must:- Declare teams on a journey- Assign inscribed dogs to an specific team- Printout teams once finished

You can define different teams on different journeysSo In inscription window, select a team journey and press “Teams”

You can add, delete, declare, edit, search and so teams as usual, by cursor, mouse or buttons

Doubleclick on each team member to can change their membershipBy default inscribed dogs are assigned to “-- Sin asignar --” team. So to assign a dog to a team, just expand “-- Sin asignar --” team, select dog, and declare their destination team ( previously created)

There is an special button “Verify” to check:- There are inscribed dogs without assigned team- There are some team with less than minimun dogs in a team- There are some team with more than maximum allowed dogs

There is two Team contest modalities, choosen at journey declaration:- 3 best dogs of 4 ( As AWC-FCI contest )- 4 dogs together ( As European Open contest )You can also works with i.e. 2 dogs teams, but you'll be warned when clicking “Verify” buttonOnce finished team assignment, pulse “Print” to emit a PDF printout of teams for this journey

Contest deploymentOK. Now we have the dogs, the contest, the inscriptions… and the day of competition arrives.

Agility contest allows you perform last-minute changes in almost every thing on a contest. Some advices:

Any changes to a dog makes them to become the last in the starting order in their category

You can make on-line changes on name, handler, club and so in a dog, but any change on grade/category/heat on a dog that already has complete a round will erase their round results. This doesn't apply -of course- to closed journeys, were data will be mantained

So lets go to main menu, and click in “Running Contests”. We will be prompted for contest and journey selection. And then the main competition window deploys:

By selecting a round we can deploy round data: judges, standard and maximum course time, categories grouping and so

As usual, operations comes in Top-to-Down order:

1- Choose Journey planing. Timetables, series ordering, rings and so2- Select a round and prepare starting order3- Enter round results for each competitor4- Get round results and print listings5- repeat 2..4 until the end of the journey series

Journey planning and timetableWith proper infrastructure deployment, AgilityContest can handle several rings, journeys and contests at once. So we need some way to provide competitors a timetable of activities.

This timetable will be used by wideowalls, tablet, electronic chronometers and so, to take care on what to do

So first is to declare the journey planning. Just click on “Planning”

You'll see a list of every categories on every rounds on every series for this journey, sorted as they were declared on journey creation

You can edit existing pre-defined entries, reorder it by drag&drop with the mouse, but cannot delete them.You can assign them to an specific ring, especify time and insert comments, but not change therir name nor delete

Additionaly, you can add new user-defined activities, by just clicking at “New”, as shown in the image.

Once every activities are declared and sorted , press “Print” to get out a PDF printout of the journey's planning

Round Starting Order SetupTime to provide competitors an starting order. So Select desired round and press “Starting order”

A new window deploys:

Simple rules:

- Drag and drop a dog to change their starting order. To mantain ordering consistency, you cannot drop beyond a category/heat change

- Use “Random” button to generate a new, randomly ordered list

- Use “Reverse” to re-order listing in reverse order of qualifications on Agility/Jumping counterpart round

- Use “Clone” to get the same starting order than the twin round in the series

- Use “Verify” to check for handlers with two o more dogs than are so close together. There is a configurable value “proximity alert” that allows user to change the alert distance (defaults to 5 dogs for the same handler)

In a multi-user environment, external operators may change starting order. You have the “Refresh” key to take care on themWhen everything is OK, just press “Print” and proceed

Team Rounds starting order setupIn team rounds, competitors are grouped by teams. You can drag and drop competitors inside the team, but no easy way to sort teams themselves. So when in team rounds a new button appears in starting order window:

As usual, drag and drop teams to re-adjust order.

When everything is done, just click on print and get PDF printoutsAs a recommendation, whenever you get starting order printouts is recommendable to also get judge assistant papers sheets for ring table

Entering Round informationAgilityContest is Round information agnostic: just stores time, faults, refusals, and so. Penalization, Califications, etc are handled in runtime by examining current and provided data and results

In this way, we can provide real time results, and re-evaluation of course times according provided rules

This rules are:- Declare judges for each round. Optionally replicate provided judges for all rounds- Declare Distance, obstacles and way to evaluate Standard and Maximum Course Time- Declare how to group categories on the round. Common, separate or mixed courses on each category

This is done by mean of the main journey deployment window. Just select requested round and display their associated information:

Notice that Course grouping affects to every Agility/Jumping pairs on the Series; you cannot provide separate califications for agility and common for jumping ( but can change from one to another in runtime:-)

You can specify SCT and MCT as:- Fixed Time ( seconds with up to 2 decimals)- SCT relative to best or mean of 3 bests results + optional offset ( seconds or percentage )- SCT relative to other categories SCT- SCT provided as meters/seconds. In this case proper roundup is applied

When everithing gets OK, press “Save” to store changes. To revert them, use “Restore”

Entering contests results( This chapter covers entering data from console. To use tablet/assistant read proper section ) In “Running contests” menu, once selected planning, and starting order, is time to begin entering data. So click on “Data Entry” and next window comes up:

You'll see the dog list for this round, ordered as stated in “Starting Order”. Red Dorsals means “Need to enter data”, and black ones “Already edited”

As usual you can use cursor keys or mouse to navigate across rows. By doubleClick, pressing Enter, or clicking on “Edit” the editor mode opens, and operator can enter team data. Alternatively, you can enter dorsal number in search box, to search and open in editor mode the team withselected dorsal

When done, just click “Save” to store data or “Cancel”, to exit without saving changes. Alternatively, pressing Enter in editor mode just saves current data and move editor to next rowPressing “Clear” removes data from selected row and mark it as “Pending”, that is: need to be filled

Two special buttons to take care on:- “Reset” to clear EVERY entries on this round- “Swap” to exchange data with Agility/Jumping counterpart roundUse this options with precaution: They are intended to be used only in case of round selection missmatch, and may conflict with other operators working in other consoles

As a web aplication, several console windows may be opened at the same time (each one with a different user logged in) so, many people may be entering data simultaneously. Use “Refresh” to update screen data

When auto-refresh is selected, edition is blocked, and the screen will refresh every 5 seconds. This is useful to monitorize external (ie: tablet/assistant) data entry

Round results handling and printingOnce a round is finished and every data are entered in, it's time to visualize, revise and print round results.Just select round and press “Round results”. This window appears:

You can see:

- Round ata on SCT and MCT- Results for this round. You can select the categories to be shown according Round Information data

There are two buttons:- First one to refresh screen. When several users are working in typeing data, you can use this button to monitorize result progress in real time- A button to print results and dump it into a PDF file.

When “Print” is clicked, the application will check for pending teams (i.e. dogs without data for this round) and warn the user about it

On team rounds, an slightly different screen appears, showing results grouped by teams. Anyway the behaviour is the same

Round forms and PDF printoutsWhen Running contests, the operator may generate several documents:

- Activities and timetable- Starting order for each round

- Tool sheets:* SheetCalc to evaluate SCT/MCT* Sheet to let the judge write in SCT/MCT roundinformation* Empty judge assistant sheets* Judge assistant sheets in several behaviours:1,5,10 dogs/sheet

- Round results ( from the round results window )

Judge assistant sheets may be used to manually annotate results, in order to perform further revision, or if we have no realtime ( ie: tablet/assistant console) data entry support

Just select “Templates” on main “Journey Deployment” window, or press “Print” button on each specific sub-window

Classifications. Final ScoresWhen all the series for a round are gone, It's time to get final results and scores.

In main menu, go to “Scores”, select contest and journey, and final scores window comes:

You should select series and categories, and proper SCT/MCT information and round results will be shown. ( notice that categories will be grouped according Round Data info entered in previous stage)

- By click'ng “Verify” you can search for dogs without data in any round- Use “Refresh” to reload data, to allow real-time update when external (ie: tablet/assistant ) data entry method is being used

When everything is ok, you can press “Reports” to create several forms:- Printout of PDF with podiums for choosen series- Printout of PDF with Scores for selected Series/Categories- Generate an Excel file for further post-processing- Printout of adhesive labels for qualification cards. Currently there is only one cart supported: the one forRSCE (Spanish kennel Club) Agility Carts. In a future version each federation will handle their own cart format

A last word: You can change Round Data Information every time: scores will be real-time evaluated and shown when pressing “Refresh”. In this way you can use VideoWall monitors to display on-line realtime results when SCT depends on dogs results (ie: 3 best average result)

StatisticsThis section is currently under development. In the future will show statistics on results for selected Contest/Journey: percentage of Excelents, Eliminated, average speed, best teams for contest and so

ConfigurationNOTICE: Configuration window is intended only for being used by Administrators: no relation with contest handling. In fact: only Users with “Admin” role has permission to change their content ( with the exception of changeing user own password )

AgilityContest is very versatile and configurable. You can define:

- Users and Roles- Sessions and their behaviour- Change user preferences- Use several additional mgmt tools

Opening “Admin” window, You'll see a tabbed panel with above options. Just choose desired one

User ConfigurationClick on “Users” tab to list, add, edit or delete current defined AgilityContest users. The screen shown is very similar to DataBase handling ones, and works in the same way: cursors, mouse and buttons, to handle data

Only users with “Admin” role can declare/edit/delete other user's data. A non-admin user only can changetheir password

Notice the “-- Sin asignar --” user. This enrtry cannot be edited/deleted: it's internally used to handle anonymous connections

Session handlingA session is “An AgilityContest data entry point”, that is a site/window/hardware to provide/view contest data:- Electronic chronometer- A tablet/assistant console on each ring- One or several consoles- A Videowall monitor- An anonymous user accessing public pages

There are two kind of sessions: named ( an user must be provided) or annonymous ( no user required)

The rule: An user cannot be logged at two simultaneous named sessions. So we need to log in as a different user on each console/tablet we open. Failure on follow this rule may result in data being refused by the application, by showing an error message like “Invalid session ID”

Appart of console, named sessions are usually associated with a competition ring. In this way you can usea tablet console and an electronic chronometer on each ring at the same time. When timetable planning is declared, you can decide which round/series are assigned to each ring, and their respective tablets will only show associated information

At the writing of this manual, sessions also handle information on live stream video-source for each ring. This feature may change in next revisions

The handling of each session is similar to other windows: use cursor, keys, search and buttons to add/delete/edit sessions. But in the vast majority of the cases you won't need to change this window's content

There is an special button: “Reset Session” to clear every related event history for this session. This is useful at journey deployment to start with clean history data

Preferences menuIn this window you can change AgilityContest Behaviour: change themes, colors, and define the behaviour of several subsystemsMost of those items are self-descriptive:

Desktop preferences:

Tablet & Chronometer

Depending of the tablet model and responsiveness, you may need to setup behaviour. Also, when using a laptop instead of a tablet, you can enable additional features, like drag&drop to change starting order, or use keyboard to enter contest events and data

Electronic Chronometer is highly coupled with tablet console. Dog in ring, Course walk, manual timing, 15 seconds initial countdown and faults/refusals data entry can be handled either by mean of crono or tablet. So check for proper configuration and behaviour

Videowall parameters

Use this panel to set up colors, backgrounds and transparency level for several video-wall monitors display and/or live stream OnScreenDisplay information

PDF forms and report generation

Use this panel to choose fonts, colors and so for PDF report generationAbout fonts: there are two kind of available fonts: - UTF-8 to handle non West-European languages (ie: greek, cirylic, arabic, and so)- Latin-1 to use with occidental Europe languagesFirst one admits any character, but printing is slower, second one is quicker but restricted to Iso-latin-1 charset

About printing labels for calification carts: you should select sheet format (number of labels/sheet) and adjust margins to fit adhesive labels. Please disable any kind of auto-resize or margin setup in printer application menu before printing

Internet access options

Just only one item to setup: auto-refresh period. When set to none, user should click on organizer's logo tomanually refresh pages

System configuration

This is perhaps the most important panel on preferences setup. Controls the behaviour of the application: language, logging and raw printing, how alerts are shown during contest deployment, time precission, andso:

Language settings:

You can declare default languaje ( currently supported Spanish, English and (partially) German.Additionally you can instruct the application to honor browser preferences. When enabled, the applicationwill try to select prefered language from browser; if not available, will fall into default

Event registering and logging

AgilityContest tracks EVERY activity on the system, either runtime traces, or contest related data. There are several related operations to control the behaviour of the tracking system:

- Define de runtime trace logging level: It's mainly used for debugging purposes: normal user should declare “Error” debug level

- Store contest data events in a file: Every faul, refusal, time mark and so sent to application is stored in database. Additioinaly the operator can choose to store it in a plain-text file. There is a button check to enable this option

- In the same way the administrator may clare a “point-of-sale” like printer to permanently store competitors data in a non-modifiable way in a thermal printer. The user can declare this printer and their properties.

- There are an event log for each opened session. You can choose clear previous data on session login

Runtime options

- The operator can define the distance between two dogs of the same handler to trigger proximity alert in Starting order window from contest deployment

- Chronometer timestamps are allways handled in microseconds. The user can choose to show time marksin milliseconds or cents of seconds. Notice that timestamp are provided by trunk (not rounding) to the choosen decimal numbers precission (2 o 3)

Additional information

Finally, and additional entry is shown with the IP address(es) of the server where the application is running (database and web server side).

By mean of this information, the user can connect the server with other consoles, declare where connect the WiFi tablet to, or tell the VideoWall monitors where the information comes from.

So you could -in theory, but not recommended- share several AgilityContests servers in same physical network

Additional configurations

Some special features must be handled by mean of direct editing of configuration files.

- Run in “Restricted” ( public access read-only ) mode- Remote database access ( for centralized database in a Federation)

Please contact the author to enable this options

ToolsLast panel on Configuration menu provides several tools to:

Handle database

- Backup and restore database contents, to ease porting a contest from an AgilityContest install to another- Clear database:* Partial: only contests, inscriptions and results* Total: remove above, and every dog/club/judge/handler and so, starting with a vanilla (clean) database

Update application

Search internet for new versions of AgilityContest, and if requested to do so, perform a complete version upgrade. To prevent upgrade faillures, the user should allways perform a security backup of the database

Licensing informationVersion: 2.2.1 - 20160303_1332 AgilityContest is CopyRight © 2013-2015 from Juan Antonio Martínez <juansgaviota@gmail.com>

Source code available at https://github.com/jonsito/AgilityContestCopy, modify and re-distribution is granted under terms of GNU General Public License version 2

AgilityContest Logo is derived from an original work of Britta Schweikl <ltBritta.Schweikl@t-online.de>

Original design -an many others- can be found at http://www.hundestempel.de/. This logo is distributed with authorization from original author. This copyright notice must be included in every copy

Registered in Registro Territorial de la Propiedad Intelectual de Madrid. Expediente: 09-RTPI-09439.4/2014

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

Source code distributed “as is” provides a subset of the available operations. You need an additional license file to enable code additional features.

License file is NOT under GPL License terms, You cannot use license files outside the scope of the agilityclub that license belongs to.Also, remember that National laws prevents you to bypass protections to the program

Additional (need license) features are:

- Contests with more than 75 inscribed dogs- Team and KO rounds- Electronic chronometer support- Internet access support- Videowall monitor support- Live-Streaming features- Removal of watermarks on PDF printouts

Registering process

To register the application, you should ask and receive a personalized license file.

Open application and log in as “admin”. On main menu select “License information”

Click on “Examine” to select the received license fileClick on “Register” to proceed. If everything goes, a message is shown, and you'll can see your licensing information in the license window

Restart application ( reload page or press F5 on browser ) to activate new license

Using the Judge assistant tablet/laptopOne of AgilityContest most noticeable features is that is a multi-user environment: that is: their use is not restricted to console web browser but the server can act as central node for a complete contest deployment: electronic chronometer, videowall monitors, data source for live-stream, etc

The central point of this deployment is de judge assistant tablet: an special browser view, intended to be used at the ring, to enter data in real time:- Select active rounds and series- Tell videowalls and livestream system who is in the ring- Manually enter faults, refusals, mark eliminated of not present for current team in real time- Enter / fix manually cronometer timestamps- In built manual chronometer

We can see the Assistant tablet as a orchresta director for a given AgilityContest deployment

To get it working we need:

* A local (domestic) area network, either wired or wireless (WiFi)* A modern wifi tablet or netbook. Sugested equipment is a 4core 1GHz ARM CPU with 2Gb Ram and 1024*768 screen resolution, running either Android (5.1 or upper) or OSX

Following images shows a basic ( tablet/videowall) deployment

There are more elaborated deployments, but for most of environments this structure is enought

This manual doesn't include information about how to deploy local network. We assume that the user has enougth knowledge on getting a domestic network up and running: properly setup router wifi, dhcp server, connecting devices to the router and so.

If this is not the case, you can find additional information on AgilityContest deployment examples. See documentation

Starting the tablet application

Connecting to server is simple:

- Open the in-built web browser in tablet- Type in the address https://agilitycontest.server.ip.addr/agility/tablet

Where agilitycontest.server.ip.addr is the one noticed in the console application at Administration→ Configuration→ Configuration → System

When the connection is stablished you'll see next screen:

Notes: - You should NOT use the same user/password for console and tablet session: they must differ. It's recommended to work with an user with “assistant” role. AgilityContest provided a pre-defined user “assistant” (password: “assistant” ) you can declare any additional users and roles. See “Users” section

- Also, you should select a ring from declared ones in “Session” section. Standard contests only uses one (first) ring. More complex contest may use any ring number, as declared in “Session”

- A tablet can only handle activities belonging the ring he is logged into.Refer to “Activities” section in Journey deployment. In this way you can use as many tablets as rings declared, isolating one from another

- Finally you should select a contest and a (non-closed) journey for that contest

When every thing goes well, pressing “Accept” shows main tablet window

Troubleshooting tablet session

If tablet loggin screen does not appears check next items:

- Check that server IP address is correct. Verify the usage of https (with 's') protocol- Check for AgilityContest application is started in server- Open a second window in server and try to access tablet application by enteringhttps://localhost/agility/tablet- Make sure that javascript is enabled in tablet's browser- Verify server firewall: on Windows servers enable it “for domestic connections”- In the wifi router, verify logs to assure that tablet is properly connected- Make sure that WiFi is enabled and DHCP server active in router:

- Check distance and WiFi signal strenght- If the tablet shows message about invalid certificate, ignore it and continue into page.- If the console shows alerts on intrussion detection, verify that they are originated by the tablet. If so, tell firewall to ignore these alerts and allow connection. As extreme case, and no danger, disable firewall

Working with the Assistant Tablet 1: Round Control

When everything goes right, log into the tablet session by pressing “Accept”. Main tablet screen is shown:

You can see two sections:

- Leftmost one is the “Series mgmnt panel”. You can:* Examine series declared for choosen ring* Expand/Collapse each round and see dogs inscribed into it and if pending or not to entering ring* Direct acces to a dog by entering dorsal number* Tell electronic chronometer to start/stop course walk countdown

The order shown in series is the same as stored in “Activities Panel”. Notice that only appears activities assigned to choosen ring

Dogs in a round are listed in same order as stated in “Starting order Panel”. When proper option is enabled, you can drag and drop to change order directly from tablet, but it's not recommended due to needof proper sinchronization tasks needeed at server console ( must refresh starting order screen too )

You can search for a dog by entering dorsal, but if the dog doesn't belong to opened round, a warning message will be shown

Very important: by clicking on a round we mark that round as “active”. That is: videowalls, livestream and rest of deployed systems assigned to choosen ring, will update their contents to choosen round data

Working with Assistant Tablet 2: Dog control Panel

The rightmost side of the screen is the Dog mgmt window. While “Round control panel” is active, their content is disabled.By clicking on a dog, Round control panel is closed and screen shows dog mgmnt screen:

With this panel you can:- Mark and remove faults/refusals. Notice that information is sent in real time to chronometer and video walls. Also: data from chronometer will be shown in tablet information panel- Mark dog as eliminated or not presented ( also this can be done from chronometer )- Start 15 seconds countdown. Behavior of this count is controlled at “Tablet&Chrono Setup” in Configuration menu at server console (do nothing, eliminate or start manual chrono)- Start and stop in-built manual chronometer. This function is disabled when automatic count from electronic chrono is on- Reset electronic chronometer if required- Manual entering time for current dog if electronic chrono is not being used or fails- By pressing “Cancel”, every entered data are lost, and tablet returns to Round selection mode- By pressing “Accept”, current data is stored, dog marked as “not pending”, and depending on the behaviour declared at control panel, returns to “Round mode” or goes to next dog in round, or returns to round panel when last dog in round gets done- By double click on left-down dog list, selected dog will become active WITHOUT saving current dog data.Remember: all changes on tablet are reflected on every AgilityContest deployed system in real time. Specifically: LiveStream OnScreen Display shows data of current dog shown in tablet. So don't go to nextdog until current one leaves the ring :-)

Working with assistant tablet 3: Extensions and tips

Using a laptop/computer instead of a tablet

Assistant tablet may not only be used in a tablet, but also in a laptop, or even in a separate browser window at server console.

In those situations, insted of using mouse the user can directly type in actions by mean of the keyboard.There are severarl pre-defined keys:- Key 'F' Add a fault- Ctrl + 'F' Remove a fault- Key 'R' Add a refusal- Ctrl + 'R' Remove it- Key 'T' Mark 'touched'- Ctrl + 'T' Remove touch- Key 'E' Eliminated. Press again to remove mark- Key 'N' Not present. Press again to remove mark- 'G' (!go!) Init 15 seconds countdown- 'S' (star/stop) Start/stop manual chronometer- 'Home' Reset chronometer data- '0' .. '9' (or keypad), '.' (dot), and 'Del': to manually enter runing time- 'Enter' Accept/save data and (depending on config) go to next dog- 'Esc' Cancel data and return to round selection panel

This feature can be disabled in Console configuration panel

Videowall interactions

As said above, Assistant tablet is a sort of “orchresta director” for online/realtime management. When a videowall or livestream system is connected, the operator controls:- Contest, Journey and ring to be handled- Round and dog to be shown in videowalls or emitted by livestream system

Special care must be taken in those videowall screens that shows realtime data for dog in ring: In order to show right information the operator should only press “accept” or “cancel” whenever a dog enter or leaves the ring. Breaking this rule will result in incorrect dog/handler information shown in OnScreen Displays LiveStream data and realtime monitors

To reflect round information in videowalls the operator must select and deploy choosen round in tablet “Round Selection panel”. When last dog in round is gone, videowall stays reflecting finalized round information until a new round is choosen

Using tablet in combination with electronic chronometer

Some considerations should be taken:- Most important: Do not press accept while chronometer is running: no guarantee about wich time will be assigned to the dog- Tablet/chrono works paired: Every data keyed into tablet are sent to chronometer. In the same way everydata entered in the chronometer ( by mean of chrono remote control ) are sent to tablet- Don't use manual chronometer in tablet when chrono is on: undeterminated timmings may result

- Beware on tablet/chrono configurations:* Mark chrono timestamp active* Fix desired behaviour for sensor detection when manual chrono is on( continue manual or start automatic )* When using 15 seconds countdown, it's recommended to disable auto-start manual chronometer in Console Configuration panel. If don't, manual chrono may take precedence when countdown gets zero

Electronic chronometerAgilityContest provides an event-oriented API, to allow conecting several data sources and drains: Videowalls, chronometers, livestream and so.

All these devices are closely coupled with Assistant tablet, and are intended to be used in an online/realtime data registering and showing

There are two golden rules:- To show proper and updated information, the operator MUST choose and deploy active round from tablet- Every incoming data affects dog active at “Dog panel” window on tablet. So don't change team until they leave the ring and all related data are typed/received

Adding electronic chronometer:

The procedure is simple:

- Make sure AgilityContest application is installed and running- Connect electronic chronometer to the router with an ethernet cable BEFORE turning on chronometer- Turn on cronometer. After a while, display lights up- Open a session with the tablet, choose a contest/journey/round and select a dog* Check that faults, refusals, and timming from cronometer are shown in tablet* Also check if type in data into tablet gets displayed on chronometer