--- storage/meta/meta-format.tex 2004/07/16 13:45:49 1.15 +++ storage/meta/meta-format.tex 2005/11/24 18:52:57 1.16 @@ -16,7 +16,7 @@ \author{Robert Casties, Dirk Wintergrün, Hans-Christoph Liess} -\date{V1.2 of 16.7.2004} +\date{V1.3 of 24.11.2005} \begin{document} @@ -59,20 +59,20 @@ files are possible: \begin{itemize} \item a file named \texttt{index.meta} in a directory. -\item a file named like the data file it describes with an +\item a file with the same name as the data file it describes and an additional extension \texttt{.meta}. For example metadata for the - file \texttt{0001.tif} would be in a file \texttt{0001.tif.meta}. + file \texttt{p0001.tif} would be in a file \texttt{p0001.tif.meta}. \end{itemize} The resource directory must contain an \texttt{index.meta} file with -information about the resource as a whole. Other directories can -contain \texttt{index.meta} files. +information about the resource as a whole. Subdirectories can +contain additional \texttt{index.meta} files. Additional information about single data files that are part of the resource can either be put in \texttt{file} tags in the \texttt{index.meta} file or in separate \emph{filename}\texttt{.meta} files for each data file. Information from the directory level file is -inherited at the file level. +inherited at the file level when it is not overwritten. \section{Resource format} @@ -96,7 +96,7 @@ The outer container element is \texttt{r \item[type] sub-type of resource (e.g. ``ECHO'', ``MPIWG'') -- optional. -\item[version] version number of metadata format (currently 1.1) -- +\item[version] version number of metadata format (currently 1.2) -- required. \end{description} @@ -125,7 +125,7 @@ The outer container element is \texttt{r whole archive collection, including the resource directory -- deduced. \item[archive-id] The ID for this document in the archive -- - required. + optional. \item[derived-from] Container for the description of the original resource if this resource is a modified version of another resource @@ -133,10 +133,25 @@ The outer container element is \texttt{r \begin{description} \item[archive-id] The ID of the original resource - -- required. + -- required (or archive-path). \item[archive-path] The full path to the original resource - -- deduced. + -- required (or archive-id). + + \item[description] An informal textual description of the relation + of this resource to the original resource -- optional. + \end{description} + +\item[used-by] Container for the description of modified resources + if this resource is the source of another resource + -- optional. + + \begin{description} + \item[archive-id] The ID of the derived resource + -- required (or archive-path). + + \item[archive-path] The full path to the derived resource + -- required (or archive-id). \item[description] An informal textual description of the relation of this resource to the original resource -- optional. @@ -148,10 +163,10 @@ The outer container element is \texttt{r \begin{description} \item[archive-id] The ID of the linked resource - -- required. + -- required (or archive-path). \item[archive-path] The full path to the linked resource - -- deduced. + -- required (or archive-id). \item[description] An informal textual description of the relation of this resource to the linked resource -- optional. @@ -212,10 +227,10 @@ The outer container element is \texttt{r \item[name] The name of the file -- required. \item[original-name] A text string associated with the file as - original name -- optional. (E.g. if this file came from an + original name -- optional. (e.g. if this file came from an external source and had a name that had to be changed according to - section~\ref{sec:file-directory-names} but it should be possible - to reference the original name.) + section~\ref{sec:file-directory-names} it is possible + to preserve the original name.) \item[path] The directory path of this file relative to the resource's root directory (excluding the file itself) -- required @@ -250,7 +265,7 @@ The outer container element is \texttt{r All elements with \texttt{meta} tags can contain an arbitrary number of the following additional metadata elements. -\subsection{workflow state} +\subsection{Workflow state} \label{sec:workflow-state} All additional metadata elements can have a \texttt{workflow-state} @@ -864,7 +879,7 @@ whole pages or parts of pages must be sp If the access to a resource is bound to conditions for technical or legal reasons then the conditions can be put in a \texttt{access-conditions} -container. Other access rights conditions like copyright can also be +container. Other usage conditions like copyright can also be documented in this container. \begin{description} @@ -882,9 +897,9 @@ documented in this container. as text) \end{description} - \item[copyright] the copyright owner and it's conditions + \item[copyright] the copyright holder and it's conditions \begin{description} - \item[owner] the name of the copyright owner + \item[owner] the name of the copyright holder \begin{description} \item[name] a name (free text) @@ -894,7 +909,7 @@ documented in this container. \item[date] the date when the copyright was issued - \item[duration] the duration of the copyright (if known) + \item[duration] the duration of the copyright term (if known) \item[description] free-text field for special or additional conditions @@ -902,44 +917,100 @@ documented in this container. \item[publish-metadata] metadata about this resource can be made - freely available when this tag is present. Access to the resource - itself is regulated separately by the \texttt{access} element. + freely available when this tag is present (otherwise metadata has + the same access conditions as the rest of the resource). Access to + the resource itself is regulated separately by the \texttt{access} + element. - \item[access] conditions of access to this resource + \item[access] conditions of access to this resource. Different + access types are specified by a \texttt{type} attribute: \begin{description} - \item[internal] access should be restricted to a group of users. The - type of group is defined by one of the following + \item[type=group] access restricted to the members of this named + group. The method to identify a user belonging to a named group + is not specified in this document. \begin{description} - \item[institution] the members of this institution. The method - to identify a user to belong to the institution is not - specified in this document. - - \item[subnet] all computers with an IP-address in this subnet. The - subnet is defined in ``truncated-quad'' (e.g. ``141.14'') or - ``adress/netmask'' (e.g. ``141.14.0.0/255.255.0.0'') notation. - - \item[group] the members of this named group. The method to - identify a user to belong to a named group is not specified in - this document. + \item[name] name of the group. + + \item[only-before] the access condition is only valid before the + given date (format: ``YYYY/MM/DD''). + + \item[only-after] the access condition is only valid after the + given date (format: ``YYYY/MM/DD''). + \end{description} + + \item[type=institution] access restricted to the members of this + institution. The method to identify a user to belong to the + institution is not specified in this document. + \begin{description} + \item[name] name of the group. + + \item[only-before] the access condition is only valid before the + given date (format: ``YYYY/MM/DD''). + + \item[only-after] the access condition is only valid after the + given date (format: ``YYYY/MM/DD''). \end{description} + - \item[scientific] access to this resource should be restricted to + \item[type=subnet] access restricted to all computers with an + IP-address in this subnet. + \begin{description} + \item[range] subnet range defined in + truncated-quad (e.g. ``141.14''), network-netmask + (e.g. ``141.14.0.0/255.255.0.0''), or network-range + (e.g. ``141.14.0.0/16'') notation. + + \item[only-before] the access condition is only valid before the + given date (format: ``YYYY/MM/DD''). + + \item[only-after] the access condition is only valid after the + given date (format: ``YYYY/MM/DD''). + \end{description} + + + \item[type=scientific] access to this resource should be restricted to scientific work + \begin{description} + \item[only-before] the access condition is only valid before the + given date (format: ``YYYY/MM/DD''). + + \item[only-after] the access condition is only valid after the + given date (format: ``YYYY/MM/DD''). + \end{description} + - \item[free] access to this resource is not restricted + \item[type=free] access to this resource is not restricted + \begin{description} + \item[only-before] the access condition is only valid before the + given date (format: ``YYYY/MM/DD''). + + \item[only-after] the access condition is only valid after the + given date (format: ``YYYY/MM/DD''). + \end{description} + - \item[special] if none of the above conditions seems appropriate, + \item[type=special] if none of the above conditions seems appropriate, a free-form text can be specified here. + \begin{description} + \item[description] description of special access conditions. + + \item[only-before] the access condition is only valid before the + given date (format: ``YYYY/MM/DD''). + + \item[only-after] the access condition is only valid after the + given date (format: ``YYYY/MM/DD''). + \end{description} + \end{description} \end{description} \end{description} \noindent -It should be noted that control over the access to the resource has to -be provided by additional technical measures. Access conditions in the -metadata file only state that conditions \emph{should} be observed, -not that they \emph{are} necessarily observed, as the enforcement of -conditions depends on additional technical measures. +It should be noted that control over access to the resource has to be +provided by additional technical measures. Access conditions in the +metadata file only state that conditions \emph{should} be observed, it +is not implied that they \emph{are} necessarily observed, as the +enforcement of conditions depends on additional measures.