sul-dlss / sul_pub

SUL system for harvest and managing publications for Stanford CAP, with controlled API access.
http://cap.stanford.edu
Other
8 stars 3 forks source link

Promote "book review" as a new document type #17

Open mejackreed opened 8 years ago

mejackreed commented 8 years ago

From @peetucket on March 16, 2016 17:44

We've discovered that although the harvest logic is supposed to ignore "book review", we are, in fact, harvesting book reviews and we're at 1661 harvested items. CAP has asked (as an enhancement) for us revise our logic and rather than stick book reviews in as an article (see this section of a record for SULPUBID 331351)

"authorcount": "1"
"keywords_sw": [ 0]
"documenttypes_sw": [ 1]
0: "Book Review"
-
"type": "article"
"documentcategory_sw": "Journal Document"

that we should create a "first class" type of "Book Review". This would require several changes.

  1. We'd need to create a new type value of "Book Review". CAP would need to have the same new high level category.
  2. For any item flagged as Book Review, we'd need to modify the logic that generates the ALA/MLA/Chicago citations to create a book review citation.
  3. CAP would need to modify the UI to account for Book Reviews as a new category.
  4. CAP would need to create a Book Review online citation format.
  5. most importantly, CAP and SUL would need to support a manually entered Book Review which would require: 5A. analysis to generate a book review online entry form, determining what are required fields, field validation rules, etc. 5B. creation of the manual entry pages by CAP 5C. modification of the API to accommodate this new doc type.

Copied from original issue: sul-dlss/sul-pub#112

mejackreed commented 8 years ago

From @darrenleeweber on March 23, 2016 21:16

There are some relevant application configuration parameters in https://github.com/sul-dlss/sul-pub/blob/master/config/application.yml#L4-L60

mejackreed commented 8 years ago

From @peetucket on April 14, 2016 17:9

CAP is now creating a citation on their side in a modified format for book reviews. We may want to still support harvesting in the future. Details from Tina:

" For the immediate issue for the Book Reviews that are already in CAP, we have modified the CAP style citation to show Book Reviews as in the following example:

Banking and business in the Roman world. (Book Review) BUSINESS HISTORY REVIEW Book Review Authored by: Saller, R. 2000; 74 (3): 483-485

We added '(Book Review)' after the title and 'Book Review Authored by:' in front of the author's list."

dazza-codes commented 6 years ago

The example for Saller, R. can seen on the profiles site at

> PublicationIdentifier.where(identifier_type: 'WosItemID', identifier_value: '000244272600114')
  PublicationIdentifier Load (4.0ms)  SELECT `publication_identifiers`.* FROM `publication_identifiers` WHERE `publication_identifiers`.`identifier_type` = 'WosItemID' AND `publication_identifiers`.`identifier_value` = '000244272600114'
=> [#<PublicationIdentifier:0x0055fd4a4a9910
  id: 1041660,
  publication_id: 331355,
  identifier_type: "WoSItemID",
  identifier_value: "000244272600114",
  identifier_uri: "https://ws.isiknowledge.com/cps/openurl/service?url_ver=Z39.88-2004&rft_id=info:ut/000244272600114",
  certainty: "confirmed",
  created_at: Wed, 17 Sep 2014 17:43:06 UTC +00:00,
  updated_at: Mon, 08 May 2017 03:59:44 UTC +00:00>]

Using the WOS client to retrieve it, we get

