|
|
| (58 intermediate revisions by 4 users not shown) |
| Line 1: |
Line 1: |
| − | [[Main Page]] > [[User manual]] > [[UM-3 | UM-3 Add / edit content]] > [[UM-3.1|UM3.1 Add / edit archival descriptions]] > UM-3.1.1 Data entry: archival descriptions | + | [[Main Page]] > [[User manual]] > [[Add/edit content]] > [[Add/edit archival institutions]] > Create a new archival institution |
| | | | |
| − | == Data entry: archival descriptions == | + | <div class="clearfix"> |
| | | | |
| − | [[Image:um3-1-1ArchivalDescription.png|500px|right|thumb|Edit screen: all record areas collapsed]]
| + | == From the main menu == |
| | | | |
| − | The [[Glossary#Edit screen|Edit screen]] for archival descriptions is structured into six [[Glossary#Record area|record areas based on [[ISAD(G)]]'s "information areas". Click on a [[Glossary#Record area|record area]] to expand it (display fields); click again to collapse it (hide fields). Note that as of ICA-AtoM version 0.6, whenever you save a record ICA-AtoM re-loads the page, collapsing all areas.
| + | # [[Image:addMenu.png|500px|right|thumb|Add a new archival institution from the main menu]]In the [[Glossary#Main menu|main menu]], hover your cursor over Add and select Archival institutions. ICA-AtoM takes you to a blank [[Glossary#Edit page|edit page]] for data entry |
| | + | # [[Image:createIsdiah.png|500px|right|thumb|Save or cancel the new record]]On loading, the [[Glossary#Edit page|edit page]] displays the record with all [[Glossary#Information area|information areas]] closed; click on an [[Glossary#Information area|information area]] to access the [[Glossary#Field|fields]] grouped under it |
| | + | # You can quit the process at any time by clicking the "cancel" button in the [[Glossary#Button block|button block]]; no new record will be added |
| | + | # Click the [[Glossary#Create button|Create button]] in the [[Glossary#Button block|button block]] to save the new record |
| | | | |
| | + | </div> |
| | | | |
| − | The following notes aim only to clarify ICA-AtoM procedures; for guidelines on what information to record in particular fields, consult [[ISAD(G)]] as the content standard. The notes are organized by field, with links to the applicable [[ISAD(G)]] section(s).
| + | <div class="note"> |
| | | | |
| | + | Introduced in 1.3 Release is the ability for site Administrators to track digital object storage per repository. Storage limits may be placed on individual repositories by in-house server capacity or on hosted server agreements. If you are utilizing a multi-institutional / portal instance of ICA-AtoM you will need to check with the site Administrator to learn the digital object storage limitations. |
| | | | |
| − | <br clear=right>
| + | [[Image:digobjstorage.png|500px|right|thumb| Digital storage indicator is shown on the View archival repository page]] |
| − | == Identity area ==
| |
| | | | |
| − | [[Image:um3-1-1IdentityArea.png|500px|right|thumb|Archival description: Identity area]]
| + | </div> |
| | | | |
| − | The '''Identity area''' contains fields that uniquely identify the archival description.
| + | <div class="clearfix"> |
| | | | |
| | + | == From an archival description edit page == |
| | | | |
| − | 1. '''Reference code''' ([[ISAD(G)#isad3.1.1|ISAD(G) 3.1.1]]):
| + | In the Repository [[Glossary#Field|field]] of an ISAD, RAD or MODS [[Glossary#Archival description|archival description]] or in the Relation (isLocatedAt) [[Glossary#Field|field]] of a Dublin Core [[Glossary#Archival description|archival description]], type in a new [[Glossary#Archival institution|archival institution]] name. A new [[Glossary#Archival institution|archival institution]] will be created when you save the record. |
| − | *Enter the reference code that uniquely identifies the archival unit under description.
| |
| | | | |
| | | | |
| − | 2. '''Title''' ([[ISAD(G)#isad3.1.2 |ISAD(G) 3.1.2]]):
| + | == From an archival institution view page == |
| − | *Enter the authorized title of the unit of description.
| |
| | | | |
| | + | Click the [[Glossary#Add new button|add new button]] in the [[Glossary#Button block|button block]] of an [[Glossary#Archival institution|archival institution]] [[Glossary#View page|view page]]. This will open a blank [[Glossary#Edit page|edit page]] for data entry. |
| | | | |
| − | 3. <span class="field">Alternate title</span> ([[ISAD(G)#isad3.1.2 |ISAD(G) 3.1.2]]):
| + | </div> |
| − | *Enter an alternate title of the unit.
| |
| − | *In the current version of ICA-AtoM (v0.6) you can only register one alternate title; in future iterations, you should be able to register as many alternates as you need.
| |
| | | | |
| − | | + | [[Category:User manual]] |
| − | 4. <span class="field">Title notes</span> ([[ISAD(G)#isad3.1.2 |ISAD(G) 3.1.2]], [[ISAD(G)#isad3.6.1 |ISAD(G) 3.6.1]]):
| |
| − | *Multi-value field displaying notes in a list form.
| |
| − | *Create as many title notes as you need.
| |
| − | *Notes that have already been entered appear with a red <span class="button">DeleteInfoIcon</span> beside them.
| |
| − | *Use the last row (with the green <span class="button">AddInfoIcon</span> beside it) to add a new note.
| |
| − | | |
| − | | |
| − | 5. <span class="field">Note</span> ([[ISAD(G)#isad3.1.2 |ISAD(G) 3.1.2]], [[ISAD(G)#isad3.6.1 |ISAD(G) 3.6.1]]):
| |
| − | *Enter the note.
| |
| − | | |
| − | | |
| − | 6. <span class="field">Note type</span> ([[ISAD(G)#isad3.6.1 |ISAD(G) 3.6.1]]):
| |
| − | *Defaults to "Title note" and cannot be changed: any note you create here will always be a "Title note".
| |
| − | *To create other types of notes, go to the <span class="area">Control</span> record area.
| |
| − | | |
| − | | |
| − | 7. <span class="button">AddInfoIcon</span>:
| |
| − | *Click to register the new title note.
| |
| − | | |
| − | | |
| − | 8. <span class="button">DeleteInfoIcon</span>:
| |
| − | *Click to delete an existing title note.
| |
| − | | |
| − | | |
| − | 9. <span class="field">Level of description</span> ([[ISAD(G)#isad3.1.4 |ISAD(G) 3.1.4]]):
| |
| − | *Select the appropriate level of description from the drop-down list.
| |
| − | *List terms can be customized by <span class="role">Administrators</span> to suit their institution's arrangement system.
| |
| − | | |
| − | | |
| − | 10. <span class="field">Next upper level of description</span>:
| |
| − | *Select the unit immediately above the current one in the hierarchy of arrangement ("parent record").
| |
| − | *Leave blank if the current unit represents the highest level of arrangement (e.g. a fonds).
| |
| − | | |
| − | | |
| − | 11. <span class="field">Extent and medium</span> ([[ISAD(G)#3.1.5 |ISAD(G) 3.1.5]]):
| |
| − | *Enter information relating to the physical size, media, and formats.
| |
| − | *Structure data according to your institution's standards (e.g. separate entries by commas or separate lines).
| |
| − | | |
| − | | |
| − | |width="40%" align="right"|
| |
| − | | |
| − | ''insertScreenshot''
| |
| − | | |
| − | |}
| |
| − | | |
| − | === Context area ===
| |
| − | | |
| − | {| border="0" cellpadding="2"
| |
| − | | |
| − | |- valign="top"
| |
| − | |width="60%" |
| |
| − | | |
| − | The <span class="area">ContextArea</span> contains fields that provide information about the origins and custody of the archival material being described.
| |
| − | | |
| − | | |
| − | 1. <span class="field">Creation context</span>:
| |
| − | *Multi-value field displaying creation events in a list form.
| |
| − | *A <span class="entity">creation event</span> captures dates of creation: an entity creating the archival materials being described over a certain date range.
| |
| − | *Register as many creation events as you need. ISAD(G) recognizes more than one type of date (e.g. dates of document creation vs dates of accumulation, see [[ISAD(G)#isad3.1.3 |ISAD(G) 3.1.3]]). And in some arrangement systems there may be more than one creator (e.g. in a series system, a series may be successively controlled by differen bodies over time).
| |
| − | *The first entry in the list (containing empty text boxes) is for registering a new creation event.
| |
| − | *Any subsequent entries show events already registered.
| |
| − | | |
| − | | |
| − | 2. <span class="field">Creator</span> and <span class="field">Add new name</span>:
| |
| − | *Select the creator's name from the drop-down list in the <span class="field">Creator</span> field.
| |
| − | *ICA-AtoM generates the list from all existing authority records.
| |
| − | *If the creator's name does '''not''' appear in the list, use the <span class="field">Add new name</span> field to enter the creator's name.
| |
| − | *If you select a name from the drop-down list, ICA-AtoM will ignore any text you may have entered in the <span class="field">Add new name</span> field.
| |
| − | *Note that you can leave both of these field blank; in this case, the unit will inherit creator information from its parent record (next highest level of description).
| |
| − | *At the highest level of description, you should always include the creator; the <span class="field">Administrative history / biographical sketch</span> is drawn from the creator's authority record.
| |
| − | *Lower levels inherit creator information from higher levels: use only if creator is different than the creator of the parent record (next upper level of description).
| |
| − | | |
| − | | |
| − | 3. <span class="field">Creation year / End year</span> ([[ISAD(G)#isad3.1.3 |ISAD(G) 3.1.3]]):
| |
| − | *Enter the opening and closing years of the date range.
| |
| − | *ICA-AtoM uses these values for sorting and searching purposes.
| |
| − | *Use only four-digit numbers.
| |
| − | *If the start and end years are the same, enter only in the start year and leave the end year blank.
| |
| − | *Complete at lower levels of description even if you are leaving the <span class="field">Creator name</span> field blank (e.g. when describing a series, you do not need to repeat the <span class="field">Creator name</span> from the fonds description, but you do need to enter the date range of the series).
| |
| − | *Do not use any qualifiers here (e.g. "ca.") or typographical symbols (e.g. "[194?]") to express uncertainty (see step4).
| |
| − | | |
| − | | |
| − | 4. <span class="field">Date display</span> ([[ISAD(G)#isad3.1.3 | ISAD(G) 3.1.3]]):
| |
| − | *Enter the date range as you want it to appear to the viewer.
| |
| − | *Add any additional text to qualify date range (e.g. "ca. 1940-1980" or "[1940]-1980; predominant 1973-1980").
| |
| − | *Whereas <span class="field">Creation year</span> and <span class="field">End year</span> are used internally for database searching and sorting purposes, this field is for display purposes.
| |
| − | | |
| − | | |
| − | | |
| − | 5. <span class="button">AddInfoIcon</span> (green +):
| |
| − | *Click to register the creation event.
| |
| − | *Behind the scenes, ICA-AtoM creates a related record in the <span class="entity">Event</span> table and displays it as the next entry in the list.
| |
| − | *If you selected an existing authority record as the <span class="field">Creator</span> field in step2, ICA-AtoM provides a link to the creator's <span class="entity">authority record</span> (blue text).
| |
| − | *If you entered a new name in the <span class="field">Add new name</span> field, ICA-AtoM creates a new authority record for that entity and provides a link to it (blue text).
| |
| − | | |
| − | | |
| − | 6. <span class="button">DeleteInfoIcon</span> (red X):
| |
| − | *Click to delete an existing creation event.
| |
| − | | |
| − | | |
| − | 7. <span class="field">Administrative / biographical history</span> ([[ISAD(G)#isad3.2.2 |ISAD(G) 3.2.2]]):
| |
| − | *Text block displaying data from the creator's <span class="entity">authority record</span>.
| |
| − | *If you have registered more than 1 creator in the creator events (see steps 1-5), the administrative histories / biographical sketches of each will appear here sequentially, separately by a line (horizontal rule).
| |
| − | *Because the data actually resides in another record in another table, it cannot be directly edited here; to edit, click the <span class="button">EditInfoIcon</span> (see step8 below).
| |
| − | | |
| − | | |
| − | 8. <span class="button">EditInfoIcon</span> (pencil):
| |
| − | *Click to edit the <span class="field">Administrative / biographical history</span> field; ICA-AtoM routes you to the related authority record.
| |
| − | *Make changes and save; ICA-AtoM returns you to the <span class="screen">Edit archival description</span> screen.
| |
| − | *Note that upon return all <span class="area">RecordAreas</span> are collapsed.
| |
| − | | |
| − | | |
| − | 9. <span class="field">Archival history</span> ([[ISAD(G)#isad3.2.3 |ISAD(G) 3.2.3]]):
| |
| − | *Enter information relating to the history of custody over the material being described.
| |
| − | | |
| − | | |
| − | 10. <span class="field">Repository</span>:
| |
| − | *Select from the drop-down list the institution that holds the archival material under description.
| |
| − | *ICA-AtoM generates the list from existing <span class="entity">archival institution</span> records.
| |
| − | *Typically you need only enter this information at the highest level of description (e.g. the fonds or collection; series in a series system); it can be left blank at the lower levels if they are all stored in the same repository.
| |
| − | | |
| − | | |
| − | 11. <span class="field">Immediate source of acquisition</span> ([[ISAD(G)#isad3.2.4 |ISAD(G) 3.2.4]]):
| |
| − | *Enter information relating to the circumstances leading to the acquisition of the material by the archival institution.
| |
| − | | |
| − | | |
| − | |width="40%" align="right"|
| |
| − | | |
| − | [[Image:Add ArchivalContext.png|400px|right]]
| |
| − | | |
| − | [[Image:Add ArchivalContext2.png|500px|right]]
| |
| − | | |
| − | |}
| |
| − | | |
| − | === Content and structure area ===
| |
| − | | |
| − | {| border="0" cellpadding="2"
| |
| − | | |
| − | |- valign="top"
| |
| − | |width="60%" |
| |
| − | | |
| − | The <span class="area">ContentAndStructureArea</span> contains fields that provide information relating to the content and arrangement of the materials under description. These are all basic text fields. For practical purposes there are no limits on field length (fields can hold up 16 million characters); scroll arrows will appear if needed.
| |
| − | | |
| − | | |
| − | 1. <span class="field">Scope and content</span> ([[ISAD(G)#isad3.3.1 |ISAD(G) 3.3.1]]):
| |
| − | *Enter information relating to scope and content as per ISAD(G) rule.
| |
| − | | |
| − | | |
| − | 2. <span class="field">Appraisal, destruction and scheduling information</span> ([[ISAD(G)#isad3.3.2 |ISAD(G) 3.3.2]]):
| |
| − | *Enter information relating to appraisal, destruction and scheduling as per ISAD(G) rule.
| |
| − | | |
| − | | |
| − | 3. <span class="field">Accruals</span> ([[ISAD(G)#isad3.3.3 |ISAD(G) 3.3.3]]):
| |
| − | *Enter information relating to future accruals as per ISAD(G) rule.
| |
| − | | |
| − | | |
| − | 4. <span class="field">System of arrangement</span> ([[ISAD(G)#isad3.3.4 |ISAD(G) 3.3.4]]):
| |
| − | *Enter information relating to the system of arrangement as per ISAD(G) rule.
| |
| − | | |
| − | | |
| − | |width="40%" align="right"|
| |
| − | | |
| − | [[Image:ArchivalContent.png|500px|right]]
| |
| − | | |
| − | |}
| |
| − | | |
| − | === Conditions of access and use area ===
| |
| − | | |
| − | {| border="0" cellpadding="2"
| |
| − | | |
| − | |- valign="top"
| |
| − | |width="60%" |
| |
| − | | |
| − | The <span class="area">ConditionsOfAccessAndUseArea</span> contains fields that provide information about the availability of the material being described. Most of the fields in this area are basic text fields; the exceptions are <span class="field">Languages</span> and <span class="field">Scripts</span> (see steps 3 below).
| |
| − | | |
| − | | |
| − | 1. <span class="field">Conditions governing access</span> ([[ISAD(G)#isad3.4.1 |ISAD(G) 3.4.1]]):
| |
| − | *Enter information relating to conditions governing access as per ISAD(G) rule.
| |
| − | | |
| − | | |
| − | 2. <span class="field">Conditions governing reproduction</span> ([[ISAD(G)#isad3.4.2 |ISAD(G) 3.4.2]]):
| |
| − | *Enter information relating to conditions governing reproduction as per ISAD(G) rule.
| |
| − | | |
| − | | |
| − | 3. <span class="field">Language</span> ([[ISAD(G)#isad3.4.3 |ISAD(G) 3.4.3]]):
| |
| − | *Multi-value fields displaying in list form the language(s) and script(s) employed in the archival material under description.
| |
| − | *Select the language / script from the drop-down list.
| |
| − | *Click the <span class="button">Save</span> button.
| |
| − | *ICA-AtoM saves the records, collapsing the <span class="area">ConditionsOfAccessAndUseArea</span>; click to re-open.
| |
| − | *The selected language / script now appears in the list above the data entry field.
| |
| − | *Repeat for other languages / scripts if required.
| |
| − | *To delete a language / script from the list, click the red <span class="button">DeleteInfoIcon</span> beside it.
| |
| − | *Note that future releases of ICA-AtoM will normalize these fields to the standard behaviour of multi-value fields in the system (i.e. present to the user an <span class="button">AddInfoIcon</span> button for registering an entry rather than having to save the record).
| |
| − | | |
| − | | |
| − | 4. <span class="field">Physical characteristics</span> ([[ISAD(G)#isad3.4.3 |ISAD(G) 3.4.3]]):
| |
| − | *Enter information relating to physical characteristics that affect access to the material or technical requirements needed to access it as per ISAD(G) rule.
| |
| − | | |
| − | | |
| − | 5. <span class="field">Finding aids</span> ([[ISAD(G)#isad3.4.5 |ISAD(G) 3.4.5]]):
| |
| − | *Enter information relating to the existence of other finding aids to the material as per ISAD(G) rule.
| |
| − | | |
| − | | |
| − | 6. <span class="field">Location of originals</span> ([[ISAD(G)#isad3.5.1 |ISAD(G) 3.5.1]]):
| |
| − | *Enter information relating to the location of the originals of the materials described (if they are copies) as per ISAD(G) rule.
| |
| − | *Note that in future releases of ICA-AtoM, this field should be moved to a new record area (<span class="area">AlliedMaterials</span> to better reflect the ISAD(G) standard.
| |
| − | | |
| − | | |
| − | 7. <span class="field">Location of copies</span> ([[ISAD(G)#isad3.5.2 |ISAD(G) 3.5.2]]):
| |
| − | *Enter information relating to the location of copies of the materials described *In as per ISAD(G) rule.
| |
| − | *Note that in future releases of ICA-AtoM, this field should be moved to a new record area (<span class="area">AlliedMaterials</span> to better reflect the ISAD(G) standard.
| |
| − | | |
| − | | |
| − | 8. <span class="field">Related units of description</span> ([[ISAD(G)#isad3.5.3 |ISAD(G) 3.5.3]]):
| |
| − | *Enter information relating to related units of description as per ISAD(G) rule.
| |
| − | *Note that in future releases of ICA-AtoM, this field should be moved to a new record area (<span class="area">AlliedMaterials</span> to better reflect the ISAD(G) standard.
| |
| − | | |
| − | | |
| − | |width="40%" align="right"|
| |
| − | | |
| − | [[Image:Add ArchivalAccess.png|400px|right]]
| |
| − | | |
| − | |}
| |
| − | | |
| − | === Access points ===
| |
| − | {| border="0" cellpadding="2"
| |
| − | | |
| − | |- valign="top"
| |
| − | |width="60%" |
| |
| − | | |
| − | The <span class="area">AccessPoints</span> area links archival descriptions to terms drawn from controlled vocabularies as a means of facilitating acess and retrieval. As of version 0.5, ICA-AtoM can create <span class="field">Subject</span> access points; future releases should include <span class="field">Place</span> and <span class="field">Name</span> access points.
| |
| − | | |
| − | | |
| − | Access points are multi-value fields displaying terms in a list form. To create a new access point:
| |
| − | | |
| − | | |
| − | 1. Select a term from the drop-down list.
| |
| − | | |
| − | | |
| − | 2. Click the <span class="button">Save</span> button.
| |
| − | | |
| − | | |
| − | 3. ICA-AtoM saves the record, collapsing the <span class="area">AccessPoints</span> area; click to re-open; the selected term now appears in the list above the data entry field.
| |
| − | | |
| − | | |
| − | 4. Repeat for other terms as required.
| |
| − | | |
| − | | |
| − | 5. To delete an access point from the list, click the red <span class="button">DeleteInfoIcon</span> beside it.
| |
| − | | |
| − | | |
| − | Note that future releases of ICA-AtoM will normalize these fields to the standard behaviour of multi-value fields in the system (i.e. present to the user an <span class="button">AddInfoIcon button</span> for registering an entry rather than having to save the record).
| |
| − | | |
| − | | |
| − | |width="40%" align="right"|
| |
| − | | |
| − | [[Image:AddArchivalAccessPoints1.png|500px|right]]
| |
| − | | |
| − | [[Image:AddArchivalAccessPoints2.png|500px|right]]
| |
| − | | |
| − | |}
| |
| − | | |
| − | === Description control area ===
| |
| − | | |
| − | {| border="0" cellpadding="2"
| |
| − | | |
| − | |- valign="top"
| |
| − | |width="60%" |
| |
| − | | |
| − | The <span class="area">DescriptionControlArea</span> contains fields that provide information about the creation and maintenance of the description record.
| |
| − | | |
| − | | |
| − | 1. <span class="field">Notes</span>: [[ISAD(G)#Notes area | ISAD(G) 3.6]]
| |
| − | *Multi-value field displaying notes as a list; there is no limit to the number of notes you can add.
| |
| − | *Enter the note, select the type and click the green <span class="button">AddInfoIcon</span> to register.
| |
| − | *To delete an existing note, click the red <span class="button">DeleteInfoIcon</span> beside it.
| |
| − | *See above [[#Multi-value fields | Multi-value fields]] for more information on the behaviour of multi-value fields.
| |
| − | | |
| − | | |
| − | 2. <span class="field">Rules or conventions</span>: [[ISAD(G)#Rules or conventions | ISAD(G) 3.7.2]]
| |
| − | *Free text field.
| |
| − | | |
| − | | |
| − | 3. <span class="field">Dates of description</span>: [[ISAD(G)#Date(s) of descriptions | ISAD(G) 3.7.3]]
| |
| − | *Not yet available (as of ICA-AtoM 0.4).
| |
| − | *[Multi-value field, registering the dates the description was originally created and subsequently revised.]
| |
| − | | |
| − | | |
| − | |width="40%" align="right"|
| |
| − | | |
| − | [[Image:Add ArchivalControl.png|400px|right]]
| |
| − | | |
| − | |}
| |
