DisplayString

Article
05/16/2012

Applies To: Operations Manager 2007 R2, System Center Operations Manager 2007

Represents a localizable name and description for an element or an alert message.

Schema Hierarchy

ManagementPack
  LanguagePacks
    LanguagePack
      DisplayStrings
        DisplayString

Syntax

<DisplayString ElementID=”ElementID”>
   <Name>Element or alert message name</Name>   <Description>Element description or alert message content </Description>
</DisplayString>

Attributes and Elements

The following sections describe attributes, child elements, and the parent element of the DisplayString element.

Attributes

Attribute	Description
ElementID	Required attribute. The ID of the element or string resource to which the localizable name and description are associated.
SubElementID	Required attribute only when the display string is applied to a sub-element of the element represented by the ElementID attribute, such as the Property (ClassType) element of the ClassType element.

Child Elements

Element	Description
Name (DisplayString)	Required element. Represents the display name of the element or alert message.
Description (DisplayString)	Optional element. Represents the display description of the element or alert message content.

Parent Elements

Element	Description
DisplayStrings	Contains all localizable display strings in the management pack.

Remarks

To provide friendly display strings for all elements and alert messages in your management pack, you must define a display string element for each language your management supports.

Display strings can be associated with any management pack element ID (for example, the ID of a ClassType element, Rule element, and so on).

Example

The following XML sample illustrates how to define two types of display strings. The first display string is the display name of the management pack. The second is associated with a StringResource element. String resource elements are generally used to provide detail alert messages in the Operations console.

<Manifest>
    <Identity>
      <ID>Microsoft.Windows.Client.XP</ID>
      <Version>6.0.6663.0</Version>
    </Identity>
    <Name>Microsoft Windows Client XP MP</Name>
    …
</Manifest>
…
<StringResource ID="Microsoft.Windows.Client.XP.LogicalDisk.AvailabilityHealth.AlertMessage" />
…
<LanguagePack ID="ENU" IsDefault="true">
   <DisplayStrings>
      <DisplayString ElementID="Microsoft.Windows.Client.XP">
         <Name>Windows Client XP Professional Operating Systems</Name>
         <Description>Microsoft Windows Client XP Professional Operating System Management Pack: This management pack discovers and monitors Windows XP Professional Client Operating Systems.</Description>
      </DisplayString>
      <DisplayString ElementID="Microsoft.Windows.Client.XP.LogicalDisk.AvailabilityHealth.AlertMessage">
         <Name>Logical Disk Not Available</Name>
         <Description>The Logical Disk {0} is Not Available</Description>
     </DisplayString>
   </DisplayStrings>
</LanguagePack>
…
<UnitMonitor ID="Microsoft.Windows.Client.XP.LogicalDisk.AvailabilityHealth" Accessibility="Public" Enabled="onEssentialMonitoring" Target="Microsoft.Windows.Client.XP.LogicalDisk" ParentMonitorID="SystemHealth!System.Health.AvailabilityState" Remotable="true" Priority="Normal" TypeID="Microsoft.Windows.Client.XP.LogicalDisk.Monitortype" ConfirmDelivery="false">
   <Category>StateCollection</Category>
   <AlertSettings AlertMessage="Microsoft.Windows.Client.XP.LogicalDisk.AvailabilityHealth.AlertMessage">
      <AlertOnState>Error</AlertOnState>
      <AutoResolve>true</AutoResolve>
      <AlertPriority>Normal</AlertPriority>
      <AlertSeverity>Error</AlertSeverity>
       <AlertParameters>
          <AlertParameter1>$Target/Property[Type="Windows!Microsoft.Windows.LogicalDevice"]/Name$</AlertParameter1>
       </AlertParameters>
    </AlertSettings>
…
</UnitMonitor>

Share via