id.sifa.profile.publication Documentation (EN)

main record

Record representing a single publication.

Record Key tid Timestamp-based ID

Properties

authors array of ref #author Optional

Co-authors. The record owner is always an implicit author.

maxLength: 50 items

createdAt string datetime Required

Client-declared timestamp when this record was originally created.

description string Optional

Description or abstract.

maxLength: 50000 bytesmaxGraphemes: 5000 graphemes

publishedAt string Optional

Publication date in YYYY-MM or YYYY-MM-DD format.

publisher string Optional

Publisher, journal, or venue name.

maxLength: 2560 bytesmaxGraphemes: 256 graphemes

sameAs ref id.sifa.defs#externalRecordRef Optional

The same publication as recorded on another person's profile. Set when you keep your own entry for work someone else has also recorded, so consumers can tell the two describe one thing rather than showing it twice. Each side stays its own record: the other person cannot edit yours, and yours does not change theirs. Resolve by AT-URI, since they will keep editing their copy.

subtitle string Optional

Publication subtitle. Carries the distinguishing part of a title that sources such as Crossref and ORCID store separately from the main title -- for example the volume/part designation and descriptive clause of a multi-part paper series ("III. Using cluster masses to create a cleaned catalogue"). Absent for publications with no subtitle.

maxLength: 2000 bytesmaxGraphemes: 200 graphemes

title string Required

Publication title.

maxLength: 2000 bytesminLength: 1 bytesmaxGraphemes: 200 graphemes

url string uri Optional

URL to the publication.

View raw schema

{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "title",
      "createdAt"
    ],
    "properties": {
      "url": {
        "type": "string",
        "format": "uri",
        "description": "URL to the publication.",
        "x-skos:exactMatch": [
          "bibo:uri",
          "schema:url"
        ]
      },
      "title": {
        "type": "string",
        "maxLength": 2000,
        "minLength": 1,
        "description": "Publication title.",
        "maxGraphemes": 200,
        "x-skos:exactMatch": [
          "dcterms:title",
          "schema:name"
        ]
      },
      "sameAs": {
        "ref": "id.sifa.defs#externalRecordRef",
        "type": "ref",
        "description": "The same publication as recorded on another person's profile. Set when you keep your own entry for work someone else has also recorded, so consumers can tell the two describe one thing rather than showing it twice. Each side stays its own record: the other person cannot edit yours, and yours does not change theirs. Resolve by AT-URI, since they will keep editing their copy."
      },
      "authors": {
        "type": "array",
        "items": {
          "ref": "#author",
          "type": "ref"
        },
        "maxLength": 50,
        "description": "Co-authors. The record owner is always an implicit author.",
        "x-skos:note": "bibo:authorList is an ordered rdf:List and preserves author order, which schema:author does not guarantee.",
        "x-skos:exactMatch": [
          "bibo:authorList",
          "schema:author"
        ]
      },
      "subtitle": {
        "type": "string",
        "maxLength": 2000,
        "description": "Publication subtitle. Carries the distinguishing part of a title that sources such as Crossref and ORCID store separately from the main title -- for example the volume/part designation and descriptive clause of a multi-part paper series (\"III. Using cluster masses to create a cleaned catalogue\"). Absent for publications with no subtitle.",
        "maxGraphemes": 200,
        "x-skos:closeMatch": [
          "schema:alternativeHeadline"
        ]
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "Client-declared timestamp when this record was originally created."
      },
      "publisher": {
        "type": "string",
        "maxLength": 2560,
        "description": "Publisher, journal, or venue name.",
        "maxGraphemes": 256,
        "x-skos:exactMatch": [
          "dcterms:publisher",
          "schema:publisher"
        ]
      },
      "description": {
        "type": "string",
        "maxLength": 50000,
        "description": "Description or abstract.",
        "maxGraphemes": 5000,
        "x-skos:exactMatch": [
          "bibo:abstract",
          "schema:abstract"
        ]
      },
      "publishedAt": {
        "type": "string",
        "description": "Publication date in YYYY-MM or YYYY-MM-DD format.",
        "x-skos:exactMatch": [
          "dcterms:issued",
          "schema:datePublished"
        ]
      }
    }
  },
  "description": "Record representing a single publication.",
  "x-skos:note": "Refine to bibo:AcademicArticle, bibo:Book, bibo:Report or bibo:Thesis when a resource type is known. COAR is the value anchor.",
  "x-skos:broadMatch": [
    "bibo:Document",
    "schema:CreativeWork"
  ]
}

author object

A co-author of the publication.

Properties

did string did Optional

Author's ATproto DID, if they have an account.

name string Required

Author's display name.

maxLength: 1000 bytesminLength: 1 bytesmaxGraphemes: 100 graphemes

View raw schema

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "did": {
      "type": "string",
      "format": "did",
      "description": "Author's ATproto DID, if they have an account."
    },
    "name": {
      "type": "string",
      "maxLength": 1000,
      "minLength": 1,
      "description": "Author's display name.",
      "maxGraphemes": 100
    }
  },
  "description": "A co-author of the publication."
}