2.2.9 View Definition File

File name

Any name

Description

The XML file that contains the definition of a view.

Use this file to register, update, and display details of a view. When registering or updating a view using this XML file, refer to "Creating Views" in the Operator's Guide to create the XML file.

File location

Any folder

File format

<?xml version="1.0" encoding="UTF-8"?>
<view>
  <layers>
    <layer>
      <layerNumber>LayerNumber</layerNumber>
      <layerName>CIName</layerName>
      <displayCi>CItoDisplay</displayCi>
      <conditions>
        <condition>
          <logicalOperator>logicalOperator</logicalOperator>
          <attribute>Attribute</attribute>
          <comparisonOperator>comparisonOperator</comparisonOperator>
          <keyword>Keyword</keyword>
        </condition>
      ...
      </conditions>
      <label>attributeToUseForLabel</label>
    </layer>
    ...
  </layers>
  <columns>
    <column>
      <columnNumber>columnNumber</columnNumber>
      <columnName>columnName</columnName>
      <layerNumber>LayerNumber</layerNumber>
      <attribute>Attribute</attribute>
    <column>
    ...
  </columns>
</view>

A description and the setting contents for each item (element) are shown below.

Modify the view definition if necessary, referring to this information.

Element names that are enclosed in square brackets, "[ ]", can be omitted.

Element	Type	Setting Range	Description	Required	Setting Content
layers	-	-	Specify multiple layers.	No
layer	-	-	Specify a layer.	No	When defining multiple layers, use multiple entries of this element.
columns	-	-	Specify multiple columns.	No
column	-	-	Specify a column.	No	When defining multiple columns, use multiple entries of this element.

The contents to specify for the layer element are shown below. Element names that are enclosed in square brackets, "[ ]", can be omitted from each layer element.

Element	Type	Setting Range	Description	Required	Setting Content
layerNumber	ASCII string	2 characters	The layer number.	Yes	Specify the layer number using a sequential number starting with 1.
layerName	UTF-8 string	Up to 85 characters	The CI name.	Yes
displayCi	ASCII string	Up to 32 characters	The CI to display.	Yes	Specify one of the following values: tenant_all: All tenants servergroup_all : All server groups server_all : All servers server_direct: Manually registered servers server_ror: Server of ServerView Resource Orchestrator server_openstack: OpenStack server vmhost_all : All VM hosts software_all : All software products software_updateadvisor: Fujitsu middleware software_direct: Manually registered software products patch_all: All patches patch_windowsos: Windows patches patch_linuxos: Linux patches patch_solarisos: Solaris patches patch_updateadvisor: Fujitsu middleware patches patch_direct: Manually registered patches parameter_all: Software parameters
conditions	-	-	Specify multiple conditions.	No	When not specifying any conditions, enter an empty element tag for this element.
condition	-	-	Specify a condition.	No	When defining multiple conditions, use multiple entries of this element.
label	ASCII string	Up to 32 characters	The attribute to use as the label.	Yes	Specify the attribute ID of the attribute, referring to "Chapter 3 CI Reference".

The contents to specify for the condition element are shown below. Element names that are enclosed in square brackets, "[ ]", can be omitted from each condition element.

Element	Type	Setting Range	Description	Required	Setting Content
logicalOperator	ASCII string	Up to 3 characters	The logical operator.	No	For the first condition, omit the value for this element. For the second and subsequent conditions, specify one of the following values for this element: and or
comparisonOperator	ASCII string	Up to 3 characters	The comparison operator.	Yes	Specify one of the following values: (1) == !== < <= > >= 1: When specifying "<" or ">" in an XML file, escape the character using "<" or ">", respectively.
keyword	UTF-8 string	Up to 128 characters	The keyword.	Yes	Specify a keyword. To specify an empty string, enter an empty element tag for this element.

Element

Type

Setting Range

Description

Required

Setting Content

logicalOperator

ASCII string

Up to 3 characters

The logical operator.

For the first condition, omit the value for this element. For the second and subsequent conditions, specify one of the following values for this element:

comparisonOperator

ASCII string

Up to 3 characters

The comparison operator.

Yes

Specify one of the following values: (*1)

*1: When specifying "<" or ">" in an XML file, escape the character using "<" or ">", respectively.

keyword

UTF-8 string

Up to 128 characters

The keyword.

Yes

Specify a keyword. To specify an empty string, enter an empty element tag for this element.

The contents to specify for the column element are shown below. Element names that are enclosed in square brackets, "[ ]", can be omitted from each column element.

