/** * 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); } }