Bureaucrats, editor, reviewer, Administrators
13,550
edits
Changes
Jump to navigation
Jump to search
{{Mark|Updated with Version 9.5}}: Integers added as valid start and end times.
|-
|{{Code|unknown}}
| The supplied query id is unknown or not available anymore.
→jobs:eval
==jobs:eval==
{| width='100%'
|-
| '''Summary'''
|Schedules the evaluation of the supplied {{Code|$query}} ({{Code|xs:string}}, or of type {{Code|xs:anyURI}}, pointing to a resource), and returns a query id. The query will be queued, and the result will optionally be cached. Queries can be updating. The query can be a URI or a string, and variables Variables and the context items value can be declared via {{Code|$bindings}} (see [[XQuery Module#xquery:eval|xquery:eval]] for more details). The following {{Code|$options}} can be supplied:
* {{Code|cache}}: indicates if the query result will be cached or ignored (default: <code>false</code>):
** The result will be cached in main-memory until it is fetched via [[#jobs:result|jobs:result]], or until {{Option|CACHETIMEOUT}} is exceeded.
==jobs:result==
{{Mark|Updated with Version 9.7:}} Return empty sequence if no result is cached.
{| width='100%'
| '''Summary'''
|Returns the cached result of a job with the specified job {{Code|$id}}:
* If the original job has raised an error, the cached error will be raised instead.
* Results can only be retrieved once. After retrieval, the cached result will be dropped.
* If the original job result has raised an error, the cached error will be raised instead.|-| '''Errors'''|{{Error|running|#Errors}} the job is still running.<br/>{{Error|unknown|#Errors}} the supplied id is unknown: The id is unknownalready been retrieved, or the result if it has already not been retrievedcached, an empty sequence is returned.<br/>
|-
| '''Examples'''
|{{Code|service}}
| Registered services cannot be parsed, added or removed.
|}
=Changelog=
;Version 9.7
* Updated: {{Function|Jobs|jobs:result}}: return empty sequence if no result is cached.
;Version 9.5
