User Guide

(these are currently in process...)

Definitions and Permissions

Arguments - How to edit arguments, including how to add hyperlinks to records and other arguments

Getting started

1. visit the URT user site:
    http://urt.parsons.edu/urt
2. Browse around the map and any pre-existing records and projects
3. Login by clicking "Login"
4. This brings you to a kind of "user homepage" or "dashboard" type thing, which shows any projects you belong to and your "role" on each, also any records you have already created.

Creating a Subproject

1. From the user homepage screen, click on one of your assigned projects.
2. Click "Create a new subproject".
3. Enter a title and description. You can also add any tags you would like to describe the project. Tags should be separated by spaces and can have any characters except spaces (ie, feel free to use underscores to separate words in a tag, like "urban_media_archaeology"). Tags will provide search and filter functionality soon.
4. Select yourself and specify your role (this step is awkward and will be eliminated soon). But also, If this is a collaboration, select any other users and specify their roles.
5. Select any record types you would like to be part of this project. If you need to create new record types, you can do that after saving your project. That process is described below.
6. Click "submit".
7. You should now be seeing the project overview page for this new project.

Creating a new Record Type

For now, unfortunately, this feature is still only possible from within the admin site. We are working on re-implementing this in the user site with a more streamlined and intuitively designed workflow.

1. Visit the admin site:
    http://urt.parsons.edu/urt/admin
   (The first time you do this you might want to change your password by clicking "Change password" in the upper-right corner. After which, click "Home" to go back.)
2. Click "Record Types". This will show you all previously-defined record types. You can click around to see how other record types have been defined. And you can edit any previously defined types. But please don't change any that others have created! (This will be protected by permissions when this is in the user area.)
3. Click "Add record type" (upper-right corner)
4. Enter a name and description. A nice description would probably describe what this record type will be used to represent semantically, ie, beyond just the fields. For ex "Will store traffic signs in an urban environment with safety data related to each." Some may be fairly specific ("A video arcade including location and usage stats") but some may be fairly general ("A sound recording at some place and time").
5. You can also select an icon for how this will be represented on the map.
6. Now specify what fields. Click "Add another" to add more. Each field will have a name, a "type", an order (determining the order in which the fields are displayed) and a flag for whether or not this field is required. Current available types are:
   • text -- an open text field
   • numerical -- an open numeric field
   • citation (sadly this is not quite working yet, but this will provide an open standards compliant bibliographic citation)
   • geography point -- a single point on the map
   • geography path -- a route or group of lines on the map
   • geography area -- an area or region on the map
   • image -- an image file
   • sound -- a sound file. Most general audio formats should work fine (MP3, WAV, etc)
   • video -- a video file. Unfortunately we currently only support .flv files. If you want to upload another format you must first convert it to .flv. This will change soon to be more accommodating.
7. When you have fully specified your record type click save.
8. Now you can go back to  the user site, click "Projects" (in the navigation bar), select your project, click "Edit", and add your new record type to your project. Click "Submit" to save.

Creating a Record

1. From the URT user site:
    http://urt.parsons.edu/urt
2. From the "Projects" drop-down, select your project. (Or, click your name to go to your "dashboard" and select your project there.)
3. You should see a list of members and a list of "Allowed Record Types".
4. To start adding records to this project, click "Start working on this project"
5. You should now see "create" links next to each allowed record type.
6. Click one.
7. You should now be able to fill out all fields as described by this record type, including file uploads and specifying map locations (Warning: the map interface is a little frustrating still!)
8. You can also add tags to a record (again, these will provide search and filter functionality soon).
9. Click create when you are done.
10. You should now see your new record in the "Records" list on your project overview page. You can also click to the homepage (click the logo up top) and if your record has a map point, see it on the map.