DigiMonitor: ItemWatcher
ItemWatcher logic has been rewritten for these purposes:
1) To provide unittestable code and in turn make sure functionality is tested thoroughly before release.
2) To provide better logging.
3) To fix specific issues with integer parsing which resulted in events not being handled and not correctly marked as failed either.
Nothing has changed regarding the configuration of ItemWatchers except an old bug which reversed 'greater than' and 'less than' when comparing values has finally been fixed.
In a users perspective the one and only major change from before to now is all ItemWatcher configurations are validated when starting up - even if they are not active. Any invalid configuration will result in an exception written to the digimonitor log in order to catch this at the earliest possible time.
Search2 security type ItemSecurityReadAccessOnlyPublic implemented for Solr
Not only that: it is now also the recommended security type to use with any Solr enabled search.
Enhanced DAM Stat metrics
The DAM Center now logs these two events:
- Member logs into the DAM Center
- Member downloads an asset
To support this, in the DamStatWS you can now view metrics for assets and members filtered by specific member ids. This makes it possible to view, for example, how many times an asset was downloaded by a specific member or when a specific member has logged in to the DAM Center. The DamStat flash application has been updated to support the new filters (see "How to use Enhanced DAM Stat metrics" below).
Implement hyphen to not mean "not" when part of a word
The hyphen operator still means not when there is a space in front of it but not where there isn't. So searching "doctor -scientist" (without the quotations) means "doctor not scientist" whereas "doctor-scientist" (again without the quotations) no longer interprets the hyphen as a not.
Support for full HD video format
Troels Holm (Unlicensed) please update the description
How to access/use the new implementation?
DigiMonitor: ItemWatcher
As before access ItemWatcher configuration via System Tools → Workflow → ItemWatcher.
Enhanced DAM Stat metrics
Martin Ulisse Anything to add here regarding how the flash implementation is used?
Implement hyphen to not mean "not" when part of a word
Simply use the hyphen operator as part of a query or as part of a word. It is best practice to not use the hyphen operator unless it is meant as part of a query. When searching for a hyphenated word simply type the word without the hyphen instead.
Support for full HD video format
Full HD (1920x1080) video is now available for Adaptive Bitrate installations and as download option where applicable.
How the new implementation works?
DigiMonitor: ItemWatcher
Logging has been overhauled. Messages are all in english and have been tightened up in wording and debug data.
Almost all parts of the configuration and certainly all of the common parts are now validated upon startup. As always it is important to check digimonitor logs. When an ItemWatcher is rejected due to error in configuration a clear exception message is written about this in the log for DigiMonitorPluginExecutor.
'Process only for this language ID' may now be omitted in which case a lookup is performed for digizuite constant 'LANGUAGE_DEFAULT_METADATA_ID'.
Some situations where events were marked as handled even though they failed they are now marked as failed instead. These situations are generally about when exceptions are thrown. Be aware that an event is marked as failed if 1 ItemWatchers fails in its "event matchmaking". So other ItemWatchers might have succesfully worked the event. This is as before.
Regarding configuration everything works as before. It should not be necessary to do anything differently. The exception is if any of the operators 'greater than' or 'less than' are used. See section below for details.
Security type 'ItemSecurityReadAccessOnlyPublic'
Works as before but now also works with Solr. With 'ItemSecurityReadAccessOnlyPublic' these 4 filters are applied in addition to the standard readaccess check:
1) deleted = 0: deleted assets are filtered out.
2) is_public = 1: non public assets are filtered out.
3) expiration: an unused feature but nonetheless expired assets are filtered out.
4) published: an asset needs to have been fully through a publish otherwise it is also filtered out.
Enhanced DAM Stat metrics
The additional log data needed for filtering by member was already there to begin with (on the database level), but there was no way to retrieve it using the DamStatWS. New methods for the DamStatWS has been created (along with corresponding stored procedures) that returns data filtered by member.
Furthermore the DAM Center now calls the DamStatWS from the Ext.JS code when a user has successfully logged in. It also calls it whenever a user clicks on the download icon for an asset (it will log a download even if a user chooses to cancel the download, no way around that unfortunately). If the user chooses to download multiple assets at once, the DamStatWS will be called once for each asset.
Martin Ulisse Anything to add here regarding how the flash implementation works?
Implement hyphen to not mean "not" when part of a word
When searching for a hyphenated word the hyphen is ignored and essentially a search for 2 words is done instead.
Support for full HD video format
Troels Holm (Unlicensed) please update the description
How to configure the new implementation?
DigiMonitor: ItemWatcher
Use of 'IsNumeric' and 'Len' will need to be reconfigured manually.
SpecialValidator: Isnumeric
This option did not work properly and has been fixed. Simply specify 'Isnumeric' (case insensitive) within an xml tag to validate that a value is numeric. Example: <AssetType>Isnumeric</AssetType>.
SpecialValidator: Len
This option did not work properly and has been fixed. Simply specify 'Len [operator] [value]'. Supported operators are '=', '>', '<' and '!' and obviously value needs to be an integer. Spaces between 'Len' and 'operator' or between 'operator' and 'value' are ignored. An error in this configuration is an exception to the general rule of validating all configuration at startup and will still be validated upon handling an event.
Example: <Description>Len!0</Description>
Example: <Description>Len > 0</Description> (notice that greater than and less than must be escaped as per xml standards)
ItemIdRequired
Working as before but important enough to reiterate. When set to true only events with a present and valid (>0) ItemId will be handled. It is not necessary to specify configuration for a value check ('Process only for changes to this item metadata field ID' and related configuration) but if this configuration is done it will only be performed when ItemIdRequired is true as looking up non-item metadata values is not supported.
Operator: Less than, Greater than
Now works as they should. In case this is used and has been reversed to do what is needed they will need to be set correctly.
Everything else
No changes except validation is done at startup. Check logs for exceptions to check if any ItemWatcher configuration is invalid.
How to manually change Digizuite_system_framework_search to use ItemSecurityReadAccessOnlyPublic
Delete these 3 sections (if present) as they are now obsolete:
<searchField id="isPublic" fieldName="asset.is_public" valueHandler="Equals" operator="AND">
<values valueType="String">
<value>1</value>
</values>
</searchField>
<searchField id="sIsNotDeleted" fieldName="asset.deleted" valueHandler="Equals" operator="AND">
<values valueType="String">
<value>0</value>
</values>
</searchField>
<searchField id="sFirstPublished" fieldName="asset_layoutfolder.FirstPublished" operator="AND" valueHandler="NotEmpty" visible="false" />
Then change security to ItemSecurityReadAccessOnlyPublic
<searchField id="security" securityType="ItemSecurityReadAccessOnlyPublic" visible="false" operator="AND" />
Enhanced DAM Stat metrics
No configuration needed for this functionality.
Implement hyphen to not mean "not" when part of a word
No configuration available.
Support for full HD video format
Troels Holm (Unlicensed) please update the description
DOs
DON'Ts
- Pokemon Go: do not use PowerUPs unless you are at least level 20. You might waste your Stardust
Tips & Tricks
What has been released?