使用 Web 服務 › 如何建立自訂度量系列 › 建立自訂度量系列 XML 檔 › 新增 <ComponentDefinitionList> 區段

新增 <ComponentDefinitionList> 區段

<ComponentDefinitionList> 區段定義元件的詳細資料。 詳細資料包括為元件儲存在資料庫中的多個屬性定義，以及與 CA Performance Center 同步處理元件及其屬性的資訊。

只有在符合下列條件時，才需要此區段：

• 自訂度量系列 XML 檔指定 <IsList_> 索引標籤是設定為 True 的屬性。
• <ComponentList> 區段中的元件不是預先定義的元件。

  

在自訂度量系列的此區段中，包含下列索引標籤：

<Name>

<Description>

<CertificationType>—此索引標籤一律設定為 CUSTOM。

AttributeList

(選用) 定義為元件在資料庫中計算和定義的屬性清單。 使用元件屬性，同步處理這些屬性與 CA Performance Center，以提供 CA Performance Center 更多關於元件的資訊 (如程序元件的引數)。 此區段包含每個屬性的下列標記：

Name

指定 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 做為項目類型內容的所有屬性。 此區段包含每個屬性的下列標記：

Name

在 CA Performance Center 中定義此內容的內部名稱。

附註：Name 標記最大長度為 32 個字元。 請勿超過此限制。

標籤

指定此內容在 CA Performance Center 使用者介面中顯示的標籤。

AttributeName

參考 CA Performance Center 同步處理期間填入此內容的元件屬性。

Justification

指定顯示此內容時的 CA Performance Center 使用者介面文字對齊。

預設：Left

DisplayWidth

定義顯示此內容時 CA Performance Center 使用者介面中使用的欄寬度 (單位為公釐)。

OrderBySQL

在有多個 Data Aggregator 執行個體與 CA Performance Center 進行同步處理時，識別元件所屬的 Data Aggregator 執行個體。

附註：此項目是設定為 False，因為目前不支援此項目。

DatabaseType/MaxLength

對於此內容所用的推斷資料庫類型，指定預設長度上限的覆寫。

附註：如需有關各個 XML 標記的詳細資訊，請參閱 MetricFamily.xsd 及 Component.xsd 檔案中提供的內嵌文件。 如需程式碼範例，請參閱 ProcessInfoMFWithComponent.xml 檔案。 此範例檔案定義收集程序度量的度量系列。

更多資訊：

建立自訂度量系列 XML 檔

ComponentDefinitionList

如下圖所示，如果自訂度量系列引入新元件，例如 Process，可以在此區段中定義該元件。 ComponentDefinition 指定建立度量系列的元件所用的全部內容。 內容包括為元件儲存在資料庫中的多個屬性定義，以及與 CA Performance Center 同步處理元件及其屬性的資訊。