PubMan Func Spec Display

From MPDLMediaWiki
Revision as of 15:49, 26 February 2008 by Uat (talk | contribs) (→‎Full)
Jump to navigation Jump to search

The PubMan application will support different display types, which can be selected for item lists or single item views.

General information on item/item list display[edit]

  • Fields are only displayed, when they are filled.
  • Language flags are only being shown in the single item view (TBD with GUI)
  • The order of elements is decided by GUI.
  • As string for title and/or number of creators might be too long for proper display, strings might be cutted after 100 characters or cutted at word boundaries.(GUI decision)

Default system settings[edit]

The default system setting for display of lists is short display.

Item list displays[edit]

Short[edit]

Status: implemented

Schedule: R2


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

Medium[edit]

Status: implemented

Schedule: R2


Publication.Title

Display:

<Publication.title> [font type: bold]

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 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.Degree

  • Display:

Degree Type: <Degree>

Publication.Publishing.Info

  • Display:

Publishing Info: <Place>:<Publisher>

Edition:<Edition>

Publication.TotalNumberOfPages

  • Display:

Total number of pages:<TotalNumberOfPages>

Publication.Event.Title

  • Display:

Title of Event: <Event.Title>

Publication.Source

  • Publication.Source.Genre
    • Display:

Genre of Source:<Source>

  • Publication.Source.Title
    • Display:

Title of Source: <Title>

  • Publication.Source.Creator
    • Display:

Source Creator: [same as above, Publication.Creator]

  • Publication.Source.Volume/Publication.Source.Issue
    • Display:

Volume/Issue: <Volume>, (<Issue>)

  • Publication.Source.StartPage/Publication.Source.EndPage
    • Display:

Start/Endpage: <StartPage> - <EndPage>

  • Publication.Source.SequenceNumber
    • Display:

Sequence Number: <SequenceNumber>

  • Publication.Source.PublishingInfo
    • Display:

Publishing Info: <Place>: <Publisher>

Edition: <Edition>

  • Publication.Source.Identifier
    • Display:

<IdType>: <identifier>

File information

  • Display:

For each file, display the same fulltext symbol as in short item view. plus additional file information:

<name of file>

<content category>

<size of file>

<MIMEType>

<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.

Future developments[edit]

Include in Publication.Source the display of Source in Source


Future developments[edit]

Include in Publication.Source the display of Source in Source

Item version displays[edit]

Item version (all status except withdrawn)[edit]

Status: in specification

Schedule: R3

The single item version view contains the same elements as depicted for the full display in item lists, AND

  • additional information for the file information:

=> display the same fields as in full display for item lists, and in addition the

  • additional fields, which are grouped under "System details":
    • 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

The single item view for withdrawn items contains

  • an icon for being withdrawn (e.g. thumbstone) and the information "This item has been withdrawn"
  • The withdrawal comment, the withdrawal date
  • the item data, as defined in the short view for item lists
  • the System data as defined in the item view defined above
  • Please note, that for withdrawn items, no further actions (i.e. extensions points) are possible (See Use case View item version
  • Please note, that files attached to withdrawn items are not accessible

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> 


Example:

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: