Executing Services - Revision history

Padro at 15:01, 18 July 2019

2019-07-18T15:01:16Z

Padro at 10:01, 18 July 2019

2019-07-18T10:01:41Z

Padro at 11:24, 21 January 2016

2016-01-21T11:24:37Z

Padro at 11:23, 21 January 2016

2016-01-21T11:23:07Z

Padro at 15:44, 19 January 2016

2016-01-19T15:44:26Z

Padro at 15:44, 19 January 2016

2016-01-19T15:44:04Z

Padro at 15:42, 19 January 2016

2016-01-19T15:42:15Z

Padro at 15:41, 19 January 2016

2016-01-19T15:41:22Z

Padro at 15:38, 19 January 2016

2016-01-19T15:38:25Z

Padro at 15:37, 19 January 2016

2016-01-19T15:37:38Z

@@ Line 49: / Line 49: @@
 == What if I get "NO SERVERS AVAILABLE" ?  ==
-TextServer keeps a battery of loaded servers for each provided service.
+TextServer keeps an array of loaded servers for each provided service.
 If the service is not requested, the servers are stopped to save resources.
-If a request arrives and there are no loaded services (or all loaded services are busy), the user may get the "no servers available, try again later" error.  However, when this happens, TextServer launches new servers.  So, if the request is sent again, it will be attended by those newly created servers.
+If a request arrives and there are no running servers (or all loaded servers are busy), the user may get the "no servers available, try again later" error.  However, when this happens, TextServer launches new servers.  So, if the request is sent again after a short time, it will be attended by those newly created servers.
 Notice that depending on the service, loading a server may take some time (from a few seconds to a couple of minutes), so it is wise to wait a reasonable time before sending the request again.

← Older revision		Revision as of 10:01, 18 July 2019
Line 46:		Line 46:

	The retrieval can be done to the user convenience (e.g. the same client can send the request and sleep for a while before polling the server to get the results, or you can have an independent cron job that polls for all sent requests once every hour, or you can add a trigger in your mail that will launch the retrieval when the "job completed" mail is received, etc.)		The retrieval can be done to the user convenience (e.g. the same client can send the request and sleep for a while before polling the server to get the results, or you can have an independent cron job that polls for all sent requests once every hour, or you can add a trigger in your mail that will launch the retrieval when the "job completed" mail is received, etc.)
		+
		+	== What if I get "NO SERVERS AVAILABLE" ? ==
		+
		+	TextServer keeps a battery of loaded servers for each provided service.
		+	If the service is not requested, the servers are stopped to save resources.
		+	If a request arrives and there are no loaded services (or all loaded services are busy), the user may get the "no servers available, try again later" error. However, when this happens, TextServer launches new servers. So, if the request is sent again, it will be attended by those newly created servers.
		+
		+	Notice that depending on the service, loading a server may take some time (from a few seconds to a couple of minutes), so it is wise to wait a reasonable time before sending the request again.

@@ Line 39: / Line 39: @@
 The user can retrieve the results manually in the web page, or programmatically from a remote client.
-Example remote clients to retrieve batch requests results are provided
+[[Example Clients|Example clients]] to retrieve batch requests results are provided.
 TextServer will notify the user via email when the job is finished. Alteratively, the user can poll TextServer periodically to find out whether job results are ready.

← Older revision		Revision as of 11:23, 21 January 2016
Line 32:		Line 32:
	To call TextServer services from a remote client you need a program that sends a POST request with the right parameters to the right URL.		To call TextServer services from a remote client you need a program that sends a POST request with the right parameters to the right URL.
	Since this is easier to say than to do, we provide a set of [[Example Clients\|example clients]] you can use as a basis to write your own.		Since this is easier to say than to do, we provide a set of [[Example Clients\|example clients]] you can use as a basis to write your own.
		+
		+
		+	== Retrieving Results for a Batch Request ==
		+
		+	When the user submits a batch request, TextServer responds with a Token ID that will identify the job and allow retrieval of the results when it is done.
		+
		+	The user can retrieve the results manually in the web page, or programmatically from a remote client.
		+	Example remote clients to retrieve batch requests results are provided
		+
		+	TextServer will notify the user via email when the job is finished. Alteratively, the user can poll TextServer periodically to find out whether job results are ready.
		+
		+	When the user attempts to retrieve the results of an unfinished job, TextServer will respond with a HTTP 503 error message (Service Unavailable) containing the TextServer error code TS-125 (job not finished) in the message body.
		+
		+	The retrieval can be done to the user convenience (e.g. the same client can send the request and sleep for a while before polling the server to get the results, or you can have an independent cron job that polls for all sent requests once every hour, or you can add a trigger in your mail that will launch the retrieval when the "job completed" mail is received, etc.)

