Swift

Rename Email Attachments After Adding

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

func chilkatTest() {
    var success: Bool = false

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

    let mailman = CkoMailMan()!

    mailman.smtpHost = "smtp.my-mail-server.com"
    mailman.smtpUsername = "MY_SMTP_USERNAME"
    mailman.smtpPassword = "MY_SMTP_PASSWORD"
    mailman.smtpSsl = true
    mailman.smtpPort = 465

    let email = CkoEmail()!

    email.subject = "This is a test"
    email.body = "This is a test"
    email.from = "Chilkat Support <support@chilkatsoft.com>"
    success = email.add(to: "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.
    var contentType: String? = email.addFileAttachment(path: "qa_data/jpg/starfish.jpg")
    if email.lastMethodSuccess != true {
        print("\(email.lastErrorText!)")
        return
    }

    contentType = email.addFileAttachment(path: "qa_data/pdf/fishing.pdf")
    if email.lastMethodSuccess != true {
        print("\(email.lastErrorText!)")
        return
    }

    // If we save the email to a .eml, we can examine in a text editor.
    success = email.saveEml(path: "qa_output/e1.eml")
    if success == false {
        print("\(email.lastErrorText!)")
        print("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(index: 0, filename: "orange_starfish.jpg")
    success = email.setAttachmentFilename(index: 1, filename: "tuna_fishing.pdf")

    // Look at the new MIME source of the email in a  text editor...
    success = email.saveEml(path: "qa_output/e2.eml")
    if success == false {
        print("\(email.lastErrorText!)")
        print("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: email)
    if success != true {
        print("\(mailman.lastErrorText!)")
        return
    }

    success = mailman.closeSmtpConnection()
    if success != true {
        print("Connection to SMTP server not closed cleanly.")
    }

    print("Mail with attachments sent!")

}