(Excel) Outlook -- Search Multiple Folders

I don't yet see how it's possible to do a recursive search of Outlook folders using the Microsoft Graph API. My best guess is to somehow use OData v4.0's $expand query option, but the hierarchical structure of the "mailFolder" and "messages" Microsoft Graph resources don't quite fit. Suggestions are welcome and can be sent to support@chilkatsoft.com.

This example will iterate over a list of folder previously obtained by a recursive traversal of the Outlook mail folders. (See the link in the example code below.)

A separate search is performed on each desired folder, and the results are combined into a single result set.

Note: This example requires Chilkat v9.5.0.68 or greater.

This example applies to: Exchange Online | Office 365 | Hotmail.com | Live.com | MSN.com | Outlook.com | Passport.com

Download Excel Class Modules Chilkat Excel Class Modules

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

Dim http As Chilkat.Http
Set http = Chilkat.NewHttp

' 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).

http.AuthToken = "MICROSOFT_GRAPH_ACCESS_TOKEN"

' This example will iterate over the folders previously discovered by recursively traversing the Outlook folders
' as shown in this example:  Outlook Recursive Folder Traversal)

' The XML map produced by the recursive traversal looks like this:

' 	<?xml version="1.0" encoding="utf-8"?>
' 	<hashtable>
' 	<e><k>/Sent Items</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAgEJAAAA</v></e>
' 	<e><k>/Inbox</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAgEMAAAA</v></e>
' 	<e><k>/Junk Email</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAgEiAAAA</v></e>
' 	<e><k>/Inbox/xyz</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwEAAAA=</v></e>
' 	<e><k>/Inbox/abc/subFolderA/a</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwIAAAA=</v></e>
' 	<e><k>/Inbox/abc</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huv8AAAA=</v></e>
' 	<e><k>/Outbox</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAgELAAAA</v></e>
' 	<e><k>/Inbox/abc/subFolderA</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwAAAQ==</v></e>
' 	<e><k>/Inbox/abc/subFolderB</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwMAAAA=</v></e>
' 	<e><k>/Archive</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAG8XunwAAAA=</v></e>
' 	<e><k>/Deleted Items</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAgEKAAAA</v></e>
' 	<e><k>/Drafts</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAgEPAAAA</v></e>
' 	</hashtable>

