Administration

Adding a solution

• Select the "Admin" link. Enter your Username and Password. This will enter into the Administration table of contents.
• Select "Create a new solution". This will enter into the Addition form template.
• When adding a solution, the only mandatory selections are the Subject, and Solution. This allows for quick additions and later editing. But please put in as much detail as possible.
• Submitting this form will set the status of the solution as "Pending". A supervisor will need to review and authorize the solution to make it active.

Authorize a solution

• Select the "Admin" link. Enter your Username and Password. This will enter into the Administration table of contents.
• Select "Authorize pending solutions". This will enter into the Authorization page.
• This also will state how many solutions are pending as well.
• In the Authorization page, click the html link to view each solution. If it looks correct select the checkbox next to all that apply and click the submit button.
• This will activate all selected solutions into the database.

Editing a solution

• Select the "Admin" link. Enter your Username and Password. This will enter into the Administration table of contents.
• Select "Edit a solution". This will enter into the Edit form.
• Enter in the solution number and submit.
• This will enter into the Edit form template.
• In this area, make any necessary changes and submit them. This will auto increase the version number of the solution and submit the changes back into the active database.
• If the solution's status is Deleted, then it will give the option to re-activate. This will put it back in a Pending status and will need to be authorized again.
• When editing a solution it will be locked out so that nobody else edits the same one and overwrites data. The lock out will be cleared once the solution is finished being edited, or after 30 minutes from when it was opened. This is just in case the solution is selected to be edited, but either never does or never finishes.

Special Formatting

