/**
* Find Submission Ids on a Turnitin Assignment.
*
* Takes a {@link TiiSubmission.html TiiSubmission} object containing the required parameters
* and returns a {@link Response.html Response} object containing the data from the response.
*
* findSubmissions accepts:
* <ul>
* <li><b>Assignment Id</b><br />{@link TiiSubmission.html#setAssignmentId TiiSubmission->setAssignmentId( <i>integer</i> AssignmentId )}</li>
* <li><b>Date From</b> (Optional)<br />{@link TiiSubmission.html#setDateFrom TiiSubmission->setDateFrom( <i>string</i> DateFrom )}</li>
* </ul>
* findSubmissions returns a {@link Response.html Response} object which contains a {@link TiiSubmission.html TiiSubmission} object:
* <ul>
* <li>{@link Response.html#setSubmission Response->getSubmission()} returns a {@link TiiSubmission.html TiiSubmission} object</li>
* <ul>
* <li><b>Submission Ids</b> (array)<br />{@link TiiSubmission.html#getSubmissionIds TiiSubmission->getSubmissionIds()}</li>
* </ul>
* </ul>
*
* <h3>Example Code:</h3>
* <pre class="prettyprint lang-perl" style="padding: 12px;">
* $api = new APITurnitin( 1234, 'https://sandbox.turnitin.com', 'mysecret', 16 );
* $submission = new TiiSubmission();
* $submission->setAssignmentId( 1234 );
* $submission->setDateFrom( '2012-09-12T09:00:00Z' );
*
* $response = $api->findSubmissions( $submission );
* $findsubmission = $response->getSubmission();
* $findsubmissionids = $findsubmission->getSubmissionIds();
* </pre>
*
* @param TiiSubmission $submission
* @return Response
*/
public function findSubmissions($submission)
{
$submissionSoap = $this->setOptions(new SubmissionSoap($this->resultwsdl, $this->getServiceOptions('result')));
if (!is_null($submission->getDateFrom())) {
return $submissionSoap->findRecentSubmissions($submission);
} else {
return $submissionSoap->findSubmissions($submission);
}
}
