User Instructions 

(Last updated on 04/06/2004)

You can use On-Server archivelet to create and maintain a virtual archivelet for yourself on the group server. After creating your archivelet, you will be able to use just a web browser to publish and edit your metadata and to upload your fulltext documents.

All the metadata and the fulltext documents are stored on the server and are available for OAI harversters to come and harvest your collection. The archivelet also has a persistent URL for harvesting which you can give to any OAI-compliant harvester to harvest your archivelet.

This On-Server Archivelet solution is best if you have your computer behinde firewalls and/or NAT proxies. You do not need any special configuration for these devices as long as you have connection to the Internet.

This help file contains two sections:

  • Getting start with on-server archivelet -- guides on how to set up and work with on-server archivelet.

  • Glossary -- explanation on some of the terms used in on- server archivelet.

Getting start with on-server archivelet.

1. Set up on-server archivelet account.

In order to work with on-server archivelet, you need to create an account on the group server. Next time you want to use the on-server archivlet, you can just log into the existing account.

To create a on-server archivlet account, click the 'Create archivelet' link on the on-server archivelet home page. and you will see a "create archivelt" form. Fill in the form with required information then click 'Create Archivlet' button. If the filled form is accepted, you will see a message 'you are registed with the group server:   Now click the 'Go to my account'  button and your account page will be displayed.

The following buttons will be found on your account page:

List -- Once clicked will list all the items you've published.

Publish -- Publish an item. ( Refer to ' 3. Publish an item ' for detailed usage)

Export -- Not supported in this version.

Import -- Not supported in this version.

Setting -- Configure archivelet. (Refer to '2. configure on-server archivelet 'for detailed usage)

Help -- Links to this help file.


2. Configure  on-server archiveletelet

Once you create an account on the group server(or login in to your account) you can configure your archivelet by clicking 'setting' button in you account.

The setting page will display.

you can make the following configurations:

  • If you want to notify the group of any new documents or  changes of existing documents, click the "Notify group now" button on the setting page. You can also choose to send notifications automatically after every update. To do so, just check the "Notify group on every update" checkbox on the settings screen and click 'ok ' button. 

  • Edit your user profile then click 'ok' button.


3. Publish an item 

Click "Publish" button in your account , you will be prompted to select a metadata format to continue. Currently, we support two types of format:  olac and oai_dc. Once you select a format and click 'continue' button, a popup dialog will appear. In this dialog, you can:

  • input for "identifier", "title", "date", "language", "description".

  • click the "browse" button to choose the file that you want to share. The format field will be automaticly filled with the extension of the file you've chosen.

  • click "Edit" button to add or remove "creator" or "subject".

  • click "More" button to edit "publisher", "contributor", "type", "source", "relation", "coverage".

In this dialog, any field marked with a star (*) is  mandatory. The ' ? ' mark button adjacent to the field, once clicked, will pop up a message box displaying the regular expression you should follow to input to the corresponding field. The regular expression might not be set if there is no sepcific pattern requirement for a field.  

after you input all the necessary metadata info, click 'submit' button.  If the information is accepted, you will see 'Metadata addded succcessfully.  Do you want to add more metadata?' click 'yes' if you want to publish more data or 'no' to return to your account.

4. List/Edit/Remove/View published item

After your publishing,  you can click 'List' button to list all the item published.

Once you see the listed items you can also:

  • Edit an item -- Select an item from the list and click "Edit" button, and a popup dialog will appear. The process is similar to "how to add an item". 

  • View the shared file -- Select the item from the list, click the link in title field, a popup dialog will appear, you will view what you have shared by clicking the link on the popup dialog.

  • Remove an item -- Select the item that you want to remove from the list and then click the "Remove" button.

Glossary

Archivelet ID -- This is the ID of your archivelet. It must be unique in the group.

Service Provider URL (SP URL)-- This is the group server URL which the archivelet registered to.

Persistent URL (PURL) -- Persistent URL is a constant URL assigened by the   group server at the time user register to the group server, it is provided to service provider for harvesting user's collection.