How does a custom module send emails and PDFs?
Updated Reading time: 3 min
On this page
Custom modules can pass on results: generate a report as a PDF, download it, attach it to an entry, or send it via email. For example: In the defect reporter, an employee reports a faulty radiator. The module generates a report as a PDF from this and sends it to the building technician, whom the administration has entered in the module settings.
Info
What a module sends and when is determined by the module itself. The administration decides whether it may also reach addresses outside the platform.
Reports as PDF#
A module creates a PDF from its data, for example a defect report, an inspection protocol, or an evaluation. Depending on the module, you can then:
download the PDF to save or print it,
attach it to the entry so that it remains with the report and is visible to everyone who is allowed to see the entry,
send it via email, as an attachment to platform users or to shared addresses.
A PDF has a maximum of 50 pages. It contains text, tables, and images from the module, but no content from the internet.
Emails from a module#
A module sends emails to up to 20 recipients at once. Recipients are people on the platform, groups, or, if the administration allows it, external email addresses.
Sender is always the platform under the name of your company. Below each message it says: Sent by <person> via the module "<module>" in <company>.
Replies go to the person who triggered the email, if the module provides for this.
Each recipient receives their own message. No one sees the addresses of the others, not even the addresses of colleagues.
Attachments: up to 5 files, together at most 15 MB, for example the created PDF, photos for the report, or tables.
People as recipients: The module only reaches people you can see yourself in the directory.
Groups as recipients: The module writes to all members of a group that you can see yourself. You yourself do not receive a copy. A group counts as one recipient, across all groups of one email it is at most 50 people. If there are more, the email is not sent.
You can see which modules send emails in the module itself: Click on the shield icon at the top right in the row above the module. There it states whether the module can send emails to people on the platform and, if applicable, also externally. More on this under How do I open my own module?.
Allow emails to external addresses#
A module may write to people on the platform without approval if it states this in its description. For external addresses, such as an external building technology company, your approval is required. This is set by people who are allowed to edit the module:
Open the module in the Module Studio: Administration, under Platform the entry Modules, tab Own, then the module.
Switch to the Settings tab at the top, then to General, and scroll to the Emails from the module section.
Enable Allow external recipients.
Under Only to these domains, enter the domains the module is allowed to write to, one per line, for example example.de. Subdomains are included.
Click Save.
Warning
Without a domain, no external recipient is allowed. If the module should be allowed to write to any address, enable Allow all domains and confirm the prompt. Only do this if you trust the module and everyone who uses it: the module then writes on behalf of your company, with content that people enter in the module.
Guests cannot trigger emails to external addresses.
If the module does not state in its description that it sends externally, the approval only takes effect with a version that states this.
The approval belongs to your installation and is retained during module updates.
Limits#
What | Limit |
|---|---|
Recipients per email | 20 |
People via groups per email | 50 |
Attachments per email | 5 files, 15 MB total |
File types as attachments | PDF, PNG, JPG, CSV, XLSX, DOCX, ODS, ODT, ODP, ICS, TXT |
Emails per person and module | 30 per hour |
Emails per company | 500 in 24 hours |
External recipients per company | 200 in 24 hours |
Pages per PDF | 50 |
Tracking Shipments#
Under Emails from the module, you will find the shipments of the last 7 days: how many emails were sent to how many people on the platform and to external addresses, and how many deliveries failed.
Info
Kibi only stores these numbers for shipments, not subjects, contents, or addresses.