TDX Knowledge: Get Started with Knowledge Articles

This knowledge article guides TeamDynamix (TDX) Agents with the Knowledge Candidate role on how to create, update, renew, address feedback, and monitor their articles in the Knowledge Base. 

Before You Begin

 

If you have Knowledge article create/edit permissions, you can do the following tasks:

In This Article:

 

 

 

Creating New Articles

Step 1: Open the New Article Form

  1. Log in to the Client Portal and navigate to Knowledge Base. 
  2. Click +New Article button. The new article form appears.

 

Step 2: Select an Article Category 

  1. Search and select a Category for the article.

Note: By default the articles in the main categories inherent public visibility. You can change the article visibility to only for logged-in users later. For now continue to next step.

 

Step 3: Complete the Article Settings

  1. Leave the Order field set to 1.0.
  2. Leave Pin Article unchecked.
  3. Enter the article Subject (title) according to the Article Title Guidelines.
  4. In the Body text box, enter the article's scope statement according to the Article Scope Statement Guidelines.
  1. Copy the scope statement from the Body text box into the Article Summary text box.
  2. Add the appropriate Tags according to the Article Keywords or Tags Guidelines.
  3. If you want to receive notifications when users submit feedback, select Notify Owner on Feedback. 
  4. Select the primary contact person for the article form the Article Agent lookup.
  5. Click Save. 

Result: The article edit mode closes, and the article appears in view mode. 

 

Step 4: Add the Main Article Content 

  1. Click the Edit Article to open the article in edit mode.
  1. Enter the article content in the Body text box. Follow these guidelines as you build the article:
  • Formatting text: Use the formatting panel controls to format the article content.
  • Hyperlinks: Embed URL behind descriptive hyperlinks instead of displaying just long URLs.
  • Screenshots: If you are adding screenshots and need help see Inserting Images insturctions.
  • Table of Contents: If the article contains two or more H2 headings, consider Adding a Table of Content.
  • Alert boxes: If needed select a call-out alert boxe from Templates in the formatting panel.
  • Tables: If you add a table, consider enabling the hover-over effect in the Table Properties.

Note: For comprehensive formatting and styling guidelines refer to Article Styling Guidelines.

  1. When you finish adding content, click Update Article. 

Result: The article is saved, and it remains open in edit mode.

 

Step 5: Submit Article for Style Review

  1. Click the article title's breadcrumb above the article title to exit edit mode and display the article in view mode.
  2. Click Submit Article.

Result: The article is sent to a KB Admin on the TDX Admin team for formatting and styling review. It is not yet available to its intended audience.

 

Steps 6: Check Article Visibility (if needed)

  • While your article awaits review, confirm that its visibility matches your intended audience. You can change an article's visibility at any time. For instructions, see the Change Article Visibility section.

 

 

 

 

Updating Published Articles

Follow the instructions to modify the main content in an already published article.

Step 1: Access the Article

  1. Ensure you are logged in to the Client Portal.
  2. Click Knowledge Base on the menu bar.
  3. Search for the article you want to update.
  4. From the search results, click the article title to display it.

Result: The article is displayed in view mode on the Client Portal.

 

Step 2: Modify the Body Content 

  1. Click the Edit Article to open the article in edit mode.
  1. Edit the article content in the Body text box. Follow these guidelines as you build the article:
  • Formatting text: Use the formatting panel controls to format the article content.
  • Hyperlinks: Embed URL behind descriptive hyperlinks instead of displaying just long URLs.
  • Screenshots: If you are adding screenshots and need help see Inserting Images insturctions.
  • Table of Contents: If the article contains two or more H2 headings, consider Adding a Table of Content.
  • Alert boxes: If needed select a call-out alert boxe from Templates in the formatting panel.
  • Tables: If you add a table, consider enabling the hover-over effect in the Table Properties.

Note: For comprehensive formatting and styling guidelines refer to Article Styling Guidelines.

  1. When you finish adding content, click Save as Draft. 

Result: The article changes are saved, and it remains open in edit mode.

  1. Click the article title's breadcrumb above the article title to exit edit mode and display the article in view mode.

 

 

 

 

Change Article Visibility

The following three user-facing article visibility levels are available:

  • Public: Anyone can view the article without logging in. This is default for the articles in all Main categories.
  • Internal: Only logged-in users can view the article. This is default for the articles in the Departmental category.
  • Limited: Only logged-in users who belong to a specific college.

If you want to keep your article’s default visibility, no changes are needed. Use the table below to determine whether you need to modify your article’s visibility settings.

If the Article is in Desired visibility Level is Public Desired Visibility Level is Internal Desired Visibility Level is Limited
Any Main category No change needed, already default. Change visibility to Internal. Change visibility to Limited.
Departmental category — No change needed, already default.

If you need to change your article's visibility, follow the steps below:

 

Step 1: Open the Article

  1. Ensure you are logged in to the Client Portal.
  2. Click Knowledge Base on the menu bar.
  3. Search for the article you want to update.
  4. Click the article's title in the search results to display it in the view mode mode.

