Summary

Represents a knowledge article that is associated with the specified element.

Management Pack Knowledge Authoring Tool

Summary

Management Pack Knowledge Authoring Tool provides online WSIWIG editor for creating Knowledge Articles in the System Center Operations Manager (SCOM) management packs.

Knowledge Authoring Tool provides the following functions:

Create and edit Knowledge Articles content in the WSIWIG editor. Supports all localizations.
Copy-paste the contents of the Knowledge Article from Word in the WSIWIG editor. Supports standard Word styles: headers 1-2 level, paragraph, table, bold and etc.
Load existing <KnowledgeArticle>/<MamlContent> XML elements and edit content in the WSIWIG editor.
Convert a Knowledge Article from WSIWIG editor to the MALM format. Specify ElementID to create a <KnowledgeArticle> element. If ElementID is not specified, it creates the <MamlContent> element.

Knowledge Articles in System Center Management Packs

System Center Operations Manager management packs include knowledge for rules, monitors, and alerts that helps you identify problems, causes, and resolutions. Knowledge is referred to as product knowledge or company knowledge. Product knowledge is embedded in a rule or monitor when it is authored. Company knowledge is added by management group administrators to expand the troubleshooting information and provide company-specific information for operators.

A knowledge article can be created for any management pack object, but only knowledge articles attached to an alert-generating rule or monitor are actually displayed from within the Operations Manager Console. Knowledge articles are stored by using MAML schema. This schema is included in the Operations Manager 2007 management pack schema. The knowledge article is either of type MAML or HTML. HTML is allowed for backward-compatibility reasons. Microsoft Assistance Markup Language (Microsoft AML, generally referred to as MAML) is an XML-based markup language.

Management Pack Schema Hierarchy:

ManagementPack
- LanguagePacks
  - LanguagePack
    - KnowledgeArticles — contains all knowledge articles that are related to management pack objects in the system.
      - KnowledgeArticle — represents a knowledge article that is associated with the specified element.
        
        MamlContent — represents the knowledge article layout in Microsoft Assistance Markup Language (MAML) markup.

Microsoft Assistance Markup Language (MAML) syntax for SCOM/SCSM management packs

Operations Manager supports displaying a limited number of MAML tags defined in Microsoft.MOM.UI.Common.dll:

MAML tag	HTML tag	Description
maml:section		The MamlContent element contains one or more maml:section elements.
maml:title	h1
maml:subTitle	h2
maml:para	p
maml:ui	b
maml:list	ul
maml:listItem	li
maml:table	table
maml:summary	table/summary	it is not used in real
maml:tableHeader	thead
maml:tableFooter	tfoot	it is not used in real
maml:row	tr
maml:navigationLink	a
maml:uri	a:href
maml:linkText	a (text)

Create Links in Knowledge Article

Operations Manager supports the following types of links:

A simple Link opens an external page:

<maml:navigationLink>

  <maml:linkText>http://go.microsoft.com/fwlink/?LinkId=28867</maml:linkText>

  <maml:uri href="http://go.microsoft.com/fwlink/?LinkId=28867" />

</maml:navigationLink>

A Task element can be included inline so that the user can launch a task from within the knowledge article. The following sample shows the correct markup for defining an inline task:

<maml:navigationLink>

   <maml:linkText>Start the Service</maml:linkText>

   <maml:uri condition="Task" href="Microsoft.Demo.NTService.StartService" uri="MOM.Console.Exe"/>

</maml:navigationLink>



<maml:navigationLink>

   <maml:linkText>Check top processes currently using the processor</maml:linkText>

   <maml:uri condition="Task" href="Microsoft.Server.AD.2008.TopCPU.Task&amp;tasktarget={$TARGET$}" uri="MOM.Console.Exe" />

</maml:navigationLink>



<maml:navigationLink>

   <maml:linkText>Start NLB node</maml:linkText>

   <maml:uri condition="Task" href="$MPElement[Name='Microsoft.Windows.NetworkLoadBalancing.StartNode']$&amp;tasktarget={$TARGET$}" uri="MOM.Console.Exe" />

</maml:navigationLink>

A ConsoleTask element can also be included within the knowledge article.

<maml:navigationLink>

   <maml:linkText>Ping the server</maml:linkText>

   <maml:uri condition="ConsoleTask" href="Windows!Ping" uri="MOM.Console.Exe"/>

</maml:navigationLink>



<maml:navigationLink>

   <maml:linkText>Launch ServerView Operations Manager (Single System View)</maml:linkText>

   <maml:uri condition="ConsoleTask" href="Fujitsu.Servers.PRIMERGY.ServerViewManagementConsole.ServerName.Task&amp;tasktarget={$TARGET$}" uri="MOM.Console.Exe" />

</maml:navigationLink>

A View element can be provided within the knowledge article text.

<maml:navigationLink>

   <maml:linkText>View Alerts</maml:linkText>

   <maml:uri condition="View" href="Fujitsu.Servers.PRIMERGY.ActiveAlertsView" uri="MOM.Console.Exe" />

</maml:navigationLink>



<maml:navigationLink>

   <maml:linkText>View Alerts</maml:linkText>

   <maml:uri condition="View" href="Microsoft.SystemCenter.AlertView&amp;viewtarget={$TARGET$}" uri="MOM.Console.Exe" />

</maml:navigationLink>



<maml:navigationLink>

   <maml:linkText>View all events</maml:linkText>

   <maml:uri condition="View" href="$MPElement[Name='WindowsServer!Microsoft.Windows.Server.DiskCapacity.Dashboard.View']$&amp;viewtarget={$TARGET$}" uri="MOM.Console.Exe"/>

</maml:navigationLink>