> For the complete documentation index, see [llms.txt](https://docs.pentaho.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pentaho.com/pdia-admin/9.3-administer/embed-and-extend-pentaho-functionality-cp/embed-reporting-functionality/get-started-with-the-pentaho-reporting-sdk.md).

# Get started with the Pentaho Reporting SDK

You can download the latest Pentaho Reporting software development kit (SDK) from the [Support Portal](https://support.pentaho.com).

Download the `pre-classic-sdk-9.3.0.0-xxx` file and unpack the Pentaho Reporting SDK archive to a convenient and accessible location. If you use the Eclipse or IntelliJ IDEA development environments, this directory will also serve as your workspace.

In an effort to reduce the size of the SDK, the source code of its constituent libraries is not included. If you need to see the source to any of the software distributed with the Pentaho Reporting SDK, see [Source Code Links](/pdia-admin/9.3-administer/embed-and-extend-pentaho-functionality-cp/embed-reporting-functionality/advanced-topics/source-code-links.md) for instructions.

## Use the included Eclipse project

If you use the Eclipse or IntelliJ IDEA development environments, you can use the Eclipse project included with the Pentaho Reporting SDK to work directly with the example source code. Simply select the unpacked Pentaho Reporting SDK directory as your workspace.

You can also launch the `Sample1.java` and `Sample2.java` example applications directly from the file browser in Eclipse.

## SDK directory structure

The following elements are delivered in the SDK directory structure:

```
/
/documentation
/licenses
/samples
/WebContent
/../META-INF
/../WEB-INF
/../../lib
/lib
/source
/../org
/../../pentaho
/../../../reporting
/../../../../engine
/../../../../../classic
/../../../../../../samples
/sql
```

| Directory            | Content Description                                                           |
| -------------------- | ----------------------------------------------------------------------------- |
| `Documentation`      | Where the "Embedding the Pentaho Reporting engine" PDF is located             |
| `Licenses`           | Contains text files with licensing information                                |
| `Samples`            | The eclipse project directory, which contains the samples shown in this guide |
| `Samples/WebContent` | WebContent information used with Sample 4 (mainly the `WEB-INF/web.xml`)      |
| `Samples/lib`        | The lib directory which makes up thePentaho Reporting engine SDK              |
| `Samples/source`     | The source files used to make up the four reporting samples                   |
| `Samples/sql`        | The file-based HSQLDB instance used with the samples                          |

## Content of the samples directory

The following files appear in the `Samples` directory:

| File               | Purpose                                                                  |
| ------------------ | ------------------------------------------------------------------------ |
| `build.properties` | Ant properties used with the build script                                |
| `build.xml`        | Ant build script                                                         |
| `common_build.xml` | Ant Build Script                                                         |
| `ivysettings.xml`  | Settings for Ivy (used with build)                                       |
| `ivy.xml`          | Dependencies for project (used with Ivy – used with build)               |
| `.project`         | Eclipse project file                                                     |
| `.classpath`       | Eclipse classpath file                                                   |
| `samples.iml`      | IntelliJ project file                                                    |
| `Sample*.bat`      | Runs the sample (1/2/3) program on Windows                               |
| `Sample *.launch`  | Runs the sample (1/2/3) program from within Eclipse                      |
| `Sample*.sh`       | Runs the sample (1/2/3) project on linux                                 |
| `Sample4.war`      | The WAR that can be dropped in a Servlet Container (Tomcat) and executed |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pentaho.com/pdia-admin/9.3-administer/embed-and-extend-pentaho-functionality-cp/embed-reporting-functionality/get-started-with-the-pentaho-reporting-sdk.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.