Result: The article opens in view mode..

 

Step 2: Open the Permissions Settings 

  1. Click the Edit Article button to open it in edit mode.
  2. Click the Permissions tab below the article title.

Result: The current Permissions settings are displayed.

 

Step 3: Choose the Visibility Level

Follow the instructions in the desired option for the visibility level you want to apply.

Option A: Set Visibility to Internal

Choose this option to make the article visible the logged-in users only.

  1. Clear the Inherit Permissions checkbox.
  2. Clear the Public checkbox.
  3. Select the Allow all individuals to view this article EXCEPT the associated groups below.
  4. Make sure the Add Group field is empty.
  5. Click Save.

Result: The article visibility change takes effect immediately..

Option B: Set Visibility to Limited

Choose this option to make the article visible only to the logged-in users who belong to specific college.

  1. Clear the Inherit Permissions checkbox.
  2. Clear the Public checkboxe.
  3. Select Allow ONLY the associated groups below to view this article.
  4. In the Add Groups dropdown, select the desired PG-xxxx group(s).
  1. Click Save.

Result: The article visibility change takes effect immediately.

 

 

 

Modify Article Settings

You can modify the article title, change the article category, update the article summary text, add or remove article tags, and transfer or take article ownership under article settings.

You can work with these settings in two steps. First, access the article you want to change. Then, make the actual changes to the settings.

Step 1: Access the Article

  1. Ensure you are logged in to the Client Portal.
  2. Click Knowledge Base on the menu bar.
  3. Search for the article you want to update.
  4. From the search results, click the article title to display it.

Result: The article is displayed in view mode on the Client Portal.

 

Step 2: Modify the Settings 

  1. Click the Edit Article button to open it in edit mode.
  2. Click the Settings tab under the article title.
  3. On the Settings window, make the desired changes:
  • Subject (or Title): See how to make effective Article Titles.
  • Category: You can sort the Category Lookup list by the Category column. This makes it easier to find a category.
  • Summary: See what to include in Article Summary. 
  • Tags: See Article Tags to know what to include as tags.
  • Notify Owner on Feedback: If enabled, all members of the article owner group will receive this notification.
  • Owner: This is the article owning group.
  • Article Agent: This person is the point of contact and owner of the article who represents the group and coordinates with the KB Admin.
  1. When you finish updating Settings, click Save.
  2. Click the article's breadcrumb above the article title to close edit mode and display the article in view mode.

Result: Your changes are saved and will take effect immediately.

 

 

 

Submitting Article Reviews

All published articles must be reviewed every six months for accuracy and currency. The six-month countdown starts from the article’s publish date or its last review date. 

Members of the article-owning group get an Article Review Due email 30 days before the due date.

You can submit an article review anytime before the due date. The review process has two steps:

Step 1: Find the Article

  1. Sign in to the Client Portal.
  2. Choose one of these reports:
  1. When the report page opens in a new tab, click the Run Report button.
  1. From the report results, click the article Title (in Subject column)

Result: You are viewing the article on the Client Portal.

 

Step 2: Complete the Review

  1. Check the article to see if anything needs to be updated. (if needed, see how to Update Existing Articles).
  2. Scroll to the Feedback section and address any unaddressed feedback (if needed, see how to Address Article Feedback).
  3. Scroll to Was this helpful? and click Yes.
  4. In the Comment box, type a short note like: Article reviewed, extend next review date.
  5. Click Submit (only once).
  1. Refresh your browser.

Result: Your article review is now recorded in the Feedback section.

 

 

 

Addressing Article Feedback

User feedback helps improve knowledge articles. Addressing each feedback submission recognizes the submitter’s contribution and encourages continued participation.

Article owners are primarily responsible for monitoring and addressing feedback on their articles

Logged-in users can submit one of two types of feedback on any article they can view by selecting Yes or No for Was this helpful? at the end of an article.

  • Reaction feedback: The user selects only Yes or No without adding comments.
  • Detailed feedback: The user also provides written comments or additional context.

 

Follow the steps below to find and address article feedback.

Step 1: Find Articles with Unaddressed Feedback

If you are not monitoring the article feedback on your ticketing dashboard, you can also find articles with unaddressed feedback using any of the following methods. Choose the method that best works for you.

Method 1: Find Articles with Feedback in Work Management 

  • Navigate to Work Management > Tickets and select My Articles – Unaddressed Feedback from the left navigation under Knowledge Reference Reports.

Method 2: Run the Article Unaddressed Feedback Report

  1. Sign in to the Client Portal.
  2. Choose the desired report:
  1. When the report opens in a new tab, click Run Report.
  1. To open an article with unaddressed feedback, click the article Title in the Subject column.

Result: The article opens in view mode.

 

Step 2: Review and Address Feedback

  1. Scroll to the bottom of the article and click Feedback.
  2. Look for unaddressed feedback submissions, which looks like this, 
  1. Choose the instructions for the appropriate feedback type below:  

