Visual FoxPro

Rename Email Attachments After Adding

Demonstrates how to rename email attachments after adding but before sending. Visual FoxPro

LOCAL lnSuccess
LOCAL loMailman
LOCAL loEmail
LOCAL lcContentType

lnSuccess = 0

* This example requires the Chilkat API to have been previously unlocked.
* See Global Unlock Sample for sample code.

loMailman = CreateObject('Chilkat.MailMan')

loMailman.SmtpHost = "smtp.my-mail-server.com"
loMailman.SmtpUsername = "MY_SMTP_USERNAME"
loMailman.SmtpPassword = "MY_SMTP_PASSWORD"
loMailman.SmtpSsl = 1
loMailman.SmtpPort = 465

loEmail = CreateObject('Chilkat.Email')

loEmail.Subject = "This is a test"
loEmail.Body = "This is a test"
loEmail.From = "Chilkat Support <support@chilkatsoft.com>"
lnSuccess = loEmail.AddTo("Chilkat Admin","admin@chilkatsoft.com")
* To add more recipients, call AddTo, AddCC, or AddBcc once per recipient.

* Add some attachments.
* The AddFileAttachment method returns the value of the content-type it chose for the attachment.
lcContentType = loEmail.AddFileAttachment("qa_data/jpg/starfish.jpg")
IF (loEmail.LastMethodSuccess <> 1) THEN
    ? loEmail.LastErrorText
    RELEASE loMailman
    RELEASE loEmail
    CANCEL
ENDIF

lcContentType = loEmail.AddFileAttachment("qa_data/pdf/fishing.pdf")
IF (loEmail.LastMethodSuccess <> 1) THEN
    ? loEmail.LastErrorText
    RELEASE loMailman
    RELEASE loEmail
    CANCEL
ENDIF

* If we save the email to a .eml, we can examine in a text editor.
lnSuccess = loEmail.SaveEml("qa_output/e1.eml")
IF (lnSuccess = 0) THEN
    ? loEmail.LastErrorText
    ? "Failed to save .eml"
    RELEASE loMailman
    RELEASE loEmail
    CANCEL
ENDIF

* We see the following in the e1.eml
* Notice that Chilkat replaced the full path with just the filename.
* The full local path is not part of the email that gets sent..

* ...
* --------------020807050607070004010609
* Content-Type: image/jpeg; name="starfish.jpg"
* Content-Transfer-Encoding: base64
* Content-Disposition: attachment; filename="starfish.jpg"
* 
* ...
* --------------020807050607070004010609
* Content-Type: application/pdf; name="fishing.pdf"
* Content-Transfer-Encoding: base64
* Content-Disposition: attachment; filename="fishing.pdf"
* ...

* Before sending, each filename can be changed within the email object.
* For example:
lnSuccess = loEmail.SetAttachmentFilename(0,"orange_starfish.jpg")
lnSuccess = loEmail.SetAttachmentFilename(1,"tuna_fishing.pdf")

* Look at the new MIME source of the email in a  text editor...
lnSuccess = loEmail.SaveEml("qa_output/e2.eml")
IF (lnSuccess = 0) THEN
    ? loEmail.LastErrorText
    ? "Failed to save .eml"
    RELEASE loMailman
    RELEASE loEmail
    CANCEL
ENDIF

* You'll see this:

* ...
* --------------020807050607070004010609
* Content-Type: image/jpeg; name="orange_starfish.jpg"
* Content-Transfer-Encoding: base64
* Content-Disposition: attachment; filename="orange_starfish.jpg"
* 
* ...
* --------------020807050607070004010609
* Content-Type: application/pdf; name="tuna_fishing.pdf"
* Content-Transfer-Encoding: base64
* Content-Disposition: attachment; filename="tuna_fishing.pdf"
* ...

* Send the email with the updated filenames..
lnSuccess = loMailman.SendEmail(loEmail)
IF (lnSuccess <> 1) THEN
    ? loMailman.LastErrorText
    RELEASE loMailman
    RELEASE loEmail
    CANCEL
ENDIF

lnSuccess = loMailman.CloseSmtpConnection()
IF (lnSuccess <> 1) THEN
    ? "Connection to SMTP server not closed cleanly."
ENDIF

? "Mail with attachments sent!"

RELEASE loMailman
RELEASE loEmail