Missing book information in inbook citation

[opoudjis]

doi:10.1037/0000120-016

The following is its source JSON:

{
  "status": "ok",
  "message-type": "work",
  "message-version": "1.0.0",
  "message": {
    "indexed": {
      "date-parts": [
        [
          2022,
          3,
          29
        ]
      ],
      "date-time": "2022-03-29T21:49:31Z",
      "timestamp": 1648590571265
    },
    "publisher-location": "Washington",
    "reference-count": 0,
    "publisher": "American Psychological Association",
    "content-domain": {
      "domain": [],
      "crossmark-restriction": false
    },
    "short-container-title": [],
    "published-print": {
      "date-parts": [
        [
          2019
        ]
      ]
    },
    "DOI": "10.1037/0000120-016",
    "type": "book-chapter",
    "created": {
      "date-parts": [
        [
          2018,
          12,
          6
        ]
      ],
      "date-time": "2018-12-06T14:14:50Z",
      "timestamp": 1544105690000
    },
    "page": "345-359",
    "source": "Crossref",
    "is-referenced-by-count": 6,
    "title": [
      "Culinary arts: Talent and their development."
    ],
    "prefix": "10.1037",
    "author": [
      {
        "given": "Laurent",
        "family": "Aron",
        "sequence": "first",
        "affiliation": []
      },
      {
        "given": "Marion",
        "family": "Botella",
        "sequence": "additional",
        "affiliation": []
      },
      {
        "given": "Todd",
        "family": "Lubart",
        "sequence": "additional",
        "affiliation": []
      }
    ],
    "member": "15",
    "container-title": [
      "Psychology of high performance: Developing human potential into domain-specific talent."
    ],
    "original-title": [],
    "link": [
      {
        "URL": "http://psycnet.apa.org/books/16096/016.pdf",
        "content-type": "unspecified",
        "content-version": "vor",
        "intended-application": "similarity-checking"
      }
    ],
    "deposited": {
      "date-parts": [
        [
          2020,
          12,
          28
        ]
      ],
      "date-time": "2020-12-28T18:52:59Z",
      "timestamp": 1609181579000
    },
    "score": 1,
    "resource": {
      "primary": {
        "URL": "http://content.apa.org/books/16096-016"
      }
    },
    "subtitle": [],
    "short-title": [],
    "issued": {
      "date-parts": [
        [
          2019
        ]
      ]
    },
    "references-count": 0,
    "alternative-id": [
      "2018-59444-016",
      "2018-59444-000"
    ],
    "URL": "http://dx.doi.org/10.1037/0000120-016",
    "relation": {},
    "published": {
      "date-parts": [
        [
          2019
        ]
      ]
    }
  }
}

The following is the generated Relaton XML:

<bibitem type="inbook" schema-version="v1.2.1" id="B">  <fetched>2022-12-10</fetched>
<title type="main" format="text/plain" language="en" script="Latn">Culinary arts: Talent and their development.</title>
  <uri type="DOI">http://dx.doi.org/10.1037/0000120-016</uri>  <docidentifier type="DOI" primary="true">10.1037/0000120-016</docidentifier>  <date type="created">    <on>2018-12-06</on>  </date>  <date type="issued">    <on>2019</on>  </date>  <date type="published">    <on>2019</on>  </date>  <contributor>    <role type="author"/>    <person>
<name>        <forename language="en" script="Latn">Laurent</forename>        <surname language="en" script="Latn">Aron</surname>      </name>
    </person>  </contributor>  <contributor>    <role type="author"/>    <person>
<name>        <forename language="en" script="Latn">Marion</forename>        <surname language="en" script="Latn">Botella</surname>      </name>
    </person>  </contributor>  <contributor>    <role type="author"/>    <person>
<name>        <forename language="en" script="Latn">Todd</forename>        <surname language="en" script="Latn">Lubart</surname>      </name>
    </person>  </contributor>  <contributor>    <role type="publisher"/>    <organization>
<name>American Psychological Association</name>
    </organization>  </contributor>  <place>    <city>Washington</city>    <region/>  </place></bibitem>

Again, we are missing host item information, and extent:

<bibitem>
<uri>http://psycnet.apa.org/books/16096/016.pdf</uri> # link.URL
....
<relation type="includedIn">
<bibitem type="book"> # inferred from inbook
<title>Psychology of high performance: Developing human potential into domain-specific talent</title> # container-title
<contributor/> # see below
</bibitem>
</relation>
<extent>
  <localityStack>
        <locality type="page"> # page
          <referenceFrom>345</referenceFrom>
          <referenceTo>359</referenceTo>
        </locality>
  </localityStack>
</extent>

We have an additional problem:

