Export a PDF of a report
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.
Name | Type | Required | Description |
---|---|---|---|
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" |
Name | Type | Required | Description |
---|---|---|---|
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 |
Name | Type | Required | Description |
---|---|---|---|
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. |
Status | Meaning | Description | ||
---|---|---|---|---|
200 | OK | Successful execution. Response is the report in the requested PDF format. | Headers | Schema |
303 | See Other | The 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. | Headers | Schema |
400 | Bad Request | There was an error in the request. | Headers | Schema |
404 | Not Found | Not found Error | Schema |