--- loncom/html/adm/help/tex/Problem_LON-CAPA_Functions.tex 2013/08/18 01:40:23 1.25 +++ loncom/html/adm/help/tex/Problem_LON-CAPA_Functions.tex 2014/06/12 14:44:27 1.28 @@ -141,7 +141,7 @@ Option 1 - \&map(\$seed,[$\backslash$\$w epoch (UTC), which can be used in calculations.\\ \hline -\&submission(\$partid,\$responseid,\$version) & Returns what the student submitted for response \$responseid in part \$partid. You can get these IDs from the XML-code of the problem. \$version is optional and returns the \$version-th submission of the student that was graded.\\ +\&submission(\$partid,\$responseid,\$version) & Returns what the student submitted for response \$responseid in part \$partid. You can get these IDs from the XML-code of the problem. Use 0 as \$partid for problems without parts. \$version is optional and returns the \$version-th submission of the student that was graded. If \$version is 0 or ommitted, the latest submission is returned.\\ \hline \¶meter\_setting(\$name,\$partid) & Returns the parameter setting \$name. Partid is optional.\\ @@ -241,12 +241,12 @@ undef @name & To destroy the contents o \hline \end{longtable} -The \&EXT() \index{\&EXT}external function is extremely powerful to access parameters -and submission values and can be -used within scripts and the grading spreadsheet. +The \&EXT() \index{\&EXT}external function is extremely powerful, and is used to access parameters +and submission values. It can be +used within scripts and also within cell formulas in the grading spreadsheet. Some examples can be found by browsing in the repository to /res/msu/albertel/test/ext\_examples.html. -The \&EXT() function can be used to access many of the same parameters as some of the other functions +The \&EXT() function can be used to obtain values for the same parameters as are retrived by some of the other (newer) helper functions summarized in the table above, such as \&firstname() which is equivalent to \&EXT(`environment.firstname'), -and \¶meter\_setting(\$name,\$partid) is equivalent to \&EXT(`resource.'.\$partid.`.'.\$name) -and the more specialized functions are preferred for clarity of the code. +and \¶meter\_setting(\$name,\$partid) is equivalent to \&EXT(`resource.'.\$partid.`.'.\$name). +In such cases the newer (specialized) functions are preferred to \&EXT() on the basis of ease of use.