Difference between revisions of "PubMan Func Spec Display"

From MPDLMediaWiki
Jump to navigation Jump to search
(→‎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>

Item version - status withdrawn[edit]

Status: in specification

Schedule: R3

Item details[edit]

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: