rdf-vocab 3.1.5 → 3.1.6

Sign up to get free protection for your applications and to get access to all the features.
@@ -922,7 +922,7 @@ module RDF::Vocab
922
922
  comment: %(This relates an Authority or Variant to its administrative metadata, which is, minimimally, a Class defined outside of the MADS/RDF namespace. The RecordInfo Class from the RecordInfo ontology is recommended.).freeze,
923
923
  domain: term(
924
924
  type: "owl:Class".freeze,
925
- unionOf: list("_:g10900".freeze, "_:g10920".freeze, "_:g10940".freeze)
925
+ unionOf: list("_:g10080".freeze, "_:g10100".freeze, "_:g10120".freeze)
926
926
  ),
927
927
  label: "Administrative Metadata".freeze,
928
928
  type: "owl:ObjectProperty".freeze
@@ -1004,7 +1004,7 @@ module RDF::Vocab
1004
1004
  comment: %(A code is a string of characters associated with a the authoritative or deprecated label. It may record an historical notation once used to uniquely identify a concept.).freeze,
1005
1005
  domain: term(
1006
1006
  type: "owl:Class".freeze,
1007
- unionOf: list("_:g11420".freeze, "_:g11440".freeze)
1007
+ unionOf: list("_:g10600".freeze, "_:g10620".freeze)
1008
1008
  ),
1009
1009
  label: "Code".freeze,
1010
1010
  subPropertyOf: "skos:notation".freeze,
@@ -1015,7 +1015,7 @@ module RDF::Vocab
1015
1015
  label: "Component List".freeze,
1016
1016
  range: term(
1017
1017
  type: "owl:Class".freeze,
1018
- unionOf: list("_:g11540".freeze, "_:g11560".freeze)
1018
+ unionOf: list("_:g10720".freeze, "_:g10740".freeze)
1019
1019
  ),
1020
1020
  type: "owl:ObjectProperty".freeze
1021
1021
  property :country,
@@ -1070,7 +1070,7 @@ module RDF::Vocab
1070
1070
  label: "Element List".freeze,
1071
1071
  range: term(
1072
1072
  type: "owl:Class".freeze,
1073
- unionOf: list("_:g11900".freeze, "_:g11920".freeze)
1073
+ unionOf: list("_:g11080".freeze, "_:g11100".freeze)
1074
1074
  ),
1075
1075
  type: "owl:ObjectProperty".freeze
1076
1076
  property :elementValue,
@@ -1225,7 +1225,7 @@ module RDF::Vocab
1225
1225
  label: "Has MADSCollection Member".freeze,
1226
1226
  range: term(
1227
1227
  type: "owl:Class".freeze,
1228
- unionOf: list("_:g12800".freeze, "_:g12820".freeze)
1228
+ unionOf: list("_:g11980".freeze, "_:g12000".freeze)
1229
1229
  ),
1230
1230
  subPropertyOf: "skos:member".freeze,
1231
1231
  type: "owl:ObjectProperty".freeze
@@ -1236,7 +1236,7 @@ module RDF::Vocab
1236
1236
  label: "Has MADS Scheme Member".freeze,
1237
1237
  range: term(
1238
1238
  type: "owl:Class".freeze,
1239
- unionOf: list("_:g12960".freeze, "_:g12980".freeze)
1239
+ unionOf: list("_:g12140".freeze, "_:g12160".freeze)
1240
1240
  ),
1241
1241
  type: "owl:ObjectProperty".freeze
1242
1242
  property :hasNarrowerAuthority,
@@ -1347,7 +1347,7 @@ module RDF::Vocab
1347
1347
  comment: %(Associates a Collection with a madsrdf:Authority or another madsrdf:MADSCollection.).freeze,
1348
1348
  domain: term(
1349
1349
  type: "owl:Class".freeze,
1350
- unionOf: list("_:g13540".freeze, "_:g13560".freeze)
1350
+ unionOf: list("_:g12720".freeze, "_:g12740".freeze)
1351
1351
  ),
1352
1352
  inverseOf: "mads:hasMADSCollectionMember".freeze,
1353
1353
  label: "Is Member Of MADSCollection".freeze,
@@ -1356,7 +1356,7 @@ module RDF::Vocab
1356
1356
  property :isMemberOfMADSScheme,
1357
1357
  domain: term(
1358
1358
  type: "owl:Class".freeze,
1359
- unionOf: list("_:g13640".freeze, "_:g13660".freeze)
1359
+ unionOf: list("_:g12820".freeze, "_:g12840".freeze)
1360
1360
  ),
1361
1361
  inverseOf: "mads:hasMADSSchemeMember".freeze,
1362
1362
  label: "Is Member of MADS Scheme".freeze,
@@ -1367,7 +1367,7 @@ module RDF::Vocab
1367
1367
  comment: %(Identifies a MADS Scheme in which the Authority is at the top of the hierarchy.).freeze,
1368
1368
  domain: term(
1369
1369
  type: "owl:Class".freeze,
1370
- unionOf: list("_:g13780".freeze, "_:g13800".freeze)
1370
+ unionOf: list("_:g12960".freeze, "_:g12980".freeze)
1371
1371
  ),
1372
1372
  inverseOf: "mads:hasTopMemberOfMADSScheme".freeze,
1373
1373
  label: "Is Top Member of MADS Scheme".freeze,
@@ -158,6 +158,13 @@ module RDF::Vocab
158
158
  range: "ogc:url".freeze,
159
159
  "rdfs:seeAlso": "foaf:depiction".freeze,
160
160
  type: "rdf:Property".freeze
161
+ property :"image:alt",
162
+ comment: %(A description of what is in the image \(not a caption\). If the page specifies an og:image it should specify og:image:alt.).freeze,
163
+ isDefinedBy: "og:".freeze,
164
+ label: "image:alt".freeze,
165
+ range: "ogc:url".freeze,
166
+ "rdfs:seeAlso": "og:image".freeze,
167
+ type: "rdf:Property".freeze
161
168
  property :"image:height",
162
169
  comment: %(The height of an image.).freeze,
163
170
  isDefinedBy: "og:".freeze,
@@ -177,6 +184,14 @@ module RDF::Vocab
177
184
  label: "image type".freeze,
178
185
  range: "ogc:mime_type_str".freeze,
179
186
  type: "rdf:Property".freeze
187
+ property :"image:url",
188
+ comment: %(Identical to og:image.).freeze,
189
+ isDefinedBy: "og:".freeze,
190
+ label: "image:url".freeze,
191
+ "owl:sameProperty": "og:image".freeze,
192
+ range: "ogc:url".freeze,
193
+ "rdfs:seeAlso": "og:image".freeze,
194
+ type: "rdf:Property".freeze
180
195
  property :"image:width",
181
196
  comment: %(The width of an image.).freeze,
182
197
  isDefinedBy: "og:".freeze,
@@ -201,6 +216,13 @@ module RDF::Vocab
201
216
  label: "locale".freeze,
202
217
  range: "ogc:string".freeze,
203
218
  type: "rdf:Property".freeze
219
+ property :"locale:alternate",
220
+ comment: %(An array of other locales this page is available in.).freeze,
221
+ isDefinedBy: "og:".freeze,
222
+ label: "locale:alternate".freeze,
223
+ range: "ogc:string".freeze,
224
+ "rdfs:seeAlso": "og:locale".freeze,
225
+ type: "rdf:Property".freeze
204
226
  property :locality,
205
227
  comment: %([DEPRECATED] The locality of the resource e.g, "Palo Alto").freeze,
206
228
  isDefinedBy: "og:".freeze,
@@ -18,9 +18,9 @@ module RDF::Vocab
18
18
  # # @return [RDF::Vocabulary::Term]
19
19
  # attr_reader :Agent
20
20
  #
21
- # # Rationale Specific dates may apply to the particular rights statement.
22
- # #
23
21
  # # Definition: The date range during which the particular rights statement applies or is applied to the content.
22
+ # #
23
+ # # Rationale Specific dates may apply to the particular rights statement.
24
24
  # # @return [RDF::Vocabulary::Term]
25
25
  # attr_reader :ApplicableDates
26
26
  #
@@ -28,35 +28,35 @@ module RDF::Vocab
28
28
  # # @return [RDF::Vocabulary::Term]
29
29
  # attr_reader :Bitstream
30
30
  #
31
+ # # Creation / Maintenance Notes: A preservation repository should never refer to content that it does not control. Therefore, the PREMIS working group assumed that the repository will always assign the contentLocation, probably by program.
32
+ # #
31
33
  # # Definition: Information needed to retrieve a file from the storage system, or to access a bitstream within a file.
32
34
  # #
33
35
  # # Usage Notes: If the preservation repository uses the objectIdentifier as a handle for retrieving data, contentLocation is implicit and does not need to be recorded.
34
- # #
35
- # # Creation / Maintenance Notes: A preservation repository should never refer to content that it does not control. Therefore, the PREMIS working group assumed that the repository will always assign the contentLocation, probably by program.
36
36
  # # @return [RDF::Vocabulary::Term]
37
37
  # attr_reader :ContentLocation
38
38
  #
39
- # # Definition: Information about the copyright status of the object(s).
40
- # #
41
39
  # # Usage Notes: When rights basis is a copyright, copyrightInformation should be provided. Repositories may need to extend this with more detailed information. See the California Digital Library's copyrightMD schema (www.cdlib.org/inside/projects/rights/schema/) for an example of a more detailed scheme.
40
+ # #
41
+ # # Definition: Information about the copyright status of the object(s).
42
42
  # # @return [RDF::Vocabulary::Term]
43
43
  # attr_reader :CopyrightInformation
44
44
  #
45
45
  # # Creation / Maintenance Notes: If the object was created by the repository, assignment of creating application information should be straightforward. If the object was created outside the repository, it is possible this information could be supplied by the depositor. It might also be extracted from the file itself; the name of the creating application is often embedded within the file.
46
46
  # #
47
- # # Definition: Information about the application that created the object.
48
- # #
49
47
  # # Rationale: Information about the creating application, including the version of the application and the date the file was created, can be useful for problem solving purposes. For example, it is not uncommon for certain versions of software to be known for causing conversion errors or introducing artifacts. It is also useful to determine which rendering software is available for the digital object. For example, if you know that the Distiller program created the PDF file, you know it will be renderable with (among other programs) Adobe Reader.
50
48
  # #
49
+ # # Definition: Information about the application that created the object.
50
+ # #
51
51
  # # Usage Notes: This semantic unit applies to both objects created external to the repository and subsequently ingested, and to objects created by the repository, for example, through migration events. The creatingApplication container is repeatable if more than one application processed the object in turn. For example, a file could be created by Microsoft Word and later turned into a PDF using Adobe Acrobat. Details of both the Word and Acrobat applications may be recorded. However, if both files are stored in the repository, each file should be completely described as an Object entity and linked by using relationship information with a relationshipType “derivation.” It may also be repeated to record the creating application before the object was ingested as well as the creating application used as part of the ingest process. For example, an HTML file was created pre-ingest using Dreamweaver, and the Web crawler Heritrix then captured a snapshot of the files as part of the ingest. The amount of information needed for creatingApplication given here is minimal. For more granularity, extensibility is provided. Rather than having each repository record this locally, it would be preferable to have a registry of this information similar to format or environment registries.
