%s
'):
+ """Validates document properties passed on the REQUEST object
+ raises a ValidationError and puts error messages into REQUEST if
+ errors are found"""
+ errors = 0
+
+ for p in self._documentProperties:
+ field = p['id']
+ ftype = p['type']
+ value = REQUEST.get(field, None)
+
+ if p.has_key('required') and p['required'] and not value \
+ or (ftype in ('lines','list','tokens') and value == ['']):
+ self._setError(field, 'Required Field', REQUEST, error_template)
+ errors = errors + 1
+ elif ftype == 'date' and value:
+ try:
+ DateTime(value)
+ except:
+ self._setError(field, 'Invalid Date', REQUEST, error_template)
+ errors = errors + 1
+ elif ftype == 'int' and value:
+ try:
+ int(value)
+ except:
+ self._setError(field, 'Invalid Integer Value', REQUEST, error_template)
+ errors = errors + 1
+ elif ftype == 'float' and value:
+ try:
+ float(v)
+ except:
+ self._setError(field, 'Invalid Real Number', REQUEST, error_template)
+ errors = errors + 1
+
+ if REQUEST.has_key('file') \
+ and not (REQUEST.file.filename or REQUEST.get('url','http://') != 'http://'):
+ self._setError('file', 'Specify a File or a URL to Submit',
+ REQUEST, error_template)
+ errors = errors + 1
+
+ if errors == 1:
+ message = ('1 error was found on the form. '
+ 'Please correct the noted field '
+ 'and resubmit the form.')
+ elif errors > 1:
+ message = ('%d errors were found on the form. '
+ 'Please correct the noted fields '
+ 'and resubmit the form.') % errors
+
+ if errors:
+ if REQUEST.has_key('file'):
+ message = message + ('Note: Due to browser limitations, ' + 'you may need to specify the file you are ' + 'submitting again.') + REQUEST.set('ERROR_FORM', error_template % message) + raise 'ValidationError', '%d Form Field Error(s) Found' % errors + + manage_documentProperties = DTMLFile('dtml/EditDocumentProperties', globals()) + + def manage_editDocumentProperties(self, REQUEST, RESPONSE=None): + """Modify the document properties' default values""" + + editedProperties = [] + + for prop in self._documentProperties: + propvalue = REQUEST.get(prop['id'], '') + proptype = prop.get('type', 'string') + + if type_converters.has_key(proptype): + propvalue = type_converters[proptype](propvalue) + + prop['default'] = propvalue + + required_flag = prop['id'] + '_required_' + + if REQUEST.has_key(required_flag) and REQUEST[required_flag]: + prop['required'] = 1 + else: + if prop.has_key('required'): del prop['required'] + + editedProperties.append(prop) + + self._documentProperties = tuple(editedProperties) + + if REQUEST and RESPONSE: + RESPONSE.redirect(REQUEST.URL1 + ('/manage_documentProperties?' + 'manage_tabs_message=Properties+Updated')) + + def manage_delDocumentProperties(self, ids=None, REQUEST=None, RESPONSE=None): + """Delete one or more document properties specified by 'ids'.""" + if not ids: + raise 'BadRequest', "No properties were specified" + + propdict=self.documentPropertyDict() + nd=self._reserved_names + for id in ids: + if not propdict.has_key(id): + raise 'BadRequest', ( + 'The property %s does not exist' % id) + if (not 'd' in propdict[id].get('mode', 'wd')) or (id in nd): + raise 'BadRequest', ( + 'The property %s cannot be deleted.' % id) + del propdict[id] + + self._documentProperties = tuple(map(lambda i: i[1], propdict.items())) + + if REQUEST and RESPONSE: + RESPONSE.redirect(REQUEST.URL1 + ('/manage_documentProperties' + '?manage_tabs_message=Properties+Deleted')) + + def manage_addDocumentProperty(self, id, default_value, type, required=0, + REQUEST=None, RESPONSE=None): + """Add a document property""" + # Raise an error if an value is wrapped. + if hasattr(default_value, 'aq_base'): + raise ValueError, 'Invalid property value: wrapped object' + + # Check that the property id is valid + docpropnames = map(lambda p: p['id'], self._documentProperties) + + if not id or id[:1]=='_' or (id[:3]=='aq_') \ + or (' ' in id) or hasattr(self.aq_base, id) or (id in docpropnames): + raise 'Bad Request', 'Invalid or duplicate property id' + + # Convert the value to the proper type + if type_converters.has_key(type): + default_value = type_converters[type](default_value) + + prop = {} + prop['id'] = id + prop['type'] = type + + if not type in ('selection', 'multiple selection'): + prop['default'] = default_value + else: + prop['select_variable'] = default_value + prop['default'] = '' + + if required: prop['required'] = 1 + self._documentProperties = self._documentProperties + (prop,) + + if REQUEST and RESPONSE: + RESPONSE.redirect('manage_documentProperties?manage_tabs_message=Property+Added') + + # + # Document management methods + # + + manage_addDocumentFileForm = Document.manage_addDocumentFileForm + manage_addDocumentFile = Document.manage_addDocumentFile + + def addDocumentFile(self, REQUEST): + """Adds a new document and sets its properties from a form based submission""" + + self=self.this() + doc = Document.Document(title=REQUEST.title, container=self) + self._setObject(doc.getId(), doc) + doc = self._getOb(doc.getId()) + + # See if the user can skip the document review + if REQUEST.AUTHENTICATED_USER.has_permission('Add Document Library Files Without Review', + self): + REQUEST.set('review_date', DateTime()) + else: + REQUEST.set('review_date', DLGlobals.document_unreviewed_date) + + # Set the properties, but don't index yet + doc.manage_changeProperties(REQUEST, reindex=0) + # See if a file or url was specified + if not REQUEST.file.filename and REQUEST.get('url', 'http://') != 'http://': + doc.manage_upload(file=REQUEST.url, remote=1) + else: + doc.manage_upload(REQUEST.file) + + if not Document.check_content_type(self, doc.content_type): + self.manage_delObjects(doc.getId()) + raise "IllegalFileType", \ + "That file type cannot be uploaded into the library." + + return doc + + def deleteDocumentFile(self, REQUEST=None, RESPONSE=None): + """Deletes a document from the document store""" + self.manage_delObjects(REQUEST.id) + + if REQUEST and RESPONSE and REQUEST.has_key('last_url'): + RESPONSE.redirect(REQUEST.last_url + '?' + REQUEST.get('last_query','')) + + # + # Catalog query support methods + # + + def query(self, REQUEST=None, **kw): + """Query the document store for matching documents""" + return apply(self.Catalog.searchResults, (REQUEST,), kw) + + def getpath(self, rid): + """ + Return the path to a cataloged object given a 'data_record_id_' + Used by the Catalog brains + """ + return self.Catalog.paths[rid] + + # + # Catalog management methods + # + + manage_catalogColumns = DTMLFile('dtml/catalogColumns', globals()) + + def getCatalogColumns(self): + """Returns the metadata columns in the catalog""" + return self.Catalog.schema.keys() + + def manage_delCatalogColumns(self, names, REQUEST=None, RESPONSE=None): + """Delete Catalog metadata column""" + if type(names) == type(''): + names = [names] + + for name in names: + self.Catalog.delColumn(name) + + if REQUEST and RESPONSE: + RESPONSE.redirect('manage_catalogColumns?manage_tabs_message=Catalog+Metadata+Deleted') + + def manage_addCatalogColumn(self, name, REQUEST=None, RESPONSE=None): + """Add Catalog metdata column""" + self.Catalog.addColumn(name) + + if REQUEST and RESPONSE: + RESPONSE.redirect('manage_catalogColumns?manage_tabs_message=Catalog+Metadata+Column+Added') + + manage_catalogIndexes = DTMLFile('dtml/catalogIndexes', globals()) + + def getCatalogIndexes(self): + """Returns the indexes in the catalog""" + return self.Catalog.indexes.values() + + def manage_delCatalogIndexes(self, names, REQUEST=None, RESPONSE=None): + """Delete Catalog index""" + if type(names) == type(''): + names = [names] + + for name in names: + self.Catalog.delIndex(name) + + if REQUEST and RESPONSE: + RESPONSE.redirect('manage_catalogIndexes?manage_tabs_message=Catalog+Index+Deleted') + + def manage_addCatalogIndex(self, name, type, REQUEST=None, RESPONSE=None): + """Add Catalog index""" + index_class={'FieldIndex': FieldIndex, + 'TextIndex': TextIndex, + 'KeywordIndex': KeywordIndex}[type] + + if index_class is TextIndex: + self.Catalog.addIndex(name, + index_class(name, lexicon=self.Catalog.getLexicon())) + else: + self.Catalog.addIndex(name, index_class(name)) + + if REQUEST and RESPONSE: + RESPONSE.redirect('manage_catalogIndexes?manage_tabs_message=Catalog+Index+Added') + + manage_catalogMaintenance = DTMLFile('dtml/catalogMaintenance', globals()) + + def manage_reinitCatalog(self, REQUEST=None, RESPONSE=None): + """Reinitialize the document store catalog""" + + self.Catalog.clear() + + for doc in self.objectValues(): + try: + doc.setIcons() + if doc.is_accepted(): doc.showTopics() + except: + pass + doc.index_object() + + if REQUEST and RESPONSE: + RESPONSE.redirect('manage_catalogMaintenance?manage_tabs_message=Catalog+Reinitialized') + +Globals.InitializeClass(DocumentStore) diff --git a/src/DocumentLibrary/FileConverters/CVS/Entries b/src/DocumentLibrary/FileConverters/CVS/Entries new file mode 100644 index 0000000..9e39766 --- /dev/null +++ b/src/DocumentLibrary/FileConverters/CVS/Entries @@ -0,0 +1,9 @@ +/__init__.py/1.1.1.1/Fri Jan 18 04:38:43 2002// +/doc.py/1.1.1.1/Fri Jan 18 04:38:43 2002// +/html.py/1.1.1.1/Fri Jan 18 04:38:43 2002// +/pdf.py/1.1.1.1/Fri Jan 18 04:38:43 2002// +/ppt.py/1.1.1.1/Fri Jan 18 04:38:43 2002// +/ps.py/1.1.1.1/Fri Jan 18 04:38:43 2002// +/wvText.xml/1.1.1.1/Fri Jan 18 04:38:43 2002// +/xls.py/1.1.1.1/Fri Jan 18 04:38:43 2002// +D diff --git a/src/DocumentLibrary/FileConverters/CVS/Repository b/src/DocumentLibrary/FileConverters/CVS/Repository new file mode 100644 index 0000000..05376e6 --- /dev/null +++ b/src/DocumentLibrary/FileConverters/CVS/Repository @@ -0,0 +1 @@ +DocumentLibrary/FileConverters diff --git a/src/DocumentLibrary/FileConverters/CVS/Root b/src/DocumentLibrary/FileConverters/CVS/Root new file mode 100644 index 0000000..2084eca --- /dev/null +++ b/src/DocumentLibrary/FileConverters/CVS/Root @@ -0,0 +1 @@ +:pserver:anonymous@cvs.nlada-library.sourceforge.net:/cvsroot/nlada-library diff --git a/src/DocumentLibrary/FileConverters/__init__.py b/src/DocumentLibrary/FileConverters/__init__.py new file mode 100644 index 0000000..6c67436 --- /dev/null +++ b/src/DocumentLibrary/FileConverters/__init__.py @@ -0,0 +1,29 @@ +"""File converters for the document library product""" + +from os import listdir + +def getFileConverters(): + """Import converter modules from this directory + and return them as a dictionary keyed by content_type. + + Each converter module should define an attribute content_type and a function + def convert(data) which should return text given data in the + format the converter understands. content_type may be a string or a + sequence of strings if several content_types are equivilant""" + + cvtr_dict = {} + + for cvtr_name in listdir(__path__[0]): + if cvtr_name[0] != '_' and cvtr_name[-3:] == '.py': + cvtr = __import__(cvtr_name[:-3], globals(), globals(), __path__) + + if hasattr(cvtr, 'content_type') and hasattr(cvtr, 'convert'): + if type(cvtr.content_type) == type(''): + cvtr_dict[cvtr.content_type] = cvtr + else: + for c_type in cvtr.content_type: + cvtr_dict[c_type] = cvtr + + return cvtr_dict + +FileConverters = getFileConverters() diff --git a/src/DocumentLibrary/FileConverters/doc.py b/src/DocumentLibrary/FileConverters/doc.py new file mode 100644 index 0000000..dfed561 --- /dev/null +++ b/src/DocumentLibrary/FileConverters/doc.py @@ -0,0 +1,26 @@ +"""MSWord doc to text file converter for Document Library""" + +from os import popen, remove, path +from Globals import package_home + +content_type = ('application/msword', 'application/ms-word', 'application/vnd.ms-word') + +content_description = """Microsoft Word [ +Download MS Word Viewer]""" + +wvConf_file = path.join(package_home(globals()), 'wvText.xml') + +# Uses the wvWare, and assumes it is in the path +# Requires write access to /tmp + +def convert(documentFile): + """Convert MSWord data to raw text""" + + tmp_name = documentFile._writeToTempFile() + text = popen('wvWare -x %s %s 2> /dev/null' % (wvConf_file, tmp_name)).read() + remove(tmp_name) + + return text + +# For increased speed, comment out line 400 of text.c in the wv source diff --git a/src/DocumentLibrary/FileConverters/html.py b/src/DocumentLibrary/FileConverters/html.py new file mode 100644 index 0000000..84305e7 --- /dev/null +++ b/src/DocumentLibrary/FileConverters/html.py @@ -0,0 +1,46 @@ +"""HTML to text file converter for Document Library""" + +from sgmllib import SGMLParser +from string import join + +content_type = ('text/html', 'text/xml', 'text/sgml') + +content_description = 'Web Page (HTML)' + +# Code taken from Dieter Maurer's CatalogSupport Module +# http://www.handshake.de/~dieter/pyprojects/zope +# Thank you! + +class _StripTagParser(SGMLParser): + '''SGML Parser removing any tags and translating HTML entities.''' + + from htmlentitydefs import entitydefs + + data= None + + def handle_data(self,data): + if self.data is None: self.data=[] + self.data.append(data) + + def __str__(self): + if self.data is None: return '' + return join(self.data,'') + + +def convert(doc): + """Convert html data to raw text""" + + p = _StripTagParser() + + try: + data = doc.data + if type(data) == type(''): + p.feed(data) + else: + while data is not None: + p.feed(data.data) + data = data.next + p.close() + return str(p) + except: + return '' diff --git a/src/DocumentLibrary/FileConverters/pdf.py b/src/DocumentLibrary/FileConverters/pdf.py new file mode 100644 index 0000000..12707e0 --- /dev/null +++ b/src/DocumentLibrary/FileConverters/pdf.py @@ -0,0 +1,19 @@ +"""PDF to text file converter for Document Library""" + +from os import popen, remove + +content_type = 'application/pdf' + +content_description = """Adobe Acrobat PDF [Download Acrobat Reader]""" + +# Uses the built-in linux pdftotext command, and assumes it is in the path +# Requires write access to /tmp + +def convert(documentFile): + """Convert pdf data to raw text""" + + tmp_name = documentFile._writeToTempFile() + text = popen('pdftotext %s -' % tmp_name).read() + remove(tmp_name) + + return text diff --git a/src/DocumentLibrary/FileConverters/ppt.py b/src/DocumentLibrary/FileConverters/ppt.py new file mode 100644 index 0000000..11f2b03 --- /dev/null +++ b/src/DocumentLibrary/FileConverters/ppt.py @@ -0,0 +1,47 @@ +"""MSPowerpoint doc to text file converter for Document Library""" + +from os import popen, remove +from sgmllib import SGMLParser +from string import join + +content_type = ('application/mspowerpoint', 'application/ms-powerpoint', + 'application/vnd.ms-powerpoint') + +content_description = """Microsoft Powerpoint [Download Powerpoint Viewer]""" + +#uses pptHTML http://www.xlhtml.org +# Requires write access to /tmp + +class _StripTagParser(SGMLParser): + '''SGML Parser removing any tags and translating HTML entities.''' + + from htmlentitydefs import entitydefs + + data= None + + def handle_data(self,data): + if self.data is None: self.data=[] + self.data.append(data) + + def __str__(self): + if self.data is None: return '' + return join(self.data,'') + + +def convert(documentFile): + """Convert MS-Powerpoint data to raw text""" + + tmp_name = documentFile._writeToTempFile() + text = popen('pptHtml %s 2> /dev/null' % (tmp_name)).read() + remove(tmp_name) + + p = _StripTagParser() + + try: + p.feed(text) + p.close() + return str(p) + except: + return '' diff --git a/src/DocumentLibrary/FileConverters/ps.py b/src/DocumentLibrary/FileConverters/ps.py new file mode 100644 index 0000000..aec0c62 --- /dev/null +++ b/src/DocumentLibrary/FileConverters/ps.py @@ -0,0 +1,22 @@ +"""Postscript to text file converter for Document Library""" + +from os import popen, remove, rename + +content_type = 'application/postscript' + +content_description = 'Adobe Postscript Document' + +# Uses the prescript program available at: +# http://www.nzdl.org/html/prescript.html +# Requires write access to /tmp + +def convert(documentFile): + """Convert postscript data to raw text""" + + tmp_name = documentFile._writeToTempFile() + rename(tmp_name, tmp_name + '.ps') + tmp_name = tmp_name + '.ps' + text = popen('prescript plain %s - 2> /dev/null' % tmp_name).read() + remove(tmp_name) + + return text diff --git a/src/DocumentLibrary/FileConverters/wvText.xml b/src/DocumentLibrary/FileConverters/wvText.xml new file mode 100644 index 0000000..e05d9fb --- /dev/null +++ b/src/DocumentLibrary/FileConverters/wvText.xml @@ -0,0 +1,355 @@ +
+A Document File is an enhanced file object that allows full text +searchability of file formats such as MSWord, PDF and HTML. It +also contains enhanced support for the +Dublin Core Metadata Initiative. +
++Select a file to upload from your local computer by clicking the +Browse button. +
+ + + ++A document store is used by a document library to store and +catalog document files. +
+ + + ++Add a document library index topic. +
+ + + ++A document library stores document files in a topic hierarchy. +It provides functionality for users to browse, search and add documents +through a web interface. +
+ + + ++A library topic index root is the container of a library's +topic index hierarchy. In it you can create library topic indexes. +It also provides support for topic index searching.
+ + + +
+You are currently working in version
+Creates a topic index from a text file outline. The tabbed indentation +of each line determines the level of each index topic created. The title and +id +of each topic can be specified by delimiting the two on a given line: title;id. +The default delimiter is a semicolon (;). If no delimiter is used, the +text of the line becomes the topic's title and the id is assigned in sequence. +
++WARNING: +The existing index topics will be cleared! +
++Select the index file to upload from your local computer by clicking the +Browse button. +
+ + + ++Select the icon file to upload from your local computer by clicking the +Browse button. +
+ + + ++
| + |
+
+
+
+ |
+
+This list defines what document file meta-data is available to the document +list interface. +
+ ++ + + +
+This list defines the search indexes available for documents stored +here.
+ ++Text Indexes break text up into individual words, and +are often referred to as full-text indexes. Text indexes +sort results by score meaning they return hits in order +from the most relevant to the lest relevant. +
+ ++Field Indexes treat the value of an objects attributes +atomically. +
+ ++Keyword Indexes index a sequence of objects that act as +'keywords' for an object. A Keyword Index will return any objects +that have one or more keywords specified in a search query. +
+ + + + + ++
|
+
+ Document Catalog Maintenance
+
+ |
+|
|
+ Reinitializing the document catalog will + completely clear the catalog, rebuild the indexes and metadata + elements and reindex all of the documents contained here. This + can take a very long time to complete if you have many documents + in your library. + + |
+ + + | +
| + + | +|
|
+
+ Subtransactions
+
+ |
+|
|
+
+ Subtransactions allow Zope to commit small + parts of a transaction over a period of time instead of all at + once. For ZCatalog, this means using subtransactions can + signficantly reduce the memory requirements needed to index huge + amounts of text all at once. Currently, subtransactions are only + applied to text indexes. + +If enabled, subtransactions will reduce the memory + requirements of ZCatalog, but at the expense of speed. + If you choose to enable subtransactions, you can adjust how often + ZCatalog commits a subtransactions by adjusting the + threshold below. + +If you are using ZCatalog and ZSQL Methods + in the same transaction, you must disable + subtransactions, they are not compatible with ZSQL Methods. ++ |
+|
|
+ Subtransactions are
+ |
+ + + | +
|
+ The Subtransaction threshold is the number of + objects cataloged + in the context of a single transaction that the catalog + will index before it commits a subtransaction. If this number + is low, the Catalog will take longer to index but consume less + memory. If this number is higher, the Catalog will index + quickly but consume much more memory. + |
+ + + + | +
+
+Advanced Document Search
+
+ Enter search criteria in as many document data fields as desired. Entering more
+ criteria will result in a more refined search.
+ Visit the search tips page for help creating your
+ search criteria.
+
+
+ [<< Previous &dtml-previous-sequence-size; Documents]
+
+
+
+
+ [Next &dtml-next-sequence-size; Documents >>]
+
+
diff --git a/src/DocumentLibrary/instance/methods/document_browse b/src/DocumentLibrary/instance/methods/document_browse
new file mode 100755
index 0000000..077ebf4
--- /dev/null
+++ b/src/DocumentLibrary/instance/methods/document_browse
@@ -0,0 +1,85 @@
+-
+
+
+
+
+(* Denotes required fields)
+
+
+
+
+ 
+ Edit Document File
+
+
+
+
+
+ +
+
+
diff --git a/src/DocumentLibrary/instance/methods/document_list b/src/DocumentLibrary/instance/methods/document_list
new file mode 100755
index 0000000..54a45b2
--- /dev/null
+++ b/src/DocumentLibrary/instance/methods/document_list
@@ -0,0 +1,67 @@
+|
+ |
+
+ &dtml-title;
+ &dtml-description;
+ |
+
|---|---|
| + Format + | +
+ |
+
| + Size + | +
+ |
+
| + Type + | +
+ |
+
| + Date + | +
+ |
+
| + Creator + | +
+ |
+
| + Subject Topic Area(s) + | +
+ |
+
+ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/src/DocumentLibrary/instance/methods/document_list_item b/src/DocumentLibrary/instance/methods/document_list_item
new file mode 100755
index 0000000..861f512
--- /dev/null
+++ b/src/DocumentLibrary/instance/methods/document_list_item
@@ -0,0 +1,45 @@
+|
+ |
Rejected Documents
+Documents Awaiting Your Review
+
+
+
+
+
+
+
+
+
++
Library Search Results
++
+
+
+
+ To submit a document to the library, fill out this form.
+
+ (* Denotes required fields)
+
+
+
+Document Submission Error
++Sorry, the file you specified could not be submitted to the library. +It either could not be opened or it is not a valid file format. To correct +this problem try one of the following: +
+-
+
- Make sure the file is not open in another program on your computer. + If it is, close the file and try again. +
- Make sure the file is not an executable program file, these + file types (commonly with the extension ".exe" or ".com") + cannot be submitted to the library. +
- Make sure the file name has the proper file extension in its file + name, for instance: ".doc" for MS Word documents, ".pdf" for + PDF documents, etc. Note: the extension may not be visible + when you browse for the file. If the file appears with the proper + icon in the browse window, then the extension is correct. +
- Make sure that you have the proper rights to open the file on + your computer. Try opening it on your computer using the appropriate + program. If you cannot access the file, see your system + administrator for help. +
+To return to the form to resubmit your document, click on the +Back button on your browser's toolbar.
diff --git a/src/DocumentLibrary/instance/methods/document_submit_message b/src/DocumentLibrary/instance/methods/document_submit_message new file mode 100644 index 0000000..27c908f --- /dev/null +++ b/src/DocumentLibrary/instance/methods/document_submit_message @@ -0,0 +1,26 @@ +Your document
Document Submission Error
+The URL you specified for the document could not be submitted because:
+
To correct this problem try the following:
+-
+
- Confirm that you can access the URL as entered using your web browser. + Click on the URL link above to test it in your browser +
- Make sure you URL uses the http, ftp or gopher protocols. This is denoted + at the front of the URL (ie http://). Other protocols (such as file: or mailto:) + are not allowed for submitting documents. If the protocol is omitted, + http is assumed. +
To return to the form to resubmit your document, click on the +Back button on your browser's toolbar.
diff --git a/src/DocumentLibrary/instance/methods/index_chooser b/src/DocumentLibrary/instance/methods/index_chooser new file mode 100755 index 0000000..3c7a068 --- /dev/null +++ b/src/DocumentLibrary/instance/methods/index_chooser @@ -0,0 +1,193 @@ +
+
+
+
+
+
+
+ Display a intro blurb at the top only when the user first enters the library
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
++
+ Welcome to the document library. You can use this page to
+ browse and
+ search
+ the documents here.
+
+
+
+
+
+Document Library Search Tips
++ When searching for documents, there are several techniques you + can use to improve the accuracy of your search results. These terms allow you + to formulate partial word, boolean and phrase matching search queries. Below are examples of + the query language that is used to perform searches in the document + library. You can also combine the techniques below in a single search to + further refine your query. +
+ +
+
+Simple word searches
+ If you enter multiple words for your search query the
+ results will be
+ documents containing one or more of the words in your query. Queries are
+ not case sensitive, so they will match the word(s) only based on spelling.
+ Documents matching more of the words will appear first in the search results.
+ Because a document only need to match one of the words you specify,
+ you may find that your search results contain irrelevant documents.
+
+ Example: housing landlord rent
+ This search query would find all documents containing one or more of the
+ words specified.
+ Refining your results to match multiple words
+ Using the and search
+ term between the
+ words you are searching for will limit the search results only to documents
+ containing all of the specified words.
+
+ Example: housing and landlord and rent
+ This search query would find only documents containing all of the
+ words specified.
+ Explicitly omitting results
+ You might also want to omit documents containing certain words.
+ Using the and not search term between the
+ words you are searching for will omit any documents containing the word
+ you specify.
+
+ Example: housing and landlord and not discrimination
+ This search query would find documents containing the first two words
+ and omit any documents also containing the last word.
+ Searching for phrases
+ If the word combination you are searching for always occurs
+ in a particular phrase,
+ you will get better search results using a phrase matching query. To match a particular
+ phrase, place it in double quotation marks. In order for a document to match, the
+ words in the phrase must occur in the document in the same order as they appear in the query.
+
+ Example: "fair housing"
+ This search query would find only documents containing the phrase specified.
+ Matching partial words
+ You can match multiple word forms simultaneously using
+ partial word matching. If, for
+ instance you want to guarantee that all documents containing any form of a word
+ (plural, singular, past tense, etc.) are found, you can use the asteriks (*) and
+ question mark (?) wildcard characters in your search queries. The question
+ mark matches any single character and the asterik matches zero or more characters.
+
+Example: discriminat*
+ This query would find documents containing the words "discriminate", "discriminated",
+ "discrimination", etc.
+