Source for file AssessmentPublished.php

Documentation is available at AssessmentPublished.php

  1. <?php
  2. /**
  3. * AssessmentPublished includes an Assessment as well as additional data
  4. * relating to the availability of the Assessment.
  5. *
  6. * <p>
  7. * OSID Version: 2.0
  8. * </p>
  9. *
  10. * <p>
  11. * Licensed under the {@link org.osid.SidImplementationLicenseMIT MIT}
  12. * O.K.I&#46; OSID Definition License}.
  13. * </p>
  14. *
  15. * @package org.osid.assessment
  16. */
  17. class AssessmentPublished
  18. {
  19. /**
  20. * Update the display name for this AssessmentPublished.
  21. *
  22. * @param string $displayName
  23. *
  24. * @throws object AssessmentException An exception with one of
  25. * the following messages defined in
  26. * org.osid.assessment.AssessmentException may be thrown: {@link }
  27. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  28. * OPERATION_FAILED}, {@link }
  29. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  30. * PERMISSION_DENIED}, {@link }
  31. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  32. * CONFIGURATION_ERROR}, {@link }
  33. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  34. * UNIMPLEMENTED}, {@link }
  35. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  36. * NULL_ARGUMENT}
  37. *
  38. * @access public
  39. */
  40. function updateDisplayName ( $displayName ) {
  41. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  42. }
  43.  
  44. /**
  45. * Update the description for this AssessmentPublished.
  46. *
  47. * @param string $description
  48. *
  49. * @throws object AssessmentException An exception with one of
  50. * the following messages defined in
  51. * org.osid.assessment.AssessmentException may be thrown: {@link }
  52. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  53. * OPERATION_FAILED}, {@link }
  54. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  55. * PERMISSION_DENIED}, {@link }
  56. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  57. * CONFIGURATION_ERROR}, {@link }
  58. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  59. * UNIMPLEMENTED}, {@link }
  60. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  61. * NULL_ARGUMENT}
  62. *
  63. * @access public
  64. */
  65. function updateDescription ( $description ) {
  66. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  67. }
  68.  
  69. /**
  70. * Set the unique Id of the Assignment associated with this
  71. * AssessmentPublished, if any. The unique Id refers to an object created
  72. * through the Grading OSID.
  73. *
  74. * @param object Id $gradingAssignmentId
  75. *
  76. * @throws object AssessmentException An exception with one of
  77. * the following messages defined in
  78. * org.osid.assessment.AssessmentException may be thrown: {@link }
  79. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  80. * OPERATION_FAILED}, {@link }
  81. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  82. * PERMISSION_DENIED}, {@link }
  83. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  84. * CONFIGURATION_ERROR}, {@link }
  85. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  86. * UNIMPLEMENTED}, {@link }
  87. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  88. * NULL_ARGUMENT}, {@link }
  89. * org.osid.assessment.AssessmentException#UNKNOWN_ID UNKNOWN_ID}
  90. *
  91. * @access public
  92. */
  93. function updateGradingAssignmentId ( $gradingAssignmentId ) {
  94. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  95. }
  96.  
  97. /**
  98. * Set the unique Id of the Course Section associated with this
  99. * AssessmentPublished, if any. The unique Id refers to an object created
  100. * through the CourseManagement OSID.
  101. *
  102. * @param object Id $courseSectionId
  103. *
  104. * @throws object AssessmentException An exception with one of
  105. * the following messages defined in
  106. * org.osid.assessment.AssessmentException may be thrown: {@link }
  107. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  108. * OPERATION_FAILED}, {@link }
  109. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  110. * PERMISSION_DENIED}, {@link }
  111. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  112. * CONFIGURATION_ERROR}, {@link }
  113. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  114. * UNIMPLEMENTED}, {@link }
  115. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  116. * NULL_ARGUMENT}, {@link }
  117. * org.osid.assessment.AssessmentException#UNKNOWN_ID UNKNOWN_ID}
  118. *
  119. * @access public
  120. */
  121. function updateCourseSectionId ( $courseSectionId ) {
  122. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  123. }
  124.  
  125. /**
  126. * Update the data for this AssessmentPublished. The structure of the Data
  127. * is not defined in the OSID. .
  128. *
  129. * @param object mixed $data (original type: java.io.Serializable)
  130. *
  131. * @throws object AssessmentException An exception with one of
  132. * the following messages defined in
  133. * org.osid.assessment.AssessmentException may be thrown: {@link }
  134. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  135. * OPERATION_FAILED}, {@link }
  136. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  137. * PERMISSION_DENIED}, {@link }
  138. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  139. * CONFIGURATION_ERROR}, {@link }
  140. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  141. * UNIMPLEMENTED}, {@link }
  142. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  143. * NULL_ARGUMENT}
  144. *
  145. * @access public
  146. */
  147. function updateData ( $data ) {
  148. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  149. }
  150.  
  151. /**
  152. * Get the display name for this AssessmentPublished.
  153. *
  154. * @return string
  155. *
  156. * @throws object AssessmentException An exception with one of
  157. * the following messages defined in
  158. * org.osid.assessment.AssessmentException may be thrown: {@link }
  159. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  160. * OPERATION_FAILED}, {@link }
  161. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  162. * PERMISSION_DENIED}, {@link }
  163. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  164. * CONFIGURATION_ERROR}, {@link }
  165. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  166. * UNIMPLEMENTED}
  167. *
  168. * @access public
  169. */
  170. function getDisplayName () {
  171. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  172. }
  173.  
  174. /**
  175. * Get the description for this AssessmentPublished.
  176. *
  177. * @return string
  178. *
  179. * @throws object AssessmentException An exception with one of
  180. * the following messages defined in
  181. * org.osid.assessment.AssessmentException may be thrown: {@link }
  182. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  183. * OPERATION_FAILED}, {@link }
  184. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  185. * PERMISSION_DENIED}, {@link }
  186. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  187. * CONFIGURATION_ERROR}, {@link }
  188. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  189. * UNIMPLEMENTED}
  190. *
  191. * @access public
  192. */
  193. function getDescription () {
  194. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  195. }
  196.  
  197. /**
  198. * Get the unique Id for this AssessmentPublished.
  199. *
  200. * @return object Id
  201. *
  202. * @throws object AssessmentException An exception with one of
  203. * the following messages defined in
  204. * org.osid.assessment.AssessmentException may be thrown: {@link }
  205. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  206. * OPERATION_FAILED}, {@link }
  207. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  208. * PERMISSION_DENIED}, {@link }
  209. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  210. * CONFIGURATION_ERROR}, {@link }
  211. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  212. * UNIMPLEMENTED}
  213. *
  214. * @access public
  215. */
  216. function getId () {
  217. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  218. }
  219.  
  220. /**
  221. * Get the date the Assessment was published.
  222. *
  223. * @return int
  224. *
  225. * @throws object AssessmentException An exception with one of
  226. * the following messages defined in
  227. * org.osid.assessment.AssessmentException may be thrown: {@link }
  228. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  229. * OPERATION_FAILED}, {@link }
  230. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  231. * PERMISSION_DENIED}, {@link }
  232. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  233. * CONFIGURATION_ERROR}, {@link }
  234. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  235. * UNIMPLEMENTED}
  236. *
  237. * @access public
  238. */
  239. function getDate () {
  240. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  241. }
  242.  
  243. /**
  244. * Get the Assessment being published.
  245. *
  246. * @return object Assessment
  247. *
  248. * @throws object AssessmentException An exception with one of
  249. * the following messages defined in
  250. * org.osid.assessment.AssessmentException may be thrown: {@link }
  251. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  252. * OPERATION_FAILED}, {@link }
  253. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  254. * PERMISSION_DENIED}, {@link }
  255. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  256. * CONFIGURATION_ERROR}, {@link }
  257. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  258. * UNIMPLEMENTED}
  259. *
  260. * @access public
  261. */
  262. function getAssessment () {
  263. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  264. }
  265.  
  266. /**
  267. * Get the unique Id of the Assignment associated with this
  268. * AssessmentPublished, if any. The unique Id refers to an object created
  269. * through the Grading OSID.
  270. *
  271. * @return object Id
  272. *
  273. * @throws object AssessmentException An exception with one of
  274. * the following messages defined in
  275. * org.osid.assessment.AssessmentException may be thrown: {@link }
  276. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  277. * OPERATION_FAILED}, {@link }
  278. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  279. * PERMISSION_DENIED}, {@link }
  280. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  281. * CONFIGURATION_ERROR}, {@link }
  282. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  283. * UNIMPLEMENTED}
  284. *
  285. * @access public
  286. */
  287. function getGradingAssignmentId () {
  288. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  289. }
  290.  
  291. /**
  292. * Get the unique Id of the Course Section associated with this
  293. * AssessmentPublished, if any. The unique Id refers to an object created
  294. * through the CourseManagement OSID.
  295. *
  296. * @return object Id
  297. *
  298. * @throws object AssessmentException An exception with one of
  299. * the following messages defined in
  300. * org.osid.assessment.AssessmentException may be thrown: {@link }
  301. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  302. * OPERATION_FAILED}, {@link }
  303. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  304. * PERMISSION_DENIED}, {@link }
  305. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  306. * CONFIGURATION_ERROR}, {@link }
  307. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  308. * UNIMPLEMENTED}
  309. *
  310. * @access public
  311. */
  312. function getCourseSectionId () {
  313. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  314. }
  315.  
  316. /**
  317. * Get the Data for this AssessmentPublished. The structure of the Data is
  318. * not defined in the OSID.
  319. *
  320. * @return object mixed (original type: java.io.Serializable)
  321. *
  322. * @throws object AssessmentException An exception with one of
  323. * the following messages defined in
  324. * org.osid.assessment.AssessmentException may be thrown: {@link }
  325. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  326. * OPERATION_FAILED}, {@link }
  327. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  328. * PERMISSION_DENIED}, {@link }
  329. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  330. * CONFIGURATION_ERROR}, {@link }
  331. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  332. * UNIMPLEMENTED}
  333. *
  334. * @access public
  335. */
  336. function getData () {
  337. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  338. }
  339.  
  340. /**
  341. * Create an AssessmentTaken based on an AssessmentPublished and agentId of
  342. * the student.
  343. *
  344. * @param object Id $agentId
  345. *
  346. * @return object AssessmentTaken
  347. *
  348. * @throws object AssessmentException An exception with one of
  349. * the following messages defined in
  350. * org.osid.assessment.AssessmentException may be thrown: {@link }
  351. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  352. * OPERATION_FAILED}, {@link }
  353. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  354. * PERMISSION_DENIED}, {@link }
  355. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  356. * CONFIGURATION_ERROR}, {@link }
  357. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  358. * UNIMPLEMENTED}, {@link }
  359. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  360. * NULL_ARGUMENT}
  361. *
  362. * @access public
  363. */
  364. function createAssessmentTaken ( $agentId ) {
  365. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  366. }
  367.  
  368. /**
  369. * Delete an AssessmentTaken.
  370. *
  371. * @param object Id $assessmentTakenId
  372. *
  373. * @throws object AssessmentException An exception with one of
  374. * the following messages defined in
  375. * org.osid.assessment.AssessmentException may be thrown: {@link }
  376. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  377. * OPERATION_FAILED}, {@link }
  378. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  379. * PERMISSION_DENIED}, {@link }
  380. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  381. * CONFIGURATION_ERROR}, {@link }
  382. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  383. * UNIMPLEMENTED}, {@link }
  384. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  385. * NULL_ARGUMENT}, {@link }
  386. * org.osid.assessment.AssessmentException#UNKNOWN_ID UNKNOWN_ID}
  387. *
  388. * @access public
  389. */
  390. function deleteAssessmentTaken ( $assessmentTakenId ) {
  391. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  392. }
  393.  
  394. /**
  395. * Get all the Assessments taken.
  396. *
  397. * @return object AssessmentTakenIterator
  398. *
  399. * @throws object AssessmentException An exception with one of
  400. * the following messages defined in
  401. * org.osid.assessment.AssessmentException may be thrown: {@link }
  402. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  403. * OPERATION_FAILED}, {@link }
  404. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  405. * PERMISSION_DENIED}, {@link }
  406. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  407. * CONFIGURATION_ERROR}, {@link }
  408. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  409. * UNIMPLEMENTED}
  410. *
  411. * @access public
  412. */
  413. function getAssessmentsTaken () {
  414. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  415. }
  416.  
  417. /**
  418. * Get all the Assessments taken by a specific a student with this agentId.
  419. *
  420. * @param object Id $agentId
  421. *
  422. * @return object AssessmentTakenIterator
  423. *
  424. * @throws object AssessmentException An exception with one of
  425. * the following messages defined in
  426. * org.osid.assessment.AssessmentException may be thrown: {@link }
  427. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  428. * OPERATION_FAILED}, {@link }
  429. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  430. * PERMISSION_DENIED}, {@link }
  431. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  432. * CONFIGURATION_ERROR}, {@link }
  433. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  434. * UNIMPLEMENTED}
  435. *
  436. * @access public
  437. */
  438. function getAssessmentsTakenBy ( $agentId ) {
  439. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  440. }
  441.  
  442. /**
  443. * Get all the Evaluations for this Item.
  444. *
  445. * @return object EvaluationIterator
  446. *
  447. * @throws object AssessmentException An exception with one of
  448. * the following messages defined in
  449. * org.osid.assessment.AssessmentException may be thrown: {@link }
  450. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  451. * OPERATION_FAILED}, {@link }
  452. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  453. * PERMISSION_DENIED}, {@link }
  454. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  455. * CONFIGURATION_ERROR}, {@link }
  456. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  457. * UNIMPLEMENTED}
  458. *
  459. * @access public
  460. */
  461. function getEvaluations () {
  462. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  463. }
  464.  
  465. /**
  466. * Get the Evaluations of the specified Type for this Assessment.
  467. *
  468. * @param object Type $evaluationType
  469. *
  470. * @return object EvaluationIterator
  471. *
  472. * @throws object AssessmentException An exception with one of
  473. * the following messages defined in
  474. * org.osid.assessment.AssessmentException may be thrown: {@link }
  475. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  476. * OPERATION_FAILED}, {@link }
  477. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  478. * PERMISSION_DENIED}, {@link }
  479. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  480. * CONFIGURATION_ERROR}, {@link }
  481. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  482. * UNIMPLEMENTED}, {@link }
  483. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  484. * NULL_ARGUMENT}, {@link }
  485. * org.osid.assessment.AssessmentException#UNKNOWN_TYPE
  486. * UNKNOWN_TYPE}
  487. *
  488. * @access public
  489. */
  490. function getEvaluationsByType ( $evaluationType ) {
  491. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  492. }
  493. }
  494.  
  495. ?>

Documentation generated on Wed, 19 Sep 2007 10:21:33 -0400 by phpDocumentor 1.3.0RC3