records = WOS.queries.retrieve_by_id(['000244272600114']);
records.first.print
<?xml version='1.0'?>
<REC r_id_disclaimer='ResearcherID data provided by Clarivate Analytics'>
  <UID>WOS:000244272600114</UID>
  <static_data>
    <summary>
      <EWUID>
        <WUID coll_id='WOS'/>
        <edition value='WOS.SSCI'/>
        <edition value='WOS.AHCI'/>
      </EWUID>
      <pub_info issue='1' pubtype='Journal' sortdate='2007-02-01' has_abstract='N' coverdate='FEB 2007' pubmonth='FEB' vol='112' pubyear='2007'>
        <page end='257' page_count='2' begin='256'>256-257</page>
      </pub_info>
      <titles count='6'>
        <title type='source'>AMERICAN HISTORICAL REVIEW</title>
        <title type='source_abbrev'>AM HIST REV</title>
        <title type='abbrev_iso'>Am. Hist. Rev.</title>
        <title type='abbrev_11'>AM HIST REV</title>
        <title type='abbrev_29'>AMER HIST REV</title>
        <title type='item'>Women's religious activity in the Roman Republic.</title>
      </titles>
      <names count='1'>
        <name daisng_id='31624016' seq_no='1' role='author' reprint='Y'>
          <display_name>Saller, Richard</display_name>
          <full_name>Saller, Richard</full_name>
          <wos_standard>Saller, R</wos_standard>
          <first_name>Richard</first_name>
          <last_name>Saller</last_name>
        </name>
      </names>
      <doctypes count='1'>
        <doctype>Book Review</doctype>
      </doctypes>
      <publishers>
        <publisher>
          <address_spec addr_no='1'>
            <full_address>GREAT CLARENDON ST, OXFORD OX2 6DP, ENGLAND</full_address>
            <city>OXFORD</city>
          </address_spec>
          <names count='1'>
            <name addr_no='1' role='publisher' seq_no='1'>
              <display_name>OXFORD UNIV PRESS</display_name>
              <full_name>OXFORD UNIV PRESS</full_name>
            </name>
          </names>
        </publisher>
      </publishers>
    </summary>
    <fullrecord_metadata>
      <languages count='1'>
        <language type='primary'>English</language>
      </languages>
      <normalized_languages count='1'>
        <language type='primary'>English</language>
      </normalized_languages>
      <normalized_doctypes count='1'>
        <doctype>Review</doctype>
      </normalized_doctypes>
      <refs count='1'/>
      <addresses count='1'>
        <address_name>
          <address_spec addr_no='1'>
            <full_address>Univ Chicago, Chicago, IL 60637 USA</full_address>
            <organizations count='2'>
              <organization>Univ Chicago</organization>
              <organization pref='Y'>University of Chicago</organization>
            </organizations>
            <city>Chicago</city>
            <state>IL</state>
            <country>USA</country>
            <zip location='AP'>60637</zip>
          </address_spec>
        </address_name>
      </addresses>
      <category_info>
        <headings count='1'>
          <heading>Arts &amp; Humanities</heading>
        </headings>
        <subjects count='3'>
          <subject ascatype='traditional' code='MM'>History</subject>
          <subject ascatype='extended'>History</subject>
          <subject ascatype='traditional' code='MM'>HISTORY</subject>
        </subjects>
      </category_info>
    </fullrecord_metadata>
    <item xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' coll_id='WOS' xsi:type='itemType_wos'>
      <ids avail='N'>137DH</ids>
      <bib_id>112 (1): 256-257 FEB 2007</bib_id>
      <bib_pagecount type='Journal'>396</bib_pagecount>
      <reviewed_work>
        <languages count='1'>
          <language>English</language>
        </languages>
        <rw_authors count='1'>
          <rw_author>Schultz, CE</rw_author>
        </rw_authors>
        <rw_year>2006</rw_year>
      </reviewed_work>
      <reprint_contact>
        <address_spec addr_no='1'>
          <full_address>Univ Chicago, Chicago, IL 60637 USA</full_address>
          <organizations count='2'>
            <organization>Univ Chicago</organization>
            <organization pref='Y'>University of Chicago</organization>
          </organizations>
          <city>Chicago</city>
          <state>IL</state>
          <country>USA</country>
          <zip location='AP'>60637</zip>
        </address_spec>
        <names count='1'>
          <name addr_no='1' role='author' seq_no='1' reprint='Y'>
            <display_name>Saller, Richard</display_name>
            <full_name>Saller, Richard</full_name>
            <wos_standard>Saller, R</wos_standard>
            <first_name>Richard</first_name>
            <last_name>Saller</last_name>
          </name>
        </names>
      </reprint_contact>
    </item>
  </static_data>
  <dynamic_data>
    <citation_related>
      <tc_list>
        <silo_tc coll_id='WOS' local_count='0'/>
      </tc_list>
    </citation_related>
    <cluster_related>
      <identifiers>
        <identifier value='0002-8762' type='issn'/>
        <identifier value='1937-5239' type='eissn'/>
        <identifier value='10.1086/ahr.112.1.256a' type='xref_doi'/>
      </identifiers>
    </cluster_related>
  </dynamic_data>
</REC>
peetucket commented 6 years ago

From the current publication we have:

pid=PublicationIdentifier.find_by(:identifier_type=>'WosItemID',:identifier_value=>'000244272600114').publication_id
pub=Publication.find(pid)
pp pub.pub_hash
 :documenttypes_sw=>["Book Review"],
 :documentcategory_sw=>"Journal Document",
 :type=>"article",

So we mapped the type "article" but the documenttypes_sw is "Book Review"...so it is possible they are using that field change their citation.