Version 12 (modified by hmottestad, 10 years ago) |
---|
Simplified Maintenance Procedure
Brief into
Prerequisites
- Only new reference data items
- Max 50 reference data items
- Simplified use of 15926-2
Details
1. Only new reference data classes
A new reference data item is an RDF node set as a subject in a list of triples.
rdl:newItem a p2:ClassOfInanimatePhysicalObject; rdl:hasDesignation "NEW ITEM"@en^^xsd:string
With new reference data items it is forbidden to add predicates to existing subjects in the RDL and it is forbidden to use 15926-2 to add a classification or a specialization to an existing item in the RDL.
# adding a new entity type to an existing RDL item is forbidden rdl:RDS327239 a p2:ClassOfArrangedIndividual; # adding a new superclass to an exisitng RDL item is forbidden rdl:newSpecialization a p2:Specialization ; p2:hasSubclass rdl:RDS327239 ; p2:hasSuperclass rdl:newItem ; # adding a new classifier to an exisitng RDL item is forbidden rdl:newClassification a p2:Classification ; p2:hasClassified rdl:RDS327239 ; p2:hasClassifier rdl:newItem ;
New reference data is allowed to be in the hasSubclass position in any specialization relationship or in the hasClassified position of any classification relationship. New reference data is also allowed to be in the hasSuperclass position or the hasClassifier position when the opposing position is filled with another new reference data item.
# making a new item a subclass of an existing item is allowed and recommended rdl:newSpecialization a p2:Specialization ; p2:hasSubclass rdl:newItem ; p2:hasSuperclass rdl:RDS327239 ; # making a new item the superclass of another new item is allowed and recommended rdl:newSpecialization a p2:Specialization ; p2:hasSubclass rdl:anotherNewItem ; p2:hasSuperclass rdl:newItem ;
2. Max 50 reference data items
An item is measured as a RDF subject that is not typed as either p2:Specialization or p2:Classification. All other RDF subjects count. The limit is 50 inclusive.
3. Simplified use of 15926-2
In order to simplify the needed verification and validation there is a limit to the allowed relationships and predicates that can be used.Allowed 15926-2 relationships:
- Classification
- Specialization
Allowed predicates:
- rdl:hasDesignation
- rdl:hasDefinition
- rdl:defaultRdsId
- rdf:type with object being a 15926-2 entity type
- rdfs:label
The following predicates will be set automatically:
- rdl:hasCreationDate is set to now.
- rdl:hasStatus is set to "Candidate"
Creating a request package
The request package is the official package that is delivered to PCA containing the reference data items to be added together with contact details and a proof of verification.The package must be a zip file containing the following files: 1. referenceData.ttl
- readme.txt
- verificationReport.txt
1. referenceData.ttl
All reference data items must be contained in this file, serialized as RDF/TTL.
2. readme.txt
This file must contain the contact details for the request
Name of company: YOUR COMPNAY NAME HERE Name of contact person: CONTACT PERSON NAME HERE Email of contact person: [email protected]
3. verificationReport.txt
Upload the referenceData.ttl file to the automatic verification system. Click to download the verificationReport.txt file. This file contains a signature that links the contents the referenceData.ttl file to the results of a valid verification. Any subsequent changes to referenceData.ttl will invalidate the report.TODO: Set up a link to the verification system.
Post request
After review by the PCA staff the referenceData.ttl file will be uploaded to http://staging.data.posccaesar.org. A minimum delay of 14 days is required to allow for comments.Any registered user may comment on the submitted reference data. Comments are graded as trivial, major, blocker. All comments require