User:Inga/container tocs
Jump to navigation
Jump to search
Inga currently tries to understand the container discussion in the eSciDoc technical team and uses this page to structure results and thoughts.
Everything should start with a definition[edit]
Following definition of a Container is taken from the eSciDoc framework specification[1]:
"Containers offer the concept of aggregation, i.e. they can contain other (simple and complex) objects.
Each container includes a structural map and can have a TOC and an AdminDescriptor. A container can be
a collection or a bundle."
The corresponding container XML schemas [2] slightly differs from this perception by allowing minOccurs=0 to structMap.
The CoLab provides some more definitions:
Resources available about containers and tocs:
- ESciDoc_Services:core_services shortly describes the Container Handler service and introduces the terms "Container", "TableOfContents" and "StructuralMap"
- 9
Is there light at the end of the tunnel?[edit]
- ESciDoc Container Toc states "Grouping of direct members is not necessary; a hierarchical structure is build by container resources wich are linked as members." -> isn't the toc something like a grouping?
- ESciDoc Container Toc states "The only reason to provide more than one TOC for a container resource would be to have different selections of the container resource members. It is assumed that there is no use case for different selections of members of one single container.
- One TOC per container?
- What is the difference between
The Result: Inga's assumptions and recommendations[edit]
- Container members are independent from their container, thus each item/container can be member of n containers.
-> The requirement that "non-editors" would like to provide individual TOCs for an existing container - The TOC is an optional, but integral component/member of the container
->Changes in the TOC object should version the container object
- I would strongly vote for synchronizing definitions, re-considering terms used and harmonizing notations
- container, i.e. in regard to hierarchical structure
- table of contents/tableOfContents/TOC/toc - if the escidoc toc is an ordered and grouped overview of [selected] members, it may be semantically in sync with the METS concept "structMap" -> renaming to avoid confusion?
- StructuralMap/struct-map - if a structural map is the "flat" list of item reference, it may be semantically in sync with the METS concpet "fileSec" -> renaming?
References[edit]
- ↑ API Documentation Container Handler, rest interface, framework release 0.9
- ↑ - XML schema Container rest interface, framework release 0.9