# PDF Table Extraction Plugin

As of Squirro 3.2.4, users can now extract tables from PDF documents. Extracted tables are written to an Excel document.

In order to extract tables, follow the setup steps below. Afterwards, when navigating PDF documents a table icon should appear in the header of the PDF viewer. When selecting this button, users are now able to select table areas and subsequently export the tables.

PDF Table Extraction is powered by [Camelot](https://camelot-py.readthedocs.io/en/master/).
Hence, it should first be installed:

```shell
sudo yum install squirro-python38-camelot-py
```

## Setup

Update `/etc/squirro/frontend.ini` with the following:

```ini
[frontend]
pdf_table_extraction_url = /studio/pdf_table_extraction/table
```

Finally, upload the Plugin.

## Notes

Activity tracking is currently in use and records the following actions: `pdfExtractionSuccess` and `pdfExtractionFail`.
