(PowerBuilder) Outlook Contacts Update (PATCH) a Contact

See more Outlook Contact Examples

Update the properties of an Outlook contact object.

For more information, see https://docs.microsoft.com/en-us/graph/api/contact-update?view=graph-rest-1.0&tabs=http

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

integer li_rc
oleobject loo_Http
oleobject loo_JsonToken
integer li_Success
oleobject loo_Json
string ls_Id
oleobject loo_Resp
oleobject loo_JResp

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

loo_Http = create oleobject
// Use "Chilkat_9_5_0.Http" for versions of Chilkat < 10.0.0
li_rc = loo_Http.ConnectToNewObject("Chilkat.Http")
if li_rc < 0 then
    destroy loo_Http
    MessageBox("Error","Connecting to COM object failed")
    return
end if

// Use your previously obtained access token here: Get Outlook Contacts OAuth2 Access Token (Azure AD v2.0 Endpoint).

loo_JsonToken = create oleobject
// Use "Chilkat_9_5_0.JsonObject" for versions of Chilkat < 10.0.0
li_rc = loo_JsonToken.ConnectToNewObject("Chilkat.JsonObject")

li_Success = loo_JsonToken.LoadFile("qa_data/tokens/outlookContacts.json")
if li_Success = 0 then
    Write-Debug loo_JsonToken.LastErrorText
    destroy loo_Http
    destroy loo_JsonToken
    return
end if

loo_Http.AuthToken = loo_JsonToken.StringOf("access_token")

// Send the following PATCH:

// PATCH https://graph.microsoft.com/v1.0/me/contacts/{id}
// Content-type: application/json
// Content-length: 1977
// 
// {
//   "homeAddress": {
//     "street": "123 Some street",
//     "city": "Seattle",
//     "state": "WA",
//     "postalCode": "98121"
//   },
//   "birthday": "1974-07-22"
// }

// Build the JSON body of the POST.

// Use this online tool to generate code from sample JSON: 
// Generate Code to Create JSON

loo_Json = create oleobject
// Use "Chilkat_9_5_0.JsonObject" for versions of Chilkat < 10.0.0
li_rc = loo_Json.ConnectToNewObject("Chilkat.JsonObject")

loo_Json.UpdateString("homeAddress.street","123 Some street")
loo_Json.UpdateString("homeAddress.city","Seattle")
loo_Json.UpdateString("homeAddress.state","WA")
loo_Json.UpdateString("homeAddress.postalCode","98121")
loo_Json.UpdateString("birthday","1974-07-22")

// We need the ID of the contact to be updated.
// This was available in the response when we created the contact:  Create an Outlook Contact.
// Or you can list contacts to get the ID: List Outlook Contacts).

ls_Id = "AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQBGAAAAAAAu7cUXL5YOTrdsUIw7-v8FBwBUcG0qWqkmQYqWLHQataQxAAAAAAEOAABUcG0qWqkmQYqWLHQataQxAAD0sxexAAA="
loo_Http.SetUrlVar("id",ls_Id)

// Send the HTTP PATCH
loo_Resp = loo_Http.PText("PATCH","https://graph.microsoft.com/v1.0/me/contacts/{$id}",loo_Json.Emit(),"utf-8","application/json",0,0)
if loo_Http.LastMethodSuccess <> 1 then
    Write-Debug loo_Http.LastErrorText
    destroy loo_Http
    destroy loo_JsonToken
    destroy loo_Json
    return
end if

Write-Debug "Response status code = " + string(loo_Resp.StatusCode)
destroy loo_Resp

loo_JResp = create oleobject
// Use "Chilkat_9_5_0.JsonObject" for versions of Chilkat < 10.0.0
li_rc = loo_JResp.ConnectToNewObject("Chilkat.JsonObject")

loo_JResp.Load(loo_Resp.BodyStr)
loo_JResp.EmitCompact = 0
Write-Debug loo_JResp.Emit()

// The send succeeded if the response status code = 201.
if loo_Resp.StatusCode <> 200 then
    Write-Debug "Failed"
    destroy loo_Http
    destroy loo_JsonToken
    destroy loo_Json
    destroy loo_JResp
    return
end if

// Sample JSON response:

// {
//   "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('4ee732c3-322e-4a6b-b729-2fd1eb5c6004')/contacts/$entity",
//   "@odata.etag": "W/\"EQAAABYAAABUcG0qWqkmQYqWLHQataQxAAD0iYu5\"",
//   "id": "AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQBGAAAAAAAu7cUXL5YOTrdsUIw7-v8FBwBUcG0qWqkmQYqWLHQataQxAAAAAAEOAABUcG0qWqkmQYqWLHQataQxAAD0sxexAAA=",
//   "createdDateTime": "2021-06-29T16:32:05Z",
//   "lastModifiedDateTime": "2021-06-29T16:57:39Z",
//   "changeKey": "EQAAABYAAABUcG0qWqkmQYqWLHQataQxAAD0iYu5",
//   "categories": [
//   ],
//   "parentFolderId": "AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQAuAAAAAAAu7cUXL5YOTrdsUIw7-v8FAQBUcG0qWqkmQYqWLHQataQxAAAAAAEOAAA=",
//   "birthday": "1974-07-22T11:59:00Z",
//   "fileAs": "",
//   "displayName": "Pavel Bansky",
//   "givenName": "Pavel",
//   "initials": null,
//   "middleName": null,
//   "nickName": null,
//   "surname": "Bansky",
//   "title": null,
//   "yomiGivenName": null,
//   "yomiSurname": null,
//   "yomiCompanyName": null,
//   "generation": null,
//   "imAddresses": [
//   ],
//   "jobTitle": null,
//   "companyName": null,
//   "department": null,
//   "officeLocation": null,
//   "profession": null,
//   "businessHomePage": null,
//   "assistantName": null,
//   "manager": null,
//   "homePhones": [
//   ],
//   "mobilePhone": null,
//   "businessPhones": [
//     "+1 732 555 0102"
//   ],
//   "spouseName": null,
//   "personalNotes": "",
//   "children": [
//   ],
//   "emailAddresses": [
//     {
//       "name": "Pavel Bansky",
//       "address": "pavelb@fabrikam.onmicrosoft.com"
//     }
//   ],
//   "homeAddress": {
//     "street": "123 Some street",
//     "city": "Seattle",
//     "state": "WA",
//     "postalCode": "98121"
//   },
//   "businessAddress": {},
//   "otherAddress": {}
// }

Write-Debug "Contact updated."


destroy loo_Http
destroy loo_JsonToken
destroy loo_Json
destroy loo_JResp