Intergrating Postfix with Imixs-Office-Workflow

[lazo23]

Hello @rsoika,

I'm interested in integrating Postfix with imixs-Office-Workflow to enable email sending from within the workflow system to specified email accounts. Can someone provide guidance on how to achieve this integration and share the necessary configuration steps?

Thank you for your assistance.

[rsoika]

Hi,
this is independent from the Imixs-Office-Workflow application.
You can setup your smarthost and than you only need to provide an environment variable. In the standalone.xml file we have the following setting:

        <outbound-socket-binding name="mail-smtp">
            <remote-destination host="${env.MAILGATEWAY}" port="25"/>
        </outbound-socket-binding>

So when you set MAILGATEWAY to your postfix server sending mails should work.

[lazo23]

Hi @rsoika,

where do I find the standalone.xml file? I am running Imixs-Office-Workflow via Docker.

Thank you, Lazo

[rsoika]

In case you are using the standard docker setup is is sufficient if you just add the environment variable MAILGATEWAY

...
  app:
    image: imixs/imixs-office-workflow
    depends_on:
      - db
    environment:
      TZ: "CET"
      LANG: "en_US.UTF-8"
      MAILGATEWAY: "your-postfix-host"
      ....

Note, that the expected port is the default smtp-port 25

[lazo23]

In order to send a notification email after changing the status of a workflow, do I need to check this box?

Are there any other configurations that i need to do to be able to send emails through imixs office workflow?

[rsoika]

Just make sure that your model includes the Plugin

org.imixs.workflow.engine.plugins.MailPlugin

Your configuration is correct. For testing, you can add your own mail address into the 'Others' field.

On the server console you will see the log messages when the server generates and send the e-mail.

[lazo23]

Hello @rsoika,

i have attempted to implement your suggested method my adding the environtment variable MAILGATEWAY and configurating it to reference to my postfix server. Despite these adjustments, I am still encoutering difficulties with sending mails. Additionally, I have ensured that the mail plugin is correctly added in the properties of the workflow.

Could that be caused because of the firewall? Do I additionally need to allow traffic at the docker network?

My postfix server is configurated to send emails via STMP-port 25. I can not see why imixs-office-workflow is unable to send the emails. Could you please provide any further suggestions or assistance in resolving this matter?

Thank you.

[lazo23]

Hello @rsoika,

I'm working on a vacation planning workflow and would like to include a calendar in the first event, "Data Collection," allowing users to choose their vacation dates.

Is that possible? Could you please help me?

Thank you for your help.

[rsoika]

As long as you work with Imixs-Office-Workflow you can add such a imput element as so called form-part.
User Custom forms: https://doc.office-workflow.com/forms/index.html
and choose a Imput part: https://doc.office-workflow.com/forms/parts.html - in your case type="date"

[lazo23]

Hello @rsoika,

I am using the Imixs-Office-Workflow via Docker, and currently, it is running on localhost. However, I would like to set up a TLS connection to secure the website. Is it sufficient to configure this only at the system level, or are there additional settings required within Imixs-Office-Workflow?

Best regards,
@lazo23

[rsoika]

Hi,
There are two ways to do this. You can publish port 8181 instead of 8080 - this will allow you to access wildfly via https.
Or you use a reverse proxy like a nginx or apache server in front of your application.
Another solution for you could be the traefik.io project

Imixs-Office-Workflow itself is not affected from all this. It's a pure operation topic.l

[lazo23]

Hello @rsoika,

i have attempted to implement your suggested method my adding the environtment variable MAILGATEWAY and configurating it to reference to my postfix server. Despite these adjustments, I am still encoutering difficulties with sending mails. Additionally, I have ensured that the mail plugin is correctly added in the properties of the workflow.

Could that be caused because of the firewall? Do I additionally need to allow traffic at the docker network?

My postfix server is configurated to send emails via STMP-port 25. I can not see why imixs-office-workflow is unable to send the emails. Could you please provide any further suggestions or assistance in resolving this matter?

Thank you.

[rsoika]

Hi,
the second exception ViewExpiredException ist independent from your e-mail problem. This indicates simply that your web browser session was expired. Just reload the page to get rid of this.

The mail exception show indeed that your mail server did not accept invalid addresses. Which is normal. So you are near to success ;-)

[lazo23]

So the problem is not at the configuration of imixs-office-workflow, but at my postfix mail server?

[rsoika]

Can you confirm that the ViewExpiredException is gone?

[lazo23]

Yes it is gone.

[rsoika]

Ok, than we can concentrate on the message regarding the SMTP transfer. Do you still get an error message? From the messages above it looks like the server is not accepting the mail addresses you use to authenticate. But the message in the screenshot is incomplete. It looks to me that you have a problem in your exim4 server. If you take a look here you can find a simple test how you can verify your mail via exim4 before your test this issue with imixs-workflow. You need a bash into your exim4 container and than you can try a command like this:

echo "This is the message" | mail -s "The subject" captain.kirk@myhost.com -aFrom:sender@myhost.com

But you need to use valid addresses here.