52
52
  # # @return [RDF::Vocabulary::Term]
53
53
  # attr_reader :CreatingApplication
54
54
  #
55
- # # Usage Notes: This semantic unit is for additional objects that are necessary to render a file or representation, not for required software or hardware. It may also be used for a non-executable component of the object, such as a font or style sheet. For things that the software requires, see swDependency. This semantic unit does not include objects required by structural relationships, such as child content objects (e.g., figures that are part of an article), which are recorded under relationship with a relationshipType of “structural”. It is up to the repository to determine what constitutes a dependency in the context of the designated community. The objects noted may be internal or external to the preservation repository.
56
- # #
57
55
  # # Creation / Maintenance Notes: Recommended practice is for a repository to archive objects on which other objects depend. These may be sent by the submitter of the primary object, or they may in some cases be automatically obtained by the repository. For example, a markup file will often contain links to other objects it requires such as DTDs or XML Schema. If it does, these objects can often be identified by the link and downloaded by the repository.
58
56
  # #
59
57
  # # Definition: Information about a non-software component or associated file needed in order to use or render the representation or file, for example, a schema, a DTD, or an entity file declaration.
58
+ # #
59
+ # # Usage Notes: This semantic unit is for additional objects that are necessary to render a file or representation, not for required software or hardware. It may also be used for a non-executable component of the object, such as a font or style sheet. For things that the software requires, see swDependency. This semantic unit does not include objects required by structural relationships, such as child content objects (e.g., figures that are part of an article), which are recorded under relationship with a relationshipType of “structural”. It is up to the repository to determine what constitutes a dependency in the context of the designated community. The objects noted may be internal or external to the preservation repository.
60
60
  # # @return [RDF::Vocabulary::Term]
61
61
  # attr_reader :Dependency
62
62
  #
@@ -76,11 +76,11 @@ module RDF::Vocab
76
76
  # # @return [RDF::Vocabulary::Term]
77
77
  # attr_reader :Event
78
78
  #
79
- # # Usage Notes: This may be used to record all error and warning messages issued by a program involved in the event or to record a pointer to an error log. If the event was a validity check (e.g., profile conformance) any anomalies or quirks discovered would be recorded here. All subunits of this semantic unit are optional. At least one subunit (i.e. eventOutcomeDetailNote and/or eventOutcomeDetailExtension) must be present if this container is included.
79
+ # # Definition: A detailed description of the result or product of the event.
80
80
  # #
81
81
  # # Rationale: An event outcome may be sufficiently complex that a coded description is not adequate to document it.
82
82
  # #
83
- # # Definition: A detailed description of the result or product of the event.
83
+ # # Usage Notes: This may be used to record all error and warning messages issued by a program involved in the event or to record a pointer to an error log. If the event was a validity check (e.g., profile conformance) any anomalies or quirks discovered would be recorded here. All subunits of this semantic unit are optional. At least one subunit (i.e. eventOutcomeDetailNote and/or eventOutcomeDetailExtension) must be present if this container is included.
84
84
  # # @return [RDF::Vocabulary::Term]
85
85
  # attr_reader :EventOutcomeDetail
86
86
  #
@@ -94,21 +94,21 @@ module RDF::Vocab
94
94
  # # @return [RDF::Vocabulary::Term]
95
95
  # attr_reader :File
96
96
  #
97
- # # Definition: Information used to verify whether an object has been altered in an undocumented or unauthorized way.
98
- # #
99
97
  # # Usage Notes: To perform a fixity check, a message digest calculated at some earlier time is compared with a message digest calculated at a later time. If the digests are the same, the object was not altered in the interim. Recommended practice is to use two or more message digests calculated by different algorithms. (Note that the terms “message digest” and “checksum” are commonly used interchangeably. However, the term “checksum” is more correctly used for the product of a cyclical redundancy check (CRC), whereas the term “message digest” refers to the result of a cryptographic hash function, which is what is referred to here.) The act of performing a fixity check and the date it occurred would be recorded as an Event. The result of the check would be recorded as the eventOutcome. Therefore, only the messageDigestAlgorithm and messageDigest need to be recorded as objectCharacteristics for future comparison. Representation level: It could be argued that if a representation consists of a single file or if all the files comprised by a representation are combined (e.g., zipped) into a single file, then a fixity check could be performed on the representation. However, in both cases the fixity check is actually being performed on a file, which in this case happens to be coincidental with a representation. Bitstream level: Message digests can be computed for bitstreams although they are not as common as with files. For example, the JPX format, which is a JPEG2000 format, supports the inclusion of MD5 or SHA-1 message digests in internal metadata that was calculated on any range of bytes of the file.
100
98
  # #
101
99
  # # Creation / Maintenance Notes: Automatically calculated and recorded by repository.
100
+ # #
101
+ # # Definition: Information used to verify whether an object has been altered in an undocumented or unauthorized way.
102
102
  # # @return [RDF::Vocabulary::Term]
103
103
  # attr_reader :Fixity
104
104
  #
105
105
  # # Usage Notes: A bitstream embedded within a file may have different characteristics than the larger file. For example, a bitstream in LaTex format could be embedded within an SGML file, or multiple images using different colorspaces could be embedded within a TIFF file. format must be recorded for every object. When the bitstream format can be recognized by the repository and the repository might want to treat the bitstream differently from the embedding file for preservation purposes, format can be recorded for embedded bitstreams. Although this semantic unit is mandatory, both of its subunits are optional. At least one subunit (i.e. either formatDesignation or formatRegistry) must be present if this container is included or both may be used. If the subunit (formatDesignation or formatRegistry) needs to be repeated, the entire format container is repeated. This allows for association of format designation with a particular set of format registry information. For example, if the precise format cannot be determined and two format designations are recorded, each is given within a separate format container. The format container may also be repeated for multiple format registry entries.
106
106
  # #
107
- # # Definition: Identification of the format of a file or bitstream where format is the organization of digital information according to preset specifications.
108
- # #
109
107
  # # Creation / Maintenance Notes: The format of a file or bitstream should be ascertained by the repository on ingest. Even if this information is provided by the submitter, directly in metadata or indirectly via the file name extension, recommended practice is to independently identify the format by parsing the file when possible. If the format cannot be identified at the time of ingest, it is valid to record that it is unknown, but the repository should subsequently make an effort to identify the format, even if manual intervention is required.
110
108
  # #
111
109
  # # Rationale: Many preservation activities depend on detailed knowledge about the format of the digital object. An accurate identification of format is essential. The identification provided, whether by name or pointer into a format registry, should be sufficient to associate the object with more detailed format information.
110
+ # #
111
+ # # Definition: Identification of the format of a file or bitstream where format is the organization of digital information according to preset specifications.
112
112
  # # @return [RDF::Vocabulary::Term]
113
113
  # attr_reader :Format
114
114
  #
@@ -118,11 +118,11 @@ module RDF::Vocab
118
118
  # # @return [RDF::Vocabulary::Term]
119
119
  # attr_reader :FormatDesignation
120
120
  #
121
- # # Definition: Identifies and/or gives further information about the format by reference to an entry in a format registry.
122
- # #
123
121
  # # Rationale: If central format registries are available to the preservation repository, they may provide an excellent way of referencing detailed format information.
124
122
  # #
125
123
  # # Usage Notes: Either formatDesignation or at least one instance of formatRegistry is required. If more than one formatRegistry needs to be recorded the format container should be repeated to include each additional set of formatRegistry information. The PREMIS working group assumed that a number of format registries will be developed and maintained to support digital preservation efforts. The proposal for a Global Digital Format Registry (GDFR) (http://hul.harvard.edu/gdfr/documents.html#data), for example, would create a network-accessible registry designed to store detailed specifications on formats and profiles.
124
+ # #
125
+ # # Definition: Identifies and/or gives further information about the format by reference to an entry in a format registry.
126
126
  # # @return [RDF::Vocabulary::Term]
127
127
  # attr_reader :FormatRegistry
128
128
  #
@@ -136,19 +136,19 @@ module RDF::Vocab
136
136
  # # @return [RDF::Vocabulary::Term]
137
137
  # attr_reader :Identifier
138
138
  #
139
- # # Definition: Features of the object intended to inhibit access, use, or migration.
140
- # #
141
- # # Creation / Maintenance Notes: Inhibitors are more likely to be present on an object ingested by the repository than applied by the repository itself. It is often not possible to tell that a file has been encrypted by parsing it; the file may appear to be ASCII text. Therefore, information about inhibitors should be supplied as metadata with submitted objects when possible.
139
+ # # Rationale: Format information may indicate whether a file is encrypted, but the nature of the encryption also must be recorded, as well as the access key.
142
140
  # #
143
141
  # # Usage Notes: Some file formats allow encryption for embedded bitstreams. Some file formats such as PDF use passwords to control access to content or specific functions. Although this is actually implemented at the bitstream level, for preservation purposes it is effectively managed at the file level; that is, passwords would not be recorded for individually addressable bitstreams. For certain types of inhibitor keys, more granularity may be required. If the inhibitor key information is identical to key information in digital signatures, use those semantic units.
144
142
  # #
145
- # # Rationale: Format information may indicate whether a file is encrypted, but the nature of the encryption also must be recorded, as well as the access key.
143
+ # # Creation / Maintenance Notes: Inhibitors are more likely to be present on an object ingested by the repository than applied by the repository itself. It is often not possible to tell that a file has been encrypted by parsing it; the file may appear to be ASCII text. Therefore, information about inhibitors should be supplied as metadata with submitted objects when possible.
144
+ # #
145
+ # # Definition: Features of the object intended to inhibit access, use, or migration.
146
146
  # # @return [RDF::Vocabulary::Term]
147
147
  # attr_reader :Inhibitors
148
148
  #
149
- # # Definition: a set of content that is considered a single intellectual unit for purposes of management and description: for example, a particular book, map, photograph, or database. An Intellectual Entity can include other Intellectual Entities; for example, a Web site can include a Web page; a Web page can include an image. An Intellectual Entity may have one or more digital representations.
150
- # #
151
149
  # # Intellectual entities are described via Descriptive metadata models. These are very domain-specific and are out of scope for PREMIS. Examples: Dublin Core, Mets, MARC
150
+ # #
151
+ # # Definition: a set of content that is considered a single intellectual unit for purposes of management and description: for example, a particular book, map, photograph, or database. An Intellectual Entity can include other Intellectual Entities; for example, a Web site can include a Web page; a Web page can include an image. An Intellectual Entity may have one or more digital representations.
152
152
  # # @return [RDF::Vocabulary::Term]
