= Selection manager =

|| '''Date''' || 2008/10/20 ||
|| '''Contact(s)''' || mcoudert ||
|| '''Last edited''' || [[Timestamp]] ||
|| '''Status''' || draft ||
|| '''Assigned to release''' || 2.3 ? ||
|| '''Resources''' || Resource available / patch proposed ||

== Overview ==

The purpose of this proposal is to improve existing massive actions on metadata search results (ie delete, filter search ...).

=== Proposal Type ===
 * '''Type''': 
 * '''App''': !GeoNetwork
 * '''Module''': User Interface, new SelectionManager module

=== Links ===
 * '''Documents''':
 * '''Email discussions''':
 * '''Other wiki discussions''':

=== Voting History ===
 * Vote proposed by X on Y, result was +/-n (m non-voting members).


== Motivations ==
In 2.2 release, only delete action is possible on all metadata records in current search page results.
There's no easy way to delete all metadata matching a specific search.
This improvement allows users to navigate through search results keeping selected metadata in session. Once selected, user can't apply action to selection set.

Actions available on selection:
 * massive delete
 * display only selected

[[Image(selection.png,align=center)]]


== Proposal == 

 * 1. A user select a metadata, by checking its checkbox just before title in result list.
 * 2. Selected metadata is added to selection manager :
  * 1. Selection manager is null
   * 1. new selection manager created for the type metadata
   * 2. selection manager set in session
   * 3. UUID of the selected metadata added in the new selection manager
  * 2. Selection manager is already existing in session
   * 1 . UUID of the selected metadata added in the existing selection manager


Parameters available for selection : all, none, true, false, single
These parameters alloxs differents action on selection manager :
 * all    : select all metadata in result list (current searcher)
 * none   : remove all items from selection manager / reset
 * true   : add the specified item in selection
 * false  : remove the specified item from selection
 * single : clear the selection and add selected element

=== Backwards Compatibility Issues ===


== Risks ==

How to deal with harvested / remote metadata : 
 * should we allow delete actions on it ?

== Participants ==
 * francois
 * BRGM (Etienne, Pierre) / !GeoSource project