Version Information

This version includes the Amazon Mechanical Turk SDK for Java version 1.2.2.

This version is compatible with Amazon Mechanical Turk web service version 2007-06-21.

The Amazon Mechanical Turk team would appreciate any comments and feedback on the Command Line Tools. Please submit issues via the Amazon Mechanical Turk discussion forums.

Revision History

Version 1.3.1 - August 23rd, 2012

Version 1.3.0 - April 22nd, 2008

• Fixed: GetResults doesn't return assignment data when the HIT has more than 10 assignments.
• New Feature: Windows installer for installing the CLT and setting up access keys
• New Feature: the makeTemplate operation allows you to easily copy a sample and modify it as your own
• New Feature: the image categorization sample and website filtering sample allow you to generate a result report to easily digest the results
• New Feature: the .results file now includes links to manage the HITs in requester.mturk.com
• New Feature: new statistics are displayed when running GetResults

Version 1.2.1 - February 16th, 2008

• Fixed: 1889820 Change updateHITs -input parameter to -success file
• Fixed: 1889783 Copyright information is incorrect in script files

Version 1.2.0 - February 6th, 2008

• New Feature: 1816696 Update CLT to use New version of MTurk SDK
• New Feature: 1826391 Add multi-threading features to speed up operations
• New Feature: 1823722 Add Image Categorization sample to samples directory
• New Feature: 1823715 Add Image Tagging sample to samples
• New Feature: 1826393 Support for CSV file format
• New Feature: 1834851 Change mturk.properties so that production is the default
• New Feature: 1826400 All methods should have a -sandbox parameter
• New Feature: 1836091 always override .success and .results files
• New Feature: 1836090 approveAndDelete should show a count relative to its total
• New Feature: 1836088 users shouldn\'t have to type I AM SURE
• New Feature: 1836086 makeTemplate should create template files that use the -label parameter
• New Feature: 1834854 Support New version of FormattedContent.xsd for iframe
• New Feature: 1834853 Add some additional line feeds when outputting the URL
• New Feature: 1834850 invoke.cmd to not output JAVA_HOME errors
• New Feature: 1830205 Site_category example should be renamed to external_hit
• New Feature: 1826929 When operating against the sandbox, reduce # of threads used
• New Feature: 1826272 GetResults should output rows with no assignments
• New Feature: 1824965 Show summary data after calling loadHITs
• New Feature: 1824952 Add template generator scripts for HITs and Qualifications
• New Feature: 1823712 approveWork should take in a .success file
• New Feature: 1823696 getResults should allow for -namevaluepairs parameter
• New Feature: 1816834 Provide -label parameter to loadHITs
• New Feature: 1798417 GetResults: List answers in column format
• New Feature: 1796643 GetResults should output the effective hourly rate
• New Feature: 1838917 Output only the first input field in the .failure file
• New Feature: 1826189 GetResults should show # of assignments/total assignments
• New Feature: 1826170 GetResults should show X of Y when downloading results
• New Feature: 1841320 Need to be able to Reset your Account
• New Feature: 1841321 Need to be able to Extend HITs
• New Feature: 1846591 GetResults should show time elapsed
• New Feature: 1830822 Need Grant Bonus command
• New Feature: 1841321 Need to be able to Extend HITs
• Fixed: 1836092 approveAndDelete failed counter is not accurate
• Fixed: 1831885 The generated .success file is a Unix file even in Windows
• Fixed: 1829772 The invoke script shouldn\'t blindly prepend a package name
• Fixed: 1816806 GetResults has missing columns when value is NULL
• Fixed: 1816703 GetResults: Retrieved HIT number is misleading
• Fixed: 1816701 ApproveWork/RejectWork help does not specify comments
• Fixed: 1816693 Exception when a cell in the input file is empty
• Fixed: 1816692 If approve/reject file have missing comments, op fails
• Fixed: 1846589 Poor error messaging for invalid IDs in the .success

NOTE: In this relesae, the Command Line Tools are configured to work against the production site by default.

Version 1.1.0 patch - October 25th, 2007

• Bug 1819004: Removed Error message when .aws/auth file is not found.

Version 1.1.0 - September 13th, 2007

• New Feature: Added Qualification Management commands allowing you to create and manage qualifications for your HITs.
• New Feature: Added an Update HITs command allowing you to update properties of HITs that are in production.
• New Feature: Added Block Worker and Unblock Worker commands to prevent workers from working on your HITs.
• New Feature: Support for Developer Sandbox throttling. The tools will auto retry requests if the Developer Sandbox throttles your requests.
• New Feature: Updated to use the Java SDK 1.1.1 and Requester WSDL version 2007-06-21.

Version 1.0.1 - June 15th, 2007

• New Feature: When retrieving results, the data is streamed directly to the Results file instead of being cached in memory and written at once. Avoids out of memory errors when retrieving large data sets.
• New Feature: The generated Results file now orders the question/answer pairs based on the order they appear in the QuestionForm instead of being ordered alphabetically.
• New Feature: Progress indicator when results are being retrieved from the system.
• Fixed: Batch operations halt when the first error is encountered instead of skipping and continuing.
• Fixed: Removed some extraneous files from the distribution.

Version 1.0.0 - June 4th, 2007

• New Feature: The URL to the HITs that are loaded via the Command Line Tools is displayed.
• New Feature: User specified logging has been added to aid debugging and reporting issues to Amazon Mechanical Turk.
• New Feature: Command Line Tools supports the Amazon Mechanical Turk Developer Sandbox http://sandbox.mturk.com/.
• New Feature: The Java Standard Edition Runtime Environment 1.5.0 (JRE) for Windows is now included in the distribution to ease installation.
• New Feature: The Amazon Mechanical Turk SDK for Java is now included in the distribution to ease installation.
• New Feature: Added several convenience scripts in sample applications to complete HIT workflow (Create HIT->Get Results->Approve And Delete Assignments).
• Fixed: Retrieving assignments for a HIT over a certain number causes the code to lockup.
• Fixed: -preview of LoadHITs should default to a filename of preview.html and not require -previewfile to be specified.
• Fixed: Time format in Results file should be standard 0-23 hr format instead of 1-24 format.
• Fixed: QuestionForm validation fails when using ExternalQuestion functionality
• Fixed: QuestionForm validation does not validate the XHTML contained in the FormattedContent blocks of the QuestionForm. It will currently ignore content inside FormattedContent blocks.
• Fixed: The ordering of the name/value pairs of the HIT results output file is inconsistent.
• Fixed: When writing the .success and .failure files, it overwrites the file instead of appending.
• Fixed: The .failure file is output if there are no failures. It should only exist if there are errors.

Version 0.9.0 Beta - March 28th, 2007

• Initial release