RubyGems - rturk - Versions diffs - 2.0.2 → 2.0.3 - Mend

rturk 2.0.2 → 2.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (122) hide show

data/README.markdown +3 -2
data/Rakefile +10 -4
data/VERSION +1 -1
data/aws_docs/ApiReference_AnswerKeyDataStructureArticle.html +98 -0
data/aws_docs/ApiReference_ApproveAssignmentOperation.html +75 -0
data/aws_docs/ApiReference_AssignQualificationOperation.html +107 -0
data/aws_docs/ApiReference_AssignmentDataStructureArticle.html +171 -0
data/aws_docs/ApiReference_BlockWorkerOperation.html +70 -0
data/aws_docs/ApiReference_ChangeHITTypeOfHITOperation.html +68 -0
data/aws_docs/ApiReference_CommonParametersArticle.html +119 -0
data/aws_docs/ApiReference_CreateHITOperation.html +330 -0
data/aws_docs/ApiReference_CreateQualificationTypeOperation.html +190 -0
data/aws_docs/ApiReference_DataStructuresArticle.html +7 -0
data/aws_docs/ApiReference_DisableHITOperation.html +63 -0
data/aws_docs/ApiReference_DisposeHITOperation.html +56 -0
data/aws_docs/ApiReference_DisposeQualificationTypeOperation.html +52 -0
data/aws_docs/ApiReference_ExtendHITOperation.html +86 -0
data/aws_docs/ApiReference_ExternalQuestionArticle.html +125 -0
data/aws_docs/ApiReference_ForceExpireHITOperation.html +61 -0
data/aws_docs/ApiReference_FormattedContentXHTMLArticle.html +289 -0
data/aws_docs/ApiReference_GetAccountBalanceOperation.html +51 -0
data/aws_docs/ApiReference_GetAssignmentsForHITOperation.html +166 -0
data/aws_docs/ApiReference_GetBonusPaymentsOperation.html +160 -0
data/aws_docs/ApiReference_GetFileUploadURLOperation.html +75 -0
data/aws_docs/ApiReference_GetHITOperation.html +89 -0
data/aws_docs/ApiReference_GetHITsForQualificationTypeOperation.html +137 -0
data/aws_docs/ApiReference_GetQualificationRequestsOperation.html +155 -0
data/aws_docs/ApiReference_GetQualificationScoreOperation.html +68 -0
data/aws_docs/ApiReference_GetQualificationTypeOperation.html +57 -0
data/aws_docs/ApiReference_GetQualificationsForQualificationTypeOperation.html +134 -0
data/aws_docs/ApiReference_GetRequesterStatisticOperation.html +315 -0
data/aws_docs/ApiReference_GetReviewableHITsOperation.html +155 -0
data/aws_docs/ApiReference_GrantBonusOperation.html +95 -0
data/aws_docs/ApiReference_GrantQualificationOperation.html +69 -0
data/aws_docs/ApiReference_HITDataStructureArticle.html +302 -0
data/aws_docs/ApiReference_HelpOperation.html +125 -0
data/aws_docs/ApiReference_LocaleDataStructureArticle.html +29 -0
data/aws_docs/ApiReference_NotificationAPI_BuildingANotificationReceptor.html +36 -0
data/aws_docs/ApiReference_NotificationAPI_ElementsOfANotification.html +40 -0
data/aws_docs/ApiReference_NotificationDataStructureArticle.html +73 -0
data/aws_docs/ApiReference_NotificationReceptorAPIArticle.html +9 -0
data/aws_docs/ApiReference_NotificationReceptorAPI_RESTTransportArticle.html +39 -0
data/aws_docs/ApiReference_NotificationReceptorAPI_SOAPTransportArticle.html +45 -0
data/aws_docs/ApiReference_NotifyWorkersOperation.html +82 -0
data/aws_docs/ApiReference_OperationsArticle.html +8 -0
data/aws_docs/ApiReference_PriceDataStructureArticle.html +65 -0
data/aws_docs/ApiReference_QualificationDataStructureArticle.html +89 -0
data/aws_docs/ApiReference_QualificationRequestDataStructureArticle.html +102 -0
data/aws_docs/ApiReference_QualificationRequirementDataStructureArticle.html +176 -0
data/aws_docs/ApiReference_QualificationTypeDataStructureArticle.html +198 -0
data/aws_docs/ApiReference_QuestionAnswerDataArticle.html +8 -0
data/aws_docs/ApiReference_QuestionFormAnswersDataStructureArticle.html +54 -0
data/aws_docs/ApiReference_QuestionFormDataStructureArticle.html +796 -0
data/aws_docs/ApiReference_RegisterHITTypeOperation.html +149 -0
data/aws_docs/ApiReference_RejectAssignmentOperation.html +66 -0
data/aws_docs/ApiReference_RejectQualificationRequestOperation.html +61 -0
data/aws_docs/ApiReference_RevokeQualificationOperation.html +78 -0
data/aws_docs/ApiReference_SearchHITsOperation.html +164 -0
data/aws_docs/ApiReference_SearchQualificationTypesOperation.html +211 -0
data/aws_docs/ApiReference_SendTestEventNotificationOperation.html +78 -0
data/aws_docs/ApiReference_SetHITAsReviewingOperation.html +73 -0
data/aws_docs/ApiReference_SetHITTypeNotificationOperation.html +99 -0
data/aws_docs/ApiReference_UnblockWorkerOperation.html +67 -0
data/aws_docs/ApiReference_UpdateQualificationScoreOperation.html +77 -0
data/aws_docs/ApiReference_UpdateQualificationTypeOperation.html +180 -0
data/aws_docs/ApiReference_WsdlLocationArticle.html +95 -0
data/aws_docs/ApiReference_XMLParameterValuesArticle.html +37 -0
data/aws_docs/Welcome.html +125 -0
data/aws_docs/WhatsNew.html +16 -0
data/aws_docs/_title.html +28 -0
data/aws_docs/_toc.html +749 -0
data/aws_docs/aws-docs-IE.css +419 -0
data/aws_docs/aws-docs.css +455 -0
data/aws_docs/copyrightinfo.html +14 -0
data/aws_docs/frameset.js +12 -0
data/aws_docs/images/Feedback_link.gif +0 -0
data/aws_docs/images/caution.png +0 -0
data/aws_docs/images/home.gif +0 -0
data/aws_docs/images/important.png +0 -0
data/aws_docs/images/next.gif +0 -0
data/aws_docs/images/note.png +0 -0
data/aws_docs/images/prev.gif +0 -0
data/aws_docs/images/tip.png +0 -0
data/aws_docs/images/title-swoosh-logo.gif +0 -0
data/aws_docs/images/toc_bullet.gif +0 -0
data/aws_docs/images/toc_plus.gif +0 -0
data/aws_docs/index.html +18 -0
data/aws_docs/toc.js +84 -0
data/lib/rturk.rb +2 -2
data/lib/rturk/adapter.rb +11 -0
data/lib/rturk/adapters/assignment.rb +13 -50
data/lib/rturk/adapters/hit.rb +21 -9
data/lib/rturk/adapters/worker.rb +23 -0
data/lib/rturk/operation.rb +1 -1
data/lib/rturk/operations/create_hit.rb +10 -54
data/lib/rturk/operations/register_hit_type.rb +68 -0
data/lib/rturk/operations/search_hits.rb +44 -0
data/lib/rturk/parser.rb +8 -0
data/lib/rturk/parsers/answer_parser.rb +29 -0
data/lib/rturk/parsers/assignment_parser.rb +49 -0
data/lib/rturk/parsers/hit_parser.rb +50 -0
data/lib/rturk/{response.rb → parsers/response.rb} +7 -2
data/lib/rturk/{responses → parsers/responses}/create_hit_response.rb +2 -2
data/lib/rturk/{responses → parsers/responses}/get_account_balance_response.rb +0 -0
data/lib/rturk/{responses → parsers/responses}/get_assignments_for_hit_response.rb +3 -3
data/lib/rturk/{responses → parsers/responses}/get_hit_response.rb +9 -16
data/lib/rturk/{responses → parsers/responses}/get_reviewable_hits_response.rb +3 -5
data/lib/rturk/parsers/responses/register_hit_type_response.rb +17 -0
data/lib/rturk/parsers/responses/search_hits_response.rb +65 -0
data/lib/rturk/xml_utilities.rb +14 -3
data/rturk.gemspec +112 -12
data/spec/adapters/hit_spec.rb +10 -0
data/spec/fake_responses/register_hit_type.xml +6 -0
data/spec/fake_responses/search_hits.xml +50 -0
data/spec/operations/create_hit_spec.rb +2 -2
data/spec/operations/get_hit_spec.rb +1 -1
data/spec/operations/register_hit_type_spec.rb +24 -0
data/spec/{adapters/answers_spec.rb → parsers/answer_parser_spec.rb} +2 -2
data/spec/parsers/hit_parser_spec.rb +41 -0
data/spec/xml_parse_spec.rb +2 -2
metadata +111 -11
data/lib/rturk/adapters/answers.rb +0 -38