153
153
  # attr_reader :IntellectualEntity
154
154
  #
@@ -158,19 +158,19 @@ module RDF::Vocab
158
158
  # # @return [RDF::Vocabulary::Term]
159
159
  # attr_reader :LicenseInformation
160
160
  #
161
+ # # Entity properties: Can be associated with one or more rights statements. Can participate in one or more events. Links between entities may be recorded from either direction and need not be bi-directional.
162
+ # #
161
163
  # # The object class aggregates information about a digital object held by a preservation repository and describes those characteristics relevant to preservation management. The only mandatory property is objectIdentifier. The object class has three subclasses: Representation, File, and Bitstream.
162
164
  # #
163
165
  # # Entity types: Representation: A digital object instantiating or embodying an Intellectual Entity. A representation is the set of stored digital files and structural metadata needed to provide a complete and reasonable rendition of the Intellectual Entity. File: A named and ordered sequence of bytes that is known to an operating system. Bitstream: Contiguous or non-contiguous data within a file that has meaningful properties for preservation purposes.
164
- # #
165
- # # Entity properties: Can be associated with one or more rights statements. Can participate in one or more events. Links between entities may be recorded from either direction and need not be bi-directional.
166
166
  # # @return [RDF::Vocabulary::Term]
167
167
  # attr_reader :Object
168
168
  #
169
169
  # # Usage Notes: The semantic units included in objectCharacteristics should be treated as a set of information that pertains to a single object at a single compositionLevel. Object characteristics may be repeated when an object was created by applying two or more encodings, such as compression and encryption. In this case each repetition of objectCharacteristics would have an incrementally higher compositionLevel. When encryption is applied, the objectCharacteristics block must include an inhibitors semantic unit. A bitstream embedded within a file may have different object characteristics than the file. Where these characteristics are relevant for preservation, they should be recorded. When a single file is equivalent to a representation, objectCharacteristics may be applied and thus associated with the representation. In these cases, the relationship between the file comprising the representation and other associated files may be expressed using relationshipSubType.
170
170
  # #
171
- # # Rationale: There are some important technical properties that apply to objects of any format. Detailed definition of format-specific properties is outside the scope of this Data Dictionary, although such properties may be included within objectCharacteristicsExtension.
172
- # #
173
171
  # # Definition: Technical properties of a file or bitstream that are applicable to all or most formats.
172
+ # #
173
+ # # Rationale: There are some important technical properties that apply to objects of any format. Detailed definition of format-specific properties is outside the scope of this Data Dictionary, although such properties may be included within objectCharacteristicsExtension.
174
174
  # # @return [RDF::Vocabulary::Term]
175
175
  # attr_reader :ObjectCharacteristics
176
176
  #
@@ -178,19 +178,19 @@ module RDF::Vocab
178
178
  # # @return [RDF::Vocabulary::Term]
179
179
  # attr_reader :PremisEntity
180
180
  #
181
- # # Definition: Information indicating the decision or policy on the set of preservation functions to be applied to an object and the context in which the decision or policy was made.
182
- # #
183
181
  # # Creation / Maintenance Notes: The preservation level may be assigned by the repository or requested by the depositor and submitted as metadata. The repository may also choose to record additional metadata indicating the context for the assignment of the preservation level.
184
182
  # #
185
- # # Usage Notes: If the repository offers only a single preservation level, this value does not need to be explicitly recorded within the repository. Application of a particular set of preservationLevel semantic units may only cover a single representation of an object: representations in other technical forms or serving other functions may have a different preservationLevel applied. The container may be repeated if a preservation level value needs to be recorded in additional contexts (see preservationLevelRole).
186
- # #
187
183
  # # Rationale: Some preservation repositories will offer multiple preservation options depending on factors such as the value or uniqueness of the material, the “preservability” of the format, the amount the customer is willing to pay, etc. The context surrounding the choice of a particular preservation option for an object may also require further explanation.
184
+ # #
185
+ # # Definition: Information indicating the decision or policy on the set of preservation functions to be applied to an object and the context in which the decision or policy was made.
186
+ # #
187
+ # # Usage Notes: If the repository offers only a single preservation level, this value does not need to be explicitly recorded within the repository. Application of a particular set of preservationLevel semantic units may only cover a single representation of an object: representations in other technical forms or serving other functions may have a different preservationLevel applied. The container may be repeated if a preservation level value needs to be recorded in additional contexts (see preservationLevelRole).
188
188
  # # @return [RDF::Vocabulary::Term]
189
189
  # attr_reader :PreservationLevel
190
190
  #
191
- # # Usage Notes: The related object may or may not be held within the preservation repository. Recommended practice is that objects reside within the repository unless there is a good reason to reference an object outside. Internal and external references should be clear.
192
- # #
193
191
  # # Definition: The identifier and sequential context of the related resource
192
+ # #
193
+ # # Usage Notes: The related object may or may not be held within the preservation repository. Recommended practice is that objects reside within the repository unless there is a good reason to reference an object outside. Internal and external references should be clear.
194
194
  # # @return [RDF::Vocabulary::Term]
195
195
  # attr_reader :RelatedObjectIdentification
196
196
  #
@@ -214,11 +214,11 @@ module RDF::Vocab
214
214
  # # @return [RDF::Vocabulary::Term]
215
215
  # attr_reader :RightsStatement
216
216
  #
217
+ # # Rationale: A repository may have a policy of generating digital signatures for files on ingest, or may have a need to store and later validate incoming digital signatures.
218
+ # #
217
219
  # # Definition: Information needed to use a digital signature to authenticate the signer of an object and/or the information contained in the object.
218
220
  # #
219
221
  # # Usage Notes: Several of the semantic components of signatureInformation are taken from the W3C’s XML-Signature Syntax and Processing; see www.w3.org/TR/2002/REC-xmldsig-core-20020212/ for more information on the structure and application of these semantic units.
220
- # #
221
- # # Rationale: A repository may have a policy of generating digital signatures for files on ingest, or may have a need to store and later validate incoming digital signatures.
222
222
  # # @return [RDF::Vocabulary::Term]
223
223
  # attr_reader :Signature
224
224
  #
@@ -226,29 +226,29 @@ module RDF::Vocab
226
226
  # #
227
227
  # # Rationale: Objects that have the same technical properties may still differ as to the properties that should be preserved for future presentation or use.
228
228
  # #
229
- # # Usage Notes: All of this semantic unit’s subunits are optional. At least one of the significantPropertiesValue and significantPropertiesExtension subunits must be present if this container is included or both may be used. Significant properties may be objective technical characteristics subjectively considered important, or subjectively determined characteristics. For example, a PDF may contain links that are not considered important and JavaScript that is considered important. Or future migrations of a TIFF image may require optimization for line clarity or for color; the option chosen would depend upon a curatorial judgment of the significant properties of the image. Listing significant properties implies that the repository plans to preserve these properties across time and requires them to acceptably survive preservation action; for example, to be maintained during emulation or after format migration. It also implies that the repository would note when preservation action results in modification of significant properties. In practice, significant properties might be used as measures of preservation success, as part of quality checking the results of a preservation action or evaluating the efficacy of a preservation method. For example, if the listed significant properties are not maintained after application of a particular preservation method, it may indicate a failure of the process or that the method is not well suited to the type of material. More experience with digital preservation is needed to determine the best ways of representing significant properties in general, and of representing modification of significant properties. The semantic units included in the significantProperties container aim to provide a flexible structure for describing significant properties, allowing general types of aspects, facets or attributes of an object to be declared and to be paired with specific significant details about the object pertaining to that aspect, facet or attribute. For example, some repositories may define significant properties for objects related to facets of content, appearance, structure, behavior, and context. Examples of facet:detail pairs in this case could include: significantPropertiesType = “content” significantPropertiesValue = “all textual content and images” significantPropertiesType = “behavior” significantPropertiesValue = “editable” Other repositories may choose to describe significant properties at a more granular attribute level; for example: significantPropertiesType = “page count” significantPropertiesValue = “7” significantPropertiesType = “page width” significantPropertiesValue = “210 mm” Each facet:detail pair should be contained in a separate, repeated significantProperties container. Further work on determining and describing significant properties may yield more detailed schemes to facilitate general description. Representing modification of significant properties as a result of preservation action also requires further work. One possible way involves the use of Object and Event information: Object A has significant properties volume and timing, which are recorded as significantProperties of A. In migrated version B, the timing is modified, which is noted in the eventOutcome of the migration event. Only volume is listed as a significant property of B.
230
- # #
231
229
  # # Creation / Maintenance Notes: Significant properties may pertain to all objects of a certain class; for example, the repository can decide that for all PDF files, only the content need be preserved. In other cases, for example, for media art, the significant properties may be unique to each individual object. Where values are unique, they must be supplied by the submitter or provided by the curatorial staff of the repository.
230
+ # #
231
+ # # Usage Notes: All of this semantic unit’s subunits are optional. At least one of the significantPropertiesValue and significantPropertiesExtension subunits must be present if this container is included or both may be used. Significant properties may be objective technical characteristics subjectively considered important, or subjectively determined characteristics. For example, a PDF may contain links that are not considered important and JavaScript that is considered important. Or future migrations of a TIFF image may require optimization for line clarity or for color; the option chosen would depend upon a curatorial judgment of the significant properties of the image. Listing significant properties implies that the repository plans to preserve these properties across time and requires them to acceptably survive preservation action; for example, to be maintained during emulation or after format migration. It also implies that the repository would note when preservation action results in modification of significant properties. In practice, significant properties might be used as measures of preservation success, as part of quality checking the results of a preservation action or evaluating the efficacy of a preservation method. For example, if the listed significant properties are not maintained after application of a particular preservation method, it may indicate a failure of the process or that the method is not well suited to the type of material. More experience with digital preservation is needed to determine the best ways of representing significant properties in general, and of representing modification of significant properties. The semantic units included in the significantProperties container aim to provide a flexible structure for describing significant properties, allowing general types of aspects, facets or attributes of an object to be declared and to be paired with specific significant details about the object pertaining to that aspect, facet or attribute. For example, some repositories may define significant properties for objects related to facets of content, appearance, structure, behavior, and context. Examples of facet:detail pairs in this case could include: significantPropertiesType = “content” significantPropertiesValue = “all textual content and images” significantPropertiesType = “behavior” significantPropertiesValue = “editable” Other repositories may choose to describe significant properties at a more granular attribute level; for example: significantPropertiesType = “page count” significantPropertiesValue = “7” significantPropertiesType = “page width” significantPropertiesValue = “210 mm” Each facet:detail pair should be contained in a separate, repeated significantProperties container. Further work on determining and describing significant properties may yield more detailed schemes to facilitate general description. Representing modification of significant properties as a result of preservation action also requires further work. One possible way involves the use of Object and Event information: Object A has significant properties volume and timing, which are recorded as significantProperties of A. In migrated version B, the timing is modified, which is noted in the eventOutcome of the migration event. Only volume is listed as a significant property of B.
232
232
  # # @return [RDF::Vocabulary::Term]
