Difference between revisions of "Administration"

From reBiND Documentation
Jump to: navigation, search
Line 3: Line 3:
 
XML document can be uploaded to the eXist database even if the document is not valid according to the schema used. However it is mandatory that the document is well formed, otherwise errors will occur when trying to store the document.  
 
XML document can be uploaded to the eXist database even if the document is not valid according to the schema used. However it is mandatory that the document is well formed, otherwise errors will occur when trying to store the document.  
  
But before the documents can be stored, a closer look at the collection structure within eXist is needed. The reBiND Framework depends on two collections for managing the different data projects. One of the collections is for the unpublished data projects, which are still being corrected, reviewed or otherwise prepared for publication. The other collection is for the published projects, which can be publicly searched and accessed. The names for the two collections can be adjusted for the individual reBiND Instances, but for the sake of simplicity, within this document they will be referred to as ''unpublished'' and ''published''. Both of these collections are located in the root collection of eXist. Within these collections are the collection for the individual data projects. Having the two collections for unpublished and published data projects makes the security configuration also quite easy, since it only has to be done for these two collections and the data project collections stored in them automatically inherit these configurations.
+
But before the documents can be stored, a closer look at the collection structure within eXist is needed. The reBiND Framework depends on two collections for managing the different data projects. One of the collections is for the unpublished data projects, which are still being corrected, reviewed or otherwise prepared for publication. The other collection is for the published projects, which can be publicly searched and accessed. Within this document they will be referred to as ''unpublished'' and ''published''. Both of these collections are located in the root collection of eXist. Within these collections are the collection for the individual data projects. Having the two collections for unpublished and published data projects makes the security configuration also quite easy, since the security settings for these two collections will be automatically inherited by data projects within these.
  
 
So in order to upload the data document for a new data project, a new collection for the data project has to be created. This can be easily done via the web interface of the eXist server. The Content Administrator needs to login in order to see the admin dashboard of the eXist server, where such an option is available. The collection should have a clear descriptive name, but must only contain small letters (without special characters), digits, underscores or dashes. Within this collection the data document and meta data document can then be uploaded, also via the admin dashboard. Additional files could also uploaded in the collection, like the original data file, the data was extracted from in order to generate the XML document or images and other multimedia objects. For the sake of clarity image and multimedia objects should be placed into special subcollections within the data project collection, like ''images/''. A data project could also contain more than one XML data document, however only one meta data file.   
 
So in order to upload the data document for a new data project, a new collection for the data project has to be created. This can be easily done via the web interface of the eXist server. The Content Administrator needs to login in order to see the admin dashboard of the eXist server, where such an option is available. The collection should have a clear descriptive name, but must only contain small letters (without special characters), digits, underscores or dashes. Within this collection the data document and meta data document can then be uploaded, also via the admin dashboard. Additional files could also uploaded in the collection, like the original data file, the data was extracted from in order to generate the XML document or images and other multimedia objects. For the sake of clarity image and multimedia objects should be placed into special subcollections within the data project collection, like ''images/''. A data project could also contain more than one XML data document, however only one meta data file.   

Revision as of 17:47, 21 October 2014

Administration

XML document can be uploaded to the eXist database even if the document is not valid according to the schema used. However it is mandatory that the document is well formed, otherwise errors will occur when trying to store the document.

But before the documents can be stored, a closer look at the collection structure within eXist is needed. The reBiND Framework depends on two collections for managing the different data projects. One of the collections is for the unpublished data projects, which are still being corrected, reviewed or otherwise prepared for publication. The other collection is for the published projects, which can be publicly searched and accessed. Within this document they will be referred to as unpublished and published. Both of these collections are located in the root collection of eXist. Within these collections are the collection for the individual data projects. Having the two collections for unpublished and published data projects makes the security configuration also quite easy, since the security settings for these two collections will be automatically inherited by data projects within these.

So in order to upload the data document for a new data project, a new collection for the data project has to be created. This can be easily done via the web interface of the eXist server. The Content Administrator needs to login in order to see the admin dashboard of the eXist server, where such an option is available. The collection should have a clear descriptive name, but must only contain small letters (without special characters), digits, underscores or dashes. Within this collection the data document and meta data document can then be uploaded, also via the admin dashboard. Additional files could also uploaded in the collection, like the original data file, the data was extracted from in order to generate the XML document or images and other multimedia objects. For the sake of clarity image and multimedia objects should be placed into special subcollections within the data project collection, like images/. A data project could also contain more than one XML data document, however only one meta data file.

The collection structure of eXist would therefore look like this: