Demo to preview the settings
Introduction
Now you can make PDF files in back-end workflows at Bubble with PDF Conjurer!
Make more with the PDF Conjurer at server-side using the PDF Make!
You can insert into your PDF file:
- Texts
- Images
- Tables
- Columns
- Header / Footer
There is a total of 20 server-side actions that you can use in the back-end workflows to build your PDF file. These actions are very similar to those used on the client-side, with some particularities from the server-side Bubble actions! So, if you already use it on the client-side, it will be easy for you to use it on the server-side too!
Each action returns the configurations to the next action, and at the end, the plugin returns a base 64 string that the user can use in other actions in the back-end workflow, including make the file upload!
All actions receive the previous action result (except the โInitialize PDF Documentโ action), it will be always the first parameter you need to insert into the action! Please donโt forget! Each action will be shown below!
Plugin Actions๏ปฟ
Initialize PDF document
Load font
Not all fonts can be read. If you have a text in Arabic, Chinese, etc., please experiment with the top fonts for these languages and see which one suits you best. For ex: For example, for a PDF in Arabic, you can use Amiri.
Define new style
Add text
Add image
Add table
Conjure PDF
Upload PDF
Upload API workflow
o configure an upload API workflow is very simple:
Create an API Workflow and give it a name
Add a new parameter with the Type file! Remember the key name to insert into the โUpload PDFโ action field โFile input nameโ
Return the fileโs URL, using the action โReturn data from APIโ at the โData (Things)โ session
Optional: You can also use โCreate a new thing...โ to save the fileโs data that you want in your database, or use it into another workflow
Options available in PDF Conjurer PRO version
Start Multi-column
End Multi-column
Start repeating structures
End repeat structure
Start repeated table
Add column to a repeated table
End repeated table
Start advanced table
Add column into advanced table
End advanced table
Workflow example
Initializing your App and initial PDF Conjurer configurations:
- Create a new App into your account and add the PDF Conjurer plugin
- The server side actions only works into the Backend workflows, so just go to the Top Menu and open the
Backend workflows
- In the Backend workflows you can create a workflow like you want (if you have a paid plan), here we create a new API Workflow as example, so give it a name, and make the configurations that you need
2. Use the action Initialize PDF Document to set the initial
configurations of your PDF document
- After the Initialize PDF Document action, insert the action that you want to add a content, you can use it in any order that you want
- Remember to load the previous step result Configurations into the first field of each action
To use special structures like multi-columns and repeating structures:
- After the Initialize PDF Document (Not necessarily right after) action, insert the action that initialize the structure
- The content must be between the start action and the end action of the corresponding structure, you can use these fields to specify where the content will be inserted, if none of these fields were used, the content will be inserted into the document
- Remember to insert the end action, in order to insert the structure into the document, before the โConjure PDFโ action
- Repeated tables must be inserted inside a repeating structure
- You can also combine multi-columns with repeating structures, using both fields in the actions!
- You can insert repeated tables into multi-colunms when this multi-column are into a repeating structure
To activate the header and footer:
- Remember to use the activate header/footer on PDF action, you can use only one or both into your document:
- The background doesnโt need to be activated
- Insert content into these structures:
You can use the fields in an action to put the element into these structures
The elements into the header or footer are placed into a multi-column, so you can use the columns width property to adjust the content size
If the content is larger than the available space, it will be not displayed correctly
After inserting all the content you need:
- Use the action Conjure PDF
- Set the last action into the first field
- Set the PDF Document name
- Choose if you want to insert the data header at the result base 64 string
The action returns the base 64 string with the document content and its name with the pdf extension
Both the file name and the base 64 string can be:
- Returned from your API Workflow
- Saved into the database
- Uploaded it into the Bubble server through the action โUpload PDFโ and an upload API Workflow (see next page)
Uploading the PDF document
Configure an upload API Workflow (see page 34) and get your Workflow API root URL at your App Settings panel > API
After the action Conjure PDF:
- Use the action Upload PDF in your workflow
- Into field โUpload file URLโ insert your Workflow API root URL plus โ/your_upload_workflow_nameโ
- Insert the key name that receive a file into your upload workflow into the field โFile input nameโ
- The โFile nameโ field receives the โConjure PDFโ action File name result
- The โContentโ field receives the โConjure PDFโ action Content result
- If you chose not that the workflow run without authentication, you need to insert the API token or a valid token provided by an authentication API Workflow into the โAuthenticationโ field
The action returns the file's URL if it managed to locate it, in other words, if you configured your upload workflow correctly:
https://s3.amazonaws.com/appforest_uf/f1628301265406x464015184635478100/Image%20Test.pdf
You can find the file in the App Data panel > File Manager
You can also save the fileโs URL in the database, with the other information, like the name and his base64 string!
For example, to generate a list of files (periodic reports), or use it to send an email, or a message, show on a page and the user can click and open the file