Question 1

Is Carbone On-premise available?

Accepted Answer

Carbone On-premise is available, it includes:

Unlimited number of renders and formats
Unlimited usage in time
Unlimited servers & installations
For one project or one product, and any internal usage
Easy to install and deploy one-binary file for Linux distributions, and Mac OS. It can be used in docker, or installed with the self-configured and highly secured systemd’s sandboxing of Ubuntu, Debian, etc.
A light stateless studio with basic authentication
The possibility to add JS plugins to overwrite storage, authentication, and formatters
All Enterprise Edition features: dynamic image, dynamic color, HTML rendering, etc…
SLA support, and some hours of training
Free trial period, which can be extended if needed
Coming in next versions : open metrics + raw statistics for each report, improved log output, dynamic charts for DOCX/ODT, and more…

To get more information, reach the team on chat or by email: contact@carbone.io We will give you detailed documentation, the pricing and a trial license.

Question 2

How to insert a page break without having a blank page at the end of the report?

Accepted Answer

Inserting page break without an extra blank page

To insert a page break between each repetition section, you have two options:

A - Insert a page break within the repetition section
B - Or use paragraph options of Word to insert a page break before each new paragraph

Example A - page break

Template with page break

||| With the first option, the page break is repeated by the loop. So the last repeated part will contain a page break, which generates a blank page at the end of the report.

Here is the result:

[
  { "id": 1 },
  { "id": 100 }
]

Result with blank page

Example B - page break before paragraph

To avoid the blank page at the end of the report, we recommend to insert a page break before the first paragraph.

Page break before paragraph

How to do this?

In MS Word:

Select the first paragraph in your template
Right-click -> Paragraph…
Check the option "Page break before":

Page break before option in MS Word

In LibreOffice:

![Page break before option in LibreOffice](https://storage.crisp.chat/users/helpdesk/website/f3

Question 3

Carbone Roadmap

Accepted Answer

Community Edition

Read the roadmap on Github 😺

Enterprise Edition

2022 Q1 - Q2

✅ Carbone Account: new simplified billing and invoicing system
✅ Carbone Render/Studio/On-premise: Dynamic charts for DOCX and ODT documents > The Beta v4.0.0 is available!
✅ Carbone Render/Studio/On-premise: New aggregators formatters > The Beta v4.0.0 is available!
[WIP] Carbone Studio v3.0.0
[WIP] Carbone Core: No-code alternative syntax
[WIP] Enterprise Edition: On-click deploy on AWS

Later 2022

Carbone Core: New advanced error management
SOC2, HIPAA, HDS certifications
Digital PDF signatures
Factur-x standard

| The roadmap is flexible and based on the latest user feedback. If you need something or got questions, reach the team on chat or by email: support@carbone.io.

Question 4

Style guide to design a report

Accepted Answer

||| 🚩 Style guide in progress, more content is coming

Carbone Style Guide

This is the official style guide for Carbone specific code. If you use Carbone in a project, it’s a great reference to avoid errors, bikeshedding, and anti-patterns.

Essential

These rules help prevent errors, so learn and abide by them at all costs. Exceptions may exist, but should be very rare and only be made by those with expert knowledge of Carbone. The following checklist avoids unexpected behaviors, avoids creating a corrupted document or avoids not printed values on the generated report.

Check if, each loops begin with [i] and end with [i+1], such as {d.fruits[i].name}{d.fruits[i+1].name}.
Check if, each showBegin is followed by showEnd, or hideBegin with hideEnd.
Check if, every Carbone markers path is defined on the JSON dataset. Otherwise, values and lists will not be printed on the report.
Check if, the variable type you are printing is the expected one, if it is an Array (a.k.a. table), don't forget to use [i] and [i+1] to loop the whole table or use [i=0] to print only the first element.
Check if different loops are not mixed. The following example misbehaves the Carbone rendering and will generate a corrupted document : First loop: {d.fruits[i].name}{d.vegetables[i].name}{d.fruits[i+1].name} Second loop: {d.vegetables[i+1].name}. It should be: `First loop: {d.fruits[i].name}{d.fruits[i+1].name}, Second loop: {d.vegetables[i].name}{d.vegetables[i+

Question 5

Carbone V3 - News September 2021

Accepted Answer

Hello / Bonjour 👋

In this first news edition, we are celebrating and sharing with you a major Carbone update, version 3.0.0 🎉 As always, the Carbone team is focusing on stability, simplicity, and performance, that's why we are bringing you this new version. Carbone v3 is fully backward compatible with all of your reports. We value future-proof and sustainability, so do our users.

In this article, the team and I are pleased to introduce the following (cool) elements:

HTML rendering (Enterprise Edition Only)
Dynamic Hyperlinks (Enterprise Edition Only)
Dynamic Checkboxes (Enterprise Edition Only)
Carbone Render API updates (Enterprise Edition Only)
Core updates (Community Edition & Enterprise Edition )
WIP and Roadmap 🚀

The version was ship into production a few months ago and the v3.3.0 is already available, it is going blazing fast, but here we are to communicate! If you want to get all updates and all technical details, read our changelog.

To update to the latest version:

CarboneJS on Github: Update the package version, run on your terminal npm update carbone
Carbone Render API users: insert the header carbone-version:3. If API requ

Question 6

How to create a template?

Accepted Answer

How create a template and render it on Carbone Studio?

Create a template on Carbone studio is easy. You need LibreOffice or Microsoft word and a free account on Carbone Studio.

Create a template

You can create writer document, calc spreadsheet or event presentation.

Open libre office or Microsoft word

Choose the type of document you want.

Design your template

Then use your editor functionnalities to design it. You can add header, footer… Follow this documentation to add dynamic content with JSON data.

For example:

Template example

Save you document

You just need to save your document and your template is ready to be rendered

Upload your template in the studio

You can create a free account on Carbone Account. Once your are login, go on Carbone Studio.

|| By default you have an example template you can delete if you don't want it

Now let's add your new template. Click in the menu on Report and then New. A modal will appear:

Add a report

Add your saved document in the Template input
Add a name to your template in Name of the report
Choose a category. You c

Frequently Read Articles

Browse All Categories