<chapter id="record-model">
- <!-- $Id: recordmodel.xml,v 1.4 2002-08-22 14:58:22 adam Exp $ -->
+ <!-- $Id: recordmodel.xml,v 1.8 2002-10-17 08:10:08 mike Exp $ -->
<title>The Record Model</title>
<para>
kind of structured data. Each record in the system is associated with
a <emphasis>record schema</emphasis> which lends context to the data
elements of the record.
- Any number of record schema can coexist in the system.
+ Any number of record schemas can coexist in the system.
Although it may be wise to use only a single schema within
one database, the system poses no such restrictions.
</para>
<para>
The record model described in this chapter applies to the fundamental,
structured
- record type <literal>grs</literal> as introduced in
+ record type <literal>grs</literal>, introduced in
<xref linkend="record-types"/>.
+ <!--
FIXME - Need to describe the simple string-tag model, or at least
refer to it here. -H
+ -->
</para>
<para>
<screen>
<Distributor>
- <Name> USGS/WRD </Name>
- <Organization> USGS/WRD </Organization>
- <Street-Address>
- U.S. GEOLOGICAL SURVEY, 505 MARQUETTE, NW
- </Street-Address>
- <City> ALBUQUERQUE </City>
- <State> NM </State>
- <Zip-Code> 87102 </Zip-Code>
- <Country> USA </Country>
- <Telephone> (505) 766-5560 </Telephone>
+ <Name> USGS/WRD </Name>
+ <Organization> USGS/WRD </Organization>
+ <Street-Address>
+ U.S. GEOLOGICAL SURVEY, 505 MARQUETTE, NW
+ </Street-Address>
+ <City> ALBUQUERQUE </City>
+ <State> NM </State>
+ <Zip-Code> 87102 </Zip-Code>
+ <Country> USA </Country>
+ <Telephone> (505) 766-5560 </Telephone>
</Distributor>
</screen>
</para>
- <note>
- <para>
+ <!-- There is no indentation in the example above! -H
+ -note-
+ -para-
The indentation used above is used to illustrate how Zebra
interprets the mark-up. The indentation, in itself, has no
significance to the parser for the canonical input format, which
discards superfluous whitespace.
- </para>
- </note>
+ -/para-
+ -/note-
+ -->
+
<para>
The keywords surrounded by <...> are
<emphasis>tags</emphasis>, while the sections of text
Each element is terminated by a closing tag - beginning
with <literal><</literal>/, and containing the same symbolic
tag-name as the corresponding opening tag.
- The general closing tag - <literal><</literal>>/ -
+ The general closing tag - <literal><</literal>/> -
terminates the element started by the last opening tag. The
structuring of elements is significant.
The element <emphasis>Telephone</emphasis>,
<screen>
<gils>
- <title>Zen and the Art of Motorcycle Maintenance</title>
+ <title>Zen and the Art of Motorcycle Maintenance</title>
</gils>
</screen>
tag with the same <emphasis>class</emphasis> and
<emphasis>value</emphasis> settings, or by the
appearance of another, normal tag. In other words, the end-tags for
- the variants used in the example above could have been saved.
+ the variants used in the example above could have been omitted.
</para>
<para>
<para>
<screen>
- TITLE "Zen and the Art of Motorcycle Maintenance"
+ TITLE "Zen and the Art of Motorcycle Maintenance"
ROOT
- AUTHOR "Robert Pirsig"
+ AUTHOR "Robert Pirsig"
</screen>
</para>
<para>
<screen>
- TITLE "Zen and the Art of Motorcycle Maintenance"
+ TITLE "Zen and the Art of Motorcycle Maintenance"
ROOT
- FIRST-NAME "Robert"
- AUTHOR
- SURNAME "Pirsig"
+ FIRST-NAME "Robert"
+ AUTHOR
+ SURNAME "Pirsig"
</screen>
</para>
tree).
</para>
- <note>
- <para>
+ <!--
FIXME! Documentation needs extension here about types of nodes - numerical,
textual, etc., plus the various types of inclusion notes.
</para>
- </note>
+ -->
</sect2>
or all of the following:
</para>
- <para>
+ <!--
FIXME - Need a diagram here, or a simple explanation how it all hangs together -H
- </para>
+ -->
<para>
<listitem>
<para>
If this directive is followed by <literal>enable</literal>,
- then extra indexing is performed to allow for XPATH-like queries.
+ then extra indexing is performed to allow for XPath-like queries.
If this directive is not specified - equivalent to
- <literal>disable</literal> - no extra XPATH-indexing is performed.
+ <literal>disable</literal> - no extra XPath-indexing is performed.
</para>
</listitem>
</varlistentry>
is assumed by the MARC family in Z39.50.
</para>
- <para>
+ <!--
<emphasis>NOTE: FIXME! The schema-mapping functions are so far limited to a
straightforward mapping of elements. This should be extended with
mechanisms for conversions of the element contents, and conditional
mappings of elements based on the record contents.</emphasis>
- </para>
+ -->
<para>
These are the directives of the schema mapping file format:
header of the record.
</para>
- <para>
- <emphasis>NOTE: FIXME! This will be described better. We're in the process of
+ <!--
+ NOTE: FIXME! This will be described better. We're in the process of
re-evaluating and most likely changing the way that MARC records are
handled by the system.</emphasis>
- </para>
+ -->
</sect2>
is used to show the hierarchical structure of the record. All
"GRS" type records support both the GRS-1 and SUTRS
representations.
- FIXME - What is SUTRS - should be expanded here
+ <!-- FIXME - What is SUTRS - should be expanded here -->
</para>
</listitem>
abstract syntaxes can be mapped to the SOIF format, although nested
elements are represented by concatenation of the tag names at each
level.
- FIXME - Is this used anywhere ? -H
+ <!-- FIXME - Is this used anywhere ? -H -->
</para>
</listitem>