(Visual FoxPro) Outlook Send HTML Email with Embedded Images

This example sends an HTML email with embedded images. Other examples exist for:

Sending plain-text email.
Sending email with attachments.
Sending HTML email with embedded images and attachments.

Chilkat ActiveX Downloads

ActiveX for 32-bit and 64-bit Windows

LOCAL loHttp
LOCAL lnBCrlf
LOCAL loSbHtmlBody
LOCAL loJpgStarfish
LOCAL loJpgHedgeHogs
LOCAL loJson
LOCAL loResp

* Important: This example requires Chilkat v9.5.0.68 or greater.

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

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Http')
loHttp = CreateObject('Chilkat.Http')

* Use your previously obtained access token here:
* See the following examples for getting an access token:
*    Get Microsoft Graph OAuth2 Access Token (Azure AD v2.0 Endpoint).
*    Get Microsoft Graph OAuth2 Access Token (Azure AD Endpoint).
*    Refresh Access Token (Azure AD v2.0 Endpoint).
*    Refresh Access Token (Azure AD Endpoint).

loHttp.AuthToken = "MICROSOFT_GRAPH_ACCESS_TOKEN"

* To send mail, we'll POST to the following endpoint:
* 
* POST /users/{id | userPrincipalName}/sendMail
* 
* (The special keyword "me" may be used in place of a principal name.)
* 

* This example will send HTML email containing the following HTML body.
* After the 

* 	<html>
* 	<head>
* 	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
* 	<meta content="text/html; charset=utf-8">
* 	</head>
* 	<body bgcolor="#FFFFFF">
* 	<font face="Calibri">This is a test <b>HTML email with embedded images</b>.<br>
* 	<br>
* 	<img alt="" src="cid:starfish"><br>
* 	<img alt="" src="cid:hedgehogs"><br>
* 	</font>
* 	</body>
* 	</html>

* Build the HTML body...
lnBCrlf = 1
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.StringBuilder')
loSbHtmlBody = CreateObject('Chilkat.StringBuilder')
loSbHtmlBody.AppendLine("<html>",lnBCrlf)
loSbHtmlBody.AppendLine("<head>",lnBCrlf)
loSbHtmlBody.AppendLine('<meta http-equiv="Content-Type" content="text/html; charset=utf-8">',lnBCrlf)
loSbHtmlBody.AppendLine('<meta content="text/html; charset=utf-8">',lnBCrlf)
loSbHtmlBody.AppendLine("</head>",lnBCrlf)
loSbHtmlBody.AppendLine('<body bgcolor="#FFFFFF">',lnBCrlf)
loSbHtmlBody.AppendLine('<font face="Calibri">This is a test <b>HTML email with embedded images</b>.<br>',lnBCrlf)
loSbHtmlBody.AppendLine("<br>",lnBCrlf)
loSbHtmlBody.AppendLine('<img alt="" src="cid:starfish"><br>',lnBCrlf)
loSbHtmlBody.AppendLine('<img alt="" src="cid:hedgehogs"><br>',lnBCrlf)
loSbHtmlBody.AppendLine("</font>",lnBCrlf)
loSbHtmlBody.AppendLine("</body>",lnBCrlf)
loSbHtmlBody.AppendLine("</html>",lnBCrlf)

* Load the image files.
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.BinData')
loJpgStarfish = CreateObject('Chilkat.BinData')
loJpgStarfish.LoadFile("qa_data/jpg/starfish.jpg")
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.BinData')
loJpgHedgeHogs = CreateObject('Chilkat.BinData')
loJpgHedgeHogs.LoadFile("qa_data/jpg/hedgehogs.jpg")

* The body of the POST request contains JSON that specifies the email subject, body,
* recipients, etc.  This example will build the following JSON HTML email:
* 

