source: MILK/trunk/milk_server/milk_server/templates/atom_editor/atom_help.html @ 5196

Subversion URL: http://proj.badc.rl.ac.uk/svn/ndg/MILK/trunk/milk_server/milk_server/templates/atom_editor/atom_help.html@5196
Revision 5196, 55.0 KB checked in by cbyrom, 10 years ago (diff)

Update atom help doc to include the new data sections and new atom
structure.

Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2<html xmlns="http://www.w3.org/1999/xhtml"
3        xmlns:py="http://genshi.edgewall.org/" 
4        xmlns:xi="http://www.w3.org/2001/XInclude">
5        <xi:include href="../layout.html" />
6        <xi:include href="atom_functions.html" />
7        <head>
8        <title py:content="c.title">title</title>
9    </head>
10  <body class="submit">
11      <panelTab>Editor</panelTab>
12        <div id="contents">
13            <div class="metadata">
14                            <h3>  $c.title
15                    </h3>
16                                <h2>Contents</h2>
17                                <div class="headingblock">                 
18                    <ol>
19                        <li><a href="#intro">Introduction</a></li>
20                        <li><a href="#home">Editor home page</a></li>
21                        <li><a href="#creating">Creating an atom</a></li>
22                        <li><a href="#searching">Searching atoms</a></li>
23                        <li><a href="#editing">Editing an atom</a></li>
24                        <li><a href="#granulite">Importing granulite data</a></li>
25                        <li><a href="#csml">Importing CSML/CDML data</a></li>
26                        <li><a href="#deleting">Deleting granule atoms</a></li>
27                        <li><a href="#structure">Appendix A: Atom XML structure</a></li>
28                        <li><a href="#example">Appendix B: Creating an example set of metadata documents</a></li>
29                        <li><a href="#exampleCurating">Appendix C: Curating an example set of metadata documents</a></li>
30                    </ol>
31                    </div>
32                    <a name="intro"><h2>Introduction</h2></a>
33                                <div class="headingblock">                 
34                    <p>
35                    This editor allows the creation and maintenance of metadata documents in the MOLES2.0
36                    (Metadata Objects for Links in Environmental Science) format - which is based on the Atom
37                    Syndication Format v1.0 (details
38                    <a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">here</a>).  It
39                    replaces the CEDAR editor which produced documents according to the more complex, MOLES1.3 schema.  NB,
40                    documents produced using this older schema should be available in the BADC system in new format; if not,
41                    a migration script exists with which to enable this - contact the system administrator for details**.
42                    </p>
43                    <p>
44                    Full details of the MOLES2.0 schema are provided in section, '<a href="#structure">Appendix A: Atom XML structure</a>'.
45                    </p>
46                                </div>
47                    <a name="home"><h2>Editor home page</h2></a>
48                                <div class="headingblock">                 
49                    <p>
50                    The editor home page is available <a href="${h.url_for('atomHome')}">
51                    here</a>.  The following options are available:
52                    <ul>
53                    <li>
54                            <a href="${h.url_for('create')}">Create atom</a>
55                            - see section, '<a href="#creating">Creating an atom</a>'
56                    </li>
57                    <li>
58                            <a href="${h.url_for('createGranule')}">Create data granule atom using granulite file</a>
59                            - see section, '<a href="#granulite">Importing granulite data</a>'
60                    </li>
61                    <li>
62                            <a href="${h.url_for('list')}">Edit/List atoms</a>
63                            - see sections, '<a href="#editing">Editing an atom</a>' and '<a href="#searching">Searching atoms</a>'
64                    </li>
65                    <li>
66                            <a href="${h.url_for('help')}">Help</a>
67                            - display this page
68                    </li>
69                    </ul>
70                    </p>
71                    </div>
72
73                    <a name="creating"><h2>Creating an atom</h2></a>
74                                <div class="headingblock">                 
75                    <p>
76                    Atom metadata documents are created in two stages - firstly specifying the essential, 'header' information
77                    then filling out the remaining detail.  Documents are created by visiting the,
78                    '<a href="${h.url_for(controller='atom_editor/editatom',action='create')}">Create atom</a>' page.  This
79                    presents the user with four input fields that MUST be specified in order for the document to be created:
80                    <dl>
81                    <dt><b>Provider ID</b></dt>
82                    <dd>
83                    the name of the organisation providing the data - selectable from a pre-specified drop down list
84                    </dd>
85                    <dt><b>Data Type</b></dt>
86                    <dd>
87                    the type of atom document to produce.  This relates to the type of underlying data that
88                    the metadata is describing and must be set to one of the following, pre-specified values:
89                        <dl>
90                        <dt><b>Data Entity</b></dt>
91                        <dd>
92                        a general, high level metadata document allowing the grouping of data granules
93                        and deployments data together in a logical manner - e.g. bringing together a data granule describing a
94                        particular data file with the observation stations, data production tools and activities involved in creating it.
95                        </dd>
96                        <dt><b>Data Granule</b></dt>
97                        <dd>
98                        acts as a 'wrapper' to specific data files, providing summary metadata in
99                        order to aid discovery.  NB, data granules can be created or augmented by ingesting data directly into
100                        the system - see sections, '<a href="#importing">Importing granulite data</a>' and '<a href="#csml">Importing CSML/CDML data</a>'
101                        </dd>
102                        <dt><b>Activity</b></dt>
103                        <dd>
104                        a metadata document describing an activity used to create a dataset.
105                        </dd>
106                        <dt><b>Data Production Tool (DPT)</b></dt>
107                        <dd>
108                        a metadata document describing an instrument involved in the creation of a dataset.
109                        </dd>
110                        <dt><b>Observation Station</b></dt>
111                        <dd>
112                        a metadata document describing the observation station used to create a dataset.
113                        </dd>
114                        <dt><b>Deployment</b></dt>
115                        <dd>
116                        a simple metadata document allowing the grouping of Activity, Data Production Tool and Observation
117                        Station documents in a logical manner - i.e. to pull together the why/how/where of data production.  NB, any number of
118                        activities, data production tools and observation stations can be specified in a single deployment and these will all
119                        share the same temporal and spatial coverage summary information.  Also note, data entities do not specify references to
120                        activities, DPTs or observation stations metadata document directly; rather they reference Deployment documents which, in turn, reference
121                        these documents.  Note, a Deployment atom is just a specialisation of the 'Activity' atom type - but with a subtype of, 'Deployment'.
122                        </dd>
123                        </dl>
124                    </dd>
125                    <dt><b>Title</b></dt>
126                    <dd>
127                    free text field to specify a title for the metadata document
128                    </dd>
129                    <dt><b>Author</b></dt>
130                    <dd>
131                    free text field to specify the principal author of the underlying data described by the metadata document.
132                    </dd>
133                    </dl>
134                    Note, the atom types, 'Actitivity', 'Observation Station' and 'Data Production Tool' are known collectively as
135                    <em>Deployments data</em> - and this should not be confused with the 'Deployment' atom type - which is the document
136                    type which groups together Deployments data.
137                    </p>
138                    <p>
139                    Once the header info is completed, the atom document is created and the user is taken to the 'Edit' page
140                    (see section, '<a href="#editing">Editing an atom</a>') where additional content can be specified.  Note, the edit
141                    page allows the author and title details to be edited, however the provider and type data cannot be changed
142                    following document creation.
143                    </p>
144                    </div>
145                   
146                    <a name="searching"><h2>Searching atoms</h2></a>
147                                <div class="headingblock">                 
148                    <p>
149                    The atom metadata catalogue can be searched by visiting the
150                    '<a href="${h.url_for(controller='atom_editor/listatom',action='list', searchData=None)}">Edit/List atoms</a>' page.
151                    This provides a simple search filter allowing the user to specify the following inputs to search on:
152                    <dl>
153                    <dt><b>Provider ID</b></dt><dd>
154                    - the name of the organisation providing the data - selectable from a pre-specified drop down list
155                    </dd>
156                    <dt><b>Data Type</b></dt>
157                    <dd>
158                    the type of atom document to search for - selectable from a pre-specified drop down list
159                                </dd>
160                                <dt><b>Search Text</b></dt>
161                                <dd>
162                                a free text field to allow searching for specific data
163                                </dd>
164                                </dl>
165                                NB, the 'Search Text' field allows the contents of the atom elements to be searched and is done in a
166                                cumulative manner when multiple words are specified - e.g. searching using, 'temperature hot' will return
167                                all atoms which feature both the words 'temperature' and 'hot', although not necessarily in that order or
168                                adjacent to one another.  Additionally, simple wildcards can be used in the searches - using '*' to represent
169                                all characters, multiple times and '?' to represent a single character - demonstrated as follows:
170                                <dl>
171                                        <dt><b>temp*</b></dt>
172                                        <dd>
173                                        will return existing documents containing 'temperature', 'temperate', 'temporary', etc
174                                        </dd>
175                                        <dt><b>?eather</b></dt>
176                                        <dd>
177                                        will return existing documents containing 'weather', 'heather', 'leather', etc
178                                        </dd>
179                                </dl>
180                                Note, also, text searches are case insensitive.
181                                </p>
182                                <p>
183                                To search for documents, enter the required search terms (NB, leaving the filter in its initial state, with
184                                Provider ID and Data Type set to 'All' and Search Text empty, will return all available atom documents) and
185                                click the 'Search' button.  If data exists matching the search criteria, these will be displayed after a short
186                                pause in a table of results.  To view this data in more detail, click the 'Edit' button associated with it.  This will
187                                take you to the atom editor, described in the section, '<a href="#editing">Editing an atom</a>'.
188                    </p>
189                    </div>
190                   
191                    <a name="editing"><h2>Editing an atom</h2></a>
192                                <div class="headingblock">                 
193                    <p>
194                    The main 'Edit' page for an atom is reached via two routes: either by creating a new atom
195                    (see section, '<a href="#creating">Creating an atom</a>'); or by searching
196                    existing atoms and electing to edit one of these (see section, '<a href="#searching">Searching atoms</a>').
197                    </p>
198                    <p>
199                    The following inputs are available to the atom editor - note, some are
200                    only available to specific atom types:
201                    <dl>
202                    <dt><b>Title</b>
203                    </dt>
204                    <dd>
205                    free text field to specify a title for the metadata document
206                    </dd>
207                    <dt>
208                    <b>Sub-Type</b> (not Deployments or Granules)
209                    </dt>
210                    <dd>
211                    more specific classification of the type of the underlying data - selectable from a fixed list - which is dependent on the main atom type
212                    </dd>
213                    <dt>
214                    <b>Abbreviation</b> (not Deployments or Granules)
215                    </dt>
216                    <dd>
217                    free text field to specify an abbreviation for the data
218                    </dd>
219                    <dt>
220                    <b>Publication state</b>
221                    </dt>
222                    <dd>
223                    publication state of the metadata - selectable from one of four categories:
224                    <ul>
225                        <li> 'old' - for redundant records; these are available from the browse service, if their direct link is known, however they will not be displayed in search results - unless the browse search is ran in the editor</li>
226                        <li>'working' - for new/in progress records; these are only available from the browse service when it is running with the editor</li>
227                        <li>'published' - for records approaching maturity, which may still change, but should be available via the browse and discovery services</li>
228                        <li>'Published' for mature records that are unlikely to change and should be available via the browse and discovery services</li>
229                    </ul>
230                    </dd>
231                    <dt>
232                    <b>Upload data</b> (Data Granules only)
233                    </dt>
234                    <dd>
235                                functionality to allow the import of data direct from CDML or CSML
236                                files - as described in section, '<a href="#csml">Importing CSML/CDML data</a>'.
237                    </dd>
238                    <dt>
239                    <b>Summary</b> (not Deployments or Granules)
240                    </dt>
241                    <dd>
242                    free text area to provide an abstract for the data
243                    </dd>
244                    <dt>
245                    <b>Content</b> (not Deployments)
246                    </dt>
247                    <dd>
248                    the actual main content of the metadata document.  This may just be
249                    text content, but in the case of Granule atoms, if a CSML or CDML file
250                    has been specified (see section '<a href="#csml">Importing CSML/CDML data</a>',
251                    this will be set as the atom content.
252                    </dd>
253                    <dt>
254                    <b>Lineage</b> (Data Entities only)
255                    </dt>
256                    <dd>
257                    summary of the origins of the dataset, e.g.: "Dataset produced from NASA MODIS instrument on Terra and collected at the University of York's groundstation 1999-2003 and a copy provided to NEODC in June 2007".
258                    </dd>
259                    <dt>
260                    <b>Quality</b> (Data Entities only)
261                    </dt>
262                    <dd>
263                    description of the relative quality of the dataset
264                    </dd>
265                    <dt>
266                    <b>Author</b>
267                    </dt>
268                    <dd>
269                    the principal author of the underlying data being described by the atom. An
270                    email address can be provided with the author name.
271                    </dd>
272                    <dt>
273                    <b>Contributors</b> (not Deployments)
274                    </dt>
275                    <dd>
276                    secondary authors of the underlying data - together with email addresses, if required.
277                    Three contributors can be added at a time; if more are required, add the first three
278                    then click, 'Update' - and space will be added to input another three contributors.
279                    Contributors can be removed by selecting the check box and clicking on 'Remove'.  NB,
280                    multiple contributors can be removed at once.
281                    </dd>
282                    <dt>
283                    <b>Online References</b> (not Deployments or Granules)
284                    </dt>
285                    <dd>
286                    reference links to data associated with the underlying data - composed of a link 'type',
287                    or 'relation' together with a URI and a title.  Note, the URI must follow the format,
288                    'http://www.somesite.com' - i.e. including the full address.  Like 'Contributors', it is
289                    possible to add and remove multiple online references at once.
290                    </dd>
291                    <dt>
292                    <b>Associated Data Granules</b> (Data Entities only)
293                    </dt>
294                    <dd>
295                    references to existing data granule atoms.  Clicking
296                    on the 'Add' link in this section takes the user to the atom list page (see section
297                    '<a href="#searching">Searching atoms</a>').  Since the user is setting up
298                    data granule associations, only atoms of this type can now be searched on.  Once
299                    a search has been done (narrowing results by specifying suitable search terms, if required),
300                    if results have been found, the user can then set up associations with these, by
301                    using the checkboxes to select the specific granules and then clicking 'Add selections'.
302                    If associations with granules need to be removed, click the 'Edit' link, select the
303                    granule(s) to remove using the checkbox and then click, 'Remove'.
304                    </dd>
305                    <dt>
306                    <b>Associated Deployments</b> (Data Entities only)
307                    </dt>
308                    <dd>
309                    references to existing deployment atoms.  The process to add
310                    and remove associations is the same as for data granules, above.
311                    </dd>
312                    <dt>
313                    <b>Associated Data</b> (Deployments only)
314                    </dt>
315                    <dd>
316                    references to existing activity/observation station/data production tool atoms.  The process to add
317                    and remove associations is the same as for data granules, above.
318                    </dd>
319                    <dt>
320                    <b>Parameters</b> (Data Entities only)
321                    </dt>
322                    <dd>
323                    parameters categorising the underlying data described by the metadata document.  Parameter data consists
324                    of a label together with a URL to a valid vocabulary term (i.e. available from a vocab server - such as
325                    'http://vocab.ndg.nerc.ac.uk/') and term ID.  On input the validity of the vocab term data is checked and
326                    the data will be rejected if it is invalid.
327                    </dd>
328                    <dt>
329                    <b>Data Coverage</b>
330                    </dt>
331                    <dd>
332                    a summary of the spatiotemporal coverage of the underlying data.  Input fields allow the specification of
333                    max/min coordinates, temporal ranges, spatial resolution and vertical extents.
334                    </dd>
335                    <dt>
336                    <b>Responsible Parties</b>
337                    </dt>
338                    <dd>
339                    information on individuals responsible for the creation and maintenance
340                    of the actual atom metadata document - consists of free text information
341                    to specify the user role, name and uri (if required).  As with Contributors,
342                    multiple data can be added - and subsequently removed.
343                    </dd>
344                    <dt>
345                    <b>Other Info</b> (Data Entities only)
346                    </dt>
347                    <dd>
348                    additional miscellaneous data - currently allows the input of the dataset language
349                    and the update frequency
350                    </dd>
351                   
352                    </dl>
353                   
354                    In addition to the input fields, some atom types have additonal, 'summary'
355                    information displayed - relating to atoms which have a logical reference to
356                    the current document.  Specifically, the following summaries are available:
357                    <dl>
358                    <dt>
359                    <b>Associated Deployments Data (summary/details)</b> (Data Entities and Deployments data only)
360                    </dt>
361                    <dd>
362                    displays a list of the associated Deployments data - via associated Deployment atoms - i.e.
363                    this gathers info from all Deployment documents which reference the current
364                    data and lists out all the other Deployments data featured.  For example, if a Deployment
365                    features Activity1, DPT1 and Observation Station2, and we are viewing Activity1, then
366                    DPT1 and Observation Station2 will be displayed (together with links to the actual docs)
367                    here.  Clicking on the plus/minus sign toggles between the summary and details mode.
368                    Summary mode displays a unique list of the associated Deployments data whereas details mode
369                    shows exactly how this is grouped, together with temporal ranges, in the Deployment atoms.
370                    </dd>
371                    <dt>
372                    <b>Associated Data Entities - summary</b> (Deployments data and Granules only)
373                    </dt>
374                    <dd>
375                    displays a list of the associated Data Entities data - together with links to this data. 
376                    For Deployments data, the list is constructed
377                    by finding all Deployment atoms which feature the currently displayed atom, then
378                    finding all Data Entities which reference these Deployments.  For Data Granule atoms,
379                    this list is constructed by finding all the Data Entities which directly reference the
380                    displayed Granule.
381                    </dd>
382                    </dl>
383                    </p>
384                    </div>
385                    <a name="granulite"><h2>Importing granulite data</h2></a>
386                                <div class="headingblock">                 
387                    <p>
388                    Data can be imported directly into the system using a type of data file known
389                    as a <em>granulite</em>.  These are used to create Data Granule metadata documents
390                    and set up associations with existing Data Entities.  The format of a granulite file
391                    can be seen here - <a href="${h.url_for('example')}">example granulite</a>.
392                    </p>
393                    <p>
394                    When a valid granulite file has been constructed, the contents may be ingested by
395                    visiting the '<a href="${h.url_for('createGranule')}">Create data granule atom using granulite file</a>' page.
396                    This presents the user with the following input fields:
397                    <dl>
398                    <dt><b>
399                    Granulite File
400                    </b></dt>
401                    <dd>
402                    Clicking on 'Browse...' produces a file browser window to allow users to
403                    navigate and select their granulite file.
404                    </dd>
405                    <dt><b>
406                    CSML or CDML file
407                    </b></dt>
408                    <dd>
409                    Clicking on 'Browse...' produces a file browser window to allow users to
410                    navigate and select their CSML or CDML file.  This file is used to augment data
411                    specified in the granulite file and is uploaded to the document repository upon
412                    ingest.  Note, only one CSML or CDML
413                    file can be ingested per granulite file.  Also note, if a CDML file is ingested
414                    it is coverted into a CSML file, as part of the ingest, to extract the required
415                    summary data; both the original CDML file and the generated CSML file are subsequently
416                    stored in the document repository.
417                    </dd>
418                    <dt><b>
419                    Dataset ID
420                    </b></dt>
421                    <dd>
422                    *****************THIS SHOULD PROBABLY BE REMOVED - NEEDS TESTING....****
423                    </dd>
424                    <dt><b>
425                    Time axis
426                    </b></dt>
427                    <dd>
428                    If a CDML file is specified, it is necessary to identify the time axis label
429                    used by the file in order to extract all the available data.  If no axis is provided,
430                    the default, 'time' will be used.
431                    </dd>
432                    </dl>
433                    </p>
434                    <p>
435                    <h2>Use Cases</h2>
436                    The ingesting of granulite data has several possible workflows; these are
437                    described in detail here.
438                    <dl>
439                    <dt><b>
440                    1. Ingest of new granulite, with no CSML/CDML file, describing new Data Granule
441                    </b></dt>
442                    <dd>
443                    The granulite should not have a dataset_id specified in the granule_info as this
444                    will be automatically generated upon ingest.  User selects the granulite file
445                    using the 'Granulite file' Browse input.  User clicks 'Upload'.  The data is then
446                    ingested and, if no problems are encountered, a new Data Granule is created using
447                    this data and then displayed.
448                    </dd>
449                    <dt><b>
450                    2. Ingest of old granulite, with no CSML/CDML file or dataset_id specified
451                    </b></dt>
452                    <dd>
453                    If no dataset_id has been specified, the ingest process has no way of knowing
454                    that the data has already been ingested.  In this case, a new Data Granule is
455                    created - effectively with identical contents to another Data Granule.
456                    </dd>
457                    <dt><b>
458                    3. Ingest of old granulite, with no CSML/CDML file specified, but dataset_id of existing Data Granule <em>is</em>specified
459                    </b></dt>
460                    <dd>
461                    If the dataset_id has been specified, and if an existing Data Granule is already using this ID, the
462                    ingest process is interupted and the user is asked whether they want to overwrite the existing
463                    Data Granule with the new Data Granule generated from the granulite file contents.  If the user
464                    clicks, 'Cancel' then the ingest is halted and they remain on the granulite ingest page.  If they
465                    click, 'Ok' then the ingest continues and the old Data Granule is replaced with the new one.  NB, in
466                    this scenario, any links between Data Entities and the old Data Granule are removed.
467                    </dd>
468                    <dt><b>
469                    4. Ingest of new granulite with CSML file specified
470                    </b></dt>
471                    <dd>
472                    Work flow as Use Case 1, however a CSML file is also specified - using the Browse input for this
473                    field.  When the user clicks 'Upload' the CSML file is the scanned to extract the following data:
474                    <ul>
475                    <li>
476                    CSML ID - to be used as the produced Data Granule dataset ID
477                    </li>
478                    <li>
479                    Title
480                    </li>
481                    <li>
482                    Spatiotemporal coverage data
483                    </li>
484                    <li>
485                    Parameters data
486                    </li>
487                    </ul>
488                    This is used to create a new Data Granule and the CSML file is uploaded to the
489                    document repository.  The granulite data is then extracted
490                    and applied to this new Data Granule.  NB, this will lead to replacement of any
491                    single value data, if specified - i.e. the ID, Title and coverage data.  The parameters
492                    data will be augmented with any new, unique terms.
493                    </dd>                   
494                    <dt><b>
495                    5. Ingest of new granulite with CDML file specified
496                    </b></dt>
497                    <dd>
498                    As Use Case 4, however the CDML file is firstly converted into a
499                    CSML file, using the additional supplied inputs, if required.  NB, both
500                    the original CDML file and the generated CSML file are uploaded to the
501                    document repository.
502                    </dd>
503                    <dt><b>
504                    6. Ingest of old granulite with CSML/CDML file and dataset ID specified
505                    </b></dt>
506                    <dd>
507                    Similarly to Use Case 3, the user will be prompted to confirm whether the
508                    ingest should complete - and overwrite the existing Data Granule.  If the
509                    user selects to do this, workflow continues as for Use Case 4/5.
510                    </dd>
511                    </dl>
512                    </p>
513                    <p>
514                    Note, the granulite ingest functionality is also available as a command line
515                    process - which may be more appropriate for batch processing large numbers of
516                    granulite files.
517                    </p>
518                    </div>
519                    <a name="csml"><h2>Importing CSML/CDML data</h2></a>
520                                <div class="headingblock">                 
521                    <p>
522                    As well as importing data from granulite files (see section, '<a href="#granulite">Importing granulite data</a>'),
523                    it is also possible to ingest data directly from CSML or CDML files into existing Data Granules.
524                    </p>
525                    <p>
526                    If a Data Granule doesn't already have a CSML or CDML file associated with it, it
527                    will have an 'Upload data' input section available to it in edit mode.  This is
528                    similar to the input used for the granulite ingest - except the option to specify
529                    a granulite file is absent.  A user can specify a CSML or CDML file and click,
530                    'Upload' to add data from the file to the Data Granule.  NB, as with the granulite
531                    ingest, if a CDML file is specified, it may be necessary to include a time axis, to
532                    aid the parsing of this file.  Also, like the granulite ingest, CDML files are used
533                    to create CSML files - and both these types of document are uploaded to the document
534                    repository as part of the upload process.
535                    </p>
536                    <p>
537                    Note, if the data to upload is of a large size, please be patient as this operation
538                    may take some time to complete.
539                    </p>
540                    <p>
541                    When the upload is completed, the new data is saved to the Data Granule and this is
542                    reloaded to display the new contents.  NB, it is only possible to associate a single
543                    CDML or CSML file with a Data Granule so, following the initial upload, this input
544                    functionality is then disabled.  The 'Content File' section is filled in automatically
545                    to display the name of the uploaded CSML/CDML.
546                    </p>
547                    </div>
548                    <a name="deleting"><h2>Deleting granule atoms</h2></a>
549                                <div class="headingblock">                 
550                    <p>
551                    Data Granules, and their associations with Data Entities, may be deleted from
552                    the system.  To do this, access the Data Granule in question, via the search
553                    page (see section '<a href="#searching">Searching atoms</a>') and click on the
554                    'Delete' button at the top of the editor.  The user is then presented with a
555                    confirmation dialog, to avoid accidental deletion of data.  If the user confirms the
556                    delete, the Data Granule atom is deleted and links to it from Data Entity atoms are removed.
557                    NB, before the atom is deleted a copy is stored in the backup collection of the document
558                    repository.
559                    </p>
560                    </div>
561                    <a name="structure"><h2>Appendix A: atom XML structure</h2></a>
562                                <div class="headingblock">                 
563                    <p>
564                    The XML structure of a dummy Data Entity document is given described below.  The various metadata inputs
565                    discussed in section, '<a href="#editing">Editing an atom</a>' should be evident in this structure.  Points of note
566                    include:
567                    <ul>
568                    <li>
569                    Online references are stored as atom links
570                    </li>
571                    <li>
572                    Parameters are stored as atom categories
573                    </li>
574                    <li>
575                    Atom type and subtype are stored as atom categories
576                    </li>
577                    <li>
578                    The atom id element is a unique identifier - an IRI as specified by <a href="http://tools.ietf.org/html/rfc3987">[RFC3987]</a> - this includes the atom dataset ID
579                    </li>
580                    <li>
581                    The Atom1.0 schema has been extended to include data that didn't naturally fit in it, namely:
582                        <ul>
583                        <li>
584                                Spatiotemporal data - which is described in GEOSS, GML and Moles elements
585                        </li>
586                        <li>
587                        Responsible parties data
588                        </li>
589                        <li>
590                        Dataset and metadata language
591                        </li>
592                        <li>
593                        Abbreviation
594                        </li>
595                        <li>
596                        Creation date
597                        </li>
598                        <li>
599                        Provider ID
600                        </li>
601                        </ul>
602                        NB, the Moles elements are based on the old MOLES1.3 format.  Note, also, that the schema
603                        could be further simplified by judicious use of vocab terms - effectively translating
604                        the latter four bits of data into categories data.
605                    </li>
606                    </ul>
607                    <pre>
608            <div class="xmlDocBig"><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">entry <span class="xmlAttrTyp">xmlns</span>="<span class="xmlAttrVal">http://www.w3.org/2005/Atom</span>" <span class="xmlAttrTyp">xmlns:georss</span>="<span class="xmlAttrVal">http://www.georss.org/georss/10</span>"
609            <span class="xmlAttrTyp">xmlns:moles</span>="<span class="xmlAttrVal">http://ndg.nerc.ac.uk/schema/moles2beta</span>" <span class="xmlAttrTyp">xmlns:gml</span>="<span class="xmlAttrVal">http://www.opengis.net/gml</span>"</span><b>></b>
610<div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">id</span><b>></b>tag:localhost,2008-12-23:/view/badc.nerc.ac.uk__ATOM__DE_077c33f0-d0f8-11dd-b324-00188b13dc5a<b>&lt;</b>/<span class="xmlElemTag">id</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">title</span><b>></b>A data entity describing some data used in a measurement.<b>&lt;</b>/<span class="xmlElemTag">title</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">link</span> <span class="xmlAttrTyp">href</span>="<span class="xmlAttrVal">http://localhost:5000/view/badc.nerc.ac.uk__ATOM__DE_077c33f0-d0f8-11dd-b324-00188b13dc5a</span>" <span class="xmlAttrTyp">rel</span>="<span class="xmlAttrVal">self</span>"<b>></b><b>&lt;</b>/<span class="xmlElemTag">link</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">link</span> <span class="xmlAttrTyp">href</span>="<span class="xmlAttrVal">http://localhost:5000/view/badc.nerc.ac.uk__ATOM__ACTIVITY_e6b77f61-d0e0-11dd-a6c8-00188b13dc5a</span>"
611<span class="xmlAttrTyp">rel</span>="<span class="xmlAttrVal">NOT YET SET UP/None/Deployment</span>" <span class="xmlAttrTyp">title</span>="<span class="xmlAttrVal">dep1</span>"<b>></b><b>&lt;</b>/<span class="xmlElemTag">link</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">link</span> <span class="xmlAttrTyp">href</span>="<span class="xmlAttrVal">http://localhost:5000/view/badc.nerc.ac.uk__ATOM__ACTIVITY_db75de0f-d0f6-11dd-86d8-00188b13dc5a</span>"
612<span class="xmlAttrTyp">rel</span>="<span class="xmlAttrVal">NOT YET SET UP/None/Deployment</span>" <span class="xmlAttrTyp">title</span>="<span class="xmlAttrVal">dep266</span>"<b>></b><b>&lt;</b>/<span class="xmlElemTag">link</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">link</span> <span class="xmlAttrTyp">href</span>="<span class="xmlAttrVal">http://localhost:5000/view/badc.nerc.ac.uk__ATOM__GRANULE_4f32c0b0-d0e4-11dd-aff3-00188b13dc5a</span>"
613<span class="xmlAttrTyp">rel</span>="<span class="xmlAttrVal">GRAN - NOT YET SET UP/None/GRANULE</span>" <span class="xmlAttrTyp">title</span>="<span class="xmlAttrVal">gran1</span>"<b>></b><b>&lt;</b>/<span class="xmlElemTag">link</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">link</span> <span class="xmlAttrTyp">href</span>="<span class="xmlAttrVal">http://localhost:5000/view/badc.nerc.ac.uk__ATOM__GRANULE_85813fcf-d197-11dd-afef-00188b13dc5a</span>"
614<span class="xmlAttrTyp">rel</span>="<span class="xmlAttrVal">GRAN - NOT YET SET UP/None/GRANULE</span>" <span class="xmlAttrTyp">title</span>="<span class="xmlAttrVal">new gran12</span>"<b>></b><b>&lt;</b>/<span class="xmlElemTag">link</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">link</span> <span class="xmlAttrTyp">href</span>="<span class="xmlAttrVal">http://tessella.com</span>" <span class="xmlAttrTyp">rel</span>="<span class="xmlAttrVal">http://vocab.ndg.nerc.ac.uk/term/N041/3/4</span>" <span class="xmlAttrTyp">title</span>="<span class="xmlAttrVal">Tessella</span>"<b>></b><b>&lt;</b>/<span class="xmlElemTag">link</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">link</span> <span class="xmlAttrTyp">href</span>="<span class="xmlAttrVal">http://bbc.co.uk</span>" <span class="xmlAttrTyp">rel</span>="<span class="xmlAttrVal">http://vocab.ndg.nerc.ac.uk/term/N041/3/2</span>" <span class="xmlAttrTyp">title</span>="<span class="xmlAttrVal">Data</span>"<b>></b><b>&lt;</b>/<span class="xmlElemTag">link</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">link</span> <span class="xmlAttrTyp">href</span>="<span class="xmlAttrVal">http://measurement.co.uk</span>" <span class="xmlAttrTyp">rel</span>="<span class="xmlAttrVal">http://vocab.ndg.nerc.ac.uk/term/N041/3/1</span>" <span class="xmlAttrTyp">title</span>="<span class="xmlAttrVal">object home</span>"<b>></b><b>&lt;</b>/<span class="xmlElemTag">link</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">author</span><b>></b>
615<div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">name</span><b>></b>Mr Smith<b>&lt;</b>/<span class="xmlElemTag">name</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">email</span><b>></b>mrsmith@gmail.com<b>&lt;</b>/<span class="xmlElemTag">email</span><b>></b></div><b>&lt;</b>/<span class="xmlElemTag">author</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">contributor</span><b>></b>
616<div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">name</span><b>></b>Mrs Smith<b>&lt;</b>/<span class="xmlElemTag">name</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">email</span><b>></b>mrssmith@gmail.com<b>&lt;</b>/<span class="xmlElemTag">email</span><b>></b></div><b>&lt;</b>/<span class="xmlElemTag">contributor</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">contributor</span><b>></b>
617<div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">name</span><b>></b>Mr Yang<b>&lt;</b>/<span class="xmlElemTag">name</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">email</span><b>></b>yang@yahoo.co.uk<b>&lt;</b>/<span class="xmlElemTag">email</span><b>></b></div><b>&lt;</b>/<span class="xmlElemTag">contributor</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">category</span> <span class="xmlAttrTyp">term</span>="<span class="xmlAttrVal">ATOM_TYPE</span>" <span class="xmlAttrTyp">scheme</span>="<span class="xmlAttrVal">DE - NOT YET SET UP/None/DE</span>" <span class="xmlAttrTyp">label</span>="<span class="xmlAttrVal">DE</span>"<b>></b><b>&lt;</b>/<span class="xmlElemTag">category</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">category</span> <span class="xmlAttrTyp">term</span>="<span class="xmlAttrVal">ATOM_SUBTYPE</span>" <span class="xmlAttrTyp">scheme</span>="<span class="xmlAttrVal">NOT YET SET UP/None/dgMeasurement</span>" <span class="xmlAttrTyp">label</span>="<span class="xmlAttrVal">dgMeasurement</span>"<b>></b><b>&lt;</b>/<span class="xmlElemTag">category</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">summary</span><b>></b>This data entity represents some measurement data.<b>&lt;</b>/<span class="xmlElemTag">summary</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">content</span> <span class="xmlAttrTyp">type</span>="<span class="xmlAttrVal">xhtml</span>"<b>></b>
618<div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">{http://www.w3.org/1999/xhtml}div</span><b>></b>Some more details of the measurement data.
619blah,
620blah,
621blah...<b>&lt;</b>/<span class="xmlElemTag">{http://www.w3.org/1999/xhtml}div</span><b>></b></div><b>&lt;</b>/<span class="xmlElemTag">content</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">updated</span><b>></b>2008-12-24T13:42:51Z<b>&lt;</b>/<span class="xmlElemTag">updated</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">published</span><b>></b>2008-12-23T13:45:59Z<b>&lt;</b>/<span class="xmlElemTag">published</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:entity</span><b>></b>
622<div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:molesISO</span><b>></b><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:datasetLanguage</span><b>></b>English<b>&lt;</b>/<span class="xmlElemTag">moles:datasetLanguage</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:metadataLanguage</span><b>></b>English<b>&lt;</b>/<span class="xmlElemTag">moles:metadataLanguage</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:updateFrequency</span><b>></b>Once in a blue moon.<b>&lt;</b>/<span class="xmlElemTag">moles:updateFrequency</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:lineage</span><b>></b>This data came from the sea.  It then travelled on land and climbed a tree.<b>&lt;</b>/<span class="xmlElemTag">moles:lineage</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:quality</span><b>></b>Reasonable quality, but really must try harder<b>&lt;</b>/<span class="xmlElemTag">moles:quality</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:responsibleParties</span><b>></b><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:responsibleParty</span><b>></b><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:name</span><b>></b>Calum Byrom<b>&lt;</b>/<span class="xmlElemTag">moles:name</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:uri</span><b>></b>www.tessella.com<b>&lt;</b>/<span class="xmlElemTag">moles:uri</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:role</span><b>></b>Data migrator<b>&lt;</b>/<span class="xmlElemTag">moles:role</span><b>></b></div><b>&lt;</b>/<span class="xmlElemTag">moles:responsibleParty</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:responsibleParty</span><b>></b><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:name</span><b>></b>Calum Byrom<b>&lt;</b>/<span class="xmlElemTag">moles:name</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:uri</span><b>></b>www.tessella.com<b>&lt;</b>/<span class="xmlElemTag">moles:uri</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:role</span><b>></b>Data curator<b>&lt;</b>/<span class="xmlElemTag">moles:role</span><b>></b></div><b>&lt;</b>/<span class="xmlElemTag">moles:responsibleParty</span><b>></b></div><b>&lt;</b>/<span class="xmlElemTag">moles:responsibleParties</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:abbreviation</span><b>></b>ANON<b>&lt;</b>/<span class="xmlElemTag">moles:abbreviation</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:spatialResolution</span><b>></b>quite detailed but not that detailed<b>&lt;</b>/<span class="xmlElemTag">moles:spatialResolution</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:verticalExtent</span><b>></b>higher than you might think<b>&lt;</b>/<span class="xmlElemTag">moles:verticalExtent</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:providerID</span><b>></b>badc.nerc.ac.uk<b>&lt;</b>/<span class="xmlElemTag">moles:providerID</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:created</span><b>></b>2008-12-23T13:45:59Z<b>&lt;</b>/<span class="xmlElemTag">moles:created</span><b>></b></div><b>&lt;</b>/<span class="xmlElemTag">moles:molesISO</span><b>></b></div><b>&lt;</b>/<span class="xmlElemTag">moles:entity</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">moles:temporalRange</span><b>></b>1901-01-01/2003-04-29<b>&lt;</b>/<span class="xmlElemTag">moles:temporalRange</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">georss:where</span><b>></b>
623<div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">gml:Envelope</span><b>></b>
624<div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">gml:lowerCorner</span><b>></b>-29 -02<b>&lt;</b>/<span class="xmlElemTag">gml:lowerCorner</span><b>></b></div><div class="xmlElem"><b>&lt;</b><span class="xmlElemTag">gml:upperCorner</span><b>></b>44 89<b>&lt;</b>/<span class="xmlElemTag">gml:upperCorner</span><b>></b></div><b>&lt;</b>/<span class="xmlElemTag">gml:Envelope</span><b>></b></div><b>&lt;</b>/<span class="xmlElemTag">georss:where</span><b>></b></div><b>&lt;</b>/<span class="xmlElemTag">entry</span><b>></b></div></div>
625</pre>
626                    </p>
627                    </div>
628                    <a name="example"><h2>Appendix B: Creating an example set of metadata documents</h2></a>
629                                <div class="headingblock">                 
630                    <p>
631                    Setting up a collection of metadata documents is described in the following example:
632                    <dl>
633                    <dt>
634                    <b>
635                    1. Create a Data Granule atom
636                    </b>
637                    </dt>
638                    <dd>
639                    <ol>
640                    <li>
641                    From the <a href="${h.url_for('atomHome')}">atom home page</a>, click on <a href="${h.url_for('create')}">Create atom</a> link.
642                    </li>
643                    <li>
644                    Select the required Provider ID and select, 'Data Granule' as the Data Type.
645                    </li>
646                    <li>
647                    Click 'Create'.  The editor will now complain about missing author and title data - so provide these.
648                    </li>
649                    <li>
650                                The editor will create a new Data Granule atom and open this in the main editor page.  Add additional
651                                information by editing the different sections and clicking 'Update' each time.
652                    </li>
653                    </ol>
654                    </dd>
655                    <dt>
656                    <b>
657                    2. Create a Data Entity atom and link the Data Granule atom
658                    </b>
659                    </dt>
660                    <dd>
661                    <ol>
662                    <li>
663                    Return to the home page, clicking on the <a href="${h.url_for('atomHome')}">Home</a> link.
664                    </li>
665                    <li>
666                    Click on <a href="${h.url_for('create')}">Create atom</a> link and create a new atom - this type specifying 'Data Entity' as the data type.
667                    </li>
668                    <li>
669                    Add additional data to the Data Entity document; notice there are several extra inputs available
670                    </li>
671                    <li>
672                    Click the 'Add' link in the 'Associated Data Granules' section - this will open the <a href="${h.url_for('list')}">atom search</a> page.
673                    </li>
674                    <li>
675                    Leave the filter blank in its initial state and click, 'Search'.  The Data Granule created in
676                    the previous section should now be displayed.  Gain familiarisation with the search filter,
677                    try changing the selected provider ID and entering search terms - with and without wildcards
678                    (see section '<a href="#searching">Searching atoms</a>' for details).
679                    </li>
680                    <li>
681                    Select the Data Granule created in the previous section, by clicking its checkbox
682                    and then click 'Add Selections'.  The editor will now return to the Data Entity atom; notice
683                    it now displays the Data Granule just added in its 'Associated Data Granules' section.
684                    </li>
685                    <li>
686                    Click on the link to Data Granule in the 'Associated Data Granules' section.  When this
687                    loads notice the 'Associated Data Entities' section now contains the Data Entity to which this atom
688                    has just been associated.
689                    </li>
690                    </ol>
691                    </dd>
692                    <dt>
693                    <b>
694                    3. Create Activity, Observation Station and DPT atoms
695                    </b>
696                    </dt>
697                    <dd>
698                    <ol>
699                    <li>
700                    Return to the home page, clicking on the <a href="${h.url_for('atomHome')}">Home</a> link.
701                    </li>
702                    <li>
703                    Click on <a href="${h.url_for('create')}">Create atom</a> link and create a new atom - this type specifying 'Activity' as the data type.
704                    </li>
705                    <li>
706                    Add additional data to the Activity atom; notice, again, the slightly different available content for input.
707                    </li>
708                    <li>
709                    Repeat steps 2. and 3., specifying Data Types of 'Observation Station' and 'Data Production Tool'
710                    </li>
711                    </ol>
712                    </dd>
713                    <dt>
714                    <b>
715                    4. Create a Deployment atom and link to Deployment Data atoms
716                    </b>
717                    </dt>
718                    <dd>
719                    <ol>
720                    <li>
721                    Return to the home page, clicking on the <a href="${h.url_for('atomHome')}">Home</a> link.
722                    </li>
723                    Click on <a href="${h.url_for('create')}">Create atom</a> link and create a new atom - this type specifying 'Deployment' as the data type.
724                    <li>
725                    Click the 'Add' link in the 'Associated Data' section then search for and add the Deployment Data atoms created in the previous section.
726                    </li>
727                    <li>
728                    The editor will now return to the Deployment atom; notice
729                    it now displays the newly added Deployment Data just added in its 'Associated Data' section.
730                    </li>
731                    <li>
732                    Click on a link to one of the Deployment Data atoms.  This will open the data in 'view' mode.
733                    Click the 'Edit' button at the top of the document to open it in edit mode.  Notice that the
734                    'Associated Deployments Data' now displays the other Deployment Data atoms associated with this
735                    one by the newly created Deployment atom.
736                    </li>
737                    </ol>
738                    </dd>
739                    <dt>
740                    <b>
741                    6. Link Deployment atom to Data Entity atom
742                    </b>
743                    </dt>
744                    <dd>
745                    <li>
746                    Return to the home page, clicking on the <a href="${h.url_for('atomHome')}">Home</a> link.
747                    </li>
748                    <li>
749                    Click on <a href="${h.url_for('list')}">Edit/List atoms</a> and search for the Data Entity created previously.
750                    </li>
751                    <li>
752                    Once found, click 'Edit' to view the Data Entity in the editor.
753                    </li>
754                    <li>
755                    Click the 'Add' link in the 'Associated Deployements' section - and use the search filter to find and add the
756                    Deployment atom just created.
757                    </li>
758                    <li>
759                    The editor returns to the Data Entity atom; notice that the 'Associated Deployments'
760                    section now contains the Deployment atom just added.  Also note the 'Associated Deployments Data'
761                    section now contains summary data from the newly added Deployment atom.
762                    </li>
763                    <li>
764                    Click on the plus/minus sign on the 'Associated Deployments Data' section to
765                    view the data at different levels of detail
766                    </li>
767                    <li>
768                    Click on a link to one of the associated Deployment Data atoms.  When this loads notice
769                    the 'Associated Data Entities' section now contains the Data Entity to which this atom
770                    has just been associated (indirectly via the Deployment atom).
771                    </li>
772                    </dd>
773                    </dl>
774                    </p>
775                    </div>
776                    <a name="exampleCurating"><h2>Appendix C: Curating an example set of metadata documents</h2></a>
777                                <div class="headingblock">                 
778                    <p>
779                    Updating a collection of metadata documents is described in the following example (which assumes the previous Appendix has been completed):
780                    <dl>
781                    <dt>
782                    <b>
783                    1. Curate the Deployment details
784                    </b>
785                    </dt>
786                    <dd>
787                    <li>
788                    From the <a href="${h.url_for('atomHome')}">atom home page</a>, click on the <a href="${h.url_for('list')}">Edit/List atoms</a> link and search for and open the Deployment atom created previously.
789                    </li>
790                    <li>
791                    Click on the 'Edit' link for the 'Associated Data' section.
792                    </li>
793                    <li>
794                    Select a couple of the Deployment Data atoms and click 'Remove'.
795                    </li>
796                    <li>
797                    The Deployment atom now updates - when it reloads notice the selected
798                    Deployment Data atoms are no longer referenced.
799                    </li>
800                    <li>
801                    Click on a remaining Deployment Data atom link - and notice, when this loads, that
802                    it has a reduced set of 'Associated Deployments Data'
803                    </li>
804                    </dd>
805                    <dt>
806                    <b>
807                    2. Remove the Deployment atom association to the Data Entity atom
808                    </b>
809                    </dt>
810                    <dd>
811                    <li>
812                    From the <a href="${h.url_for('atomHome')}">atom home page</a>, click on the <a href="${h.url_for('list')}">Edit/List atoms</a> link and search for and open the Data Entity atom created previously.
813                    </li>
814                    <li>
815                    Click the 'Edit' link of the 'Associated Deployments' section, then select the Deployment atom and click 'Remove'.
816                    </li>
817                    <li>
818                    The editor updates the Data Entity - notice that it no longer has any 'Associated Deployments'.
819                    </li>
820                    <li>
821                    Return to the search page and find one of the Deployment Data atoms created previously.
822                    </li>
823                    <li>
824                    When this loads, notice it no longer has any 'Associated Data Entities' information.
825                    </li>
826                    </dd>
827                    <dt>
828                    <b>
829                    3. Remove the Data Granule atom association to the Data Entity atom
830                    </b>
831                    </dt>
832                    <dd>
833                    <li>
834                    Repeat the previous section, but this time remove the atom in the 'Associated Data Granules' section.
835                    </li>
836                    <li>
837                    Check the Data Granule is no longer featured in the Data Entity - and that it no longer references
838                    the Data Entity.
839                    </li>
840                    <li>
841                    Add the Data Granule to the Data Entity again.
842                    </li>
843                    <li>
844                    Now, search for the Data Granule and open in the editor.
845                    </li>
846                    <li>
847                    Click the 'Delete' button at the top of the document and confirm the deletion.  A pop up
848                    box should confirm that the deletion has completed successfully.  Control returns to the
849                    atom home page.
850                    </li>
851                    <li>
852                    Click on <a href="${h.url_for('list')}">Edit/List atoms</a> and search for the deleted Data Granule - it should no longer be found.
853                    Instead return to the Data Entity created previously.
854                    </li>
855                    <li>
856                    Observe the Data Entity no longer holds any data in its 'Associated Data Granules' section;
857                    the Data Granule has been deleted and references to it have been removed.
858                    </li>
859                    </dd>
860                    </dl>
861                    </p>
862                    </div>
863                </div>
864        </div>
865  </body>
866</html>
Note: See TracBrowser for help on using the repository browser.