IMPORTANT: Please gather, using your notes and sources, all the data you have about an entity before you actually edit or add it to the database. The system creates a new revision for each time you click the Save button. Entering all data at once prevents unnecessary revisions.
The order of data entry
In order to connect an entity to another, you should first find out whether or not the other entity already exists in the database. If it does, you can go ahead and connect the two. You can also edit (correct or add data to the other entity while at it). If it doesn't exist (and please double check, as we are eager to avoid duplications!), please create it first.
Please consult the class diagram, which lists all the relationships among all entity types, in order to understand which type of entity you should create first. Generally speaking, you have to "climb up" the tree of the relationships. For example, if you are dealing with a work by a known person that was written in a known site, you should -- following the diagram -- start from the lowest of the three, which is the site. Again, you should check first whether the site exists in Pandit, and add it first if it doesn't. Then check if the person entity exists, and add it if it doesn't. Finally, do the same with the work entity itself.
Tip: If you can, go in a chronological order; for example, If you want to add data that one person knew the other, so usually the other person is older and should be in the database first.
Editing an existing entity
Each entity has its own page. At the top left of each page you can find the link Edit. Click it in order to launch the editing form.
Continue as explained below in the section on using the editing form.
Adding a new entity
For type Print, State, Site, Institution, Person, Work, MS Collection and Manuscript - hover the "Add data" global menu at the right top of the website and clicking the link of the relevant entity type. For the Extract type - click the "Add an extract" link located inside the relevant manuscript page. Once you click the link you are launching the editing form. Continue as explained below.
Using the editing form
Once you have opened the editing form, carefully go through ALL the fields in it so that you add or edit as much data as you can.
- Remember to click the Save button; the system does not save the entity automatically.
- Click the Save button only once. Then wait to the page to refresh.
Use simple widgets as a text box, a select list and check boxes as you normally do when filling forms (like a "contact us" page in any website). Some other widgets are listed below.
Fields with an autocoplete function are marked with a circle at the right end of the widget. Start typing in any part of the name or title of the entity you want to relate to, and the available entities will appear on your screen:
- You must choose from the autocomplete list of options; a copy-paste of a name or of a title of an entity will not work.
- The system provides additional information on each suggested entity so as to help you to choose between multiple options.
- Make sure you choose the correct entity to refer to. If you are not sure, search the entity in a separate tab and make sure that its ID is the same as of the entity you refer to.
- You can type any part of the name or the title of the entity you want to refer to, not necessarily its beginning. In the example above, you can type ayy or ksi, etc.
- If you know the ID of the entity you can type it in order to get the entity you want right away.
When a field has sub-fields they are grouped in a frame:
Go to Google Maps and search for the place by typing its name in the search box. Choose the correct option:
Copy the full name as Google identify the place:
Paste the text that you have copied into the text box:
If you add data to an entity as part of working on a specific project then check the relevant checkbox under the field "Attribute to (project)".
- You cannot remove an attribution to an entity, so make sure that you are attributing an entity to a project only when appropriate.
- The attribution to a project is only for this entity, not to related entities. This is to prevent false attributing to an entity that has nothing to do with your project.
When you constantly work on a specific project, use the field "Automatic attribution to (project)" that is located at the bottom of of the settings form in your profile page - this will save you from once and again checking the checkbox of the project you work on for each and every entity.
Removing a value
If the widget includes a Remove button then click it:
However, if the widget does not include such a button then you have to select the entire value and delete so the widget will look empty: