Tcl

Rename Email Attachments After Adding

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

load ./chilkat.dll

set success 0

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

set mailman [new_CkMailMan]

CkMailMan_put_SmtpHost $mailman "smtp.my-mail-server.com"
CkMailMan_put_SmtpUsername $mailman "MY_SMTP_USERNAME"
CkMailMan_put_SmtpPassword $mailman "MY_SMTP_PASSWORD"
CkMailMan_put_SmtpSsl $mailman 1
CkMailMan_put_SmtpPort $mailman 465

set email [new_CkEmail]

CkEmail_put_Subject $email "This is a test"
CkEmail_put_Body $email "This is a test"
CkEmail_put_From $email "Chilkat Support <support@chilkatsoft.com>"
set success [CkEmail_AddTo $email "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.
set contentType [CkEmail_addFileAttachment $email "qa_data/jpg/starfish.jpg"]
if {[CkEmail_get_LastMethodSuccess $email] != 1} then {
    puts [CkEmail_lastErrorText $email]
    delete_CkMailMan $mailman
    delete_CkEmail $email
    exit
}

set contentType [CkEmail_addFileAttachment $email "qa_data/pdf/fishing.pdf"]
if {[CkEmail_get_LastMethodSuccess $email] != 1} then {
    puts [CkEmail_lastErrorText $email]
    delete_CkMailMan $mailman
    delete_CkEmail $email
    exit
}

# If we save the email to a .eml, we can examine in a text editor.
set success [CkEmail_SaveEml $email "qa_output/e1.eml"]
if {$success == 0} then {
    puts [CkEmail_lastErrorText $email]
    puts "Failed to save .eml"
    delete_CkMailMan $mailman
    delete_CkEmail $email
    exit
}

# 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:
set success [CkEmail_SetAttachmentFilename $email 0 "orange_starfish.jpg"]
set success [CkEmail_SetAttachmentFilename $email 1 "tuna_fishing.pdf"]

# Look at the new MIME source of the email in a  text editor...
set success [CkEmail_SaveEml $email "qa_output/e2.eml"]
if {$success == 0} then {
    puts [CkEmail_lastErrorText $email]
    puts "Failed to save .eml"
    delete_CkMailMan $mailman
    delete_CkEmail $email
    exit
}

# 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..
set success [CkMailMan_SendEmail $mailman $email]
if {$success != 1} then {
    puts [CkMailMan_lastErrorText $mailman]
    delete_CkMailMan $mailman
    delete_CkEmail $email
    exit
}

set success [CkMailMan_CloseSmtpConnection $mailman]
if {$success != 1} then {
    puts "Connection to SMTP server not closed cleanly."
}

puts "Mail with attachments sent!"

delete_CkMailMan $mailman
delete_CkEmail $email