Export a PDF of a report

get/reports/{reportId}/pdf
Internal-Use Only

Export a report as PDF. Maintain the client connection to download the report even if it takes some time to generate the PDF. Apply the query parameter values to the creation of the PDF output, overriding (1) defaults of the underlying rendering services, and also overriding (2) any defaults that were saved with the report by the SAS Visual Analytics application.

Request Samples

1

Response Samples

1No example avaliable

Path Parameters

NameTypeRequiredDescription
reportId
string
true

Identifier of an existing report resource. Report identifiers are generated by the Reports API when reports are created.

Examples:
"12345678-abcd-ef12-3456-123456789abc"

Query Parameters

NameTypeRequiredDescription
reportObjects
string
false

This parameter lists the labels of the report objects to include in the request. Multiple object labels are separated by commas. The labels can be quoted to avoid problems with spaces and special characters. If this is left empty, the result varies depending on the type of output. Report objects include visual elements like graphs, tables, and visual containers that the author has created in the layout, as well as complete pages. Specifying the object by its label makes it more convenient for the report author or viewer and does not to expose the internal names of objects in the model. However, if the client knows the internal identifier of a report object, it can be used instead of the label.

Examples:
"Bar+Chart+1,Cluster+Detail+Table"
coverPageText
string
false

Optional text to be included on the cover page. This setting is ignored if includeCoverPage is false.

Default:
expandClippedContent
boolean
false

Enables you to see all of the content for tables, crosstabs, gauges, and containers. This includes content that is only partially available in the layout of the page. Each object is displayed on a separate page at the end of the report.

Default:
false
includeAppendix
boolean
false

Indicates whether the appendix should be included. The appendix can contain comments, detail tables, and parts that were clipped in the main body of the report.

Default:
true
includeComments
boolean
false

Indicates whether the comments should be included in the appendix.

Default:
false
includeCoverPage
boolean
false

Indicates whether a cover page should be included. The cover page can include the name of the report, the date, the user name, and the number of pages.

Default:
true
includeDetailsTables
boolean
false

Indicates whether the detail tables should be included in the appendix.

Default:
false
includeTableOfContents
boolean
false

Indicates whether to add a table of contents.

Default:
false
margin
string
false

A margin value that is applied to all four margins of the page. It is nonnegative number, integer, or floating point, which is followed by the unit. The unit can be one of the following two-letter abbreviations: in, cm, mm, pt , px , em, or ex.

Default:
.25in
Examples:
"1.25in""2.5cm""25mm"
Match pattern:
\d*.\d*(in|cm|mm|pt|px|em|ex)
orientation
string
false

The page orientation. If this query parameter is set, it overrides any orientation that is saved in the report by the Visual Analytics UI and the default value defined by other supporting services.

Allowed values:
landscapeportrait
Default:
landscape
paperSize
string
false

The paper size designation from the enumerated list. Custom sizes are not provided in version 1. If this query parameter is set, it overrides any paperSize that is saved in the report by the Visual Analytics UI and the default value defined by other supporting services.

Allowed values:
letterlegalA3A4A5B4B5ledger
Default:
letter
showEmptyRowsAndColumns
boolean
false

Indicates whether empty rows and columns should be included to fill the allocated layout space for list tables and crosstabs.

Default:
false
showPageNumbers
boolean
false

Indicates whether page numbers should be displayed.

Default:
true

Header Parameters

NameTypeRequiredDescription
Accept-Language
string
false

The user's language, which is used in both rendering and caching. For technical details, see "/tools.ietf.org/html/rfc7231#section-5.3.5" It affects the language of reports if they have been translated. This setting overrides any other user preference that has been set, such as the "offline process locale" preference in Visual Analytics. If this header is not set and there is no user preference, the language is the default language of the service.

Accept-Locale
string
false

A "format locale" that is distinct from the user's language (Accept-Language). Its syntax is similar to Accept-Language. It is honored in running of queries and formatting of values. This setting overrides any other user preference that has been set, such as the "regional locale for formats" preference in Visual Analytics. If this header is not set and there is no user preference, the format locale is the default locale of the service.

Responses

StatusMeaningDescription
200OKSuccessful execution. Response is the report in the requested PDF format.HeadersSchema
303See OtherThe operation could not be completed before the wait period expired. This redirect (See Other) continues the process of waiting for the result. It is used to provide liveness to the browser transmit queue. Note that although this practice of redirecting is common, clients that cannot follow a redirect must either not use this method or specify a longer `wait` period.HeadersSchema
400Bad RequestThere was an error in the request.HeadersSchema
404Not FoundNot found ErrorSchema