Share via


GlobalRootcause Complex Type

Specifies resolvers and verifiers that act on the root causes that a troubleshooter finds.

<xs:complexType name="GlobalRootcause">
    <xs:sequence>
        <xs:element name="ID"
            type="dcmPS:ID"
            minOccurs="1"
            maxOccurs="1"
         />
        <xs:element name="DisplayInformation"
            type="dcmPS:DisplayInformation"
            minOccurs="1"
            maxOccurs="1"
         />
        <xs:element name="Resolvers"
            type="dcmPS:Resolvers"
            minOccurs="1"
            maxOccurs="1"
        >
            <xs:unique name="No_global_resolver_may_have_the_same_ID">
                <xs:selector
                    xpath="Resolver"
                 />
                <xs:field
                    xpath="ID"
                 />
            </xs:unique>
        </xs:element>
        <xs:element name="Verifier"
            type="dcmPS:Verifier"
            minOccurs="1"
            maxOccurs="1"
         />
        <xs:element name="ContextParameters"
            type="dcmPS:Parameters"
            minOccurs="1"
            maxOccurs="1"
         />
        <xs:element name="ExtensionPoint"
            type="dcmPS:ExtensionPoint"
            minOccurs="1"
            maxOccurs="1"
         />
    </xs:sequence>
</xs:complexType>

Child elements

Element Type Description
ContextParameters dcmPS:Parameters An extension point can contain substitution strings (for example, %param%). Each substitution string is replaced with the value of the same named parameter specified in the ContextParameters element.
You can also specify the Keywords parameter that MSDT will use in the event that the root cause is detected but not fixed. The value is a localized resource (for example, "@resource.dll,-123") that contains one or more keywords; each keyword is separated by a plus (+) sign (for example, keyword1+keyword2).
If the user clicks Explore additional options, the keywords are used to find related information if the user then clicks Help and Support, Windows Communities, or Related Troubleshooters.
For Help and Support, the keywords are used in a logical OR operation and for Windows Communities and Related Troubleshooters, the keywords are used in a logical AND operation.
You can specify keywords here or as an extension point of the package (see the ExtensionPoint child element of the GlobalDiagnosticPackage complex type).
DisplayInformation dcmPS:DisplayInformation The name and description of the root cause to use in the UI.
ExtensionPoint dcmPS:ExtensionPoint Used by the client to extend the functionality of the Rootcause node. The MSDT client does not support extensions for the Rootcause node.
ID dcmPS:ID A string identifier that identifies the global root cause.
Resolvers dcmPS:Resolvers The resolver scripts to run.
Verifier dcmPS:Verifier The verifier script to run.

Remarks

You must specify the resolver scripts; however, the verifier script is optional.

Requirements

Minimum supported client
Windows 7 [desktop apps only]
Minimum supported server
Windows Server 2008 R2 [desktop apps only]

See also

GlobalRootcauses Complex Type

Rootcause (GlobalRootcauses) Element