data/aws_docs/ApiReference_UnblockWorkerOperation.html ADDED Viewed

@@ -0,0 +1,67 @@
+<html xmlns:fo="http://www.w3.org/1999/XSL/Format"><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>UnblockWorker</title><link rel="stylesheet" href="aws-docs-IE.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><link rel="home" href="#top" title="Amazon Mechanical Turk"><link rel="up" href="ApiReference_OperationsArticle.html" title="Chapter&nbsp;5.&nbsp;Operations"><link rel="prev" href="ApiReference_SetHITTypeNotificationOperation.html" title="SetHITTypeNotification"><link rel="next" href="ApiReference_UpdateQualificationScoreOperation.html" title="UpdateQualificationScore"><!--[if !IE]>--><link rel="stylesheet" href="aws-docs.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><!--<![endif]--><meta xmlns="http://www.w3.org/1999/xhtml" http-equiv="Content-Type" content="text/html; charset=utf-8"></meta><script src="/urchin.js" type="text/javascript"></script><script type="text/javascript">
+				urchinTracker();
+			</script><script xmlns="http://www.w3.org/1999/xhtml" type="text/javascript" src="frameset.js"> //
+		</script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="ApiReference_SetHITTypeNotificationOperation.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_UnblockWorkerOperation">Documentation Feedback</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_UpdateQualificationScoreOperation.html"><img src="images/next.gif" alt="Next"></a></td></tr></table><div class="breadcrumb"><a href="Welcome.html">Welcome</a><a href=""></a> &raquo; <a href="ApiReference_OperationsArticle.html">Operations</a> &raquo; <strong>UnblockWorker</strong></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h1 class="topictitle">UnblockWorker</h1></div></div></div><a class="indexterm" name="d0e12705"></a><a class="indexterm" name="d0e12708"></a><a class="indexterm" name="d0e12713"></a><a class="indexterm" name="d0e12718"></a><a class="indexterm" name="d0e12721"></a><a class="indexterm" name="d0e12726"></a><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e12731">Description</h2></div></div></div><p> The <code class="function">UnblockWorker</code> operation allows you to reinstate a blocked
+			Worker to work on your HITs. This operation reverses the effects of the <a class="link" href="ApiReference_BlockWorkerOperation.html" title="BlockWorker">BlockWorker</a> operation. </p><p> You need the Worker ID to use this operation. If the Worker ID is missing or invalid,
+			this operation fails and returns the message &#8220;WorkerId is invalid.&#8221; If the specified
+			Worker is not blocked, this operation returns successfully. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e12744">Request Parameters</h2></div></div></div><p> The <code class="function">UnblockWorker</code> operation accepts parameters common to all
+			operations. Some common parameters are required. See <a class="link" href="ApiReference_CommonParametersArticle.html" title="Chapter&nbsp;4.&nbsp;Common Parameters">Common Parameters</a> for more
+			information. </p><p> The following parameters are specific to the <code class="function">UnblockWorker</code>
+			operation: </p><div class="informaltable"><table cellspacing="0" border="0"><colgroup><col><col><col></colgroup><thead><tr><th>Name</th><th>Description</th><th>Required</th></tr></thead><tbody><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>Operation</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">The name of the operation</p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Valid Values: UnblockWorker</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">Yes</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>WorkerId</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">The ID of the Worker to unblock.</p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">Yes</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>Reason</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> A message that explains the reason for unblocking the Worker.
+								The Worker does not see this message. </p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr></tbody></table></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e12852">Response Elements</h2></div></div></div><p> A successful request for the <code class="function">UnblockWorker</code> operation returns
+			with no errors. The response includes the elements described in the following table. The
+			operation returns no other data. </p><div class="informaltable"><table cellspacing="0" border="0"><colgroup><col><col></colgroup><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>UnblockWorkerResult</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> Contains a <em class="parameter"><code>Request</code></em> element if the
+									<strong class="userinput"><code>Request</code></strong>
+								<em class="parameter"><code>ResposeGroup</code></em> is specified. </p>
+						</td></tr></tbody></table></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e12894">Examples</h2></div></div></div><p>The following example shows how to use the <code class="function">UnblockWorker</code>
+			operation.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title" id="d0e12902">Sample Request</h3></div></div></div><p>The following example unblocks a Worker and allows that Worker to work on your
+					HITs.</p><pre class="programlisting">http://mechanicalturk.amazonaws.com/?Service=AWSMechanicalTurkRequester
+&amp;AWSAccessKeyId=<em class="replaceable"><code>[the Requester's Access Key ID]</code></em>
+&amp;Version=2008-08-02
+&amp;Operation=UnblockWorker
+&amp;Signature=<em class="replaceable"><code>[signature for this request]</code></em>
+&amp;Timestamp=<em class="replaceable"><code>[your system's local time]</code></em>
+&amp;WorkerId=AZ3456EXAMPLE
+         </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title" id="d0e12918">Sample Response</h3></div></div></div><p>The following is an example response.</p><pre class="programlisting">&lt;UnblockWorkerResult&gt;
+  &lt;Request&gt;
+    &lt;IsValid&gt;True&lt;/IsValid&gt;
+  &lt;/Request&gt;
+&lt;/UnblockWorkerResult&gt;</pre></div></div></div><div class="navfooter"><table width="100%" summary="Navigation footer" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="ApiReference_SetHITTypeNotificationOperation.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_UnblockWorkerOperation">Documentation Feedback</a><br><a href="copyrightinfo.html">Copyright Information</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_UpdateQualificationScoreOperation.html"><img src="images/next.gif" alt="Next"></a></td></tr><tr><td width="30%" align="left" valign="top">&nbsp;</td><td width="40%" align="center"><a accesskey="h" href="#top"><img src="images/home.gif" alt="Home"></a></td><td width="30%" align="right" valign="top">&nbsp;</td></tr></table></div></body></html>

data/aws_docs/ApiReference_UpdateQualificationScoreOperation.html ADDED Viewed

@@ -0,0 +1,77 @@
+<html xmlns:fo="http://www.w3.org/1999/XSL/Format"><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>UpdateQualificationScore</title><link rel="stylesheet" href="aws-docs-IE.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><link rel="home" href="#top" title="Amazon Mechanical Turk"><link rel="up" href="ApiReference_OperationsArticle.html" title="Chapter&nbsp;5.&nbsp;Operations"><link rel="prev" href="ApiReference_UnblockWorkerOperation.html" title="UnblockWorker"><link rel="next" href="ApiReference_UpdateQualificationTypeOperation.html" title="UpdateQualificationType"><!--[if !IE]>--><link rel="stylesheet" href="aws-docs.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><!--<![endif]--><meta xmlns="http://www.w3.org/1999/xhtml" http-equiv="Content-Type" content="text/html; charset=utf-8"></meta><script src="/urchin.js" type="text/javascript"></script><script type="text/javascript">
+				urchinTracker();
+			</script><script xmlns="http://www.w3.org/1999/xhtml" type="text/javascript" src="frameset.js"> //
+		</script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="ApiReference_UnblockWorkerOperation.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_UpdateQualificationScoreOperation">Documentation Feedback</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_UpdateQualificationTypeOperation.html"><img src="images/next.gif" alt="Next"></a></td></tr></table><div class="breadcrumb"><a href="Welcome.html">Welcome</a><a href=""></a> &raquo; <a href="ApiReference_OperationsArticle.html">Operations</a> &raquo; <strong>UpdateQualificationScore</strong></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h1 class="topictitle">UpdateQualificationScore</h1></div></div></div><a class="indexterm" name="d0e12929"></a><a class="indexterm" name="d0e12932"></a><a class="indexterm" name="d0e12937"></a><a class="indexterm" name="d0e12940"></a><a class="indexterm" name="d0e12945"></a><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e12950">Description</h2></div></div></div><p> The <code class="function">UpdateQualificationScore</code> operation changes the value of a
+			Qualification previously granted to a Worker. </p><p> Only the owner of a Qualification type can update the score of a Qualification of
+			that type. </p><p> The Worker must have already been granted a Qualification of the given Qualification
+			type before the score can be updated. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e12962">Request Parameters</h2></div></div></div><p> The <code class="function">UpdateQualificationScore</code> operation accepts parameters common
+			to all operations. Some common parameters are required. See <a class="link" href="ApiReference_CommonParametersArticle.html" title="Chapter&nbsp;4.&nbsp;Common Parameters">Common Parameters</a> for more
+			information. </p><p> The following parameters are specific to the <code class="function">UpdateQualificationScore</code> operation: </p><div class="informaltable"><table cellspacing="0" border="0"><colgroup><col><col><col></colgroup><thead><tr><th>Name</th><th>Description</th><th>Required</th></tr></thead><tbody><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>Operation</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">The name of the operation</p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Valid Values: UpdateQualificationScore</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">Yes</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>QualificationTypeId</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> The ID of the Qualification type, as returned by <a class="link" href="ApiReference_CreateQualificationTypeOperation.html" title="CreateQualificationType">CreateQualificationType</a> operation. </p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">Yes</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>SubjectId</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> The ID of the Worker whose Qualification is being updated, as
+								returned by the <a class="link" href="ApiReference_GetAssignmentsForHITOperation.html" title="GetAssignmentsForHIT">GetAssignmentsForHIT</a> operation. </p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">Yes</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>IntegerValue</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">The new value for the Qualification.</p>
+							<p class="simpara">Type: Integer</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">Yes</p>
+						</td></tr></tbody></table></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e13101">Response Elements</h2></div></div></div><p> A successful request for the <code class="function">UpdateQualificationScore</code> operation
+			returns with no errors. The response includes the elements described in the following
+			table. The operation returns no other data. </p><div class="informaltable"><table cellspacing="0" border="0"><colgroup><col><col></colgroup><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>UpdateQualificationScoreResult</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> Contains a <em class="parameter"><code>Request</code></em> element if the
+									<strong class="userinput"><code>Request</code></strong>
+								<em class="parameter"><code>ResposeGroup</code></em> is specified. </p>
+						</td></tr></tbody></table></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e13143">Examples</h2></div></div></div><p>The following example shows how to use the <code class="function">UpdateQualificationScore</code> operation.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title" id="d0e13151">Sample Request</h3></div></div></div><p>The following example changes the value of a Qualification of the specified
+					type for the specified Worker.</p><pre class="programlisting">http://mechanicalturk.amazonaws.com/?Service=AWSMechanicalTurkRequester
+&amp;AWSAccessKeyId=<em class="replaceable"><code>[the Requester's Access Key ID]</code></em>
+&amp;Version=2008-08-02
+&amp;Operation=UpdateQualificationScore
+&amp;Signature=<em class="replaceable"><code>[signature for this request]</code></em>
+&amp;Timestamp=<em class="replaceable"><code>[your system's local time]</code></em>
+&amp;QualificationTypeId=789RVWYBAZW00EXAMPLE
+&amp;SubjectId=AZ3456EXAMPLE
+&amp;IntegerValue=70
+         </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title" id="d0e13167">Sample Response</h3></div></div></div><p>The following is an example response.</p><pre class="programlisting">&lt;UpdateQualificationScoreResult&gt;
+  &lt;Request&gt;
+    &lt;IsValid&gt;True&lt;/IsValid&gt;
+  &lt;/Request&gt;
+&lt;/UpdateQualificationScoreResult&gt;</pre></div></div></div><div class="navfooter"><table width="100%" summary="Navigation footer" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="ApiReference_UnblockWorkerOperation.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_UpdateQualificationScoreOperation">Documentation Feedback</a><br><a href="copyrightinfo.html">Copyright Information</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_UpdateQualificationTypeOperation.html"><img src="images/next.gif" alt="Next"></a></td></tr><tr><td width="30%" align="left" valign="top">&nbsp;</td><td width="40%" align="center"><a accesskey="h" href="#top"><img src="images/home.gif" alt="Home"></a></td><td width="30%" align="right" valign="top">&nbsp;</td></tr></table></div></body></html>

data/aws_docs/ApiReference_UpdateQualificationTypeOperation.html ADDED Viewed

@@ -0,0 +1,180 @@
+<html xmlns:fo="http://www.w3.org/1999/XSL/Format"><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>UpdateQualificationType</title><link rel="stylesheet" href="aws-docs-IE.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><link rel="home" href="#top" title="Amazon Mechanical Turk"><link rel="up" href="ApiReference_OperationsArticle.html" title="Chapter&nbsp;5.&nbsp;Operations"><link rel="prev" href="ApiReference_UpdateQualificationScoreOperation.html" title="UpdateQualificationScore"><link rel="next" href="ApiReference_DataStructuresArticle.html" title="Chapter&nbsp;6.&nbsp;Data Structures"><!--[if !IE]>--><link rel="stylesheet" href="aws-docs.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><!--<![endif]--><meta xmlns="http://www.w3.org/1999/xhtml" http-equiv="Content-Type" content="text/html; charset=utf-8"></meta><script src="/urchin.js" type="text/javascript"></script><script type="text/javascript">
+				urchinTracker();
+			</script><script xmlns="http://www.w3.org/1999/xhtml" type="text/javascript" src="frameset.js"> //
+		</script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="ApiReference_UpdateQualificationScoreOperation.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_UpdateQualificationTypeOperation">Documentation Feedback</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_DataStructuresArticle.html"><img src="images/next.gif" alt="Next"></a></td></tr></table><div class="breadcrumb"><a href="Welcome.html">Welcome</a><a href=""></a> &raquo; <a href="ApiReference_OperationsArticle.html">Operations</a> &raquo; <strong>UpdateQualificationType</strong></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h1 class="topictitle">UpdateQualificationType</h1></div></div></div><a class="indexterm" name="d0e13178"></a><a class="indexterm" name="d0e13181"></a><a class="indexterm" name="d0e13188"></a><a class="indexterm" name="d0e13193"></a><a class="indexterm" name="d0e13198"></a><a class="indexterm" name="d0e13203"></a><a class="indexterm" name="d0e13208"></a><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e13213">Description</h2></div></div></div><p> The <code class="function">UpdateQualificationType</code> operation modifies attributes of an
+			existing Qualification type. </p><p> Most attributes of a Qualification type can be changed after the type has been
+			created. However, the <em class="parameter"><code>Name</code></em> and <em class="parameter"><code>Keywords</code></em>
+			fields cannot be modified. If you create a Qualification type and decide you do want to
+			use it with its name or keywords as they were created, update the type with the
+				<em class="parameter"><code>QualificationTypeStatus</code></em> parameter set to <strong class="userinput"><code>Inactive</code></strong>. Then create a new type using <a class="link" href="ApiReference_CreateQualificationTypeOperation.html" title="CreateQualificationType">CreateQualificationType</a> operation with the desired values. </p><p> You can use this operation to update a the test of a Qualification type. The test is
+			updated based on the values specified for the <em class="parameter"><code>Test</code></em>, <em class="parameter"><code>TestDurationInSeconds</code></em> and <em class="parameter"><code>AnswerKey</code></em> parameters.
+			All three parameters specify the updated test. If you are updating the test for a type,
+			you must specify the <em class="parameter"><code>Test</code></em> and <em class="parameter"><code>TestDurationInSeconds</code></em> parameters. The <em class="parameter"><code>AnswerKey</code></em>
+			parameter is optional; omitting it specifies that the updated test does not have an
+			answer key. </p><p> If you omit the <em class="parameter"><code>Test</code></em> parameter, the test for the Qualification
+			type is unchanged. There is no way to remove a test from a Qualification type that has
+			one. If the type already has a test, you cannot update it to be <em class="parameter"><code>AutoGranted</code></em>. If the Qualification type does not have a test and one is
+			provided by an update, the type will henceforth have a test. </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p> If you want to update the test duration or answer key for an existing test
+				without changing the questions, you must specify a <em class="parameter"><code>Test</code></em>
+				parameter with the original questions, along with the updated values. </p></td></tr></table></div><p> If you provide an <em class="parameter"><code>AnswerKey</code></em> paramter, Amazon Mechanical Turk
+			processes requests for the Qualification automatically, and assigns the Worker a
+			Qualification with a value calculated from the <em class="parameter"><code>AnswerKey</code></em> and the
+			answers submitted by the Worker. </p><p> If you provide an updated <em class="parameter"><code>Test</code></em> but no <em class="parameter"><code>AnswerKey</code></em>, the new test will not have an answer key. Requests for such
+			Qualifications must be granted manually. </p><p> You can also update the <em class="parameter"><code>AutoGranted</code></em> and <em class="parameter"><code>AutoGrantedValue</code></em> attributes of the Qualification type. </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p> A Qualification type cannot be configured with both the <em class="parameter"><code>Test</code></em> parameter specified and the <em class="parameter"><code>AutoGranted</code></em>
+				parameter set to <strong class="userinput"><code>true</code></strong>. Currently, there is no way to remove a
+				test from a Qualification type that has one. A Qualification type with a test cannot
+				be re-configured to use the auto-granting feature. </p></td></tr></table></div><p> Only the owner of a Qualification type can modify its attributes. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e13310">Request Parameters</h2></div></div></div><p> The <code class="function">UpdateQualificationType</code> operation accepts parameters common
+			to all operations. Some common parameters are required. See <a class="link" href="ApiReference_CommonParametersArticle.html" title="Chapter&nbsp;4.&nbsp;Common Parameters">Common Parameters</a> for more
+			information. </p><p> The following parameters are specific to the <code class="function">UpdateQualificationType</code> operation: </p><div class="informaltable"><table cellspacing="0" border="0"><colgroup><col><col><col></colgroup><thead><tr><th>Name</th><th>Description</th><th>Required</th></tr></thead><tbody><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>Operation</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">The name of the operation</p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Valid Values: UpdateQualificationType</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">Yes</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>QualificationTypeId</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">The ID of the Qualification type to update.</p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">Yes</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>RetryDelayInSeconds</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> The amount of time, in seconds, that Workers must wait after
+								requesting a Qualification of the specified Qualification type
+								before they can request it again. </p>
+							<p class="simpara">Type: non-negative integer</p>
+							<p class="simpara">Default: None. If not specified, retries are
+								disabled.</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>QualificationTypeStatus</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">The new status of the Qualification type.</p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Valid Values: Active | Inactive</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>Description</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">The new description of the Qualification type.</p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>Test</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> The questions for a Qualification test a user must answer
+								correctly to obtain a Qualification of this type. </p>
+							<p class="simpara"> Type: a <a class="link" href="ApiReference_QuestionFormDataStructureArticle.html" title="QuestionForm">QuestionForm</a> data structure. </p>
+							<p class="simpara"> Default: None </p>
+							<p class="simpara"> Constraints: Cannot be specified if <em class="parameter"><code>AutoGranted</code></em> is <strong class="userinput"><code>true</code></strong>. If you
+								update the <em class="parameter"><code>AnswerKey</code></em>, you must provide the
+									<em class="parameter"><code>Test</code></em> parameter, even if the test has not
+								changed. If you update the <em class="parameter"><code>TestDurationInSeconds</code></em>, you must provide the
+									<em class="parameter"><code>Test</code></em> parameter, even if the test has not
+								changed. </p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>AnswerKey</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> The answers to the Qualification test specified in the
+									<em class="parameter"><code>Test</code></em> parameter. </p>
+							<p class="simpara">Type: an <a class="link" href="ApiReference_AnswerKeyDataStructureArticle.html" title="AnswerKey">AnswerKey</a> data structure.</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>TestDurationInSeconds</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> The amount of time, in seconds, that a Worker has to complete
+								the Qualification test, starting from when the Worker requested the
+								Qualification. </p>
+							<p class="simpara">Type: positive integer</p>
+							<p class="simpara">Default: None</p>
+							<p class="simpara">Conditions: Required if the <em class="parameter"><code>Test</code></em>
+								parameter is specified.</p>
+						</td><td>
+							<p class="simpara">Conditional</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>AutoGranted</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> Specifies whether requests for the Qualification type will be
+								granted immediately, without prompting the Worker with a
+								Qualification test. </p>
+							<p class="simpara">Type: Boolean</p>
+							<p class="simpara">Valid Values: true | false</p>
+							<p class="simpara">Default: None</p>
+							<p class="simpara">Conditions: Cannot be <strong class="userinput"><code>true</code></strong> if <em class="parameter"><code>Test</code></em> is specified.</p>
+						</td><td>
+							<p class="simpara">Conditional</p>
+						</td></tr><tr><td><p class="simpara"></p>
+							<em class="parameter"><code>AutoGrantedValue</code></em>
+						</td><td>
+							<p class="simpara"> The Qualification value to use if <em class="parameter"><code>AutoGranted</code></em> is <strong class="userinput"><code>true</code></strong>. </p>
+							<p class="simpara">Type: Integer</p>
+							<p class="simpara">Default: 1</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr></tbody></table></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e13648">Response Elements</h2></div></div></div><p> A successful request for the <code class="function">UpdateQualificationType</code> operation
+			has a <em class="parameter"><code>QualificationType</code></em> element in the response, as described in
+			the following table: </p><div class="informaltable"><table cellspacing="0" border="0"><colgroup><col><col></colgroup><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>QualficationType</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> Contains a <a class="link" href="ApiReference_QualificationTypeDataStructureArticle.html" title="QualificationType">QualificationType</a> data strucure. </p>
+							<p class="simpara"> Type: a <a class="link" href="ApiReference_QualificationTypeDataStructureArticle.html" title="QualificationType">QualificationType</a> data structure </p>
+						</td></tr></tbody></table></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e13693">Examples</h2></div></div></div><p>The following example shows how to use the <code class="function">UpdateQualificationType</code> operation.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title" id="d0e13701">Sample Request</h3></div></div></div><p> The following example changes the <em class="parameter"><code>QualificationTypeStatus</code></em> of a Qualification type. </p><pre class="programlisting">http://mechanicalturk.amazonaws.com/?Service=AWSMechanicalTurkRequester
+&amp;AWSAccessKeyId=<em class="replaceable"><code>[the Requester's Access Key ID]</code></em>
+&amp;Version=2008-08-02
+&amp;Operation=UpdateQualificationType
+&amp;Signature=<em class="replaceable"><code>[signature for this request]</code></em>
+&amp;Timestamp=<em class="replaceable"><code>[your system's local time]</code></em>
+&amp;QualificationTypeId=789RVWYBAZW00EXAMPLE
+&amp;QualificationTypeStatus=Inactive
+         </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title" id="d0e13720">Sample Response</h3></div></div></div><p>The following is an example response.</p><pre class="programlisting">&lt;UpdateQualificationTypeResult&gt;
+  &lt;Request&gt;
+    &lt;IsValid&gt;True&lt;/IsValid&gt;
+  &lt;/Request&gt;
+  &lt;QualificationType&gt;
+    &lt;QualificationTypeId&gt;789RVWYBAZW00EXAMPLE&lt;/QualificationTypeId&gt;
+    &lt;CreationTime&gt;2009-06-15T12:00:01Z&lt;/CreationTime&gt;
+    &lt;Name&gt;EnglishWritingAbility&lt;/Name&gt;
+    &lt;Description&gt;The ability to write and edit text...&lt;/Description&gt;
+    &lt;Keywords&gt;English, text, write, edit, language&lt;/Keywords&gt;
+    &lt;QualificationTypeStatus&gt;Active&lt;/QualificationTypeStatus&gt;
+    &lt;RetryDelayInSeconds&gt;86400&lt;/RetryDelayInSeconds&gt;
+    &lt;IsRequestable&gt;true&lt;/IsRequestable&gt;
+  &lt;/QualificationType&gt;
+&lt;/UpdateQualificationTypeResult&gt;</pre></div></div></div><div class="navfooter"><table width="100%" summary="Navigation footer" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="ApiReference_UpdateQualificationScoreOperation.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_UpdateQualificationTypeOperation">Documentation Feedback</a><br><a href="copyrightinfo.html">Copyright Information</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_DataStructuresArticle.html"><img src="images/next.gif" alt="Next"></a></td></tr><tr><td width="30%" align="left" valign="top">&nbsp;</td><td width="40%" align="center"><a accesskey="h" href="#top"><img src="images/home.gif" alt="Home"></a></td><td width="30%" align="right" valign="top">&nbsp;</td></tr></table></div></body></html>

data/aws_docs/ApiReference_WsdlLocationArticle.html ADDED Viewed

@@ -0,0 +1,95 @@
+<html xmlns:fo="http://www.w3.org/1999/XSL/Format"><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Chapter&nbsp;3.&nbsp;WSDL and Schema Locations</title><link rel="stylesheet" href="aws-docs-IE.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><link rel="home" href="#top" title="Amazon Mechanical Turk"><link rel="up" href="#top" title="Amazon Mechanical Turk"><link rel="prev" href="WhatsNew.html" title="Chapter&nbsp;2.&nbsp;What's New"><link rel="next" href="ApiReference_CommonParametersArticle.html" title="Chapter&nbsp;4.&nbsp;Common Parameters"><!--[if !IE]>--><link rel="stylesheet" href="aws-docs.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><!--<![endif]--><meta xmlns="http://www.w3.org/1999/xhtml" http-equiv="Content-Type" content="text/html; charset=utf-8"></meta><script src="/urchin.js" type="text/javascript"></script><script type="text/javascript">
+				urchinTracker();
+			</script><script xmlns="http://www.w3.org/1999/xhtml" type="text/javascript" src="frameset.js"> //
+		</script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="WhatsNew.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_WsdlLocationArticle">Documentation Feedback</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_CommonParametersArticle.html"><img src="images/next.gif" alt="Next"></a></td></tr></table><div class="breadcrumb"><a href="Welcome.html">Welcome</a><a href=""></a> &raquo; <strong>WSDL and Schema Locations</strong></div></div><div class="chapter" lang="en" id="ApiReference_WsdlLocationArticle"><div class="titlepage"><div><div><h1 class="topictitle">WSDL and Schema Locations</h1></div></div></div><a class="indexterm" name="d0e384"></a><a class="indexterm" name="d0e387"></a><a class="indexterm" name="d0e390"></a><a class="indexterm" name="d0e395"></a><a class="indexterm" name="d0e400"></a><a class="indexterm" name="d0e403"></a><div class="highlights"><p><strong>Topics</strong></p><ul><li><a href="ApiReference_WsdlLocationArticle.html#d0e460">The WSDL and Message Schema Locations</a></li><li><a href="ApiReference_WsdlLocationArticle.html#d0e483">The Data Structure Schema Locations</a></li><li><a href="ApiReference_WsdlLocationArticle.html#d0e560">The Formatted Content XHTML Subset</a></li><li><a href="ApiReference_WsdlLocationArticle.html#d0e597">The Notifications Receptor WSDL Location</a></li><li><a href="ApiReference_WsdlLocationArticle.html#d0e619">Service API Versions</a></li><li><a href="ApiReference_WsdlLocationArticle.html#d0e647">Accessing a Specific Service Version</a></li><li><a href="ApiReference_WsdlLocationArticle.html#d0e672">The Default Version</a></li></ul></div><p> The Amazon Mechanical Turk Service can be accessed using the SOAP web services messaging protocol, or
+		using the REST method of HTTP requests with parameters. The SOAP interface is described by a Web
+		Services Description Language (WSDL) document. REST requests return messages that conform to an XML
+		Schema document. </p><p> To make it easy to upgrade your application when a new version of schemas are released, all schemas
+		have a version number. The version number appears in the URL of a schema file, and in a schema's
+		target namespace. The API schemas (the WSDL and request/response messages) and the data structure
+		schemas (question and answer values) use separate version numbers. The latest versions are as follows: </p><div class="informaltable"><table cellspacing="0" border="0"><colgroup><col><col></colgroup><thead><tr><th> Type of Schema </th><th> Latest Version </th></tr></thead><tbody><tr><td> The API: WSDL and message schemas </td><td>
+						<strong class="userinput"><code>2008-08-02</code></strong>
+					</td></tr><tr><td> The QuestionForm, QuestionFormAnswers and AnswerKey schemas </td><td>
+						<strong class="userinput"><code>2005-10-01</code></strong>
+					</td></tr><tr><td> The ExternalQuestion schema </td><td>
+						<strong class="userinput"><code>2006-07-14</code></strong>
+					</td></tr><tr><td> The formatted content XHTML subset </td><td>
+						<strong class="userinput"><code>2006-07-14</code></strong>
+					</td></tr><tr><td> The notifications receptor API </td><td>
+						<strong class="userinput"><code>2006-05-05</code></strong>
+					</td></tr></tbody></table></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e460">The WSDL and Message Schema Locations</h2></div></div></div><p> The WSDL for a given version of the Amazon Mechanical Turk Service API can be found at a URL that
+			corresponds to the API version. For example, the WSDL for the
+			<strong class="userinput"><code>2008-08-02</code></strong> version of the API can be found here: </p><p>
+			<a class="ulink" href="http://mechanicalturk.amazonaws.com/AWSMechanicalTurk/2008-08-02/AWSMechanicalTurkRequester.wsdl" target="_blank">http://mechanicalturk.amazonaws.com/AWSMechanicalTurk/2008-08-02/AWSMechanicalTurkRequester.wsdl</a>
+		</p><p> The XML Schema for the messages of a given version of the Amazon Mechanical Turk Service API can be
+			found at a URL that corresponds to the API version. For example, the XML Schema for the
+				<strong class="userinput"><code>2008-08-02</code></strong> version of the API can be found here: </p><p>
+			<a class="ulink" href="http://mechanicalturk.amazonaws.com/AWSMechanicalTurk/2008-08-02/AWSMechanicalTurkRequester.xsd" target="_blank">http://mechanicalturk.amazonaws.com/AWSMechanicalTurk/2008-08-02/AWSMechanicalTurkRequester.xsd</a>
+		</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e483">The Data Structure Schema Locations</h2></div></div></div><a class="indexterm" name="d0e486"></a><p> The Amazon Mechanical Turk Service has several parameters and return values that contain XML data. The
+			XML content must validate against the appropriate XML schema. For more information, see <a class="link" href="ApiReference_QuestionFormDataStructureArticle.html" title="QuestionForm">QuestionForm</a>, <a class="link" href="ApiReference_QuestionFormAnswersDataStructureArticle.html" title="QuestionFormAnswers">QuestionFormAnswers</a>, and <a class="link" href="ApiReference_AnswerKeyDataStructureArticle.html" title="AnswerKey">AnswerKey</a>. </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p> The API version number and the data structure version number are not related. The two sets
+				of schemas may have new releases at different times, and may have different version numbers.
+				For example, an application using the <strong class="userinput"><code>2008-08-02</code></strong> version of the
+				API may create HITs using the <strong class="userinput"><code>2005-10-01</code></strong> version of the QuestionForm
+				schema. (There may not be a "2008-08-02" version of the QuestionForm
+				schema.) </p><p> Your application may use any supported version of the data schemas with any supported
+				version of the API. A data structure returned by the service will include a namespace that
+				corresponds to the relevant schema. </p></td></tr></table></div><p> The <strong class="userinput"><code>2005-10-01</code></strong> version of the QuestionForm schema can be found here: </p><p>
+			<a class="ulink" href="http://mechanicalturk.amazonaws.com/AWSMechanicalTurkDataSchemas/2005-10-01/QuestionForm.xsd" target="_blank">http://mechanicalturk.amazonaws.com/AWSMechanicalTurkDataSchemas/2005-10-01/QuestionForm.xsd</a>
+		</p><p> The <strong class="userinput"><code>2005-10-01</code></strong> version of the QuestionFormAnswers schema can be found
+			here: </p><p>
+			<a class="ulink" href="http://mechanicalturk.amazonaws.com/AWSMechanicalTurkDataSchemas/2005-10-01/QuestionFormAnswers.xsd" target="_blank">http://mechanicalturk.amazonaws.com/AWSMechanicalTurkDataSchemas/2005-10-01/QuestionFormAnswers.xsd</a>
+		</p><p> The <strong class="userinput"><code>2005-10-01</code></strong> version of the AnswerKey schema can be found here: </p><p>
+			<a class="ulink" href="http://mechanicalturk.amazonaws.com/AWSMechanicalTurkDataSchemas/2005-10-01/AnswerKey.xsd" target="_blank">http://mechanicalturk.amazonaws.com/AWSMechanicalTurkDataSchemas/2005-10-01/AnswerKey.xsd</a>
+		</p><p> The <strong class="userinput"><code>2006-07-14</code></strong> version of the ExternalQuestion schema can be found here: </p><p>
+			<a class="ulink" href="http://mechanicalturk.amazonaws.com/AWSMechanicalTurkDataSchemas/2006-07-14/ExternalQuestion.xsd" target="_blank">http://mechanicalturk.amazonaws.com/AWSMechanicalTurkDataSchemas/2006-07-14/ExternalQuestion.xsd</a>
+		</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p> To conform to a schema, XML content must use namespace declarations that match the target
+				namespace for the schema. The target namespace is declared at the top of the schema, as the
+				"targetNamespace" attribute of the "xs:schema" element. </p><p> The schemas for QuestionForm, QuestionFormAnswers, and AnswerKey use namespace URIs similar
+				to the URL at which the schema file can be found, including the service version. For example: </p><pre class="programlisting">&lt;QuestionForm
+  xmlns="http://mechanicalturk.amazonaws.com/AWSMechanicalTurkDataSchemas/2005-10-01/QuestionForm.xsd"
+  &gt;
+    <em class="replaceable"><code>[...]</code></em>
+&lt;/QuestionForm&gt;</pre><p> If the service returns an error message about data not validating against the schema, make
+				sure your namespace declaration matches the target namespace specified in the schema. </p></td></tr></table></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e560">The Formatted Content XHTML Subset</h2></div></div></div><a class="indexterm" name="d0e563"></a><a class="indexterm" name="d0e566"></a><a class="indexterm" name="d0e569"></a><a class="indexterm" name="d0e572"></a><p> HITs and Qualification tests can include blocks of content formatted with XHTML tags in their
+			instructions and question data. To include text and markup for formatted content in a web service
+			request, you specify it as XML CDATA inside a <em class="parameter"><code>FormattedContent</code></em> element,
+			part of <a class="link" href="ApiReference_QuestionFormDataStructureArticle.html" title="QuestionForm">the QuestionForm data
+				structure</a>. </p><p> Amazon Mechanical Turk validates formatted content by converting the text and markup in the
+			CDATA block into an XML document, then validating it against a schema. For more information about
+			how this XML document is produced, see <a class="link" href="ApiReference_FormattedContentXHTMLArticle.html" title="Formatted Content: XHTML">Formatted Content: XHTML</a>, "How XHTML Formatted Content Is
+			Validated". </p><p> The <strong class="userinput"><code>2006-07-14</code></strong> version of the schema used to validate formatted content
+			can be found here: </p><p>
+			<a class="ulink" href="http://mechanicalturk.amazonaws.com/AWSMechanicalTurkDataSchemas/2006-07-14/FormattedContentXHTMLSubset.xsd" target="_blank">http://mechanicalturk.amazonaws.com/AWSMechanicalTurkDataSchemas/2006-07-14/FormattedContentXHTMLSubset.xsd</a>
+		</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e597">The Notifications Receptor WSDL Location</h2></div></div></div><a class="indexterm" name="d0e600"></a><a class="indexterm" name="d0e605"></a><p> The WSDL for the notification receptor API is located here: </p><p>
+			<a class="ulink" href="http://mechanicalturk.amazonaws.com/AWSMechanicalTurk/2006-05-05/AWSMechanicalTurkRequesterNotification.wsdl" target="_blank">http://mechanicalturk.amazonaws.com/AWSMechanicalTurk/2006-05-05/AWSMechanicalTurkRequesterNotification.wsdl</a>
+		</p><p> For more information about building a notification receptor web service, see <a class="link" href="ApiReference_NotificationReceptorAPIArticle.html" title="Chapter&nbsp;8.&nbsp;The Notification Receptor API">The Notification Receptor API</a>. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e619">Service API Versions</h2></div></div></div><p> When a new version of the service API is released, previous versions are supported for a
+			limited time to allow applications to continue to function until they are upgraded. The version of
+			a service API is specified as a date, such as <strong class="userinput"><code>2008-08-02</code></strong>. </p><p> The version of the API can be found in the URLs of the WSDL and schema files. It can also be
+			found in the <em class="parameter"><code>targetNamespace</code></em> of the WSDL and schema files. </p><p> You can retrieve the WSDL or schema files for previous versions of the API by replacing the
+			version date in the URL with the desired version. For example, to retrieve the WSDL for API
+			version <strong class="userinput"><code>2008-08-02</code></strong>: </p><p>
+			<a class="ulink" href="http://mechanicalturk.amazonaws.com/AWSMechanicalTurk/2008-08-02/AWSMechanicalTurkRequester.wsdl" target="_blank">http://mechanicalturk.amazonaws.com/AWSMechanicalTurk/2008-08-02/AWSMechanicalTurkRequester.wsdl</a>
+		</p><p> For information about which versions of the API are supported, visit the Amazon Web Services
+			web site at <a class="ulink" href="http://aws.amazon.com/mturk" target="_blank">http://aws.amazon.com/mturk</a>. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e647">Accessing a Specific Service Version</h2></div></div></div><p> For your application to use a specific version of the service API, the service needs to be told
+			which version is being used with each request. </p><p> For SOAP requests, the Amazon Mechanical Turk Service determines which API version you are using based
+			on the namespace in your request message, which is determined by the WSDL you are using with your
+			application. SOAP requests always include this information, and SOAP toolkits determine the
+			namespace automatically from the WSDL. </p><p> For REST requests, you must explicitly request the version to use by including the
+				<em class="parameter"><code>Version</code></em> parameter in your request. The <em class="parameter"><code>Version</code></em>
+			parameter ensures that the service does not return response elements that your application is not
+			designed to handle. </p><p> Here is an example REST request that includes the <em class="parameter"><code>Version</code></em> parameter: </p><pre class="programlisting">http://mechanicalturk.amazonaws.com/?Service=AWSMechanicalTurkRequester
+&amp;AWSAccessKeyId=<em class="replaceable"><code>[the Requester's Access Key ID]</code></em>
+&amp;Version=2008-08-02
+&amp;Operation=GetHIT
+&amp;HITId=123RVWYBAZW00EXAMPLE</pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e672">The Default Version</h2></div></div></div><p> Older AWS services supported requests that did not specify an API version. This behavior is
+			still supported for legacy reasons, but its use is discouraged. </p><p> When the Amazon Mechanical Turk Service receives a REST request without a
+			<em class="parameter"><code>Version</code></em> parameter, the service will use the latest version. If your
+			application does not specify the <em class="parameter"><code>Version</code></em> in each request, when a new
+			version of the API is released, your application will start using the new version automatically.
+			Because new versions of the API may be incompatible with applications expecting to use an older
+			version, specifying an explicit <em class="parameter"><code>Version</code></em> parameter with each request is
+			strongly recommended. </p><p> A similar legacy feature exists for SOAP: A request for the WSDL or a schema file using a URL
+			that does not include the version number will return the file for the latest version of the API.
+			Using WSDL/schema URLs that include the API version number is strongly recommended. </p></div></div><div class="navfooter"><table width="100%" summary="Navigation footer" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="WhatsNew.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_WsdlLocationArticle">Documentation Feedback</a><br><a href="copyrightinfo.html">Copyright Information</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_CommonParametersArticle.html"><img src="images/next.gif" alt="Next"></a></td></tr><tr><td width="30%" align="left" valign="top">&nbsp;</td><td width="40%" align="center"><a accesskey="h" href="#top"><img src="images/home.gif" alt="Home"></a></td><td width="30%" align="right" valign="top">&nbsp;</td></tr></table></div></body></html>

data/aws_docs/ApiReference_XMLParameterValuesArticle.html ADDED Viewed

@@ -0,0 +1,37 @@
+<html xmlns:fo="http://www.w3.org/1999/XSL/Format"><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Using XML Parameter Values</title><link rel="stylesheet" href="aws-docs-IE.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><link rel="home" href="#top" title="Amazon Mechanical Turk"><link rel="up" href="ApiReference_QuestionAnswerDataArticle.html" title="Chapter&nbsp;7.&nbsp;Question and Answer Data"><link rel="prev" href="ApiReference_QuestionAnswerDataArticle.html" title="Chapter&nbsp;7.&nbsp;Question and Answer Data"><link rel="next" href="ApiReference_QuestionFormDataStructureArticle.html" title="QuestionForm"><!--[if !IE]>--><link rel="stylesheet" href="aws-docs.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><!--<![endif]--><meta xmlns="http://www.w3.org/1999/xhtml" http-equiv="Content-Type" content="text/html; charset=utf-8"></meta><script src="/urchin.js" type="text/javascript"></script><script type="text/javascript">
+				urchinTracker();
+			</script><script xmlns="http://www.w3.org/1999/xhtml" type="text/javascript" src="frameset.js"> //
+		</script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="ApiReference_QuestionAnswerDataArticle.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_XMLParameterValuesArticle">Documentation Feedback</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_QuestionFormDataStructureArticle.html"><img src="images/next.gif" alt="Next"></a></td></tr></table><div class="breadcrumb"><a href="Welcome.html">Welcome</a><a href=""></a> &raquo; <a href="ApiReference_QuestionAnswerDataArticle.html">Question and Answer Data</a> &raquo; <strong>Using XML Parameter Values</strong></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h1 class="topictitle">Using XML Parameter Values</h1></div></div></div><a class="indexterm" name="d0e16918"></a><a class="indexterm" name="d0e16921"></a><p> The <a class="link" href="ApiReference_QuestionFormDataStructureArticle.html" title="QuestionForm">QuestionForm</a>, <a class="link" href="ApiReference_QuestionFormAnswersDataStructureArticle.html" title="QuestionFormAnswers">QuestionFormAnswers</a>, and
+			<a class="link" href="ApiReference_AnswerKeyDataStructureArticle.html" title="AnswerKey">AnswerKey</a> data structures are
+		used as parameter values in service requests, and as return values in service responses. Unlike other
+		data structures described in this API reference, these XML structures are not part of the service API
+		directly, but rather are used as string values going in and out of the service. This article describes
+		the encoding methods needed to use XML data as parameter and return values. </p><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e16935">XML Data as a Parameter</h2></div></div></div><p> For SOAP requests, XML data in a parameter value must appear in the request <span class="emphasis"><em>XML
+				escaped</em></span>. Characters that are part of XML syntax, such as ampersands
+				(<strong class="userinput"><code>&amp;</code></strong>) and angle brackets
+			(<strong class="userinput"><code>&lt;&gt;</code></strong>), must be replaced with the corresponding XML character
+			entities in the parameter value. Most SOAP toolkits will automatically escape data set as the
+			string value of the parameter. </p><p> The following is a fragment of a <em class="parameter"><code>QuestionForm</code></em> data structure, escaped
+			with XML character entities: </p><pre class="programlisting">&amp;lt;QuestionForm xmlns="..."&amp;gt;
+  &amp;lt;Overview&amp;gt;
+    &amp;lt;Text&amp;gt;
+      Musicals by Rodgers &amp;amp;amp; Hart...
+    &amp;lt;/Text&amp;gt;
+  &amp;lt;Overview&amp;gt;
+  ...
+&amp;lt;/QuestionForm&amp;gt;</pre><p> For REST requests, the data must be <span class="emphasis"><em>URL encoded</em></span> to appear as a single
+			parameter value in the request. (This is true for all REST parameter values.) Characters that are
+			part of URL syntax, such as question marks (<strong class="userinput"><code>?</code></strong>) and ampersands
+				(<strong class="userinput"><code>&amp;</code></strong>), must be replaced with the corresponding URL character
+			codes. </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p> XML data in REST requests should only be URL encoded, <span class="emphasis"><em>not</em></span> XML escaped.
+			</p></td></tr></table></div><p> In service responses, this data will be XML escaped. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e16975">Namespaces for XML Parameter Values</h2></div></div></div><p> XML data in parameter values must have a namespace specified for all elements. The easiest way
+			to do this is to include an <code class="code">xmlns</code> attribute in the root element equal to the
+			appropriate namespace. </p><p> The namespace for a <em class="parameter"><code>QuestionForm</code></em>,
+			<em class="parameter"><code>QuestionFormAnswers</code></em>, or <em class="parameter"><code>AnswerKey</code></em> element is
+			identical to the URL of the corresponding schema document, including the version date. While XML
+			namespaces need not be URLs according to the XML specification, this convention ensures that the
+			consumer of the value knows which version of the schema is being used for the data. </p><p> For the locations of the schema documents, as well as instructions on how to include the
+			version date in the URL, see <a class="link" href="ApiReference_WsdlLocationArticle.html" title="Chapter&nbsp;3.&nbsp;WSDL and Schema Locations">WSDL and Schema
+				Locations</a>. </p></div></div><div class="navfooter"><table width="100%" summary="Navigation footer" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="ApiReference_QuestionAnswerDataArticle.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_XMLParameterValuesArticle">Documentation Feedback</a><br><a href="copyrightinfo.html">Copyright Information</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_QuestionFormDataStructureArticle.html"><img src="images/next.gif" alt="Next"></a></td></tr><tr><td width="30%" align="left" valign="top">&nbsp;</td><td width="40%" align="center"><a accesskey="h" href="#top"><img src="images/home.gif" alt="Home"></a></td><td width="30%" align="right" valign="top">&nbsp;</td></tr></table></div></body></html>