Chilkat Online Tools

unicodeC / Salesforce Platform APIs / SOAP DescribeValueType

Back to Collection Items

#include <C_CkHttpW.h>
#include <C_CkXmlW.h>
#include <C_CkStringBuilderW.h>
#include <C_CkHttpResponseW.h>

void ChilkatSample(void)
    {
    HCkHttpW http;
    BOOL success;
    HCkXmlW xml;
    HCkStringBuilderW sbRequestBody;
    HCkHttpResponseW resp;
    HCkStringBuilderW sbResponseBody;
    HCkXmlW xmlResponse;
    const wchar_t *soapenv_Envelope_xmlns_soapenv;
    const wchar_t *soapenv_Envelope_xmlns;
    const wchar_t *apiCreatable;
    const wchar_t *apiDeletable;
    const wchar_t *apiReadable;
    const wchar_t *apiUpdatable;

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

    http = CkHttpW_Create();

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

    // The following XML is sent in the request body.

    // <?xml version="1.0" encoding="utf-8"?>
    // <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tns="http://soap.sforce.com/2006/04/metadata">
    //     <soapenv:Header>
    //         <tns:SessionHeader>
    //             <tns:sessionId>{{_accessToken}}</tns:sessionId>
    //         </tns:SessionHeader>
    //     </soapenv:Header>
    //     <soapenv:Body>
    //         <tns:describeValueType>
    //             <type>{http://soap.sforce.com/2006/04/metadata}INSERT_METADATA_TYPE_NAME</type>
    //         </tns:describeValueType>
    //     </soapenv:Body>
    // </soapenv:Envelope>
    // 

    xml = CkXmlW_Create();
    CkXmlW_putTag(xml,L"soapenv:Envelope");
    CkXmlW_AddAttribute(xml,L"xmlns:soapenv",L"http://schemas.xmlsoap.org/soap/envelope/");
    CkXmlW_AddAttribute(xml,L"xmlns:tns",L"http://soap.sforce.com/2006/04/metadata");
    CkXmlW_UpdateChildContent(xml,L"soapenv:Header|tns:SessionHeader|tns:sessionId",L"{{_accessToken}}");
    CkXmlW_UpdateChildContent(xml,L"soapenv:Body|tns:describeValueType|type",L"{http://soap.sforce.com/2006/04/metadata}INSERT_METADATA_TYPE_NAME");

    CkHttpW_SetRequestHeader(http,L"Content-Type",L"text/xml");
    CkHttpW_SetRequestHeader(http,L"SOAPAction",L"login");
    CkHttpW_SetRequestHeader(http,L"Accept",L"text/xml");
    CkHttpW_SetRequestHeader(http,L"charset",L"UTF-8");

    sbRequestBody = CkStringBuilderW_Create();
    CkXmlW_GetXmlSb(xml,sbRequestBody);

    resp = CkHttpW_PTextSb(http,L"POST",L"https://domain.com/services/Soap/m/{{version}}",sbRequestBody,L"utf-8",L"text/xml",FALSE,FALSE);
    if (CkHttpW_getLastMethodSuccess(http) == FALSE) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkHttpW_Dispose(http);
        CkXmlW_Dispose(xml);
        CkStringBuilderW_Dispose(sbRequestBody);
        return;
    }

    sbResponseBody = CkStringBuilderW_Create();
    CkHttpResponseW_GetBodySb(resp,sbResponseBody);
    CkHttpResponseW_Dispose(resp);

    xmlResponse = CkXmlW_Create();
    CkXmlW_LoadSb(xmlResponse,sbResponseBody,TRUE);
    wprintf(L"%s\n",CkXmlW_getXml(xmlResponse));

    // Sample XML response:
    // (Sample code for parsing the XML response is shown below)

    // <?xml version="1.0" encoding="UTF-8"?>
    // <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="http://soap.sforce.com/2006/04/metadata">
    //     <soapenv:Body>
    //         <describeValueTypeResponse>
    //             <result>
    //                 <apiCreatable>false</apiCreatable>
    //                 <apiDeletable>false</apiDeletable>
    //                 <apiReadable>false</apiReadable>
    //                 <apiUpdatable>false</apiUpdatable>
    //             </result>
    //         </describeValueTypeResponse>
    //     </soapenv:Body>
    // </soapenv:Envelope>

    // Sample code for parsing the XML response...
    // Use this online tool to generate parsing code from sample XML: Generate XML Parsing Code

    // Chilkat functions returning "const char *" return a pointer to temporary internal memory owned and managed by Chilkat.

    soapenv_Envelope_xmlns_soapenv = CkXmlW_getAttrValue(xmlResponse,L"xmlns:soapenv");
    soapenv_Envelope_xmlns = CkXmlW_getAttrValue(xmlResponse,L"xmlns");
    apiCreatable = CkXmlW_getChildContent(xmlResponse,L"soapenv:Body|describeValueTypeResponse|result|apiCreatable");
    apiDeletable = CkXmlW_getChildContent(xmlResponse,L"soapenv:Body|describeValueTypeResponse|result|apiDeletable");
    apiReadable = CkXmlW_getChildContent(xmlResponse,L"soapenv:Body|describeValueTypeResponse|result|apiReadable");
    apiUpdatable = CkXmlW_getChildContent(xmlResponse,L"soapenv:Body|describeValueTypeResponse|result|apiUpdatable");


    CkHttpW_Dispose(http);
    CkXmlW_Dispose(xml);
    CkStringBuilderW_Dispose(sbRequestBody);
    CkStringBuilderW_Dispose(sbResponseBody);
    CkXmlW_Dispose(xmlResponse);

    }