233
233
  # attr_reader :SignificantProperties
234
234
  #
235
- # # Definition: Software required to render or use the object.
236
- # #
237
235
  # # Creation / Maintenance Notes: If recording this explicitly, many different software environments may apply; for example, a particular object such as a PDF file may be viewable by several versions of several applications running under several operating systems and operating system versions. Although at least one software environment should be recorded, it is not necessary to record them all and each repository will have to make its own decisions about which software environments to record. Also, what appears to the user as a single rendering program can have many dependencies, including system utilities, runtime libraries, and so on, which each might have their own dependencies in turn. As with environment, metadata may be more efficiently managed in conjunction with a format registry either internal or external to a repository. In the absence of a global mechanism, repositories may be forced to develop their own local “registries” relating format to software environment.
236
+ # #
237
+ # # Definition: Software required to render or use the object.
238
238
  # # @return [RDF::Vocabulary::Term]
239
239
  # attr_reader :Software
240
240
  #
241
- # # Usage Notes: When rights basis is a statute, statuteInformation should be provided.
242
- # #
243
241
  # # Definition: Information about the statute allowing use of the object.
242
+ # #
243
+ # # Usage Notes: When rights basis is a statute, statuteInformation should be provided.
244
244
  # # @return [RDF::Vocabulary::Term]
245
245
  # attr_reader :StatuteInformation
246
246
  #
247
+ # # Definition: Information about how and where a file is stored in the storage system.
248
+ # #
247
249
  # # Rationale: It is necessary for a repository to associate the contentLocation with the storageMedium.
248
250
  # #
249
251
  # # Usage Notes: Normally there would be a single storage location and medium for an object, because an object in another location would be considered a different object. The storage composite should be repeated if there are two or more copies that are identical bit-wise and managed as a unit except for the medium on which they are stored. They must have a single objectIdentifier and be managed as a single object by the repository. Although this semantic unit is mandatory, both of its subunits are optional. At least one subunit (i.e. either contentLocation or storageMedium) must be present or both may be used.
250
- # #
251
- # # Definition: Information about how and where a file is stored in the storage system.
252
252
  # # @return [RDF::Vocabulary::Term]
253
253
  # attr_reader :Storage
254
254
  #
@@ -264,258 +264,258 @@ module RDF::Vocab
264
264
  # # @return [RDF::Vocabulary::Term]
265
265
  # attr_reader :TermOfRestriction
266
266
  #
267
- # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
268
- # #
269
267
  # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/actionsGranted
270
268
  # #
269
+ # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
270
+ # #
271
271
  # # Definition: The action the preservation repository is allowed to take.
272
272
  # # @return [RDF::Vocabulary::Term]
273
273
  # attr_reader :hasAct
274
274
  #
275
- # # Rationale: Digital provenance requires often that relationships between agents and events are documented. The role of the associated agent may need to be documented. For this, a SKOS vocabulary can be used. The LOC will publish a vocabulary at http://id.loc.gov/, denoting the agent's role. These vocabulary will publish the concepts also as subproperties to the linkingAgent property, for denoting the role of the agent in the event or rightsstatement.
276
- # #
277
275
  # # Definition: link to the associated Agent.
276
+ # #
277
+ # # Rationale: Digital provenance requires often that relationships between agents and events are documented. The role of the associated agent may need to be documented. For this, a SKOS vocabulary can be used. The LOC will publish a vocabulary at http://id.loc.gov/, denoting the agent's role. These vocabulary will publish the concepts also as subproperties to the linkingAgent property, for denoting the role of the agent in the event or rightsstatement.
278
278
  # # @return [RDF::Vocabulary::Term]
279
279
  # attr_reader :hasAgent
280
280
  #
281
- # # Rationale: This semantic unit provides a more reader-friendly version of the agent identified by the agentIdentifier.
282
- # #
283
281
  # # Usage Note: The value is not necessarily unique.
284
282
  # #
285
283
  # # Definition: A text string which could be used in addition to agentIdentifier to identify an agent.
286
284
  # #
287
285
  # # Examples: Erik Owens, Pc
286
+ # #
287
+ # # Rationale: This semantic unit provides a more reader-friendly version of the agent identified by the agentIdentifier.
288
288
  # # @return [RDF::Vocabulary::Term]
289
289
  # attr_reader :hasAgentName
290
290
  #
291
- # # Definition: Additional information about the agent.
292
- # #
293
291
  # # Rationale: Additional information may be needed to describe or disambiguate the agent.
292
+ # #
293
+ # # Definition: Additional information about the agent.
294
294
  # # @return [RDF::Vocabulary::Term]
295
295
  # attr_reader :hasAgentNote
296
296
  #
297
- # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
298
- # #
299
297
  # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/agentType
300
298
  # #
301
299
  # # Definition: A high-level characterization of the type of agent.
300
+ # #
301
+ # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
302
302
  # # @return [RDF::Vocabulary::Term]
303
303
  # attr_reader :hasAgentType
304
304
  #
305
305
  # # @return [RDF::Vocabulary::Term]
306
306
  # attr_reader :hasApplicableDates
307
307
  #
308
- # # Usage Notes: A file or bitstream can be subject to multiple encodings that must be decoded in reverse order (highest to lowest). For example, file A may be compressed to create file B, which is encrypted to create file C. To recreate a copy of the base file A, one would have to unencrypt file C to create file B and then uncompress file B to create file A. A compositionLevel of zero indicates that the object is a base object and not subject to further decoding, while a level of 1 or higher indicates that one or more decodings must be applied. Numbering goes lowest to highest (first encoded = 0). 0 is base object; 1-n are subsequent encodings. Use 0 as the default if there is only one compositionLevel. When multiple file objects are bundled together as filestreams within a package file object (e.g., a ZIP file), the individual filestream objects are not composition levels of the package file object. They should be considered separate objects, each with their own composition levels. For example, two encrypted files zipped together and stored in an archive as one file object would be described as three separate objects, each with its own associated metadata. The storage location of the two inner objects would point to the ZIP file, but the ZIP file itself would have only a single composition level (of zero) whose format would be “zip.”
309
- # #
310
- # # Rationale: A file or bitstream can be encoded with compression, encryption, etc., or bundled with other files or bitstreams into larger packages. Knowing the order in which these actions are taken is important if the original object or objects must be recovered.
311
- # #
312
308
  # # Examples: 0, 1, 2
313
309
  # #
314
- # # Definition: An indication of whether the object is subject to one or more processes of decoding or unbundling.
310
+ # # Data Constraints: Non-negative integers.
311
+ # #
312
+ # # Usage Notes: A file or bitstream can be subject to multiple encodings that must be decoded in reverse order (highest to lowest). For example, file A may be compressed to create file B, which is encrypted to create file C. To recreate a copy of the base file A, one would have to unencrypt file C to create file B and then uncompress file B to create file A. A compositionLevel of zero indicates that the object is a base object and not subject to further decoding, while a level of 1 or higher indicates that one or more decodings must be applied. Numbering goes lowest to highest (first encoded = 0). 0 is base object; 1-n are subsequent encodings. Use 0 as the default if there is only one compositionLevel. When multiple file objects are bundled together as filestreams within a package file object (e.g., a ZIP file), the individual filestream objects are not composition levels of the package file object. They should be considered separate objects, each with their own composition levels. For example, two encrypted files zipped together and stored in an archive as one file object would be described as three separate objects, each with its own associated metadata. The storage location of the two inner objects would point to the ZIP file, but the ZIP file itself would have only a single composition level (of zero) whose format would be “zip.”
315
313
  # #
316
314
  # # Creation / Maintenance Notes: Composition level will generally be supplied by the repository, which should attempt to supply this value automatically. If the object was created by the repository, the creating routine knows the composition level and can supply this metadata. If the object is being ingested by the repository, repository programs will have to attempt to identify the composition level from the object itself or from externally supplied metadata.
317
315
  # #
318
- # # Data Constraints: Non-negative integers.
316
+ # # Definition: An indication of whether the object is subject to one or more processes of decoding or unbundling.
317
+ # #
318
+ # # Rationale: A file or bitstream can be encoded with compression, encryption, etc., or bundled with other files or bitstreams into larger packages. Knowing the order in which these actions are taken is important if the original object or objects must be recovered.
319
319
  # # @return [RDF::Vocabulary::Term]
320
320
  # attr_reader :hasCompositionLevel
321
321
  #
322
322
  # # @return [RDF::Vocabulary::Term]
323
323
  # attr_reader :hasContentLocation
324
324
  #
325
- # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/contentLocationType
325
+ # # Definition: The means of referencing the location of the content.
326
326
  # #
327
327
  # # Rationale: To understand the meaning of the value it is necessary to know what location scheme is used.
328
328
  # #
329
329
  # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
330
330
  # #
331
- # # Definition: The means of referencing the location of the content.
331
+ # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/contentLocationType
332
332
  # # @return [RDF::Vocabulary::Term]
333
333
  # attr_reader :hasContentLocationType
334
334
  #
335
- # # Definition: The reference to the location of the content used by the storage system.
335
+ # # Examples: http://wwasearch.loc.gov/107th/200212107035/http://house.gov/langevin/ (file), c:\apache2\htdocs\index.html (file), 64 [offset from start of file c:\apache2\htdocs\image\logo.gif] (bitstream)
336
336
  # #
337
337
  # # Usage Notes: This could be a fully qualified path and filename, or the information used by a resolution system (e.g., a handle) or the native information used by a storage management system. For a bitstream or filestream, this would probably be the reference point and offset of the starting position of the bitstream. It is up to the repository to determine the level of granularity that should be recorded.
338
338
  # #
339
- # # Examples: http://wwasearch.loc.gov/107th/200212107035/http://house.gov/langevin/ (file), c:\apache2\htdocs\index.html (file), 64 [offset from start of file c:\apache2\htdocs\image\logo.gif] (bitstream)
339
+ # # Definition: The reference to the location of the content used by the storage system.
340
340
  # # @return [RDF::Vocabulary::Term]
341
341
  # attr_reader :hasContentLocationValue
342
342
  #
343
343
  # # Data Constraint: Values should be taken from ISO 3166.
344
344
  # #
345
- # # Definition: The country whose copyright laws apply.
346
- # #
347
345
  # # Rationale: Copyright law can vary from country to country.
348
346
  # #
349
347
  # # Examples: us, de, be
348
+ # #
349
+ # # Definition: The country whose copyright laws apply.
350
350
  # # @return [RDF::Vocabulary::Term]
351
351
  # attr_reader :hasCopyrightJurisdiction
352
352
  #
353
- # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/copyrightStatus
354
- # #
355
353
  # # Definition: A coded designation for the copyright status of the object at the time the rights statement is recorded.
356
354
  # #
355
+ # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/copyrightStatus
356
+ # #
357
357
  # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
