GetReports

Description

This service returns a list of reports within a specified range, limited by one or more optional filters.

Arguments

Response

GetReportsResult is returned. A filtered list of reports, within the specified range, is displayed in the response. The response contains the number of reports returned and a high-level description for each report. Use the isQueryAtRuntime element in the response to determine if the report can be executed using the RunReport call (query at runtime reports cannot be executed by RunReport). For more detail, see GetReportsResult.

Usage

The GetReports call finds a list of available reports without actually running any of the reports themselves. You can use GetReports to search for all reports that you have privileges to run, modify, and delete within the provided range . You can also use this call to search for auxiliary table reports that you can run, modify, and delete. You can use this call to identify which report you would like to run using the UUID of the report. To run a given report in the returned list, use RunReport. You can optionally use the returned report URL to run the report in a Web browser.

Faults

• Invalid database pointer.
• The project ID is not valid.
• The user lacks sufficient permission.
• Returning the report fails.

XML

The following XML is a snippet of the payload that is sent with GetReports.

<urn:GetReports>
    <urn:auth>
        <urn:userId>admin</urn:userId>
        <urn:password></urn:password>
        <urn:hostname></urn:hostname>
        <urn:loginAsUserId></urn:loginAsUserId>
    </urn:auth>
    <urn:queryRange>
            <urn:startIndex>1</urn:startIndex>
            <urn:fetchSize>4</urn:fetchSize>
            <urn:totalCount></urn:totalCount>
    </urn:queryRange>
    <urn:reportsFilter>
        <urn:solution>
            <urn:displayName></urn:displayName>
            <urn:id>1</urn:id>
            <urn:uuid></urn:uuid>
            <urn:uniqueName></urn:uniqueName>
            <urn:tabName></urn:tabName>
        </urn:solution>
        <urn:project>
            <urn:displayName></urn:displayName>
            <urn:id>4</urn:id>
            <urn:uuid></urn:uuid>
            <urn:fullyQualifiedName></urn:fullyQualifiedName>
        </urn:project>
        <urn:table>
            <urn:displayName></urn:displayName>
            <urn:id>1000</urn:id>
            <urn:uuid></urn:uuid>
            <urn:dbName></urn:dbName>
        </urn:table>
        <urn:author>
            <urn:displayName></urn:displayName>
            <urn:id></urn:id>
            <urn:uuid></urn:uuid>
            <urn:loginId></urn:loginId>
        </urn:author>
        <urn:reportType>LISTING</urn:reportType>
        <urn:reportCategory>ALL</urn:reportCategory>
        <urn:reportAccessLevel>USER</urn:reportAccessLevel>
        <urn:report>
            <urn:displayName></urn:displayName>
            <urn:id></urn:id>
            <urn:uuid></urn:uuid>
        </urn:report>
        <urn:searchByName></urn:searchByName>
        <urn:includeSubProjects>true</urn:includeSubProjects>
        <urn:createdDateFrom></urn:createdDateFrom>
        <urn:createdDateTo></urn:createdDateTo>
        <urn:extendedData>
            <urn:data>
                <urn:name></urn:name>
                <urn:value></urn:value>
            </urn:data>
        </urn:extendedData>
    </urn:reportsFilter>
    <urn:options>
        <urn:extraOption>
            <urn:name></urn:name>
            <urn:value></urn:value>
        </urn:extraOption>
    </urn:options>
</urn:GetReports>