Difference between revisions of "Talk:PubMan Func Spec Easy Submission"

Latest revision as of 07:27, 9 September 2009

All important information has been moved to http://colab.mpdl.mpg.de/mediawiki/PubMan_Ingestion Discussions and older versions of the scenarios have been moved to http://colab.mpdl.mpg.de/mediawiki/Talk:PubMan_Ingestion

Functional Prototype

Please check the functional prototype for easy submission

Difference between revisions of "Talk:PubMan Func Spec Easy Submission"

Latest revision as of 07:27, 9 September 2009

Functional Prototype

Navigation menu

Search

@@ Line 1: / Line 1: @@
-==UC_PM_EASM_01 upload file in structured format==
-===Status/Schedule===
-*Status: '''in design'''
-*Schedule:'''R3'''
-===Motivation===
+All important information has been moved to http://colab.mpdl.mpg.de/mediawiki/PubMan_Ingestion
-*The user wants to upload a locally created BibTeX file, containing one reference.
+Discussions and older versions of the scenarios have been moved to http://colab.mpdl.mpg.de/mediawiki/Talk:PubMan_Ingestion
-===Expected outcome===
+==Functional Prototype==
-Reference is uploaded to a collection on PubMan.
-The item is created on PubMan and can be edited/modified afterwards.
-===Steps===
-# The user chooses a collection where he has depositor privileges
-# The user chooses to upload a file in structured format.
-# The user starts the upload.
-# The system processes the uploaded file, checks for completeness, creates an item and releases them immediately. The use case ends successfully.
-===Alternatives===
-. The user gets an error message, indicating type of error (time out during upload, invalid file, validation rules not met).
-a. User tries the upload again. continue with step 3.
-b. User cancels the upload procedure.
-===Actors involved===
-User with depositing rights for at least one collection
-===Data involved===
-BibTeX File, structured format. See [https://zim01.gwdg.de/repos/smc/tags/public/PubMan/example_bitex_AEI.bib example file] by the AEI.
-===Constraints===
-*BibTeX files are idiosyncratically structured; [http://www.gerd-neugebauer.de/software/TeX/BibTool.en.html BibTool] may help with preprocessing/normalization.
-Does this mean we need not to provide any mapping?--[[User:Uat|Ulla]] 11:03, 26 February 2008 (CET)
-*Basic TeX Parsing is needed to interpret non-ascii characters etc., see for example https://dev.livingreviews.org/projects/epubtk/browser/trunk/ePubTk/lib/bibtexlib.py .
-*In BibTeX fields are not repeatable; thus multiple authors need to be parsed from the ''author'' field.
-*BibTeX allows for different formats of representing an author's name; thus the parser needs to be smart enough to recognize them all. See for example http://search.cpan.org/~gward/Text-BibTeX-0.34/BibTeX/Name.pm
-===Future development===
-*Upload files in structured format containing more than one reference
-see [[Talk:PubMan_Ingestion|Ingestion]]
-=Functional Prototype=
 Please check the [https://zim01.gwdg.de/repos/smc/tags/public/PubMan/Prototypes/Easy_Submission/index.html functional prototype for easy submission]
-) Fetch MD, Step 3: Typo on GUI, short short. In addition, would re-phrase to "...might not cover all fetched Metadata".
---[[User:Uat|Ulla]] 12:35, 15 February 2008 (CET)
-==Comments Technical Team==
-Franke Michael  commented on AS-316:
-------------------------------------
-Only some remarks:
-* Abstract prototype
-- Step 2 (Select collection): Shouldn't there be a note about having only one collection or more than one?
-For Easy Submission there will be only one collection in most cases. If only one collection is available the step is not visible. --[[User:Rkiefl|Rupert]] 13:58, 27 February 2008 (CET)
-- Typo: "Contiuer and complete"
-Done --[[User:Rkiefl|Rupert]] 13:58, 27 February 2008 (CET)
-- After finishing step 5 there is a decision diamond without a condition. I guess it is the validation, right?
-Yes (abstract prototype is done by func team) --[[User:Rkiefl|Rupert]] 13:58, 27 February 2008 (CET)
-- After this decision one is led to step 1.4? I guess this is a typo, too.
-I took this out. --[[User:Rkiefl|Rupert]] 13:58, 27 February 2008 (CET)
-- Another typo: "sucess message"
-Done --[[User:Rkiefl|Rupert]] 13:58, 27 February 2008 (CET)
-- Step 2.1: I do not understand it: Is the upload and the preview on the same page? I would also appreciate some more information on the preview. Or will this be part of the GUI design?
-- Yet another typo: "successfull"
-The page flow diagram is more detailed here: Editable Preview is after step 4 (manual) or after step 3 (BibTeX/Fetch MD) on a separate page.
-* Page flow
-- The texts next to "choose collection" are swapped.
-This was wrong ... done --[[User:Rkiefl|Rupert]] 13:58, 27 February 2008 (CET)
-- From "view item version" there is no direct way to submit the item, only to the Edit item mask.
-Right! View item version is just a rough preview in this case. Because for the existing "view item version" an item must at lease be in state pending?! Please ask Natasa just to be sure.
-''Comment Natasa:''View item version step according to my understanding was invoked if user decides to preview the item quickly without invoking the Full edit mask. The item is not yet created, but is view-item-version page for VO (value object) of the item only (this means, the Submit action should be available). My comment is also in PageFlow diagram. However, the prototype does not show this, instead on BibTex_Fetch_MD_Step3 it provides two options:a) short short preview and quickly submit (please note that short preview does not show all metadata fetched) b) check or edit all available metadata
-*The prototype should not offer Option a) and option b) to be selected by the user, but should automatically invoke "option a)" - which was added with intention to provide "classical view item" no item id, no status information provided (because GUI Team thought it is too much disruption to directly show the full-edit mask as it was agreed originally. Therefore alternative approach was to make the view-item-page composed from the Value object (not retrieved from the FW) and in addition user would be able to "submit" the item (as she is doing it regularly from full edit mask) or go back to "edit" the item - by invoking the full-item edit mask. Therefore, "option a)" is what user automatically gets after Step2. --[[User:Natasab|Natasa]] 16:05, 3 March 2008 (CET)
-Done, Natasa can you please check that? --[[User:Rkiefl|Rupert]] 22:12, 3 March 2008 (CET)
-* Choose Collection
-- Can this be linked to the according colab page?
-Done --[[User:Rkiefl|Rupert]] 13:58, 27 February 2008 (CET)
-Error: it is linked to the "submit item" use case and not to "create item" use case --[[User:Natasab|Natasa]] 16:05, 3 March 2008 (CET)
-* Choose submission method
-- Where does "cancel" lead?
-Back to the Workspace ... Page Flow is updated. --[[User:Rkiefl|Rupert]] 17:09, 27 February 2008 (CET)
-''Comment Natasa:''
-*There are misleading labels: In action links on left vertical bar one has "Easy submission". Breadcrumbs say "Short Submission".
-*Proposal: why not naming "Manual submission" as "Use form for data entry" or smth similar, as manual submission is not clear --[[User:Natasab|Natasa]] 16:05, 3 March 2008 (CET)
-Not sure what a librarian would expect to see here. Perhaps we will know more after the workshop ... --[[User:Rkiefl|Rupert]] 22:12, 3 March 2008 (CET)
-* Manual submission step 2
-- "content-type" is now "content category"
-- The design of a file input cannot be influenced by CSS. It only depends on the locale set in the clients browser and on the OS (Windows, Linux, Mac). I will attach some examples. The GUI design has to take this into account.
-- I guess the red star at "genre" means that this field is mandatory. Why isn't there one at "title"?
-Done, I added another asterix to the first line of authors --[[User:Rkiefl|Rupert]] 13:58, 27 February 2008 (CET)
-''Comment Natasa''
-*please use consistent rule for labeling of fields (e.g. at present one has Upload new File, Content Category, Please Upload a file and define the type of content - here we have a mixture of sometimes camel case sometimes not, also the field label is content category and the message asks for the type of content - misleading)
-*would be useful if label "Uploaded" is changed to "File" and if the file-name does not contain the directory name but only the "C:\filename.pdf"
-*for uploaded files it would be useful if besides the "trash can" icon one has "editing icon" i.e. to be able to edit the category of the file without having to once again upload the same file for another content category (but that would also require some other extra work probably)
-*Back/Next are labels to the arrow or are buttons with the arrow icon? (not clear, preference would be to have it as a button, in a same manner as "cancel")
-*Maybe back/next can be right aligned next to each other and cancel button can be left alligned (this way it would not be central button on the form) (valid for all steps)
-*missing file visibility for files and information on the file size, mime type after the file has been uploaded
-* Manual submission step 3
-- Creator names are split up into "Name" and "Family name". I expect this would cause faulty entries, because "Name" often is associated either with the surname or with the full name. IMO "Family name" and "Given name" would be better.
-I took 'first name' because during interviews people were not sure about given name (!). --[[User:Rkiefl|Rupert]] 13:58, 27 February 2008 (CET)
-*consistent labeling needed (currently in the prototype: First Name, Family name, Creator Type - it is "Role" actually)--[[User:Natasab|Natasa]] 18:07, 3 March 2008 (CET)
-- Why should the user enter the number of a author?
-If the list contains more authors this can be used to insert the author above. --[[User:Rkiefl|Rupert]] 13:58, 27 February 2008 (CET)
-*even if this is the case it is not very nice to put numbers in, as the "old" numbers will switch (reorder). Why not simply using arrows up/down for this purpose? --[[User:Natasab|Natasa]] 18:07, 3 March 2008 (CET)
-- Once entered, an author cannot be edited anymore, can he?
-No, just removed. In most cases scientists are willing to enter only the first author or corresponding author. The first entry should be in editable state until the last entry is filled or the next-button is operated. If the last field is filled, followed by enter, the line will be not editable any more and another editable line appears. --[[User:Rkiefl|Rupert]] 13:58, 27 February 2008 (CET)
-*--[[User:Natasab|Natasa]] 18:07, 3 March 2008 (CET)it is edit form, right? Why preventing the editing in such a manner? Maybe enabling "edit icon" (same issue as for files in step 1) can explicitly enable the editing of fields for the selected row (and thus making only 1 row editable at a time) of the author. In addition moving up/down of the complete record will not be considered as editing of the row, just re-positioning of the row (in this case no explicit numbering is needed, especially not when creating the author-record).
-- If so, there should at least be the possibility to move creators up or down. Otherwise, the following can occur: The user enters 5 authors. Then she recognises that she produced at the first author. Now she has to delete all 5 authors to bring them back into the right order.
-(--[[User:Natasab|Natasa]] 18:07, 3 March 2008 (CET) Agree, see comment above as well)
-- Is there a concept for entering authors in a predefined format yet? See http://colab.mpdl.mpg.de/mediawiki/Talk:Providing_Lists_of_Authors#Varieties_of_Lists
-This would be wonderful, but lists of Authors are not scheduled for R3 so I took this simple approach. --[[User:Rkiefl|Rupert]] 13:58, 27 February 2008 (CET)
-* Manual submission step 4
-- As it is decided that ONLY the "date published in print" will be asked for, there is no need for a dropdown meny, is there?
-Could be a misunderstanding; as far as I know "one" publication date only should be possible which can have several types. The dropdown just contains a dummy entry. --[[User:Rkiefl|Rupert]] 17:09, 27 February 2008 (CET)
---[[User:Natasab|Natasa]] 18:07, 3 March 2008 (CET)According the last functional/GUI meeting, it is only "date published in print" - so no need for a dropdown menu. It would be the case for librarians then to later copy/paste the appropriate date.
-OK. --[[User:Rkiefl|Rupert]] 22:12, 3 March 2008 (CET)
-- Because "Language", "Subject" and "Abstract" follow "Title of source, I as a user would have difficulties to decide if these fields belong to my publication or to its source.
-So we put the Title of source below the other fields.--[[User:Rkiefl|Rupert]] 17:09, 27 February 2008 (CET)
-*--[[User:Natasab|Natasa]] 18:07, 3 March 2008 (CET)Or one can clearly specify the source as "separate group" visually?
-* Bibtex import step 2
-- Same for file input as above
-- If the import was successful, the user is lead to "Bibtex import step 3". What happens, if the import fails?
-*--[[User:Natasab|Natasa]] 18:27, 3 March 2008 (CET)What is the label '''Metadata source''' next to the "Provide ID" text?
-*--[[User:Natasab|Natasa]] 18:27, 3 March 2008 (CET)We have talked that the BibTex file upload should contain the possibility either to upload a file with 1 reference or to directly paste the BibTex reference in a text area field (whereas if a file with 1 reference is uploaded, users see the uploaded reference in a text area field). This is not specified on step 2.
-*Breadcrumb "Fetch Metadata" or "Provide Metadata" (consistent labeling needed)
-* Back/Next/Cancel button issue (see for Manual submission remarks above)
-Moves back to step 2 with a message above (see Page Flow). --[[User:Rkiefl|Rupert]] 17:09, 27 February 2008 (CET)
-* Bibtex import step 3
-- Here and on "Choose submission method" radio buttons are used. The user could save one click if we would use direkt links ?!?
-Right, but navigation should be done only with back and next. --[[User:Rkiefl|Rupert]] 17:09, 27 February 2008 (CET)
---[[User:Natasab|Natasa]] 18:27, 3 March 2008 (CET)
-*Why it is important to make the navigation only with back/next in "Fetch metadata" and in "choose submission method" pages (imho it can be a valid argument for "manual submission")?
-*in fetch metadata step 2 "Back" means "Choose other submission method"
-*in manual submission step 2 "Back" means "Choose other submission method" (so either label the button "change submission method" or simply remove the button and allow only for "cancel", as Step 3 from fetch metadata is to be removed anyway)
-*In manual submission giving "label" to the step such as "Title/Files", "Creators", "Publication info" and naming the "Back/Next" accordingly may be more "wordy" (of course, this is not generic solution, but it may be worth thinking)
-*In general, maybe the selected collection name is worth displaying somewhere (in the breadcrumb or somewhere else on the page) - as users already had to select it in the first place.
-Rupert: I would do so only for Full Submission. For ES it would not make sense.--[[User:Rkiefl|Rupert]] 22:12, 3 March 2008 (CET)