Tutorial 3: Difference between revisions

From DAAP
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
=Tutorial 3=
=Tutorial 3=


==Edit Item page==
==Create a new Item==
https://daap.bannerrepeater.org/w/images/9/95/Tutorial3_img1.png
You can use the '''Create a new Item''' form to add new '''items''' to the database whether the item is a thing such as a specific artwork or object, a person, an institution, or a place in the world. Items can also be less specific "things" such as "paper", "offset printing", "softcover binding", etc. Item records can be very complex, with lots of information attached to them, as is the case for artworks, or very simple with only one or two pieces of information attached, such as the record for "softcover binding" for example.  
 
This is what a new item looks like after it has been created and added to the archive. You can always edit or add to the information that was entered when creating the item, such as the description, alias and even the label. To do this you simply click on the “edit” button at the top right side corner of the page. When you are happy with the changes you’ve made, press “save”. 
 
'''Add statement:'''
To start adding information to describe different aspects of the item you will add “statements”. This will be familiar to you if you have used [https://www.wikidata.org/wiki/Wikidata:Main_Page Wikidata] before.
 
Before we add anything let us just explain what we mean by statements. Each statement consists of a property and a value, and is used to add descriptive information, in other words metadata, about an item. Properties are the links that connect different pieces of information together, such as a work and its title.
 
Each statement can have a variety of different properties depending on the item it relates to. Each property can also have a variety of different values such as other items, text, dates, or URLs, depending on the type of the property.
 
The full list of properties, alongside examples and short descriptions of the role of each property, can be found in the section Data model reference on the [https://daap.bannerrepeater.org/wiki/Main_Page home page] of the database backend or by using [https://docs.google.com/spreadsheets/d/1PtX5g-T6T8d7GSq7uYNNhPPrbHU91U-GV4aF2W18occ/edit#gid=123424532 this link].
 
https://daap.bannerrepeater.org/w/images/6/6d/Tutorial3_img2.png
 
===Step 1===
===Step 1===
Now, to add statements to your Item page go to the page you have already created.  
To add a new item to the database please go to the '''Create a new Item''' page using [https://daap.bannerrepeater.org/wiki/Special:NewItem this link].
You can always find this function in the sidebar to the left on your screen, or by using the '''Create new item''' button under the heading Adding new data in the archive on the [https://daap.bannerrepeater.org/wiki/Main_Page Main Page].


Click on “+ add statement”.  
https://daap.bannerrepeater.org/w/images/e/ee/Tutorial2_img1.png


https://daap.bannerrepeater.org/w/images/b/b4/Tutorial3_img3.png
In order to do so you should log in. If you are not logged in an error message will be shown:


To add statements please use the existing properties. This is important. We intend to keep the properties to a limited list, to ensure workability. If you think a property is missing please consult with us before adding a new one.  
https://daap.bannerrepeater.org/w/images/3/34/Tutorial2_img2.png


There is no required order for how to add the different statements. Still, to know how to start you can have a look at another item in the database, or this example page that demonstrates a wide range of properties, to see how they are used.
You can login using [https://daap.bannerrepeater.org/w/index.php?title=Special:UserLogin&returnto=Main+Page this link] or from the Main Page.  
===Step 2===
===Step 2===
As we are adding the publication ''Surviving art school: an artist of colour tool kit'' we want to state that this item is a work (and not a person or a place). To do this we're going to add a statement that makes this clear. In order to specify what kind of item we're entering in the database we're going to use the property "instance of".
Make sure the item you want to add is not already in the database before you attempt to add it. You can do this by searching for it using the search bar in the top right corner of the Main Page containing the text “Search DAAP”.  


Start writing "instance of" in the box with the text "Property" and the box will auto-suggest this property for you, click on the suggestion to auto-complete the text.
https://daap.bannerrepeater.org/w/images/c/c3/Tutorial2_img3.png


https://daap.bannerrepeater.org/w/images/e/e0/Tutorial3_img4.png
===Step 3===
Then, start adding the details into the form on the Create a new Item page.


===Step 3===
https://daap.bannerrepeater.org/w/images/5/5c/Tutorial2_img4.png
In the box to the right, we're going to enter the value that describes what kind of item ours is. In this case, as we are adding a publication we’ll set the value to "work".  


All items that are things, like publications or artworks will have the value “work” and be an “instance of work”, as opposed to an instance of a person or a place.
'''Language:'''
Here you choose the language you will use to describe the item. If the original language of the work is different from English, there will be opportunity at a later stage (i.e. statement editing) to indicate that. For search purposes all item labels and descriptions have to be in English (NB: NOT British English, as that would create discrepancies in the database). Please enter “en” for English in this field, if it’s not your default language already.


Start writing "work" in the box following the property box we already set to “instance of”. The box will auto-suggest the value “work”. Click on the right suggestion to complete it automatically.
'''Label:'''
The Label is like a title – how this "thing" is referred to in the database. If your item is a publication or artwork its title would be the Label. If your item is a person this would be the person’s name, and so on.  


https://daap.bannerrepeater.org/w/images/4/4e/Tutorial3_img5.png
'''Description:'''
Your description should be a very short statement (max 250 characters) that distinguishes one thing in the database from another. If two items in the database would have the same label, for instance two artworks both called "untitled", the descriptive text would help the user quickly distinguish between the two.  


===Step 4===
Once the item is created, the description will appear at the top of the item page (see Step4).  
Press '''save'''. You have now made your first statement.


Now that you know how to add a statement to your Item, we'll go through how to add other kinds of statements.
'''Aliases, pipe-separated:'''
Aliases are alternative ways of spelling or calling the item. For example, aliases for the city "New York" would be "NYC", or "New York City", etc. There is no limit to the number of aliases that can be added, they just need to be separated by the pipe symbol | .


To add a statement about who the creators/artists/contributors are to your own Item you need to make sure an Item page for the person, or collective, already exists, else you need to create one for them.  
Here we have entered the details for the publication ''Surviving art school : an artist of colour tool kit''.


https://daap.bannerrepeater.org/w/images/d/d0/Tutorial3_img6.png
https://daap.bannerrepeater.org/w/images/3/30/Tutorial2_img5.png


This is a process that you can repeat for adding an item for the publisher, the format, a specific binding method, etc. as needed.
===Step 4===
Press the “Create” button to finalise this step. In the next tutorials we’ll show you how we added this item to the DAAP database and you can follow along the steps with the item you want to add.  


To do so please follow the tutorial [https://daap.network/tutorial_4 Create other items needed to describe a work].
https://daap.bannerrepeater.org/w/images/c/c2/Tutorial2_img6.png

Revision as of 22:23, 30 July 2021

Tutorial 3

Create a new Item

You can use the Create a new Item form to add new items to the database whether the item is a thing such as a specific artwork or object, a person, an institution, or a place in the world. Items can also be less specific "things" such as "paper", "offset printing", "softcover binding", etc. Item records can be very complex, with lots of information attached to them, as is the case for artworks, or very simple with only one or two pieces of information attached, such as the record for "softcover binding" for example.

Step 1

To add a new item to the database please go to the Create a new Item page using this link. You can always find this function in the sidebar to the left on your screen, or by using the Create new item button under the heading Adding new data in the archive on the Main Page.

Tutorial2_img1.png

In order to do so you should log in. If you are not logged in an error message will be shown:

Tutorial2_img2.png

You can login using this link or from the Main Page.

Step 2

Make sure the item you want to add is not already in the database before you attempt to add it. You can do this by searching for it using the search bar in the top right corner of the Main Page containing the text “Search DAAP”.

Tutorial2_img3.png

Step 3

Then, start adding the details into the form on the Create a new Item page.

Tutorial2_img4.png

Language: Here you choose the language you will use to describe the item. If the original language of the work is different from English, there will be opportunity at a later stage (i.e. statement editing) to indicate that. For search purposes all item labels and descriptions have to be in English (NB: NOT British English, as that would create discrepancies in the database). Please enter “en” for English in this field, if it’s not your default language already.

Label: The Label is like a title – how this "thing" is referred to in the database. If your item is a publication or artwork its title would be the Label. If your item is a person this would be the person’s name, and so on.

Description: Your description should be a very short statement (max 250 characters) that distinguishes one thing in the database from another. If two items in the database would have the same label, for instance two artworks both called "untitled", the descriptive text would help the user quickly distinguish between the two.

Once the item is created, the description will appear at the top of the item page (see Step4).

Aliases, pipe-separated: Aliases are alternative ways of spelling or calling the item. For example, aliases for the city "New York" would be "NYC", or "New York City", etc. There is no limit to the number of aliases that can be added, they just need to be separated by the pipe symbol | .

Here we have entered the details for the publication Surviving art school : an artist of colour tool kit.

Tutorial2_img5.png

Step 4

Press the “Create” button to finalise this step. In the next tutorials we’ll show you how we added this item to the DAAP database and you can follow along the steps with the item you want to add.

Tutorial2_img6.png

Retrieved from "https://daap.bannerrepeater.org/w/index.php?title=Tutorial_3&oldid=15447"