MySource Matrix Developer

MySource Matrix Developer Newsletter Issue 268
Friday 5th March 2010

covers versions 3.24.6 stable, 3.26.1 stable, 3.27.0 development

News

New Matrix Release due next Monday (3.26.2 only)

The next release of MySource Matrix will be next Monday 8th March when version 3.26.2 will be made available. Funnelback search integration will be included in the SSV.

New Matrix Release (3.24.6)

MySource Matrix 3.24.6 is now available for download from the MySource Matrix web site.

New Features

Funnelback Search integration

Added to: 3.27.0 development, 3.26.2 stable

[ Feature Request #4214 ]

MySource Matrix has been integrated with purpose-built Funnelback binaries, for indexing and searching of content housed in a MySource Matrix system.

Searches are performed against Collections, which are linked to MySource Matrix Site assets, and Meta-Collections which comprise multiple Collections (ie; for searching more than one site at a time). Configuration of Collections, Metadata mappings and indexing are performed under the Funnelback Manager asset.

The Funnelback Search Page asset has been expanded to include bodycopies for Contextual Navigation, Type Formats (HTML, PDF etc.), Featured Pages and spelling suggestions.

Funnelback search integration is performed through interaction with external binaries. These are included within MySource Matrix SSV for configuration during installation or upgrade.

Search indexing functions differently to MySource Matrix Search, in that content is not immediately indexed when updated. Scripts are available within the Funnelback package which can be added to the cron to update the index periodically. The frequency at which the indexer should be run is dependent on the amount of content being indexed and the dynamic requirements of this content. Collections can be reindexed independently of each other.

The MySource Matrix search system is still required for items such as backend search.

TRIM Record Type filter

Added to: 3.27.0 development, 3.26.2 stable

[ Feature Request #4224 ]

A Record Type Filter is now available in the "General Search Options" of TRIM Saved Search assets to restrict retrieved records to particular TRIM Record Types.

As record types can be custom-built, a list of these are retrieved from the TRIM server when synchronising the Saved Search page, which are then available for selection.

For example, a saved search may be configured to return "Document" types, or both "Document" and "Folder" types.

Target Remap URL on Web Paths screen

Added to: 3.27.0 development

[ Feature Request #4220 ]

In line with the display in Remap Manager, the asset Web Paths screen now shows the Target URL in the Remaps list.

JS API: Provision of asset, global and Simple Edit Keyword Replacements

Added to: 3.27.0 development

[ Feature Request #4210 ]

A new function, getKeywordsReplacements(), has been added to the JS API to return keyword replacements for requested asset, global and Simple Edit keywords.

Keywords are supplied in a Javascript array, which can either be with or without surrounding percentage (%) signs. Only one keyword may be supplied per array element, and no static text may be supplied alongside these values.

The function signature is:

getKeywordsReplacements(asset_id, keywords_array, dataCallback)

A usage example might be (for asset ID 123):

var keywords = {'asset_name', 'asset_id'};
getKeywordsReplacements(123, keywords, kwResult); // where kwResult is a defined function to obtain the result

Planned Development

No new generic features are currently scheduled for development.

Upgrading

3.24.7 Stable

Additional queries:

Additional comments: 

No additional steps are required.

3.26.2 Stable, 3.27.0 Development

Additional queries:

Additional comments: 

Funnelback Search integration

The following steps are required to install the Funnelback OEM binaries for the integration with MySource Matrix.

A Java Runtime Environment is included in the distribution as Funnelback has dependencies on Java code. This particular runtime version has been tested against Funnelback code, so substituting other existing runtimes is not advised.

All commands must be run as the root user at the command line (prompt denoted by the hash '#' character).

All supported OS distributions
(Create directory to house Funnelback OEM binaries)

mkdir /opt
tar -zxf funnelback.tar.gz -C /opt
mv /opt/funnelback /opt/funnelback-oem

Debian distributions
(Modify Funnelback config to point to correct 'sort' binary)

sed -i 's!sort=/bin/sort!sort=/usr/bin/sort!' /opt/funnelback-oem/conf/executables.cfg

All supported OS distributions
(Set permissions and fix symbolic links)

chown -R root.root /opt/funnelback-oem
cd /opt/funnelback-oem/lib/java/filter
rm -f tika-app.jar
ln -s tika-app-0.6.jar tika-app.jar
cd /opt/funnelback-oem/linbin/
rm -f jre
ln -s jre1.6.0_17-32 jre

A MySource Matrix manual for the Funnelback Package will be available to download by clients running our SSV packages.

New Bugs Added To Bug Tracker

Notes:

Bug #4213 ("Unable to delete remaps", reported 26th Feb by dsimmons) was marked "Not a Bug". The "Never Delete" checkbox against the relevant remap entries was checked, voiding any deletion attempts.

New Feature Requests Added To Bug Tracker

Bugs Fixed In The Bug Tracker

The following bugs were resolved in the 3.24.6 release just after last week's MySource Matrix Developer Newsletter:

The following bugs are resolved in our next releases (as denoted):

View Comments