Home

The Medici Archive Project, Software Redesign Proposal

1. A N BUSINESS J h DATA T4 je Y LOGIC ACCESS i LAYER V LAYER Image 1 The software application layers User Interface this layer handles the system interaction with the users It includes the read only and the data entry masks the controls and the mechanisms that appropriately intercept the events that the user performs Business Logic Layet it includes the set of rules that handle information exchange between the Data Access Layer and the User Interface Data Access Layet provides simplified access to the data kept in a persistent storage such as a RDBMS This model will be used to develop the new MAP software system 13 References Principal Documents Appendix A Top Level System Requirements Document Minutes of meeting Minutes of Meeting 3 State Archive in Florence requirements Current websites http documents medici org MAP online read only database http courses medici org MAP online teaching software Current Data Structure Database iter medici out current mysql database tables structure the data source of http documents medici org that is shown after this document 1 4 Overview of the Document The document is divided into six main sections The Software Modules Design section explains how the modules and sub modules that compose the MAP system are structured and how they will be developed The User Interface Design section shows the web interface
2. John Smith Community User My messenger Send new PM Inbox Contact List Total Messages 8 in all foders 0 of total capacity Edit Folders Message Title Sender Date Mark as read Move Delete Go to Inbox d New Portrait upload Needs your approval here System message Community 02 4 2000 Backup Messages Edit Signature amp RE how to search for Alessandro de Medici Alessio Assonitis add to contacts 02 4 2000 amp New post on document 1143 System message Community 02 14 2000 wi Scheduled db backup not performed Error System message Critical 02 14 2010 Ci v RE how to search for Alessandro de Medici Alessio Assonitis add to contacts 0244 2010 P bg RE how to search for Alessandro de Medici Alessio Assonitis add to contacts 02 14 2010 B w RE how to search for Alessandro de Medici Alessio Assonitis add to contacts 02 14 2010 G wr RE how to search for Alessandro de Medici Alessio Assonitis add to contacts 02 14 2010 Ci Mark as read Move Delete Image 18 Community System Messages 33 2 6 Administration Module The Administration is used both to administer the whole system uset account management reports statistics logs document revisions and to manage the data backups 2 6 1 User Management Through the User Management dropdown menu users belonging to the Administrators user group will be able to activate new user accounts create new user accounts and modify e
3. The Community usets will be able to send personal messages to each other The ability to communicate this way will be very important in establishing relationships between scholars who have interests in common 3 3 2 Functional Requirements 3 3 2 1 REQ 08 New user registration form New usets will be able to ask for a username and password through a registration form A community rules disclaimer will be created one that new users must agree to in order to successfully register 15 3 3 2 2 REQ 09 Search the database When users log in they will be able to browse the data using a search mask similar to the one we have at out current on line database at http documents medici org Search results will include digitized documents as well 3 3 2 3 REQ 10 Posting comments questions and answers Community users will be able to post comments questions and answers according to the community rules disclaimer If the comments posted do not comply with the community rules the Community Coordinators see 2 4 8 will delete them The Community Coordinators will be able to close a discussion thread blocking any further comments 3 4 Logging user actions and data revisions 3 4 1 Description Every modification to the data in the system must be logged and saved This is needed for monitoring purposes and to track user actions to see if the users are correctly operating the interface When a system error occurs these logs will
4. Yes No Check Box to signal Recipient s Name is 66 uncertain for any reason including illegibility physical loss name identification RECIPLOCPLALL Number Recipient Location ID linked to unique ID in GETTYPLACES RECIPLOCUNS Yes No Check Box to signal Recipient s Place is uncertain for any reason including illegibility physical loss place identification RECIPNOTES Text Text field for notes modifying or qualifying Recipient s Name ot Location E g Giorgino Pittore Roma or A Niccolini Ambasciatore a Roma GRAPHIC Yes No Check Box for visual material e g drawings plans coats of arms etc tblPeople PERSONID AutoNumber Unique Identifier for a Person MAPNameLF Text Created automatically as Name Parts are Edited Full Name Last Name First GENDER Text Gender M F or X for unknown or placeholders ACTIVESTART Text If no birthdate date known activity starts ACTIVEEND Text If no deathdate date known activity ends BMONTHNUM Number Birth Month in Number Format BDAY Number Birth Day BYEAR Number Birth Year BPLACEID Number BirthPlaceID links to tblPlaces record BPLACE Text Birth Place entered here only if not in tblPlaces when identified and present in tblPlaces this entry will be deleted DMONTHNUM Number Death Month in Number Format DDAY Numbet Death Day DYEAR Numbet Death Year DPLACEID Numbet DeathPlace
5. 5 3 3 Reliability The software reliability is an important requirement Any data loss will be avoided 21 6 Other Requirements 6 1 Data migration Volumes documents bios and places records reside now in the current software These data will be transferred into the new system which will be using a RDBMS that is compatible with a web based system A web based read only system http documents medici org has already been developed and it is based on an opensource database MySQL We do have tools to migrate the vetted data from the current software Microsoft Access to MySQL The migration task has to be planned and verified to avoid data loss and will be investigated in the System Design Phase Phase 2 22 Minutes of Meeting Minutes of Meeting 1 MAP Software Redesign Identification of Functional Requirements 10 01 2009 Participants Staff Lorenzo Allori Technology Director Alessio Assonitis Research Director Research Fellows Elena Brizio Lisa Kaborycha Stefano Dall Aglio Documents to refer to a Current system slides b Current system slides things to change In these slides our current Microsoft Access based MAPDocSourcesV4D data entry system is analyzed in all its parts the PowerPoint slides we used during the meeting are shown after this document Definitions of terms Hereafter the terms slides or the slides refers to Current system slides The terms mslides or the mslide
6. Add New Document Record Remove Filter 7 Refresh Excel Entryit Volit Shel tt Foliott Date Alga Date Indexed People Sender Recip Une 45 2 24 1537 09 13 25 Cobos y Molina Francisco de los J Li dre appi pi Mo lina c con Portrait r mos irar alor S Signor 1 Record 14 142 of 1 Filtered record Id 1 gt gt t rx of 19000 E ay v m amp au 4 FK us a x mm NN E a ALL INDEXED TOPICS by DOCUMENT GRID BA Remove Fiter close Amon Pate TOPIC CATEGORY PLACE DOC ID DATE INDEXED PERSON gt Sculpture Chk Pam Campidoglio 399 Rossi Vincenzo de Sculpture EH AM Campidoglio 1981 Carafa Gianpietro Paulus IV Sculpture PME Campidoglio Sculpture 1824 Tevere 18453 Guidi Antonio 1981 Carafa Gianpietro Paulus IV zi 21499 Sculpture EEE Campidoglio 21493 360 Medici di Marignano Giovanni Angelo de Pius IV 21499 _ RECO SYNOPSIS Nr Add New EXT Document zm l and Record Pd Close Topic Category Academies TopicID 2 Remove Filter ACADEMIES indexes occurrences of the term accademia in its various language forms The Refresh term accademia was used to designate a wide variety of formal and informal organizations ranging from official bodies like the Florentine Accademia del Disegno and Accademia della Crusca to simple gatherings of people with shared in
7. Word Search el Add Volume e E From Date yea nont v day Add to Date year nontl z day Add in Extract 8 in Synopsis Add Topics e x Sender e E Recipient oj 3 io Refers to e z Search Locations Search People Search Volumes Search Filter List in Volume 1170a remove Rima remove And in Extract alcuni libri arabi e caldei a And regarding Topics Books and Printing remove And regarding Topics Coins and Medals remove Search From E Image 7b Advanced Search page filters creation sample 16 The search results will be displayed as follows Advanced Search Search Results 9 Documents Select All 1 DOCID VOLUME INSERT FOLIO DATE FROM TO Search Filter List 22434 1858 61 1519 Nov 19 Tudor Henry VII Valois Henry Il de r London Paris in Volume 1170a 22434 1858 61 1519 Nov 19 Tudor Henry VII Valois Henry Il de D And London Paris i libri i i 61 Tudor Henry VII Valois Henry Il di in Geez alcuni libri arabi e caldei 22434 1858 Ls b C bre aee para Henry Uc D Ani SSS regarding Topics Books and Printing OD And 22434 1858 61 1519 Nov 19 Tudor Henry VII Valoi London Paris regarding Topics Coins and Medals CTR RE LT TT eA CTO A BERR HII HS r Modify Filters EN A 22434 1858 61 1519 Nov 19 Tudor Henry VII Valois Henry Il de London Paris r 22434 1858 61 1519 Nov 19 Tudor Henry VII Valois Henry Il de r London Paris 22434 1858 61 1519 Nov 19 Tu
8. look and its new features The Data Structural Design section gives a general view of MAP s current database tables as well as the new database tables which will be created The Help System Design section shows how the help system works and where the users can access it Inthe Architectural Strategies section the coding approach is explained in detail as well as the tools that will be used to develop the software platform The Application Environments section describes the Development Environment the Testing Environment and the Production Environment This includes the Developers laptop software configuration as well as the Servers software NB The Server System section describes both the server deployment as well as the backup and restote procedures The manuscripts and the text displayed on the screen images attached to this document do not correspond to actual documents but are only samples The images shown in the document are not to be considered the final look of the new web application but only a suggestion of potential screens and masks which might be adopted Additionally the purpose of these images is to better understand the concepts and the functionalities explained in this document Referring to these images will facilitate the work of the software developers 2 Software Modules Design The web based application MAP is going to develop has a modular structure Authentication Data E
9. Docid 9915 Volume 1170a Insert Part Folio Start Paginated No TL Modern Date 1577 Recorded Year 1577 Ge E Date Note Undated document but inserted between documents dated 1577 x c FACT CHECK YES open and edit rs N CORRESPONDENTS PEOPLE edit Pa p Sender Tudor Henry VII From City of London City of London England Fa Recipient Medici Francesco de To Firenze Firenze Toscana Ref Niccolini Agnolo di Matteo mn Kir EXTRACT SYNOPSIS edit R Extract St kd Prego V S a Hay os favorirmi con S A Ser ma et con Ar adama Sig a mia Ser ma di farmi gratia d imprestarmi m alcuni libri arabi e caldei et il carattere per stampare alcune Be operette mie overo concedermi una stanza nel giardino m dove io possa studiare e rendere subito i libri a luoghi suoi St ie mandare a V S alcune madaglie della m editione di San Carlo et alcun Agnus Dei e He oynopsis m Vittorio Accorense Maronita asks Cioli to request permission dat Le from Grand Duke Cosimo Il and Grand Duchess Christine of a Lorraine on his behalf to borrow some foreign books type Zoom in out CI fonts for printing a few of his works or to grant him a room in an iuinenerifiaed nardan where he mav e idy Arenrense Image 6 see item s history of revisions 14 2 3 Search module This module is used to search through the database records Everyone can use it and perform three main actions perform a search browse through the results and show the d
10. E3 Entry Menu Vet Menu Advancec User Management Reports and Revisions System Management Browse Users Activity report Servers status Activate User Accounts Comments report Backup and Restore Scheduled Backups Add new User Statistics Manual Backup ate Da Revisions Database Documents revisions Browse Data Backups Documents Total 19187 People revisions Not Vetted 5759 Vetted 13428 Browse Logs Backups Volumes revisions Places revisions Image 29 Administration menu 45 3 2 4 Digitization menu and its web interface Once the Digitization Technician see 3 1 1 5 logs on she is forwarded to the Digitization Interface that consists in two main menus Digitized volumes filze upload and Catalog Descriptions This menu helps the Digitization Technician to perform two main actions Prepare the volume compiling its catalog description see Minutes of Meeting 3 Catalog Description which can be downloaded as a pdf file to be handed to the State Archive official Upload the entire digitized volume all the images are prepared before the upload in the correct format following the State Archive cataloguing conventions see Minutes of Meeting 3 State Archive in Florence requirements and compressed into a zip file H THE MEDICI ARCHIVE PROJECT Search Documents for go Upload Volumes Filze Catalog Descriptions Create new digitized Volume Filza Browse catalog descritpions Edit digit
11. Ready to be vetted to permit another Fellow to do a check and review it After the second Fellow who must be an On Site Fellow or a Senior Distant Fellow has checked and corrected it she will vet the document using the Vet this document option This menu is also used to un vet the document in case someone notices an error In this case the document has to be re vetted by another Fellow If a document is not set as Ready to be vetted it is allowed to be viewed and edited only by the user who created that entty ICI ARCHIVE PROJECT Un vet this document Image 26 Vet Menu 43 Menu items Set Ready to be vetted Vet this document visible to Administrators On Site Fellows and Senior Distant Fellows if the document is ready to be vetted Un vet this document visible to Administrators On Site Fellows and Senior Distant Fellows if the document is vetted 3 2 1 4 Advanced Search The Advanced Search menu is used to do a search over documents volumes people and places and community comments applying several filters see 2 3 2 Go to last PERSON 4 PROJECT t3 Entry Menu Vet Menu Who am Lisa Ka Search on people Search on volumes Search on places Search on community comments Image 27 Advanced Search Menu Menu items Search on documents Search on volumes Search on persons Search on places Search on community comments 3 2 1 5 Chronology The Chronology dropdown menu will
12. same database tables structure of the Microsoft Access based On Site software To populate the online database MAP at the present time exports the data from Microsoft Access to Mysql using some Perl based scripts once a week These scripts will need to be revised for use with the new system but 90 of the Mysql structure MAP now has will be used as is 62 4 2 Current Database Tables TblSeriesList SeriesRefNum Number primary key Unique identifying number for Series Reference titles and subtitles Title Text Series reference title from Archivio Mediceo del Principato Inventario Sommario Roma 1951 SubTitle1 Text Series reference subtitle 1 from Archivio Mediceo del Principato Inventario Sommario Roma 1951 SubTitle2 Text Series reference subtitle 2 from Archivio Mediceo del Principato Inventario Sommario Roma 1951 TblVolumes VOLUMES Summaryld AutoNumber primary key Unique identifying number for Volume Summaries SeriesRefNum Number extern key to tblSerieList Unique identifying number keyed to SERIESLIST table containing pre assigned titles of the categories into which the Mediceo del Principato archive has been divided VolNum Number Volume Shelf Number e g 1176 Will not exceed 4 digits VolLeText Text Letter extension for volume shelf number e g a in 11762 ResId Text Initials of Researcher who crea
13. 2006 kl Iv 6 9 2006 6 9 2006 gt Save Record Add New Volume Remove Filter Z Refresh W MAF Documentary sources Database ugar umeni Vata Management Eg Hy 1 RUSA BY 219 TKAM s Ej RASSIGI DONE 3 LI A 5 8 2003 E t ALL EXTRACTS amp SYNOPSES by DOCUMENT GRID iy Remove pito to Filter Eici DOC ID DAY MON YEAR MOD YEAR SORTABLE DATE VolShelftt ReslD 801 RE IL od0000000 5158 BS EXTRACT FROM DOCUMENT ENGLISH SYNOPSIS In fatto w eil Ser mo Gran Duca An unsigned legal opinion discusses the Ferdinando primo 1 di glor rosa memoria obligations ofthe estate of Grand Duke C Ferdinando de Medici and Prince Lorenzo EI GET e de Medici his heir to maintain Gianfrancesco u ii i i g Maria de Medici The opinion considers Dio piacer concederci provederemo con Gianfrancesco to be a spurious offspring and a parte ne parla loro nascita o therefore not deserving intendiamo c hi o annulli la olont e s intendino instituiti come sin horo instituiamo in quelli bene e raggioni che per detti privilegi appariranno espr i e tutto ci in ogni miglio modo resent gifts from velle textiles and Molina textiles and z Se HI b bl of 19004 l re B P ALL PEOPLE DOCUMENT GRID d Remove Filter Close Export Data to Fact Check Save Record he si revoc
14. 3 reading preliminary vetting On Site Fellows Senior Distance Fellows 2nd step Continuous reviewing 1 review community comments Community Users 2nd review answer comment On Site Fellows Senior Distance Fellows and Distance Fellows This process continues until a Community Coordinator decides to close the thread 11 2 5 Design and Implementation Constraints The graphic user interface has to be web based Lightweight production of web pages is desirable to guarantee fast reliable access to the system Itis acceptable to use an opensource RDBMS 2 6 User and Developer Documentation A User Manual will be produced Video lessons will be created to get new users acquainted with the system In addition a Developer Manual will be produced 12 3 System Features 3 1 Access to the System Authentication Module 3 1 1 Description The login to the system is performed through username and password All the users must be registered except the guest users see 2 4 7 After the login phase every user has access to some specific part of the systems based on its group credentials see 2 4 3 1 2 Functional Requirements 3 1 2 1 REQ 01 Authentication methods Authentication methods must be implemented in accordance with the more recent standards for web authentication 3 2 Data Entry Documents Module 3 2 1 Description Data entry is one of the most important tasks The Documents Module is the w
15. Bus esce ina 3 2 4 Digitization menu and its web interface ex nce aee qtd ette id ee tete quta 3 3 Split SCLEEM 28 P M 48 3 4 The Document Transcription rire eieeeeee ennt nnne nnne nnne nn tenente nenne enne nennen 51 3 5 Getting info from dropdown auto completing menus eene 55 3 6 How to print records crrrrrrrrerer erre ee zeri ee ze zine re ze nici nz ezine nie e zine rie ee eee zie i ni zz eee zeri eee aaiae 59 3 6 1 Printing aisingle item page rita i 59 3 6 2 Printing document records from a search list 61 3 7 COmpatibility Saa 61 4 DATA STRUCTURAL DESIGN eese enne nennen nnne a nennen entente nnne Teeke 62 4 1 Date SUUCtUfes oie ox eed diet eoa t sit 62 4 2 Current Database Tables cis 5 eerte tret oeste ha oe En get esae neon tees oa eoe Pag eo asa eese espe get i 63 4 3 New AIREICGECCRCIO C R zi zizi eeee eee zizi zicicine 4 3 1 User action tracking ine 4 3 2 Database Items revisions 4 3 3 Community Comments ds I sexs xs us ASA Personal Messages eee ee apa eee tei e Des i pee eti ce E cd dat teer e petente 4 3 5 Showtrip dieitized manusctlpls siii iaia aaa ia 71 4 3 6 Google Maps integration ia us Dor iu A ASE Catalog d scripHons scene htt aptat bte pte e hdd dede otia detta date ce desde ecu d 5 HELP SYSTEM DESIGN eese entente nennen eie
16. Date Notes Florentine dating applies Remove Filter Z Refresh Close Unique ID 424 Volume Shelf 1 READY FOR VETTING Iv 9 1 2000 Stage Researcher ID AR VETTER ASSIGNED MA 5 30 2006 VETTING DONE Iv 4 11 2008 Date Created 8 11 1998 General Description Correspondents Documents Volume loose series of documents from Condition Loose sheets in varying states of Organizational different periods including late conservation but generally good possibly eighteenth century copies of documents from other volumes divided into 2 inserts inconsistent folio General Rocard Bound Yes No L1 Folios Numbered Yes No L1 Alphabetical Index Yes No O Folio Count Add Ne Yolume Criteria New Italian French O German O Other Languages Lus Corresp Sanh LI Pur English O Remove Filter 7 Refresh Some Documents in Cipher Cipher Notes Unique ID 424 Volume Shelf 1 READY FOR VETTING Iv 3 1 2000 Researcher ID AR M Stage VETTER ASSIGNED MA 5 30 2006 Date Created 8 11 1338 VETTING DONE 5 4 11 2008 General Description Correspondents Documents General Description of Correspondents GRIDS Cosimo de Medici Eleonora de Toledo Lorenzo Pagni Cristiano Pagni Pier Francesco Riccio Bartolomeo GRIDS Concini Guidubaldo Il della Rovere Antonio Ramirez de Montalvo General Ins 1 Cosimo de Medici Francesco de Medici Ferdinando de Medi
17. E 13 3 1 Access to the System Authentication Module eese 13 5 3 JOeSCTIDHOD S eerte ee cette e sie iet thee tete ettet te tette ii 13 3 1 2 Functional Requifements eee tee edet tei ip repete a di esee ei pec pt 13 3 2 Data Entry Documents Module 13 3 2 1 Description iatale ilaele dialisi aaa bha 13 3 2 2 Functional Requitem nts ila rica 14 3 3 Community Modules ara 15 3 3 1 D scripion mariti alal ia 15 3 3 2 Functional Requitem nts iii aaa 15 3 4 Logging user actions and data revisions eene 16 3 4 1 JJesctIptOn aeter utn tiae et tetas eed dvi de e t RE 16 3442 Functional Requirements eee 16 3 5 Document Digitization iran 17 3 5 1 JOESEFIDUOD s cetera i lina ina I inni a eo di ia 17 3 5 2 Functional Requirements ia i 17 3 6 Syst m AC Minist ON aa ra 18 3 6 1 Descriptions ida E a tuens di ella Relais ni la i lidi ui 18 3 6 2 Functional Requirements Oa 18 4 EXTERNAL INTERFACE REQUIREMENTIS ecce 19 4 1 Hardware Inteiacirlae aa 19 4 1 1 Digitization hatdwate i enceinte illa aaa 19 41 22 Servers Hardwatesc aco SERI EROR REOR RIDE RANA 19 5 OTHER NONFUNCTIONAL REQUIREMENTS eee 20 5 1 Performance Requirements sani 20 5 2 Security Requirements sidro 20 5 3 Software Quality Attubutes a iaia 21 AS Usability eerie ette Gala Acli 21 519 2 GCrOSs plattorm compatibility uil iaia 21 53 3 E sense nee
18. Henry VIII Portrait edit 5 Documents Tudor Henry VIII Gender M Date of Birth 1491 DOCID VOLUME INSERT FOLIO DATE FROM TO Birth Place 22434 1858 61 1519 Nov 19 Tudor Henry VII Valois Henry ll de Active Start London Paris Death 1547 Jan 1 22434 1858 61 1519Nov19 Tudor Henry VII Valois Henry Il de ce London Paris 22434 1858 61 1519 Nov 19 Tudor Henry VII Valois Henry Il de E London Paris Names edit 22434 1858 61 1519 Nov 19 Tudor Henry VII Valois Henry Il de ES London Paris Given Henry 22434 1858 61 1519 Nov 19 Tudor Henry VII Valois Henry Il de London Paris Family Tudor back to document advanced search Titles Occupations edit King of England HEADS of STATE Emperors Empresses Kings Queens 1509 1547 Relationships edit Spouses Arag n Caterina de 1505 1533 d 1536 m Boleyn Anne m 1536 b 1507 d 1536 Seymour Jane d 1537 m Cl ves Anne de m 7 Howard Catherine m 3 Parr Catherine m 1542 b 1521 d 1542 1512 d 1548 Children Tudor Mary b 1516 d 1558 udor Elizabeth b 1533 d 1603 udor Edward VI b 1537 October 12 d 1553 July 6 Image 13 the PeopleBase editing turned on Each bio file has the following main fields Person Details Names Titles and Occupations Relationships and Portait Each main field has its sub fields except for Names Titles and Occupations and Portrait Person Details Gender Date of birth Birth place if the place is n
19. ID f Insert or Part No E Il Unpaginated Name Medici Cosimo de Folio Start No 24 Disc Cont d O Place Firenze Firenze Toscana Italia Sender Notes Y ear Month Day 1537 September 13 O RECIPIENT Uns ID it Date Uncertain or Approximate Undated O Name Serristori Averardo di Antonio O 205 Sortable Date 1537 09 13 Aie fs Sekt fa sort dy ual datet Place Espana Europe World Top of the TGN hieral 1 O EN Date Notes The dating seems to be an abbreviation for settembre though a readina of aiuano is not Recipient Notes Al ambasciatore Averardo Serristori in Spagna Fact Check START 1537 Start Month January Start Day 30 Add New END 1543 End Month December End Day E penis Date Notes Florentine dating applies ee From Context Predominantly from the Tuscan Court various hands including Lorenzo Pagni However there are also copies of spies reports and other miscellaneous material sent to the Duke Remove Filter Volume Info Refresh To Fact Check Italy and Abroad Sovereigns Bates Nobles Gentlemen Administrators including rardo Serristori Agnolo Niccolini internal Hemo Giovanni Bandinjittfnso d Avalos Marchese del Vasto and T Don Pedig oledo Viceroy of Naples Doc ID 73 Vol Shelf 2 Res ID 11 28 1596 SENDER Unpaginated di 18 cage M 24 Disc Cont d O Place EG i i 5 8 2003 DETAIL Vol
20. Maddalena d Austria for permitting him the church ofthe Santissima Annunziata during his sta Each frame separately Extract Ritornai a Milano poco fa perla via della Romagna imagine dell Annonciata scoperta la memoria della quale conservar sempre riccordai di Vostra Altezza et della serenissima sua Casa Rendo poi infinite gratie a Vostra Altezza et allo ser mo signor Gran Duca Cosimo Il de Medici del favore che mi fecero ch io potessi vedere quella sacra Eurum ME Miraculous Images Santissima Annunziata Cappella della Santissima Annunziata Basilica della Santissima Annunziata Convento della Firenze Painting Santissima Annunziata Cappella della Santissima Annunziata Basilica della Santissima Annunziata Convento della Firenze Place Index Madonna di Loreto Chiesa della Loreto Ancona Marche Research Notes No Research Notes Available Document Citation Text Archivio di Stato di Firenze Mediceo del Principato 6081 folio 194circa Entry 15693 in the the Medici Archive Project Documentary Sources database The Medici Archive Project All infarmatinn ritad from tha Nacimantary Saurcac for tha Arte and Himanitiac datahaca miict ha craditad to Image 43 Print preview page The user is then able to print it by clicking the operating system print button in this case the Microsoft Windows 60 3 6 2 Printing document records from a search list I
21. The digitization task The Medici Granducal Archival Corpus is organized in volumes called fe At first the digitization technician prepares the volume she analyzes the volume s conditions deciding if it has to be restored she compiles a catalog description see Minutes of Meeting 3 Catalog Description and eventually numbers the pages At this point she starts taking pictures of each page including the spine at the end of this process she creates a directory with the name of the volume ex 17012 on his computer and she transfers all the images produced from the digital camera to the computer Finally she renames each image using the State Archive in Florence standards lt progressive number gt _ lt type gt _ lt page number gt _ lt side gt progressive number 4 numbers that identify the page univocally ex 0001 0023 spe can take one of the following values COPERTA C carta G guardia e A allegato page number 3 numbers that identify the page number ex 001 009 side can take one of the following values R recto V verso Examples 0001 COPERTA 001 R tiff 0456 C 001 R t ff 0456 C 001 V aff The directory 1s afterwards compressed in a zip format and sent to the MAP system using the digitization interface see 2 7 2 1 The digitization task will start at the same time as the development process so MAP will not be able to provide the digitization interface The digitized manuscripts will be
22. Tuscan Court Averardo Serristori Cosimo I de Medici Francesco I Cardinal Ferdinando I de Medici RECIPS Memo General description of correspondents E g To Rome Ambassadors Agents Administrators and the Papal Court Pope Paul III CONTEXT Memo General historical description of the volume emphasizing major events E g Pope Paul III elevates new cardinales Medici and Ferrarese ambassadors precedence controvery at the Papal Court Reports on plague in Rome FOLIOCOUNT Text Number of folios in the volume including blank folios Based on pagination Folio count in unpaginated volumes are estimated BOUND Yes No Check box to signal that volume is bound or unbound FOLSNUMBRD Yes No Check box to signal that folios are paginated or unpaginated OLDALPHAINDEX Yes No Check box to signal presence of an index Some volumes contain old alphabetical indices of names CONDITION Memo Notes on physical condition of the volume and individual folios E g Documents heavily treated and sometimes faint Deterioration sometimes affects legibility ITALIAN Yes No Check box to signal presence of documents in ITALIAN language SPANISH Yes No Check box to signal presence of documents in SPANISH language ENGLISH Yes No Check box to signal presence of documents in ENGLISH language LATIN Yes No Check box to signal presence of do
23. Would it be possible to include the image of the spine of the volume in the MAP new system LORENZO ALLORI Sure it could be possible to show it in the l o Base so that a volume might also be identified by the picture of its spine I will discuss this as well with our Research Director Alessio Assonitis 4 Analysis of the Manuscript Viewer program LORENZO ALLORI Dr Klein is it possible to get the sources of the manuscript viewer you are using as it is an opensource product and it complies with your regulations FRANCESCA KLEIN Yes I will introduce you to Dr Parrini from the Scuola Normale di Pisa who developed our system to view the manuscripts online you will need to ask him for the sources Catalog description Istituto Archivio di Stato Firenze Fondo Serie N unit Titolo Date estreme Descrizione contenuto Legatura Supporto Cartulazione Note alla cartulazione Carte bianche Carte mancanti Dimensioni base mm Dimensioni altezza mm Sistema di scansione marca e modello dello scanner software utilizzato durante il processo di scansione Profondit del colore es RGB 24 bit Risoluzione Formato Compressione Nome files ES quattro cifre numero progressivo delle immagini coperta C carta G guardia A allegato tre cifre numero della pagina o carta _ R V Numero totale imm
24. a description of the user action performed for example modified field recipient in doc id 3256 or modified topic in doc id 4492 A copy of the modified item with date and time is stored for the history of revisions 3 5 Document Digitization 3 5 1 Description Document digitization is a high priority requirement in order to work off site it also helps preserve the precious original documents from wear and tear The first twenty volumes of the Medici Granducal Archival Collection have already been digitized and will be uploaded to the system All subsequent volumes will be digitized in their entirety and will be uploaded one at a time to the new system 3 5 2 Functional Requirements 3 5 2 1 REQ 15 Upload digitized documents to the database A standalone program or a web interface will be given to the Digitization Technician in order to upload the digitized images to the system in the correct format Digitized documents can be stored in the file system or in the database This decision will be made in the System Design Phase Phase 2 3 5 2 2 REQ 16 Digitization process The Digitization Technician will follow the State Archive s cataloguing conventions see Minutes of Meeting 3 State Archive in Florence requirements The reproduction will be made using digital camera technology see 4 1 1 Once the digitization of a volume is completed the Digitization Technician will upload the images to the system
25. digitization table b Digita Docs see 4 3 5 e Tae 2 7 2 The Digitization web interface The Digitization module consists in the web interface the Digitization Technician uses for uploading the digitized volumes to the system and to compiling the catalog descriptions For a detailed explanation of the Digitization web interface see section 3 2 4 37 2 8 Manuscript Viewer To show the digitized manuscripts MAP chose to adapt and to integrate IIPImage in the web application IIPImage is an open source lightweight streaming client server system for the web based viewing and zooming of ultra high resolution images It is designed to be bandwidth and memory efficient and usable even over a slow Internet connection To use IIPImage though the source images must be in a multi resolution tiled pyramidal format Tiled Pyramidal TIFF is a tiled multi page TIFF image with each resolution stored as a separate layer within the TIFF During the digitization process the system creates the Tiled Pyramidal TIFF using Imagemagick 2 8 1 MAP s IIPImage implementation The manuscript viewer will be available in two different formats full screen and half size and will be accessed from both Wo Base see 2 4 2 and DocBase see 2 4 1 2 8 1 1 Full screen This format is normally used by a Fellow when working in the Vo Base see 2 4 2 she flips through a volume of the Medici Granducal Archival Collection and reads each page looking for a docum
26. le Granvi or to Francisco de los Cobos y Molina textiles and Synopsis quelle parole iudicherete co rsi per arra an unspecified statue People Topics Volume Info Fact Check Delete This Doc Record READY FOR VETTING Doc ID 73 Vol Shelf 2 2 13 2002 DETAIL Volume Shelf tt 2 Res 1n FN SENDER Insert or Part No Unpaginated ig Medici Cosimo de Folio Start No 24 Disc Cont d O Place Firenze Firenze Toscana Italia 2 t INO sc Lontd Sender Notes Year Month Day Mod Year Reckoning 1537 September j 13 O RECIPIENT Uns ID tt Date Uncertain or Approximate Undated L1 Name Serristori Averardo di Antonio Sortable Date 1537 09 13 xe y fata fe sont de Aul Afef Place Espana Europe World Top of the TGN hiera Date Notes The dating seems to be an abbreviation for Recipient Notes All ambasciatore Averardo Serristori in Spagna settembre though a reading of aiuano is not Volume Info Fact Check Add New Document Extract 251 Cobos y Molina Francisco de los I Record Synopsis S 203 Medici Cosimo de 250 Perrenot de Granvelle Nicolas Remove R 205 Serristori Averardo di Antonio I Filters Refresh Fact Check Record 14 1 gt gt I gt of 4 READY FOR VETTING VETTER ASSIGNED DONE Doc ID 73 Vol Shelf 2 2 13 2002 EG fee 5 8 200
27. person description Created by LK on 25 11 2009 DOCUMENT DETAILS edit Docid 9915 Volume 1170a Insert Part Folio Start Paginated No Modern Date 1577 Recorded Year 1577 Date Note Undated document but inserted between documents dated 1577 FACT CHECK NO open and edit CORRESPONDENTS PEOPLE Sender Tudor From Firenze Firenze Toscan Select a Person SearchName Tudor Tudor Tudor Ref Tudor Tudor pou Recipient Image 38 People suggestion box with link to PeopleBase 55 By clicking the link a description page of the bio selected appears This is obtained by the use of the spit screen feature see 3 3 Created by LK on 25 11 2009 DOCUMENT DETAILS edit Docid 9915 Volume 1170a Insert Part Folio Start Paginated No Modern Date 1577 Recorded Year 1577 Date Note Undated document but inserted between documents dated 1577 FACT CHECK NO open and edit CORRESPONDENTS PEOPLE Sender Tudor From Firenze Firenze Toscan Recipient Tudor Tudor Tudor Ref Tudor Tudor EXTRACT SYNOPSIS edit Empty Extract NO IMAGE se dls attach a Empty Synopsis digitalized document PERSON DETAILS Tudor Henry VIII Portrait er Birth 1491 Og moo t ath 1547 Jan 1 Given Henry Family Tudor TITLES OCCUPATIONS King of England HEADS of STATE Emperors Empresses Kings Queens 1509 1547 RELATIONSHIPS Spouses Arag n Cater
28. show a list of the twenty most recent database items viewed ot edited 3 2 1 6 My profile This link takes the user to his profile see 2 5 2 3 2 1 7 Messages This link takes the user to his inbox see 2 5 3 3 2 1 8 Log out This link logs out the user from the system 44 3 2 1 9 Shortcut Menu The Shortcut Menu is placed at the top right of the Main Menu and it consists in three links taken from the chronology that if clicked take you to the last document person volume or place that you most recently edited see image below 3 2 2 Community User menus When a Community user logs on she can perform the same actions that Fellows can see the section above with the exception that she does not have access to the Entry menu and the Vet Menu and therefore cannot edit or delete anything Go to last DOCUMENT entry Vol 1770a Abate Di San Galgano Go to last VOLUME entry Mdp 1170a S Date 1534 Sept Go to last PLACE entry Firenze Firenze Toscana Italia Europe World Advanced Search Chronology My Profile Messages 1 Log out Who am I John Smith Community User Image 28 Community User Main Menu 3 2 3 Administration menus When a user belonging to the Administrators user group logs on the Administration menus appear This module consists in three dropdown menus User Management Reports and Revisions and System Management E THE MEDICI ARCHIVE PROJECT Search Documents J for
29. stored on dvds and or hard drives and when the digitization interface is ready they will be uploaded to the system These images will also help us for the initial testing of the digitization module 36 For easy access of a document in its digital format the digitized manuscripts are stored in the database in a database table called Dzg fa Does see 4 3 5 A new record is created for each new digitized document uploaded Each database record that belongs to the table b Digital Docs corresponds to two digitized images recto and verso The digitized documents database table does not contain any external keys to the b Volumes ot to the b Documents tables see 4 2 This database table however includes all the information extracted from the names of the files and from the directory in which it resides allowing the association to a volume and to the folio page The On Site or the Distance Fellow will manually link the extract to the correct folio or folios to which it belongs The system performs these actions 1 Checks if the volume is already present in the system 2 If it is asks if the user wants to replace the old content with the new one Saves the original zip file in the digitization root folder and renames it in this format date volumenumber zip Decomptesses the zip file in a folder renaming it with the volume number Analyzes the names of the files Creates a Tiled Pyramidal TIFF see 2 8 Creates a new record in the
30. the State Archive in Florence regulations for publishing online digitized manuscripts During Phase 2 we will find a way to adapt it to our new system Minutes of Meeting 3 MAP Software Redesign Meeting with the State Archive in Florence Officials 10 28 2009 Participants Staff Lorenzo Allori Technology Director Marcello Botrugno Software Architect Francesca Klein State Archive in Florence Director of the Reading Room Francesco Martelli State Archive in Florence Curator of the Medici Granducal Archive Collection Steps 1 Introduction 2 Analysis of the Digitalization Technician workflow 3 Definition of the standards for cataloguing digitalized document images 4 Analysis of the Manuscript Viewer program Documents to refer to Minutes of Meeting 3 catalog description that is shown after this document 1 Introduction to the document digitalization process LORENZO ALLORI The goal of this meeting is to Describe the Digitalization Technician workflow Identify and define the State Archive in Florence standards for cataloguing the digitalized documents Analyze the tool for viewing the digitalized document in use by the Florence State Archive to see if it matches our requirements 2 Analysis of the Digitalization Technician workflow LORENZO ALLORI Dr Klein would you please describe the workflow of the technicians that you use fot digitalizing the manusctipts FRANCESCA KLEIN First the volume m
31. the following fields will be filled in vital statistics name variants parents children spouses roles and occupations In case of children parents and spouses the person must be linked to the pertinent other bios 3 2 2 6 REQ 07 Creating modifying a place in the GeoBase The database contains the records of all the places if recognizable contained in the documents These places can refer to modern nations cities that exist now or that do not exist anymore as well as churches villas or castles Each Place is indexed in the GeoBase according to its modern name in the principal language spoken in that country For example the Belgian city of Antwerp is searchable by entering its Flemish name Antwerpen Google maps must be integrated in the system to show cleatly where the location is 3 3 Community Module 3 3 1 Description Though read only browsing in our database is free and is a chief prerogative of the whole system users belonging to the Guest group see 2 4 7 are forbidden from browsing digitized documents and from posting comments Registered Community users are authorized to see digitized documents and to post comments questions and answers see 2 4 5 The comments questions and answers entered by the community have their own life cycle If a user posts a comment or a question another user can answer it The discussion will go on until the Community Coordinator see 2 4 8 decides to close the discussion thread
32. the menu Servers status Backup and Restore Scheduled Backup Manual Backup Browse Data Backups Browse Logs Backups The Servers Status takes the Administrator to a page that shows all the sensitive server information such as cluster information uptime of all the servers connected disk use load average etc The Backup and Restore tool is used to manage the backup system The Scheduled Backup is a tool to be used to schedule automatic backups It permits you to define what to backup and when to do it The Manual Backup is a tool to perform a fast backup in a few clicks by selecting the data you want to backup The Browse Data Backups and the Browse Logs Backups are two different pages to search through data backups or logs backups This menu is shown at section 3 2 3 35 2 7 Digitization module The digitization of the manuscripts is the most important task to be performed along with the development of the software so that when MAP launches the production release the Distance Fellows and the Community users will have a large number of digitized manuscripts to work on and discuss The digitization tasks are performed separately from the On site Fellows work This means that the Fellows work is independent from the digitization task the On Site Fellows in fact have the primary sources to look at Conversely the process of digitization is not dependent on the creation of database records transcriptions 2 74
33. 3 ea im Vol DETAIL Volume Shelf 2 Res 1 FN gt SENDER Uns ID if Name Em 203 Insert or Part No IL Unpaginated i Folio Start No Dac Cond CI Place a E Tm Sender Notes Year Month Day Mod Year Reckoning DATE 1537 September 13 o RECIPIENT Uns ID it Date Uncertain or amp pproximate Undated O Name o 205 Sortable Date 1537 09 13 Aie thi Bek fo sevt dy Aat datel Date Notes The dating seems to be an abbreviation for settembre though a reading of aiuano is not Place Recipient Notes UTILITIES Save Record Firenze Firenze Toscana Italia Add New GRIDS oculpture Espana rane World 1 e TG dbi Document Extract Record Luxury Textiles Firenze inze na it Synopsis Luxury Textiles People Gifts from the Medici Court to Topics Remove Filter Volume Info Refresh Fact Check Delete This Doc Record Record I4 I 1 EE gt i rs of 5 READY FOR VETTING VETTER ASSIGNED DONE MM Vol DETAIL Volume Shelf tt Res ID FN 1 SENDER Uns ID ft rm Insert or Pat No Unpaginated E PB Folio Start No 24 Disc Cont d O L a eal E GB Sender Notes Year Month _ Day Mod Year Reckoning i i 1537 September 13 o RECIPIENT Uns ID it Date Uncertain or Approximate Undated O Name
34. ALESSIO ASSONITIS Ok nothing to change and or add 3 7 PeopleBase Docs Tab slide 12 ALESSIO ASSONITIS Ok nothing to change and or add 3 8 PeopleBase Biblio Stats Tab slide 13 mslide 6 ALESSIO ASSONITIS This should be restructured The textboxes should be completely free without having to add a master biblio record FELLOWS We should also remove the button Add New Master Biblio Record 4 VolBase mask redesign 4 1 VolBase General tab slide 14 ALESSIO ASSONITIS The textbox called Internal Memo should be changed to Volume Fact Check 4 2 VolBase Description tab slide 15 ALESSIO ASSONITIS Ok nothing to change and or add 4 3 VolBase Correspondents tab slide 16 ALESSIO ASSONITIS The From and the To textboxes should be converted into two automatic lists that the program creates itself FELLOWS The names should be clickable so that if you click on a name you get the Peop eBase record of that sender or recipient In the Context tab one should be able to add a link to a place indexed in the database 4 4 VolBase Documents tab slide 17 ALESSIO ASSONITIS Ok nothing to change and or add 5 MAPDocSourcesV4D Search Grids slides 18 19 LORENZO ALLORI As this will be a web based application the button grids are no longer needed Web based programs have a completely different approach for doing a search over our database we will be creating a search page with all the fields then we will b
35. AP blanks GEOGKEY Number TGN geographic place ID subject id Created by MAP for MAPPLACES and MAPSITES on new records PLACENAME Text Name of Place PLACENAMEFULL Text Concatenated String of place hierarchy created programmatically PLNAMEFULL_PLTYPE Text Concatenated String of place hierarchy including place types created programmatically PLTYPE Text Place Type inhabited place province etc PREFFLAG Text Preferred Flag indicates P referred or V ariant place name PLSOURCE Text Source for this record TGN import MAPPLACE or MAPSITE PLPARENT Text Place s Parent Place next up on the hierarchy PARENTTYPE Text Parent Place Type PLPARENT TERM ID Number Parent s Place Term ID PlaceANameID in Doc Soutces PLPARENT SUBJECT ID Number Parent s Subject ID GEOGKEY in Doc Sources PLPARENT PLACEALLID Number Parent s Unique MAP ID GPARENT Text Place Grandparent Name 68 GPTYPE Text Place Grandparent Place Type GGP Text Place Great Grandparent Name GGPTYPE Text Place Great Grandparent Place Type GP2 Text Place Great Great Grandparent Name GP2TYPE Text Place Great Great Grandparent Type RESID Text Researcher s ID Number DATEENTERED Date time Date Stamp for entries PLACESMEMO Memo MAP Researcher Notes not for public ADDLRES Yes No Additional Research Required Ietm Accent Text Term with accented characters Language Number Not implemented OTHER_FLAGS T
36. APPENDIX A Top Level System Requirements Document Last Edited March 23 2010 Lorenzo Alloti and Marcello Botrugno Te HEN TRO DUCT TON siccicccstecasunsacnaa seed ocnsscntdeavanasanadsantcnnvadedecsdsendcvaveradevaveennenavadetsenvee 4 1 1 PURPOSE spissa qu Oba ER ia 4 1 2 Intended Audience usse UU TVAE AUTEM I UH SUR e ED SEV ES 4 1 3 Project SCODE naar 5 1 4 RR PEREN CES as cis wzeiavises daceansndees wigan vues ula vases dha Cees ae eseia aude Sega wanes Hee 5 2 OVERALL DESCRIPTION 6 2 1 Product Perspectives oisi eis ds er I E eR SIR IEEE RON cise UU See IESU 6 2 2 Modular DGS otis ous ai osos i TIS Staa ile 6 2 3 PHrtod ct Eeatufes un cdiiendedm ipo sitas Eear E ea 7 2 4 User Groups qvo oig o eo AH VOR HR OA RAE HR RE YEA IA RU E UA 8 2 4 1 Adiinist atots ausc tete ae sk each tate de lhe i iii eve sete ii A 9 2 4 2 On Site Fellows nica E aE 9 2 4 5 Senior Distance RellOws etes ett petiere eaters thieves ne 9 244 Distance Pellows nest er metet eer e eet puede sies epa aee eei aeu ted 9 2 4 5 COMMUNITY USERS rM RR RR 10 2 4 6 JDipitization Technicians es 10 y wc I D ES 10 2 4 8 SpecilhRoles eie te iaia 10 2 4 9 Workflow serenana E edet pe a etes tique sei peter iii 11 2 5 Design and Implementation Constraints eese 12 2 6 User and Developer Documentation eese eee 12 Ao SYSTEM FEATURES 22502 3 IRI AFIN Rb AEI SEXUM AGIR VERAM tayeys QUERECHT ER KHU
37. DS Parents amp Children D siio n Vital Stats Names Parents Children Spouses Roles Occs Biblio LE 3 Add New Master Bibliography Biblia Record Reference Author s E ditor s Dates Ref Notes for this Person Ei Record 14 1 bl of 1 P In Rome by 1575 worked in Florence as a portraitist passed through S See Thomas DaCosta Kaufmann Drawings from the Holy Roman Venice during return trip to Bavaria in 1587 T Empire 1540 1680 Princeton 1982 Person Record Remove Filter 7 Refresh x Eg Hy 7 amp R0 amp dA 2 y VY OKOM d di A M IG o O0IktinNARO LLLO IeLLL IABLLLLOULLELD LE E a ALL INDEXED TOPICS by DOCUMENT GRID BA Remove Fiter close Fipon Date TOPIC CATEGORY PLACE DOC ID DATE INDEXED PERSON gt Sculpture TESE Campidoglio 21499 Rossi Vincenzo de Sculpture RERyIUE Campidoglio 21499 j 1981 Carafa Gianpietro Paulus IV Sculpture GEPA Campidoglio 21493 l Medici di Marignano Giovanni Angelo de Pius IV 21499 Sculpture EHE Campidoglio 18453 Guidi Antonio Sculpture 1824 Tevere 1981 Carafa Gianpietro Paulus IV Record 14 lt i d Hl of 5497 Filtered RECOU SYNOPSIS Add New Document TER Record BA cose Topic Category Academies TopicID 2 Remove Filter Refresh ACADEMIES indexes occurrences of the term
38. ESSIO ASSONITIS This should be redesigned we should take out Dates Places and Person textboxes FELLOWS It should be possible to indicate that a Fac Check is available for that document and it should be visible to the community so that the community users can answer the questions or the issues that are listed in the Fact Check section LORENZO ALLORI We can highlight the Fac Check label to identify the presence of a Fac Check related to that particular document 3 PeopleBase Mask redesign 3 1 PeopleBase Vital Stats tab slide 6 mslide 5 ALESSIO ASSONITIS We should remove the checkbox named PORTRAIT INDEXED in the DOCBASE FELLOWS We should be able to add images for the portraits We could use the National Portrait Gallery web site to do this and we should also permit the members of the community to do that LORENZO ALLORI We can also authorize the community users to upload a picture from the National Portrait Gallery This upload has to be vetted by a Fellow or a Staff member prior to being published online 3 2 PeopleBase Names tab slide 7 ALESSIO ASSONITIS Ok nothing to change and or add 3 3 PeopleBase Parents tab slide 8 ALESSIO ASSONITIS Ok nothing to change and or add 3 4 PeopleBase Children Tab slide 9 ALESSIO ASSONITIS Ok nothing to change and or add 3 5 PeopleBase Spouses Tab slide 10 ALESSIO ASSONITIS Ok nothing to change and or add 3 6 PeopleBase Roles Occs Tab slide 11
39. ID links to tblPlaces record DPLACE Text Death Place entered here only if not in tblPlaces when identified and present in tblPlaces this entry will be deleted FIRST Text First or Given Name SUCNUM Text Succession number Middle Text Middle Pre Last Name midprefix Text Prefix to Middle Pre Last Name Last Text Last or ID Name lastprefix Text Prefix for Last or ID Name Postlast Text Name following ID Name postlastprefix Text Prefix for Name following ID Name 67 BAPPROX Yes No Birth Year Approx Y N BDATEBC Yes No Birth Year B C Y N BPLACEUNS Yes No Birth Place Unsure Y N DAPPROX Yes No Death Date Approx Y N DYEARBC Yes No Death Year B C Y N DPLACEUNS Yes No Death Place Unsure Y N STATUS Text Active or Inactive BIONOTES Memo General biographical Notes STAFFNOTES Memo Internal Staff Notes PORTRAIT Yes No Portrait Description for this person Y N calculated from EPLINK Portrait field FATHERID Number Father s Person ID MOTHERID Number Mother s Person ID RESID Text Researcher ID for record creator DateCreated Date time Date Entry Started on this Record LastUpdate Date time Date of Last Change tblPlaces PLACEALLID AutoNmber Unique MAP ID Primary key PLACENAMEID Number Unique TGN Place Term_ID ID Necessarily missing for MAPPLACES and MAPSITES Must set Duplicates OK because of the M
40. K YES open and edit CORRESPONDENTS PEOPLE edit Sender Tudor Henry VII From City of London City of London England Recipient Medici Francesco de To Firenze Firenze Toscan Ref Niccolini Agnolo di Matte EXTRACT SYNOPSIS edit Extract L Prego V S a degnarsi favorirmi con S A Ser ma et con ladama Sig a mia Ser ma di farmi gratia d imprestarmi alcuni libri arabi e caldei et il carattere per stampare alcune operette mie overo concedermi una stanza nel giardino dove io possa studiare e rendere subito i libri a luoghi suoi Vorrei mandare a V S alcune madaglie della eneditione di San Carlo et alcun Agnus Dei Synopsis Vittorio Accorense Maronita asks Cioli to request permission 9 E from Grand Duke Cosimo Il and Grand Duchess Christine of Y Lorraine on his behalf to borrow some foreign books type Zoom in out fonts for printing a few of his works or to grant him a room in i WINE an unspecified garden where he may study Accorense intends to send Cioli foundation medals of the church of San Carlo and some agnus dei TOPICS edit Books and Printing City of London City of London England Coins and Medals Firenze Firenze Toscana Italia MANUSCRIPT VIEWER Turn editing off Zooming Utility 800000 see it in full screen go to Volbase Image 11 the DocBase editing turned on Each document file has the following main fields Document Details Correspondents People Ex
41. London England Recipient Medici Francesco de To Firenze Firenze Toscan Tudor Henry VII London 49 Tudor Henry VII Valois Henry Il de London Paris Ref Niccolini Agnolo di Matte EXTRACT SYNOPSIS edit Extract m Prego V S a degnarsi favorirmi con S A Ser ma et con ladama Sig a mia Ser ma di farmi gralia d imprestarmi alcuni libri arabi e caldei et il carattere per stampare alcune operette mie overo concedermi una stra nel giardino dove io possa studiare e rendere subito i libri a luoghi suoi fore mandare a V S alcune madaglie della editione di San Carlo et alcun Agnus Dei Synopsis Vittorio Accorense Maronita asks Cioli to request permission from Grand Duke Cosimo I and Grand Duchess Christine of Lorraine on h s behalf to borrow some foreign books type Zoom in out fonts for printing a few of his works or to grant him a uo in a an unspecified garden where he may study Accoren intends to send Cioli foundation medals of the church of San Carlo and some agnus dei TOPICS eai Books and Printing City of London City of London England Coins and Medals Firenze Firenze Toscana Italia Image 31 Left screen Edit Screen and Right screen Searches Read only Screen 48 Created by LK on 25 11 2009 DOCUMENT DETAILS edit Docid 9915 Volume 1170a Insert Part Folio Start Paginated No Modern Date 1577 Recorded Year 1577 Date Note Undated document but inserted between document
42. Lorraine on his behalf to borrow some foreign books type dove io possa SUE arance UR Do a luoghi suoi Foie Cle e wona orta Joe ji pitone di San Carlo akin OUS Dei tl intends to send Cioli foundation medals of the church of San View Full Screen Carlo and some aanus dei Image 8 the Turn editing on button 18 2 4 Data Entry module This module consists of the data entry interface that On Site Fellows Senior Distance Fellows and Distance Fellows use Through this module they are able to create new item records volume document bio or place modify and or delete them Each type of item has its attributes fields that can be edited The Fellows enter this module by clicking on the button called turn editing on see Image 8 on the previous page Once having entered the Data Entry module the user can edit each editable part by clicking the edit web link visible at the right side of each section title Created by LK on 25 11 2009 DOCUMENT DETAILS edit Docid 9915 Volume Select Vol edit doc details Folio Start Paginated Modern Date Recorded Year Date Note CORRESPONDENTS PEOPLE ait Sender Person not selected From Place not selected Recipient Person not selected To Place not selected Ref Person not selected Image 9 the Edit section web link 19 After pressing the edit web link the Edit Box emerges allowing the user to edit that section In the example below the user is editing th
43. O _205 Sortable Date 1537 09 13 dee fri fen fo sunt by fal date Place Espana Europe World Top of the TGN hiera a O BEEN Date Notes The dating seems to be an abbreviation for settembre though a readina of aiuano is not Recipient Notes j UTILITIES Save Record START Start Month Start D ay Add New END End Month End Day Document Record Date Notes From Context lominantly fr he Tuscan Court various hands including On fly leaf Minute dell I r the es of spies 1543 Drafts of letters and n The chief topics it to the Duke include aftermath of the death of Duke Alessandro de Medici the early principato of Cosimo relations with Spain Remove through the correspondence of Averardo Serristori Filter Ambassador to the Imperial Court negotiations for marriage of Cosimo and Eleonora de Toledo Piero Strozzi affair French and Spanish troop movements negotiations bles Gentlemen regarding Altopascio Camerino and Piombino d isagreement Delete vh CUN Internal Memo This Doc Va Record Refresh Vol Shelf 2 2 13 2002 5 8 2003 Res ib FN SENDER m Name Medici Cosimo de Doc ID 73 DETAIL Volume Shelf Insert or Part No ll Unpaginated Place Firenze Firenze Toscana Italia HEALY FUR VEI IINa y NS aNEL VUNE 5 8 2003 Sender Notes Folio Start No 124 Disc Cont d O ID it Year _ Month Day Mod Year
44. People tab slide 2 mslide 2 FELLOWS A search button for the portrait indexed in a document should be available inside the PeopleBase LORENZO ALLORI We will discuss this issue during the analysis of the PeopleBase slides 2 3 DocBase Volume Info tab slide 3 mslide 3 ALESSIO ASSONITIS This section should be removed it should be kept instead in the Volbase 2 4 DocBase Topic tab slide 4 FELLOWS Would it be possible to create a new Topic Category and add it to the existing ones ALESSIO ASSONITIS No One would have to re read and re vet all the volumes that have been entered so far However what we can do and should do is create a Topic Category which derives from two or more existing ones For example all documents dealing with dance or ballet are entered either under the Topic Categories Music and Musical Instruments and or Theater and Festival In Early Modern Eutope there was no dance performance without music and usually every theater performance included both dance and music It is for this reason that Fellows could read over all documents in the categories Music and Musical Instruments and Theater and Festival and select those documents in which dance is referenced directly and link them to a new Topic Category entitled Dance and Ballet LORENZO ALLORI Ok we will create a new Topic Category called Dance and Ballet It will be added to the topic list 2 5 DocBase Fact Check tab slide 5 mslide 4 AL
45. Reckoning 1537 September 13 O Date Uncertain or Approximate Undated O RECIPIENT Sortable Date 1537 09 13 tive dis Bat to sort by Kal data Uns ID Name Serristori Averardo di Antonio ET O _205 Place Espana Europe World Top of the TGN hiera 41 O NEN Date Notes The dating seems to be an abbreviation for Recipient Notes All ambasciatore Averardo Serristori in Spagna settembre though a reading of aiuano is not Extract Synopsis Yolume Info Research Notes Internal Notes GRIDS EN Extract Synopsis PLACE S People Topics PERSON pes Volume Info Fact Check UTILITIES Add New Document Record Remove Filter Refresh ID 113 Vital Stats Parents amp Children Titles Occs Biblio Aachen Hans von XXXXXXXXXXX ID Name XXXXXXIXIXXXX Vital Stats Names Spouses Roles Occs Docs Biblio gt Vital Statistics Enter Birth Year OR Active Start Unsure 8623 Koln 7 Koln Nordrhein Westfal 4b Hat Record 14 1 gt b of 1 P in Rome by 1575 worked in Florence as a portraitist passed through U Venice during return trip to Bavaria in 1587 Enter Death Year OR Active End Unsure 12118 Praha Stredocesky Ceska Reput dpi a ack S See Thomas DaCosta Kaufmann Drawings from the Holy Roman T Empire 1540 1680 Princeton 1982 Person Record Remove Filter 7 Re
46. SPONDENTS PEOPLE Sender Tudor Henry VII From City of London City of London England Recipient Medici Francesco de To Firenze Firenze Toscan Ref Niccolini Agnolo di Matte EXTRACT SYNOPSIS Extract El Memoriale dello Abbate di San Galgano all lll mo et S or Duca di Fiorenze et Siena Francesco 1 sopra gli aggravii che messer Agnolo Niccolini governatore oggi in Siena gli ha fatto et continuamente gli va facendo 3 Synopsis List of complaints presented by the Abbot of San Galgano to Francesco largely relating to his perceived maltreatment the Medici s Sienese governor Agnolo Niccolini le list includes the fact that no payment was made of rent for the lease of San Galgano properties at Santa Maria Maddalena in Siena to the nuns of Ognissanti Related correspondence indicates that the complex was used to house the nuns after their convent had been demolished during the war of Siena Zoom in out TOPICS Place Index San Galgano Abbazia Image 32 Left Side Edit Screen and Right Side Document Read only Screen Above you can see a Fellow that is comparing the document she is editing to another read only document 49 Here on the other hand a Fellow is compating a document to a person record which is mentioned in the document Created by LK on 25 11 2009 DOCUMENT DETAILS edit a PERSON DETAILS Docid 9915 Volume 1170a Insert Part Folio Start Paginated No Tudor Henry VIII Po
47. Spouses Documents Indexed to this Person GRIDS Vital Stats Names Parents amp Children Spouses Remove Filter 7 Refresh Titles Occs O Record P in Rome by 1575 worked in Florence as a portraitist passed through See Thomas DaCosta Kaufmann Drawings from the Holy Roman Venice during return trip to Bavaria in 1587 Empire 1540 1680 Princeton 1982 ID 113 Aachen Hans von Vital Stats Names Parents Children Spouses Roles Occs Biblio ibili Add New Master Bibliography Biblio Record Reference Author s E ditor s Dates Ref Notes for this Person Person Record Hemove Filter 7 Refresh Titles Occs uments Bibio m Record I4 por nori P in Rome by 1575 worked in Florence as a portraitist passed through e Thomas DaCosta Kaufmann Drawings from the Holy Roman Venice during return trip to Bavaria in 1587 mpire 1540 1680 Princeton 1982 Unique ID Vol Shelf 424 olume Shelf READY FOR VETTING Stage Researcher ID AR AR M 8 11 1338 Iv 3 1 2000 VETTER ASSIGNED MA z 5 30 2006 VETTING DONE Date Created Vv 4 11 2008 General Description Correspondents Documents Inventario Sommario Series Reference Date Entered _ 871171998 Minute di Lettere e Registri E Minute Cosimo pues Concino General Start Year Save Record Start Day End Year 1574 End Month Corresp Add New End Day Yolume
48. The Digitization Coordinator see 2 4 8 will check the quality of the images produced in otder to guarantee an easy reading for the Fellows 17 3 6 System Administration 3 6 1 Description Administration tasks are performed through a particular part of the web interface that is accessible only to the Administrators user group see 2 4 1 3 6 2 Functional Requirements 3 6 2 1 REQ 17 User accounts management It will be possible to perform these tasks Show the user list Create new usets Modify user accounts Delete usets 3 6 2 2 REQ 19 Backup and restore A backup and restore option will be available 3 6 2 3 REQ 20 Logs review A mask for searching through logs will be available Logs will be searched by each relevant field Furthermore it would be possible to cross seatch these items user IP address action information date and time 3 6 2 4 REQ 21 Revisions review A history review option will be available to Administrators by clicking a review history list link displayed on each volume document bio or place page 18 4 External Interface Requirements 4 1 Hardware Interfaces 4 1 1 Digitization hardware The digitization will be performed using a digital camera taking pictures at minimum 300 DPI 4 1 2 Servers Hardware The servers hardware will guarantee enough storage space for the digitized document images and enough speed for the performance required Technical spec
49. Wine Fortifications Image 40 Topics suggestion box with link to Topic info box 57 In this case though the split screen feature is not used The information is displayed using a floating help box From this box you are able to directly chose the topic if it meets the users needs by clicking the button Choose Rupe WIbUI FEGIIUESUU Ut Ww Piece MICIIZE PUDUEI I Ref Niccolini Agnolo di Matte TITLES OCCUPATIONS L King of England HEADS of STATE Emperors Empresses Kings Que TOPICS mM x TIONSHIPS Topic z Topic Place x P Caterina de 526 83 5 1536 b 1507 d 1536 X I our JANG Synopsis f PIEMONTE TOPIC DESCRIPTION Books and Printing d ird ong SET e of e ae ntmaking manuscript copies s calligi and illumination TOPICS editing Bookbinding distribution and copyright privileges for books and ints the censorship of printed works the trade imm eferences to printed maps are cross indexed under MAPS Al MAPMAKING and printed music under MUSIC AND MUSICALE INSTRUMENTS Major libraries are also indexed under PLACES 1553 July 6 for example Biblioteca Laurenziania Convento San Lorenzo Firenze Firenze Toscana Italia Europe World Image 41 Topics suggestion box with link to floating Topic info box All these features are developed using DWR and JQuery See 6 1 1 and 6 1 5 for details 58 3 6 Howto print records Another important feature which w
50. a conclave for the election of Julius Ill election of Henri III Valois as King of Poland imprisonment of Mariotto Cecchi election of Pietro Lando as je of Venice pu intment of Bishop of Saluzzo Alfonso Tomabuoni to bear congratulations from the Medici court to Felipe Il S EE Emanuela de Portugal on the birth of Don Carlos selection of a possible successor to Bartolomeo Lanfredini as majordomo at the Medici court possible V visit of Cardinal Gianfrancesco Gambara Image 12 the VolBase editing turned on Each volume has the following main fields Volume Details Description Correspondents and Context 23 Each main field has its sub fields except for Context Volume Details Map or Volume Number Start Date End Date Date Note Description Organizational Criteria Condition Bound Folios Numbered Alphabetical Index Languages Some Documents in Cipher Cipher Notes Correspondents From To Context This section provides a brief historical overview of the specific events that are featured in the volume Volume Spine If the volume spine has been digitized the image of it is shown here 24 2 4 3 PeopleBase sub module This is the data entry part which stores biographical information regarding the individuals and corporate bodies whose names appear in the DocBase You searched PEOPLE for Henry VIII Who am I Lisa Kaborycha On site Fellow Person Details edit CREATED BY KH 11 28 1996 edit Document List People Tudor
51. a ow a his works or sd him a room in NIIS I an unspecified garden where he may study Accorense Tudor Mary b 1516 d 1558 intends to send Cioli foundation medals of the church of San TE Ey 2 3 Carlo and some agnus dei udor Elizabeth b 1533 d 1603 udor Edward VI b 1537 October 12 d 1553 July 6 TOPICS edit Books and Printing City of London City of London England Coins and Medals Firenze Firenze Toscana Italia Image 33 Left Side Edit Screen and Right Side Person Read only Screen 50 3 4 The Document Transcription The document transcription task is one of the core actions that the Fellows perform and one of the main goals MAP wants to accomplish is performing the document transcriptions with the use of digitized documents Therefore it is very important to provide the Distance Fellows with usable and accessible workbench Clicking the Extract Synopsis section edit link the Fellow enters the transctiption tasks p Created by NC on 06 23 2003 DOCUMENT DETAILS edit Vetted by LK on 11 25 2009 Docid 9914 Volume 1170a Insert Part Folio Start Paginated No Modern Date 1577 Recorded Year 1577 Date Note Undated document but inserted between documents dated 1577 CORRESPONDENTS PEOPLE edit From Abate di San Galgano Firenze Firenze Toscana Italia To Medici Francesco de Firenze Firenze Toscana Italia Ref Niccolini Agnolo di Matteo EXTRACT SYNOPSIS EG Extract Empty Synopsis E
52. accademia in its various langugge forms The 4 term accademia was used to designate a wide variety of formal and informalefganizations ranging from official bodies like the Florentine Accademia del Disegno and Accademia della Crusca to simple gatherings of people with shared interests stasera si fa l accagfnia dei poeti in palazzo Accademie were frequently meetings of artists and or amateurs tgefiraw from the nude Therefore the term fare l accademia often meant to draw from the nudegf nd the noun un accademia could indicate a drawing from the nude Duly constituted Acadeg es with formal corporate identities are also indexed under PLACES For example the Florepiifie Accademia del Disegno is indexed as Accademia Disegno Firenze Firenze Toscana lifa Europe World Delete This Doc Record ID AO 5 SENDER Insert or Part No 2 Unpaginated O SMISE Name Falia 5 tart M ape m D isc Cont d x Ll Place Sender Notes DATE RECIPIENT Une 1D Undated L1 Name Riccio Pier F J I EE Date Uncertain or Approximate Sortable Date 1548 03 03 dige he Peur o ane ae All datat Place Date Motes Wrong date April 6 on the back of the letter essa Volume Info Fact Check UTILITIES Save Record Year Month 3 Mod rear Reckoning L1 START 1538 Start Month J Start Day 3 Add New END End Month End Day 3 D
53. agini Dimensione media immagini Dimensione totale immagini Responsabile fotoriproduzione Data ripresa Operatore Minutes of Meeting 4 MAP Software Redesign Phase 1 3 Community requirements 10 29 2009 Participants Staff Lorenzo Allori Technology Director Alessio Assonitis Research Director Steps 1 Introduction 2 Study of the requirements for the Community module 1 Introduction LORENZO ALLORI The goal of this meeting is to identify the requirements for the Community module This part of the system will allow the Community users to interact with the Fellows work and amongst one another 2 Study on the requirements for the Community module LORENZO ALLORI Which are the tasks a Community user can perform once logged on ALESSIO ASSONITIS Community users will be able to See read only data such as documents including digitalized images bio records volume records and place records Comment on each record Edit their personal profile Communicate through personal messages between each other or send messages to a MAP Fellow LORENZO ALLORI Comments posted by users do not have to be immediately put online It is important that a Fellow or a Staff member who will have the role of checking user comments monitors each comment posted by a user and then authorizes the comment or deletes it ALESSIO ASSONITIS The Fellows who have this role should be notified
54. ange or delete any Distant Fellows documents SRC Search module MView Manuscript Viewer module CM Community module HL History Log module DIG Digitalization module Image 3 User Groups summary 10 2 1 1 8 Special Roles The Distance Fellows Coordinator can check the Distance Fellows work by accessing the History Log module s sub module called User Actions see 2 2 1 He will be notified in his inbox see 2 5 3 about any new ready to be vetted see 3 2 1 document created by the Distance Fellows The Community Coordinator can moderate the Community Users comments He is notified in his inbox about any new comment posted by the Community Users see 2 5 3 He is also notified of any user that fills in the User Registration Form see 2 1 3 and therefore he is in charge of whether or not to allow a user who requests to become a Community User The Digitization Coordinator is notified in his inbox about any new uploaded digitized volume 2 1 2 The Login Page On the login page the user can perform three actions Login with username and password Login as Guest Register to get username and password n THE MEDICI ARCHIVE PROJECT PLEASE LOG IN Register here to get your username and password Username Kaborycha eas Click here to login as Guest Password ee eee eee ES LOG IN Forgot your password Click here Image 4 Login page 11 2 1 3 User Registration Form When a G
55. are a me ne ui pensate che facci cose superfrue ma si tutte necessarie e come ui ho pi uolte detto ui anno a essere tutti contanti di poi f3 lascer fare a uoi altri il resto cio il maritarla che addio piaccia sia presto se per lo meglio accio si caui uoi di spesa e me di pensiero Vi mando il conto di tutto quello s speso come uedrete e non possendo mandarli tutti hora ne potrete m per tutta questa settimana mandarci la met e il restante a mezzo quest altro mese a ogni modo e non mancha te perch son debitora qua di parecchi scudi per questo conto ne altro ZOOM IT state sano e ci racchomandiano alle uostre orationi il di 7 di marzo 1562 Synopsis Fra Tommaso asks again for money in cash explaining he already has asked for it but there were problems It is important that the money comes quickly Other important things will be done shortly and no time will be wasted He also refers to a girl whom must be married quickly and this seems too to be a problem Image 37 Completed Extract Synopsis section 54 3 5 Getting info from dropdown auto completing menus Another important feature which was requested by the Fellows is getting items information directly from the dropdown auto completing text fields In the image below the user is selecting a Sender by typing in an auto complete text field a dropdown suggestion box appears with five fields the last field 1s the corresponding link to the
56. as requested by the Fellows is an easy to use printing facility for the documents indexed in the database 3 6 1 Printing a single item page To print a selected record the user has to click the print link at top left of the screen Y Created by NC on 06 23 2003 D AILS edit Vetted by LK on 11 25 2009 Docid 9914 Volume 1170a Insert Part Folio Start Paginated No Modern Date 1577 Recorded Year 1577 Date Note Undated document but inserted between documents dated 1577 CORRESPONDENTS PEOPLE edit From Abate di San Galgano Firenze Firenze Toscana Italia To Medici Francesco de Firenze Firenze Toscana Italia Ref Niccolini Agnolo di Matteo EXTRACT SYNOPSIS edit Extract Empty Synopsis Empty ZOOM IT Image 42 Print facility on item page 59 After clicking the link a preview page is shown The Medici Archive Project Documentary Sources for the Arts aH Printer Name Dell 2330dn Laser Printer Properti Document n Status Ready Type Dell 2330dn Laser Printer Ca t i Print range Copies Correspondents All Number of copies fr From Abbiati Forieri Ottaviano Milano Mil si EN lt To Habsburg de Medici Maria Magdalena von Firenze J Fi M Selection Ref Medici Cosimo Il de J Print Frames Extract Synopsis As laid out on the screen Synopsis The priest Ottaviano Abbiati Forieri who has recentlyre The selected frame Tuscany Maria
57. asingly efficient and productive By providing access to digitized primary sources MAP will be able to hire Distance Fellows who will work on the software from remote locations This way MAP will be able to reduce costs while increasing productivity Additionally the system will create a link between the MAP and the outside world expanding a community of scholars of early modern history These scholars both professional academics and graduate students will be able to comment and discuss the data interactively while consulting the database Therefore the system must be web based in order to be accessible from the Internet 1 4 References Minutes of meeting Minutes of Meeting 1 Functional requirements Minutes of Meeting 2 Digitization process requirements Minutes of Meeting 3 State Archive in Florence requirements Minutes of Meeting 3 Catalog Description Minutes of Meeting 4 Community requirements Minutes of Meeting 5 History log module requirements Current websites http documents medici org MAP online read only database http courses medici org MAP online teaching software 2 Overall Description 2 1 Product Perspective This system will be an enhanced version of the Microsoft Access based which MAP Fellows currently use as their data entry software Unlike the current software the new system will be easily accessible off site and therefore must be fully accessible from the Internet To achieve th
58. ature pv RE how to search for Alessandro de Medici Alessio Assonitis add to contacts 02 14 2010 r v RE how to search for Alessandro de Medici Alessio Assonitis add to contacts 02 14 2010 r bg RE how to search for Alessandro de Medici Alessio Assonitis add to contacts 02 14 2010 r w amp RE how to search for Alessandro de Medici Alessio Assonitis add to contacts 02 14 2010 O p RE how to search for Alessandro de Medici Alessio Assonitis add to contacts 02 14 2010 n pv RE how to search for Alessandro de Medici Alessio Assonitis add to contacts 02 14 2010 r w RE how to search for Alessandro de Medici Alessio Assonitis add to contacts 02 14 2010 Mark as read Move Delete Image 17 Community A User s Inbox 25 3 2 System Messages If the user has a special role Distance Fellows Coordinator Community Coordinator or Digitization Coordinator he receives system messages in his inbox A Distance Fellows Cootdinator can receive a notification about a new document entered by a Distance Fellow a Community Coordinator can receive a notification of a new comment posted that is waiting for approval a Digitization Coordinator can receive the notification that a new digitized volume is ready Also On Site Fellows receive notifications about documents that have been finished and set to ready to be vetted see 3 2 1 by Distance Fellows Users with special roles can also send messages to an entire user group Who am
59. be reviewed in order to discover the reason for that failure To restore any type of data loss and as an enhancement to regularly scheduled backup procedures a history of revisions of every single item record volume document bio place present in the database must be available to the Administrators user group see 2 4 1 3 4 2 Functional Requirements 3 4 2 1 REQ 11 Access to the system Registered users access the system by entering a username and a password Every login will be recorded including the following fields username IP address date and time 3 4 2 2 REQ 12 Adding new data The creation of new records will be logged tracing username IP address date and time as well as a description of the user action performed for example added sender into doc id 2305 or added role and occupation to person id 34283 A copy of that item with date and time will be stored in the database for the history of revisions 3 4 2 3 REQ 13 Deleting data The deletion of new records will be logged tracing username IP address date and time as well as a description of the user action performed for example deleted place record id 4442 or deleted doc id 2308 At the time of the deletion a copy of the deleted item with date and time will be stored in the database for the history of revisions 16 3 4 2 4 REQ 14 Modifying data Every modified item is logged tracing username IP address date and time as well as
60. ci Felipe de Austria Maximilian Il on Habsburg Charles Ix de Valois Pius IV Pius V Girolamo Priuli Doge di Venezia Ercole Il d Este Ferrante Gonzaga di Guastalla Cardinal Giovanni Salviati Cardinal Zaccaria Delfino Cardinal Ippolito d Este Cardinal Corresp Markus Il Altemps Cardinal Pier Francesco Ferrero Cardinal Carlo Borromeo Cardinal Innocenzo Ciocchi dal rdinal Ercole Context This volume contains a variety of minutes copies and other documents covering a broad range of subjects related to the period of Cosimo and Francesco de Medici Save Record Remove Filter 7 Refresh Unique ID 424 Volume Shelf Stage Researcher ID DONE Date Created General DOCID DATE folio 5303 SENDER PLAC NUM KEEN 8 11 1338 Description RECIP PLACE Record 14 1 gt gt i of 44 READY FOR VETTING Iv 3 1 2000 VETTER ASSIGNED MA z 5730 2006 VETTING DONE Correspondents RESID Created Status 8 11 1338 8 11 1938 8 11 1338 8 11 1338 8 11 1338 8 11 1338 8 11 1938 8 11 1338 DONE Iv 4 11 2008 Documents OK to Vet VetlD 11 25 2001 Iv 5 23 2006 Iv 2 22 2002 Iv 11 26 2001 Iv 11 26 2001 Iv 11 26 2001 Iv 5 19 2006 Iv 5 24 2006 Vetted H 9 1 2000 11 25 2001 kl Iv 6 9 2006 6 9 2006 pH 9 1 2000 1 1 2001 n PF 9 1 2000 1 1 2001 mp F 9 1 2000 11 26 2001 aE 9 1 2000 1 1 2001 IM Iv 6 9 2006 6 9
61. cular field or function Who am Advanced Search Search Documents Q Search Filter List olur PAZZINI F n resse INCA as HELP Search on Documents in Volume 170a remove And From Date yea Just select or in any search field and our selection will be automatically added to the Search Filter List in Extract alcuni libri arabi e caldei remove to Dat ear cix 4 For the fields From Date to Date in Extract and in And Synopsis you have to press the Add link to add them to the in Extract Search Filter List regarding Topics Books and Printing remove When you are finished adding your filters to match your And search criteria just press the button Search at the bottom right of the Search Filter List regarding Topics Coins and Medals remove Close j Add Image 46 Help System Example Advanced Search on Documents 5 3 The Developer Manual MAP is going to release the code produced as open source which therefore will be used and adapted for other purposes by other institutions and or individuals For this reason MAP must provide a detailed technical documentation The developer manual produced will consists in the Software s UML schemas Class Diagram Composite Structure Diagram Sequence Diagram and Activity Diagram as well as the APIs documentation MAP Development team while developing software code has been documenting each java class produced By using the Javadoc tool
62. cuments in LATIN language GERMAN Yes No Check box to signal presence of documents in GERMAN language FRENCH Yes No Check box to signal presence of documents in FRENCH language 64 OTHERLANG Text Text field to list presence of documents in additional languages not included in the check box option CIPHER Yes No To signal presence of documents in cipher CIPHERNOTES Text Text field for descriptive notes on documents in cipher E g Names and brief passages in code sometimes transcribed ORGNOTES Memo Volume organization E g 5 inserts of unbound documents pencil numbering in first four inserts insert 5 unnumbered contains various unsigned notes regarding Giovanna d Austria STAFFMEMO Memo Notes for additional research required for the volume summary E g Identify son of Isabella de Medici and Paolo Giordano Orsini born in 1572 tbIDocuments EntryId AutoNumber primaty key Unique identifying number for Volume Entries Summaryld Number extern key to tblVolumes Unique identifying number for Volume Summaries SubVol Text Letter extension for volume shelf number e g 11762 DELETE THIS FIELD IF MATCHES WITH VOLSUM FIELD ResId Text Researcher initials for entry creator DateCreated Date time Creation date of the record LastUpdate Date time Date Last Updated or Changed DocTobeVetted Yes Not Check b
63. d backups automatically back up the system but manual backups are also available The restore procedure is accessible from the web graphic interface but also an automated one from the operating system shell will be implemented in case of critical failure 81 8 1 4 Hardware and bandwidth upgrading Even though MAP considers this hardware configuration and the dedicated Internet bandwidth proportioned to the expected usage or wotkload of the web interface the application software and the operating system software that compose the new MAP system are structured to permit easy migration to a hardware configuration which provides a higher performance such as cluster or cloud solutions Moreover the web hosting company we are going to rely on granted us prompt access to a wider Internet bandwidth upon request 82
64. dification Document digitization e Upload digitized images to the database e Verify digitized documents e Write catalog descriptions System Administration e Manage users e Read system and user actions logs e Read database item review history e Backup and restore system data and users profiles User Groups These are the defined user groups Administrators On Site Fellows Senior Distance Fellows Distance Fellows Digitization Technicians Community Users Guests These are special roles which can be assigned to one or more users Distant Fellows Coordinator Community Coordinator Digitization Coordinator 2 44 Administrators The Administrators perform all the administration tasks Create delete modify users and user profiles Read system and user logs Read database items review histoty Backup and or restore data 2 4 2 On Site Fellows The On Site Fellows work from September to July four days a week six hours a day They begin by selecting one of the 6 429 volumes relevant to a particular topic or time period of special interest They contextualize the history and physical condition of the volume desctibe and appraise its codicological properties read and evaluate all the letters and other documents in the volume select those that appear most pertinent to the historical database transctibe the original text mostly in Italian but also in Latin Spanish French German and Hebrew decipher abbreviatio
65. dor Henry VII Valois Henry Il de r Search through the results PR CU Lus RI cC OEE New blank advanced search Print Selected Image 7c Advanced Search page search results sample As for the Basic Search an option for searching through the results is available 17 2 3 3 Item file Clicking on any of the results takes the user to the item file requested This can be a document a volume a bio or a place By clicking on the button turn editing on the Fellow enters the Data Entry module see 2 4 If the user belongs to a group to whom editing of an item is forbidden the turn editing on button is hidden DOCUMENT DETAILS TOPICS Docid 9915 Volume 1170a Insert Part Folio Start Paginated No Books and Printing City of London City of London England Modern Date 1577 Recorded Year 1577 a ee eee ore ee Date Note Undated document but inserted between documents dated 1577 CORRESPONDENTS PEOPLE Sender Tudor Henry VII From City of London City of London England Recipient Medici Francesco de To Firenze Firenze Toscan Ref Niccolini Agnolo di Matte EXTRACT SYNOPSIS sep V S adi fe i SASe t e Prego V S a degnarsi favorirmi con S A Ser ma et con A i Bn antl i n 1 i ia d i Vittorio Accorense Maronita asks Cioli to request permission Madama Sig a mia Ser ma di farmi gratia d imprestarmi from Grand Duke Cosimo Il and Grand Duchess Christine of operetle mie overo concedermi una stanza nel giardino
66. e Document Details Created by LK on 25 11 2009 DOCUMENT DETAILS Docid 9915 Volume j Paginated Insert Part Reckoning Unsure Folio Start Date Uncertain Modern Date month day Date Notes FACT CHECK NO open and edit CORRESPONDENTS PEOPLE edit Sender Person not selected From Place not selected Recipient Person not selected To Place not selected Ref Person not selected EXTRACT SYNOPSIS edit Extract Empty Extract AIA Image 10 the Edit Box After editing each section the user presses the Save button and automatically saves and exits the Edit Box allowing the user to edit another section These operations need to be done without the web page being refreshed as specified in the requirements documents Therefore to create and show the Edit Boxes the DWR API along with JQuery will be used see 6 1 1 and 6 1 5 20 2 4 1 DocBase sub module This is the data entry part that stores identifying and indexing information regarding the documents themselves Using this interface a scholar is able to transcribe a document record contextualizing it by linking it to people and locations Created by LK on 25 11 2009 DOCUMENT DETAILS edit Docid 9915 Volume 1170a Insert Part Folio Start Paginated No Modern Date 1577 Recorded Year 1577 Date Note Undated document but inserted between documents dated 1577 FACT CHEC
67. e 6253 Documents on 44 Topics Birth and Death Place Fills in automatically not editable 644 Birth 491 Death Senders and Recipients Filis in automatically not editable 4403 Senders 10904 Recipients Geographic Coordinates edit Latitude 435000N Longitude 0112000E External Links edit Wikipedia Florence Google Maps Florence Image 14 GeoBase editing turned on Each Place file has the following main fields Place Details Names ot Name Variants Topic List Birth and Death Place Senders and Recipients and External Links Place Details Place ID Place name Place type Place parent the TGN format field for example Firenze Firenze Toscana Italia means placerecord province region countty Name or Name Variants This is a list of the names the user can find in the documents when somebody is referring to this place 27 Topic List This is a not editable field It fills in automatically listing the number of topics assigned to in the place file If clicked it shows the list of the documents that refer to that place This is done using the split screen feature see 3 3 Birth and Death Place Birth Death This is a not editable field It fills in automatically and gives both the number of Bzrth place and Death place referred to in the place file When the user clicks one of these links he gets a list of persons who were born and or died in that place in the right screen This is done using t
68. e DETAILS edit CREATED BY KH 11 28 1996 Volume 1170a Tum editing off Carteggio dei Segretari Pier Francesco del Riccio Volume Filza MDP 1170a Start Date 1534 September 6 End Date 1573 April 2 Date Notes None prev lt Folio 2 gt next Description edit Mares Criteria A pat loose series includin terial relocated from the Miscellanea Medicea divided into 5 inserts of varying o l Ur Ml N ES are identi and sot 111834 to 1 oper 59 nsen STi 1547 to 1559 Tin T tn nar 1 11 422 44 Insert Ill 1545 to 1546 ff insert IV irregui ly dated 1543 1667 ff 501 Fag ff 73876 lost atachment 574 present no ff 645 689 lost Cond Good Bo id No Follos Numbered Yes 710 Alphabetical Index No E guages Italian La tan jome uments in Cipher No 7 Cipher Notes None j Volume Spine Correspondents edit 8000 00 From Tuscany and abroad Secretaries Agents Administrators Artists sta Including Lorenzo Pagni Cristiano Pagni Giovanni Francesco Lottini Niccol Cam npana EE Ferrini Agnolo Bronzino Bemardo Saliti Giorgio Dati Agnolo Dovizi da To Porence Pierfrancesco Riccio Context edit Notices on conflict between the Medici and the Appiano over rights to mining prev lt q Folio 2 gt next emi in Ur expulsion of the Dominicans from S Marco Piero Strozzi iombino pale Turkish Armada and Dragut civil unrest in Pitigliano inheritance sara li Accolti Cardinal of Ravenn
69. e DWR to create Javascript widgets for the auto complete text fields and the auto complete dropdown suggestion boxes 75 6 1 6 Google Maps integration To integrate the Google Maps in the GeoBase the official Google Maps API provided by Google Code will be used These APIs are released under the Google Maps Google Earth APIs terms of service 6 2 Database MAP s current online read only application http documents medici org is using as data source the Mysg 5 x This database is already up and running since April 2006 and did not have any kind of failure and or performance problems For these reasons MAP chose to continue using Mysg 5 x this will provide 90 of the database structure ready to be used for the new system To migrate the data from Microsoft Access to Mysql MAP now uses some Per based sctipts which will need some minor changes to be used with the new system These will be used to populate the database with data for the testing phase and also for the final transition from the old system to the new one 6 3 Software Project Management and development tools The open source software project management tool Apache Maven will be used to manage the development of the software It allows developers in a team working environment to deal easily with code compiling and distribution The Edipse IDE will be used in conjunction with the above mentioned Apache Maven for building and testing the web application 6 4 Applicati
70. e able to concatenate those search strings to get the best results 6 Printing functionality mslide 7 FELLOWS The button for printing documents is very difficult to use and it is a waste of time LORENZO ALLORI Yes the printing feature will be implemented in a completely different way You will have a button for printing the document volume bio or place page and also a printing feature will be implemented on the search page making it able to print only the selected documents in a reliable way Minutes of Meeting 1 Current System Slides READY FOR VETTING VETTER ASSIGNED DONE Doc ID 73 Vol Shelf 2 xL ree v2 TT Vol DETAIL Volume Shelf tt Res ID FN 1 SENDER Uns ID i Insert or Part No Unpaginated Name O 203 Folio Start No 24 Disc Cont d OD Place a Sender Notes Year Month Day Mod Year Reckoning z i 1537 September 13 O RECIPIENT Uns ID Date Uncertain or Approximate Undated O Name L1 205 Sortable Date 1537 09 13 Aie Pi faid to sant be Aul data Place Date Notes The dating seems to be an abbreviation for Recipient Notes settembre though a readina of aiuano is not Volume Info Fact Check Save Record SYNOPSIS Add New GRIDS Li drappi present te la 3 S ata is to present gifts from Document AVE Cosimo to Nicolas de Granvelle textiles and Bod 1 ecora Extract at l altra a Granvella Nico
71. e and time This 1s a recotd of the date and time when the log occurs 2 2 1 2 Full name This is the full name of the user who performs the logged action 2 2 1 3 Action This is the action that a user performs logging in delete modify add new record etc 2 2 1 4 Information This field concerns where the user performed the action the module or the sub module that the user was involved in If modifying deleting or creating a record the record ID is shown If the log concerns the deletion of any volume bio document or place a link to the last revision see 2 2 2 of that document is available For a detailed description of the User Actions database table see 4 3 1 13 2 2 2 Revisions This sub module records any previous version of each volume document bio or place present in the database creating a history of revisions Every time that a user modifies or deletes a record a copy of the previous version of the recotd is registered in the database see 4 3 2 Each document bio volume or location page if accessed by a member of the Administrators user group has a history of revisions link which can be clicked to see that item s list of revisions A tool to browse the revisions can be used by Administrators group users through the Administration interface see 3 2 3 User Management Reports and Revisions System Management Created by LK on 25 11 2009 py see histo of revisions DOCUMENT DETAILS edit
72. ect Scholarly Community A Welcome Page welcomes a user login n gm i THE MEDICI ARCHIVE PROJECT Who am Lisa Kaborycha On site Fd gt MAP Courses al e Take a look to the courses we are currently Wo teaching click here Welcome back Lisa From your last log on you have 23 new messages 1 new digitized volume has been uploaded 12 new documents have been entered 31 documents have been vetted 15 new people have been entered 5 new places and or locations have been entered Image 15 the Welcome Page From the Welcome Page the user can access every part of the system using the Main Menu see 3 2 or can click on any of the From your last logon links This page displays a link to the MAP teaching platform http courses medici org in order to inform Community Users of our current curriculum offerings We expect to recruit many interested and qualified future online scholars through this channel The Community module consists in three sub modules Comments Profiles Personal Messages 29 2 5 1 Comments Each database item volume document bio ot place can be commented on using a special section on the page called View Comments Add Comments see image below Community users can comment on either vetted or non vetted documents Comments made prior to vetting will be distinguished from the post vetting comments and will show the pre vetting label The Community Coordinato
73. ee eee ee eee tenente E ESETE EErEE SENEN EES 72 Bil The Uset Manual T A 72 5 2 The embedded Help System ccccsscsssscesssscsssscsseceseecesseceseeeeseecesesceseesesseeessesesseecssesceseesees 73 5 3 The Developet Puri i aiias 73 6 ARCHITECTURAL STRATEGIES eese eene ses EE eE EEEn NEEESE NEEESE NEEE eine 74 6 1 Frameworks ir sna Enen ee eNe E Een ze zizi cenere reze zizi ci esee rire eee nici ceci rie ze zizi ceci rire ze zizi esee cirie zizi zi TESEN 6 1 1 Spring NLVOS lalla alal 6 1 2 Security and Authentication 6 3 3 Data Model sss 6 1 4 System Logs xx ihe zs s T nn x 6 1 5 Graphics tesa eet etsi bte csetera te e 6 2 6 3 6 4 6 5 6 6 74 7 2 7 3 8 8 1 6 1 6 Goosle Maps ntegratiODs snc Ie Cate I a E Rte ye Da TAL aaa ae 76 BEIDE 76 Software Project Management and development tools eese 76 Application Server cre rrrrrererreeeeee st ESE zizi cirie zine rie e zine re zizi nine nici nine nici nie ESEE SEE aS esai 76 Bueg ttackinp i u C M 76 Server side scripting lesse esee 77 APPLICATION ENVIRONMENTS ccccccsssscsssscessseesssecsseeceseeceseeeeseeecsseeceseesesseeeseesesseeseseeoess 78 The Development Environment cccccccssssscssssescessscesesssscssessesesseseecesssseessesssessssseeessessesessoes 78 The Testing Environmetit A ta
74. eil brun nd tenuta satu bs e mtd 21 6 OTHER REOUIREMEN TS ii roii ei ats euis FM ve ni quie 22 6 1 Data tnigtatlOI pra YR A M ean YER UR lenin aphasia yaaa 22 1 Introduction 1 1 Purpose The Medici Archive Project s mission is to bring the unparalleled resources of the Medici Granducal Archive for the Arts and Humanities to a broad international public for the first time by way of the latest information technology Therefore after eleven years the Medici Archive Project hereafter referred to as MAP needs to develop more efficient and productive software system using up to date technologies giving the research Fellows the possibility to perform many new tasks This document contains the outline of the first phase of the software planning 1 2 Intended Audience This document contains the software s functional and non functional requirements It is intended to be read by the MAP Staff Project Managers and Software Developers Chapter 2 gives a general description of the system It is intended to be read by the MAP staff Chapter 3 contains analysis of both functional and non functional requirements in full detail This chapter will be evaluated by the MAP staff and by the Software Architects It will be used in order to create the Top Level System Design Document in the second phase of the software planning 1 3 Project Scope The new system will offer more functions than the current one making the work of the Fellows incre
75. enance operations and checks the logs Updates and bug fixings are done by logging directly onto the server through SSH Community Users access the system using the web browser They view all content and all digitized images They can comment on each database item document bio volume ot place and read the other users comments They can also send personal messages to the other community members and receive answers The entire system resides on two servers For servers deployment details see section 8 1 40 3 User Interface Design 3 1 Usabililty MAP would like to preserve the usability of the current interface associating to each of the four data entry sections to four different colors the DocBase see 2 4 1 is identified by a brown navigation bar DOCUMENT DETAILS TOPICS the PeopleBase see 2 4 3 has a violet navigation bar You searched PEOPLE for Henry VII Who am I Lisa Kaborycha On site Fellow Person Details edit CREATED BY KH 11 28 1996 edit Document List People Tudor Henry VIII IR Dci imantel the VolBase see 2 4 2 has a yellow navigation bar Who am I Lisa Kaborycha On site Fellow Volume DETAILS edit CREATED BY KH 11 28 1996 Flip Trough Volume 1170a uim wd the GeoBase see 2 4 4 has a green navigation bar Who am I Lisa Kaborycha On site Fellow PLACE DETAILS edit Turn aditina aff Image 22 a b c d NavBars 41 3 2 The Main Menu The Main Menu i
76. ent that matches one of MAP s forty four topics Who am Lisa Kaborycha On site Fellow DIGITIZED DOCUMENT Fullscreen Zooming Utility prev E Folio 2 recto P next 000000 This document is NOT indexed in the sale an ED database Image 19 Manuscript Viewer Full screen mageMagick is an open source and free software suite to convert and write images in a variety of formats including TIFF 38 The two violet atrows at the top of the document allow the user to flip through the document pages The button at bottom right allows the user to create a new document record if the document is not already present in the database If it is the button will have the Show me this Document label instead of Create an Entry 2 8 1 2 Half size The half size format is used to show the user a portion of the manuscript while reading transcriptions and of the document or the volume details see Image 10 and Image 11 in section 2 4 1 and 2 4 2 It is also used to transcribe the document Who am Lisa Kaborycha Distant Fello Oc EXTRACT b f ilias DOCUMENT Reuerendo padre fra Tommaso io be pregho e contento om ry marca P la dedere cuodere ay Eto pi indugiata pi somma saranno et in vero non ui mA icha perch si fomir pi presto che sono quasi tutte fra mano e si spediranno tutte le cose che si appartenghono a fare a me ne ui pensate che facci cose superfrue ma si tutte necessarie e come u
77. ers belonging to this group are able to use the Data Entry Module see 2 4 and have the permission to correct and vet other documents entered by On Site and Distance Fellows They are part of the Scholarly Community and have also access to all the other modules with the exception of the Digitization Module see 2 7 and the Administration Module see 2 6 The On Site Fellows can be assigned or flagged as Distance Fellows Coordinator or Community Coordinator or Digitization Coordinator see 2 1 1 8 2 1 1 3 Senior Distance Fellows Users belonging to this group are experienced scholars who have been trained by the On Site Fellows on how to use the system They are able to use the Data Entry Module see 2 4 and have the permission to correct and vet other documents entered by Distance Fellows They are part of the scholarly Community and also have access to all the other modules with the exception of the Digitization Module see 2 7 and the Administration Module see 2 6 The Senior Distance Fellows can be assigned or flagged as Distance Fellows Coordinators and or Community Coordinators see 2 1 1 8 2 1 1 4 Distance Fellows Users belonging to this group are able to use the Data Entry Module see 2 4 Unlike the On Site Fellows or the Senior Distance Fellows Distance Fellows are able to enter data but not to vet any document or volume or delete any content except for their own entries They are part of the scholarly Comm
78. esired items 2 3 1 Basic Search The basic search is performed through the Main Menu see 3 2 1 and permits a word seatch on volumes documents people locations and Community comments see 2 5 1 The results are displayed in a list see Image 77 It is also possible to search through the results obtained from a basic search but only using the Advanced Search format 2 3 2 Advanced Search The Advanced Search tool permits a fully customizable and accurate search to be performed on the four different items present in the database Each item has different attributes thus four different search masks are present Search Documents Search Volumes Search Locations and Search People In addition an option to search through Community comments is present see 2 5 1 and Image 28 at 3 2 1 4 After choosing what to search the user can create a set of filters combining and concatenating any type of content Advanced Search Search Documents Search Filter List 2 Word Search 9 Add bos Volume e sj From Date 8 sj Add to Date z Add in Extract 9 in Synopsis 9 Sender e E From z Recipie To ecipient o X X Search Locations Search People Search Volumes Image 7a Advanced Search page sample 15 On the left part of your screen you create the filters by using the add buttons on the right side you can customize ot remove some filters Advanced Search Search Documents
79. ext TGN Field indicates records displaying ISO and other international codes as placename GEOGKEY CHILDREN Memo Comma sepatated list of all of the subregions of the current row populated via UTL migration script 69 4 5 New database tables The development team is going to create new database tables to accomplish the following functions user action tracking see 2 2 1 revision of the database items see 2 2 2 community comments see 2 5 1 personal messages see 2 5 3 digitized manuscripts see 2T 4 3 1 User action tracking tblActions Field Type Description Timestamp Date time automatic Date and time of creation Ip Varchar Ip address of the user UserID Numeric Extern Key Type Text Type of information Action Descr Text Description of information depending on the user action The Chronology dropdown menu see 3 2 1 5 and the Shortcut Menu see 3 2 1 9 are created getting the data from this table 4 3 2 Database Items revisions Four new tables are created Rdocuments tb Rvolumes tblRpeople tb Rplaces with the same structure of the Zb Documents tb Volumes tblPeople and tblPlaces see 4 2 but with three additional fields realiD that is the current record timestamp the timestamp of the item revision ID user a key or a username that identifies the person that modified that record For example a new record in the 0 Rwvolumes with rea ID set as 1171a izes
80. fresh ID 113 Aachen Hans von Parents Children Spouses Roles Occs NameT ype PersoniD 113 Person Record Given Family 113 Parents amp Appellative Children Given Remove Filter 7 SearchName Refresh E E E EIE Biblio Record 4 1 DI rx of 5 P In Rome by 1575 worked in Florence as a portraitist passed through See Thomas DaCosta Kaufmann Drawings from the Holy Roman E U Venice during return trip to Bavaria in 1587 mpire 1540 1680 Princeton 1982 ID 113 Aachen Hans von Parents Father Assign Father Aut Vital Stats uo BirthYear Month Day ActiveStart Approx Parents amp DeathYear Month Day Active End Approx Children Father BioNotes Titles Occs Father Staff Notes Documents finie P In Rome by 1575 worked in Florence as a portraitist passed through Venice during return trip to Bavaria in 1587 BirthYear Month Day ActiveStart Approx ES DeathYear Month Day Active End Approx Mother BioNotes Mother Staff Notes See Thomas DaCosta Kaufmann Drawings from the Holy Roman Empire 1540 1680 Princeton 1982 Add Person Record Hemove Filter 7 Refresh ID 113 Aachen Hans von Vital Stats Names Parents Children Spouses Roles Occs Docs Biblio Children Assign Child Ss Add IDit Child s Name Died Age at Death AutoNu Person hod Record Vital Stats Parents amp Children Remove Filter 7 Refres
81. ge would be stored in a separate database to keep track of each user s work This will also be useful for backup purposes MARCELLO BOTRUGNO What about multiple users editing the same document If two users are modifying the same recotds we could potentially have multiple errors and duplicated fields in the database LORENZO ALLORI One solution to this is blocking record locking a document from being edited by more than a single user at a time MARCELLO BOTRUGNO To record the revisions we will create new tables in the database and store this information there The new tables will have the same record fields of each of the different sections of the database DocBase PeopleBase Volbase GeoBase 2 2 How to read logs LORENZO ALLORI To read these logs a web interface is needed MARCELLO BOTRUGNO My recommendation is that the logs as well as the revision history should be visible to the system administrators only 3 Study on the requirements for the history log module reporting interface LORENZO ALLORI Two different interfaces will be needed to read these logs one displaying per user logs ip addresses and actions and the other for viewing prior revisions of the documents MARCELLO BOTRUGNO These two interfaces will be integrated inside our web based application and accessible only to the system administratots LORENZO ALLORI The fields in the per user logging report should be Software s part used DocBase PeopleBase V
82. h Hence a Florentine document dated 24 March 1544 is dated according to modern calendar to 24 Match 1545 RECKONING Yes Not Check Box to signal that the researcher considers the calendar in use is uncertain UNDATED Yes Not Check Box to signal undated documents DATEUNS Yes No Check Box to signal that the document date is uncertain for any reason including illegibility physical loss etc DATEAPPROX Text Text field to insert researcher s estimate of approximate date assessed from document context DATENOTES Text Text field for notes concerning document date E g 1550 noted on back of letter in second hand probably Riccio s SENDID Number Sender s Name Link containing PERSONID number to link to PEOPLELIST table SENDUNS Yes No Check Box to signal Sender s Name is uncertain for any reason including illegibility physical loss name identification SENDLOCPLALL Number Sender Location ID linked to unique ID in GETTYPLACES SENDLOCUNS Yes No Check Box to signal Sender s Place is uncertain for any reason including illegibility physical loss place identification SENDNOTES Text Text field for notes modifying or qualifying Sender s Name or Location E g Giorgino Pittore Roma or A Niccolini Ambasciatore a Roma RECIPID Number Recipient s Name Link containing PERSONID number to link to PEOPLELIST table RECIPUNS
83. h Titles Occs Biblio m Record 14 1 KACI of 1 P In Rome by 1575 worked in Florence as a portraitist passed through S See Thomas DaCosta Kaufmann Drawings from the Holy Roman U Venice during return trip to Bavaria in 1587 T Empire 1540 1680 Princeton 1982 ID 113 Aachen Hans von First Name Vital Stats Names Parents Children Spouses Roles Occs Docs Spouses Assign S p pa Vital Stats MarlDit Spouse StartYr End Reason Marriage Notes Parents amp Children Filter 7 Refresh Titles Occs Biblio m Record 14 1 bl of l Spouses Remove I P In Rome by 1575 worked in Florence as a portraitist passed through S See Thomas DaCosta Kaufmann Drawings from the Holy Roman U Venice during return trip to Bavaria in 1587 Empire 1519 tea n 199 Internal Staff Motes ID 113 Aachen Hans von Vital Stats Names Biblio Titles Occupations Start Refresh Pulldown Lists P Year Month Day Approx Uns Y Printmaker Bo Pittore Pittrice Bn O O Parents amp Children gl Ar Titles Occs Record 4 1 gt bl gt gt of 2 P In Rome by 1575 worked in Florence as a portraitist passed through S See Thomas DaCosta Kaufmann Drawings from the Holy Roman Venice during return trip to Bavaria in 1587 T Empire 1540 1680 Princeton 1982 Add Remove Filter Refresh ID 113 Aachen Hans von First Name Vital Stats Names Parents Children
84. he split screen feature see 3 3 Senders and Recipients Senders Recipients This is a not editable field It fills in automatically and gives both the number of Senders and Recipients referred to in the place file When the user clicks one of these links a list of documents sent from or sent to that place appears in the right screen This is done using the split screen feature see 3 3 Both document links are clickable as well as senders and recipients so the user can select a document file or a bio file Geographic Coordinates Latitude Longitude These are used to create the Google Map that shows up in right screen If the place is registered in the TGN the geographic coordinates are automatically given Otherwise the Fellow has to find and enter them manually External Links This is a list of links to external sites It should include a link to show the place on Google Maps and can include a Wikipedia page as well as other useful links that the Fellows will attach Right Screen default The default right screen displays the place record on Google Maps This is obtained using the Google Maps APIs see 6 7 The database table tblPlaces will contain a new field for the geographic coordinates of the place record from which the Google Maps APIs will create the appropriate Google Map see 4 3 6 28 2 Community Module Each user of the system excluding the Guest user group see 2 1 1 7 is part of The Medici Archive Proj
85. i ho pi uolte detto ui anno a essere tutti contanti di poi lascer fare a uoi altri il resto cio il maritar a che addio piaccia sia presto se per lo meglio accio si il Ra m dps mm st speso come eee non possendo mandari tut hora e gt quei potrete IU acdecdore d p 4127 T di 7 di marzo 1562 Mire HM u pain fatiha ph T formia pi s che sam to tutte fra mano v spediamo le com Ks n affare am neu mA faf de e M ia qui amo on tat ee Jr por yis aur air verfo dhe rf marr n he Mo Wa tH m se poe medi aan yt aus uo di Spesa emi dh persiera ot and il conto DU tratto gula se speso come wed e n postino mandari tuit fra o n id Gatta see it in full screen show manuscript on the right side x1 Close x b Image 20 Manuscript Viewer Half size 39 2 9 Deployment Diagram ey Administrator On site Fellows i F F iB System e o7 aum ai Testing Server AAA A DA A nmm lesi Firewall mara cm I ite Digitization Distance Fellows Image 21 Deployment Diagram Both On Site and Distance Fellows use a web browser to enter the data into the system During their wotk they perform frequent database queries and they can access the digitized documents and volumes The Digitization Technician digitizes documents on his workstation and then uploads them to the server using the Digitalization web interface see 3 2 4 The System Administrator does basic maint
86. ifications will be investigated in the System Design Phase Phase 2 19 5 Other Nonfunctional Requirements 5 1 Performance Requirements The response time i e the time a system or functional unit takes to react to a given input of the new system will be faster than current software The response time of the web application used to view the digitized documents must be reasonable in order to provide fast and reliable access to the digitized manuscripts 5 2 Security Requirements The data will be protected from web attacks Read only access to the system is open and free meaning that everyone can access it from the Internet To see digitized documents or to participate in the community discussions a user must register to get a username and password The write access to the database is permitted only to these user groups Administrators On Site Fellows Senior Distant Fellows and Distant Fellows 20 5 3 Software Quality Attributes 5 3 1 Usability The entry data interface will be usable and accessible to Fellows This means that all the tasks the Fellows perform will be executed as fast as possible using the fewest possible mouse clicks Response time of the search tasks performed by Fellows and Community users will be reduced to a minimum The possibility of refining search results is necessary 5 3 2 Cross platform compatibility The system must be compatible with Apple Microsoft and Linux operating systems
87. imo to Nicolas de Granvelle textiles and to Francisco de los Cobos y Molina textiles and an unspecified statue Delete This Doc Record READY FOR VETTING VETTER ASSIGNED DONE Doc IDE 73 Vol Shelf 2 2 13 2002 EG 5 8 2003 5 8 2003 DETAIL Volume Shelf tt ID SENDER Uns ID Insert or Part No Unpaginated Name Medici Cosimo de Folio Start No Disc Cont d O Place Firenze Firenze Toscana Italia Sender Notes Year _Month Day Mod Year Reckoning 1537 September 13 O Date Uncertain or Approximate Undated O RECIPIENT Uns ID Name Serristori Averardo di Antonio a o 205 Place Espana Europe World Top of the TGN hiera 41 834 Sortable Date 1537 09 13 Exe ys Sat feo sont de al datet Date Notes The dating seems to be an abbreviation for Recipient Notes All ambasciatore Averardo Serristori in Spagna settembre though a reading of aiuano is not Volume Info Fact Check Save Add New Document 251 Cobos y Molina Francisco de los I Record S 203 Medici Cosimo de 250 Perrenot de Granvelle Nicolas Remove R 205 Serristori Averardo di Antonio I Gioni Refresh Record 14 11 gt I gt of 4 READY FOR VETTING VETTER ASSIGNED DONE Doc ID 7 Vol Shelf 2 2 13 2002 EG fee 5 8 2003 DETAIL Volume Shelf it Res i0 FN SENDER Uns
88. ina de m 1536 Boleyn Anne m 1536 b 1507 d 1536 Seymour Jane m gt d 1537 Cl ves Anne de m Howard Catherine m 1521 d 1542 Parr Catherine m 1542 7 b 1512 d 1548 Children Tudor Mary b 1516 d 1558 udor Elizabeth b 1533 d 1603 udor Edward VI b 1537 October 12 d 1553 July 6 Image 39 People suggestion box with split screened PeopleBase At this point the user is able to see the information related to that person and see if it is the one she was looking for This feature works for people volumes and places dropdown suggestion boxes 56 The same feature applies to the topic selection NAMES CORRESPONDENTS PEOPLE ait I Given Henry Sender Tudor Henry VII From City of London City of London England Family Tudor Recipient Medici Francesco de To Firenze Firenze Toscan Ref Niccolini Agnolo di Matte TITLES OCCUPAT Lei ing of England HEAD TOPICS Topic Topic Piace Caterina de p 153t tion nico V Academies 1536 b 150 a ope Animals Exotic and Unusual n our ER 153 a a tas Antiquities and Antiquarianism d tal a ent Cl ves Anne de Empty S Archives Spread documen m Sit Arms and Armor Howard Catherine Art Collecting Parr Catherine Art Literature m 1542 7 b 1512 d TOPIC Avvisi 2 Children Books and Printing Carriages Ceramics Coins and Medals Costumes and Dress Devotional Objects Drawings Food and
89. is the functionalities of the current software must be translated and adapted in order to comply with those of a web based system 2 2 Modular Design The structure of the new system will be modular This means that the software is divided into several modules which fulfill different functional tasks The access to the new system will be carried out through an authentication phase a user can access certain parts of the application based on his group credentials An Authentication module regulates this process A History Log module which tracks the users actions in the system will be connected to the Authentication module The Data Entry module is defined by the part of the system where the documents accompanied by digitized images historic people and historic places are stored The Fellows will be able to read create and modify data the scholarly community will only be able to read the documents and not to modify or create them The documents module is divided into four sections Vo Base contains the digitized volumes of the Medici Granducal Archival Collection DocBase stores identifying and indexing information regarding the documents PeopleBase stores biographical information regarding the individuals and corporate bodies whose names appear in the DocBase GeoBase contains the hierarchy of places used in the DocBase from continents and nations down to individual buildings institutions and sites The Community mod
90. ized Volume Filza Edit catalog descritpions Browse digitized Volume Filza Search digitized Volume Filza Image 30 Digitization menu This is the dropdown structure of the menu Create new digitized volume filza Edit digitized volume filza Browse digitized volumes filze Search for volume filza Create new volume filza allows the user to compile a new catalog description of the volume and then to upload the digitized images to the system Edit volume filza allows the user to edit a previous catalog description and or allows uploading of a different set of images for that volume Browse volumes filze allows the user to look at a list of digitized volumes Search for volume filza allows the user to perform a search through digitized volumes 46 3 2 4 1 Catalog descriptions This menu helps the Digitization Technician to find and download the catalog description to be handed to the State Archive officials This is the dropdown structure of the menu Browse catalog descriptions Edit catalog descriptions Browse catalog descriptions allows the user to get a list of the catalog description of each volume and lets them download a pdf version of each catalog description Edit catalog descriptions allows the user to search and edit a catalog description without needing to use the Edit digitized volumes filza page To see the fields listed in any catalog description see the document Minutes of Meeting 3 Catalog Descrip
91. l be configured for a high availability using Tomcat s 6 cluster capabilities A watchdog like component is included in software architecture this will act as a real time monitor for the software In case of system malfunction the request will be forwarded to the other Tomcat instance so that the user will not lose requests and or sessions Administrators will be notified of any system malfunction by the watchdog 8 1 2 Database Mysql configuration As regards the database when one Mysql instance fails the service must be provided through another route Therefore we will need process redundancy To gain this we will install and configure Mysql on both servers building an Active Standby Mysql configuration Only one Mysql instance will be active and when a failure is detected the standby instance will be made active 80 ue C ey I Standby MySQL Replication Active MySQL Primary server Standby server Image 48 Active Standby Mysql configuration The two instances will be synchronized using scheduled time These times will be scheduled duting the part of the day in which there is less workload this will be determined and adjusted using the system statistics capabilities When the standby instance is activated an additional synchronization process is started Backup and Restore Procedures Backups are managed through the system Administrative Interface see 2 6 3 Schedule
92. ll of these fields are editable except for Group which is assigned by the Authentication module see 2 1 While accessing another profile page a user can send a personal message to the uset to whom the profile belongs see 2 5 3 Vno am John Smith Com User Profile Help System i User Manual HTML version John Smith Download Manual PDF version Help Videos Group Community User EE Title Curator edit NO Organization Naples Museum of Art edit IMAGE Location italy Florence edit MAP Courses ui cha Interests s Salvador Rosa ecc edit f Jj currently teaching Resume no add modify resume Click here Image 16d Profile Page with the Help system and the MAP Courses link Aside from the user s profile itself in this page it is possible to access MAP s online teaching platform under the section MAP Courses and the online manuals see 5 1 All the profile data is stored in OpenLDAP see 6 1 2 32 2 5 3 Community Messaging System 2 5 3 1 Personal Messages Each user has his own inbox where he receives personal messages and can reply to those he is interested in Who am My messenger Send new PM Inbox Contact List Total Messages 8 in all foders 0 of total capacity Edit Folders Message Title Sender Date Mark as read Move Delete Go to Inbox v RE how to search for Alessandro de Medici Alessio Assonitis add to contacts 02 14 2010 n Backup Messages Edit Sign
93. mpty Image 34 Entering the edit Extract Synopsis section 51 The Transcription window is divided into two parts on your left side the manuscript viewer is shown and on the right side the Fellow can enter data in the Extract The Fellow is able to put the Manusctipt viewer on the right side and the extract page on the other side by clicking the show manuscript on right side link Who am Lisa Kaborycha Distant Fello occ EXTRACT N paula DOCUMENT Reuerendo padre fra Tommaso io ui pregho siate contento A cain N acad Aij a chiedere duedere Ac Pio pi i e pid somma Saranno et in vero non ul ri icha perch si fomir pi presto che sono quasi tutte fra mano e si spediranno tutte le cose che si appa a fare a me ne ui pensate che facci cose superfrue ma si tutte necessarie e come ui ho pi uolte detto ui anno a essere tutti contanti di poi lascer fare a uoi altri il resto cio il maritaria che addio piaccia sia presto se lo meglio accio si gt p y DL 2 IA ase MR Frane oa Me qo O e rd Li 227 pa o mero paia fatiha pei Jormra pra i e de Ex ta fu ne ke ae O Lam he gi appart ry hone afare ame ne a 9 AE TT ma s fae wecuane o e il di 7 di marzo 1562 du amo ahere tath comm dr por amp suoi altr I refe en marcata che ue PERI rm se c 4 jo media aan a cul uot X spesa me di persiera pr mm il conto Nta guela fe peso come Hedret e n postero mandari tudin fra n me po
94. nia 78 The Production Environment eese eene enne nnne nnne nnne entente tens nennen nenne 79 SERVER SYSTEM 80 Servers deploy Merits ivi 05 ccc ivis 80 8 1 1 Servlet container Tomcat configuration wee csescessesseseeseeseesessessessessessessesessessessessssessesseesssstssesseesssessesens 80 83 2 Database Mysql configuration uen ee nti aa 8 1 3 Backup and Restore Procedures 8 1 8 Hardware and bandwidth upgrading 1 Introduction 11 Purpose This document contains the complete description of the Medici Archive Project s hereafter referred to as MAP Software System Redesign The primary audience of this document 1s the Software Developers NB This document will be used by the Development Team hereafter referred to as DT as a guideline but it is requested that all members of the DT take an active part in the implementation choices By active part we mean that eventual problems that have not been investigated during the planning phase will be analyzed afterwards along with the Software Architect s contribution 1 2 Architectural Design When developing data centric applications the most common approach is to divide the software system into three different application layers Each layer performs specific tasks In turn it asks the other two layers to perform different tasks These three layers are organized hierarchically as follows
95. ns and make sense of linguistic impasses such as lacunae misspellings deteriorated text ciphered words and coded expressions Finally they write a succinct yet exhaustive synopsis of the specific documentary extract synthesizing factual information evaluating the plausibility of statements made in the document and proposing solutions to the meaning of the document and its relation to wider historical contexts Their ability to synthesize historical information as well as their uniquely privileged contact with the actual documents authorizes them to check and review or vet the data entered by other users For performing special actions the On Site Fellows will be assigned or flagged as Distance Fellows Coordinators Community Coordinators and or Digitization Coordinators see 2 4 8 2 4 3 Senior Distance Fellows The Senior Distance Fellows will work off site on previously digitized and uploaded documents The users that belong to this category are allowed to create and modify any of their own entries on documents additionally they will be able to vet the Distance Fellows work 2 4 4 Distance Fellows The Distance Fellows will work off site on previously digitized and uploaded documents The users that belong to this category are allowed to create and modify and delete any of their own entries on documents volumes bios or places however a Distance Fellow cannot delete or vet any other type of content The Research Directo
96. ntry VolBase DocBase PeopleBase GeoBase Digitization Administration Community Comments Profiles Personal Messages User Management Report View System Manager stop start services Search Basic Search Advanced Search Manuscript Viewer Zoom in out Flip Through History Log Revisions User Actions Image 2 System Modules and Sub modules Some modules have sub modules such as the Administration module which is divided into User Management Report View and System Manager The next sections describe each module and its sub modules in detail 2 1 Authentication Module This module recognizes the user and gives him the authorization to use one or more software modules based on the credentials of his users group 2 1 1 User Groups The defined user groups are Administrators On Site Fellows Senior Distance Fellows Distance Fellows Digitization Technicians Community users and Guests Some special role users are also present Distance Fellow Cootdinator Community Coordinator and Digitization Coordinator For a detailed description of the each user group see the 2 4 section of Appendix A Phase1_TLSRL pdf Top Level System Requirements Document 2 1 1 1 Administrators Users belonging to this group are able to use all the Administration Module s sub modules User Management Reports and Revisions and System Management see 2 6 2 1 1 2 On Site Fellows Us
97. ocument e Record Date Notes J From Context Jacopo Dani Lorenzo Pagni Cristiano Pagni Vincenzo Provisions for fortifications armour being produced in Brescia Ferrini Luca Martini Giovan Francesco Lottini Mariotto by Pietra Gandino Don Diego Hurtado de Mendoza Cecchi Girolamo Marinozzi Francesco Buonanni Lelio Torelli disarming Siena Entry of Prince Felipe d Austria in Genoa Jacopo de Medici Jacopo Guidi Food and wine clothing and furniture provisions for court Remove while staying in Poggio a Caiano Pisa Livorno and Genoa Filter f Yolume Info Activity movements and health of the Duke the Duchess Refresh i and the other members of the court o Fact Check Fier Francesco Riccio Florence Delete Internal Hemo This Doc AD Ins 4 38 Notarized document in Latin Record Minutes of Meeting 2 MAP Software Redesign Digitization process requirements 10 13 2009 Participants Staff Lorenzo Allori Technology Director Alessio Assonitis Research Director Steps 1 Introduction 2 Document digitization process analysis 3 Study of the requirements for the Manuscript Viewer 1 Introduction LORENZO ALLORI The goal of this meeting is to Identify which volumes f ze will be digitized who will be involved in the process and how the work will be accomplished Identify the features needed in the web based program for viewing the digitized manuscripts Manuscript Viewer 2 Analysis of
98. olBase GeoBase or other module Time when the action has been performed Ip address User s Full Name Action performed It will be possible to search combining each of these fields to get detailed logs the Administrators might need MARCELLO BOTRUGNO In the revisions interface it will be possible to search the revisions by doc id people id volume id and place id as well as the deleted records LORENZO ALLORI Additionally a button for viewing the old versions of record should be present on each document people volume and place page Only Administrators will be able to use this feature APPENDIX B Top Level Software Design Document Last Edited March 23 2010 Lorenzo Allori and Marcello Botrugno IMEEM EP 5 1 2 Architectural Design en eterne ete aod erepto e Lee odo eene uad een deae to ee aequa ap etude pepe E EE 5 13 References EET DTE LIII T m 6 L4 Overviewofthe Document iere ali NA EEE 6 2 SOFTWARE MODULES DESIGN cccsssssccccssceccsssccesssccccncsccececscceecsccsesecceeuesececessceseueses 8 2 1 Authentication Module 24 1 2 1 2 2 1 3 2 2 2 2 1 2 2 2 2 3 2 3 1 2 3 2 Li did 24 2 4 1 2 4 2 2 4 3 2 4 4 2 5 2 5 1 2 5 2 2 5 2 6 2 6 1 2 6 2 2 6 3 2 7 2 7 1 2 7 2 2 8 2 8 1 2 9 History Log Module rrrrrrrrrrrrereeeee nere ze eene nennen nnne eeN SN E aa ea 13 Community Module Administration Module U
99. on Server Even if it is MAP s intention to use Tomcat which is a servlet container if the development team starts from the beginning to follow the JEE specifications this will permit MAP to easily migrate to the use of JBoss in the future if needed 6 5 Bug tracking For the testing phase and also when in production MAP and the test users will use the Bugzilla bug tracking system This system will help to keep track of new bugs in the development this will be used also to avoid using emails to receive bugs notifications 76 6 6 Server side scripting Bash scripting will be used for both backup purposes and to prepare the digitized images for the use with IIPImage Manuscript Viewer 77 7 Application Environments 7 1 The Development Environment The Development Environment consists in the platform where the Java developers and the Web Graphic Designer work The two Java developers have a Microsoft Windows or Linux based laptop depending on their preference with these services installed Apache Tomcat 6 0 x Mysql Client Jsdk 1 6 Eclipse IDE for Java EE Developers The Web Graphic Designer has a Microsoft Windows based laptop with these services installed Apache Tomcat 6 0 x Mysql Client Jsdk 1 6 Eclipse IDE for Java EE Developers Photoshop or Macromedia Studio depending on the Web Graphic Designet s preference 7 2 The Testing Environment The Testing Environment resides on one
100. on each comment posted LORENZO ALLORI They will be notified via email or through the personal messaging section the system will provide This matter will be studied during Phase 2 Minutes of Meeting 5 MAP Software Redesign Phase 1 3 History Log module requirements 03 11 2009 Participants Staff Lorenzo Allori Technology Director Marcello Botrugno Software Architect Steps 1 Introduction to the History Log module 2 Study of the requirements for the History Log module 3 Study of the requirements for the History Log module reporting interface 1 Introduction to the history log module LORENZO ALLORI The goal of this meeting is to identify the requirements for the History Log module This module will be used to track each user s work as well as the documents revisions 2 Study on the requirements for the history log module 2 1 What to log LORENZO ALLORI We have to define what we should record in detail On to per user logging it is important to collect the Ip addresses and users actions MARCELLO BOTRUGNO What do you mean by actions LORENZO ALLORI User actions refers to the tasks a user can perform for example new record creation deletion of a record and modification of a particular field MARCELLO BOTRUGNO What about documents revisions LORENZO ALLORI My recommendation is a Wikipedia style revisions so that each revision of a document page a people page or a places pa
101. ork is an ad hoc module completely separate from the application which manages the users authentication and the authorization Thus it is not necessary to store the username and password in the database tables and most importantly during the development of the software the developers do not have to worry about introducing control methods on the users authentication this process is entirely delegated to the Spring Security framework 6 1 3 Data Model An object relational mapping type ORM approach to the data model will be used To accomplish these tasks the development team will use the Java Persistence API JPA linked to the Hibernate implementation Hibernate will be configured for Mysql In addition the Java Persistence Query Language with its sql like syntax will help the developers to deal with the database queries more easily and to cut down the time of developing the Advanced Search sub module This model does not bind us to this database making any migration to another rdbms fast and easy 6 1 4 System Logs For the system logs the framework Apache Log4 will be used It will be configured to append the data to Mysql as well as to text log files 6 1 5 Graphics The Spring MVC framework allows us also to link the User Interface Layer to the Apache Tiles 2 API The Web Graphic Designer will use this 2 API to produce highly reliable usable and portable W3C compliant HTML templates JQuety will be used along with th
102. orkbench used by Fellows to index documents To review all the features needed see the Appendix D MAPDocSourcesV4D manual To review what has been discussed during the meeting with the Fellows check the document Minutes of Meeting 1 Functional requirements These features will be discussed and analyzed in depth in Phase 2 the System Design Phase see Appendix B Top Level System Design Document 13 3 2 2 Functional Requirements 3 2 2 1 REQ 02 View digitized documents Scholars will be able to see and transcribe digitized manuscripts therefore a web based tool a manusctipt viewer must be created and integrated During Phase 2 the Design Phase MAP will investigate how to accomplish this requirement 3 2 2 2 REQ 03 Browsing through digitized documents in a volume The goal is to achieve a realistic flip through effect to be utilized on the digitized documents of a virtual volume This flipping will have to be as similar to flipping through a real volume as possible If the volume contains inserts it will be possible to see those inserts and flip through them In the virtual volume documents must have a resolution high enough to be easily read by the users 3 2 2 3 REQ 04 Creating modifying a volume in the VolBase Creating or modifying a volume requires the Fellow to filling in of a large amount of information volume desctiption its correspondents and so on These tasks have to be done without
103. ot present in the database the user can click a button called add new place record Active start Date of Death Active end Names This is a list of name variations of the same person that the Fellows encounter and that they have annotated during their work It is used mainly for search purposes 25 Titles and Occupations This is a list of the titles and occupations that the person has obtained during his her life with the dates 1f they are known Relationships Spouses Children Portrait This is the portrait of the person If the image box is empty anyone can upload a portrait image The Community Coordinator will be notified if this happens and will decide whether ot not to allow the image to be updated and therefore viewed by the users If an On Site Fellow or a Senior Distance Fellow has uploaded the image it automatically goes online 26 2 4 4 GeoBase sub module This is the data entry part which contains the hierarchy of places used in the database from continents and nations down to individual buildings institutions and sites am Lisa Kaborycha On site Fellow PLACE DETAILS edi Tum editing off Place ID 48335 Place name Firenze Place type Inhabited Place Place Parent Firenze Toscana Italia Europe Name or Name Variants Principal Firenze Variant Fiorenza Variant Florencia Variant Florentia Variant Florentine Variant Florenz Topics List amp Fills in automatically not editabl
104. ox to signal document is ready for vetting DOCTOBEVETTEDDATE Date time Date Doc is signed off for vetting DOCVETID Text ID of the Researcher who vetted the volume DOCVETBEGINS Date time Date Vetting Begins DOCVETTED Yes Not Checkbox signals record has been vetted DOCVETTEDDATE Date time Date Vetting is Completed DOCSTATBOX Text Vetting Status of Document NEWENTRY Yes Not Check box to signal New Entry requiring vetting INSERTNUM Text Folders containing unbound documents usually contained within a larger box or tied together INSERTLET Text Insert Letter of folders containing unbound documents usually contained within a larger box or tied together Yes is entered for unnumbered or unlettered folders FOLIONUM Number Folio number of cited document Left blank for unpaginated folios 65 FOLIOMOD Text Text field For bis ter etc modifying folio number CONTDISC Yes Not Check Box to signal discussion continued on later folio in this volume UNPAGED Yes Not Check Box to signal unpaginated folio DOCDAY Number Day Date for Document DOCMONTHNUM Number Month Number DOCYEAR Number Year Date for Document SORTABLEDATE Text Concatenated Year Mon Day for sotting purposes YEARMODERN Number Year Date according to modern calendar applied to documents dated by earlier reckoning systems E g The Florentine New Year began on 25 Marc
105. r assigns the vetting of the documents entered by the Distance Fellows to one or more On Site Fellows or Senior Distance Fellows 2 4 5 Community Users Community users can perform any kind of search and they can post comments questions answers on each item that matches their search criteria They will be able to see the digitized documents by flipping through the volumes A link to our web based online course system http coutses medici org will be present to educate the community users on our current curriculum offerings we expect to recruit many interested and qualified future online scholars through this channel 2 4 6 Digitization Technicians These users are in charge of the document digitization Digitization Technicians DTs will log in to the system upload the digitized documents and edit the catalog descriptions see Minutes of Meeting 3 State Archive in Florence requirements DT s do not have any other privileges 2 4 7 Guests Users that browse our system without registering a username and password belong to this group They will have access to the database to perform any kind of search but access to digitized documents will be forbidden They will be able to apply for a username and password in order to become regular Community Users In order to join the MAP Community they will need to fill out a registration form and accept a community rules disclaimet 2 4 8 Special Roles e Distance Fellows Coordinator DFC
106. r see 2 1 1 8 is in charge of moderating the posted comments J THE MEDICI ARCHIVE PROJECT Search Documents for go Menu Advanced Search Chronology DOCUMENT DETAILS TOPICS Docid 9915 Volume 1170a Insert Part Folio Start Paginated No Books and Printing Modern Date 1577 Recorded Year 1577 Colis and Marais i Date Note Undated document but inserted between documents dated 1577 CORRESPONDENTS PEOPLE EDITS Sender Tudor Henry VII Created by LK on 25 09 2009 From City of London City of London England Recipient Medici Francesco de To Firenze Firenze Toscan Vetted by SD on 30 10 2009 Ref Niccolini Agnolo di Matte EXTRACT SYNOPSIS Extract M Synopsis Prego V S a degnarsi favorirmi con S A Ser ma et con adama Sig a mia Ser ma di farmi gratia d imprestarmi alcuni libri arabi e caldei et il carattere per stampare alcune operette mie overo concedermi una stanza nel giardino dove io possa studiare e rendere subito i libri a luoghi suoi Vorrei mandare a V S alcune madaglie della eneditione di San Carlo et alcun Agnus Dei em s View Comments reverse order Add comments Vittorio Accorense Maronita asks Cioli to request permission from Grand Duke Cosimo Il and Grand Duchess Christine of Lorraine on his behalf to borrow some foreign books type fonts for printing a few of his works or to grant him a room in an unspecified garden where he may study Accorense intends to send Cioli fo
107. rtrait Modern Date 1577 Recorded Year 1577 Gender M Date of Birth 1491 Date Note Undated document but inserted between documents dated 1577 Birth Place Active Start Date of Death 1547 Jan 1 FACT CHECK YES open and edit Death Place CORRESPONDENTS PEOPLE edit baud siven ry Sender Tudor Henry VII From City of London City of London England Family Tudor nily Recipient Medici Francesco de To Firenze Firenze Toscan Ra enam Agnolo di Ma TITLES OCCUPATIONS King of England HEADS of STATE Emperors Empresses Kings Queens 1509 1547 RELATIONSHIPS Spouses Ara Caterina de m 36 Boleyn Anne m 1535 1536 b 1507 d 1536 Seymour Jane m 5 d 1537 Cleves Anne de s m 7 Howard Catherine EXTRACT SYNOPSIS edit Extract fi Prego V S a degnarsi favorirmi con S A Ser ma et con adama Sig a mia Ser ma di farmi gratia d imprestarmi alcuni libri arabi e caldei et il carattere per stampare alcune operette mie overo concedermi una stanza nel giardino dove io possa studiare e rendere subito i libri a luoghi suoi Vorrei mandare a V S alcune madaglie della eneditione di San Carlo et alcun Agnus Dei Synopsis mu 1542 b 1521 d 1542 atherine Vittorio Accorense Maronita asks Cioli to request permission m 542 yb from Grand Duke Cosimo Il and Grand Duchess Christine of E T 1512 d 1548 Lorraine on his behalf to borrow some foreign books type Zoom in out Children fonts for printing
108. s instead refers to Current system slides things to change We will also refer to DocBase PeopleBase and VolBase which are three of the four parts that our current data entry system is divided in Steps 1 Introduction 2 DocBase mask redesign 3 PeopleBase mask redesign 4 VolBase mask redesign 5 MAPDocSourcesV4D Search Grids 6 Printing Functionality 1 Introduction LORENZO ALLORI The goal of this meeting is to identify which features we will need to remove and or change in our new web based system in order to redesign the new interface properly To do this we will check each mask shown in the slides to identify which features should be removed and which added being aware that the program we ate going to create is not a client server application but rather a web based one 2 DocBase mask redesign 2 1 DocBase Extract Synopsis Tab slide 1 mslide 1 ALESSIO ASSONITIS Do you find Insert or Part No second text box from left useful FELLOWS It seems that certain inserts have other inserts inside we should have that text box available even if it is used rarely ALESSIO ASSONITIS Do you find Folio Start No second text box from left useful FELLOWS Itis the same as the previous textbox discussed before It is rare but we use it ALESSIO ASSONITIS What about the Reckoning checkbox FELLOWS It is used when a dating style is uncertain We should change its label to Reckoning unsure 2 2 DocBase
109. s dated 1577 FACT CHECK Yes open and edit CORRESPONDENTS PEOPLE edit Sender Tudor Henry VII From City of London City of London England Recipient Medici Francesco de To Firenze Firenze Toscan Ref Niccolini Agnolo di Matte EXTRACT SYNOPSIS edit Extract ul Prego V S a degnarsi favorirmi con S A Ser ma et con ladama Sig a mia Ser ma di farmi gralia d imprestarmi alcuni libri arabi e caldei et il carattere per stampare alcune operetle mie overo concedermi una stanza nel giardino dove io possa studiare e rendere subilo i libri a luoghi suoi Ele mandare a V S alcune madaglie della ieditione di San Carlo et alcun Agnus Dei Synopsis Vittorio Accorense Maronita asks Cioli to request permission from Grand Duke Cosimo Il and Grand Duchess Christine of Lorraine on his behalf to borrow some foreign books type fonts for printing a few of his works or to grant him a room in an unspecified garden where he may study Accorense intends to send Cioli foundation medals of the church of San Carlo and some agnus dei O def Zoom in out TOPICS edit Books and Printing City of London City of London England Coins and Medals Firenze Firenze Toscana Italia DOCUMENT DETAILS Docid 9914 Tum editing off Volume 1170a Folio Start Paginated No Insert Part Modern Date 1577 Recorded Year 1577 Date Note Undated document but inserted between documents dated 1577 FACT CHECK No CORRE
110. s used to navigate through the interface Each user group has its own menu 3 2 1 On Site Fellows and Distance Fellows menu It shows six links to perform different actions a search form used for the Basic Search see 2 3 1 and the Shortcut menu see 3 2 1 9 at top right gt m Go to last PERSON entry Tudor Henry VIII THE MEDICI ARCHIVE PROJECT Go to last VOLUME entry Mdp 1170a S Date 1534 Sept Who am Lisa Kaborycha On site Fellow Image 23 Main Menu Onsite Fellow or Distance Fellow This module helps the user to perform several actions 3 2 1 1 The Search form Basic Search Itis a form for the user to perform a simple word search on documents volumes people locations and community comments see 2 3 1 42 3 2 1 2 Entry Menu The entry menu is visible to Administrators On Site Fellows Senior Distance Fellows and Distance Fellows It is used to perform the Add operations and to delete the item the user is currently viewing p l THE MEDICI ARCHIVE PROJECT Search Documents for go Entry Menu Add new Document Add new Person Add new Volume Add new Place Delete this Item Image 25 Entry Menu Menu items Add new document Add new volume Add new person Add new place Delete this item visible to Administrators and On Site Fellows 3 2 13 Vet Menu The Vet Menu vetting menu is visible if we are editing a document in the DocBase A Fellow can set it as
111. ser Groups sti m TheiLogin P ge ene User Registration Forni aeree eet cetera recep teet pai ops rediere Reto tee eerte 12 User Actions eta To A EE E Mm Data Entry module rcsrrrrrrrrrerereee rire ze ee eine ezine re ze zi nizza neni nea zine rie eeneniz ezine nie e nici nie zine ozone 19 DocBase sub modul s s carina aee certi ha Lala andino ON CUTE ER anna CUT E TURN NER Ae ua E 21 VolBase sub module is sn SS aie ius s uds P ople Baseisub smodule etie Sai 25 GeoBase sub moduless eis ae se O I 27 Comments P du lior TUM Community Messaging System ettet a te teer ttt tin tee tete tn te a a reete ipee Rad 33 User Management Reports and Revisions System Management sano duode uae dieque pneu pie dete Digitization module Lees esses eene nennt cinici tnnt zizi rice SECRETE ESETERE STEEKR einen The digitization task a The Digitization web 1ttetface tette nce e t Alia 37 Manuscript Viewer eiie eaae ieri PAR UNE ER ERU isee ski s otites eiside aeda MAP s IIPImage implementation Deployment Did pram sists iaia acini 40 3 USER INTERFACE DESIGN lareo ereat ennt cere ee ee rie e nice ce zeri cirie eee nie e eee eee a 41 3 1 Usabililty a cuni aac 41 3 2 The Mani Menus eite RI RI RIO ra 3 2 1 On Site Fellows and Distance Fellows menu 32 2 Community User menus 3 25 Administration Te
112. server in MAP s room in the State Archive in Florence It runs Linux Slackware and these services will be running Apache Tomcat 6 0 x Mysqld 5 x Mysql Client 78 7 3 The Production Environment The production environment resides on MAP s outsourced servers see 8 1 It runs Linux CentOS and these services will be running Apache Tomcat 6 0 x Mysqld 5 x Mysql Client Subversion or CVS OpenSSH Bugzilla 79 8 Server System 8 1 Servers deployment One of the main bottlenecks of a web based system that has to serve multiple users simultaneously is the Internet bandwidth For this reason MAP chose an outsourced solution instead of an in house one MAP is going to rent two dedicated private servers with the following specifications Intel Xeon 4x cote 1 86Ghz 2Gb Ram 2x 300Gb SAS Hard Drives RAID 1 configuration 10Mbps assured internet bandwidth Public IP The two hard drives on each server create a RAID 1 array mirroring and are managed by a hardware raid controller MAP s system requires continuous availability and a high degree of reliability For this reason one setver will act as a master server the other one as a slave all the data will be synchronized If a failure occurs the slave server takes the lead providing a failover capability see 8 1 1 and 8 1 2 8 1 1 Servlet container Tomcat configuration Each server will run an instance of Tomcat The two Tomcats wil
113. tamp set as 11122012 and ID zser set as lallori is an old revision of the current 1171a which has been modified by the user lallori on October 12 2012 4 3 3 Community Comments TblComments Field Type Description ID Numeric automatic UniqueID Timestamp Date time automatic Date and time of creation UserID Numeric External Key USERS Type Numeric 0 Document 1 Person 2 Volume 3 Place EntryID Numeric External Key tblDocuments Status Numetic O0 TOBE EVALUATED 1 2 APPROVED 2 NOT APPROVED Text Text Comment text 70 4 3 4 Personal Messages TblMessages Field Type Description ID Numeric automatic UniqueID Timestamp Date time automatic Date and time of creation UserID Numeric External Key USERS Type Numeric 0 Personal Message 1 System Message Status Numeric O READ 1 NOT_READ Text Text Message text 4 3 5 Showing digitized manuscripts The digitized manuscripts reside on the servers filesystem as files In the database tables a field is reserved to the images path TblDigitalDocs Id Unique ID Vol_id Text Identificativo del volume Progr Numeric Numero progressivo del documento digitalizzato Type Text COPERTA P Carta C Guardia G Allegato A Folio Numeric Numero del foglio 4 3 6 Google Maps integration In the table zb P aces a new field geocoord will be added It will contain the geographic coordina
114. ted the Volume Record DateCreated Date time Date volume record is created VolTobeVettedDate Date time Date Volume is signed off for vetting whether from backlog or newly entered volume VolTobeVetted Yes Not Check box to signal Volume is ready for vetting VolVetlId Text Initials of Researcher who vetted the volume VolVetBegins Date time Date Vetting Begins VolVetted Yes Not Check box to signal volume vetting is complete VolVettedDate Date time Date volume vetting is completed STATBOX Text Vetting Status of Volume STARTYEAR Number For inclusive date range of all documents in the volume STARTMONTH Text For inclusive date range of all documents in the volume DELETE USE NUMBER FORMAT WITH MONTHNAME LOOKUP TABLE STARTMONTHNUM Number Start Month Number Format STARTDAY Number For inclusive date range of all documents in the volume ENDYEAR Numbet For inclusive date tange of all documents in the 63 volume ENDMONTH Text For inclusive date range of all documents in the volume DELETE USE NUMBER FORMAT WITH MONTHNAME LOOKUP TABLE ENDMONTHNUM Number Start Month Number Format ENDDAY Number For inclusive date range of all documents in the volume DATENOTES Memo For additional information characterizing date range of documents E g Document dating is a mix of Florentine and Roman reckoning SENDERS Memo General description of correspondents E g From
115. terests stasera si fa l accademia dei poeti in palazzo Accademie were frequently meetings of artists and or amateurs to draw from the nude Therefore the term fare l accademia often meant to draw from the nude and the noun un accademia could indicate a drawing from the nude Duly constituted Academies with formal corporate identities are also indexed under PLACES For example the Florentine Accademia del Disegno is indexed as Accademia Disegno Firenze Firenze Toscana ltalia Europe W orld Delete This Doc Record Minutes of Meeting 1 Current System Slides Things to Change Doc ID 73 Vol Shelf 2 DETAIL Volume Shelf Res ID FN 11 28 1996 SENDER Insert or Pat No Unpaginated 4 11 2001 HE Folio Start Ma 24 ae en O Place Firenze Firenze Sender Notes Tear Month Day Mod ear gfieckoning 9 DATE 1537 September 13 O RECIPIENT Uns ID it Date Uncertain ar Approximate Undated Mame n ardo di Antonio H O _ 205 Sortable Date 1537 09 13 He hio n fo sont ae af cao Place na Ei Top af iN hiera 41 O Date Notes The dating seems to be an abbreviation for Recipient Notes settembre though a reading of aiuano is not Yolume Info Fact Check Save Record SYNOPSIS Document ord Ambassador Serristori is to present gifts from Cos
116. tes that will be used by the Google Maps APIs see 6 7 4 3 7 Catalog descriptions A new table for catalog descriptions will be created Caz4 0g using the fields listed in Minutes of Meeting 3 Catalog Description 71 5 Help System Design 5 1 The User Manual In each user s profile page see Image in section 2 5 2 the scholar is provided with the user manual It will be available both in html and pdf versions From this page the user can also access the help videos section The help videos are a step by step guide to perform some of the main activities a user performs duting the day to day work e Data Entry System Create a document file Create a people file Create a volume file Create a location file e How to perform an Advanced Search On documents On people On volumes On locations On community comments e How to deal with the community comments e How to use the personal messaging tool e Howto deal with your user profile During the Community Testing phase see Appendix C Preliminary Gantt Chart the community testers will be able to ask the MAP team to create additional videos to guide them thtough tasks which need further explanation and are not mentioned above 72 5 2 The embedded Help System Aside from the User Manual the Help System will be embedded inside the system and will be accessed through the icons Each icon will open a help pop up explaining that parti
117. the document digitization process 2 1 Already digitized volumes and documents LORENZO ALLORI We have already some digitized documents How many of them do we have ALESSIO ASSONITIS The first 20 volumes are already digitized These digitized documents will be uploaded to the new system 2 2 Documents in our current data entry interface LORENZO ALLORI How will we deal with the documents in our current database that need their digitized document to be attached ALESSIO ASSONITIS The volumes will be digitized in their entirety starting from the volume number twenty one Once a volume will be completed a Fellows will attach the correct manuscript folios to the correspondent indexed document in the database 2 3 Human Resources LORENZO ALLORI We will need a person for the digitization and the upload of documents to our system The manusctipts need to be handled with care when digitized We should plan a meeting with the State Archive in Florence to discuss this issue 3 Study on the requirements for the Manuscript Viewer LORENZO ALLORI What features will we need in the manuscript viewer ALESSIO ASSONITIS The digitized documents will have to be readable and therefore should be in high resolution Additionally a zoom in zoom out feature must be available We should ask the State Archive in Florence if it is possible to use the manuscript viewer applet they use in their web site LORENZO ALLORI Yes it does also comply with
118. the web page being refreshed During Phase 2 a web technology will be chosen to accomplish this requirement 3 2 2 4 REQ 05 Creating modifying a document in the DocBase Creating or modifying a document requires the following steps e Identify a document relevant to the MAP topics list e Identify the sender and recipient that if not present in the database must be inserted through the bio data entry section see 3 2 2 5 It is required to see if that person already exists in the database or not For this reason an autocomplete dropdown text field is a must e Identify the sender and recipient locations that if not present in the database will be added in the places data entry section see 3 2 2 6 It is required to see if that person already exists in the database or not For this reason an autocomplete dropdown text field is a must e Add the document transcription in the original language e Add the transcription synopsis in English e Link the document to the MAP topics it refers to These tasks must be done without the web page being refreshed During Phase 2 a web technology will be chosen to accomplish this requirement 14 3 2 2 5 REQ 06 Creating modifying a bio in the PeopleBase During the Fellows work on the documents it is crucially important to add the sender and the recipient name Those historic figures must be present in the PeopleBase if not it is necessary to add them When adding a new bio
119. this is a flag that an On Site Fellow or a Senior Distance Fellow can obtain The DFC is responsible for monitoring the Distance Fellows work The DFC is notified of any new records that Distance Fellows create but is not responsible for vetting them e Community Coordinator CC this is a flag that an On Site Fellow or a Community User can obtain with the responsibility of evaluating the comments posted by the Community Users A CC will be notified by the system when a comment is posted after which she will review it and decide if it matches the community disclaimer rules If not the comments will not be approved and will be deleted A CC will also be able to close a convetsation thread The Research Director is an On Site Fellow who is responsible for the whole Medici Archive Project s reseatch on the Medici Granducal Archive Collection 10 Digitization Coordinator DC this is a flag that an On Site Fellow can obtain with the responsibility of monitoring and quality assurance of document digitization The system will notify the DCs about new documents that DTs upload to the system 2 4 9 Wotkflow The workflow is divided into two steps a defined class of users performs the following actions 1st step Preliminary reviewing Digitize documents Digitization Technician Digitization Coordinator 1 reading data entry On Site Fellows Distance Fellows 2 reading pre vetting comments Community Users
120. tion 47 3 3 Split Screen This feature is one of the most important innovations of the whole system The Fellows in fact requested a way to compare one document to another entry in the same screen To do this MAP will create an interface that is divided into two parts The left hand side of the screen will be where the Fellow modifies the document On the right hand side the Fellow can perform a related search Here the Fellow will also be able to open up a tead only version of the document people volume or place entry for compatison while editing on the left hand side of the screen THE MEDICI ARCHIVE PROJECT 1 S Date 1534 Sept irenze Firenze Toscana ltalia Europe World Search Documents for E Entry Menu Vet Menu Advanced Search Chronology aka Messages 1 Log out Lisa Kaborycha On site Fellow Created by LK on 25 11 2009 DOCUMENT DETAILS edi CEU Search Results Tum editing off 9 Documents Docid 9915 Volume 1170a Insert Part Folio Start Paginated No Modem Date 1577 Recorded Year 1577 Jee SEL Le aoe E oe To 22434 1858 61 1519 Nov 19 Tudor Henry VII Valois Henry fl de London Paris Date Note Undated document but inserted between documents dated 1577 FACT CHECK YES open and edit 22434 1858 Tudor Henry VII London 22434 1058 or CORRESPONDENTS PEOPLE edit 22434 1858 OPEN left window Sender Tudor Henry VII From City of London City of
121. tis also possible to select and print documents from a search list Search Results 9 Documents Select All DOCID VOLUME INSERT FOLIO DATE FROM TO 22434 1858 61 1519 Nov 19 Tudor Henry VII Valois Henry Il de r London Paris C e e SE La 22434 1858 61 1519 Nov 19 Tudor Henry VII Valois Henry Il de D London Paris ee F CA RE NES io SA SR Ee ee 22434 1858 61 1519 Nov 19 Tudor Henry VII Valois Henry Il de London Paris r 22434 1858 61 1519 Nov 19 Tudor Henry VII Valois Henry Il de n London Paris 22434 1858 61 1519 Nov 19 Tudor Henry VII Valois Henry Il de r London Paris New blank advanced search Print Selected Image 44 Selected four documents to be printed from a search results list First the user selects the documents that he wants to print and then clicks the link Print Selected The user is also able to select all the documents by clicking the Select All link and then to print them out 3 7 Compatibility The software produced will be web based and therefore it will be accessible from any of the major web browsers To guarantee cross browser compatibility the Graphic Designer along with the Developers will produce HTML according to the W3C standards 61 4 Data Structural Design 4 1 Data Structure The current database structure is preserved Image 45 Current database tables Microsoft Access View MAP s online database http documents medici org is based on Mysql and contains the
122. tract Synopsis and Topics Each main field has its sub fields except for Topics Document Details Docid Volume Insert Part Folio start Paginated Modern Date Recorded Year Date notes 21 Correspondents People Sender Sender from Recipient Recipient from Reference to The Reference to field is a list of people mentioned in documents extract see 2 4 3 Extract Synopsis Extract Synopsis The extract is the actual transcription of the document The synopsis is a summary of the transcription it is written in English see 3 4 for details Topics Topic Topic Place Here the user can add one or more of the MAP topics appropriate to the document along with the place or places associated with it see 2 4 4 22 2 4 2 VolBase sub module This is the data entry part that refers to the volumes of the Medici Granducal Archival Collection Using this interface the scholar can edit the volume information but she can also flip through the folios of the digitized volume see 2 8 By clicking on a digitized folio she can if already indexed by the Fellows access its transcription Otherwise if she has permission to do so the Fellow can enter that indexed folio s transcription creating a new database record RCHIVE PROJECT irenze Toscana lItalia Europe World Search Documents for E Entry Menu Vet Menu Advanced Search Chronology My Profile Messages 1 Log out Lisa Kaborycha On s Volum
123. trete p tutta see it in full screen show manuscript on the right side CI n ose N N Image 35 The Transcription window After transcribing the document the Fellow clicks on the button Add or Edit Synopsis 52 The previous screen slides on the left and the user starts entering the synopsis comparing it to the previously entered extract Image 36 The Synopsis Window When the Fellow has finished she presses the button labeled Save and Close Ext Syn 53 The Extract Synopsis section of the DocBase has been filled Created by NC on 06 23 2003 DOCUMENT DETAILS edit Vetted by LK on 11 25 2009 Docid 9914 Volume 1170a Insert Part Folio Start Paginated No Modern Date 1577 Recorded Year 1577 Date Note Undated document but inserted between documents dated 1577 CORRESPONDENTS PEOPLE edit From Abate di San Galgano Firenze Firenze Toscana Italia To Medici Francesco de Firenze Firenze Toscana Italia Ref Niccolini Agnolo di Matteo change image EXTRACT SYNOPSIS edit i il Extract E E OA Reuerendo padre fra Tommaso io ui pregho siate contento 424 6557 Ge mandar c i questi danari che gi pi uolte ui habbiamo f IT he 1a mandato cancelled pi a chiedere E quanto pi indugiate or fer ir i somma saranno et in vero non ui paia faticha perch si ornir pi presto che sono quasi tutte fra mano e si spediranno tutte le cose che si appartenghono a f
124. uest uset see 2 1 1 7 wants to become a Community User he has to fill in a User Registration Form he can access it from the user login page see Image 4 J fc SS e a dle A Registration Form FrstName LastName lt Cs City a County TTT Email E Re enter your email t CS Addes Organization s lt i CSS S Title CG Interests Verify that you are a human drag pencil into the circle WA Please read this disclaimer and check the agree box ONLY if you agree to the terms I agree M Image 5 User Registration page This form has the following fields to be filled in First Name Last Name City Country E mail Address Organization Title 12 Interests The fields with are compulsory A verification image like a captcha is present in order to protect the forms against spam robots A community rules disclaimer is shown and the user has to read and accept it before submitting the request After submitting the request the user receives his username and password by email To see how the Authentication module will be developed see 6 1 2 2 20 History Log Module 2 24 User Actions This sub module keeps track of any user action Once a user logs on the User Actions sub module starts logging each action he performs Each log entry shows these fields Date and time Ip address Username Full name Action Information 2 2 1 1 Dat
125. ule will manage all of the online scholarly community s comments questions and answers regarding each item present in the database volumes documents historic people historic places Authentication module History Log module Data Entry module Community module VolBase 4 read only read only gt PeopleBase fread only GeoBase 4 pane read write 2 3 Product Features System features requirements list 1 Login to the system with username and password 2 Creation and or update and or deletion of database records e Flip through digitized documents in a volume Create update delete volumes records Create update delete documents records View digitized documents Create update delete bio pages records Create update delete places records Send personal messages to other users of the system 3 Search records e Search through the volumes document transcriptions digitized documents bios and places records 4 Community actions A database record is one entry in the database 2 4 e Post comments questions answets on volumes document transcriptions bios and places records e Send personal messages to the other users of the system e Edit view personal profiles Moderate community comments questions answers e View evaluate delete community comments questions answets Log tracking of users actions in the system System access New record creation Record deletion Record mo
126. ume Shelf Uns ID i 203 Insert or Part Mo Folio Start Mo Sender Notes fear Month Day kod ear Reckoning 9 DATE 1537 September 13 I Date Uncertain or Approximate Undated O Sortable Date 1537 09 13 Ure de Beer to sar Der Aa ote Date Notes The dating seems to be an abbreviation for settembre though a reading of giugno is not RECIPIENT Mame Place Recipient Motes i l ambasciatore Averardo Extrac Synopsis Save Yolume Info Fact Check Research Notes PUBLIC NOTES Internal Notes Record Add Mew Document Extract Record synopsis PLACE 5 People Topics Remove Filter Refresh PERSON Yolume Into Fact Check Delete This Doc Record ID 113 Aachen Hans von Parents PORTRAIT INDEXED in I Person Record Parents amp Children Enter Birth Year OR Active Start Enter Death Year OR Active End Hemove Place Unsure sure lace Unsure Filter 7 Refresh n 12118 Praha Stredocesky Ceska Reput dpi E Hat react Occs Titles m 8623 Koln 7 Koln 7 Nordrhein Westfal d Biblio Record 14 1 gt bl gt of 1 e Thomas DaCosta Kaufmann Drawings from the Holy Roman P In Rome by 1575 worked in Florence as a portraitist passed through Se Empire 1540 1680 Princeton 1982 U Venice during return trip to Bavaria in 1587 ID 113 Aachen Hans von GRI
127. undation medals of the church of San Carlo and some agnus dei n 9 12 07 2009 09 34 AM John Smith Community User post vetting What do you think about ashdshdhashds reply 2 2 12 07 2009 11 41 PM Alessio Assonitis Administrator post vetting Seems that asd asd asd asd asd as dasd asd asd as das dda sd s dasd reply Image 16a Community comments post vetting comments and Edits section 2 5 2 Profiles Each user has his own profile which is his personal business card for the community COCUENSECEREOENRG ees COE EEEURG User Profile John Smith Group Community User Title Curator edit NO Organization Naples Museum of Art edit IMAGE Location Italy Florence edit Interests Salvador Rosa ecc edit Resume no add modify resume Image 16b Community User s Profile User Profile Alessio Assonitis Group Administrators Title Research Coordinator NO Organization The Medici Archive Project IMAGE Location Italy Florence State Archive Interests Savonarola ecc Resume yes Send personal message Image 16c The user is looking at another user s profile 31 These are the profile fields First name and Last name A user s picture the user can upload a picture of himself to the system Group the system s user group he belongs to Title the title the user has at the organization where he works Organisation Location Interests Resume the user can upload a pdf ot word file to the system A
128. unity and also have access to all the other modules with the exception of the Digitization Module see 2 7 and the Administration Module see 2 6 2115 Community Users Users belonging to this group can access the Search module see 2 3 They can also access the Community module s three sub modules comments see 2 5 1 profiles see 2 5 2 and personal messages see 2 5 3 2 1 1 6 Digitization Technicians Users belonging to this group are allowed to access the Digitization module see 2 7 and are in charge of uploading the digitized documents to the system The Digitization Technician also belongs to the Community User Group and thus has a read only access to all the items contained in the database and is able to post comments 2 1 1 7 Guests These are the users that browse MAP s system without using a username and a password They can access the Search module though access to the Manuscript Viewer module see 2 8 is forbidden They can however fill in the User Registration Form sce 2 1 3 to become regular Community Users Every request is checked by the Community Coordinator and if accepted the user becomes a regular Community User see 2 1 1 5 AM DE DEV DEVO SRC EW CM HL DIG omino V 4 4 ST SISSA 4 communiy Users Y Y Y Z Modules Description ADM Administration module DE Data Entry module DEV Data Entry module vet and change or delete any document DEVD Data Entry module vet and ch
129. ust be prepared the volume s conditions must be analyzed identifying if the volume must be restored a catalog description see attached MM3 catalog desctiption pdf for reference of the volume should be compiled and eventually the pages should be numbered in order to link the image to the document During this phase a member of the State Archive in Florence staff expert in the Medici Granducal Archive Collection must assist the Digitalization Technician The second step is the actual digitalization The digitalization technician will be taking color pictures of the document using a camera The quality should be at 300 DPI minimum The images should be saved both in TIFF and JPEG format The third step regards the image s storing The images will be downloaded from the digital camera on to a computer where they will be saved matching our cataloguing standards 3 Definition of the standards for cataloguing digitalized document images MARCELLO BOTRUGNO What are your cataloguing standards for digitalized images FRANCESCA KLEIN Before downloading the images from the digital camera a directory will be created on the computer and named as the number of the volume Then the images are downloaded to that directory The format of the names of each image must have at least four progessive numbers_ coperta C G guatdia A allegato three numbers number of folio R V recto or verso Example 0005 C 009 R FRANCESCO MARTELLI
130. which that is provided by the JDK we will able to easily generate the APIs documentation in HTML format 73 6 Architectural Strategies Various web otiented programming languages are available nowadays to create successful web interactive platforms Excluding the Microsoft world the software architects attention focused on both PHP and JAVA Comparing advantages and disadvantages of these two technologies which are both very powerful and mature MAP chose JAVA Therefore the code will be written following the JEE specifications 6 1 Frameworks 6 1 1 Spring MVC The development team will use the Spring MVC which is a Java framework to build web applications on top of the Java Enterprise Platform Spring MVC architecture meets MAP s three layer design methodology Presentation Persistence Image 47 Spring Architecture 74 The Developers will also use the DWR library Direct Web Remoting also called Easy Ajax for Java which provides an easy and fast interaction between Java Server Pages and JavaScript client language 6 1 2 Security and Authentication To develop the authentication and authorization mechanisms the development team will use the Spring Security framework This provides a set of modules to connect to the most important authorization and authentication mechanisms such as OpenLDAP which will be used to store username and passwords as well as the profile fields data This security framew
131. xisting ones This is the dropdown structure of the menu Browse users Activate user accounts Add new user Edit user This menu is shown at section 3 2 3 2 6 2 Reports and Revisions This menu helps the administrative user to browse the data that the History Log Module recorded see 2 2 Through the Reports and Revisions dropdown menu the Administrator will be able to search through the logs see 2 2 1 and the revisions see 2 2 2 using several types of filters This is the dropdown structure of the menu Activity Report Comments Report Statistics Revisions Database Document revisions People revisions Volumes revisions Places revisions The Activity Report helps the Administrator to browse the user s logged activities The Comments Report helps the Administrator to track the comments posted by the users and all the activities that regard the community itself The Stazisties tool is able to perform statistical graphs using each type of data recorded by the history log system combining it with the database content 34 The Revisions Database is a search tool that will be able not only to search for previous revisions of documents volumes bios and or locations but it can also restore an old version of it This menu is shown at section 3 2 3 2 6 3 System Management Through the System Management menu the user will be able to see the server status and to access the backup system This is the dropdown structure of

The Medici Archive Project, Software Redesign Proposal

Contents

Download Pdf Manuals

Related Search

Related Contents