Creating custom views

In the lxca_filters.xml file, all default and custom views are included under the <filters> tag. You can also add custom views under this tag for any command that returns inventory data. In the following example, there is a filter for the chassis command named default. This is the default view that is used if the --view parameter is not specified. The following example also has a filter for the cmm command named location_view To use this view, specify --view location_view when you run the command.

<filters>
   <chassis name="default">...</chassis>
   <chassis name="health_view">...</chassis>
   <cmm name="location_view">...</cmm>
</filters>

Under each command tag (such as <chassis>) are the fields that you want returned for that view. You can choose to return any response-body field that the inventory REST API supports for the device type. In the following example, Name and ChassisLocation are the labels that are returned by the chassis command, and name and location are the names of the response-body fields in the GET /chassis/{uuid_list} request. If the field is an object, you must specify type="object” in the tag and then list the fields in the object that you want to return under the tag.

<filters>
   <chassis name="location_view">
      <Name>name</Name>
      <ChassisLocation name="location" type="object">
         <Rack>rack</Rack>
         <Room>room</Room>
      </Chassis_Location>
      <Contact>contact</Contact>
      <Type>type</Type>
      <IPAddresses>ipAddresses</IPAddresses>
      <HostName>hostname</HostHame>
      <UUID>uuid</UUID>
   </chassis>
</filters>

The following example is returned if you run the chassis command using the location_view filter that is defined previously:

Name: SN#Y031BG19H006
ChassisLocation:
    Rack: []
    Room: []
Contact: None
Type: Chassis
IPAddresses: [u'192.0.2.0', u'fe80::5ef3:fcff:fe25:e1dd', u'fd55:faaf:e1ab:2021:5ef3:fcff:fe25:e1dd']
HostName: SN#Y031BG19H006
UUID: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA