Guide Overview
The following article is designed to give administrators and agents with the appropriate permissions an overview on the following topics:
Guide Index
You can use the following links below to quickly navigate to a specific section in this document. To quickly return to this index, simply use the Return to Index link located at the end of any section.
Introduction
The Knowledge Base provides you a central location to share solutions for common problems that teachers, faculty, staff, and agents may come across. From here, you can share internally created documents, provide access to outside documentation, as well as automatically link articles into tickets themselves.
You can access the Knowledge Base by selecting Knowledge Base from the left navigation bar.
Tip: You can add knowledge base articles to a ticket that you are working by using shortcuts. This is a fast and easy way to send the requestor an article addressing their issue. Please refer to this details article about shortcuts.
Setting up the Knowledge Base
The following section of this article is designed to give you a step-by-step guide on how to begin setting up your knowledge base from scratch. Please note, you must first set up your categories correctly in the following subsection before you can begin adding any help articles. In order, you will be shown how to:
Adding Categories
Before you begin adding articles to the knowledge base you will first need to create article categories. This includes parent categories and their corresponding subcategories, the latter of which is where you will actually store the help articles.
To set up your categories, click on the Add Category to the right under the options section.
This will bring up a window where you can name your category and specify that it has no parent category. Since it has no parent, it will instead become a parent category itself. When finished select Save.
Underneath the By Category section you will now see your new parent category.
Before you can begin adding help articles, you will first need to repeat creating a category. However, instead of leaving it without a parent category as before, you will instead need to select your previously created category as the Parent. When finished select Save.
You will now see your parent category along with your subcategory beneath it in the By Category section. At this point, you are now ready to begin adding articles to your knowledge base.
Adding Help Articles
Once you have your categories set up, you can begin adding your knowledge base articles. Begin by selecting Add Article on the right side of the page.
Important Note: If you have not added subcategories underneath parents categories, then you will be unable to add articles into the Knowledge Base. Please consult the Adding Categories section for further information.
You’ll now find yourself in the new article editor. At the very minimum, you will need to add a title, category to store the article under in the knowledge base, and either a link to an outside help article or fill in the issue and resolution fields. Below is a breakdown of what each field does:
- Title (Required): The name you want to display in the knowledge base and in ticket links.
- Category (Required): Select what category you want this article to be stored under in the Knowledge Base.
- Recommended Solution: Will generate a link in tickets that match the Applies To fields and selected Issues.
- Visibility: Allows you to set article visibility to Publicly, Everyone inside iiQ, or Agents and Admins Only.
- Owner: Allows you to set who should to have the ability to edit, manage, and delete this article.
- Estimated Effort: Here you can enter an estimated time this resolution will take the user.
- Tags: Allows you to add keywords to improve knowledge base searches.
- Attachments: Allows you to attach files and images for download or reference.
- Applies To Model: Here you can select what model(s) this article applies to.
- Applies To Category: Here you can select what model category(s) this article applies to.
- Custom Fields: Here you can add a custom field to your help article (available options based upon custom fields already attached to your selected model and/or model category.)
- External URL (Required if Issue and Resolution are empty): Here you can add a URL to an outside help article that will display within Incident IQ. (Please note that some websites do not allow this type of linking.)
- Open in new window: Will set this knowledge base article to open a new window for users when clicking on the link for this article provided in a ticket.
- Issue (Required if URL field is empty): This field is used to describe of the issue this article is designed to address.
- Resolution (Required if URL field is empty): This field is used to describe the method(s) used to remediate the issue.
Inserting Knowledge Base Suggestions in Tickets
If you want to link a knowledge base article in certain tickets you can do so by making it the Recommended Solution in the article editor.
You’ll need to select what models, model category, and/or issues this knowledge base article will appear in.
Now, whenever a ticket with this model and issues is submitted a new widget will appear linking directly to the knowledge base article. Requestors will see it prominently underneath their submitted ticket. Also, if requestors receive emails when tickets are created the Knowledge Base article links will be within the email.
For agents and administrators, they’ll see the widget beneath the model information on the right side of the screen.
Accessing the Public Article Link
When enabling the articles visibility to public you will be provided with an article link. This will be the link that you will provide your users that do not have a login with Incident IQ.
Click on the new article that you have saved. Next, click on Edit Article to the right. Under the visibility options you will be provided with the public article link.
Editing/Deleting Categories
If you need to edit a knowledge base category, begin by clicking on the category in question.
This will take you the selected category’s main page. Near the top right select the Edit button.
Next, a pop-up window will appear where you can edit the category name, assign it to or unassign it from a parent category, or deleted the category entirely.
Editing/Deleting Articles
To edit or delete a help article, begin by navigating to the article in question in the category that it is currently located under and clicking on it article title.
This will open the article page. If you have ownership of the article you can select to either Edit or Delete the article on the right side of the page.
