source: trunk/grails-app/controllers/dbnp/importer/ImporterController.groovy @ 1542

Last change on this file since 1542 was 1542, checked in by t.w.abma@…, 10 years ago
  • "existing*" string being removed after refreshing the first step in the Import Wizard
  • Property svn:keywords set to Rev Author Date
File size: 23.5 KB
Line 
1package dbnp.importer
2
3import dbnp.studycapturing.*
4import org.dbnp.gdt.*
5import grails.converters.JSON
6import org.codehaus.groovy.grails.plugins.web.taglib.ValidationTagLib
7import grails.plugins.springsecurity.Secured
8
9/**
10 * Wizard Controller
11 *
12 * @author Jeroen Wesbeek
13 * @since 20101206
14 *
15 * Revision information:
16 * $Rev: 1542 $
17 * $Author: t.w.abma@umcutrecht.nl $
18 * $Date: 2011-02-21 19:49:51 +0000 (ma, 21 feb 2011) $
19 */
20@Secured(['IS_AUTHENTICATED_REMEMBERED'])
21class ImporterController {
22        // the pluginManager is used to check if the Grom
23        // plugin is available so we can 'Grom' development
24        // notifications to the unified notifications daemon
25        // (see http://www.grails.org/plugin/grom)
26        def pluginManager
27        def authenticationService
28        def fileService
29        def ImporterService
30        def validationTagLib = new ValidationTagLib()
31        def GdtService
32
33        /**
34         * index method, redirect to the webflow
35         * @void
36         */
37        def index = {
38                // Grom a development message
39                if (pluginManager.getGrailsPlugin('grom')) "redirecting into the webflow".grom()
40
41                /**
42                 * Do you believe it in your head?
43                 * I can go with the flow
44                 * Don't say it doesn't matter (with the flow) matter anymore
45                 * I can go with the flow (I can go)
46                 * Do you believe it in your head?
47                 */
48                redirect(action: 'pages')
49        }
50
51        /**
52         * WebFlow definition
53         * @void
54         */
55        def pagesFlow = {
56                // start the flow
57                onStart {
58                        // Grom a development message
59                        if (pluginManager.getGrailsPlugin('grom')) "entering the WebFlow".grom()
60
61                        // define variables in the flow scope which is availabe
62                        // throughout the complete webflow also have a look at
63                        // the Flow Scopes section on http://www.grails.org/WebFlow
64                        //
65                        // The following flow scope variables are used to generate
66                        // wizard tabs. Also see common/_tabs.gsp for more information
67                        flow.page = 0
68                        flow.pages = [
69                                [title: 'Import file'],
70                                [title: 'Assign properties'],
71                                [title: 'Check imported data'],
72                                //[title: 'Imported'],
73                                [title: 'Done']
74                        ]
75                        flow.cancel = true;
76                        flow.quickSave = true;
77
78                        success()
79                }
80
81                // render the main wizard page which immediately
82                // triggers the 'next' action (hence, the main
83                // page dynamically renders the study template
84                // and makes the flow jump to the study logic)
85                mainPage {
86                        render(view: "/importer/index")
87                        onRender {
88                                // Grom a development message
89                                if (pluginManager.getGrailsPlugin('grom')) "rendering the main Ajaxflow page (index.gsp)".grom()
90
91                                // let the view know we're in page 1
92                                flow.page = 1
93                                success()
94                        }
95                        on("next").to "pageOne"
96                }
97
98                // File import and entitie template selection page
99                pageOne {
100                        render(view: "_page_one")
101                        onRender {
102                                log.info ".entering import wizard"
103                                // Grom a development message
104                                if (pluginManager.getGrailsPlugin('grom')) ".rendering the partial: pages/_page_one.gsp".grom()
105
106                                flow.page = 1
107                                flow.studies = Study.findAllWhere(owner: authenticationService.getLoggedInUser())
108                flow.importer_fuzzymatching="false"
109
110                                success()
111                        }
112
113            on("refresh") {               
114
115                if (params.entity) {
116                    flash.importer_datatemplates = Template.findAllByEntity(GdtService.getInstanceByEntity(params.entity.decodeURL()))
117                }
118               
119                flash.importer_params = params               
120
121                // If the file already exists an "existing*" string is added, but we don't
122                // want that after a refresh of the first step in the import wizard, so remove
123                // that string
124                flash.importer_params.importfile = params.importfile.replace('existing*', '')
125
126                                success()
127                        }.to "pageOne"
128
129                        on("next") {
130                                flash.wizardErrors = [:]
131                flash.importer_params = params
132                flash.importer_params.importfile = params.importfile.replace('existing*', '')
133
134                if (params.entity) {
135                    flash.importer_datatemplates = Template.findAllByEntity(GdtService.getInstanceByEntity(params.entity.decodeURL()))
136                }
137
138                                // Study selected?
139                                flow.importer_study = (params.study) ? Study.get(params.study.id.toInteger()) : null
140
141                                // Trying to import data into an existing study?
142                                if (flow.importer_study)
143                                        if (flow.importer_study.canWrite(authenticationService.getLoggedInUser())) 
144                                                fileImportPage(flow, flash, params) ? success() : error()                                       
145                                        else {
146                                                log.error ".importer wizard wrong permissions"
147                                                this.appendErrorMap(['error': "You don't have the right permissions"], flash.wizardErrors)
148                                                error()
149                                        }
150                                else {
151                                        fileImportPage(flow, flash, params) ? success() : error()
152                                }
153
154                                // put your bussiness logic (if applicable) in here
155                        }.to "pageTwo"
156                }
157
158                // Property to column assignment page
159                pageTwo {
160                        render(view: "_page_two")
161                        onRender {
162                                log.info ".import wizard properties page"
163               
164                def template = Template.get(flow.importer_template_id)
165
166                                // Grom a development message
167                                if (pluginManager.getGrailsPlugin('grom')) ".rendering the partial: pages/_page_two.gsp".grom()
168
169                flow.importer_importmappings = ImportMapping.findAllByTemplate(template)
170
171                                flow.page = 2
172                                success()
173                        }
174            on("refresh") {
175                def template = Template.get(flow.importer_template_id)
176                flow.importer_importmappings = ImportMapping.findAllByTemplate(template)
177
178                // a name was given to the current property mapping, try to store it
179                if (params.mappingname) {
180                    flash.importer_columnproperty = params.columnproperty
181                    propertiesSaveImportMappingPage(flow, flash, params)                   
182                } else // trying to load an existing import mapping
183                if (params.importmapping_id) {
184                    propertiesLoadImportMappingPage(flow, flash, params)
185                }
186               
187                if (params.fuzzymatching == "true")
188                    flow.importer_fuzzymatching="true" else
189                    flow.importer_fuzzymatching="false"
190
191                success()
192                        }.to "pageTwo"
193
194                        on("next") {
195                                if (propertiesPage(flow, flash, params)) {
196                                        success()
197                                } else {
198                                        log.error ".import wizard, properties are set wrong"
199                                        error()
200                                }
201                        }.to "pageThree"
202                        on("previous").to "pageOne"
203                }
204
205                // Mapping page
206                pageThree {
207                        render(view: "_page_three")
208                        onRender {
209                                log.info ".import wizard mapping page"
210                                // Grom a development message
211                                if (pluginManager.getGrailsPlugin('grom')) ".rendering the partial pages/_page_three.gsp".grom()
212
213                                flow.page = 3
214                                success()
215                        }
216                        on("refresh") {
217                                success()
218                        }.to "pageThree"
219                        on("next") {
220                                if (mappingsPage(flow, flash, params)) {
221                                        flow.page = 4
222                                        success()
223                                } else {
224                                        log.error ".import wizard mapping error, could not validate all entities"
225                                        error()
226                                }
227                        }.to "save"
228                        on("previous").to "pageTwo"
229                }
230
231                // Imported data overview page
232                pageFour {
233                        render(view: "_page_four")
234                        onRender {
235                                // Grom a development message
236                                if (pluginManager.getGrailsPlugin('grom')) ".rendering the partial pages/_page_four.gsp".grom()
237
238                                flow.page = 4
239                                success()
240                        }
241                        on("next") {
242                                if (importedPage(flow, params)) {
243                                        flow.page = 4
244                                        success()
245                                } else {
246                                        log.error ".import wizard imported error, something went wrong showing the imported entities"
247                                        error()
248                                }
249                        }.to "save"
250                        on("previous").to "pageThree"
251                }
252
253                // Save the imported data
254                save {
255                        action {
256                                // here you can validate and save the
257                                // instances you have created in the
258                                // ajax flow.
259                                // Grom a development message
260                                if (pluginManager.getGrailsPlugin('grom')) ".persisting instances to the database...".grom()
261
262                                if (saveEntities(flow, params)) {
263                                        //if (ImporterService.saveDatamatrix(flow.importer_study, flow.importer_importeddata)) {
264                                        //log.error ".import wizard succesfully persisted all entities"
265                                        //def session = sessionFactory.getCurrentSession()
266                                        //session.clear()
267                                        success()
268                                } else {
269                                        log.error ".import wizard, could not save entities:\n" + e.dump()
270                                        flow.page = 4
271                                        error()
272                                }
273                        }
274                        on("error").to "error"
275                        on(Exception).to "error"
276                        on("success").to "finalPage"
277                }
278
279                // render errors
280                error {
281                        render(view: "_error")
282                        onRender {
283                                // Grom a development message
284                                if (pluginManager.getGrailsPlugin('grom')) ".rendering the partial pages/_error.gsp".grom()
285
286                                // set page to 4 so that the navigation
287                                // works (it is disabled on the final page)
288                                flow.page = 4
289                        }
290                        on("next").to "save"
291                        on("previous").to "pageFour"
292                }
293
294                // last wizard page
295                finalPage {
296                        render(view: "_final_page")
297                        onRender {
298                                // Grom a development message
299                                if (pluginManager.getGrailsPlugin('grom')) ".rendering the partial pages/_final_page.gsp".grom()
300                                success()
301                        }
302                        onEnd {
303                                // clean flow scope
304                                flow.clear()
305                        }
306                }
307        }
308
309    def propertiesManager = {
310        render (view:"common/_propertiesManager")
311    }
312
313        /**
314         * Return templates which belong to a certain entity type
315         *
316         * @param entity entity name string (Sample, Subject, Study et cetera)
317         * @return JSON object containing the found templates
318         */
319        def ajaxGetTemplatesByEntity = {
320                // fetch all templates for a specific entity
321                def templates = Template.findAllByEntity(GdtService.getInstanceByEntity(params.entity.decodeURL()))
322
323
324                // render as JSON
325                render templates as JSON
326        }
327
328        /**
329         * Handle the file import page.
330         *
331         * @param Map LocalAttributeMap (the flow scope)
332         * @param Map GrailsParameterMap (the flow parameters = form data)
333         * @returns boolean true if correctly validated, otherwise false
334         */
335        boolean fileImportPage(flow, flash, params) {
336                def importedfile = fileService.get(params['importfile'])
337                //fileService.delete(YourFile)
338
339        if (importedfile.exists()) {
340            try {
341                session.importer_workbook = ImporterService.getWorkbook(new FileInputStream(importedfile))
342            } catch (Exception e) {
343                log.error ".importer wizard could not load file: " + e
344                this.appendErrorMap(['error': "Wrong file (format), the importer requires an Excel file as input"], flash.wizardErrors)
345                return false
346            }
347        }
348
349                if (params.entity && params.template_id) {           
350                       
351            try {
352                session.importer_workbook = ImporterService.getWorkbook(new FileInputStream(importedfile))
353            } catch (Exception e) {
354                log.error ".importer wizard could not load file: " + e
355                this.appendErrorMap(['error': "Excel file required as input"], flash.wizardErrors)
356                return false
357            }
358
359                        def selectedentities = []
360
361                        def entityName = GdtService.decryptEntity(params.entity.decodeURL())
362                        def entityClass = GdtService.getInstanceByEntityName(entityName)
363
364                        // Initialize some session variables
365                        //flow.importer_workbook = wb // workbook object must be serialized for this to work
366
367                        flow.importer_template_id = params.template_id
368                        flow.importer_sheetindex = params.sheetindex.toInteger() - 1 // 0 == first sheet
369                        flow.importer_datamatrix_start = params.datamatrix_start.toInteger() - 1 // 0 == first row
370                        flow.importer_headerrow = params.headerrow.toInteger()
371            flow.importer_entityclass = entityClass
372
373                        // Get the header from the Excel file using the arguments given in the first step of the wizard
374                        flow.importer_header = ImporterService.getHeader(session.importer_workbook,
375                                flow.importer_sheetindex,
376                                flow.importer_headerrow,
377                                flow.importer_datamatrix_start,
378                                entityClass)
379
380                        session.importer_datamatrix = ImporterService.getDatamatrix(
381                                session.importer_workbook, flow.importer_header,
382                                flow.importer_sheetindex,
383                                flow.importer_datamatrix_start,
384                                5)
385
386                        flow.importer_templates = Template.get(flow.importer_template_id)
387                        flow.importer_allfieldtypes = "true"
388
389                        return true
390                }
391
392
393        log.error ".importer wizard not all fields are filled in"
394        this.appendErrorMap(['error': "Not all fields are filled in, please fill in or select all fields"], flash.wizardErrors)
395        return false
396        }
397
398    /**
399     * Load an existing import mapping
400     *
401     * @param Map LocalAttributeMap (the flow scope)
402         * @param Map GrailsParameterMap (the flow parameters = form data)
403         * @returns boolean true if correctly validated, otherwise false
404         */
405    boolean propertiesLoadImportMappingPage(flow, flash, params) {
406        def im = ImportMapping.get(params.importmapping_id.toInteger())
407        im.refresh()
408
409        im.mappingcolumns.each { mappingcolumn ->
410            //def mc = new MappingColumn()
411            //mc.properties = mappingcolumn.properties
412
413            flow.importer_header[mappingcolumn.index.toInteger()] = mappingcolumn           
414        }
415    }
416
417    /**
418     * Save the properties as an import mapping.
419     *
420     * @param Map LocalAttributeMap (the flow scope)
421         * @param Map GrailsParameterMap (the flow parameters = form data)
422         * @returns boolean true if correctly validated, otherwise false
423         */
424    boolean propertiesSaveImportMappingPage(flow, flash, params) {
425        flash.wizardErrors = [:]
426        def isPreferredIdentifier = false
427
428                // Find actual Template object from the chosen template name
429                def template = Template.get(flow.importer_template_id)
430       
431        // Create new ImportMapping instance and persist it
432        def im = new ImportMapping(name:params.mappingname, entity: flow.importer_entityclass, template:template).save()       
433
434                params.columnproperty.index.each { columnindex, property ->
435                        // Create an actual class instance of the selected entity with the selected template
436                        // This should be inside the closure because in some cases in the advanced importer, the fields can have different target entities                     
437                        //def entityClass = GdtService.getInstanceByEntityName(flow.importer_header[columnindex.toInteger()].entity.getName())           
438            def entityObj = flow.importer_entityclass.newInstance(template:template)
439
440            def dontimport = (property == "dontimport") ? true : false
441
442            // Loop through all fields and find the preferred identifier
443            entityObj.giveFields().each {               
444                                isPreferredIdentifier = (it.preferredIdentifier && (it.name == property)) ? true : false
445                        }
446
447            // Create new MappingColumn instance
448            def mc = new MappingColumn (importmapping:im,
449                                        name: flow.importer_header[columnindex.toInteger()].name,
450                                        property:property,
451                                        index:columnindex,
452                                        entityclass:flow.importer_entityclass,
453                                        templatefieldtype:entityObj.giveFieldType(property),
454                                        dontimport: dontimport,
455                                        identifier:isPreferredIdentifier)
456
457            // Save mappingcolumn
458            if (mc.validate()) {
459                im.addToMappingcolumns(mc)               
460            }
461            else {
462                mc.errors.allErrors.each {
463                    println it
464                }
465            }
466
467            // Save importmapping
468            if (im.validate()) {
469                try {
470                    im.save(flush:true)
471                } catch (Exception e) {
472                    //getNextException
473                    log.error "importer wizard save importmapping error: " + e
474                }
475            }
476            else {
477                im.errors.allErrors.each {
478                    println it
479                }
480            }
481           
482                }
483    }
484
485        /**
486         * Handle the property mapping page.
487         *
488         * @param Map LocalAttributeMap (the flow scope)
489         * @param Map GrailsParameterMap (the flow parameters = form data)
490         * @returns boolean true if correctly validated, otherwise false
491         */
492        boolean propertiesPage(flow, flash, params) {
493        flash.wizardErrors = [:]
494       
495                // Find actual Template object from the chosen template name
496                def template = Template.get(flow.importer_template_id)
497
498                params.columnproperty.index.each { columnindex, property ->
499                        // Create an actual class instance of the selected entity with the selected template
500                        // This should be inside the closure because in some cases in the advanced importer, the fields can have different target entities
501                        def entityClass = Class.forName(flow.importer_header[columnindex.toInteger()].entityclass.getName(), true, this.getClass().getClassLoader())
502                        def entityObj = entityClass.newInstance(template: template)
503
504                        // Store the selected property for this column into the column map for the ImporterService
505                        flow.importer_header[columnindex.toInteger()].property = property
506
507                        // Look up the template field type of the target TemplateField and store it also in the map
508                        flow.importer_header[columnindex.toInteger()].templatefieldtype = entityObj.giveFieldType(property)
509
510                        // Is a "Don't import" property assigned to the column?
511                        flow.importer_header[columnindex.toInteger()].dontimport = (property == "dontimport") ? true : false
512
513                        //if it's an identifier set the mapping column true or false
514                        entityObj.giveFields().each {
515                                (it.preferredIdentifier && (it.name == property)) ? flow.importer_header[columnindex.toInteger()].identifier = true : false
516                        }
517                }
518
519                // Import the workbook and store the table with entity records and store the failed cells
520                def (table, failedcells) = ImporterService.importData(flow.importer_template_id,
521                        session.importer_workbook,
522                        flow.importer_sheetindex,
523                        flow.importer_datamatrix_start,
524                        flow.importer_header)
525
526                flow.importer_importeddata = table
527
528        // loop through all entities to validate them and add them to wizardErrors flash when invalid
529        table.each { record ->
530            record.each { entity ->
531                if (!entity.validate()) {
532                                this.appendErrors(entity, flash.wizardErrors, 'entity_' + entity.getIdentifier() + '_')
533                }
534            }
535        }
536
537        flow.importer_failedcells = failedcells
538
539                return true
540        }
541
542        /**
543         * Handle the mapping page.
544         *
545         * @param Map LocalAttributeMap (the flow scope)
546         * @param Map GrailsParameterMap (the flow parameters = form data)
547         * @returns boolean true if correctly validated, otherwise false
548         */
549        boolean mappingsPage(flow, flash, params) {
550                flash.wizardErrors = [:]
551                flow.importer_invalidentities = 0
552
553                flow.importer_importeddata.each { table ->
554                        table.each { entity ->
555                                def invalidfields = 0
556
557                                // Set the fields for this entity by retrieving values from the params
558                                entity.giveFields().each { field ->
559                                        // field of type ontology and value "#invalidterm"?
560                                        if (field.type == org.dbnp.gdt.TemplateFieldType.ONTOLOGYTERM &&
561                                                params["entity_" + entity.getIdentifier() + "_" + field.escapedName()] == "#invalidterm"
562                                        ) {
563                                                invalidfields++
564                                        } else
565                                        if (field.type == org.dbnp.gdt.TemplateFieldType.ONTOLOGYTERM &&
566                                                params["entity_" + entity.getIdentifier() + "_" + field.escapedName()] != "#invalidterm") {
567                                                if (entity) removeFailedCell(flow.importer_failedcells, entity, field)                       
568                                                entity.setFieldValue(field.toString(), params["entity_" + entity.getIdentifier() + "_" + field.escapedName()])
569                                        }
570                                        else
571
572                    if (field.type == org.dbnp.gdt.TemplateFieldType.STRINGLIST &&
573                                                params["entity_" + entity.getIdentifier() + "_" + field.escapedName()] != "#invalidterm") {
574                                                if (entity) removeFailedCell(flow.importer_failedcells, entity, field)                       
575                                                entity.setFieldValue(field.toString(), params["entity_" + entity.getIdentifier() + "_" + field.escapedName()])
576                    } else
577                    if (field.type == org.dbnp.gdt.TemplateFieldType.STRINGLIST &&
578                                                params["entity_" + entity.getIdentifier() + "_" + field.escapedName()] == "#invalidterm"
579                                        ) {
580                                                invalidfields++
581                                        } else
582
583                                                entity.setFieldValue(field.toString(), params["entity_" + entity.getIdentifier() + "_" + field.escapedName()])
584                                }
585
586                                // Determine entity class and add a parent (defined as Study in first step of wizard)
587                                switch (entity.getClass()) {
588                                        case [Subject, Sample, Event]: entity.parent = flow.importer_study
589                                }
590
591                                // Try to validate the entity now all fields have been set
592                                if (!entity.validate() || invalidfields) {
593                                        flow.importer_invalidentities++
594
595                                        // add errors to map
596                                        this.appendErrors(entity, flash.wizardErrors, "entity_" + entity.getIdentifier() + "_")
597
598                                        entity.errors.getAllErrors().each() {
599                                                log.error ".import wizard imported validation error:" + it
600                                        }
601                                } else {
602                                        //removeFailedCell(flow.importer_failedcells, entity)
603                                } // end else if
604
605                        } // end of record
606                } // end of table
607
608                return (flow.importer_invalidentities == 0) ? true : false
609        } // end of method
610
611        /**
612         * @param failedcell failed ontology cells
613         * @param entity entity to remove from the failedcells list
614         */
615        def removeFailedCell(failedcells, entity, field) {
616                // Valid entity, remove it from failedcells
617        def entityidfield = "entity_" + entity.getIdentifier() + "_" + field.name.toLowerCase()
618
619                failedcells.each { record ->
620                        def tempimportcells = []
621
622
623                        record.importcells.each { cell ->               
624                                // remove the cell from the failed cells session
625                                if (cell.entityidentifier != entityidfield) {
626                                        //record.removeFromImportcells(cell)
627                                        tempimportcells.add(cell)
628                                }
629                        }
630
631                        record.importcells = tempimportcells
632                        // } // end of importcells
633                } // end of failedcells
634        }
635
636        /**
637         * Handle the imported entities page.
638         *
639         * @param Map LocalAttributeMap (the flow scope)
640         * @param Map GrailsParameterMap (the flow parameters = form data)
641         * @returns boolean true if correctly validated, otherwise false
642         */
643        boolean importedPage(flow, params) {
644                return true
645        }
646
647        boolean saveEntities(flow, params) {
648                //def (validatedSuccesfully, updatedEntities, failedToPersist) =
649                //try {
650                ImporterService.saveDatamatrix(flow.importer_study, flow.importer_importeddata, authenticationService, log)
651
652                //}
653                //catch (Exception e) {
654//                log.error ".import wizard saveEntities error\n" + e.dump()
655//            }
656
657                //flow.importer_validatedsuccesfully = validatedSuccesfully
658                //flow.importer_failedtopersist = failedToPersist
659                //flow.imported_updatedentities = updatedEntities
660                //flow.importer_totalrows = flow.importer_importeddata.size
661                //flow.importer_referer = ""
662
663                return true
664        }
665
666        /**
667         * append errors of a particular object to a map
668         * @param object
669         * @param map linkedHashMap
670         * @void
671         */
672        def appendErrors(object, map) {
673                this.appendErrorMap(getHumanReadableErrors(object), map)
674        }
675
676        def appendErrors(object, map, prepend) {
677                this.appendErrorMap(getHumanReadableErrors(object), map, prepend)
678        }
679
680        /**
681         * append errors of one map to another map
682         * @param map linkedHashMap
683         * @param map linkedHashMap
684         * @void
685         */
686        def appendErrorMap(map, mapToExtend) {
687                map.each() {key, value ->
688                        mapToExtend[key] = ['key': key, 'value': value, 'dynamic': false]
689                }
690        }
691
692        def appendErrorMap(map, mapToExtend, prepend) {
693                map.each() {key, value ->
694                        mapToExtend[prepend + key] = ['key': key, 'value': value, 'dynamic': true]
695                }
696        }
697
698        /**
699         * transform domain class validation errors into a human readable
700         * linked hash map
701         * @param object validated domain class
702         * @return object  linkedHashMap
703         */
704        def getHumanReadableErrors(object) {
705                def errors = [:]
706                object.errors.getAllErrors().each() { error ->
707                        // error.codes.each() { code -> println code }           
708
709                        // generally speaking g.message(...) should work,
710                        // however it fails in some steps of the wizard
711                        // (add event, add assay, etc) so g is not always
712                        // availably. Using our own instance of the
713                        // validationTagLib instead so it is always
714                        // available to us
715                        errors[error.getArguments()[0]] = validationTagLib.message(error: error)
716                }
717
718                return errors
719        }
720
721}
Note: See TracBrowser for help on using the repository browser.