Documentation

This is taking longer than usual. If nothing appears, refresh the page.

Documentation

{{docApp.title}}

{{docApp.description}}

Connect an AI assistant

Your AI assistant can read this documentation directly, so it answers from the current content instead of guessing. Add one of the servers below to your client — they use the Model Context Protocol (MCP). Each one covers a different body of content, so add the one you need.

The catalog did not load. Refresh the page to try again.

Loading…

How can we help?

{{docApp.searchError}}

Keep typing  - a search needs at least two characters

Searching in {{docApp.searchFilterBySpecificBookTitle}}

 {{docApp.currentResultsSearchText}}  in {{docApp.searchFilterBySpecificBookTitle}}
Found {{docApp.searchResponse.totalResultsAvailable}} matches. Showing the top {{docApp.searchResponse.results ? docApp.searchResponse.results.length : 0}}. Use a more specific search to further narrow down the results.
No documentation pages match this search, so all content types are shown. Most matches are in {{docApp.searchDocTypeRescue.best.name}}.
There is no book with the ID "{{docApp.searchBookRescue.bid}}", so the book filter from this link was ignored and results from all books are shown.

You have an odd number of " characters in your search terms - each one needs closing with a matching " character!
  • {{resultItem.title}} {{resultItem.matchedBy === 'semantic' ? 'semantic' : (resultItem.matchedBy === 'both' ? 'keyword + semantic' : 'keyword')}}

    {{resultItem.url}}

{{docApp.libraryHomeViewProduct.title || docApp.libraryHomeViewProduct.id}}

{{docApp.libraryHomeViewProduct.description}}

  1. {{book.title}}

Details

The Details section contains key information about the article. The settings and controls for the article can all be found here.

  • Id. A unique ID for the article. This cannot be changed.
  • Default Language. The language that the article was created in. This cannot be changed.
  • Title. Displayed in many of the lists and within the structure of the associated knowledge base. Because this title is important when users search for knowledge content, make sure to use a title that represents the article’s information in a way that helps users find the article.
  • Owned By. This is automatically set using the name of the person who created the article. Both the current owner and the knowledge base manager can change the owner.
  • Status. This changes when actions are taken on an article.
  • Date Published. The date when the article initially changed from draft to published.
  • Knowledge Base. This is the article’s current knowledge base. If you wish to transfer the article to a different knowledge base, you can choose from the list of existing knowledge bases. When changing the knowledge base, you will also need to change the topic.
  • Topic. Signifies where the article is located in the topic tree, which can be seen when browsing the knowledge base.
  • Knowledge Base Article Type. The selected article type can be used for filtering.
  • External Reference. A free-text field to record an external reference number for the article.
  • External Source. A free-text field to record an external source for the article.
  • Visible In Employee Portal. Provided that the knowledge base has been set to be visible in the Employee Portal, turning this setting off hides the article from this portal.
  • Visible In Customer Portal. Provided that the knowledge base has been set to be visible in the Customer Portal, turning this setting off hides the article from this portal.
  • Created By. The original creator of the article.
  • Last Modified By. The last person to modify the article.

Article status lifecycle

Each article will move through several statuses during its life.

  • Draft. An article that has the status of draft is not visible to users when browsing or searching a knowledge base. All new articles will start with the draft status.
  • Pending Approval. Where approval is required, a contributor will need to submit a draft article to be approved by a knowledge manager before it is published. When approved, the status will automatically change to published.
  • Published. Published articles are available to users when browsing and searching a knowledge base.
  • Retired. When an article is no longer relevant, the status can be set to retired. Retired articles are no longer available for users to browse or search. A retired article can be unretired. When unretired by a knowledge manager, the status will change to published. When unretired by a contributor and approval to publish articles is enabled, the article will need to be approved by a knowledge base manager before the status is set to published. The option to unretire can be found in the Details section of an article.
flowchart LR
A@{ shape: sm-circ, label: New}
B@{ shape: doc, label: "Draft"}
C@{ shape: diamond, label: KB Manager?}
D@{ shape: doc, label: "Published"}
E@{ shape: diamond, label: Approval Needed?}
F@{ shape: doc, label: "Pending Approval"}
G@{ shape: diamond, label: Approved?}
I@{ shape: doc, label: "Retired"}
J@{ shape: trap-t, label: "Unretire" }
A --> B
B --> C
C -- Yes --> D
C -- No --> E
D --> I
E -- No --> D
E -- Yes --> F
F --> G
G -- Yes --> D
G -- No --> B
I --> J
J --> C

Note

At any point within the lifecycle, an article can be deleted. This action cannot be reversed. Deleting will permanently remove the article.

In This Document