AppSuite:UI FAQ - Revision history

Khgras at 10:06, 22 May 2017

2017-05-22T10:06:02Z

← Older revision		Revision as of 10:06, 22 May 2017
Line 1:		Line 1:
	~~<!-- !!! -->~~		The content on this page has moved to https://documentation.open-xchange.com/latest/ui/miscellaneous/faq.html
	~~<!-- PLEASE APPLY CHANGES ONLY TO THE NEW TECHNICAL DOCUMENTATION~~: ~~wd/frontend~~/~~web~~/documentation -->
	~~<!-- !!! -->~~

	~~'''Synopsis~~:~~''' Frequently asked questions about running~~ the ~~App Suite UI. If you need~~ a ~~tool set for finding things out about the UI, see [https://~~documentation.open-xchange.com~~/latest/ui/miscellaneous/debugging~~.~~html].~~		Note: Open-Xchange is in the process of migrating all its technical documentation to a new and improved documentation system (documentation.open-xchange.com). Please note as the migration takes place more information will be available on the new system and less on this system. Thank you for your understanding during this period of transition.

	~~= Getting~~ the ~~UI started =~~
	~~Frequently asked by new developers. And forgetful veterans. Who therefore write documentation pieces like this.~~

	~~== Does show the login screen after logging in ==~~
	~~This means you managed to find a bug even before our error message module could~~ be ~~loaded. There is something rather basic broken, maybe~~ the ~~DB connection or some of the standard .js~~

	~~The only hint we can give from a UI perspective is to use the developer console on your browser~~ and~~, if applicable, turn~~ on ~~"halt on all errors" or "preserve logging data". You might see an error message that otherwise gets eaten by a redirect~~.

	If you ~~are running the backend yourself, you are in luck, go, look at the server error log.~~

	~~== Does not load, fails with error: Could not read... ==~~
	~~"Could not read 'io.ox/core/http.js'"~~
	~~"Could not read 'io.ox/core/events.js'"~~
	That's not all, the system is probably hiding even more errors. It is more probable that the whole UI cannot be found. Check the com.openexchange.apps.path, usually hidden in manifests.properties. Does it point to where your ~~webserver serves the files from? The default is /var/www/appsuite, on OSX is is more likely to be /Library/WebServer/Documents/appsuite~~

	~~== App Suite loads, but no apps show up ==~~
	So bother backend and frontend are devoid of errors, the UI loads nicely, you see the top bar with settings, notifications and refresh button but no apps at all, right? This is a manifest problem. Check the capabilities (see hint in the beginning of this ~~page). If even those are correct, check the backend's /tmp folder and the manifest.properties there: Are the paths~~ of ~~<tt>com.openexchange.apps.path</tt> and <tt>com.openexchange.apps.manifestPath</tt> pointing to your build directory?~~

	~~== Could not read 'io.ox/office/preview/app/... when loading anything but the portal ==~~
	~~You lack preview capabilities. Since you can choose what to use, here are your options~~
	* use the URL parameter <tt>disableFeature=document_preview%2Ctext</tt>
	* figure out how to install office
	* use the existing preview bundles

	~~== After logging in I'm dumped back to the login page with a #autologin=false added to the URL ==~~

	~~You might not see an error message in the console then~~. ~~Configure your JS console to preserve messages on navigation (so after a redirect), and you might get a hint as to what's wrong.~~

	~~= UI build environment =~~

	~~There is an explicit [https://documentation.open-xchange.com/latest/ui/00-getting-started/04-build-process.html FAQ page] for grunt related questions when working with external modules.~~

	~~[[Category:AppSuite]]~~
	~~[[Category:UI]]~~
	~~[[Category:Developer]]~~

Khgras at 10:00, 22 May 2017

2017-05-22T10:00:31Z

← Older revision		Revision as of 10:00, 22 May 2017
Line 3:		Line 3:
	<!-- !!! -->		<!-- !!! -->

	'''Synopsis:''' Frequently asked questions about running the App Suite UI. If you need a tool set for finding things out about the UI, see [~~[AppSuite~~:~~Debugging the UI]~~].		'''Synopsis:''' Frequently asked questions about running the App Suite UI. If you need a tool set for finding things out about the UI, see [https://documentation.open-xchange.com/latest/ui/miscellaneous/debugging.html].

	= Getting the UI started =		= Getting the UI started =

Khgras at 09:09, 22 May 2017

2017-05-22T09:09:06Z

← Older revision		Revision as of 09:09, 22 May 2017
Line 35:		Line 35:
	= UI build environment =		= UI build environment =

	There is an explicit [~~[AppSuite~~:~~GruntFAQ\|~~FAQ page]] for grunt related questions when working with external modules.		There is an explicit [https://documentation.open-xchange.com/latest/ui/00-getting-started/04-build-process.html FAQ page] for grunt related questions when working with external modules.

	[[Category:AppSuite]]		[[Category:AppSuite]]
	[[Category:UI]]		[[Category:UI]]
	[[Category:Developer]]		[[Category:Developer]]

Frank.paczynski at 06:16, 11 February 2016

2016-02-11T06:16:04Z

← Older revision		Revision as of 06:16, 11 February 2016
Line 1:		Line 1:
			<!-- !!! -->
			<!-- PLEASE APPLY CHANGES ONLY TO THE NEW TECHNICAL DOCUMENTATION: wd/frontend/web/documentation -->
			<!-- !!! -->

	'''Synopsis:''' Frequently asked questions about running the App Suite UI. If you need a tool set for finding things out about the UI, see [[AppSuite:Debugging the UI]].		'''Synopsis:''' Frequently asked questions about running the App Suite UI. If you need a tool set for finding things out about the UI, see [[AppSuite:Debugging the UI]].

J.ohny.b at 08:28, 1 July 2014

2014-07-01T08:28:17Z

← Older revision		Revision as of 08:28, 1 July 2014
Line 29:		Line 29:
	You might not see an error message in the console then. Configure your JS console to preserve messages on navigation (so after a redirect), and you might get a hint as to what's wrong.		You might not see an error message in the console then. Configure your JS console to preserve messages on navigation (so after a redirect), and you might get a hint as to what's wrong.

	= UI build environment		= UI build environment =

	There is an explicit [[AppSuite:GruntFAQ\|FAQ page]] for grunt related questions when working with external modules.		There is an explicit [[AppSuite:GruntFAQ\|FAQ page]] for grunt related questions when working with external modules.

J.ohny.b at 08:27, 1 July 2014

2014-07-01T08:27:41Z

← Older revision		Revision as of 08:27, 1 July 2014
Line 29:		Line 29:
	You might not see an error message in the console then. Configure your JS console to preserve messages on navigation (so after a redirect), and you might get a hint as to what's wrong.		You might not see an error message in the console then. Configure your JS console to preserve messages on navigation (so after a redirect), and you might get a hint as to what's wrong.

			= UI build environment

			There is an explicit [[AppSuite:GruntFAQ\|FAQ page]] for grunt related questions when working with external modules.

	[[Category:AppSuite]]		[[Category:AppSuite]]
	[[Category:UI]]		[[Category:UI]]
	[[Category:Developer]]		[[Category:Developer]]

DerCisco: Added hint

2014-05-26T08:53:02Z

Added hint

← Older revision		Revision as of 08:53, 26 May 2014
Line 24:		Line 24:
	* figure out how to install office		* figure out how to install office
	* use the existing preview bundles		* use the existing preview bundles

			== After logging in I'm dumped back to the login page with a #autologin=false added to the URL ==

			You might not see an error message in the console then. Configure your JS console to preserve messages on navigation (so after a redirect), and you might get a hint as to what's wrong.


	[[Category:AppSuite]]		[[Category:AppSuite]]
	[[Category:UI]]		[[Category:UI]]
	[[Category:Developer]]		[[Category:Developer]]

Tierlieb at 11:26, 18 December 2013

2013-12-18T11:26:10Z

← Older revision		Revision as of 11:26, 18 December 2013
Line 18:		Line 18:
	== App Suite loads, but no apps show up ==		== App Suite loads, but no apps show up ==
	So bother backend and frontend are devoid of errors, the UI loads nicely, you see the top bar with settings, notifications and refresh button but no apps at all, right? This is a manifest problem. Check the capabilities (see hint in the beginning of this page). If even those are correct, check the backend's /tmp folder and the manifest.properties there: Are the paths of <tt>com.openexchange.apps.path</tt> and <tt>com.openexchange.apps.manifestPath</tt> pointing to your build directory?		So bother backend and frontend are devoid of errors, the UI loads nicely, you see the top bar with settings, notifications and refresh button but no apps at all, right? This is a manifest problem. Check the capabilities (see hint in the beginning of this page). If even those are correct, check the backend's /tmp folder and the manifest.properties there: Are the paths of <tt>com.openexchange.apps.path</tt> and <tt>com.openexchange.apps.manifestPath</tt> pointing to your build directory?

			== Could not read 'io.ox/office/preview/app/... when loading anything but the portal ==
			You lack preview capabilities. Since you can choose what to use, here are your options
			* use the URL parameter <tt>disableFeature=document_preview%2Ctext</tt>
			* figure out how to install office
			* use the existing preview bundles

	[[Category:AppSuite]]		[[Category:AppSuite]]
	[[Category:UI]]		[[Category:UI]]
	[[Category:Developer]]		[[Category:Developer]]

DerCisco: /* Does not load, fails with error: Could not read... */

2013-12-05T12:23:33Z

Does not load, fails with error: Could not read...

← Older revision		Revision as of 12:23, 5 December 2013
Line 14:		Line 14:
	"Could not read 'io.ox/core/http.js'"		"Could not read 'io.ox/core/http.js'"
	"Could not read 'io.ox/core/events.js'"		"Could not read 'io.ox/core/events.js'"
	That's not all, the system is probably hiding even more errors. It is more probable that the whole UI cannot be found. Check the com.openexchange.apps.path, usually hidden in manifests.properties. Does it point to where your webserver serves the files from? The default is /var/www/appsuite, on OSX is is more likely to be /~~Libraries~~/WebServer/Documents/appsuite		That's not all, the system is probably hiding even more errors. It is more probable that the whole UI cannot be found. Check the com.openexchange.apps.path, usually hidden in manifests.properties. Does it point to where your webserver serves the files from? The default is /var/www/appsuite, on OSX is is more likely to be /Library/WebServer/Documents/appsuite

	== App Suite loads, but no apps show up ==		== App Suite loads, but no apps show up ==

DerCisco: /* Does show the login screen after logging in */

2013-12-05T12:23:22Z

Does show the login screen after logging in

← Older revision		Revision as of 12:23, 5 December 2013
Line 7:		Line 7:
	This means you managed to find a bug even before our error message module could be loaded. There is something rather basic broken, maybe the DB connection or some of the standard .js		This means you managed to find a bug even before our error message module could be loaded. There is something rather basic broken, maybe the DB connection or some of the standard .js

	The only hint we can give from a UI perspective is to use the developer console on your browser and, if applicable, turn on "halt on all errors" or "~~preserver~~ logging data". You might see an error message that otherwise gets eaten by a redirect.		The only hint we can give from a UI perspective is to use the developer console on your browser and, if applicable, turn on "halt on all errors" or "preserve logging data". You might see an error message that otherwise gets eaten by a redirect.

	If you are running the backend yourself, you are in luck, go, look at the server error log.		If you are running the backend yourself, you are in luck, go, look at the server error log.