Upload to Livelox - Revision history

ANK at 13:05, 23 August 2023

2023-08-23T13:05:09Z

← Older revision		Revision as of 15:05, 23 August 2023
Line 32:		Line 32:

	=Upload dialog=		=Upload dialog=
	After the successful authorization OCAD opens the '''Upload ~~dialog~~'''.		After the successful authorization OCAD opens the '''Upload to Livelox''' dialog.

	[[File:~~LiveloxDialog01~~.png]]		[[File:UploadToLiveloxDialog01.png\|600px]]

	===Event Information===		===Event Information===
	*'''ID''': This field is empty for a new project. If you have already uploaded data the ID already exists. In this case you can directly update the existing event in Livelox.		*'''Event ID''': This field is empty for a new project. If you have already uploaded data the ID already exists. In this case you can directly update the existing event in Livelox.
	*'''Start time''': The field is empty for a new project. You can set and change the start time in Livelox.		*'''Start time''': The field is empty for a new project. You can set and change the start time in Livelox.
	*'''End time''': The field is empty for a new project. You can set and change the start time in Livelox.		*'''End time''': The field is empty for a new project. You can set and change the start time in Livelox.
Line 44:		Line 44:
	*'''Organizing clubs''': The field is empty for a new project. You can set and change the name in Livelox.		*'''Organizing clubs''': The field is empty for a new project. You can set and change the name in Livelox.
	*'''Map name''': Enter here the map name. OCAD uses the ocd file name from the [[Course_Setting_for_Orienteering#Start_a_New_Course_Setting_Project\|background map]] as default name.		*'''Map name''': Enter here the map name. OCAD uses the ocd file name from the [[Course_Setting_for_Orienteering#Start_a_New_Course_Setting_Project\|background map]] as default name.
	*'''~~Scale~~''': The scale is defined in the course setting project.		*'''Map scale''': The scale is defined in the course setting project.

	===Settings===		===Settings===
Line 54:		Line 54:

	*'''Map Preview''':		*'''Map Preview''':
	~~[[File:LiveloxDialog02.png]]~~

	In the dialog appears a preview of the png map. Click on the image to open the png in an external application to see the quality of the created map file.<br>		In the dialog appears a preview of the png map. Click on the image to open the png in an external application to see the quality of the created map file.<br>
	If the extent of the map is wrong, close this dialog and set the export extent in the [[Export_Files#Setup_Part_of_Map\|export dialog]].		If the extent of the map is wrong, close this dialog and set the export extent in the [[Export_Files#Setup_Part_of_Map\|export dialog]].
Line 70:		Line 68:
	:- Upload successfully		:- Upload successfully
	:- Upload failed		:- Upload failed

			If all works fine, <span style="color:green">'''Check successful'''</span> will be shown.

			[[File:UploadToLiveloxDialog02.png\|600px]]

	*'''Upload'''		*'''Upload'''
Line 84:		Line 86:
	Livelox does also a check which can return errors and warnings.		Livelox does also a check which can return errors and warnings.

	~~[[File:LiveloxDialog03~~.~~png]]~~		The upload breaks when Livelox returns errors. You have to fix the errors in the OCAD course setting project before publishing the data. When Livelox returns warnings it is possible to publish the data, but we recommend to fix these warnings in the OCAD course setting project first.

			If the upload was successfully OCAD opens the web browser and redirect to Livelox where you can create the event.

	The upload breaks when Livelox returns errors. You have to fix that error in the OCAD course setting project before publishing the data. When Livelox returns warnings it is possible to publish the data, but we recommend to fix these warnings in the OCAD course setting project first.		[[File:UploadToLiveloxDialog03.png\|600px]]

	~~If the upload was successfully OCAD opens the web browser and redirect to Livelox where you can create the event~~.		[[File:UploadToLiveloxDialog04.png\|600px]]

	~~[[File:LiveloxDialog04~~.~~png]]~~		You have to close and reopen the '''Upload to Livelox''' function to see the changes you made in Livelox.

	Once you have created the event, the option '''Update existing event''' is available.<br>		Once you have created the event, the option '''Update existing event''' is available.<br>
	If changes are made to the courses later on, use the option '''Update existing event''' to upload data.<br>		If changes are made to the courses later on, use the option '''Update existing event''' to upload data.<br>
	In this case OCAD publish the changes without redirecting the user to Livelox.<br>		In this case OCAD publish the changes without redirecting the user to Livelox.<br>

ANK: /* Export to Livelox */

2023-08-23T12:46:24Z

Export to Livelox

← Older revision		Revision as of 14:46, 23 August 2023
Line 51:		Line 51:

	===Export to Livelox===		===Export to Livelox===
	Click the '''Check''' button to create and verify the ~~upload~~ data.		Click the '''Check''' button to create and verify the data.

	*'''Map Preview''':		*'''Map Preview''':
Line 65:		Line 65:
	:- Checking		:- Checking
	:- Check failed		:- Check failed
	:- Check ~~successfully~~		:- Check successful
	:- Livelox validation errors		:- Livelox validation errors
	:- Livelox validation warnings		:- Livelox validation warnings
Line 72:		Line 72:

	*'''Upload'''		*'''Upload'''
	The '''Upload''' button is only ~~enabled when~~ the check was ~~successfully~~. Click the '''Upload''' button to upload the data.		The '''Upload''' button is enabled only if the check was successful. Click the '''Upload''' button to upload the data.

	OCAD uploads the following data:		OCAD uploads the following data:

ANK: /* Settings */

2023-08-23T12:40:36Z

Settings

← Older revision		Revision as of 14:40, 23 August 2023
Line 47:		Line 47:

	===Settings===		===Settings===
	*'''~~Resolution~~''': Set here the resolution for the png map~~. For sprint maps 254dpi for a good quality is recommended, 286 dpi for the others maps~~.		*'''Map resolution''': Set here the resolution for the png map.
	*'''Remember me''': When this option is checked, then OCAD saves the Livelox authorization token encrypted in the Windows Registry. In this case you don’t have to do the authorization again when opening this dialog next time.		*'''Remember me''': When this option is checked, then OCAD saves the Livelox authorization token encrypted in the Windows Registry. In this case you don’t have to do the authorization again when opening this dialog next time.

ANK: /* Event Information */

2023-08-23T12:39:25Z

Event Information

← Older revision		Revision as of 14:39, 23 August 2023
Line 37:		Line 37:

	===Event Information===		===Event Information===
	*'''ID''': ~~The ID~~ is empty for a new project. If you have already uploaded data the id already exists. In this case you can directly update the existing event in Livelox.		*'''ID''': This field is empty for a new project. If you have already uploaded data the ID already exists. In this case you can directly update the existing event in Livelox.
			*'''Start time''': The field is empty for a new project. You can set and change the start time in Livelox.
			*'''End time''': The field is empty for a new project. You can set and change the start time in Livelox.
			*'''Publication time''': The field is empty for a new project. This is the time when the event will be published on the Livelox website. In most cases you do not want to publish the event before the last starter has started.
	*'''Name''': Enter here the event name. OCAD uses the [[Course_Setting_Options#Titles\|event name]] from the course setting options as default name.		*'''Name''': Enter here the event name. OCAD uses the [[Course_Setting_Options#Titles\|event name]] from the course setting options as default name.
			*'''Organizing clubs''': The field is empty for a new project. You can set and change the name in Livelox.
	*'''Map name''': Enter here the map name. OCAD uses the ocd file name from the [[Course_Setting_for_Orienteering#Start_a_New_Course_Setting_Project\|background map]] as default name.		*'''Map name''': Enter here the map name. OCAD uses the ocd file name from the [[Course_Setting_for_Orienteering#Start_a_New_Course_Setting_Project\|background map]] as default name.
	*'''Scale''': The scale is defined in the course setting project.		*'''Scale''': The scale is defined in the course setting project.

GRS: /* Export to Livelox */

2022-07-13T07:43:12Z

Export to Livelox

← Older revision		Revision as of 09:43, 13 July 2022
Line 54:		Line 54:
	In the dialog appears a preview of the png map. Click on the image to open the png in an external application to see the quality of the created map file.<br>		In the dialog appears a preview of the png map. Click on the image to open the png in an external application to see the quality of the created map file.<br>
	If the extent of the map is wrong, close this dialog and set the export extent in the [[Export_Files#Setup_Part_of_Map\|export dialog]].		If the extent of the map is wrong, close this dialog and set the export extent in the [[Export_Files#Setup_Part_of_Map\|export dialog]].

	~~The map extent is the current print extent. You also have the possibility to choose another extent specified and saved before under '''[[Printing_Maps#Setup_Part_of_Map\|Setup_Part_of_Map]]'''.~~

	*'''Status''':		*'''Status''':

GRS: /* Export to Livelox */

2022-07-13T07:41:28Z

Export to Livelox

← Older revision		Revision as of 09:41, 13 July 2022
Line 54:		Line 54:
	In the dialog appears a preview of the png map. Click on the image to open the png in an external application to see the quality of the created map file.<br>		In the dialog appears a preview of the png map. Click on the image to open the png in an external application to see the quality of the created map file.<br>
	If the extent of the map is wrong, close this dialog and set the export extent in the [[Export_Files#Setup_Part_of_Map\|export dialog]].		If the extent of the map is wrong, close this dialog and set the export extent in the [[Export_Files#Setup_Part_of_Map\|export dialog]].

			The map extent is the current print extent. You also have the possibility to choose another extent specified and saved before under '''[[Printing_Maps#Setup_Part_of_Map\|Setup_Part_of_Map]]'''.

	*'''Status''':		*'''Status''':

ANK at 13:00, 29 March 2021

2021-03-29T13:00:15Z

← Older revision		Revision as of 15:00, 29 March 2021
Line 6:		Line 6:

	=Account=		=Account=
	You need a Livelox account to upload the data. If you are member of a Swedish, Norwegian or Australian orienteering club, please log in with your Eventor account rather than creating a new user account.<br>		You need a Livelox account to upload the data. If you have an Eventor account (e.g. you are member of a Swedish, Norwegian or Australian orienteering club), please log in with your Eventor account rather than creating a new user account.<br>
	You can create ~~the~~ user account here: [https://www.livelox.com/Account/Users/Create https://www.livelox.com/Account/Users/Create]		You can create your Livelox user account here: [https://www.livelox.com/Account/Users/Create https://www.livelox.com/Account/Users/Create]

	=Livelox Authorization=		=Livelox Authorization=

ANK at 12:57, 29 March 2021

2021-03-29T12:57:30Z

← Older revision		Revision as of 14:57, 29 March 2021
Line 20:		Line 20:
	[[File:LiveloxAuthorization02.png]]		[[File:LiveloxAuthorization02.png]]

	The web browser ~~open~~ and you have to login to Livelox.		The web browser opens and you have to login to Livelox.

	[[File:LiveloxAuthorization03.png~~\|500px~~]]		[[File:LiveloxAuthorization03.png]]

	[[File:LiveloxAuthorization04.png~~\|400px~~]]		[[File:LiveloxAuthorization04.png]]

	Click the Allow button to allow OCAD publish course-setting information to Livelox.<br>		Click the '''Allow button''' to allow OCAD publish course-setting information to Livelox.<br>
	After the successful authorization the web browser loads this ~~‘Livelox Authorization’~~ webpage which you can close.		After the successful authorization the web browser loads this ''Livelox Authorization'' webpage which you can close.

	[[File:LiveloxAuthorization05.png]]		[[File:LiveloxAuthorization05.png]]

	=Upload dialog=		=Upload dialog=
	After the successful authorization OCAD opens the Upload dialog.		After the successful authorization OCAD opens the '''Upload dialog'''.

	[[File:LiveloxDialog01.png]]		[[File:LiveloxDialog01.png]]

	==Event Information==		===Event Information===
	*'''ID''': The ID is empty for a new project. If you have already uploaded data the id already exists. In this case you can directly update the existing event in Livelox.		*'''ID''': The ID is empty for a new project. If you have already uploaded data the id already exists. In this case you can directly update the existing event in Livelox.
	*'''Name'''': Enter here the event name. OCAD uses the event name from the course setting options as default name.		*'''Name''': Enter here the event name. OCAD uses the [[Course_Setting_Options#Titles\|event name]] from the course setting options as default name.
	*'''Map name''': Enter here the map name. OCAD uses the ocd file name from the background map as default name.		*'''Map name''': Enter here the map name. OCAD uses the ocd file name from the [[Course_Setting_for_Orienteering#Start_a_New_Course_Setting_Project\|background map]] as default name.
	*'''Scale''': The scale is defined in the course setting project.		*'''Scale''': The scale is defined in the course setting project.

	==Settings==		===Settings===
	*'''Resolution''': Set here the resolution for the png map. For sprint maps 254dpi for a good quality is recommended, 286 dpi for the others maps.		*'''Resolution''': Set here the resolution for the png map. For sprint maps 254dpi for a good quality is recommended, 286 dpi for the others maps.
	*'''Remember me''': When this option is checked, then OCAD saves the Livelox authorization token encrypted in the Windows Registry. In this case you don’t have to do the authorization again when opening this dialog next time.		*'''Remember me''': When this option is checked, then OCAD saves the Livelox authorization token encrypted in the Windows Registry. In this case you don’t have to do the authorization again when opening this dialog next time.

	==Export to Livelox==		===Export to Livelox===
	Click the '''Check''' button to create and verify the upload data.		Click the '''Check''' button to create and verify the upload data.

	*'''Map Preview'''		*'''Map Preview''':
	[[File:LiveloxDialog02.png]]		[[File:LiveloxDialog02.png]]

	In the dialog appears a preview of the png map. Click on the image to open the png in an external application to see the quality of the created map file.<br>		In the dialog appears a preview of the png map. Click on the image to open the png in an external application to see the quality of the created map file.<br>
	If the extent of the map is wrong, close this dialog and set the export extent in the ~~export dialog~~ [[Export_Files#Setup_Part_of_Map]].		If the extent of the map is wrong, close this dialog and set the export extent in the [[Export_Files#Setup_Part_of_Map\|export dialog]].

	*'''Status'''		*'''Status''':
	The following status exist:		The following status exist:

	:Status not checked		:- Status not checked
	:Checking		:- Checking
	:Check failed		:- Check failed
	:Check successfully		:- Check successfully
	:Livelox validation errors		:- Livelox validation errors
	:Livelox validation warnings		:- Livelox validation warnings
	:Upload successfully		:- Upload successfully
	:Upload failed		:- Upload failed

	*'''Upload'''		*'''Upload'''
Line 84:		Line 84:
	The upload breaks when Livelox returns errors. You have to fix that error in the OCAD course setting project before publishing the data. When Livelox returns warnings it is possible to publish the data, but we recommend to fix these warnings in the OCAD course setting project first.		The upload breaks when Livelox returns errors. You have to fix that error in the OCAD course setting project before publishing the data. When Livelox returns warnings it is possible to publish the data, but we recommend to fix these warnings in the OCAD course setting project first.

	If the upload was successfully OCAD opens the web browser and redirect to Livelox where you can create the event		If the upload was successfully OCAD opens the web browser and redirect to Livelox where you can create the event.

	[[File:LiveloxDialog04.png]]		[[File:LiveloxDialog04.png]]

	Once you have created the event, the option '''Update existing event''' is available. If changes are made to the courses later on, use the option '''Update existing event''' to upload data. In this case OCAD publish the changes without redirecting the user to Livelox.		Once you have created the event, the option '''Update existing event''' is available.<br>
			If changes are made to the courses later on, use the option '''Update existing event''' to upload data.<br>
			In this case OCAD publish the changes without redirecting the user to Livelox.<br>

ANK at 12:37, 29 March 2021

2021-03-29T12:37:05Z

← Older revision		Revision as of 14:37, 29 March 2021
Line 1:		Line 1:
	~~ToDo~~		[[File:Mas40px.PNG\|This function is available in OCAD Mapping Solution.\|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG\|This function is available in OCAD Orienteering.\|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG\|This function is available in OCAD Starter.\|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG\|This function is available in OCAD Course Setting.\|link=https://www.ocad.com/en/products/ocad-for-orienteering]]

			[https://www.livelox.com/ Livelox] is a web-based application for analysis of routes from orienteering races. Participants record their routes in real time using a mobile app, or upload them from their GPS watches afterwards. As an organizer of orienteering trainings or competitions, you can publish maps and courses to Livelox to let spectators follow the competitors in real time, and to let participants analyze their route choices post-race.

			The OCAD function '''Upload to Livelox''' can be found in the '''Course Setting''' menu of the OCAD programm. It will upload maps, courses and course data directly to Livelox.

			=Account=
			You need a Livelox account to upload the data. If you are member of a Swedish, Norwegian or Australian orienteering club, please log in with your Eventor account rather than creating a new user account.<br>
			You can create the user account here: [https://www.livelox.com/Account/Users/Create https://www.livelox.com/Account/Users/Create]

			=Livelox Authorization=
			OCAD uses the OAuth2 protocol for the authorization. The first time you upload data to Livelox you have to allow OCAD access to your Livelox account.

			First you have to allow OCAD access to start a webserver for the OAuth2 authorization.

			[[File:LiveloxAuthorization01.png]]

			Click '''Allow access'''.

			[[File:LiveloxAuthorization02.png]]

			The web browser open and you have to login to Livelox.

			[[File:LiveloxAuthorization03.png\|500px]]

			[[File:LiveloxAuthorization04.png\|400px]]

			Click the Allow button to allow OCAD publish course-setting information to Livelox.<br>
			After the successful authorization the web browser loads this ‘Livelox Authorization’ webpage which you can close.

			[[File:LiveloxAuthorization05.png]]

			=Upload dialog=
			After the successful authorization OCAD opens the Upload dialog.

			[[File:LiveloxDialog01.png]]

			==Event Information==
			*'''ID''': The ID is empty for a new project. If you have already uploaded data the id already exists. In this case you can directly update the existing event in Livelox.
			*'''Name'''': Enter here the event name. OCAD uses the event name from the course setting options as default name.
			*'''Map name''': Enter here the map name. OCAD uses the ocd file name from the background map as default name.
			*'''Scale''': The scale is defined in the course setting project.

			==Settings==
			*'''Resolution''': Set here the resolution for the png map. For sprint maps 254dpi for a good quality is recommended, 286 dpi for the others maps.
			*'''Remember me''': When this option is checked, then OCAD saves the Livelox authorization token encrypted in the Windows Registry. In this case you don’t have to do the authorization again when opening this dialog next time.

			==Export to Livelox==
			Click the '''Check''' button to create and verify the upload data.

			*'''Map Preview'''
			[[File:LiveloxDialog02.png]]

			In the dialog appears a preview of the png map. Click on the image to open the png in an external application to see the quality of the created map file.<br>
			If the extent of the map is wrong, close this dialog and set the export extent in the export dialog [[Export_Files#Setup_Part_of_Map]].

			*'''Status'''
			The following status exist:

			:Status not checked
			:Checking
			:Check failed
			:Check successfully
			:Livelox validation errors
			:Livelox validation warnings
			:Upload successfully
			:Upload failed

			*'''Upload'''
			The '''Upload''' button is only enabled when the check was successfully. Click the '''Upload''' button to upload the data.

			OCAD uploads the following data:

			:- rasterized map as png with world file
			:- courses as svg file
			:- course setting data as IOF xml file
			:- index file

			*'''Error and Warnings'''
			Livelox does also a check which can return errors and warnings.

			[[File:LiveloxDialog03.png]]

			The upload breaks when Livelox returns errors. You have to fix that error in the OCAD course setting project before publishing the data. When Livelox returns warnings it is possible to publish the data, but we recommend to fix these warnings in the OCAD course setting project first.

			If the upload was successfully OCAD opens the web browser and redirect to Livelox where you can create the event

			[[File:LiveloxDialog04.png]]

			Once you have created the event, the option '''Update existing event''' is available. If changes are made to the courses later on, use the option '''Update existing event''' to upload data. In this case OCAD publish the changes without redirecting the user to Livelox.

MergeUser: Created page with "ToDo"

2021-03-29T11:18:26Z

Created page with "ToDo"

New page

ToDo