• Da'ath supports special formatting when creating or editing a solution.
• [link #] will insert a link to the solution number. [link 102]
• To use html tags, use the square braces [] instead of the greater/lessthan < >. [b] bold [/b]

Deleting a solution

• Select the "Admin" link. Enter your Username and Password. This will enter into the Administration table of contents.
• Select "Delete a solution". This will enter into the Deletion form.
• Enter in the solution number and submit.
• This will not delete the solution, but removes the solution from any searches, but allows it to be re-activated at a later date if necessary.

Remove Edit Lock Files

• Select the "Admin" link. Enter your Username and Password. This will enter into the Administration table of contents.
• Select "Remove Edit Lock Files". This will remove all Lock files created from users editing solutions.
• This rarely happens, but the option is available for administration purposes. Make sure the Lock directory permissions allow the web server to access it.

Database Status Info

• Select the "Admin" link. Enter your Username and Password. This will enter into the Administration table of contents.
• Select "Database Status Info". This will enter into the status page.
• This page will show some basic stats about the knowledge base and show the last 20 log messages.

Uploading a file

• A file can be uploaded and attached to any solution, via the ADD or EDIT options.
• When in the ADD or EDIT field, select the 'browse' button to find the file to upload.
• Then type in description for the file. This description is only used in the solution display.
• File uploading is restricted to certain file types for security. Currently they are: .pdf, .doc, .xls, .html, .txt, .gzip, .jpg, .png, .gif

Database Administration

• Select the "Admin" link. Enter your Username and Password. This will enter into the Administration table of contents.
• Select "Database Administration". This will enter into the Database administration section.
• Listed will be all database fields available to edit. Select a field and click 'submit'.
• Edit the current values, or add a new one and click 'Enter'.

Theme Administration

• Select the "Admin" link. Enter your Username and Password. This will enter into the Administration table of contents.
• Select "Theme Administration". This will enter into the Theme administration section.
• Listed will be all themes available in the Theme/ directory. Select a theme and click 'submit'.
• You can build your own theme. See the themes.txt file in the Docs/ directory.

User Administration

• Select the "Admin" link. Enter your Username and Password. This will enter into the Administration table of contents.
• Select "User Administration". This will enter into the User Administration Table of contents.
• All of these options require access level (5) to access, except to change a password.

  Create a new user

  • Select this option to create a new user to have access to the Administration tools.
  Edit a user
  • Edit any user value.
  List all users
  • This will list all users.
  Delete a user
  • Enter the username to delete.
  • This will not really delete the user, but disable the account from allowing login access.
  Change password
  • All access levels will have access to change their own password.
  • Enter in your new password twice and submit. Changes will take place instantly. You will have to log back into continue using the Administration tools.

Directory Tree

• Select the "Tree" or "Directory" link. This section will list all Companies, types and categories in the knowledge base. The count of how many solutions will be listed by each.

Fields described

• Solution ID: Unique number for each solution. (This is auto generated)
• Status: Status of the solution. Options are Active, Obsolete, Pending, and Deleted.
• Title: Title or main subject of the solution. (Mandatory entry)
• Company: Company name. (config.php holds listing of all types)
• Type: Type of solution. (config.php holds listing of all types)
• Category: Category that solution falls under. (config.php holds listing of all categories)
• Date Entered: Original creation date of solution. (This is auto entered)
• Date Updated: Date of last revision update. (This is auto updated)
• Revision: Revision number of solution. (This is auto incremented by .1)
• Summary: Brief summary of the solution. This should be more descriptive than the Subject. (Mandatory enter)
• Solution: This is the guts and main part of the solution. Fill out as much information as possible.
• Relationship: This will link to other active solutions if there is a connection.
• Attachments: This will link to any file attachments for the solution.

Search

• Enter the information to search for.
• Search will scan the subject, summary and solution fields to find all relative matches.
• If a blank search is performed, it will return all solutions found within the filters defined.
• Options to search for "phrase", "all words", and "any word". These options will help narrow down or widen your searches.

  Filters

  • Select any filters to help narrow the search results. The option "All" will search all items in that category.

  Advanced Search

  • This section allows for different search options. The same Search features still apply.
  • Solution ID: This allows to search for just the ID number and pull it up directly.
  • Attachments: This will filter and only pull up solutions that have attachments.
  • Date: This will search a date yyyy/mm/dd and find any solution newer than that date, or updated since that date.
  • custom search options: This radio button will allow you to format your search string however you wish, following the below rules.
    • Quotes (") can be used to narrow search results. Putting quotes around a group of words will search for that phrase. "this example" will search for all occurrences of the phrase (this example). Without the quotes the search will look for matches of the words (this) and (example).
    • Selecting the Solution ID checkbox will only search for the number of the solution in the search field and go directly to that solution.
    • + A leading plus sign indicates that this word must be present in every row returned.
    • - A leading minus sign indicates that this word must not be present in any row returned. By default (when neither plus nor minus is specified) the word is optional, but the rows that contain it will be rated higher. This mimics the behavior of MATCH() ... AGAINST() without the IN BOOLEAN MODE modifier.
    • < > These two operators are used to change a word's contribution to the relevance value that is assigned to a row. The < operator decreases the contribution and the > operator increases it. See the example below.
    • ( ) Parentheses are used to group words into subexpressions.
    • ~ A leading tilde acts as a negation operator, causing the word's contribution to the row relevance to be negative. It's useful for marking noise words. A row that contains such a word will be rated lower than others, but will not be excluded altogether, as it would be with the - operator.
    • * An asterisk is the truncation operator. Unlike the other operators, it should be appended to the word, not prepended.

      Examples:

      • apple banana ... find rows that contain at least one of these words.
      • +apple +juice ... both words.
      • +apple macintosh ... word ``apple'', but rank it higher if it also contain ``macintosh''.
      • +apple -macintosh ... word ``apple'' but not ``macintosh''.
      • +apple +(>pie < strudel) ... ``apple'' and ``pie'', or ``apple'' and ``strudel'' (in any order), but rank ``apple pie'' higher than ``apple strudel''.
      • apple* ... ``apple'', ``apples'', ``applesauce'', and ``applet''.
      • "some words" ... ``some words of wisdom'', but not ``some noise words''.