Retrieving Text

This document covers the following topics:


Specifying the Search Criteria

Issue the following command from any point in Con-nect to retrieve text from a document:

FIND

As a result, the "Find TRS Documents" screen appears.

   3:59 PM             * * *  C O N - N E C T  3  * * *                 4.Feb.94
  Cabinet LS                    Find TRS Documents                        Friday
                                                                                
  1 Document Text   ____________________________________________________________
                    ____________________________________________________________
                    ____________________________________________________________
                    ____________________________________________________________
                    ____________________________________________________________
                    ____________________________________________________________
  2 Description     ____________________________________________________________
                    ____________________________________________________________
                    ____________________________________________________________
  3 Keywords        ____________________________________________________________
                    ____________________________________________________________
  4 Writer/Author   ____________________________________________________________
                    ____________________________________________________________
  5 Title/Name      ____________________________________________________________
                    ____________________________________________________________
  Combine FIND No.  1 + 2 + 3 + 4 + 5_____________ with + (AND) or , (OR)       
                                                                                
 Enter a command, press a PF-key, or enter * to display commands                
    Command /                                                              /    
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help  Menu  Quit  In    Send  Foldr Docs  Note  Cal   Flip  Last  Home   

You can only search for words that have been inverted.

Enter the search criteria separated by boolean or proximity operators (see Boolean and Proximity Operators below).

1 Document Text

You can enter one or more words. Con-nect retrieves text from the documents for which the specified words have been inverted.

You need not enter the whole word. You can substitute a part of the word with an asterisk (*). See Truncation for further information.

You can also search for individual words which have been marked with word-marking symbols (you do not enter the word-marking symbols in this case).

If you want to retrieve words that have been assigned to a category, synonym or root, the name of the category, synonym or root must be preceded by the appropriate marker. The marker and the name of the category, synonym, or root must be separated by a blank.

The following markers are available:

  • CATEGORY or CAT, e.g. "CAT species"

  • SYNONYM or SYN, e.g. "SYN elephant"

  • ROOT, e.g. "ROOT temperature"

  • PHONETIC or PHON, e.g. "PHON principal"

The PHONETIC marker automatically displays a list of homophonous names or words (words that sound alike but are different in spelling), for example "principal" or "principle".

Note:
Categories, synonyms, and roots must be defined with one of the following command sequences before they can be retrieved with the FIND command: "ADD Word", "ADD Category", "ADD Synonym", or "ADD Root". See Adding a Word and Adding Categories, Synonyms and Roots for further information.

When you enter a word and a category, synonym or root, the word must always be entered before the category, synonym or root. For example, you enter "lion AND CAT species" in the "Document Text" line.

See Categories in a TRS Folder for further information on categories.

2 Description

You can enter one or more words which are contained in the description lines of the required documents.

3 Keywords

You can enter one or more keywords that are assigned to the required documents.

4 Writer/Author

The following information applies to reference documents. You can enter one or more writers. You can enter any part of the writer's name. For example, you can enter only the first name or a part of the last name and substitute the missing part with an asterisk (*); see Truncation for further information.

The following information applies to documents. You can enter one or more authors. The author may be the person who added the document, or the person who last modified the document. You can either enter the user ID or the last name. You can enter any part of the user ID or last name and substitute the missing part with an asterisk (*).

5 Title/Name

The following information applies to reference documents. You can enter one or more titles. You can also enter a part of a title and substitute the missing part with an asterisk (*).

The following information applies to documents. You can enter one or more document names. You can enter any part of the document name and substitute the missing part with an asterisk (*).

Note:
When a document name has not been defined, the document is identified by the first line of its description.

Combine FIND No.

Each type of line is assigned a number, e.g. 1 for "Document text" and 3 for "Keywords". You can enter the numbers of the criteria you want to combine with the appropriate boolean operators. The three following boolean operators are available:

  • + or AND

  • , or OR

  • NOT

If you do not enter anything in this line, AND is assumed to be the default.

Press ENTER to start the search.

If one or more documents are found, the number found is indicated in the "Found" column to the right of the corresponding criteria.

   4:00 PM                  * * *  C O N - N E C T  3  * * *            4.Feb.94
  Cabinet LS                    Find TRS Documents                        Friday
                                                                           Found
  1 Document Text   Birds_____________________________________________        4 
                    __________________________________________________          
                    __________________________________________________          
                    __________________________________________________          
                    __________________________________________________          
                    __________________________________________________          
  2 Description     animal____________________________________________        2 
                    __________________________________________________          
                    __________________________________________________          
  3 Keywords        nesting___________________________________________        3 
                    __________________________________________________          
  4 Writer/Author   __________________________________________________          
                    __________________________________________________          
  5 Title/Name      __________________________________________________          
                    __________________________________________________          
  Combine FIND No.  1 , 2 , 3_____________________ with + (AND) or , (OR)       
                                                    Combined Total            5 
 DISPLAY to see found documents or press ENTER to modify criteria               
    Command /                                                              /    
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help  Menu  Quit  In    Send  Foldr Docs  Note  Cal   Flip  Last  Home   

