Folder

Article
01/07/2013

Applies To: System Center Service Manager 2010

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Represents a folder to be displayed in the console.

Schema Hierarchy

ManagementPack
  Presentation
    Folders
      Folder

Syntax

<Folder ID="FolderID" Accessibility="Public/Private" ParentFolder="ParentFolderID"></Folder>

Attributes and Elements

The following sections describe attributes, child elements, and the parent element of the Folder 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.
Accessibility	Required attribute. Defines the visibility of the view type definition.
ParentFolder	Required attribute. Represents the ID of the folder that is to be the parent of this folder. The parent folder can be defined either in the management pack that defines this folder or in an external management pack.

Accessibility Attribute Values

Value	Description
Public	Indicates that the folder element is visible to external management packs so that external child folders can be added to it.
Internal	Indicates that the folder element is not visible to external management packs so that external child folders cannot be added to it.

Child Elements

None.

Parent Elements

Element	Description
Folders	Contains all folder definitions to be displayed in the Operations console.

Remarks

Folder elements are defined to contain one or more Views elements that have been defined in your management pack. Views cannot be displayed without first being contained by a folder. To contain a view inside a folder, you must define a FolderItem element without your management pack.

A display string for each folder should be defined in the display string section of the management pack for at least one language. For more information, see DisplayStrings.

Example

The following XML sample illustrates how to associate a View element with a Folder element by using the FolderItem definition. In this case, the Microsoft.EnterpriseManagement.ServiceManager.UI.Administration.View.Overview view will be placed under the top-level administration folder in the console.

<View ID="Microsoft.EnterpriseManagement.ServiceManager.UI.Administration.View.Overview" Target="System!System.Entity" Enabled="true" TypeID="OverviewType" Accessibility="Public">
  <Category>Overview</Category>
  ...
</View>
…
<Folder ID="Microsoft.EnterpriseManagement.ServiceManager.UI.Administration.Folder.Root" ParentFolder="Microsoft.EnterpriseManagement.ServiceManager.UI.Administration.Folder" Accessibility="Public" />
…
<FolderItem ID="Microsoft.EnterpriseManagement.ServiceManager.UI.Administration.FolderItem.Overview" ElementID="Microsoft.EnterpriseManagement.ServiceManager.UI.Administration.View.Overview" Folder="Microsoft.EnterpriseManagement.ServiceManager.UI.Administration.Folder.Root" />

Share via