(Visual FoxPro) Azure Table Insert Entity

See more Azure Table Service Examples

Insert an entity into an Azure table.

For more information, see https://docs.microsoft.com/en-us/rest/api/storageservices/insert-entity

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

LOCAL loRest
LOCAL lnSuccess
LOCAL lnBTls
LOCAL lnPort
LOCAL lnBAutoReconnect
LOCAL loAzAuth
LOCAL loJson
LOCAL loSbRequestBody
LOCAL loSbResponseBody
LOCAL lnRespStatusCode

* 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.Rest')
loRest = CreateObject('Chilkat.Rest')

* IMPORTANT: Make sure to change "myaccount" to your actual Azure Storage Account name.
* IMPORTANT: Also change "mytable" to the name of your Azure table.
* We're going to POST to this URL:  https://myaccount.table.core.windows.net/mytable
lnBTls = 1
lnPort = 443
lnBAutoReconnect = 1
lnSuccess = loRest.Connect("myaccount.table.core.windows.net",lnPort,lnBTls,lnBAutoReconnect)
IF (lnSuccess <> 1) THEN
    ? "ConnectFailReason: " + STR(loRest.ConnectFailReason)
    ? loRest.LastErrorText
    RELEASE loRest
    CANCEL
ENDIF

* Provide Azure Cloud credentials for the REST call.
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.AuthAzureStorage')
loAzAuth = CreateObject('Chilkat.AuthAzureStorage')
loAzAuth.AccessKey = "AZURE_ACCESS_KEY"
* The account name used here should match the 1st part of the domain passed in the call to Connect (above).
loAzAuth.Account = "myaccount"
loAzAuth.Scheme = "SharedKey"
loAzAuth.Service = "Table"

* This causes the "x-ms-version: 2019-07-07" header to be automatically added.
loAzAuth.XMsVersion = "2019-07-07"
lnSuccess = loRest.SetAuthAzureStorage(loAzAuth)

* Note: The application does not need to explicitly set the following
* headers: Content-Length, x-ms-date, Authorization.  These headers
* are automatically set by Chilkat.

* Note: The above code does not need to be repeatedly called for each REST request.
* The rest object can be setup once, and then many requests can be sent.  Chilkat will automatically
* reconnect within a FullRequest* method as needed.  It is only the very first connection that is explicitly
* made via the Connect method.

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

* The following JSON is sent in the request body.

* {  
*    "PartitionKey":"mypartitionkey",  
*    "RowKey":"myrowkey",  
*    "Timestamp":"2013-08-22T01:12:06.2608595Z",  
*    "Address":"Mountain View",  
*    "Age":23,  
*    "AmountDue":200.23,  
*    "CustomerCode":"c9da6455-213d-42c9-9a79-3e9149a57833",  
*    "CustomerSince":"2008-07-10T00:00:00",  
*    "IsActive":true,  
*    "NumberOfOrders":"255"  
* }  

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJson = CreateObject('Chilkat.JsonObject')
loJson.UpdateString("PartitionKey","mypartitionkey")
loJson.UpdateString("RowKey","myrowkey")
loJson.UpdateString("Timestamp","2013-08-22T01:12:06.2608595Z")
loJson.UpdateString("Address","Mountain View")
loJson.UpdateInt("Age",23)
loJson.UpdateNumber("AmountDue","200.23")
loJson.UpdateString("CustomerCode","c9da6455-213d-42c9-9a79-3e9149a57833")
loJson.UpdateString("CustomerSince","2008-07-10T00:00:00")
loJson.UpdateBool("IsActive",1)
loJson.UpdateString("NumberOfOrders","255")

* IMPORTANT: Pay attention to the options for nometadata, minimalmetadata, or fullmetadata.
* See the Azure table service API documentation at https://docs.microsoft.com/en-us/rest/api/storageservices/insert-entity
loRest.AddHeader("Accept","application/json;odata=nometadata")
loRest.AddHeader("Prefer","return-no-content")
loRest.AddHeader("Content-Type","application/json")

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.StringBuilder')
loSbRequestBody = CreateObject('Chilkat.StringBuilder')
loJson.EmitSb(loSbRequestBody)
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.StringBuilder')
loSbResponseBody = CreateObject('Chilkat.StringBuilder')
* IMPORTANT: Change "mytable" to the name of your actual table.
lnSuccess = loRest.FullRequestSb("POST","/mytable",loSbRequestBody,loSbResponseBody)
IF (lnSuccess <> 1) THEN
    ? loRest.LastErrorText
    RELEASE loRest
    RELEASE loAzAuth
    RELEASE loJson
    RELEASE loSbRequestBody
    RELEASE loSbResponseBody
    CANCEL
ENDIF

* A status code of 204 is a success response for the case where Prefer=return-no-content.
lnRespStatusCode = loRest.ResponseStatusCode
? "Response Status Code = " + STR(lnRespStatusCode)
IF (lnRespStatusCode >= 400) THEN
    ? "Response Header:"
    ? loRest.ResponseHeader
    ? "Response Body:"
    ? loSbResponseBody.GetAsString()
    RELEASE loRest
    RELEASE loAzAuth
    RELEASE loJson
    RELEASE loSbRequestBody
    RELEASE loSbResponseBody
    CANCEL
ENDIF

? "Success."

RELEASE loRest
RELEASE loAzAuth
RELEASE loJson
RELEASE loSbRequestBody
RELEASE loSbResponseBody