inbook, inproceedings, incollection works are expected to have an editor of the host item. (Only rarely does the host item have an author instead of an editor.) DOI, surprisingly, does not supply it: it only supplies the host item title. The actual citation of the chapter in APA style is:

Aron, L., Botella, M., & Lubart, T. (2019). Culinary arts: Talent and their development. In R. F. Subotnik, P. Olszewski-Kubilius, & F. C. Worrell (Eds.), The psychology of high performance: Developing human potential into domain-specific talent (pp. 345–359). American Psychological Association. https://doi.org/10.1037/0000120-016

In order to get the names of Subotnik, Olszewski-Kubilius and Worrell, we actually have to look up the matching book.

To my astonishment, CrossRef does not provide a link from the contained item to its host item. So you are going to have to do a search; and per https://www.crossref.org/documentation/retrieve-metadata/rest-api/tips-for-using-the-crossref-rest-api/ , they just want you to do a search using query.bibliographic . Include in the search: container-title, publisher, publisher-location, year, comma delimited. So:

http://api.crossref.org/works?query.bibliographic="Psychology of high performance: Developing human potential into domain-specific talent, American Psychological Association, Washington, 2019"&rows=2

(Rows 2 tells us if there is any ambiguity, but unfortunately, there will be. We just have to trust in the first result being the right one.)

That query retrieves

{
  "status": "ok",
  "message-type": "work-list",
  "message-version": "1.0.0",
  "message": {
    "facets": {},
    "total-results": 2011118,
    "items": [
      {
        "indexed": {
          "date-parts": [
            [
              2022,
              6,
              24
            ]
          ],
          "date-time": "2022-06-24T10:26:06Z",
          "timestamp": 1656066366644
        },
        "publisher-location": "Washington",
        "reference-count": 0,
        "publisher": "American Psychological Association",
        "content-domain": {
          "domain": [],
          "crossmark-restriction": false
        },
        "published-print": {
          "date-parts": [
            [
              2019
            ]
          ]
        },
        "DOI": "10.1037/0000120-003",
        "type": "book-chapter",
        "created": {
          "date-parts": [
            [
              2018,
              12,
              6
            ]
          ],
          "date-time": "2018-12-06T14:14:50Z",
          "timestamp": 1544105690000
        },
        "page": "23-58",
        "source": "Crossref",
        "is-referenced-by-count": 8,
        "title": [
          "High-performance talent development in golf."
        ],
        "prefix": "10.1037",
        "author": [
          {
            "given": "Steven T.",
            "family": "Portenga",
            "sequence": "first",
            "affiliation": []
          }
        ],
        "member": "15",
        "container-title": [
          "Psychology of high performance: Developing human potential into domain-specific talent."
        ],
        "link": [
          {
            "URL": "http://psycnet.apa.org/books/16096/003.pdf",
            "content-type": "unspecified",
            "content-version": "vor",
            "intended-application": "similarity-checking"
          }
        ],
        "deposited": {
          "date-parts": [
            [
              2020,
              12,
              28
            ]
          ],
          "date-time": "2020-12-28T18:52:41Z",
          "timestamp": 1609181561000
        },
        "score": 65.82207,
        "resource": {
          "primary": {
            "URL": "http://content.apa.org/books/16096-003"
          }
        },
        "issued": {
          "date-parts": [
            [
              2019
            ]
          ]
        },
        "references-count": 0,
        "alternative-id": [
          "2018-59444-003",
          "2018-59444-000"
        ],
        "URL": "http://dx.doi.org/10.1037/0000120-003",
        "published": {
          "date-parts": [
            [
              2019
            ]
          ]
        }
      },
      {
        "indexed": {
          "date-parts": [
            [
              2022,
              10,
              18
            ]
          ],
          "date-time": "2022-10-18T07:56:04Z",
          "timestamp": 1666079764459
        },
        "publisher-location": "Washington",
        "reference-count": 0,
        "publisher": "American Psychological Association",
        "content-domain": {
          "domain": [],
          "crossmark-restriction": false
        },
        "published-print": {
          "date-parts": [
            [
              2019
            ]
          ]
        },
        "DOI": "10.1037/0000120-002",
        "type": "book-chapter",
        "created": {
          "date-parts": [
            [
              2018,
              12,
              6
            ]
          ],
          "date-time": "2018-12-06T14:14:50Z",
          "timestamp": 1544105690000
        },
        "page": "7-20",
        "source": "Crossref",
        "is-referenced-by-count": 8,
        "title": [
          "High performance: The central psychological mechanism for talent development."
        ],
        "prefix": "10.1037",
        "member": "15",
        "container-title": [
          "Psychology of high performance: Developing human potential into domain-specific talent."
        ],
        "link": [
          {
            "URL": "http://psycnet.apa.org/books/16096/002.pdf",
            "content-type": "unspecified",
            "content-version": "vor",
            "intended-application": "similarity-checking"
          }
        ],
        "deposited": {
          "date-parts": [
            [
              2020,
              12,
              28
            ]
          ],
          "date-time": "2020-12-28T18:52:41Z",
          "timestamp": 1609181561000
        },
        "score": 65.55682,
        "resource": {
          "primary": {
            "URL": "http://content.apa.org/books/16096-002"
          }
        },
        "editor": [
          {
            "given": "Rena F.",
            "family": "Subotnik",
            "sequence": "first",
            "affiliation": []
          },
          {
            "given": "Paula",
            "family": "Olszewski-Kubilius",
            "sequence": "additional",
            "affiliation": []
          },
          {
            "given": "Frank C.",
            "family": "Worrell",
            "sequence": "additional",
            "affiliation": []
          }
        ],
        "issued": {
          "date-parts": [
            [
              2019
            ]
          ]
        },
        "references-count": 0,
        "alternative-id": [
          "2018-59444-002",
          "2018-59444-000"
        ],
        "URL": "http://dx.doi.org/10.1037/0000120-002",
        "published": {
          "date-parts": [
            [
              2019
            ]
          ]
        }
      }
    ],
    "items-per-page": 2,
    "query": {
      "start-index": 0,
      "search-terms": null
    }
  }
}

