Form

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

Represents a form definition in a management pack.

Schema Hierarchy

ManagementPack
  Presentation
    Forms
      Form

Syntax

Xml
<Form ID=”ID” Comment=”String” Accessibilty=”Private/Public” Target=”TargetID” Assembly=”AssemblyResourceID” BaseForm=”FormID” TypeName=”String”> <Category>Form</Category> </Form>

Xml

<Form ID=”ID” Comment=”String” Accessibilty=”Private/Public” Target=”TargetID” Assembly=”AssemblyResourceID” BaseForm=”FormID” TypeName=”String”>
   <Category>Form</Category>
</Form>

Attributes and Elements

The following sections describe attributes, child elements, and the parent element of the Form 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 class type.
Target	Required attribute. The ID of the targeted entity type. This can be the ID of either a ClassType element or a TypeProjection element.
Assembly	Required attribute. The ID of the Assembly (Resources) element that contains this form.
BaseForm	Optional attribute. The base Form element to which this form provides customization data.
TypeName	Required attribute. The type name of the Form element within the specified assembly.

Accessibility Attribute Values

Value	Description
Public	Indicates that this form is visible to external management packs for targeting or inheritance.
Internal	Indicates that external management packs cannot reference this form.

Child Elements

Element	Description
Category (Form)	Required element. Must have the value of “Form”.

Parent Elements

Element	Description
Presentation	Contains all user interface related elements that are defined in the management pack.

Remarks

A Form element represents a WPF form class within the specified assembly.

Example

The following XML sample illustrates a simple Form definition in a management pack. This particular Form provides a view to the history of the targeted workflow item (Microsoft.SystemCenter.WorkflowTarget). The target and assembly definitions are included for clarity.

	Copy Code
<Form TypeName="Microsoft.EnterpriseManagement.ServiceManager.UI.Administration.Workflow.HistoryView" Target="SystemCenter!Microsoft.SystemCenter.WorkflowTarget" ID="Microsoft.EnterpriseManagement.ServiceManager.Workflows.History.Form" Assembly="AdministrationAssembly" Accessibility="Public"> <Category>Form</Category> </Form> ... <ClassType ID="Microsoft.SystemCenter.WorkflowTarget" Base="AdminItem!System.AdminItem" Abstract="true" Accessibility="Public" Hosted="false" /> … <Assembly ID="AdministrationAssembly" Accessibility="Public" QualifiedName="Microsoft.EnterpriseManagement.ServiceManager.UI.Administration" FileName="Microsoft.EnterpriseManagement.ServiceManager.UI.Administration.dll" />

Copy Code

<Form TypeName="Microsoft.EnterpriseManagement.ServiceManager.UI.Administration.Workflow.HistoryView" Target="SystemCenter!Microsoft.SystemCenter.WorkflowTarget" ID="Microsoft.EnterpriseManagement.ServiceManager.Workflows.History.Form" Assembly="AdministrationAssembly" Accessibility="Public">
  <Category>Form</Category>
</Form>
...
<ClassType ID="Microsoft.SystemCenter.WorkflowTarget" Base="AdminItem!System.AdminItem" Abstract="true" Accessibility="Public" Hosted="false" />
…
<Assembly ID="AdministrationAssembly" Accessibility="Public" QualifiedName="Microsoft.EnterpriseManagement.ServiceManager.UI.Administration" FileName="Microsoft.EnterpriseManagement.ServiceManager.UI.Administration.dll" />