Home

User Guide for version 3.0 of the dLibra system

1. Generate pages To use default configuration simply check Use default templates The Templates tab allows user to select templates which are to be used to generate a publication To choose templates press Choose directory button and choose directory with templates Index template file should have an index vm name and page template file should have a page vm name External files list contains all additional files that are used by the templates If Copy external files is selected then after generation process external files will be copied to target publication directory The user may also select template character encoding and size of thumbnails which will be generated thumbnail are only generated when the publication is based on graphics Templates should use the Velocity standard to use to following variables e info PublicationAuthor information about publication author e info PublicationTitle publication title e info PublicationInfo additional information about publication e relPath relative path to the publication sources e info PictureName file name base segment e info PictureType file type file name extension 25 Editor s Application 3 3 e pictureNumber file number e info BeginIndex index of first file e info EndIndex index of last file e info PageCount the number of files in the publication e pageNumber actual page number e info PageName name
2. Press Remove button placed beside the groups list After confirming a group and all it s values will be removed from the list and from the system Caution If any of the group s values is assigned to a bibliographic description of some library element the system won t delete such a group and will show a dialog with information that all connections should be removed instead To merge two groups of synonyms l 2 Choose a group in a list that has to be merged with other group A button Merge should be pressed After confirming an intention of merging the groups a new window with groups list will appear From a new list Figure 4 8 Choosing a group to merge choose a group that previously chosen group should be merged to Edition field up the window makes it easier to find a groups with names containing certain set of characters An All button brings all the groups back to the list 57 Library Manager Figure 4 8 Choosing a group to merge Target element Help Target element application octet stream application rdf xml image gif imagejpeg texthtml Cancel 4 To finish the process of merging groups press Apply button Previously chosen group will be merged with new one and it means that old group will be removed and all it s values will be moved to a new one Caution If the target group contains a value with the same name as one of the values from group chosen to be m
3. 4 3 Advanced right management 4 3 1 Introduction In the dLibra library access restrictions are applied on three different levels library level directory level and publication level The library level access restrictions concern attribute scheme management library users and groups management The directory level restrictions can be applied to every single directory in the library content tree and regard content visibility permission to read and edit the content of the directory Finally the publication level access management applies to a single publication and regards publication viewing and reading The three groups of access permissions will be dis cussed in detail further in this section Regardless of the access level rights are granted on a user or group basis A user has the rights he was directly granted but also the rights inherited from all groups he is a member of Thus a change made to access permissions of a group will affect every user belonging to the group 4 3 2 Library level permissions In dLibra there are five library level administrative permissions e account management allows to create remove and alter user accounts e group management allows to create remove and alter user groups e attributes management allows to create remove and alter attributes 70 Library Manager e attribute values management allows to manage the synonyms dictionary e collections management allows to create
4. 2004 then the name will be John Smith 2004 Stories first author then publishing date and title Whenever a user changes the attributes values the name is updated Press the Next button to move to the next steps Figure 3 16 New Publication Wizard attribute values page 2 New publication wizard Help Steps Metadata description Name Samoloty Attributes Enter metadata for the a EN Attribute name new publication e 1 he main publication Attribute value IPL Dublin Core ver 1 1 Univ Title Samoloty Creator Subject and Keywords Description Publisher Contributor Date E Resource Type Format Resource Identifier Source Language Relation Clear description Description of selected attribute A name given to the resource Metadata import export C Store RDF file Metadata file Not specified Main file Documents and Settings tparkola Moje dokumenty przyklady publikacje userguide_pdf userguide pdf In the third step Figure 3 17 New Publication Wizard publication rights page user may grant appropriate rights for other users to publication For more details about rights management for publication see section Rights editor Press the Next button to move to the next steps 29 Editor s Application Figure 3 17 New Publication Wizard publication rights pa
5. Help User s administrative rights Rights management Set user s administrative rights Set user s lomains C Account managing C Group managing C Attributes managing C Attribute values management oO Collection managing Oo WAAAY application managing 6 In the last fourth step Figure 4 15 New user wizard defininf access domains assign access domains Managing access domains is described in details in 63 Library Manager Figure 4 15 New user wizard defininf access domains New user wizard x User s access domains Domain list Domain properties rights 4 Set user s access domains Domain type To remove a user l In the Library Tree Select the user to be removed 2 Press the Delete button Alternatively a context menu or a pull down menu can be used 4 2 5 2 Library groups management To create a new users group l 2 In the Library Tree select the groups node or a group node From the toolbar select button or choose Nowa grupa option from popup menu You can also choose New group option from Management menu In the new group wizard the first step Figure 4 16 New group wizard general information specify general information description and name Press the Next button to go to the next step It is to possible to create the group at this point by pressing the Finish button 6
6. Library Manager Figure 4 3 Collection s publications management Subject and Keyw Description amp z 8S Nowa publikacjakk dLibra Library Manager admin TAX Program Edit Management View Help Library resources a EEF Collection Rights Publications 3 Library resources r a Users lee AS amp Groups MI Oo D Biblioteka Cyfrowa E LDAP groups O C a Biblioteka A 3 Attributes Oo Biblioteka B Dublin Core ver 1 1 LI o D Jan Kowalski HO Title 0 QO 21D Przyk ady Creator Ea o So Gazeta wiat oo M M o Publisher H O Contributor H Date HO Resource Type I O Format 2 Resource Identifier Source Language Relation Coverage Rights Managemen o WE Metadata languages fa Interface languages B 20 Library directories g9 Library collections 3 Digital Library a Math Exhibitions 5 Regionals si wig Przyk adowa Publication is assigned to the following collections 5 Regionals E math Cancel After choosing certain collection in Collections Tree on the tab named Publications Figure 4 3 Collection s publications management appears an interface enabling publications membership management for selected on Collection Trees collection On the top of the Publications tab a table used for editing publications to collection assignment is
7. Pressing the Apply button will store the information from tabs on the server Pressing the Cancel button or selecting another element on the elements list will discard all changes made since the last Apply operation Values of some prop erties eg edition description can be defined in a number of languages the current language can be changed with the drop down list placed on the bottom right corner of the Properties Window 11 Editor s Application 3 1 4 General information editor General information editor allows user to view modify element s main properties for example directory name for directory element General information editor is usually the first tab in the properties window The list below shows properties for different library objects e Library directory Name defines name of a directory identifying it in dLibra system directory name is language independent Notes administrative notes for a directory notes content is language independ ent e Library collection Name defines name of a collection identifying it in dLibra system and visible in WWW application collection name is language dependent and should be defined for each language separately Description defines description and contains basic information about collection visible also in WWW application collection description is language dependent and should be defined for each language separately Notes administrative notes for
8. 96 Glossary Publication LDAP MARC 21 communitation format RDF format Digital object stored in a digital library Lightweight Directory Access Protocol protocol used for object localization e g information about organization user or file etc which are grouped in a tree structure File format which is used to store bibliographic description in MARC standard in order to communicate between systems Resource Description Framework RDF language used for representing information on the web 97
9. All changes must be confirmed by pressing Apply button down the screen Editing attributes properties can be performed using the interface placed on a General information tab available after choosing single attribute node in the Library Tree User can change name RDF name role and description of each attribute 53 Library Manager Figure 4 5 Attribute properties a dLibra Zarz dzanie Bibliotek admin Heg Program Edit Management View Help Library resources Attribute Subattributes order values 5 0 Library resources a Users Language dependent values E Grupy m 6 2 Grupy LDAP EEN mmi PL 3 Attributes Dublin Core ver 1 1 Nazwa Title a Title Creator Subject and Keywords Opis Description Publisher Contributor Date Resource Type Format Language independent values A name given to the resource Be eee ee Resource Identifier RDF Name Title Source Language Role lt no role gt iy Relation Coverage Rights Management jo WE Metadata languages fa Interface languages B 20 Library directories HS Library collections Identifier gt Caes ae e e EE canada Name and description of an attribute are multilingual properties and they have inform ational character RDF name is a unique name identifying attribute inside Dublin Core metadata scheme and outside the system A single role can be ass
10. Computer science Publication A publication is a unit of information such as an article report or user s manual dLibra publications consist of files In the simplest case a publication can contain only one file that conveys all the information e g a PDF PS or MS Word document Nevertheless it is also possible that a single publication will cnsist of many files of different types The prime example of such a publication is a web page with HTML JPEG GIF and other files as its components Introduction 1 5 1 Publication s editions files and files versions Publication s edition is a concrete version of a digital document Let us assume that an author has created document A this is the first version of the document The author has sent document to editor which has added it to digital library by creating a publication when creating publication dLibra system creates first edition automatically Next the author modified the document and as a result editor has got a new document version document A In order to make the new document version A avaliable in the digital library the editor should add a new edition to the publication not new publication After a new edition is added publication contains two editions the first one refers to document A the second one refers to document A Thanks to this approach users have entire document s life history avaliable In the context of files an edition is a set of concr
11. Or APP ICAO a a E E E E O ENE AE OEE cet 7 3 EGitor s APP Caton ania r Sec teehee ahs oe cas hag Rs Sas IRs RS ES LR RI 9 3 1 Editor s Application main Window cece cee cc eee nee ee eeeaeeeeeeaeseneeaaes 9 De Vole DIFECTOMIES REC aia teeth ti ane sctes teats Soanbs Meanbs Soanbs Moanhs Soanbe teats foanie Mania 10 3 1 2 El ments SE sgh o5 ose hs news E cha tk us tue NEEN A ANEA buetube ceded Ea ENE EEN 10 351 93 PFOPeruies WINdOW oesie seasea ea ae AEAEE A ARRARAS AEAEE 11 3 1 4 General information editor 2 0 0 0 cece cceecc eee cneceaeeeeeeneeeaeeeaeeeeeeaeees 12 3 1 5 Bibliographic description editor ec ceceee cee eee eee neeeneenaes 13 e A RIGHUS HilOrs i ce EET E E eet E tiered ein T 18 3 1 7 Publication position Editor onene iuen an cece eee E a a E a 20 3 1 8 Assigning publication to collections esssesseeseseesessesresersreseesereees 20 3 2 P Dlicatiot CLEALON usii sere sete e nE safe bored ee Sere Baie a Ria a aeaii 21 3 2 1 Publication Creator s functions eseseseseseresressrereeereresrersrererereees 22 3 2 2 Using Publication Creator cece cece cece nsec aaa a 22 33 Lypical ditor s laSKS oar AAE ARIES dian I ORN ORIA ORIORI ORE 26 3 3 1 Moving and removing elements 0 eee cesses cnececeeeeeceeceeeneeneees 26 3 9 21 Creatina GIEC TOI sxsw a aN cadsae cana cab cee cause sav ees NEEN NEN 26 3 3 3 Creating a new group publication 2 0 0 eee eee eeeeeeee
12. Publication files upload Choose the main publication file Enter metadata for the new publication t publication rights Progress 1 Creating publication 0 00 2 Setting rights 0 00 3 Adding publication to collections 0 00 4 Creating file versions 0 00 5 Sending files 0 00 6 Creating first edition 0 00 7 Setting metadata description 0 00 Add publication to collections Upload publication files to the dLibra server Estimated remaining time 0 03 Press Start button to start upload 3 3 5 Creating a new planned publication To create a new planned publication l 2 On the elements list select destination directory or group publication From the popup menu select New planned publication It is also possible to select this option from toolbar or main menu Planned publication wizard consist of four steps The first step is the same as the second step of new publication wizard The second step is the same as the third step of new publication wizard The third step is the same as the fourth step of new publication wizard In the last fourth step of new planned publication wizard Fig ure 3 22 New planned publication wizard general information specify the ad ministrative notes and information whether the publication should be secured or not Secured check box 33 Editor s Application Figure 3 22 New planned public
13. and specify address composed of digital library address appen ded by the Link ie for a digital library which address is www wbc poznan pl we would have www wbc poznan pl publica tion 10 Planned Identifier Identifier cannot be modified as it is auto publica matically assigned by the system This is tion unique identifier of a publication Planned Attributes Yes No Bibliographic description of a planned publica values publication is automatically assigned to tion first edition which is created while adding content to this planned publication Planned Secured No Yes This value is represented as check box publica Editor may initially secure planned public tion ation see opis publikacji for more details mark that the content of this publication should be secured Publica Name No Yes Publication s name in dLibra system tion Publica Notes No No Administrative notes This information can tion only be viewed by editors 89 Objects properties in dLibra system Element Property Multilin gual Required Description Publica tion Link This value is automatically generated by the system It is a permanent link to a publication in a digital library It is com posed of a publication part and public ation s identifier ie for publication which have identifier 10 the link would be publication 10 In order to view inform ation about the publ
14. can be used 4 2 6 Languages management WWW application in dLibra system may have different language versions for example users visiting digital library from England see WWW pages buttons names labels etc in English while users visitng digital library from Poland see WWW pages in Polish These languages are interface languages By default users have two languages avaliable Polish and English In order to add new interface language it is required to translate buttons names labels etc Additionally administrators have to remember to provide collection names attributes names etc in new interface language because users see this information on WWW pages In dLibra system there are also metadata languages Edition s bibliographic description edition s description and comment are specified in metadata languages On the WWW pages users may choose both interface language and metadata language The choice of interface language is independent from the choice of metadata language and vice versa therefore it is possible that user have WWW pages presented in English but specific edition s metadata in Polish When Interface languages or Metadata languages node is selected administrator may set languages that are used in dLibra system Currently used languages are selected on languages table In order to add remove language select deselect check box corres ponding to the language Every language type metadata and interface has t
15. common administrator s tasks using the dLibra Administrator s Application 4 2 1 Creating removing collection 4 2 1 1 Creating and removing library collections To create a new collection 50 Library Manager 1 Inthe Library Tree select the library collection which will be the supercollection for a newly created one From the popup menu select the New collection function Alternatively the toolbar button or main menu options can be used 3 In the New Collection Wizard enter name description and notes for the new collec tion Press Finish button to create the collection Figure 4 2 New Collection Wizard New collection wizard Help Hew collection name and information Language dependent values Name New collection Description i Language independent values OAI PMH identifier dLibraDigitalLibrary Notes To remove a collection 1 In the Library Tree Select the collection to be removed 2 Press the Delete button Alternatively a context menu or a pull down menu can be used 4 2 2 Managing publications in collection There is a possibility to manage publications membership for a given collection A user who has a right to manage a given collection can add publications to it and remove publications from it An interface enabling it is placed on a tab named Publications available after choosing a certain collection in Collections Tree 51
16. from the beggining of 245b subfield if this sequence will be found at the beggining of this subfield So if in the MARC file subfield 245a will have abStories value then the application will transform it to Stories value which will be imported to the bibliographic description Default configuration By default MARC extension is configured using the following files e marcImport properties tee Aor ales Ol Ole iA Oreo Si Ol AiO CieSacow i OOp IKOR Subject Description 6XX Publisher 260a 260b 260f Contr ioeo r nOr Date 260c Type Identifier 920 856u Source Language 041 546 Relation 250 534 440 490 800 810 811 830 Coverage Rights 506 540 e marcImpRemChars properties This file is empty by default 79 Appendix B Export to RDF format B 1 Note This appendix describes configuration files used for exporting bibliographic de scription to RDF format It is dedicated to dLibra administrators RDF Resource Description Framework is a format for specifying properties of a given subject RDF format is used in dLibra to specify metadata bibliographic description In this case the subject is an element e g publication and the properties are specified as attributes values More about RDF format can be found here RDF export configuration file There is one RDF format configuration file e systemurl properties this file should contains an URL which specified the namespace f
17. gt Rights separated with a comma The list of possible rights e pv publication view e pr publication read e pe publication management edit Attribute publication collections 45 Editor s Application Collections identifiers separated by a comma to which publication is be assigned to Attribute publication destination directoryId Destination directory identifier Attribute publication destination parentPublicationId Destination group publication identifier Attribute publication mainFile The name of the publication main file including extension Specified file has to be in directory describing this publication Attribute publication metadataFile Metadata filename including extension Metadata file has to be accordant with RDF format and it has to be placed in directory describing a publication By default metadata filename is the same as publication main file name except the extension it is rdf Attribute publication name Publication name Attribute publication notes Administrative notes concerning publication Attribute publication published Attribute indicating whether the firs edition of this publication should be published or not If the value is true edition will be published In any other case the edition will not be published Default value is false Attribute publication secured Attribute indicating whether the publication should be secured or not If the value is true publication will b
18. in fn doc document fn local name Description fn local name Subjex rdf_dce Description for x in fn doc document fn local name Description fn local name De rdf_dc Publisher for x in fn doc document fn local name Description fn local name Pub rorsGe Cont ripuver tor Sx in insdsot Gaocument 7 7 neiees nome Description 1 7 twetocal name C rdf_de Date for x in fn doc document fn local name Description fn local name Date re rdf_dce Type for x in fn doc document fn local name Description fn local name Type re rdf_dce Identifier for x in fn doc document fn local name Description fn local name Ide rdf de Source for Sx in fnz dee idecument fms local name Description fazlcocal name Source rdf_dec Language for x in fn doc document fn local name Description fn local name Langi rdf_dc Relation for x in fn doc document fn local name Description fn local name Relat rdf_dc Coverage for x in fn doc document fn local name Description fn local name Cove rdf_dce Rights for x in fn doc document fn local name Description fn local name Rights As we can see conversion properties file contains conversion rules which correspond to tests in tests properties file The key in conversion properties file is composed of the key from tests properti
19. must be properly prepared They all must be placed in the same directory on a local user disk Furthermore the files must have the precise format of name Base segment of a name must be the same in all files they must be differentiated only by the ordinal number placed just before the file extension for example test01 jpg test02 4pg test03 jpg etc 3 2 2 Using Publication Creator Publication Creator is composed of three tabs Data Information about publication and Templates If Generate pages button is pressed application generates publication files in the directory chosen by the user Cancel button closes the window 22 Editor s Application 3 2 2 1 Data tab Figure 3 11 Publication Creator Information about files tab Publication Creator CE On the Data tab user may choose files to use when generating publication files Choose file button allows user to select one of the files which will be used in generation process When the file is selected fields in a File panel are filled with values e Filename base segment of files name e File type files format e Begin index the number of the first file that will be used to generate a publication e End index the number of the last file that will be used to generate a publication These values may be edited by the user Particularly changing the index values may be useful if publication is not meant to contain all images placed in a chosen director
20. of the page file For more information about Velocity format visit Velocity homepage ht tp jakarta apache org velocity user guide html Typical editor s tasks This section describes typical editor s tasks Full list of operations which may be per formed on specific objects can be found in Appendix H List of operations concerning objects of the dLibra system 3 3 1 Moving and removing elements To remove an element 1 In the directories tree or on the elements list select an element to remove 2 From the popup menu select Delete option and confirm operation Alternatively a main menu or toolbar only in case of an element selected on elements list can be used In case of publication and directory which contains at least one publication it is possible to specify remove reason for publications The remove reason is presented to the WWW if a user attempts to read publication There are two ways of moving an object The first way is possible when editor application has two elements list visible see In order to move selected element from one list to the open element of the second list press F6 key Remember that moving huge amounts of object eg directory may cause high server load caused by information actualization The second way is to use Drag and drop this way you can move element between elements list and directories tree 3 3 2 Creating directory To create a new directory 1 On the elements list sel
21. placed The table has two columns In the right column library structure is placed the same as in Directories Tree but not editable An element in the right column in Directories Tree is selected or not when corresponding check box on the left side is selected or not There are three possible states of this check box e a state possible for every element In case of a directory it means that none of the publications which it encloses is assigned to selected collection In case of a publication it means that the publication is not assigned to selected collection K state possible only for directories and it means that a directory encloses both publication s which are assigned to selected collection and publication s which are not assigned to selected collection state possible for every element In case of directory it means that all publica tions in this directory are assigned to selected collection In case of publication it means that the publication is assigned to selected collection Modifying check boxes publications assignment to collection is modified 52 Library Manager All changes have to be approved by pressing Apply button on the bottom right of Prop erties Window 4 2 3 Library attributes management Library Manager application allows user to manage attributes in dLibra system It is possible through interfaces available after choosing attributes node or single attribute node in Library
22. shall be stored in In the Files to download table the default file selection can be altered To exclude a file from the download list uncheck the appropriate position in the Present column Additionally the version to be downloaded can be changed using a pull down list in the Version column It is possible to download the publication as the zip archive In order to do this check Download zipped publication check box Press the Next button to proceed to the file download page 37 Editor s Application 4 Figure 3 24 Download Wizard publication file selection page Download wizard X Help Steps Files to download 1 Choose the files you want Destination directory C Documents and Settings tparkola Pulpit to have downloaded ed files to Files to download Present File name Version mini i 20050610 Lawica Pla 6 13 05 8 33 AM 2005061 0 Lawica Pla 6 13 05 8 32 AM 2005061 0 Lawica Pla 6 13 05 8 32 AM 20050610 Lawica Pla 6 13 05 8 32 AM 2005061 0 Lawica Pla 6 13 05 8 32 AM 20050610 Lawica Pla 6 13 05 8 32 AM 20050610 Lawica Pla 6 13 05 8 32 AM 2005061 0 Lawica Pla 6 13 05 8 33 AM findex html 1 29 07 9 06 AM E index rdf 12 18 06 11 31 AM ipage12 htmi 12 16 05 6 31 AM Fil thecied 3 html 4 17106 946 A O00 NOOOOoOo0o0000 Setect at ceara ZIP compression C Download zipped publication In the second step Figure 3 25 Downloa
23. tests properties file master for x in fn doc document fn compare fn name msDescription 0 return x rdf_dc for x in fn doc document fn compare fn local name RDF 0 return x conversion properties file master Title for x in fn doc document msHeading title return x master Creator for x in fn doc document msHeading author return x master Description for x in fn doc document msContents overview return x master Publisher for x in fn doc document msContents respStmt resp name return x master Contributor for x in fn doc document msDescription msContents respStmt resp return x master Date for x in fn doc document msHeading origDate return x master Type for x in fn doc document physDesc form return x master Identifier for x in fn doc document msIdentifier country settlement repository idno return master Source for x in fn doc document msPart idno return x master Language for x in fn doc document msContents textLang return x master Language for x in fn doc document msContents textLang otherLangs return x master Rights for x in fn doc document msIdentifier repository return x 81 XML metadata import rdf_dce Title for x in fn doc document fn local name Description fn local name Title rdf_de Creator for x in fn doc document fn local name Description fn local name Creat rdf_dce Subject for x
24. the next step press the Next button It is to possible to create the user here by pressing the Finish button Figure 4 12 New user wizard general information New user wizard x Help Steps General information about new user 1 Specify general General information information 2 Add user to groups 3 Set usel Lastname Name e mail E mail Institution Institution Identifier Login Password Confirm password User type Editor Administrator x Expiration date March 13 2007 r Doesnt expire o Locked In the second step Figure 4 13 New user wizard assigning to groups assign user to groups Member of list constains groups which the user will assigned to Not member of list contains groups which the user will not assigned to Press the Next button to go to the next step 62 Library Manager Figure 4 13 New user wizard assigning to groups New user wizard X Help User s groups Groups management Member of Not member of Fe U ytkownicy publiczni 5 Inthe third step Figure 4 14 New user wizard assigning administrative rights assign administrative rights to user the meaning of rights is described in Press the Next button to go to the next step Figure 4 14 New user wizard assigning administrative rights Z New user wizard
25. time the author has modified document again body html and title jpg file has changed and new logo gif file has been added The editor has created third edition which groups the newest versions of body html and title jpg file and first version of logo gif file Summing up publication is composed of three editions These editions group files in concrete versions Publication contains also three files which group concrete files versions eg title jpg file groups version 1 1 and version 1 3 and file logo gif groups one version 1 1 Introduction Figure 1 1 File versioning and publication editions Sample Fist edition Second edition Third edition publication Initial version 1 1 Ld logo gif Initial version Version Version Version Li 13 1 4 15 tite jpg b Initial version Revised version Version Version Version L1 1 2 13 14 L5 E Another example picture below presents dependencies between publication its editions files and files versions The picture below presents a publication which contains two editions and two files Files contain concrete versions while editions group these versions WWW user reader sees the publication and its two editions When he wants to see the content of specific edition than dLibra system serves files versions which this edition groups Figure 1 2 Struktura publikacji Publication a txt v 1 1 a txt v 1 2 file b txt bat vit 1 6 Object s propertie
26. url Contributors dentifier Language Relation Coverage Righnts 83 Appendix E Attributes values Synonyms Dictionary E 1 E 2 The idea of Synonyms Dictionary The Synonyms Dictionary has been introduced in dLibra library in order to improve mechanism of searching library resources User entering a phrase which has to be a key for searching may decide to extend the query by information included in dictionary It gives them a better chance to find publications they looked for and on the other hand doesn t require for them to know the specific format of data used in attributes values In example let user input in a filed author value Shakespeare to search for library resources If this query will be processed without synonymous extension only publica tions containing values with a character subset Shakespeare for an attribute author in bibliographic description will be found However if there is a group containing both values Shakespeare and Szekspir polish translation of the name for attribute au thor then user deciding to extend the query with a dictionary information will get as a result list of all publications that have Shakespeare or Szekspir set as an author value This means that they don t have to know which format of this writer s name was used by librarians to describe his publications The other examples of synonymous connection between attribute values may be putting picture a
27. 4 Library Manager Figure 4 16 New group wizard general information New group wizard a Help Steps General information about new grou Specify general General information information 2 Add Set group s administrative ights Name Name Description Description In the second step Figure 4 17 New group wizard assigning users assign users to group If a user is placed on the Members list then the user will be assigned to new group zostan dodani do nowej grupy Press the Next button to go to the next step It is to possible to create the group at this point by pressing the Finish button Figure 4 17 New group wizard assigning users New group wizard x Help Group s users Users management Members Non members a admin a Janek A jkowalski QD jsmith oF public g3 65 Library Manager 5 In the last step Figure 4 18 New group wizard assigning administrative rights assign administrative rights to group Detailed information about the meaning of particular right can be found in Press the Finish button to create the group Figure 4 18 New group wizard assigning administrative rights New group wizard x Help 3 Set group s administrative rights Group s administrative rights Rights management C Account managing C Group ma
28. Dublin Core 1 1 but there is a possibility to modify it The values of object attributes are considered while searching the library and are the key element to identify certain resource Schema is in practice object s biblio graphic description In case of default schema Dublin Core 1 1 the description consist of information about author title publishing date publisher etc Objects which have bibliographic description are e planned publication e edition e group publication e directory Other library resources Apart from the library content i e publications dLibra manages some other resources A system of users and groups of users facilitates right management All rights can be granted on user or group basis assigning a user to a group gives him or her all the rights the group has In dLibra an attribute which is a part of bibliographic description is also a resource Thus attributes can be created and altered by the library administrators Chapter 2 Program installation and startup 2 1 Installing and running dLibra GUI applic ation dLibra GUI application installation is maintained by dLibra library administrator In order to run this application Java 2 Virtual Machine version 5 0 or newer is needed If the library administrator has installed the application and he or she has created the shortcut e g on the desktop to dLibra GUI application then in order to run the applic ation double click on the short
29. PG test02 gif E Moje rozszerzenia Google Gadgets 3 D5C00128 rdf Pulpit E Moje wideo DSC00129 JPG O My Skype Content D5C00129 rdf o My Skype Pictures DS5C00130 IPG I fy M j notes D5C00130 rdf oje dokumenty O Nerovision index html O Odebrane pliki E przyklady T Default rdp M j komputer z desktop ini page1 html page2 html przyklady zip server xml ED G Ee EN S E S D A D A ee lt i gt p File name Open Moje miejsca 7 7 sieciowe Files of type al Files iy The metadata export dialog allows user to specify the destination file and the format of the destination file Press Export button to export metadata 3 1 6 Rights Editor The Right Editor Figure 3 8 Right Editor publication rights enables user to alter users access rights to publication There are three rights which can be granted to a user or group of users for selected publication 18 Editor s Application View The permission to read all published editions of a publication Read The permission to read all editions of a publication Manage The permission to manage the publication e g to create a new edition or grant access rights Figure 3 8 Right Editor publication rights dLibra Publication Browser admin Jee Program Edit View Management Publication Tools Help BSsSeGBTRALBES 5 0 Biblioteka Cyfrowa Biblioteka Cyfrowa D Bibli
30. Tree Attributes in dLibra system are stored in a certain order which is important in view of presenting bibliographic description of library resources For every attribute and the attributes node it is possible to manage the order of its subattributes on the Attributes order tab Figure 4 4 Attributes order management Figure 4 4 Attributes order management dLibra Zarzadzanie Biblioteka admin BAX Program Edit Management View Help eno Seuss Attribute Subattributes order values 3 0 Library resources Users Attributes Attribute information E Grupy o a Grupy LDAP 3 Attributes Dublin Core ver 1 1 Temat i sowa kluczo I O Title Opis H O Creator Wydawca HO Subject and Keywords Wispd ttworce Description Data wydania Publisher Typ zasobu Contributor Format 2 Date identyfikator zasobu Name Tytu H O Resource Type Fr dto AS HO Format Description 4 Resource Identifier Jezyk Source Powi zania HO Language Zakres H O Relation Prawa iO Coverage HO Rights Management LS Metadata languages a Interface languages Po Library directories 9 Library collections J gt Down EE On the left side there is a list of attributes and on the right side there is information about currently chosen attribute These values are only informational and cannot be edited here Order of attributes in the list can be easily changed using Up and Down buttons
31. User Guide for version 3 0 of the dLibra system Poznan Supercomputing and Networking Center Edited by Tomasz Parkola User Guide for version 3 0 of the dLibra system by Tomasz Parkota Copyright 2002 2007 Poznan Supercomputing and Networking Center Table of Contents I Introduction 4 4005 s i ea oni hw eel etn een A A ea anaes olin 1 1 1 dLibra digital library framework 0 0 0 0 cece cceeee cee eeeneeeeeeeeeaeeeeaeneeees 1 12 ALibra systern Usero oeae eaae EEEE EEE EAEE VES E AANE OE VEE VAAS EA AEEA AA Y 1 Loe DIFECLOTIES sccecct sage esagetostgstesageestgntesagezeotoete cme e enr sete EE TEE eE 2 124 CONECHONS inai savas EEEE EEEE EEE AEE E E a E Ea es 2 Vs Publication sc ci1 Sereserdareuce ee ann ni s manas N Snes tale dss deleauregeresieres 2 1 5 1 Publication s editions files and files versions sseessesseesrereeereee 3 1 6 ODJECUS Properties ore n a nes NRE A nee RS 4 1 6 1 Multilingual properties 2 00 0 e E EE E KO EEE 5 1 6 2 Object s bibliographic description s ssesssesesseereserseeressesreseereeresses 5 1 7 Other library TESOULCES ssc vives aire JAKTAN ESIET Candas Can lav lan lad SAKEA NEATA ES ARAT TAR 5 2 Program installation and startup ssssssesseesesreserstesresessesresreseeseesesreseeseereerereeee 6 2 1 Installing and running dLibra GUI application eseeeseesseseesesrereeresreseeseess 6 2 2 Logging into the dLibra GUI application and running editor or adminis
32. XML files details about XML can be found here XML metadata import extension uses XQuery language details about XQuery can be found here To make the import avaliable appropriate configuration for the XML extension has to be provided By default XML extension configuration allows editor to import metadata from RDF and MASTER format both formats use XML to present metadata XML extension is configured using two property files property files contain key value pairs e tests properties file contains XQuery queries which test what kind of file is to be imported e conversion properties file contains rules for conversion XML metadata files to dLibra metadata Relation between both files is very strict for every XQuery test in tests properties file there are corresponding conversion rules in conversion properties file For a given metadata XML file import mechanism performs each test query from tests properties file If the result have one or more values then metadata are imported from XML file using conversion rules corresponding to successful XQuery test from conversion properties files tests properties file contains XQuery queries which test whether the metadata file may be imported using corresponding to XQuery test conversion rules The key identifies conversion rules in conversion properties file For example let us assume that we have the following files this example presents ex tension s default configuration
33. a DIGITAL LIBRARY FRAMEWORK Library Manager te FR The main window of the Administrator s Application is divided into two parts The Library Tree which is located on the left provides access to library resources such as library users groups and attribute schemes as well as to the directory of library content On the right property dialogs are displayed accordingly to the element selected in the library tree 4 1 1 Library Tree The Library Tree is divided into three subtrees resources tree directories tree and collections tree Resources tree contains nodes of the following types users node contains nodes representing library users 49 Library Manager 4 2 user node represents single library user groups node contains nodes representing user groups group node represents single user group LDAP groups node contains nodes representing LDAP group nodes visible only whe dLibra is configured in such a way that it uses LDAP server LDAP group node represents one LDAP group attributes node contains nodes representing attributes defined in the library attribute node represents single attribute m languages management allows administrator to manage lenguages available in the system Apart from the node corresponding to library resources the Library Tree contains a node providing access to the library content The structure of the node is explained in detail in Edit
34. a collection notes content is language independ ent e Publication planned normal and light deleted Name defines name of a publication identifying it in dLibra system publication name is language independent and is visible only in Editor s Application and Library Manager Notes administrative notes for a publication notes content is language inde pendent e Edition Name defines name for an edition which is language independent edition name is visible in WWW application Description description defines certain edition and contains basic information about it eg abstract visible also in WWW application edition description is language dependent and should be defined for each language separately Comment comment contains additional information about the edition eg in formation about errors or damages in case of old books scans visible also in WWW application edition comment is language dependent and should be defined for each language separately Notes administrative notes for an edition notes content is language independent 12 Editor s Application e Miniature a picture representing a miniature of an edition if miniature is chosen it will bew seen in web application 3 1 5 Bibliographic description editor 3 1 5 1 Attributes values dLibra system provides an advanced attributes values bibliographic description management mechanism to allow describing library elements with metadata M
35. adata file inheritance This mechanism works in the same way as for publication properties files with one exception parent file should have publication rdf name So if we will specify in publication properties file attribute publication metadataFile it will be checked if there exists its parent publication rdf 3 4 6 2 4 Examplary properties file Menu item Save properties file in menu Tools makes it possible to save information describing selected on the elements list publication such a file can be used as an ex ample for mass publication upload 3 4 7 Editor s application configuration After choosing the Configuration option from the Program menu configuration window will appear Figure 3 34 Application s configuration window 47 Editor s Application Figure 3 34 Application s configuration window a Configuration Program settings Extensions configurarion View settings C Always show publication s editions C Automatically add main file format to imported metadata Tabs placed in configuration window are responsible for configuration of particular application features In the following sections all the tabs are described 3 4 7 1 Program configurarion Program settings tab enables user to adjust editor program view This configuration is connected with editor program modes If Always show publication s editions option is not checked then editor appli
36. altered by checking unchecking appropriate positions in the Add column of the publication files table Press the Next button to proceed to the file upload page Figure 3 26 File Update Wizard updated files directory page New files versions wizard a Help Updated files directo Steps t LETS WG JE Te Source directory and Settings tparkola przykladypublikacje samoloty_nowe containing the updated files Main publication file index html 2 Upload new files to the dLibra Publication files server Add File name Last modified Last added Encoding T mini _ T 20050610 Jun 13 2005 9 Jun 13 2005 8 T 20050610 Jun 13 2005 9 Jun 13 2005 8 m 20050610 Jun 13 2005 9 Jun 13 2005 8 M 20050610 Jun 13 2005 9 Jun 13 2005 8 T 20050610 Jun 13 2005 9 Jun 13 2005 8 M 20050610 Jun 13 2005 9 Jun 13 2005 8 T 20050610 Jun 13 2005 9 Jun 13 2005 8 m 20050610 Jun 13 2005 9 Jun 13 2005 8 ml E index html Feb 26 2007 8 Feb 21 2007 7 Select modified Clear all Publication consistency New files 0 Files missing 0 4 Press the Start button to start uploading selected publication files to the server The process can be paused and resumed pressing the button again 39 Editor s Application After the uploading process finishes press
37. ation will be secured copying printing will not be possible applies only to HTML publications 31 Editor s Application Figure 3 20 New publication wizard general information e 2 New publication wizard Help Publication general information General information and settings Administrative information Notes Enter publication general informe First edition C Published Do not expire Main file C Documents and Settings tparkola Moje dokumenty przyklady publikacje userguide_pdf userguide pdf z Uploading files on the server is the last step Figure 3 21 New publication wizard creating publication on the server Press the Start button to create publication on the server The process can be paused and resumed by pressing the button again During the creation process on the Progress panel all operation which have to be performed are presented Operation which is being performed is marked with bold font For every operation elapse time is measured and presented in seconds in the brackets after the operation name Progress bars inform about progress the operation When all operations are finished short summary is presented During the creation process it is possible to cancel it e g press the Cancel button 32 Editor s Application Figure 3 21 New publication wizard creating publication on the server Z New publication wizard Help Steps
38. ation wizard general information ea Add files to planned publication wizard Help Steps Publication main file 1 Choose the main Main file Moje dokumenty przykladypublikacjewserquide_pdfiuserquide pdf publication file alion iles to the Publication directory C Documents and Settings tparkolatMoje dokumenty przyklady publikacjewserguide_ Publication files tree Choose File name Type Size Last modified Encoding gzs usergui Adobe Acroba 2 808 732 Apr 24 2006 1 Check not linked Uncheck not linked Publication consistency Files checked 1 Files missing 0 Total size 2 742 KB Cie f Caa 3 3 6 Adding content to planned publication To add files to planned publication l 2A On the elements list select a planned publication which you want to add files to From the popup menu select Add files Add content wizard consists of two stepts The first step is the same as the firts step of new publication wizard The second step Figure 3 23 Add content wizard sending content files on the server allows sending publication content on the server In order to send selected files in the first step press Start button 34 Editor s Application Figure 3 23 Add content wizard sending content files on the server Add files to planned publication wizard Help Steps Publication files upload Choose the main publication file Upload
39. be altered in the Publication Properties panel Rights tab 74 Library Manager Figure 4 26 Publication level rights editor dLibra Library Manager admin BAF Program Edit Management View Help Lay resources Rights 3 0 Library resources a Users Users Rights sE Groups rao 7 A E LDAP groups is admin Right Current state New state Recursion 2 Attributes A Janek Przegl danie pu Not granted al F I Metadata languages had Odezyt publikacji Not granted Oo O Loofal Interface languages Zarz dzanie pub Not granted E L e Ro Library directories D Biblioteka Cyfrowa 2 Biblioteka A 2 Biblioteka B Nazwa OP public Fe U ytkownicy publiczni 0 Jan Kowalski Oo Przyk ady Se Gazeta Swiat amp Przyk adowa 20 Library collections C FX wig Cancel 4 4 Access domains management In dLibra for every library user it is possible to define a number of access domains so that from some places in the Internet the user can access the library without authen tication from other access is denied or requires entering a password The most important part of an access domain definition is the set of addresses the access restrictions should apply to The address can be defined by specifying e a single DNS name e g rose man poznan pl e a DNS address mask e g poznan pl e a single IP address e g 62 21 18 55 e arange o
40. blished Do not expire Modified by admin Files size 1 KB In order to remove edition two condition have to be fulfilled e Edition is not the only one edition of publication e Edition is not published Remove edition choosing Delete option from context menu 3 4 5 Managing publication files There are three mechanisms which allow publication files management The first one is file version removal File version can be removed when it is not the only one version of a file and it is does not belong to any edition The second mechanism is file removal File can be removed when none of its versions belongs to any edition The third mech anism is automatic deletion of redundant files Redundant files of publication are files and files versions which may be removed In order to delete redundant files choose Re move redundant files option from context menu of Publication files element it is available after publication is opened only in advanced mode 3 4 6 Mass publication upload In this section it is described mass publication upload mechanism 3 4 6 1 Mass publication upload wizard To start mass publication upload creator select Mass publication upload from Tools menu 43 Editor s Application In the first step Figure 3 32 Mass publication upload creator publications selec tion we specify publications which will be sent to dLibra server First step s window is splitted into two pa
41. bra system have to groups of values which contain blue sad group and divine group In such case the user have to decide either the blue is a color divine group or it is a state of mind sad group 15 Editor s Application Figure 3 4 Group selection for a value Choose group Attributes groups zamek Entered attribute is unequivocal Choose a group the entered value belongs to zamek zatrzask The bibliographic description is language dependent which means that the user may specify metadata in a number of languages To view modify bibliographic description in specific language user have to select appropriate tab The name of the tab is two letter abbreviation of the language name and it is pictured by the icon representing the language 3 1 5 3 Universal metadata language Let us assume that in our library we provide bibliographic description in two languages English and Polish In order to provide an author of a specific publication the editor has to put this value in both languages In order to modify this value the editor has to modify it in both languages separatelly for each language In such situation the author value is universal which means that it concerns two languages the same value should be provided for each language In order to simplify creation of bibliographic description in such situations special universal language has been added to dLibra system marked as Univ on b
42. cation works in simple mode otherwise it works in ad vanced mode Switching mode in editor application this option is switched in fact The meaning of the option is described in Table 3 1 Differences between editor s application work modes 3 4 7 2 Extensions configuration Extensions configuration tab allows user to specify extensions configuration List of configurable extensions is placed on this tab Figure 3 35 Configuration Extensions configuration tab In order to change setting of specific configuration select extension from the list and press Configure button Figure 3 35 Configuration Extensions configuration tab a Configuration I r Program settings Extensions configurarion Configuration Select extension and press Configure button Format komunikacyjny MARC 21 Format XML Format BibTex RDF Format _ 48 Chapter 4 Library Manager This chapter describes the dLibra Administrator s Application with regard to the most common library management tasks 4 1 Administrator s Application main win dow Figure 4 1 Administrator s Application main window a dLibra Zarzadzanie Biblioteka admin Bax Program Edit Management View Help Library resources 30 L Users a E Grupy a Grupy LDAP a Attributes BE Metadata languages i WE Interface languages 26 Library directories O Library collections dLibr
43. configuration file format eeeeeeeeeeereeeerreerereee 77 A 2 marcImpRemChars properties configuration file format eee 78 A 374 Default configuration sson a un eh ahs eta oa sea saah Sse eaeee ss 79 Be Export to RDF format monone aieia ou sent EOE OA EENE coments 80 B 1 RDF export configuration file eesesseesseeeseessreerereerrrsesrrrererererseesreeeseres 80 C AML metadata IPOE arria taa a Aay IAAI aun aia a aa 83 D BibTeX Metadata ImPos e ea ese e aeee e Gerdes e ea e Tier e eGON 83 E Attributes values Synonyms Dictionary sessessreseerrecrseesesresresrerersesreseeserseesee 84 E 1 The idea of Synonyms Dictionary esesssesssererereresesrresrererereresreesrereeers 84 E 2 Construction of Synonyms Dictionary eessesseeseseresesrsesrererereresrreerereeers 84 F Editor s application default configuration ssssesssssserereresesrresrerererrresrersrereeeres 86 F 1 Default editor s application settings eesssessesesereeerssesrrrererererreesreeeseres 86 G Objects properties in dLibra system sesseseesessesstsersresrrererreresteneeseeresseseeseese 87 H List of operations concerning objects of the dLibra system eeeeseerecrrrresee 93 GIOSSAT 7 tes T A ET A E EAE ET AEA EE EEA ETEEN TE 97 iv Chapter 1 Introduction 1 1 1 2 dLibra digital library framework The dLibra Digital Library Framework is a set of tools that allow e Storage of digi
44. cription Description of selected attribute An entity responsible for making contributions to the content of the resource Metadata import export 41 Editor s Application 5 Enter WWW information Description which is presented on search results list Comment available on edition information page and miniature presented on edition information page To proceed to the next step press Next button Figure 3 30 New Edition Wizard WWW information New edition wizard x Steps WWW information AWAY Information Miniature _ _ _ 2 Enter metadata for the new LEEEN mm PL Unive publication WWW edition information Enter name and de the edition to be created Description brak miniatury 6 Enter the new edition s name and description in the Name and Description fields To make the new edition published check the Published option This can also be done after the edition is created To create the new edition press the Finish button 42 Editor s Application Figure 3 31 New Edition Wizard edition properties page New edition wizard Help Hew edition name and description Name Samoloty 2 Enter metadata for the new Aaminisirative infomation publication Notes 3 WWA edition information Enter name and description of the edition to be created Publikowanie C Pu
45. cut If such a shortcut does not exist in order to run the dLibra GUI application 1 Run web browser e g Internet Explorer in case of Windows operating system 2 Inthe address field type the library web address and add the nlp ending For ex ample if the library web address were www wbc poznan pl then you should type ww wbe poznan pl jnlp therefore add to the web address the nlp ending 3 Approve the web address e g press the ENTER key 4 Wait until needed file will be downloaded and application will be started 5 If during the application startup secuirity question will appear press Always button 6 On the screen login window should appear Figure 2 1 Login dialog Figure 2 1 Login dialog dLibra login BAX Help User profile admin v User ID admin Password admin localhost Program installation and startup 2 2 Logging into the dLibra GUI application and running editor or administrator applica tion Before any task is performed using dLibra GUI applications an authorization process must be carried out After the dLibra GUI application startup login dialog Figure 2 1 Login dialog will appear on the screen The needed authorization data user id password can either be entered directly in User ID and Password fields or stored in a login profile Login Profiles Editor Figure 2 2 Login Profiles Editor makes it possible to add new profiles o
46. d column contains information which indicates wheter the property is required yes or not no Description column contains short description of the property 87 Objects properties in dLibra system Table G 1 Objects properties Element Property Multilin Required Description gual Directory Name No Yes Directory s name Directories are only seen by editors in editor administrator applica tion Directory Notes No No Administrative notes ie information about elements in the directory This information can only be viewed by editors Directory Attributes Yes No Directory s bibliographic description is the values default description for elements such as publication which will be created in this directory When creating a new element in a directory user may provide bibliographic description of this new element By default this description is filled with values from the directory User may also modify this default description Directory Identifier Identifier cannot be modified as it is auto matically assigned by the system This is unique identifier of a directory Group Name No Yes Group publication s name in dLibra sys publica tem tion Group Notes No No Administrative notes This information can publica only be viewed by editors tion Group _ Identifier Identifier cannot be modified as it is auto publica matically assigned by the system This is tion unique identifier o
47. d wizard file download page press the Start button to start downloading the selected publication files to the selected local disk directory The process can be paused and resumed pressing the button again After the downloading process finishes press the Finish button to close the wizard Figure 3 25 Download wizard file download page 2 Download wizard x Help File download 2 Download selected files to your computer Press Start to start downloading 38 Editor s Application 3 4 3 Adding new files versions After modifying some of files of an existing publication for the changes to take effect the files must be sent back to the server and the for example new edition can be created based on newly added filed To send the updated files to the server I On the elements list select the publication to which the new file versions shall be assigned From the context menu select the Add new files versions function Alternatively the toolbar 4 button or main menu options may be used In the Add new files versions wizard select the local disk directory that contains the updated publication files Selected directory has to contain publication main file Missing files are marked by Q The wizard selects files to update based on the modification and storage dates By default files modified after the last store add operation are selected The selection can be
48. destination directory only e Publication main file It is specified by publication mainFile attribute and it is re quired e Publication name There are two ways to specify publication name First way is to specify publication name attribute If this attribute is not specified metadata file will be checked in order to compose publication name in the same way as in fourth step of new publication creator it is composed of title author and date So metadata file is the second way 3 4 6 2 2 Inheritance in publication properties files Inheritance mechanism was introduced in order to simplify assigning some attributes from publication properties file Inheritance mechanism works in the following way For every publication properties file which is to be read let us name it a child it is checked if there exists a public ation properties file in the upper directory let us name it a parent If the parent file exists its content is read then the content of child is read During the reading process there is a rule that says that attribute values are overridden It means that if both parent file and child file specify the same attribute the child s attribute value is taken parent attribute value is overridden Notice that this mechanism works recorsivelly It means that before the parent file is read it is checked if there exists its parent if yes it is read 3 4 6 2 3 Met
49. e it is 245 field So the 245 a b n template will combine 245 field s subfields a b and n in one value These subfields will be separated with space as specified in the template For example if the subfield 245a has first value value subfield 245b has second value value and subfield 245n has third value value then the result will be first value second value third value If there is a need to separate these values with anothed character not space place them instead of the space in the template e g 245 a b subfield n n There are few exceptions characters semicolon backslash and to interpret these characters correctly by the application two additional backslashes have to be placed before e g 245 S a b n e 008 35 37 concerns only control fields it means extracting a range of chararcers from the control field This template is combined from two parts separated by the slash character 1 008 the number of control field which range of characters will be extracted from 2 35 37 this is the rance of characters which will be extracted from the filed number which is placed before slash The entry means that the character on the position 35 36 and 37 from the 008 control field will make the value If the 008 control field on the 35th position has an e character on the 36th position has an n character and on t
50. e secured In any other case it will not be secured Default value is false Examplary publication properties file pu pu pu pu pu pu pu pu lication actorsRights publicGroup pv pr ILsL she Oi 5 COLLEC ONS Sa 7 A lication destination directoryId 1 lication mainFile index htm lication metadataFile metadata rdf lication name Przyktadowa publikacja lication notes Stworzone przez Jana Kowalskiego D D D D D D D D lication published true Above examplary file specifies a publication publicGroup will have right to view pv and read pr it Publication will be assigned to collections indicated by identifier 2 7 and 12 Publication will be placed in the directory indicated by identifier 1 Publication main file will be index htm and metadata are in metadata rdf file Publication name 46 Editor s Application is Examplary publication and administrative notes are Created by John Smith First edition of this publication will be published and publication itself will not be secured To create publication it is required a minimal set of informations described below It it is impossible to gain all these informations it is impossible to creata a publication e Publication destination in Directories Tree There are two ways to specify it destin ation directory publication destination directoryld attribute and destination group publication publication destination parentPublicationId attribute or
51. e send publication to the server Figure 3 33 Mass publication upload creator publications upload shows a window of the second step To send publications press Start button During the upload process is it is possible to monitor the progress throught to the progress bars When the process finished appropriate summary is shown If for any reason uploading of one or more publications failed it is possible to check error messages by pressing the Errors details button 44 Editor s Application Figure 3 33 Mass publication upload creator publications upload Mass publications upload x Help Steps Upload files and create publications 1 Directories selection 2 Create publications Press Start button to start upload 3 4 6 2 Structure of a directory describing a publication Directory describing a publication consists of publication properties file which describes publication Optional RDF file which contains bibliographic description fo the publication Publication files 3 4 6 2 1 publication properties file publication properties file is publication properties file It consists of attribute value pairs Attribute is separated from value by the equals sign Every pair is placed in separate line Possible attributes and their values are presented below Attribute publication actorsRights lt user login or group name to which we will assign rights
52. ect destination directory parent directory of new directory 2 From the popup menu select New directory function Alternatively the toolbar button amp or Management main menu option can be used 3 Inthe New Directory Wizard enter name and description for the new directory Press Finish button to create the directory 26 Editor s Application Figure 3 14 New Directory Wizard New directory wizard Help Hew directory name and notes Name New directory Administrative information Notes 3 3 3 Creating a new group publication To create a new group publication l On the elements list select the directory or group publication the new group public ation should belong to From the popup menu select the New publication function Alternatively the toolbar or Management main menu option can be used Enter the name and notes for the new group publication and click Finish button to finish 3 3 4 Creating a new publication Note Before a new publication can be placed in the library all its files must be present in a directory on a local disk To create a new publication l 2 On the elements list select destination directory or destination group publication From the popup menu select the New publication function Alternatively the toolbar button or Management main menu option can be used In the first step of the New Publication Wizard F
53. eeeneeneees 27 3 3 4 Creating a new publication aiioe ceeeeecee cece ceeceeeeeeeeeeeeeeneees 27 3 3 5 Creating a new planned publication cece eeeeceeee eee eeeeeeeeeeeees 33 3 3 6 Adding content to planned publication 2 0 0 0 eee ceneen eee een tenes 34 3 3 7 Publishing publication s edition 2 0 0 0 cee esses ceeceeeeeeeceeeeeneeee 35 3 3 8 Deleting publication s Content 2 0 0 0 eee eeeceeceece eee eeeeeeeeeeenteneeneenes 35 33 9 Changing password aiea AE gan deugaaden ATN 36 S29 SCAT CHING eis occ ca eve haar ks tea hE AS ENd AEN T OS E RO ONEC 36 3 4 Advanced editor s tasks harrin nenio en hea a a eee a a as 36 3 4 1 Editor s application modes views sesssesesessssesesesssresesessesesesee 36 3 4 2 Downloading an edition of a publication eeeeeeeeeeeeererrrerrerrrere 37 3 4 3 Adding new files versions ssssssssessessessrserstsresreereresresresresessess 39 3 4 4 Creating removing an edition of a publication eeeeeeeeeceeereerreeee 40 3 4 5 Managing publication files 2 0 0 eee eeeeceeeeeeneceeeeeeeaeeeeueeeenees 43 3 4 6 Mass publication upload 2 0 0 eee eee nee ceeceeceeceeceeaeeaeeaeeaeeaeeaees 43 3 4 7 Editor s application configuration e cece eeeseeeceeeeeeneeeaeeeeeeeeeees 47 As Library Manager sorre E lee ieee eeu ecegoneewaen R donot ech gee donget eos uae deuet cuss 49 4 1 Administrator s Application main Window ssssessessesessesresresrerereereerere
54. em It is used for example in specifica tion of conversion rules for metadata im port Attribute Role No No Role of an attribtue in Dublin Core schema Attribute Identifier No Yes Identifier cannot be modified as it is auto matically assigned by the system This is unique identifier of an attribute 92 Appendix H List of operations concerning objects of the dLibra system Table below presents operations that may be performed on objects from editor admin istrator application Every row contains the following information Element column contains the name of an object element Operation column contains the name of op eration which may be performed on the element Access column describes the place where the operation can be found and performed Description column contains short description of the operation 93 List of operations concerning objects of the dLibra system Table H 1 Operacje Element Operation Access Description Directory New direct Management menu Operation allows editor to create a ory toolbar context menu new directory in selected directory Directory New public Management menu Operation allows editor to create a ation toolbar context menu new publication in selected directory Directory New group Management menu Operation allows editor to create a publication toolbar context menu new group publication in selected d
55. em installation and configuration etc and general topics concerning digital libraries and dLibra system Editor application forum and administrator application forum is reserved for editor and administrator application users All the forums can be found under http www dlibra psnc pl forum If you have any questions problems suggestions we invite you to post it on the forum dLibra system users Users of the dLibra system may be divided into three common types e Administrator manages digital library creates users and groups of users grants rights to users and groups can create and modify library structure can use all of Introduction 1 3 1 4 1 5 the dLibra system applications administrator editor WWW but generally uses administrator application e Editor creates digital library adds new documents publications to library creates or imports bibliographic description for documents groups documents generally has limited access to administrator application uses editor application e Reader dLibra system user which has access only to web pages WWW placed on the Internet can browse and read documents publications created and made available by the editor cannot use neither editor nor administrator application every person which visits dLibra web pages is treated as a reader These are three types of uses commonly used in digital libraries based on dLibra Each has different duties and nature Admini
56. er login of a user User uses this identifier to log in to the system User Password No No User s password These two properties allow confirm to change user s password password User User type No Yes Value represented as a list Types of user are described in User Expira No No After this date user account expires user tion date cannot log in to the system User Blocked No Yes Value represented as a check box Account can be blocked by an administrator when check box is selected Blocked user cannot log in to the system User Access do No No Access domains foe the user It is possible mains to specify computer addresses that have access to the system without password or addresses that are blocked User Groups gt List of gruops that a user belongs to User Adminis 7 Rights which may be assigned to a user trative See for more details rights Group Name No Yes Name of a group in dLibra system Group Descrip No No Description of a group tion Group Members List of users which are members of this group Group Adminis Rights which may be assigned to group trative See for more details rights Attribute Name Yes Yes Name of an attribute in dLibra system This name is presented on WWW pages Attribute Descrip Yes Yes Description of an attribute in dLibra sys tion tem Description is presented on WWW pages Attribute RDF No Yes Unique identifier of an attribute in dLibra name syst
57. erged system won t merge these groups and in stead will show a dialog with information that this operation cannot be proceeded Before merging groups it must be assured that there are no duplicate values names in groups 4 2 4 2 Managing the attributes values All actions can be performed after choosing a certain group in the left list To add a value to a group 1 Ina text field placed below the values list enter the name for a value that should be added to a group Name cannot be already in use by other value in a group 2 In order to add a value press an Add button placed beside the text field To remove a value from a group 1 Choose a value from the right list that has to be removed 2 Press the Remove button placed beside the list Value will be removed from the list and from the system 58 Library Manager Caution If the chosen value is assigned to a bibliographic description of some library element the system won t delete such a value and will show a dialog with informa tion that all connections should be removed instead To change the value s name 1 2 Choose a value which name should be changed Press the Edit button A dialog allowing to edit a value will appear Enter a new name for a value and press Apply button If the group s base value was edited then the group will get a new name as well Figure 4 9 Editing an attribute s value s name Value edition Help Attribute va
58. es Implies the Access List Read and Publication create permissions in the current directory and Publication view and manage per missions for all publications in this directory Rights management enables a user to alter access rights for the directory Inherited from the parent directories Implies the Access List and Read permissions The directory level access permissions can be altered in the Directory Properties panel Rights tab 72 Library Manager Figure 4 24 Directory level rights editor dLibra Library Manager admin BAX Program Edit Management View Help i Ki resources Rights 3 50 Library resources is Users Users Rights Groups oF x z rs D LDAP groups yy admin Right Current state New state Recursion 2 Attributes Access Not granted al F HE Metadata languages List Not granted LI 0O WE Interface languages Read Not granted L Ro Library directories 2s Nazwa Structure edit Not granted im O D Biblioteka Cyfrowa Of public Publication create Not granted d L D Biblioteka 4 Suin Publication mana Not granted d 2D Biblioteka B U ytkownicy publiczni Right management _ Not granted a Oo a Jan Kowalski Oo Przyk ady Se Gazeta Swiat lt Przyk adowa 20 Library collections E TE On the list on the left library users na in black having at least one right in grey having no rights and groups in red are sho
59. es file dot and dLibra attribtue s identifier RDF name Values resulted from queries which are in conversion properties file will be assigned to attributes with specific RDF name Let us assume that we want to import file A which contains metadata in XML format Import mechanism performs XQuery queries which are placed in tests properties file The first test which results with non empty list of values decides which conversion rules will be applied for metadata import Let us assume that it was a test which key is metadata Import mechanism chooses conversion rules from conversion proper ties file all keys which start with master Then values from XQuery queries are as signed to specific attribute for example to attribute with Tit le RDF name the mechan ism assigns values from query for x in fn doc document msHeading title return x If there is a need for an attribute to have more that one query then line with additional query should be added for example Language has two queries Wvery XQuery query should use document string to specify document on which the query is performed Extension automatically replaces this string with appropriate path to XML file 82 Appendix D BibTeX metadata import Editor administrator application functionality may be extended with so called extensions It is possible to add extension which imports metadata from external sources BibTeX import extension is an extension of this type It allows
60. ete files versions where by the file s version we understand a file in a specific time e g file from 17 01 2006 at 07 32 am It covers with the information from previous paragraph document A is the first version which groups files versions sent to editor after the document was created Document A groups files versions sent to editor after modification Summing up the first public ation s edition created automatically when creating publication groups files versions of the document A the second edition groups files versions of the document A In ad dition if the document was composed of many files and the modifications done by the author were not refered to all the document files then the second edition would group files from document A not modified files and files from document A modified files To explain versioning more precisely let us follow an example illustration Figure 1 1 File versioning and publication editions Let us assume that at the beggining a docu ment is composed of one file body html Editor creates a publication in the dLibra system by pointing out this file as a content System creates publication and automat ically adds a new edition which groups first version of body htm1 file After some time the author has modified body htm1 file and added title jpg file The editor has created second edition which now groups body htm1 file second version and title jpg file first version After some
61. f IP addresses e g 62 21 17 55 62 21 18 55 For every library user any number of rules address gt action can be defined The action can be either to allow access without authentication without entering a password or to deny access The rules can be defined in User Properties panel Access domains tab 75 Library Manager Figure 4 27 User access domains ra Zarz dza n Program Edit Management View Help R y Library resources z User Groups Administrative rights Access domains 5 6 Library resources a Users Domain list _ Domain properties admin r aan A jkowalski i a jenih Oh public AX Grupy J E Grupy LDAP J Attributes Domain type WE Metadata languages O DNS Name i WE Interface languages 5 20 Library directories ziskan 4 9 Library collections Ge Address mask PP address From 150 254 5 100 To 150 254 5105 Address range Action Deny access O Without password LEE x Use the Add button to add new access domains and the Delete to remove access domains In the Domain Properties panel address type and action can be specified 76 Appendix A MARC import extension By default attributes values import from MARC 21 communication format is based on built in configuration It is also possible to use external configuration defined in text files The tex
62. f a publication Group Attributes Yes No Bibliographic description of a group public publica values ation is inherited by elements which are in tion this group publication If bibliographic de scription of an element does not have val ues for specific attribute and group public ation has such values then bibliographic description of the element will be filled up with the value from group publication For every element such bibliographic descrip tion is automatically created when it is presented on WWW pages Internally in editor administrator application biblio graphic description of an element is separ ated from group publication s description Planned Name No Yes Planned publication s name in dLibra sys publica tem tion 88 Objects properties in dLibra system Element Property Multilin Required Description gual Planned Notes No No Administrative notes This information can publica only be viewed by editors tion Planned Link This value is automatically generated by publica the system It is a permanent link to a tion publication in a digital library It is com posed of a publication part and public ation s identifier ie for publication which have identifier 10 the link would be publication 10 In order to view inform ation about the publication on WWW page the user have to run a browser Internet Explorer Firefox etc
63. ge e 2 New publication wizard Help Steps Publication rights Choose the main publication U ytkownicy file 2 Enter metadata for the new x admin publication a Janek ah jkowalski jsmith Fs Nazwa Set publication rights sation to collections ion information 6 Enter publication general Not granted Not granted Not granted gt gh 4 8 Main file Documents and Settings tparkola Moje dokumenty przyklady publikacje userquide_pdF userquide pdf 6 In the fourth step Figure 3 18 New Publication Wizard publication s collections page user may assign publication to collections See Publication s collections ed itor for details Press the Next button to move to the next step Figure 3 18 New Publication Wizard publication s collections page a New publication wizard Help Steps Publication collections 1 Choose the main publication Collections file 2 Enter metadata for the new s Collection name publication 5 Digital Library 3 Set publicatio J go E Math Add publication to d D Regionals collections o i Exhibitions edition information Enter publication general infor n Upload publication files to the Unmark all Collection information Description Main file Documents and Settings tparkola Moje dokumenty przyklady publikacje userguide_pdf userguide pdf Help lt Back Next gt nis
64. h 30 Editor s Application In the fifth step Figure 3 19 New publication wizard WWW information it is possible to specify WWW information concerning the first edition of the new public ation WWW information consists of Description short edition description e g what does it concern visible on WWW search results page it is recommended to provide the description possibly short one or two sentences Comment characteristic information concerning the edition e g specific marks for example the lack of one page Miniature graphic edition representation visible on the WWW edition information page Press the Next button to move to the next step Figure 3 19 New publication wizard WWW information 2 New publication wizard Help Steps WWW information Choose the main publication VW Information Miniature for the new EEEN mm PL Uniw Description brak miniatury Comment Select Main file Documents and Settings tparkola Moje dokumenty przyklady publikacje userquide_pdF userquide pdf 8 Step sixth Figure 3 20 New publication wizard general information allows user to provide general information Notes administrative notes concerning publication First edition panel which allows for publishing the first edition uncertain or time publishing Secured if checked public
65. he 37th position has a g character then the value of such a entry will be eng If it is needed to ex tract only one character from a given position simply specify the character position after the slash character e g 008 30 A 2 marcImpRemChars properties configur ation file format end 245b a b begin 245a 0S 2 end 260c c 78 MARC import extension A 3 An examplary marcImpRemChars properties file is presented above This file enables user to define characters or series of characters to remove from values of MARC subfield before this value is imported to bibliographic description The charac ters can be removed both from begin and end of the subfield Characters are defined using regular expression Regular expressions which may be used in this mechanism have to be conformant with Java lt regular expressions details can be found here Line end 245b a b means that from the end the word end of the 245b subfield a or b character will be removed if of course one of these characters will be found at the end of the 245b subfield Minus separates the place begin or end from which we re move the characters and the subfield 245b from which we remove the characters After the equals character regular expression which defines characters to remove is specified Let us analyze the following example begin 245a ab This record will couse that the application will remove the ab characters sequence
66. he elements list You can open an element on the list by doubleclicking on it or by pressing ENTER key when the element is selected In order to go one level up press BACKSPACE key or doubleclick element on the first position this elements is not displayed when main directory is opened as there is no higher level than main directory The path to currently opened element is displayed on the top of the elements list When user selects an element on the list properties window bottom left part of the window is filled with information about the selected element Types of elements possible on the elements list D directory node represents a library directory may contain subdirectories and publications e group publication node represents a group publication which may contain publications including group publications planned publication node represents planned publication and does not contain nodes 10 Editor s Application publication node represents a publication in advanced mode contains publication editions nodes and publication files node whereas in simple mode when publication has only one edition contains files versions of this edition removed content publication node represents publication which content was removed contains only publication editions nodes edition node represents an edition of a publication contains all versions of publication files that compose the edit
67. he path to main library collection Collections editor allows user to assign publication to a number of collections When publication or group publication is selected on the elements list the collection editor is available on the Collections tab 20 Editor s Application 3 2 Figure 3 10 Adding publication to collections dLibra Publication Browser admin TAX Program Edit View Management Publication Tools Help BeSeeBERAGLES E D Biblioteka Cyfrowa D Biblioteka A Identifier D Biblioteka B t D Jan Kowalski F D Przyk ady So Gazeta wiat Publication Rights Collections Edition Attributes values WAWY Information Collections Collection name O D Digital Library 5 Math Oo i D Regionals F 5 Exhibitions Unmark all Collection information Description Notes Cancel To assign a collection to selected on the elements list publication check appropriate check box To remove the assignment deselect appropriate check box Check boxes are placed on the left side of the collection s name If the collection icon is green it means that currently logged user has rights to manage this collection and may change the assignment of a publication Red icon indicates that user do not have appropriate rights to change the assignment of the publication in a collection If a collection name is marked with a bold font it means that selected publication will belong to this col
68. his value cannot be modifies It is last sion modification date of this file version File ver Type Type cannot be modified It is the type of sion file version File ver Descrip No No Description of file version It is an internal sion tion information for editors Collection Name Yes Yes Collection name in dLibra system This name is presented on WWW pages Collection Descrip Yes No Collection s description Description is tion presented on WWW pages Collection OAI PMH No Yes Identifier used in distributed resources identifier search mechanizm This identifier should be unique on one level of collections Collection Notes No No Administrative notes This information can only be viewed by editors Collection Identifier Identifier cannot be modified as it is auto matically assigned by the system This is unique identifier of a collection User Name No No Data about the user first name and sur name User e mail No Yes User s e mail address It must me unique every user have to have different address User Institu No No Data about user ie institution where the tion user is employed 91 Objects properties in dLibra system Element Property Multilin Required Description gual User Identifier No Yes This value is provided once when creating user When user is created it is not modifi able This is unique identifi
69. ibing library element with a set of attributes means assigning these attributes concrete values taken from dictionary One attribute may be assigned many different values Such an approach causes that every modification of attribute value for instance name change deleting or moving value to a different group influences bibliographic description of all resources being connected with this value For example if there are many Mickiewicz s publications in a system and all of them are connected with the 84 Attributes values Synonyms Dictionary same attribute s value then fixing a mistake in this value will cause fixing description of all those publications Managing of Synonyms Dictionary is available in Library Manager application 85 Appendix F Editor s application default configuration F 1 Default editor s application settings Editor s application by default is set to simple mode Section 3 4 1 Editor s application modes views and adds automatically maila file format when new metadata are impor ted 86 Appendix G Objects properties in dLibra system Objects properties avaliable in dLibra system has been described in the table below One row contains the following pieces of information Element column contains the name of an object Property column contains the name of a property of an object Multilingual column information whether the property is multilingual yes or not no Require
70. ibliographic description editor tab This language is created only for editors to make their work easier bibliographic description in universal language is not visible on WWW pages Values from the universal language are automatically added to bibliographic description of other languages when presenting these on WWW pages For example let us assume that in editor and administrator application we have typed the value of Title attribute in universal language for edition A On edition A WWW page the user see this value in every language The bibliographic description presented in concrete language e g Polish or English is filled with values from universal language all the values from universal language are added to bibliographic description of a language selected on WWW page Please notice that values from universal language are added not replaced to values of other languages 16 Editor s Application 3 1 5 4 Metadata import Attributes values editor allows bibliographic description to be imported from external file which structure is in specific format Digital library administrator may add so called extensions to application in order to enable metadata import in specific format By default extensions for the following formats are added e MARC 21 communication format details can be found in application configuration and Appendix A MARC import extension e XML format default configuration allows to import metadata fro
71. ica tion WWW page using permanent access point to publication Publication Delete Management menu toolbar context menu Operation allows editor to delete publication Before the operation is performed editor may give a deletion reason This reason is presented to WWW users which visit publication WWW page using permanent access point to publication Publication without content Delete Management menu toolbar context menu Operation allows editor to delete publication Before the operation is performed editor may give a deletion reason This reason is presented to WWW users which visit publication WWW page using permanent access point to publication 95 List of operations concerning objects of the dLibra system Element Operation Access Description Edition New edition Management menu Operation allows editor to create a toolbar context menu new edition basis on selected edition By default in new edition wizard files versions which are grouped by selected edition are chosen Edition Download Management menu Operation allows editor to download files toolbar context menu edition s files Edition Delete Management menu Operation allows editor to delete edi toolbar context menu tion Edition may be deleted when it is not the only edition of publication it is not published and it is not edi tion of publication wi
72. ication on WWW page the user have to run a browser Internet Explorer Firefox etc and specify address composed of digital library address appen ded by the Link ie for a digital library which address is www wbc poznan pl we would have www wbc poznan pl publica tion 10 Publica tion Secured Yes This value is represented as a check box If this check box is selected then the con tent of editions will be secured from copying and printing on WWW pages This property may be checked only for HTML publica tions Publica tion without content Publication without content has the same properties as normal publication One dif ference is that the user cannot modify these properties can only view them Edition Name Yes Edition s name in dLibra system Edition Notes Administrative notes This information can only be viewed by editors Edition Published Yes This value is represented as a check box If this check box is selected then users which have view right to the publication may view this edition Edition may also be published until some date in the future after this date the edition is automatically set to be not published Edition Modifica tion Editor cannot modify this value it is automatically updated by the system The value is an identifier login of a user which has lately modified this edition Edition Files size Editor cannot
73. igned to an attribute if it has a special meaning in a system and it s value is used in other contexts dLibra system lets user to assign attribute one of the following roles e Contributor e Coverage e Creator e Date e Description e Format e Language e Publisher e Relation e Resource identifier e Resource type 54 Library Manager e Rights management e Source e Subject and keywords e Title 4 2 3 1 Adding and removing attributes To add new attribute 1 Choose attributes node in the Library Tree An interface to manage attributes will appear on a tab Attributes management 2 Click Add button placed below the attributes list on the left 3 In the New Attribute Wizard enter name and description for an attribute for all languages Enter the RDF name a unique attribute identifier To create new attribute press Apply button Figure 4 6 New Attribute Wizard Z New attribute Help Language dependent values o sa Em wm PL E 2H Description Language independent values RDF Name Role lt no role gt m Newly created attribute will appear as the last element in attributes list and will be grayed Unless changes are committed by clicking Apply button there is no way to edit it or change it s order After applying it s colour changes to black and attribute is fully functional To remove attribute 1 In the Library Tree select the attribute s node t
74. igure 3 15 New Publication Wizard main publication file page select the main publication file If the publication 27 Editor s Application content is in one file for example PDF or MS Word document choose this file If the publication is composed of many files e g HTML files choose top level file in case of HTML usually index html If the main publication file is an HTML or DJVU file the wizard will try to find all publication files and verify consistency of the files If there are any problems with files consistency Warnings button will be activated so the user can press this button to see warnings It is strongly recommended that only complete publications without missing files are put into the library However using the Ignore inconsist ency option it is possible to proceed with an incomplete inconsistent publication All files that the publication consists of will be added to publication files table There is no way to uncheck them they all will be sent to the server Beside publication files all the other files in main file s directory are listed on the files table By default these files are not checked to send to the server However it is possible to add additional files Notice that the main publication file and cannot be unchecked and it will always be sent to the server Press the Next button to move to the the page Figure 3 15 New Publication Wizard main publication file page New pub
75. igure 3 28 New Edition Wizard file versions selection page New edition wizard x Help Steps Hew edition file versions Choose the file versions ee to make the edition Edition files Enter metac or the n Present File name Version E mini 20050610 Lawica Pla 6 13 05 8 33 AM 20050610 Lawica Pla 6 13 05 8 32 AM 20050610 Lawica Pla 6 13 05 8 32 AM 20050610 Lawica Pla 6 13 05 8 32 AM 20050610 Lawica Pla 6 13 05 8 32 AM 2005061 0 Lawica Pla 6 13 05 8 32 AM 2005061 0 Lawica Pla 6 13 05 8 32 AM 2005061 0 Lawica Pla 6 13 05 8 33 AM zai index html 1 29 07 9 06 4M E index rdt E jpage12 html E page13 html E jpage14 html E page15 html E page 6 html E tpage17 html OOOOOOOsoOo0o0000000 Select all Clear all 4 In this step enter bibliographic description for new edition It is possible to import bibliographic description from MARC 21 lub RDF format To proceed to the next step press Next button Figure 3 29 New Edition Wizard bibliographic description page Z New edition wizard x Help Metadata description Attributes BEJEN attribute name Attribute value Enter metadata for the mm PL new publication Dublin Core ver 1 1 A Univ Title Bamoloty ition information Creator iption of Subject and Keywords Description Publisher Contributor Date Resource Type Format v Clear des
76. importing bibliographic description from BibTeX files details about BibTeX can be found here In order to import bibliographic description BibTeX extension has to be properly con figured BibTeX extension is configured using one property file property files contain key value pairs e bibtexImport properties file contains rules of conversion from BibTex format to dLibra metadata format Let us assume that we have the following bibtexImport properties file Creator book author Title title booktitle Description note Publisher publisher Date month year Type type Subject keywords Source url Contributor dentifier Language Relation Coverage Rights In the file key is attribute s RDF name and value is a list of fields tags of entries from BibTeX format Concrete fields in the list of fields should be separated by the semilocon For example line 1 to Creator attribute values from author field book entry will be assigned notation book author If there is a need to import field values from any entry asterix character should be used instead of entry name for example line 2 to Title attribute value from filed title and booktitle any entry will be assigned notation title booktitle The following configuration is used as default Creator author Title title booktitle Description note Publisher publisher Date month year Type type Subject keywords Source
77. ion publication files node contains all publication files e folder node folder icon the same as in operating system represents a folder that groups publication files or publications files versions e publication file node icon depends on the file type represents a publication file contains all versions of the file e version node icon depends on the file type represents a single version of a public ation file With every node a context menu is associated that provides quick access to the most common operations performed on a given type of element e g adding new files versions Context menu is called by clicking a right mouse button on a node Two toggle buttons are placed on the bottom of the elements list These buttons allow to hide specific elements Currenlty it is possible to hide planned publications and publications with removed content 3 1 2 2 Description of selected elements e Publication The structure of publication is described in In addition publication in dLibra system may be secured Only HTML up to version 3 2 higher versions may be in correctly displayed publications can be secured Secuirity mechanism disallows reader to copy save or print publication content 3 1 3 Properties Window Properties Window consist of a set of tabs the number depends on the chosen element s type Each tab contains properties editor which allows user to change some properties of selected element
78. irectory Directory New Management menu Operation allows editor to create a planned toolbar context menu new planned publication in selected publication directory Directory Delete Management menu Operation allows user to remove se toolbar context menu lected directory including elements which are in it Group pub New Management menu Operation allows editor to create a lication planned toolbar context menu new planned publication in selected publication group publication Group pub New public Management menu Operation allows editor to create a lication ation toolbar context menu new publication in selected group publication Group pub New group Management menu Operation allows editor to create a lication publication toolbar context menu new group publication in selected group publication Group pub Delete Management menu Operation allows editor to remove lication toolbar context menu selected group publication including publications which are in it Planned Add con Context menu Operation allows editor to add con publication tent tent to planned publication During this operation planned publication becomes normal Planned Delete Management menu Operation allows editor to remove publication toolbar context menu selected planned publication Publication Add new Management menu Operation allows editor to add new files ver toolbar context menu files versions to publication files sio
79. l as for group publication for which this directory is a direct parent 13 Editor s Application Figure 3 2 Attributes values editor eg Z4 dLibra Publication Browser admin Program Edit View Management Publication Tools Help BeSeesBTKAEGaS JEE D Przyk ady D Biblioteka A 2 Jan Kowalski D Biblioteka B Se Gazeta wiat E m Biblioteka Cyfrowa Biblioteka Cyfrowa Element Identifier IL Jan Kowalski O Przyk ady Se Gazeta Swiat Przyk adowa 2 amp Publication Rights Collections Edition Attributes values ywa Information _ Attributes lst Attribute value mm PL DUDIN Core ver 1 1 Univ Title Planes Creator Subject and Keywords planes Lawica Description Publisher Contributor Clear description Description of selected attribute Show with inherited values The topic of the content of the resource Metadata import export Attributes Values Editor is available on Attributes values tab It allows user to describe a library element with a set of attributes available in system Bibliographic description is presented in a table with two columns Attributes tree is placed in the left column values assigned to attributes are in the right column Every attribute may have many values Every value is presented in separate row starting from the row with attribute name If an a
80. lected source When Automatically detect option is selected application tries to detect source format and import the metadata automatically If the file to import contains more that one set of metadata the application will ask the user to choose one Figure 3 6 Choose metadata set 17 Editor s Application Figure 3 6 Choose metadata set Select a record p Multiple records Found ae Please select a record Biotoksycznos produkt w mikrobiologicznych przemi x 3 1 5 5 Metadata export Attributes values editor allows bibliographic description to be exported to external file which will be saved in specific format Digital library administrator may add so called extensions to application in order to enable metadata export in specific format By default extensions for the following formats are added e RDF format see application configuration and Appendix B Export to RDF format for details on conversion configuration In order to export metadata to a file press Export button Metadata Figure 3 7 Metadata export dialog export dialog will show up Figure 3 7 Metadata export dialog Ba Open Lookin Moje dokumenty x i paa A O mini O a Moja muzyka Moje bie ce a Moje foldery udostepniania dokumenty B Moje ksztatty desktop rdf 3 style css dLibra license E style rdf DSC00127 JPG fi trof DSC00127 rdf amp test01 gif AN Moje obrazy DSC00128 I
81. lection directly or indirectly When collection is checked all its super collection are also marked with a bold font It means that the selected publication is indirectly assigned to all supercollections and directly assigned to checked collection All the changes must be applied using the Apply button Choosing different element or clicking the Cancel button discards all changes since the last apply action Publication Creator This chapter contains information about Publication Creator which has been added as a part of Editor s Application 21 Editor s Application 3 2 1 Publication Creator s functions Publication Creator generates WWW pages in HTML format basis on the files provided by the user WWW pages contain references to these file or and the content of these files e g pictures Publication Creator is useful when user wants to create a compact document containing files they have for example picture gallery in a simple quick way Creator fills document templates with files in case of pictures it prepares also miniatures and saves as a final publication on a local user s disk After publication is generated dLibra system asks if the user wants to add this publication to the library If yes new publication wizard is started In the first step user selects destination either directory or group publication The remaining steps are the same as for new publication wizard Before the publication is generated all files
82. lication wizard Help Steps Publication main file Choose the main Main file tparkolalMoje dokumenty przyklady publikacjeluserguide_pdfluserguide pat publication file Publication directory C Documents and Settings tparkola Moje dokumenty przykladypublikacjewsergquide_pdf 2 Enter metadata for the new publication Publication files tree File name Type Size Last modified Encoding M A userguide pdf Adobe Acrobat 2 808 732 Apr 24 2006 10 34 AM o collections ormation 6 Enter publication general information n files to the Check not linked Uncheck not linked Publication consistency Files checked 1 Files missing 0 Total size 2 742 KB In the second step Figure 3 16 New Publication Wizard attribute values page publication may be described with a set of attributes Bibliographic description may be imported from an external file e g MARC RDF Master Bibtex Attributes values editor and import mechanism is described in the part concerning Bibliographic description editor In order to proceed to the next step a publication name has to be given field with Name label By default the name is created basis on bibliographic description throught combining the title author and publishing date For example 28 Editor s Application if the title is Stories author is John Smith and the publishing date is
83. lue Enter new attribute value application rdf xml To merge two values in a group l 2 Choose the value that should be merged with other value Press the Merge button placed beside the values list After confirming a new window will appear with the values list From a new list choose a value to which previously chosen value should be merged to Edition field up the window makes it easier to find the values with names con taining certain set of characters An All button brings all the values back to the list To finish the operation of merging the values press Apply button Previously chosen value will be merged with new one which means that all connections to it will be removed with connections to a new one To move a value to a new group l 2 Choose a value that has to be moved to a new group Press the Move button After confirming a new window will appear with the groups list that this value may be moved to From a new list choose a group to which previously chosen value should be moved to Edition field up the window makes it easier to find the groups with names con taining certain set of characters An All button brings all the groups back to the list 59 Library Manager Figure 4 10 Attribute s name edition dialog Target element Help Target element application octet stream application rdf xml image gif imagejpeg texthtml Cancel To finish the o
84. m RDF and MASTER format details can be found in application configuration and Appendix B Export to RDF format e Bibtex format details can be found in application configuration and Appendix A MARC import extension In order to import metadata from external resource press Import button Metadata Figure 3 5 Metadata import dialog import dialog will show up Figure 3 5 Metadata import dialog 2 Open Lookin 44 Moje dokumenty x amp JEE El mini E desktop rdf gt style css a Moja muzyka E dLibra license E style rdf Moje biezace a Moje foldery udostepniania DSC00127 IPG E t rdf dokumenty Moje ksztalty 3 D5c00127 rdf testOL oif ah Moje obrazy DSC00128 IPG test02 gif E Moje rozszerzenia Google Gadgets DSC00128 rdF Pulpit E Moje wideo D5C00129 JPG D My Skype Content f DSC00129 rdf My Skype Pictures D5C00130 IPG fy M j notes E 0500130 rdF oje dokumenty O NeroVision E index html Odebrane pliki E page1 html A przyklady E page2 html Q Default rdp BS przyklady zip M j komputer a desktop ini f server xml lt W e File name Moje miejsca z sieciowe Files of type an Files The metadata import dialog allows user to specify the source of the bibliographic de scription file or URL to file and the format of the source file Press Import button to import metadata from the se
85. m the View menu The differences between the modes views are presented on the Table 3 1 Differences between editor s application work modes 36 Editor s Application Table 3 1 Differences between editor s application work modes Feature Mode Simple mode Advanced mode Publication properties window e Ifthe publication has only one Afrter expanding publication all edtion the edition is not visible its editions are visible Files ver after expanding the publica sion which compose the edition tion edition s files versions are are visible after expanding edition visible All the properties for the edition and publication can be specified on the tabs in the node e Ifthe publication has more that one edition these editions are visible after expanding the publication it is the same situation as in the advanced mode 3 4 2 Downloading an edition of a publication In order to further edit an existing publication its files must be downloaded into editor s local machine To download an edition of a publication l On the elements list select the edition to be downloaded it can be the current edition as well From the context menu select the Download function Alternatively the toolbar L button or main menu options can be used In the first step Figure 3 24 Download Wizard publication file selection page select the local disk directory the publication files
86. modify this value it is automatically updated by the system The value is total size of files which belong to this edition Edition Attributes values Yes Bibliographic description of an edition This description should correspond to the con tent of edition Generally every ediiton should have bibliographic description 90 Objects properties in dLibra system Element Property Multilin Required Description gual Edition Descrip Yes No Short description of an edtion This descrip tion tion is presented on WWW pages It should contain description of edition s content short characteristic of the resource Edition Comment Yes No Comment to edition It may be expanded It should contain additional information about the resurce ie information about damage on pages that were scanned Edition Miniature No No Icon which represents edition It may be for example scan of first page of a book File File name File name cannot be modified It is the name of a file which is a part of publication File File type File type cannot be modified It is file type of a file which is a part of publication File ver File name File name cannot be modified It is the sion name of a file that this version refers to File ver File size File size cannot be modified It is the size sion of file version File ver Modified T
87. mport export Show with inherited values Cancel 3 Press the Remove connections button All editions and directories will be removed 4 4 2 5 Users and groups management from the list Caution In case user has no rights to modify any of the editions or directories a dialog will appear informing about the problem and no connections will be removed Press the Apply button to finish the process of removing the connections 4 2 5 1 Library users management To create a new library user l 2 In the Library Tree select the users node or a user node From the popup menu select the New user option Alternativelly choose button from toolbar or opcje New user from Management menu In the first step Figure 4 12 New user wizard general information provide user s general information Identifier e mail address and password are required Choose one of the three user types Administrator editor dLibra system user can log in to any application including editor and administrator application usually his her task is administration of the dLibra system or library content creation Reader WWW user cannot log in to editor and administrator application can log in on WWW pages and modify information concerning his her account 61 Library Manager e Reader with restrictions has the same possibilities as the Reader excluding possibility to modify his her account To go to
88. naging C Attributes managing C Attribute values management C Collection managing Oo WAA application managing To remove a group l In the Library Tree select the group to be removed 2 Press the Delete button Alternatively a context menu or a pull down menu can be used 4 2 5 3 LDAP groups management Note To understand this section basic knowledge about LDAP is required To create a new LDAP group l 2 In the Library Tree select the LDAP groups node or an LDAP group node Select the button from toolbar or choose New LDAP group from popup menu You can also choose New LDAP group option from Management menu In the first step of new LDAP group wizard Figure 4 19 New LDAP group wizard general information specify general information 66 Library Manager Figure 4 19 New LDAP group wizard general information New LDAP group wizard X Help LDAP group s definition neral information Base path o airius com Define LDAP group g Attributes Attributes list Assigned attributes C Add J M Remove J In the second step Figure 4 20 New LDAP group wizard defining LDAP group define group Assign group attribtues and base path Attributes are listed in Attrib utes list Assigned attribute value pairs are listed in Assigned attributes list To add attribute a Enter attribute name or select it f
89. nd photo in the same group for format attribute or putting polish polski polish translation of polish word pol and pl in the same group for language attribute Construction of Synonyms Dictionary dLibra system stores Synonyms Dictionary for attributes values This dictionary con tains at least all those values used in bibliographic descriptions of library resources but is not limited to those values and may contain phrases not used in a system Sep arate dictionary is kept for each attribute and each language dictionary contains at least all those values used in bibliographic descriptions of library resources but is not limited to those values and may contain phrases not used in a system Separate diction ary is kept for each attribute and each language For a given attribute and language the dictionary is divided into the groups of synonyms Each group can contain one or more values It is supposed that values belonging to the same group should either be synonyms or words having the same meaning or words in some other way connected with one another In every group there is one marked value named base value The group always takes it s name from it s base value For a single attribute there may not exist more than one group having the same name For a single group there may not exist more than one value having the same name however values with the same name may exist in the separate groups for a single attribute Descr
90. ns New files versions are usually added in order to create a new edition from them 94 List of operations concerning objects of the dLibra system Element Operation Access Description Publication Change files Context menu Operation allows editor to change files of publication After this opera tion publication has completely new files specified in wizard the old file are deleted This operation is avail able when the publication has only one edition which is not published Additionally none of the publication files may have more than one ver sion These constraints are to make this operation available only in the erly stages of publication existence Publication New edition Management menu toolbar context menu Operation allows editor to create a new edition of the publication By default the newest files version are selected to be the content of this new edition Publication Download files Avaliable only in ad vanced mode when publication has only one edition Management menu toolbar context menu Operation allows editor to download publication s edition files Publication Delete con tent Management menu toolbar context menu Operation allows editor to delete content from all publication s edi tions Before the operation is per formed it is required to give a dele tion reason This reason is presented to WWW users which visit publ
91. o have de fault language Default language is used when the system cannot find the language corresponding to WWW user For example let us assume that we have system with English default and Polish interface language and Polish default metadata language When user from Germany visits WWW pages then default English interface language and default metadata language Polish will be chosen to present data because there is no German interface metadata language 69 Library Manager Figure 4 22 Languages management Z dLibra Library Manager admin AX Program Edit Management View Help R Library resources Languages management 3 F Library resources Select description languages 8 Users EEY E 7 B E Grupy Default language Polish 3 amp Grupy LDAP Select Language 2 Attributes Albanian amp GE Metadata languages Arabic GE Interface languages O Belarusian 20 Library directories f Bulgari 59 Library collections H ie Vv Chinese Croatian TC Czech Danish v Dutch v English Estonian v Finnish French German Greek Hebrew F Hindi India Hungarian Icelandic Italian v Japanese F Korean Latvian 0 _fithuanian on
92. o remove 55 Library Manager 2 Click the right mouse button on it and select Delete option If the attribute is con nected with values then system will ask for confirmation if not the attribute will be removed 4 2 3 2 Attributes editing To edit properties of an attribute l 3 Choose single attribute node in the Library Tree An interface to manage attributes properties will appear on a tab General information Enter or choose new values in the fields Name RDF Name Role and Description It is worth remembering that name and description are multilingual values If a role is chosen that some other attribute has already had assigned user will be asked to confirm the operation Assigning this role to a new attribute will cause old attribute to be assigned no role value All changes must be committed by clicking Apply button 4 2 4 Attribute s values dictionary management The following section describes in details functions and operations allowing the man agement of synonyms dictionary and describes steps to be taken to commit these ac tions Figure 4 7 Attributes values management dLibra Library Manager admin Program Edt Management View Help aax Library resources 3 0 Library resources 26 Library directories Library collections a Users 6 Grupy 3 Grupy LDAP 3 Attributes SQ Dublin Core ver 11 2 Title H O Creator 2 9 Subject and Keyw HO Descripti
93. om the autocomplete list e g by double clicinkg on its name Figure 3 3 Attribute s values list shown by the autocomplete mechanism Publication Rights Collections Edition Attributes values wiwan Information Attributes GEN Attribute name Attribute value wee PL Dublin Core ver 1 1 p A Univ Title Sal Creator Samoloty Subject and Keywords Sadownik Description Publisher Contributor Date bad Clear description i Description of selected attribute A nara niian ka kha varmi wen hava l Attribute s value can be removed from the attribute s values list In order to do it select a value on the list and press DELETE key on keyboard The value will be removed from the bibliographic description if there was only one value the field with it will be cleared if there was more than one value the row with selected value will be re moved Attention In order to save attributes values bibliographic description press Apply the bottom right corner of the Properties Window If equivocal value is present in bibliographic description user must choose the meaning of the value In order to do this application pops up choose group window see Figure 3 4 Group selection for a value so the user could choose the group the meaning that the equivocal value belongs to An example Let us assume that the bibliographic de scription contains the blue value and the dLi
94. on Publisher H Contributor H Date HM Resource Type HA Format t Resource Identifier HOA Source 5 9 Language H Relation H O Coverage 5 9 Rights Managemen Lee Metadata languages Ia Interface languages GEEN m PL Uniw Attribute Subattributes order Values Unequivocal attributes Search Show all Groups application octet streat application pdf application rdf xml image gif Remove Add A v Values text html Add 56 Library Manager Interface to manage attributes values is available after choosing a single attribute node in Library Tree and a tab named Values Panel is divided into two parts list o synonyms groups on the left and list of single group values on the right List of values is filled with values after choosing single group on the left list Each list has additionally a set of buttons allowing to perform some operations on dictionary All actions are described in details later in this section 4 2 4 1 Managing of synonyms groups To create a new synonyms group l 2 In a text field placed below the groups list a value for a base value in a new group should be entered This value will also become a name for a new group Value must not be already in use by some other group To create a new group click Add button placed beside the groups list To remove a group of synonyms l 2 Choose a single group on a groups list
95. or exported attribtue values This file is a properties file so in each line there is a key and its value separated by the equals character e g property value Configuration file should contain one line which specifies an URL defining the namespace for attribute values The key which identifies this URL is systemURL for example systemURL http dlibra psne pl The URL is usually WWW address of specific digital library Exported file may look as follows lt xml version 1 0 gt ache giiD yy xmlns rdf http www w3 org 1999 02 22 rdf syntax ns xmingrdlibre ave httpr7 adlibra psnc pis gt lt par Description tdtrabout nite 7 dlibrapsne ply publications 376 lt dlibra_avs Title xml lang pl gt Przyktadowa publikacja lt dlibra_avs Title gt lt dlibra_avs Author xml lang pl gt Jan Kowalski lt dlibra_avs Author gt lt dlibra_avs Format xml lang en gt text plain lt dlibra_avs Format gt lt dlibra_avs Format xml lang pl gt text plain lt dlibra_avs Format gt lt rdf Description gt lt rdf RDF gt Default systemurl properties file contains the following entry systemURL http www dlibra psnc pl 80 Appendix C XML metadata import Editor administrator application functionality may be extended with so called extensions It is possible to add extension which imports metadata from external sources XML import extension is an extension of this type It allows importing bibliographic description from
96. or s Application main window Figure 3 1 Editor s Application main window Z dLibra Publication Browser admin JEE Program Edit View Management Publication Tools Help BeSeSaBERABRES 3 Biblioteka Cyfrowa EEE eka lemen lentifier D Biblioteka A Element Identifi D Biblioteka B i a Jan Kowalski XS Samoloty 9 D Przyk ady S Gazeta wiat Publication Rights Collections Edition Attributes values WASA Information Name Samoloty Administrative information Notes Link Jpublication 9 The main window of the Editor s Application is divided into five parts e Directories tree placed on the left side of editor s application main window It presents hierarchical structure of the library e List of elements placed on top right part of the main window It presents a list of elements e Properties Window on the right bottom part which presents properties of an element chosen on the list of elements e Main menu placed on the top of the editor s application e Toolbar placed below the main menu enabling convenient access to most common operations e g creating new publication Default editor application view presented above can be configured by the user User may change components in places where elements list and properties window is placed In both places user may put either element list or properties window So it is possible Editor s Applica
97. or s Application The functionality is though limited only to rights manage ment for all tree objects Directories Tree is placed in a Library collections node It contains nodes of only one type collection node which represents library collection Collections are grouped in a library in hierarchical structure Each collection may contain a number of subcol lections On every level of this structure a collection may be assigned a publication Any number of publications may belong to a single collection If publication belongs to a collection it implies that it also belongs to all its supercollections on the path to main library collection A context menu is associated with collection node It provides quick access to three operations adding deleteing and refreshing a collection Context menu is called by clicking a right mouse button on a node When we select collection on the properties window we can modify properties of the collection assign publications and rights Section 4 3 4 Collection level permissions to it With every node on library tree a context menu is associated that provides quick access to the most common operations performed on a given type of element e g creating a new directory Similar to Directories Tree see Editor s Application it is possible to hide Library Tree nodes Currently it is possible to hide users nodes Basic administrator s tasks This section describes how to complete
98. ore in formation about the mechanism can be found in Appendix E Attributes values Syn onyms Dictionary The idea of synonyms dictionary is described in attributes dictionary appendix In this section only basic information is presented about how the system works and how it influences the way user describes directories group publications and editions with metadata Attributes values are kept in a system in a special dictionary It is built separately for each language and each attribute Therefore it is allowed for a value to exist more than once singly for each attribute Values of every attribute are divided into groups of synonyms The same value may exist in many groups for instance if it has many meanings Describing library resources with metadata rest on choosing a set of values for some attributes If a value doesn t exist in a dictionary it is possible to add it using Publication Browser 3 1 5 2 Attributes Values Editor The Attributes Values Editor allows user to modify bibliographic description of edition group publication or directory Bibliographic description of an edition is essential for searching mechanism in the reader s application WWW pages Description of a group publication is inherited by all the group publications and editions placed lower in the inheritance hierarchy Directory description is a default bibliographic descritpion for all newly created editions of any publication in this directory as wel
99. ossible to ma nipulate publication position using publication position editor Figure 3 9 Publication position editor publication positioning Figure 3 9 Publication position editor publication positioning Z dLibra Publication Browser admin BAF Program Edt View Management Publication Tools Help BeSeGBTRABRBSE 2D Biblioteka Cyfrowa Biblioteka Cyfrowa D Biblioteka Element aii D Biblioteka B D Biblioteka D Jan Kowalski 1 Biblioteka B i Przyk ady 5 Jan Kowalski aS Gazeta Swiat DO Przyk ady Se Nowa publikacjak Furga Smee Przyk adowa Z g Publication Rights Collections Attributes values Publications Publications Publication information e Fe Nowa publikacjakk Name ZI Position 1 Description i gt Using the Up Down To start or To end buttons on the Publications panel user may change position of selected publication Basic information about selected publication are presented on the Publication information panel 3 1 8 Assigning publication to collections Collections are grouped in a library in hierarchical structure Each collection may contain any number of subcollections On every level of this structure a collection may be assigned a publication Any number of publications may belong to a single collection If publication belongs to a collection it implies that it also belongs to all its su percollections on t
100. oteka A Element Hedi D gt Biblioteka B D Biblioteka A 2 Jan Kowalski O Biblioteka B i D Przyk ady 5 Jan Kowalski 5 e Gazeta wiat O Przyk ady TS Nowa publikaciak So Gazeta Swiat Przyk adowa 2 amp Publication Rights Collections Edition Attributes values vww Information U ytkownicy Rights ah admin ah Janek wh jkowalski 2 jsmith gt Nazwa a OF public Granted Miews Fs U ytkownicy publiczni Not granted Read Not granted _ Manage aie Every right can have one of five states Granted The permission is granted directly to the user From group The user is a member of a group that has the right granted Inherited The permission is granted to some of the parent objects e g a parent directory Implied The permission is granted because of another right granted e g a user who has a Manage right for a publication has also an implied Read right to the publication Not granted The right is not granted at all Rights to publication can be also assigned in administrator application Section 4 3 5 Publication level permissions 19 Editor s Application 3 1 7 Publication position editor Group publication may contain other publications which are ordered by an editor Publications are displayed on the WWW according to the order specified by an editor By default newly added publication appears on the last position It is p
101. peration of moving the value press Apply button Previously chosen value will be moved to a new group Caution If the chosen group already contain a value with the same name system won t move the value to that group and will show a dialog with information that this operation cannot be performed instead To change base value in a group l 2s Choose a value form the list that has to be the new base value Press New base button Chosen value will become a new base value in a group and therefore a group s name will change into a new one Caution Be sure that there is no group with the same name as chosen value If such a group already exist the operation of changing base value will not finish correctly To remove the connections of a value Choose a value from a list which connections should be removed Press the Editions button A new window will appear containing a list of editions and directories that bibliographic description is connected with the value Pressing Cancel button any time will cancel all changes made 60 Library Manager Figure 4 11 List of editions and directories connected with a value Editions and directories list Help Editions and directories list Yalue Remove connec I Samoloty Attributes Attribute value waa PL Dublin Core ver 1 1 la Univ Title Creator pet i te Description of selected attribute Metadata i
102. permission e directly granted e implied by another right that is directly granted e g the directory listing right is implied by the directory content reading right e inherited from one of the parent directories for which the permission is directly granted or implied e inherited from a group the user is a member of 71 Library Manager In dLibra there are seven directory level permissions Access makes the directory visible in a user s view of the library tree Not inherited from the parent directories List enables a user to view the content of the directory i e publications and sub directories and view the published editions of publications placed in the directory Inherited from the parent directories Implies the Access permission Read enables a user to view all editions whether published or not of all publications contained in the directory Inherited from the parent directories Implies the Access and List permissions Structure edit enables a user to edit the structure of the directory i e to create move and remove subdirectories Inherited from the parent directories Implies the Access List and Read permissions Publication create enables a user to create new publications in the directory Inher ited from the parent directories Implies the Access and List permissions Publication management enables a user to remove publications from the directory Inherited from the parent directori
103. publication files to the dLibra server Progress 1 Creating files versions 0 00 2 Uploading files contents 0 00 3 Creating publication s edition 0 00 4 Creating publication s structure 0 00 Press Start button to start upload 3 3 7 Publishing publication s edition In order that reader could read publication s edition it is required to assign to publication a read right for him and publish the edition In order to publish the edition and assign a read right to the reader 1 On the elements list select a publication which edition is to be visible for the reader 2 On the edition s general information tab Edition select Published option 3 On the rights assignment tab Rights select the user name or group name if we want to assign right to the group of users which you want to grant the read right and then select the View check box In order to approve the changes press the Apply button The publication is now visible for users which have read right assigned 3 3 8 Deleting publication s content Content deleting is useful when we want to remove publication content files but leave editions bibliographic description and delete reason To delete publication s content 1 On the elements list select a publication which content is to be deleted 2 From the popup menu select Delete content option 3 Enter delete reason Attention The reason is
104. r alter the existing ones Figure 2 2 Login Profiles Editor User profiles editor Help User profiles Wiasciwosci profilu admin Nazwa profilu admin U ytkownik admin Hasto RRRRK Host localhost Port 10051 Aod _ The default login profile defines the address and port number of the dLibra server to be used when authorizing with directly entered user id and password For the other profiles the data can be defined separately When leaving an empty password in a login profile the password shall be entered in the Password field of the Login Dialog Figure 2 1 Login dialog every time the login operation is performed After the successfull login startup application Figure 2 3 dLibra startup application is shown It enables the user to run dLibra GUI applications You can choose the ap plication by pressing on its name label e PublicationBrowser the editor s application e LibraryManager the library administrator s application After application selection loading its components is performed Information about the component being currently loaded is shown on the bottom of the startup screen Program installation and startup Figure 2 3 dLibra startup application Ei PublicationBrowser Pas LibraryManager Choose your application Chapter 3 Editor s Application This chapter describes the dLibra Editor s Application with regard to its basic components 3 1 Edit
105. remove and alter collections The administrative rights of a user can be changed in the User Properties panel Admin istrative rights tab Figure 4 23 User administrative rights tab The administrative rights of a group can be changed in the Group Properties panel Administrative rights tab Figure 4 23 User administrative rights tab Z dLibra Zarz dzanie Bibliotek admin Program Edit Management View Help Wee Library resources fo Library resources AE Users Rights management 2T admin jkowalski x m OP public amp Grupy 2 Grupy LDAP 2 Attributes ofa Metadata languages WE Interface languages 26 Library directories Obecny stan Library collections Not granted Not granted Not granted Not granted Not granted Not granted w FP T Marzena Rabiega PCSS GG 514760 4 3 3 Directory level permissions User Groups Administrative rights Access domains Nowy stan C Account managing C Group managing C Attributes managing oO Attribute values management C Collection managing Fi WWI application managing Cancel In dLibra access to the library directories is controlled separately for every single dir ectory and every single library user This means that both for the same directory different users can have different permissions and one user can have different levels of access to different directories There are four different ways in which a user can have directory
106. required because it is presented when WWW reader visits publication page 35 Editor s Application 3 3 9 Changing password Every user of the editor and administrator program may change his her password In order to change password press Change password option from Program menu Change password window will appear To change password provide current password new password and confirm new password 3 3 10 Searching User may find an element in two different ways e Searching for an element basis on bibliographic description e searching for an element basis on its identifier Searching basis on bibliographic description gives the same results as searching on WWW page In order to run this perform searching select Find option from Edit menu To run searching basis on identifier select Go to option from Edit menu Then select type of an element to find e g directory and type identifier of the element to find If such an element exists it will be displayed and selected on elements list 3 4 Advanced editor s tasks This section describes advanced tasks performed by the editor 3 4 1 Editor s application modes views In the editor s application two work modes are possible e Simple mode e Advanced mode By default the simple mode is enabled In order to switch to the advanced mode select the Advanced mode option from the View menu In ordert to get back to the simple mode select again the Adcanced mode option fro
107. rom Attributes list list in the Attributes list text field b Enter attribute value in the Assigned attributes text field and press Add button To remove attribute value pair select it on Assigned attributes list and press Remove button Press the Next button to go to the next step It is to possible to create the LDAP group at this point by pressing the Finish button 67 Library Manager Figure 4 20 New LDAP group wizard defining LDAP group New LDAP group wizard K Help LDAP group s definition Base path o airius com Attributes Attributes list Assigned attributes C Add J M Remove 5 In the last step Figure 4 21 New LDAP group wizard assigning administrative rights assign administrative right To create new LDAP group press Finish button Figure 4 21 New LDAP group wizard assigning administrative rights New LDAP group wizard x Help LDAP group s administrative rights information Rights management oup Set LDAP group s administrative rights C Account managing C Group managing C Attributes managing C Attribute values management oO Collection managing Oo WAAAY application managing To remove an LDAP group 1 In the Library Tree select the LDAP group to be removed 68 Library Manager 2 Press the amp Delete button Alternatively a context menu or a pull down menu
108. rts on the left side there is a system dir ectories tree on the right side there is a list of publication to upload In order to add publication to upload a On the system directories tree check a directory containing subdirectories de scribing publications information about the structure of a directory describing a publication are placed in the next section Press the button Application will check corectness of directories describing publications In case of errors appropriate messages will be shown After adding publications to send it is possible to go to the next step Figure 3 32 Mass publication upload creator publications selection Mass publications upload Ed Help Select directories to analyze Steps nieopublikowana Publikacja nieopublikowa przypisana do kolekcji Dopisana do koleko zabezpieczona Publikacja zabezpieczona A A i A 4 Directories selection Moje foldery udost pniania Moje ksztatty is Moje obrazy B Moje rozszerzenia Google G 5 Moje wideo My Skype Content My Skype Pictures M j notes Nerovision Odebrane pliki 3 przyklady a cwiczenia kreator publikacji a marc masowe masowe ladowanie miniaturka samolotu a opisy bibliograficzne publikacje a szablony BS M j komouter Mi lt i gt lt j gt aa 2 Create publications coe ie oa a Cea oro Caa In the second step w
109. s Objects in dLibra system have various properties Examples of properties are object s name object s bibliographic description administrative information corresponding to object Additionally every property may be multilingual or not required or optional Introduction Appendix G Objects properties in dLibra system contains information about objects properties in dLibra system 1 6 1 Multilingual properties If a property is independent from language then it is specified only once in one language If a property is multilingual then is may be specified in any number of languages used languages are defined by the library administrator An example of language independent property is directory name Directories are created by the editor in order to organize documents in hierarchical manner Directories organization is internal which means that only editors may see it WWW reades do not have access to directories As the directory is an internal object it is not necessary to provide its name in many languages An example of language dependent property multilingual property is collection name Collection name is presented on WWW pages therefore it is required to have it in many languages because of different nationality of users which visit WWW pages 1 6 2 Object s bibliographic description 1 7 Some objects in the dLibra library can be described by set of attributes called schema The main scheme in dLibra system is
110. see 49 Al LADTALY Troe aniani eee ele aE tac gtc eet cane E S asec eee e sega eee S 49 4 2 Basic administrator s taSks 2 0 0 eec eee eee eee eeeeeeeeeeeeneeneeneeeeeneeeeeeneenes 50 iii User Guide for version 3 0 of the dLibra system 4 2 1 Creating removing Collection 0 0 cece cee ceeeee eee eeea nena eee eene ees 50 4 2 2 Managing publications in Collection 2 0 0 0 cece cee cece eee ee enone 51 4 2 3 Library attributes management cece ceeceeceeeeeeeeeneeeneenees 53 4 2 4 Attribute s values dictionary management cece eee eee eee ees 56 4 2 5 Users and groups management c cece eceeeeeece seen eee eeeneseaeenees 61 4 2 6 Languages management cece eee a a s E a e 69 4 3 Advanced right management sesesseseesesresresrrrerrerererrereeeesreseereeseseeseese 70 4 3 1 Introd cton ss s cic tis ces shieea the eeg E EAAS EEE EE NA E AEAN E AA EANNA o 70 4 3 2 Library level permissions ssrsesseserssriesesseeseesseseesresensretosrasenset 70 4 3 3 Directory level perMiSSiONS imonini ane e aa 71 4 3 4 Collection level permissions esessessesresresrerrrrrrrrrrreerereseeseeseeres 73 4 3 5 Publication level permissions seesesseseesessesresrtrersrererererrereeesees 74 4 4 Access domains management seessereereeresreresresrererressesreseesreserrererereeee 75 A MARC import extension eseese a a a a a a a a a e enee TT A l marcImport properties
111. strator takes care of a digital library as a whole editor cares about the content of the digital library according to limits specified by the administrator reader uses WWW to access documents publications stored by the ed itor in the digital library Directories All the documents stored in the dLibra library are organized in a hierarchical structure of directories Every directory can contain any number of documents or subdirectories Directories provide a structural order in a library In most cases documents will be as signed to directories accordingly to their owner or e g to the company department they belong to Library structure organized in a structure of directories is visible only in administrator and editor application therefore reader does not see it Thanks to this approach editor can freely create the structure without any influence on reader view Collections Directories are only meant to help editor order library publications Logical structure seen by the reader is kept by the mechanism of library collections In dLibra system there can be any number of collections and their structure is hierarchical Every collec tion can contain any number of subcollections There can be any number of publications that belong to a single collection and each publication may belong to any number of different collections Collections are in most cases created for a specific topic eg Edu cational materials and its subcollections Biology
112. t files are simply property files A 1 marcImport properties configuration file format Tit ie 24 5a Se Siou Sini POO kee ode 2G ey ee a he Creator 1100 pal Opal ikp Subject Description 6XX Publisher 260a 260b 260f Contri buco r OOM al Oj aalales Date 260c Type Identifier 920 856u Source Language 041 546 008 35 37 Relation 250 534 440 490 800 810 811 830 Coverage Rights 506 540 Examplary configuration file is presented above This file contains configuration which defines assignment of MARC elements to dLibra attributes Every line in the configuration file contains configuration for single attribute Every line is composed of RDF attribute name the equal sign and a list of MARC elements to assign to the attribute RDF name of an attribute can be found in administrator application editing panel for an attribute MARC elements which may be imported are inter alia subfield value characters from control fields etc If attribute s RDF name is not specified no values will be assigned to the attribtue A record defining a MARC field number which value is to be imported into attribute value has the following basic syntax AAAb where AAA is a three digit number and b is a subfield code It is also possible to combine MARC subfield or extract a range of characters from control fields Note that the sign semicolon is a part of this syntax and is necessary for a proper configuration It is possible to omit
113. tal documents of various types e g scientific articles reports manuals HTML pages PDF documents audio video recordings e Management of digital documents stored in a library e g modifying documents grouping documents assigning document to thematic categories management of user rights to documents e Access to digital documents e g viewing document on web pages searching for documents securing documents from copying temporal access e Management of a digital library e g creating groups of users users rights manage ment e Cooperation with other information systems using publicly available standards e g OAI PMH RSS dLibra system is composed of three basic elements e Server key element of the system responsible for every operation performed on digital library e WWW pages reader s application allow users to access digital library resources e g books e Editor and administrator application desktop program composed of two applications editor s and administrator s which are used to manage library resources e g adding new elements and the library itself e g management of digital library thematic collections These three connected elements make dLibra system platform for building digital libraries A set of discussion forums are available on dLibra project web page These forums concern both technical help for dLibra system editor and administrator application reader application dLibra syst
114. tate Recursion a Attributes X Janel Zarz dzanie za Not granted o F HE Metadata languages A jkowalski WE Interface languages 3 20 Library directories sg Library collections 32 Digital Library Math 2 H Regionals Exhibitions TEE QB jsmith a U ytkownicy publiczni Rights can be managed on a tab signed Rights 4 3 5 Publication level permissions Cancel As with the library directories or collections access to dLibra publications is controlled separately for every single publication and every single library user for the same publication different users can have different permissions and one user can have dif ferent levels of access to different publications Similarly to the library directories access permissions to publications can be directly granted implied inherited from parent directories or inherited from a group see previous section In dLibra there are three publication level permissions e View enables a user to read the published editions of a publication Inherited from the List right of the directory the publication belongs to e Read enables a user to read all editions whether published or not of a publication Inherited from the Read right of the directory the publication belongs to e Manage enables a user to alter other user s rights for it By default granted to the creator of the publication The publication level access permissions can
115. the Finish button to close the wizard Figure 3 27 File Update Wizard file upload page Z New files versions wizard x Help Steps Upload new files 1 Choose the directory containing the updated files Upload new files to the dLibra server Progress 1 Creating file versions 0 00 2 Sending files 0 00 Press Start button to start upload 3 4 4 Creating removing an edition of a publication Edition is a viewable form of a publication to make a publication available for viewing an edition must be created and published To create an edition of a publication 1 On the elements list select the edition e g the current edition the new edition should be based on 2 From the context menu select the New edition function Alternatively the toolbar button or main menu options can be used 3 In the New Edition Wizard select the versions of publication files to compose the new edition When the new edition is based on a branch of a publication the newest versions of files lying on the branch are selected When the new edition is based on an existing edition of a publication the selected file versions are the same as in the base edition The selection of file versions can be altered using a drop down list embedded in the Version column of the Edition files table To proceed to the edition properties page press the Next button 40 Editor s Application F
116. the subfield code as well as use the multi value code Details and examples of it are presented below e 100 an example of field number Such a record will either import the value of a the field note that some fields in MARC format for instance control fields which numbers are smaller than 010 never have subfields or import the values of all subfields of this field into an attribute value Every subfield value will be imported as a separate attribute value e 260c an example of filed number with subfield code Such a record will import just the value of a certain subfield into attribute value 77 MARC import extension e 6XX an example of multi value code Such a record will import the values of all fields and subfields at range 600 699 In this way you cannot specify certain subfield codes It is also possible to define for instance such a record 65X which will analogically import values from fields at range 650 699 e 245 a b n an example for combining MARC subfields into one value oe We can split this entry into two parts which are separated by the colon character l 245 field number which subfields will be combined into a value 2 a b n template which defines how to combine the subfields The entry a means that in its place value from a subfield should be placed The subfield is a subfield of field number placed before the character in this cas
117. thout content File Delete Management menu Operation allows editor to delete file toolbar context menu File may be deleted when none of its versions belong to any edition File version Download Management menu Operation allows editor to download file toolbar context menu file s version File version Change file Context menu Operation allows editor to change content file s version content File version Delete Management menu Operation allows editor to delete file s toolbar context menu version File s version may be deleted when it does not belong to any edtion and it is not the only one version of a file Collection New collec Management menu Operation allows editor to create a tion context menu new collection in selected collection Collection Delete Management menu Operation allows editor to delete se context menu lected collection User New user Management menu Operation allows editor to create a context menu new user User Delete Management menu Operation allows editor to delete se context menu lected user Group New group Management menu Operation allows editor to create a context menu new group Group Delete Management menu Operation allows editor to delete context menu group Attribute New attrib Management menu Operation allows editor to create a ute context menu new attribute Attribute Delete Management menu Operation allows editor to delete at context menu tribute
118. tion to compare properties of two elements when properties window is in both places or manipulate on two lists In order to change component where by default elements list is placed top right corner press ALT F1 properties window will replace elements list In order to get back to elements list press ALT F1 again In order to change component where by default properties window is presented bottom right corner press ALT F2 elements list will show up to get back to properties window press ALT F2 again 3 1 1 Directories Tree The directories tree is placed on the left side of the editor s application Directories allow editors and administrators to order hierarchically elements in the library Directories are visible only for editors and administrators it is not visible for WWW users Direct ories tree may contain D directory node represents a library directory may contain subdirectories and group publications e group publication node represents a group publication which may contain publications With every node a context menu is associated that provides quick access to the most common operations performed on a given type of element e g creating a publication Context menu may be called by clicking the right mouse button on a node 3 1 2 Elements list 3 1 2 1 Introduction Elements list allows user to browse the content of the digital library By default elements from the main directory are listed on t
119. ttribute has no values assigned then the field on the right side of an attrib ute name is empty When Show with inherited values check box is selected the table with bibliographic description is filled up with attributes values inherited from overriding group publica tions Clear values button removes all attributes values from the table In order to add value to an attribute which has no value assigned 1 Choose an empty field on the rights side of attribute s name e g clik left mouse button on it to which you want to add a value 2 Enter the value you want to add 3 Approve the operation by pressing the ENTER key In order to add value to an attribute which have at least one value assigned 1 Choose a field with value assigned to the attribute 2 Press the TAB key a new row will be added below selected row 14 Editor s Application 3 Enter the value you want to add 4 Approve the operation by pressing the ENTER key While entering attribute s value it is possible to press the TAB key It will add the current value to attribute s values list and create a new row in which next value can be added Autocomplete mechanism will be started if current value matches any value of the at tribute s dictionary The autocomplete mechanism shows the list of attribute s values see Figure 3 3 Attribute s values list shown by the autocomplete mechanism which start with current value The user may select the value fr
120. wn When the button is pressed public users are not displayed After selecting one or more users or groups their rights to the chosen directory are displayed in four columns in the table on the right e Right contains the name of the permission e Old state displays the state of the permission before change e New state displays the state of the permission after change To grant the right to the chosen users select the checkbox in the table e Recursion select the checkbox to grant the right directly for all subdirectories of the selected directory 4 3 4 Collection level permissions As with the library directories access to dLibra publications is controlled separately for every single publication and every single library user Similarly to the library direct ories access permissions to publications can be directly granted implied inherited from parent directories or inherited from a group see previous section In dLibra there is only one publication level permission e Manage collection content enables a user to add and remove publications from a chosen collection 73 Library Manager Figure 4 25 Collection level rights editor dLibra Library Manager admin BAF Program Edit Management View Help Library resources JOEA x Collection Rights Publications 3 0 Library resources a Users Users Rights amp Groups fon rar 5 3 LDAP groups xs admin Right Current state New s
121. y Publication will be generated to directory where the selected files are this directory is pointed by Publication source directory field 23 Editor s Application 3 2 2 2 Information about publication tab Figure 3 12 Publication Creator Information about publication tab Data Information about publication Templates Basic information Author John Smith Title Title Additional information HTML Generate pages Additional information concerning the publication may be provided on the Information about publication tab The information will be placed in the HTML files and include e Author Information about publication s author e Title A title of the publication e Additional information Additional information about the publication user may use here HTML tags 24 Editor s Application 3 2 2 3 Templates tab Figure 3 13 Publication Creator Information about templates tab Alrubication creator ToT Data Information about publication Templates Settings Directory with templates Documents and Settings tparkola SALVINIA My Documents pubcre _ Use default templates Choose directory Index template External files v Page template style css v Copy external files Template character encoding windows 1250 v Thumbnail size 400

User Guide for version 3.0 of the dLibra system

Contents

Download Pdf Manuals

Related Search

Related Contents