' We'll iterate over the folders, and search all folders beginning with "/Inbox" (effectively, we're recursively searching
' everything under Inbox)
Dim xmlMap As Chilkat.Xml
Set xmlMap = Chilkat.NewXml

success = xmlMap.LoadXmlFile("qa_data/outlook/folderMap.xml")
If (success <> True) Then
    Debug.Print "Failed to load XML folder map."
    Exit Sub
End If

' We're going to return just the message id, subject, and FROM name/address.
success = http.SetUrlVar("select","id,subject,from")

' Our search will be for emails with the word "sample" in the subject.
success = http.SetUrlVar("filter","contains(subject,'sample')")

Dim json As Chilkat.JsonObject
Set json = Chilkat.NewJsonObject
json.EmitCompact = False

Dim jsonCombined As Chilkat.JsonObject
Set jsonCombined = Chilkat.NewJsonObject
jsonCombined.EmitCompact = False

Dim sbResponse As Chilkat.StringBuilder
Set sbResponse = Chilkat.NewStringBuilder
Dim sbPath As Chilkat.StringBuilder
Set sbPath = Chilkat.NewStringBuilder

numFolders = xmlMap.NumChildren

i = 0

j = 0

k = 0
Do While i < numFolders
    xmlMap.I = i
    success = sbPath.SetString(xmlMap.GetChildContent("e[i]|k"))

    If (sbPath.StartsWith("/Inbox",True) = True) Then

        Debug.Print "------------------------------------------------------------------"
        Debug.Print "Searching "; sbPath.GetAsString()

        ' Search this mail folder..
        success = http.SetUrlVar("folder_id",xmlMap.GetChildContent("e[i]|v"))

        sbResponse.Clear 
        success = http.QuickGetSb("https://graph.microsoft.com/v1.0/me/mailFolders/{$folder_id}/messages?$filter={$filter}&$select={$select}",sbResponse)
        If ((success <> True) And (http.LastStatus = 0)) Then
            Debug.Print http.LastErrorText
            Exit Sub
        End If

        success = json.LoadSb(sbResponse)

        If (http.LastStatus <> 200) Then
            Debug.Print "HTTP response status = "; http.LastStatus
            Debug.Print json.Emit()
            Debug.Print "Failed."
            Exit Sub
        End If

        Debug.Print json.Emit()

        ' Each mail folder search will return JSON with a value array, which is non-empty if any matching messages were found:

        ' 			{
        ' 			  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/mailFolders('AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAgEMAAAA')/messages(id,subject,from)",
        ' 			  "value": [
        ' 				Individual messages, if any, are listed here.
        ' 			  ]
        ' 			}


        numMessages = json.SizeOfArray("value")
        j = 0
        Do While j < numMessages
            json.J = j

            ' Add this message to the final result set.
            jsonCombined.K = k
            success = jsonCombined.UpdateString("value[k].folderPath",sbPath.GetAsString())
            success = jsonCombined.UpdateString("value[k].id",json.StringOf("value[j].id"))
            success = jsonCombined.UpdateString("value[k].subject",json.StringOf("value[j].subject"))
            success = jsonCombined.UpdateString("value[k].from.emailAddress.name",json.StringOf("value[j].from.emailAddress.name"))
            success = jsonCombined.UpdateString("value[k].from.emailAddress.address",json.StringOf("value[j].from.emailAddress.address"))
            k = k + 1

            j = j + 1
        Loop

    End If

    i = i + 1
Loop

' Show the final combined JSON search result.
Debug.Print "------------------------------------------------------------------"
Debug.Print "Combined Search Results:"
Debug.Print jsonCombined.Emit()

' Sample output for the above program:

' ------------------------------------------------------------------
' Searching /Inbox
' {
'   "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/mailFolders('AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAgEMAAAA')/messages(id,subject,from)",
'   "value": [
'     {
'       "@odata.etag": "W/\"CQAAABYAAADn68XtMop0TpsYJGpfKXY9AADOpwfr\"",
'       "id": "AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgBGAAADsVyfxjDU406Ic4X7ill8xAcA5_vF7TKKdE6bGCRqXyl2PQAAAgEMAAAA5_vF7TKKdE6bGCRqXyl2PQAAAM6Jj10AAAA=",
'       "subject": "A sample email with Amazon in the body",
'       "from": {
'         "emailAddress": {
'           "name": "Chilkat Software",
'           "address": "support@chilkatsoft.com"
'         }
'       }
'     }
'   ]
' }
' 
' ------------------------------------------------------------------
' Searching /Inbox/xyz
' {
'   "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/mailFolders('AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwEAAAA%3D')/messages(id,subject,from)",
'   "value": [
'   ]
' }
' 
' ------------------------------------------------------------------
' Searching /Inbox/abc/subFolderA/a
' {
'   "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/mailFolders('AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwIAAAA%3D')/messages(id,subject,from)",
'   "value": [
'     {
'       "@odata.etag": "W/\"CQAAABYAAADn68XtMop0TpsYJGpfKXY9AADOpzfb\"",
'       "id": "AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgBGAAADsVyfxjDU406Ic4X7ill8xAcA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwIAAADn68XtMop0TpsYJGpfKXY9AAAAzombFQAAAA==",
'       "subject": "Sample email from admin@chilkat.io",
'       "from": {
'         "emailAddress": {
'           "name": "Chilkat Software",
'           "address": "admin@chilkat.io"
'         }
'       }
'     }
'   ]
' }
' 
' ------------------------------------------------------------------
' Searching /Inbox/abc
' {
'   "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/mailFolders('AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huv8AAAA%3D')/messages(id,subject,from)",
'   "value": [
'   ]
' }
' 
' ------------------------------------------------------------------
' Searching /Inbox/abc/subFolderA
' {
'   "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/mailFolders('AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwAAAQ%3D%3D')/messages(id,subject,from)",
'   "value": [
'   ]
' }
' 
' ------------------------------------------------------------------
' Searching /Inbox/abc/subFolderB
' {
'   "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/mailFolders('AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwMAAAA%3D')/messages(id,subject,from)",
'   "value": [
'   ]
' }
' 
' ------------------------------------------------------------------
' Combined Search Results:
' {
'   "value": [
'     {
'       "folderPath": "/Inbox",
'       "id": "AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgBGAAADsVyfxjDU406Ic4X7ill8xAcA5_vF7TKKdE6bGCRqXyl2PQAAAgEMAAAA5_vF7TKKdE6bGCRqXyl2PQAAAM6Jj10AAAA=",
'       "subject": "A sample email with Amazon in the body",
'       "from": {
'         "emailAddress": {
'           "name": "Chilkat Software",
'           "address": "support@chilkatsoft.com"
'         }
'       }
'     },
'     {
'       "folderPath": "/Inbox/abc/subFolderA/a",
'       "id": "AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgBGAAADsVyfxjDU406Ic4X7ill8xAcA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwIAAADn68XtMop0TpsYJGpfKXY9AAAAzombFQAAAA==",
'       "subject": "Sample email from admin@chilkat.io",
'       "from": {
'         "emailAddress": {
'           "name": "Chilkat Software",
'           "address": "admin@chilkat.io"
'         }
'       }
'     }
'   ]
' }
'