Creating and publishing knowledge articles

Before you begin

• Make sure that knowledge sets are created and associated with appropriate knowledge templates.
• To help users navigate to appropriate sections in a knowledge article, you can add cross-references to those sections by adding anchor tags. Before you add the anchor tags, an administrator must whitelist the attributes of the anchor tags. Contact your administrator to confirm if the attributes for the anchor tag are whitelisted. 

Best practices for creating knowledge articles

You must create complete and accurate articles that help agents with the required information for their cases. 

The following image shows best practices for creating knowledge articles:

To create a knowledge article

1. Log in to BMC Helix Business Workflows. 

2. Navigate to Create > Knowledge.

   Important

   If you are using BMC Helix Knowledge Management by ComAround, you will be redirected to the BMC Helix Knowledge Management by ComAround portal to create a new article. To learn about creating a knowledge article, login to BMC Helix Knowledge Management by ComAround and refer to the help articles. Learn how to access BMC Helix Knowledge Management by ComAround help articles in

   Some content is unavailable due to permissions.

   .

   By default, the Line of Business is selected for which you can create an article.

3. Select a knowledge template for the article. Before you start creating the article, you can preview the template and then choose Use selected Template or to select a different template, click Select a different template. 

4. On the Create Knowledge page, enter the article title in the Knowledge Title field and the content in the text box by using the DocEditor.
   The following image shows the options in the text editor to format the text:
   
   Use the following table to learn about some of the options in the text editor:

   Icon	Description
   	Add a cross-reference link to a section in the same document.
   	Copy the formatting from a word or paragraph to apply it to a different word or paragraph in the document.
   	Insert text from a Word document into the knowledge article.
   	Insert a page break that appears in the printed format of the knowledge article.
   	Find and replace text in the knowledge article.

   Best Practice
   We recommend that you do not change the template of a knowledge article after you enter the content of the knowledge article. If you change the template, you must reenter all the details for the article in the new template.

5. In the Knowledge Metadata section, fill the following fields:

   Description of fields in the Knowledge Metadata section

   Field	Description
   Knowledge Set	To associate a knowledge set with the selected template, select the required knowledge set from the list. Knowledge templates inherit the permissions from the knowledge set and these permissions are applied to the article.
   Company	Select the requester's company for the knowledge article.
   Author	The logged in user is selected by default.
   Article locale	Select the language for the article.
   Assigned Group	Select the group to which the article will be assigned.
   Assignee	Select the user to which the article will be assigned. The article inherits the access permissions from the selected group.
   Assign to me	To assign the article to yourself, click Assign to me.
   Keywords	Add a keyword to the article. You can use this keyword to search for the article from a case.
   Category Tier 1, 2, 3, and 4	Select a category for the article. This classification is useful when you search for the article from a case using the Advanced search options and include the category values.
   Region, Site group, and Site	Select a region, site group, and site for the article. This information is useful when you search for the article from a case using the Advanced search options and select location values.
   Attachments	To attach files to the article, click Attachment. The valid file size is 20 MB.

   Important

   When you view a knowledge article with the view permission, the following read-only fields are displayed:

   • Knowledge Title
   • Article ID
   • Knowledge Status
   • RTF fields
   • View counter
   • Useful counter
   • Knowledge Metadata
   • Flag icon
6. Click Save Knowledge.

The view, edit, and search permissions of knowledge articles are inherited from knowledge sets. To change the permissions of the knowledge article, see To add or remove user access to a knowledge article.

After you create an article, the default status of the article is In Progress. As you work on the article, you can change the article status to reflect the progress on the article. For more information about article statuses, see Changing-knowledge-article-statuses.

If required, you can send the article for an SME review by changing the article status to SME Review. For more information about SME Review, see Reviewing-and-validating-knowledge-articles.

To publish a knowledge article

You can publish knowledge articles to an internal or external audience. To publish an article, you must have the Knowledge Contributor, Knowledge Publisher, or Knowledge Coach role. For more information about these roles, see FAQ.

To publish a knowledge article, complete the following steps:

1. Log in to BMC Helix Business Workflows.

2. Select Workspace > Knowledge.

   Important

   If you are using BMC Helix Knowledge Management by ComAround, you will be redirected to the BMC Helix Knowledge Management by ComAround portal. To learn about publishing a knowledge article, login to BMC Helix Knowledge Management by ComAround and refer to the help articles. Learn how to access BMC Helix Knowledge Management by ComAround help articles in

   Some content is unavailable due to permissions.

   .

   By default, the Line of Business is selected for which you want to publish an article.

3. To open a knowledge article from the Knowledge workspace, click the required article.
4. Click the status to open the status pane. 
5. In the Status field, specify the value Published.
6. (Optional) Specify the audience for the article in the External list in the Knowledge Metadata section. By default, the value of this field is set to No.

1. • No—Publish internally for agents.
     You must have Knowledge Contributor, Knowledge Publisher, or Knowledge Coach role to publish the article internally.

1. • Yes—Publish externally for agents and self-service users.
     You must have Knowledge Publisher or Knowledge Coach role to publish the article externally.

After you publish the article, you can periodically review the article to validate it. The Next Review Date field in the Knowledge Metadata section of the article displays the date by when you should review the article. As required, you can specify a different review date or extend it. For more information about the periodic review of articles, see Reviewing-and-validating-knowledge-articles.