358
358
  # # @return [RDF::Vocabulary::Term]
359
359
  # attr_reader :hasCopyrightStatus
360
360
  #
361
- # # Example: 2001-10-26T19:32:52+00:00
361
+ # # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
362
362
  # #
363
363
  # # Definition: The date that the copyright status recorded in copyrightStatus was determined.
364
364
  # #
365
- # # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
365
+ # # Example: 2001-10-26T19:32:52+00:00
366
366
  # # @return [RDF::Vocabulary::Term]
367
367
  # attr_reader :hasCopyrightStatusDeterminationDate
368
368
  #
369
369
  # # @return [RDF::Vocabulary::Term]
370
370
  # attr_reader :hasCreatingApplication
371
371
  #
372
- # # Definition: A designation for the name of the software program that created the object.
372
+ # # Example: MSWord
373
373
  # #
374
374
  # # Usage Notes: The creatingApplication is the application that created the object in its current format, not the application that created the copy written to storage. For example, if a document is created by Microsoft Word and subsequently copied to archive storage by a repository’s Ingest program, the creatingApplication is Word, not the Ingest program.
375
375
  # #
376
- # # Example: MSWord
376
+ # # Definition: A designation for the name of the software program that created the object.
377
377
  # # @return [RDF::Vocabulary::Term]
378
378
  # attr_reader :hasCreatingApplicationName
379
379
  #
380
- # # Definition: The version of the software program that created the object.
381
- # #
382
380
  # # Example: 2000
381
+ # #
382
+ # # Definition: The version of the software program that created the object.
383
383
  # # @return [RDF::Vocabulary::Term]
384
384
  # attr_reader :hasCreatingApplicationVersion
385
385
  #
386
- # # Example: 2001-10-26T19:32:52+00:00
387
- # #
388
- # # Definition: The actual or approximate date and time the object was created.
386
+ # # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
389
387
  # #
390
388
  # # Usage Notes: Use the most precise date available. This is the date the object was created by the creating application, not the date any copy was made externally or by the repository. For example, if a file is created by Microsoft Word in 2001 and two copies are made in 2003, the dateCreatedByApplication of all three files is 2001. The date a file is written to storage can be recorded as an Event. If the object itself contains internal creation and modification dates, the modification date should be used as dateCreatedByApplication. If the application is a Web harvester capturing an object at a point of time, use for date captured.
391
389
  # #
392
- # # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
390
+ # # Example: 2001-10-26T19:32:52+00:00
391
+ # #
392
+ # # Definition: The actual or approximate date and time the object was created.
393
393
  # # @return [RDF::Vocabulary::Term]
394
394
  # attr_reader :hasDateCreatedByApplication
395
395
  #
396
396
  # # @return [RDF::Vocabulary::Term]
397
397
  # attr_reader :hasDependency
398
398
  #
399
+ # # Definition: A designation for a component or associated file needed by the representation or file.
400
+ # #
399
401
  # # Rationale: It may not be self-evident from the dependencyIdentifier what the name of the object actually is.
400
402
  # #
401
403
  # # Example: Additional Element Set for Language Corpora
402
- # #
403
- # # Definition: A designation for a component or associated file needed by the representation or file.
404
404
  # # @return [RDF::Vocabulary::Term]
405
405
  # attr_reader :hasDependencyName
406
406
  #
407
+ # # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
408
+ # #
407
409
  # # Usage Notes: Use “0000-00-00T00:00:00+00:00” for an open ended term of grant. Omit endDate if the ending date is unknown or the permission statement applies to many objects with different end dates.
408
410
  # #
409
411
  # # Definition: The ending date of the permission granted.
410
- # #
411
- # # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
412
412
  # # @return [RDF::Vocabulary::Term]
413
413
  # attr_reader :hasEndDate
414
414
  #
415
415
  # # @return [RDF::Vocabulary::Term]
416
416
  # attr_reader :hasEnvironment
417
417
  #
418
- # # Rationale: If multiple environments are described, this element can help to distinguish among them.
419
- # #
420
418
  # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/environmentCharacteristic
421
419
  # #
422
- # # Definition: An assessment of the extent to which the described environment supports its purpose.
420
+ # # Rationale: If multiple environments are described, this element can help to distinguish among them.
423
421
  # #
424
422
  # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
423
+ # #
424
+ # # Definition: An assessment of the extent to which the described environment supports its purpose.
425
425
  # # @return [RDF::Vocabulary::Term]
426
426
  # attr_reader :hasEnvironmentCharacteristic
427
427
  #
428
- # # Rationale: There may be a need to give a textual description of the environment for additional explanation.
428
+ # # Definition: Additional information about the environment.
429
429
  # #
430
- # # Example: This environment assumes that the PDF will be stored locally and used with a standalone PDF reader.
430
+ # # Rationale: There may be a need to give a textual description of the environment for additional explanation.
431
431
  # #
432
432
  # # Usage Notes: This note could be used to record the context of the environment information. For example, if a file can be rendered through a PC client application or through a browser with a plug-in, this note could be used to identify which situation applies. The note should not be used for a textual description of environment information recorded more rigorously elsewhere.
433
433
  # #
434
- # # Definition: Additional information about the environment.
434
+ # # Example: This environment assumes that the PDF will be stored locally and used with a standalone PDF reader.
435
435
  # # @return [RDF::Vocabulary::Term]
436
436
  # attr_reader :hasEnvironmentNote
437
437
  #
438
- # # Definition: The use(s) supported by the specified environment.
439
- # #
440
- # # Rationale: Different environments can support different uses of objects. For example, the environment needed to edit and modify a file can be quite different than the environment needed to render it.
438
+ # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
441
439
  # #
442
440
  # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/environmentPurpose
443
441
  # #
444
- # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
442
+ # # Definition: The use(s) supported by the specified environment.
443
+ # #
444
+ # # Rationale: Different environments can support different uses of objects. For example, the environment needed to edit and modify a file can be quite different than the environment needed to render it.
445
445
  # # @return [RDF::Vocabulary::Term]
446
446
  # attr_reader :hasEnvironmentPurpose
447
447
  #
448
- # # Definition: The event associated with the object or an agent.
449
- # #
450
448
  # # Usage Notes: Use to link to events that are not associated with relationships between objects, such as format validation, virus checking, etc.
449
+ # #
450
+ # # Definition: The event associated with the object or an agent.
451
451
  # # @return [RDF::Vocabulary::Term]
452
452
  # attr_reader :hasEvent
453
453
  #
454
- # # Usage Notes: Recommended practice is to record the most specific time possible and to designate the time zone.
455
- # #
456
- # # Example: 2001-10-26T19:32:52+00:00
454
+ # # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
457
455
  # #
458
456
  # # Definition: The single date and time, or date and time range, at or during which the event occurred.
459
457
  # #
460
- # # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
458
+ # # Example: 2001-10-26T19:32:52+00:00
459
+ # #
460
+ # # Usage Notes: Recommended practice is to record the most specific time possible and to designate the time zone.
461
461
  # # @return [RDF::Vocabulary::Term]
462
462
  # attr_reader :hasEventDateTime
463
463
  #
464
- # # Usage Notes: eventDetail is not intended to be processed by machine. It may record any information about an event and/or point to information stored elsewhere.
464
+ # # Definition: Additional information about the event.
465
465
  # #
466
466
  # # Examples: Object permanently withdrawn by request of Caroline Hunt, Program=“MIGJP2JP2K”; version=“2.2”
467
467
  # #
468
- # # Definition: Additional information about the event.
468
+ # # Usage Notes: eventDetail is not intended to be processed by machine. It may record any information about an event and/or point to information stored elsewhere.
469
469
  # # @return [RDF::Vocabulary::Term]
470
470
  # attr_reader :hasEventDetail
471
471
  #
472
- # # Rationale: A coded way of representing the outcome of an event may be useful for machine processing and reporting. If, for example, a fixity check fails, the event record provides both an actionable and a permanent record.
473
- # #
474
472
  # # Usage Notes: Recommended practice is to use a controlled vocabulary that a system can act upon automatically. More detail about the outcome may be recorded in eventOutcomeDetail. Recommended practice is to define events with sufficient granularity that each event has a single outcome.
475
473
  # #
476
- # # Examples: 00 [a code meaning “action successfully completed”], CV-01 [a code meaning “checksum validated”]
474
+ # # Rationale: A coded way of representing the outcome of an event may be useful for machine processing and reporting. If, for example, a fixity check fails, the event record provides both an actionable and a permanent record.
477
475
  # #
478
476
  # # Data Constraint: Value should be taken from a controlled vocabulary.
479
477
  # #
480
478
  # # Definition: A categorization of the overall result of the event in terms of success, partial success, or failure.
479
+ # #
480
+ # # Examples: 00 [a code meaning “action successfully completed”], CV-01 [a code meaning “checksum validated”]
481
481
  # # @return [RDF::Vocabulary::Term]
482
482
  # attr_reader :hasEventOutcome
483
483
  #
484
484
  # # @return [RDF::Vocabulary::Term]
485
485
  # attr_reader :hasEventOutcomeDetail
486
486
  #
487
+ # # Definition: A detailed description of the result or product of the event in textual form.
488
+ # #
487
489
  # # Rationale: Additional information in textual form may be needed about the outcome of the event.
488
490
  # #
489
491
  # # Examples: LZW compressed file, Non-standard tags found in header
490
- # #
491
- # # Definition: A detailed description of the result or product of the event in textual form.
492
492
  # # @return [RDF::Vocabulary::Term]
493
493
  # attr_reader :hasEventOutcomeDetailNote
494
494
  #
495
495
  # # @return [RDF::Vocabulary::Term]
496
496
  # attr_reader :hasEventOutcomeInformation
497
497
  #
498
- # # This propety links a Event instance to an Agent instance. Via this property a distinction can be made in the linkingAgent properties based on the domain.
499
- # #
500
498
  # # Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.
499
+ # #
500
+ # # This propety links a Event instance to an Agent instance. Via this property a distinction can be made in the linkingAgent properties based on the domain.
501
501
  # # @return [RDF::Vocabulary::Term]
502
502
  # attr_reader :hasEventRelatedAgent
503
503
  #
504
- # # Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.
505
- # #
506
504
  # # Rationale: Digital provenance often requires that relationships between objects and events are documented.
507
505
  # #
506
+ # # Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.
507
+ # #
508
508
  # # Definition: Information about an object associated with an event.
509
509
  # # @return [RDF::Vocabulary::Term]
510
510
  # attr_reader :hasEventRelatedObject
511
511
  #
512
512
  # # Rationale: Categorizing events will aid the preservation repository in machine processing of event information, particularly in reporting.
513
513
  # #
514
+ # # Definition: A categorization of the nature of the event.
515
+ # #
514
516
  # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/eventType
515
517
  # #
516
518
  # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
517
- # #
518
- # # Definition: A categorization of the nature of the event.
519
519
  # # @return [RDF::Vocabulary::Term]
