This add-on is operated by Expected Behavior
Simple & Robust HTML-to-PDF Conversion
Last updated 15 October 2015
Table of Contents
The DocRaptor add-on allows you to convert HTML into PDF and XLS documents on the fly from your application using the DocRaptor HTML to PDF cloud API.
Provisioning the add-on
DocRaptor can be attached to a Heroku application via the CLI:
A list of all plans available can be found here.
$ heroku addons:create docraptor -----> Adding docraptor to sharp-mountain-4005... done, v18 (free)
Once DocRaptor has been added a
DOCRAPTOR_API_KEY setting will be available in the app configuration and will contain the API key used to make requests against our document creation API. This can be confirmed using the
heroku config:get command.
$ heroku config:get DOCRAPTOR_API_KEY http://user:email@example.com/resourceid
After installing DocRaptor the application should be configured to fully integrate with the add-on.
After provisioning the add-on it’s necessary to locally replicate the config vars so your development environment can operate against the service.
Though less portable it’s also possible to set local environment variables using
Use the Heroku Local command-line tool to configure, run and manage process types specified in your app’s Procfile. Heroku Local reads configuration variables from a
.env file. To view all of your app’s config vars, type
heroku config. Use the following command to add the DOCRAPTOR_API_KEY values retrieved from heroku config to your
$ heroku config -s | grep DOCRAPTOR_API_KEY >> .env $ more .env
Credentials and other sensitive configuration values should not be committed to source-control. In Git exclude the .env file with:
echo .env >> .gitignore.
For more information, see the Heroku Local article.
Using with Rails 3.x
Ruby on Rails applications will need to add the following entry into their
Gemfile specifying the DocRaptor client library.
Update application dependencies with bundler.
$ bundle install
A very basic example of using DocRaptor to create a document might look something like this:
DocRaptor.create(:document_content => "<html><body>Some HTML!</body></html>", :document_type => "pdf")
Using with Python/Django, Java, Node.js, etc.
There are many more samples on the DocRaptor Coding Examples page.
Monitoring & Logging
Stats and the current state of DocRaptor can be displayed via the CLI.
$ heroku docraptor:command example output
For more information on the features available for DocRaptor please see the docs at docraptor.com/documentation.
The DocRaptor dashboard allows you to review logs from previous documentation creation requests.
The dashboard can be accessed via the CLI:
$ heroku addons:open docraptor Opening docraptor for sharp-mountain-4005…
or by visiting the Heroku apps web interface and selecting the application in question. Select DocRaptor from the Add-ons menu.
If document generation does not seem to be working then check your document logs on the DocRaptor dashboard.
Migrating between plans
Application owners should carefully manage the migration timing to ensure proper application function during the migration process.
heroku addons:upgrade command to migrate to a new plan.
$ heroku addons:upgrade docraptor:premium -----> Upgrading docraptor:newplan to sharp-mountain-4005... done, v1 ($95/mo) Your plan has been updated to: docraptor:premium
Removing the add-on
DocRaptor can be removed via the CLI.
This will destroy all associated data and cannot be undone!
$ heroku addons:destroy docraptor -----> Removing docraptor from sharp-mountain-4005... done, v1 (free)
Billing and Heroku account issues should be submitted via one of the Heroku Support channels. All technical questions and product feedback is welcome by contacting us at firstname.lastname@example.org. We are happy to assist with debugging your PDF documents.