From users' point of view, the PDF View Plugin for JIRA is very simple to use.
All you have to do is clicking certain items in the Export drop-down menu to get your PDF documents. Those can either be generated:
After the PDF document is downloaded to your computer, open the file in any compatible viewer. Our primary recommendation is Adobe Reader.
Click one of the items in the Export drop-down menu in the Issue Details screen to get your PDF document.
Please note that there are multiple Export menu items available, because the plugin allows using any number of templates to generate PDF documents. You can, for instance, use one template to generate a timesheet based invoice from your issues, and use another to generate custom release notes.
Similarly to the previous, click one of the items in the Export drop-down menu in the Issue Navigator screen. (There can be multiple PDF export options available there, as written in the previous section.)
The plugin enables using any number of so-called views (export types), each relying on a different PDF template and different template logic. You can use one view to generate task lists, another to generate timesheets, and a third one to generate release notes documents, for example.
Views are ordered. Their order can be defined right in the PDF Views list. The same order will also be reflected in the Export drop-down menus, allowing the administrators to define a logical order for the items.
As written above, views render their output from PDF templates. All templates can be edited directly in a web based editor, by clicking on the name of a template in PDF Templates list.
Each PDF template:
Go to JIRA Administration → Add-ons → PDF Views.
You can easily create, edit, delete or reorder export types (views) in this screen. Please note that you can use the "edit" function also to rename or hide views.
The final PDF documents are rendered from template files, optionally running Groovy scripts. These files, used by the rendering process, are together called "resources".
Go to JIRA Administration → Add-ons → PDF Templates to manage resources.
You can easily create or edit PDF templates and Groovy scripts in this screen, using the web based code editor. To edit a resource, just click on its name, make the necessary modifications and save your work.
Next step: customizing your JIRA PDF templates.
Ask us any time.