Element	Type	Setting Range	Description	Required	Setting Content
columnNumber	ASCII string	2 characters	The column number.	Yes	Specify the column numbers using sequential numbers starting with 1.
columnName	UTF-8 string	Up to 85 characters	The column name.	Yes
layerNumber	ASCII string	2 characters	The layer to which the CI for the attribute to be output to the column belongs.	Yes	Specify the layer of the CI for the attribute using the layer number.
attribute	ASCII string	Up to 32 characters	The attribute to output to the column.	Yes	Specify the attribute ID of the attribute, referring to "Chapter 3 CI Reference".

Notes

None.

Examples

For registration

<?xml version="1.0" encoding="UTF-8"?>
<view>
  <layers>
    <layer>
      <layerNumber>1</layerNumber>
      <layerName>Tenant</layerName>
      <displayCi>tenant_all</displayCi>
      <conditions>
        <condition>
          <logicalOperator/>
          <attribute>tenantId</attribute>
          <comparisonOperator>==</comparisonOperator>
          <keyword>__DEFAULT__</keyword>
        </condition>
        </condition>
      <label>displayName</label>
    </layer>
    <layer>
      <layerNumber>2</layerNumber>
      <layerName>serverGroup</layerName>
      <displayCi>servergroup_all</displayCi>
      <conditions/>
      <label>serverGroupName</label>
    </layer>
    <layer>
      <layerNumber>3</layerNumber>
      <layerName>WindowsWebServer</layerName>
      <displayCi>server_direct</displayCi>
      <conditions>
        <condition>
          <logicalOperator/>
          <attribute>osType</attribute>
          <comparisonOperator>==</comparisonOperator>
          <keyword>Windows</keyword>
        </condition>
        <condition>
          <logicalOperator>and</logicalOperator>
          <attribute>serverName</attribute>
          <comparisonOperator>=</comparisonOperator>
          <keyword>^WebServer</keyword>
        </condition>
      </conditions>
      <label>serverName</label>
    </layer>
  </layers>
  <columns>
    <column>
      <columnNumber>1</columnNumber>
      <columnName>tenantName</columnName>
      <layerNumber>1</layerNumber>
      <attribute>displayName</attribute>
    </column>
    <column>
      <columnNumber>2</columnNumber>
      <columnName>serverGroupName</columnName>
      <layerNumber>2</layerNumber>
      <attribute>serverGroupName</attribute>
    </column>
    <column>
      <columnNumber>3</columnNumber>
      <columnName>serverName</columnName>
      <layerNumber>3</layerNumber>
      <attribute>serverName</attribute>
    </column>
  </columns>
</view>

For update

<?xml version="1.0" encoding="UTF-8"?>
<view>
  <layers>
    <layer>
      <layerNumber>1</layerNumber>
      <layerName>Tenant</layerName>
      <displayCi>tenant_all</displayCi>
      <conditions>
        <condition>
          <logicalOperator/>
          <attribute>tenantId</attribute>
          <comparisonOperator>==</comparisonOperator>
          <keyword>__DEFAULT__</keyword>
        </condition>
      </conditions>
      <label>displayName</label>
    </layer>
    <layer>
      <layerNumber>2</layerNumber>
      <layerName>serverGroup</layerName>
      <displayCi>servergroup_all</displayCi>
      <conditions/>
      <label>serverGroupName</label>
    </layer>
    <layer>
      <layerNumber>3</layerNumber>
      <layerName>WindowsWebServer</layerName>
      <displayCi>server_direct</displayCi>
      <conditions>
        <condition>
          <logicalOperator/>
          <attribute>osType</attribute>
          <comparisonOperator>==</comparisonOperator>
          <keyword>Windows</keyword>
        </condition>
        <condition>
          <logicalOperator>and</logicalOperator>
          <attribute>serverName</attribute>
          <comparisonOperator>=</comparisonOperator>
          <keyword>^WebServer</keyword>
        </condition>
      </conditions>
      <label>serverName</label>
    </layer>
  </layers>
  <columns>
    <column>
      <columnNumber>1</columnNumber>
      <columnName>tenantName</columnName>
      <layerNumber>1</layerNumber>
      <attribute>displayName</attribute>
    </column>
    <column>
      <columnNumber>2</columnNumber>
      <columnName>serverGroupName</columnName>
      <layerNumber>2</layerNumber>
      <attribute>serverGroupName</attribute>
    </column>
    <column>
      <columnNumber>3</columnNumber>
      <columnName>serverName</columnName>
      <layerNumber>3</layerNumber>
      <attribute>serverName</attribute>
    </column>
    <column>
      <columnNumber>4</columnNumber>
      <columnName>ipAddress</columnName>
      <layerNumber>3</layerNumber>
      <attribute>ipAddress</attribute>
    </column>
  </columns>
</view>