Difference between revisions of "PubMan Func Spec Display"
(→Medium: modified medium view) |
(→COinS: removed source in source to future dev) |
||
Line 356: | Line 356: | ||
''* Please note, that files attached to withdrawn items are not accessible'' | ''* Please note, that files attached to withdrawn items are not accessible'' | ||
=== Future developement === | |||
Include in view item version, for Publication.Source, the display of Source in Source. | |||
== COinS == | == COinS == |
Revision as of 09:29, 7 March 2008
The PubMan application will support different display types of items for lists, which can be selected by the user or defined in user preferences (item list displays).
For the display of a specific item, one view is defined (item version display).
General information on item/item list display[edit]
- List view: Labels and values are always displayed, even if there is no entry. In the case the metadata value is not provided, the information "no entry" is displayed.
- Item display: Labels and values are always displayed, even if there is no entry. In the case the metadata value is not provided, the information "no entry" is displayed. If a complete group of Metadata (e.g. source) contains no values , no labels are displayed, just the information "no entry" is displayed.
- Language flags are only being shown in the view item version.
- The order and grouping of elements is specified in GUI design.
- The Labeling of the different display types for lists is specified in GUI design.
Default system settings[edit]
The default system setting for display of lists is short display.
Item list displays[edit]
Short[edit]
Status: in design
Schedule: R3
Publication.Title
Publication.Creator
- If creator is of type person, display: <Publication.Creator.Person.FamilyName>, <Publication.Creator.Person.GivenName>
- If creator is of type organization, display: <Publication.Creator.Organization.Name>
- Creators are shown in one row and separated by semicolon. They are displayed in the same order as they have been entered.
Publication.Date
- Only one date value is displayed
- If more than one <date> is available, the display of the dates follows the priority:
- <Publication.Date.DateType = published in print>
- <Publication.Date.DateType = published online>
- <Publication.Date.DateType = accepted>
- <Publication.Date.DateType = submitted>
- <Publication.Date.DateType = modified>
- <Publication.Date.DateType = created>
Publication.Genre
Number of the Files
- If a file exists, display a fulltext symbol and show the number of attached files
- If no file exists, but a reference to an external location, the information, that a reference to a file exists, is provided.
Medium[edit]
Status: in design
Schedule: R3
Publication.Title
Publication.Creator and Publication.Creator.Person.Organization
- Publication.Creator
- Please start a new line after each creator. The display of creators might be limeted for the default view, but it should be possible to view all creators also.
- please display them in the order, they have been entered into the system
- If creator is of type person, display <Publication.Creator.Person.FamilyName>[, ] <Publication.Creator.Person.GivenName>.
- If creator of type organization, display <Publication.Creator.Organization.Name>
- If creator is of type person and if the person has an affiliated organization (Publication.Creator.Person.Organization), then display a small number behind the Given Name. This numbers are numerated and beginning with 1.
- Express the creator role of the creator.
- Publication.Creator.Person.Organization
- Display each information in a separate row:
- <Organization.Name>
- <Organization.Adress>
- <Organization.Identifier>
Publication.Date
- all dates are displayed
- Order of dates:
- <Publication.Date.DateType=created>
- <Publication.Date.DateType=modified>
- <Publication.Date.DateType=submitted>
- <Publication.Date.DateType=accepted>
- <Publication.Date.DateType=published online>
- <Publication.Date.DateType=published in print>
Publication.Genre
Publishing.Info
- Publishing Info: <Place>:<Publisher>
Publication.Event.Title
Publication.Source
- Publication.Source.Genre
- Publication.Source.Title
- Publication.Source.Volume/Publication.Source.Issue
- Publication.Source.StartPage/Publication.Source.EndPage
- Publication.Source.SequenceNumber
- Publication.Source.PublishingInfo
File information
- For each binary content, display the same fulltext symbol as in short item view. plus additional file information:
- <name of file>
- <content category>
- <visibility>
- <filedescription>
- If list is result of a search, display the text fragments with the highlighted search term. The text fragment contains the search term and 10 words before and after the highlighted hit.
- for an external locator, display following information:
- external locator
- <content category>
- <visibility>
Item version displays[edit]
Item version - all status except withdrawn[edit]
Status: in specification
Schedule: R3
Item Details[edit]
The single item version view contains following elements and properties:
Publication.Title
- display the content of the MD field Publication.Title [in font type: bold]
Publication.AlternativeTitle
- Display: Alternative Title: AlternativeTitle
Publication.Creator
- Please start a new line after each creator. The display of creators might be limeted for the default view, but it should be possible to view all creators also.
- please display them in the order, they have been entered into the system
- If creator is of type person, display <Publication.Creator.Person.FamilyName>[, ] <Publication.Creator.Person.GivenName>.
- If creator of type organization, display <Publication.Creator.Organization.Name>
- If creator is of type person and if the person has an organization (Publication.Creator.Person.Organization), then display a small number behind the Given Name. This numbers are numerated and beginning with 1.
- Express the creator role of the creator.
Publication.Creator.Person.Organization
- Display each information in a seperate row:
- <Organization.Name>
- <Organization.Adress>
- <Organization.Identifier>
Publication.Date
- All dates are displayed.
- order of dates:
- <Publication.Date.DateType = created>
- <Publication.Date.DateType = modified>
- <Publication.Date.DateType = submitted>
- <Publication.Date.DateType = accepted>
- <Publication.Date.DateType = published online>
- <Publication.Date.DateType = published in print>
- Display:
- Date <DateType>: YYYY-MM-DD
Publication.Genre
- Display:
- Genre: <Genre>
Publication.Language
- Display:
- Language of Content: <Language>
Publication.ReviewMethod
- Display:
- Review type: <ReviewMethod>
Publication.Degree
- Display:
- Degree Type: <Degree>
Publication.PublishingInfo
- Display:
- Publishing Info: <Place> : <Publisher>
- Edition: <Edition>
Publication.TotalNumberOfPages
- Display:
- Total number of pages: <TotalNumberOfPages>
Publication.Event
- Publication.Event.Title
- font type: bold
- Display:
- Title of Event: <Event.Title>
- Publication.Event.AlternativeTitle
- limit the diplay to the first 50 characters
- Display:
- Alternative Title of Event: <Event.AlternativeTitle>
- Publication.Event.Place
- Display:
- Place of Event: <Event.Title>
- Publication.Event.StartDate - Publication.Event.EndDate
- Display: <Publication.Event.StartDate> - <Publication.Event.EndDate>
- Date Format: YYYY-MM-DD - YYYY-MM-DD
- Publication.Event.InvitationStatus
- Display: Invited contribution (only if status is invited, then display this field)
Publication.Source
- Publication.Source.Gernre
- Display:
- Genre of source: <Source>
- Publication.Source.Title
- font type: bold
- Display:
- Title of Source: <Title>
- Publication.Source.!AlternativeTitle
- limit the diplay to the first 50 characters
- Display:
- Alternative Title of Source: <AlternativeTitle>
- Publication.Source.Creator
- Display:
- Source Creator: [creators as discribed under 3. Publication.Creator]
- Publication.Source.Volume/Publication.Source.Issue
- Display:
- Volume/Issue: <Volume> (<Issue>)
- Publication.Source.StartPage/Publication.Source.EndPage
- Display:
- Start/End Page: <StartPage> - <EndPage>
- Publication.Source.SequenceNumber
- Display:
- Sequence Number: <SequenceNumber>
- Publication.Source.PublishingInfo
- Display the fields as described in the follwing order:
- Publisher: <publisher>
- Place of Publication: <Place>
- Edition: <Edition>
- Publication.Source.Identifier
- Display:
- <IdType>: <identifier>
Publication.Subject
- Display:
- Subject: <Subject>
Publication.Abstract
- Display:
- Abstract: <Abstract>
Publication.TableOfContents
- Display:
- Table of Contents: <TableOfContents>
Publication.Identifier
- If more than one identifier is available, the display follows the priority: <persistent ID>, <system ID>.
- Display:
- <IdType>: <identifier>
Publication.Location
- Display:
- Location: <Location>
File information
- For each file, display the file information: <name of file>, <content category>, <size of file>, <MIME Type>, <file description>, <file visibility> and the same full text symbol as in short item view for lists.
In addition to the MD, please display up to two text fragments per full text file (in which was searched) with 10 words before and after the highlighted hit.
System details[edit]
- Affiliated to (context of responsibility)
- Name of context
- Last modified (i.e. automatic generated date of the last modification of the item)
- Display: Item last modified: YYYY-MM-DD
- Item state
- Display: Status of item: <value of item state>
- Links/Buttons to the various extension points depicted in use case View item version
Item version - status withdrawn[edit]
Status: in specification
Schedule: R3
Item details[edit]
- the same item data, as defined in the short view for item lists
Withdrawal details[edit]
- an icon for being withdrawn (e.g. thumbstone) and the information "This item has been withdrawn"
- The withdrawal comment, the withdrawal date
System details[edit]
- Affiliated to (context of responsibility)
- Name of context
- Last modified (i.e. automatic generated date of the last modification of the item)
- Display: Item last modified: YYYY-MM-DD
- Item state
- Display: Status of item: <value of item state>
* Please note, that for withdrawn items, no further actions (i.e. extensions points) are possible (See Use case View item version, Alternative)
* Please note, that files attached to withdrawn items are not accessible
Future developement[edit]
Include in view item version, for Publication.Source, the display of Source in Source.
COinS[edit]
Status: implemented partly (rft_val_fmt|| info:ofi/fmt:kev:mtx:journal is hardcoded)
Schedule: R2
In all display types, a COinS has to be provided for each item. A COinS is the representation of bibliographic information for this item in an HTML span element by re-using the key-value elements defined in the OpenURL standard,e.g.
<span class="Z3988" title="ctx_ver=Z39.88-2004&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Ajournal&rfr_id=info%3Asid%2Fwww.escidoc.de%3 Apubman&&rft.genre=article&rft.atitle=Coccidiosis+of+mammary+tissue+in+the+water+shrew%2C+Sorex+palustris+navigato r.&rft.title=Journal+of+Parasitology&rft.issn=0022-3395&rft.date=2007&rft.volume=12&rft.issue=3&rf t.spage=123&rft.epage=125&rft.aulast=Bowman&rft.aufirst=Ben&rft.au=Ben+Bowman&rft_id=info:doi/10.1046% 2F19991u38%C3%9F2"> </span>
Following values and mapping should be used to create COinS for publication items. The complete COinS needs to be URL encoded:
key | value | remark |
---|---|---|
ctx_ver | Z39.88-2004 | |
rft_val_fmt | info:ofi/fmt:kev:mtx:journal | |
rfr_id | info:sid/escidoc.mpg.de:pubman | name space |
rft.genre | <Publication.Genre> | |
rft.atitle | <Publication.Title> | |
rft.title | <Publication.Source.Title> | |
rft.aulast | <Publication.Creator.Person.Lastname> | of first author only |
rft.aufirst | <Publication.Creator.Person.Firstname> | of first author only |
rft.au | <Publication.Creator.Person.Completename> | for all users, concatenated by semicolon |
rft.issn | <Publication.Source.Identifier> or <Publication.Identifier> | of type issn |
rft.isbn | <Publication.Source.Identifier> or <Publication.Identifier> | of type isbn |
rft_id | info:doi/<Publication.Source.Identifier> | of type doi |
rft.volume | <Publication.Source.Volume> | |
rft.issue | <Publication.Source.Issue> | |
rft.pages | <Publication.Source.Pages> | |
rft.date | <Publication.Date> | if more than one publication dates is available only one should be included in following order
<Publication.Date.DateType = published in print> <Publication.Date.DateType = published online> <Publication.Date.DateType = accepted> <Publication.Date.DateType = submitted> <Publication.Date.DateType = modified> <Publication.Date.DateType = created> |
More information:
- COinS generator
- COinS information (by inga)
- http://www.niso.org/standards/standard_detail.cfm?std_id=783 - OpenURL standard