Curl Command

curl -X POST
	-H "Content-Type: text/xml"
	-H "charset: UTF-8"
	-H "SOAPAction: login"
	-H "Accept: text/xml"
	-d '<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tns="http://soap.sforce.com/2006/04/metadata">
	<soapenv:Header>
	<tns:SessionHeader>
		<tns:sessionId>{{_accessToken}}</tns:sessionId>
	</tns:SessionHeader>
	</soapenv:Header>
	<soapenv:Body>
		<tns:describeValueType>
			<type>{http://soap.sforce.com/2006/04/metadata}INSERT_METADATA_TYPE_NAME</type>
		</tns:describeValueType>
	</soapenv:Body>
</soapenv:Envelope>'
https://domain.com/services/Soap/m/{{version}}

Postman Collection Item JSON

{
  "name": "SOAP DescribeValueType",
  "event": [
    {
      "listen": "test",
      "script": {
        "exec": [
          ""
        ],
        "type": "text/javascript"
      }
    }
  ],
  "request": {
    "auth": {
      "type": "noauth"
    },
    "method": "POST",
    "header": [
      {
        "key": "Content-Type",
        "name": "Content-Type",
        "value": "text/xml",
        "type": "text"
      },
      {
        "key": "charset",
        "value": "UTF-8"
      },
      {
        "key": "SOAPAction",
        "value": "login"
      },
      {
        "key": "Accept",
        "value": "text/xml",
        "type": "text"
      }
    ],
    "body": {
      "mode": "raw",
      "raw": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns:tns=\"http://soap.sforce.com/2006/04/metadata\">\n\t<soapenv:Header>\n\t<tns:SessionHeader>\n\t\t<tns:sessionId>{{_accessToken}}</tns:sessionId>\n\t</tns:SessionHeader>\n\t</soapenv:Header>\n\t<soapenv:Body>\n\t\t<tns:describeValueType>\n\t\t\t<type>{http://soap.sforce.com/2006/04/metadata}INSERT_METADATA_TYPE_NAME</type>\n\t\t</tns:describeValueType>\n\t</soapenv:Body>\n</soapenv:Envelope>"
    },
    "url": {
      "raw": "{{_endpoint}}/services/Soap/m/{{version}}",
      "host": [
        "{{_endpoint}}"
      ],
      "path": [
        "services",
        "Soap",
        "m",
        "{{version}}"
      ]
    }
  },
  "response": [
    {
      "name": "Status200-Success",
      "originalRequest": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "text/xml"
          },
          {
            "key": "charset",
            "value": "UTF-8"
          },
          {
            "key": "SOAPAction",
            "value": "login"
          },
          {
            "key": "Accept",
            "value": "text/xml"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns:tns=\"http://soap.sforce.com/2006/04/metadata\">\n\t<soapenv:Header>\n\t<tns:SessionHeader>\n\t\t<tns:sessionId>{{_accessToken}}</tns:sessionId>\n\t</tns:SessionHeader>\n\t</soapenv:Header>\n\t<soapenv:Body>\n\t\t<tns:describeValueType>\n\t\t\t<type>{http://soap.sforce.com/2006/04/metadata}INSERT_METADATA_TYPE_NAME</type>\n\t\t</tns:describeValueType>\n\t</soapenv:Body>\n</soapenv:Envelope>"
        },
        "url": {
          "raw": "{{_endpoint}}/services/Soap/m/{{version}}",
          "host": [
            "{{_endpoint}}"
          ],
          "path": [
            "services",
            "Soap",
            "m",
            "{{version}}"
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "xml",
      "header": [
        {
          "key": "Date",
          "value": "Thu, 07 Sep 2023 09:25:45 GMT"
        },
        {
          "key": "Cache-Control",
          "value": "no-cache,must-revalidate,max-age=0,no-store,private"
        },
        {
          "key": "Content-Type",
          "value": "text/xml; charset=utf-8"
        },
        {
          "key": "Vary",
          "value": "Accept-Encoding"
        },
        {
          "key": "Content-Encoding",
          "value": "gzip"
        },
        {
          "key": "Transfer-Encoding",
          "value": "chunked"
        }
      ],
      "cookie": [
      ],
      "body": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns=\"http://soap.sforce.com/2006/04/metadata\">\n    <soapenv:Body>\n        <describeValueTypeResponse>\n            <result>\n                <apiCreatable>false</apiCreatable>\n                <apiDeletable>false</apiDeletable>\n                <apiReadable>false</apiReadable>\n                <apiUpdatable>false</apiUpdatable>\n            </result>\n        </describeValueTypeResponse>\n    </soapenv:Body>\n</soapenv:Envelope>"
    }
  ]
}