520
520
  # attr_reader :hasEventType
521
521
  #
@@ -528,22 +528,22 @@ module RDF::Vocab
528
528
  # # @return [RDF::Vocabulary::Term]
529
529
  # attr_reader :hasFormatDesignation
530
530
  #
531
- # # Examples: Text/sgml, image/tiff/geotiff, Adobe PDF, DES, PGP, base64, unknown, LaTex
531
+ # # Definition: A designation of the format of the file or bitstream.
532
532
  # #
533
533
  # # Data Constraint: Value should be taken from a controlled vocabulary.
534
534
  # #
535
- # # Definition: A designation of the format of the file or bitstream.
535
+ # # Examples: Text/sgml, image/tiff/geotiff, Adobe PDF, DES, PGP, base64, unknown, LaTex
536
536
  # #
537
537
  # # Usage Notes: For unidentified formats, formatName may be recorded as “unknown”.
538
538
  # # @return [RDF::Vocabulary::Term]
539
539
  # attr_reader :hasFormatName
540
540
  #
541
+ # # Rationale: Qualifying information may be needed to supplement format designation and registry information or record a status for identification.
542
+ # #
541
543
  # # Usage Notes: The formatNote may contain free text, a reference pointer, or a value from a controlled list.
542
544
  # #
543
545
  # # Definition: Additional information about format.
544
546
  # #
545
- # # Rationale: Qualifying information may be needed to supplement format designation and registry information or record a status for identification.
546
- # #
547
547
  # # Examples: tentative identification, disjunction, multiple format identifications found
548
548
  # # @return [RDF::Vocabulary::Term]
549
549
  # attr_reader :hasFormatNote
@@ -565,51 +565,51 @@ module RDF::Vocab
565
565
  # # @return [RDF::Vocabulary::Term]
566
566
  # attr_reader :hasFormatRegistryName
567
567
  #
568
- # # Rationale: The same format may be defined in different registries for different purposes. For example, one registry may give detailed format specifications while another has profile information. If multiple registries are recorded, this semantic unit can be used to distinguish among them.
568
+ # # Definition: The purpose or expected use of the registry.
569
569
  # #
570
570
  # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/formatRegistryRole
571
571
  # #
572
- # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
572
+ # # Rationale: The same format may be defined in different registries for different purposes. For example, one registry may give detailed format specifications while another has profile information. If multiple registries are recorded, this semantic unit can be used to distinguish among them.
573
573
  # #
574
- # # Definition: The purpose or expected use of the registry.
574
+ # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
575
575
  # # @return [RDF::Vocabulary::Term]
576
576
  # attr_reader :hasFormatRegistryRole
577
577
  #
578
578
  # # Examples: 6.0, 2003
579
579
  # #
580
- # # Definition: The version of the format named in formatName.
580
+ # # Usage Notes: If the format is versioned, formatVersion should be recorded. It can be either a numeric or chronological designation.
581
581
  # #
582
582
  # # Rationale: Many authority lists of format names are not granular enough to indicate version, for example, MIME Media types.
583
583
  # #
584
- # # Usage Notes: If the format is versioned, formatVersion should be recorded. It can be either a numeric or chronological designation.
584
+ # # Definition: The version of the format named in formatName.
585
585
  # # @return [RDF::Vocabulary::Term]
586
586
  # attr_reader :hasFormatVersion
587
587
  #
588
588
  # # @return [RDF::Vocabulary::Term]
589
589
  # attr_reader :hasHardware
590
590
  #
591
- # # Usage Notes: Include manufacturer when this helps to identify or disambiguate the product. Include version for firmware or other components where that information is pertinent.
592
- # #
593
591
  # # Examples: Intel Pentium III, 1 GB DRAM, Windows XPcompatible joystick
594
592
  # #
595
593
  # # Definition: Manufacturer, model, and version (if applicable) of the hardware.
594
+ # #
595
+ # # Usage Notes: Include manufacturer when this helps to identify or disambiguate the product. Include version for firmware or other components where that information is pertinent.
596
596
  # # @return [RDF::Vocabulary::Term]
597
597
  # attr_reader :hasHardwareName
598
598
  #
599
- # # Usage Notes: This could be an identifier or URI used to point to hardware documentation.
600
- # #
601
599
  # # Definition: Additional requirements or instructions related to the hardware referenced in hwName.
602
600
  # #
601
+ # # Usage Notes: This could be an identifier or URI used to point to hardware documentation.
602
+ # #
603
603
  # # Examples: 32MB minimum, Required RAM for Apache is unknown
604
604
  # #
605
605
  # # Rationale: For hardware, the amount of computing resource needed (such as memory, storage, processor speed, etc.) may need to be documented. In addition, more detailed instructions may be needed to install and/or operate the hardware.
606
606
  # # @return [RDF::Vocabulary::Term]
607
607
  # attr_reader :hasHardwareOtherInformation
608
608
  #
609
- # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/hardwareType
610
- # #
611
609
  # # Definition: Class or category of the hardware.
612
610
  # #
611
+ # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/hardwareType
612
+ # #
613
613
  # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
614
614
  # # @return [RDF::Vocabulary::Term]
615
615
  # attr_reader :hasHardwareType
@@ -617,45 +617,45 @@ module RDF::Vocab
617
617
  # # @return [RDF::Vocabulary::Term]
618
618
  # attr_reader :hasIdentifier
619
619
  #
620
- # # Usage Notes: The type of the identifier may be implicit within the repository as long it can be explicitly communicated when the item is disseminated outside of it.
621
- # #
622
- # # Rationale: Identifier values cannot be assumed to be unique across domains. The combination of identifierType and identifierValue should ensure uniqueness.
623
- # #
624
620
  # # Data Constraint: Value should be taken from controlled vocabulary.
625
621
  # #
626
622
  # # Definition: A designation of the domain within which the identifier is unique.
627
623
  # #
628
624
  # # Examples: DLC, DRS, hdl:4263537
625
+ # #
626
+ # # Rationale: Identifier values cannot be assumed to be unique across domains. The combination of identifierType and identifierValue should ensure uniqueness.
627
+ # #
628
+ # # Usage Notes: The type of the identifier may be implicit within the repository as long it can be explicitly communicated when the item is disseminated outside of it.
629
629
  # # @return [RDF::Vocabulary::Term]
630
630
  # attr_reader :hasIdentifierType
631
631
  #
632
- # # Defnition: The value of the Identifier.
633
- # #
634
632
  # # Examples: 0000000312 (Representation), IU2440 (File), WAC1943.56 (File), http://nrs.harvard.edu/urn-3:FHCL.Loeb:sal (File), IU2440-1 (Bitstream)
633
+ # #
634
+ # # Defnition: The value of the Identifier.
635
635
  # # @return [RDF::Vocabulary::Term]
636
636
  # attr_reader :hasIdentifierValue
637
637
  #
638
+ # # Example: [DES decryption key]
639
+ # #
638
640
  # # Usage Notes: The key should be provided if known. However, it is not advisable to actually store the inhibitorKey in plain text in an unsecure database.
639
641
  # #
640
642
  # # Definition: The decryption key or password.
641
- # #
642
- # # Example: [DES decryption key]
643
643
  # # @return [RDF::Vocabulary::Term]
644
644
  # attr_reader :hasInhibitorKey
645
645
  #
646
- # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/inhibitorTarget
647
- # #
648
646
  # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
649
647
  # #
648
+ # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/inhibitorTarget
649
+ # #
650
650
  # # Definition: The content or function protected by the inhibitor.
651
651
  # # @return [RDF::Vocabulary::Term]
652
652
  # attr_reader :hasInhibitorTarget
653
653
  #
654
- # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/inhibitorType
655
- # #
656
654
  # # Definition: The inhibitor method employed.
657
655
  # #
658
656
  # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
657
+ # #
658
+ # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/inhibitorType
659
659
  # # @return [RDF::Vocabulary::Term]
660
660
  # attr_reader :hasInhibitorType
661
661
  #
@@ -671,58 +671,58 @@ module RDF::Vocab
671
671
  # # @return [RDF::Vocabulary::Term]
672
672
  # attr_reader :hasKeyInformation
673
673
  #
674
- # # Usage Notes: This could contain the actual text of the license or agreement or a paraphrase or summary.
675
- # #
676
674
  # # Definition: Text describing the license or agreement by which permission was granted.
675
+ # #
676
+ # # Usage Notes: This could contain the actual text of the license or agreement or a paraphrase or summary.
677
677
  # # @return [RDF::Vocabulary::Term]
678
678
  # attr_reader :hasLicenseTerms
679
679
  #
680
680
  # # Definition: The output of the message digest algorithm.
681
681
  # #
682
- # # Rationale: This must be stored so that it can be compared in future fixity checks.
683
- # #
684
682
  # # Example: 7c9b35da4f2ebd436f1cf88e5a39b3a257edf4a22be3c955ac49da2e2107b67a1924419563
683
+ # #
684
+ # # Rationale: This must be stored so that it can be compared in future fixity checks.
685
685
  # # @return [RDF::Vocabulary::Term]
686
686
  # attr_reader :hasMessageDigest
687
687
  #
688
- # # Definition: The specific algorithm used to construct the message digest for the digital object.
689
- # #
690
688
  # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
691
689
  # #
690
+ # # Definition: The specific algorithm used to construct the message digest for the digital object.
691
+ # #
692
692
  # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/cryptographicHashFunctions
693
693
  # # @return [RDF::Vocabulary::Term]
694
694
  # attr_reader :hasMessageDigestAlgorithm
695
695
  #
696
- # # Rationale: A preservation repository may ingest files that have had message digests calculated by the submitter; checking these ensures that the file as received is the same as the file as sent. The repository may also ingest files that do not have message digests, and so must calculate the initial value upon ingest. It can be useful to know who calculated the initial value of the message digest.
696
+ # # Examples: DRS, A0000978
697
697
  # #
698
698
  # # Usage Notes: The originator of the message digest could be represented by a string representing the agent (e.g., “NRS” referring to the archive itself) or a pointer to an agent description (e.g., “A0000987” taken here to be an agentIdentifierValue).
699
699
  # #
700
- # # Examples: DRS, A0000978
701
- # #
702
- # # Definition: The agent that created the original message digest that is compared in a fixity check.
700
+ # # Rationale: A preservation repository may ingest files that have had message digests calculated by the submitter; checking these ensures that the file as received is the same as the file as sent. The repository may also ingest files that do not have message digests, and so must calculate the initial value upon ingest. It can be useful to know who calculated the initial value of the message digest.
703
701
  # #
704
702
  # # Creation / Maintenance Notes: If the calculation of the initial message digest is treated by the repository as an Event, this information could be obtained from an Event record.
703
+ # #
704
+ # # Definition: The agent that created the original message digest that is compared in a fixity check.
705
705
  # # @return [RDF::Vocabulary::Term]
706
706
  # attr_reader :hasMessageDigestOriginator