If no documents fulfilling all specified criteria are found, the respective message is displayed. However, this does not necessarily indicate that no documents were found; it indicates that no document was found which contained all criteria. If you are looking for any of the specified criteria, you must use the OR operator.

You can modify or extend your search by pressing ENTER and entering the additional search criteria.

Issue the following command from the "Find TRS Documents" screen

DISPLAY

As a result, the "Display TRS Documents" screen appears. It lists all found documents and reference documents (if only one document or reference document is found, that document is displayed immediately).

   4:02 PM                * * *  C O N - N E C T  3  * * *              4.Feb.94
  Cabinet LS                 Display TRS Documents                        Friday
                                                                                
  Cmd Document Name                Enc Typ Folder         File       Date Filed 
  --- ---------------------------- --- --- -------------- ---------- -----------
  __  Nesting Habits                   Txt Meadows        Meadow Lar    4.Feb.94
  __  Observation for 1991             Txt Meadows        Eastern US   26.Jan.94
  __  Spoonbills of the FL. Keys       Txt Wetlands                    22.Dec.93
  __  Spoonbill Population in LA       Txt Wetlands       Louisanna    22.Dec.93
                                                                                
  __  The Bright Breasted              Txt Hummingbirds   Eastern US   27.Jan.94
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 Cmds are 1 or 2 characters from the list below (FLIP for PF-keys)              
    Command /                                                              /    
  Copy     Display  Enclose  Erase    Export   File     Format   Info     Modify
  Output   Print    Send     Top      Translat X                                

The command prompting line of the "Display TRS Documents" screen shows all commands which apply to documents and reference documents. The commands are described in section Commands.

The following exceptions apply when issuing the DISPLAY command in conjunction with a TRS item:

When you mark a document or reference document with DI, the following is displayed according to the search criteria you entered in the "Find TRS Documents" screen:

Search Criteria Display of
Document Text The document text. All occurrences of a specified word are highlighted.
Description The document text (not the screen displaying the description).
Keywords The document text (not the screen displaying the keywords).
Writer The reference document or document text.
Title The reference document.

You can issue DISPLAY in the command line of the "Display TRS Documents" screen to display all found documents and reference documents consecutively.

When a document is displayed, all words specified as the search criteria are highlighted. You can page from one highlighted word to the next by entering the FIND command in the command line.

Issue the QUIT command to return to the "Find TRS Documents" screen.

The "Find TRS Documents" screen displays the last search criteria you specified. You can continue building upon the search criteria or quit completely from the find function by issuing the QUIT command once more.

If you issue the FIND command during the same Con-nect session, the last search criteria are displayed in the "Find TRS Documents" screen. You can either use the criteria again or specify new search criteria.

Truncation

When you enter the search criteria in the "Find TRS Documents" screen, you need not enter the whole word. You can replace a part of the word with an asterisk (*).

The following three options are available:

Option Retrieval of all documents containing
wo* Words beginning with "wo".
*ord Words ending with "ord".
w*rd Words beginning with "w" and ending with "rd".

Boolean and Proximity Operators

If you are in the "Find TRS Documents" screen, you can enter several words in each line and specify the search criteria by using the AND, OR, NOT or ADJ operators. You must separate the operators and the specified words by blanks.

When you are looking for a specific word pair, you can use the proximity operator ADJ. For example, when you specify "New ADJ York", all documents containing the word pair "New York" are retrieved.

If you do not specify an operator, AND is assumed to be the default.

Operator Retrieval of all documents
AND Which contain all specified words (default).
OR Which contain some or all the specified words.
NOT Which do not contain the specified words.
ADJ Which contain the specified word pair.

You can also enter the symbols "+" for AND and "," for OR. In this case you need not separate the operators and the specified words by blanks.

Bracketing of words is allowed; e.g. if you enter "(rodent+quadruped) OR mouse", all documents containing "rodent" and "quadruped" or "mouse" are retrieved.

You can also combine the find criteria for the document text, description, keywords, writer and title in the "Combine FIND No." line. Since each type of search criterion is assigned a number, you only have to enter the numbers you want to combine with the appropriate boolean operators. You cannot use the proximity operator ADJ in the "Combine FIND No." line.

Categories in a TRS Folder

You define categories for each TRS folder in the "Define Inverting Rules" screen (see Defining the TRS Inverting Rules). During the search process, a category is split into separate words. Thus, when you issue the FIND command to search for inverted words, a category is not linked to a specific folder. Words contained in this category are also found in other TRS folders.

Example

The categories "Countries" and "Names" have been defined to folder A. This folder contains a document with the words "Jack" and "Greece".

The category "Countries" has been excluded from folder B. This folder contains a document with the words "Jack" and "Greece".

No category has been defined to/excluded from folder C. This folder contains a document with the words "Jack" and "Greece".

You issue the FIND command and enter "Jack AND CAT Countries" in the "Document Text" line of the "Find TRS Documents" screen.

As a result, both the documents filed in folder A and C are found (although the documents are filed in different folders), since the words defined to categories "Countries" and "Names" are inverted.