Chilkat Online Tools

C++ / Salesforce Platform APIs / SOAP DescribeValueType

Back to Collection Items

#include <CkHttp.h>
#include <CkXml.h>
#include <CkStringBuilder.h>
#include <CkHttpResponse.h>

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

    CkHttp http;
    bool success;

    // 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>
    // 

    CkXml xml;
    xml.put_Tag("soapenv:Envelope");
    xml.AddAttribute("xmlns:soapenv","http://schemas.xmlsoap.org/soap/envelope/");
    xml.AddAttribute("xmlns:tns","http://soap.sforce.com/2006/04/metadata");
    xml.UpdateChildContent("soapenv:Header|tns:SessionHeader|tns:sessionId","{{_accessToken}}");
    xml.UpdateChildContent("soapenv:Body|tns:describeValueType|type","{http://soap.sforce.com/2006/04/metadata}INSERT_METADATA_TYPE_NAME");

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

    CkStringBuilder sbRequestBody;
    xml.GetXmlSb(sbRequestBody);

    CkHttpResponse *resp = http.PTextSb("POST","https://domain.com/services/Soap/m/{{version}}",sbRequestBody,"utf-8","text/xml",false,false);
    if (http.get_LastMethodSuccess() == false) {
        std::cout << http.lastErrorText() << "\r\n";
        return;
    }

    CkStringBuilder sbResponseBody;
    resp->GetBodySb(sbResponseBody);
    delete resp;

    CkXml xmlResponse;
    xmlResponse.LoadSb(sbResponseBody,true);
    std::cout << xmlResponse.getXml() << "\r\n";

    // 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.

    const char *soapenv_Envelope_xmlns_soapenv = xmlResponse.getAttrValue("xmlns:soapenv");
    const char *soapenv_Envelope_xmlns = xmlResponse.getAttrValue("xmlns");
    const char *apiCreatable = xmlResponse.getChildContent("soapenv:Body|describeValueTypeResponse|result|apiCreatable");
    const char *apiDeletable = xmlResponse.getChildContent("soapenv:Body|describeValueTypeResponse|result|apiDeletable");
    const char *apiReadable = xmlResponse.getChildContent("soapenv:Body|describeValueTypeResponse|result|apiReadable");
    const char *apiUpdatable = xmlResponse.getChildContent("soapenv:Body|describeValueTypeResponse|result|apiUpdatable");
    }

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>"
    }
  ]
}