Difference between revisions of "Getting Started"

From Metadata-Registry
Jump to: navigation, search
(Step 2. Register an Agent)
(Training Screencasts)
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The Open Metadata Registry provides services for discovery, use, and administration of metadata vocabularies and element sets.
+
The Open Metadata Registry provides services for discovery, use, and administration of metadata vocabularies and schemas. It supplies tools for both maintainers and users of vocabularies. This document is intended as a starting place for maintainers and representatives of owning organizations. For users, the registry supplies an interface for searching available metadata terms and allows tracking changes to used vocabularies through RSS & Atom feeds.
 
+
...
+
 
+
For vocabulary maintainers, the registry provides a stable hosting service and a range of management tools.
+
 
+
...
+
  
 
==Training Screencasts==
 
==Training Screencasts==
Line 14: Line 8:
 
* Using the Registry: Step-by-Step
 
* Using the Registry: Step-by-Step
 
** [http://www.screencast.com/users/DianeHillmann/folders/Camtasia/media/0a8af9ca-3f9a-4065-bb22-e157e8d86026 User Management Structure and Instruction]
 
** [http://www.screencast.com/users/DianeHillmann/folders/Camtasia/media/0a8af9ca-3f9a-4065-bb22-e157e8d86026 User Management Structure and Instruction]
** Building Element/Property sets [In development]
+
** [http://achelo.us/videos/element-sets.ogv Building Element/Property Sets]
** Building Value Vocabularies [In development]
+
** [http://achelo.us/videos/creating-vocabs.ogv Building Value Vocabularies]
 
* Managing Registered Vocabularies Over Time [In development]
 
* Managing Registered Vocabularies Over Time [In development]
  
Line 37: Line 31:
 
* '''Sensible vocabulary development tools will support institutions using the Semantic Web.''' While many institutions are still using vocabularies in traditional ways, many are excited by the possibilities of the Semantic Web and open linked data to improve their results and make their work (whether product, description or idea) more broadly available for use and reuse by new communities of practice. The Registry enables vocabulary development to be undertaken with these Semantic Web opportunities in mind--it is based on standards and good practices developed by the World Wide Web Consortium (W3C), increasingly seen as the underpinnings that will drive the new information world for libraries, commerce and users of all varieties working on the Web.
 
* '''Sensible vocabulary development tools will support institutions using the Semantic Web.''' While many institutions are still using vocabularies in traditional ways, many are excited by the possibilities of the Semantic Web and open linked data to improve their results and make their work (whether product, description or idea) more broadly available for use and reuse by new communities of practice. The Registry enables vocabulary development to be undertaken with these Semantic Web opportunities in mind--it is based on standards and good practices developed by the World Wide Web Consortium (W3C), increasingly seen as the underpinnings that will drive the new information world for libraries, commerce and users of all varieties working on the Web.
  
To start playing in the sandbox, it's enough to be aware of these assumptions. As you plan to use the registry software to maintain schemas & vocabularies either as an individual or in a larger organizational context, you will want to read the following for policy guidance:
+
To start playing in the sandbox, it's enough to be aware of these assumptions. As you plan to use the registry software to maintain schemas & vocabularies either as an individual or in a larger organizational context, you may find the following helpful for policy guidance:
  
 
* [[Planning an Implementation]]
 
* [[Planning an Implementation]]
Line 52: Line 46:
 
Anyone who will work on vocabulary development should register as a user. If you will be maintaining vocabularies as a part of a larger organization, you should create or join the Agent representing that organization. Otherwise, you can simply register an individual resource owner.  Please note that the production Registry and the Sandbox require separate registration.
 
Anyone who will work on vocabulary development should register as a user. If you will be maintaining vocabularies as a part of a larger organization, you should create or join the Agent representing that organization. Otherwise, you can simply register an individual resource owner.  Please note that the production Registry and the Sandbox require separate registration.
  
You do not need to register as a user to access metadata resources hosted on the registry.
+
You do not need to register as a user to search and access metadata resources hosted by the registry.
  
====Step-by-Step====
+
==What's Next?==
  
=====Step 1: Register an Individual=====
+
The [[Open_Metadata_Registry_Step-By-Step_Instruction|Step-by-Step Instructions]] provide a walkthrough of the process of registering users, agents, and metadata terms. This is a good introduction to the registry's capabilities and the perfect place to start if you want to learn how to work with the software.
 
+
On the upper right hand corner of every Registry page is a tab, which, for a user not signed in says:
+
* sign in/register | about
+
When clicked on '''sign in/register''', the following page appears:
+
 
+
[[Image:UserRegStep1sm.jpg|700px]]
+
 
+
A new user must register by clicking the box that says ''click here to create a new account'' which allows the user to fill in four boxes, all mandatory:
+
* a login name
+
* a password
+
* a password confirmation
+
* an email address
+
 
+
The email address is used only for password retrieval, when a user forgets his or her password, is used for no other purpose, nor shared with any other service or individual.
+
 
+
 
+
[[Image:UserRegStep2sm.jpg|700px]]
+
 
+
Results: A new user account is created.  The user should note the login name and password, as well as the email address entered at the time of new account registration.
+
 
+
=====Step 2. Register an Agent=====
+
Now that you are logged in, you can add a resource owner. Every schema or vocabulary must be owned by a resource owning agent, which can be registered as either an individual or an organization.
+
 
+
To register an agent, click on the '''(Add)''' link next to '''Resource Owners''' in the '''Browse''' box on the right side of the page and fill out the resulting form. '''Owner Name''' and '''Email''' are required fields. As with user registration, email addresses are kept private. When you register an agent, you become the registrar of that agent and an '''Agent Administrator''' for that organization or individual. Other users and administrators can be added later.
+
 
+
[[Image:agent-registration.png|Agent Registration Page|700px]]
+
 
+
 
+
'''DEFINITIONS:'''
+
----
+
 
+
An '''Agent Administrator''' is defined as: "One or more persons authorized to maintain one or more Agent records." This Agent Administrator is automatically the Vocabulary Administrator and Maintainer for all element sets or vocabularies owned by that Agent, and authorized to:
+
* Edit/Delete Agent Records (an Agent can only be deleted by an Admin if there are no associated Vocabularies) 
+
* Designate other registered users as:
+
** Agent Administrators for that Agent
+
** Agent Contacts for that Agent (can receive notifications but has no explicit role in vocabulary development)
+
** Vocabulary Administrator for individual Vocabularies owned by that Agent
+
** Vocabulary Maintainers for individual Vocabularies owned by that Agent
+
 
+
A '''Vocabulary Administrator''' is defined as: "One or more persons responsible for editorial functions related to one or more submitted vocabularies. The user who registers a Vocabulary becomes the Administrator for that Vocabulary."
+
The Vocabulary Administrator is authorized to:
+
* Act as Vocabulary Maintainer
+
* Designate other registered users as Vocabulary Maintainers
+
 
+
A '''Vocabulary Maintainer''' is defined as: "A registered user designated as responsible for maintaining a Vocabulary."
+
The Vocabulary Maintainer is authorized to edit vocabulary properties and concepts.
+
 
+
----
+
 
+
==What's Next?==
+
  
 
Add other users in other roles
 
  
 
[[Category:Documentation]]
 
[[Category:Documentation]]

Latest revision as of 23:35, 10 October 2010

The Open Metadata Registry provides services for discovery, use, and administration of metadata vocabularies and schemas. It supplies tools for both maintainers and users of vocabularies. This document is intended as a starting place for maintainers and representatives of owning organizations. For users, the registry supplies an interface for searching available metadata terms and allows tracking changes to used vocabularies through RSS & Atom feeds.

Training Screencasts

The Sandbox

The registry sandbox is a non-production implementation of the registry software and can be used for testing the registry's features. Everything there works the same as in the live registry, except for the URIs (this avoids the temptation to use the sandbox as a substitute for the production-level registry). We advise playing around a bit in the sandbox before trying anything on the real thing.

Use Cases

For information about common use cases, see: <ask format="ul"></ask>

Making Policy Decisions Prior to Implementation

  • Metadata increasingly lives in an open world. Most older vocabulary development tools are designed to provide assistance in developing vocabularies in commercial environments or where development processes are assumed to reside 'in house.' They are usually applications designed to run behind a firewall for a good-sized organization or on a personal computer. In most cases they can provide output that can be used to develop web pages, but they assume that the organization is not interested in exposing the process itself outside the institution. The Registry is designed to be used in an open web environment--it can be used behind firewalls, but this requires more effort for the institution to manage.
  • Group based vocabulary development and maintenance is the best approach. Most vocabularies are designed for some combination of use by internal and external parties for specific purposes: to enhance discoverability, to deal with the ambiguities of language, or to sell products. Given this reality, most groups find that the development process needs to take advantage of the wisdom of the entire group in order to meet the goals of the group. The Registry software is designed to recognize that need, and accommodates a variety of group processes and workflows, providing opportunities to build vocabularies that can improve over time and reflect changes in language.
  • Sensible vocabulary development tools will support institutions using the Semantic Web. While many institutions are still using vocabularies in traditional ways, many are excited by the possibilities of the Semantic Web and open linked data to improve their results and make their work (whether product, description or idea) more broadly available for use and reuse by new communities of practice. The Registry enables vocabulary development to be undertaken with these Semantic Web opportunities in mind--it is based on standards and good practices developed by the World Wide Web Consortium (W3C), increasingly seen as the underpinnings that will drive the new information world for libraries, commerce and users of all varieties working on the Web.

To start playing in the sandbox, it's enough to be aware of these assumptions. As you plan to use the registry software to maintain schemas & vocabularies either as an individual or in a larger organizational context, you may find the following helpful for policy guidance:

User Registration

The Registry user management system is based on a simple model. An individual user begins the process by building a simple profile for himself or herself. This first user then registers an institutional or individual agent who will be the vocabulary owner for vocabularies developed subsequently. By registering an institution or individual agent, the user becomes the Agent Administator for that organization/individual.

Registry Standard Workflow.jpg

Who Should Register

Anyone who will work on vocabulary development should register as a user. If you will be maintaining vocabularies as a part of a larger organization, you should create or join the Agent representing that organization. Otherwise, you can simply register an individual resource owner. Please note that the production Registry and the Sandbox require separate registration.

You do not need to register as a user to search and access metadata resources hosted by the registry.

What's Next?

The Step-by-Step Instructions provide a walkthrough of the process of registering users, agents, and metadata terms. This is a good introduction to the registry's capabilities and the perfect place to start if you want to learn how to work with the software.