Which includes the editors we were looking for.

Yes, this is complex. But it is non-negotiable. We cannot exclude editor names from book chapters: a citation of this work which does not name Subotnik, Olszewski-Kubilius, & Worrell is simply incorrect.

[andrew2net]

(Rows 2 tells us if there is any ambiguity, but unfortunately, there will be. We just have to trust in the first result being the right one.)

@opoudjis do you mean the first result with editors? Why should we take the second row? It has even a different DOI.

[ronaldtse]

We need to be a bit careful about terminology here.

The DOI is an ISO standard with data managed by the DOI Foundation as the registration authority. It “does not” handle any bibliographic data. It only maps a DOI identifier to a URL.

There is another organization called CrossRef that is a registration agent of DOI (they pay DOI) which accepts bibliographic data when resolving DOI. Publishers who pay CrossRef are allowed to attach bibliographic data to map to their DOI identifiers when using the CrossRef system.

Technically, this gem is relaton-crossref, not relaton-doi, because it never actually talks to DOI’s systems.

[opoudjis]

You want the first result where (a) the container-title of the chapter have matches the title of what you find, and (b) the type is not book-chapter but book.

And of course the DOI is different. The chapter and the book including the chapter are different things, so they get different IDs. You are using chapter data, and supplementing it with information from the book, which is a different item.

You are by default indeed looking for an item with editors. But even if it has authors not editors, it is a match so long as the container-title of the chapter is the title of the item, the item is not a chapter but a book, and the other common attributes, year publisher publisher-location, all match.

Same goes for proceedings paper (however they call it) and proceedings.

If you haven't already done so, find a DOI item from one of each category we recognise, and include it in testing.

[andrew2net]

@opoudjis fixed, please try v 1.14.1

[opoudjis]

Almost, but not quite:

The editors you have retrieved, Subotnik, Olszewski-Kubilius and Worrell, are currently appended after the chapter authors. But they are the editors of the book, not the chapter. So they need to go inside /relation/bibitem:

  <relation type="includedIn">
    <bibitem>
      <title format="text/plain">Psychology of high performance: Developing human potential into domain-specific talent.</title>
  <contributor>
    <role type="editor"/>
    <person>
      <name>
        <forename language="en" script="Latn">Rena F.</forename>
        <surname language="en" script="Latn">Subotnik</surname>
      </name>
    </person>
  </contributor>
  <contributor>
    <role type="editor"/>
    <person>
      <name>
        <forename language="en" script="Latn">Paula</forename>
        <surname language="en" script="Latn">Olszewski-Kubilius</surname>
      </name>
    </person>
  </contributor>
  <contributor>
    <role type="editor"/>
    <person>
      <name>
        <forename language="en" script="Latn">Frank C.</forename>
        <surname language="en" script="Latn">Worrell</surname>
      </name>
    </person>
  </contributor>
    </bibitem>
  </relation>

[opoudjis]

OK, one more thing.

Books can have series. (I will need to find if Crossref models those at all.)

Chapters are included in books.

Articles are included in journals. BUT, INSTEAD, we model articles as being in series. That's a convention we're continuing with.

However, we do NOT model chapters as belonging in series.

So:

• You are currently encoding the container-title twice, as series and as relation/bibitem/title. Don't:
• chapter: no series, just includedIn
• article: no includedIn, just series.
• book: POTENTIALLY a distinct series field, if it exists, but I will find that out when I search for examples for you.