Part 1. Preparing for the exercises1-1. Open a Web broswer (suggesting using Internet Explorer or Firefox, not Safari). Go

to VRA Core site (Google "VRA Core 4 examples" or directly go to: http://www.vraweb.org/projects/vracore4/ ). Find 'Cataloging Examples.

1-2. Select Category of "Paintings". Choose "Landscape Painting", it should be “Autumn – On the Hudson River”. (The direct link is: http://www.vraweb.org/projects/vracore4/example026.html)

On the top right corner there is a “XML” button. Click on the xml file and save into your desktop or jump drive. (We will read it from Oxygen later. In other cases, you can always read it using a text editor such as TextEdit (Mac) and Notepad (PC)).

1-3 Google "VRA Core schemas" or directly go to the official VRA Core site http://www.loc.gov/standards/vracore/schemas.html, download (save) two schemas of VRA Core to your own disk. Make sure the file saved with a file extension *.xsd !

Unrestricted Version - specifies the basic structure of the schema http://www.loc.gov/standards/vracore/vra.xsd

Restricted Version - extends the unrestricted schema by adding controlled type lists and date formatshttp://www.loc.gov/standards/vracore/vra-strict.xsd

Instruction Using Oxygen XML Editor

software are on SLIS Computer Lab's computers

1

To get a 30 day free-trail version for your computer, go to http://www.oxygenxml.com/register.html

Part 2. Reading a VRA XML record

2-1. Starting the software

• Start All Programs Oxygen XML Editor Oxygen XML Editor

• It will take a while for the software to start!

• Close the “Did You Know?” box.

• The first screen is blank.

2

element attribute value

1

2

3 4

2-2. Element

1. Choose FILE OPEN to open up the XML record example you downloaded. Now you can see the XML record in the center part of the screen. 2. Click on the hierarchy icon to view elements displayed hierarchically.

3. Outline view of the record:

wrapper element subelements

4. Elements available for this set

? What sub-elements are available for <agent>? (Click on <agent> tag, see in box ).5 3

element attribute value

element attribute value

1 1. Attributes available for an element

? What attributes are available for <agent >?

? What attributes have been used for the name of this agent? And for the dates?

2-3 Attributes

1. When clicking on an element, the attributes that are available for it will show on the upper right box.

4

(cont.) 2-3 Attributes: Another way to find out attributes: 1. Inside a tag, type a space, then a list of attributes will open. 2. Clicking on an attribute, you may see the explanations of the attribute.

1

2

? What attributes are available for <name >?

5

element attribute value

Part 3. Editing an XML record3-1 Add a new element <agent> and its sub-elements 1. Type "<agent>" after the last set of agent, right below the closing tag"</agent>". 2. Start a new line below <agent> tag in order to add subelements. (Hit a return key between

<agent></agent> pair .)3. Add sub-elements under <agent> by typing "<name>"; or double click on the “name”

subelement from the lower-right box to get it onto the record.4. Add two other subelements: ‘dates’, and ‘role’ in the record. 5. (Not required: For <dates>, it also two sub-subelements. You can insert them in the

<dates></dates> set.)

1 23 4

6

3-5 Attribute valuesNow try your own name.1.Inside the <name> tag, before ">", type a space after ‘name’ to get the list of the attribute. 2.Choose ‘type’ attribute. its allowable values will show on the screen like a pop-up list. (When there is already a list of restricted values, the values will show on the screen like a pop-up list. If no pre-defined values, there will be no list.)3. For #2, this can also be done by clicking on the attribute name on the upper- right box of the screen.

2

1

3

? What ‘type’ values are listed for <name >?

? What ‘type’ values are listed for <dates? 7

3-3 Values – use controlled vocabularies• Add a person’s name, dates, role.

– Follow the example provided by the record. Add a person’s name, dates, role. (For practice, make any name and dates you like.)

– For 'role', go to AAT to find the term ‘painter’ and see if the reference id is the same:

• Google ‘AAT” Art and Architecture Thesaurus. At AAT site, search “painter” (with quotation marks) Find “painters (artists)”, open the record to see the concept ID and all other information.

– For a person's refid, back to AAT and switch to ULAN -> Union List of Artist Names search Jasper Francis Cropsey view record and find out the ID.

11

11

22

22

8• Save the revised record with another name.

Part 4. Doing your own project

4-1 Create a 'project' file1. Click on Project on the tool bar for a New project. It is like to create a folder

for your project. Your xsd, xml, and other files for the same project can be stored under this project.

2. Right-mouse click on "newProject.xpr" Add Files;Add the vra-4.0-restricted.xsd file you downloaded from VRA site.

1

2

3. File Save all Give a name to the project and save into a place you want. 9

4-2 Start a new VRA record' xml file.1. To create a new file, click on File New 2. A list is offered of different file types. The default is XML, so click on OK.

1

2

10

A new window will pop-up.

1. At the URL you can point to the VRA Core 4.0 'restricted' schema xsd file.

2. The namespace will automatically be filled.Leave the prefix empty for now.

3. It is very important to choose a Root Element correctly. In VRA

Core 4.0, it is 'vra'. (In CDWA Lite, the Root Element is 'cdwalite'.) These could be the prefix as well. But for this assignment, we will not be using a prefix now.

4. It is also very important to check the box 'Add Optional content' so all elements (not just the required ones) will show up.

1

2

3

4

11

4-3 Work on the XML template1. Save your file for use in the future.2. From the left-lower box, you will see collection, work, or image. Click the type that you will NOT need to use (e.g., collection and image here) and DELETE them so that only the elements for work will stay in the central workspace.

The elements at each level can be seen from the Outline pane at the left lower box. (Note for this version of software, when you just keep WORK type, the XML record will include both a work and an image. You can either put your two records here together, or separate them.)

2 12

3. Save the file after you did editing.

4. Add this file into your ‘project’ space if your file is in a different place.

• Click on project’s file right-mouse-click Add Files

5. Submit your xml file on Blackboard.

6. Print: If you like to keep a copy, you may directly print the record from SLIS 310A printer. Or, open the file from your text editor and print.

4

(cont.) 3-3 Work on the XML template

13

1

2

3

[Additional notes] Part 5. Using Tree-editor --- a Non-XML way to edit a record Tools Tree EditorOption A: 1. Click on the tag (e.g., agentSet) that you want to add sub-ordinate element, (e.g., agent) 2. Choose ‘Insert Element’ from the icon or menu to get the available elements or sub-elements.Option B: 3. Obtain an element tag from the lower-right box, give the position (after, first, last), double click. 4. =2. Choose ‘Insert Element’ from the icon or menu

2

14

If you are not confortable with XML, you can try these.

5

5. Click on an element (e.g., name), choose ‘Insert attribute’ from the icon or menu.

6. Select the attribute you need (e.g., type) and click to insert it under the element agent.

7. Choose ‘Start Editing’ icon in order to add an attribute.

8. The attribute will be filled in by you. Find the available attributes on the upper-right box.

5

6

5

7

8

15

9. In order to type a real personal name into the record, click on the element tag (e.g., name).

10. Click on the TT icon to obtain a text box.

11. Now you can type the text into the box.

9

10

11

16

[Additional Notes] Part 6. Grid view of the record1. Switch to ‘Grid view’. 2. Click the sign to open up the description

1

2

You can also use this interface to edit. For example, right-mouse-click on an element to insert before or after an element, or to append sub-elements, attributes, etc. You will need to have a clear idea what you want to add and what attributes values are available. 17