707
707
  #
708
- # # Definition: Information about an object associated with an event or rightsstatement.
708
+ # # Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.
709
709
  # #
710
710
  # # Rationale: Digital provenance often requires that relationships between objects and events are documented. / Rights statements must be associated with the objects to which they pertain, either by linking from the rights statement to the object(s) or by linking from the object(s) to the rights statement. This provides the mechanism for the link from the rights statement to an object. For denoting the role of the object, when related to an event,one can extend this ontology be defining your own subproperties, such as those given by http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole.
711
711
  # #
712
- # # Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.
712
+ # # Definition: Information about an object associated with an event or rightsstatement.
713
713
  # # @return [RDF::Vocabulary::Term]
714
714
  # attr_reader :hasObject
715
715
  #
716
716
  # # @return [RDF::Vocabulary::Term]
717
717
  # attr_reader :hasObjectCharacteristics
718
718
  #
719
- # # Usage Notes: This is the name of the object as designated in the Submission Information Package (SIP). The object may have other names in different contexts. When two repositories are exchanging content, it would be important for the receiving repository to know and record the name of the representation at the originating repository. In the case of representations, this may be a directory name.
719
+ # # Creation / Maintenance Notes: This value would always be supplied to the repository by the submitter or harvesting application. How much of the file path to preserve would be up to the repository.
720
720
  # #
721
721
  # # Definition: The name of the object as submitted to or harvested by the repository, before any renaming by the repository.
722
722
  # #
723
723
  # # Rationale: The name used within the preservation repository may not be known outside of the repository. A depositor might need to request a file by its original name. Also, the repository may need to reconstruct internal links for dissemination.
724
724
  # #
725
- # # Creation / Maintenance Notes: This value would always be supplied to the repository by the submitter or harvesting application. How much of the file path to preserve would be up to the repository.
725
+ # # Usage Notes: This is the name of the object as designated in the Submission Information Package (SIP). The object may have other names in different contexts. When two repositories are exchanging content, it would be important for the receiving repository to know and record the name of the representation at the originating repository. In the case of representations, this may be a directory name.
726
726
  # #
727
727
  # # Example: N419.pdf
728
728
  # # @return [RDF::Vocabulary::Term]
@@ -731,30 +731,30 @@ module RDF::Vocab
731
731
  # # @return [RDF::Vocabulary::Term]
732
732
  # attr_reader :hasPreservationLevel
733
733
  #
734
- # # Examples: 2001-10-26T19:32:52+00:00
735
- # #
736
- # # Rationale: The preservationLevel applicable to an object is expected to be reviewed and changed over time, in response to changes in repository preservation requirements, policies, or capabilities relevant to the object. The date that the current preservationLevelValue was assigned aids review of decisions.
734
+ # # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
737
735
  # #
738
736
  # # Definition: The date, or date and time, when a particular preservationLevelValue was assigned to the object.
739
737
  # #
740
- # # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
738
+ # # Rationale: The preservationLevel applicable to an object is expected to be reviewed and changed over time, in response to changes in repository preservation requirements, policies, or capabilities relevant to the object. The date that the current preservationLevelValue was assigned aids review of decisions.
739
+ # #
740
+ # # Examples: 2001-10-26T19:32:52+00:00
741
741
  # # @return [RDF::Vocabulary::Term]
742
742
  # attr_reader :hasPreservationLevelDateAssigned
743
743
  #
744
- # # Examples: user pays, legislation, defective file, bit-level preservation only available for this format
745
- # #
746
744
  # # Usage Notes: This optional semantic unit records the reason for applying the preservationLevelValue. This information can be particularly important when the assigned preservationLevelValue differs from usual repository policy. For example, a repository may normally assign a preservationLevelValue of “full preservation” for JPEG2000 files, but detects that a particular file is defective. This may mean that the repository’s preservation strategy for JPEG2000 may not be effective for this particular file, so the repository may assign a preservationLevelValue of “bit-level preservation” to this file, recording “defective file” as the rationale. Similarly, legislative requirements or contractual agreements may require a higher level of preservation to be assigned to a particular object than would be assigned to that class of object according to usual policy. In this case, the rationale for the assignment may be recorded as “legislation” or “user pays”, for example. preservationLevelRationale may be repeated if more than one reason needs to be recorded.
747
745
  # #
748
746
  # # Definition: The reason a particular preservationLevelValue was applied to the object.
749
747
  # #
748
+ # # Examples: user pays, legislation, defective file, bit-level preservation only available for this format
749
+ # #
750
750
  # # Rationale: Application of a particular preservationLevelValue may require justification, especially if it differs from that usually applied according to repository policy.
751
751
  # # @return [RDF::Vocabulary::Term]
752
752
  # attr_reader :hasPreservationLevelRationale
753
753
  #
754
- # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/preservationLevelRole
755
- # #
756
754
  # # Definition: A value indicating the context in which a set of preservation options is applicable.
757
755
  # #
756
+ # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/preservationLevelRole
757
+ # #
758
758
  # # Rationale: Repositories may assign preservationLevelValues in different contexts which must be differentiated, and may need to record more than one context.
759
759
  # #
760
760
  # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
@@ -763,15 +763,15 @@ module RDF::Vocab
763
763
  #
764
764
  # # Usage Notes: Only one preservationLevelValue may be recorded per preservationLevel container. If a further preservationLevelValue applies to the object in a different context, a separate preservationLevel container should be repeated.
765
765
  # #
766
- # # Rationale: Some preservation repositories will offer multiple preservation options depending on factors such as the value or uniqueness of the material, the “preservability” of the format, the amount the customer is willing to pay, etc.
767
- # #
768
766
  # # Examples: bit-level, full, fully supported with future migrations (File), 0
769
767
  # #
770
768
  # # Data Constraint: Value should be taken from a controlled vocabulary.
771
769
  # #
772
- # # Definition: A value indicating the set of preservation functions expected to be applied to the object.
770
+ # # Rationale: Some preservation repositories will offer multiple preservation options depending on factors such as the value or uniqueness of the material, the “preservability” of the format, the amount the customer is willing to pay, etc.
773
771
  # #
774
772
  # # Creation / Maintenance Notes: The preservation level may be assigned by the repository or requested by the depositor and submitted as metadata.
773
+ # #
774
+ # # Definition: A value indicating the set of preservation functions expected to be applied to the object.
775
775
  # # @return [RDF::Vocabulary::Term]
776
776
  # attr_reader :hasPreservationLevelValue
777
777
  #
@@ -779,9 +779,9 @@ module RDF::Vocab
779
779
  # # @return [RDF::Vocabulary::Term]
780
780
  # attr_reader :hasRelatedObject
781
781
  #
782
- # # Definition: The order of the related object relative to other objects with the same type of relationship.
783
- # #
784
782
  # # Rationale: This semantic unit is particularly useful for structural relationships. In order to reconstruct a representation, it may be necessary to know the order of components with sibling or part-whole relationships. For example, to render a page-image book, it is necessary to know the order of files representing pages.
783
+ # #
784
+ # # Definition: The order of the related object relative to other objects with the same type of relationship.
785
785
  # # @return [RDF::Vocabulary::Term]
786
786
  # attr_reader :hasRelatedObjectSequence
787
787
  #
@@ -789,17 +789,17 @@ module RDF::Vocab
789
789
  # # @return [RDF::Vocabulary::Term]
790
790
  # attr_reader :hasRelatedStatuteInformation
791
791
  #
792
- # # The LOC will provide a SKOS vocabulary, where the concepts can also be used as object properties at http://id.loc.gov/. These relationships will capture the relationship type and subtype. One can define its own relationships, but for interoperability reasons, these should be linked to or made a subproperty of the properties of the LOC vocabulary.
793
- # #
794
792
  # # Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.
795
793
  # #
794
+ # # The LOC will provide a SKOS vocabulary, where the concepts can also be used as object properties at http://id.loc.gov/. These relationships will capture the relationship type and subtype. One can define its own relationships, but for interoperability reasons, these should be linked to or made a subproperty of the properties of the LOC vocabulary.
795
+ # #
796
796
  # # Definition: This property links one object to one or more other objects.
797
797
  # # @return [RDF::Vocabulary::Term]
798
798
  # attr_reader :hasRelationship
799
799
  #
800
- # # Definition: A condition or limitation on the act.
801
- # #
802
800
  # # Examples: No more than three, Allowed only after one year of archival retention has elapsed, Rightsholder must be notified after completion of act
801
+ # #
802
+ # # Definition: A condition or limitation on the act.
803
803
  # # @return [RDF::Vocabulary::Term]
804
804
  # attr_reader :hasRestriction
805
805
  #
@@ -846,21 +846,21 @@ module RDF::Vocab
846
846
  #
847
847
  # # Definition: The encoding used for the values of signatureValue, keyInformation.
848
848
  # #
849
- # # Rationale: These values cannot be interpreted correctly if the encoding is unknown.
850
- # #
851
849
  # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/signatureEncoding
852
850
  # #
851
+ # # Rationale: These values cannot be interpreted correctly if the encoding is unknown.
852
+ # #
853
853
  # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
854
854
  # # @return [RDF::Vocabulary::Term]
855
855
  # attr_reader :hasSignatureEncoding
856
856
  #
857
- # # Definition: A designation for the encryption and hash algorithms used for signature generation.
858
- # #
859
857
  # # Rationale: The same algorithms must be used for signature validation.
860
858
  # #
861
859
  # # Data Constraint: Values are taken from a SKOS vocabulary
862
860
  # #
863
861
  # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
862
+ # #
863
+ # # Definition: A designation for the encryption and hash algorithms used for signature generation.
864
864
  # # @return [RDF::Vocabulary::Term]
865
865
  # attr_reader :hasSignatureMethod
866
866
  #
@@ -872,23 +872,23 @@ module RDF::Vocab
872
872
  #
873
873
  # # Definition: The operations to be performed in order to validate the digital signature.
874
874
  # #
875
- # # Rationale: The repository should not assume that the procedure for validating any particular signature will be known many years in the future without documentation.
876
- # #
877
875
  # # Usage Notes: This may include the canonicalization method used before calculating the message digest, if the object was normalized before signing. This value could also be a pointer to archive documentation.
876
+ # #
877
+ # # Rationale: The repository should not assume that the procedure for validating any particular signature will be known many years in the future without documentation.
878
878
  # # @return [RDF::Vocabulary::Term]
879
879
  # attr_reader :hasSignatureValidationRules
880
880
  #
881
- # # Example: juS5RhJ884qoFR8flVXd/rbrSDVGn40CapgB7qeQiT+rr0NekEQ6BHhUA8dT3+BCTBUQI0dBjlml9lwzENXvS83zRECjzXbMRTUtVZiPZG2pqKPnL2YU3A9645UCjTXU+jgFumv7k78hieAGDzNci+PQ9KRmm//icT7JaYztgt4=
882
- # #
883
881
  # # Definition: The digital signature; a value generated from the application of a private key to a message digest.
