Phraseanet integrates a task engine to perform asynchronous operations.
This different tasks are managed by a Scheduler.
Log in to the application with a Phraseanet Administrator account
Launch the Admin interface
Click on the Task Manager item in the left side menu
You will find in the Scheduler context menu list items to start, stop and watch logs of the tasks.
If you want to start and stop the Scheduler automatically, for example in a cron script, you can use KonsoleKommander and find the right command:
bin/console scheduler:start bin/console scheduler:stop bin/console scheduler:state bin/console task:run
For tasks editing, please refer to the Task manager paragraph in the User manual.
This task indexes the datas using the phraseanet_indexer binary.
Indexer requires parameters:
Path to indexer binary
Host: MySQL server hostname / address
Port: MySQL port
Database: MySQL dbname
User: MySQL user
Password: MySQL password
Socket port: socket port to stop the indexer
Default language for thesaurus candidates : Default language for unknown terms inserted in candidates, ex: en
Enable stemming languages : languages for indexing by “stems”, ex: en, fr
The “stemming” (see http://en.wikipedia.org/wiki/Stemming) allows searching different forms of words as plural or conjugation
ex. : searching “running wolf” will match records containing “wolfes run”
Sort records with an empty fields : When searching, records where the field used for sorting is not set can be :
not on result ; in the begining of results ; in the end of results
/usr/local/bin/phraseanet_indexer -h=host \ -P=port \ -b=database \ -u=user \ -p=password \ --socket=13800 \ --default-character-set=utf8 \ -o
This task is required for common Phraseanet use
This task creates sub-definitions (thumbnails, previews and other sub-definitions set in the setup structure).
This task is required for common Phraseanet use
This task writes metadatas inside documents, depending of the configuration you set up.
This task watch a HotFolder and archive its content in a Collection.
For security reasons, you have to write an empty .phrasea.xml file at the root of the HotFolder.
Archive files and their XML description is possible by editing the XML view.
Here is an example of XML configuration to archive .jpg and .tif files associated with their .xml description:
<?xml version="1.0" encoding="UTF-8"?> <tasksettings> ... <files> <file mask="^(.*)\.jpg$" caption="$1.jpg.xml"/> <file mask="^(.*)\.JPG$" caption="$1.JPG.xml"/> <file mask="^(.*)\.tif$" caption="$1.tif.xml"/> <file mask="^(.*)\.TIF$" caption="$1.TIF.xml"/> <file mask="^(.*\.xml)$" caption="$1"/> </files> </tasksettings>
This task will upload your FTP export. It requires the activation of FTP export.
This task fetch data from a remote FTP repository to a local storage. It can be combined with an archive task to fetch datas.
This task manages synchro with others APIs (Youtube, DailyMotion ou Flickr) through the Bridge.
This task performs actions on records from a Phraseanet collection to another. depending of their status or some date fields.
It is intended to move (or delete) records from a Phraseanet collection to another according to dates criteria or Phraseanet status-bits states.
Typically it can be used to automate end licence issues in organizations to avoid the use of some media after an expiration date.
RecordMover execute a list of tasks.
A job search for matching records to criteria (settings “from”) and apply update on these records (settings “to”) or deletion.
The “RecordMover” task has replace a the “Workflow01” task from previous Phraseanet versions because it allows more criteria.
The settings are editable in XML and the interface displays the corresponding XML grammar, the number of records affected by each task (if the task was performed now), and the first 10 affected record-id’s.
A task can be kept “off” during its development : a red cross is visible.
<tasks> lists all the <task>.
A <task> act on a Phraseanet base/Databox (attribute “sbas_id”) and can either update records or delete them (“action” attribute: update OR delete).
A <task> can be named (“name” attribute) so that it name appears in logs.
To execute a <task> it must have the attribute “active =” 1 “”. Use 0 to keep the task off during its development.
A <task> acts on ALL records corresponding to criterias listed in the <from> part of the script.
<type type="RECORD" /> only documents <type type="STORY" /> only stories
<coll compare="=" id="3,5,7" /> records are in collections 3, 5 or 7 <coll compare="!=" id="8,9" /> records are in all collection, except collection 8 or 9
<status mask="1x0xxxx" /> status-bit number 4 is set to 0 AND status-bit number 6 is set 1 (please note sb 0 to 3 are reseved to Phraseanet so the xxxx at the end of attribute <status mask> remain the same)
<text field="City" compare="=" value="Paris"/> value in the City filed is Paris <text field="Author" compare="!=" value="Smith"/> all value in the Author field except Smith
<date direction="before" field="ONLINESINCE"/> before the date indicated in ONLINESINCE fleid compared to the date of the day (so where are before the indicated date) <date direction="after" field="ONLINESINCE" delta="+30" /> the date in ONLINESINCE has passed since 30 days compared to the date of the day (so where are more than 30 days after the indicated date in the ONLINESINCE field) <date direction="after" field="PURGE" delta="-2" /> 2 days before the date indicated in a PURGE field
For the “update” action, operations described in <to> markup can concern:
<coll id="2" /> records are moved to phraseanet collection 2
<status mask="0x1xxxx" /> lower status-bits number 6 to 0, raise status-bit number 4 to 1
For the “delete”, attribute deletechildren=”1” calls for the removal of the contents of the deleted stories.
<?xml version="1.0" encoding="UTF-8"?> <tasksettings> <period>10</period> <logsql>0</logsql> <tasks> <!-- leave off line (sb4=1) all records before the date in COPYRIGHT_END--> <task active="1" name="confidential" action="update" sbas_id="1"> <from> <date direction="before" field="COPYRIGHT_END"/> </from> <to> <status mask="x1xxxx"/> </to> </task> <!-- keep on line (sb4=0) all records from 'public' collection between copyright date and archive date --> <task active="1" name="visible" action="update" sbas_id="1"> <from> <coll compare="=" id="5"/> <date direction="after" field="COPYRIGHT_END"/> <date direction="before" field="ARCHIVAGE_DATE"/> </from> <to> <status mask="x0xxxx"/> </to> </task> <!-- tell 10 day before archiving (lower sb5) --> <task active="1" name="ending soon" action="update" sbas_id="1"> <from> <coll compare="=" id="5"/> <date direction="after" field="ARCHIVE_DATE" delta="-10"/> </from> <to> <status mask="1xxxxx"/> </to> </task> <!-- move in 'archive' collection --> <task active="1" name="archiving" action="update" sbas_id="1"> <from> <coll compare="=" id="5"/> <date direction="after" field="ARCHIVAGE_DATE" /> </from> <to> <status mask="00xxxx"/> <!-- clean status-bits states --> <coll id="666" /> </to> </task> <!-- purge archived records since 1 year in 'archive' collection --> <task active="1" name="purge archive" action="delete" sbas_id="1"> <from> <coll compare="=" id="666"/> <date direction="after" field="ARCHIVAGE_DATE" delta="+365" /> </from> </task> </tasks> </tasksettings>
In case of conflicts or overlaps between <task> criteria, successive records may ‘jump’ from one state to another at each execution of the task.
ex : In the previous example, if the archive date of a record is prior to its copyright end date (inconsistent), sb 4 will go from 0 to 1 at each task execution.
This kind of issue can be avoided by ensuring that none of the <from> clauses are overlapped by raising a specific Phraseanet Status-bit in each stage <to> of a <task>.