Journal titles and ISSNs

The journal titles and issns properties contain temporal title and ISSN entries that are expected to be referred to in places where it is important to know which title or ISSN the journal had at the time of publication.

Consider the JSON document returned for the journal "Abdominal Radiology" on the API sandbox server, it has a number of registered titles:

Sample journal temporal titles

  "titles": [
    {
      "pureId": 14250944,
      "title": "Abdominal Radiology",
      "startDate": {},
      "endDate": {}
    },
    {
      "pureId": 14250945,
      "title": "Abdominal Imaging",
      "startDate": {},
      "endDate": {}
    },
    {
      "pureId": 14250947,
      "title": "Urologic Radiology",
      "startDate": {},
      "endDate": {}
    }
  ],

Let's assume that you want to create or update the journal association on a ContributionToJournal (a subtype of ResearchOutput). Here's the schema for the journal association:

Schema for JournalAssociation

    JournalAssociation:
      type: object
      properties:
        title:
          $ref: '#/components/schemas/JournalTitleRef'
        issn:
          $ref: '#/components/schemas/ISSNRef'

Where the JournalTitleRef is defined as:

Schema for JournalTitleRef

    JournalTitleRef:
      required:
      - pureId
      type: object
      properties:
        pureId:
          type: integer
          description: Pure database ID of the title. This is found by retrieving
            the Journal and going through the titles collection.
          format: int64
        title:
          type: string
          description: The title of the journal.
          readOnly: true

This specifies that the pureId value is required, and the title is read-only as it is derived from the title entry on the journal.

So when updating or creating a ContributionToJournal resource that is associated with the "Abdominal Radiology" journal it could look like the following:

Sample journal association fron contribution to journal

"journalAssociation": {
    "title": {
      "pureId": 14250945
    },
    "journal": {
      "systemName": "Journal",
      "uuid": "653a51d0-86b2-4b93-81e6-c69ae914e7a1"
    }
  },

The title.pureId property refers to the pureId value of the second title element on the sample journal referring to the journal title "Abdominal Imaging".

The pattern for referring to journal ISSN entries is the same as for the title property.