Using Web.Instance.List
Introduction
Web.Instance.List is a parameter available on Activate provisioning objects (mainly Services, Assets and Tasks) which allows the Activate Administrator to configure the columns and values that appear on lists of that object. The list of ServiceInstances on a service for example, which is accessible via the "Manage Access" button on the Service properties page.
The Web.Instance.List parameter is not included by default, a new parameter of type Xml needs to be created. This definition represents the default column configuration:
Text format for copying and pasting:
<list>
<standard>
<user name="User" visible="true">
</user>
<name name="Name" visible="true">
</name>
<status visible="true">
</status>
<owner visible="true">
</owner>
<costCentre visible="true">
</costCentre>
<services visible="true">
</services>
<properties visible="true">
</properties>
<assets visible="true">
</assets>
<computer visible="true">
</computer>
</standard>
<columns>
</columns>
</list>Row Types
The columns on a row are evaluated against the row context. The object type of the context can differ based on the root object.
Service: ServiceInstanceQuery Asset: AssetInstanceQuery Job: Job ServiceDeskProvider: Ticket
It's important when configuring a Web.Instance.List column that the expression fits the context.
Adding Custom Columns
Name is the property name of the object in context in the row, e.g. in the example below for a service, the column value in the grid would be the name of the Service (ServiceInstanceQuery.Name)
<columns> <column title="Service Name" name="Name" visible="true"></column> </columns>
If the name attribute is not set on the column it uses the innertext which can be an expression, this example ends up with the same result as the example above:
<columns> <column title="Service Name" visible="true">=/Name</column> </columns>
Values from data can also be shown on the list:
<columns> <column title="TextBox1" visible="true">=/data/textBox1</column> </columns>