Changes

Replaced content with "<noinclude> Multi selection screenshots </noinclude> http://wiki.sugarlabs.org/go/Features/Multi_selection"
Line 4: Line 4:     
http://wiki.sugarlabs.org/go/Features/Multi_selection
 
http://wiki.sugarlabs.org/go/Features/Multi_selection
  −
== Summary ==
  −
  −
Implements the ability to select multiple journal entries in the journal entry view and perform group operations (like copy, delete) on them.
  −
  −
== Owner ==
  −
* Name:  [[User:Walter| Walter Bender]], [[User:Gonzalo| Gonzalo Odiard]], [[User:erikos| Simon Schampijer]], [[tch| Martin Abente]], [[User:Ajay| Ajay Garg]], [[User:M_anish| Anish Mangal]]
  −
* Email: walter@sugarlabs.org, gonzalo@laptop.org, erikos@sugarlabs.org, tch@activitycentral.com, ajay@activitycentral.com, anish@activitycentral.com
  −
  −
== Current status ==
  −
* Targeted release: 0.98
  −
* Development status: This feature is tested to be working quite well in sugar-0.94 based dextrose-3 images. The patchset just needs to be ported over to the latest sugar code.
  −
  −
== Benefit to Sugar ==
  −
This feature allows the users to perform operations on multiple journal entries at once, making it very efficient if the user has to perform repetitive tasks like copying/deleting journal entries for many entries. The users can also filter journal entries by using the already existing search facilities and perform operations on those.
  −
  −
Two ways of selecting multiple journal entries have been provided. The user can either click the checkbox next to individual journal entries or use the select/deselect all buttons provided on the toolbar (which only shows up if the feature is being used). This UI takes some ideas from the standard gmail interface in how it allows users to select multiple entries and perform operations on them.
  −
  −
Another interesting and useful side-effect of this feature is that a user can insert a pen-drive with many activity bundles, select 'all' and copy them to journal. The resulting operation will install all bundles on the XO laptop!
  −
  −
== Scope ==
  −
This feature has already been implemented in sugar-0.94 based dextrose-3 builds. The feature just needs porting to the latest sugar version.
  −
===Patches===
  −
* Patch in sugar-dx3 code repo: [http://git.sugarlabs.org/~m_anish/sugar/sugar-dextrose/commit/1d3574120ac7d7bbc4017aa0d0b2aab19553cd4a 1] [http://git.sugarlabs.org/~m_anish/sugar/sugar-dextrose/commit/dfb8c33f9591f7610e1b780bf7a95412c7cf8382 2]
  −
* Patch in sugar-toolkit-dx3 code repo: [http://git.sugarlabs.org/~m_anish/sugar-toolkit/sugar-toolkit-dextrose/commit/e5c63fd56cf9a3982e9629229870aa4319af3b76 1]
  −
* Patch in sugar-artwork-dx3 code repo: [http://git.sugarlabs.org/~m_anish/sugar-artwork/sugar-artwork-dextrose/commit/348bef5511cc8b6774199a7d46b2740036e26431 1] [http://git.sugarlabs.org/~m_anish/sugar-artwork/sugar-artwork-dextrose/commit/136d7abaf9b451aa18023b5c95bc79f3b622814c 2]
  −
  −
== History ==
  −
  −
The implementation is almost identical to the one done by Martin; details available at :
  −
http://www.sugarlabs.org/~tch/journal2.mpeg
  −
  −
The only differences are ::
  −
  −
* More copy-to options :: Clipboard, Documents (in addition to mounted drives).
  −
* When entries are copied to another location, both - the sources and the destinations - are de-selected automatically, without the user explicitly have to de-select them all manually.
  −
* There has been a progress bar added for batch-operations.
  −
  −
  −
== Basic utility of this feature ==
  −
  −
* This feature, merely does a loop-over for multiple entries. That is, the workflow and the end-result in the following two scenarios should be exactly the same ::
  −
** Entries, E1, E2, E3 .... En, are operated upon one after the another, individually.
  −
** Entries, E1, E2, E3 .... En, are selected together, and operated upon one after the another, as a single macro batch-operaton.
  −
  −
* Some particular use-cases ::
  −
** Batch-operations <del>speeds up</del> makes XO-bundle installations more convenient, when multiple bundles are copied together from a USB drive to the journal. Thanks a ton to Sridhar Dhanapalan for the attention generated towards this (otherwise obscure) use-case.
  −
  −
  −
  −
  −
  −
== UI Design ==
  −
  −
=== Typical copy-to workflow ===
  −
  −
=[Step 01] Initial "Journal" view=
  −
**[[File:b1.png]]
  −
  −
  −
  −
  −
  −
  −
  −
  −
  −
=[Step 02] Initial "Documents" view=
  −
**[[File:b2.png]]
  −
  −
  −
  −
  −
  −
  −
  −
  −
  −
=[Step 03] Select an entry in the journal. The Edit-Toolbar, signifying batch-operations, appears.=
  −
**[[File:b3.png]]
  −
  −
  −
  −
  −
  −
  −
  −
  −
  −
=[Step 04] Select more entries in the Journal.=
  −
**[[File:b4.png]]
  −
  −
  −
  −
  −
  −
  −
  −
  −
  −
=[Step 05] Click "Copy" toolbar button, and select to copy to "Documents" from the pop-up=
  −
**[[File:b5.png]]
  −
  −
  −
  −
  −
  −
  −
  −
  −
  −
=[Step 06] The confirmation alert appears. Click 'OK'=
  −
**[[File:b6.png]]
  −
  −
  −
  −
  −
  −
  −
  −
  −
  −
=[Step 07] If there ia any error for a entry, the message is displayed as an alert. Click 'OK' to continue.=
  −
**[[File:b7.png]]
  −
  −
  −
  −
  −
  −
  −
  −
  −
  −
=[Step 08] Progress status for entry=
  −
**[[File:b8.png]]
  −
  −
  −
  −
  −
  −
  −
  −
  −
  −
=[Step 09] Progress status for next entry. Note that the progress-status changed without any user convention=
  −
**[[File:b9.png]]
  −
  −
  −
  −
  −
  −
  −
  −
  −
  −
=[Step 10] Final "Journal" view. Note that all the "source" entries are de-selected.=
  −
**[[File:b10.png]]
  −
  −
  −
  −
  −
  −
  −
  −
  −
  −
=[Step 11] Final "Documents" view. Note that all "destination" entries are de-selected.=
  −
**[[File:b11.png]]
  −
  −
== Dependencies ==
  −
  −
None
  −
  −
== Contingency Plan ==
  −
  −
Don't use this feature
  −
  −
== Documentation ==
  −
  −
This feature was discussed in EDUJam 2011 and [http://wiki.sugarlabs.org/go/Features/Multi_selection this] feature page was a result of that.
 
525

edits