diff --git a/CHANGELOG.md b/CHANGELOG.md index f9379d7..10ecf4c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,7 @@ # Changelog +## [Version 1.1.0](https://github.com/dataiku/dss-plugin-sendmail/releases/tag/v1.1.0) - Feature release - 2026-08 +- Add Cobuild support to the send mails recipe ## [Version 1.0.3](https://github.com/dataiku/dss-plugin-sendmail/releases/tag/v1.0.3) - Feature release - 2025-03 diff --git a/custom-recipes/send-mails-from-contacts-dataset/Cobuild.md b/custom-recipes/send-mails-from-contacts-dataset/Cobuild.md new file mode 100644 index 0000000..1cf9261 --- /dev/null +++ b/custom-recipes/send-mails-from-contacts-dataset/Cobuild.md @@ -0,0 +1,8 @@ +- Always configure `output` with an existing dataset; the runner requires it even though the descriptor marks the role optional. +- For the sender, either set `sender_column`, or set `use_sender_value=true` and `sender_value`, unless the selected mail channel already defines the sender. +- For the subject, either set `subject_column`, or set `use_subject_value=true` and `subject_value`. +- For the body, either set `body_column`, or set `use_body_value=true` and use `body_format` with `body_value` for plain text or `html_body_value` for HTML. +- For `mail_channel`, call the `list_message_channels` tool with `integrationType=mail`. If several channels are available and the user did not identify one, ask which one to use. +- Set `mail_channel` to the chosen channel id. Append `__WITH_DEFINED_SENDER__` when its `sender` is set or `useCurrentUserAsSender` is true. +- If the user chooses to configure SMTP directly instead of using a DSS mail channel, set `mail_channel` to `__DKU__DIRECT_SMTP__`. When no DSS mail channel exists, leave it null. +- When direct SMTP uses authentication (`smtp_use_auth=true`), set `smtp_user` and ask the user to set `smtp_pass` in the DSS recipe settings; both are required by SMTP login. diff --git a/custom-recipes/send-mails-from-contacts-dataset/recipe.json b/custom-recipes/send-mails-from-contacts-dataset/recipe.json index e656acd..97a48b4 100644 --- a/custom-recipes/send-mails-from-contacts-dataset/recipe.json +++ b/custom-recipes/send-mails-from-contacts-dataset/recipe.json @@ -4,6 +4,9 @@ "description" : "Send personalised emails for every row in a Contacts dataset (mandatory), with data from Attachments datasets (optional) as CSV or Excel attachments, and use JINJA templating to show data in the email body. The output dataset shows the status of sent emails - please review it even if the job succeeds." }, "kind" : "PYTHON", + "cobuild": { + "supported": true + }, "selectableFromDataset": "contacts", "paramsPythonSetup": "dynamic_form.py", "inputRoles" : [ diff --git a/plugin.json b/plugin.json index ee7b2ac..8f000c5 100644 --- a/plugin.json +++ b/plugin.json @@ -1,6 +1,6 @@ { "id": "sendmail", - "version": "1.0.3", + "version": "1.1.0", "meta": { "label": "Send emails", "description": "Send emails based on a dataset containing a list of contacts, with optional attachments (other datasets)",