* 	{
* 	  "message": {
* 	    "subject": "Sample HTML Email with Embedded Images",
* 	    "body": {
* 	      "contentType": "html",
* 	      "content": "The HTML body goes here..."
* 	    },
* 	    "toRecipients": [
* 	      {
* 	        "emailAddress": {
* 		  "name": "Chilkat Software",
* 	          "address": "admin@chilkat.io"
* 	        }
* 	      },
* 	      {
* 	        "emailAddress": {
* 	          "address": "chilkat.support@gmail.com"
* 	        }
* 	      }
* 	    ],
* 	    "ccRecipients": [
* 	      {
* 	        "emailAddress": {
* 		  "name": "Chilkat Blog",
* 		  "address": "admin@cknotes.com"
* 	        }
* 	      }
* 	    ],
* 	    "attachments": [
* 	       {
* 	         "@odata.type": "#microsoft.graph.fileAttachment",
* 	         "name": "starfish.jpg",
* 	         "contentType": "image/jpeg",
* 	         "size": 6497,
* 	         "isInline": true,
* 	         "contentId": "starfish",
* 	         "contentLocation": null,
* 	         "contentBytes": "base64_data_here"
* 	       },
* 	       {
* 	         "@odata.type": "#microsoft.graph.fileAttachment",
* 	         "name": "hedgehogs.jpg",
* 	         "contentType": "image/jpeg",
* 	         "size": 48845,
* 	         "isInline": true,
* 	         "contentId": "hedgehogs",
* 	         "contentLocation": null,
* 	         "contentBytes": "base64_data_here"
* 	       }
* 	    ]
* 	  },
* 	  "saveToSentItems": true
* 	}
* 
* Build the above JSON.
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJson = CreateObject('Chilkat.JsonObject')
loJson.UpdateString("message.subject","Sample HTML Email with Embedded Images")
loJson.UpdateString("message.body.contentType","html")
loJson.UpdateString("message.body.content",loSbHtmlBody.GetAsString())

loJson.UpdateString("message.toRecipients[0].emailAddress.name","Chilkat Software")
loJson.UpdateString("message.toRecipients[0].emailAddress.address","admin@chilkat.io")
loJson.UpdateString("message.toRecipients[1].emailAddress.address","chilkat.support@gmail.com")
loJson.UpdateString("message.ccRecipients[0].emailAddress.name","Chilkat Blog")
loJson.UpdateString("message.ccRecipients[0].emailAddress.address","admin@cknotes.com")

loJson.UpdateString('message.attachments[0]."@odata.type"',"#microsoft.graph.fileAttachment")
loJson.UpdateString("message.attachments[0].name","starfish.jpg")
loJson.UpdateString("message.attachments[0].contentType","image/jpeg")
loJson.UpdateInt("message.attachments[0].size",loJpgStarfish.NumBytes)
loJson.UpdateBool("message.attachments[0].isInline",1)
* This contentId must match the "cid:" in the HTML
loJson.UpdateString("message.attachments[0].contentId","starfish")
loJson.UpdateNull("message.attachments[0].contentLocation")
loJson.UpdateBd("message.attachments[0].contentBytes","base64",loJpgStarfish)

loJson.UpdateString('message.attachments[1]."@odata.type"',"#microsoft.graph.fileAttachment")
loJson.UpdateString("message.attachments[1].name","hedgehogs.jpg")
loJson.UpdateString("message.attachments[1].contentType","image/jpeg")
loJson.UpdateInt("message.attachments[1].size",loJpgHedgeHogs.NumBytes)
loJson.UpdateBool("message.attachments[1].isInline",1)
* This contentId must match the "cid:" in the HTML
loJson.UpdateString("message.attachments[1].contentId","hedgehogs")
loJson.UpdateNull("message.attachments[1].contentLocation")
loJson.UpdateBd("message.attachments[1].contentBytes","base64",loJpgHedgeHogs)

loJson.UpdateBool("saveToSentItems",1)

* -------------------------------------------------------------
* Important: This example requires Chilkat v9.5.0.68 or greater.
* -------------------------------------------------------------

* Send the HTTP POST (i.e. send the HTML email)
loResp = loHttp.PostJson3("https://graph.microsoft.com/v1.0/me/sendMail","application/json",loJson)
IF (loHttp.LastMethodSuccess <> 1) THEN
    ? loHttp.LastErrorText
    RELEASE loHttp
    RELEASE loSbHtmlBody
    RELEASE loJpgStarfish
    RELEASE loJpgHedgeHogs
    RELEASE loJson
    CANCEL
ENDIF

* The send succeeded if the response status code = 202.
* In the success case, there is no response body.  (We just get the response code to know that it succeeded.)
IF (loResp.StatusCode <> 202) THEN
    loJson.Load(loResp.BodyStr)
    loJson.EmitCompact = 0
    ? loJson.Emit()
    ? "Failed, response status code = " + STR(loResp.StatusCode)
ELSE
    ? "Outlook HTML Mail Sent."
ENDIF

RELEASE loResp

RELEASE loHttp
RELEASE loSbHtmlBody
RELEASE loJpgStarfish
RELEASE loJpgHedgeHogs
RELEASE loJson