使用 Web 服务 › 如何创建自定义度量标准系列 › 创建自定义度量标准系列 XML 文件 › 添加 <ComponentDefinitionList> 部分

添加 <ComponentDefinitionList> 部分

<ComponentDefinitionList> 部分定义有关您的组件的详细信息。 详细信息包括要存储在组件数据库中的更多属性的定义，以及组件及其属性与 CA Performance Center 同步的信息。

仅当满足以下条件时，才需要使用此部分：

• 您的自定义度量标准系列 XML 文件指定 <IsList_> 标记设置为 True 的属性。
• <ComponentList> 部分中的组件不是预定义的组件。

  

在自定义度量标准系列的此部分中包括以下标记：

<Name>

<Description>

<CertificationType>－始终将此标记设置为“自定义”。

AttributeList

（可选）定义了要在组件数据库中计算和存储的属性列表。 通过将这些属性与 CA Performance Center 同步，使用组件属性使组件的更多信息（如进程组件的参数）在 CA Performance Center 中可用。 本部分包括每个属性的以下标记：

名称

指定采用 QName 格式的唯一内部名称。

类型

指定此属性的数据类型。

IsList

表明此属性是基于标量还是基于表。 通常此值等于度量标准系列收集的相应属性的值。

说明

指定可在用户界面上显示的此属性的说明。

下图提供了使用 AttributeList 的示例：

ItemSyncDefinition

提供必要的详细信息，用于使组件与 CA Performance Center 保持同步。 ItemSyncDefinition 也列出要在同步期间作为组件属性发送给 CA Performance Center 的附加属性，以便它们在 CA Performance Center 用户界面中可见。 由于仅同步具有子类型的项，因此 <ItemSyncDefinition> 必须定义基本项类型和子类型。 基本项类型可以用于创建逻辑组，并提供对所有子类型可用的默认信息和同步行为。 在一些用例中，新的基本项类型可以改善性能。 对于多数用例，它是“组件”项目类型。 子类型项可提供更多特定于这些子类型的属性，必须对它们进行同步。 例如，度量标准系列可以定义过程子类型的过程参数属性。 此部分包括以下标记：

ItemTypeName

定义项基本类型的名称，以便要在 CA Performance Center 中使用。

ItemSubTypeName

定义项子类型的名称，以便在 CA Performance Center 中使用。

ItemTypeLabel

指定用户界面标签，以便在显示此类型的单个组件时使用。

ItemTypeLabelPlural

指定用户界面标签，以便在显示此类型的多个组件时使用。

IsDeviceComponent

指定此项是否为设备的组件（通常设置为 True）。 在设为 True 时，此标记表示此组件列于“设备组件”视图中。

GroupBy

定义是否需要将 CA Performance Center 中此类型的组件分组。 在设为 True 时，“清单”菜单下面的新菜单条目支持您将这些组件列在它们自己的组视图中。

Context

指定是否需要在 CA Performance Center 中为此类型的组件自动创建上下文类型（通常设置为 False）。

Categorize

指定是否需要在 CA Performance Center 中为此类型的组件创建动态组（通常设置为 False）。

Mapped

在多个 Data Aggregator 实例与 CA Performance Center 同步时，标识组件所属的 Data Aggregator 实例。

注意：由于该元素不受支持，因此要将其设置为 False。

ItemPropertyList

列出作为项类型的属性同步到 CA Performance Center 的所有属性。 本部分包括每个属性的以下标记：

名称

定义 CA Performance Center 中此属性的内部名称。

注意：“名称”标记有 32 个字符的最大长度。 请勿超出此限制。

Label

指定要在 CA Performance Center 用户界面中为此属性显示的标签。

AttributeName

引用在 CA Performance Center 同步期间填充此特性的组件属性。

Justification

指定显示此属性的 CA Performance Center 用户界面中的文本对齐。

默认：左对齐

DisplayWidth

定义列宽（以毫米为单位），以便在显示此属性的 CA Performance Center 用户界面中使用。

OrderBySQL

在多个 Data Aggregator 实例与 CA Performance Center 同步时，标识组件所属的 Data Aggregator 实例。

注意：由于该元素不受支持，因此要将其设置为 False。

DatabaseType/MaxLength

指定推断数据库类型的默认最大长度覆盖，以便用于此属性。

注意：有关每个 XML 标记的详细信息，请参阅 MetricFamily.xsd 和 Component.xsd 文件中提供的行内注释式文档。 有关代码示例，请参阅 ProcessInfoMFWithComponent.xml 文件。 此示例文件定义用于收集进程度量标准的度量标准系列。

详细信息：

创建自定义度量标准系列 XML 文件

ComponentDefinitionList

如果您的自定义度量标准系列介绍了新组件项，例如下图所示的您在此部分中定义的进程。 ComponentDefinition 为度量标准系列的组件的创建指定所有属性。 特性包括要存储在组件数据库中的更多属性的定义，以及组件及其属性与 CA Performance Center 同步的信息。