OS4X Enterprise job archive restore - Revision history

Admin at 08:59, 22 August 2017

2017-08-22T08:59:23Z

2017-08-22T08:46:24Z

Configuring job restore

2017-08-22T08:46:06Z

Configuring job restore

2017-08-22T08:43:05Z

Debugging

2017-08-22T08:37:04Z

Debugging

2017-08-22T08:36:05Z

2017-08-22T08:32:18Z

Using job restore

2017-08-22T08:31:15Z

Using job restore

2017-08-22T08:25:41Z

Configuring job restore

2017-08-22T08:25:16Z

Configuring job restore

@@ Line 48: / Line 48: @@
 *Untrusted script source: the web server of the JSONP service may disallow your request. Be aware that your administrative web interface is starting the request, not the OS4X server!
 *JSONP requests are always HTTP(S) GET requests. No POST, PUT, OPTIONS etc. are allowed.
 [[Category:OS4X Enterprise]]

← Older revision		Revision as of 08:46, 22 August 2017
Line 34:		Line 34:


−	'''Hint:''' If you need additional ~~parameter~~ for the request, just append them seperated in URL encoded entities as GET parameters to the service URL. The archive restore service call will identify this situation and will append the own parameters according to the rules for GET parameters dynamically! Example service URL with additional parameters:	+	'''Hint:''' If you need additional parameters for the request, just append them seperated in URL encoded entities as GET parameters to the service URL. The archive restore service call will identify this situation and will append the own parameters according to the rules for GET parameters dynamically! Example service URL with additional parameters:
	http://192.168.20.60/archiving/restoreJob?myParameter=myValue&mySecondParameter=this%20is%20a%20test		http://192.168.20.60/archiving/restoreJob?myParameter=myValue&mySecondParameter=this%20is%20a%20test

@@ Line 22: / Line 22: @@
 In the OS4X's administrative web interface, navigate to "Configuration" -> "OS4X Enterprise" -> "Basic". In the section "Job restore mechanism" there exist some parameters to be defined:
-*Absolute AJAX URL for job restore processes: This is the absolute URL of the service call
+*Absolute AJAX URL for job restore processes: This is the absolute URL of the service call.
 *Name of parameter for restore AJAX call: the parameter name of the archive ID must be configured here
 *(optional) Name of JSONP callback parameter: the callback function name parameter
@@ Line 32: / Line 32: @@
 *Expected answer:
   Ext.my.callbackfn123({ whatever: true })
 = Using job restore =

@@ Line 43: / Line 43: @@
 *Wrong server answer: the JSONP request must be answered by encapsulating the JSON answer in the callback function. The callback function name is dynamic. Only JSON is supported as content payload, XML is not supported by this mechanism. More information about JSONP is available at [https://en.wikipedia.org/wiki/JSONP Wikipedia].
 *Untrusted script source: the web server of the JSONP service may disallow your request. Be aware that your administrative web interface is starting the request, not the OS4X server!
 [[Category:OS4X Enterprise]]

@@ Line 42: / Line 42: @@
 *Unauthorized service access: verify that the service call can be executed from the web browser location you are using. When dealing with single-sign-on environments, the service call will typically answer with an HTTP 401 (unauthorized) answer, so the webbrowser can answer back again with an authorized request automatically.
 *Wrong server answer: the JSONP request must be answered by encapsulating the JSON answer in the callback function. The callback function name is dynamic. Only JSON is supported as content payload, XML is not supported by this mechanism. More information about JSONP is available at [https://en.wikipedia.org/wiki/JSONP Wikipedia].
 [[Category:OS4X Enterprise]]

← Older revision		Revision as of 08:36, 22 August 2017
Line 38:		Line 38:
	[[Image:Google ChromeScreenSnapz441.png]]		[[Image:Google ChromeScreenSnapz441.png]]

		+	= Debugging =
		+	When something goes wrong, it can have several reasons. The most common are:
		+	*Unauthorized service access: verify that the service call can be executed from the web browser location you are using. When dealing with single-sign-on environments, the service call will typically answer with an HTTP 401 (unauthorized) answer, so the webbrowser can answer back again with an authorized request automatically.
		+	*Wrong server answer: the JSONP request must be answered by encapsulating the JSON answer in the callback function. The callback function name is dynamic. Only JSON is supported as content payload, XML is not supported by this mechanism. More information about JSONP is available at [https://en.wikipedia.org/wiki/JSONP Wikipedia].

	[[Category:OS4X Enterprise]]		[[Category:OS4X Enterprise]]

@@ Line 34: / Line 34: @@
 = Using job restore =
-In the job detail view, a button exists for job restoring. As long as the value "<code>archive_id</code>" of the database table "<code>os4x_jobs</code>" has a non-NULL value (where the numeric value of "<code>0</code>" is also interpreted as NULL) the button is enabled:
+In the job detail view, a button exists for job restoring. As long as the value "<code>archive_id</code>" of the database table "<code>os4x_jobs</code>" has a non-NULL value (where the numeric value of "<code>0</code>" is also interpreted as NULL) the button is enabled. When pressing this button, the JSONP request is executed with the actual configuration and the restore process can be executed asynchronously.
 [[Image:Google ChromeScreenSnapz441.png]]

← Older revision		Revision as of 08:31, 22 August 2017
Line 34:		Line 34:

	= Using job restore =		= Using job restore =
		+	In the job detail view, a button exists for job restoring. As long as the value "<code>archive_id</code>" of the database table "<code>os4x_jobs</code>" has a non-NULL value (where the numeric value of "<code>0</code>" is also interpreted as NULL) the button is enabled:
		+
		+	[[Image:Google ChromeScreenSnapz441.png]]
		+

	[[Category:OS4X Enterprise]]		[[Category:OS4X Enterprise]]

@@ Line 26: / Line 26: @@
 *(optional) Name of JSONP callback parameter: the callback function name parameter
 Due to the nature of JSONP, your service must be able to interpret the "callback" parameter and reply with a JSON answer, encapsulated by the callback function name. Example:
 *Service URL call: http://192.168.20.60/archiving/restoreJob?inArchiveJobId=4711&callback=Ext.my.callbackfn123