in Alfresco

Alfresco inbound tutorial and telnet instructions

Introduction

Inbound is supported by alfresco and allows user to send email with attachment to alfresco. In this tutorial we are going to explain how to:

  • Enable alfresco inbound
  • Test if alfresco is receiving emails using telnet

Enabling alfresco inbound

Alfresco even though it supports inbound emails this feature is not enabled by default, in order to enable it you have to set this parameters into your alfresco global properties file

tomcat/shared/alfresco-global.properties
email.server.enabled=true

This next few properties are optional

email.server.port=25 #specify your port if this one is taken
email.inbound.unknownUser=anonymous  
email.server.domain=localhost #specify your domain

Property unknownUser is interesting, as if this user exist in this case anonymous alfresco will receive emails from unknown addresses.

Only thing you need to set after this is DNS to when person sends email to 123@alfrescoblog.com alfresco should receive it.

What is the email address for each node?

Each node has emailId property that will be visible when inbound is enabled. Can be seen in the properties of alfresco folder or file.

Email ID & Email Alias

 

For share to work we have to add some configuration in the share-config-custom.xml

<config evaluator="aspect" condition="emailserver:aliasable">
 <forms>
 <form>
 <field-visibility>
 <show id="emailserver:alias" />
 </field-visibility>
 <appearance>
 <field id="emailserver:alias" />
 </appearance>
 </form>
 </forms>
</config>

This will look like this:

Alias in Share

Alias in Share

PS: you need to add aspect aliasable to desired node. This can be done with share manage aspects action.

Test if alfresco inbound feature is working

For testing we need to add user to EMAIL_CONTRIBUTORS group and that user must have email address set.

Second we need to have telnet in your computer, for windows users you can enable your telnet using instructions here.

Lets type some commands and send email to alfresco from console.

1 :Type telnet like so:

telnet
open localhost 25

Response from the server will be

220 localhost ESMTP SubEthaSMTP 3.1.6

2: Next we must say helo

helo me

Alfresco will respond with

250 localhost

3: Now we want to send email by typing next command

mail from:admin@alfresco.com

Email address must be known to the alfresco, or anonymous username will be used if exists.

Server should say

250 Ok

4: Now we will enter who is receiving the email, in this case receiver would be a folder that we know email id or alias value (inbox or 892 in this case)

rcpt to:892@alfrescoblog.com

Server will say :

250 Ok

5: Final part is to specify body of our email using commands like this:

Data

Server will say

354 End data with <CR><LF>.<CR><LF>

We will continue with this ([enter] means press key enter)

Subject:alfrescoblog.com.txt[enter][enter]
this is email test being sent from alfresco blog.[enter][enter]
. [yes type dot][enter]

Server will respond with something like this if all was ok

250 Ok

Yeeeee we have sent the email to alfresco.

You can find your file in the inbox folder named as the subject in the email you have sent.

Sending email to alfresco with attachments

I have found this here and it works great!

Subject: This is a test mail
Date: Thu, 24 Mar 2011 15:15:29 +0900
MIME-Version: 1.0
Content-Type: multipart/mixed;
 boundary="----=_NextPart_000_001A_01CBEA36.4FC7F870"

This is a multi-part message in MIME format.

------=_NextPart_000_001A_01CBEA36.4FC7F870
Content-Type: text/plain;
 charset="utf-8"
Content-Transfer-Encoding: 7bit

This is a test mail.

------=_NextPart_000_001A_01CBEA36.4FC7F870
Content-Type: image/x-png;
 name="Image1.png"
Content-Transfer-Encoding: base64
Content-Disposition: inline;
 filename="Image1.png"

iVBORw0KGgoAAAANSUhEUgAAACgAAAAoCAIAAAADnC86AAAAFXRFWHRDcmVhdGlv
biBUaW1lAAfb
AxgPCwvMW+fiAAAAB3RJTUUH2wMYDwsbBO0U9gAAAAlwSFlzAAALEgAACxIB0t1+
/AAAAC1JREFU
eNrtzQENAAAIAyC1f2eN8c1BAXorY0KvWCwWi8VisVgsFovFYrH4ZXzcfAFPgCy5
CQAAAABJRU5E
rkJggg==

------=_NextPart_000_001A_01CBEA36.4FC7F870--

.

After you paste text above press enter .

 

Don't be shellfish...Tweet about this on TwitterShare on LinkedInShare on Google+Share on RedditShare on Facebook

Was this helpful ?