Option A: Address Reaction Feedback

​If the feedback is only a Yes or No without any comments:

  1. Click Mark Addressed.

Result: The feedback is marked as addressed.

Option B: Address Detailed Feedback

If the feedback also includes written comments:

  1. Review the feedback comments.
  2. Update the article if appropriate.
  3. Click Mark Addressed.
  4. Recommended: If the feedback resulted in content corrections, send the feedback submitter a brief thank-you message.

Result: The feedback is marked as addressed.

 

 

 

 

Managing Articles

You can use Knowledge Reports to monitor or track your articles for common needs, such as checking upcoming review dates, viewing unaddressed feedback, or knowing approval status.

 

Monitor Your Articles

Here are a few ways to view the articles where you are the article agent:

Method 1: Run the Knowledge Reports in the Client Portal:

  1. Make sure you are signed in to the Client Portal.
  2. Click the desired report link:
  1. When the report opens in a new tab, click Run Report.

Result: Articles matching the report’s scope are displayed.

 

Method 2: Run the Knowledge Reports in TD Work Management.

  1. Go to TD Work Management
  2. Click View Applications and select the Tickets application.
  3. In the left navigation, scroll to the Knowledge Reference Reports section
  4. Click the desired report from the list in that section

Result: Articles matching the report’s scope are displayed.

 

Method 3: Add the Knowledge Reports you want to your dashboard.

Result: You can see your list of articles in real time, right next to your TDX tickets, on the same dashboard.

 

Monitor Group Articles

Here are a few ways to view the articles that your Responsible Group owns:

Method 1: Run the Knowledge Reports in the Client Portal:

  1. Make sure you are signed in to the Client Portal.
  2. Click the desired report link:
  1. When the report page opens in a new tab, click the Run Report button.
  2. Search and select your group for the Owning group is one of prompt.
  3. Click the Run Report button.

Result: Articles matching the report’s scope are displayed.


Method 2: Run the Knowledge Reports in TD Work Management.

  1. Go to TD Work Management
  2. Click View Applications and select the Tickets application.
  3. In the left navigation, click the Knowledge Reference Reports link.
  4. From the list of reports in the main window, click the desired 'Groups' Articles - xxx' report.

Result: Articles matching the report’s scope are displayed.

 

Adding the Group Reports on Dashboards: If you want a Groups' Articles report on your dashboard, first make a copy, set the Owning Group filter to your group, and add that customized version on the dashboard. Using the original report as it is will require you to manually select your group each time the dashboard refreshes. This is because TDX does not currently support dynamic group reporting. Their group-based Knowledge Base reports must either have a specific group selected in the filter or be chosen manually each time they run.

 

 

 

Retiring or Restoring Articles

 

Retire an Article

Published articles that miss a periodic review are considered outdated or abandoned. They will automatically retire to the archive by the 15th day after the missed review date.

  • If you want to retire an article, send a request and ensure to include the ID and Title of the article being retired.

 

Restore an Article

You can restore a retired or archived article in two steps. First, submit a request to restore the article as a draft. Then, submit the restored draft article for republishing.

Step 1: Submit a request to restore an article

  1. Sign in to the Client Portal.
  1. Choose one of these reports:
  1. When the report opens in a new tab, click Run Report.
  1. From the report list, note the ID and Title of the article you want to restore.
  2. Submit a request to restore the article and include the article ID and Title.

Result: Your request to restore an archived article has been submitted. The KB Admin will restore it in 24-48 hours. 

Step 2: Submit the restored article draft for republishing

Once you are notified that the requested article has been restored as a draft, follow these steps to get it published (make it live) for its audience. 

  1. Access the restored article
  2. Check the article to see if anything needs to be updated. (if needed, see how to Update Existing Articles).
  3. Scroll to the Feedback section and address any unaddressed feedback (if needed, see how to Address Article Feedback).
  4. In the View mode, click the Submit Article button, as you would for a new article.

Result: Your article has been submitted for publishing.

 

 

 

Managing Article Notifications

Knowledge articles generate automatic notifications at various points in their lifecycle. These messages are sent on a per-article basis as Outlook emails, and all members of the article’s owning group receive them. You can manage or filter these notifications by creating Outlook Rules that use Advanced Options with the with specific words in the body condition.

  • If you want to treat all Knowledge notifications the same (e.g., move them all to one folder), use kb-notifications- in the rule condition to capture all of them with a single rule.
  • If you plan to handle Knowledge notifications differently (e.g., route them to different folders), use the corresponding keywords below in the rule condition to create separate rules for each notification.
Notification Trigger Keyword to use in the rule
Feedback A user submits feedback on an article. kb-notifications-feedback
Review Due An article requires a periodic six-month review. kb-notifications-review-due
Status Change An article's lifecycle status is changed. kb-notifications-status-change
Draft Rejected A Knowledge Admin rejects an article. kb-notifications-draft-rejected

Result: This keeps the inbox clean for people who don’t handle articles, while making sure the people who do can still see the notifications.