Wiki Markup |
---|
h2. Summary
| Project | DSpace ClientUI built on RESTful API |
| Student | [~tr4n2uil] |
| Mentors | * [~bojan] (lead)
* [~mdiggory] |
| Technologies | DSpace REST \\
JavaScript jQuery FireSpark \\ |
| Proposal | [Melange|http://socghop.appspot.com/gsoc/proposal/review/google/gsoc2011/tr4n2uil/1] |
| Repository | [https://github.com/tr4n2uil/restclient] |
| Demo | [http:/ |
Summary
...
Project
...
DSpace ClientUI built on RESTful API
...
Student
...
...
Mentors
...
- Bojan Suzic (lead)
- Mark Diggory
...
Technologies
...
DSpace REST
JavaScript jQuery FireSpark
...
Proposal
...
...
Repository
...
https://github.com/tr4n2uil/restclient
...
Demo
...
/ec2-107-20-35-121.compute-1.amazonaws.com:8080/restclient/ |
...
Notes
...
jQuery
DSpace deployment on Amazon EC2
Project Requirements
- Client run interface
- Attractive look and feel
- Easy to customize
Features
...
DSpace REST
...
] | | Notes | [jQuery|https://wiki.duraspace.org/display/ |
...
GSOC/ |
...
FireSpark
...
jQuery+Notes] \\ [DSpace deployment on Amazon EC2|https:// |
...
RESTClient Extensions
...
Services and Workflows built for RESTClient using FireSpark for providing core UI functionality while interfacing the
RESTful API
https://github.com/tr4n2uil/restclient
...
jQuery Templates
...
Client side processing supported by flexible templates written in JavaScript thereby enabling easier evolution of the UI
http://api.jquery.com/category/plugins/templates/
...
CKEditor
...
HTML Rich Text Editor supported for easier text input during repository manipulation
http://ckeditor.com/
User Documentation
Source Structure
File / Directory / Subdirectory | Description | Files |
---|---|---|
index.html | initialization page for loading all necessary client scripts + basic document layout |
|
README |
|
|
ui/ | top level folder containing interface resources |
|
ui/css/ | styles and themes directory |
|
ui/css/default.css | global styles |
|
ui/css/jquery.css | jquery styles |
|
ui/css/restclient-styles.css | RESTClient styles unified from dev/ |
|
ui/img/ | images directory |
|
ui/js/ | scripts directory |
|
ui/js/jquery-1.6.1.min.js | jQuery |
|
ui/js/jquery-ui-1.8.13.min.js | jQuery UI |
|
ui/js/jquery.tmpl.min.js | jQuery Templates |
|
ui/js/jquery-firespark.js | jQuery FireSpark |
|
ui/js/ckeditor | CKEditor directory |
|
ui/js/restclient-jquery.js | RESTClient Extensions unified from dev/ |
|
ui/js/restclient-templates.js | RESTClient Templates unified from dev/ |
|
dev/ | top level folder containing developer resources |
|
dev/styles/ | individual styles directory |
|
dev/templates/ | individual templatesdirectory |
|
dev/build.bat (build.sh for linux) | Build script for unification |
|
dev/init.js | RESTClient initialization |
|
dev/helpers/ | individual helpers directory |
|
dev/services/ | individual services directory |
|
dev/workflows/ | individual workflows directory |
|
Customizations
Customization | Support | Description |
---|---|---|
Stylesheets (CSS) | Yes | Individual stylesheets in dev/styles/ control the styles for different pages |
Layout | Yes | Layout is configured in dev/styles/layout.css |
Themes | Yes | Themes are supported natively by jQuery UI |
Internationalization | No | Support for i18n is planned to be integrated into FireSpark soon using the i18n plugin |
Developer Documentation
Screenshots
Functional Specifications
- Features to be supported
- Respository Browsing
- Repository Manipulation
- Content Searching
- Statistics
- Administration
- Customizations to be supported
- Stylesheets (CSS)
- Layout
- Themes
- Internationalization
Project Timeline
| Ready |
| Base done, Improvement phase |
| In Progress |
Before May 24
- Obtain access to :
Wiki
Project repository
Download, build and install local DSpace instance
Download, build and install DSpace REST module
Test and verify the installation
Go through the functionality of DSpace and DSpace REST API
Compare possible JavaScript UI frameworks -- Ext JS preferred
Note |
---|
Mark: I would like to see a bit more dialog with Bojan concerning the REST API contracts and migration to Spring, mainly, are we happy with these API contracts and using them for the students project, or do we need to consider some possible changes int he API to adopt to using Spring REST instead of Entity Broker. And if so, is there a timeline for providing those changes in scope of the 1.8 release? Vibhaj: Confirmed that the possible migration shall not affect the REST interface and hence RestClient project. |
May 25 - June 15
...
- collections, communities, items and bitstreams
- create
view
edit
delete
- users and groups
view
- search
generating statistics
...
wiki.duraspace.org/display/GSOC/Amazon+EC2+DSpace+Deployment] \\ | h2. Project Requirements # Client run interface # Attractive look and feel # Easy to customize h2. Features | DSpace REST \\ | Built on the DSpace REST API developed as GSoC project in 2009-10 \\ [https://wiki.duraspace.org/display/DSPACE/REST+API]\\ | | FireSpark \\ | Interface powered by FireSpark - JavaScript Service Computing Platform - which is an experimental platform currently \\ under my research. \\ [https://github.com/tr4n2uil/firespark]\\ | | RESTClient Extensions \\ | Services and Workflows built for RESTClient using FireSpark for providing core UI functionality while interfacing the \\ RESTful API \\ [https://github.com/tr4n2uil/restclient]\\ | | jQuery Templates \\ | Client side processing supported by flexible templates written in JavaScript thereby enabling easier evolution of the UI \\ [http://api.jquery.com/category/plugins/templates/]\\ | | CKEditor \\ | HTML Rich Text Editor supported for easier text input during repository manipulation \\ [http://ckeditor.com/]\\ | h2. User Documentation h4. Source Structure || File / Directory / Subdirectory || Description || Files || | index.html | initialization page for loading all necessary client scripts + basic document layout | | | README \\ | | | | ui/ \\ | top level folder containing interface resources | | | ui/css/ \\ | styles and themes directory \\ default theme is redmond \\ other themes provided are smoothness and ui-lightness \\ more themes may be downloaded from [http://jqueryui.com/themeroller/|http://jqueryui.com/themeroller/] | | | ui/css/default.css | global styles | | | ui/css/jquery.css | jquery styles | | | ui/css/restclient-styles.css | RESTClient styles unified from dev/ \\ see dev/ structure description for information on unification during build | | | ui/img/ \\ | images directory \\ | | | ui/js/ \\ | scripts directory \\ | | | ui/js/jquery-1.6.1.min.js | jQuery \\ | | | ui/js/jquery-ui-1.8.13.min.js | jQuery UI \\ | | | ui/js/jquery.tmpl.min.js | jQuery Templates \\ | | | ui/js/jquery-firespark.js | jQuery FireSpark \\ | | | ui/js/ckeditor | CKEditor directory \\ | | | ui/js/restclient-jquery.js | RESTClient Extensions unified from dev/ | | | ui/js/restclient-templates.js | RESTClient Templates unified from dev/ | | | dev/ \\ | top level folder containing developer resources | | | dev/styles/ \\ | individual styles directory \\ files will be unified to ui/css/restclient-styles.css during build | * home.css * layout.css * all-communities.css * all-collections.css * all-items.css * all-users.css * all-groups.css * all-stats.css * community.css * collection.css * item.css * user.css | | dev/templates/ \\ | individual templatesdirectory \\ files will be unified to ui/js/restclient-templates.js during build | * Account.js * Browse.js * Login.js * AllCommunities.js * AllCollections.js * AllItems.js * AllUsers.js * AllGroups.js * AllStats.js * Community.js * Collection.js * Item.js * User.js * Group.js * CommunityEdit.js * CollectionEdit.js * CommunityDelete.js | | dev/build.bat (build.sh for linux) \\ | Build script for unification \\ Unification is the merging of individual files to single file for client use | | | dev/init.js \\ | RESTClient initialization \\ It will be unified to ui/js/restclient-jquery.js during build | | | dev/helpers/ \\ | individual helpers directory \\ files will be unified to ui/js/restclient-jquery.js during build | * GetDate.js * ReadFileSize.js | | dev/services/ \\ | individual services directory \\ files will be unified to ui/js/restclient-jquery.js during build | * Resource.RESTURL.service.js * Session.RESTURL.service.js * Session.Write.service.js | | dev/workflows/ \\ | individual workflows directory \\ files will be unified to ui/js/restclient-jquery.js during build | * Session.Begin.workflow.js * Session.End.workflow.js * Resource.Load.workflow.js * Resource.Edit.workflow.js * Resource.Delete.workflow.js | h4. Customizations || Customization \\ || Support \\ || Description \\ || | Stylesheets (CSS) \\ | Yes \\ | Individual stylesheets in dev/styles/ control the styles for different pages \\ Additionally, ui/css/default.css is the global style sheet \\ (Note : Individual stylesheets override global styles) \\ | | Layout \\ | Yes \\ | Layout is configured in dev/styles/layout.css \\ Currently jQuery UI Tabpanel (which is the container supported in FireSpark) is used for viewing different \\ pages as it provides faster navigation (without breadcrumbs) although simple layout is also possible. \\ (Containers may be developed/changed easily though it shall require understanding of FireSpark whose documentation will be \\ completed by the end of the 2011) \\ Other UI containers are under development in FireSpark. \\ | | Themes \\ | Yes \\ | Themes are supported natively by jQuery UI \\ Themes may be downloaded from [http://jqueryui.com/themeroller|http://jqueryui.com/themeroller/] | | Internationalization \\ | No \\ | Support for i18n is planned to be integrated into FireSpark soon using the [i18n plugin|http://plugins.jquery.com/project/jquery_i18n_properties]\\ This will allow easy internationalization for RESTClient \\ | h2. Developer Documentation h3. RESTClient Extensions h4. Services || Name\\ || Description\\ || Options (Parameters passed to service in FireSpark)\\ || Return Values\\ || | SessionWrite | Saves session information (email/password) for use in further requests\\ | * form : string : Selector for login form : optional default false | None\\ | | ResourceRESTURL | Generates REST URL from resource information\\ | * rsrctype : string : Resource type : values ('allcommunities', 'community', 'community-edit', 'community-delete', 'community-change', 'allcollections', 'collection', 'collection-edit', 'collection-delete', 'collection-change', 'allitems', 'item', 'item-edit', 'item-delete', 'item-change', 'allusers', 'user', 'allgroups', 'group', 'allstats') * rsrcid : number : Resource ID : optional default false * rsrcfield : string : Resource Field : optional default false * rsrcvalue : string : Resource Value : optional default false * end : boolean : Should '.json' be appended to URL formed : optional default false | * url : string : Resource URL generated | | SessionRESTURL | Appends Session information (email/password) to URL\\ | * url : string : Resource URL | * url : string : Resource URL with session appended | h4. Workflows || Name\\ || Description\\ || Options (Parameters passed to service in FireSpark) || Return Values\\ || | SessionBegin\\ | Stores login information into session, authenticates and loads account template\\ | * cntr : string : Container selector for account panel : optional default '#account-panel' * sel : string : Selector for login form : optional default '#login-container' | None\\ | | SessionEnd\\ | Deletes session and loads account template\\ | * cntr : string : Container selector for account panel : optional default '#account-panel' * sel : string : Selector for login form : optional default '#login-container' * data : object : Indicate whether to show invalid message : optional default { invalid : false } | None\\ | | ResourceLoad\\ | Loads resource using GET and applies template into selected element\\ | * type : string : Resource Type : values (refer ResourceRESTURL service rsrctype values) * tabui : string : Saved reference index for Tabpanel : optional default 'tabuipanel' * title : string : Tab Title : optional default 'DSpace RESTUI' * id : number : Resource ID : optional default false * ld : string : HTML Loading content : optional default RESTClient.jquery.constant.loadmsg * anm : string : Animation Type : optional default 'fadein' : values ('fadein', 'fadeout', 'slidein', 'slideout') * dur : number : Animation Duration : optional default 100 * dly : number : Animation Delay : optional default 0 | None\\ | h4. Helpers || Name\\ || Description\\ || Arguments\\ || Return Value\\ || | getDate\\ | Returns timestamp as properly formatted date string\\ | time : number : Timestamp\\ | date : string : Formatted Date\\ | | readFileSize\\ | Returns size in bytes as properly formatted string\\ | size : number : Size in bytes\\ | size : string : Formatted Size\\ | h4. init.js || Option\\ || Description\\ || Default Value\\ || | RESTClient.urls | URLs to be used\\ | {\\ base : '/dspace/',\\ allcommunities : 'communities',\\ community : 'communities/',\\ allcollections : 'collections',\\ collection : 'collections/',\\ allitems : 'items',\\ item : 'items/',\\ bitstream : 'bitstream/',\\ receive : 'receive',\\ allusers : 'users',\\ user : 'users/',\\ allgroups : 'groups',\\ group : 'groups/',\\ allstats : 'stats'\\ }; | | RESTClient.jquery.constant.loadmsg\\ | HTML content to show while loading content\\ | '<p class="loading">Loading ...</p>'\\ | | RESTClient.jquery.constant.successimg\\ | HTML content to indicate successful execution\\ | '<img src="ui/img/icons/ok.gif">'\\ | | RESTClient.jquery.constant.errorimg\\ | HTML content to indicate erroneous execution\\ | '<img src="ui/img/icons/error.gif">'\\ | h3. Documentation Resources || Name\\ || Available\\ || Description\\ || | FireSpark\\ | No\\ | Partially available in the heavily commented source code\\ [https://github.com/tr4n2uil/firespark|https://github.com/tr4n2uil/firespark]\\ | | jQuery Templates\\ | Yes\\ | Available as jQuery plugin API documentation\\ [http://api.jquery.com/category/plugins/templates/template-tags/]\\ | h2. Screenshots h2. Functional Specifications # Features to be supported ## Respository Browsing ## Repository Manipulation ## Content Searching ## Statistics ## Administration # Customizations to be supported ## Stylesheets (CSS) ## Layout ## Themes ## Internationalization h2. Project Timeline | (/) | Ready | | (+) | Base done, Improvement phase | | (y) | In Progress | h4. Before May 24 # Obtain access to : #* (/) Wiki #* (/) Project repository # (/) Download, build and install local DSpace instance # (/) Download, build and install DSpace REST module # (/) Test and verify the installation # (/) Go through the functionality of DSpace and DSpace REST API # (/) Compare possible JavaScript UI frameworks \-\- Ext JS preferred {note}Mark: I would like to see a bit more dialog with Bojan concerning the REST API contracts and migration to Spring, mainly, are we happy with these API contracts and using them for the students project, or do we need to consider some possible changes int he API to adopt to using Spring REST instead of Entity Broker. And if so, is there a timeline for providing those changes in scope of the 1.8 release? Vibhaj: Confirmed that the possible migration shall not affect the REST interface and hence RestClient project.{note} h4. May 25 - June 15 # (+) Get familiar with DSpace REST API ## collections, communities, items and bitstreams ##* create ##* (/) view ##* (/) edit ##* (/) delete ## users and groups ##* (/) view ## search ## (/) generating statistics # (/) Decide the JavaScript Library to be used by discussing with the DSpace community: *jQuery* \[decided by community\] |
...
Selectors
Actions and Methods
Events
UI Widgets
...
# (+) Learn the jQuery JavaScript Library #* (/) Selectors #* (/) Actions and Methods #* (/) Events #* (+) UI Widgets # (+) Design client run FireSpark framework supporting JavaScript UI for RESTful (JSON) services # (+) Design generic Services and Workflows in FireSpark # (+) Plan these extensions for RestClient #* (+) RESTUI.Resource.Load |
...
Workflow #* (+) RESTUI.Resource.Edit |
...
Workflow #* (+) RESTUI.Resource.Delete |
...
June 15 - July 10
Implement extensions (Services and Workflows) to FireSpark in RESTClient to provide support for :
- Repository Browsing
- Communities
All
Single
Subcommunities
Recent Submissions
- Sort
- Collections
All
Single
- Sort
- Items
All
Single
Read Metadata
- Bitstreams
Download
- Communities
- Repository Browsing
July 11 - July 15
GSoC Mid Term Evaluations
July 15 - July 31
Implement extensions (Services and Workflows) to FireSpark in RESTClient to provide support for :
- Repository Manupulation
- Communities
Edit
Delete
- Collections
Edit
- Communities
- Administration
- Users
Login
Logout
All
Single
- Groups
All
Single
- Users
- Content Searching
- Statistics
Reports (simple)
Charts and Visualization (simple)
- Repository Manupulation
August 1 - August 15
- Enhancing the look and feel
- Look into and improve scope for customizations
- Improve the architecture of RESTClient and FireSpark
- Testing
- Complete Documentation
- Final Improvements
...
Workflow #* (y) ParseItemMetadata helper h4. June 15 - July 10 # (+) Implement extensions (Services and Workflows) to FireSpark in RESTClient to provide support for : ## Repository Browsing ##* Communities ##** (+) All ##** (+) Single ##** (+) Subcommunities ##** (+) Recent Submissions ##** Sort ##* Collections ##** (+) All ##** (+) Single ##** Sort ##* Items ##** (+) All ##** (+) Single ##** (y) Read Metadata ##* Bitstreams ##** (+) Download h4. July 11 - July 15 # (/) GSoC Mid Term Evaluations h4. July 15 - July 31 # (+) Implement extensions (Services and Workflows) to FireSpark in RESTClient to provide support for : ## Repository Manupulation ##* Communities ##** (+) Edit ##** (+) Delete ##* Collections ##** (+) Edit ## Administration ##* Users ##** (+) Login ##** (+) Logout ##** (+) All ##** (+) Single ##* Groups ##** (+) All ##** (+) Single ## Content Searching ## Statistics ##* (+) Reports (simple) ##* (+) Charts and Visualization (simple) h4. August 1 - August 15 # Enhancing the look and feel # Look into and improve scope for customizations # Improve the architecture of RESTClient and FireSpark # Testing # Complete Documentation # Final Improvements individual templates directory (will be unified to ui/js/restclient-templates.js during build) = '<p class="loading">Loading ...</p>'; |