SQL Server Requires Chilkat v11.0.0+
SQL Server
Outlook Contacts Update (PATCH) a Contact
See more Outlook Contact Examples
Update the properties of an Outlook contact object.Chilkat SQL Server Downloads
-- Important: See this note about string length limitations for strings returned by sp_OAMethod calls.
--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
DECLARE @hr int
DECLARE @iTmp0 int
DECLARE @sTmp0 nvarchar(4000)
DECLARE @success int
SELECT @success = 0
-- This example requires the Chilkat API to have been previously unlocked.
-- See Global Unlock Sample for sample code.
DECLARE @http int
EXEC @hr = sp_OACreate 'Chilkat.Http', @http OUT
IF @hr <> 0
BEGIN
PRINT 'Failed to create ActiveX component'
RETURN
END
-- Use your previously obtained access token here: Get Outlook Contacts OAuth2 Access Token (Azure AD v2.0 Endpoint).
DECLARE @jsonToken int
EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @jsonToken OUT
EXEC sp_OAMethod @jsonToken, 'LoadFile', @success OUT, 'qa_data/tokens/outlookContacts.json'
IF @success = 0
BEGIN
EXEC sp_OAGetProperty @jsonToken, 'LastErrorText', @sTmp0 OUT
PRINT @sTmp0
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @jsonToken
RETURN
END
EXEC sp_OAMethod @jsonToken, 'StringOf', @sTmp0 OUT, 'access_token'
EXEC sp_OASetProperty @http, 'AuthToken', @sTmp0
-- 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
DECLARE @json int
EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @json OUT
EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'homeAddress.street', '123 Some street'
EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'homeAddress.city', 'Seattle'
EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'homeAddress.state', 'WA'
EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'homeAddress.postalCode', '98121'
EXEC sp_OAMethod @json, 'UpdateString', @success OUT, '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).
DECLARE @id nvarchar(4000)
SELECT @id = 'AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQBGAAAAAAAu7cUXL5YOTrdsUIw7-v8FBwBUcG0qWqkmQYqWLHQataQxAAAAAAEOAABUcG0qWqkmQYqWLHQataQxAAD0sxexAAA='
EXEC sp_OAMethod @http, 'SetUrlVar', @success OUT, 'id', @id
-- Send the HTTP PATCH
DECLARE @resp int
EXEC @hr = sp_OACreate 'Chilkat.HttpResponse', @resp OUT
EXEC sp_OAMethod @http, 'HttpJson', @success OUT, 'PATCH', 'https://graph.microsoft.com/v1.0/me/contacts/{$id}', @json, 'application/json', @resp
IF @success = 0
BEGIN
EXEC sp_OAGetProperty @http, 'LastErrorText', @sTmp0 OUT
PRINT @sTmp0
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @jsonToken
EXEC @hr = sp_OADestroy @json
EXEC @hr = sp_OADestroy @resp
RETURN
END
EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
PRINT 'Response status code = ' + @iTmp0
DECLARE @jResp int
EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @jResp OUT
EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
EXEC sp_OAMethod @jResp, 'Load', @success OUT, @sTmp0
EXEC sp_OASetProperty @jResp, 'EmitCompact', 0
EXEC sp_OAMethod @jResp, 'Emit', @sTmp0 OUT
PRINT @sTmp0
-- The send succeeded if the response status code = 201.
EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
IF @iTmp0 <> 200
BEGIN
PRINT 'Failed'
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @jsonToken
EXEC @hr = sp_OADestroy @json
EXEC @hr = sp_OADestroy @resp
EXEC @hr = sp_OADestroy @jResp
RETURN
END
-- 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": {}
-- }
PRINT 'Contact updated.'
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @jsonToken
EXEC @hr = sp_OADestroy @json
EXEC @hr = sp_OADestroy @resp
EXEC @hr = sp_OADestroy @jResp
END
GO