882
+ # #
883
+ # # Example: juS5RhJ884qoFR8flVXd/rbrSDVGn40CapgB7qeQiT+rr0NekEQ6BHhUA8dT3+BCTBUQI0dBjlml9lwzENXvS83zRECjzXbMRTUtVZiPZG2pqKPnL2YU3A9645UCjTXU+jgFumv7k78hieAGDzNci+PQ9KRmm//icT7JaYztgt4=
884
884
  # # @return [RDF::Vocabulary::Term]
885
885
  # attr_reader :hasSignatureValue
886
886
  #
887
- # # Rationale: The signer might also be carried in the keyInformation, but it can be accessed more conveniently if recorded here.
887
+ # # Usage Notes: If the signer is an Agent known to the repository, this property can directly link to this agent. The consequence is punning: a datatype property and object property with the same name, i.e., :signer
888
888
  # #
889
889
  # # Definition: The individual, institution, or authority responsible for generating the signature.
890
890
  # #
891
- # # Usage Notes: If the signer is an Agent known to the repository, this property can directly link to this agent. The consequence is punning: a datatype property and object property with the same name, i.e., :signer
891
+ # # Rationale: The signer might also be carried in the keyInformation, but it can be accessed more conveniently if recorded here.
892
892
  # # @return [RDF::Vocabulary::Term]
893
893
  # attr_reader :hasSigner
894
894
  #
@@ -897,44 +897,44 @@ module RDF::Vocab
897
897
  #
898
898
  # # Definition: The aspect, facet, or attribute of an object about which significant properties are being described.
899
899
  # #
900
- # # Examples: content, structure, behavior, page count, page width, typeface, hyperlinks (representation), image count (representation), color space [for an embedded image] (bitstream)
900
+ # # Usage Notes: This semantic unit is optional and may be used as part of a facet:detail pair with significantPropertiesValue.
901
901
  # #
902
902
  # # Rationale: Repositories may choose to describe significant properties based on a particular aspect or attribute of an object.
903
903
  # #
904
- # # Usage Notes: This semantic unit is optional and may be used as part of a facet:detail pair with significantPropertiesValue.
904
+ # # Examples: content, structure, behavior, page count, page width, typeface, hyperlinks (representation), image count (representation), color space [for an embedded image] (bitstream)
905
905
  # # @return [RDF::Vocabulary::Term]
906
906
  # attr_reader :hasSignificantPropertiesType
907
907
  #
908
- # # Definition: Description of the characteristics of a particular object subjectively determined to be important to maintain through preservation actions.
909
- # #
910
- # # Usage Notes: If facet:detail pairs are used, the content of significantPropertiesValue should describe the significant properties of object relevant to the aspect, facet, or attribute declared in the significantPropertiesType with which it is paired. If facet:detail pairs are not used, significantPropertiesValue may be used to freely describe any characteristic of an object. significantPropertiesValue is not repeatable. Multiple significant properties should be described in separate, repeated significantProperties container units.
908
+ # # Rationale: Repositories may choose to describe significant properties based on a particular aspect or attribute of an object.
911
909
  # #
912
910
  # # Examples: [For a Web page containing animation that is not considered essential] Content only, [For detail associated with a significantPropertiesType of "behavior"] Hyperlinks traversable, [For a Word document with embedded links that are not considered essential] Content only, [For detail associated with significantPropertiesType of "behavior"] Editable, [For detail associated with a significantPropertiesType of "page width"] 210 mm, [For a PDF with an embedded graph, where the lines' color determines the lines' meaning] Color, [For detail associated with a significantPropertiesType of "appearance"] Color
913
911
  # #
914
- # # Rationale: Repositories may choose to describe significant properties based on a particular aspect or attribute of an object.
912
+ # # Usage Notes: If facet:detail pairs are used, the content of significantPropertiesValue should describe the significant properties of object relevant to the aspect, facet, or attribute declared in the significantPropertiesType with which it is paired. If facet:detail pairs are not used, significantPropertiesValue may be used to freely describe any characteristic of an object. significantPropertiesValue is not repeatable. Multiple significant properties should be described in separate, repeated significantProperties container units.
913
+ # #
914
+ # # Definition: Description of the characteristics of a particular object subjectively determined to be important to maintain through preservation actions.
915
915
  # # @return [RDF::Vocabulary::Term]
916
916
  # attr_reader :hasSignificantPropertiesValue
917
917
  #
918
+ # # Usage Notes: Defining this semantic unit as size in bytes makes it unnecessary to record a unit of measurement. However, for the purpose of data exchange the unit of measurement should be stated or understood by both partners.
919
+ # #
918
920
  # # Definition: The size in bytes of the file or bitstream stored in the repository.
919
921
  # #
920
- # # Usage Notes: Defining this semantic unit as size in bytes makes it unnecessary to record a unit of measurement. However, for the purpose of data exchange the unit of measurement should be stated or understood by both partners.
922
+ # # Creation / Maintenance Notes: Automatically obtained by the repository.
921
923
  # #
922
924
  # # Example: 2038937
923
925
  # #
924
926
  # # Rationale: Size is useful for ensuring the correct number of bytes from storage have been retrieved and that an application has enough room to move or process files. It might also be used when billing for storage.
925
- # #
926
- # # Creation / Maintenance Notes: Automatically obtained by the repository.
927
927
  # # @return [RDF::Vocabulary::Term]
928
928
  # attr_reader :hasSize
929
929
  #
930
930
  # # @return [RDF::Vocabulary::Term]
931
931
  # attr_reader :hasSoftware
932
932
  #
933
- # # Example: GNU gcc >=2.7.2
933
+ # # Definition: The name and, if applicable, version of any software component needed by the software referenced in swName in the context of using this object.
934
934
  # #
935
935
  # # Usage Notes: The value should be constructed in a way that is consistent with the construction of swName and swVersion. This semantic unit identifies the software that is needed by what is recorded in swName, for example, a Perl script that depends on a Perl module. In this case the Perl script is listed in swName, with the module in swDependency within a software container.
936
936
  # #
937
- # # Definition: The name and, if applicable, version of any software component needed by the software referenced in swName in the context of using this object.
937
+ # # Example: GNU gcc >=2.7.2
938
938
  # # @return [RDF::Vocabulary::Term]
939
939
  # attr_reader :hasSoftwareDependency
940
940
  #
@@ -946,53 +946,53 @@ module RDF::Vocab
946
946
  # # @return [RDF::Vocabulary::Term]
947
947
  # attr_reader :hasSoftwareName
948
948
  #
949
- # # Example: Install Acroread (Adobe Acrobat) first; copy nppdf.so (the plug-in) to your Mozilla plug-ins directory, and make sure a copy of (or symlink to) Acroread is in your PATH.
950
- # #
951
949
  # # Definition: Additional requirements or instructions related to the software referenced in swName.
952
950
  # #
951
+ # # Example: Install Acroread (Adobe Acrobat) first; copy nppdf.so (the plug-in) to your Mozilla plug-ins directory, and make sure a copy of (or symlink to) Acroread is in your PATH.
952
+ # #
953
953
  # # Usage Notes: This could be a reliable persistent identifier or URI pointing to software documentation within or outside the repository.
954
954
  # # @return [RDF::Vocabulary::Term]
955
955
  # attr_reader :hasSoftwareOtherInformation
956
956
  #
957
957
  # # Rationale: Several different layers of software can be required to support an object.
958
958
  # #
959
- # # Definition: Class or category of software.
960
- # #
961
959
  # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/softwareType
962
960
  # #
961
+ # # Definition: Class or category of software.
962
+ # #
963
963
  # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
964
964
  # # @return [RDF::Vocabulary::Term]
965
965
  # attr_reader :hasSoftwareType
966
966
  #
967
- # # Definition: The version or versions of the software referenced in swName.
968
- # #
969
967
  # # Usage Notes: If there is no formal version, the date of issuance can be used.
970
968
  # #
969
+ # # Definition: The version or versions of the software referenced in swName.
970
+ # #
971
971
  # # Examples: >=2.2.0, 6.0, 2003
972
972
  # # @return [RDF::Vocabulary::Term]
973
973
  # attr_reader :hasSoftwareVersion
974
974
  #
975
- # # Definition: The beginning date of the permission granted.
976
- # #
977
975
  # # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
976
+ # #
977
+ # # Definition: The beginning date of the permission granted.
978
978
  # # @return [RDF::Vocabulary::Term]
979
979
  # attr_reader :hasStartDate
980
980
  #
981
- # # Examples: Legal Deposit (Jersey) Law 200, National Library of New Zealand (Te Puna Mātauranga o Aotearoa) Act 2003 no 19 part 4 s 34
981
+ # # Definition: An identifying designation for the statute.
982
982
  # #
983
983
  # # Usage Notes: Use standard citation form when applicable.
984
984
  # #
985
- # # Definition: An identifying designation for the statute.
985
+ # # Examples: Legal Deposit (Jersey) Law 200, National Library of New Zealand (Te Puna Mātauranga o Aotearoa) Act 2003 no 19 part 4 s 34
986
986
  # # @return [RDF::Vocabulary::Term]
987
987
  # attr_reader :hasStatuteCitation
988
988
  #
989
- # # Definition: The date that the determination was made that the statute authorized the permission(s) noted.
989
+ # # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
990
990
  # #
991
991
  # # Rationale: The permission in question may be the subject of some interpretation. These assessments are made within a specific context and at a specific time. At another time the context, and therefore the assessment, could change. For this reason it can be important to record the date of the decision.
992
992
  # #
993
993
  # # Example: 2001-10-26T19:32:52+00:00
994
994
  # #
995
- # # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
995
+ # # Definition: The date that the determination was made that the statute authorized the permission(s) noted.
996
996
  # # @return [RDF::Vocabulary::Term]
997
997
  # attr_reader :hasStatuteInformationDeterminationDate
998
998
  #
@@ -1009,13 +1009,13 @@ module RDF::Vocab
1009
1009
  # # @return [RDF::Vocabulary::Term]
1010
1010
  # attr_reader :hasStorage
1011
1011
  #
1012
- # # Rationale: The repository needs to know the medium on which an object is stored in order to know how and when to do media refreshment and media migration.
1013
- # #
1014
- # # Definition: The physical medium on which the object is stored (e.g., magnetic tape, hard disk, CD-ROM, DVD).
1012
+ # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/storageMedium
1015
1013
  # #
1016
1014
  # # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
1017
1015
  # #
1018
- # # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/storageMedium
1016
+ # # Rationale: The repository needs to know the medium on which an object is stored in order to know how and when to do media refreshment and media migration.
1017
+ # #
1018
+ # # Definition: The physical medium on which the object is stored (e.g., magnetic tape, hard disk, CD-ROM, DVD).
1019
1019
  # # @return [RDF::Vocabulary::Term]
1020
1020
  # attr_reader :hasStorageMedium
1021
1021
  #