TestFileAttachment

From GreenVulcano Wiki
Revision as of 09:52, 16 February 2012 by G.iannello (talk | contribs) (Flow implementation)
Jump to: navigation, search

Description

TestFileAttachment description

This example shows how to use GreenVulcano® ESB to send an email containing attachments.


TestFileAttachment service executes the following operations:

  • Reads a file from an input directory (TestAttach/input)
  • Sends an email with this file as attachment
  • Moves the sent file to another directory (TestAttach/sent)

VulCon Configuration

To configure TestFileAttachment service follow these steps:

  1. Define the System, Channel and Operations required
  2. Define the Services
  3. Implement the flows.

Defining System, Channel and Operations

To define a System, go to VulCon core view and, into Systems element, insert the System GVESB if it is not already present. From there create the Channel TEST_CHANNEL_FILE in which the following operations will be configured:

Attribute/Subelement Value
name ScanAttachments

FileCommands:

FileSearchCommand
filePattern=".*"
returnFullPath="true"
sourcePath="${{gv.app.home}}/TEST/TESTFS/TestAttach/input"
Attribute/Subelement Value
name MoveAttachments

FileCommands:

FileMoveCommand:
filePattern=".*"
sourcePath="${{gv.app.home}}/TEST/TESTFS/TestAttach/input"
targetPath="${{gv.app.home}}/TEST/TESTFS/TestAttach/sent"
Attribute Value
jndi-name gvesb.mailServer
name SendEmail
mail-message content-type="text-html"
high-priority="true"
sender-display-name="GV ESB"
subject="Test send attachments"
destinations:
to:
mail-address: address="gv2@gv.com"
message-body: gvBuffer-dump="false"
message-text: ${'Attachment file list:\n'+property['GV_SMTP_ATTACHMENTS']}

Flow implementation

TestFileAttachment flow

To implement the TestFileAttachment service Flow design it as shown in the picture:


The service looks for the file presence in a directory, sends it as attachment and moves it into another directory.


The following table shows the nodes and attributes to be defined:

Attribute/Subelement Value
first-node Prepare
Conditions/GVBufferCondition condition="FilesFound" type="condition"

Property:

name="GVFM_FOUND_FILES_NUM"
operator="greater"
type="gvbuffer-field"
value="0"
value-type="integer"
GVOperationNode dump-in-out="false"
id="list_files"
id-system="GVESB" input="input"
next-node-id="check_files"
op-type="call"
operation-name="ScanAttachments"
output="files"
GVNodeCheck default-id="end-nofiles"
id="check_files"
input="files"
on-exception-id="end"
GVRouting:
condition="FilesFound"
next-node-id="prepare"
ChangeGVBufferNode dump-in-out="true"
id="prepare"
input="files"
next-node-id="send_email"
output="files"

ChangeGVBuffer: clear-data="false"

OGNLScript: property['GV_SMTP_ATTACHMENTS'] = property['GVFM_FOUND_FILES_LIST']
GVOperationNode dump-in-out="false"
id="send_email"
id-system="GVESB"
input="files"
next-node-id="move_files"
operation-name="SendEmail"
output="files"
GVOperationNode dump-in-out="false"
id="move_files"
id-system="GVESB"
input="files"
next-node-id="end"
operation-name="MoveAttachments"
output="files"
GVEndNode end-business-process="yes"
id="end-nofiles"
output="files"
GVEndNode end-business-process="yes"
id="end"
output="files"

Save the editor clicking on the Save icon of Eclipse. Control that there are not errors in the flow and save it in the apposite icon present in the Core View of VulCon®. From the Project view, expand your project, refresh (f5), and right clicking the folder "conf" export your new configuration.

GV Console Configuration

It is time to deploy and test your new Service. To do that execute the following steps:

Deploy new Service

Suppose you have saved the VulCon Configuration file as "${{gv.app.home}}/TEST/REPG1.zip". To deploy the new Service follow this steps:

  1. Start GreenVulcano® ESB
  2. Access to the GV Console.
  3. In the Deploy New Service section click (Browse) and select the file where you saved the VulCon configuration.
  4. `Click Submit.

The section Deploy Services will be open. In this section you can select the services you want to deploy.

  1. Clicking on service TestFileAttachment a new view will be showed containing the files GVCore.xml present in local and on server side.
  2. Click Deploy. Now you can save the document and write some notes about it.
  3. Save the Document. By saving you will return to the Deploy Service section.
GV Console Utility section

Now pass to the GV Console section Utility.

  1. Click on Reload configuration
  2. Select GVCore.xml and then Reload. A new windows will be open to confirm the operation
  3. Click OK.
GV Console Testing section

Go to the GV Console section Testing. In this section you can finally test your new services:

  1. Into the Service voice select TestFileAttachment
  2. Into the System voice select GVESB
  3. Click RequestReply

The Testing View will be expanded and it is also possible to view the GVBuffer Output panel where there are present some properties, among these the GVFM_FOUND_FILES_NUM property set to 3, representing the number of files found.

The file TestOutput.txt will be generated in the directory ${{gv.app.home}}/log as previously set (see Testing, data input area) containing information about the files found and the email already sent.

<pre>
----------- TEST N. 0 2012.02.15 at 18:02:32 -----------
Standard Field:
	system   = GVESB
	service  = EmailFileAttachment
	id       = 7F0001014F3BE51400059DBA
	retCode  = 0
GVBuffer: class java.lang.String

Properties:
	messageID = <9388830.11329325352084.JavaMail.gv1@gv.com>
	GVFM_FOUND_FILES_LIST = <nowiki>${{gv.app.home}}</nowiki>/TEST/TESTFS/TestAttach/input/001.txt;
                                <nowiki>${{gv.app.home}}</nowiki>/TEST/TESTFS/TestAttach/input/002.txt;
                                <nowiki>${{gv.app.home}}</nowiki>/TEST/TESTFS/TestAttach/input/003.txt
	GVFM_FOUND_FILES_NUM = 3
	GV_SMTP_ATTACHMENTS = <nowiki>${{gv.app.home}}</nowiki>/TEST/TESTFS/TestAttach/input/001.txt;
                              <nowiki>${{gv.app.home}}</nowiki>/TEST/TESTFS/TestAttach/input/002.txt;
                              <nowiki>${{gv.app.home}}</nowiki>/TEST/TESTFS/TestAttach/input/003.txt
</pre>

Set a new account with the properties:
Server SMTP/POP3

  • SMTP : localhost:3025
  • POP3: localhost:3110
  • Server mailbox: gv1@gv.com (gv1/gv1)
  • Client mailbox: gv2@gv.com (gv2/gv2)
    gv3@gv.com (gv3/gv3)
TestFileAttachment email

You will receive an email as this shown in the picture.


You can also check that the files were moved into the directory ${{gv.app.home}}/TEST/TESTFS/TestAttach/sent.