Objective-C

Rename Email Attachments After Adding

Demonstrates how to rename email attachments after adding but before sending. Objective-C

#import <CkoMailMan.h>
#import <CkoEmail.h>
#import <NSString.h>

BOOL success = NO;

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

CkoMailMan *mailman = [[CkoMailMan alloc] init];

mailman.SmtpHost = @"smtp.my-mail-server.com";
mailman.SmtpUsername = @"MY_SMTP_USERNAME";
mailman.SmtpPassword = @"MY_SMTP_PASSWORD";
mailman.SmtpSsl = YES;
mailman.SmtpPort = [NSNumber numberWithInt:465];

CkoEmail *email = [[CkoEmail alloc] init];

email.Subject = @"This is a test";
email.Body = @"This is a test";
email.From = @"Chilkat Support <support@chilkatsoft.com>";
success = [email AddTo: @"Chilkat Admin" emailAddress: @"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.
NSString *contentType = [email AddFileAttachment: @"qa_data/jpg/starfish.jpg"];
if (email.LastMethodSuccess != YES) {
    NSLog(@"%@",email.LastErrorText);
    return;
}

contentType = [email AddFileAttachment: @"qa_data/pdf/fishing.pdf"];
if (email.LastMethodSuccess != YES) {
    NSLog(@"%@",email.LastErrorText);
    return;
}

//  If we save the email to a .eml, we can examine in a text editor.
success = [email SaveEml: @"qa_output/e1.eml"];
if (success == NO) {
    NSLog(@"%@",email.LastErrorText);
    NSLog(@"%@",@"Failed to save .eml");
    return;
}

//  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:
success = [email SetAttachmentFilename: [NSNumber numberWithInt: 0] filename: @"orange_starfish.jpg"];
success = [email SetAttachmentFilename: [NSNumber numberWithInt: 1] filename: @"tuna_fishing.pdf"];

//  Look at the new MIME source of the email in a  text editor...
success = [email SaveEml: @"qa_output/e2.eml"];
if (success == NO) {
    NSLog(@"%@",email.LastErrorText);
    NSLog(@"%@",@"Failed to save .eml");
    return;
}

//  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..
success = [mailman SendEmail: email];
if (success != YES) {
    NSLog(@"%@",mailman.LastErrorText);
    return;
}

success = [mailman CloseSmtpConnection];
if (success != YES) {
    NSLog(@"%@",@"Connection to SMTP server not closed cleanly.");
}

NSLog(@"%@",@"Mail with attachments sent!");