home *** CD-ROM | disk | FTP | other *** search
/ PSION CD 2 / PsionCDVol2.iso / Programs / 653 / datasel.SIS / DataSel.hlp (.txt) < prev   
Encoding:
EPOC Database  |  2001-09-25  |  29.7 KB  |  252 lines
  1. "Data.appS@
  2. Table1
  3. Table1
  4. ColA4
  5. ColB4
  6. ColA6
  7. ColB6
  8. ColB6
  9. $ACreate New file , this enables you to create a new database file , when a file is created - the first record will be as shown above - this will be removed after a merge , if you simply want to add individual records add at least ONE new record BEFORE attempting to delete the default record
  10. AIf you set the 'Export delimiters' line to Psion Data when exporting the file , you will NOT be able to import this back into DataSel , in this case you would have to import the file into a Psion Data file , then import this Data file into DataSel ( see instructions on exporting ) .
  11. ility ( Dbase etc. )
  12. rd BEFORE attempting to delete the default record
  13. NBMerge , this enables existing Epoc databases to be merged into an existing DataSel file , if there are already records in the DataSel file the merged records will be added at the end of the existing ones , in the order they appear in the actual datbase file ( this may be different to the order they are DISPLAYED in the Epoc Data program ) , if the first record in the DataSel file is the default one ( This file is empty etc.. ) then this record will be automatically removed from the file . This saves you the effort of doing it manually - you didn't want to keep that record did you ?
  14. DThe database file you wish to merge in MUST contain at least 8 Text fields or an error will occur . Memo field are NOT text fields , nor are Date fields Number fields etc. In Data you can check on the type of labels by pressing Ctrl+L , highlighting each field and then selecting Edit and checking the 'Type' . If there are less than 8 text fields you should add as many as are required until there are 8 text fields . Assuming there are 8 text fields , any NON-TEXT fields will be ignored ( and not merged in ) . If you have an existing Data file you wish to use in DataSel which does not conform to these requirements , you can either convert it on the PC using Psion file convertor to a Series 3 file then use Palmtop Software 3Base to convert it to plain text file - in the format of :- 8 Fields per record : Field de-limiter = Carriage return , Line feed ( CR,LF ) : record de-limiter = Carriage return , Line feed ( CR,LF ) ( this method is highly recommended - 3Base is now freely downloadable from the Palmtop website )
  15. TBImport text , this enables the import of plain text files into an existing DataSel database file . The text file format MUST be :- 8 Fields per record : Field de-limiter = Carriage return , Line feed ( CR,LF ) : Record de-limiter = Carriage return , Line feed ( CR,LF ) again you can prepare a Series 3 database or other database using Palmtop Software 3Base or similar . No checks are performed that the file to be imported is in a valid form , the worst that can happen is that records run 'out of sequence' with any labels that might be entered - or the resulting records contain gibberish .
  16. AIf you set the 'Export delimiters' line to Psion Data when exporting the file , you will NOT be able to import this back into DataSel , in this case you would have to import the file into a Psion Data file , then import this Data file into DataSel ( see instructions on exporting ) .
  17. $AFind records , allows search of all records , records which match the search will be displayed along with a record count ( Record 3 of 344 ) . As this searches ALL 8 fields , a limit of 10 characters exists on this search , if more than 10 are entered it will be truncated to the first 10 .
  18. CSql Search , the sql search gives more control over the search . It is possible to find records which match 2 criteria . The first search request is entered , along with the specific field to search and the type of search , if this is set to 'Contains' then the search request can be at any position in the relevant field ( 'mark' would find marked , hallmark , remarked etc ) if set to 'Equalls' then the entire contents of the relevant field must exactly ( apart from case ) 'Greater than' allows search for records greater than the search request COMPARED AS A STRING VALUE , using this on records which contain numbers AND punctuation or letters of the alphabet causes odd effects . 'Less than' works in the same way and has the same limitations as greater than . If you wish to perform a search on a second criteria set 'Second search' to 'And' - records must contain both search requests , 'Or' records can contain one , other or both search requests , 'None' - no second search is carried out.
  19. BInsta-Search options , the options set here are stored for each file you have opened on the Psion , the options are 'Field to search' ( any of the 8 fields or All fields ) 'Only search start of field' ( Yes or No ) if this is set to yes then the first characters in the field ( or fields ) must exactly match the search request ( 'mark' will match 'marked' , 'Mark' , 'Mark Stevenson' , 'MarkStevenson.nildram' but NOT 'www.MarkStevenson.nildram.co.uk' , 'remarked' , 'He was a marked man' etc.) 'Always Start at first record' ( Yes or No ) if this is set to yes when a NEW Insta-Search request is entered , the search will start from record 1 . Note that the Insta-Search options affect the Quick search operation , apart from always start at first record .
  20. BAdd record , adds a new record to the database , once the details have been entered press 'Enter' to save and a new empty record will be displayed ready for adding in , when you have finished adding records either press 'Esc' to close the Add dialog (and abandon any information currently entered in the dialog ) or press 'Enter' while an empty record is displayed . IE pressing 'Enter' twice in quick succession saves the first record then abandons the adding of further records without saving the 'empty' record .
  21. DAEdit New record , adds a new record , with the field values filled in using the current records field values , useful if you have a lot of similar records to enter . 'Enter' saves the record , 'Esc' abandons any changes made so far . The ORIGINAL record is left unchanged , the NEW record is saved at the end of the file .
  22. 3AEdit field titles , allows you to customise the field titles . NOTE . If you set any of the field titles to 'Date' ( NOT 'Date sold' or 'Sale date' etc.) when a record is added ( Ctrl+A ) or Edit new ( Ctrl+K ) the date field will be filled with the current date in the format dd/mm/yyyy - IE 27/06/2000 .
  23. /ADebug , If you see this command you must have my Psion Revo !! Does nothing of use other than to slow the program down and print out values of critical variables at various points of the program . Helps me to see what is going on 'under the hood' while trying out various features and code re-writes .
  24. s of a search . I may remove it completely from later versions .
  25. /ADebug , If you see this command you must have my Psion Revo !! Does nothing of use other than to slow the program down and print out values of critical variables at various points of the program . Helps me to see what is going on 'under the hood' while trying out various features and code re-writes .
  26. AWhile DataSel is not exactly 'Beta' software , it is not exactly finished either . I would welcome constructive comments regarding its operation . I can Honestly say that I use it daily and much prefer it to the Data program , but am still refining its operation . DataSel is freeware , I use it on my Revo reglarly and I have not suffered from any unusual growths, injuries or data loss as a result . I cannot promise that you won't either .
  27. CIf you set the 'Export delimiters' line to Psion Data , when importing into Psion Data you would set the import text file dialog 'Options' settings to the following . Text Qualifier = None : Label separator = Tab ( Tab ) : Entry separator = End of line . You would also need to have ensured that you have set at least the first 8 label types to 'text' , with a length of 250 . Note that DataSel can store a maximum of 255 characters per field , if any fields are longer than 250 , the last five characters of that field will be 'lost' by the Psion import routine , but WILL be present in the export file created by DataSel , you should be able to view this file with a text editor , and 'reclaim' the lost information . Note that this type of export file CAN NOT be re-imported into DataSel . If this file is imported into a Psion Data file , this Data file can then be imported back into DataSel .
  28. *BThe file is normally sorted alphabetically before being exported , for databases which you do not want to be sorted alphabetically this can be overridden by using the hidden shortcut command of Ctrl+Fn+X , you can tell if the file is to be exported alphabetically ( or not ) as when you are asked for the exported files file name , the dialog will display either 'Alphabetic Export as text' or 'Non-Alphabetic Export as text' . It is possible to sort the database , using the alphabetic export and then importing the text file into a new database file .
  29. SDAn Insta-Search is initiated by just typing at the keyboard - simple as that . DataSel assumes if you do not press any control buttons ( Ctrl , Fn , Tab , Enter , Esc , Del , Menu etc. ) you want to enter an Insta-Search . If you pause typing an Insta-Search request for more than 2-3 seconds the search will start automatically you can alternatively press 'Enter' to skip the 2-3 second pause if you are in a rush If you make a mistake typing an Insta-Search request , pressing 'Esc' will cancel the Insta-Search operation . It is possible to enter a dual search request as outlined in the Quick search section as an Insta-Search command ( if you can type quickly enough !! ) Insta-Search searches WITHIN the current record set , this can be helpful in trying to narrow down the records you require . Pressing 'Enter' will search for the next record which matches the search request displayed in the status bar , pressing Shift+'Enter' searches for the previous record which matches the search request . If no search request has been entered this will simply move to the next/previous record in the file .
  30. AThe status bar doubles up as the scrollbar if a record is unable to be displayed in its entirety in the display window . When this is the case , the scroll up/down arrows will be displayed in the right corner of the status bar , tapping on the appropriate arrow will scroll in the direction indicated , you can also use the up and down arrow keys on the keyboard to the same effect . If the display has been scrolled - the Tab key returns the display to the usual position .
  31. Toolbar Ctrl+T
  32. Show toolbar , shows or hides a toolbar . The setting of the toolbar is saved on a file to file basis , you could have one file which automatically has a toolbar on opening and another with no toolbar .
  33. Word wrap Ctrl+WcWord Wrap , turns the word wrap on or off . Word wrap is always turned on when the file is opened
  34. Zoom in Ctrl+M    Zoom in
  35. Zoom out Shift+Ctrl+M
  36. Zoom out
  37. Debug Shift+Ctrl+D
  38.  Status Bar ( Scrolling entries )
  39. Next/Previous recordQThe left and right keys ( < , > ) move to the next/previous records as expected
  40. Disclaimer 
  41.     Copyright4Copyright Mark Stevenson 2000 mkstevo@nildram.co.uk
  42. zBWhen you start DataSel for the very first time , no database will exist , you will be asked if you would like to open an existing file or create a new one - as no existing files will exist ( yet ) you should select Create New and one will be automatically created and the display will show the first record in the file . This first record will be similar to :-
  43. Field1 This file is empty , press Ctrl+A to add new records
  44. Field2 or Ctrl+L to merge in records from an existing file
  45. Field3 Edit titles using Ctrl+T
  46. Field4
  47. Field5 Welcome to DataSelector for Epoc ! 
  48.  Mark Stevenson 2000
  49. Field6 Read the readme file for more information
  50. ~CExport as text , this exports the file as text . When selecting Export , you have the option of exporting the current 'group' only ( as indicated in the status bar - IE Record 1 of 171 indicates a group of 171 , this may be a subset of records within the database ) or all of the records in the entire database , this second option abandons any existing searches . If the current group is made up of all the records in the database then either option will have the same effect . 
  51. The export format can be set to either :- 
  52. DataSel type : 8 Fields per record Field de-limiter = Carriage return , Line feed ( CR,LF ) record de-limiter = Carriage return , Line feed ( CR,LF ) This is compatible with Palmtop software 3Base file conversion program and most PC databases have a plain text CR,LF import utility ( Dbase etc. )
  53. Psion Compatible : See help topic 'Export ( Psion Data Compatible )'
  54. "Running DataSel for the first time
  55. Open Ctrl+O
  56. Open file , this allows you to open an existing DataSel file , you cannot open standard Epoc database files - see the merge command
  57. New Ctrl+N
  58. Merge Ctrl+L
  59. Merge Notes
  60. Exit Ctrl+E
  61. Exit , exits the program , all current options are saved and the database file is compressed ( deleted entries removed etc. ) to save disk space .
  62. Export Ctrl+X
  63.  Export ( Psion Data compatible ) 
  64. Export ( Unsorted order )
  65. Import Shift+Ctrl+X
  66.     Import(2)
  67. Import ( Backup )tIf you are importing into an existing file , it might be sensible to back the file up BEFORE attempting an import .
  68. ADelete record , deletes the current record . Press 'Enter' to confirm deletion , 'Esc' to abandon the delete action .
  69. It is also possible to delete an entire group .
  70. Shift+Ctrl+D
  71. If you delete ALL records using this command you will be presented with the option to delete the empty file . This will also delete the associated option settings and is recommended unless you have a good reason for saving the options file for reuse later .
  72. vABrowser , Displays the records in a simple list style , press 'Enter' - close the browser and make the browsers current record the current record , 'Esc' close the browser , Ctrl+W alter the display widths . 
  73. NOTE 
  74. The browser is not yet working to my satisfaction , it is VERY slow if displaying the results of a search . I may remove it completely from later versions .
  75. @This can also be initiated by tapping the current search request in the status bar , or if no search request has been entered - by tapping the rightmost end of the statusbar .
  76. Quick search , allows a search for the next/previous record to be entered , after entering the search request press 'Enter' to search forward , or Ctrl+R to search backwards . All fields are searched . 
  77. As this feature was copied in its entirety from the Series 3 version of the program it is possible to carry out a dual search by typing in the search request as follows :- 
  78. mark and london
  79. mark and mablethorpe
  80. mkstevo@nildram.co.uk and markstevenson.nildram.co.uk
  81. records must contain both the items either side of the ' and ' - the spaces either side of the word and MUST exist - but are ignored
  82. mark or london
  83. mark or mablethorpe
  84. mkstevo@nildram.co.uk or www.markstevenson.nildram.co.uk
  85. records can contain either of the items either side of the ' or ' - the spaces either side of the word or MUST exist - but are ignored
  86. you can even type :- 
  87. mkstevo@nildram.co.uk and mablethorpe or mark and london
  88. this example is effectively split as follows
  89. mkstevo@nildram.co.uk and mablethorpe or mark and london 
  90. records can optionally contain either of the two sets of requests
  91. mkstevo@nildram.co.uk and mablethorpe or london
  92. Valid request
  93. this example is effectively split as follows
  94. mkstevo@nildram.co.uk and mablethorpe or london 
  95. records can optionally contain either of the two sets of requests . 
  96. mablethorpe or mkstevo@nildram.co.uk and london 
  97. Valid request
  98. mablethorpe or mkstevo@nildram.co.uk and
  99.  london 
  100. mablethorpe and mkstevo@nildram.co.uk and london or mark
  101. INVALID request
  102. mablethorpe and mkstevo@nildram.co.uk and london or mark 
  103. unless you have an entry containing the phrase 'mkstevo@nildram.co.uk and london' the first half of this search is unlikely to return as true . 
  104. If you wish to search for a phrase containing the word 'and' , either enter it with no trailing space ( 'dead and' or 'and buried' ) or use the find records command instead .
  105. About DataSel Ctrl+Q>About , displays a copyright notice and the version number .
  106. Navigation Fn+< )First record , goes to the first record
  107. Navigation Fn+> )Last record , goes to the last record .
  108. Jump Ctrl+J>Jump to record , jump directly to a specific record number .
  109. Find Ctrl+F
  110. Sql Search Shift+Ctrl+F
  111. Quick search Ctrl+G
  112. Find all records EscLFind all records , cancels any existing search and all records are valid .
  113. Insta-Search options Ctrl+I
  114. Insta-Search Entries
  115. Add records Ctrl+A
  116. Update Ctrl+U
  117. Update Current record , allows updating of records . Press 'Enter' to save the changes or 'Esc' to close the dialog and abandon any changes NOT YET SAVED .
  118. Edit New record Ctrl+K
  119. Delete Ctrl+D#
  120. Edit Field titles Shift+Ctrl+T
  121. Browser Ctrl+B
  122. About DataSel Ctrl+Q>About , displays a copyright notice and the version number .
  123. Navigation Fn+< )First record , goes to the first record
  124. Navigation Fn+> )Last record , goes to the last record .
  125. Jump Ctrl+J
  126. Jump to record , jump directly to a specific record number .
  127.  This command can be invoked by simply tapping the area of the screen showing the current record number and record count in the status window .
  128. Find Ctrl+F
  129. Sql Search Shift+Ctrl+F
  130. Quick search Ctrl+G
  131. Find all records EscLFind all records , cancels any existing search and all records are valid .
  132. Insta-Search options Ctrl+I
  133. Insta-Search Entries
  134. Add records Ctrl+A
  135. Update Ctrl+U
  136. Update Current record , allows updating of records . Press 'Enter' to save the changes or 'Esc' to close the dialog and abandon any changes NOT YET SAVED .
  137. Edit New record Ctrl+K
  138. Delete Ctrl+D#
  139. Edit Field titles Shift+Ctrl+T
  140. Browser Ctrl+B
  141. About DataSel Ctrl+Q>About , displays a copyright notice and the version number .
  142. Navigation Fn+< )First record , goes to the first record
  143. Navigation Fn+> )Last record , goes to the last record .
  144. Jump Ctrl+J
  145. This can also be initiated by tapping the current record number and record count in the status bar .
  146. Jump to record , jump directly to a specific record number .
  147. Find Ctrl+F
  148. Sql Search Shift+Ctrl+F
  149. Quick search Ctrl+G
  150. Find all records EscLFind all records , cancels any existing search and all records are valid .
  151. Insta-Search options Ctrl+I
  152. Insta-Search Entries
  153. Add records Ctrl+A
  154. Update Ctrl+U
  155. Update Current record , allows updating of records . Press 'Enter' to save the changes or 'Esc' to close the dialog and abandon any changes NOT YET SAVED .
  156. Edit New record Ctrl+K
  157. Delete Ctrl+D#
  158. Edit Field titles Shift+Ctrl+T
  159. Browser Ctrl+B
  160. DBrowser , Displays the records in a simple list style , press 'Enter' - close the browser and make the browsers current record the current record , 'Esc' close the browser , Ctrl+W alter the displayed record widths , to hide a field , set a width of 0 . The up and down arrows make the next/previous records current ( as indicated by the small arrow on the left of the screen ) and the PgUp/PgDn commands move through the records in larger blocks , the last ( or first ) visible record becomes the current one . The amount of records displayed will depend on the size of the screen as DataSel will try to fit as many as it can in the screen height available .
  161. NOTE: As from version 1.42 I have rewritten certain parts of the browser routine . This has speeded it up no end . When entering the browser , particularly if you are attempting to 'browse' a large number of records (500+) there will be a slight delay whilst the view is created , there will be a message displayed which will give a rough count of how many records have so far been loaded into the view . Only once this is completed will the browser view open . Once open however moving between records is as fast ( if not faster ) that moving through records in the standard record view .
  162. About DataSel Ctrl+Q>About , displays a copyright notice and the version number .
  163. Navigation Fn+< )First record , goes to the first record
  164. Navigation Fn+> )Last record , goes to the last record .
  165. Jump Ctrl+J
  166. This can also be initiated by tapping the current record number and record count in the status bar .
  167. Jump to record , jump directly to a specific record number .
  168. Find Ctrl+F
  169. Sql Search Shift+Ctrl+F
  170. Quick search Ctrl+G
  171. Find all records EscLFind all records , cancels any existing search and all records are valid .
  172. Insta-Search options Ctrl+I
  173. Insta-Search Entries
  174. Add records Ctrl+A
  175. Update Ctrl+U
  176. Update Current record , allows updating of records . Press 'Enter' to save the changes or 'Esc' to close the dialog and abandon any changes NOT YET SAVED .
  177. Edit New record Ctrl+K
  178. Delete Ctrl+D#
  179. Edit Field titles Shift+Ctrl+T
  180. Browser Ctrl+B
  181. DThe database file you wish to merge in MUST contain at least 8 Text fields or an error will occur . Memo field are NOT text fields , nor are Date fields Number fields etc. In Data you can check on the type of labels by pressing Ctrl+L , highlighting each field and then selecting Edit and checking the 'Type' . If there are less than 8 text fields you should add as many as are required until there are 8 text fields . Assuming there are 8 text fields , any NON-TEXT fields will be ignored ( and not merged in ) . If you have an existing Data file you wish to use in DataSel which does not conform to these requirements , I suggest you convert it on the PC using Psion file convertor to a Series 3 file then use Palmtop Software 3Base ( or similar ) to convert it to plain text file - in the format of :- 8 Fields per record : Field de-limiter = Carriage return , Line feed ( CR,LF ) : record de-limiter = Carriage return , Line feed ( CR,LF ) ( this method is highly recommended - 3Base is now freely downloadable from the Palmtop website )
  182. "Running DataSel for the first time
  183. Open Ctrl+O
  184. Open file , this allows you to open an existing DataSel file , you cannot open standard Epoc database files - see the merge command
  185. New Ctrl+N
  186. Merge Ctrl+L
  187. Merge Notes
  188. Exit Ctrl+E
  189. Exit , exits the program , all current options are saved and the database file is compressed ( deleted entries removed etc. ) to save disk space .
  190. Export Ctrl+X
  191.  Export ( Psion Data compatible ) 
  192. Export ( Unsorted order )
  193. Import Shift+Ctrl+X
  194.     Import(2)
  195. Import ( Backup )tIf you are importing into an existing file , it might be sensible to back the file up BEFORE attempting an import .
  196. CExport as text , this exports the file as text . When selecting Export , you have the option of exporting the current 'group' only ( as indicated in the status bar - IE Record 1 of 171 indicates a group of 171 , this may be a subset of records within the database ) or all of the records in the entire database , this second option abandons any existing searches . If the current group is made up of all the records in the database then either option will have the same effect , other than the alphabetic ordering .
  197. The export format can be set to either :- 
  198. DataSel type : 8 Fields per record Field de-limiter = Carriage return , Line feed ( CR,LF ) record de-limiter = Carriage return , Line feed ( CR,LF ) This is compatible with Palmtop software 3Base file conversion program and most PC databases have a plain text CR,LF import utility ( Dbase etc. )
  199. Psion Compatible : See help topic 'Export ( Psion Data Compatible )'
  200. "Running DataSel for the first time
  201. Open Ctrl+O
  202. Open file , this allows you to open an existing DataSel file , you cannot open standard Epoc database files - see the merge command
  203. New Ctrl+N
  204. Merge Ctrl+L
  205. Merge Notes
  206. Exit Ctrl+E
  207. Exit , exits the program , all current options are saved and the database file is compressed ( deleted entries removed etc. ) to save disk space .
  208. Export Ctrl+X
  209.  Export ( Psion Data compatible ) 
  210. Export ( Unsorted order )
  211. Import Shift+Ctrl+X
  212.     Import(2)
  213. Import ( Backup )tIf you are importing into an existing file , it might be sensible to back the file up BEFORE attempting an import .
  214. "Running DataSel for the first time
  215. Open Ctrl+O
  216. Open file , this allows you to open an existing DataSel file , you cannot open standard Epoc database files - see the merge command
  217. New Ctrl+N
  218. Merge Ctrl+L
  219. Merge Notes
  220. Exit Ctrl+E
  221. Exit , exits the program , all current options are saved and the database file is compressed ( deleted entries removed etc. ) to save disk space .
  222. Export Ctrl+X
  223.  Export ( Psion Data compatible ) 
  224. Import Shift+Ctrl+X
  225.     Import(2)
  226. Import ( Backup )tIf you are importing into an existing file , it might be sensible to back the file up BEFORE attempting an import .
  227. &AIf you set the 'Export delimiters' line to Psion Data when exporting the file , you will NOT be able to correctly import this back into DataSel , in this case you would have to import the file into a Psion Data file , then import this Data file into DataSel ( see instructions on exporting ) .
  228. "Running DataSel for the first time
  229. Open Ctrl+O
  230. Open file , this allows you to open an existing DataSel file , you cannot open standard Epoc database files - see the merge command
  231. New Ctrl+N
  232. Merge Ctrl+L
  233. Merge Notes
  234. Exit Ctrl+E
  235. Exit , exits the program , all current options are saved and the database file is compressed ( deleted entries removed etc. ) to save disk space .
  236. Export Ctrl+X
  237.  Export ( Psion Data compatible ) 
  238. Import Shift+Ctrl+X
  239.     Import(2)
  240. Import ( Backup )tIf you are importing into an existing file , it might be sensible to back the file up BEFORE attempting an import .
  241. Toolbar Ctrl+T
  242. Show toolbar , shows or hides a toolbar . The setting of the toolbar is saved on a file to file basis , you could have one file which automatically has a toolbar on opening and another with no toolbar .
  243. Word wrap Ctrl+WcWord Wrap , turns the word wrap on or off . Word wrap is always turned on when the file is opened
  244. Zoom in Ctrl+M    Zoom in
  245. Zoom out Shift+Ctrl+M
  246. Zoom out
  247. Debug Shift+Ctrl+D
  248.  Status Bar ( Scrolling entries )
  249. Next/Previous recordQThe left and right keys ( < , > ) move to the next/previous records as expected
  250. Disclaimer 
  251.     Copyright4Copyright Mark Stevenson 2001 mkstevo@nildram.co.uk
  252.