Image

Article
08/10/2011

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

Defines an image that represents an object in the console.

Warning

This element applies to Management Pack Schema 1.0 only.

Schema Hierarchy

ManagementPack
  PresentationTypes
    Images
      Image

Syntax

<Image ID=”ImageID” Comment=”Comment” Accessibility=”Public/Private” Category=”u16x16Icon/u32x32Icon/DiagramIcon/BmpIcon/StatusIcon/BackgroundImage”>
   <ImageData>binaryData</ImageData>
   <ImageSettings>…</ImageSettings>
</Image>

Attributes and Elements

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

Attributes

Attribute	Description
ID	Required attribute. Represents the identity of the element. To learn how to identify your element in a management pack, see Element Identity and Namespace Conventions.
Comment	Optional attribute. Represents commentary by the management pack author.
Accessibility	Required attribute. Defines the visibility of the image definition.
Category	Required attribute. Defines the category type of the image.

Accessibility Attribute Values

Value	Description
Public	Indicates that the module type definition is visible to external management packs.
Internal	Indicates that the module type definition is not visible to external management packs.

Category Attribute Values

Value	Description
u16x16Icon	Indicates that the image is a 16x16 icon.
u32x32Icon	Indicates that the image is a 32x32 icon.
DiagramIcon	Indicates that the image is an 80x80 image.
BmpIcon	Indicates that the image is a BMP image.
StatusIcon	Indicates that the image is used as a status icon.
BackgroundImage	Indicates that the image is used as a background image.

Child Elements

Element	Description
ImageData	Required element. Contains the serialized binary image data.
ImageSettings	Optional element. For internal use only.

Parent Elements

Element	Description
Images	Contains images that represent an object in the console.

Remarks

An image element contains binary data of the serialized image. When an image is assigned to a class type or other management pack object, that image will be rendered in the Operations console when instances of that target object are displayed.

A ClassType element inherits its image from its base class type. If a class type does not specify an image, it will be displayed with the image of its base class type. To associate a class type with an image, you must define an ImageReference element.

When defining an image, you should always define two: a 16x16 image (u16x16Icon) and an 80x80 image (DiagramIcon). This will ensure that the class type is represented properly in all places in the Operations console.

Example

The following XML sample illustrates how to associate an Image element with a ClassType element by using the ImageReference definition. In this case, Microsoft.Exchange2007 class type instances will appear with the specified custom images in the Operations console.

<ClassType ID="Microsoft.Exchange2007" Accessibility="Public" Abstract="false" Base="System!System.Service" Hosted="false" Singleton="true" />
…
<Image ID="Microsoft.Exchange2007.Image.Svc16" Accessibility="Public" Category="u16x16Icon">
   <ImageData>…</ImageData>
</Image>
<Image ID="Microsoft.Exchange2007.Image.Svc80" Accessibility="Public" Category="DiagramIcon">
   <ImageData>…</ImageData>
</Image>
…
<ImageReference ElementID="Microsoft.Exchange2007" ImageID="Microsoft.Exchange2007.Image.Svc80" />
<ImageReference ElementID="Microsoft.Exchange2007" ImageID="Microsoft.Exchange2007.Image.Svc16" />