@@ Line 1: / Line 1: @@
-=== Interactive and Batch requests ===
+== Interactive and Batch requests ==
 Services can be called in two ways: Manually via a browser web interface, or programmatically via a client program running on your side. See below for details on each of them.
@@ Line 26: / Line 26: @@
-=== Submitting Jobs via a Remote Client ===
+== Submitting Jobs via a Remote Client ==
 TextServer becomes most useful when used from a remote client. This allows you to integrate into your application the results of our language analyzers.

← Older revision		Revision as of 15:44, 19 January 2016
Line 18:		Line 18:


−	=== Submitting Jobs via Web Browser ===	+	== Submitting Jobs via Web Browser ==

	A registered user can submit a text for analysis from the "Execute" form in the [[Service Catalog]].		A registered user can submit a text for analysis from the "Execute" form in the [[Service Catalog]].

← Older revision		Revision as of 15:42, 19 January 2016
Line 31:		Line 31:

	To call TextServer services from a remote client you need a program that sends a POST request with the right parameters to the right URL.		To call TextServer services from a remote client you need a program that sends a POST request with the right parameters to the right URL.
−	Since this is easier to say than to do, we provide ~~here~~ a set of example clients you can use as a basis to write your own.	+	Since this is easier to say than to do, we provide a set of [[Example Clients\|example clients]] you can use as a basis to write your own.

← Older revision		Revision as of 15:41, 19 January 2016
Line 1:		Line 1:
−	Services can be called in two ways: Manually via a browser web interface, or programmatically via a client program running on your side.	+	=== Interactive and Batch requests ===
		+
		+	Services can be called in two ways: Manually via a browser web interface, or programmatically via a client program running on your side. See below for details on each of them.

	Both ways allow submitting either interactive or batch requests.		Both ways allow submitting either interactive or batch requests.

← Older revision		Revision as of 15:38, 19 January 2016
Line 29:		Line 29:

	To call TextServer services from a remote client you need a program that sends a POST request with the right parameters to the right URL.		To call TextServer services from a remote client you need a program that sends a POST request with the right parameters to the right URL.
−	Since this is easier to say than to do, we provide here set of example clients you can use as a basis to write your own.	+	Since this is easier to say than to do, we provide here a set of example clients you can use as a basis to write your own.

@@ Line 18: / Line 18: @@
 === Submitting Jobs via Web Browser ===
-A registered user can submit a text for analysis from the "Execute" form in the [http://textserver.lsi.upc.edu/wiki/index.php/Service_Catalog Service Catalog].
+A registered user can submit a text for analysis from the "Execute" form in the [[Service Catalog]].
 The form will require the user to select the type of request (Interactive/Batch), to provide the service parameters (e.g. language, desired output format...), and the text to be analyzed (either writting it in a text box or uploading a file).
-When clicking "Execute" the request will be sent.  If it is a batch request, the user will get a job id for later [http://textserver.lsi.upc.edu/wiki/index.php/Retrieving_Batch_Results result retrieval]. If it is an interactive request, the user will get a file in the desired output format (XML, json, etc.)
+When clicking "Execute" the request will be sent.  If it is a batch request, the user will get a job id for later [[Retrieving_Batch_Results|result retrieval]]. If it is an interactive request, the user will get a file in the desired output format (XML, json, etc.)