MySource Matrix Developer

MySource Matrix Developer Newsletter Issue 83
Friday 14th July 2006

covers versions 3.8.4 stable, 3.10.0 RC1, 3.11.0 development

News

Changes to Session Cleanup Script

Last week's newsletter referred to a new session file garbage collection script that has been added to all currently maintained versions of MySource Matrix (3.8.x, 3.10.x and development branches). The original version was a PHP script (scripts/session_file_garbage_collection.php), however this has been replaced with a shell script (scripts/session_cleanup.sh), which should should be more portable across *nix systems.

Those systems already using the original PHP script should update their crontab (or other scheduler) to use the new shell script.

New Features

Simple Edit Accessed Trigger Event

Added to: 3.11.0 development

This new trigger event is fired at any time the Simple Edit interface is being accessed. As an example, this trigger event can be used to automatically place Live assets into Safe Edit when entering the Simple Edit interface.

URL Matches Trigger Condition

Added to: 3.11.0 development

This new trigger condition returns TRUE when the current URL matches or does not match the specified pattern. Note that this pattern is matched simply, so regular expressions cannot be used for the pattern.

Release Lock Trigger Action

Added to: 3.11.0 development

This new trigger action releases any locks held on the target asset. If the asset cascaded its locks to any child assets, those assets' locks will also be released.

New Features For Matrix Cache Clearing

Added to: 3.11.0 development

The Cache Manager now has a "Delete All System Cache" option on the Clear Cache screen that clears the entire MySource Matrix cache, regardless of other settings on that screen. There are some instances where this feature may be useful, however it should be used sparingly, especially on large systems.

The Clear Cache HIPO job now also has a freestyle threshold, similar to other HIPO jobs. This defaults to 100 assets. Any Clear Cache job affecting less assets than this threshold will attempt to run in one go.

Set Status Trigger Action Improvements

Added to: 3.11.0 development

The Set Status Trigger Action now has a setting that affects assets that are controlled by a dependant parent. If this new setting is turned on, if the affected asset is a dependant child, the trigger action will set the status of the highest-level parent(s) that the asset depends upon.

Attribute Changed Condition Improvements

Added to: 3.11.0 development

This Trigger Condition previously didn't include non-user-creatable assets such as Bodycopy or Content Type. This category of assets are now available in this condition.

Planned Development

No new generic features are currently scheduled for development.

Upgrading

3.11.0 Development

Additional queries:

If you ran the upgrade script for the upgrading of the data directories (see the previous newsletter for details), there was a bug in that script that left some file versioning entries in the database with a double slash where a single slash should have been. This caused problems when accessing versioned files within MySource Matrix.

Please run the following commands from an SQL shell to fix this issue:

BEGIN;

UPDATE sq_file_vers_file
    SET path = REPLACE(path, '//', '/');

COMMIT;

Additional comments: 

The Cache DSN changes add a new configuration variable to the main configuration file. Follow these steps to upgrade your system:

1. Run the step_01.php installation script.
2. OPTIONAL: Edit the [SYSTEM ROOT]/data/private/conf/main.inc configuration file and edit the SQ_CONF_DBCACHE_DSN variable. (If this step is omitted, the 'db2' connection will be used.)
3. Run the step_02.php installation script.

3.10.0 Release Candidate 1

Additional queries: No additional queries are required for upgrades.

Additional comments: 

The Cache DSN changes add a new configuration variable to the main configuration file. Follow these steps to upgrade your system:

1. Run the step_01.php installation script.
2. OPTIONAL: Edit the [SYSTEM ROOT]/data/private/conf/main.inc configuration file and edit the SQ_CONF_DBCACHE_DSN variable. (If this step is omitted, the 'db2' connection will be used.)
3. Run the step_02.php installation script.

3.8.4 Stable

Additional queries: No additional queries are required for upgrades.

Additional comments: 

The Cache DSN changes add a new configuration variable to the main configuration file.

It is possible to follow the instructions set out for the 3.11.0 or 3.10.x versions above, however the first step will reset your default and technical contact e-mail addresses. The recommended method of upgrading a 3.8.x system is as follows:

1. Edit the [SYSTEM ROOT]/data/private/conf/main.inc configuration file and add the following line:

   define('SQ_CONF_DBCACHE_DSN', '<cache database DSN>');

   The DSN can be left empty, in which case the 'db2' connection will be used.
2. Run the step_02.php installation script.

New Bugs Added To Bug Tracker

Bug ID	3.8.x	3.10.x	Dev	Description
1493	N	N	Y	Validate Job function in Bmail Job does not respect parent usergroup permission
1495	N	Y	N	Cascading No Permissions (not confirmed)
1496	N	N	Y	Asset is of type display without a lock aquired
1497	N	N	N	Searching metadata field with multiple options not working (not confirmed)
1499	N	Y	N	getParents ignores type when restricting by level (not confirmed)
1500	Y	N	N	Submission Log Edit screen (not confirmed)
1502	Y	N	N	valid email address not valid for email form field (not confirmed)
1505	N	Y	N	Related Asset Listing not Listing Siblings (not confirmed)

Notes:

Bug #1491 (News item URL link can't browse the asset tree in simple edit mode (feature request?)) was submitted by miriam.clinton but was marked as not being a bug in current versions. The bug was reported in version 3.6.8, however the bug has already been fixed in version 3.8 and higher, and no further bug fixes are provided for 3.6.x versions.

Bug #1492 (Keyword Documentation (feature request)) was submitted by miriam.clinton but was marked as not being a bug because the report was a request for documentation, which does not belong on the bug tracker as the documentation team does not use it.

Bug #1498 (Matrix Bug Site - Link to 'report a bug') was submitted by MargieW but was marked as not being a bug as the report related to the bug tracker and not MySource Matrix itself. The bug has been closed.

New Feature Requests Added To Bug Tracker

Bug ID	Description
1501	Selection Field - no blank value allowed
1503	Multi-page - Custom Form
1504	Trigger Manager - Batching - asset type

Bugs Fixed In The Bug Tracker

Bug ID	3.8.x	3.10.x	Dev	Description
1480	Y	Y	Y	Search List Asset - Web Path
1481	Y	Y	Y	Search List Error
1485	Y	Y	Y	Custom Form File Upload Field Overwrite Rule Problem
1486	N	Y	Y	Custom form - email options screen display's warnings for not setting optional settings
1487	Y	Y	Y	Trigger Action Set Status' not updating dependant assets statuses
1489	Y	Y	Y	Asset Listing Column Layout
1493	N	N	Y	Validate Job function in Bmail Job does not respect parent usergroup permission

View Comments