id.sifa.profile.publication
Schema Diff
+76 -0
Compatibility Analysis
Backward Compatible
Backward compatible. 12 non-breaking changes.
Non-Breaking Changes (12)
- AddedVertex AddedVertex { vertex_id: "id.sifa.defs#relatedIdentifier" }
- AddedVertex AddedVertex { vertex_id: "id.sifa.profile.publication:body.doi" }
- AddedVertex AddedVertex { vertex_id: "id.sifa.profile.publication:body.isPrimary" }
- AddedVertex AddedVertex { vertex_id: "id.sifa.profile.publication:body.relatedIdentifiers" }
- AddedVertex AddedVertex { vertex_id: "id.sifa.profile.publication:body.relatedIdentifiers:items" }
- AddedVertex AddedVertex { vertex_id: "id.sifa.profile.publication:body.type" }
- AddedEdge AddedEdge { src: "id.sifa.profile.publication:body", tgt: "id.sifa.profile.publication:body.doi", kind: "prop", name: Some("doi") }
- AddedEdge AddedEdge { src: "id.sifa.profile.publication:body", tgt: "id.sifa.profile.publication:body.isPrimary", kind: "prop", name: Some("isPrimary") }
- AddedEdge AddedEdge { src: "id.sifa.profile.publication:body", tgt: "id.sifa.profile.publication:body.relatedIdentifiers", kind: "prop", name: Some("relatedIdentifiers") }
- AddedEdge AddedEdge { src: "id.sifa.profile.publication:body", tgt: "id.sifa.profile.publication:body.type", kind: "prop", name: Some("type") }
- AddedEdge AddedEdge { src: "id.sifa.profile.publication:body.relatedIdentifiers", tgt: "id.sifa.profile.publication:body.relatedIdentifiers:items", kind: "items", name: None }
- AddedEdge AddedEdge { src: "id.sifa.profile.publication:body.relatedIdentifiers:items", tgt: "id.sifa.defs#relatedIdentifier", kind: "ref", name: None }
Migration Guidance
Added Elements
AddedVertex { vertex_id: "id.sifa.defs#relatedIdentifier" }AddedVertex { vertex_id: "id.sifa.profile.publication:body.doi" }AddedVertex { vertex_id: "id.sifa.profile.publication:body.isPrimary" }AddedVertex { vertex_id: "id.sifa.profile.publication:body.relatedIdentifiers" }AddedVertex { vertex_id: "id.sifa.profile.publication:body.relatedIdentifiers:items" }AddedVertex { vertex_id: "id.sifa.profile.publication:body.type" }
Additional Notes
- Non-breaking: AddedEdge { src: "id.sifa.profile.publication:body", tgt: "id.sifa.profile.publication:body.doi", kind: "prop", name: Some("doi") }
- Non-breaking: AddedEdge { src: "id.sifa.profile.publication:body", tgt: "id.sifa.profile.publication:body.isPrimary", kind: "prop", name: Some("isPrimary") }
- Non-breaking: AddedEdge { src: "id.sifa.profile.publication:body", tgt: "id.sifa.profile.publication:body.relatedIdentifiers", kind: "prop", name: Some("relatedIdentifiers") }
- Non-breaking: AddedEdge { src: "id.sifa.profile.publication:body", tgt: "id.sifa.profile.publication:body.type", kind: "prop", name: Some("type") }
- Non-breaking: AddedEdge { src: "id.sifa.profile.publication:body.relatedIdentifiers", tgt: "id.sifa.profile.publication:body.relatedIdentifiers:items", kind: "items", name: None }
- Non-breaking: AddedEdge { src: "id.sifa.profile.publication:body.relatedIdentifiers:items", tgt: "id.sifa.defs#relatedIdentifier", kind: "ref", name: None }
1
1
{
2
2
"$type": "com.atproto.lexicon.schema",
3
3
"defs": {
4
4
"author": {
5
5
"description": "A co-author of the publication.",
6
6
"properties": {
7
7
"did": {
8
8
"description": "Author's ATproto DID, if they have an account.",
9
9
"format": "did",
10
10
"type": "string"
11
11
},
12
12
"name": {
13
13
"description": "Author's display name.",
14
14
"maxGraphemes": 100,
15
15
"maxLength": 1000,
16
16
"minLength": 1,
17
17
"type": "string"
18
18
}
19
19
},
20
20
"required": [
21
21
"name"
22
22
],
23
23
"type": "object"
24
24
},
25
25
"main": {
26
26
"description": "Record representing a single publication.",
27
27
"key": "tid",
28
28
"record": {
29
29
"properties": {
30
30
"authors": {
31
31
"description": "Co-authors. The record owner is always an implicit author.",
32
32
"items": {
33
33
"ref": "#author",
34
34
"type": "ref"
35
35
},
36
36
"maxLength": 50,
37
37
"type": "array",
38
38
"x-skos:exactMatch": [
39
39
"bibo:authorList",
40
40
"schema:author"
41
41
],
42
42
"x-skos:note": "bibo:authorList is an ordered rdf:List and preserves author order, which schema:author does not guarantee."
43
43
},
44
44
"createdAt": {
45
45
"description": "Client-declared timestamp when this record was originally created.",
46
46
"format": "datetime",
47
47
"type": "string"
48
48
},
49
49
"description": {
50
50
"description": "Description or abstract.",
51
51
"maxGraphemes": 5000,
52
52
"maxLength": 50000,
53
53
"type": "string",
54
54
"x-skos:exactMatch": [
55
55
"bibo:abstract",
56
56
"schema:abstract"
57
57
]
58
58
},
59
+
"doi": {
60
+
"description": "Digital Object Identifier, bare rather than as a URL: \"10.1234/example\", not \"https://doi.org/10.1234/example\". A DOI identifies the work itself, so it is what two records describing one publication can be matched on. Carrying it inside `url` makes it a link and stops it being an identifier.",
61
+
"maxGraphemes": 256,
62
+
"maxLength": 2560,
63
+
"type": "string",
64
+
"x-skos:exactMatch": [
65
+
"bibo:doi",
66
+
"prism:doi"
67
+
],
68
+
"x-skos:note": "schema:identifier with a PropertyValue of propertyID 'doi' is the JSON-LD serialization; bibo:doi is the direct term."
69
+
},
70
+
"isPrimary": {
71
+
"description": "Whether this is the user's primary publication, surfaced in profile Highlights. Any entry may be primary.",
72
+
"type": "boolean"
73
+
},
59
74
"publishedAt": {
60
75
"description": "Publication date in YYYY-MM or YYYY-MM-DD format.",
61
76
"type": "string",
62
77
"x-skos:exactMatch": [
63
78
"dcterms:issued",
64
79
"schema:datePublished"
65
80
]
66
81
},
67
82
"publisher": {
68
83
"description": "Publisher, journal, or venue name.",
69
84
"maxGraphemes": 256,
70
85
"maxLength": 2560,
71
86
"type": "string",
72
87
"x-skos:exactMatch": [
73
88
"dcterms:publisher",
74
89
"schema:publisher"
75
90
]
76
91
},
92
+
"relatedIdentifiers": {
93
+
"description": "Other versions or forms of this work, such as the published version of a preprint. A consumer can show linked versions as one publication.",
94
+
"items": {
95
+
"ref": "id.sifa.defs#relatedIdentifier",
96
+
"type": "ref"
97
+
},
98
+
"maxLength": 20,
99
+
"type": "array",
100
+
"x-skos:closeMatch": [
101
+
"dcterms:relation"
102
+
]
103
+
},
77
104
"sameAs": {
78
105
"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.",
79
106
"ref": "id.sifa.defs#externalRecordRef",
80
107
"type": "ref"
81
108
},
82
109
"subtitle": {
83
110
"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.",
84
111
"maxGraphemes": 200,
85
112
"maxLength": 2000,
86
113
"type": "string",
87
114
"x-skos:closeMatch": [
88
115
"schema:alternativeHeadline"
89
116
]
90
117
},
91
118
"title": {
92
119
"description": "Publication title.",
93
120
"maxGraphemes": 200,
94
121
"maxLength": 2000,
95
122
"minLength": 1,
96
123
"type": "string",
97
124
"x-skos:exactMatch": [
98
125
"dcterms:title",
99
126
"schema:name"
100
127
]
101
128
},
129
+
"type": {
130
+
"description": "Resource type. Open set: the known values are ORCID's work-type vocabulary, which is what Sifa already ingests and stores unmapped, so a synced work round-trips without a translation table. A value outside the set is kept as written rather than rejected, because a publication that reached Sifa from somewhere other than ORCID need not fit ORCID's list.",
131
+
"knownValues": [
132
+
"journal-article",
133
+
"conference-paper",
134
+
"conference-abstract",
135
+
"conference-poster",
136
+
"book",
137
+
"book-chapter",
138
+
"book-review",
139
+
"edited-book",
140
+
"dissertation",
141
+
"preprint",
142
+
"dataset",
143
+
"report",
144
+
"review",
145
+
"patent",
146
+
"software",
147
+
"working-paper",
148
+
"artistic-performance",
149
+
"lecture-speech",
150
+
"online-resource",
151
+
"newspaper-article",
152
+
"research-technique",
153
+
"standards-and-policy",
154
+
"technical-standard",
155
+
"registered-copyright",
156
+
"translation",
157
+
"dictionary-entry",
158
+
"encyclopedia-entry",
159
+
"supervised-student-publication",
160
+
"annotation",
161
+
"test",
162
+
"spin-off-company",
163
+
"disclosure",
164
+
"license",
165
+
"trademark",
166
+
"design",
167
+
"other"
168
+
],
169
+
"maxGraphemes": 64,
170
+
"maxLength": 640,
171
+
"type": "string",
172
+
"x-skos:closeMatch": [
173
+
"dcterms:type",
174
+
"schema:additionalType"
175
+
],
176
+
"x-skos:note": "COAR Resource Types is the anchor a consumer should map to. The values here are ORCID's because that is the vocabulary the data arrives in; deviating from the id.sifa.defs token convention is deliberate, since the vocabulary is ORCID's rather than Sifa's."
177
+
},
102
178
"url": {
103
179
"description": "URL to the publication.",
104
180
"format": "uri",
105
181
"type": "string",
106
182
"x-skos:exactMatch": [
107
183
"bibo:uri",
108
184
"schema:url"
109
185
]
110
186
}
111
187
},
112
188
"required": [
113
189
"title",
114
190
"createdAt"
115
191
],
116
192
"type": "object"
117
193
},
118
194
"type": "record",
119
195
"x-skos:broadMatch": [
120
196
"bibo:Document",
121
197
"schema:CreativeWork"
122
198
],
123
199
"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."
124
200
}
125
201
},
126
202
"description": "A publication authored or co-authored by the user.",
127
203
"id": "id.sifa.profile.publication",
128
204
"lexicon": 1
129
205
}