(Visual FoxPro) Outlook -- Create a Mail Folder

Creates a new mail folder as a child of an existing mail folder.

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

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

LOCAL loHttp
LOCAL loHtFolderMap
LOCAL loSbMap
LOCAL lcExistingFolderId
LOCAL loJsonRequestBody
LOCAL loResp
LOCAL loJsonResponse

* 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:
loHttp.AuthToken = "MICROSOFT_GRAPH_ACCESS_TOKEN"

* This example will create a new mail folder as a child of /Inbox/abc

* Get the existing folder ID from the folder map created by this example 
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Hashtable')
loHtFolderMap = CreateObject('Chilkat.Hashtable')
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.StringBuilder')
loSbMap = CreateObject('Chilkat.StringBuilder')
loSbMap.LoadFile("qa_data/outlook/folderMap.xml","utf-8")
loHtFolderMap.AddFromXmlSb(loSbMap)

lcExistingFolderId = loHtFolderMap.LookupStr("/Inbox/abc")
IF (loHtFolderMap.LastMethodSuccess <> 1) THEN
    ? "Folder ID not found"
    RELEASE loHttp
    RELEASE loHtFolderMap
    RELEASE loSbMap
    CANCEL
ENDIF

* Create a JSON request body with this content:
* 
* 	{
* 	  "displayName": "displayName-value",
* 	}

* This example will create /Inbox/abc/subFolderC
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJsonRequestBody = CreateObject('Chilkat.JsonObject')
loJsonRequestBody.UpdateString("displayName","subFolderC")

loHttp.SetUrlVar("folder_id",lcExistingFolderId)

* Create the folder "subFolderC" at the specified location.
loResp = loHttp.PostJson2("https://graph.microsoft.com/v1.0/me/mailFolders/{$folder_id}/childFolders","application/json",loJsonRequestBody.Emit())
IF (loHttp.LastMethodSuccess <> 1) THEN
    ? loHttp.LastErrorText
    RELEASE loHttp
    RELEASE loHtFolderMap
    RELEASE loSbMap
    RELEASE loJsonRequestBody
    CANCEL
ENDIF

* A 201 response indicates success.
IF (loHttp.LastStatus = 201) THEN
    ? "Folder created."
ELSE
    ? "Response status code = " + STR(loResp.StatusCode)
    ? "Error: Folder not created."
ENDIF

* Show the response in both cases..
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJsonResponse = CreateObject('Chilkat.JsonObject')
loJsonResponse.EmitCompact = 0
loJsonResponse.Load(loResp.BodyStr)
? loJsonResponse.Emit()

RELEASE loResp

* A sample successful JSON response looks like this:

* 	{
* 	  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/mailFolders('AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huv8AAAA%3D')/childFolders/$entity",
* 	  "id": "AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAM6JqMIAAAA=",
* 	  "displayName": "subFolderC",
* 	  "parentFolderId": "AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huv8AAAA=",
* 	  "childFolderCount": 0,
* 	  "unreadItemCount": 0,
* 	  "totalItemCount": 0
* 	}

RELEASE loHttp
RELEASE loHtFolderMap
RELEASE loSbMap
RELEASE loJsonRequestBody
RELEASE loJsonResponse