This document contains instructions for editing existing KB documents. It also includes a training exercise in which document authors edit the sample document they created in KB Author Training - Creating a New Document. For detailed information about other aspects of the document editor, please continue with this training series or return to the KB Author Training - Overview.
To edit an existing document you must first locate it in the KB Admin Tools. Begin by clicking the Documents tab.
Links in the left-hand navigation menu: Active, In Review, In Progress, Inactive and Trash act as shortcuts to lists of documents by status. You can click on any of these links to see a list of documents at the corresponding status at your KB site. For example, to see all documents in 'Active' status click the Active link. Once you click on a status, it is highlighted in blue.
After you've selected a document status, you can refine your search using the filter dropdowns underneath the Status heading on the top of the screen. The image below shows the filters beneath the Documents in Review screen.
|ID or comma delimited IDs
||A document ID # or query string may be entered here. If a document ID is entered all other filters are ignored and that document is opened for review.
||Enter keywords here. Results from a keyword search will be returned for all documents whose title or keywords contain the query string entered. Case is ignored. All other filters (Topic, Status, Type, Group, Owner or Blog) will be used in a query string search.|
||By default, Keyword searches are run. In this dropdown, you can choose from searches; Keyword and Full Text Search (FTS) with the query string and other filters.|
|Search/ Priority||By default keyword searches are run. By selecting Top, High, Normal, Low, Exclude (Exclude from search) from the drop down window, a query will be run with the query string and other filters.|
|Topic||Lists documents in the specified topic. Options to select 'All topics' or 'No topics assignment' are available in the drop down in addition to all topics set up in that KB group.|
||Lists documents delineated by a specific Audience. Defaults to "all Audiences".
|Status||Use this drop down to limit results to documents of a specific Status. Choices are: 'Active', 'In Review', 'In Progress', 'Inactive', 'Trash'|
|Type||Use this drop down to limit results to documents of a specific Type. Choices are: 'All types', 'Document', 'Glossary', 'Template'.|
|Group||Use this drop down to limit results to documents of a specific Group. Choices are: ' 'Other groups', 'All groups'. Select 'Other groups' to see all documents being shared in to your group.|
|Owner||Use this drop down to limit results to documents of a specific user. By default 'All owners' will be selected.
|Site||By default results display documents which are either in the Internal KB site or External KB site. Use this drop down to limit results to Internal and External, Internal only, External only, Internal All or External All.|
||Use this drop down filter to limit results to documents of specific a Site Access restriction(s) based on the presence/absence of a valid campus login. Choices are: Defer to SiteAccess, Ext/internal with campus login, Internal for all campus users. This setting defaults to All campus access options.|
||View documents by relevance such as My/sharing groups, My Campus, My
University System and Universal.
|Blog||By default results display documents which do not have a blog. Use this drop down limit results to documents that do have a blog,
|Limit||By default results are displayed 25 documents on a page. Use this drop down to adjust the number of documents displayed on a page.|
|Go||Click 'Go' to execute the search.|
Once the document you are searching for appears in the search results, you can open it for editing by clicking on the document title.
Alternatively, if you search directly by document ID, you will be taken to the document automatically once you click on the Go button.
The image below shows the doc ID typed into the ID or comma delimited IDs field. Upon clicking the Go button, you will be led directly to your document, as seen on the right.
If the document's status is currently Active you will need to set the doc to 'In Progress' status to make changes.
Scroll to the bottom of the page. In the Review Options/Comment section, select Leave doc up and set to 'In Progress'.
In the Comments field, enter a brief description of changes you plan to make. Some groups may not require that comments be added before documents are updated, but it is a good practice nonetheless.
Click the Submit button
You will prompted to edit or preview the document. To make changes, click Edit document XXXXXX.
If the document's status is currently In Progress you can edit the document without changing its status by clicking the Edit button.
You should now see the document editor with the fields described in KB Author Training - Creating a New Document. Note that if the Title, Keywords, Summary and Body fields are grayed out, you do not have permissions to edit the document and you must to contact the document's owner in order to proceed.
Click the Save change button as changes are made.
Once all of desired changes and updates are completed, set the proper status for the document. Depending on your group's review process, you may need to activate the document yourself by setting it to Active. If your group has a review process, contact the group's KnowledgeBase admin to have them review your document and activate it.
The exact procedure for document review and activation may vary from group to group. If you have questions, please contact your KB site's admin regarding the specifics of your group's process.
If you are not the document owner or primary reviewer, we generally recommend against editing a document you do not own without permission. If you see a document that needs editing but you are not the owner, we encourage you to leave feedback or contact the owner or the primary reviewer to either offer your suggestion or to get permission to edit the document.
If you are not already logged in, log into the KB Admin Tools.
Note: If your institution is not using Shibboleth, go to the Active Directory Login.
Click on the Documents tab.
Since you did not make the document you created in KB Author Training - Creating a New Document active, it should still be at status In Progress. Click on the 'In Progress' link on the left-hand menu.
The easiest way to retrieve the document is to enter the document ID you recorded in the previous exercise into the ID or comma delimited IDs field, then click on the Go button.
If you do not have your document ID and you cannot locate your document in the list of 'In Progress' docs, try searching based on keyword. We named the sample document from the previous excercise [Your Name]'s First KB Document, so you should be able to enter your name in the 'Find' field to pull up your document.
Once you've located and opened your document, click the Edit button.
Add a line to the text in the Body field indicating that you've updated the document: This document was updated as part of the 'Editing an Existing Document' exercise!
You should end up with something that looks like this. Once you are satisfied with your updated document, scroll down to the Status section of the document editor, make sure that 'In Progress' is still selected, and click the Submit button.